@astralkit/mcp 1.0.0 → 1.1.0

package/dist/data/tokens.js

@@ -1,78 +1,436 @@
+// AUTO-GENERATED by packages/mcp/scripts/gen-tokens.cjs from
+// src/sdk/astralkit/astralkit-theme.css — do not edit by hand.
+// Re-run: node packages/mcp/scripts/gen-tokens.cjs
 export const DESIGN_TOKENS = `# AstralKit Design Token Reference
 
-## Surfaces
-- \`bg-ak-bg\` — page background
-- \`bg-ak-surface\` — card/panel background
-- \`bg-ak-surface-2\` — secondary surface (nested panels)
-- \`bg-ak-hover\` — hover state background
-- \`bg-ak-elevated\` — elevated surface (modals, popovers)
-
-## Text
-- \`text-ak-text\` — primary body text
-- \`text-ak-text-secondary\` — descriptions, supporting copy
-- \`text-ak-text-muted\` — timestamps, captions, tertiary info
-- \`text-ak-text-disabled\` — disabled controls
-- \`text-ak-text-inverse\` — text on dark/ink backgrounds
-- \`text-ak-text-link\` — inline hyperlinks
-- \`text-ak-on-primary\` — text on primary-colored backgrounds
-
-## Borders
-- \`border-ak-border\` — default border
-- \`border-ak-border-subtle\` — lighter border
-- \`border-ak-border-strong\` — emphasis border
-
-## Primary (buttons, CTAs)
-- \`bg-ak-primary\` — primary action background
-- \`bg-ak-primary-hover\` — primary hover state
-- \`text-ak-on-primary\` — text on primary background
-- \`bg-ak-primary-subtle\` — soft tint (badges, soft buttons)
-
-## Status Colors
-- \`ak-success\` / \`ak-warning\` / \`ak-danger\` / \`ak-info\`
-- Each has \`-subtle\` and \`-text\` variants
-
-## Spacing Scale
-- \`ak-0_5\` (4px) · \`ak-1\` (8px) · \`ak-1_5\` (12px) · \`ak-2\` (16px)
-- \`ak-2_5\` (20px) · \`ak-3\` (24px) · \`ak-4\` (32px) · \`ak-5\` (40px) · \`ak-6\` (48px)
-
-## Typography Scale
-- \`text-ak-xs\` (12px) · \`text-ak-sm\` (14px) · \`text-ak-base\` (16px)
-- \`text-ak-lg\` (18px) · \`text-ak-xl\` (20px) · \`text-ak-2xl\` (24px)
-
-## Fluid Typography (headings)
-- \`text-ak-fl-lg\` · \`text-ak-fl-xl\` · \`text-ak-fl-2xl\` · \`text-ak-fl-3xl\`
-- \`text-ak-fl-4xl\` · \`text-ak-fl-5xl\`
-
-## Radii
-- \`rounded-ak-sm\` · \`rounded-ak-md\` · \`rounded-ak-lg\` · \`rounded-ak-xl\` · \`rounded-ak-full\`
-
-## Control Heights
-- \`min-h-ak-control-sm\` (32px) · \`min-h-ak-control-md\` (40px)
-- \`min-h-ak-control-lg\` (48px) · \`min-h-ak-control-xl\` (56px)
-
-## Layout
-- \`max-w-ak-page\` (80rem) — max page width
-- \`h-ak-nav\` — nav bar height
-- \`px-ak-fl-page-margin\` — fluid side padding (16px mobile → 80px desktop)
+**This is the complete, authoritative list of every \`ak-*\` design token.**
+These are the ONLY valid AstralKit tokens. Do NOT invent or guess a token that
+is not listed here — in Tailwind v4 an undefined utility (e.g. \`bg-ak-surface-muted\`)
+**silently fails to compile** (no error, the element just renders unstyled).
+
+Tailwind v3 vs v4: the token NAMES and VALUES are identical in both. v4 reads them
+from \`astralkit/theme-v4\` (\`@theme\`) and auto-generates every utility. v3 reads
+\`astralkit/theme\` (CSS vars) plus the \`astralkit/tailwind\` plugin, which registers
+the same utilities. Either way the class names below are what you write.
+
+---
+
+## Colors
+Each color token works with every color utility: \`bg-*\`, \`text-*\`, \`border-*\`, \`ring-*\`, \`fill-*\`, \`stroke-*\`, \`from-*\`/\`to-*\`/\`via-*\`.
+Example: token \`ak-surface\` → \`bg-ak-surface\`, \`text-ak-surface\`, \`border-ak-surface\`.
+
+- \`ak-neutral-0\` — \`#ffffff\`
+- \`ak-neutral-50\` — \`#fafafa\`
+- \`ak-neutral-100\` — \`#f5f5f5\`
+- \`ak-neutral-200\` — \`#e5e5e5\`
+- \`ak-neutral-300\` — \`#d4d4d4\`
+- \`ak-neutral-400\` — \`#a3a3a3\`
+- \`ak-neutral-500\` — \`#737373\`
+- \`ak-neutral-600\` — \`#525252\`
+- \`ak-neutral-700\` — \`#404040\`
+- \`ak-neutral-800\` — \`#262626\`
+- \`ak-neutral-900\` — \`#171717\`
+- \`ak-neutral-950\` — \`#0a0a0a\`
+- \`ak-primary-50\` — \`#f5f5f5\`
+- \`ak-primary-100\` — \`#e5e5e5\`
+- \`ak-primary-200\` — \`#cccccc\`
+- \`ak-primary-300\` — \`#a3a3a3\`
+- \`ak-primary-400\` — \`#737373\`
+- \`ak-primary-500\` — \`#525252\`
+- \`ak-primary-600\` — \`#404040\`
+- \`ak-primary-700\` — \`#333333\`
+- \`ak-primary-800\` — \`#1a1a1a\`
+- \`ak-primary-900\` — \`#000000\`
+- \`ak-primary-950\` — \`#000000\`
+- \`ak-primary\` — \`#000000\`
+- \`ak-primary-hover\` — \`#1a1a1a\`
+- \`ak-primary-active\` — \`#333333\`
+- \`ak-bg\` — \`#ffffff\`
+- \`ak-surface\` — \`#fafafa\`
+- \`ak-surface-2\` — \`#f5f5f5\`
+- \`ak-hover\` — \`#f7f7f7\`
+- \`ak-active\` — \`#f0f0f0\`
+- \`ak-elevated\` — \`#ffffff\`
+- \`ak-surface-raised\` — \`#ffffff\`
+- \`ak-surface-raised-soft\` — \`rgba(255, 255, 255, 0.78)\`
+- \`ak-surface-glass\` — \`rgba(255, 255, 255, 0.72)\`
+- \`ak-surface-glass-strong\` — \`rgba(255, 255, 255, 0.84)\`
+- \`ak-highlight-soft\` — \`rgba(255, 255, 255, 0.45)\`
+- \`ak-highlight-strong\` — \`rgba(255, 255, 255, 0.72)\`
+- \`ak-skeleton-base\` — \`#ededed\`
+- \`ak-skeleton-shine\` — \`rgba(255, 255, 255, 0.72)\`
+- \`ak-overlay\` — \`rgba(0, 0, 0, 0.5)\`
+- \`ak-on-primary\` — \`#ffffff\`
+- \`ak-primary-subtle\` — \`#f5f5f5\`
+- \`ak-primary-subtle-hover\` — \`#e5e5e5\`
+- \`ak-text\` — \`#171717\`
+- \`ak-text-emphasis\` — \`#2b2b2b\`
+- \`ak-text-secondary\` — \`#525252\`
+- \`ak-text-muted\` — \`#a3a3a3\`
+- \`ak-text-disabled\` — \`#d4d4d4\`
+- \`ak-text-inverse\` — \`#ffffff\`
+- \`ak-text-link\` — \`#000000\`
+- \`ak-text-placeholder\` — \`#525252\`
+- \`ak-border\` — \`#dee2e6\`
+- \`ak-border-subtle\` — \`#e5e5e5\`
+- \`ak-border-strong\` — \`#525252\`
+- \`ak-border-focus\` — \`#000000\`
+- \`ak-success\` — \`#16a34a\`
+- \`ak-success-subtle\` — \`#f0fdf4\`
+- \`ak-success-text\` — \`#15803d\`
+- \`ak-warning\` — \`#d97706\`
+- \`ak-warning-subtle\` — \`#fffbeb\`
+- \`ak-warning-text\` — \`#b45309\`
+- \`ak-danger\` — \`#dc2626\`
+- \`ak-danger-subtle\` — \`#fef2f2\`
+- \`ak-danger-text\` — \`#b91c1c\`
+- \`ak-info\` — \`#2563eb\`
+- \`ak-info-subtle\` — \`#eff6ff\`
+- \`ak-pink\` — \`#db2777\`
+- \`ak-pink-subtle\` — \`#fdf2f8\`
+- \`ak-info-text\` — \`#1d4ed8\`
+- \`ak-sheet-handle\` — \`#d4d4d4\`
+- \`ak-brutal-ink\` — \`#000000\`
+- \`ak-brutal-face\` — \`#ffffff\`
+- \`ak-brutal-face-dark\` — \`#262626\`
+- \`ak-brutal-on-face\` — \`#000000\`
+- \`ak-brutal-on-face-dark\` — \`#ffffff\`
+- \`ak-chart-1\` — \`#4e79a7\`
+- \`ak-chart-2\` — \`#f28e2c\`
+- \`ak-chart-3\` — \`#e15759\`
+- \`ak-chart-4\` — \`#76b7b2\`
+- \`ak-chart-5\` — \`#59a14f\`
+- \`ak-chart-6\` — \`#edc949\`
 
 ## Fonts
-- \`font-ak-sans\` — DM Sans (body)
-- \`font-ak-serif\` — DM Serif Display (display/headlines)
-- \`font-ak-mono\` — JetBrains Mono (code)
+\`font-*\` utilities.
+
+- \`font-ak-sans\` — 'Inter', system-ui, -apple-system, sans-serif
+- \`font-ak-serif\` — 'DM Serif Display', Georgia, serif
+- \`font-ak-mono\` — 'JetBrains Mono', 'Fira Code', ui-monospace, monospace
+
+## Font Size (text scale)
+\`text-*\` utilities. Includes static, \`_5\` half-steps, fluid (\`fl-*\`), display, watermark, avatar, and badge sizes.
+
+- \`text-ak-2xs\` — \`0.6875rem\`
+- \`text-ak-xs\` — \`0.75rem\`
+- \`text-ak-xs_5\` — \`0.8125rem\`
+- \`text-ak-sm\` — \`0.875rem\`
+- \`text-ak-sm_5\` — \`0.9375rem\`
+- \`text-ak-base\` — \`1rem\`
+- \`text-ak-lg\` — \`1.125rem\`
+- \`text-ak-xl\` — \`1.25rem\`
+- \`text-ak-xl_5\` — \`1.375rem\`
+- \`text-ak-2xl\` — \`1.5rem\`
+- \`text-ak-2xl_5\` — \`1.625rem\`
+- \`text-ak-3xl\` — \`2rem\`
+- \`text-ak-4xl\` — \`2.5rem\`
+- \`text-ak-4xl_5\` — \`2.75rem\`
+- \`text-ak-5xl\` — \`3rem\`
+- \`text-ak-6xl\` — \`3.75rem\`
+- \`text-ak-6xl_5\` — \`4rem\`
+- \`text-ak-7xl\` — \`4.5rem\`
+- \`text-ak-7xl_5\` — \`5.25rem\`
+- \`text-ak-8xl\` — \`6rem\`
+- \`text-ak-9xl\` — \`7rem\`
+- \`text-ak-10xl\` — \`8rem\`
+- \`text-ak-fl-xs\` — \`clamp(0.6875rem, 0.67rem  + 0.06vw, 0.75rem)\`
+- \`text-ak-fl-sm\` — \`clamp(0.75rem,   0.71rem  + 0.12vw, 0.875rem)\`
+- \`text-ak-fl-base\` — \`clamp(0.875rem,  0.84rem  + 0.12vw, 1rem)\`
+- \`text-ak-fl-lg\` — \`clamp(1rem,      0.96rem  + 0.12vw, 1.125rem)\`
+- \`text-ak-fl-xl\` — \`clamp(1.125rem,  1.09rem  + 0.12vw, 1.25rem)\`
+- \`text-ak-fl-2xl\` — \`clamp(1.25rem,   1.18rem  + 0.23vw, 1.5rem)\`
+- \`text-ak-fl-3xl\` — \`clamp(1.5rem,    1.39rem  + 0.35vw, 1.875rem)\`
+- \`text-ak-fl-4xl\` — \`clamp(1.875rem,  1.76rem  + 0.35vw, 2.25rem)\`
+- \`text-ak-fl-5xl\` — \`clamp(2.25rem,   2.03rem  + 0.69vw, 3rem)\`
+- \`text-ak-fl-6xl\` — \`clamp(3rem,      2.78rem  + 0.69vw, 3.75rem)\`
+- \`text-ak-fl-7xl\` — \`clamp(3.5rem,    3.2rem   + 0.93vw, 4.5rem)\`
+- \`text-ak-fl-8xl\` — \`clamp(4.5rem,    4.06rem  + 1.39vw, 6rem)\`
+- \`text-ak-fl-9xl\` — \`clamp(5.25rem,   4.73rem  + 1.62vw, 7rem)\`
+- \`text-ak-display-xs\` — \`clamp(0.75rem,   0.7rem  + 0.15vw, 0.875rem)\`
+- \`text-ak-display-sm\` — \`clamp(0.875rem,  0.83rem + 0.19vw, 1rem)\`
+- \`text-ak-display-base\` — \`clamp(1rem,      0.94rem + 0.28vw, 1.1875rem)\`
+- \`text-ak-display-lg\` — \`clamp(1.125rem,  1.01rem + 0.52vw, 1.5rem)\`
+- \`text-ak-display-xl\` — \`clamp(1.25rem,   1.07rem + 0.83vw, 1.875rem)\`
+- \`text-ak-display-2xl\` — \`clamp(1.5rem,    1.2rem  + 1.11vw, 2.25rem)\`
+- \`text-ak-display-3xl\` — \`clamp(1.875rem,  1.42rem + 1.67vw, 3rem)\`
+- \`text-ak-display-4xl\` — \`clamp(2.25rem,   1.58rem + 2.5vw,  3.75rem)\`
+- \`text-ak-display-5xl\` — \`clamp(3rem,      2.07rem + 3.47vw, 5.25rem)\`
+- \`text-ak-display-6xl\` — \`clamp(3.75rem,   2.5rem  + 4.63vw, 7rem)\`
+- \`text-ak-display-7xl\` — \`clamp(4.5rem,    3.06rem + 5.56vw, 8rem)\`
+- \`text-ak-display-8xl\` — \`clamp(5rem,      3.06rem + 6.94vw, 9rem)\`
+- \`text-ak-display-9xl\` — \`clamp(5.5rem,    3.06rem + 7.64vw, 10rem)\`
+- \`text-ak-watermark-2xs\` — \`clamp(1rem, 13cqi, 13rem)\`
+- \`text-ak-watermark-xs\` — \`clamp(1rem, 16cqi, 16rem)\`
+- \`text-ak-watermark-sm\` — \`clamp(1rem, 19cqi, 20rem)\`
+- \`text-ak-watermark-base\` — \`clamp(1rem, 21cqi, 22rem)\`
+- \`text-ak-watermark-md\` — \`clamp(1rem, 24cqi, 26rem)\`
+- \`text-ak-watermark-lg\` — \`clamp(1rem, 26cqi, 28rem)\`
+- \`text-ak-watermark-xl\` — \`clamp(1rem, 28cqi, 30rem)\`
+- \`text-ak-watermark-2xl\` — \`clamp(1rem, 30cqi, 34rem)\`
+- \`text-ak-watermark-3xl\` — \`clamp(1rem, 33cqi, 38rem)\`
+- \`text-ak-watermark-4xl\` — \`clamp(1rem, 36cqi, 42rem)\`
+- \`text-ak-watermark-5xl\` — \`clamp(1rem, 40cqi, 48rem)\`
+- \`text-ak-avatar-xs\` — \`0.625rem\`
+- \`text-ak-avatar-sm\` — \`0.6875rem\`
+- \`text-ak-avatar-md\` — \`0.8125rem\`
+- \`text-ak-avatar-lg\` — \`1rem\`
+- \`text-ak-avatar-xl\` — \`1.25rem\`
+- \`text-ak-avatar-2xl\` — \`1.75rem\`
+- \`text-ak-avatar-3xl\` — \`2.25rem\`
+- \`text-ak-badge-md\` — \`0.625rem\`
+- \`text-ak-badge-lg\` — \`0.6875rem\`
+- \`text-ak-badge-xl\` — \`0.8125rem\`
+- \`text-ak-badge-2xl\` — \`0.9375rem\`
+- \`text-ak-badge-3xl\` — \`1.125rem\`
+
+## Line Height
+\`leading-*\` utilities.
+
+- \`leading-ak-display\` — \`0.85\`
+- \`leading-ak-squeezed\` — \`0.92\`
+- \`leading-ak-condensed\` — \`0.95\`
+- \`leading-ak-none\` — \`1\`
+- \`leading-ak-fitted\` — \`1.02\`
+- \`leading-ak-compact\` — \`1.05\`
+- \`leading-ak-tighter\` — \`1.1\`
+- \`leading-ak-snugger\` — \`1.2\`
+- \`leading-ak-tight\` — \`1.25\`
+- \`leading-ak-snug\` — \`1.375\`
+- \`leading-ak-normal\` — \`1.5\`
+- \`leading-ak-relaxed\` — \`1.625\`
+- \`leading-ak-prose\` — \`1.75\`
+- \`leading-ak-loose\` — \`2\`
+
+## Letter Spacing
+\`tracking-*\` utilities.
+
+- \`tracking-ak-tighter\` — \`-0.05em\`
+- \`tracking-ak-tight\` — \`-0.025em\`
+- \`tracking-ak-subtle\` — \`-0.01em\`
+- \`tracking-ak-normal\` — \`0em\`
+- \`tracking-ak-wide\` — \`0.025em\`
+- \`tracking-ak-section\` — \`0.08em\`
+- \`tracking-ak-wider\` — \`0.05em\`
+- \`tracking-ak-widest\` — \`0.1em\`
+
+## Spacing
+Feeds every spacing utility: \`p-* px-* py-* pt/pr/pb/pl-* m-* mx-* my-* gap-* gap-x/y-* space-x/y-* w-* h-* min-w-* min-h-* max-w-* inset-* top/right/bottom/left-*\`.
+Example: token \`ak-3\` → \`p-ak-3\`, \`gap-ak-3\`, \`mt-ak-3\`.
+
+- \`ak-0\` — \`0rem\`
+- \`ak-px\` — \`0.0625rem\`
+- \`ak-0_5\` — \`0.25rem\`
+- \`ak-0_75\` — \`0.375rem\`
+- \`ak-1\` — \`0.5rem\`
+- \`ak-1_25\` — \`0.625rem\`
+- \`ak-1_5\` — \`0.75rem\`
+- \`ak-2\` — \`1rem\`
+- \`ak-2_5\` — \`1.25rem\`
+- \`ak-3\` — \`1.5rem\`
+- \`ak-3_5\` — \`1.75rem\`
+- \`ak-4\` — \`2rem\`
+- \`ak-4_5\` — \`2.25rem\`
+- \`ak-5\` — \`2.5rem\`
+- \`ak-5_5\` — \`2.75rem\`
+- \`ak-6\` — \`3rem\`
+- \`ak-7\` — \`3.5rem\`
+- \`ak-8\` — \`4rem\`
+- \`ak-9\` — \`4.5rem\`
+- \`ak-10\` — \`5rem\`
+- \`ak-11\` — \`5.5rem\`
+- \`ak-12\` — \`6rem\`
+- \`ak-14\` — \`7rem\`
+- \`ak-16\` — \`8rem\`
+- \`ak-20\` — \`10rem\`
+- \`ak-24\` — \`12rem\`
+- \`ak-mobile-bar\` — \`4.5rem\`
+- \`ak-fl-page-margin\` — \`clamp(1rem, 0.26rem + 3.7vw, 5rem)\`
+- \`ak-fl-3xs\` — \`clamp(0.25rem,  0.21rem + 0.14vw, 0.375rem)\`
+- \`ak-fl-2xs\` — \`clamp(0.5rem,   0.43rem + 0.28vw, 0.75rem)\`
+- \`ak-fl-xs\` — \`clamp(0.75rem,  0.65rem + 0.42vw, 1rem)\`
+- \`ak-fl-sm\` — \`clamp(1rem,     0.86rem + 0.56vw, 1.5rem)\`
+- \`ak-fl-md\` — \`clamp(1.5rem,   1.29rem + 0.83vw, 2rem)\`
+- \`ak-fl-lg\` — \`clamp(2rem,     1.72rem + 1.11vw, 3rem)\`
+- \`ak-fl-xl\` — \`clamp(3rem,     2.5rem  + 1.85vw, 4.5rem)\`
+- \`ak-fl-2xl\` — \`clamp(4rem,     3.22rem + 2.78vw, 6rem)\`
+- \`ak-fl-3xl\` — \`clamp(6rem,     4.86rem + 4.17vw, 9rem)\`
+- \`ak-fl-xs-md\` — \`clamp(0.75rem,  0.43rem + 1.39vw, 2rem)\`
+- \`ak-fl-xs-lg\` — \`clamp(0.75rem,  0.14rem + 2.78vw, 3rem)\`
+- \`ak-fl-sm-lg\` — \`clamp(1rem,     0.43rem + 2.78vw, 3rem)\`
+- \`ak-fl-sm-xl\` — \`clamp(1rem,     0rem    + 4.17vw, 4.5rem)\`
+- \`ak-fl-md-xl\` — \`clamp(1.5rem,   0.57rem + 3.47vw, 4.5rem)\`
+- \`ak-fl-md-2xl\` — \`clamp(1.5rem,   0rem    + 5.56vw, 6rem)\`
+- \`ak-fl-lg-2xl\` — \`clamp(2rem,     0.57rem + 5.56vw, 6rem)\`
+- \`ak-fl-xl-3xl\` — \`clamp(3rem,     0.57rem + 8.33vw, 9rem)\`
+
+## Border Radius
+\`rounded-*\` utilities.
+
+- \`rounded-ak-xs\` — \`0.125rem\`
+- \`rounded-ak-none\` — \`0\`
+- \`rounded-ak-sm\` — \`0.25rem\`
+- \`rounded-ak-md\` — \`0.5rem\`
+- \`rounded-ak-lg\` — \`0.75rem\`
+- \`rounded-ak-xl\` — \`1rem\`
+- \`rounded-ak-2xl\` — \`1.5rem\`
+- \`rounded-ak-3xl\` — \`2rem\`
+- \`rounded-ak-full\` — \`9999px\`
+- \`rounded-ak-brutal\` — \`0.5rem\`
+- \`rounded-ak-brutal-sm\` — \`0.25rem\`
+- \`rounded-ak-input\` — \`0.625rem\`
+
+## Border Width
+\`border-*\` utilities (width).
+
+- \`border-ak-brutal\` — \`2px\`
+- \`border-ak-brutal-lg\` — \`3px\`
+
+## Box Shadow
+\`shadow-*\` utilities (includes focus rings and neobrutalist shadows).
+
+- \`shadow-ak-xs\` — \`0 1px 2px rgba(0,0,0,0.04)\`
+- \`shadow-ak-sm\` — \`0 1px 3px rgba(0,0,0,0.06), 0 1px 2px rgba(0,0,0,0.04)\`
+- \`shadow-ak-md\` — \`0 4px 12px rgba(0,0,0,0.06), 0 2px 4px rgba(0,0,0,0.04)\`
+- \`shadow-ak-lg\` — \`0 8px 30px rgba(0,0,0,0.08), 0 4px 8px rgba(0,0,0,0.04)\`
+- \`shadow-ak-xl\` — \`0 16px 50px rgba(0,0,0,0.1), 0 8px 16px rgba(0,0,0,0.05)\`
+- \`shadow-ak-2xl\` — \`0 24px 60px rgba(0,0,0,0.14)\`
+- \`shadow-ak-brutal-xs\` — \`2px 2px 0 0 var(--color-ak-brutal-ink)\`
+- \`shadow-ak-brutal-sm\` — \`3px 3px 0 0 var(--color-ak-brutal-ink)\`
+- \`shadow-ak-brutal\` — \`4px 4px 0 0 var(--color-ak-brutal-ink)\`
+- \`shadow-ak-brutal-lg\` — \`6px 6px 0 0 var(--color-ak-brutal-ink)\`
+- \`shadow-ak-brutal-xl\` — \`8px 8px 0 0 var(--color-ak-brutal-ink)\`
+- \`shadow-ak-focus\` — \`0 0 0 3px rgba(0, 0, 0, 0.08)\`
+- \`shadow-ak-focus-primary\` — \`0 0 0 3px rgba(0, 0, 0, 0.15)\`
+- \`shadow-ak-focus-danger\` — \`0 0 0 3px rgba(220, 38, 38, 0.08)\`
+- \`shadow-ak-focus-success\` — \`0 0 0 3px rgba(22, 163, 74, 0.08)\`
+
+## Max Width (containers)
+\`max-w-*\` utilities.
+
+- \`max-w-ak-page\` — \`80rem\`
+- \`max-w-ak-xs\` — \`20rem\`
+- \`max-w-ak-sm\` — \`24rem\`
+- \`max-w-ak-md\` — \`28rem\`
+- \`max-w-ak-lg\` — \`32rem\`
+- \`max-w-ak-xl\` — \`36rem\`
+- \`max-w-ak-2xl\` — \`42rem\`
+- \`max-w-ak-3xl\` — \`48rem\`
+- \`max-w-ak-4xl\` — \`56rem\`
+- \`max-w-ak-prose\` — \`65ch\`
+
+## Z-Index
+\`z-*\` utilities.
+
+- \`z-ak-base\` — \`0\`
+- \`z-ak-docked\` — \`10\`
+- \`z-ak-dropdown\` — \`1000\`
+- \`z-ak-sticky\` — \`1100\`
+- \`z-ak-banner\` — \`1200\`
+- \`z-ak-overlay\` — \`1300\`
+- \`z-ak-modal\` — \`1400\`
+- \`z-ak-popover\` — \`1500\`
+- \`z-ak-toast\` — \`1700\`
+- \`z-ak-tooltip\` — \`1800\`
+
+## Transition Duration
+\`duration-*\` utilities.
+
+- \`duration-ak-fast\` — \`110ms\`
+- \`duration-ak-base\` — \`150ms\`
+- \`duration-ak-slow\` — \`240ms\`
+- \`duration-ak-skeleton\` — \`1800ms\`
+
+## Transition Timing (easing)
+\`ease-*\` utilities.
+
+- \`ease-ak-default\` — \`cubic-bezier(0.4, 0, 0.2, 1)\`
+- \`ease-ak-in\` — \`cubic-bezier(0.4, 0, 1, 1)\`
+- \`ease-ak-out\` — \`cubic-bezier(0, 0, 0.2, 1)\`
+- \`ease-ak-spring\` — \`cubic-bezier(0.34, 1.56, 0.64, 1)\`
+- \`ease-ak-bounce\` — \`cubic-bezier(0.25, 1, 0.5, 1)\`
+
+## Heights
+\`h-*\` and \`min-h-*\` utilities (named, beyond the spacing scale).
+
+- \`h-ak-nav\` / \`min-h-ak-nav\` — \`4.5rem\`
+- \`h-ak-touch\` / \`min-h-ak-touch\` — \`2.5rem\`
+- \`h-ak-control-sm\` / \`min-h-ak-control-sm\` — \`2rem\`
+- \`h-ak-control-md\` / \`min-h-ak-control-md\` — \`2.5rem\`
+- \`h-ak-control-lg\` / \`min-h-ak-control-lg\` — \`3rem\`
+- \`h-ak-control-xl\` / \`min-h-ak-control-xl\` — \`3.5rem\`
+- \`h-ak-control-2xl\` / \`min-h-ak-control-2xl\` — \`4rem\`
+- \`h-ak-row-compact\` / \`min-h-ak-row-compact\` — \`2.5rem\`
+- \`h-ak-row-default\` / \`min-h-ak-row-default\` — \`3rem\`
+- \`h-ak-row-comfortable\` / \`min-h-ak-row-comfortable\` — \`3.25rem\`
+
+## Widths
+\`w-*\` and \`min-w-*\` utilities (named, beyond the spacing scale).
+
+- \`w-ak-touch\` — \`2.5rem\`
+- \`w-ak-sidebar-collapsed\` — \`5rem\`
+- \`w-ak-sidebar-expanded\` — \`18rem\`
+
+## Size (width + height shorthand)
+\`size-*\` utilities (sets width AND height — icons, avatars, status dots, badges).
+
+- \`size-ak-sheet-handle-width\` — \`2.25rem\`
+- \`size-ak-sheet-handle-height\` — \`0.25rem\`
+- \`size-ak-icon-xs\` — \`0.75rem\`
+- \`size-ak-icon-sm\` — \`1rem\`
+- \`size-ak-icon-md\` — \`1.25rem\`
+- \`size-ak-icon-lg\` — \`1.5rem\`
+- \`size-ak-icon-xl\` — \`1.75rem\`
+- \`size-ak-icon-2xl\` — \`2rem\`
+- \`size-ak-icon-3xl\` — \`3rem\`
+- \`size-ak-panel-width\` — \`260px\`
+- \`size-ak-avatar-xs\` — \`1.5rem\`
+- \`size-ak-avatar-sm\` — \`2rem\`
+- \`size-ak-avatar-md\` — \`2.5rem\`
+- \`size-ak-avatar-lg\` — \`3rem\`
+- \`size-ak-avatar-xl\` — \`4rem\`
+- \`size-ak-avatar-2xl\` — \`6rem\`
+- \`size-ak-avatar-3xl\` — \`8rem\`
+- \`size-ak-status-md\` — \`12px\`
+- \`size-ak-status-lg\` — \`14px\`
+- \`size-ak-status-xl\` — \`20px\`
+- \`size-ak-status-2xl\` — \`28px\`
+- \`size-ak-status-3xl\` — \`36px\`
+- \`size-ak-badge-md\` — \`18px\`
+- \`size-ak-badge-lg\` — \`20px\`
+- \`size-ak-badge-xl\` — \`24px\`
+- \`size-ak-badge-2xl\` — \`32px\`
+- \`size-ak-badge-3xl\` — \`40px\`
+- \`size-ak-badge-border-md\` — \`2px\`
+- \`size-ak-badge-border-lg\` — \`2px\`
+- \`size-ak-badge-border-xl\` — \`3px\`
+- \`size-ak-badge-border-2xl\` — \`3.5px\`
+- \`size-ak-badge-border-3xl\` — \`4px\`
+- \`size-ak-icon-badge-md\` — \`22px\`
+- \`size-ak-icon-badge-lg\` — \`24px\`
+- \`size-ak-icon-badge-xl\` — \`28px\`
+- \`size-ak-icon-badge-2xl\` — \`34px\`
+- \`size-ak-icon-badge-3xl\` — \`40px\`
+- \`size-ak-control-sm\` — \`2rem\`
+- \`size-ak-control-md\` — \`2.5rem\`
+- \`size-ak-control-lg\` — \`3rem\`
+- \`size-ak-touch-min\` — \`3rem\`
+
+---
 
 ## Common Patterns
 \`\`\`tsx
 // Card
 <div className="border border-ak-border rounded-ak-lg p-ak-3 bg-ak-surface">
 
-// Primary button
-<button className="bg-ak-primary text-ak-on-primary px-ak-2_5 py-ak-1_25 min-h-[3rem] rounded-ak-lg font-semibold cursor-pointer">
+// Primary button (48px min touch target)
+<button className="bg-ak-primary text-ak-on-primary px-ak-2_5 py-ak-1_25 min-h-ak-control-lg rounded-ak-lg font-ak-sans font-semibold cursor-pointer">
 
-// Section
+// Section with fluid vertical rhythm + max page width
 <section className="py-ak-fl-xl-3xl bg-ak-bg">
-  <div className="max-w-ak-page mx-auto px-ak-3">
+  <div className="max-w-ak-page mx-auto px-ak-fl-page-margin">
 
-// Icon
+// Icon (Phosphor only — never inline SVG)
 import { House } from '@phosphor-icons/react'
 <House size={20} aria-hidden="true" />
 \`\`\`

package/dist/data/tokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/data/tokens.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8E5B,CAAC"}
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/data/tokens.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,+DAA+D;AAC/D,mDAAmD;AAEnD,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAib5B,CAAC"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AA2iBA,wBAAsB,WAAW,kBA2BhC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAsxBA,wBAAsB,WAAW,kBA2BhC"}