@loworbitstudio/visor-theme-engine 0.25.0 → 0.29.0

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-ZPTjTL_-.js';
-export { u as BRAND_VARIANTS, v as BRAND_VISIBILITIES, w as BrandAccessibility, x as BrandArchetype, y as BrandBoilerplate, z as BrandColorPairing, A as BrandColorUsage, D as BrandContrastTarget, E as BrandGoverns, H as BrandLexiconEntry, I as BrandMessaging, J as BrandPersonalityTrait, K as BrandPillar, L as BrandPositioning, M as BrandStrategyIssueSeverity, N as BrandToneEntry, Q as BrandVariant, U as BrandVisibility, W as BrandVoice, X as BrandVoiceTrait, Y as COMPONENT_TOKEN_FAMILIES, Z as COMPONENT_TOKEN_FAMILY_BY_NAME, _ as ColorFormat, $ as ComponentTokenBinding, a0 as ComponentTokenBindings, a1 as ComponentTokenConsumer, a2 as ComponentTokenFamily, a3 as ComponentTokenSpec, a4 as DEFAULT_BRAND_STRATEGY_SURFACES, a5 as DEFAULT_BRAND_STRATEGY_TONE_STATES, a6 as FontSource, a7 as GOVERNS_WILDCARD, a8 as RGBA, a9 as ResolvedComponentTokens, aa as SemanticTokenValue, ab as allComponentTokenNames, ac as componentTokenName, ad as hasComponentBindings, ae as resolveComponentBindings, af as validateComponentBindings } from './types-ZPTjTL_-.js';
+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-C7nWZ5fB.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-C7nWZ5fB.js';
 
 /**
  * Font resolver — maps font family names to loadable font resources.
@@ -527,6 +527,16 @@ var properties = {
 					org: {
 						type: "string",
 						description: "Organization namespace for visor-fonts CDN (required when source is visor-fonts)."
+					},
+					"text-transform": {
+						type: "string",
+						"enum": [
+							"none",
+							"uppercase",
+							"lowercase",
+							"capitalize"
+						],
+						description: "Casing applied to this slot's text via --font-heading-text-transform. Emitted only when set."
 					}
 				}
 			},
@@ -557,6 +567,16 @@ var properties = {
 					org: {
 						type: "string",
 						description: "Organization namespace for visor-fonts CDN (required when source is visor-fonts)."
+					},
+					"text-transform": {
+						type: "string",
+						"enum": [
+							"none",
+							"uppercase",
+							"lowercase",
+							"capitalize"
+						],
+						description: "Casing applied to this slot's text via --font-display-text-transform. Emitted only when set."
 					}
 				}
 			},
@@ -586,6 +606,16 @@ var properties = {
 					org: {
 						type: "string",
 						description: "Organization namespace for visor-fonts CDN (required when source is visor-fonts)."
+					},
+					"text-transform": {
+						type: "string",
+						"enum": [
+							"none",
+							"uppercase",
+							"lowercase",
+							"capitalize"
+						],
+						description: "Casing applied to this slot's text via --font-body-text-transform. Emitted only when set."
 					}
 				}
 			},
@@ -596,6 +626,16 @@ var properties = {
 					family: {
 						type: "string",
 						description: "Google Fonts family name or CSS font stack for monospace."
+					},
+					"text-transform": {
+						type: "string",
+						"enum": [
+							"none",
+							"uppercase",
+							"lowercase",
+							"capitalize"
+						],
+						description: "Casing applied to this slot's text via --font-mono-text-transform. Emitted only when set."
 					}
 				}
 			},
@@ -1144,6 +1184,34 @@ var properties = {
 					$ref: "#/$defs/componentTokenBinding"
 				}
 			},
+			input: {
+				type: "object",
+				description: "Input shape at the default `md` size. Each key falls back to the matching `--input-*-md` variable, so a scope that sets one still applies while the key is unbound; a bound key wins. Keys: md-height, md-padding, md-radius.",
+				additionalProperties: {
+					$ref: "#/$defs/componentTokenBinding"
+				}
+			},
+			textarea: {
+				type: "object",
+				description: "Textarea shape at the default `md` size. Keys: padding, radius.",
+				additionalProperties: {
+					$ref: "#/$defs/componentTokenBinding"
+				}
+			},
+			select: {
+				type: "object",
+				description: "Select trigger shape at the default `md` size. Keys: height, padding, radius.",
+				additionalProperties: {
+					$ref: "#/$defs/componentTokenBinding"
+				}
+			},
+			"tag-input": {
+				type: "object",
+				description: "TagInput — the field around the tags, each held tag, and the opt-in typing slot (`entryAs=\"slot\"`). The slot follows the tag's shape unless its own keys are set. Keys: min-height, padding, radius, tag-height, tag-padding-x, tag-font-size, tag-font-weight, tag-radius, slot-height, slot-padding-x, slot-radius, slot-min-width.",
+				additionalProperties: {
+					$ref: "#/$defs/componentTokenBinding"
+				}
+			},
 			hairline: {
 				type: "object",
 				description: "The one switch for hairlines (VI-680). Every hairline rule, divider and ring reads its weight from `--hairline-width`, so `width: 0` removes them all at once. Independent of the `control` edge switch. Keys: width.",
@@ -1153,7 +1221,7 @@ var properties = {
 			},
 			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.",
+				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, invalid-ring-width, invalid-halo-width.",
 				additionalProperties: {
 					$ref: "#/$defs/componentTokenBinding"
 				}
@@ -1174,7 +1242,7 @@ var properties = {
 			},
 			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.",
+				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, font-weight, radius, sm-font-size, sm-font-weight, sm-text-transform, sm-letter-spacing, sm-radius, md-font-size, md-font-weight, md-text-transform, md-letter-spacing, md-radius, lg-font-size, lg-font-weight, lg-text-transform, lg-letter-spacing, lg-radius, dlg-font-size, dlg-font-weight, dlg-text-transform, dlg-letter-spacing, dlg-radius, icon-size, icon-pad, icon-radius, icon-ghost-color.",
 				additionalProperties: {
 					$ref: "#/$defs/componentTokenBinding"
 				}
@@ -1188,14 +1256,21 @@ var properties = {
 			},
 			"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.",
+				description: "Switch track and knob dimensions (default size; `size=\"sm\"` keeps its own) and colours. 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, track-hover-bg, track-hover-bg-checked, knob-bg, knob-bg-checked.",
 				additionalProperties: {
 					$ref: "#/$defs/componentTokenBinding"
 				}
 			},
 			"save-status": {
 				type: "object",
-				description: "SaveStatus readout — the fixed-width slot, its type, the Syncing ink and the Unsaved dot, so the readout never reflows its row. Keys: width, syncing-color, dot-size, font-family, text-transform, letter-spacing.",
+				description: "SaveStatus readout — the fixed-width slot, its type, the Syncing ink and the Unsaved dot, so the readout never reflows its row. Keys: width, syncing-color, font-size, dot-size, unsaved-dot-size, font-family, text-transform, letter-spacing.",
+				additionalProperties: {
+					$ref: "#/$defs/componentTokenBinding"
+				}
+			},
+			"segmented-control": {
+				type: "object",
+				description: "SegmentedControl — the well, its corner radius, the sliding pill, the ink and the state edge on it. The resting edge is the shared `control` edge. Keys: track-bg, radius, indicator-bg, indicator-text, indicator-edge, inactive-text, active-weight.",
 				additionalProperties: {
 					$ref: "#/$defs/componentTokenBinding"
 				}
@@ -1214,6 +1289,20 @@ var properties = {
 					$ref: "#/$defs/componentTokenBinding"
 				}
 			},
+			"input-affix": {
+				type: "object",
+				description: "Input and NumberInput prefix and suffix: the gap between a fixed affix and the value, and the affix's ink. Keys: gap, color.",
+				additionalProperties: {
+					$ref: "#/$defs/componentTokenBinding"
+				}
+			},
+			separator: {
+				type: "object",
+				description: "Separator rule colour, bare or either side of a label. Keys: color.",
+				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.",
@@ -2005,6 +2094,25 @@ declare function getKnownTokenRefs(): Set<string>;
  * a diff against that file readable.
  */
 declare const VISOR_CORE_SEMANTIC_ALIASES: Readonly<Record<string, string>>;
+/**
+ * Aliases visor-core declares with a **different referent in dark mode**, mapped
+ * to that dark referent. `--sidebar-bg` is `var(--color-neutral-50)` on `:root`
+ * but `var(--color-neutral-900)` under `[data-theme="dark"]` and the
+ * prefers-color-scheme block.
+ *
+ * `VISOR_CORE_SEMANTIC_ALIASES` records the light referent. A theme scope
+ * re-declares these with the light referent on the host and with the dark one
+ * on its dark selectors (VI-696), so a scoped dark sidebar resolves to the
+ * theme's own `neutral-900`, not its near-white `neutral-50` (the VI-648 flat
+ * emission) nor visor-core's untuned default (the VI-695 skip).
+ *
+ * Pinned against the dark rules of the emitted `tokens.css` by
+ * `semantic-alias-coverage`: both the key set and every referent. A new
+ * mode-dependent alias, or a changed dark referent, fails there by name.
+ */
+declare const VISOR_CORE_DARK_SEMANTIC_ALIASES: Readonly<Record<string, string>>;
+/** The aliases in `VISOR_CORE_DARK_SEMANTIC_ALIASES`: the ones whose referent changes with the mode. */
+declare const MODE_DEPENDENT_SEMANTIC_ALIASES: ReadonlySet<string>;
 /**
  * Every custom property declared anywhere in `css`, without the leading `--`.
  *
@@ -2012,8 +2120,13 @@ declare const VISOR_CORE_SEMANTIC_ALIASES: Readonly<Record<string, string>>;
  * `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.
+ *
+ * `options.exclude` drops the rules whose selector is listed, for a caller that
+ * needs only what one mode's selector can see (VI-696).
  */
-declare function collectDeclaredProperties(css: string): Set<string>;
+declare function collectDeclaredProperties(css: string, options?: {
+    exclude?: readonly 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.
@@ -2030,11 +2143,20 @@ declare function collectDeclaredProperties(css: string): Set<string>;
  *   the correct outcome — re-emitting would replace a working value with an
  *   invalid one.
  *
+ * `options.skip` names aliases to leave inheriting visor-core's value.
+ *
+ * `options.table` swaps the alias → referent table. A dark selector passes
+ * `VISOR_CORE_DARK_SEMANTIC_ALIASES`, with `declared` read off only what that
+ * selector sees; a dark-only host passes `VISOR_CORE_SEMANTIC_ALIASES_DARK_HOST`.
+ *
  * 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[];
+declare function generateSemanticAliasDecls(declared: ReadonlySet<string>, options?: {
+    skip?: ReadonlySet<string>;
+    table?: Readonly<Record<string, string>>;
+}): string[];
 
 /**
  * Per-theme font-family aliasing — substrate fix for VI-354.
@@ -2286,4 +2408,36 @@ 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_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 };
+/**
+ * Vertical font metrics for centring a native <input>'s text (VI-684).
+ *
+ * A native input cannot be trimmed to its capital band without clipping
+ * descenders and accents, so its capitals sit wherever the font's line box puts
+ * them: half a line above the box centre plus (ascent - descent) / 2, each
+ * rounded to a whole px. That depends on the face, so input.module.css reads
+ * `--font-ascent` / `--font-descent` (unitless em ratios) to work out the
+ * padding that lands the baseline on the right pixel.
+ *
+ * The ratios are Chromium's own `fontBoundingBoxAscent` / `Descent` at 1000px
+ * (what its line layout rounds), measured once from the real faces by
+ * scripts/measure-font-metrics.mjs and committed here. Measuring at build time
+ * would put a network fetch and a font parser on every theme build.
+ *
+ * A face with no entry emits no tokens, and the input takes no nudge: it renders
+ * as it did before VI-684 (within about 1px of centre), never worse.
+ *
+ * `system-ui` is platform-dependent. The entry is what Chromium resolves on
+ * macOS (San Francisco). Windows and Linux resolve another face, so the nudge
+ * there is a best effort; override it with --font-ascent / --font-descent.
+ */
+interface FontVerticalMetrics {
+    /** Ascent as a fraction of the font size. */
+    ascent: number;
+    /** Descent as a fraction of the font size. */
+    descent: number;
+}
+declare const FONT_VERTICAL_METRICS: Record<string, FontVerticalMetrics>;
+/** The `--font-ascent` / `--font-descent` declarations for a body family, or none when the face is unmeasured. */
+declare function generateFontMetricDecls(family: string): string[];
+
+export { type BrandPassthrough, BrandResolution, BrandSlot, BrandSource, BrandStrategy, BrandStrategyContext, BrandStrategyIssue, BrandStrategyValidationResult, type CSSFile, ColorRole, type Confidence, DEFAULT_VISOR_BRAND, type ExtractedToken, type ExtractionResult, FONT_VERTICAL_METRICS, FONT_WEIGHT_ALIASES, type FontCoverageError, type FontCoverageResult, FontDisplayStrategy, type FontFaceDeclaration, FontResolution, FontResolveOptions, type FontVerticalMetrics, FullShadeScale, GeneratedPrimitives, GoogleFontEntry, MODE_DEPENDENT_SEMANTIC_ALIASES, 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_DARK_SEMANTIC_ALIASES, 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, generateFontMetricDecls, 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

@@ -3,10 +3,14 @@ import {
   COMPONENT_TOKEN_FAMILIES,
   COMPONENT_TOKEN_FAMILY_BY_NAME,
   DEFAULT_VISOR_BRAND,
+  FONT_VERTICAL_METRICS,
   FONT_WEIGHT_ALIASES,
   MATERIAL_TEXT_SLOTS,
+  MODE_DEPENDENT_SEMANTIC_ALIASES,
   TAILWIND_GRAY,
+  TEXT_TRANSFORMS,
   VISOR_BRANDS_CDN,
+  VISOR_CORE_DARK_SEMANTIC_ALIASES,
   VISOR_CORE_SEMANTIC_ALIASES,
   VISOR_DEFAULT_BRAND_PATH,
   VISOR_FONTS_CDN,
@@ -22,6 +26,7 @@ import {
   compositeOverBackground,
   declaresWeights,
   generateDarkCss,
+  generateFontMetricDecls,
   generateFontWeightDecls,
   generateFullBundleCss,
   generateLightCss,
@@ -63,7 +68,7 @@ import {
   rgbToOklch,
   serializeColor,
   validateComponentBindings
-} from "./chunk-C2DUPZVY.js";
+} from "./chunk-YMCDUC7N.js";
 
 // src/fonts/validate-coverage.ts
 var FONT_VAR_RE = /--font-(heading|display|body|sans|mono)\s*:\s*([^;]+);/g;
@@ -747,6 +752,11 @@ var visor_theme_schema_default = {
             org: {
               type: "string",
               description: "Organization namespace for visor-fonts CDN (required when source is visor-fonts)."
+            },
+            "text-transform": {
+              type: "string",
+              enum: ["none", "uppercase", "lowercase", "capitalize"],
+              description: "Casing applied to this slot's text via --font-heading-text-transform. Emitted only when set."
             }
           }
         },
@@ -773,6 +783,11 @@ var visor_theme_schema_default = {
             org: {
               type: "string",
               description: "Organization namespace for visor-fonts CDN (required when source is visor-fonts)."
+            },
+            "text-transform": {
+              type: "string",
+              enum: ["none", "uppercase", "lowercase", "capitalize"],
+              description: "Casing applied to this slot's text via --font-display-text-transform. Emitted only when set."
             }
           }
         },
@@ -798,6 +813,11 @@ var visor_theme_schema_default = {
             org: {
               type: "string",
               description: "Organization namespace for visor-fonts CDN (required when source is visor-fonts)."
+            },
+            "text-transform": {
+              type: "string",
+              enum: ["none", "uppercase", "lowercase", "capitalize"],
+              description: "Casing applied to this slot's text via --font-body-text-transform. Emitted only when set."
             }
           }
         },
@@ -808,6 +828,11 @@ var visor_theme_schema_default = {
             family: {
               type: "string",
               description: "Google Fonts family name or CSS font stack for monospace."
+            },
+            "text-transform": {
+              type: "string",
+              enum: ["none", "uppercase", "lowercase", "capitalize"],
+              description: "Casing applied to this slot's text via --font-mono-text-transform. Emitted only when set."
             }
           }
         },
@@ -1180,6 +1205,34 @@ var visor_theme_schema_default = {
             $ref: "#/$defs/componentTokenBinding"
           }
         },
+        input: {
+          type: "object",
+          description: "Input shape at the default `md` size. Each key falls back to the matching `--input-*-md` variable, so a scope that sets one still applies while the key is unbound; a bound key wins. Keys: md-height, md-padding, md-radius.",
+          additionalProperties: {
+            $ref: "#/$defs/componentTokenBinding"
+          }
+        },
+        textarea: {
+          type: "object",
+          description: "Textarea shape at the default `md` size. Keys: padding, radius.",
+          additionalProperties: {
+            $ref: "#/$defs/componentTokenBinding"
+          }
+        },
+        select: {
+          type: "object",
+          description: "Select trigger shape at the default `md` size. Keys: height, padding, radius.",
+          additionalProperties: {
+            $ref: "#/$defs/componentTokenBinding"
+          }
+        },
+        "tag-input": {
+          type: "object",
+          description: 'TagInput \u2014 the field around the tags, each held tag, and the opt-in typing slot (`entryAs="slot"`). The slot follows the tag\'s shape unless its own keys are set. Keys: min-height, padding, radius, tag-height, tag-padding-x, tag-font-size, tag-font-weight, tag-radius, slot-height, slot-padding-x, slot-radius, slot-min-width.',
+          additionalProperties: {
+            $ref: "#/$defs/componentTokenBinding"
+          }
+        },
         hairline: {
           type: "object",
           description: "The one switch for hairlines (VI-680). Every hairline rule, divider and ring reads its weight from `--hairline-width`, so `width: 0` removes them all at once. Independent of the `control` edge switch. Keys: width.",
@@ -1189,7 +1242,7 @@ var visor_theme_schema_default = {
         },
         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.",
+          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, invalid-ring-width, invalid-halo-width.",
           additionalProperties: {
             $ref: "#/$defs/componentTokenBinding"
           }
@@ -1210,7 +1263,7 @@ var visor_theme_schema_default = {
         },
         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.",
+          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, font-weight, radius, sm-font-size, sm-font-weight, sm-text-transform, sm-letter-spacing, sm-radius, md-font-size, md-font-weight, md-text-transform, md-letter-spacing, md-radius, lg-font-size, lg-font-weight, lg-text-transform, lg-letter-spacing, lg-radius, dlg-font-size, dlg-font-weight, dlg-text-transform, dlg-letter-spacing, dlg-radius, icon-size, icon-pad, icon-radius, icon-ghost-color.",
           additionalProperties: {
             $ref: "#/$defs/componentTokenBinding"
           }
@@ -1224,14 +1277,21 @@ var visor_theme_schema_default = {
         },
         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.',
+          description: 'Switch track and knob dimensions (default size; `size="sm"` keeps its own) and colours. 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, track-hover-bg, track-hover-bg-checked, knob-bg, knob-bg-checked.',
           additionalProperties: {
             $ref: "#/$defs/componentTokenBinding"
           }
         },
         "save-status": {
           type: "object",
-          description: "SaveStatus readout \u2014 the fixed-width slot, its type, the Syncing ink and the Unsaved dot, so the readout never reflows its row. Keys: width, syncing-color, dot-size, font-family, text-transform, letter-spacing.",
+          description: "SaveStatus readout \u2014 the fixed-width slot, its type, the Syncing ink and the Unsaved dot, so the readout never reflows its row. Keys: width, syncing-color, font-size, dot-size, unsaved-dot-size, font-family, text-transform, letter-spacing.",
+          additionalProperties: {
+            $ref: "#/$defs/componentTokenBinding"
+          }
+        },
+        "segmented-control": {
+          type: "object",
+          description: "SegmentedControl \u2014 the well, its corner radius, the sliding pill, the ink and the state edge on it. The resting edge is the shared `control` edge. Keys: track-bg, radius, indicator-bg, indicator-text, indicator-edge, inactive-text, active-weight.",
           additionalProperties: {
             $ref: "#/$defs/componentTokenBinding"
           }
@@ -1250,6 +1310,20 @@ var visor_theme_schema_default = {
             $ref: "#/$defs/componentTokenBinding"
           }
         },
+        "input-affix": {
+          type: "object",
+          description: "Input and NumberInput prefix and suffix: the gap between a fixed affix and the value, and the affix's ink. Keys: gap, color.",
+          additionalProperties: {
+            $ref: "#/$defs/componentTokenBinding"
+          }
+        },
+        separator: {
+          type: "object",
+          description: "Separator rule colour, bare or either side of a label. Keys: color.",
+          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.",
@@ -1564,8 +1638,8 @@ var KNOWN_TYPOGRAPHY_KEYS = /* @__PURE__ */ new Set([
   "text-on-dark"
 ]);
 var KNOWN_CDN_OVERRIDE_KEYS = /* @__PURE__ */ new Set(["visor-fonts"]);
-var KNOWN_TYPOGRAPHY_FONT_KEYS = /* @__PURE__ */ new Set(["family", "weight", "weights", "source", "org"]);
-var KNOWN_TYPOGRAPHY_MONO_KEYS = /* @__PURE__ */ new Set(["family", "weight", "weights", "source", "org"]);
+var KNOWN_TYPOGRAPHY_FONT_KEYS = /* @__PURE__ */ new Set(["family", "weight", "weights", "source", "org", "text-transform"]);
+var KNOWN_TYPOGRAPHY_MONO_KEYS = /* @__PURE__ */ new Set(["family", "weight", "weights", "source", "org", "text-transform"]);
 var KNOWN_LETTER_SPACING_KEYS = /* @__PURE__ */ new Set([
   "xl",
   "lg",
@@ -1882,6 +1956,12 @@ function validateConfig(config) {
       errors.push(`'typography.cdn-overrides.visor-fonts' must not be empty`);
     }
     const orgOptional = typeof visorFontsOverride === "string" && visorFontsOverride.length > 0;
+    for (const slot of ["heading", "display", "body", "mono"]) {
+      const tt = typo[slot]?.["text-transform"];
+      if (tt !== void 0 && !TEXT_TRANSFORMS.includes(tt)) {
+        errors.push(`'typography.${slot}.text-transform' must be one of: ${TEXT_TRANSFORMS.join(", ")}`);
+      }
+    }
     for (const slot of ["heading", "display", "body"]) {
       const font = typo[slot];
       if (font && font.source === "visor-fonts" && !orgOptional && !font.org) {
@@ -2136,6 +2216,7 @@ function resolveConfig(config) {
         weight: config.typography?.heading?.weight ?? DEFAULTS.typography.heading.weight,
         ...config.typography?.heading?.source && { source: config.typography.heading.source },
         ...config.typography?.heading?.org && { org: config.typography.heading.org },
+        ...config.typography?.heading?.["text-transform"] && { "text-transform": config.typography.heading["text-transform"] },
         ...config.typography?.heading?.weights && { weights: config.typography.heading.weights }
       },
       display: {
@@ -2143,6 +2224,7 @@ function resolveConfig(config) {
         weight: config.typography?.display?.weight ?? 400,
         ...config.typography?.display?.source && { source: config.typography.display.source },
         ...config.typography?.display?.org && { org: config.typography.display.org },
+        ...config.typography?.display?.["text-transform"] && { "text-transform": config.typography.display["text-transform"] },
         ...config.typography?.display?.weights && { weights: config.typography.display.weights }
       },
       body: {
@@ -2150,6 +2232,7 @@ function resolveConfig(config) {
         weight: config.typography?.body?.weight ?? DEFAULTS.typography.body.weight,
         ...config.typography?.body?.source && { source: config.typography.body.source },
         ...config.typography?.body?.org && { org: config.typography.body.org },
+        ...config.typography?.body?.["text-transform"] && { "text-transform": config.typography.body["text-transform"] },
         ...config.typography?.body?.weights && { weights: config.typography.body.weights }
       },
       mono: {
@@ -2157,7 +2240,8 @@ function resolveConfig(config) {
         ...config.typography?.mono?.weight && { weight: config.typography.mono.weight },
         ...config.typography?.mono?.weights && { weights: config.typography.mono.weights },
         ...config.typography?.mono?.source && { source: config.typography.mono.source },
-        ...config.typography?.mono?.org && { org: config.typography.mono.org }
+        ...config.typography?.mono?.org && { org: config.typography.mono.org },
+        ...config.typography?.mono?.["text-transform"] && { "text-transform": config.typography.mono["text-transform"] }
       },
       ...config.typography?.["cdn-overrides"] && {
         "cdn-overrides": config.typography["cdn-overrides"]
@@ -4353,11 +4437,14 @@ export {
   DEFAULT_BRAND_STRATEGY_SURFACES,
   DEFAULT_BRAND_STRATEGY_TONE_STATES,
   DEFAULT_VISOR_BRAND,
+  FONT_VERTICAL_METRICS,
   FONT_WEIGHT_ALIASES,
   GOVERNS_WILDCARD,
+  MODE_DEPENDENT_SEMANTIC_ALIASES,
   SEMANTIC_MAP,
   TAILWIND_GRAY,
   VISOR_BRANDS_CDN,
+  VISOR_CORE_DARK_SEMANTIC_ALIASES,
   VISOR_CORE_SEMANTIC_ALIASES,
   VISOR_DEFAULT_BRAND_PATH,
   VISOR_FONTS_CDN,
@@ -4380,6 +4467,7 @@ export {
   extractFromCSS,
   formatFontCoverageError,
   generateDarkCss,
+  generateFontMetricDecls,
   generateFontWeightDecls,
   generateFullBundleCss,
   generateLightCss,

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

@@ -603,6 +603,8 @@ declare function validateComponentBindings(bindings: unknown): string[];
  * Covers the full pipeline: .visor.yaml config → shade scales → semantic tokens → CSS output.
  */
 
+/** VI-687: casing a typography slot applies to its text. */
+type TextTransform = "none" | "uppercase" | "lowercase" | "capitalize";
 type ShadeStep = 50 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 | 950;
 type ColorRole = "primary" | "accent" | "neutral" | "success" | "warning" | "error" | "info";
 type FullShadeScale = Record<ShadeStep, string>;
@@ -707,6 +709,7 @@ interface VisorThemeConfig {
             weights?: number[];
             source?: FontSource;
             org?: string;
+            "text-transform"?: TextTransform;
         };
         display?: {
             family?: string;
@@ -714,6 +717,7 @@ interface VisorThemeConfig {
             weights?: number[];
             source?: FontSource;
             org?: string;
+            "text-transform"?: TextTransform;
         };
         body?: {
             family?: string;
@@ -721,6 +725,7 @@ interface VisorThemeConfig {
             weights?: number[];
             source?: FontSource;
             org?: string;
+            "text-transform"?: TextTransform;
         };
         mono?: {
             family?: string;
@@ -728,6 +733,7 @@ interface VisorThemeConfig {
             weights?: number[];
             source?: FontSource;
             org?: string;
+            "text-transform"?: TextTransform;
         };
         /**
          * VI-447: 6-tier letter-spacing ramp (`xl | lg | md | sm | xs | tight`).
@@ -912,6 +918,7 @@ interface ResolvedThemeConfig {
             weights?: number[];
             source?: FontSource;
             org?: string;
+            "text-transform"?: TextTransform;
         };
         display: {
             family: string;
@@ -919,6 +926,7 @@ interface ResolvedThemeConfig {
             weights?: number[];
             source?: FontSource;
             org?: string;
+            "text-transform"?: TextTransform;
         };
         body: {
             family: string;
@@ -926,6 +934,7 @@ interface ResolvedThemeConfig {
             weights?: number[];
             source?: FontSource;
             org?: string;
+            "text-transform"?: TextTransform;
         };
         mono: {
             family: string;
@@ -933,6 +942,7 @@ interface ResolvedThemeConfig {
             weights?: number[];
             source?: FontSource;
             org?: string;
+            "text-transform"?: TextTransform;
         };
         /**
          * Per-source CDN base URL overrides (e.g., `visor-fonts:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loworbitstudio/visor-theme-engine",
-  "version": "0.25.0",
+  "version": "0.29.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",