@natjswenson/press 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -5,6 +5,70 @@ 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
+single pixel. Surveying the site turned up four values the token set could not
+express, so it could not have been migrated without either losing them or
+hand-writing them locally — which is the failure mode press exists to end.
+
+### Added
+
+- **Alpha tints as first-class derived tokens** — `border`, `border_hover` and
+  `accent_dim`, computed from `ink` and `accent` so no consumer writes an
+  `rgba()` by hand.
+
+### Changed
+
+- **`mono_stack` gained `'JetBrains Mono'`.** The site's stack was one fallback
+  deeper than the token set's; emitting the shorter one would have silently
+  removed a face. Fallbacks are additive, so the union is canonical — the same
+  call made for the résumé's stacks in 0.1.0. Purely additive for every existing
+  consumer.
+
+### Known inconsistency, kept deliberately
+
+`hair` (0.18) and `border` (0.16) are the same idea at two different strengths —
+the résumé's hairline and the site's. They are recorded as separate tokens rather
+than reconciled, because reconciling them would change one of two shipped
+products. That is a decision to make on purpose, not a side effect of adopting
+press. Documented in `tokens.json` under `derived.$comment`.
+
 ## [0.1.0] - 2026-07-31
 
 First release. Replaces eight hand-ported copies of the PRESS brand with one
@@ -63,4 +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.1.0
+version: 0.3.0
 ---
 
 # /press — the brand system

package/brand/tokens.json

@@ -33,14 +33,30 @@
     "ink_faint": "Decorative only — a faint element inside an illustration. Never body text, never a headline."
   },
   "derived": {
+    "$comment": "Alpha tints, all computed from ink or accent so no consumer writes an rgba() by hand. hair (0.18) and border (0.16) are the SAME IDEA at two different strengths — the résumé's hairline and the site's. That is a real inconsistency, kept deliberately: reconciling them would change one of two shipped products, which is a decision to make on purpose and not as a side effect of adopting press.",
     "hair_alpha": 0.18,
+    "border_alpha": 0.16,
+    "border_hover_alpha": 0.38,
+    "accent_dim_alpha": 0.12,
     "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', 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,9 +292,32 @@ function required(params, key, emitter) {
   return value;
 }
 
-function lookup(tokens, name) {
-  if (name === 'hair') return tokens.derived.hair;
-  for (const group of [tokens.colors, tokens.terminal, tokens.fonts, tokens.identity, tokens.marks]) {
+/**
+ * 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',
+  border_hover: 'borderHover',
+  accent_dim: 'accentDim',
+};
+
+function lookup(tokens, name, params = {}) {
+  if (name in DERIVED) return tokens.derived[DERIVED[name]];
+  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,13 +37,38 @@ 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);
 
-  const hairAlpha = raw.derived?.hair_alpha ?? 0.18;
   const [r, g, b] = hexToRgb(colors.ink);
-  const hair = `rgba(${r}, ${g}, ${b}, ${hairAlpha})`;
+  const [ar, ag, ab] = hexToRgb(colors.accent);
+  const inkAlpha = (a) => `rgba(${r}, ${g}, ${b}, ${a})`;
+
+  const hairAlpha = raw.derived?.hair_alpha ?? 0.18;
+  const hair = inkAlpha(hairAlpha);
+  // Named separately from `hair` on purpose — see derived.$comment in tokens.json.
+  const border = inkAlpha(raw.derived?.border_alpha ?? hairAlpha);
+  const borderHover = inkAlpha(raw.derived?.border_hover_alpha ?? 0.38);
+  const accentDim = `rgba(${ar}, ${ag}, ${ab}, ${raw.derived?.accent_dim_alpha ?? 0.12})`;
 
   const fillSteps = (raw.derived?.fill_steps ?? []).map((name) => {
     const value = colors[name];
@@ -57,11 +82,15 @@ 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),
-    derived: { hair, hairAlpha, fillSteps },
+    derived: { hair, hairAlpha, border, borderHover, accentDim, fillSteps },
     /** Every literal color the brand permits, for the off-palette lint. */
     palette: [...Object.values(colors), ...Object.values(terminal)],
   };
@@ -77,6 +106,9 @@ export function hexToRgb(hex) {
 /** Look up a token by its flat name, including the derived ones. */
 export function tokenValue(tokens, name) {
   if (name === 'hair') return tokens.derived.hair;
+  if (name === 'border') return tokens.derived.border;
+  if (name === 'border_hover') return tokens.derived.borderHover;
+  if (name === 'accent_dim') return tokens.derived.accentDim;
   if (name in tokens.colors) return tokens.colors[name];
   if (name in tokens.terminal) return tokens.terminal[name];
   if (name in tokens.fonts) return tokens.fonts[name];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@natjswenson/press",
-  "version": "0.1.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$",
@@ -303,12 +305,33 @@
             "token": "ink_faint",
             "name": "fg-tertiary"
           },
+          {
+            "token": "border"
+          },
+          {
+            "token": "border_hover"
+          },
           {
             "token": "accent"
           },
+          {
+            "token": "accent_dim"
+          },
           {
             "token": "rule"
           },
+          {
+            "token": "display_stack",
+            "name": "font-display"
+          },
+          {
+            "token": "serif_stack",
+            "name": "font-serif"
+          },
+          {
+            "token": "mono_stack",
+            "name": "font-mono"
+          },
           {
             "token": "term_bg",
             "name": "panel"
@@ -330,6 +353,10 @@
             "name": "panel-bar"
           }
         ]
+      },
+      "init": {
+        "replaceFrom": "^:root \\{$",
+        "replaceTo": "^\\}$"
       }
     }
   ]