typstyle: baixar versions anteriors

Rust crates (typstyle and typstyle-core) and native CLI binaries are available for v0.15.2. The WASM build failed, so @typstyle/typstyle-wasm-bundler v0.15.2 was not published to npm. WASM consumers should continue using their previous package version.
Release workflow details
- Feature(CLI): Add --line-ending=lf|crlf|preserve with preserve as the default.
Preservation generates CRLF only when the input contains at least one CRLF
and has no bare LF or bare CR; otherwise it generates LF. lf and crlf force
generated breaks. The default
--check now accepts formatted CRLF files; use --line-ending=lf to enforce LF.
(#496)
- Feature(Core): Add Config::line_ending and with_line_ending for LF, CRLF,
or default conservative preservation in document and partial formatting. Detection
uses the whole original document, including for range edits. Literal text remains
verbatim. The CLI uses the pretty renderer directly without output conversion.
- Feature: Add wrap_mode = "fill-sentence" / --wrap-text=fill-sentence, a middle ground
between fill and sentence: like sentence, each sentence starts on a new line; like
fill, each sentence's words are reflowed to the line width instead of leaving it as one
unbounded line or preserving manual line breaks.
- Fix: Preserve trailing spaces and whitespace-only lines inside multiline strings, raw blocks, and format-disabled source instead of trimming every rendered line.
- Fix: Avoid generated indentation on blank lines and unnecessary flow spaces at line boundaries, including in partial formatting and aligned math. Line comments and block comments with leading stars still have trailing whitespace trimmed during comment formatting.
- Fix: Range formatting now matches document formatting when the range covers the whole source. Previously the returned edit could be narrower than the requested range and its content could miss document layout such as the final newline.
- Fix: Range formatting now honors @typstyle off directives attached to syntax outside the selected range, including when the document has unrelated syntax errors.
- Fix: Range formatting no longer deletes code separators when the selection is whitespace-only, such as an empty cursor position or a line break between statements.
- Fix: Range formatting of markup selections no longer adds document-level layout (such as a trailing newline) or layout inferred from source outside the replaced range.
- Fix: Range formatting of code keeps comments and semicolons at the replacement boundary, so the applied edit cannot merge the formatted fragment with the following statement.

- Update typst to v0.15.1.
- Add experimental sentence-level text wrapping with wrap_mode = "sentence" or --wrap-text=sentence. Breaking: the boolean wrap_text configuration option is replaced by wrap_mode; migrate true to "fill" and false to "none". The existing bare --wrap-text CLI flag remains supported as shorthand for --wrap-text=fill.

- Bump typst to v0.15.0. With the new typst math parser, the formatting of math arguments has also improved slightly as a side effect.

- Fix git submodule ghost that prevents publishing.

- Feature: Bump typst-syntax to v0.14.0.

- Bug fix: Previously, @typstyle off is not correctly recognized for {table,grid}.{header,footer}. Now it is fixed.
- Revert: The body of strong/emph is no longer indented.
Playground
- Feature: Added some loadable sample documents.
- Feature: The active output tab is now persisted in the URL.

Core
- Feature: Improved flavor detection for list-like syntaxes.
Previously, flavor detection checked only whether the first space contained a line break, leading to unexpected multiline layout when child expressions contained line breaks or spaces. Now, a list-like syntax is considered multiline only if there is a space containing a line break before its first child expression.
For example, this code was previously treated as multiline due to the line break before ), but now uses the compact layout:
#f(it => it
)
- Feature: Aligned equation flavor detection with other nodes.
For example,
$ a
$
was previously regarded as multiline due to the break before the closing $. Now it formats as
$ a $
enabling inline block switching by adjusting the space after the opening $.
- Feature: Raw blocks are combinable now.
- Feature: Compact layout for markup.
For a content block, strong, or emph node, if its opening boundary is non-breakable, contains no breaks, and has exactly one primary expression (excluding labels, break symbols, and plain text), it is rendered without indentation.
- Feature: Indent the body of strong or emph expressions when not using the compact layout.
- Fix: Corrected misplaced standalone comments in method chains.
In this example,
#(
foo
// comment
.bar()
)
it previously formatted as
#(
foo // comment
.bar()
)
Now the comment correctly stays on its own line.
- Fix: Prevent reflow of text segments that can be parsed as enum item markers.
text 01.
Previously formatted as
text
01.
which created an unintended enum item. Now it remains on one line.
- Fix: Do not insert an extra break at a nil boundary for headings. Now the code
#[= h1]
will not be formatted as
#[
= h1
]
in any case.
Playground
- Feature: Use system color preference as the default theme.
- Feature: Persist the current state (code and options) in the URL for easy sharing.
- Feature: Store source code in local storage; if absent from the URL, the stored code is used as a fallback.
- Feature: Enable in-place formatting (full document or selection) in the source editor.
- Feature: Added a loading spinner and error boundary.
- Feature: Toggle word wrap in the source editor.
- Feature: Option to display only the formatted selection’s output.
- Feature: Reduced indentation size in the output AST/IR from 4 spaces to 2.
Documentation
- Feature: Switched documentation theme from mdBook to Starlight.
- Feature: Added “copy code” support.
Miscellaneous
- Moved the benchmark-results repository to the typstyle-rs organization.

- Due to ci configuration issues, we failed to publish v0.13.15. This release is a re-publish of v0.13.15 with the correct version number.
v0.13.15 - [2025-07-18]
- Feature(CLI): Add --diff option to show unified diff of formatting changes. This allows users to preview what changes would be made before applying formatting.
For example:
typstyle file.typ --diff
Output:
--- file.typ
+++ file.typ
@@ -1,3 +1,3 @@
-#let x=1+2
-#let y=(3*4)
+#let x = 1 + 2
+#let y = (3 * 4)
- Feature: Improve comment handling - line comments are now treated as line suffixes instead of separate lines, resulting in more compact and natural formatting.
For example, The following code will be accepted by typstyle now:
#let result = (x + y) / 2 + 1 // This comment stays on same line
But it will be formatted to this in previous versions. Note that the comment was moved to a new line, which is not ideal for inline comments.
// line width = 40
#let result = (
(x + y) / 2 + 1
) // This comment stays on same line
- Feature: Add support for sharing links in the web playground, making it easier to share formatted code snippets with others for demo or collaboration.
- Performance: Bump prettyless to v0.3.0. This slightly improves performance and lowers memory consumption during formatting.

We now employ prettyless as the layout engine. It provides more features to support us to adopt better layout logic.
- Feature: Long lines after the first line will no longer cause compact layout to fail to fit.
For example:
#figure(caption: [], {
"looooooooooooooooooooooooooong"
})
It now fits in the compact layout regardless of the length of any long line in the code block.
- Feature: We now respect the flavor of arguments in any case, except that the sole argument is a code block, which is always folded. This reverts the behavior of "force folding" when the sole argument is combinable, so that users can freely decide whether the argument should be compact. This change is expected not to affect your code if it is already compact.
For example:
#f(
(1, 2, 3)
)
was formatted to
#f((1, 2, 3))
Now it is kept unchanged given its multiline flavor.
- Bug fix: In code mode, std.table was not recognized as a table function, preventing proper table formatting.
- Bug fix: Fixed incorrect formatting of table functions with empty content blocks.
When table.header or table.footer had no parentheses (()), the formatter would incorrectly add parentheses before empty content blocks. When parenthesized args are empty, the formatter would insert a line break with short line length.
For example:
#table(
columns: 2,
table.header[],
table.footer(),
)
was formatted to:
#table(
columns: 2,
table.header()[],
table.footer(),
)
or with short line length:
#table(
columns: 2,
table.header(

)[],
table.footer(

),
)
- Bug fix: Fixed incorrect handling of trailing content blocks in set rules.
Previously, when there were no parentheses, a following content block would be wrapped by (); when parentheses were already present, any trailing content block was dropped.
For example:
#set circle[1]
#set circle()[1]
#set circle(stroke: blue)[1]
was previously formatted to:
#set circle([1])
#set circle()
#set circle(stroke: blue)

- Bug fix(CI): Fixed a CI misconfiguration that prevented the release of v0.13.12.

- Feature(CLI): (breaking) Removed deprecated format-all command from CLI. This command was previously deprecated and has now been completely removed. Users should use typstyle <dir> -i instead.
- Feature(CLI): Added --timing option to CLI for displaying elapsed time during formatting operations. Users can now monitor the performance of formatting operations with this new debug flag.
- Feature: Empty code blocks no longer get extra spaces added.
For example, #{} will now be formatted as #{} instead of #{ }. This aligns with the behavior of most code formatters.
- Enhancement: Labels are no longer reflowed to the next line with text wrapping enabled.
- Bug fix: Texts spanning multiple lines, such as strings, inline raws, or syntax nodes marked typstyle off are correctly layouted according to their line widths.
- Bug fix: When the last arg of func call is not combinable, the flavor is respect.

- Bug fix: Fixed unexpected semicolon to comma conversion in nested math arguments. Previously, typstyle would incorrectly convert semicolons to commas in complex nested mathematical expressions like $mat(mat(1; 2); mat(3; 4))$.
- Refactor: Extracted WASM features into a separate typstyle-wasm crate. This improves the modular architecture by separating WebAssembly-specific functionality from the core library.
- API Enhancement: Added rendering IR functionality to the formatter. The Formatter now provides a render_ir() method that allows developers to inspect the pretty-printing intermediate representation, which can be useful for debugging and understanding the formatting process.

- Feature: typstyle now evaluates simple constant expressions for table columns. This enhancement allows for better column count calculation in tables. For example, if you have a table with a column count defined as ((1fr,) * 2 + 2 * (auto,)) * 3, typstyle will now correctly interpret this as 12 columns.
- Feature: typstyle now uses soft wrapping for import items. Import statements with long lists of items will now wrap more compact. This aligns with rustfmt's approach to formatting long import lists.
- Feature: typstyle no longer collapses consecutive spaces in markup by default. This change preserves intentional spacing in markup content, maintaining the author's formatting intentions.
- Feature: typstyle no longer adds padding to the last cell in math alignments. For example, in cases() expressions, the formatter will no longer add trailing spaces after the last cell, keeping comments properly aligned without unnecessary padding.
- Enhancement: typstyle now formats tables in most cases, and format headers and footers as tables. This major enhancement provides better support for complex table structures.
- Enhancement: improved detection of table and grid elements. Special rows (header, footer) and cells (cell, hline, vline) are now recognized without needing the grid. or table. prefix.
- Bug fix: typstyle now preserves backslashes in single-row aligned math equations. This addresses a missed case from #294 where expressions like math.equation($ 1 & 2 \ $.body + $ & 4 \ $.body) would incorrectly have their backslashes removed.
- Bug fix: typstyle now handles escape hatch comments (@typstyle off) better in corner cases. Previously, escape hatch did not work for ArrayItem, DictItem, Param, and DestructuringItem. Additionally, @typstyle off no longer penetrates comments, and when it appears before Code or Math, it now only applies to the first non-trivial child instead of the whole syntax node.

- Bug fix: typstyle previously will break inline equations if they has alignments. Now it is fixed. It will never add paddings to align inline equations now.
- Feature: typstyle doesn't enforce trailing backslash in math equations with alignments now.
- Feature: Previously, typstyle will try to put the last argument of a function call in the same line as the function call when certain conditions are met. Now it is enhanced. In this version, if the last argument is an array or a dict, typstyle will only do this if it is the only array/dict argument.

- Cli: typstyle now supports formatting dirs natively. You can use typstyle -i <dir> to format all files in the directory. Given that, typstyle format-all is deprecated and will be removed in the future.
- Cli: typstyle now uses -l or --line-width instead of -c/--column to specify the line width. The -c/--column option is deprecated and will be removed in the future.
- Cli: typstyle now uses --indent-width instead of --tab-width to specify the indent width. The --tab-width option is deprecated and will be removed in the future. However, -t is still available.
- Feature: when --wrap-text is enabled, typstyle will now keep the line breaks after backslashes in markup. Previously, it is not treated specially.
- Feature: typstyle now keep spaces around fractions in math equations. Previously, it always added a space before and after the fraction.

- Bug fix: #272. Previously, typstyle will remove the space between variable and underscore in math equations. \(#mysum _(i=0)\) for example, will be formatted as \(#mysum_(i=0)\). Now it is fixed.
- Enhancement: #273. When formatting math equations with alignments and multiline cells, previous typstyle versions will introduce excessive spaces. Now it is fixed.
- Enhancement: #280. When wrap text is enabled, previous typstyle will mess up the formatting of labels. Now it is fixed.

- Bug fix: Typstyle previously will panic if there is only a space in math function call. Now it is fixed.
- Bug fix: Typstyle previously will not converge if there are multiple newlines in a function call. Now it is fixed.

- Feature: typstyle cli now enables import sorting by default. You can disable it with --no-reorder-import-items flag.
- Feature: typstyle now supports --wrap-text flag to wrap texts in the markup. It is considered as experimental and may not work in all cases. Please report any issues you encounter.
For example, this code:
Let's say you have a long text that needs to be wrapped in the markup. This is a very long sentence that needs to be wrapped in the markup. It should be wrapped in the markup.
Will be formatted as following when column width is 80 and --wrap-text is enabled:
Let's say you have a long text that needs to be wrapped in the markup. This is a
very long sentence that needs to be wrapped in the markup. It should be wrapped
in the markup.
- Feature: typstyle now tries to align &s in math equations, even if the cells are multiline. Currently it it works in most cases, except the following:
- Has multiline Str or Raw descendants.
- Not following a linebreak when in MathDelimited or Args.
- Across args of functions such as cases.
For example, this code:
$
F_n &= sum_(i=1)^n i^2 & n > 0 \
a &< b+1 & forall b < 1
$
Will be formatted as:
$
F_n & = sum_(i=1)^n i^2 & n > 0 \
a & < b+1 & forall b < 1 \
$
- Feature: typstyle now generate more compact result when formatting complex function calls. Similar to what rustfmt does, when the only argument is combinable, it will be put in the same line as the function call. When the last argument is blocky, it will also be put in the same line if possible.
For example, this code:
#figure(
fletcher.diagram(
node-outset: .5em,
node-stroke: .075em,

node(
(+1,0,),
[variable],
radius: 3em,
), // test
))
Will be formatted as:
#figure(fletcher.diagram(
node-outset: .5em,
node-stroke: .075em,

node((+1, 0), [variable], radius: 3em), // test
))
For another example, this code:
#set page(
margin: 0.5in,
footer: context {
if counter(page).display() == "2" {
[test]
} else {
[]
}
}
)
Will be formatted as:
#set page(margin: 0.5in, footer: context {
if counter(page).display() == "2" {
[test]
} else {
[]
}
})
Due to the limitations of the currently used pretty engine, there is still room for improvement in some cases.

- Feature: Unified equation layout and removed indent for non-block equations
- Non-block equations are no longer indented, which works well in most reasonable cases
- Nodes with multiline comments are now treated as multiline
- Improved comment attachment mechanism
- Fix: Improved handling of comments directly in equations and spaces in math
- Correctly handles in-equation comments before and after Math
- Fixed infinite spaces added before // in math
- Fixed extra indent of array args in math
- Optimized spaces handling in MathAttach and MathRoot
- Fix: Addressed list layout issues
- Fixed indent and grouping issues in list layouts
- Fixed missing separators in list layouts mixed with comments

- Feature: Typstyle can format code in markup lines now. Linebreaks are suppressed inside to ensure compact layout.
- Feature: Typstyle can format math equations with comments and hashes now. Previously they are skipped.
- Feature: Improved formatting of math delimited. Linebreaks are kept as is.
- Experimental feature: Typstyle CLI will sort import items in a single import statement if --reorder-import-items is passed. It would be enabled by default in the future.
- Added a 3rd-party typstyle-action maintained by @grayespinoza.

- Bump to typst v0.13.1
- Typstyle now uses braces () instead of parens (()) when the closure body is not a chainable binary expression
#fun(() => {
aaa
})
instead of
#fun(() => (
aaa
))
- Fix mis-format when linebreak \ appears at the end of a inline math equation.
- Fix mis-format when line comment appears in a multiline import statement.

- Bump to typst v0.13.0
- Regression: In typst v0.13.0, PR #5310 changes the parsing behavior of comments when it presenting in list, enum and term list. In this verison, the indent level of the comment in list, enum and term list determined by the next item, not the previous item. For example,
- Fruit
- Apple
- Banana
// - Orange
- Vegetable
- Carrot
- Tomato
will be formatted as this in this version. Note that the // - Orange is misindented. It is indented to the same level as - Vegetable. It works perfectly in previous versions. So if you want to keep the old behavior, please keep using typstyle v0.12.x at this moment.
- Fruit
- Apple
- Banana
// - Orange
- Vegetable
- Carrot
- Tomato

- Feat: add --tab-width cli option to set the number of spaces for indentation. The default value is 2.
- Fix: typstyle-cli now outputs the original source when the input syntax is erroneous.
- Fix: issues with list/enum/term item indent and linebreak with comments are fixed. Now linebreaks in items are preserved. Items in content blocks will be surrounded with linebreaks when necessary (also to avoid ambiguity).
For example, the code
+
+ xyz

-
xyz

- //foo
- xyz
//bar

/ 4:
// 4
/ 44: // 44
444
was incorrectly formatted to
+ + xyz

- xyz

- //foo
- xyz
//bar

/ 4: // 4
/ 44: // 44
444
Now it is correctly unchanged.
And
#{
[- single]
[- indented
- less
]
[- indented
- same
- then less
- then same
]
[- indented
- more
- then same
- then less
]
}
will be correctly formatted to
#{
[- single]
[
- indented
- less
]
[
- indented
- same
- then less
- then same
]
[
- indented
- more
- then same
- then less
]
}

- Fix: typstyle-cli previously add an extra newline at the end of the file. Now it is fixed.
- Fix: typstyle now correctly strip leading spaces in markup
- Feat: typstyle-core now has very basic support for range formatting.

- Fix: typstyle previously incorrectly remove comments in math equations. Now it is fixed.
- Cli:
- typstyle now reports error when the input file is invalid.
- typstyle --check no longer changes the file content.
- Other minor improvements.

No changes. We failed to publish the previous release because of the ci issue.

- Fix: musl build is now statically linked. This fixes the issue that the musl build doesn't work on systems other than alpine.
- Typstyle now break content blocks into multiple lines if they have leading spaces and trailing spaces.
For example, the following code is not formattable by typstyle previously:
#{
let res = if true [ The Result is definitely true. And it is a very long sentence that needs to be broken into multiple lines. ] else [ The Result is definitely false. And it is a very long sentence that needs to be broken into multiple lines. ]
}
Now it will be formatted as:
#{
let res = if true [
The Result is definitely true. And it is a very long sentence that needs to be broken into multiple lines.
] else [
The Result is definitely false. And it is a very long sentence that needs to be broken into multiple lines.
]
}

- Typstyle no longer force single arg function call to be in a single line. Instead, it is determined in a smarter way. And this fixes https://github.com/Enter-tainer/typstyle/issues/143.
- Typstyle will always add newline at the end of the file. Previously, it only adds newline when it already exists.

- Typstyle will format binary expressions as operator chains. Parentheses are added if necessary.
- Formatting chains with comments is supported now. This is the last piece of formatting with comments.
- Dot chains in markup with parentheses will be broken into multiple lines, if the it contains at least two dots and one function calls.
For example, the following code:
#let _is_block(e,fn)=fn==heading or (fn==math.equation and e.block) or (fn==raw and e.has("block") and e.block) or fn==figure or fn==block or fn==list.item or fn==enum.item or fn==table or fn==grid or fn==align or (fn==quote and e.has("block") and e.block)
Will be formatted as this in previous versions:
#let _is_block(e, fn) = (
fn == heading or (fn == math.equation and e.block) or (
fn == raw and e.has("block") and e.block
) or fn == figure or fn == block or fn == list.item or fn == enum.item or fn == table or fn == grid or fn == align or (
fn == quote and e.has("block") and e.block
)
)
Now it will be formatted as:
#let _is_block(e, fn) = (
fn == heading
or (fn == math.equation and e.block)
or (fn == raw and e.has("block") and e.block)
or fn == figure
or fn == block
or fn == list.item
or fn == enum.item
or fn == table
or fn == grid
or fn == align
or (fn == quote and e.has("block") and e.block)
)

- Dot chain related improvement:
- Previously if the last item of a dot chain is a function call, typstyle doesn't indent it correctly. Now it is fixed.
- Previously typstyle formats function calls in dot chains in a very conversative way. Now it is the same as normal function calls.
- Function calls with comments are made formattable.
For example, the following code is not formattable by typstyle previously:
#{
let x = f(
cetz.draw.super-long-name.line(
start: (0, 0),
end: (1, 1), // note
) // my comment
)
}
Now it will be formatted as:
#{
let x = f(
cetz
.draw
.super-long-name
.line(
start: (0, 0),
end: (1, 1), // note
), // my comment
)
}

- Parenthesized expressions with comments can be formatted by typstyle now.
- Closure with comments can be formatted by typstyle now.
- Typstyle will removes unnecessary parentheses if the inner expression is literal, array, dict, destructuring, block, or pattern. For safety, parens around idents are kept.
- Destructuring and params with comments are no longer forced to fold into one line.

- Typstyle can format comments appears in most places. Previously it simply gives up when it encounters comments in these places. Now it can format them correctly.
For example, this code:
#let conf(
title: none, //comments
authors: (),
abstract: [],
lang: "zh", // language
doctype: "book", //comments
doc // my docs
) = {
doc }
Previously typstyle will not format it. Now it will be formatted as:
#let conf(
title: none, //comments
authors: (),
abstract: [],
lang: "zh", // language
doctype: "book", //comments
doc, // my docs
) = {
doc
}
However, there are still some limitations. For more information, see Limitation.
- Fix typstyle previously would format parenthesized patterns incorrectly into none. Now it is fixed.

- Performance improvement(#158, #159 by @QuadnucYard): Typstyle now becomes 10-100x faster than before. Previously formatting tablex source code takes ~500ms, but now it only takes less than 5ms.