@loworbitstudio/visor-theme-engine 0.22.0 → 0.24.0

package/dist/adapters/index.d.ts

@@ -1,4 +1,4 @@
-import { k as GeneratedPrimitives, s as SemanticTokens, R as ResolvedThemeConfig } from '../types-Wy5n0W9F.js';
+import { k as GeneratedPrimitives, s as SemanticTokens, R as ResolvedThemeConfig } from '../types-ZPTjTL_-.js';
 
 /**
  * Adapter types for the Visor theme engine.

package/dist/adapters/index.js

@@ -25,7 +25,7 @@ import {
   resolveThemeBrand,
   resolveThemeFonts,
   sectionComment
-} from "../chunk-L5DQDEZV.js";
+} from "../chunk-D5XSLWXP.js";
 
 // src/adapters/brand-passthrough.ts
 var SENTINEL_COLOR = "#ff00ff";

package/dist/{chunk-L5DQDEZV.js → chunk-D5XSLWXP.js}

@@ -1271,6 +1271,7 @@ var FIELD = "components/ui/field/field.module.css";
 var TEXT = "components/ui/text/text.module.css";
 var INLINE_EDIT = "components/ui/inline-edit/inline-edit.module.css";
 var SAVE_STATUS = "components/ui/save-status/save-status.module.css";
+var TOOLTIP = "components/ui/tooltip/tooltip.module.css";
 function at(file, fallback) {
   return [{ file, fallback }];
 }
@@ -1300,7 +1301,7 @@ var tableFamily = {
     { key: "cell-font-size", property: "font-size", description: "Body cell type size.", consumers: at(TABLE, "inherit") },
     { key: "cell-color", property: "color", description: "Body cell text colour.", consumers: at(TABLE, "var(--text-primary, #111827)") },
     { key: "cell-bg", property: "background-color", description: "Body cell fill. Sits above the shared `--dt-row-bg` surface role.", consumers: at(TABLE, "var(--dt-row-bg, transparent)") },
-    { key: "cell-border-top", property: "border-top", description: "Cell hairline.", consumers: at(TABLE, "1px solid var(--hairline, transparent)") },
+    { key: "cell-border-top", property: "border-top", description: "Cell hairline.", consumers: at(TABLE, "var(--hairline-width, 1px) solid var(--hairline, transparent)") },
     { key: "footer-bg", property: "background-color", description: "Footer row fill.", consumers: at(TABLE, "var(--surface-muted, #f3f4f6)") },
     { key: "caption-color", property: "color", description: "Caption text colour.", consumers: at(TABLE, "var(--text-secondary, #6b7280)") }
   ]
@@ -1404,7 +1405,49 @@ var badgeFamily = {
       ]
     },
     { key: "md-padding", property: "padding", description: "Default badge padding.", consumers: at(BADGE, "calc(var(--spacing-1, 0.25rem) / 2) var(--spacing-2, 0.5rem)") },
-    { key: "md-gap", property: "gap", description: "Default badge icon gap.", consumers: at(BADGE, "var(--spacing-1, 0.25rem)") }
+    { key: "md-gap", property: "gap", description: "Default badge icon gap.", consumers: at(BADGE, "var(--spacing-1, 0.25rem)") },
+    {
+      key: "bg",
+      property: "background-color",
+      description: "Badge ground in every variant (an accent tint, an on-image scrim). Unset, each variant keeps its own surface.",
+      consumers: [
+        "var(--interactive-primary-bg, currentColor)",
+        "var(--interactive-secondary-bg, var(--surface-subtle, transparent))",
+        "var(--surface-card, #ffffff)",
+        "transparent",
+        "var(--surface-error-subtle, transparent)",
+        "color-mix(in srgb, var(--destructive) 20%, transparent)",
+        "var(--surface-success-subtle, transparent)",
+        "color-mix(in srgb, var(--success) 18%, transparent)",
+        "var(--surface-warning-subtle, transparent)",
+        "color-mix(in srgb, var(--warning) 20%, transparent)",
+        "var(--surface-info-subtle, transparent)",
+        "color-mix(in srgb, var(--info) 18%, transparent)",
+        "var(--surface-muted, #f3f4f6)",
+        "var(--surface-error-default, transparent)",
+        "var(--surface-success-default, transparent)",
+        "var(--surface-warning-default, transparent)",
+        "var(--surface-info-default, transparent)",
+        "var(--color-neutral-600, #4b5563)"
+      ].map((fallback) => ({ file: BADGE, fallback }))
+    },
+    {
+      key: "ink",
+      property: "color",
+      description: "Badge label colour in every variant. Unset, each variant keeps its own text colour.",
+      consumers: [
+        "var(--interactive-primary-text, var(--text-inverse, #f9fafb))",
+        "var(--interactive-secondary-text, var(--text-primary, currentColor))",
+        "var(--text-primary, #111827)",
+        "var(--text-error, currentColor)",
+        "var(--text-success, currentColor)",
+        "var(--text-warning, currentColor)",
+        "var(--text-info, currentColor)",
+        "var(--text-secondary, var(--text-primary, #374151))",
+        "var(--text-inverse, currentColor)",
+        "var(--color-white, #ffffff)"
+      ].map((fallback) => ({ file: BADGE, fallback }))
+    }
   ]
 };
 var statusBadgeFamily = {
@@ -1564,7 +1607,7 @@ var tabsFamily = {
     { key: "list-padding", property: "padding", description: "Tab-rail inset.", consumers: at(TABS, "calc(var(--spacing-1, 0.25rem) * 0.75)") },
     { key: "list-color", property: "color", description: "Tab-rail base text colour.", consumers: at(TABS, "var(--text-secondary, #6b7280)") },
     { key: "list-bg", property: "background-color", description: "Segmented-variant rail fill.", consumers: at(TABS, "var(--surface-muted, #f3f4f6)") },
-    { key: "line-border-bottom", property: "border-bottom", description: "Underlined-variant rail rule.", consumers: at(TABS, "1px solid var(--hairline, var(--border-default, #e5e7eb))") },
+    { key: "line-border-bottom", property: "border-bottom", description: "Underlined-variant rail rule (width, style and colour). Unbound, the rail rule is painted at `--hairline-width`; binding this draws your border instead.", consumers: at(TABS, "1px solid transparent") },
     { key: "trigger-radius", property: "border-radius", description: "Trigger corner rounding.", consumers: at(TABS, "var(--radius-md, 0.375rem)") },
     { key: "trigger-padding", property: "padding", description: "Trigger inset.", consumers: at(TABS, "var(--spacing-1, 0.25rem) var(--spacing-2, 0.5rem)") },
     { key: "trigger-font-size", property: "font-size", description: "Trigger type size.", consumers: at(TABS, "var(--font-size-sm, 0.875rem)") },
@@ -1864,6 +1907,53 @@ var saveStatusFamily = {
     { key: "letter-spacing", property: "letter-spacing", description: "Readout tracking.", consumers: at(SAVE_STATUS, "revert-layer") }
   ]
 };
+var tooltipFamily = {
+  family: "tooltip",
+  prefix: "tooltip",
+  description: "Tooltip ground and ink, so a dark theme can keep the label legible without retuning the shared inverse pair other components read.",
+  tokens: [
+    { key: "bg", property: "background-color", description: "Tooltip ground.", consumers: at(TOOLTIP, "var(--surface-overlay, #111827)") },
+    { key: "text", property: "color", description: "Tooltip label colour.", consumers: at(TOOLTIP, "var(--text-inverse, #ffffff)") }
+  ]
+};
+var HAIRLINE_PX = [
+  "components/ui/bulk-action-bar/bulk-action-bar.module.css",
+  "components/ui/dialog/dialog.module.css",
+  "components/ui/dropdown-menu/dropdown-menu.module.css",
+  "components/ui/matrix-table/matrix-table.module.css",
+  TABLE,
+  TABS
+];
+var HAIRLINE_THIN = [
+  "blocks/dialog-form/dialog-form.module.css",
+  "components/ui/coherence-check/coherence-check.module.css",
+  "components/ui/doc-frame/doc-frame.module.css",
+  "components/ui/doc-nav/doc-nav.module.css",
+  "components/ui/editable-block/editable-block.module.css",
+  "components/ui/fidelity-mirror/fidelity-mirror.module.css",
+  "components/ui/infographic-bar/infographic-bar.module.css",
+  "components/ui/popover/popover.module.css",
+  "components/ui/section-nav/section-nav.module.css",
+  "components/ui/specimen-card/specimen-card.module.css",
+  "components/ui/structured-prompt/structured-prompt.module.css",
+  "components/visual/browser-frame/browser-frame.module.css"
+];
+var hairlineFamily = {
+  family: "hairline",
+  prefix: "hairline",
+  description: "The one switch for hairlines (VI-680). Every hairline rule, divider and ring reads its weight from `--hairline-width`, so `width: 0` removes them all at once. Independent of the `control` edge switch.",
+  tokens: [
+    {
+      key: "width",
+      property: "border-width / box-shadow spread / height",
+      description: "THE switch. Hairline weight for every `--hairline` / `--hairline-strong` rule; `0` turns every hairline off. Focus and invalid edges are untouched.",
+      consumers: [
+        ...each(HAIRLINE_PX, "1px"),
+        ...each(HAIRLINE_THIN, "var(--stroke-width-thin, 1px)")
+      ]
+    }
+  ]
+};
 var adminUiFamily = {
   family: "admin-ui",
   prefix: "admin-ui",
@@ -1893,11 +1983,13 @@ var COMPONENT_TOKEN_FAMILIES = [
   spinnerFamily,
   checkboxFamily,
   controlFamily,
+  hairlineFamily,
   fieldFamily,
   buttonFamily,
   textFamily,
   switchFamily,
   saveStatusFamily,
+  tooltipFamily,
   adminUiFamily
 ];
 var COMPONENT_TOKEN_FAMILY_BY_NAME = new Map(

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FontResolveOptions, a as FontResolution, V as VisorTypography, b as FontDisplayStrategy, T as ThemeFontResult, G as GoogleFontEntry, c as VisorBrand, B as BrandSlot, d as BrandSource, e as BrandResolution, C as ColorScheme, f as ThemeBrandResult, g as BrandStrategy, h as BrandStrategyContext, i as BrandStrategyIssue, j as BrandStrategyValidationResult, S as SerializedBrandStrategy, R as ResolvedThemeConfig, k as GeneratedPrimitives, l as ThemeOutput, m as ThemeData, n as VisorThemeConfig, o as FullShadeScale, p as ColorRole, q as SelectiveShadeScale, r as RGB, P as ParsedColor, O as OKLCH, s as SemanticTokens, t as ShadeStep } from './types-Wy5n0W9F.js';
-export { u as BRAND_VARIANTS, v as BRAND_VISIBILITIES, w as BrandAccessibility, x as BrandArchetype, y as BrandBoilerplate, z as BrandColorPairing, A as BrandColorUsage, D as BrandContrastTarget, E as BrandGoverns, H as BrandLexiconEntry, I as BrandMessaging, J as BrandPersonalityTrait, K as BrandPillar, L as BrandPositioning, M as BrandStrategyIssueSeverity, N as BrandToneEntry, Q as BrandVariant, U as BrandVisibility, W as BrandVoice, X as BrandVoiceTrait, Y as COMPONENT_TOKEN_FAMILIES, Z as COMPONENT_TOKEN_FAMILY_BY_NAME, _ as ColorFormat, $ as ComponentTokenBinding, a0 as ComponentTokenBindings, a1 as ComponentTokenConsumer, a2 as ComponentTokenFamily, a3 as ComponentTokenSpec, a4 as DEFAULT_BRAND_STRATEGY_SURFACES, a5 as DEFAULT_BRAND_STRATEGY_TONE_STATES, a6 as FontSource, a7 as GOVERNS_WILDCARD, a8 as RGBA, a9 as ResolvedComponentTokens, aa as SemanticTokenValue, ab as allComponentTokenNames, ac as componentTokenName, ad as hasComponentBindings, ae as resolveComponentBindings, af as validateComponentBindings } from './types-Wy5n0W9F.js';
+import { F as FontResolveOptions, a as FontResolution, V as VisorTypography, b as FontDisplayStrategy, T as ThemeFontResult, G as GoogleFontEntry, c as VisorBrand, B as BrandSlot, d as BrandSource, e as BrandResolution, C as ColorScheme, f as ThemeBrandResult, g as BrandStrategy, h as BrandStrategyContext, i as BrandStrategyIssue, j as BrandStrategyValidationResult, S as SerializedBrandStrategy, R as ResolvedThemeConfig, k as GeneratedPrimitives, l as ThemeOutput, m as ThemeData, n as VisorThemeConfig, o as FullShadeScale, p as ColorRole, q as SelectiveShadeScale, r as RGB, P as ParsedColor, O as OKLCH, s as SemanticTokens, t as ShadeStep } from './types-ZPTjTL_-.js';
+export { u as BRAND_VARIANTS, v as BRAND_VISIBILITIES, w as BrandAccessibility, x as BrandArchetype, y as BrandBoilerplate, z as BrandColorPairing, A as BrandColorUsage, D as BrandContrastTarget, E as BrandGoverns, H as BrandLexiconEntry, I as BrandMessaging, J as BrandPersonalityTrait, K as BrandPillar, L as BrandPositioning, M as BrandStrategyIssueSeverity, N as BrandToneEntry, Q as BrandVariant, U as BrandVisibility, W as BrandVoice, X as BrandVoiceTrait, Y as COMPONENT_TOKEN_FAMILIES, Z as COMPONENT_TOKEN_FAMILY_BY_NAME, _ as ColorFormat, $ as ComponentTokenBinding, a0 as ComponentTokenBindings, a1 as ComponentTokenConsumer, a2 as ComponentTokenFamily, a3 as ComponentTokenSpec, a4 as DEFAULT_BRAND_STRATEGY_SURFACES, a5 as DEFAULT_BRAND_STRATEGY_TONE_STATES, a6 as FontSource, a7 as GOVERNS_WILDCARD, a8 as RGBA, a9 as ResolvedComponentTokens, aa as SemanticTokenValue, ab as allComponentTokenNames, ac as componentTokenName, ad as hasComponentBindings, ae as resolveComponentBindings, af as validateComponentBindings } from './types-ZPTjTL_-.js';
 
 /**
  * Font resolver — maps font family names to loadable font resources.
@@ -408,6 +408,14 @@ var properties = {
 		],
 		description: "The one switch for form-control edges (VI-655). 'off' removes the resting edge of every form control, dashed drop-target and empty-state edges included, with no layout shift; focus and invalid stay visible. Shorthand for components.control.edge-width: \"0\" (an explicit binding there wins). Defaults to 'on'. Optional."
 	},
+	hairlines: {
+		type: "string",
+		"enum": [
+			"on",
+			"off"
+		],
+		description: "The one switch for hairlines (VI-680). 'off' sets --hairline-width to 0, so every hairline rule, divider and ring disappears. Shorthand for components.hairline.width: \"0\" (an explicit binding there wins). Independent of 'edges'. Defaults to 'on'. Optional."
+	},
 	colors: {
 		type: "object",
 		description: "Color definitions for light mode. Only primary is required — all others have sensible defaults.",
@@ -1061,7 +1069,7 @@ var properties = {
 			},
 			badge: {
 				type: "object",
-				description: "Badge treatment — the D3 Tier-2 `--badge-text-transform` / `-letter-spacing` / `-font-size` / `-font-weight` set, promoted from the admin-ui audit to a bindable contract. Keys: radius, border, font-family, font-weight, text-transform, letter-spacing, font-size, md-padding, md-gap.",
+				description: "Badge treatment — the D3 Tier-2 `--badge-text-transform` / `-letter-spacing` / `-font-size` / `-font-weight` set, promoted from the admin-ui audit to a bindable contract. Keys: radius, border, font-family, font-weight, text-transform, letter-spacing, font-size, md-padding, md-gap, bg, ink.",
 				additionalProperties: {
 					$ref: "#/$defs/componentTokenBinding"
 				}
@@ -1136,6 +1144,13 @@ var properties = {
 					$ref: "#/$defs/componentTokenBinding"
 				}
 			},
+			hairline: {
+				type: "object",
+				description: "The one switch for hairlines (VI-680). Every hairline rule, divider and ring reads its weight from `--hairline-width`, so `width: 0` removes them all at once. Independent of the `control` edge switch. Keys: width.",
+				additionalProperties: {
+					$ref: "#/$defs/componentTokenBinding"
+				}
+			},
 			control: {
 				type: "object",
 				description: "The one switch for form-control edges (VI-655). Every form control draws its resting edge from these, so `edge-width: 0` removes every resting edge at once, dashed edges included, with no layout shift. Keys: edge-width, edge-color, edge-style, drop-edge-width, drop-edge-style, state-edge-width.",
@@ -1185,6 +1200,13 @@ var properties = {
 					$ref: "#/$defs/componentTokenBinding"
 				}
 			},
+			tooltip: {
+				type: "object",
+				description: "Tooltip ground and ink, so a dark theme can keep the label legible without retuning the shared inverse pair other components read. Keys: bg, text.",
+				additionalProperties: {
+					$ref: "#/$defs/componentTokenBinding"
+				}
+			},
 			"admin-ui": {
 				type: "object",
 				description: "Structural roles the admin-ui pattern owns. `marquee-family` is the display face for KPI hero figures and marquee page titles — the role the admin-ui portability audit named as the one piece of ENTR brand coupling a new theme must rebind. Keys: marquee-family.",

package/dist/index.js

@@ -63,7 +63,7 @@ import {
   rgbToOklch,
   serializeColor,
   validateComponentBindings
-} from "./chunk-L5DQDEZV.js";
+} from "./chunk-D5XSLWXP.js";
 
 // src/fonts/validate-coverage.ts
 var FONT_VAR_RE = /--font-(heading|display|body|sans|mono)\s*:\s*([^;]+);/g;
@@ -655,6 +655,11 @@ var visor_theme_schema_default = {
       enum: ["on", "off"],
       description: `The one switch for form-control edges (VI-655). 'off' removes the resting edge of every form control, dashed drop-target and empty-state edges included, with no layout shift; focus and invalid stay visible. Shorthand for components.control.edge-width: "0" (an explicit binding there wins). Defaults to 'on'. Optional.`
     },
+    hairlines: {
+      type: "string",
+      enum: ["on", "off"],
+      description: `The one switch for hairlines (VI-680). 'off' sets --hairline-width to 0, so every hairline rule, divider and ring disappears. Shorthand for components.hairline.width: "0" (an explicit binding there wins). Independent of 'edges'. Defaults to 'on'. Optional.`
+    },
     colors: {
       type: "object",
       description: "Color definitions for light mode. Only primary is required \u2014 all others have sensible defaults.",
@@ -1100,7 +1105,7 @@ var visor_theme_schema_default = {
         },
         badge: {
           type: "object",
-          description: "Badge treatment \u2014 the D3 Tier-2 `--badge-text-transform` / `-letter-spacing` / `-font-size` / `-font-weight` set, promoted from the admin-ui audit to a bindable contract. Keys: radius, border, font-family, font-weight, text-transform, letter-spacing, font-size, md-padding, md-gap.",
+          description: "Badge treatment \u2014 the D3 Tier-2 `--badge-text-transform` / `-letter-spacing` / `-font-size` / `-font-weight` set, promoted from the admin-ui audit to a bindable contract. Keys: radius, border, font-family, font-weight, text-transform, letter-spacing, font-size, md-padding, md-gap, bg, ink.",
           additionalProperties: {
             $ref: "#/$defs/componentTokenBinding"
           }
@@ -1175,6 +1180,13 @@ var visor_theme_schema_default = {
             $ref: "#/$defs/componentTokenBinding"
           }
         },
+        hairline: {
+          type: "object",
+          description: "The one switch for hairlines (VI-680). Every hairline rule, divider and ring reads its weight from `--hairline-width`, so `width: 0` removes them all at once. Independent of the `control` edge switch. Keys: width.",
+          additionalProperties: {
+            $ref: "#/$defs/componentTokenBinding"
+          }
+        },
         control: {
           type: "object",
           description: "The one switch for form-control edges (VI-655). Every form control draws its resting edge from these, so `edge-width: 0` removes every resting edge at once, dashed edges included, with no layout shift. Keys: edge-width, edge-color, edge-style, drop-edge-width, drop-edge-style, state-edge-width.",
@@ -1224,6 +1236,13 @@ var visor_theme_schema_default = {
             $ref: "#/$defs/componentTokenBinding"
           }
         },
+        tooltip: {
+          type: "object",
+          description: "Tooltip ground and ink, so a dark theme can keep the label legible without retuning the shared inverse pair other components read. Keys: bg, text.",
+          additionalProperties: {
+            $ref: "#/$defs/componentTokenBinding"
+          }
+        },
         "admin-ui": {
           type: "object",
           description: "Structural roles the admin-ui pattern owns. `marquee-family` is the display face for KPI hero figures and marquee page titles \u2014 the role the admin-ui portability audit named as the one piece of ENTR brand coupling a new theme must rebind. Keys: marquee-family.",
@@ -1509,7 +1528,8 @@ var KNOWN_TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
   "motion",
   "overrides",
   "components",
-  "edges"
+  "edges",
+  "hairlines"
 ]);
 var KNOWN_COLOR_KEYS = /* @__PURE__ */ new Set([
   "primary",
@@ -1791,6 +1811,9 @@ function validateConfig(config) {
   if (obj.edges !== void 0 && obj.edges !== "on" && obj.edges !== "off") {
     errors.push("'edges' must be either 'on' or 'off'");
   }
+  if (obj.hairlines !== void 0 && obj.hairlines !== "on" && obj.hairlines !== "off") {
+    errors.push("'hairlines' must be either 'on' or 'off'");
+  }
   if (typeof obj.colors !== "object" || obj.colors === null) {
     errors.push("'colors' is required and must be an object");
     return { valid: false, errors };
@@ -2173,9 +2196,16 @@ function resolveConfig(config) {
     // component-tokens.ts owns their shape, there is nothing to default.
     // VI-655: `edges: off` folds in here as `control.edge-width: 0`, so every
     // adapter emits the switch through the same component-token path.
-    components: config.edges === "off" ? {
+    // VI-680: `hairlines: off` folds in the same way, as `hairline.width: 0`.
+    // The two switches are independent: each touches only its own family.
+    components: config.edges === "off" || config.hairlines === "off" ? {
       ...config.components,
-      control: { "edge-width": "0", ...config.components?.control }
+      ...config.edges === "off" && {
+        control: { "edge-width": "0", ...config.components?.control }
+      },
+      ...config.hairlines === "off" && {
+        hairline: { width: "0", ...config.components?.hairline }
+      }
     } : config.components,
     originalColors,
     colorFormats

package/dist/{types-Wy5n0W9F.d.ts → types-ZPTjTL_-.d.ts}

@@ -838,6 +838,14 @@ interface VisorThemeConfig {
      * `components.control.edge-width` wins over it. Default: `on`.
      */
     edges?: "on" | "off";
+    /**
+     * VI-680: the one switch for hairlines. `off` sets `--hairline-width` to 0 so
+     * every hairline rule, divider and ring (the `--hairline` / `--hairline-strong`
+     * family) disappears. Shorthand for `components.hairline.width: "0"`, and an
+     * explicit `components.hairline.width` wins over it. Independent of `edges`:
+     * neither switch touches the other's tokens. Default: `on`.
+     */
+    hairlines?: "on" | "off";
     /**
      * Migration metadata — optional, additive, consumed by `visor migrate` commands.
      * Does not affect CSS generation or theme application.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loworbitstudio/visor-theme-engine",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "Theme engine for the Visor design system — shade generation, token mapping, font resolution, and import/export for .visor.yaml themes.",
   "type": "module",
   "main": "./dist/index.js",

package/src/visor-theme.schema.json

@@ -39,6 +39,11 @@
       "enum": ["on", "off"],
       "description": "The one switch for form-control edges (VI-655). 'off' removes the resting edge of every form control, dashed drop-target and empty-state edges included, with no layout shift; focus and invalid stay visible. Shorthand for components.control.edge-width: \"0\" (an explicit binding there wins). Defaults to 'on'. Optional."
     },
+    "hairlines": {
+      "type": "string",
+      "enum": ["on", "off"],
+      "description": "The one switch for hairlines (VI-680). 'off' sets --hairline-width to 0, so every hairline rule, divider and ring disappears. Shorthand for components.hairline.width: \"0\" (an explicit binding there wins). Independent of 'edges'. Defaults to 'on'. Optional."
+    },
     "colors": {
       "type": "object",
       "description": "Color definitions for light mode. Only primary is required — all others have sensible defaults.",
@@ -484,7 +489,7 @@
         },
         "badge": {
           "type": "object",
-          "description": "Badge treatment — the D3 Tier-2 `--badge-text-transform` / `-letter-spacing` / `-font-size` / `-font-weight` set, promoted from the admin-ui audit to a bindable contract. Keys: radius, border, font-family, font-weight, text-transform, letter-spacing, font-size, md-padding, md-gap.",
+          "description": "Badge treatment — the D3 Tier-2 `--badge-text-transform` / `-letter-spacing` / `-font-size` / `-font-weight` set, promoted from the admin-ui audit to a bindable contract. Keys: radius, border, font-family, font-weight, text-transform, letter-spacing, font-size, md-padding, md-gap, bg, ink.",
           "additionalProperties": {
             "$ref": "#/$defs/componentTokenBinding"
           }
@@ -559,6 +564,13 @@
             "$ref": "#/$defs/componentTokenBinding"
           }
         },
+        "hairline": {
+          "type": "object",
+          "description": "The one switch for hairlines (VI-680). Every hairline rule, divider and ring reads its weight from `--hairline-width`, so `width: 0` removes them all at once. Independent of the `control` edge switch. Keys: width.",
+          "additionalProperties": {
+            "$ref": "#/$defs/componentTokenBinding"
+          }
+        },
         "control": {
           "type": "object",
           "description": "The one switch for form-control edges (VI-655). Every form control draws its resting edge from these, so `edge-width: 0` removes every resting edge at once, dashed edges included, with no layout shift. Keys: edge-width, edge-color, edge-style, drop-edge-width, drop-edge-style, state-edge-width.",
@@ -608,6 +620,13 @@
             "$ref": "#/$defs/componentTokenBinding"
           }
         },
+        "tooltip": {
+          "type": "object",
+          "description": "Tooltip ground and ink, so a dark theme can keep the label legible without retuning the shared inverse pair other components read. Keys: bg, text.",
+          "additionalProperties": {
+            "$ref": "#/$defs/componentTokenBinding"
+          }
+        },
         "admin-ui": {
           "type": "object",
           "description": "Structural roles the admin-ui pattern owns. `marquee-family` is the display face for KPI hero figures and marquee page titles — the role the admin-ui portability audit named as the one piece of ENTR brand coupling a new theme must rebind. Keys: marquee-family.",