Repository navigation
Releases
v0.8.0 — Mermaid timelines, authoring dialects, font/math & WASM 0.8.0
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
timelinediagrams: Clean-roomtimelineparsing 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-gfmorgfm-plusacross 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 sparsegvartuple 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/LblPDF 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-lspfile/folder rename repairs (including synchronized opened include graphs) and footnote/reference label completion;fmd mcpadds in-memoryfmd.render_svgandfmd.render_epub. - Browser/WASM package (
0.8.0): Qualified withwasm-bindgen 0.2.130(8.44 MBraw /3.28 MBgzip — 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 asfranken-suite-franken-markdown-0.8.0.tgz(+.sha256sidecar).
Reliability, Dependencies & MSRV
- MSRV 1.88 qualified (#18):
franken_markdown(core library and defaultfmdCLI),fmd-font 0.5.0, andfmd-math 0.4.0build and pass tests on Rust1.88.0(Cargo cleanly rejects Rust1.85.1). Optional--features batchrequires Rust1.95+due to itsasupersyncdependency graph. - Fuzz lockfile refreshed (#19):
fuzz/Cargo.lockupdated and verified withcargo build --manifest-path fuzz/Cargo.toml --bins --lockedand 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 auditclean on root and fuzz lockfiles).
Install
Quick install (Linux / macOS)
curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/franken_markdown/main/install.sh | bashcrates.io (Rust 1.88+)
cargo install franken_markdownPublished 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
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-fontandfmd-mathset
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 IDcaféand# 中文 Guidegets中文-guide.
0.6.0 dropped non-ASCII characters and gave a heading with no ASCII letters
or digits the IDsection, 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 newanchorsmodule
exposesheading_slug,text_sluganddecode_fragment(57807a2). --pdf-aneeds a PDF target:fmd render,fmd watchandfmd 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 2bwas not rejected before (3b3b72f).fmd batchapplies each document's frontmatter: title, author (PDF),
lang,tocandtoc_depthcome from each input's frontmatter after
include expansion, as infmd render. An explicit flag wins, then
frontmatter, then native config, sotoc: falsein a document overrides a
configured TOC. 0.6.0 batch did not read frontmatter and applied config
lang,tocandtoc_depthto every file. Library batch callers'
HtmlOptionsandPdfOptionscount as explicit options, and native config
is not read for them (09bcc80).fmd batchfetches remote images by default:--to pdf,--to bothand
--to svgjobs now download http(s) image destinations, including those in
included fragments and supported raw HTML, with the systemcurlorwget
asfmd renderdoes: once per distinct URL per document, within
--max-pdf-image-bytesand--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-imagesto 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
andfmd batchstarts curl with--disableand wget with--no-config, so
personal curl and wget config files no longer apply; proxy and certificate
environment variables still do (8029c89). - The
fmdbinary embeds a CJK font: the defaultclifeature now enables
the newcjk-facefeature, sofmdcarries a 9,867,212-byte Noto Sans SC
subset. CJK text in PDF and SVG draws glyphs instead of.notdefboxes with a
missing_glyphswarning, and HTML and EPUB output for documents with CJK
text embeds a CJK subset. Builds withoutclileave 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 withpdf_a_cmyk_image(the output profile is sRGB) and
leaves existing output files untouched; unused image mappings do not
trigger it (44c88dc). - Numbered
alignis refused: fmd-math used to set\begin{align}and drop
its equation numbers. It is now refused by name, likeequation,gather
andmultline;align*andalignedstill work. Infmd render, PDF and
SVG output print a warning namingenv:alignand show the formula's TeX
source in its place; HTML output carries the TeX source in itsmath displayblock 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_paginationand the three typography
defaults now apply to books; explicit flags still win.--check-linksnow
conflicts with the new publishing flags (47f6bc0). FMD_TAIL_*switches are gone:FMD_TAIL_NOGLYPH,FMD_TAIL_NOHEXand
FMD_TAIL_NOPAIRno 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::typesetrefuses a formula source
over 65,536 bytes, or a layout over 65,536 glyphs or 262,144 path segments,
with the newMathError::Budget, and the freeparsefunctions apply the
same source limit. The nesting bound (64 levels) and the macro budgets report
Budgetwhere they reportedMalformed.fmduses 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::DisplayTextRungainsfill,baseline_yandmath_fallback,
flow_display::FlowInlineRungainsmath, andfmd_font::OwnedTextRun
gainsvertical_metrics(2fee8ba, 691b11a). - New public fields in
fmd-math:PlacedGlyph,PlacedRuleand
PlacedPathgaincolor: Option<Color>, andFracSpecgainsthickness
andcfrac(start fromFracSpec::PLAINorFracSpec::BINOM)
(d9c13d7, [19a7d64](https://github.com/Dicklesworthstone/franken_markdown/com...
v0.6.0 — book editions, PDF footnotes and math, TeX-accurate fmd-math
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 infmd-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/srcpass
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-math0.2.0:Layouthas a new publicorder: Vec<Placed>field (TeX's
emission order; newPlacedenum) andMathConstantshas new
display_integral_scale,script_spaceandjotfields; struct literals
must set them.MacroSet::canonical_bytesgains 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.renderand
five typography and font-format fields onWasmRenderOptions. Construct them
with..Default::default()(f444bba, 22d501e, 21a18a8). - The
wasm-bindgenfeature alone no longer exportsFmdFlowSessionor the
book and interactive-workspace bindings. Enablewasm-flow,wasm-book,
wasm-workspace, orwasm-fullfor all three, as the package builders do.
Calls to a missing binding reject withUNSUPPORTED_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 rendersdoc.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_markdown0.6.0,fmd-font0.3.4 andfmd-math0.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
.sha256sidecar.SHA256SUMScovers the five versioned archives. The unversionedfmd-<triple>compatibility aliases, the rawfmd(Linux x86_64) andfmd.exebinaries and the npm tarball are byte-identical copies, each with its own.sha256sidecar. 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.0and 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
Highlights
- Books and publishing:
fmd bookrenders 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-lsplanguage server (featurelsp).
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
PdfOptionsand several other public option and result structs gained fields. Construct them with..Default::default().mcp::handle_tool_callreturns a typedToolError. The MCP server uses standard stdio framing: newline-delimited JSON by default,Content-Lengthaccepted. It rejects unknown tool arguments with-32602.fmd bookvalidatesbook.tomlstrictly: unknown keys, chapters missing fromorder, 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_markdown0.5.0,fmd-font0.3.3 andfmd-math0.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
.sha256sidecar.SHA256SUMScovers the five versioned archives. The unversionedfmd-<triple>compatibility aliases, the rawfmd/fmd.exebinaries and the npm tarball are byte-identical copies, each with its own.sha256sidecar. 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
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_markdown0.4.5 andfmd-font0.3.2 are published on crates.io;fmd-mathremains 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
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
v0.4.2
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
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
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,\doublespacingas a text-mode line-spacing control, and the tier-2 size /substack/alignsurfaces. 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-fontwas factored into its own workspace crate, gained aglyfoutline decoder, and now ships the bundled OFL faces in-crate behindbundled-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.