@natjswenson/press 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -5,6 +5,35 @@ 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.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 +92,5 @@ 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.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.2.0
 ---
 
 # /press — the brand system

package/brand/tokens.json

@@ -33,14 +33,18 @@
     "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"
+    "mono_stack": "ui-monospace, 'SF Mono', 'Cascadia Code', 'JetBrains Mono', Menlo, Consolas, monospace"
   },
   "identity": {
     "stamp": "NS",

package/lib/emit.mjs

@@ -291,8 +291,15 @@ function required(params, key, emitter) {
   return value;
 }
 
+const DERIVED = {
+  hair: 'hair',
+  border: 'border',
+  border_hover: 'borderHover',
+  accent_dim: 'accentDim',
+};
+
 function lookup(tokens, name) {
-  if (name === 'hair') return tokens.derived.hair;
+  if (name in DERIVED) return tokens.derived[DERIVED[name]];
   for (const group of [tokens.colors, tokens.terminal, tokens.fonts, tokens.identity, tokens.marks]) {
     if (name in group) return group[name];
   }

package/lib/tokens.mjs

@@ -41,9 +41,16 @@ 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];
@@ -61,7 +68,7 @@ function resolve(raw) {
     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 +84,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.2.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

@@ -303,12 +303,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 +351,10 @@
             "name": "panel-bar"
           }
         ]
+      },
+      "init": {
+        "replaceFrom": "^:root \\{$",
+        "replaceTo": "^\\}$"
       }
     }
   ]