Skip to content

Releases

v0.8.0 — Mermaid timelines, authoring dialects, font/math & WASM 0.8.0

Choose a tag to compare

@Dicklesworthstone Dicklesworthstone released this 21 Nov 11:33

Highlights

franken_markdown v0.8.0 ships franken_markdown 0.8.0 (fmd CLI + Rust library), fmd-font 0.5.0, fmd-math 0.4.0, and the qualified @franken-suite/franken-markdown 0.8.0 browser/WASM package tarball across 240+ commits since v0.7.0.

New Capabilities

  • Native Mermaid timeline diagrams: Clean-room timeline parsing and native LR/TD layout across HTML, PDF, SVG posters, EPUB, and Flow output with titles, sections, periods, multiple/continuation events, safe entities, line breaks, and cluster-aware wrapping.
  • Explicit authoring dialects everywhere: Select commonmark-gfm or gfm-plus across native rendering, fmd-lsp (initializationOptions.profile), fmd mcp, persistent Flow sessions, browser exports, offline workspaces, and books.
  • Standalone display equation labels: \tag{...} and \tag*{...} rendered across HTML, EPUB, PDF, SVG, and Flow (fmd-math 0.4.0).
  • Explicit page breaks: <!-- pagebreak --> directives across documents, books, includes, and nested containers.
  • Font & math upgrades (fmd-font 0.5.0, fmd-math 0.4.0): Bounded TTC/OTC font collection inspection and face extraction (native + browser/WASM), CID-keyed CFF1 support, HVAR/MVAR variable metrics and sparse gvar tuple interpolation, cross-lookup GPOS kerning accumulation, malformed TrueType glyph rejection, optical math fonts at declared sizes, EC text metrics, and semantic MathML text islands.
  • PDF, SVG & EPUB polish: Source-owned /Note, /Reference, and /Lbl PDF accessibility structure for footnotes/endnotes and tagged lists, per-chapter book PDF hyphenation and language tags, SVG syntax highlighting, SVG linked tables of contents, SVG footnote links, and semantic EPUB notes.
  • LSP & MCP expansion: fmd-lsp file/folder rename repairs (including synchronized opened include graphs) and footnote/reference label completion; fmd mcp adds in-memory fmd.render_svg and fmd.render_epub.
  • Browser/WASM package (0.8.0): Qualified with wasm-bindgen 0.2.130 (8.44 MB raw / 3.28 MB gzip — 104.7 KiB smaller gzip than v0.6.0), passing 13/13 generated-WASM browser smoke suites and native/WASM byte-parity checks. Attached directly to this release as franken-suite-franken-markdown-0.8.0.tgz (+ .sha256 sidecar).

Reliability, Dependencies & MSRV

  • MSRV 1.88 qualified (#18): franken_markdown (core library and default fmd CLI), fmd-font 0.5.0, and fmd-math 0.4.0 build and pass tests on Rust 1.88.0 (Cargo cleanly rejects Rust 1.85.1). Optional --features batch requires Rust 1.95+ due to its asupersync dependency graph.
  • Fuzz lockfile refreshed (#19): fuzz/Cargo.lock updated and verified with cargo build --manifest-path fuzz/Cargo.toml --bins --locked and bounded smoke runs across all 3 fuzz targets (15.08M runs, 0 crashes).
  • Dependencies: Workspace lockfile refreshed (clap 4.6.9, wasm-bindgen =0.2.130, asupersync 0.6.2, libfuzzer-sys 0.4.13) with zero security advisories (cargo audit clean on root and fuzz lockfiles).

Install

Quick install (Linux / macOS)

curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/franken_markdown/main/install.sh | bash

crates.io (Rust 1.88+)

cargo install franken_markdown

Published workspace crates:

Browser / WASM package

Download franken-suite-franken-markdown-0.8.0.tgz from the assets below and verify with franken-suite-franken-markdown-0.8.0.tgz.sha256.


Release Assets & SHA-256 Checksums

All native archives contain fmd (or fmd.exe), README.md, LICENSE, and CHANGELOG.md. Linux GNU builds target a GLIBC_2.28 ceiling (cargo-zigbuild).

Asset Target SHA-256
fmd-v0.8.0-x86_64-unknown-linux-gnu.tar.gz Linux x86_64 (glibc <= 2.28) af7eb8f84c20cdc8d38bde588b9c76b64b5dc38fa98cc15f8ec9f29ec9b2e28c
fmd-v0.8.0-aarch64-unknown-linux-gnu.tar.gz Linux ARM64 (glibc <= 2.28) e81faa59def2c1d4069eeec79d294e73bcd37341c76629901903eed91d0507c7
fmd-v0.8.0-x86_64-apple-darwin.tar.gz macOS Intel (10.12+) 5ad9e8da81fb04c5afb09c5b2abe7423ab652cc8a48e703a7ab6fdde59e13b41
fmd-v0.8.0-aarch64-apple-darwin.tar.gz macOS Apple Silicon (11.0+) b35ab04445e8d53d6d7ba20ef2c5ef5b7da312b135b85acfd0b8ec05a51fdafa
fmd-v0.8.0-x86_64-pc-windows-msvc.zip Windows x86_64 (MSVC) f86e66ff2140102cc08cdc9a0af91ec7528ab33be91e02dd04198ef06e6bc618
franken-suite-franken-markdown-0.8.0.tgz Browser / WASM package eaf20aa2d00d02fde086f10b1619e8c4b415f475a4c0fdfd6038661e55197663

Unversioned compatibility aliases (fmd-<triple>.tar.gz / .zip), per-file .sha256 sidecars, combined SHA256SUMS, and franken_markdown-v0.8.0-manifest.json are included.

See CHANGELOG.md for the complete changelog.

v0.7.0 — PDF shaping and pagination, CJK text, Mermaid diagrams, fmd-math 0.3.0

Choose a tag to compare

@Dicklesworthstone Dicklesworthstone released this 03 Nov 04:00

A feature release (331 commits since 0.6.0: 322 feature and fix commits, then
the version commit, seven lint, test and snapshot commits, and this changelog). It
changes the public Rust API of all three crates and some default output, so it
is a minor-version bump. fmd-font 0.4.0 and fmd-math 0.3.0 ship with it.
GitHub release binaries are built for x86_64 and aarch64 Linux (gnu), x86_64
and aarch64 macOS, and x86_64 Windows (msvc). All three crates now declare
rust-version = "1.88": they use let-chains, which the 1.85 declared by 0.6.0
cannot compile (#18).

No browser (WASM) tarball is published with this release; npm @franken-suite/franken-markdown stays at 0.5.0.
Browser package changes (wasm/, including <fmd-view>) are not part of this release.
The iOS app (ios/) is not shipped.

fmd batch, fmd mcp and fmd-lsp exist only in builds with the cargo
features batch, mcp and lsp; the entries for them apply to such builds.

Breaking changes

  • Rust 1.88: franken_markdown, fmd-font and fmd-math set
    rust-version = "1.88" (it was 1.85, which cannot compile their let-chains),
    so Cargo refuses older toolchains before building (#18, c4df3f7).
  • Non-ASCII heading anchors change: heading IDs keep Unicode letters,
    lowercased, on every surface: HTML, EPUB, PDF destinations, bookmarks and
    contents, the search index, fmd stats, book validation and SVG link
    targets. # Café gets the ID café and # 中文 Guide gets 中文-guide.
    0.6.0 dropped non-ASCII characters and gave a heading with no ASCII letters
    or digits the ID section, so links to the old IDs of such headings no
    longer resolve. Fragment links are percent-decoded once; malformed escapes,
    invalid UTF-8 and control characters are rejected. The new anchors module
    exposes heading_slug, text_slug and decode_fragment (57807a2).
  • --pdf-a needs a PDF target: fmd render, fmd watch and fmd batch
    exit 64 with "--pdf-a and --pdf-a-strict require --to pdf or --to both"
    when either flag is given with another target.
    fmd render --to html --pdf-a 2b was not rejected before (3b3b72f).
  • fmd batch applies each document's frontmatter: title, author (PDF),
    lang, toc and toc_depth come from each input's frontmatter after
    include expansion, as in fmd render. An explicit flag wins, then
    frontmatter, then native config, so toc: false in a document overrides a
    configured TOC. 0.6.0 batch did not read frontmatter and applied config
    lang, toc and toc_depth to every file. Library batch callers'
    HtmlOptions and PdfOptions count as explicit options, and native config
    is not read for them (09bcc80).
  • fmd batch fetches remote images by default: --to pdf, --to both and
    --to svg jobs now download http(s) image destinations, including those in
    included fragments and supported raw HTML, with the system curl or wget
    as fmd render does: once per distinct URL per document, within
    --max-pdf-image-bytes and --remote-image-timeout-secs, and stopped by the
    batch deadline. A failed fetch keeps the alt text and prints a warning naming
    the input. Pass --no-remote-images to keep batch offline. HTML and EPUB
    jobs do not fetch, and the library batch entry points stay offline
    (8029c89).
  • Downloader config files are ignored: the image fetcher of fmd render
    and fmd batch starts curl with --disable and wget with --no-config, so
    personal curl and wget config files no longer apply; proxy and certificate
    environment variables still do (8029c89).
  • The fmd binary embeds a CJK font: the default cli feature now enables
    the new cjk-face feature, so fmd carries a 9,867,212-byte Noto Sans SC
    subset. CJK text in PDF and SVG draws glyphs instead of .notdef boxes with a
    missing_glyphs warning, and HTML and EPUB output for documents with CJK
    text embeds a CJK subset. Builds without cli leave it off and can enable
    cjk-face (140f77d).
  • PDF/A-2b rejects CMYK images: an archival export that uses an Adobe CMYK
    or YCCK JPEG fails with pdf_a_cmyk_image (the output profile is sRGB) and
    leaves existing output files untouched; unused image mappings do not
    trigger it (44c88dc).
  • Numbered align is refused: fmd-math used to set \begin{align} and drop
    its equation numbers. It is now refused by name, like equation, gather
    and multline; align* and aligned still work. In fmd render, PDF and
    SVG output print a warning naming env:align and show the formula's TeX
    source in its place; HTML output carries the TeX source in its math display block and prints no warning (662c3f9).
  • Config defaults reach fmd book: the persistent config values
    font_scale, lang, html_font_format, toc, toc_depth, microtype,
    pdf_page_numbers, pdf_optimal_pagination and the three typography
    defaults now apply to books; explicit flags still win. --check-links now
    conflicts with the new publishing flags (47f6bc0).
  • FMD_TAIL_* switches are gone: FMD_TAIL_NOGLYPH, FMD_TAIL_NOHEX and
    FMD_TAIL_NOPAIR no longer change PDF output (see Removed) (c97d10e).
  • Default PDF and SVG bytes change: math uses the Computer Modern faces and
    TeX's font metrics, CJK text draws real glyphs, default pagination keeps a
    heading's wrapped lines and underline together, and the PDF layout fixes
    below move content. Pin 0.6.0 if you depend on byte-identical PDFs
    (ddebab7, 4315c77, b972ddb).
  • Some edge-case Markdown parses differently: a lone CR is a line break,
    table body rows need no pipes, a reference definition can run past eight
    lines, reference labels match under Unicode full case folding, and complete
    type-7 HTML tags start HTML blocks. Documents that relied on the old reading
    render differently (see Changed and Fixed) (f88f0ea, f32548e, 2b02598).
  • fmd-math resource budgets: Engine::typeset refuses a formula source
    over 65,536 bytes, or a layout over 65,536 glyphs or 262,144 path segments,
    with the new MathError::Budget, and the free parse functions apply the
    same source limit. The nesting bound (64 levels) and the macro budgets report
    Budget where they reported Malformed. fmd uses these defaults
    (9bbb40a).
  • New public fields on option structs: HtmlOptions::font_embedding,
    PdfOptions::strict_pagination, PdfEmitOptions::compression,
    PageStyle::baseline_grid,
    WasmRenderOptions::{strict_pagination, font_embedding} and
    config::RenderDefaults::{font_embedding, pdf_strict_pagination, pdf_baseline_grid_pt}.
    No struct in the three crates
    is #[non_exhaustive], so struct literals must set these fields or end with
    ..Default::default() (9fd8f0f, bcba460, 868359b).
  • New public fields in the display list and fmd-font:
    display::DisplayTextRun gains fill, baseline_y and math_fallback,
    flow_display::FlowInlineRun gains math, and fmd_font::OwnedTextRun
    gains vertical_metrics (2fee8ba, 691b11a).
  • New public fields in fmd-math: PlacedGlyph, PlacedRule and
    PlacedPath gain color: Option<Color>, and FracSpec gains thickness
    and cfrac (start from FracSpec::PLAIN or FracSpec::BINOM)
    (d9c13d7, [19a7d64](https://github.com/Dicklesworthstone/franken_markdown/com...
Read more

v0.6.0 — book editions, PDF footnotes and math, TeX-accurate fmd-math

Choose a tag to compare

@Dicklesworthstone Dicklesworthstone released this 14 Oct 08:09

A feature release (139 commits since 0.5.0). It changes the public Rust
API, the fmd-math API and some default output, so it is a minor-version bump.
fmd-font 0.3.4 and fmd-math 0.2.0 ship with it.

Highlights

  • Book publishing: atomic multi-format editions, retained workers, chapter
    previews, publishing profiles, outlines, scoped search, undo/redo and saving.
  • PDF: page-bottom footnotes, inline math and images, Mermaid figures,
    emoji, header/footer logos, and paper sizes and margins.
  • Browser and editors: syntax-highlighted flow sessions, separate WASM
    build profiles, and cross-buffer link navigation in fmd-lsp.
  • fmd-math 0.2.0: box sizes and spacing much closer to TeX's.

Security

  • Default (safe) HTML now emits the raw-HTML subset GitHub's sanitizer allows,
    re-serialized as live markup. Only a few attributes survive, href/src pass
    the safe-URL policy, <script>, <iframe>, <style>, event handlers and
    other tags stay escaped text, and nesting is capped at 32 levels. Review this
    if your policy for untrusted Markdown is stricter than GitHub's (109537b,
    3b62050, fa5e904).
  • SVG data-URI images check byte budgets before each write and reject a
    declared MIME type that does not match the data (a58201c, 2ce5fc6). EPUB book
    exports count all content against the 256 MiB ceiling, including books
    without embedded fonts (1ff975f).

Breaking changes

  • fmd-math 0.2.0: Layout has a new public order: Vec<Placed> field (TeX's
    emission order; new Placed enum) and MathConstants has new
    display_integral_scale, script_space and jot fields; struct literals
    must set them. MacroSet::canonical_bytes gains a record when ligatures are
    off (the default pack), so cache keys built from it change. Layout
    coordinates move as boxes follow TeX (see Fixed), and rule contours start
    at the bottom-right corner (9abff25, 68fe29b, 57da845, 66d6087, 3ed1d33,
    a81fa70).
  • Public structs gained fields: PdfRunningBand.image, FmdConfig.render and
    five typography and font-format fields on WasmRenderOptions. Construct them
    with ..Default::default() (f444bba, 22d501e, 21a18a8).
  • The wasm-bindgen feature alone no longer exports FmdFlowSession or the
    book and interactive-workspace bindings. Enable wasm-flow, wasm-book,
    wasm-workspace, or wasm-full for all three, as the package builders do.
    Calls to a missing binding reject with UNSUPPORTED_WASM_PACKAGE (#16,
    a787b1a, f800a09, a3e996c; see docs/WASM_PROFILES.md).
  • Default PDF and SVG bytes change: page-bottom footnotes with superscript
    marks instead of [1], typeset inline math, drawn inline images, lowered raw
    HTML, Mermaid figures, and new PDF heading and link tags. A link to #notes
    resolves only when the host renders doc.with_endnotes(). Pin 0.5.0 if you
    depend on byte-identical PDFs (2a80cd8, fc973ad).

See CHANGELOG.md for everything added and fixed, with commit references.

Distribution and verification

  • franken_markdown 0.6.0, fmd-font 0.3.4 and fmd-math 0.2.0 are published on crates.io.
  • Five native targets were built through DSR on one macOS host: Linux x86_64/aarch64 (cross-compiled with a glibc 2.28 floor), macOS x86_64/arm64, and Windows x86_64 (cross-compiled for MSVC). Each archive has a .sha256 sidecar. SHA256SUMS covers the five versioned archives. The unversioned fmd-<triple> compatibility aliases, the raw fmd (Linux x86_64) and fmd.exe binaries and the npm tarball are byte-identical copies, each with its own .sha256 sidecar. As in 0.5.0, artifacts are not minisign-signed. The macOS binaries are not notarized.
  • Each binary was run on its platform before publishing: Linux x86_64 and aarch64 in Ubuntu 22.04, macOS arm64 natively and x86_64 under Rosetta, Windows on Windows 11. Each reports fmd 0.6.0 and renders the same PDF.
  • Tests: the full workspace suite passed (4,400 tests). Formatting and strict Clippy (--all-targets -D warnings) are clean. The WASM core check, the browser package check (node runtime suites, exact native/WASM HTML and PDF parity, size budget) and DSR's WASM package gate also pass.
  • Browser package 0.6.0 is built and verified. npm publication is still pending publishing credentials, so the ready-to-install npm tarball is attached to this release. The WASM module is 7,710,701 raw / 3,384,740 gzip bytes (0.5.0: 7,701,812 / 3,274,774), within the 7.9 MB raw budget.
  • Known test flakes and gaps carried over: none new in this release; owner pre-publish items #18 (compiler support floor) and #19 (fuzz lock) remain open.

Release builds and orchestration use DSR exclusively. No GitHub Actions were used for this release.

v0.5.0 — books, flow engine and native workspace

Choose a tag to compare

@Dicklesworthstone Dicklesworthstone released this 02 Oct 23:00

Highlights

  • Books and publishing: fmd book renders multi-chapter books to PDF, EPUB and offline HTML sites. It resolves cross-chapter links, keeps footnotes and assets per chapter, binds exact PDF chapter navigation and page counts, and adds offline full-text search to sites. EPUB exports package images, MathML/SVG, embedded font subsets and themes.
  • Browser/WASM: reusable book sessions and cancellable worker exports, persistent flow-editor sessions with paged layout, a Canvas preview with source navigation, a semantic reader with Unicode search, and document workers with cancellation.
  • Interactive HTML workspace: editable offline workspaces with native WASM rendering. They support image import, document settings, font authoring, source find/replace, background previews, cancellable PDF/HTML/EPUB/SVG exports, Document Lab reports, PDF proofs and recovery copies.
  • Layout and PDF: an exact mixed-height pagination planner, typeset display equations, composed Latin accents, rich footnote bodies, and opt-in running headers and footers (#13).
  • Languages and editors: incremental lexers for Rust, Go, Shell, C++, JavaScript, TypeScript, JSX and TSX, and an opt-in fmd-lsp language server (feature lsp).

Security

Highlighted code in the default (safe) HTML could contain live markup, for example from an HTML/XML/SVG fence containing <?x><img src=x onerror=...>?>. This was present since 0.4.4. Every highlighted token is now escaped. Upgrade if you render untrusted Markdown through the CLI, MCP server, WASM package, books or EPUB.

Breaking changes

  • PdfOptions and several other public option and result structs gained fields. Construct them with ..Default::default().
  • mcp::handle_tool_call returns a typed ToolError. The MCP server uses standard stdio framing: newline-delimited JSON by default, Content-Length accepted. It rejects unknown tool arguments with -32602.
  • fmd book validates book.toml strictly: unknown keys, chapters missing from order, and non-UTF-8 file names are errors.
  • Default PDF/SVG bytes change: vector display math, glyph expansion only with microtype, and exact pagination.

See CHANGELOG.md for the full list.

Distribution and verification

  • franken_markdown 0.5.0, fmd-font 0.3.3 and fmd-math 0.1.2 are published on crates.io.
  • Five native targets were built through DSR: Linux x86_64/aarch64 (glibc 2.28 floor), macOS x86_64/arm64, and Windows x86_64. Each archive has a .sha256 sidecar. SHA256SUMS covers the five versioned archives. The unversioned fmd-<triple> compatibility aliases, the raw fmd/fmd.exe binaries and the npm tarball are byte-identical copies, each with its own .sha256 sidecar. As in 0.4.5, artifacts are not minisign-signed.
  • Tests: the full workspace suite passed (4,155 tests). Formatting and strict Clippy (--all-targets -D warnings) are clean. Node runtime suites and exact native/WASM HTML and PDF parity also pass.
  • Browser package 0.5.0 is built and verified. npm publication is still pending publishing credentials, so the ready-to-install npm tarball is attached to this release. The WASM module is now 7,701,812 raw / 3,274,774 gzip bytes, up from about 4.6 / 2.0 MB in 0.4.5, because of the new book, flow-engine and workspace features.

Release builds and orchestration use DSR exclusively. No GitHub Actions were used for this release.

v0.4.5 — CFF font mechanics and bounded shaping

Choose a tag to compare

@Dicklesworthstone Dicklesworthstone released this 15 Sep 22:21

Reusable font mechanics

  • CFF1 (#10): exact cubic outline decoding and deterministic sparse subsets, with explicit embedding format and old-to-new glyph maps. All 3,693 Bravura 1.392 outlines and horizontal metrics match FontTools.
  • Typed subset errors (#11): additive Result APIs distinguish unsupported formats/operators, invalid glyphs, malformed data, and resource limits. Existing TrueType bytes and Option APIs remain compatible.
  • Bounded multilingual shaping (#12): explicit script/language/direction/features, glyph advances/offsets, UTF-8 source clusters and logical-text recovery. Latin combining marks, basic Arabic joining/RTL, ligatures and pair positioning match HarfBuzz fixtures. Unsupported mechanisms fail explicitly; callers own bidi segmentation and normalization.

See the font API guide for exact coverage and embedding requirements. These library APIs do not replace the existing Markdown/PDF layout path.

Distribution and verification

  • franken_markdown 0.4.5 and fmd-font 0.3.2 are published on crates.io; fmd-math remains 0.1.1.
  • Five native targets built through DSR. Intel macOS artifacts have ad-hoc code signing for Rosetta compatibility; this is not an Apple Developer ID signature.
  • 2,730 tests passed, along with formatting, all-target checking, strict Clippy, core/WASM portability, Node runtime smoke tests, and exact native/WASM HTML and PDF parity.
  • WASM: 4,719,170 raw bytes / 2,035,776 gzip bytes, within committed budgets.
  • Browser package 0.4.5 is built and verified; npm publication is pending publishing credentials. A ready-to-install npm tarball is attached to this release.

Release builds and orchestration use DSR exclusively. No GitHub Actions were used for this release cycle.

v0.4.4 — lexer robustness and standalone builds

Choose a tag to compare

@Dicklesworthstone Dicklesworthstone released this 15 Sep 21:17

Changes

  • Fix Go UTF-8 panics on malformed hexadecimal escapes (#9).
  • Fix Python/shared-lexer control-whitespace hangs (#8).
  • Remove the undocumented sibling checkout test dependency (#7).
  • Repair shell offsets, SQL Unicode boundaries, HTML incremental tag handling, and JavaScript/TypeScript highlighting.
  • Include incremental language APIs added since 0.4.3; pin matching wasm-bindgen tooling.

Distribution

Five targets: Linux x86_64/ARM64, macOS Intel/Apple Silicon, and Windows x86_64 (MSVC). Archives include SHA-256 sidecars and a combined SHA256SUMS file. DSR source revision: d4dc7cb.

Rust packages: franken_markdown 0.4.4, fmd-font 0.3.1, fmd-math 0.1.1. Browser package: @franken-suite/franken-markdown 0.4.4.

Validation

2,721 Rust tests passed; formatting, all-target checks and strict Clippy passed. Native/WASM core builds, WASM runtime smoke, package size budgets, and byte-identical HTML/PDF parity passed. Native archives were built for all five targets.

v0.4.3

Choose a tag to compare

@Dicklesworthstone Dicklesworthstone released this 31 Aug 21:01

Release 0.4.3

v0.4.2

Choose a tag to compare

@Dicklesworthstone Dicklesworthstone released this 28 Aug 23:23

PDF/A-2b compliance patch. The repaired veraPDF CI gate (old Docker Hub image was deleted upstream; now on verapdf/cli) caught a real non-compliance: the ToUnicode stream writer omitted the ISO 32000 EOL before endstream, so every embedded-font stream declared Length one byte over (ISO 19005-2 clause 6.1.7.1). One-line fix; all stream lengths verified byte-exact; gate green on main. Also includes stepped type-scale presets (--type-size) and crates.io alignment (fmd-font 0.3.0, fmd-math 0.1.0).

All 83 test suites green; CommonMark 381/652 (64.8% in-scope, ratcheted); native↔WASM byte parity; every archive smoke-tested before upload.

v0.4.1

Choose a tag to compare

@Dicklesworthstone Dicklesworthstone released this 28 Aug 22:02

Document navigation, WOFF1 embedding, watch/PDF-A surfaces, and a reality-check hardening wave.

Highlights: MathML Core HTML output; hyphenation for de/fr/es/nl; GFM-plus definition lists; HTML TOC + PDF contents page with dot leaders and linked page numbers; PDF outline bookmarks; WOFF1 embedded font subsets (default; 18.4% smaller showcase HTML, --html-font-format ttf to opt out); recursive fmd watch <dir>; PDF/A-2b with veraPDF CI; chunked PDF page emission with bounded parallel compression; fmd doctor fonts coverage auditor; iOS/Mac Catalyst app scaffold.

Hardening: dated-nightly toolchain pin restored; gate scripts survive rch offload (host-executable checks + local rebuild fallback); CommonMark ratchet 379 → 381; wasm size budget re-ratcheted with measured history.

Verification: 83 test suites green; CommonMark 381/652 (64.8% in-scope, ratcheted floor); native↔WASM byte parity; each archive smoke-tested on its platform family before upload (x86_64-apple-darwin smoke ran under Rosetta).

Platforms: Linux x86_64, macOS Apple Silicon, macOS Intel. Windows and Linux aarch64 archives follow the workflow matrix when it is re-enabled.

v0.4.0

Choose a tag to compare

@Dicklesworthstone Dicklesworthstone released this 25 Aug 01:18

Minor bump: 51 commits since v0.3.4, 17 of them features, no breaking changes.

Added

  • fmd-math is the bulk of this release: the tier-2 symbol shelf, labeled extensible arrows, text accents (\', \") parsed in text mode and refused in math, \dddot / \ddddot, \doublespacing as a text-mode line-spacing control, and the tier-2 size / substack / align surfaces. The extensions layer lands drawn delimiters, environments, stretchy accents, macros and packs, and the span map gives exact provenance everywhere plus a query surface.
  • A clean-room TrueType/OpenType font reader (text.rs), and UAX #14 CJK line breaking so ideographs stop overrunning the measure.
  • fmd-font was factored into its own workspace crate, gained a glyf outline decoder, and now ships the bundled OFL faces in-crate behind bundled-faces.

Crates

fmd-font is bumped 0.1.0 → 0.2.0 and both dependents' requirements move with it. It had changed materially since v0.3.4 while keeping the 0.1.0 version already published on crates.io, so publishing the root against fmd-font = "0.1.0" would have resolved to the older published crate rather than this tree.

fmd-math stays at 0.1.0: it is a workspace member, is not a dependency of the root crate, and is not published.

Platforms in this release

This release ships Linux x86_64 and aarch64 only. Both were verified before upload — architecture asserted with file, and the glibc floor measured with objdump -T:

asset arch glibc floor
fmd-v0.4.0-x86_64-unknown-linux-gnu.tar.gz x86-64 2.28
fmd-v0.4.0-aarch64-unknown-linux-gnu.tar.gz aarch64 2.28

Both are cross-built with cargo zigbuild against a GLIBC 2.28 floor. A host-native build inherits the build host's glibc and produced a 2.39 floor, which would have excluded Debian 12, Ubuntu 22.04 LTS, RHEL 9 / Rocky 9 and Amazon Linux 2023. Those artifacts were rebuilt rather than published.

macOS and Windows artifacts are not in this release. The macOS build host could not be reached by the release tooling during this run, and rather than publish a binary that had not been built and checked, those targets were left out. They are unaffected by anything in the source and can be added by re-running the build for those targets. macOS and Windows users can build from source (cargo install --path . --features cli) or use the previous release in the meantime.

Each archive carries a .sha256 companion, and SHA256SUMS covers every archive. Both the versioned (fmd-v0.4.0-<triple>.tar.gz) and unversioned (fmd-<triple>.tar.gz) names are published, matching what install.sh probes for.

Verification

Gate: 1883 tests passed across 50 test binaries; cargo clippy --workspace --all-targets -- -D warnings exit 0.

One test, perf_gauntlet_refuses_existing_run_before_building, fails only in environments without a .git directory: scripts/perf-gauntlet.sh runs git rev-parse --show-toplevel before its usage check, so it exits 128 rather than the expected 64. Confirmed directly in a real checkout that the script exits 64 as the test expects.

⌂ 换网址