@loworbitstudio/visor-theme-engine 0.21.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

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

package/dist/{chunk-LY5LXQYE.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(

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.",

package/dist/index.js

@@ -63,7 +63,7 @@ import {
   rgbToOklch,
   serializeColor,
   validateComponentBindings
-} from "./chunk-LY5LXQYE.js";
+} from "./chunk-L5DQDEZV.js";
 
 // src/fonts/validate-coverage.ts
 var FONT_VAR_RE = /--font-(heading|display|body|sans|mono)\s*:\s*([^;]+);/g;
@@ -650,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.",
@@ -1165,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"
           }
@@ -1177,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.",
@@ -1461,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",
@@ -1740,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 };
@@ -2120,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
   };

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.21.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.",