@nebutra/design-tokens 2.0.0 → 3.0.0

package/tokens/core.json

@@ -104,50 +104,50 @@
     },
     "nebutra-neutral": {
       "50": {
-        "$value": "#f8fafc",
+        "$value": "#f9fafb",
         "$type": "color"
       },
       "100": {
-        "$value": "#f1f5f9",
+        "$value": "#f3f4f6",
         "$type": "color"
       },
       "200": {
-        "$value": "#e2e8f0",
+        "$value": "#e4e5e8",
         "$type": "color"
       },
       "300": {
-        "$value": "#cbd5e1",
+        "$value": "#d2d4d8",
         "$type": "color"
       },
       "400": {
-        "$value": "#94a3b8",
+        "$value": "#9fa1a5",
         "$type": "color"
       },
       "500": {
-        "$value": "#64748b",
+        "$value": "#717377",
         "$type": "color"
       },
       "600": {
-        "$value": "#475569",
+        "$value": "#515357",
         "$type": "color"
       },
       "700": {
-        "$value": "#334155",
+        "$value": "#3f4044",
         "$type": "color"
       },
       "800": {
-        "$value": "#1e293b",
+        "$value": "#26272a",
         "$type": "color"
       },
       "900": {
-        "$value": "#0f172a",
+        "$value": "#18191c",
         "$type": "color"
       },
       "950": {
-        "$value": "#020617",
+        "$value": "#0b0c0d",
         "$type": "color"
       },
-      "$description": "Slate (Tailwind) — cool blue-undertone gray. SSOT decision: Slate over Zinc. See docs/design-system/token-drift-audit.md."
+      "$description": "House gray — OKLCH hue 264 (the VI hue), chroma 0.002–0.007, lightness steps of Tailwind v4 neutral. Near-achromatic on purpose: every measured reference (Linear C 0.003, Vercel C 0, Mistral/Deel C 0.003–0.03) keeps grays almost colourless, and the previous Slate (C up to 0.04, hue 257) read as the stock shadcn template. Replaces Slate 2026-09-24."
     },
     "nebutra-gray": {
       "50": {
@@ -387,6 +387,11 @@
       "$value": "-0.015em",
       "$type": "string",
       "$description": "Body emphasis"
+    },
+    "label": {
+      "$value": "0.07em",
+      "$type": "string",
+      "$description": "Uppercase micro-labels. 0.07em is Vercel's measured eyebrow value (0.071em); open tracking keeps small caps legible."
     }
   },
   "leading": {
@@ -400,6 +405,351 @@
       "$type": "string"
     }
   },
+  "type": {
+    "$description": "Type scale — size, line-height and tracking travel together, so text-2xl alone is a finished heading. Sizes keep Tailwind's names and values (1,900+ call sites keep their size); what changes is that every step now carries its own leading and a tracking curve: slightly open below 14px, neutral at 13–14, tightening to -0.045em at display sizes. Curve measured across Cursor (+0.01em@14 → -0.03em@72), Linear (-0.022em@48–72) and Vercel (-0.06em@64). Emitted as --type-<step>-size|leading|tracking and wired into Tailwind --text-* indirectly, so a Brand Package can retune the scale. Role aliases (display, body, label, meta) name the four sizes a product surface needs and point at steps, so an app caps its ladder by role without declaring a private scale (PARA did, and tailwind-merge dropped its sizes).",
+    "2xs": {
+      "size": {
+        "$value": "0.6875rem",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "1.45",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "0.01em",
+        "$type": "string"
+      },
+      "$description": "New. Micro captions and badges, replacing the 9–11px arbitrary sizes."
+    },
+    "xs": {
+      "size": {
+        "$value": "0.75rem",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "1.4",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "0.005em",
+        "$type": "string"
+      }
+    },
+    "ui": {
+      "size": {
+        "$value": "0.8125rem",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "1.45",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "0em",
+        "$type": "string"
+      },
+      "$description": "New. Dense product UI — table cells, sidebar rows, controls (Linear's caption step)."
+    },
+    "sm": {
+      "size": {
+        "$value": "0.875rem",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "1.5",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "0em",
+        "$type": "string"
+      },
+      "$description": "Product body. 1.5 rather than Tailwind's 1.43 so CJK lines do not crowd."
+    },
+    "base": {
+      "size": {
+        "$value": "1rem",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "1.6",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "-0.005em",
+        "$type": "string"
+      },
+      "$description": "Marketing and reading body."
+    },
+    "lg": {
+      "size": {
+        "$value": "1.125rem",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "1.55",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "-0.01em",
+        "$type": "string"
+      }
+    },
+    "xl": {
+      "size": {
+        "$value": "1.25rem",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "1.45",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "-0.012em",
+        "$type": "string"
+      }
+    },
+    "2xl": {
+      "size": {
+        "$value": "1.5rem",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "1.33",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "-0.015em",
+        "$type": "string"
+      }
+    },
+    "3xl": {
+      "size": {
+        "$value": "1.875rem",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "1.25",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "-0.02em",
+        "$type": "string"
+      }
+    },
+    "4xl": {
+      "size": {
+        "$value": "2.25rem",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "1.15",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "-0.022em",
+        "$type": "string"
+      }
+    },
+    "5xl": {
+      "size": {
+        "$value": "3rem",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "1.08",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "-0.028em",
+        "$type": "string"
+      }
+    },
+    "6xl": {
+      "size": {
+        "$value": "3.75rem",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "1.04",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "-0.032em",
+        "$type": "string"
+      }
+    },
+    "7xl": {
+      "size": {
+        "$value": "4.5rem",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "1",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "-0.035em",
+        "$type": "string"
+      }
+    },
+    "8xl": {
+      "size": {
+        "$value": "6rem",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "1",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "-0.04em",
+        "$type": "string"
+      }
+    },
+    "9xl": {
+      "size": {
+        "$value": "8rem",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "1",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "-0.045em",
+        "$type": "string"
+      }
+    },
+    "display": {
+      "$description": "Role alias for type.xl. Dialog and empty-state headlines — the top of a product surface's ladder, not a hero.",
+      "size": {
+        "$value": "{type.xl.size}",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "{type.xl.leading}",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "{type.xl.tracking}",
+        "$type": "string"
+      }
+    },
+    "body": {
+      "$description": "Role alias for type.sm. Product body copy.",
+      "size": {
+        "$value": "{type.sm.size}",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "{type.sm.leading}",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "{type.sm.tracking}",
+        "$type": "string"
+      }
+    },
+    "label": {
+      "$description": "Role alias for type.xs. Control labels, table headers, secondary UI.",
+      "size": {
+        "$value": "{type.xs.size}",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "{type.xs.leading}",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "{type.xs.tracking}",
+        "$type": "string"
+      }
+    },
+    "meta": {
+      "$description": "Role alias for type.2xs. Machine facts only: dimensions, cost, zoom %, timestamps, key hints.",
+      "size": {
+        "$value": "{type.2xs.size}",
+        "$type": "string"
+      },
+      "leading": {
+        "$value": "{type.2xs.leading}",
+        "$type": "string"
+      },
+      "tracking": {
+        "$value": "{type.2xs.tracking}",
+        "$type": "string"
+      }
+    }
+  },
+  "layer": {
+    "$description": "Stacking roles. One ladder for the whole repo so a layer is chosen by what it is, not by picking a number: before this, apps invented 60 / 90 / 100 / 200 independently and nothing said which sat above which. Page chrome lives below 1000, overlays at 1040–1070 with 100–1039 kept empty. Use as z-[var(--layer-<role>)].",
+    "raised": {
+      "$value": "10",
+      "$type": "string",
+      "$description": "Within a component: an element lifted over its siblings."
+    },
+    "sticky": {
+      "$value": "20",
+      "$type": "string",
+      "$description": "Sticky headers and table heads."
+    },
+    "floating": {
+      "$value": "30",
+      "$type": "string",
+      "$description": "Floating toolbars and canvas chrome anchored to content."
+    },
+    "nav": {
+      "$value": "40",
+      "$type": "string",
+      "$description": "App navigation and the shell's top bar."
+    },
+    "drawer": {
+      "$value": "60",
+      "$type": "string",
+      "$description": "Mobile navigation drawers and their toggles."
+    },
+    "banner": {
+      "$value": "90",
+      "$type": "string",
+      "$description": "Page-level banners: cookie consent, announcements."
+    },
+    "skip-link": {
+      "$value": "100",
+      "$type": "string",
+      "$description": "The skip link — above page chrome whenever it is focused."
+    },
+    "panel": {
+      "$value": "200",
+      "$type": "string",
+      "$description": "App-owned floating panels that are not overlays (locale switcher, search flyouts)."
+    },
+    "backdrop": {
+      "$value": "1040",
+      "$type": "string",
+      "$description": "Overlay tier. Mirrors overlayZIndex in @nebutra/ui; a test keeps them equal."
+    },
+    "modal": {
+      "$value": "1050",
+      "$type": "string",
+      "$description": "Dialogs and sheets."
+    },
+    "popover": {
+      "$value": "1060",
+      "$type": "string",
+      "$description": "Popovers, menus, selects."
+    },
+    "tooltip": {
+      "$value": "1070",
+      "$type": "string",
+      "$description": "Tooltips."
+    },
+    "devtools": {
+      "$value": "9999",
+      "$type": "string",
+      "$description": "Developer and debug surfaces only — never product UI."
+    }
+  },
   "ring": {
     "$description": "Inset ring shorthand recipes — replaces shadow-2xl elevation per 2026 convention.",
     "hairline": {
@@ -417,22 +767,22 @@
     }
   },
   "fontFamily": {
-    "$description": "Geist + Geist Mono for Latin, self-hosted Noto Sans SC (SIL OFL) for CJK, system CJK faces (PingFang SC / Microsoft YaHei) as the fallback behind it. ORDER IS THE DESIGN DECISION: Geist comes first so it keeps Latin and the numerals (tabular figures, tighter x-height — what dense dashboard tables need, and the locked UI face); Noto Sans SC follows so only CJK falls through to it. Reversed, Noto would take the Latin too and its Latin is not as good as Geist's for UI. Each stack prefixes the next/font variable (--font-geist-sans / --font-geist-mono / --font-noto-sans-sc) so the actual loaded face wins over the literal family name, which the browser cannot resolve directly once next/font assigns a generated unique font-family identifier. The Noto entry carries a literal fallback inside var() so a surface that never applies cjkFontClassName degrades to the family name instead of making the whole declaration invalid at computed-value time. `cn` is kept rather than deleted because it still has a job: the `font-cn` utility and the `html:lang(zh|ja|ko) body` auto-activation rule in static/base.css both set font-family to that token ALONE (they exist for the CJK line-height / word-break metrics), so it governs Chinese pages entirely — including their Latin.",
+    "$description": "Geist + Geist Mono for Latin body/UI, DM Sans (self-hosted, SIL OFL) for Latin display and headings, self-hosted MiSans (Xiaomi, free commercial use with attribution) for CJK, system CJK faces as the fallback behind it. Chosen 2026-09-25 by measuring what competitors ship: MiniMax and Moonshot set Chinese in MiSans; DeepSeek and Databricks set Latin in DM Sans. Chinese serifs were tried and rejected. ORDER IS THE DESIGN DECISION: the Latin face comes first so it keeps Latin and the numerals; MiSans follows so only CJK falls through to it (its @font-face unicode-range carries no Latin either). Each stack prefixes the next/font variable so the loaded face wins over the literal family name; the MiSans entry carries a literal fallback inside var() so a surface that never applies cjkFontClassName degrades to the family name instead of voiding the declaration. `cn` is kept because the `font-cn` utility and the `html:lang(zh|ja|ko) body` rule in static/base.css set font-family to it alone (they exist for CJK line-height / word-break metrics).",
     "sans": {
-      "$value": "var(--font-geist-sans), \"Geist\", var(--font-noto-sans-sc, \"Noto Sans SC\"), \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, system-ui, sans-serif",
+      "$value": "var(--font-geist-sans), \"Geist\", var(--font-misans, \"MiSans\"), \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, system-ui, sans-serif",
       "$type": "fontFamily"
     },
     "cn": {
-      "$value": "var(--font-geist-sans), \"Geist\", var(--font-noto-sans-sc, \"Noto Sans SC\"), \"PingFang SC\", \"Microsoft YaHei\", sans-serif",
+      "$value": "var(--font-geist-sans), \"Geist\", var(--font-misans, \"MiSans\"), \"PingFang SC\", \"Microsoft YaHei\", sans-serif",
       "$type": "fontFamily",
       "$description": "CJK-locale stack — same order as sans, minus the Latin-only system faces"
     },
     "display": {
-      "$value": "var(--font-geist-sans), \"Geist\", var(--font-noto-sans-sc, \"Noto Sans SC\"), sans-serif",
+      "$value": "var(--font-dm-sans), \"DM Sans\", var(--font-misans, \"MiSans\"), \"PingFang SC\", sans-serif",
       "$type": "fontFamily"
     },
     "heading": {
-      "$value": "var(--font-geist-sans), \"Geist\", var(--font-noto-sans-sc, \"Noto Sans SC\"), sans-serif",
+      "$value": "var(--font-dm-sans), \"DM Sans\", var(--font-misans, \"MiSans\"), \"PingFang SC\", sans-serif",
       "$type": "fontFamily"
     },
     "mono": {

package/tokens/themes/dark.json

@@ -283,61 +283,62 @@
   },
   "shadcn": {
     "background": {
-      "$value": "222 14% 9%",
-      "$type": "string"
+      "$value": "220 11.1% 5.3%",
+      "$type": "string",
+      "$description": "House canvas. Light is gray-50 under white cards (two-surface layering, as Vercel #fafafa/#fff); dark is OKLCH L 0.16, inside the near-black band every reference measures (Linear L 0.14, Raycast #040506)."
     },
     "foreground": {
-      "$value": "210 18% 96%",
+      "$value": "228 23.8% 95.9%",
       "$type": "string"
     },
     "card": {
-      "$value": "222 12% 13%",
+      "$value": "220 7.3% 8%",
       "$type": "string"
     },
     "card-foreground": {
-      "$value": "210 18% 96%",
+      "$value": "228 23.8% 95.9%",
       "$type": "string"
     },
     "popover": {
-      "$value": "222 12% 13%",
+      "$value": "225 7.7% 10.2%",
       "$type": "string"
     },
     "popover-foreground": {
-      "$value": "210 18% 96%",
+      "$value": "228 23.8% 95.9%",
       "$type": "string"
     },
     "primary": {
-      "$value": "222.6 74.4% 55.5%",
+      "$value": "228 23.8% 95.9%",
       "$type": "string",
-      "$description": "Dark-mode action blue, paired with the near-black --primary-foreground, not white. #396ae2 keeps the VI hue and sits at L*55.9 C0.191."
+      "$description": "House action fill = ink, not blue (owner decision 2026-09-24). Every measured reference ships a solid near-black primary (Vercel #171717, Figma #000) and keeps its one saturated hue for a single signal. Blue now lives on --ring (focus, selection) only."
     },
     "primary-foreground": {
-      "$value": "0 0% 100%",
+      "$value": "220 11.1% 5.3%",
       "$type": "string",
       "$description": "White, matching light mode and matching --blue-contrast. It was near-black (222 14% 9%) when --primary was a LIGHT fill at L* 68.3, where dark ink read 6.20:1. Once --primary became a deep fill at L* 55.9 the pairing inverted and measured 3.74:1, below AA — the fill moved and the ink did not. The deep-fill tier takes white in both modes; --blue-contrast says the same thing, and they must agree because --primary and --blue-9 are now the same value."
     },
     "secondary": {
-      "$value": "222 10% 18%",
+      "$value": "225 6.2% 12.5%",
       "$type": "string"
     },
     "secondary-foreground": {
-      "$value": "210 18% 96%",
+      "$value": "228 23.8% 95.9%",
       "$type": "string"
     },
     "muted": {
-      "$value": "222 10% 17%",
+      "$value": "225 6.2% 12.5%",
       "$type": "string"
     },
     "muted-foreground": {
-      "$value": "220 8% 65%",
+      "$value": "228 2.6% 62.5%",
       "$type": "string"
     },
     "accent": {
-      "$value": "228 38% 22%",
+      "$value": "225 6.2% 12.5%",
       "$type": "string"
     },
     "accent-foreground": {
-      "$value": "228 95% 80%",
+      "$value": "228 23.8% 95.9%",
       "$type": "string"
     },
     "destructive": {
@@ -388,48 +389,49 @@
       "$type": "string"
     },
     "border": {
-      "$value": "220 8% 22%",
+      "$value": "220 3.6% 16.3%",
       "$type": "string"
     },
     "input": {
-      "$value": "220 8% 22%",
+      "$value": "220 3.6% 16.3%",
       "$type": "string"
     },
     "ring": {
-      "$value": "0 0% 88%",
+      "$value": "222.6 87.3% 69%",
       "$type": "string",
-      "$description": "Focus ring (dark mode) — neutral light gray. Mirrors light-mode neutral foreground choice."
+      "$description": "The House blue. Focus rings, selection and links — the one saturated hue on a product screen. #2e65ee light / #6b93f5 dark."
     },
     "sidebar": {
-      "$value": "222 16% 8%",
+      "$value": "220 11.1% 5.3%",
       "$type": "string"
     },
     "sidebar-foreground": {
-      "$value": "210 18% 94%",
+      "$value": "228 23.8% 95.9%",
       "$type": "string"
     },
     "sidebar-primary": {
-      "$value": "228 95% 72%",
-      "$type": "string"
+      "$value": "228 23.8% 95.9%",
+      "$type": "string",
+      "$description": "Current-page accent in the sidebar. = blue-11 (#89aaee, L* 74.0, C 0.106), the ramp's measured secondary-text tier on dark (8.62:1 on step 1). Was 228 95% 72% — 95% chroma sat outside every measured band and matched no ramp step."
     },
     "sidebar-primary-foreground": {
-      "$value": "222 14% 9%",
+      "$value": "220 11.1% 5.3%",
       "$type": "string"
     },
     "sidebar-accent": {
-      "$value": "228 38% 22%",
+      "$value": "225 6.2% 12.5%",
       "$type": "string"
     },
     "sidebar-accent-foreground": {
-      "$value": "228 95% 80%",
+      "$value": "228 23.8% 95.9%",
       "$type": "string"
     },
     "sidebar-border": {
-      "$value": "220 8% 18%",
+      "$value": "225 6.2% 12.5%",
       "$type": "string"
     },
     "sidebar-ring": {
-      "$value": "228 95% 72%",
+      "$value": "222.6 87.3% 69%",
       "$type": "string"
     },
     "chart-1": {