{"route":"/en-US-v0.13.1/changelog/0.12.0/","title":"0.12.0","description":"Changes in Typst 0.12.0","part":null,"outline":[{"id":"highlights","name":"Highlights","children":[]},{"id":"layout","name":"Layout","children":[]},{"id":"text","name":"Text","children":[]},{"id":"math","name":"Math","children":[]},{"id":"introspection","name":"Introspection","children":[]},{"id":"model","name":"Model","children":[]},{"id":"bibliography","name":"Bibliography","children":[]},{"id":"visualization","name":"Visualization","children":[]},{"id":"syntax","name":"Syntax","children":[]},{"id":"scripting","name":"Scripting","children":[]},{"id":"styling","name":"Styling","children":[]},{"id":"export","name":"Export","children":[]},{"id":"performance","name":"Performance","children":[]},{"id":"command-line-interface","name":"Command Line Interface","children":[]},{"id":"tooling-and-diagnostics","name":"Tooling and Diagnostics","children":[]},{"id":"symbols","name":"Symbols","children":[]},{"id":"deprecations","name":"Deprecations","children":[]},{"id":"development","name":"Development","children":[]},{"id":"contributors","name":"Contributors","children":[]}],"body":{"kind":"html","content":"Version 0.12.0 (October 18, 2024)
\nHighlights
\n\n- Added support for multi-column floating placement and\nfigures
\n- Added support for automatic line numbering (often used in\nacademic papers)
\n- Typst's layout engine is now multithreaded. Typical speedups are 2-3x for\nlarger documents. The multithreading operates on page break boundaries, so\nexplicit page breaks are necessary for it to kick in.
\n- Paragraph justification was optimized with a new two-pass algorithm. Speedups\nare larger for shorter paragraphs and go up to 6x.
\n- Highly reduced PDF file sizes due to better font subsetting (thanks to\n@LaurenzV)
\n- Emoji are now exported properly in PDF
\n- Added initial support for PDF/A. For now, only the PDF/A-2b profile is\nsupported, but more is planned for the future.
\n- Added various options for configuring the CLI's environment (fonts, package\npaths, etc.)
\n- Text show rules now match across multiple text elements
\n- Block-level equations can now optionally break over multiple pages
\n- Fixed a bug where some fonts would not print correctly on professional\nprinters
\n- Fixed a long-standing bug which could cause headings to be orphaned at the\nbottom of the page
\n
\nLayout
\n\n- Added support for multi-column floating placement and figures via\n
place.scope and figure.scope. Two-column documents should now prefer\nset page(columns: 2) over show: column.with(2) (see the\npage setup guide). \n- Added support for automatic line numbering (often used in\nacademic papers)
\n- Added
par.spacing property for configuring paragraph spacing. This should\nnow be used instead of show par: set block(spacing: ..)\n(Breaking change) \n- Block-level elements like lists, grids, and stacks now show themselves as\nblocks and are thus affected by all block properties (e.g.
stroke) rather\nthan just spacing (Breaking change) \n- Added
block.sticky property which prevents a page break after a block \n- Added
place.flush function which forces all floating figures to be placed\nbefore any further content \n- Added
skew function \n- Added
auto option for page.header and page.footer which results in\nan automatic header/footer based on the numbering (which was previously\ninaccessible after a change) \n- Added
gap and justify parameters to repeat function \n- Added
width and height parameters to the measure function to define\nthe space in which the content should be measured. Especially useful in\ncombination with layout. \n- The height of a
block, image, rect, square, ellipse, or circle can\nnow be specified in fractional units \n- The
scale function now supports absolute lengths for x, y, factor.\nThis way an element of unknown size can be scaled to a fixed size. \n- The values of
block.above and block.below can now be retrieved in context\nexpressions. \n- Increased accuracy of conversions between absolute units (pt, mm, cm, in)
\n- Fixed a bug which could cause headings to be orphaned at the bottom of the\npage
\n- Fixed footnotes within breakable blocks appearing on the page where the\nbreakable block ends instead of at the page where the footnote marker is
\n- Fixed numbering of nested footnotes and footnotes in floats
\n- Fixed empty pages appearing when a context expression wraps whole pages
\n- Fixed
set block(spacing: x) behaving differently from\nset block(above: x, below: x) \n- Fixed behavior of
rotate and scale with reflow: true \n- Fixed interaction of
align(horizon) and v(1fr) \n- Fixed various bugs where floating placement would yield overlapping results
\n- Fixed a bug where widow/orphan prevention would unnecessarily move text into\nthe next column
\n- Fixed weak spacing not being trimmed at the start and end of lines\nin a paragraph (only at the start and end of paragraphs)
\n- Fixed interaction of weak page break and
pagebreak.to \n- Fixed compilation output of a single weak page break
\n- Fixed crash when padding by
100% \n
\nText
\n\n- Tuned hyphenation: It is less eager by default and hyphenations close to the\nedges of words are now discouraged more strongly\n(May lead to larger layout reflows)
\n- New default font: Libertinus Serif. This is the maintained successor to the\nold default font Linux Libertine. (May lead to smaller reflows)
\n- Setting the font to an unavailable family will now result in a warning
\n- Implemented a new smart quote algorithm, fixing various bugs where smart\nquotes weren't all that smart
\n- Added
text.costs parameter for tweaking various parameters that affect the\nchoices of the layout engine during text layout \n- Added
typm highlighting mode for math in raw blocks \n- Added basic i18n for Galician, Catalan, Latin, Icelandic, Hebrew
\n- Implemented hyphenation duplication for Czech, Croatian, Lower Sorbian,\nPolish, Portuguese, Slovak, and Spanish.
\n- The
smallcaps function is now an element function and can thereby be used\nin show(-set) rules. \n- The
raw.theme parameter can now be set to none to disable highlighting\neven in the presence of a language tag, and to auto to reset to the\ndefault \n- Multiple stylistic sets can now be enabled at once
\n- Fixed the Chinese translation for "Equation"
\n- Fixed that hyphenation could occur outside of words
\n- Fixed incorrect layout of bidirectional text in edge cases
\n- Fixed layout of paragraphs with explicit trailing whitespace
\n- Fixed bugs related to empty paragraphs created via
#"" \n- Fixed accidental trailing spaces for line breaks immediately preceding an\ninline equation
\n- Fixed
text.historical-ligatures not working correctly \n- Fixed accidental repetition of Thai characters around line breaks in some\ncircumstances
\n- Fixed smart quotes for Swiss French
\n- New font metadata exceptions for Archivo, Kaiti SC, and Kaiti TC
\n- Updated bundled New Computer Modern fonts to version 6.0
\n
\nMath
\n\n- Block-level equations can now break over multiple pages if enabled via\n
show math.equation: set block(breakable: true). \n- Matrix and vector sizing is now more consistent across different cell contents
\n- Added
stretch function for manually or automatically\nstretching characters like arrows or parentheses horizontally or vertically \n- Improved layout of attachments on parenthesized as well as under- or overlined\nexpressions
\n- Improved layout of nested attachments resulting from code like\n
#let a0 = $a_0$; $a0^1$ \n- Improved layout of primes close to superscripts
\n- Improved layout of fractions
\n- Typst now makes use of math-specific height-dependent kerning information in\nsome fonts for better attachment layout
\n- The
floor and ceil functions in math are now callable symbols, such that\n$ floor(x) = lr(floor.l x floor.r) $ \n- The
mat.delim, vec.delim, and\ncases.delim parameters now allow any character that is\nconsidered a delimiter or "fence" (e.g. |) by Unicode. The delim: "||"\nnotation is not supported anymore and should be replaced by\ndelim: bar.double (Minor breaking change) \n- Added
vec.align and mat.align\nparameters \n- Added
underparen, overparen,\nundershell, and overshell \n- Added
~ shorthand for tilde.op in math mode (Minor breaking change) \n- Fixed baseline alignment of equation numbers
\n- Fixed positioning of corner brackets (⌜, ⌝, ⌞, ⌟)
\n- Fixed baseline of large roots
\n- Fixed multiple minor layout bugs with attachments
\n- Fixed that alignment points could affect line height in math
\n- Fixed that spaces could show up between text and invisible elements like\n
metadata in math \n- Fixed a crash with recursive show rules in math
\n- Fixed
lr.size not affecting characters enclosed in\nmid in some cases \n- Fixed resolving of em units in sub- and superscripts
\n- Fixed bounding box of inline equations when a text edge is\nset to
"bounds" \n
\nIntrospection
\n\n- Implemented a new system by which Typst tracks where elements end up on the\npages. This may lead to subtly different behavior in introspections.\n(Breaking change)
\n- Fixed various bugs with wrong counter behavior in complex layout situations,\nthrough a new, more principled implementation
\n- Counter updates can now be before the first, in between, and after the last\npage when isolated by weak page breaks. This allows, for instance, updating a\ncounter before the first page header and background.
\n- Fixed logical ordering of introspections within footnotes and figures
\n- Fixed incorrect
here().position() when place was used in a\ncontext expression \n- Fixed resolved positions of elements (in particular, headings) whose show rule\nemits an invisible element (like a state update) before a page break
\n- Fixed behavior of stepping a counter at a deeper level than its current state\nhas
\n- Fixed citation formatting not working in table headers and a few other places
\n- Displaying the footnote counter will now respect the footnote numbering style
\n
\nModel
\n\n- Document set rules do not need to be at the very start of the document\nanymore. The only restriction is that they must not occur inside of layout\ncontainers.
\n- The
spacing property of lists,\nenumerations, and term lists is now also\nrespected for tight lists \n- Tight lists now only attach (with tighter spacing) to preceding paragraphs,\nnot arbitrary blocks
\n- The
quote element is now locatable (can be used in queries) \n- The bibliography heading now uses
depth instead of level so that its level\ncan still be configured via a show-set rule \n- Added support for more numbering formats: Devanagari, Eastern Arabic,\nBengali, and circled numbers
\n- Added
hanging-indent parameter to heading\nfunction to tweak the appearance of multi-line headings and improved default\nappearance of multi-line headings \n- Improved handling of bidirectional text in outline entry
\n- Fixed document set rules being ignored in an otherwise empty document
\n- Fixed document set rules not being usable in context expressions
\n- Fixed bad interaction between
set document and set page \n- Fixed
show figure: set align(..). Since the default figure alignment is\nnow a show-set rule, it is not revoked by show figure: it => it.body\nanymore. (Minor breaking change) \n- Fixed numbering of footnote references
\n- Fixed spacing after bibliography heading
\n
\nBibliography
\n\n- The Hayagriva YAML
publisher field can now accept a dictionary with a\nlocation key. The top-level location key is now primarily intended for\nevent and item locations. \n- Multiple page ranges with prefixes and suffixes are now allowed
\n- Added
director and catch-all editor types to BibLaTeX parsing \n- Added support for disambiguation to alphanumeric citation style
\n- The year 0 will now render as 1BC
\n- Fixes for sorting of bibliography entries
\n- Fixed pluralization of page range labels
\n- Fixed sorting of citations by their number
\n- Fixed how citation number ranges collapse
\n- Fixed when the short form of a title is used
\n- Fixed parsing of unbalanced dollars in BibLaTeX
url field \n- Updated built-in citation styles
\n
\nVisualization
\n\n- Added
fill-rule parameter to path and\npolygon functions \n- Fixed color mixing and gradients for Luma colors
\n- Fixed conversion from Luma to CMYK colors
\n- Fixed offset gradient strokes in PNG export
\n- Fixed unintended cropping of some SVGs
\n- SVGs with foreign objects now produce a warning as they will likely not render\ncorrectly in Typst
\n
\nSyntax
\n\n- Added support for nested imports like
import "file.typ": module.item \n- Added support for parenthesized imports like
import "file.typ": (a, b, c).\nWith those, the import list can break over multiple lines. \n- Fixed edge case in parsing of reference syntax
\n- Fixed edge case in parsing of heading, list, enum, and term markers\nimmediately followed by comments
\n- Fixed rare crash in parsing of parenthesized expressions
\n
\nScripting
\n\n- Added new fixed-point
decimal number type for highly precise arithmetic on\nnumbers in base 10, as needed for finance \n- Added
std module for accessing standard library definitions even when a\nvariable with the same name shadows/overwrites it \n- Added
array.to-dict, array.reduce, array.windows methods \n- Added
exact argument to array.zip \n- Added
arguments.at method \n- Added
int.from-bytes, int.to-bytes, float.from-bytes, and\nfloat.to-bytes \n- Added proper support for negative values of the
digits parameter of\ncalc.round (the behaviour existed before but was subtly broken) \n- Conversions from
int to float will now error instead of saturating if\nthe float is too large (Minor breaking change) \n- Added
float.nan and float.inf, removed calc.nan\n(Minor breaking change) \n- Certain symbols are now generally callable like functions and not only\nspecifically in math. Examples are accents or
floor and\nceil. \n- Improved
repr of relative values, sequences, infinities, NaN,\ntype(none) and type(auto) \n- Fixed crash on whole packages (rather than just files) cyclically importing\neach other
\n- Fixed return type of
calc.round on integers when a non-zero value is\nprovided for digits \n
\nStyling
\n\n- Text show rules now match across multiple text elements
\n- The string
" in a text show rule now matches smart quotes \n- Fixed a long-standing styling bug where the header and footer would\nincorrectly inherit styles from a lone element on the page (e.g. a heading)
\n- Fixed
set page not working directly after a counter/state update \n- Page fields configured via an explicit
page(..)[..] call can now be\nproperly retrieved in context expressions \n
\nExport
\n\n- Highly reduced PDF file sizes due to better font subsetting
\n- Emoji are now exported properly in PDF
\n- Added initial support for PDF/A. For now, only the standard PDF/A-2b is\nsupported, but more is planned for the future. Enabled via
--pdf-standard a-2b in the CLI and via the UI in File > Export as > PDF in the web app. \n- Setting
page.fill to none will now lead to transparent pages instead\nof white ones in PNG and SVG. The new default of auto means transparent\nfor PDF and white for PNG and SVG. \n- Improved text copy-paste from PDF in complex scenarios
\n- Exported SVGs now contain the
data-typst-label attribute on groups resulting\nfrom labelled boxes and blocks \n- Fixed a bug where some fonts would not print correctly on professional\nprinters
\n- Fixed a bug where transparency could leak from one PDF object to another
\n- Fixed a bug with CMYK gradients in PDF
\n- Fixed various bugs with export of Oklab gradients in PDF
\n- Fixed crashes related to rendering of non-outline glyphs
\n- Two small fixes for PDF standard conformance
\n
\n\n\n- Typst's layout engine is now multithreaded. Typical speedups are 2-3x for\nlarger documents. The multithreading operates on page break boundaries, so\nexplicit page breaks are necessary for it to kick in.
\n- Paragraph justification was optimized with a new two-pass algorithm. Speedups\nare larger for shorter paragraphs and range from 1-6x.
\n
\nCommand Line Interface
\n\n- Added
--pages option to select specific page ranges to export \n- Added
--package-path and --package-cache-path as well as\nTYPST_PACKAGE_PATH and TYPST_PACKAGE_CACHE_PATH environment variables for\nconfiguring where packages are loaded from and cached in, respectively \n- Added
--ignore-system-fonts flag to disable system fonts fully for better\nreproducibility \n- Added
--make-deps argument for outputting the dependencies of the current\ncompilation as a Makefile \n- Added
--pretty option to typst query, with the default now being to minify\n(only applies to JSON format) \n- Added
--backup-path to typst update to configure where the previous\nversion is backed up \n- Added useful links to help output
\n- The CLI will now greet users who invoke just
typst for the first time \n- The document can now be written to stdout by passing
- as the output\nfilename (for PDF or single-page image export) \n- Typst will now emit a proper error message instead of failing silently when\nthe certificate specified by
--cert or TYPST_CERT could not be loaded \n- The CLI now respects the
SOURCE_DATE_EPOCH environment variable for better\nreproducibility \n- When exporting multiple images, you can now use
t (total pages), p\n(current page), and 0p (zero-padded current page, same as current n)\nin the output path \n- The input and output paths now allow non-UTF-8 values
\n- Times are now formatted more consistently across the CLI
\n- Fixed a bug related to the
--open flag \n- Fixed path completions for
typst not working in zsh \n
\n\n\n- The "compiler" field for specifying the minimum Typst version required by a\npackage now supports imprecise bounds like 0.11 instead of 0.11.0
\n- Added warning when a label is ignored by Typst because no preceding labellable\nelement exists
\n- Added hint when trying to apply labels in code mode
\n- Added hint when trying to call a standard library function that has been\nshadowed/overwritten by a local definition
\n- Added hint when trying to set both the language and the region in the
lang\nparameter \n- Added hints when trying to compile non-Typst files (e.g. after having typed\n
typst c file.pdf by accident) \n- Added hint when a string is used where a label is expected
\n- Added hint when a stray end of a block comment (
*/) is encountered \n- Added hints when destructuring arrays with the wrong number of elements
\n- Improved error message when trying to use a keyword as an identifier in a let\nbinding
\n- Improved error messages when accessing nonexistent fields
\n- Improved error message when a package exists, but not the specified version
\n- Improved hints for unknown variables
\n- Improved hint when trying to convert a length with non-zero em component to an\nabsolute unit
\n- Fixed a crash that could be triggered by certain hover tooltips
\n- Fixed an off-by-one error in to-source jumps when first-line-indent is enabled
\n- Fixed suggestions for
. after the end of an inline code expressions \n- Fixed autocompletions being duplicated in a specific case
\n
\nSymbols
\n\n- New:
parallelogram, original, image, crossmark, rest, natural,\nflat, sharp, tiny, miny, copyleft, trademark, emoji.beet,\nemoji.fingerprint, emoji.harp, emoji.shovel, emoji.splatter,\nemoji.tree.leafless, \n- New variants:
club.stroked, diamond.stroked, heart.stroked,\nspade.stroked, gt.neq, lt.neq, checkmark.heavy, paren.double,\nbrace.double, shell.double, arrow.turn, plus.double, plus.triple,\ninfinity.bar, infinity.incomplete, infinity.tie, multimap.double,\nballot.check, ballot.check.heavy, emptyset.bar, emptyset.circle,\nemptyset.arrow.l, emptyset.arrow.r, parallel.struck, parallel.eq,\nparallel.equiv, parallel.slanted, parallel.tilde, angle.l.curly,\nangle.l.dot, angle.r.curly, angle.r.dot, angle.oblique, angle.s,\nem.two, em.three \n- Renamed:
turtle to shell, notes to note, ballot.x to ballot.cross,\nsucc.eq to succ.curly.eq, prec.eq to prec.curly.eq, servicemark to\ntrademark.service, emoji.face.tired to emoji.face.distress\n(Breaking change) \n- Changed codepoint:
prec.eq, prec.neq, succ.eq, succ.neq, triangle\nfrom ▷ to △, emoji.face.tired (Breaking change) \n- Removed:
lt.curly in favor of prec, gt.curly in favor of succ\n(Breaking change) \n
\nDeprecations
\n\nDevelopment
\n\n- Added
typst-kit crate which provides useful APIs for World implementors \n- Added go-to-definition API in
typst-ide \n- Added package manifest parsing APIs to
typst-syntax \n- As the compiler is now capable of multithreading,
World implementations must\nsatisfy Send and Sync \n- Changed signature of
World::main to allow for the scenario where the main\nfile could not be loaded \n- Removed
Tracer in favor of Warned<T> and typst::trace function \n- The
xz2 dependency used by the self-updater is now statically linked \n- The Dockerfile now has an
ENTRYPOINT directive \n
\nContributors
"}}