@loworbitstudio/visor-theme-engine 0.4.0 → 0.4.1

package/dist/{chunk-NZF2MS4L.js → chunk-G4B57FB3.js}

@@ -1366,6 +1366,26 @@ function generateFullBundleCss(primitives, tokens, config) {
   return lines.join("\n");
 }
 
+// src/types.ts
+var MATERIAL_TEXT_SLOTS = [
+  "displayLarge",
+  "displayMedium",
+  "displaySmall",
+  "headlineLarge",
+  "headlineMedium",
+  "headlineSmall",
+  "titleLarge",
+  "titleMedium",
+  "titleSmall",
+  "bodyLarge",
+  "bodyMedium",
+  "bodySmall",
+  "labelLarge",
+  "labelMedium",
+  "labelSmall",
+  "labelXSmall"
+];
+
 export {
   googleFontsCatalog,
   lookupGoogleFont,
@@ -1392,6 +1412,7 @@ export {
   isValidColor,
   compositeOverBackground,
   serializeColor,
+  MATERIAL_TEXT_SLOTS,
   FULL_SHADE_STEPS,
   SELECTIVE_SHADE_STEPS,
   TAILWIND_GRAY,

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, R as ResolvedThemeConfig, c as GeneratedPrimitives, d as ThemeOutput, e as ThemeData, f as VisorThemeConfig, g as FullShadeScale, C as ColorRole, S as SelectiveShadeScale, h as RGB, P as ParsedColor, O as OKLCH, i as SemanticTokens, j as ShadeStep } from './types-DgAumoCX.js';
-export { k as ColorFormat, l as FontSource, m as RGBA, n as SemanticTokenValue } from './types-DgAumoCX.js';
+import { F as FontResolveOptions, a as FontResolution, V as VisorTypography, b as FontDisplayStrategy, T as ThemeFontResult, G as GoogleFontEntry, R as ResolvedThemeConfig, c as GeneratedPrimitives, d as ThemeOutput, e as ThemeData, f as VisorThemeConfig, g as FullShadeScale, C as ColorRole, S as SelectiveShadeScale, h as RGB, P as ParsedColor, O as OKLCH, i as SemanticTokens, j as ShadeStep } from './types-gAlkt__C.js';
+export { k as ColorFormat, l as FontSource, m as RGBA, n as SemanticTokenValue } from './types-gAlkt__C.js';
 
 /**
  * Font resolver — maps font family names to loadable font resources.
@@ -97,7 +97,7 @@ declare function lookupGoogleFont(family: string): GoogleFontEntry | undefined;
  */
 
 /**
- * Generate all shade scales from a resolved config.
+ * Generate all shade scales from a resolved config (light-mode colors).
  * If neutral is null, uses Tailwind Gray verbatim.
  */
 declare function generatePrimitives(config: ResolvedThemeConfig): GeneratedPrimitives;
@@ -367,6 +367,61 @@ var properties = {
 						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"
+					}
+				}
 			}
 		}
 	},
@@ -432,6 +487,29 @@ var properties = {
 			}
 		}
 	},
+	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.",
@@ -498,6 +576,28 @@ var $defs = {
 				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."
+			}
+		}
 	}
 };
 var visorTheme_schema = {
@@ -658,10 +758,12 @@ declare function resolveConfig(config: VisorThemeConfig): ResolvedThemeConfig;
  */
 
 /**
- * Assign semantic tokens from generated shade scales and resolved config.
- * Returns concrete hex values for all ~55 tokens in both light and dark modes.
+ * Assign semantic tokens from mode-specific shade scales and resolved config.
+ * lightPrimitives drives light-mode token values; darkPrimitives drives dark-mode
+ * values — allowing themes with colors-dark overrides to produce correct dark
+ * semantic tokens (e.g. surface-accent-default uses the dark brand color).
  */
-declare function assignSemanticTokens(primitives: GeneratedPrimitives, config: ResolvedThemeConfig): SemanticTokens;
+declare function assignSemanticTokens(lightPrimitives: GeneratedPrimitives, darkPrimitives: GeneratedPrimitives, config: ResolvedThemeConfig): SemanticTokens;
 
 /**
  * Override Application (Stage 4)

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-NZF2MS4L.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."
+        }
+      }
     }
   }
 };
@@ -333,6 +390,7 @@ var KNOWN_TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
   "spacing",
   "radius",
   "shadows",
+  "strokeWidths",
   "motion",
   "overrides"
 ]);
@@ -353,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", "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) {
@@ -425,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)) {
@@ -447,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)) {
@@ -547,6 +641,23 @@ function validateConfig(config) {
         }
       }
     }
+    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) {
     if (typeof obj.overrides !== "object" || obj.overrides === null) {
@@ -595,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",
@@ -671,7 +788,8 @@ function resolveConfig(config) {
       },
       mono: {
         family: config.typography?.mono?.family ?? DEFAULTS.typography.mono.family
-      }
+      },
+      slots: config.typography?.slots ?? {}
     },
     spacing: {
       base: config.spacing?.base ?? DEFAULTS.spacing.base
@@ -690,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"],
@@ -769,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 }
@@ -797,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 }
@@ -977,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 };
 }
@@ -1071,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);
@@ -1103,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),

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

@@ -124,6 +124,23 @@ 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;
@@ -189,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;
@@ -207,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;
@@ -260,6 +290,12 @@ interface ResolvedThemeConfig {
         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;
@@ -278,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.4.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",

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."
+        }
+      }
     }
   }
 }