@loworbitstudio/visor-theme-engine 0.20.0 → 0.22.0

package/dist/adapters/index.d.ts

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

package/dist/adapters/index.js

@@ -6,6 +6,7 @@ import {
   block,
   buildVisorFontUrl,
   collectBrandPassthrough,
+  collectDeclaredProperties,
   fontStack,
   generateDarkCss,
   generateFontSizeDecls,
@@ -14,6 +15,7 @@ import {
   generateIntentDecls,
   generateLightCss,
   generatePrimitivesCss,
+  generateSemanticAliasDecls,
   generateShadeScale,
   generateSpaceAliasDecls,
   generateTextScaleAliasDecls,
@@ -23,7 +25,7 @@ import {
   resolveThemeBrand,
   resolveThemeFonts,
   sectionComment
-} from "../chunk-JDYLDGUN.js";
+} from "../chunk-L5DQDEZV.js";
 
 // src/adapters/brand-passthrough.ts
 var SENTINEL_COLOR = "#ff00ff";
@@ -301,14 +303,27 @@ ${inner.split("\n").map((l) => `  ${l}`).join("\n")}
     }
     semanticLines.push("");
   }
+  const lightBody = stripHeader(generateLightCss(input.tokens, { scopePrefix, colorScheme }));
+  const darkBody = stripHeader(generateDarkCss(input.tokens, { scopePrefix, colorScheme }));
+  const adaptiveBody = [lightBody, darkBody].filter(Boolean).join("\n\n");
+  if (scopePrefix) {
+    const declared = collectDeclaredProperties(
+      [primitivesBody, semanticLines.join("\n"), adaptiveBody].join("\n")
+    );
+    const aliasDecls = generateSemanticAliasDecls(declared);
+    if (aliasDecls.length > 0) {
+      semanticLines.push(
+        sectionComment("visor-core alias re-substitution at theme scope (VI-648)")
+      );
+      semanticLines.push(block(hostSelector, aliasDecls));
+      semanticLines.push("");
+    }
+  }
   const semanticLayer = wrapInLayer("visor-semantic", semanticLines.join("\n").trim());
   if (semanticLayer) {
     lines.push(semanticLayer);
     lines.push("");
   }
-  const lightBody = stripHeader(generateLightCss(input.tokens, { scopePrefix, colorScheme }));
-  const darkBody = stripHeader(generateDarkCss(input.tokens, { scopePrefix, colorScheme }));
-  const adaptiveBody = [lightBody, darkBody].filter(Boolean).join("\n\n");
   lines.push(
     wrapInLayer("visor-adaptive", adaptiveBody)
   );

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

@@ -1260,9 +1260,23 @@ var TABS = "components/ui/tabs/tabs.module.css";
 var SKELETON = "components/ui/skeleton/skeleton.module.css";
 var SPINNER = "components/ui/spinner/spinner.module.css";
 var CHECKBOX = "components/ui/checkbox/checkbox.module.css";
+var INPUT = "components/ui/input/input.module.css";
+var TEXTAREA = "components/ui/textarea/textarea.module.css";
+var SELECT = "components/ui/select/select.module.css";
+var SWITCH = "components/ui/switch/switch.module.css";
+var TAG_INPUT = "components/ui/tag-input/tag-input.module.css";
+var FILE_UPLOAD = "components/ui/file-upload/file-upload.module.css";
+var BUTTON = "components/ui/button/button.module.css";
+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";
 function at(file, fallback) {
   return [{ file, fallback }];
 }
+function each(files, fallback) {
+  return files.map((file) => ({ file, fallback }));
+}
 var tableFamily = {
   family: "table",
   prefix: "table",
@@ -1343,7 +1357,12 @@ var chipFamily = {
   description: "Chip / filter-pill treatment. The retro found the same mono status chip at 8.5 / 9 / 9.5 / 10 / 11px with tracking .03\u2013.14em across nine implementations; this family is the single dial.",
   tokens: [
     { key: "radius", property: "border-radius", description: "Chip corner rounding.", consumers: at(CHIP, "var(--radius-full, 9999px)") },
-    { key: "border", property: "border", description: "Chip outline.", consumers: at(CHIP, "var(--stroke-width-thin, 1px) solid var(--border-default, #e5e7eb)") },
+    {
+      key: "border",
+      property: "outline-color (outlined variant, on ::after)",
+      description: "Outlined-chip edge colour. Width and style come from the shared `control` edge, so `control.edge-width: 0` turns it off.",
+      consumers: at(CHIP, "var(--control-edge-color, var(--border-default, #e5e7eb))")
+    },
     { key: "bg", property: "background-color", description: "Resting chip fill.", consumers: at(CHIP, "var(--surface-card, #ffffff)") },
     { key: "text-color", property: "color", description: "Chip label colour.", consumers: at(CHIP, "var(--text-primary, #111827)") },
     { key: "font-family", property: "font-family", description: "Chip label family \u2014 bind a mono face for token/ID chips.", consumers: at(CHIP, "var(--font-body, inherit)") },
@@ -1360,7 +1379,7 @@ var chipFamily = {
     { key: "lg-padding-x", property: "padding", description: "Large chip horizontal padding.", consumers: at(CHIP, "var(--spacing-4, 1rem)") },
     { key: "lg-font-size", property: "font-size", description: "Large chip type size.", consumers: at(CHIP, "var(--font-size-base, 1rem)") },
     { key: "selected-bg", property: "background-color", description: "Selected chip fill.", consumers: at(CHIP, "var(--surface-accent-subtle, #eff6ff)") },
-    { key: "selected-border-color", property: "border-color", description: "Selected chip outline colour.", consumers: at(CHIP, "var(--surface-accent-default, #3b82f6)") },
+    { key: "selected-border-color", property: "outline-color (on ::after)", description: "Selected chip edge colour.", consumers: at(CHIP, "var(--surface-accent-default, #3b82f6)") },
     { key: "selected-text-color", property: "color", description: "Selected chip label colour.", consumers: at(CHIP, "var(--text-link, #2563eb)") }
   ]
 };
@@ -1458,7 +1477,12 @@ var emptyStateFamily = {
     { key: "gap", property: "gap", description: "Placard stack rhythm.", consumers: at(EMPTY_STATE, "var(--spacing-2, 0.5rem)") },
     { key: "padding", property: "padding", description: "Default-size placard inset.", consumers: at(EMPTY_STATE, "var(--spacing-8, 2rem) var(--spacing-5, 1.25rem)") },
     { key: "bg", property: "background-color", description: "Default-tone fill.", consumers: at(EMPTY_STATE, "var(--surface-muted, #f9fafb)") },
-    { key: "border", property: "border", description: "Default-tone frame (dashed by default).", consumers: at(EMPTY_STATE, "1px dashed var(--border-default, #e5e7eb)") },
+    {
+      key: "border",
+      property: "outline-color",
+      description: "Default-tone dashed-edge colour. Width and style come from the shared `control` drop edge, so `control.edge-width: 0` turns it off.",
+      consumers: at(EMPTY_STATE, "var(--control-edge-color, var(--border-default, #e5e7eb))")
+    },
     { key: "icon-size", property: "width / height", description: "Icon-chip diameter.", consumers: at(EMPTY_STATE, "72px") },
     { key: "icon-radius", property: "border-radius", description: "Icon-chip rounding.", consumers: at(EMPTY_STATE, "var(--radius-full, 9999px)") },
     { key: "icon-bg", property: "background-color", description: "Icon-chip fill.", consumers: at(EMPTY_STATE, "var(--surface-subtle, #f5f5f6)") },
@@ -1606,9 +1630,238 @@ var checkboxFamily = {
     { key: "size", property: "width / height", description: "Checkbox box size.", consumers: at(CHECKBOX, "1rem") },
     { key: "radius", property: "border-radius", description: "Checkbox corner rounding \u2014 square it for the editorial admin look.", consumers: at(CHECKBOX, "var(--radius-sm, 0.25rem)") },
     { key: "bg", property: "background-color", description: "Unchecked fill.", consumers: at(CHECKBOX, "transparent") },
-    { key: "border", property: "border", description: "Unchecked outline.", consumers: at(CHECKBOX, "1px solid var(--border-default, #e5e7eb)") },
+    {
+      key: "border",
+      property: "outline-color",
+      description: "Unchecked edge colour. Width and style come from the shared `control` edge, so `control.edge-width: 0` turns it off.",
+      consumers: at(CHECKBOX, "var(--control-edge-color, var(--border-default, #e5e7eb))")
+    },
+    {
+      key: "edgeless-bg",
+      property: "background-image",
+      description: "Unchecked fill shown only while the shared edge is off (`control.edge-width: 0`), so the box still reads as a control.",
+      consumers: at(CHECKBOX, "var(--control-edge-color, var(--border-default, #e5e7eb))")
+    },
     { key: "bg-checked", property: "background-color", description: "Checked fill.", consumers: at(CHECKBOX, "var(--interactive-primary-bg, var(--primary, #111827))") },
-    { key: "border-checked", property: "border-color", description: "Checked outline colour.", consumers: at(CHECKBOX, "var(--interactive-primary-bg, var(--primary, #111827))") }
+    { key: "border-checked", property: "outline-color", description: "Checked edge colour.", consumers: at(CHECKBOX, "var(--interactive-primary-bg, var(--primary, #111827))") }
+  ]
+};
+var EDGE_CONTROLS = [INPUT, TEXTAREA, SELECT, CHECKBOX, SWITCH, TAG_INPUT, BUTTON];
+var controlFamily = {
+  family: "control",
+  prefix: "control",
+  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.",
+  tokens: [
+    {
+      key: "edge-width",
+      property: "outline-width",
+      description: "THE switch. Resting-edge weight for every form control; `0` turns every resting edge off.",
+      consumers: [
+        ...each(EDGE_CONTROLS, "1px"),
+        { file: CHIP, fallback: "var(--stroke-width-thin, 1px)" },
+        { file: FILE_UPLOAD, fallback: "1px" },
+        { file: EMPTY_STATE, fallback: "1px" }
+      ]
+    },
+    {
+      key: "edge-color",
+      property: "outline-color",
+      description: "Resting-edge colour. A component's own `--<component>-border` override still wins over it.",
+      consumers: each([INPUT, TEXTAREA, SELECT, CHECKBOX, TAG_INPUT, CHIP, FILE_UPLOAD, EMPTY_STATE, BUTTON], "var(--border-default, #e5e7eb)")
+    },
+    {
+      key: "edge-style",
+      property: "outline-style",
+      description: "Resting-edge style for solid edges.",
+      consumers: each([...EDGE_CONTROLS, CHIP], "solid")
+    },
+    {
+      key: "drop-edge-width",
+      property: "outline-width",
+      description: "Dashed-edge weight (file-upload draws it at 2\xD7). Follows `edge-width` unless set \u2014 set it alone to keep dashed edges while solid edges are off.",
+      consumers: each([FILE_UPLOAD, EMPTY_STATE], "var(--control-edge-width, 1px)")
+    },
+    {
+      key: "drop-edge-style",
+      property: "outline-style",
+      description: "Dashed-edge style for drop targets and empty states.",
+      consumers: each([FILE_UPLOAD, EMPTY_STATE], "dashed")
+    },
+    {
+      key: "state-edge-width",
+      property: "outline-width",
+      description: "Focus and invalid edge weight. Independent of `edge-width`, so focus and invalid stay visible with edges off.",
+      consumers: each([INPUT, TEXTAREA, SELECT, CHECKBOX, SWITCH, TAG_INPUT], "1px")
+    }
+  ]
+};
+var fieldFamily = {
+  family: "field",
+  prefix: "field",
+  description: "Field label treatment \u2014 size, case, tracking and colour of `FieldLabel`, in both densities.",
+  tokens: [
+    {
+      key: "label-font-size",
+      property: "font-size",
+      description: "Label type size. Drives both the standard and editorial-density steps.",
+      consumers: [
+        { file: FIELD, fallback: "var(--font-size-sm, 0.875rem)" },
+        { file: FIELD, fallback: "13px" }
+      ]
+    },
+    { key: "label-text-transform", property: "text-transform", description: "Label casing.", consumers: at(FIELD, "revert-layer") },
+    { key: "label-letter-spacing", property: "letter-spacing", description: "Label tracking.", consumers: at(FIELD, "revert-layer") },
+    {
+      key: "label-color",
+      property: "color",
+      description: "Label colour. Drives both the standard and editorial-density steps.",
+      consumers: [
+        { file: FIELD, fallback: "var(--text-primary, currentColor)" },
+        { file: FIELD, fallback: "var(--text-secondary)" }
+      ]
+    }
+  ]
+};
+var BUTTON_SIZES = [
+  { size: "sm", fontSize: ["var(--font-size-xs, 0.75rem)", "0.8125rem"], radius: "var(--radius-md, 0.375rem)" },
+  { size: "md", fontSize: ["var(--font-size-sm, 0.875rem)"], radius: "var(--radius-md, 0.375rem)" },
+  { size: "lg", fontSize: ["var(--font-size-base, 1rem)"], radius: "var(--radius-md, 0.375rem)" },
+  { size: "dlg", fontSize: ["var(--font-size-2xs, 0.6875rem)"], radius: "var(--radius-lg, 0.5rem)" }
+];
+var buttonFamily = {
+  family: "button",
+  prefix: "button",
+  description: "Button type treatment and rounding. The unprefixed keys set every size at once; a size key (`dlg-radius`) overrides one size.",
+  tokens: [
+    {
+      key: "text-transform",
+      property: "text-transform",
+      description: "Casing for every size.",
+      consumers: BUTTON_SIZES.map(() => ({ file: BUTTON, fallback: "revert-layer" }))
+    },
+    {
+      key: "letter-spacing",
+      property: "letter-spacing",
+      description: "Tracking for every size.",
+      consumers: BUTTON_SIZES.map(() => ({ file: BUTTON, fallback: "revert-layer" }))
+    },
+    {
+      key: "radius",
+      property: "border-radius",
+      description: "Corner rounding for every size (`999px` for a pill).",
+      consumers: [
+        ...BUTTON_SIZES.map(({ radius }) => ({ file: BUTTON, fallback: radius })),
+        { file: BUTTON, fallback: "var(--radius-md, 0.375rem)" }
+      ]
+    },
+    ...BUTTON_SIZES.flatMap(({ size, fontSize, radius }) => [
+      {
+        key: `${size}-font-size`,
+        property: "font-size",
+        description: fontSize.length > 1 ? `\`${size}\` type size. Drives both the standard and editorial-density steps.` : `\`${size}\` type size.`,
+        consumers: fontSize.map((fallback) => ({ file: BUTTON, fallback }))
+      },
+      {
+        key: `${size}-text-transform`,
+        property: "text-transform",
+        description: `\`${size}\` casing.`,
+        consumers: at(BUTTON, "var(--button-text-transform, revert-layer)")
+      },
+      {
+        key: `${size}-letter-spacing`,
+        property: "letter-spacing",
+        description: `\`${size}\` tracking.`,
+        consumers: at(BUTTON, "var(--button-letter-spacing, revert-layer)")
+      },
+      {
+        key: `${size}-radius`,
+        property: "border-radius",
+        description: `\`${size}\` corner rounding.`,
+        consumers: at(BUTTON, `var(--button-radius, ${radius})`)
+      }
+    ]),
+    // VI-659: the icon-only size. A square box of glyph + 2 × pad.
+    // VI-658: InlineEdit's pencil is the same mark, so it reads the same size,
+    // pad and ink.
+    {
+      key: "icon-size",
+      property: "width / height / font-size",
+      description: 'Icon-only (`size="icon"`) glyph size. The square box is this plus `icon-pad` on every side. Also sizes the InlineEdit pencil and the SaveStatus retry mark.',
+      consumers: [...each(Array(5).fill(BUTTON), "1rem"), ...each(Array(3).fill(INLINE_EDIT), "1rem"), ...each(Array(3).fill(SAVE_STATUS), "1rem")]
+    },
+    {
+      key: "icon-pad",
+      property: "width / height",
+      description: "Icon-only hit-target pad around the glyph, on every side. Also the hit target of the InlineEdit pencil and the SaveStatus retry mark.",
+      consumers: [...each([BUTTON, BUTTON], "var(--spacing-2, 0.5rem)"), ...at(INLINE_EDIT, "var(--spacing-2, 0.5rem)"), ...at(SAVE_STATUS, "var(--spacing-2, 0.5rem)")]
+    },
+    {
+      key: "icon-radius",
+      property: "border-radius",
+      description: "Icon-only corner rounding (`999px` for a round mark).",
+      consumers: at(BUTTON, "var(--button-radius, var(--radius-md, 0.375rem))")
+    },
+    {
+      key: "icon-ghost-color",
+      property: "color",
+      description: "Icon-only ghost ink at rest. Hover comes up to `--text-primary`. Also the ink of the InlineEdit pencil and the SaveStatus retry mark.",
+      consumers: [...at(BUTTON, "var(--text-secondary, #6b7280)"), ...at(INLINE_EDIT, "var(--text-secondary, #6b7280)"), ...at(SAVE_STATUS, "var(--text-secondary, #6b7280)")]
+    }
+  ]
+};
+var TEXT_SIZES = [
+  { size: "xs", fontSize: "var(--font-size-xs, 0.75rem)" },
+  { size: "sm", fontSize: "var(--font-size-sm, 0.875rem)" },
+  { size: "md", fontSize: "var(--font-size-base, 1rem)" },
+  { size: "lg", fontSize: "var(--font-size-lg, 1.125rem)" },
+  { size: "xl", fontSize: "var(--font-size-xl, 1.25rem)" }
+];
+var textFamily = {
+  family: "text",
+  prefix: "text",
+  description: "Text type treatment, per size \u2014 set `sm-font-size: 13px` for a 13px step, or caps and tracking on `xs` for a state tag. Every key begins with a size.",
+  tokens: TEXT_SIZES.flatMap(({ size, fontSize }) => [
+    { key: `${size}-font-size`, property: "font-size", description: `\`${size}\` type size.`, consumers: at(TEXT, fontSize) },
+    { key: `${size}-text-transform`, property: "text-transform", description: `\`${size}\` casing.`, consumers: at(TEXT, "revert-layer") },
+    { key: `${size}-letter-spacing`, property: "letter-spacing", description: `\`${size}\` tracking.`, consumers: at(TEXT, "revert-layer") }
+  ])
+};
+var switchFamily = {
+  family: "switch",
+  prefix: "switch",
+  description: 'Switch track and knob dimensions (default size; `size="sm"` keeps its own). Set `knob-inset` to size the knob from the track: it sits that far from the track\'s outer edge on every side.',
+  tokens: [
+    { key: "track-width", property: "width", description: "Track width.", consumers: at(SWITCH, "2rem") },
+    {
+      key: "track-height",
+      property: "height",
+      description: "Track height. With `knob-inset` set, the knob is the track height less the inset on both sides.",
+      consumers: at(SWITCH, "1.15rem")
+    },
+    {
+      key: "knob-inset",
+      property: "width / height / transform (knob)",
+      description: "Gap between the knob and the track's outer edge, on every side. Unset, the knob keeps its shipped 1rem size and position.",
+      consumers: at(SWITCH, null)
+    },
+    { key: "track-bg", property: "background-color", description: "Unchecked track fill.", consumers: at(SWITCH, "var(--border-default, #e5e7eb)") },
+    {
+      key: "edge-color",
+      property: "outline-color",
+      description: "Track edge colour \u2014 transparent by default. Width and style come from the shared `control` edge, so `control.edge-width: 0` turns it off.",
+      consumers: at(SWITCH, "transparent")
+    }
+  ]
+};
+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.",
+  tokens: [
+    { key: "width", property: "width", description: "Slot width. Fixed, so the row never reflows between states.", consumers: at(SAVE_STATUS, "7.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 adminUiFamily = {
@@ -1639,6 +1892,12 @@ var COMPONENT_TOKEN_FAMILIES = [
   skeletonFamily,
   spinnerFamily,
   checkboxFamily,
+  controlFamily,
+  fieldFamily,
+  buttonFamily,
+  textFamily,
+  switchFamily,
+  saveStatusFamily,
   adminUiFamily
 ];
 var COMPONENT_TOKEN_FAMILY_BY_NAME = new Map(
@@ -2484,6 +2743,86 @@ function generateFullBundleCss(primitives, tokens, config) {
   return lines.join("\n");
 }
 
+// src/semantic-aliases.ts
+var VISOR_CORE_SEMANTIC_ALIASES = {
+  // Border — the one entry the engine's own `SemanticTokens.border` set lacks.
+  "border-input": "color-neutral-200",
+  // Component + layout spacing (4px grid multiples).
+  "component-xs": "spacing-1",
+  "component-sm": "spacing-2",
+  "component-md": "spacing-4",
+  "component-lg": "spacing-6",
+  "component-xl": "spacing-8",
+  "layout-sm": "spacing-4",
+  "layout-md": "spacing-8",
+  "layout-lg": "spacing-12",
+  "layout-xl": "spacing-16",
+  "layout-2xl": "spacing-24",
+  "layout-section-padding": "spacing-24",
+  "layout-section-padding-mobile": "spacing-16",
+  // Typography size roles — track the theme's `typography.scale` ramp.
+  "size-body": "font-size-base",
+  "size-body-sm": "font-size-sm",
+  "size-label": "font-size-sm",
+  "size-caption": "font-size-xs",
+  "size-heading-sm": "font-size-lg",
+  "size-heading-md": "font-size-xl",
+  "size-heading-lg": "font-size-2xl",
+  "size-heading-xl": "font-size-3xl",
+  // Typography weight roles — `--weight-heading` is the token VI-648 was filed on.
+  "weight-body": "font-weight-body",
+  "weight-label": "font-weight-medium",
+  "weight-heading": "font-weight-heading",
+  "weight-strong": "font-weight-bold",
+  // Motion. `--motion-easing-spring` is absent because the engine emits it
+  // under its own name, so it is already correct on the scope.
+  "motion-duration-fast": "motion-duration-100",
+  "motion-duration-normal": "motion-duration-200",
+  "motion-duration-slow": "motion-duration-500",
+  "motion-easing-default": "motion-easing-ease-in-out",
+  "motion-easing-enter": "motion-easing-ease-out",
+  "motion-easing-exit": "motion-easing-ease-in",
+  // Skeleton shimmer. Resolves through *semantic* surfaces, not primitives —
+  // the engine emits those in `visor-adaptive`, a later layer, which does not
+  // affect substitution: `var()` reads the computed value on the element.
+  "skeleton-from": "surface-muted",
+  "skeleton-to": "surface-subtle",
+  // Chart series.
+  "chart-1": "color-primary-500",
+  "chart-2": "color-success-500",
+  "chart-3": "color-warning-500",
+  "chart-4": "color-info-500",
+  "chart-5": "color-error-500",
+  // Sidebar chrome.
+  "sidebar-bg": "color-neutral-50",
+  "sidebar-text": "color-neutral-700",
+  "sidebar-primary-bg": "color-primary-600",
+  "sidebar-primary-text": "color-white",
+  "sidebar-accent-bg": "color-neutral-100",
+  "sidebar-accent-text": "color-neutral-900",
+  "sidebar-border": "color-neutral-200",
+  "sidebar-ring": "color-primary-500",
+  "sidebar-text-muted": "color-neutral-500",
+  // Field-attached floating panels (VI-497).
+  "field-menu-bg": "surface-popover"
+};
+function collectDeclaredProperties(css) {
+  const declared = /* @__PURE__ */ new Set();
+  for (const match of css.matchAll(/(^|[{;\s])--([a-zA-Z0-9-]+)\s*:/g)) {
+    declared.add(match[2]);
+  }
+  return declared;
+}
+function generateSemanticAliasDecls(declared) {
+  const decls = [];
+  for (const [alias, referent] of Object.entries(VISOR_CORE_SEMANTIC_ALIASES)) {
+    if (declared.has(alias)) continue;
+    if (!declared.has(referent)) continue;
+    decls.push(`--${alias}: var(--${referent});`);
+  }
+  return decls;
+}
+
 // src/types.ts
 var MATERIAL_TEXT_SLOTS = [
   "displayLarge",
@@ -2577,5 +2916,8 @@ export {
   generateHairlineDecls,
   generateLightCss,
   generateDarkCss,
-  generateFullBundleCss
+  generateFullBundleCss,
+  VISOR_CORE_SEMANTIC_ALIASES,
+  collectDeclaredProperties,
+  generateSemanticAliasDecls
 };

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-BG-YT4JW.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-BG-YT4JW.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-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';
 
 /**
  * Font resolver — maps font family names to loadable font resources.
@@ -400,6 +400,14 @@ var properties = {
 		],
 		description: "Brand constraint declaring which color modes the theme supports. 'dark-only'/'light-only' lock the brand to a single mode; 'adaptive' supports both. Complements 'default-mode' (the runtime default) — 'color-scheme' is authoritative for the brand-lock. Defaults to 'adaptive' when omitted. Optional."
 	},
+	edges: {
+		type: "string",
+		"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."
+	},
 	colors: {
 		type: "object",
 		description: "Color definitions for light mode. Only primary is required — all others have sensible defaults.",
@@ -1123,7 +1131,14 @@ var properties = {
 			},
 			checkbox: {
 				type: "object",
-				description: "Control sizing — the D3 Tier-2 `--checkbox-size` / `-radius` / `-bg` / `-border` set, promoted from the admin-ui audit to a bindable contract. Keys: size, radius, bg, border, bg-checked, border-checked.",
+				description: "Control sizing — the D3 Tier-2 `--checkbox-size` / `-radius` / `-bg` / `-border` set, promoted from the admin-ui audit to a bindable contract. Keys: size, radius, bg, border, edgeless-bg, bg-checked, border-checked.",
+				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.",
 				additionalProperties: {
 					$ref: "#/$defs/componentTokenBinding"
 				}
@@ -1135,6 +1150,41 @@ var properties = {
 					$ref: "#/$defs/componentTokenBinding"
 				}
 			},
+			field: {
+				type: "object",
+				description: "Field label treatment — size, case, tracking and colour of `FieldLabel`, in both densities. Keys: label-font-size, label-text-transform, label-letter-spacing, label-color.",
+				additionalProperties: {
+					$ref: "#/$defs/componentTokenBinding"
+				}
+			},
+			button: {
+				type: "object",
+				description: "Button type treatment and rounding. The unprefixed keys set every size at once; a size key (`dlg-radius`) overrides one size. Keys: text-transform, letter-spacing, radius, sm-font-size, sm-text-transform, sm-letter-spacing, sm-radius, md-font-size, md-text-transform, md-letter-spacing, md-radius, lg-font-size, lg-text-transform, lg-letter-spacing, lg-radius, dlg-font-size, dlg-text-transform, dlg-letter-spacing, dlg-radius, icon-size, icon-pad, icon-radius, icon-ghost-color.",
+				additionalProperties: {
+					$ref: "#/$defs/componentTokenBinding"
+				}
+			},
+			text: {
+				type: "object",
+				description: "Text type treatment, per size — set `sm-font-size: 13px` for a 13px step, or caps and tracking on `xs` for a state tag. Every key begins with a size. Keys: xs-font-size, xs-text-transform, xs-letter-spacing, sm-font-size, sm-text-transform, sm-letter-spacing, md-font-size, md-text-transform, md-letter-spacing, lg-font-size, lg-text-transform, lg-letter-spacing, xl-font-size, xl-text-transform, xl-letter-spacing.",
+				additionalProperties: {
+					$ref: "#/$defs/componentTokenBinding"
+				}
+			},
+			"switch": {
+				type: "object",
+				description: "Switch track and knob dimensions (default size; `size=\"sm\"` keeps its own). Set `knob-inset` to size the knob from the track: it sits that far from the track's outer edge on every side. Keys: track-width, track-height, knob-inset, track-bg, edge-color.",
+				additionalProperties: {
+					$ref: "#/$defs/componentTokenBinding"
+				}
+			},
+			"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.",
+				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.",
@@ -1876,6 +1926,87 @@ declare const SEMANTIC_MAP: {
  */
 declare function getKnownTokenRefs(): Set<string>;
 
+/**
+ * visor-core semantic aliases that need re-substituting at a theme scope (VI-648).
+ *
+ * `packages/tokens` emits its semantic layer as indirections — `--chart-1:
+ * var(--color-primary-500)`, `--weight-heading: var(--font-weight-heading)` —
+ * declared on `:root`.
+ *
+ * Custom-property substitution resolves **where the property is declared**. On
+ * a `scopePrefix` theme (the VI-368 body-class repaint pattern that every
+ * Blacklight theme uses) the engine emits the theme's primitives on the scope
+ * selector, e.g. `body.blacklight-pro-theme`. From `:root`, a descendant's
+ * value is invisible, so `var(--color-primary-500)` sees only visor-core's
+ * untuned default. `body` then *inherits* the already-substituted default, and
+ * the alias silently ignores the theme:
+ *
+ * ```
+ * --font-weight-heading : 500   <- correct, emitted by the engine on the scope
+ * --weight-heading      : 600   <- visor-core's :root default
+ * --chart-1             : #3b82f6   <- stock blue on a monochrome theme
+ * --skeleton-from       : #f3f4f6   <- light gray on a dark theme
+ * ```
+ *
+ * The engine independently resolves 66 of visor-core's 114 aliases to concrete
+ * values (`--text-*`, `--surface-*`, `--border-*`, `--interactive-*`, `--font-*`)
+ * and emits those on the scope already, so they are correct. The 48 below are
+ * the ones only visor-core knows how to derive. Re-declaring them on the scope
+ * selector makes the substitution happen there, against the theme's own
+ * primitives.
+ *
+ * ## Why this table lives in the engine, not in `packages/tokens`
+ *
+ * `packages/tokens` is the natural owner — these are its aliases. But
+ * `packages/tokens` already depends on this package (its build calls
+ * `generateThemeData` + `docsAdapter` to emit `dist/themes/<slug>.css`), so an
+ * engine → tokens import would be a build cycle. The table therefore sits on
+ * the importable side of that edge.
+ *
+ * It is not a hand-maintained copy. `packages/tokens` owns the authoring
+ * tables in `src/tokens/semantic.ts` and this list is asserted against the
+ * *emitted* `tokens.css` by `semantic-alias-coverage` — a stronger check than
+ * comparing two constants, because it compares against what actually ships.
+ * Adding an alias in `packages/tokens` without adding it here fails that test
+ * with the missing names.
+ */
+/**
+ * Alias name → the token it resolves through. Both written without the leading
+ * `--`. Order mirrors visor-core's emission order in `tokens.css`, which keeps
+ * a diff against that file readable.
+ */
+declare const VISOR_CORE_SEMANTIC_ALIASES: Readonly<Record<string, string>>;
+/**
+ * Every custom property declared anywhere in `css`, without the leading `--`.
+ *
+ * Read off the generated CSS rather than the token data so the filter in
+ * `generateSemanticAliasDecls` reflects what this theme *actually* emits —
+ * including conditional output such as the `--font-weight-<n>` ladder, which
+ * only appears when a theme declares an explicit `weights` array.
+ */
+declare function collectDeclaredProperties(css: string): Set<string>;
+/**
+ * The `--alias: var(--referent);` declarations to re-emit on a theme's scope
+ * selector, given everything the theme has emitted so far.
+ *
+ * Filtered on both sides, so the table can never make output worse:
+ *
+ * - **Skip an alias the theme already declares.** The theme's own value is
+ *   authoritative, and re-declaring it in `visor-semantic` would override a
+ *   `visor-primitives` declaration of the same name. `--font-body` is the live
+ *   case: the engine emits it as a concrete family, and re-aliasing it to
+ *   `var(--font-sans)` would win the layer contest and resolve to nothing.
+ * - **Skip an alias whose referent the theme does not declare.** There is then
+ *   nothing to re-resolve against, and inheriting visor-core's `:root` value is
+ *   the correct outcome — re-emitting would replace a working value with an
+ *   invalid one.
+ *
+ * Returns `[]` for a `:root`-scoped theme's caller, which does not need this at
+ * all: there, visor-core's aliases and the theme's primitives are declared on
+ * the same element, so substitution already sees the theme's values.
+ */
+declare function generateSemanticAliasDecls(declared: ReadonlySet<string>): string[];
+
 /**
  * Per-theme font-family aliasing — substrate fix for VI-354.
  *
@@ -2126,4 +2257,4 @@ declare function cleanFontValue(val: string): string;
  */
 declare function extractFromCSS(files: CSSFile[], name?: string): ExtractionResult;
 
-export { type BrandPassthrough, BrandResolution, BrandSlot, BrandSource, BrandStrategy, BrandStrategyContext, BrandStrategyIssue, BrandStrategyValidationResult, type CSSFile, ColorRole, type Confidence, DEFAULT_VISOR_BRAND, type ExtractedToken, type ExtractionResult, FONT_WEIGHT_ALIASES, type FontCoverageError, type FontCoverageResult, FontDisplayStrategy, type FontFaceDeclaration, FontResolution, FontResolveOptions, FullShadeScale, GeneratedPrimitives, GoogleFontEntry, OKLCH, ParsedColor, RGB, ResolvedThemeConfig, type ResolvedWeightRamp, SEMANTIC_MAP, SelectiveShadeScale, SemanticTokens, SerializedBrandStrategy, ShadeStep, TAILWIND_GRAY, ThemeBrandResult, ThemeData, ThemeFontResult, ThemeOutput, type ThemeValidationResult, VISOR_BRANDS_CDN, VISOR_DEFAULT_BRAND_PATH, VISOR_FONTS_CDN, type ValidateOptions, type ValidationIssue, type ValidationSeverity, VisorBrand, VisorThemeConfig, VisorTypography, WEIGHT_RAMP_TARGETS, applyOverrides, assignSemanticTokens, buildVisorBrandUrl, buildVisorFontUrl, checkBrandStrategyCoherence, checkBrandStrategyStructure, clampToSrgb, cleanFontValue, collectBrandPassthrough, compositeOverBackground, declaresWeights, exportTheme, extractFromCSS, formatFontCoverageError, generateDarkCss, generateFontWeightDecls, generateFullBundleCss, generateLightCss, generatePreloadLinks, generatePrimitives, generatePrimitivesCss, generateSemanticCss, generateShadeScale, generateStylesheetLinks, generateTheme, generateThemeData, generateThemeDataFromConfig, generateThemeFromConfig, getContrastRatio, getKnownTokenRefs, getLuminance, googleFontsCatalog, hasBrandPassthrough, hexToOklch, hexToRgb, isValidColor, isValidHex, isVisorThemeConfig, loadedWeights, lookupFontWeightAlias, lookupGoogleFont, matchLoadedWeight, normalizeHex, oklchToHex, parseCSSDeclarations, parseColor, parseConfig, parseFontFaceDeclarations, parseHex, parseHsla, parseOklch, parseRgba, resolveBrandSlot, resolveBrandSource, resolveConfig, resolveFont, resolveRoleWeight, resolveThemeBrand, resolveThemeFonts, resolveWeightRamp, rgbToHex, serializeBrandStrategy, serializeColor, validate, validateBrandStrategy, validateConfig, validateFontCoverage, visorTheme_schema as visorThemeSchema };
+export { type BrandPassthrough, BrandResolution, BrandSlot, BrandSource, BrandStrategy, BrandStrategyContext, BrandStrategyIssue, BrandStrategyValidationResult, type CSSFile, ColorRole, type Confidence, DEFAULT_VISOR_BRAND, type ExtractedToken, type ExtractionResult, FONT_WEIGHT_ALIASES, type FontCoverageError, type FontCoverageResult, FontDisplayStrategy, type FontFaceDeclaration, FontResolution, FontResolveOptions, FullShadeScale, GeneratedPrimitives, GoogleFontEntry, OKLCH, ParsedColor, RGB, ResolvedThemeConfig, type ResolvedWeightRamp, SEMANTIC_MAP, SelectiveShadeScale, SemanticTokens, SerializedBrandStrategy, ShadeStep, TAILWIND_GRAY, ThemeBrandResult, ThemeData, ThemeFontResult, ThemeOutput, type ThemeValidationResult, VISOR_BRANDS_CDN, VISOR_CORE_SEMANTIC_ALIASES, VISOR_DEFAULT_BRAND_PATH, VISOR_FONTS_CDN, type ValidateOptions, type ValidationIssue, type ValidationSeverity, VisorBrand, VisorThemeConfig, VisorTypography, WEIGHT_RAMP_TARGETS, applyOverrides, assignSemanticTokens, buildVisorBrandUrl, buildVisorFontUrl, checkBrandStrategyCoherence, checkBrandStrategyStructure, clampToSrgb, cleanFontValue, collectBrandPassthrough, collectDeclaredProperties, compositeOverBackground, declaresWeights, exportTheme, extractFromCSS, formatFontCoverageError, generateDarkCss, generateFontWeightDecls, generateFullBundleCss, generateLightCss, generatePreloadLinks, generatePrimitives, generatePrimitivesCss, generateSemanticAliasDecls, generateSemanticCss, generateShadeScale, generateStylesheetLinks, generateTheme, generateThemeData, generateThemeDataFromConfig, generateThemeFromConfig, getContrastRatio, getKnownTokenRefs, getLuminance, googleFontsCatalog, hasBrandPassthrough, hexToOklch, hexToRgb, isValidColor, isValidHex, isVisorThemeConfig, loadedWeights, lookupFontWeightAlias, lookupGoogleFont, matchLoadedWeight, normalizeHex, oklchToHex, parseCSSDeclarations, parseColor, parseConfig, parseFontFaceDeclarations, parseHex, parseHsla, parseOklch, parseRgba, resolveBrandSlot, resolveBrandSource, resolveConfig, resolveFont, resolveRoleWeight, resolveThemeBrand, resolveThemeFonts, resolveWeightRamp, rgbToHex, serializeBrandStrategy, serializeColor, validate, validateBrandStrategy, validateConfig, validateFontCoverage, visorTheme_schema as visorThemeSchema };

package/dist/index.js

@@ -7,6 +7,7 @@ import {
   MATERIAL_TEXT_SLOTS,
   TAILWIND_GRAY,
   VISOR_BRANDS_CDN,
+  VISOR_CORE_SEMANTIC_ALIASES,
   VISOR_DEFAULT_BRAND_PATH,
   VISOR_FONTS_CDN,
   WEIGHT_RAMP_TARGETS,
@@ -16,6 +17,7 @@ import {
   buildVisorFontUrl,
   clampToSrgb,
   collectBrandPassthrough,
+  collectDeclaredProperties,
   componentTokenName,
   compositeOverBackground,
   declaresWeights,
@@ -25,6 +27,7 @@ import {
   generateLightCss,
   generatePreloadLinks,
   generatePrimitivesCss,
+  generateSemanticAliasDecls,
   generateSemanticCss,
   generateShadeScale,
   generateStylesheetLinks,
@@ -60,7 +63,7 @@ import {
   rgbToOklch,
   serializeColor,
   validateComponentBindings
-} from "./chunk-JDYLDGUN.js";
+} from "./chunk-L5DQDEZV.js";
 
 // src/fonts/validate-coverage.ts
 var FONT_VAR_RE = /--font-(heading|display|body|sans|mono)\s*:\s*([^;]+);/g;
@@ -647,6 +650,11 @@ var visor_theme_schema_default = {
       enum: ["dark-only", "light-only", "adaptive"],
       description: "Brand constraint declaring which color modes the theme supports. 'dark-only'/'light-only' lock the brand to a single mode; 'adaptive' supports both. Complements 'default-mode' (the runtime default) \u2014 'color-scheme' is authoritative for the brand-lock. Defaults to 'adaptive' when omitted. Optional."
     },
+    edges: {
+      type: "string",
+      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.`
+    },
     colors: {
       type: "object",
       description: "Color definitions for light mode. Only primary is required \u2014 all others have sensible defaults.",
@@ -1162,7 +1170,14 @@ var visor_theme_schema_default = {
         },
         checkbox: {
           type: "object",
-          description: "Control sizing \u2014 the D3 Tier-2 `--checkbox-size` / `-radius` / `-bg` / `-border` set, promoted from the admin-ui audit to a bindable contract. Keys: size, radius, bg, border, bg-checked, border-checked.",
+          description: "Control sizing \u2014 the D3 Tier-2 `--checkbox-size` / `-radius` / `-bg` / `-border` set, promoted from the admin-ui audit to a bindable contract. Keys: size, radius, bg, border, edgeless-bg, bg-checked, border-checked.",
+          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.",
           additionalProperties: {
             $ref: "#/$defs/componentTokenBinding"
           }
@@ -1174,6 +1189,41 @@ var visor_theme_schema_default = {
             $ref: "#/$defs/componentTokenBinding"
           }
         },
+        field: {
+          type: "object",
+          description: "Field label treatment \u2014 size, case, tracking and colour of `FieldLabel`, in both densities. Keys: label-font-size, label-text-transform, label-letter-spacing, label-color.",
+          additionalProperties: {
+            $ref: "#/$defs/componentTokenBinding"
+          }
+        },
+        button: {
+          type: "object",
+          description: "Button type treatment and rounding. The unprefixed keys set every size at once; a size key (`dlg-radius`) overrides one size. Keys: text-transform, letter-spacing, radius, sm-font-size, sm-text-transform, sm-letter-spacing, sm-radius, md-font-size, md-text-transform, md-letter-spacing, md-radius, lg-font-size, lg-text-transform, lg-letter-spacing, lg-radius, dlg-font-size, dlg-text-transform, dlg-letter-spacing, dlg-radius, icon-size, icon-pad, icon-radius, icon-ghost-color.",
+          additionalProperties: {
+            $ref: "#/$defs/componentTokenBinding"
+          }
+        },
+        text: {
+          type: "object",
+          description: "Text type treatment, per size \u2014 set `sm-font-size: 13px` for a 13px step, or caps and tracking on `xs` for a state tag. Every key begins with a size. Keys: xs-font-size, xs-text-transform, xs-letter-spacing, sm-font-size, sm-text-transform, sm-letter-spacing, md-font-size, md-text-transform, md-letter-spacing, lg-font-size, lg-text-transform, lg-letter-spacing, xl-font-size, xl-text-transform, xl-letter-spacing.",
+          additionalProperties: {
+            $ref: "#/$defs/componentTokenBinding"
+          }
+        },
+        switch: {
+          type: "object",
+          description: 'Switch track and knob dimensions (default size; `size="sm"` keeps its own). Set `knob-inset` to size the knob from the track: it sits that far from the track\'s outer edge on every side. Keys: track-width, track-height, knob-inset, track-bg, edge-color.',
+          additionalProperties: {
+            $ref: "#/$defs/componentTokenBinding"
+          }
+        },
+        "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.",
+          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.",
@@ -1458,7 +1508,8 @@ var KNOWN_TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
   "strokeWidths",
   "motion",
   "overrides",
-  "components"
+  "components",
+  "edges"
 ]);
 var KNOWN_COLOR_KEYS = /* @__PURE__ */ new Set([
   "primary",
@@ -1737,6 +1788,9 @@ function validateConfig(config) {
       errors.push("'color-scheme' must be one of: dark-only, light-only, adaptive");
     }
   }
+  if (obj.edges !== void 0 && obj.edges !== "on" && obj.edges !== "off") {
+    errors.push("'edges' 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 };
@@ -2117,7 +2171,12 @@ function resolveConfig(config) {
     overrides: config.overrides,
     // VI-625: component bindings pass through untouched — the contract in
     // component-tokens.ts owns their shape, there is nothing to default.
-    components: config.components,
+    // 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" ? {
+      ...config.components,
+      control: { "edge-width": "0", ...config.components?.control }
+    } : config.components,
     originalColors,
     colorFormats
   };
@@ -4262,6 +4321,7 @@ export {
   SEMANTIC_MAP,
   TAILWIND_GRAY,
   VISOR_BRANDS_CDN,
+  VISOR_CORE_SEMANTIC_ALIASES,
   VISOR_DEFAULT_BRAND_PATH,
   VISOR_FONTS_CDN,
   WEIGHT_RAMP_TARGETS,
@@ -4275,6 +4335,7 @@ export {
   clampToSrgb,
   cleanFontValue,
   collectBrandPassthrough,
+  collectDeclaredProperties,
   componentTokenName,
   compositeOverBackground,
   declaresWeights,
@@ -4288,6 +4349,7 @@ export {
   generatePreloadLinks,
   generatePrimitives,
   generatePrimitivesCss,
+  generateSemanticAliasDecls,
   generateSemanticCss,
   generateShadeScale,
   generateStylesheetLinks,

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

@@ -830,6 +830,14 @@ interface VisorThemeConfig {
      * did before the contract existed.
      */
     components?: ComponentTokenBindings;
+    /**
+     * VI-655: the one switch for form-control edges. `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. It is
+     * shorthand for `components.control.edge-width: "0"`, and an explicit
+     * `components.control.edge-width` wins over it. Default: `on`.
+     */
+    edges?: "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.20.0",
+  "version": "0.22.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

@@ -34,6 +34,11 @@
       "enum": ["dark-only", "light-only", "adaptive"],
       "description": "Brand constraint declaring which color modes the theme supports. 'dark-only'/'light-only' lock the brand to a single mode; 'adaptive' supports both. Complements 'default-mode' (the runtime default) — 'color-scheme' is authoritative for the brand-lock. Defaults to 'adaptive' when omitted. Optional."
     },
+    "edges": {
+      "type": "string",
+      "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."
+    },
     "colors": {
       "type": "object",
       "description": "Color definitions for light mode. Only primary is required — all others have sensible defaults.",
@@ -549,7 +554,14 @@
         },
         "checkbox": {
           "type": "object",
-          "description": "Control sizing — the D3 Tier-2 `--checkbox-size` / `-radius` / `-bg` / `-border` set, promoted from the admin-ui audit to a bindable contract. Keys: size, radius, bg, border, bg-checked, border-checked.",
+          "description": "Control sizing — the D3 Tier-2 `--checkbox-size` / `-radius` / `-bg` / `-border` set, promoted from the admin-ui audit to a bindable contract. Keys: size, radius, bg, border, edgeless-bg, bg-checked, border-checked.",
+          "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.",
           "additionalProperties": {
             "$ref": "#/$defs/componentTokenBinding"
           }
@@ -561,6 +573,41 @@
             "$ref": "#/$defs/componentTokenBinding"
           }
         },
+        "field": {
+          "type": "object",
+          "description": "Field label treatment — size, case, tracking and colour of `FieldLabel`, in both densities. Keys: label-font-size, label-text-transform, label-letter-spacing, label-color.",
+          "additionalProperties": {
+            "$ref": "#/$defs/componentTokenBinding"
+          }
+        },
+        "button": {
+          "type": "object",
+          "description": "Button type treatment and rounding. The unprefixed keys set every size at once; a size key (`dlg-radius`) overrides one size. Keys: text-transform, letter-spacing, radius, sm-font-size, sm-text-transform, sm-letter-spacing, sm-radius, md-font-size, md-text-transform, md-letter-spacing, md-radius, lg-font-size, lg-text-transform, lg-letter-spacing, lg-radius, dlg-font-size, dlg-text-transform, dlg-letter-spacing, dlg-radius, icon-size, icon-pad, icon-radius, icon-ghost-color.",
+          "additionalProperties": {
+            "$ref": "#/$defs/componentTokenBinding"
+          }
+        },
+        "text": {
+          "type": "object",
+          "description": "Text type treatment, per size — set `sm-font-size: 13px` for a 13px step, or caps and tracking on `xs` for a state tag. Every key begins with a size. Keys: xs-font-size, xs-text-transform, xs-letter-spacing, sm-font-size, sm-text-transform, sm-letter-spacing, md-font-size, md-text-transform, md-letter-spacing, lg-font-size, lg-text-transform, lg-letter-spacing, xl-font-size, xl-text-transform, xl-letter-spacing.",
+          "additionalProperties": {
+            "$ref": "#/$defs/componentTokenBinding"
+          }
+        },
+        "switch": {
+          "type": "object",
+          "description": "Switch track and knob dimensions (default size; `size=\"sm\"` keeps its own). Set `knob-inset` to size the knob from the track: it sits that far from the track's outer edge on every side. Keys: track-width, track-height, knob-inset, track-bg, edge-color.",
+          "additionalProperties": {
+            "$ref": "#/$defs/componentTokenBinding"
+          }
+        },
+        "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.",
+          "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.",