@natjswenson/press 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -5,6 +5,41 @@ All notable changes to the **press** skill are documented here.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
 this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2026-08-01
+
+Font stacks become per-engine profiles. Migrating `local-fitness` measured a real
+regression the previous single-stack model would have shipped.
+
+### Added
+
+- **`fonts.profiles`** — the brand's type *intent* is one thing; the fallback
+  chain that achieves it depends on the rendering engine. Targets pick one with
+  `params.font_profile`; omitting it uses `fonts.default_profile` (`browser`), so
+  every existing consumer is byte-for-byte unchanged.
+  - **`browser`** — Chromium/WebKit. `-apple-system` resolves to SF and the
+    fallbacks are never reached, so depth is free.
+  - **`fontconfig`** — WeasyPrint and anything else walking the chain for real.
+    Deliberately shallower: every extra face is one that can *win*.
+- An unknown `font_profile` is an error, never a silent fall back to the default.
+
+### Fixed
+
+- **The union stack visibly broke WeasyPrint output.** `local-fitness` renders
+  through WeasyPrint, which resolves none of the `ui-*` / `-apple-system`
+  keywords and walks the chain for real. The browser-tuned list put `Inter` and
+  `'Helvetica Neue'` ahead of `Arial`, and headlines resolved to
+  **Helvetica Neue Heavy Condensed** — measured with `pdffonts`, not assumed.
+  Under the `fontconfig` profile it renders `Arial-Bold` / `Georgia-Bold` /
+  `Menlo-Bold`, exactly as it always has.
+
+### Changed
+
+- **Migrated `budget` and `local-fitness`.** budget renders through headless
+  Chrome, where the widened stacks are provably inert: identical embedded faces
+  and byte-identical rendered pages. local-fitness takes the `fontconfig`
+  profile and its emitted theme changed **zero values**. Suites stay green
+  (894 and 2063 tests).
+
 ## [0.2.0] - 2026-08-01
 
 Everything `natejswenson.io` needed to adopt the brand without changing by a
@@ -92,5 +127,6 @@ source of truth and a CI drift gate.
   rasterised cards, whose eyebrow legitimately runs at `.16em`. Scoped rather
   than waived, and caught by linting the real shipped corpus.
 
+[0.3.0]: https://github.com/natejswenson/claude-skills/releases/tag/press-v0.3.0
 [0.2.0]: https://github.com/natejswenson/claude-skills/releases/tag/press-v0.2.0
 [0.1.0]: https://github.com/natejswenson/claude-skills/releases/tag/press-v0.1.0

package/SKILL.md

@@ -2,7 +2,7 @@
 name: press
 description: The one brand system for everything produced in Claude — design tokens, the visual laws, the run-presentation contract, and the universal voice core. Use when composing or restyling any artifact (report, résumé, card, cover, PDF, HTML page, chart), when asked about brand colors, fonts, the accent law or "the PRESS look", when adding a new skill that renders anything, or when a brand value needs to change everywhere at once. Also handles "check the brand is in sync", "why do my colors differ", and onboarding a new consumer repo.
 user_invocable: true
-version: 0.2.0
+version: 0.3.0
 ---
 
 # /press — the brand system

package/brand/tokens.json

@@ -41,10 +41,22 @@
     "fill_steps": ["ink", "ink_mid", "dim"]
   },
   "fonts": {
-    "$comment": "The union of every consumer's stack. Fallbacks are additive, so the richest chain is the canonical one — the résumé's print-tuned stacks were the deepest and became these. Single quotes so the same string is valid CSS and needs no escaping in a Python literal.",
-    "display_stack": "-apple-system, BlinkMacSystemFont, 'Segoe UI', Inter, Roboto, 'Helvetica Neue', Arial, sans-serif",
-    "serif_stack": "'New York', ui-serif, Georgia, 'Iowan Old Style', 'Times New Roman', serif",
-    "mono_stack": "ui-monospace, 'SF Mono', 'Cascadia Code', 'JetBrains Mono', Menlo, Consolas, monospace"
+    "$comment": "The brand's type INTENT is one thing — SF-like sans for structure, New York-like serif for commentary, SF Mono-like mono for data. The fallback chain that actually achieves it depends on the rendering engine, so there are profiles rather than one list. Chromium resolves -apple-system to SF and never reaches the fallbacks; fontconfig (WeasyPrint) resolves none of the ui-*/-apple-system keywords and walks the chain for real, where a browser-tuned list lands on Helvetica Neue *Heavy Condensed* — measured with pdffonts, not assumed. Pick with params.font_profile; omitting it gives you `default_profile`. Single quotes so the same string is valid CSS and needs no escaping in a Python literal.",
+    "default_profile": "browser",
+    "profiles": {
+      "browser": {
+        "$comment": "Chromium/WebKit. -apple-system wins on macOS; the rest is depth for other platforms. The union of every browser consumer's chain, since fallbacks are additive.",
+        "display_stack": "-apple-system, BlinkMacSystemFont, 'Segoe UI', Inter, Roboto, 'Helvetica Neue', Arial, sans-serif",
+        "serif_stack": "'New York', ui-serif, Georgia, 'Iowan Old Style', 'Times New Roman', serif",
+        "mono_stack": "ui-monospace, 'SF Mono', 'Cascadia Code', 'JetBrains Mono', Menlo, Consolas, monospace"
+      },
+      "fontconfig": {
+        "$comment": "WeasyPrint and anything else going through fontconfig, where the chain is walked for real. Measured to land on Arial-Bold / Georgia-Bold / Menlo-Bold — the faces local-fitness has always rendered. Deliberately shallower than the browser profile: every extra face here is one that can win, so depth is risk rather than robustness.",
+        "display_stack": "-apple-system, BlinkMacSystemFont, 'Segoe UI', Arial, sans-serif",
+        "serif_stack": "'New York', ui-serif, Georgia, 'Times New Roman', serif",
+        "mono_stack": "ui-monospace, 'SF Mono', Menlo, monospace"
+      }
+    }
   },
   "identity": {
     "stamp": "NS",

package/lib/emit.mjs

@@ -48,6 +48,7 @@ function pythonTheme(tokens, params) {
   const brandLine = required(params, 'brand_line', 'python-theme');
   const byline = params.byline ?? tokens.identity.byline;
   const docKind = params.document_kind ?? 'DOCUMENT';
+  const fonts = fontsFor(tokens, params);
 
   const out = [];
   out.push('import copy');
@@ -88,11 +89,11 @@ function pythonTheme(tokens, params) {
   out.push('    },');
   out.push('    "fonts": {');
   out.push('        # Display/structure voice, set 800-900 with tight tracking by the CSS.');
-  out.push(`        "display_stack": ${py(tokens.fonts.display_stack)},`);
+  out.push(`        "display_stack": ${py(fonts.display_stack)},`);
   out.push('        # Commentary voice: serif italics for standfirsts and captions.');
-  out.push(`        "serif_stack": ${py(tokens.fonts.serif_stack)},`);
+  out.push(`        "serif_stack": ${py(fonts.serif_stack)},`);
   out.push('        # Data voice: labels, dates, tables, provenance.');
-  out.push(`        "mono_stack": ${py(tokens.fonts.mono_stack)},`);
+  out.push(`        "mono_stack": ${py(fonts.mono_stack)},`);
   if (extras.has('mono_file')) {
     out.push('        # Point at a real TTF to load an authentic mono face via @font-face.');
     out.push('        "mono_file": None,');
@@ -191,7 +192,7 @@ function cssVars(tokens, params) {
     const name = (spec.name ?? spec.token).replace(/_/g, '-');
     const raw = spec.token === 'stamp'
       ? (params.stamp ?? tokens.identity.stamp)
-      : lookup(tokens, spec.token);
+      : lookup(tokens, spec.token, params);
     const value = spec.quote ? JSON.stringify(raw) : raw;
     // `comments: "explicit"` keeps only hand-written hints; the token notes are
     // written for a reader of tokens.json and are far too long for a CSS block.
@@ -253,7 +254,7 @@ function jsonTokens(tokens, params) {
   const payload = {
     colors: tokens.colors,
     terminal: tokens.terminal,
-    fonts: tokens.fonts,
+    fonts: fontsFor(tokens, params),
     identity: { ...tokens.identity, ...(params.stamp ? { stamp: params.stamp } : {}) },
     derived: { hair: tokens.derived.hair, fill_steps: tokens.derived.fillSteps },
   };
@@ -291,6 +292,22 @@ function required(params, key, emitter) {
   return value;
 }
 
+/**
+ * The font stacks for this target's rendering engine. Defaults to the token
+ * set's own default profile, so a target that says nothing is unchanged.
+ */
+function fontsFor(tokens, params = {}) {
+  const name = params.font_profile;
+  if (!name) return tokens.fonts;
+  const profile = tokens.fontProfiles?.[name];
+  if (!profile) {
+    throw new EmitError(
+      `unknown font_profile "${name}" (available: ${Object.keys(tokens.fontProfiles ?? {}).join(', ')})`,
+    );
+  }
+  return profile;
+}
+
 const DERIVED = {
   hair: 'hair',
   border: 'border',
@@ -298,9 +315,9 @@ const DERIVED = {
   accent_dim: 'accentDim',
 };
 
-function lookup(tokens, name) {
+function lookup(tokens, name, params = {}) {
   if (name in DERIVED) return tokens.derived[DERIVED[name]];
-  for (const group of [tokens.colors, tokens.terminal, tokens.fonts, tokens.identity, tokens.marks]) {
+  for (const group of [tokens.colors, tokens.terminal, fontsFor(tokens, params), tokens.identity, tokens.marks]) {
     if (name in group) return group[name];
   }
   throw new EmitError(`unknown token "${name}"`);

package/lib/tokens.mjs

@@ -37,6 +37,24 @@ const clean = (group) => {
   return out;
 };
 
+/**
+ * The three stacks for one rendering engine. An unknown profile name is an
+ * error rather than a silent fall back to the default — a target asking for
+ * `fontconfig` and quietly getting the browser chain is precisely the bug this
+ * whole mechanism exists to prevent.
+ */
+function fontProfile(raw, name) {
+  const profiles = raw.fonts?.profiles ?? {};
+  const key = name ?? raw.fonts?.default_profile;
+  const profile = profiles[key];
+  if (!profile) {
+    throw new Error(
+      `unknown font profile "${key}" (available: ${Object.keys(profiles).join(', ')})`,
+    );
+  }
+  return clean(profile);
+}
+
 function resolve(raw) {
   const colors = clean(raw.colors);
   const terminal = clean(raw.terminal);
@@ -64,7 +82,11 @@ function resolve(raw) {
     colors,
     terminal,
     notes: clean(raw.color_notes),
-    fonts: clean(raw.fonts),
+    fonts: fontProfile(raw, raw.fonts?.default_profile),
+    fontProfiles: Object.fromEntries(
+      Object.keys(raw.fonts?.profiles ?? {}).map((p) => [p, fontProfile(raw, p)]),
+    ),
+    defaultFontProfile: raw.fonts?.default_profile,
     identity: clean(raw.identity),
     marks: clean(raw.marks),
     limits: clean(raw.limits),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@natjswenson/press",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "One brand system — tokens, laws, run presentation and voice core — generated into every consumer with a CI drift gate",
   "license": "MIT",
   "author": "Nate Swenson",

package/targets.json

@@ -260,7 +260,9 @@
         "logging": true,
         "extras": [
           "mono_file"
-        ]
+        ],
+        "font_profile": "fontconfig",
+        "byline": "linkedin.com/in/natejswenson"
       },
       "init": {
         "replaceFrom": "^import copy$",