Limitations

To ensure that source code remains valid, Typstyle refrains from formatting in certain scenarios. The following cases outline situations where Typstyle either does not apply formatting or applies only conservative changes.

Currently, we are capable of formatting everything with comments. However, when expressions contain comments, Typstyle may not be able to preserve a visually pleasing layout or may even refuse to format the code. Embedded comments can interrupt alignment and grouping, making it difficult to apply standard formatting rules without altering the intended structure. In such cases, Typstyle falls back to conservative formatting or skips formatting entirely to avoid breaking the code’s semantics.

We guarantee that in all supported cases the source will be formatted correctly and no comments will be lost. If you find that a comment is lost or the formatting result is unsatisfactory due to comments, please submit an issue to report the problem.

Math mode is highly sensitive to spacing, and users may rely on precise spacing for visual effects. Therefore, Typstyle avoids changing spaces within math mode to ensure the rendered result is unchanged.

Additionally, Typstyle will not convert spaces into line breaks (or vice versa) in math, as such changes can adversely affect the appearance of equations. We respect the user’s intent regarding spaces and linebreaks.

Typstyle attempts to format tables into neat, rectangular layouts—only when the table is simple enough.

Since there is no runtime function-signature provider, we treat any call named tabletable or gridgrid as a table and apply table layout.

We fall back to a plain layout (structure preserved) in these cases:

• The table contains a block comment or has no positional arguments.
• It lacks a columnscolumns argument or uses spread arguments which possibly define columns.
• The columnscolumns argument is not a simple constant expression.

Compact layout places initial arguments on the first line and lets the last combinable argument span multiple lines. It currently has limitations:

• Only applies to function call arguments, not other list-like structures.
• Simple trailing expressions won’t trigger it.
• Comments or explicit line breaks disable it.

If you encounter cases where it would help but isn’t applied, please report an issue.