@loworbitstudio/visor-theme-engine 0.23.0 → 0.25.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-BQU3VFCD.js";
+} from "../chunk-C2DUPZVY.js";
 
 // src/adapters/brand-passthrough.ts
 var SENTINEL_COLOR = "#ff00ff";

package/dist/{chunk-BQU3VFCD.js → chunk-C2DUPZVY.js}

@@ -1271,6 +1271,8 @@ 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";
+var ACTION_ROW = "components/ui/action-row/action-row.module.css";
 function at(file, fallback) {
   return [{ file, fallback }];
 }
@@ -1300,7 +1302,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)") }
   ]
@@ -1535,6 +1537,7 @@ var emptyStateFamily = {
     { key: "heading-color", property: "color", description: "Heading colour.", consumers: at(EMPTY_STATE, "var(--text-primary, #111827)") },
     { key: "description-font-size", property: "font-size", description: "Description type size.", consumers: at(EMPTY_STATE, "var(--font-size-sm, 0.875rem)") },
     { key: "description-color", property: "color", description: "Description colour.", consumers: at(EMPTY_STATE, "var(--text-secondary, #6b7280)") },
+    { key: "error-color", property: "color", description: 'Icon, chip glyph and heading colour for `intent="error"`.', consumers: at(EMPTY_STATE, "var(--destructive, #dc2626)") },
     { key: "actions-gap", property: "gap", description: "Gap between placard actions.", consumers: at(EMPTY_STATE, "var(--spacing-2, 0.5rem)") }
   ]
 };
@@ -1606,7 +1609,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)") },
@@ -1898,14 +1901,85 @@ var switchFamily = {
 var saveStatusFamily = {
   family: "save-status",
   prefix: "save-status",
-  description: "SaveStatus readout \u2014 the fixed-width slot and its type, so the readout never reflows its row.",
+  description: "SaveStatus readout \u2014 the fixed-width slot, its type, the Syncing ink and the Unsaved dot, so the readout never reflows its row.",
   tokens: [
-    { key: "width", property: "width", description: "Slot width. Fixed, so the row never reflows between states.", consumers: at(SAVE_STATUS, "7.5rem") },
+    { key: "width", property: "width", description: "Slot width. Unbound, the slot is as wide as the longest label in the current font plus the retry mark, the same in every state. Bind it to pin a width; a longer label then truncates inside it.", consumers: at(SAVE_STATUS, "auto") },
+    { key: "syncing-color", property: "color", description: "Ink of the Syncing state (a first sync from an outside source). Unbound it reads `--text-secondary`.", consumers: at(SAVE_STATUS, "var(--text-secondary, #6b7280)") },
+    { key: "dot-size", property: "width", description: 'Diameter of the dot that draws Unsaved when `unsavedAs="dot"`. The slot width does not change.', consumers: at(SAVE_STATUS, "var(--spacing-2, 0.5rem)") },
     { key: "font-family", property: "font-family", description: "Readout family (e.g. the theme's mono).", consumers: at(SAVE_STATUS, "revert-layer") },
     { key: "text-transform", property: "text-transform", description: "Readout casing.", consumers: at(SAVE_STATUS, "revert-layer") },
     { 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 actionRowFamily = {
+  family: "action-row",
+  prefix: "action-row",
+  description: "ActionRow state fills, edge and geometry: rest, hover, open, selected and disabled each read their own token.",
+  tokens: [
+    { key: "min-height", property: "min-height", description: "Row floor height; the whole row is the target.", consumers: at(ACTION_ROW, "2.75rem") },
+    { key: "padding", property: "padding", description: "Row inset, kept inside the hover and selected fills.", consumers: at(ACTION_ROW, "var(--spacing-2, 0.5rem) var(--spacing-3, 0.75rem)") },
+    { key: "gap", property: "gap", description: "Gap between the leading slot, the title block and the trailing slot.", consumers: at(ACTION_ROW, "var(--spacing-3, 0.75rem)") },
+    { key: "radius", property: "border-radius", description: "Row corner rounding (the hover and selected fill).", consumers: at(ACTION_ROW, "var(--radius-md, 0.375rem)") },
+    { key: "hover-bg", property: "background-color", description: "Hover fill.", consumers: at(ACTION_ROW, "var(--surface-interactive-hover, #f3f4f6)") },
+    { key: "open-bg", property: "background-color", description: "Fill of a row that has opened a picker or popover (`aria-expanded`).", consumers: at(ACTION_ROW, "var(--surface-interactive-hover, #f3f4f6)") },
+    { key: "selected-bg", property: "background-color", description: "Selected fill. A lifted fill, never white.", consumers: at(ACTION_ROW, "var(--surface-interactive-active, #e5e7eb)") },
+    { key: "selected-edge-color", property: "outline-color", description: "Selected row's inset edge colour. Its width is `--control-state-edge-width`, so `edges: off` keeps it.", consumers: at(ACTION_ROW, "var(--text-secondary, #6b7280)") },
+    { key: "disabled-opacity", property: "opacity", description: "Disabled row opacity.", consumers: at(ACTION_ROW, "var(--opacity-50, 0.5)") },
+    { key: "title-weight", property: "font-weight", description: "Title weight.", consumers: at(ACTION_ROW, "var(--font-weight-medium, 500)") },
+    { key: "line-color", property: "color", description: "Second-line colour.", consumers: at(ACTION_ROW, "var(--text-secondary, #6b7280)") },
+    { key: "leading-color", property: "color", description: "Leading icon colour.", consumers: at(ACTION_ROW, "var(--text-secondary, #6b7280)") },
+    { key: "leading-size", property: "font-size", description: "Leading icon size.", consumers: at(ACTION_ROW, "1.25rem") },
+    { key: "trailing-color", property: "color", description: "Trailing value or caret colour.", consumers: at(ACTION_ROW, "var(--text-secondary, #6b7280)") }
+  ]
+};
+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 = [
+  ACTION_ROW,
+  "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",
@@ -1935,11 +2009,14 @@ var COMPONENT_TOKEN_FAMILIES = [
   spinnerFamily,
   checkboxFamily,
   controlFamily,
+  hairlineFamily,
   fieldFamily,
   buttonFamily,
   textFamily,
   switchFamily,
   saveStatusFamily,
+  tooltipFamily,
+  actionRowFamily,
   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.",
@@ -1089,7 +1097,7 @@ var properties = {
 			},
 			"empty-state": {
 				type: "object",
-				description: "Empty-state placard — surface, icon chip and copy scale. Keys: radius, text-color, gap, padding, bg, border, icon-size, icon-radius, icon-bg, icon-color, heading-font-family, heading-font-size, heading-font-weight, heading-color, description-font-size, description-color, actions-gap.",
+				description: "Empty-state placard — surface, icon chip and copy scale. Keys: radius, text-color, gap, padding, bg, border, icon-size, icon-radius, icon-bg, icon-color, heading-font-family, heading-font-size, heading-font-weight, heading-color, description-font-size, description-color, error-color, actions-gap.",
 				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.",
@@ -1180,7 +1195,21 @@ var properties = {
 			},
 			"save-status": {
 				type: "object",
-				description: "SaveStatus readout — the fixed-width slot and its type, so the readout never reflows its row. Keys: width, font-family, text-transform, letter-spacing.",
+				description: "SaveStatus readout — the fixed-width slot, its type, the Syncing ink and the Unsaved dot, so the readout never reflows its row. Keys: width, syncing-color, dot-size, font-family, text-transform, letter-spacing.",
+				additionalProperties: {
+					$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"
+				}
+			},
+			"action-row": {
+				type: "object",
+				description: "ActionRow state fills, edge and geometry: rest, hover, open, selected and disabled each read their own token. Keys: min-height, padding, gap, radius, hover-bg, open-bg, selected-bg, selected-edge-color, disabled-opacity, title-weight, line-color, leading-color, leading-size, trailing-color.",
 				additionalProperties: {
 					$ref: "#/$defs/componentTokenBinding"
 				}

package/dist/index.js

@@ -63,7 +63,7 @@ import {
   rgbToOklch,
   serializeColor,
   validateComponentBindings
-} from "./chunk-BQU3VFCD.js";
+} from "./chunk-C2DUPZVY.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.",
@@ -1128,7 +1133,7 @@ var visor_theme_schema_default = {
         },
         "empty-state": {
           type: "object",
-          description: "Empty-state placard \u2014 surface, icon chip and copy scale. Keys: radius, text-color, gap, padding, bg, border, icon-size, icon-radius, icon-bg, icon-color, heading-font-family, heading-font-size, heading-font-weight, heading-color, description-font-size, description-color, actions-gap.",
+          description: "Empty-state placard \u2014 surface, icon chip and copy scale. Keys: radius, text-color, gap, padding, bg, border, icon-size, icon-radius, icon-bg, icon-color, heading-font-family, heading-font-size, heading-font-weight, heading-color, description-font-size, description-color, error-color, actions-gap.",
           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.",
@@ -1219,7 +1231,21 @@ var visor_theme_schema_default = {
         },
         "save-status": {
           type: "object",
-          description: "SaveStatus readout \u2014 the fixed-width slot and its type, so the readout never reflows its row. Keys: width, font-family, text-transform, letter-spacing.",
+          description: "SaveStatus readout \u2014 the fixed-width slot, its type, the Syncing ink and the Unsaved dot, so the readout never reflows its row. Keys: width, syncing-color, dot-size, font-family, text-transform, letter-spacing.",
+          additionalProperties: {
+            $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"
+          }
+        },
+        "action-row": {
+          type: "object",
+          description: "ActionRow state fills, edge and geometry: rest, hover, open, selected and disabled each read their own token. Keys: min-height, padding, gap, radius, hover-bg, open-bg, selected-bg, selected-edge-color, disabled-opacity, title-weight, line-color, leading-color, leading-size, trailing-color.",
           additionalProperties: {
             $ref: "#/$defs/componentTokenBinding"
           }
@@ -1509,7 +1535,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 +1818,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 +2203,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.23.0",
+  "version": "0.25.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.",
@@ -512,7 +517,7 @@
         },
         "empty-state": {
           "type": "object",
-          "description": "Empty-state placard — surface, icon chip and copy scale. Keys: radius, text-color, gap, padding, bg, border, icon-size, icon-radius, icon-bg, icon-color, heading-font-family, heading-font-size, heading-font-weight, heading-color, description-font-size, description-color, actions-gap.",
+          "description": "Empty-state placard — surface, icon chip and copy scale. Keys: radius, text-color, gap, padding, bg, border, icon-size, icon-radius, icon-bg, icon-color, heading-font-family, heading-font-size, heading-font-weight, heading-color, description-font-size, description-color, error-color, actions-gap.",
           "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.",
@@ -603,7 +615,21 @@
         },
         "save-status": {
           "type": "object",
-          "description": "SaveStatus readout — the fixed-width slot and its type, so the readout never reflows its row. Keys: width, font-family, text-transform, letter-spacing.",
+          "description": "SaveStatus readout — the fixed-width slot, its type, the Syncing ink and the Unsaved dot, so the readout never reflows its row. Keys: width, syncing-color, dot-size, font-family, text-transform, letter-spacing.",
+          "additionalProperties": {
+            "$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"
+          }
+        },
+        "action-row": {
+          "type": "object",
+          "description": "ActionRow state fills, edge and geometry: rest, hover, open, selected and disabled each read their own token. Keys: min-height, padding, gap, radius, hover-bg, open-bg, selected-bg, selected-edge-color, disabled-opacity, title-weight, line-color, leading-color, leading-size, trailing-color.",
           "additionalProperties": {
             "$ref": "#/$defs/componentTokenBinding"
           }