Fonts wiring (TXT1-C Phase B): @font-face, font map, font manifest in the digest, web @font-face and assets

[thejackshelton]

What changed

• @font-face: accepted at the top level of a stylesheet and collected. The configuration takes an optional fonts map: Dragon Sans for sans-serif, Dragon Mono for monospace, or platform.
• Digest: the font manifest enters it only when a project has fonts.
• font-family:
  • It is keyed by how it resolves: pinned, declared, platform or unmapped. Ahem keeps font-family:Ahem.
  • An unmapped family is DRAGON_FONT_UNMAPPED_FAMILY on every target, including after var() substitution.
  • A quoted generic such as "sans-serif" names a family and is never pinned, matching Chrome (the font-map.ts fix).
• Diagnostics: eight new font codes (map invalid, unmapped family, remote URL, local(), unresolved asset, unreadable file, unsupported descriptor, variable font refused) and one warning (descriptor not applied).
• Variable-font fence: it runs on the faces Chrome would pick.
• Web output:
  • pinned generics are rewritten;
  • dragon.css starts with the @font-face rules;
  • the font bytes are returned as assets;
  • a project with no fonts gets byte-identical output.
• Other:
  • four planted faults;
  • Lato is mapped in pinned.json (recaptured) and in the north-star check;
  • docs/api.md gains a Fonts section.

Native targets still refuse any font but Ahem. Real fonts on device are TXT1a-1/2, which follow inline formatting.

What passed

• pnpm typecheck.
• The fonts-wiring and fonts tests (115).
• Font capture --check: byte-identical.
• north-star:check, run twice: totals unchanged.
• The full suite on the stacked parity branch: 109 files, 2319 tests.

Changed tests

• android-target: serif is mapped to platform, because serif alone is now an unmapped family.
• ua: the import pin.
• seams: font-face is accepted; the byte pin is intact.
• wire: the unmapped examples no longer use Lato, which is now mapped.

🤖 Generated with Claude Code

Note

Add font wiring to Dragon compiler: @font-face, font map, digest manifest, and web assets

• Adds the Phase B font pipeline: projects accept an optional fonts FontMap, @font-face rules are accepted at the top level of stylesheets, and their sources are resolved from snapshot assets during compilation.
• Font-family values in CSS are resolved against declared and pinned faces. Unmapped families produce the new DRAGON_FONT_UNMAPPED_FAMILY diagnostic, and per-case checks cover variable-font refusals, Ahem conflicts, and invalid family lists.
• Web output now rewrites pinned generic families, prepends generated @font-face rules, and returns bundled font assets on the ready ArtifactState. The font manifest contributes to the digest.
• Adds nine font diagnostic codes with catalogue entries in codes.ts, and documents the full font contract in docs/api.md.
• Behavioral Change: @font-face is the only at-rule accepted at the top level (others are still refused); generic DRAGON_UNSUPPORTED_VALUE is no longer emitted for unmapped font-family values, which now report DRAGON_FONT_UNMAPPED_FAMILY instead; ready artifacts gain a required assets collection; a lone unquoted generic family like sans-serif is now parsed as a family-list value rather than a family value.

^{Macroscope summarized 397f7d6.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR adds a substantial cross-cutting font capability, including new public configuration and artifact fields, @font-face parsing, font asset emission, digest changes, and altered handling of existing font-family declarations. The scope and unresolved semantic concern warrant human review.

Not approved because:

• 1 blocking correctness issue found at or above your repo's Minimum Blocking Severity

No code changes detected at 397f7d6. Prior analysis still applies.

^{Adjust the Minimum Blocking Severity for this repo — including turning it Off — in Settings. You can add or adjust custom eligibility rules. Learn more.}

[macroscopeapp]

🟡 Medium css/values.ts:107

Quoted generic families such as font-family: "ui-serif" are pinned or replaced as the mapped generic ui-serif, changing both the selected font and emitted CSS. familyListText sends the single-family value through familySupport without preserving that it was quoted; exclude generic names from resolution when the value is a family, while continuing to resolve bare generic lists.

-  if (v.kind === 'family') return serializeString(v.value);
+  if (v.kind === 'family') {
+    const name = asciiLower(v.value);
+    return (GENERIC_FAMILY_KEYWORDS as readonly string[]).includes(name) ? null : serializeString(v.value);
+  }

🚀 Reply "fix it for me" or copy this AI Prompt for your agent:

In file @packages/dragon/src/css/values.ts around lines 107-108:

Quoted generic families such as `font-family: "ui-serif"` are pinned or replaced as the mapped generic `ui-serif`, changing both the selected font and emitted CSS. `familyListText` sends the single-family value through `familySupport` without preserving that it was quoted; exclude generic names from resolution when the value is a `family`, while continuing to resolve bare generic lists.

[thejackshelton]

Chrome 145 treats "ui-serif" and ui-serif as the same family: ui-*, emoji and fangsong are family names to its parser whether quoted or not, and both serialize as ui-serif (new P2 case quoted-ui-serif). So resolving a quoted "ui-serif" like the bare one matches Chrome, and returning null would not. The quoting distinction applies only to the parser generics (sans-serif, serif, monospace, system-ui, -webkit-body, …), where a quoted name was already treated as a family. Checking that class turned up a real hole, fixed in db4673b: a family named like a generic in another case ("SANS-SERIF", "-webkit-body") was written bare in the web output, and bare it re-parses as the generic. Dragon now quotes those names. The Chrome font reference had the same hole and is fixed too, with Chrome-backed P2 cases for quoted, escaped and case-variant generics (a33056f).

---

Generated by Claude Code