@loworbitstudio/visor-theme-engine 0.28.0 → 0.30.0

package/dist/adapters/index.d.ts

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

package/dist/adapters/index.js

@@ -2,6 +2,8 @@ import {
   FULL_SHADE_STEPS,
   MATERIAL_TEXT_SLOTS,
   SELECTIVE_SHADE_STEPS,
+  VISOR_CORE_DARK_SEMANTIC_ALIASES,
+  VISOR_CORE_SEMANTIC_ALIASES_DARK_HOST,
   aliasFamily,
   block,
   buildVisorFontUrl,
@@ -11,6 +13,7 @@ import {
   generateDarkCss,
   generateFontMetricDecls,
   generateFontSizeDecls,
+  generateFontTextTransformDecls,
   generateFontWeightDecls,
   generateHairlineDecls,
   generateIntentDecls,
@@ -26,7 +29,7 @@ import {
   resolveThemeBrand,
   resolveThemeFonts,
   sectionComment
-} from "../chunk-X2SWJPM2.js";
+} from "../chunk-4CCJNJAS.js";
 
 // src/adapters/brand-passthrough.ts
 var SENTINEL_COLOR = "#ff00ff";
@@ -308,10 +311,11 @@ ${inner.split("\n").map((l) => `  ${l}`).join("\n")}
   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);
+    const themeCss = [primitivesBody, semanticLines.join("\n"), adaptiveBody].join("\n");
+    const declared = collectDeclaredProperties(themeCss);
+    const aliasDecls = generateSemanticAliasDecls(declared, {
+      table: colorScheme === "dark-only" ? VISOR_CORE_SEMANTIC_ALIASES_DARK_HOST : void 0
+    });
     if (aliasDecls.length > 0) {
       semanticLines.push(
         sectionComment("visor-core alias re-substitution at theme scope (VI-648)")
@@ -319,6 +323,27 @@ ${inner.split("\n").map((l) => `  ${l}`).join("\n")}
       semanticLines.push(block(hostSelector, aliasDecls));
       semanticLines.push("");
     }
+    if (colorScheme === "adaptive") {
+      const darkAliasDecls = generateSemanticAliasDecls(
+        collectDeclaredProperties(themeCss, { exclude: [lightModeSelector] }),
+        { table: VISOR_CORE_DARK_SEMANTIC_ALIASES }
+      );
+      if (darkAliasDecls.length > 0) {
+        semanticLines.push(
+          sectionComment("visor-core alias re-substitution (dark) \u2014 manual toggle (VI-696)")
+        );
+        semanticLines.push(block(darkSelectors.join(",\n"), darkAliasDecls));
+        semanticLines.push("");
+        semanticLines.push(
+          sectionComment("visor-core alias re-substitution (dark) \u2014 prefers-color-scheme (VI-696)")
+        );
+        const inner = block(prefersSelector, darkAliasDecls);
+        semanticLines.push(`@media (prefers-color-scheme: dark) {
+${inner.split("\n").map((l) => `  ${l}`).join("\n")}
+}`);
+        semanticLines.push("");
+      }
+    }
   }
   const semanticLayer = wrapInLayer("visor-semantic", semanticLines.join("\n").trim());
   if (semanticLayer) {
@@ -562,6 +587,7 @@ function generateTypographyDecls(config, aliases) {
   decls.push(...generateFontSizeDecls(config.typography.scale));
   decls.push(...generateFontMetricDecls(config.typography.body.family));
   decls.push(...generateFontWeightDecls(config.typography));
+  decls.push(...generateFontTextTransformDecls(config.typography));
   const lineHeights = {
     none: 1,
     tight: 1.25,
@@ -900,6 +926,33 @@ ${inner.split("\n").map((l) => `  ${l}`).join("\n")}
     },
     colorScheme
   );
+  const themeCss = [lines.join("\n"), semanticLines.join("\n"), componentTokensCss, brandResult.css, passthroughCss].join("\n");
+  const declared = collectDeclaredProperties(themeCss);
+  const aliasDecls = generateSemanticAliasDecls(declared, {
+    table: colorScheme === "dark-only" ? VISOR_CORE_SEMANTIC_ALIASES_DARK_HOST : void 0
+  });
+  if (aliasDecls.length > 0) {
+    semanticLines.push(sectionComment2("visor-core alias re-substitution at theme scope (VI-695)"));
+    semanticLines.push(block2(scopeClass, aliasDecls));
+    semanticLines.push("");
+  }
+  if (emitPrefers) {
+    const darkAliasDecls = generateSemanticAliasDecls(
+      collectDeclaredProperties(themeCss, { exclude: [lightSel] }),
+      { table: VISOR_CORE_DARK_SEMANTIC_ALIASES }
+    );
+    if (darkAliasDecls.length > 0) {
+      semanticLines.push(sectionComment2("visor-core alias re-substitution (dark) \u2014 manual toggle (VI-696)"));
+      semanticLines.push(block2(darkSel, darkAliasDecls));
+      semanticLines.push("");
+      semanticLines.push(sectionComment2("visor-core alias re-substitution (dark) \u2014 prefers-color-scheme (VI-696)"));
+      const inner = block2(`${scopeClass}:not(.light):not(.theme-light):not([data-theme="light"])`, darkAliasDecls);
+      semanticLines.push(`@media (prefers-color-scheme: dark) {
+${inner.split("\n").map((l) => `  ${l}`).join("\n")}
+}`);
+      semanticLines.push("");
+    }
+  }
   const adaptiveBody = [lines.join("\n").trim(), componentTokensCss].filter(Boolean).join("\n\n");
   const adaptiveLayer = wrapInLayer("visor-adaptive", adaptiveBody);
   const semanticLayer = wrapInLayer("visor-semantic", semanticLines.join("\n").trim());

package/dist/{chunk-X2SWJPM2.js → chunk-4CCJNJAS.js}

@@ -1262,6 +1262,7 @@ 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 SEPARATOR = "components/ui/separator/separator.module.css";
+var ALERT = "components/ui/alert/alert.module.css";
 var NUMBER_INPUT = "components/ui/number-input/number-input.module.css";
 var TEXTAREA = "components/ui/textarea/textarea.module.css";
 var SELECT = "components/ui/select/select.module.css";
@@ -1988,7 +1989,7 @@ var textFamily = {
 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.',
+  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.',
   tokens: [
     { key: "track-width", property: "width", description: "Track width.", consumers: at(SWITCH, "2rem") },
     {
@@ -2009,6 +2010,30 @@ var switchFamily = {
       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")
+    },
+    {
+      key: "track-hover-bg",
+      property: "background-color (hover)",
+      description: "Unchecked track fill under the pointer. Bind it in a borderless theme, where `--border-strong` is transparent.",
+      consumers: at(SWITCH, "var(--border-strong, #d1d5db)")
+    },
+    {
+      key: "track-hover-bg-checked",
+      property: "background-color (hover)",
+      description: "Checked track fill under the pointer. Unbound it is `--border-strong`, as it always was; bind it to keep the checked fill under the pointer.",
+      consumers: at(SWITCH, "var(--border-strong, #d1d5db)")
+    },
+    {
+      key: "knob-bg",
+      property: "background-color (knob)",
+      description: "Unchecked knob fill. Bind it in a dark theme, where the page colour is a black knob on a dark track.",
+      consumers: at(SWITCH, "var(--surface-page, #ffffff)")
+    },
+    {
+      key: "knob-bg-checked",
+      property: "background-color (knob)",
+      description: "Checked knob fill. Independent of `knob-bg`, so a light unchecked knob can sit beside a dark knob on a bright checked track.",
+      consumers: at(SWITCH, "var(--surface-page, #ffffff)")
     }
   ]
 };
@@ -2102,6 +2127,20 @@ var separatorFamily = {
     }
   ]
 };
+var alertFamily = {
+  family: "alert",
+  prefix: "alert",
+  description: "Alert's soft appearance: the inline alert under a control or in a dialog \u2014 icon size, inset, gap, rounding and type.",
+  tokens: [
+    { key: "icon-size", property: "width / height / min-height", description: "Soft icon size for the destructive, warning and success tones; the content is at least this tall.", consumers: at(ALERT, "2rem") },
+    { key: "icon-size-note", property: "width / height / min-height", description: "Soft icon size for the neutral note (`default` and `info`).", consumers: at(ALERT, "1.5rem") },
+    { key: "soft-padding", property: "padding", description: "Soft alert inset.", consumers: at(ALERT, "var(--spacing-3, 0.75rem) calc(var(--spacing-3, 0.75rem) + var(--spacing-1, 0.25rem) / 2)") },
+    { key: "gap", property: "gap", description: "Gap between the soft icon and its text.", consumers: at(ALERT, "var(--spacing-3, 0.75rem)") },
+    { key: "radius", property: "border-radius", description: "Soft alert corner rounding.", consumers: at(ALERT, "var(--radius-lg, 0.5rem)") },
+    { key: "font-size", property: "font-size", description: "Soft alert type size.", consumers: at(ALERT, "var(--font-size-sm, 0.875rem)") },
+    { key: "lead-font-weight", property: "font-weight", description: "Weight of the inline `AlertLead` sentence.", consumers: at(ALERT, "var(--font-weight-bold, 700)") }
+  ]
+};
 var HAIRLINE_PX = [
   "components/ui/bulk-action-bar/bulk-action-bar.module.css",
   "components/ui/dialog/dialog.module.css",
@@ -2208,6 +2247,7 @@ var COMPONENT_TOKEN_FAMILIES = [
   actionRowFamily,
   inputAffixFamily,
   separatorFamily,
+  alertFamily,
   adminUiFamily
 ];
 var COMPONENT_TOKEN_FAMILY_BY_NAME = new Map(
@@ -2720,6 +2760,14 @@ function generateFontSizeDecls(scale) {
     return `--font-size-${name}: ${rem}rem; /* ${Number(scaled.toFixed(2))}px */`;
   });
 }
+function generateFontTextTransformDecls(typography) {
+  const decls = [];
+  for (const slot of ["heading", "display", "body", "mono"]) {
+    const value = typography[slot]["text-transform"];
+    if (value) decls.push(`--font-${slot}-text-transform: ${value};`);
+  }
+  return decls;
+}
 function generateTypographyPrimitives(config, aliases = EMPTY_ALIASES) {
   const decls = [];
   decls.push(`--font-heading: ${fontStack(config.typography.heading.family, aliases)};`);
@@ -2730,6 +2778,7 @@ function generateTypographyPrimitives(config, aliases = EMPTY_ALIASES) {
   decls.push(...generateFontSizeDecls(config.typography.scale));
   decls.push(...generateFontMetricDecls(config.typography.body.family));
   decls.push(...generateFontWeightDecls(config.typography));
+  decls.push(...generateFontTextTransformDecls(config.typography));
   const lineHeights = {
     none: 1,
     tight: 1.25,
@@ -3134,16 +3183,46 @@ var VISOR_CORE_SEMANTIC_ALIASES = {
   // Field-attached floating panels (VI-497).
   "field-menu-bg": "surface-popover"
 };
-function collectDeclaredProperties(css) {
+var VISOR_CORE_DARK_SEMANTIC_ALIASES = {
+  "border-input": "color-neutral-700",
+  "skeleton-from": "color-neutral-800",
+  "skeleton-to": "color-neutral-700",
+  "chart-1": "color-primary-400",
+  "sidebar-bg": "color-neutral-900",
+  "sidebar-text": "color-neutral-300",
+  "sidebar-primary-bg": "color-primary-500",
+  "sidebar-accent-bg": "color-neutral-800",
+  "sidebar-accent-text": "color-neutral-50",
+  "sidebar-border": "color-neutral-700",
+  "sidebar-ring": "color-primary-400",
+  "sidebar-text-muted": "color-neutral-400"
+};
+var MODE_DEPENDENT_SEMANTIC_ALIASES = new Set(
+  Object.keys(VISOR_CORE_DARK_SEMANTIC_ALIASES)
+);
+var VISOR_CORE_SEMANTIC_ALIASES_DARK_HOST = {
+  ...VISOR_CORE_SEMANTIC_ALIASES,
+  ...VISOR_CORE_DARK_SEMANTIC_ALIASES
+};
+function collectDeclaredProperties(css, options = {}) {
   const declared = /* @__PURE__ */ new Set();
-  for (const match of css.matchAll(/(^|[{;\s])--([a-zA-Z0-9-]+)\s*:/g)) {
-    declared.add(match[2]);
+  if (!options.exclude?.length) {
+    for (const match of css.matchAll(/(^|[{;\s])--([a-zA-Z0-9-]+)\s*:/g)) {
+      declared.add(match[2]);
+    }
+    return declared;
+  }
+  const exclude = new Set(options.exclude);
+  for (const rule of css.replace(/\/\*[\s\S]*?\*\//g, "").matchAll(/([^{}]*)\{([^{}]*)\}/g)) {
+    if (exclude.has(rule[1].trim())) continue;
+    for (const prop of collectDeclaredProperties(rule[2])) declared.add(prop);
   }
   return declared;
 }
-function generateSemanticAliasDecls(declared) {
+function generateSemanticAliasDecls(declared, options = {}) {
   const decls = [];
-  for (const [alias, referent] of Object.entries(VISOR_CORE_SEMANTIC_ALIASES)) {
+  for (const [alias, referent] of Object.entries(options.table ?? VISOR_CORE_SEMANTIC_ALIASES)) {
+    if (options.skip?.has(alias)) continue;
     if (declared.has(alias)) continue;
     if (!declared.has(referent)) continue;
     decls.push(`--${alias}: var(--${referent});`);
@@ -3152,6 +3231,7 @@ function generateSemanticAliasDecls(declared) {
 }
 
 // src/types.ts
+var TEXT_TRANSFORMS = ["none", "uppercase", "lowercase", "capitalize"];
 var MATERIAL_TEXT_SLOTS = [
   "displayLarge",
   "displayMedium",
@@ -3208,6 +3288,7 @@ export {
   isValidColor,
   compositeOverBackground,
   serializeColor,
+  TEXT_TRANSFORMS,
   MATERIAL_TEXT_SLOTS,
   componentTokenName,
   COMPONENT_TOKEN_FAMILIES,
@@ -3238,6 +3319,7 @@ export {
   sectionComment,
   block2 as block,
   generateFontSizeDecls,
+  generateFontTextTransformDecls,
   generatePrimitivesCss,
   generateSemanticCss,
   generateTextScaleAliasDecls,
@@ -3248,6 +3330,9 @@ export {
   generateDarkCss,
   generateFullBundleCss,
   VISOR_CORE_SEMANTIC_ALIASES,
+  VISOR_CORE_DARK_SEMANTIC_ALIASES,
+  MODE_DEPENDENT_SEMANTIC_ALIASES,
+  VISOR_CORE_SEMANTIC_ALIASES_DARK_HOST,
   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-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."
 					}
 				}
 			},
@@ -1216,7 +1256,7 @@ 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"
 				}
@@ -1263,6 +1303,13 @@ var properties = {
 					$ref: "#/$defs/componentTokenBinding"
 				}
 			},
+			alert: {
+				type: "object",
+				description: "Alert's soft appearance: the inline alert under a control or in a dialog — icon size, inset, gap, rounding and type. Keys: icon-size, icon-size-note, soft-padding, gap, radius, font-size, lead-font-weight.",
+				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.",
@@ -2054,6 +2101,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 `--`.
  *
@@ -2061,8 +2127,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.
@@ -2079,11 +2150,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.
@@ -2367,4 +2447,4 @@ 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, 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, 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 };
+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

@@ -6,8 +6,11 @@ import {
   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,
@@ -65,7 +68,7 @@ import {
   rgbToOklch,
   serializeColor,
   validateComponentBindings
-} from "./chunk-X2SWJPM2.js";
+} from "./chunk-4CCJNJAS.js";
 
 // src/fonts/validate-coverage.ts
 var FONT_VAR_RE = /--font-(heading|display|body|sans|mono)\s*:\s*([^;]+);/g;
@@ -749,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."
             }
           }
         },
@@ -775,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."
             }
           }
         },
@@ -800,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."
             }
           }
         },
@@ -810,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."
             }
           }
         },
@@ -1254,7 +1277,7 @@ 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"
           }
@@ -1301,6 +1324,13 @@ var visor_theme_schema_default = {
             $ref: "#/$defs/componentTokenBinding"
           }
         },
+        alert: {
+          type: "object",
+          description: "Alert's soft appearance: the inline alert under a control or in a dialog \u2014 icon size, inset, gap, rounding and type. Keys: icon-size, icon-size-note, soft-padding, gap, radius, font-size, lead-font-weight.",
+          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.",
@@ -1615,8 +1645,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",
@@ -1933,6 +1963,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) {
@@ -2187,6 +2223,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: {
@@ -2194,6 +2231,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: {
@@ -2201,6 +2239,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: {
@@ -2208,7 +2247,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"]
@@ -4407,9 +4447,11 @@ export {
   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,

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.28.0",
+  "version": "0.30.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

@@ -131,6 +131,11 @@
             "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."
             }
           }
         },
@@ -157,6 +162,11 @@
             "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."
             }
           }
         },
@@ -182,6 +192,11 @@
             "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."
             }
           }
         },
@@ -192,6 +207,11 @@
             "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."
             }
           }
         },
@@ -636,7 +656,7 @@
         },
         "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"
           }
@@ -683,6 +703,13 @@
             "$ref": "#/$defs/componentTokenBinding"
           }
         },
+        "alert": {
+          "type": "object",
+          "description": "Alert's soft appearance: the inline alert under a control or in a dialog — icon size, inset, gap, rounding and type. Keys: icon-size, icon-size-note, soft-padding, gap, radius, font-size, lead-font-weight.",
+          "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.",