[Compression] Preserve type declarations (critical for LLM context) while allowing function compression

[FlatMapIO]

Type declarations are structural anchors for LLMs to understand code relationships, whereas function bodies can be safely compressed.

[yamadashy]

Hi, @FlatMapIO !
Thank you for feedback!

Indeed, currently the interface and other type definitions are reduced to just the name line, which may be too aggressive in terms of information reduction.
It would be better to preserve all interface, type, and class properties and methods (excluding implementations) - essentially maintaining the same level of information as a d.ts file.

I will look into implementing this change.

[raptium]

I suggest also preserving documentation comments (docstrings in Python, JSDoc in JavaScript, etc.) along with type declarations. Documentation often contains crucial information about method usage, parameters, and return values that helps LLMs understand the code's purpose and behavior.

If documentation preservation impacts file size significantly, perhaps this could be implemented as a configurable option.

[yamadashy]

@raptium
Indeed, I completely agree with you.

When considering what information makes code analysis easier, comments that explain the "Why" are essential.

Since we have the --remove-comments option, users can utilize it if they don't need the comments in their output.