Skip to main content

Changelog

v0.8.1​

A patch release with fixes and a few corrections to behaviour that 0.8.0 introduced.

Behaviour changes​

  • An em dash between inline content no longer splits slides

    A — or --- with inline content on both sides, such as Text — code``, stays part of the sentence. Before, it was read as a horizontal line, which started a new slide and dropped the dash. Inline content is text, symbols such as ~, raw, math, emphasis, links, references, citations, footnotes, boxes and similar. A dash next to a blank line, a heading, any other block or a touying marker or wrapper such as #pause or #alert[..] still splits slides.

    Migration: where a break is wanted, put a blank line or a heading around ---.

  • A bare waypoint label picks its last subslide in three places

    A bare label in handout-subslides keeps the last subslide of the waypoint, as the label of touying-recall on labelled content does. measure takes the largest size over the waypoint's range. The range markers from-wp, until-wp and not-wp keep every subslide they span, so not-wp(not-wp(<a>)) is exactly the range of <a>. handout-subslides: "waypoints" selects the last subslide of every waypoint.

    Migration: where you need other subslides than the last one, use a range marker such as from-wp, until-wp or not-wp.

  • Footnote numbering restarts per slide, not per page

    reset-footnote-number-per-slide now restarts the numbering only at the start of a slide, and counter(footnote) is one of the default frozen counters, so the numbers stay the same on every subslide. Before, the counter was reset on every page. A breakable slide that overflowed onto a second page restarted at 1 there, and with reset-footnote-number-per-slide: false the numbers of a slide ran ahead from one subslide to the next. Now overflow pages keep counting, and with false the numbering continues across slides while staying identical across the subslides of one slide.

  • touying-reduce works with alchemist 0.2.0

    A package's own touying-reducer-bindings are used when reduce and cover are both functions. Otherwise touying uses the bindings it has for the package's name.

  • Slide Preambles are now called again and preambles will be reworked soon together with more external hooks slide-preamble and default-slide-preamble are called again (they were silently dropped in March 2026). A slide now starts with preamble (first slide only), then slide-preamble, then the content a deferred config change collected in front of the slide, which used to run first. And finally the subslide preamble. These all run after the header is constructed, only the page-preamble is run before the header (old behaviour).

    Bc preambles were not easy to use for external packages they will be reworked soon in a rework that aims to allow better 3rd party package integration. The touying-reducer-bindings will stay, but other hooks will be added.

Fixes​

  • #heading[..] outside a slide call no longer fails with field "depth" in heading is not known at this point (#434, #437).
  • A #figure without a caption that is hidden by a #pause no longer fails with field "caption" in figure is not known at this point (#437).
  • animate, animate-hidden, animate-removed and item-by-item-fn are now listed in default methods through self.methods and utils.methods(self) just like uncover and only.
  • capitalize and titlecase work on non-ASCII input (#436).
  • Reducers announce the inner minimum repetitions and function wrappers of their content (#431).
  • Aligned content no longer shifts when paused list items are revealed (#442).
  • measure of a list applies the row gap, so show-set rules take effect (#443).
  • The numbers of an enum with a #pause stay aligned: the covered and the visible part get the same number column width, so items no longer move sideways when the covered part is revealed (#438).
  • touying-mitex keeps the height of a line break that is still hidden, so the visible lines no longer move sideways when the next line is revealed.
  • A #meanwhile between list items after an earlier #pause no longer splits the list, so the rows no longer move when the next subslide is shown (#439).
  • The ctheorems 2.x states are frozen across subslides (#452, #454). Support for ctheorems 1.x is deprecated and will be removed in v0.9.0.
  • The documentation of until-wp and from-wp now says what they do: until-wp stops before the first subslide of the waypoint, from-wp includes it and runs to the end.
  • The API reference lists the functions of src/core/*.typ and touying-slides, and the documentation of each release is published by the new docs-release workflow.

v0.8.0​

A big release, and the first that requires Typst 0.15.

The main new feature is article mode: the same source file compiles either to slides or to a flowing prose document, with animations collapsed to their final state and images optionally floated to the side. Two new animation entry points come with it. touying-render renders a piece of content at chosen animation stages, and animate combines visibility and styling on one piece of content. touying-recall was extended from whole slides to any labelled element. touying-fn-wrapper-raw now parses and nests its body, so #alert[.. #pause ..] works, and much more besides. .pdfpc files can be written directly as bundle assets instead of through a separate typst query step. The footnote bibliography was rebuilt on real Typst bibliographies, and the speaker-note panel is now a theme-supplied function with documentation to match. Internally, src/core.typ (6288 lines) was split into modules and the content handling was unified and several functions (mainly out of utils) moved places.

Things to watch when upgrading: a #pause after uncover/only/alternatives no longer skips the subslides they reserve (they wrongfully did so with v0.7.0), the footnote-bibliography config changed shape, semi-transparent-cover is deprecated, and on a second screen the page background is confined to the slide half. There is a migration guide below, and a separate one for theme authors at the end. Most documentation pages were rewritten or corrected.

Breaking Changes​

  • feat!: Touying now requires Typst 0.15.0

    typst.toml's compiler field goes from 0.12.0 to 0.15.0. Bundle export for .pdfpc assets and the reworked cover methods both need it. All reference renders were regenerated against Typst 0.15 / tytanic 0.4.

  • fix!: a #pause after uncover/only/alternatives no longer skips the subslides they reserve

    #uncover("2")[Only on subslide 2]
    On subslide one
    #pause
    On subslide two // v0.7.0-v0.7.4: on subslide *three*

    Up to v0.6.x a relative jump advanced the counter by one. v0.7.0 changed it to snap past the highest subslide any preceding fn-wrapper had reserved. That was meant for item-by-item, which stands in for a run of pauses and should push a later #pause past its whole animation. But item-by-item reports its extent through the same channel as every other wrapper, so the change caught uncover, only and alternatives as well. No test asserted it and it slipped past. Reserving subslides and consuming them are separate things again.

    Waypoint placement gets the same correction. #waypoint(<w>) after an #uncover("5") now lands one past the current flow position, not one past subslide 5.

    Migration: if you relied on the snap, add the extra #pause (or #jump(n, relative: true) or waypoints) yourself. item-by-item and item-by-item-fn are unaffected. They still push later pauses past their last item, and they now match the hand-written #pause sequence they abbreviate, including for content that follows them without any #pause.

  • feat!: show-bibliography-as-footnote is a boolean, and magic.bibliography() is gone

    The old mechanism took the bibliography element itself, as config-common(show-bibliography-as-footnote: bibliography("ref.bib")), hid it in the preamble, collected the entries into a state, and re-rendered them through magic.bibliography(). That state is gone. Set the flag and call a real #bibliography(..) in the presentation:

    #show: simple-theme.with(
    config-common(show-bibliography-as-footnote: true),
    )

    == References
    #bibliography("ref.bib")

    The bibliography has to be part of the document for the footnote citations to resolve. Use hide(bibliography(..)) if you do not want the reference list shown. Multiple bibliographies work now, and #395, where a footnote bibliography that overflowed its slide stopped the document converging, is fixed as a result. If your citation style already produces notes, such as "chicago-notes", leave the flag at false. See the FAQ.

    magic.bibliography-as-footnote loses its bibliography parameter and gains footnote-style, a dictionary of super properties for the citation markers. The default (typographic: false, baseline: 0em, size: 1em) makes them read as normal text.

  • feat!: the speaker-note panel is customizable through config-common(notes-fn: ..); the config-methods(show-only-notes: ..) renderer is removed (#353)

    show-only-notes was two separate options in v0.7.4 and only one of them changes. config-common(show-only-notes: true), the flag that turns on presenter view, works as before, and is documented for the first time in Speaker Notes. What is gone is config-methods(show-only-notes: ..), the function that drew the panel. Only theme authors ever overrode it.

    The panel is now produced by a theme-supplied function, the way slides are produced by slide-fn. notes-fn(self: none, note: none, slide-preview: none) -> content mirrors slide-fn, and touying-notes is the counterpart of touying-slide: it owns the rough layout, the theme passes colours and arranges the content. All six bundled themes register their own, so the notes panel matches the deck in spirit. Some alignment bugs will be fixed later.

    show-only-notes mode was restructured along with it. The slide's parts, previously shown on the top right, are reassembled into one page-sized box and handed to the theme as slide-preview content to place where and scale how it likes. The old cutout / cutout-height / (background, foreground) return protocol is gone, and slide-preview: none tells a theme it is on a second screen. This also fixes #281: the panel background was placed from the page header and nearly all of it fell off-page, so the declared #CCCCCC/#E6E6E6 colours never rendered.

    See Customizing the Speaker-Note Panel and Build Your Own Theme.

  • fix!: the page background and foreground are confined to the slide half on a second screen (#219)

    With show-notes-on-second-screen, Touying doubles the page along one axis and pushes the extra half into the margin (Now all four alignments are supported). page(background: ..) covers the whole page, so a background sized 100%, or an image with fit: "cover", was stretched across the slide and the notes half together. background and foreground are now each placed in a box the size of one slide, on the slide's own half, so percentage sizes and fit: "cover" behave as they do without a second screen.

  • feat!: touying-recall's subslide: parameter becomes subslides:, and its none/auto values swap

    The parameter is now plural because it takes ranges (since v0.6.3) rather than a single subslide, matching visible-subslides on uncover/only/effect. It accepts a superset of the old values.

    subslides: auto is the new default. It recalls all subslides of a whole-slide target, or the final animation state of a labelled element. subslides: none recalls only the last subslide. v0.7.4 had these the other way round, with none as the default, so the default behaviour is unchanged. Only code that passed either value explicitly needs the value swapped as well as the key renamed.

Minor Breaking Changes​

  • feat!: utils.semi-transparent-cover is deprecated — use utils.alpha-changing-cover or utils.color-changing-cover

    It worked by overlaying a semi-transparent rectangle on the covered content, which does not hold up in general: the overlay dims the slide background along with the content, and it stacks where covered regions overlap. It still renders, (slightly worse than the last iterations) so presentations keep compiling. Builds that use --warnings promote will however fail.

    // Before
    config-methods(cover: utils.semi-transparent-cover)
    // After: a real alpha cover, with an automatic fallback for content it cannot recolour
    config-methods(cover: utils.alpha-changing-cover)
    // Or, cheaper to compile, flattening everything to one colour
    config-methods(cover: utils.color-changing-cover.with(color: gray))

    Passing it as another cover method's fallback-hide function is still fine and does not warn. utils.cover-with-rect does also not warn.

  • fix!: utils.handout-only is removed — use the top-level #handout-only[..]. It is a parser mark rather than a callback, so it can contain slide-breaking content. See Handout Mode.

  • fix!: negative subslide indices now panic on the animation functions instead of silently doing the wrong thing.

    A negative index means "counted back from the last subslide", which only has a stable meaning once the subslide count is fixed. config-common(handout-subslides: -1), #touying-recall(.., subslides: -1) and #touying-render(.., subslides: -1) resolve their spec after parsing has settled the count, so they accept negatives.

    #only, #uncover, #effect, #alternatives, #alternatives-match, #alternatives-cases, #animate and #item-by-item are parsed as part of the flow they sit in, and now a negative index is panicked on, not ignored. Use waypoints if you need such behaviour.

    // Before: rendered nothing, silently
    #only(-1)[Last]
    // After: a waypoint names the position and keeps naming it
    A #pause B #waypoint(<end>) C
    #only(get-last(<end>))[Last]

    #waypoint(start:) is restricted the same way and now requires a position >= 1. Reference another waypoint by label to position one relative to another.

    Note: Negative numbers in a string spec are a different notation and are unaffected: "-2" is the open range "up to subslide 2", not "second from last".

  • fix: overflow detection also checks width. It only ever compared height, so an element too wide to fit, a fixed-width block level element did not trigger an overflow warning.

  • feat!: touying-equation is finally deprecated. All its uses are superseded through other means and the normal equation animations are even more capable now allowing you to write animation functions all math layout function like mat or frac.

  • feat!: config-common(detect-overflow:) defaults to auto (was true). This is the opposite of what is set for breakable and in case both are true a warning is emitted that no overflow can be detected.

  • feat!: #measure shadows std.measure and also measures animated content properly It still works as expected, needing a surrounding layout or context, and in addition to a width and height optionally supports an integer subslide and an integer base which set the subslide and subslide base to render the content at before it is measured.

  • feat!: reducer bindings are lambdas taking the package module, instead of a path spelled as an array of strings with optional trailing arguments(..).

    // Before
    #let touying-reducer-bindings = (
    reduce: ("canvas",),
    cover: ("draw", "hide", arguments(bounds: true)),
    )
    // After
    #let touying-reducer-bindings = (
    reduce: module => module.canvas,
    cover: module => module.draw.hide.with(bounds: true),
    )

    The old no longer works and this is also the shape touying-reduce now expects.

Migration Guide​

  1. Bump your compiler to Typst 0.15.0 or newer.
  2. Bibliography: replace config-common(show-bibliography-as-footnote: bibliography("ref.bib")) with config-common(show-bibliography-as-footnote: true) and put a real #bibliography("ref.bib") in the presentation. Delete any #magic.bibliography(..) call. If the bibliography sits on a slide with more than one subslide, wrap it as only("h", bibliography("ref.bib")) so it is instantiated once. Otherwise each subslide creates a fresh instance and the citation numbering restarts (#415).
  3. Speaker notes: if you overrode the config-methods(show-only-notes: ..) renderer, rewrite it as config-common(notes-fn: ..) built on top of touying-notes. config-common(show-only-notes: true) needs no change.
  4. Second screen: if a theme painted behind the notes half through config-page(background: ..), move that styling into its notes-fn (fill / header-fill on touying-notes).
  5. touying-recall: rename subslide: to subslides:. If you passed none or auto explicitly, swap it for the other one. If you relied on the default, nothing changes.
  6. Covers: replace config-methods(cover: utils.semi-transparent-cover) with utils.alpha-changing-cover or utils.color-changing-cover. Leaving it is a warning rather than an error, unless you build with --warnings promote.
  7. Pause flow: see the first breaking entry. Add an explicit #pause or #jump, or use waypoints, where you relied on a fn-wrapper snapping the counter forward.

Features​

  • feat: article mode, one source file for slides or a flowing article

    Compiling with config-common(export-mode: "article"), or with typst compile slides.typ --input export-mode=article, renders the whole deck as a continuous document instead of pages: no slide breaks, animations collapsed to their final state, images optionally floated to the side. export-mode accepts "slides" (the default, where the handout flag decides), "presentation", "handout" and "article". config-common(article-mode: true) is the raw switch behind it.

    Article mode linearizes a deck rather than carrying its layout over, so a composer's columns become flowing text and a floated element takes config-article(wrap: (width: ..)) of the text width, 50% by default, whatever width it was written at for the slide. See Article Mode.

    #show: simple-theme.with(
    config-common(
    export-mode: "article",
    article-theme: themes.article.article-theme.with(numbering: "1.1"),
    ),
    config-article(
    wrap: (image: true),
    available-fields: (title: "info.title"),
    ),
    )

    Two markers let you write for the article target. #article-text[..] replaces the content of the slide it is written in, wherever in that slide you write it, so you can give a prose paragraph instead of bullet points. #article-only[..] adds content that appears only in the article (for more see mode-only content below). The new config-article(..) group covers article-side layout: wrap for side-floating (done with meander) of certain elements; linearize for how much of the deck's layout comes apart (by default a #columns(..), a composer and a side-by-side do; a table or grid only until it declares a header or footer), #article-linearize[..] / #article-keep-layout[..] mark this per element; plus an optional title-block-fn, and lastly available-fields: a mapping that hands configuration values such as info.title through to the article theme's own parameters. See Docs/Article Mode for more details.

  • feat: themes.article, a plain A4 article theme

    The default target of article-theme: auto. It does not depend on the presentation framework, so it also works standalone for papers and reports. It is meant as an example; any article-like theme can be used instead.

  • feat: animations work inside math elements — frac, mat, vec, cases, binom, root, attach, accent, cancel, lr and the brace family.

    #pause, #uncover, #only and #alternatives inside one of these used to abort the compile with Unsupported mark, claiming the mark was somewhere the walk could not enter. It was reachable all along: these elements keep their sub-content in named fields of their own (frac's num/denom, mat's rows, attach's scripts) rather than in body or children, and the content walk only knew the latter two, so it treated them as leaves.

    $ frac(a #pause + b, c) $
    $ mat(a, #pause b; c, d) $
    $ a^(2 #pause + 1) $

    Styling fields are untouched by this: an animated mat keeps its delim and row-gap, an accent its size and dotless. The one thing that cannot animate is an accent's accent argument, which Typst stores as a single symbol rather than as content — swap the whole element with #alternatives instead.

  • feat: mode-only content and mode labels

    Four inline markers select content by output target: #article-only[..], #handout-only[..], #presentation-only[..] and #slides-only[..], the last meaning both slide modes but not the article. Hidden content is removed entirely and reserves no space, and the body can contain slide-breaking elements, so a heading inside #handout-only[..] really does start a new slide in handout mode.

    A marker works inside a slide's body as well as around the call, and which one you write decides what it covers: #slide[a #slides-only[b] c] keeps b out of the article and leaves the rest, while #slides-only(slide[a b c]) keeps the whole slide out. #article-text[..] inside a slide stands in for that slide, matching what it does at document level. See Output Modes.

    The same choice exists per slide as heading and slide labels: <touying:presentation>, <touying:handout>, <touying:slides> and <touying:article>, combinable with hyphens, where <touying:presentation-article> means "or". The new <touying:never> is the Typst equivalent of \iffalse. It parks a slide out of every render without you having to comment out markup. See Handout Mode and Sections and Headings.

  • feat: touying-recall recalls any labelled element, not just whole slides

    Besides a whole slide, #touying-recall(<lbl>) now takes a labelled reducer, a labelled diagram, or any labelled animated content as well, and replays it at a chosen stage:

    #touying-recall(<my-slide>, subslides: "waypoints")  // one subslide per waypoint
    #touying-recall(<my-diagram>, subslides: 1) // a reducer at stage 1
    #touying-recall(<my-table>) // plain labelled content

    Subslide selection accepts ints, including negative indices counted back from the last subslide, waypoint labels, and waypoint markers (get-first, get-last, prev-wp, next-wp), resolved against the recalled content's own waypoints. Recalling an element places it inline; only recalling a whole slide starts a new page. And a recall can sit inside #only/#uncover/#alternatives anywhere in their body, not just as the whole body, and base: sets the starting repetition counter for content with its own numbered steps.

  • feat: touying-render renders content at a chosen animation stage, or steps through a range

    Where touying-recall looks up previous content by label, touying-render takes the content value directly. It is useful for miniature previews or for showing a diagram's intermediate state in the article output and probably much more. You can even render entire slide contents with it.

    #touying-render(body, subslides: "2-4")   // steps through 2, 3 and 4
    #touying-render(body, subslides: "!2-3") // skips 2-3, collapsing the gap
    #touying-render(body, subslides: <wp>) // the waypoint's whole range

    A single-point spec, such as a plain int, get-first or get-last, freezes one stage. subslides: auto follows the enclosing slide's own progression. base: offsets the content's internal pause numbering, start: sets where in the enclosing slide the first subslide rendered begins, and repeat-last: controls whether the content holds at its final stage (the default) or disappears again.

  • feat: animate, for combining visibility and styling on one piece of content

    #animate(
    [The original],
    effects: (
    (effect: "cover", subslides: "-2"),
    (effect: swap[Something else], subslides: 3),
    (effect: (body, ..) => text(red, body), subslides: "4-", priority: 2),
    ),
    )

    Placements ("show", "cover", "remove", swap(..)) resolve to a single winner per subslide. They cannot be composed: the only cover method is hide, which is not a style node, and "remove" drops the content outright, so neither can be undone from inside. If you need alpha-changed covered content use styling effect functions instead. Styling functions do compose and nest. Priority picks the winning placement and orders the nesting, and ties break consistently in both classes: the last effect you wrote wins. For a placement that means it is the one used; for a style it means it ends up innermost, so it wins any property both of them set. swap takes stretch, like alternatives does: without it the layout reflows while the swap is shown, with it the swap joins the reserved space and the block keeps one size. Measuring only happens if some swap sets stretch, and each distinct combination of placement and styles is measured once. animate-hidden and animate-removed are the same function starting from "cover" and "remove", respectively, instead of "show", so effects by default say when the body appears rather than when it disappears. You can of course override this in any case, these are just shorthands.

  • feat: advances-flow on touying-fn-wrapper, for wrappers that stand in for a run of pauses

    The flag that keeps item-by-item pushing later pauses past its last item is an ordinary parameter, so your own wrappers can opt in:

    #let reveal-lines(body) = touying-fn-wrapper(
    (self: none, body) => /* ... */ body,
    last-subslide: repetitions => (repetitions + count-lines(body) - 1, (:)),
    advances-flow: true, // a following #pause continues after the last line
    body,
    )

    It defaults to false, which is what you want for anything that only animates its own body. Such a wrapper reserves the subslides it needs without moving the pause cursor.

  • feat: touying-fn-wrapper-raw parses its body nests recursively, while touying-fn-wrapper allows raw variants inside itself

    #alert[This is important, #only("2-")[easter egg] don't miss it!] used to panic with Unsupported mark. A raw wrapper handed its positional arguments straight to the wrapped function, so any animation marker inside survived as unresolved metadata. Those arguments now go through the parser like ordinary slide content, so #pause, #meanwhile and every fn-wrapper behave inside a raw wrapper as they do anywhere else, and the wrapper's content counts towards the slide's subslide total. Nested raw wrappers resolve recursively, so #uncover[#alert[a #alert[b #alert[c]]]] works all the way down.

    This makes touying-fn-wrapper-raw the better default for reaching self from markup, and the docs and themes now say so. Stargazer's tblock was switched over so it can be used with the normal animation functions. The body has to be a positional argument for any of this to apply; baking it in with .with(..) hides it from the parser. See Complex Animations.

  • feat: export .pdfpc files as bundle assets, one per document (#408)

    Typst 0.15's bundle export can emit arbitrary files, so the separate typst query .. > example.pdfpc step is no longer needed (you can still use it and the docs have transitioned to typst eval now). Put #pdfpc.bundle-assets() at the top level, outside every #document(..):

    typst compile --features bundle --format bundle --root . ./example.typ ./out
    # => ./out/deck.pdf and ./out/deck.pdfpc

    Every PDF document in the bundle that carries pdfpc metadata gets its own .pdfpc next to it, with slide labels numbered from that document's own first slide and only that document's notes, markers and configuration in it. The call is inert in every other target, so it can stay in a file you also compile to a plain PDF. See pdfpc.

  • feat: several documents in one source file (#406, thanks @mxmerz)

    Typst 0.15's bundle export lets a single file emit more than one PDF through #document("name.pdf", [..]), and a deck can now live in each of them. Heading lookups are scoped to the document they are in, so utils.current-heading and everything built on it (slide headers, the notes panel, progressive outlines) no longer pick up headings from a neighbouring deck. pdfpc metadata is scoped the same way, see the bundle-asset entry above.

    #document("deck-a.pdf", [
    #show: simple-theme
    == Deck A
    ])
    #document("deck-b.pdf", [
    #show: simple-theme
    == Deck B
    ])
  • feat: themes style the speaker-note panel through touying-notes

    touying-notes takes header, header-fill, fill, note-setting and preview-setting; a theme may use the note-setting to style the page and content. header-height collapses to its content by default, and header: none drops the strip entirely. preview-setting receives the full-size slide preview, so a theme can scale and place it freely, for example preview => place(bottom + right, box(scale(x: 30%, y: 15%, reflow: true, preview))). All six bundled themes ship one. See Speaker Notes.

  • feat: show-notes-on-second-screen accepts top and left as well as bottom and right. The page is doubled along the corresponding axis and the extra half pushed into the margin, so the slide keeps its own dimensions in all four directions.

  • feat: better covering, with alpha-changing-cover and color-changing-cover reworked (#112)

    utils.alpha-changing-cover is now the recommended semi-transparent cover, replacing the deprecated semi-transparent-cover above. It governs every stylable colour, inherits the outer scope's colour when an element declares none, understands gradients and tilings, and converts spot colours to Oklch before opacifying. Its automatic fallback alpha depends on the lightness of the colour it is dimming, and the fallback path is used far more sparingly, so images and diagrams no longer turn into grey blocks. utils.color-changing-cover remains the compile-cheap alternative that flattens everything to one colour: it overwrites colours instead of reading them, so it makes no context call. Both walk the same tree, so they treat strokes, table cells and the bodies of underline, highlight and strike alike, and neither moves the content it covers. Where an element paints its own background, flattening it together with the content on top would leave that unreadable, so color-changing-cover(hide-filled: true) (the default) hands those to fallback-hide, which now defaults to auto and dims them to match the recoloured text. See Cover Function.

  • feat: components.left-mid-right places content in three columns (#397, thanks @thomas-saigre)

  • feat: utils.get-input for reading command-line inputs

    Everything passed through --input key=value reaches Typst as a string. utils.get-input parses each value as Typst first, so accent=red is a colour, count=3 an integer and flag=true a boolean, while a bare word Typst does not know comes back as a string. That last part is what makes --input export-mode=handout work without shell quoting. Rn we only depend on it for export-mode, but we might support more commandline customizability later. Pass no key to get the whole parsed dictionary. See touying-exporter.

  • feat/fix: touying-get-config exposes common as a real category

    touying-get-config("common.handout") resolves now, and touying-get-config().common returns the flat top-level keys as a subtree, which is what the docstring always claimed. Naming a category under it, such as common.store, panics with a clear message instead of silently missing.

  • feat: waypoints now emit a globally linkable anchor <slide.waypoint> for a slide labelled <slide> and a waypoint named <waypoint>. You can use this to create links that refer to the last subslide of a waypoint. The anchor is placed best possible: If the last waypoint subslide is rendered, it is emitted there (the default in presentation mode), otherwise as close after as possible, otherwise as late inside it as possible. If all rendered subslides are before the waypoint's range it is not emitted into the document.

  • feat: new utilities. tree.is-math-symbol and tree.sequence-to-array in the new core/tree.typ, subslides.resolve-negative-subslides (negative subslide indices resolved against a repeat count and an optional non-1 base) in core/subslides.typ, and utils.rescale-image.

  • fix: a labelled #place, #rotate, #columns or #terms.item in a slide

    The parser rebuilt those four by hand and passed the label straight into the constructor, so a labelled #place(top + right)[..] <lbl> was a hard compile error and a labelled #columns(2)[..] <lbl> silently lost its label. They go through the shared reconstruction now and keep it.

  • fix: #item-by-item no longer collapses when its body starts with a #set

    Three separate copies of "count the items" could not see through the styled node a #set or #show creates, so #item-by-item[#set text(..) \ - one \ - two] rendered one subslide instead of three.

  • fix: magic.nontight on a labelled list

    It splatted the element's label into the constructor, which rejects it, so #list([a], [b]) <lbl> was a hard error under nontight-list-enum-and-terms.

  • fix: speaker notes no longer lose styled content

    utils.markup-text dropped every styled subtree, so [a #text(red)[b] c] reached the .pdfpc file as "a c". It feeds the pdfpc export, so notes were silently incomplete.

  • fix: waypoints inside a terms.item or a figure caption

    The waypoint pre-pass walked neither, while the main parse walked both, so every waypoint after one landed on the wrong subslide.

  • fix: special slides announce their title as a hidden heading

    An outline slide's title never became a heading, so nothing reading the current heading could see it. The slide header worked only because the title was passed in explicitly, and the notes panel showed nothing at all. The affected slides now emit place(hide(heading(level: self.slide-level, ..))). place keeps it out of the flow, since a plain hide still pushed the outline's contents down by about 16pt, and level: self.slide-level keeps custom-progressive-outline from mistaking "Outline" for the current section and dimming every entry. Applied to outline-slide in aqua, dewdrop, metropolis and stargazer, plus stargazer's ending-slide. Title slides are left alone for now.

  • fix: a citation covered by a visual-only method stays a real citation

    color-changing-cover sent citations to the hide fallback, so the marker vanished while the bibliography entry it queues stayed behind. @key is a ref in the content tree and only becomes a cite during layout, so neither func was in the recolourable set. Both are now, and a citation is recoloured like raw rather than hidden. Separately, magic.bibliography-as-footnote decided whether to draw a width-reserving placeholder by looking for a hide element instead of asking utils.cover-hides-footnote. It asks the config now, so it agrees with the parser's own footnote branch.

    Still open: an opaque cover that is not hide, such as cover-with-rect, together with cover-hides-footnote: true leaks the entry.

  • fix: a note-style citation after a #pause no longer leaks its footnote onto the earlier subslides (#414, thanks @SchrodingerBlume)

    #399 fixed a literal #footnote shown before its #pause, but a citation in a CSL note style such as chicago-notes still leaked. Such a citation only becomes a footnote during the layout pass, after the body scan cover-hides-footnote relies on, so hide() suppressed the marker while the entry it had queued still rendered at the bottom of the page. cite and ref now follow the same three-way branch as footnote: under a genuinely hiding cover the citation is not rendered at all, so no entry is created, and it appears normally once revealed. This also fixes packages that emit footnotes through a show std.cite rule.

  • fix: a footnote bibliography no longer prevents convergence (#395) — fixed by the bibliography rework above. Verified across 30 size × breakable/detect-overflow combinations that previously warned document did not converge within five attempts. A CI step runs the regression with --warnings promote.

  • fix: #uncover, #only and the other fn-wrappers stay visible inside a grid or table that sits behind a #pause. A fn-wrapper decides its own visibility, so it escapes the surrounding pause zone, but a table-like container worked out whether it would be hidden before re-parsing its cells and then reused that stale answer, covering a wrapper that had already revealed itself. Nesting made no difference: a grid inside a block was affected too

  • fix: a bibliography no longer needs a preceding pagebreak() to render. --- slide breaks inside mode-only content are handled as slide breaks, while pagebreak() stays a page break

  • fix: touying-get-config's default: sentinel is a private marker instead of the type builtin, so default: type is no longer a magic value, and passing a key both positionally and by name is rejected rather than silently ignored

  • fix: footnotes are no longer shown before the #pause that reveals them (#399, thanks @RivinHD for the initial contribution)

  • fix: hidden-parts are flushed in the right order when a touying-fn-wrapper follows paused content, so a fn-wrapper no longer renders ahead of content written before it (#400)

  • fix: cover spacing (#387, #405)

  • fix: reducer elements are covered individually rather than as one block (#371, #381)

  • fix: touying-reducer hands reduce and cover the element shape the package itself uses, so a package whose drawing function takes ..args rather than one array now binds without any adapter.

    A package's element is whatever its element constructor returns, and that differs: a CeTZ rect(..) and an alchemist molecule(..) are each a one-element array, while a fletcher node(..) is content and a lilaq plot(..) is a dictionary. Writing the body as a code block (#cetz-canvas({ rect(..); circle(..) })) makes Typst join those arrays into one, so the reducer received the elements already unpacked and had to guess how to put one back together when covering it. It always wrapped, which is right for CeTZ and alchemist and wrong for everything else.

    The two call styles are distinguishable where the arguments arrive, before any flattening: a code block is a single array-typed positional argument, while elements passed directly are separate arguments. The reducer now records that per item and gives each side back what it started with — cover gets a whole element, and reduce gets one array for a block body or spread arguments for a variadic one such as lq.diagram(..plots).

    // lilaq, whose plots are dictionaries and whose diagram takes `..plots`
    #let lq-diagram = touying-reducer.with(
    reduce: lq.diagram,
    cover: plot => plot + (x: (), y: (), label: none),
    )
  • fix: callback-style usage works again (#374, #380)

  • fix: empty output slides are no longer indexed when adding last-page metadata (#382)

  • fix: wrong type in pdfpc commands (#407, thanks @vilaureu)

  • fix: touying-diagram binding and the CeTZ docs example repaired (#389)

  • i18n: French translation for the outline (#396, thanks @tarikgraba)

  • theme(dewdrop): outline-title is gone from the theme's documented parameter list. It was never an actual parameter of dewdrop-theme; the outline slide's title is its title argument

  • theme(stargazer): list markers are positioned correctly (#393, thanks @joseph-tao)

  • theme(stargazer): it also documented footer and footer-right when never using those.

Documentation​

Almost every page was touched. The largest items:

  • docs: new Article Mode tutorial under Integration, since its main use is pairing an article theme with a slide theme.

  • docs: new Speaker Notes tutorial (English and Chinese), covering where notes attach, the second screen, presenter view, per-subslide notes, markdown notes for pdfpc, exporting, and styling the panel.

  • docs: Custom Themes gains sections on customizing the speaker-note panel, making a special slide's title discoverable with a hidden heading, and why helper components should use touying-fn-wrapper-raw. Build Your Own Theme gains a matching "Customizing the Notes" section.

  • docs: Cover Function rewritten around alpha-changing-cover and color-changing-cover, with a new section on cover-hides-footnote explaining why auto recognises a hiding cover by identity, so a hand-written (self: none, body) => hide(body) is classified visual-only and its footnotes appear before the reveal.

  • docs: Sections and Headings now separates the labels that change how a heading is presented from the labels that filter by output mode, and warns that <touying:hidden> does not suppress the slide or its number, which config-common(freeze-slide-counter: true) does.

  • docs: Counters and the sections page corrected on appendix, which freezes only the denominator (utils.last-slide-number) while utils.slide-counter keeps advancing, so an appendix footer reads 4 / 2.

  • docs: Complex Animations explains what can be nested inside touying-fn-wrapper-raw versus touying-fn-wrapper, including the .with(..) trap for theme authors.

  • docs: Waypoints documents hierarchical labels, where <part:intro> and <part:main> combine under <part>, and corrects start, which belongs on #waypoint rather than on #uncover.

  • docs: Fit To brought in line with the real signatures of fit-to-height and fit-to-width, where height/width are named with a 1fr default, positional is still accepted, and reflow and force-height exist.

  • docs: Layout and the FAQ corrected. detect-overflow emits a warning and compilation continues; it does not panic().

  • docs: pdfpc documents end-slide, save-slide and hidden-slide alongside speaker notes, plus bundle export. touying-exporter documents utils.get-input.

  • docs: CeTZ integration drops the stale (uncover(..),) array syntax from the callback-style example, and the FAQ's fletcher example likewise.

  • docs: the FAQ was substantially reworked, covering the bibliography, section-slide bodies, touying-fn-wrapper-raw, the cover methods, "h" and "!" subslide specs, second-screen alignments, and Tinymist in place of the discontinued Typst Preview extension.

  • docs: new Article Mode page covering the export modes, article themes and available-fields, writing for both outputs, recalling animated content, and floating images.

  • docs: new Output Modes page gathering the four export modes, the four mode markers and the <touying:..> section labels in one place. The handout page keeps handout mode itself and links to it.

  • docs: Complex Animations documents animate (placement versus styling, priority, and that the last effect written wins), swap and its stretch, animate-hidden / animate-removed, touying-render, touying-recall, and the callback-style variants.

  • docs: large Chinese translation pass covering the theme pages, FAQ, settings, sections, navigation, and the new speaker-notes page. The Chinese settings and custom pages document article mode.

Miscellaneous​

  • refactor: src/core.typ is split into modules. The 6288-line file becomes src/core/parser.typ, src/core/animation.typ, src/core/slides.typ, src/core/blocks.typ, src/core/waypoints.typ and additionally src/core/article.typ, with src/slides.typ replaced by src/entrypoint.typ and the new src/bundle.typ holding the bundle-export helpers. src/exports.typ is reorganised along the same lines. The public API is unaffected except where noted above, but anything importing touying/src/core.typ directly has to be updated.
  • refactor: content-tree handling is one layer, src/core/tree.typ. Recognising what a piece of content is, taking it apart and putting it back together was written out in about thirty places, which had drifted apart: label handling differed per call site, and several walks could not see through a styled node, so a #set or #show rule in force made them miss what they were looking for. The new module knows nothing about touying and imports nothing, so anything can use it. shape-of classifies how a node holds its sub-content, children-of and rebuild are guaranteed to round-trip it, and map-tree walks with an identity short-circuit. Moved out of utils: the is-* predicates, the typst-builtin-* handles, reconstruct*, trim, label-it. core/subslides.typ takes visibility-spec resolution (check-visible, resolve-negative-subslides, last-required-subslide, …) and resolve-waypoints joins core/waypoints.typ. The old names stay in utils: the ones returning content forward with a deprecation warning, the rest panic naming the new module.
  • refactor: block rendering, waypoint-to-integer resolution, the equation/mitex/raw paths and the article-mode scanning functions were each unified into one implementation rather than several near-duplicates.
  • test: reference renders regenerated for Typst 0.15.0 / tytanic 0.4.0 layout drift. New suites for article mode (presentation, handout and article variants of one source), recall-content, render-subslides, mode-never, notes-second-screen, pdfpc, cover-citation, and the #395, #408 and #415 regressions.

Theme Migration Guide​

For theme developers upgrading to v0.8.0:

  1. Style the body through setting:, not by wrapping it. All bundled themes now pass their alignment and decoration as touying-slide(setting: ..) rather than wrapping the body in align(..) or a block. Wrapping hides the body from the parser, which breaks animation counting and article-mode linearization:
    // Before
    touying-slide(self: self, config: config, align(center + horizon, body))

    // After
    touying-slide(self: self, config: config, setting: align.with(center + horizon), body)
  2. Register a notes-fn. Replace any config-methods(show-only-notes: ..) renderer override with config-common(notes-fn: ..) built on touying-notes; roughly ten lines of colours per theme. The config-common(show-only-notes: ..) flag is a separate option and is unchanged.
  3. Give special slides a hidden heading so their title is discoverable by utils.display-current-heading. Both the slide header and the notes panel read from it:
    place(hide(heading(
    level: self.slide-level, title,
    bookmarked: false, outlined: false, numbering: none,
    )))
  4. Prefer touying-fn-wrapper-raw for helper components that need self, and pass the body as a positional argument so animations inside it are parsed:
    #let tblock(title: none, it) = touying-fn-wrapper-raw(_tblock.with(title: title), it)
  5. Do not paint behind the notes half through config-page(background: ..). Use touying-notes' fill and header-fill.

v0.7.4​

Features​

  • feat: adds touying-reduce which automatically looks up reducer bindings given a package (#363)
  • feat(i18n): add Polish locale for outline message (#372)
  • feat: Left/Right keyboard navigation support (#352)
  • feat: add grid-size parameter to lazy-layout for quantized position grouping, improving robustness of column/row detection
  • feat: add components.full-width-block component that spans the full page width by cancelling horizontal margins

Fixes​

  • fix (minor breaking change): set lazy-layout default to false for cols
  • fix: handle missing fn field in mark warning message gracefully
  • fix: hide doing unexpected things to headings (#366)
  • fix: export touying-fn-wrapper-raw as part of the public API (#362)
  • fix: improved mark-warning, now also displayed as magic.warning when enable-mark-warning is false (#348)
  • fix: warnings now emitted via uniwarn (#359)

v0.7.3​

Minor Breaking Changes​

  • feat!: always attach #speaker-note[] to the previous slide & default receive-body-for-new-*-slide-fn to false (#354)
    • #speaker-note[] now always attaches to the slide above it, regardless of how that slide was created (explicit slide calls, heading-triggered section slides, or normal content slides). This eliminates the common pitfall where a #speaker-note[] placed after a slide would silently create an unwanted empty "ghost" slide.
    • receive-body-for-new-section-slide-fn and its variants are now defaulted to false (previously true).

Migration Guide​

If you relied on content after = Section headings being absorbed into the section slide body, explicitly set receive-body-for-new-section-slide-fn: true in your config-common(...).

Features​

  • feat: item-by-item-fn and presets for it (#347)
  • feat: improved custom-progressive-outline and new section-relationship and some other things (#345)
  • feat: better lazy-layout for mixed layouts (#355)
  • feat: add cols as alias of side-by-side and export some components cols, lazy-xxx to outside (#356)
  • theme(metropolis): add outline-slide for metropolis (#349)
  • feat: add warning for empty slide content height detection

Documentation​

  • docs: add multiple columns example and improve docs structure

v0.7.1​

Features​

  • feat(agents): breakable and clip options to avoid slide overflow (#336)
  • feat(components): add lazy-v (lazy-h) and lazy-layout for equalizing multi-column (-row) block heights (widths) (#339)
  • feat: additional contact and extra field in config-info (#342)
  • feat: touying-get-config function (#333)

Fixes​

  • fix: fix fit-to-height and size-to-pt and allow text reflow (#332)
  • fix: fix waypoint markers (#341)

v0.7.0​

Features​

  • major feature: a named waypoint feature (#298)
  • feat(waypoint): start param and Waypoints in handout-subslides (#304)
  • feat: auto, "h"-here string and inverse function for string subslide-numbers and waypoints (#301)
  • feat: implicitly allow fn-wrapper based animation functions via reducer (#300)

Fixes​

  • fix: fix cover-with-rect breaking long lines of text when partially hidden and fallback functions for color/alpha cover (#328)
  • fix: using explicit numbering in display-current-heading when style=auto (#329)
  • fix: fix ghost slides with show rules. Fix proper consistent handling of show rules and defer keyword (#317)
  • fix: alert not delayed (#316)
  • fix: remove redundant nested text call (#324)
  • fix: function alternatives-match takes into account parameter stretch (#320)
  • fix: correctly handle page margin merge/precedence (#322)
  • fix: fix cover spacing issues surrounding lists (#303)
  • fix: correctly parses negative subslide indices (ints, arrays) for handout-subslides (#307)
  • fix: slide function does not update via scoped import (#310)

Thanks for the contributions from @zral0kh, @Andrew15-5, @navdeeprana, and @Cemoixerestre.

v0.6.3​

A major bugfix release, fixing many long-standing bugs and introducing many practical features.

Features​

  • feat: add #jump(n, relative: bool) as unified animation control; redefine #pause/#meanwhile as sugar
  • feat: add #handout-only for inline content and <touying:handout> label for handout-exclusive slides (#286)
  • feat: add handout-subslides to control which subslides appear in handout mode (#288)
  • feat: add #touying-raw for animated code block reveals (#283)
  • feat: add full-screen speaker notes mode with slide thumbnail (show-only-notes) (#281)
  • feat: support arbitrary aspect ratios (e.g. 16-10) across all themes and speaker-note second screen (#280)
  • feat: add #item-by-item animation for list, enum, and terms (#278)
  • feat(recall): add subslide parameter to #touying-recall (#285)
  • feat: add default-composer to config-common for global slide layout configuration (#284)
  • feat: add cover-fn parameter to uncover for external package integration (e.g. Fletcher) (#267)
  • feat: minislides can be displayed inline (#228)
  • theme: improve appearance of long author lists in university and stargazer theme (#242)
  • theme(simple): make simple-theme respect color configuration for deco-format (#252)
  • theme(aqua,stargazer): add extra parameter to title-slide (#291)

Fixes​

  • fix: prevent ghost-slide blank pages from touying-set-config anchor regression (#289)
  • fix: styled content on first slide no longer creates extra slides (#287)
  • fix: remove unoutlined headings from navigation
  • fix: fix #meanwhile being ignored inside grid cells, boxes, and other containers (#274)
  • fix: fix config: parameter silently ignored across all themes (#273)
  • fix: fix slides after #show/#set rules not rendering subsequent slides (#268)
  • fix: fix title page PDF page label causing pdfpc presenter notes mismatch (#277)
  • fix: fix duplicate label error for labeled footnotes with #pause animations (#275)
  • fix: fix #pause inside #speaker-note body (nested list items) (#282)
  • theme(dewdrop): fix body content under level-1 heading was silently dropped (#279)
  • theme(stargazer): update stargazer theme margins and fix #259

Documentation​

  • docs(BIG CHANGE): refactor docs website and add references page
  • docs: reduce README noise, improve first impression (#297)
  • docs: restructure docs + add docs-preview CI for PRs (#296)
  • docs: comprehensive docstring improvements across all source files (#294)

Miscellaneous​

  • chore: add copilot-setup-steps.yml and improve copilot-instructions.md (#292)

Theme Migration Guide​

For theme developers upgrading to v0.6.3:

  1. Move config to the last position in utils.merge-dicts to allow user overrides:

    // Before
    self = utils.merge-dicts(self, config, config-page(...))

    // After
    self = utils.merge-dicts(self, config-page(...), config)
  2. Replace paper with utils.page-args-from-aspect-ratio to support arbitrary aspect ratios:

    // Before
    config-page(paper: "presentation-" + aspect-ratio, ...)

    // After
    config-page(..utils.page-args-from-aspect-ratio(aspect-ratio), ...)

v0.6.2​

Features​

  • feat: allow customisation of components.checkerboard (#161)

Fixes​

  • fix: support ratio and relative margins for full-width headers (#256)
  • fix: fix magic.bibliography-as-footnote in Typst 0.14 (#249)
  • fix: theorion package is broken with Typst 0.14.0 (#237)
  • fix: update components.typ and pass named arguments to grid (#207)
  • fix: fix #meanwhile in cetz (#205)
  • fix: documentation contains unclosed raw text error (#187)
  • fix: use correct circle symbol (#171)
  • fix: use regex to override colors of equations (#167)
  • fix: show-hide-set-list-marker-none with full enum (#157)
  • fix: remove dump and label-it function for better cache

Miscellaneous​

  • docs: update README, bump versions of deps, and fix comment docs
  • ci: add more tests, bump versions of tytanic, and update typstyle workflow (#221, #261)

v0.6.1​

Added support for the theorion package, and used it as the default math theorem environment.

v0.6.0​

It's not a big update, but it's the first touying release since typst 0.13 was released.

Features​

  • feat: add auto style for display-current-heading.
    • For users, you can use show heading: set text(blue) to change color for heading in some themes like dewdrop.
    • For theme creator, you can use syntax like utils.display-current-heading(level: 1, style: auto) to achieve the same result.
  • feat: apply config-info information to set document.
  • feat: set stretch: false by default for alternatives functions. This is a minor breaking change, but I think it would be more intuitive: no auto empty space.

Fixes​

v0.5.4 & v0.5.5​

Features​

Fixes​

Thanks for the contributions from @enklht.

v0.5.3​

Features​

  • feat: add stretch parameter for #alternatives[] function class. This allows us to handle cases where the internal element is a context expression.
  • feat: add config-common(align-enum-marker-with-baseline: true) for aligning the enum marker with the baseline.
  • feat: add linebreaks option to components.mini-slides. https://github.com/touying-typ/touying/pull/96
  • feat: add <touying:skip> label to skip a new-section-slide.
  • feat: add config-common(show-hide-set-list-marker-none: true) to make the markers of list and enum invisible after #pause.
  • feat: add config-common(bibliography-as-footnote: bibliography(title: none, "ref.bib")) to display the bibliography in footnotes.
  • refactor: add config-common(show-strong-with-alert: true) configuration to display strong text with an alert. (small breaking change for some themes)
  • refactor: refactor display-current-heading for preserving heading style in title and subtitle. https://github.com/touying-typ/touying/issues/71
  • refactor: make new-section-slide-fn function class can receive body parameter. We can use receive-body-for-new-section-slide-fn to control it. (Breaking change)
    • For example, you can add #speaker-note[] for a new section slide, like = Section Title \ #speaker-note[].
    • If you don't want to append content to the body of the new section slide, you can use --- after the section title.

Fixes​

v0.5.1 & v0.5.2​

  • Fix somg bugs.

v0.5.0​

This is a significant disruptive version update. Touying has removed many mistakes that resulted from incorrect decisions. We have redesigned numerous features. The goal of this version is to make Touying more user-friendly, more flexible, and more powerful.

Major changes include:

  • Avoiding closures and OOP syntax, which makes Touying's configuration simpler and allows for the use of document comments to provide more auto-completion information for the slide function.
    • The existing #let slide(self: none, ..args) = { .. } is now #let slide(..args) = touying-slide-wrapper(self => { .. }), where self is automatically injected.
    • We can use config-xxx syntax to configure Touying, for example, #show: university-theme.with(aspect-ratio: "16-9", config-colors(primary: blue)).
  • The touying-slide function no longer includes parameters like section, subsection, and title. These will be automatically inserted into the slide as invisible level 1, 2, or 3 headings via self.headings (controlled by the slide-level configuration).
    • We can leverage the powerful headings provided by Typst to support numbering, outlines, and bookmarks.
    • Headings within the #slide[= XXX] function will be adjusted to level slide-level + 1 using the offset parameter.
    • We can use labels on headings to control many aspects, such as supporting the <touying:hidden> and other special labels, implementing short headings, or recalling a slide with #touying-recall().
  • Touying now supports the normal use of set and show rules at any position, without requiring them to be in specific locations.

A simple usage example is shown below, and more examples can be found in the examples directory:

#import "@preview/touying:0.5.0": *
#import themes.university: *

#show: university-theme.with(
aspect-ratio: "16-9",
config-info(
title: [Title],
subtitle: [Subtitle],
author: [Authors],
date: datetime.today(),
institution: [Institution],
logo: emoji.school,
),
)

#set heading(numbering: "1.1")

#title-slide()

= The Section

== Slide Title

#lorem(40)

Theme Migration Guide:

For detailed changes to specific themes, you can refer to the themes directory. Generally, if you want to migrate an existing theme, you should:

  1. Rename the register function to xxx-theme and remove the self parameter.
  2. Add a show: touying-slides.with(..) configuration.
    • Change self.methods.colors to config-colors(primary: rgb("#xxxxxx")).
    • Change self.page-args to config-page().
    • Change self.methods.slide = slide to config-methods(slide: slide).
    • Change self.methods.new-section-slide = new-section-slide to config-methods(new-section-slide: new-section-slide).
    • Change private theme variables like self.xxx-footer to config-store(footer: [..]), which you can access through self.store.footer.
    • Move the configuration of headers and footers into the slide function rather than in the xxx-theme function.
    • You can directly use set or show rules in xxx-theme or configure them through config-methods(init: (self: none, body) => { .. }) to fully utilize the self parameter.
  3. For states.current-section-with-numbering, you can use utils.display-current-heading(level: 1) instead.
    • If you only need the previous heading regardless of whether it is a section or a subsection, use self => utils.display-current-heading(depth: self.slide-level).
  4. The alert function can be replaced with config-methods(alert: utils.alert-with-primary-color).
  5. The touying-outline() function is no longer needed; you can use components.adaptive-columns(outline()) instead. Consider using components.progressive-outline() or components.custom-progressive-outline().
  6. Replace states.slide-counter.display() + " / " + states.last-slide-number with context utils.slide-counter.display() + " / " + utils.last-slide-number. That is, we no longer use states but utils.
  7. Remove the slides function; we no longer need this function. Instead of implicitly injecting title-slide(), explicitly use #title-slide(). If necessary, consider adding it in the xxx-theme function.
  8. Change #let slide(self: none, ..args) = { .. } to #let slide(..args) = touying-slide-wrapper(self => { .. }), where self is automatically injected.
    • Change specific parameter configurations to self = utils.merge-dicts(self, config-page(fill: self.colors.neutral-lightest)).
    • Remove self = utils.empty-page(self) and use config-common(freeze-slide-counter: true) and config-page(margin: 0em) instead.
    • Change (self.methods.touying-slide)() to touying-slide().
  9. You can insert visible headings into slides by configuring config-common(subslide-preamble: self => text(1.2em, weight: "bold", utils.display-current-heading(depth: self.slide-level))).
  10. Finally, don't forget to add document comments to your functions so your users can get better auto-completion hints, especially when using the Tinymist plugin.

Other Changes:

  • theme(stargazer): new stargazer theme modified from Coekjan/touying-buaa.
  • feat: implemented fake frozen states support, allowing you to use numbering and #pause normally. This behavior can be controlled with enable-frozen-states-and-counters, frozen-states, and frozen-counters in config-common().
  • feat: implemented label-only-on-last-subslide functionality to prevent non-unique label warnings when working with @equation and @figure in conjunction with #pause animations.
  • feat: added the touying-recall(<label>) function to replay a specific slide.
  • feat: implemented nontight-list-enum-and-terms, which defaults to true and forces list, enum, and terms to have their tight parameter set to false. You can control spacing size with #set list(spacing: 1em).
  • feat: replaced list with terms implementation to achieve align-list-marker-with-baseline, which is off by default.
  • feat: implemented scale-list-items, scaling list items by a factor, e.g., scale-list-items: 0.8 scales list items by 0.8.
  • feat: supported direct use of #pause and #meanwhile in math expressions, such as $x + pause y$.
  • feat: provided #pause and #meanwhile support for most layout functions, such as grid and table.
  • feat: added #show: appendix support, essentially equivalent to #show: touying-set-config.with((appendix: true)).
  • feat: Introduced special labels <touying:hidden>, <touying:unnumbered>, <touying:unoutlined>, <touying:unbookmarked> to simplify control over heading behavior.
  • feat: added basic utils.short-heading support to display short headings using labels, such as displaying <sec:my-section> as "My Section".
  • feat: added #components.adaptive-columns() to achieve adaptive columns that span a page, typically used with the outline() function.
  • feat: added #show: magic.bibliography-as-footnote.with(bibliography("ref.bib")) to display the bibliography in footnotes.
  • feat: added components like custom-progressive-outline, mini-slides.
  • feat: removed touying-outline(), which can be directly replaced with outline().
  • fix: replaced potentially incompatible code, such as type(s) == "string" and locate(loc => { .. }).
  • fix: Fixed some bugs.

v0.4.2​

  • theme(metropolis): decoupled text color with neutral-dark (Breaking change)
  • feat: add mark-style uncover, only and alternatives
  • feat: add warning for styled block for slides
  • feat: add warning for touying-temporary-mark
  • feat: add markup-text for speaker-note
  • fix: fix bug of slides

v0.4.1​

Features​

  • feat: support builtin outline and bookmark
  • feat: support speaker note for dual-screen
  • feat: add touying-mitex function

Fixes​

  • fix: add outline-slide for dewdrop theme
  • fix: fix regression of default value "auto" for repeat

Miscellaneous Improvements​

  • feat: add list support for touying-outline function
  • feat: add auto-reset-footnote
  • feat: add freeze-in-empty-page for better page counter
  • feat: add ..args for register method to capture unused arguments

v0.4.0​

Features​

  • feat: support #footnote[] for all themes.
  • feat: access subslide and repeat in footer and header by self => self.subslide.
  • feat: support numbered theorem environments by ctheorems.
  • feat: support numbering for sections and subsections.

Fixes​

  • fix: make nested includes work correctly.
  • fix: disable multi-page slides from creating the same section multiple times.

Breaking changes​

  • refactor: remove self.padding and add self.full-header self.full-footer config.

v0.3.3​

  • template: move template to touying-aqua package, make Touying searchable in Typst Universe Packages
  • themes: fix bugs in university and dewdrop theme
  • feat: make set-show rule work without setting parameter
  • feat: make composer parameter more simpler
  • feat: add empty-slide function

v0.3.2​

  • fix critical bug: fix is-sequence function, make grid and table work correctly in touying
  • theme: add aqua theme, thanks for pride7
  • theme: make university theme more configurable
  • refactor: don't export variable s by default anymore, it will be extracted by register function (Breaking Change)
  • meta: add categories and template config to typst.toml for Typst 0.11

v0.3.1​

  • fix some typos
  • fix slide-level bug
  • fix bug of pdfpc label

v0.3.0​

Features​

  • better show-slides mode.
  • support align and pad.

Documentation​

  • Add more detailed documentation.

Refactor​

  • simplify theme.

Fix​

  • fix many bugs.

v0.2.1​

Features​

  • Touying-reducer: support cetz and fletcher animation
  • university theme: add university theme

Fix​

  • fix footer progress in metropolis theme
  • fix some bugs in simple and dewdrop themes
  • fix bug that outline does not display more than 4 sections

v0.2.0​

  • Object-oriented programming: Singleton s, binding methods utils.methods(s) and (self: obj, ..) => {..} methods.
  • Page arguments management: Instead of using #set page(..), you should use self.page-args to retrieve or set page parameters, thereby avoiding unnecessary creation of new pages.
  • #pause for sequence content: You can use #pause at the outermost level of a slide, including inline and list.
  • #pause for layout functions: You can use the composer parameter to add yourself layout function like utils.side-by-side, and simply use multiple pos parameters like #slide[..][..].
  • #meanwhile for synchronous display: Provide a #meanwhile for resetting subslides counter.
  • #pause and #meanwhile for math equation: Provide a #touying-equation("x + y pause + z") for math equation animations.
  • Slides: Create simple slides using standard headings.
  • Callback-style uncover, only and alternatives: Based on the concise syntax provided by Polylux, allow precise control of the timing for displaying content.
    • You should manually control the number of subslides using the repeat parameter.
  • Transparent cover: Enable transparent cover using oop syntax like #let s = (s.methods.enable-transparent-cover)(self: s).
  • Handout mode: enable handout mode by #let s = (s.methods.enable-handout-mode)(self: s).
  • Fit-to-width and fit-to-height: Fit-to-width for title in header and fit-to-height for image.
    • utils.fit-to-width(grow: true, shrink: true, width, body)
    • utils.fit-to-height(width: none, prescale-width: none, grow: true, shrink: true, height, body)
  • Slides counter: states.slide-counter.display() + " / " + states.last-slide-number and states.touying-progress(ratio => ..).
  • Appendix: Freeze the last-slide-number to prevent the slide number from increasing further.
  • Sections: Touying's built-in section support can be used to display the current section title and show progress.
    • section and subsection parameter in #slide to register a new section or subsection.
    • states.current-section-title to get the current section.
    • states.touying-outline or s.methods.touying-outline to display a outline of sections.
    • states.touying-final-sections(sections => ..) for custom outline display.
    • states.touying-progress-with-sections((current-sections: .., final-sections: .., current-slide-number: .., last-slide-number: ..) => ..) for powerful progress display.
  • Navigation bar: Navigation bar like here by states.touying-progress-with-sections(..), in dewdrop theme.
  • Pdfpc: pdfpc support and export .pdfpc file without external tool by typst query command simply.