@godxjp/ui 16.4.0 → 16.5.0

package/dist/components/data-display/card.d.ts

@@ -1,5 +1,6 @@
 import * as React from "react";
 import { type VariantProps } from "class-variance-authority";
+import type { LucideIcon } from "lucide-react";
 type CardSize = "md" | "compact";
 /** Semantic leading-edge accent stripe (border-inline-start; width via the
  *  --card-accent-rail-width token, default 6px). */
@@ -86,6 +87,9 @@ export type StatCardProps = React.HTMLAttributes<HTMLDivElement> & VariantProps<
     label: React.ReactNode;
     value: React.ReactNode;
     hint?: React.ReactNode;
+    /** Optional leading icon, rendered as a tinted medallion above the metric. Decorative
+     *  (aria-hidden) — the label carries the meaning. Tint via --stat-card-icon-* tokens. */
+    icon?: LucideIcon;
     /** Optional compact trend text beside the value. Avoid badge-like deltas. */
     delta?: React.ReactNode;
     /** KPI layout: stacked = design default, inline = label left / value right. */
@@ -98,7 +102,7 @@ export type StatCardProps = React.HTMLAttributes<HTMLDivElement> & VariantProps<
     accent?: CardAccent;
 };
 /** KPI / stat tile — token-driven layout aligned to dashboard KPI cards. */
-export declare function StatCard({ label, value, hint, delta, layout, align, inverse, accent, className, size, ...props }: StatCardProps): import("react/jsx-runtime").JSX.Element;
+export declare function StatCard({ label, value, hint, icon: Icon, delta, layout, align, inverse, accent, className, size, ...props }: StatCardProps): import("react/jsx-runtime").JSX.Element;
 /** Header actions slot — pair with `CardHeader className="flex flex-row …"`. */
 export declare const CardAction: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
 export {};

package/dist/components/data-display/card.js

@@ -96,6 +96,7 @@ function StatCard({
   label,
   value,
   hint,
+  icon: Icon,
   delta,
   layout = "stacked",
   align = "start",
@@ -117,6 +118,7 @@ function StatCard({
       "data-stat-align": align,
       ...props,
       children: [
+        Icon ? /* @__PURE__ */ jsx("span", { "data-slot": "stat-card-icon", "aria-hidden": "true", children: /* @__PURE__ */ jsx(Icon, {}) }) : null,
         /* @__PURE__ */ jsxs("div", { "data-slot": "stat-card-body", children: [
           /* @__PURE__ */ jsx("div", { "data-slot": "stat-card-label", children: label }),
           hint && layout === "inline" ? /* @__PURE__ */ jsx("div", { "data-slot": "stat-card-hint", children: hint }) : null
@@ -130,8 +132,8 @@ function StatCard({
                 "data-slot": "stat-card-delta",
                 "data-delta-tone": deltaTone,
                 className: cn(
-                  deltaTone === "positive" && "text-success",
-                  deltaTone === "negative" && "text-destructive"
+                  deltaTone === "positive" && "text-success-strong",
+                  deltaTone === "negative" && "text-error-strong"
                 ),
                 children: delta
               }

package/dist/components/feedback/sheet.js

@@ -24,7 +24,9 @@ const SheetOverlay = React.forwardRef(({ className, ...props }, ref) => /* @__PU
     ref,
     "data-slot": "sheet-overlay",
     className: cn(
-      "data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:animate-in data-[state=open]:fade-in-0 fixed inset-0 z-50 bg-black/50",
+      // Scrim colour comes from the shared --overlay-background token (see dialog-layout.css),
+      // so a service tints every overlay's backdrop from one knob instead of a baked bg-black/50.
+      "data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:animate-in data-[state=open]:fade-in-0 fixed inset-0 z-50",
       className
     ),
     ...props

package/dist/components/navigation/steps.js

@@ -17,7 +17,7 @@ function StepIcon({
   if (icon)
     return /* @__PURE__ */ jsx("span", { className: cn("flex items-center justify-center", controlIconClass), children: icon });
   if (type === "dot") {
-    return /* @__PURE__ */ jsx(
+    return /* @__PURE__ */ jsx("span", { className: cn("flex items-center justify-center", controlIconClass), children: /* @__PURE__ */ jsx(
       "span",
       {
         className: cn(
@@ -28,7 +28,7 @@ function StepIcon({
           status === "wait" && "bg-muted-foreground/30"
         )
       }
-    );
+    ) });
   }
   return /* @__PURE__ */ jsxs(
     "span",

package/dist/lib/control-styles.d.ts

@@ -17,10 +17,12 @@ export declare const controlIconLeadingClass = "size-[length:var(--control-icon-
 export declare const tableRowHeightClass = "h-[length:var(--table-row-height)]";
 export declare const tableHeadHeightClass = "h-[length:var(--table-row-height)]";
 export declare const tableCellPaddingClass = "py-[length:var(--table-cell-padding-y)]";
-/** Semantic status / badge tones — always use tokens, never raw Tailwind palette. */
-export declare const toneSuccessClass = "border-success/30 bg-success/10 text-success";
-export declare const toneWarningClass = "border-warning/30 bg-warning/10 text-warning-foreground";
-export declare const toneInfoClass = "border-info/30 bg-info/10 text-info";
-export declare const toneDestructiveClass = "border-destructive/30 bg-destructive/10 text-destructive";
+/** Semantic status / badge tones — always use tokens, never raw Tailwind palette. The TEXT uses the
+ * AA-strong status colours (text-*-strong, darker than the fill) so a small status label clears
+ * WCAG AA on the soft tint; the border/fill keep the brighter wa-iro role. */
+export declare const toneSuccessClass = "border-success/30 bg-success/10 text-success-strong";
+export declare const toneWarningClass = "border-warning/30 bg-warning/10 text-warning-strong";
+export declare const toneInfoClass = "border-info/30 bg-info/10 text-info-strong";
+export declare const toneDestructiveClass = "border-destructive/30 bg-destructive/10 text-error-strong";
 export declare const toneMutedClass = "border-border bg-muted text-muted-foreground";
 export declare const toneNeutralClass = "border-border bg-muted text-muted-foreground";

package/dist/lib/control-styles.js

@@ -8,10 +8,10 @@ const controlIconLeadingClass = "size-[length:var(--control-icon-size)] shrink-0
 const tableRowHeightClass = "h-[length:var(--table-row-height)]";
 const tableHeadHeightClass = "h-[length:var(--table-row-height)]";
 const tableCellPaddingClass = "py-[length:var(--table-cell-padding-y)]";
-const toneSuccessClass = "border-success/30 bg-success/10 text-success";
-const toneWarningClass = "border-warning/30 bg-warning/10 text-warning-foreground";
-const toneInfoClass = "border-info/30 bg-info/10 text-info";
-const toneDestructiveClass = "border-destructive/30 bg-destructive/10 text-destructive";
+const toneSuccessClass = "border-success/30 bg-success/10 text-success-strong";
+const toneWarningClass = "border-warning/30 bg-warning/10 text-warning-strong";
+const toneInfoClass = "border-info/30 bg-info/10 text-info-strong";
+const toneDestructiveClass = "border-destructive/30 bg-destructive/10 text-error-strong";
 const toneMutedClass = "border-border bg-muted text-muted-foreground";
 const toneNeutralClass = "border-border bg-muted text-muted-foreground";
 export {

package/dist/props/registry.d.ts

@@ -1086,7 +1086,7 @@ export declare const COMPONENT_PROP_REGISTRY: {
     readonly StatCardProp: {
         readonly group: "data-display";
         readonly file: "components/data-display/card.tsx";
-        readonly vocabulary: readonly ["TitleProp", "ToneProp", "ClassNameProp"];
+        readonly vocabulary: readonly ["TitleProp", "ToneProp", "IconProp", "ClassNameProp"];
     };
     readonly ResponsiveGridProp: {
         readonly group: "layout";

package/dist/props/registry.js

@@ -1080,7 +1080,7 @@ const COMPONENT_PROP_REGISTRY = {
   StatCardProp: {
     group: "data-display",
     file: "components/data-display/card.tsx",
-    vocabulary: ["TitleProp", "ToneProp", "ClassNameProp"]
+    vocabulary: ["TitleProp", "ToneProp", "IconProp", "ClassNameProp"]
   },
   ResponsiveGridProp: {
     group: "layout",

package/dist/styles/alert-layout.css

@@ -120,20 +120,22 @@
     line-height: 1;
   }
 
+  /* Title text reads the AA-strong status colour (darker than the fill) so the coloured heading
+   * clears WCAG AA on the soft alert tint; the icon keeps the brighter role colour. */
   [data-slot="alert-title"][data-tone="destructive"] {
-    color: hsl(var(--destructive));
+    color: hsl(var(--text-error));
   }
 
   [data-slot="alert-title"][data-tone="warning"] {
-    color: hsl(var(--warning));
+    color: hsl(var(--text-warning));
   }
 
   [data-slot="alert-title"][data-tone="success"] {
-    color: hsl(var(--success));
+    color: hsl(var(--text-success));
   }
 
   [data-slot="alert-title"][data-tone="info"] {
-    color: hsl(var(--info));
+    color: hsl(var(--text-info));
   }
 
   [data-slot="alert-description"] {
@@ -168,7 +170,7 @@
 
   .ui-skeleton-block {
     border-radius: var(--skeleton-radius);
-    background: hsl(var(--muted));
+    background: var(--skeleton-background);
     animation: pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
   }
 

package/dist/styles/card-layout.css

@@ -29,8 +29,15 @@
     border-style: solid;
     border-color: hsl(var(--card-border));
     border-radius: var(--card-radius);
-    background: hsl(var(--card-background));
+    /* Fill = base card colour with an opt-in role tint washed over it (--card-tint default
+     * transparent → byte-identical at rest). Tint layer sits ABOVE the base colour. */
+    background:
+      linear-gradient(var(--card-tint), var(--card-tint)),
+      hsl(var(--card-background));
     color: hsl(var(--card-foreground));
+    /* Resting elevation + opt-in brand glow — both quiet no-ops by default so a service theme can
+     * lift (--card-shadow) and/or glow (--card-glow) every card with no markup change. */
+    box-shadow: var(--card-shadow), var(--card-glow);
     overflow: hidden;
   }
 
@@ -384,6 +391,31 @@
     min-width: 0;
   }
 
+  /* Optional leading icon medallion — tinted box above the metric. Tone via tokens (default a
+   * soft brand-primary tint), so a service rethemes it with --primary or the icon tokens. */
+  [data-slot="stat-card-icon"] {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: var(--stat-card-icon-size);
+    height: var(--stat-card-icon-size);
+    margin-bottom: var(--stat-card-gap);
+    border-radius: var(--stat-card-icon-radius);
+    background: var(--stat-card-icon-background);
+    color: var(--stat-card-icon-foreground);
+  }
+
+  [data-slot="stat-card-icon"] svg {
+    width: var(--stat-card-icon-glyph-size);
+    height: var(--stat-card-icon-glyph-size);
+  }
+
+  /* Inline layout: medallion floats to the trailing edge so label/value keep the start column. */
+  [data-slot="card"][data-stat-layout="inline"] [data-slot="stat-card-icon"] {
+    margin-bottom: 0;
+    order: 1;
+  }
+
   [data-slot="stat-card-label"] {
     display: flex;
     align-items: center;

package/dist/styles/control.css

@@ -50,13 +50,13 @@
   }
 
   .ui-toggle[data-state="on"] {
-    background: hsl(var(--primary));
+    background: var(--toggle-on-background);
     color: hsl(var(--primary-foreground));
   }
 
   .ui-toggle:focus-visible {
     outline: none;
-    box-shadow: 0 0 0 3px hsl(var(--ring) / 0.35);
+    box-shadow: 0 0 0 3px hsl(var(--focus-ring-color) / 0.35);
   }
 
   .ui-toggle:disabled,
@@ -85,7 +85,7 @@
 
   .ui-button:focus-visible {
     outline: none;
-    box-shadow: 0 0 0 var(--control-focus-ring-width) hsl(var(--ring));
+    box-shadow: 0 0 0 var(--focus-ring-width) hsl(var(--focus-ring-color));
   }
 
   .ui-button:disabled {
@@ -102,7 +102,9 @@
   .ui-button--default {
     background: hsl(var(--primary));
     color: hsl(var(--primary-foreground));
-    box-shadow: var(--shadow-sm);
+    /* Brand glow layers on top of the resting shadow; --shadow-glow is invisible by default
+     * (quiet) so a service opts the CTA halo in by setting the token alone. */
+    box-shadow: var(--shadow-sm), var(--shadow-glow);
   }
 
   .ui-button--default:hover {
@@ -119,9 +121,17 @@
     background: hsl(var(--destructive) / 0.9);
   }
 
+  /* Outline + ghost set their text colour EXPLICITLY (read --foreground) — never rely on inherited
+   * body colour. Inheriting breaks in a scoped dark region (e.g. an on-navy hero): the body's
+   * computed dark colour would carry in and the label goes near-invisible on the dark fill. */
   .ui-button--outline {
     border: 1px solid hsl(var(--input));
     background: hsl(var(--background));
+    color: hsl(var(--foreground));
+  }
+
+  .ui-button--ghost {
+    color: hsl(var(--foreground));
   }
 
   .ui-button--outline:hover,
@@ -277,7 +287,7 @@
   .ui-slider-thumb:focus-visible,
   .ui-switch:focus-visible {
     outline: none;
-    box-shadow: 0 0 0 var(--control-focus-ring-width) hsl(var(--ring));
+    box-shadow: 0 0 0 var(--focus-ring-width) hsl(var(--focus-ring-color));
   }
 
   .ui-checkbox:disabled,
@@ -289,7 +299,7 @@
   }
 
   .ui-checkbox[data-state="checked"] {
-    background: hsl(var(--primary));
+    background: var(--checkbox-checked-background);
     color: hsl(var(--primary-foreground));
   }
 
@@ -326,7 +336,7 @@
   }
 
   .ui-switch[data-state="checked"] {
-    background: hsl(var(--primary));
+    background: var(--switch-checked-background);
   }
 
   .ui-switch[data-state="unchecked"] {
@@ -364,13 +374,13 @@
     flex-grow: 1;
     overflow: hidden;
     border-radius: var(--radius-pill);
-    background: hsl(var(--primary) / 0.2);
+    background: var(--slider-track-background);
   }
 
   .ui-slider-range {
     position: absolute;
     height: 100%;
-    background: hsl(var(--primary));
+    background: var(--slider-range-background);
   }
 
   .ui-slider-thumb {
@@ -646,13 +656,13 @@
 }
 .ui-otp-slot[data-active="true"] {
   z-index: 1;
-  box-shadow: 0 0 0 2px hsl(var(--ring));
+  box-shadow: 0 0 0 var(--focus-ring-width) hsl(var(--focus-ring-color));
 }
 .ui-otp-container:has(.ui-otp-input[aria-invalid="true"]) .ui-otp-slot {
   border-color: hsl(var(--destructive));
 }
 .ui-otp-container:has(.ui-otp-input[aria-invalid="true"]) .ui-otp-slot[data-active="true"] {
-  box-shadow: 0 0 0 2px hsl(var(--destructive));
+  box-shadow: 0 0 0 var(--focus-ring-width) hsl(var(--destructive));
 }
 .ui-otp-container:has(.ui-otp-input:disabled) .ui-otp-slot {
   cursor: not-allowed;
@@ -717,7 +727,7 @@
   fill: currentColor;
 }
 .ui-rating-star:focus-visible {
-  outline: 2px solid hsl(var(--ring));
+  outline: var(--focus-ring-width) solid hsl(var(--focus-ring-color));
   outline-offset: 2px;
   border-radius: var(--radius-sm);
 }
@@ -735,8 +745,8 @@
   background: hsl(var(--background));
 }
 .ui-tag-input:focus-within {
-  box-shadow: 0 0 0 2px hsl(var(--ring));
-  border-color: hsl(var(--ring));
+  box-shadow: 0 0 0 var(--focus-ring-width) hsl(var(--focus-ring-color));
+  border-color: hsl(var(--focus-ring-color));
 }
 .ui-tag-input-disabled {
   opacity: 0.6;

package/dist/styles/data-display-layout.css

@@ -9,7 +9,10 @@
     justify-content: center;
     overflow: hidden;
     border-radius: var(--radius-pill);
-    background: hsl(var(--muted));
+    /* Tint washes over the role background (default transparent = no-op, rule #44). */
+    background:
+      linear-gradient(var(--avatar-tint), var(--avatar-tint)),
+      var(--avatar-background);
     color: hsl(var(--muted-foreground));
     font-size: var(--font-size-base);
     font-weight: var(--font-weight-medium);
@@ -27,7 +30,7 @@
     height: 100%;
     align-items: center;
     justify-content: center;
-    background: hsl(var(--muted));
+    background: var(--avatar-background);
   }
 
   .ui-progress {
@@ -40,13 +43,13 @@
     height: 0.5rem;
     overflow: hidden;
     border-radius: var(--radius-pill);
-    background: hsl(var(--secondary));
+    background: var(--progress-track-background);
   }
 
   .ui-progress-bar {
     height: 100%;
     border-radius: inherit;
-    background: hsl(var(--success));
+    background: var(--progress-fill-background);
   }
 
   .ui-progress[data-tone="warning"] .ui-progress-bar {
@@ -75,8 +78,8 @@
   }
 
   .ui-tree-item[data-active="true"] {
-    border-color: hsl(var(--primary) / 0.3);
-    background: hsl(var(--primary) / 0.05);
+    border-color: var(--tree-item-active-border);
+    background: var(--tree-item-active-background);
   }
 
   .ui-tree-item[data-depth="1"] {
@@ -151,7 +154,7 @@
     place-items: center;
     border: 1px solid transparent;
     border-radius: var(--radius-pill);
-    background: hsl(var(--success));
+    background: var(--timeline-dot-done-background);
     color: hsl(var(--success-foreground));
     font-size: var(--timeline-note-font-size);
     font-weight: var(--font-weight-medium);
@@ -160,14 +163,14 @@
 
   /* done → success fill. */
   .ui-timeline-dot[data-status="done"] {
-    background: hsl(var(--success));
+    background: var(--timeline-dot-done-background);
     color: hsl(var(--success-foreground));
   }
 
   /* current → primary fill + ring (also the legacy data-current shorthand). */
   .ui-timeline-dot[data-status="current"],
   .ui-timeline-dot[data-current="true"] {
-    background: hsl(var(--primary));
+    background: var(--timeline-dot-current-background);
     color: hsl(var(--primary-foreground));
     box-shadow: 0 0 0 3px hsl(var(--primary) / 0.18);
   }
@@ -202,7 +205,7 @@
 
   /* The segment below a done/current step reads as travelled (completed). */
   .ui-timeline-line[data-completed="true"] {
-    background: hsl(var(--primary));
+    background: var(--timeline-line-completed-background);
   }
 
   .ui-timeline-head {
@@ -256,7 +259,7 @@
   text-decoration: underline;
 }
 .ui-accordion-trigger:focus-visible {
-  outline: 2px solid hsl(var(--ring));
+  outline: var(--focus-ring-width) solid hsl(var(--focus-ring-color));
   outline-offset: 2px;
   border-radius: var(--radius-sm);
 }
@@ -383,7 +386,7 @@
 }
 
 .ui-carousel-dot:focus-visible {
-  outline: 2px solid hsl(var(--ring));
+  outline: var(--focus-ring-width) solid hsl(var(--focus-ring-color));
   outline-offset: 2px;
 }
 

package/dist/styles/data-entry-layout.css

@@ -83,8 +83,8 @@
   }
 
   .ui-time-input:focus-visible {
-    border-color: hsl(var(--ring));
-    box-shadow: 0 0 0 3px hsl(var(--ring) / 0.3);
+    border-color: hsl(var(--focus-ring-color));
+    box-shadow: 0 0 0 3px hsl(var(--focus-ring-color) / 0.3);
   }
 
   .ui-time-input[aria-invalid="true"] {

package/dist/styles/dialog-layout.css

@@ -21,11 +21,15 @@
     border-top: 1px solid hsl(var(--border));
   }
 
+  .ui-dialog-overlay,
+  [data-slot="sheet-overlay"] {
+    background-color: var(--overlay-background);
+  }
+
   .ui-dialog-overlay {
     position: fixed;
     inset: 0;
     z-index: 50;
-    background-color: rgb(0 0 0 / 0.5);
   }
 
   [data-slot="dialog-content"] {
@@ -43,7 +47,7 @@
     padding: var(--dialog-space-inset);
     /* clip so the full-bleed header/footer bands round with the dialog corners (Ant Modal). */
     overflow: hidden;
-    box-shadow: var(--shadow-lg, 0 10px 15px -3px rgb(0 0 0 / 0.1));
+    box-shadow: var(--shadow-lg, 0 10px 15px -3px rgb(0 0 0 / 0.1)), var(--dialog-content-glow);
   }
 
   @media (min-width: 640px) {

package/dist/styles/index.css

@@ -41,6 +41,8 @@
  * `var(--radius-2xl)` directly; without a generated utility Tailwind drops the unused var). */
 @source inline("rounded-{xs,xl,2xl}");
 @source inline("text-2xs");
+@source inline("text-{3xl,4xl,5xl}");
+@source inline("text-{success,warning,info,error}-strong");
 /* `.js` matters: the published package ships only compiled JS under dist (no
  * .tsx sources), and this file is copied verbatim into dist/styles — without
  * it Tailwind finds no component classes in consumers (unstyled popovers and
@@ -64,7 +66,14 @@
 @import "./navigation-layout.css";
 @import "./chart-layout.css";
 
-@theme {
+/* `inline` (NOT a bare @theme): Tailwind inlines each expression — e.g. `hsl(var(--primary))` —
+ * directly into every utility (`bg-primary` becomes `background-color: hsl(var(--primary))`) instead
+ * of emitting `var(--color-primary)` computed once at :root. This is THE enabler for scoped /
+ * multi-tenant theming: a `[data-tenant]{ --primary: … }` override now re-resolves at the element,
+ * so colors and radius propagate into a subtree (a plain @theme froze them at :root, so scoped
+ * overrides never reached the color utilities). Components read raw tokens like `hsl(var(--primary))`
+ * directly in their own CSS, so they re-theme the same way. */
+@theme inline {
   --color-background: hsl(var(--background));
   --color-foreground: hsl(var(--foreground));
   --color-card: hsl(var(--card));
@@ -92,6 +101,12 @@
   --color-info-foreground: hsl(var(--info-foreground));
   --color-attention: hsl(var(--attention));
   --color-attention-foreground: hsl(var(--attention-foreground));
+  /* AA-strong status TEXT colours (text-{success,warning,info,error}-strong) — darker than the
+   * fills so small coloured labels clear WCAG AA on white; flip light on the dark theme. */
+  --color-success-strong: hsl(var(--text-success));
+  --color-warning-strong: hsl(var(--text-warning));
+  --color-info-strong: hsl(var(--text-info));
+  --color-error-strong: hsl(var(--text-error));
   --color-chart-1: var(--chart-1);
   --color-chart-2: var(--chart-2);
   --color-chart-3: var(--chart-3);
@@ -145,6 +160,10 @@
   --text-lg: var(--font-size-lg);
   --text-xl: var(--font-size-xl);
   --text-2xl: var(--font-size-2xl);
+  /* Opt-in DISPLAY ramp (marketing/hero) — wired to the display tokens, unused by the admin scale. */
+  --text-3xl: var(--font-size-3xl);
+  --text-4xl: var(--font-size-4xl);
+  --text-5xl: var(--font-size-5xl);
 }
 
 @layer base {
@@ -172,7 +191,9 @@
   body {
     background-color: hsl(var(--background));
     color: hsl(var(--foreground));
-    font-family: var(--font-family-sans);
+    /* Body reads --font-family-body (defaults to --font-family-sans → unchanged); a service that
+     * wants a dual-font brand (display + body face) overrides --font-family-body alone. */
+    font-family: var(--font-family-body);
     font-size: var(--font-size-base);
     line-height: var(--line-height-body);
     font-feature-settings:
@@ -186,7 +207,13 @@
 
   /* Semantic heading scale — SEO + accessibility: real <h1>–<h6> elements carry
    * the document outline (one <h1> per page, levels never skipped). Visual size
-   * follows the dxs-kintai scale; component titles override via their own class. */
+   * follows the dxs-kintai scale; component titles override via their own class.
+   * Headings read --font-family-display (defaults to --font-family-sans → unchanged) for dual-font
+   * brands (display face on headings, body face on prose). */
+  :where(h1, h2, h3, h4, h5, h6) {
+    font-family: var(--font-family-display);
+  }
+
   h1 {
     font-size: var(--heading-h1);
     font-weight: var(--font-weight-medium);

package/dist/styles/layout.css

@@ -345,6 +345,9 @@
     gap: var(--space-stack-sm);
     padding-bottom: var(--page-header-pad-bottom);
     border-bottom: var(--page-header-divider);
+    /* Hero banner hook — invisible by default (--gradient-hero: none); a service paints a hero
+     * gradient across the page header (full-bleed) by configuring the token alone. */
+    background-image: var(--gradient-hero);
   }
 
   .ui-page-header-row {

package/dist/styles/navigation-layout.css

@@ -8,7 +8,7 @@
     background: hsl(var(--popover));
     color: hsl(var(--popover-foreground));
     padding: var(--space-1);
-    box-shadow: var(--shadow-md);
+    box-shadow: var(--shadow-md), var(--shadow-glow);
   }
 
   .ui-context-menu-item,
@@ -55,8 +55,8 @@
   .ui-menubar-sub-trigger:hover,
   .ui-navigation-menu-link:hover,
   .ui-navigation-menu-item:hover {
-    background: hsl(var(--accent));
-    color: hsl(var(--accent-foreground));
+    background: var(--menubar-item-hover-background);
+    color: var(--menubar-item-hover-foreground);
   }
 
   .ui-context-menu-item[data-state="open"],
@@ -68,8 +68,8 @@
   .ui-menubar-sub-trigger[data-state="open"],
   .ui-navigation-menu-link[data-highlighted],
   .ui-navigation-menu-item[data-focus-visible] {
-    background: hsl(var(--accent));
-    color: hsl(var(--accent-foreground));
+    background: var(--menubar-item-hover-background);
+    color: var(--menubar-item-hover-foreground);
   }
 
   .ui-context-menu-item[data-variant="destructive"],
@@ -146,7 +146,7 @@
     background: hsl(var(--popover));
     color: hsl(var(--popover-foreground));
     padding: var(--space-1);
-    box-shadow: var(--shadow-md);
+    box-shadow: var(--shadow-md), var(--shadow-glow);
   }
 
   .ui-context-menu-sub-trigger-icon,
@@ -179,13 +179,13 @@
     background: hsl(var(--popover));
     color: hsl(var(--popover-foreground));
     padding: var(--space-1);
-    box-shadow: var(--shadow-md);
+    box-shadow: var(--shadow-md), var(--shadow-glow);
   }
 
   .ui-menubar-trigger[data-state="open"],
   .ui-menubar-sub-trigger[data-state="open"] {
-    background: hsl(var(--accent));
-    color: hsl(var(--accent-foreground));
+    background: var(--menubar-item-hover-background);
+    color: var(--menubar-item-hover-foreground);
   }
 
   .ui-navigation-menu {
@@ -233,7 +233,7 @@
     background: hsl(var(--popover));
     color: hsl(var(--popover-foreground));
     padding: var(--space-1);
-    box-shadow: var(--shadow-md);
+    box-shadow: var(--shadow-md), var(--shadow-glow);
   }
 
   .ui-navigation-menu-link {

package/dist/styles/shell-layout.css

@@ -30,6 +30,8 @@
     overflow: hidden;
     border-inline-end: 1px solid hsl(var(--border));
     background: hsl(var(--card));
+    /* Opt-in brand-chrome wash — invisible by default (--sidebar-gradient: none). */
+    background-image: var(--sidebar-gradient);
     color: hsl(var(--foreground));
   }
 
@@ -45,6 +47,8 @@
     padding-inline: var(--space-4);
     border-bottom: 1px solid hsl(var(--border));
     background: hsl(var(--background) / 0.92);
+    /* Opt-in brand-chrome wash — invisible by default (--topbar-gradient: none). */
+    background-image: var(--topbar-gradient);
     backdrop-filter: blur(12px);
   }
 
@@ -52,6 +56,9 @@
     grid-area: main;
     min-width: 0;
     overflow: auto;
+    /* Ambient brand glow hook — invisible by default (--gradient-glow: none); a service paints a
+     * radial/linear brand wash behind the whole content area by configuring the token alone. */
+    background-image: var(--gradient-glow);
     /* Sole scroll/clip boundary for the page area. `overflow:auto` alone does NOT reliably
      * establish a paint-containment boundary in Chrome: tall nested scrollers (a two-pane
      * `grid` of long lists, a nested `overflow-y:auto` region) — or any absolutely-positioned
@@ -254,13 +261,17 @@
     text-align: start;
   }
 
-  .sb-nav-item:hover,
-  .sb-nav-item[data-active="true"] {
+  .sb-nav-item:hover {
     background: hsl(var(--accent));
     color: hsl(var(--foreground));
   }
 
+  /* Active item reads its own bg/fg tokens (defaults = the hover look) so a service can give the
+   * selected nav row a brand treatment — e.g. a gold tint + gold text on a navy sidebar — without
+   * forking CSS. Defaults are byte-identical to the hover state. */
   .sb-nav-item[data-active="true"] {
+    background: var(--sidebar-item-active-background);
+    color: var(--sidebar-item-active-foreground);
     font-weight: var(--font-weight-medium);
   }
 
@@ -351,12 +362,12 @@
 
   .sb-nav-item--sub[data-active="true"] {
     background: transparent;
-    color: hsl(var(--primary));
+    color: var(--sidebar-item-active-color);
     font-weight: 500;
   }
 
   .sb-nav-item--sub[data-active="true"]::before {
-    background: hsl(var(--primary));
+    background: var(--sidebar-item-active-tint);
     opacity: 1;
   }
 
@@ -406,7 +417,7 @@
   }
 
   .sb-user:focus-visible {
-    box-shadow: 0 0 0 var(--control-focus-ring-width) hsl(var(--ring) / 0.45);
+    box-shadow: 0 0 0 var(--focus-ring-width) hsl(var(--focus-ring-color) / 0.45);
   }
 
   .sb-user-avatar {
@@ -649,7 +660,7 @@
   }
 
   .tb-icon-btn:focus-visible {
-    box-shadow: 0 0 0 var(--control-focus-ring-width) hsl(var(--ring) / 0.45);
+    box-shadow: 0 0 0 var(--focus-ring-width) hsl(var(--focus-ring-color) / 0.45);
   }
 
   .tb-bell {

package/dist/styles/table-layout.css

@@ -8,10 +8,10 @@
     padding: var(--table-cell-padding-y) var(--table-cell-space-x);
     text-align: start;
     vertical-align: middle;
-    background: hsl(var(--secondary));
+    background: var(--table-header-background);
     font-size: var(--table-head-font-size);
     font-weight: var(--font-weight-medium);
-    color: hsl(var(--muted-foreground));
+    color: var(--table-header-foreground);
     white-space: nowrap;
   }
 
@@ -97,7 +97,7 @@
   /* Zebra striping (opt-in via the `striped` prop). Selected rows keep their
    * own emphasis, so they are excluded from the stripe. */
   .ui-data-table-surface[data-striped] tbody tr:nth-child(even):not([data-state="selected"]) {
-    background-color: hsl(var(--muted) / 0.4);
+    background-color: var(--table-row-striped-background);
   }
 
   /* Empty-state cell hosts the built-in EmptyState (which brings its own padding). */
@@ -195,10 +195,10 @@
   /* Mirror the row's hover / selected tint — a translucent muted wash layered
    * over the opaque base, so the pinned cell matches the rest of its row. */
   .ui-data-table-surface tbody tr:hover > .ui-data-table-pin-end {
-    background-image: linear-gradient(hsl(var(--muted) / 0.5), hsl(var(--muted) / 0.5));
+    background-image: linear-gradient(var(--table-row-hover-background), var(--table-row-hover-background));
   }
 
   .ui-data-table-surface tbody tr[data-state="selected"] > .ui-data-table-pin-end {
-    background-image: linear-gradient(hsl(var(--muted) / 0.3), hsl(var(--muted) / 0.3));
+    background-image: linear-gradient(var(--table-row-selected-background), var(--table-row-selected-background));
   }
 }

package/dist/tokens/foundation.css

@@ -37,6 +37,13 @@
   --text-disabled: 40 6% 68%; /* disabled control text */
   --text-link: 204 100% 39%; /* inline link — defaults to brand blue */
   --text-brand: 204 100% 39%; /* brand-colored text / numerals */
+  /* Status TEXT colours — darker than the fill roles so small coloured text (a StatCard delta, an
+   * outline status badge label) clears WCAG AA 4.5:1 on white. The fill roles (--success/--warning/
+   * --info) stay the brighter wa-iro for badges/bars; only TEXT reads these via text-*-strong. */
+  --text-success: 152 84% 22%; /* deep 若竹 — AA green text on white */
+  --text-warning: 36 100% 28%; /* dark 山吹 amber — yellow can never pass as text */
+  --text-info: 221 70% 38%; /* deep 群青 — AA blue text on white */
+  --text-error: 357 75% 38%; /* deep 茜 — AA red text on white */
 
   /* Interaction ramp — hover / active steps (services override to their own brand ramp). */
   --primary-hover: 204 100% 33%;
@@ -93,6 +100,35 @@
     0 20px 25px -5px rgb(var(--shadow-color) / 0.1), 0 8px 10px -6px rgb(var(--shadow-color) / 0.1);
   --shadow-2xl: 0 25px 50px -12px rgb(var(--shadow-color) / 0.25);
 
+  /* Brand GLOW — an opt-in coloured halo for the primary CTA (and any surface that opts in).
+   * Quiet by default (cardinal rule #44): a zero-size transparent shadow, which is invalid as a
+   * bare `none` inside a comma shadow list but valid as `0 0 0 0 transparent`. A service turns it
+   * on by overriding the whole value once, e.g. `--shadow-glow: 0 8px 20px hsl(var(--primary) / .32)`
+   * — the CTA then carries a brand glow with no component change. */
+  --shadow-glow: 0 0 0 0 transparent;
+
+  /* FOCUS RING — the two global knobs for the keyboard-focus affordance (WCAG 2.4.7 / 2.4.11).
+   * `--focus-ring-color` is the themeable hue (HSL components, defaults to --ring) and
+   * `--focus-ring-width` the standard thickness; override either ONCE — even scoped under a
+   * `[data-tenant]` — to retint or resize EVERY focus ring. Both are leaf tokens (a colour and a
+   * length, no nested var) so they re-resolve at the element that paints the ring; every
+   * :focus-visible rule reads them DIRECTLY as `0 0 0 var(--focus-ring-width)
+   * hsl(var(--focus-ring-color))`, never via an intermediate composite (a `:root`-declared
+   * composite that wraps these would freeze at :root and ignore a scoped override). */
+  --focus-ring-color: var(--ring);
+  --focus-ring-width: 2px;
+
+  /* GRADIENTS — opt-in decorative fills exposed at the token layer so a service can paint a hero
+   * banner, a brand wash, or a radial brand glow purely by configuring tokens (cardinal rule #45).
+   * All default to a transparent no-op so nothing renders until a theme opts in; a surface that
+   * supports a gradient reads one of these as its background-image. Examples a service might set:
+   *   --gradient-brand: linear-gradient(135deg, hsl(var(--primary)), hsl(var(--accent)));
+   *   --gradient-hero:  linear-gradient(180deg, hsl(var(--secondary)), hsl(var(--background)));
+   *   --gradient-glow:  radial-gradient(60% 80% at 50% 0%, hsl(var(--primary) / .25), transparent); */
+  --gradient-brand: none;
+  --gradient-hero: none;
+  --gradient-glow: none;
+
   /* Sans stack — script-aware per the international convention for mixed
    * Latin/CJK UI: native Latin system fonts FIRST (clean, familiar English &
    * DEFAULT face is the bundled "Noto Sans JP" (Japanese + clean Latin), with system sans as
@@ -103,6 +139,12 @@
     "Noto Sans JP", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial,
     system-ui, "Hiragino Sans", sans-serif;
   --font-family-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  /* Dual-font split (opt-in) — many brand designs pair a DISPLAY face for headings with a separate
+   * BODY face (e.g. Source Sans 3 display + Inter body). Both default to --font-family-sans, so a
+   * single-font system is unchanged; a service overrides one or both. Headings read
+   * --font-family-display, body reads --font-family-body (wired in styles/index.css @layer base). */
+  --font-family-display: var(--font-family-sans);
+  --font-family-body: var(--font-family-sans);
   /* ── Type scale — GOLDEN-RATIO modular scale (Ant/Tailwind model). ONE base + ONE ratio; every
    * step is base × ratioⁿ, so the whole scale stays in golden proportion. `--font-size-ratio` is
    * φ^¼ (the golden ratio's quarter-step ≈ 1.1227) — a TRUE golden ratio yet dense enough that
@@ -122,6 +164,19 @@
   --font-size-xl: calc(var(--font-size-lg) * var(--font-size-ratio)); /* ratio³ ≈ 19.8px */
   --font-size-2xl: calc(var(--font-size-xl) * var(--font-size-ratio)); /* ratio⁴ ≈ 22.3px */
 
+  /* DISPLAY type — OPT-IN large sizes for MARKETING / hero surfaces (landing pages, CTA banners).
+   * The enterprise heading scale stays small by design (h1 = 20px, 渋み restraint); these are a
+   * SEPARATE bolder ramp a marketing surface opts into via the text-3xl/-4xl/-5xl utilities (wired
+   * in styles/index.css @theme). A service rescales the whole display ramp from --font-size-display
+   * (its own base). Nothing in the admin system uses them, so defaults are unchanged. */
+  --font-size-display: 3.375rem; /* 54px — hero display (the single display knob) */
+  --font-size-display-ratio: 1.28; /* bolder step than the body φ^¼ — marketing wants more contrast */
+  --font-size-3xl: calc(
+    var(--font-size-display) / var(--font-size-display-ratio) / var(--font-size-display-ratio)
+  ); /* ≈ 33 → 28px feature heading */
+  --font-size-4xl: calc(var(--font-size-display) / var(--font-size-display-ratio)); /* ≈ 36px section */
+  --font-size-5xl: var(--font-size-display); /* 54px hero */
+
   /* Headings — also golden-derived. h1=ratio³, h2=ratio²; h3/h4 reuse body sizes (single source). */
   --heading-h1: calc(
     var(--font-size-base) * var(--font-size-ratio) * var(--font-size-ratio) * var(--font-size-ratio)
@@ -139,6 +194,10 @@
    * so any remaining reference renders at 500. `bold` is the 700 emphasis weight. */
   --font-weight-semibold: 500;
   --font-weight-bold: 700;
+  /* Display/black weight — OPT-IN for marketing display type (hero/CTA). The enterprise system caps
+   * at 700 (簡素 restraint); this is only reached via the .font-display-weight utility / a service
+   * setting it on a display surface, so admin text is unchanged. */
+  --font-weight-black: 800;
   --line-height-tight: 1.25;
   --line-height-normal: 1.5;
   --line-height-body: 1.7;
@@ -285,6 +344,11 @@
   --text-disabled: 45 6% 40%;
   --text-link: 204 90% 66%;
   --text-brand: 204 90% 66%;
+  /* Status text on the dark spine reads LIGHT (AA on dark surfaces). */
+  --text-success: 146 55% 64%;
+  --text-warning: 44 95% 62%;
+  --text-info: 221 70% 72%;
+  --text-error: 357 75% 68%;
   --primary-hover: 204 90% 66%;
   --primary-active: 204 90% 72%;
   --secondary-hover: 45 6% 22%;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@godxjp/ui",
-  "version": "16.4.0",
+  "version": "16.5.0",
   "type": "module",
   "packageManager": "pnpm@10.29.1",
   "sideEffects": false,
@@ -275,7 +275,7 @@
     "test:coverage": "vitest run --coverage",
     "check:example-imports": "node scripts/check-example-imports.mjs",
     "verify": "pnpm typecheck && pnpm lint && pnpm format && pnpm build && pnpm preview:build && pnpm check:example-imports && pnpm check:core-isolation && pnpm check:prop-vocabulary && pnpm check:token-tiers && pnpm check:control-sizing && pnpm check:rtl && pnpm check:typography && pnpm check:mcp-token-sync && pnpm check:mcp-sync && pnpm check:mcp-orphans && pnpm check:audit-sync && pnpm test",
-    "verify:release": "pnpm typecheck && pnpm typecheck:docs && pnpm lint && pnpm build && pnpm preview:build && pnpm check:example-imports && pnpm check:core-isolation && pnpm check:prop-vocabulary && pnpm check:token-tiers && pnpm check:control-sizing && pnpm check:rtl && pnpm check:typography && pnpm check:mcp-token-sync && pnpm check:mcp-sync && pnpm check:mcp-orphans && pnpm check:audit-sync && pnpm check:mcp-prop-sync && pnpm test",
+    "verify:release": "pnpm typecheck && pnpm typecheck:docs && pnpm lint && pnpm build && pnpm preview:build && pnpm check:example-imports && pnpm check:core-isolation && pnpm check:prop-vocabulary && pnpm check:token-tiers && pnpm check:control-sizing && pnpm check:rtl && pnpm check:typography && pnpm check:mcp-token-sync && pnpm check:mcp-sync && pnpm check:mcp-orphans && pnpm check:audit-sync && pnpm check:mcp-prop-sync && pnpm check:contrast && pnpm test",
     "check:mcp-sync": "node scripts/check-mcp-sync.mjs",
     "check:mcp-orphans": "node scripts/check-mcp-orphans.mjs",
     "check:mcp-prop-sync": "node scripts/check-mcp-prop-sync.mjs",
@@ -297,6 +297,7 @@
     "dev": "node scripts/dev.mjs",
     "prepublishOnly": "pnpm run build",
     "check:audit-sync": "node scripts/check-audit-sync.mjs",
+    "check:contrast": "node scripts/check-contrast.mjs",
     "visual-audit": "node scripts/visual-audit.mjs",
     "postinstall": "node scripts/postinstall.mjs",
     "init-agent": "node scripts/init-agent-kit.mjs"

package/dist/tokens/components/badge.css

@@ -1,10 +0,0 @@
-/* Badge component tokens. */
-
-:root {
-  --badge-space-gap: var(--space-inline-xs);
-  --badge-space-x: var(--space-2);
-  --badge-space-y: var(--space-1);
-  /* Small-by-design (badge/pill/counter). A knob (rule #45) so a service can
-   * re-tune badge text without touching the global --font-size-xs step. */
-  --badge-font-size: var(--font-size-xs);
-}

package/dist/tokens/components/card.css

@@ -1,51 +0,0 @@
-/* Card component tokens: card chrome derives from semantic layout tokens. */
-
-:root {
-  /* Horizontal inset of every slot (header / content / footer) + the resting top/bottom
-   * shell padding. This is the column the title, body and footer all align to. */
-  --card-space-inset: var(--space-section-active);
-  /* Vertical padding of a BANDED header band (top = bottom). Drives --card-space-divided-y. */
-  --card-space-header-y: var(--space-stack-sm);
-  /* Gap between the header and the body, and the body's own top padding — the breathing
-   * room under a title before content begins. */
-  --card-space-body-y: var(--space-section-active);
-  /* Vertical padding of a SEPARATED footer band (top = bottom). Drives --card-space-divided-y. */
-  --card-space-footer-y: var(--space-stack-sm);
-  /* DIVIDED-section vertical padding (rule #44/#45). A header/footer that carries a divider
-   * border (banded header, separated footer) reads as its own band, so it pads SYMMETRICALLY
-   * top+bottom — distinct from a plain header that flows into the body (top inset, no bottom).
-   * One themeable knob keeps the header- and footer-band rhythm in sync; a service theme tunes
-   * the band density here instead of forking per-slot CSS. */
-  --card-space-divided-y: var(--card-space-header-y);
-  /* Vertical gap between stacked items WITHIN a slot (e.g. title ↕ description in the header). */
-  --card-space-gap: var(--space-stack-xs);
-  --card-title-font-size: var(--font-size-base);
-  --card-title-line-height: var(--line-height-tight);
-  --card-title-font-weight: var(--font-weight-semibold);
-  --card-description-font-size: var(--font-size-sm);
-  --card-description-line-height: var(--line-height-normal);
-  --card-background: var(--card);
-  --card-border: var(--border);
-  --card-header-background: var(--muted);
-  --card-header-background-alpha: 0.55;
-  /* Banded-header divider — tokenised (rule #44) so a service theme can make it
-   * dashed / heavier / none without forking CSS. Pair with
-   * --card-header-background-alpha: 0 for a quiet borderless-band header. */
-  --card-header-border-bottom: 1px solid hsl(var(--card-border));
-  --card-radius: var(--radius);
-  /* Accent edge — width of the semantic leading-edge stripe (data-accent).
-   * Tokenised (rule #44) so a service theme can re-tune it without forking CSS.
-   * The slot padding compensation in card-layout.css subtracts the same token,
-   * so content stays aligned on the shell whatever the rail width. */
-  --card-accent-rail-width: 6px;
-  --stat-card-label-font-size: var(--font-size-xs);
-  --stat-card-label-font-weight: var(--font-weight-medium);
-  --stat-card-label-letter-spacing: 0.04em;
-  --stat-card-value-font-size: var(--font-size-2xl);
-  --stat-card-value-line-height: 1.1;
-  --stat-card-value-font-weight: var(--font-weight-semibold);
-  --stat-card-hint-font-size: var(--font-size-xs);
-  --stat-card-gap: var(--space-stack-xs);
-  --stat-card-icon-size: 2.25rem;
-  --stat-card-delta-font-size: var(--font-size-xs);
-}

package/dist/tokens/components/control.css

@@ -1,82 +0,0 @@
-/* Control primitive tokens: heights, horizontal padding, adjacent control sizes. */
-
-:root {
-  --control-height-compact: 1.75rem;
-  --control-height-default: 2rem;
-  --control-height-comfortable: 2.75rem;
-  --control-padding-x-compact: var(--space-2);
-  --control-padding-x-default: var(--space-3);
-  --control-padding-x-comfortable: var(--space-4);
-
-  --control-height: calc(var(--control-height-default) * var(--scaling));
-  /* Adjacent control sizes, derived from the active --control-height. The ±step
-   * is scaled too so the whole control ladder stays proportional under --scaling. */
-  --control-height-sm: calc(var(--control-height) - calc(0.25rem * var(--scaling)));
-  --control-height-lg: calc(var(--control-height) + calc(0.25rem * var(--scaling)));
-  --control-height-xs: calc(var(--control-height) - calc(0.5rem * var(--scaling)));
-  --control-padding-x: var(--control-padding-x-default);
-  --control-gap: var(--space-inline-sm);
-  --control-gap-sm: var(--space-inline-xs);
-  --control-radius: var(--radius);
-  --control-icon-size: calc(1rem * var(--scaling));
-  --control-icon-size-sm: calc(0.875rem * var(--scaling));
-  --control-focus-ring-width: 2px;
-
-  --checkbox-size: calc(1rem * var(--scaling));
-  --checkbox-size-compact: 0.875rem;
-  --checkbox-size-comfortable: 1.125rem;
-  --choice-gap: var(--space-inline-sm);
-  --choice-group-gap-x: var(--space-6);
-  --choice-group-gap-y: var(--space-3);
-  --choice-description-gap: 0.125rem;
-  --choice-control-offset: 0.125rem;
-
-  --switch-width: calc(2.25rem * var(--scaling));
-  --switch-width-compact: 2rem;
-  --switch-width-comfortable: 2.5rem;
-  --switch-height: calc(1.25rem * var(--scaling));
-  --switch-height-compact: 1.125rem;
-  --switch-height-comfortable: 1.375rem;
-  --switch-thumb-size: calc(1rem * var(--scaling));
-  --switch-thumb-size-compact: 0.875rem;
-  --switch-thumb-size-comfortable: 1.125rem;
-  --switch-thumb-translate: calc(1rem * var(--scaling));
-  --switch-thumb-translate-compact: 0.875rem;
-  --switch-thumb-translate-comfortable: 1.125rem;
-
-  --slider-track-height: 0.375rem;
-  --slider-thumb-size: 1rem;
-
-  --color-picker-input-width: 6.5rem;
-
-  --command-list-max-height: min(300px, 50vh);
-  --command-input-padding-x: var(--space-3);
-  --command-group-padding: var(--space-1);
-  --command-item-padding-y: var(--space-2);
-  --command-item-padding-x: var(--space-2);
-  --search-input-edge-inset: var(--space-3);
-  --search-input-start-padding: calc(
-    var(--search-input-edge-inset) + var(--control-icon-size) + var(--control-gap)
-  );
-  --search-input-end-padding: calc(
-    var(--search-input-edge-inset) + var(--control-icon-size) + var(--control-gap)
-  );
-
-  --choice-description-font-size: var(--font-size-xs);
-  --color-picker-hex-font-size: var(--font-size-xs);
-  --command-group-heading-font-size: var(--font-size-xs);
-  --search-input-label-font-size: var(--font-size-xs);
-  --tag-input-chip-font-size: var(--font-size-xs);
-  --toggle-sm-font-size: var(--font-size-xs);
-  --button-sm-font-size: var(--font-size-xs);
-}
-
-/* Rule #24 — on touch devices (coarse pointer) interactive controls keep a ≥44px tap target
- * regardless of density; desktop (fine pointer) keeps the compact heights above. --control-height
- * resolves through these via var(), so inputs/buttons/selects/table rows all bump together. */
-@media (pointer: coarse) {
-  :root {
-    --control-height-compact: 2.75rem;
-    --control-height-default: 2.75rem;
-  }
-}

package/dist/tokens/components/data-display.css

@@ -1,8 +0,0 @@
-/* Data-display component tokens — small-by-design text knobs (rule #45/#46). */
-
-:root {
-  --progress-label-font-size: var(--font-size-xs);
-  --tree-item-title-font-size: var(--font-size-xs);
-  --tree-item-description-font-size: var(--font-size-xs);
-  --timeline-note-font-size: var(--font-size-xs);
-}

package/dist/tokens/components/data-entry.css

@@ -1,6 +0,0 @@
-/* Data-entry component tokens — small-by-design text knobs (rule #45/#46). */
-
-:root {
-  --password-strength-score-font-size: var(--font-size-xs);
-  --password-strength-checklist-font-size: var(--font-size-xs);
-}

package/dist/tokens/components/descriptions.css

@@ -1,9 +0,0 @@
-/* Descriptions component tokens. */
-
-:root {
-  /* Width of the label column when <Descriptions layout="horizontal">. Labels align to this
-   * shared column so the values line up (the horizontal-detail look, mirroring <Form layout>).
-   * A rem value gives a fixed aligned column; set `max-content` to size each label to its text.
-   * (rule #44/#45 — a service theme tunes it here instead of forking CSS.) */
-  --descriptions-label-width: 8rem;
-}

package/dist/tokens/components/feedback.css

@@ -1,25 +0,0 @@
-/* Feedback primitive tokens: dialog, alert, empty state. */
-
-:root {
-  /* Dialog inset defaults to the shared global chrome tokens (override --space-chrome-* once for the
-   * whole system, or --dialog-space-x/-y for dialogs only). */
-  --dialog-space-x: var(--space-chrome-x);
-  --dialog-space-y: var(--space-chrome-y);
-  --dialog-space-inset: var(--dialog-space-y) var(--dialog-space-x);
-  --dialog-space-gap: var(--space-stack-md);
-  --dialog-close-space-offset: var(--space-4);
-  --alert-space-inset: var(--space-section-active);
-  --alert-space-gap: var(--space-inline-md);
-  --alert-inner-space-gap: var(--space-stack-sm);
-  --alert-dismiss-space-offset: var(--space-3);
-  /* Soft (subtle) semantic tint ratios — themeable so a service can hit its exact spec
-   * (a brand's success-bg/-border are often more present than the faint 5%/30% default). */
-  --alert-bg-alpha: 0.05;
-  --alert-border-alpha: 0.3;
-  --empty-state-space-y: var(--space-10);
-  --empty-state-space-x: var(--space-6);
-  --skeleton-row-gap: var(--space-stack-sm);
-  --skeleton-cell-gap: var(--space-inline-lg);
-  --skeleton-card-inset: var(--space-section-active);
-  --skeleton-radius: var(--radius);
-}

package/dist/tokens/components/form.css

@@ -1,11 +0,0 @@
-/* Form layout tokens: horizontal-layout label column geometry. */
-
-:root {
-  /* Width of the label column in horizontal/inline layout. A service theme sets
-   * this once (e.g. 110px) to align every form to its design grid; the Form/
-   * FormField `labelWidth` prop overrides per form/field. */
-  --form-label-width: max-content;
-
-  /* Column gap between the label and its control in horizontal/inline layout. */
-  --form-label-gap: var(--space-4); /* 16px */
-}

package/dist/tokens/components/list-row.css

@@ -1,9 +0,0 @@
-/* ListRow component tokens — a single-line entity row for short lists inside a Card
- * (sessions / API tokens / linked accounts / passkeys …). Sits in a flush CardContent;
- * rows separate with a quiet divider (#44 — chrome defaults to the calm semantic border). */
-:root {
-  --list-row-padding-y: var(--space-3);
-  --list-row-padding-x: var(--space-4);
-  --list-row-gap: var(--space-3);
-  --list-row-border: 1px solid hsl(var(--border));
-}

package/dist/tokens/components/navigation.css

@@ -1,15 +0,0 @@
-/* Navigation primitive tokens: pagination, filters, compact pickers. */
-
-:root {
-  --pagination-gap: var(--space-inline-sm);
-  --pagination-item-gap: var(--space-inline-xs);
-  --pagination-size-width: 5.5rem;
-  --pagination-total-font-size: var(--font-size-sm);
-  --filter-bar-gap: var(--space-3);
-  --filter-bar-padding-y: var(--space-2);
-  --filter-label-font-size: var(--font-size-xs);
-  --filter-picker-width-sm: 11rem;
-  --filter-picker-width-md: 14rem;
-  --breadcrumb-font-size: var(--font-size-xs);
-  --menubar-shortcut-font-size: var(--font-size-xs);
-}

package/dist/tokens/components/shell.css

@@ -1,17 +0,0 @@
-/* Shell (sidebar / topbar / kbd) component tokens — small-by-design text
- * knobs (rule #45/#46). A service re-tunes chrome text without moving the
- * global scale. */
-
-:root {
-  --sidebar-section-label-font-size: var(--font-size-2xs);
-  --sidebar-product-tenant-font-size: var(--font-size-2xs);
-  --sidebar-badge-font-size: var(--font-size-2xs);
-  --sidebar-user-role-font-size: var(--font-size-2xs);
-  --sidebar-nav-sub-font-size: var(--font-size-xs);
-  --sidebar-flyout-title-font-size: var(--font-size-xs);
-  --topbar-chip-icon-font-size: var(--font-size-2xs);
-  --kbd-font-size: var(--font-size-2xs);
-  --sidebar-logo-mark-font-size: var(--font-size-xs);
-  --sidebar-avatar-font-size: var(--font-size-2xs);
-  --sidebar-user-name-font-size: var(--font-size-xs);
-}

package/dist/tokens/components/table.css

@@ -1,13 +0,0 @@
-/* Table component tokens: row height, cell padding. */
-
-:root {
-  --table-row-height-compact: 1.75rem;
-  --table-row-height-default: 2rem;
-  --table-row-height-comfortable: 2.75rem;
-  --table-row-height: calc(var(--table-row-height-default) * var(--scaling));
-  --table-cell-padding-y: var(--space-2);
-  --table-cell-space-x: var(--control-padding-x);
-  --table-head-font-size: var(--font-size-xs);
-  /* Inline-end shadow that lifts a pinned (sticky) action column off the body it scrolls over. */
-  --table-pin-shadow: -6px 0 6px -5px hsl(var(--foreground) / 0.12);
-}

package/dist/tokens/semantic/layout.css

@@ -1,49 +0,0 @@
-/* Layout primitive tokens: page, section, stack, inline. */
-
-:root {
-  /* Semantic spacing — ONE coherent 4px grid (Tailwind/Material/Ant standard). All steps reference
-   * the linear `--space-*` scale (NOT the golden φ scale — golden ratio is for modular SIZE scales
-   * like type/radius, not the spacing grid; mixing the two left an incoherent density rhythm). The
-   * φ tokens remain available as an optional golden-layout utility, just not the spacing baseline. */
-  --space-page-x: var(--space-6); /* 24px — page gutter */
-  --space-page-y: var(--space-6); /* 24px */
-  --space-section: var(--space-4); /* 16px */
-  --space-stack-xs: var(--space-1); /* 4px */
-  --space-stack-sm: var(--space-2); /* 8px */
-  --space-stack-md: var(--space-4); /* 16px */
-  --space-stack-lg: var(--space-6); /* 24px */
-  --space-stack-xl: var(--space-10); /* 40px */
-  --space-inline-xs: var(--space-1); /* 4px */
-  --space-inline-sm: var(--space-2); /* 8px */
-  --space-inline-md: var(--space-3); /* 12px */
-  --space-inline-lg: var(--space-4); /* 16px */
-
-  --space-page-active-x: var(--space-page-x);
-  --space-page-active-y: var(--space-page-y);
-  --space-section-active: var(--space-section);
-
-  /* Full-bleed rule under the PageContainer header. OFF by default — the title/body
-   * gap already separates them; a divider is a service-theme opt-in:
-   * `--page-header-divider: 1px solid hsl(var(--border));` */
-  --page-header-divider: none;
-
-  /* Bottom inset of the page header, sized so title→body distance (this pad + the
-   * --space-section-active container gap) EQUALS the page's top padding — the title
-   * band reads vertically balanced (24 above / 24 below by default), instead of the
-   * old fixed 16px pad that left 24 above vs 32 below. */
-  --page-header-pad-bottom: calc(var(--space-page-active-y) - var(--space-section-active));
-
-  /* Section "chrome" padding — the SHARED inset for header / body / footer of every overlay-ish
-   * surface (Dialog · Sheet · Drawer · Card). One global knob: a service sets these once instead of
-   * per-component. Vertical is tightened (16 vs the old 24) and density-aware (see density.css);
-   * horizontal stays 24 (Ant standard). Per-component tokens (--sheet-pad-*, --dialog-space-inset…)
-   * default to these and only override when a surface genuinely needs to differ. */
-  --space-chrome-x: var(--space-6); /* 24px — horizontal inset */
-  --space-chrome-y: var(--space-4); /* 16px — vertical inset (header/footer/body) */
-  --space-chrome-gap: var(--space-stack-sm); /* gap between header ↔ body ↔ footer */
-
-  /* The ONE vertical gap between a field's LABEL and its CONTENT — same everywhere a label sits above
-   * a control or a value (FormField, Descriptions, Form, any label-above stack). Single source so the
-   * whole system stays in sync (gh feedback: Descriptions was ~0px while FormField was 8px). */
-  --field-label-gap: var(--space-2); /* 8px */
-}