@loworbitstudio/visor-theme-engine 0.1.0 → 0.4.1

package/dist/index.js

@@ -1,4 +1,5 @@
 import {
+  MATERIAL_TEXT_SLOTS,
   TAILWIND_GRAY,
   VISOR_FONTS_CDN,
   buildVisorFontUrl,
@@ -31,7 +32,7 @@ import {
   rgbToHex,
   rgbToOklch,
   serializeColor
-} from "./chunk-ZLXFCNYF.js";
+} from "./chunk-G4B57FB3.js";
 
 // src/pipeline.ts
 import { parse as parseYaml } from "yaml";
@@ -223,6 +224,29 @@ var visor_theme_schema_default = {
             normal: { type: "string" },
             wide: { type: "string" }
           }
+        },
+        slots: {
+          type: "object",
+          description: "Per-slot overrides for the generated Flutter Material TextTheme. Any subset of the 16 slots may be specified; omitted slots fall through to the Material 3 2024 defaults shipped in visor_core.",
+          additionalProperties: false,
+          properties: {
+            displayLarge: { $ref: "#/$defs/textSlotOverride" },
+            displayMedium: { $ref: "#/$defs/textSlotOverride" },
+            displaySmall: { $ref: "#/$defs/textSlotOverride" },
+            headlineLarge: { $ref: "#/$defs/textSlotOverride" },
+            headlineMedium: { $ref: "#/$defs/textSlotOverride" },
+            headlineSmall: { $ref: "#/$defs/textSlotOverride" },
+            titleLarge: { $ref: "#/$defs/textSlotOverride" },
+            titleMedium: { $ref: "#/$defs/textSlotOverride" },
+            titleSmall: { $ref: "#/$defs/textSlotOverride" },
+            bodyLarge: { $ref: "#/$defs/textSlotOverride" },
+            bodyMedium: { $ref: "#/$defs/textSlotOverride" },
+            bodySmall: { $ref: "#/$defs/textSlotOverride" },
+            labelLarge: { $ref: "#/$defs/textSlotOverride" },
+            labelMedium: { $ref: "#/$defs/textSlotOverride" },
+            labelSmall: { $ref: "#/$defs/textSlotOverride" },
+            labelXSmall: { $ref: "#/$defs/textSlotOverride" }
+          }
         }
       }
     },
@@ -262,6 +286,17 @@ var visor_theme_schema_default = {
         xl: { type: "string" }
       }
     },
+    strokeWidths: {
+      type: "object",
+      description: "Stroke-width scale in pixels \u2014 used for borders, outlines, dividers, progress-indicator strokes. Defaults: thin=1, regular=1.5, medium=2, thick=2.5.",
+      additionalProperties: false,
+      properties: {
+        thin: { type: "number", minimum: 0 },
+        regular: { type: "number", minimum: 0 },
+        medium: { type: "number", minimum: 0 },
+        thick: { type: "number", minimum: 0 }
+      }
+    },
     motion: {
       type: "object",
       description: "Motion/animation configuration.",
@@ -316,6 +351,28 @@ var visor_theme_schema_default = {
         { pattern: "^hsla?\\(" },
         { pattern: "^oklch\\(" }
       ]
+    },
+    textSlotOverride: {
+      type: "object",
+      description: "Per-slot override for one Material TextTheme entry.",
+      additionalProperties: false,
+      properties: {
+        size: {
+          type: "number",
+          exclusiveMinimum: 0,
+          description: "Font size in logical pixels (Flutter TextStyle.fontSize)."
+        },
+        weight: {
+          type: "integer",
+          minimum: 100,
+          maximum: 900,
+          description: "Font weight."
+        },
+        "letter-spacing": {
+          type: "number",
+          description: "Letter spacing in logical pixels (Flutter TextStyle.letterSpacing). Material defaults include negative values, e.g. -0.25 for displayLarge."
+        }
+      }
     }
   }
 };
@@ -325,12 +382,15 @@ var KNOWN_TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
   "name",
   "version",
   "group",
+  "label",
+  "default-mode",
   "colors",
   "colors-dark",
   "typography",
   "spacing",
   "radius",
   "shadows",
+  "strokeWidths",
   "motion",
   "overrides"
 ]);
@@ -351,14 +411,18 @@ var KNOWN_TYPOGRAPHY_KEYS = /* @__PURE__ */ new Set([
   "body",
   "mono",
   "letter-spacing",
-  "scale"
+  "scale",
+  "slots"
 ]);
-var KNOWN_TYPOGRAPHY_FONT_KEYS = /* @__PURE__ */ new Set(["family", "weight", "source", "org"]);
+var KNOWN_TYPOGRAPHY_FONT_KEYS = /* @__PURE__ */ new Set(["family", "weight", "weights", "source", "org"]);
 var KNOWN_TYPOGRAPHY_MONO_KEYS = /* @__PURE__ */ new Set(["family"]);
 var KNOWN_LETTER_SPACING_KEYS = /* @__PURE__ */ new Set(["tight", "normal", "wide"]);
+var KNOWN_SLOT_NAMES = new Set(MATERIAL_TEXT_SLOTS);
+var KNOWN_SLOT_OVERRIDE_KEYS = /* @__PURE__ */ new Set(["size", "weight", "letter-spacing"]);
 var KNOWN_SPACING_KEYS = /* @__PURE__ */ new Set(["base"]);
 var KNOWN_RADIUS_KEYS = /* @__PURE__ */ new Set(["sm", "md", "lg", "xl", "pill"]);
 var KNOWN_SHADOW_KEYS = /* @__PURE__ */ new Set(["xs", "sm", "md", "lg", "xl"]);
+var KNOWN_STROKE_WIDTH_KEYS = /* @__PURE__ */ new Set(["thin", "regular", "medium", "thick"]);
 var KNOWN_MOTION_KEYS = /* @__PURE__ */ new Set(["duration-fast", "duration-normal", "duration-slow", "easing"]);
 var KNOWN_OVERRIDES_KEYS = /* @__PURE__ */ new Set(["light", "dark"]);
 function checkUnknownKeys(obj, errors) {
@@ -423,6 +487,31 @@ function checkUnknownKeys(obj, errors) {
         }
       }
     }
+    if (typeof typo.slots === "object" && typo.slots !== null) {
+      const slots = typo.slots;
+      for (const slotName of Object.keys(slots)) {
+        if (!KNOWN_SLOT_NAMES.has(slotName)) {
+          errors.push(
+            `Unknown key 'typography.slots.${slotName}'. Valid keys: ${[...MATERIAL_TEXT_SLOTS].join(", ")}`
+          );
+          continue;
+        }
+        const override = slots[slotName];
+        if (typeof override !== "object" || override === null) {
+          errors.push(
+            `'typography.slots.${slotName}' must be an object with optional size/weight/letter-spacing fields`
+          );
+          continue;
+        }
+        for (const key of Object.keys(override)) {
+          if (!KNOWN_SLOT_OVERRIDE_KEYS.has(key)) {
+            errors.push(
+              `Unknown key 'typography.slots.${slotName}.${key}'. Valid keys: ${[...KNOWN_SLOT_OVERRIDE_KEYS].join(", ")}`
+            );
+          }
+        }
+      }
+    }
   }
   if (typeof obj.spacing === "object" && obj.spacing !== null) {
     for (const key of Object.keys(obj.spacing)) {
@@ -445,6 +534,13 @@ function checkUnknownKeys(obj, errors) {
       }
     }
   }
+  if (typeof obj.strokeWidths === "object" && obj.strokeWidths !== null) {
+    for (const key of Object.keys(obj.strokeWidths)) {
+      if (!KNOWN_STROKE_WIDTH_KEYS.has(key)) {
+        errors.push(`Unknown key 'strokeWidths.${key}'. Valid keys: ${[...KNOWN_STROKE_WIDTH_KEYS].join(", ")}`);
+      }
+    }
+  }
   if (typeof obj.motion === "object" && obj.motion !== null) {
     for (const key of Object.keys(obj.motion)) {
       if (!KNOWN_MOTION_KEYS.has(key)) {
@@ -473,6 +569,15 @@ function validateConfig(config) {
   if (obj.version !== 1) {
     errors.push("'version' must be 1");
   }
+  if (obj.label !== void 0 && typeof obj.label !== "string") {
+    errors.push("'label' must be a string (optional display name override)");
+  }
+  if (obj["default-mode"] !== void 0) {
+    const mode = obj["default-mode"];
+    if (mode !== "dark" && mode !== "light") {
+      errors.push("'default-mode' must be either 'dark' or 'light'");
+    }
+  }
   if (typeof obj.colors !== "object" || obj.colors === null) {
     errors.push("'colors' is required and must be an object");
     return { valid: false, errors };
@@ -530,6 +635,28 @@ function validateConfig(config) {
       if (font && font.source === "visor-fonts" && !font.org) {
         errors.push(`'typography.${slot}.org' is required when source is 'visor-fonts'`);
       }
+      if (font && font.weights !== void 0) {
+        if (!Array.isArray(font.weights) || !font.weights.every((w) => typeof w === "number" && w > 0)) {
+          errors.push(`'typography.${slot}.weights' must be an array of positive numbers (e.g., [300, 500])`);
+        }
+      }
+    }
+    if (typeof typo.slots === "object" && typo.slots !== null) {
+      const slots = typo.slots;
+      for (const slotName of Object.keys(slots)) {
+        const override = slots[slotName];
+        if (typeof override !== "object" || override === null) continue;
+        const o = override;
+        if (o.size !== void 0 && (typeof o.size !== "number" || o.size <= 0)) {
+          errors.push(`'typography.slots.${slotName}.size' must be a positive number (logical pixels)`);
+        }
+        if (o.weight !== void 0 && (typeof o.weight !== "number" || o.weight < 100 || o.weight > 900)) {
+          errors.push(`'typography.slots.${slotName}.weight' must be between 100 and 900`);
+        }
+        if (o["letter-spacing"] !== void 0 && typeof o["letter-spacing"] !== "number") {
+          errors.push(`'typography.slots.${slotName}.letter-spacing' must be a number (Flutter logical pixels)`);
+        }
+      }
     }
   }
   if (obj.overrides !== void 0) {
@@ -579,6 +706,12 @@ var DEFAULTS = {
     lg: "0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -4px rgba(0, 0, 0, 0.1)",
     xl: "0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 8px 10px -6px rgba(0, 0, 0, 0.1)"
   },
+  strokeWidths: {
+    thin: 1,
+    regular: 1.5,
+    medium: 2,
+    thick: 2.5
+  },
   motion: {
     "duration-fast": "100ms",
     "duration-normal": "200ms",
@@ -636,23 +769,27 @@ function resolveConfig(config) {
         family: config.typography?.heading?.family ?? DEFAULTS.typography.heading.family,
         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?.org && { org: config.typography.heading.org },
+        ...config.typography?.heading?.weights && { weights: config.typography.heading.weights }
       },
       display: {
         family: config.typography?.display?.family ?? config.typography?.heading?.family ?? DEFAULTS.typography.heading.family,
         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?.org && { org: config.typography.display.org },
+        ...config.typography?.display?.weights && { weights: config.typography.display.weights }
       },
       body: {
         family: config.typography?.body?.family ?? DEFAULTS.typography.body.family,
         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?.org && { org: config.typography.body.org },
+        ...config.typography?.body?.weights && { weights: config.typography.body.weights }
       },
       mono: {
         family: config.typography?.mono?.family ?? DEFAULTS.typography.mono.family
-      }
+      },
+      slots: config.typography?.slots ?? {}
     },
     spacing: {
       base: config.spacing?.base ?? DEFAULTS.spacing.base
@@ -671,6 +808,12 @@ function resolveConfig(config) {
       lg: config.shadows?.lg ?? DEFAULTS.shadows.lg,
       xl: config.shadows?.xl ?? DEFAULTS.shadows.xl
     },
+    strokeWidths: {
+      thin: config.strokeWidths?.thin ?? DEFAULTS.strokeWidths.thin,
+      regular: config.strokeWidths?.regular ?? DEFAULTS.strokeWidths.regular,
+      medium: config.strokeWidths?.medium ?? DEFAULTS.strokeWidths.medium,
+      thick: config.strokeWidths?.thick ?? DEFAULTS.strokeWidths.thick
+    },
     motion: {
       "duration-fast": config.motion?.["duration-fast"] ?? DEFAULTS.motion["duration-fast"],
       "duration-normal": config.motion?.["duration-normal"] ?? DEFAULTS.motion["duration-normal"],
@@ -750,6 +893,12 @@ var SEMANTIC_SURFACE_MAP = {
     light: { constant: CONFIG_SURFACE },
     dark: { constant: CONFIG_DARK_SURFACE }
   },
+  // Distinct from card: glass themes (Blackout, Modern Minimal dark) set surface-card translucent.
+  // Floating panels rendered over arbitrary page content must be opaque — override this token there.
+  popover: {
+    light: { constant: CONFIG_SURFACE },
+    dark: { constant: CONFIG_DARK_SURFACE }
+  },
   subtle: {
     light: { role: "neutral", shade: 50 },
     dark: { role: "neutral", shade: 800 }
@@ -778,6 +927,12 @@ var SEMANTIC_SURFACE_MAP = {
     light: { role: "neutral", shade: 50 },
     dark: { role: "neutral", shade: 800 }
   },
+  // Persistent selected-state surface (active nav item, currently-selected list row).
+  // Distinct from interactive-active (transient press) and from accent-subtle (broader brand surface).
+  selected: {
+    light: { role: "primary", shade: 100 },
+    dark: { role: "primary", shade: 800 }
+  },
   "accent-subtle": {
     light: { role: "primary", shade: 50 },
     dark: { role: "primary", shade: 900 }
@@ -958,28 +1113,28 @@ function resolveRef(ref, primitives, config) {
       return ref.constant;
   }
 }
-function resolveMapping(mapping, primitives, config) {
+function resolveMapping(mapping, lightPrimitives, darkPrimitives, config) {
   return {
-    light: resolveRef(mapping.light, primitives, config),
-    dark: resolveRef(mapping.dark, primitives, config)
+    light: resolveRef(mapping.light, lightPrimitives, config),
+    dark: resolveRef(mapping.dark, darkPrimitives, config)
   };
 }
-function assignSemanticTokens(primitives, config) {
+function assignSemanticTokens(lightPrimitives, darkPrimitives, config) {
   const text = {};
   const surface = {};
   const border = {};
   const interactive = {};
   for (const [name, mapping] of Object.entries(SEMANTIC_MAP.text)) {
-    text[name] = resolveMapping(mapping, primitives, config);
+    text[name] = resolveMapping(mapping, lightPrimitives, darkPrimitives, config);
   }
   for (const [name, mapping] of Object.entries(SEMANTIC_MAP.surface)) {
-    surface[name] = resolveMapping(mapping, primitives, config);
+    surface[name] = resolveMapping(mapping, lightPrimitives, darkPrimitives, config);
   }
   for (const [name, mapping] of Object.entries(SEMANTIC_MAP.border)) {
-    border[name] = resolveMapping(mapping, primitives, config);
+    border[name] = resolveMapping(mapping, lightPrimitives, darkPrimitives, config);
   }
   for (const [name, mapping] of Object.entries(SEMANTIC_MAP.interactive)) {
-    interactive[name] = resolveMapping(mapping, primitives, config);
+    interactive[name] = resolveMapping(mapping, lightPrimitives, darkPrimitives, config);
   }
   return { text, surface, border, interactive };
 }
@@ -1052,6 +1207,18 @@ function generatePrimitives(config) {
     info: generateShadeScale(config.colors.info, "info")
   };
 }
+function generateDarkPrimitives(config, lightPrimitives) {
+  const cd = config["colors-dark"];
+  return {
+    primary: cd?.primary ? generateShadeScale(cd.primary, "primary") : lightPrimitives.primary,
+    accent: cd?.accent ? generateShadeScale(cd.accent, "accent") : lightPrimitives.accent,
+    neutral: cd?.neutral ? config.colors.neutral === null ? TAILWIND_GRAY : generateShadeScale(cd.neutral, "neutral") : lightPrimitives.neutral,
+    success: cd?.success ? generateShadeScale(cd.success, "success") : lightPrimitives.success,
+    warning: cd?.warning ? generateShadeScale(cd.warning, "warning") : lightPrimitives.warning,
+    error: cd?.error ? generateShadeScale(cd.error, "error") : lightPrimitives.error,
+    info: cd?.info ? generateShadeScale(cd.info, "info") : lightPrimitives.info
+  };
+}
 function parseConfig(yamlString) {
   const parsed = parseYaml(yamlString);
   const result = validateConfig(parsed);
@@ -1084,7 +1251,8 @@ ${validation.errors.map((e) => `  - ${e}`).join("\n")}`
   }
   const resolved = resolveConfig(config);
   const primitives = generatePrimitives(resolved);
-  let tokens = assignSemanticTokens(primitives, resolved);
+  const darkPrimitives = generateDarkPrimitives(resolved, primitives);
+  let tokens = assignSemanticTokens(primitives, darkPrimitives, resolved);
   tokens = applyOverrides(tokens, resolved.overrides);
   const output = {
     primitivesCss: generatePrimitivesCss(primitives, resolved),
@@ -1835,6 +2003,51 @@ function checkRadiusScale(config, issues) {
     );
   }
 }
+function checkDarkLightParity(config, issues) {
+  if (!config.colors) return;
+  const colorKeys = Object.keys(config.colors).filter((k) => k !== "primary");
+  const hasDarkSection = config["colors-dark"] !== void 0;
+  if (colorKeys.length > 0 && !hasDarkSection) {
+    issues.push(
+      issue(
+        "warning",
+        "DARK_LIGHT_PARITY",
+        "Custom colors are set but no colors-dark section exists. Dark mode will use generated defaults which may not match your brand.",
+        "colors-dark"
+      )
+    );
+    return;
+  }
+  if (colorKeys.length > 0 && hasDarkSection) {
+    const lightKeys = new Set(Object.keys(config.colors));
+    const darkKeys = new Set(Object.keys(config["colors-dark"]));
+    for (const key of lightKeys) {
+      if (key === "primary") continue;
+      if (!darkKeys.has(key)) {
+        issues.push(
+          issue(
+            "warning",
+            "DARK_LIGHT_PARITY",
+            `Color "${key}" is set in colors but missing from colors-dark. Dark mode will use a generated default.`,
+            "colors-dark"
+          )
+        );
+      }
+    }
+    for (const key of darkKeys) {
+      if (!lightKeys.has(key)) {
+        issues.push(
+          issue(
+            "warning",
+            "DARK_LIGHT_PARITY",
+            `Color "${key}" is set in colors-dark but missing from colors. Light mode will use a generated default.`,
+            "colors"
+          )
+        );
+      }
+    }
+  }
+}
 function validate(config) {
   const errors = [];
   const warnings = [];
@@ -1866,6 +2079,7 @@ function validate(config) {
     checkColorSimilarity(typedConfig, warnings);
     checkMissingGlowShadow(typedConfig, warnings);
     checkRadiusScale(typedConfig, warnings);
+    checkDarkLightParity(typedConfig, warnings);
   }
   return {
     valid: errors.length === 0,

package/dist/{types-r7ae3WP2.d.ts → types-gAlkt__C.d.ts}

@@ -46,18 +46,24 @@ interface VisorTypography {
     heading?: {
         family: string;
         weight?: number;
+        /** Explicit list of font weights to load (overrides engine defaults) */
+        weights?: number[];
         source?: FontSource;
         org?: string;
     };
     display?: {
         family: string;
         weight?: number;
+        /** Explicit list of font weights to load (overrides engine defaults) */
+        weights?: number[];
         source?: FontSource;
         org?: string;
     };
     body?: {
         family: string;
         weight?: number;
+        /** Explicit list of font weights to load (overrides engine defaults) */
+        weights?: number[];
         source?: FontSource;
         org?: string;
     };
@@ -118,11 +124,32 @@ interface ParsedColor {
     format: ColorFormat;
     original: string;
 }
+/**
+ * The 15 Material 3 type-scale slots plus Visor's `labelXSmall` extension.
+ *
+ * Per-slot size / weight / letter-spacing can be overridden in
+ * `typography.slots` to tune the generated Flutter `TextTheme` without
+ * touching the global font families.
+ */
+type MaterialTextSlot = "displayLarge" | "displayMedium" | "displaySmall" | "headlineLarge" | "headlineMedium" | "headlineSmall" | "titleLarge" | "titleMedium" | "titleSmall" | "bodyLarge" | "bodyMedium" | "bodySmall" | "labelLarge" | "labelMedium" | "labelSmall" | "labelXSmall";
+/** Per-slot override in `typography.slots.<slot>`. All fields optional. */
+interface TextSlotOverride {
+    /** Font size in logical pixels (Flutter `TextStyle.fontSize`). */
+    size?: number;
+    /** Font weight (100–900, matching Flutter `FontWeight.w100..w900`). */
+    weight?: number;
+    /** Letter spacing in logical pixels (Flutter `TextStyle.letterSpacing`). */
+    "letter-spacing"?: number;
+}
 interface VisorThemeConfig {
     name: string;
     version: 1;
     /** Theme group for the docs site theme switcher (e.g. 'Visor', 'Client', 'Low Orbit'). Used by `visor theme sync`. */
     group?: string;
+    /** Optional display label override for the theme switcher (e.g. 'ENTR', 'SoleSpark'). Falls back to title-cased name. */
+    label?: string;
+    /** Default color mode to force when the theme is activated ('dark' or 'light'). If unset, user/system preference applies. */
+    "default-mode"?: "dark" | "light";
     colors: {
         primary: string;
         accent?: string;
@@ -150,18 +177,21 @@ interface VisorThemeConfig {
         heading?: {
             family?: string;
             weight?: number;
+            weights?: number[];
             source?: FontSource;
             org?: string;
         };
         display?: {
             family?: string;
             weight?: number;
+            weights?: number[];
             source?: FontSource;
             org?: string;
         };
         body?: {
             family?: string;
             weight?: number;
+            weights?: number[];
             source?: FontSource;
             org?: string;
         };
@@ -176,6 +206,13 @@ interface VisorThemeConfig {
             normal?: string;
             wide?: string;
         };
+        /**
+         * Per-slot overrides for the generated Flutter `TextTheme`. Any subset
+         * of the 16 Material slots may be specified; omitted slots fall
+         * through to `VisorTextStylesData.defaults` (Material 3 2024 scale).
+         * Flutter-only — ignored by CSS/NextJS adapters.
+         */
+        slots?: Partial<Record<MaterialTextSlot, TextSlotOverride>>;
     };
     spacing?: {
         base?: number;
@@ -194,6 +231,12 @@ interface VisorThemeConfig {
         lg?: string;
         xl?: string;
     };
+    strokeWidths?: {
+        thin?: number;
+        regular?: number;
+        medium?: number;
+        thick?: number;
+    };
     motion?: {
         "duration-fast"?: string;
         "duration-normal"?: string;
@@ -226,24 +269,33 @@ interface ResolvedThemeConfig {
         heading: {
             family: string;
             weight: number;
+            weights?: number[];
             source?: FontSource;
             org?: string;
         };
         display: {
             family: string;
             weight: number;
+            weights?: number[];
             source?: FontSource;
             org?: string;
         };
         body: {
             family: string;
             weight: number;
+            weights?: number[];
             source?: FontSource;
             org?: string;
         };
         mono: {
             family: string;
         };
+        /**
+         * Per-slot Material `TextTheme` overrides, passed through from the
+         * raw config. Empty object when none supplied. Flutter adapter
+         * consumes these; other adapters may ignore them.
+         */
+        slots: Partial<Record<MaterialTextSlot, TextSlotOverride>>;
     };
     spacing: {
         base: number;
@@ -262,6 +314,12 @@ interface ResolvedThemeConfig {
         lg: string;
         xl: string;
     };
+    strokeWidths: {
+        thin: number;
+        regular: number;
+        medium: number;
+        thick: number;
+    };
     motion: {
         "duration-fast": string;
         "duration-normal": string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loworbitstudio/visor-theme-engine",
-  "version": "0.1.0",
+  "version": "0.4.1",
   "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",
@@ -35,7 +35,12 @@
     "design-system",
     "theme",
     "oklch",
-    "tokens"
+    "tokens",
+    "react",
+    "css-variables",
+    "theming",
+    "color-system",
+    "wcag"
   ],
   "license": "MIT",
   "repository": {

package/src/visor-theme.schema.json

@@ -184,6 +184,29 @@
             "normal": { "type": "string" },
             "wide": { "type": "string" }
           }
+        },
+        "slots": {
+          "type": "object",
+          "description": "Per-slot overrides for the generated Flutter Material TextTheme. Any subset of the 16 slots may be specified; omitted slots fall through to the Material 3 2024 defaults shipped in visor_core.",
+          "additionalProperties": false,
+          "properties": {
+            "displayLarge": { "$ref": "#/$defs/textSlotOverride" },
+            "displayMedium": { "$ref": "#/$defs/textSlotOverride" },
+            "displaySmall": { "$ref": "#/$defs/textSlotOverride" },
+            "headlineLarge": { "$ref": "#/$defs/textSlotOverride" },
+            "headlineMedium": { "$ref": "#/$defs/textSlotOverride" },
+            "headlineSmall": { "$ref": "#/$defs/textSlotOverride" },
+            "titleLarge": { "$ref": "#/$defs/textSlotOverride" },
+            "titleMedium": { "$ref": "#/$defs/textSlotOverride" },
+            "titleSmall": { "$ref": "#/$defs/textSlotOverride" },
+            "bodyLarge": { "$ref": "#/$defs/textSlotOverride" },
+            "bodyMedium": { "$ref": "#/$defs/textSlotOverride" },
+            "bodySmall": { "$ref": "#/$defs/textSlotOverride" },
+            "labelLarge": { "$ref": "#/$defs/textSlotOverride" },
+            "labelMedium": { "$ref": "#/$defs/textSlotOverride" },
+            "labelSmall": { "$ref": "#/$defs/textSlotOverride" },
+            "labelXSmall": { "$ref": "#/$defs/textSlotOverride" }
+          }
         }
       }
     },
@@ -223,6 +246,17 @@
         "xl": { "type": "string" }
       }
     },
+    "strokeWidths": {
+      "type": "object",
+      "description": "Stroke-width scale in pixels — used for borders, outlines, dividers, progress-indicator strokes. Defaults: thin=1, regular=1.5, medium=2, thick=2.5.",
+      "additionalProperties": false,
+      "properties": {
+        "thin": { "type": "number", "minimum": 0 },
+        "regular": { "type": "number", "minimum": 0 },
+        "medium": { "type": "number", "minimum": 0 },
+        "thick": { "type": "number", "minimum": 0 }
+      }
+    },
     "motion": {
       "type": "object",
       "description": "Motion/animation configuration.",
@@ -277,6 +311,28 @@
         { "pattern": "^hsla?\\(" },
         { "pattern": "^oklch\\(" }
       ]
+    },
+    "textSlotOverride": {
+      "type": "object",
+      "description": "Per-slot override for one Material TextTheme entry.",
+      "additionalProperties": false,
+      "properties": {
+        "size": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "description": "Font size in logical pixels (Flutter TextStyle.fontSize)."
+        },
+        "weight": {
+          "type": "integer",
+          "minimum": 100,
+          "maximum": 900,
+          "description": "Font weight."
+        },
+        "letter-spacing": {
+          "type": "number",
+          "description": "Letter spacing in logical pixels (Flutter TextStyle.letterSpacing). Material defaults include negative values, e.g. -0.25 for displayLarge."
+        }
+      }
     }
   }
 }