• Condensed overview in CHANGELOG.md
• All commits/the entire diff

Upgrading

• Rename the linalg preset import to math.

• Rename all caution calls to urgent.

• Optional: Install the Atkinson Hyperlegible Next and Intel One Mono fonts. These are the new ones used by default in the note template.

  • Motivation: Notes are often topic-specific reports, we want to reduce strain as much as possible. They should be unremarkably sleek to look at, the semantic content is what matters.

• Optional: Move creation into meta and add a per-document UUID as meta.id.

  • Motivation: Recognizability. meta specifically refers to the the document rather than the entities referred to within. A constant id is especially useful for living documents as well as ones with errata; even though title and content may not match, the versions observed can be stitched together machine-readably by joining on the ID.
  This is what I do in my notes for semiautomated upgrading, for what it's worth

  MultisampledNight/core – config/nvim/notes.vim

  Lines 65 to 79 in MultisampledNight/core@3aec6b9

  function MigrateToFlow4()

  " update the import

  %substitute/flow:\d\.\d\.\d/flow:0.4.0/

  " move `creation` timestamp into new `meta` argument

  " while also adding a new `id` field

  " (remember: 0円 is the matched pattern again)

  %substitute/creation: ".*",/meta: (\r\0\rid: "%uuid%",\r)/

  call RealizeVariables()

  " clean up, let the user see what has been done

  write

  call b:format()

  normal gg

  endfunction

New contributors

• @hyperpastel in #3 and #4

The future

• The release branch now always contains the version available on the Typst universe (aka importable via @preview/flow:0.4.0), it is also the default branch.
  • This way we avoid confusion regarding in-development features, which are on the next branch instead.
• I don't expect most of the user-facing API and looks of flow to change much from this point on. I am somewhat happy with the sleek front-loaded metadata approach.
• Details may still change, however.
  • I am especially unsure on where gfx.diagram and preset.math will be headed to. Both don't feel quite right, but I'm not sure what to change.
  • I am also not sure on how to expose a useful and nice HTML export nicely enough, this will likely change in response to what the next Typst versions do.