@loworbitstudio/visor-theme-engine 0.4.0 → 0.4.2

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

@@ -964,8 +964,11 @@ var LIGHTNESS_TARGETS = {
   200: 0.87,
   300: 0.78,
   400: 0.65,
-  500: -1,
-  // placeholder — replaced by input L at anchor (brand color lives at 500)
+  // 500 is the reference midpoint (Tailwind gray-500's OKLCH L ≈ 0.55).
+  // At the anchor shade the input L is used directly; this value seeds the
+  // interpolation math in computeLightness() for inputs that don't land at
+  // the reference midpoint.
+  500: 0.55,
   600: 0.45,
   700: 0.38,
   800: 0.3,
@@ -1012,20 +1015,20 @@ function computeLightness(step, inputL, anchorShade) {
   if (step === anchorShade) {
     return inputL;
   }
-  const anchorTarget = anchorShade === 600 ? inputL : LIGHTNESS_TARGETS[anchorShade];
+  const anchorTarget = LIGHTNESS_TARGETS[anchorShade];
   const stepTarget = LIGHTNESS_TARGETS[step];
   if (Math.abs(anchorTarget - inputL) < 0.01) {
     return stepTarget;
   }
   if (step < anchorShade) {
-    const anchorDefaultL = anchorShade === 600 ? 0.45 : LIGHTNESS_TARGETS[anchorShade];
+    const anchorDefaultL = LIGHTNESS_TARGETS[anchorShade];
     const rawRange = 0.97 - anchorDefaultL;
     const newRange = 0.97 - inputL;
     if (rawRange <= 0) return stepTarget;
     const t = (stepTarget - anchorDefaultL) / rawRange;
     return inputL + t * newRange;
   } else {
-    const anchorDefaultL = anchorShade === 600 ? 0.45 : LIGHTNESS_TARGETS[anchorShade];
+    const anchorDefaultL = LIGHTNESS_TARGETS[anchorShade];
     const rawRange = anchorDefaultL - 0.14;
     const newRange = inputL - 0.14;
     if (rawRange <= 0) return stepTarget;
@@ -1043,7 +1046,7 @@ function generateShadeScale(color, role) {
   for (const step of steps) {
     const targetL = computeLightness(step, inputL, anchorShade);
     let targetC = inputC * CHROMA_MULTIPLIERS[step];
-    if (role === "neutral") {
+    if (role === "neutral" && step !== anchorShade) {
       targetC = Math.min(targetC, maxNeutralChroma);
     }
     scale[step] = oklchToHex(targetL, targetC, inputH);
@@ -1366,6 +1369,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 +1415,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-ljcTtODU.js';
+export { k as ColorFormat, l as FontSource, m as RGBA, n as SemanticTokenValue } from './types-ljcTtODU.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.",
@@ -478,6 +556,20 @@ var properties = {
 				}
 			}
 		}
+	},
+	migrate: {
+		type: "object",
+		description: "Migration metadata consumed by `visor migrate` commands. Does not affect CSS generation or theme application.",
+		additionalProperties: false,
+		properties: {
+			"token-substitution": {
+				type: "object",
+				description: "§3.1 V7-primitive → Visor-semantic substitution table. Maps V7 CSS custom property names (with -- prefix) to Visor semantic token names. Consumed by `visor migrate token-substitution`.",
+				additionalProperties: {
+					type: "string"
+				}
+			}
+		}
 	}
 };
 var $defs = {
@@ -498,6 +590,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 +772,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)