@santi020k/lumen-core 3.0.1 → 4.0.0

package/dist/theme-builder.js

@@ -1,6 +1,25 @@
-/* eslint-disable complexity */
 import { exportThemeDesignTokens, exportThemeFigmaVariables } from './figma.js';
-import { createThemeFromHue, exportThemeCss } from './theme.js';
+import { createThemeFromHue, createThemePreset, exportThemeCss } from './theme.js';
+const appearanceNumber = (value, fallback) => {
+    if (value === undefined || value === null || value === '')
+        return fallback;
+    const number = Number(value);
+    return Number.isFinite(number) && number >= 0 ? number : fallback;
+};
+const scaleAppearanceDimensions = (tokens, names, requested) => {
+    const scale = appearanceNumber(requested, 1);
+    const dimensions = names.map(name => ({ name, value: Number.parseFloat(tokens[name] ?? '0') }));
+    const safeScale = dimensions.every(({ value }) => Number.isFinite(value * scale)) ? scale : 1;
+    for (const { name, value } of dimensions) {
+        tokens[name] = `${value * safeScale}rem`;
+    }
+};
+const customizeAppearance = (tokens, options) => {
+    scaleAppearanceDimensions(tokens, ['ui-radius-sm', 'ui-radius', 'ui-radius-lg'], options.radiusScale);
+    scaleAppearanceDimensions(tokens, ['zero', 'xs', 'sm', 'md', 'lg', 'xl', '2xl', '3xl'].map(name => `ui-space-${name}`), options.spacingScale);
+    tokens['ui-border-width'] = `${appearanceNumber(options.borderWidth, 1)}px`;
+};
+export const coerceThemePreset = (value) => value === 'studio' || value === 'glass' ? value : 'default';
 export const coerceThemeBuilderExportFormat = (value) => {
     if (value === 'figma' || value === 'tokens')
         return value;
@@ -57,33 +76,36 @@ export const themeBuilderHexToHsl = (value) => {
         value: `${normalizedHue} ${Math.round(saturation * 100)}% ${Math.round(lightness * 100)}%`
     };
 };
+const getManualColors = (options) => ({
+    primary: options.primaryColor ? themeBuilderHexToHsl(options.primaryColor) : null,
+    secondary: options.secondaryColor ? themeBuilderHexToHsl(options.secondaryColor) : null
+});
+const applyManualColors = (tokens, { primary, secondary }) => {
+    if (primary) {
+        tokens.brand = primary.value;
+        tokens['brand-solid'] = primary.value;
+    }
+    if (secondary)
+        tokens.accent = secondary.value;
+};
 export const createThemeBuilderTokens = (options = {}) => {
     const hue = normalizeThemeBuilderHue(options.hue);
     const accentHue = normalizeThemeBuilderHue(options.accentHue, normalizeThemeBuilderHue(hue + 150));
     const mode = coerceThemeBuilderMode(options.mode);
     const scheme = coerceThemeBuilderScheme(options.scheme);
-    const primary = options.primaryColor ?
-        themeBuilderHexToHsl(options.primaryColor) :
-        null;
-    const secondary = options.secondaryColor ?
-        themeBuilderHexToHsl(options.secondaryColor) :
-        null;
-    const baseHue = mode === 'manual' ? (primary?.hue ?? hue) : hue;
-    const baseAccentHue = mode === 'manual' ? (secondary?.hue ?? accentHue) : accentHue;
-    const tokens = createThemeFromHue(baseHue, {
-        accentHue: baseAccentHue,
-        scheme
-    });
-    if (mode === 'manual') {
-        if (primary) {
-            tokens.brand = primary.value;
-            tokens['brand-solid'] = primary.value;
-        }
-        if (secondary) {
-            tokens.accent = secondary.value;
-        }
-    }
+    const colors = getManualColors(mode === 'manual' ? options : {});
+    const baseHue = colors.primary?.hue ?? hue;
+    const baseAccentHue = colors.secondary?.hue ?? accentHue;
+    const tokens = options.preset ?
+        createThemePreset(coerceThemePreset(options.preset), { scheme }) :
+        createThemeFromHue(baseHue, {
+            accentHue: baseAccentHue,
+            scheme
+        });
+    applyManualColors(tokens, colors);
+    customizeAppearance(tokens, options);
     return {
+        ...(options.preset ? { preset: coerceThemePreset(options.preset) } : {}),
         accentHue: baseAccentHue,
         hue: baseHue,
         mode,

package/dist/theme-presets.generated.d.ts

@@ -0,0 +1,217 @@
+export declare const lumenThemePresetDefinitions: {
+    readonly default: {
+        readonly radiusScale: 1;
+        readonly spacingScale: 1;
+        readonly borderWidth: 1;
+        readonly elevationScale: 1;
+        readonly fontFamily: readonly ["Montserrat", "Avenir Next", "Segoe UI", "sans-serif"];
+        readonly material: "solid";
+        readonly colors: {
+            readonly light: {};
+            readonly dark: {};
+        };
+        readonly effects: {
+            readonly light: {
+                readonly "ui-shadow-sm": "0 1px 2px hsl(222 47% 11% / 0.06)";
+                readonly "ui-shadow-md": "0 8px 24px hsl(222 47% 11% / 0.08)";
+                readonly "ui-shadow-lg": "0 24px 64px hsl(222 47% 11% / 0.14)";
+                readonly "glass-bg": "0 0% 100% / 0.55";
+                readonly "glass-bg-subtle": "0 0% 100% / 0.38";
+                readonly "glass-bg-strong": "0 0% 100% / 0.72";
+                readonly "glass-border": "220 30% 100% / 0.55";
+                readonly "glass-highlight": "0 0% 100% / 0.85";
+                readonly "glass-blur": "22px";
+                readonly "glass-saturate": "1.7";
+                readonly "glass-brightness": "1.05";
+                readonly "glass-edge": "0 0% 100% / 0.9";
+                readonly "glass-edge-soft": "0 0% 100% / 0.34";
+                readonly "glass-shade": "222 47% 11% / 0.07";
+                readonly "glass-refraction": "201 96% 32% / 0.08";
+                readonly "glass-shadow": "0 1px 2px hsl(222 47% 11% / 0.08),\n    0 12px 32px hsl(222 47% 11% / 0.12),\n    0 32px 80px hsl(222 47% 11% / 0.14)";
+            };
+            readonly dark: {
+                readonly "ui-shadow-sm": "0 1px 2px hsl(0 0% 0% / 0.18)";
+                readonly "ui-shadow-md": "0 12px 32px hsl(0 0% 0% / 0.24)";
+                readonly "ui-shadow-lg": "0 28px 80px hsl(0 0% 0% / 0.36)";
+                readonly "glass-bg": "224 20% 13% / 0.78";
+                readonly "glass-bg-subtle": "224 20% 13% / 0.64";
+                readonly "glass-bg-strong": "224 20% 13% / 0.9";
+                readonly "glass-border": "210 30% 92% / 0.24";
+                readonly "glass-highlight": "210 30% 96% / 0.1";
+                readonly "glass-brightness": "1";
+                readonly "glass-edge": "210 40% 98% / 0.24";
+                readonly "glass-edge-soft": "210 40% 98% / 0.08";
+                readonly "glass-shade": "240 40% 3% / 0.3";
+                readonly "glass-refraction": "199 91% 56% / 0.1";
+                readonly "glass-shadow": "0 1px 2px hsl(0 0% 0% / 0.3),\n    0 16px 40px hsl(0 0% 0% / 0.34),\n    0 40px 96px hsl(0 0% 0% / 0.38)";
+            };
+        };
+        readonly cssColors: {
+            readonly light: {};
+            readonly dark: {};
+        };
+    };
+    readonly studio: {
+        readonly radiusScale: 0.6;
+        readonly spacingScale: 1;
+        readonly borderWidth: 1;
+        readonly elevationScale: 0;
+        readonly fontFamily: readonly ["system-ui", "-apple-system", "BlinkMacSystemFont", "Segoe UI", "sans-serif"];
+        readonly material: "solid";
+        readonly colors: {
+            readonly light: {
+                readonly canvas: "#FFFFFF";
+                readonly surface: "#FFFFFF";
+                readonly surfaceMuted: "#F4F4F4";
+                readonly surfaceStrong: "#E8E8E8";
+                readonly line: "#E5E5E5";
+                readonly ink: "#171717";
+                readonly inkSoft: "#525252";
+                readonly inkMuted: "#737373";
+                readonly brand: "#171717";
+                readonly brandSolid: "#171717";
+                readonly brandSoft: "#EBEBEB";
+                readonly onBrand: "#FFFFFF";
+                readonly accent: "#171717";
+            };
+            readonly dark: {
+                readonly canvas: "#111111";
+                readonly surface: "#111111";
+                readonly surfaceMuted: "#1C1C1C";
+                readonly surfaceStrong: "#303030";
+                readonly line: "#383838";
+                readonly ink: "#F5F5F5";
+                readonly inkSoft: "#CCCCCC";
+                readonly inkMuted: "#A3A3A3";
+                readonly brand: "#F5F5F5";
+                readonly brandSolid: "#F5F5F5";
+                readonly brandSoft: "#242424";
+                readonly onBrand: "#111111";
+                readonly accent: "#F5F5F5";
+            };
+        };
+        readonly effects: {
+            readonly light: {
+                readonly "ui-shadow-sm": "none";
+                readonly "ui-shadow-md": "none";
+                readonly "ui-shadow-lg": "none";
+                readonly "glass-bg": "0 0% 100% / 0.55";
+                readonly "glass-bg-subtle": "0 0% 100% / 0.38";
+                readonly "glass-bg-strong": "0 0% 100% / 0.72";
+                readonly "glass-border": "220 30% 100% / 0.55";
+                readonly "glass-highlight": "0 0% 100% / 0.85";
+                readonly "glass-blur": "22px";
+                readonly "glass-saturate": "1.7";
+                readonly "glass-brightness": "1.05";
+                readonly "glass-edge": "0 0% 100% / 0.9";
+                readonly "glass-edge-soft": "0 0% 100% / 0.34";
+                readonly "glass-shade": "222 47% 11% / 0.07";
+                readonly "glass-refraction": "0 0% 50% / 0.04";
+                readonly "glass-shadow": "0 1px 2px hsl(222 47% 11% / 0.08),\n    0 12px 32px hsl(222 47% 11% / 0.12),\n    0 32px 80px hsl(222 47% 11% / 0.14)";
+            };
+            readonly dark: {
+                readonly "ui-shadow-sm": "none";
+                readonly "ui-shadow-md": "none";
+                readonly "ui-shadow-lg": "none";
+                readonly "glass-bg": "224 20% 13% / 0.78";
+                readonly "glass-bg-subtle": "224 20% 13% / 0.64";
+                readonly "glass-bg-strong": "224 20% 13% / 0.9";
+                readonly "glass-border": "210 30% 92% / 0.24";
+                readonly "glass-highlight": "210 30% 96% / 0.1";
+                readonly "glass-brightness": "1";
+                readonly "glass-edge": "210 40% 98% / 0.24";
+                readonly "glass-edge-soft": "210 40% 98% / 0.08";
+                readonly "glass-shade": "240 40% 3% / 0.3";
+                readonly "glass-refraction": "0 0% 50% / 0.04";
+                readonly "glass-shadow": "0 1px 2px hsl(0 0% 0% / 0.3),\n    0 16px 40px hsl(0 0% 0% / 0.34),\n    0 40px 96px hsl(0 0% 0% / 0.38)";
+            };
+        };
+        readonly cssColors: {
+            readonly light: {
+                readonly canvas: "0 0% 100%";
+                readonly surface: "0 0% 100%";
+                readonly "surface-muted": "0 0% 96%";
+                readonly "surface-strong": "0 0% 91%";
+                readonly line: "0 0% 90%";
+                readonly ink: "0 0% 9%";
+                readonly "ink-soft": "0 0% 32%";
+                readonly "ink-muted": "0 0% 45%";
+                readonly brand: "0 0% 9%";
+                readonly "brand-solid": "0 0% 9%";
+                readonly "brand-soft": "0 0% 92%";
+                readonly "on-brand": "0 0% 100%";
+                readonly accent: "0 0% 9%";
+            };
+            readonly dark: {
+                readonly canvas: "0 0% 7%";
+                readonly surface: "0 0% 7%";
+                readonly "surface-muted": "0 0% 11%";
+                readonly "surface-strong": "0 0% 19%";
+                readonly line: "0 0% 22%";
+                readonly ink: "0 0% 96%";
+                readonly "ink-soft": "0 0% 80%";
+                readonly "ink-muted": "0 0% 64%";
+                readonly brand: "0 0% 96%";
+                readonly "brand-solid": "0 0% 96%";
+                readonly "brand-soft": "0 0% 14%";
+                readonly "on-brand": "0 0% 7%";
+                readonly accent: "0 0% 96%";
+            };
+        };
+    };
+    readonly glass: {
+        readonly radiusScale: 1.4;
+        readonly spacingScale: 1;
+        readonly borderWidth: 1;
+        readonly elevationScale: 1;
+        readonly fontFamily: readonly ["Montserrat", "Avenir Next", "Segoe UI", "sans-serif"];
+        readonly material: "glass";
+        readonly colors: {
+            readonly light: {};
+            readonly dark: {};
+        };
+        readonly effects: {
+            readonly light: {
+                readonly "ui-shadow-sm": "0 1px 2px hsl(222 47% 11% / 0.06)";
+                readonly "ui-shadow-md": "0 8px 24px hsl(222 47% 11% / 0.08)";
+                readonly "ui-shadow-lg": "0 24px 64px hsl(222 47% 11% / 0.14)";
+                readonly "glass-bg": "0 0% 100% / 0.55";
+                readonly "glass-bg-subtle": "0 0% 100% / 0.38";
+                readonly "glass-bg-strong": "0 0% 100% / 0.72";
+                readonly "glass-border": "220 30% 100% / 0.55";
+                readonly "glass-highlight": "0 0% 100% / 0.85";
+                readonly "glass-blur": "22px";
+                readonly "glass-saturate": "1.7";
+                readonly "glass-brightness": "1.05";
+                readonly "glass-edge": "0 0% 100% / 0.9";
+                readonly "glass-edge-soft": "0 0% 100% / 0.34";
+                readonly "glass-shade": "222 47% 11% / 0.07";
+                readonly "glass-refraction": "201 96% 32% / 0.08";
+                readonly "glass-shadow": "0 1px 2px hsl(222 47% 11% / 0.08),\n    0 12px 32px hsl(222 47% 11% / 0.12),\n    0 32px 80px hsl(222 47% 11% / 0.14)";
+            };
+            readonly dark: {
+                readonly "ui-shadow-sm": "0 1px 2px hsl(0 0% 0% / 0.18)";
+                readonly "ui-shadow-md": "0 12px 32px hsl(0 0% 0% / 0.24)";
+                readonly "ui-shadow-lg": "0 28px 80px hsl(0 0% 0% / 0.36)";
+                readonly "glass-bg": "224 20% 13% / 0.78";
+                readonly "glass-bg-subtle": "224 20% 13% / 0.64";
+                readonly "glass-bg-strong": "224 20% 13% / 0.9";
+                readonly "glass-border": "210 30% 92% / 0.24";
+                readonly "glass-highlight": "210 30% 96% / 0.1";
+                readonly "glass-brightness": "1";
+                readonly "glass-edge": "210 40% 98% / 0.24";
+                readonly "glass-edge-soft": "210 40% 98% / 0.08";
+                readonly "glass-shade": "240 40% 3% / 0.3";
+                readonly "glass-refraction": "199 91% 56% / 0.1";
+                readonly "glass-shadow": "0 1px 2px hsl(0 0% 0% / 0.3),\n    0 16px 40px hsl(0 0% 0% / 0.34),\n    0 40px 96px hsl(0 0% 0% / 0.38)";
+            };
+        };
+        readonly cssColors: {
+            readonly light: {};
+            readonly dark: {};
+        };
+    };
+};
+export type LumenThemePreset = keyof typeof lumenThemePresetDefinitions;
+export type LumenSurfaceMaterial = 'solid' | 'glass';
+//# sourceMappingURL=theme-presets.generated.d.ts.map

package/dist/theme-presets.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-presets.generated.d.ts","sourceRoot":"","sources":["../src/theme-presets.generated.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqO9B,CAAA;AAEV,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,2BAA2B,CAAA;AACvE,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,OAAO,CAAA"}

package/dist/theme-presets.generated.js

@@ -0,0 +1,231 @@
+/* This file is generated by scripts/generate-platform-tokens.mjs. */
+export const lumenThemePresetDefinitions = {
+    "default": {
+        "radiusScale": 1,
+        "spacingScale": 1,
+        "borderWidth": 1,
+        "elevationScale": 1,
+        "fontFamily": [
+            "Montserrat",
+            "Avenir Next",
+            "Segoe UI",
+            "sans-serif"
+        ],
+        "material": "solid",
+        "colors": {
+            "light": {},
+            "dark": {}
+        },
+        "effects": {
+            "light": {
+                "ui-shadow-sm": "0 1px 2px hsl(222 47% 11% / 0.06)",
+                "ui-shadow-md": "0 8px 24px hsl(222 47% 11% / 0.08)",
+                "ui-shadow-lg": "0 24px 64px hsl(222 47% 11% / 0.14)",
+                "glass-bg": "0 0% 100% / 0.55",
+                "glass-bg-subtle": "0 0% 100% / 0.38",
+                "glass-bg-strong": "0 0% 100% / 0.72",
+                "glass-border": "220 30% 100% / 0.55",
+                "glass-highlight": "0 0% 100% / 0.85",
+                "glass-blur": "22px",
+                "glass-saturate": "1.7",
+                "glass-brightness": "1.05",
+                "glass-edge": "0 0% 100% / 0.9",
+                "glass-edge-soft": "0 0% 100% / 0.34",
+                "glass-shade": "222 47% 11% / 0.07",
+                "glass-refraction": "201 96% 32% / 0.08",
+                "glass-shadow": "0 1px 2px hsl(222 47% 11% / 0.08),\n    0 12px 32px hsl(222 47% 11% / 0.12),\n    0 32px 80px hsl(222 47% 11% / 0.14)"
+            },
+            "dark": {
+                "ui-shadow-sm": "0 1px 2px hsl(0 0% 0% / 0.18)",
+                "ui-shadow-md": "0 12px 32px hsl(0 0% 0% / 0.24)",
+                "ui-shadow-lg": "0 28px 80px hsl(0 0% 0% / 0.36)",
+                "glass-bg": "224 20% 13% / 0.78",
+                "glass-bg-subtle": "224 20% 13% / 0.64",
+                "glass-bg-strong": "224 20% 13% / 0.9",
+                "glass-border": "210 30% 92% / 0.24",
+                "glass-highlight": "210 30% 96% / 0.1",
+                "glass-brightness": "1",
+                "glass-edge": "210 40% 98% / 0.24",
+                "glass-edge-soft": "210 40% 98% / 0.08",
+                "glass-shade": "240 40% 3% / 0.3",
+                "glass-refraction": "199 91% 56% / 0.1",
+                "glass-shadow": "0 1px 2px hsl(0 0% 0% / 0.3),\n    0 16px 40px hsl(0 0% 0% / 0.34),\n    0 40px 96px hsl(0 0% 0% / 0.38)"
+            }
+        },
+        "cssColors": {
+            "light": {},
+            "dark": {}
+        }
+    },
+    "studio": {
+        "radiusScale": 0.6,
+        "spacingScale": 1,
+        "borderWidth": 1,
+        "elevationScale": 0,
+        "fontFamily": [
+            "system-ui",
+            "-apple-system",
+            "BlinkMacSystemFont",
+            "Segoe UI",
+            "sans-serif"
+        ],
+        "material": "solid",
+        "colors": {
+            "light": {
+                "canvas": "#FFFFFF",
+                "surface": "#FFFFFF",
+                "surfaceMuted": "#F4F4F4",
+                "surfaceStrong": "#E8E8E8",
+                "line": "#E5E5E5",
+                "ink": "#171717",
+                "inkSoft": "#525252",
+                "inkMuted": "#737373",
+                "brand": "#171717",
+                "brandSolid": "#171717",
+                "brandSoft": "#EBEBEB",
+                "onBrand": "#FFFFFF",
+                "accent": "#171717"
+            },
+            "dark": {
+                "canvas": "#111111",
+                "surface": "#111111",
+                "surfaceMuted": "#1C1C1C",
+                "surfaceStrong": "#303030",
+                "line": "#383838",
+                "ink": "#F5F5F5",
+                "inkSoft": "#CCCCCC",
+                "inkMuted": "#A3A3A3",
+                "brand": "#F5F5F5",
+                "brandSolid": "#F5F5F5",
+                "brandSoft": "#242424",
+                "onBrand": "#111111",
+                "accent": "#F5F5F5"
+            }
+        },
+        "effects": {
+            "light": {
+                "ui-shadow-sm": "none",
+                "ui-shadow-md": "none",
+                "ui-shadow-lg": "none",
+                "glass-bg": "0 0% 100% / 0.55",
+                "glass-bg-subtle": "0 0% 100% / 0.38",
+                "glass-bg-strong": "0 0% 100% / 0.72",
+                "glass-border": "220 30% 100% / 0.55",
+                "glass-highlight": "0 0% 100% / 0.85",
+                "glass-blur": "22px",
+                "glass-saturate": "1.7",
+                "glass-brightness": "1.05",
+                "glass-edge": "0 0% 100% / 0.9",
+                "glass-edge-soft": "0 0% 100% / 0.34",
+                "glass-shade": "222 47% 11% / 0.07",
+                "glass-refraction": "0 0% 50% / 0.04",
+                "glass-shadow": "0 1px 2px hsl(222 47% 11% / 0.08),\n    0 12px 32px hsl(222 47% 11% / 0.12),\n    0 32px 80px hsl(222 47% 11% / 0.14)"
+            },
+            "dark": {
+                "ui-shadow-sm": "none",
+                "ui-shadow-md": "none",
+                "ui-shadow-lg": "none",
+                "glass-bg": "224 20% 13% / 0.78",
+                "glass-bg-subtle": "224 20% 13% / 0.64",
+                "glass-bg-strong": "224 20% 13% / 0.9",
+                "glass-border": "210 30% 92% / 0.24",
+                "glass-highlight": "210 30% 96% / 0.1",
+                "glass-brightness": "1",
+                "glass-edge": "210 40% 98% / 0.24",
+                "glass-edge-soft": "210 40% 98% / 0.08",
+                "glass-shade": "240 40% 3% / 0.3",
+                "glass-refraction": "0 0% 50% / 0.04",
+                "glass-shadow": "0 1px 2px hsl(0 0% 0% / 0.3),\n    0 16px 40px hsl(0 0% 0% / 0.34),\n    0 40px 96px hsl(0 0% 0% / 0.38)"
+            }
+        },
+        "cssColors": {
+            "light": {
+                "canvas": "0 0% 100%",
+                "surface": "0 0% 100%",
+                "surface-muted": "0 0% 96%",
+                "surface-strong": "0 0% 91%",
+                "line": "0 0% 90%",
+                "ink": "0 0% 9%",
+                "ink-soft": "0 0% 32%",
+                "ink-muted": "0 0% 45%",
+                "brand": "0 0% 9%",
+                "brand-solid": "0 0% 9%",
+                "brand-soft": "0 0% 92%",
+                "on-brand": "0 0% 100%",
+                "accent": "0 0% 9%"
+            },
+            "dark": {
+                "canvas": "0 0% 7%",
+                "surface": "0 0% 7%",
+                "surface-muted": "0 0% 11%",
+                "surface-strong": "0 0% 19%",
+                "line": "0 0% 22%",
+                "ink": "0 0% 96%",
+                "ink-soft": "0 0% 80%",
+                "ink-muted": "0 0% 64%",
+                "brand": "0 0% 96%",
+                "brand-solid": "0 0% 96%",
+                "brand-soft": "0 0% 14%",
+                "on-brand": "0 0% 7%",
+                "accent": "0 0% 96%"
+            }
+        }
+    },
+    "glass": {
+        "radiusScale": 1.4,
+        "spacingScale": 1,
+        "borderWidth": 1,
+        "elevationScale": 1,
+        "fontFamily": [
+            "Montserrat",
+            "Avenir Next",
+            "Segoe UI",
+            "sans-serif"
+        ],
+        "material": "glass",
+        "colors": {
+            "light": {},
+            "dark": {}
+        },
+        "effects": {
+            "light": {
+                "ui-shadow-sm": "0 1px 2px hsl(222 47% 11% / 0.06)",
+                "ui-shadow-md": "0 8px 24px hsl(222 47% 11% / 0.08)",
+                "ui-shadow-lg": "0 24px 64px hsl(222 47% 11% / 0.14)",
+                "glass-bg": "0 0% 100% / 0.55",
+                "glass-bg-subtle": "0 0% 100% / 0.38",
+                "glass-bg-strong": "0 0% 100% / 0.72",
+                "glass-border": "220 30% 100% / 0.55",
+                "glass-highlight": "0 0% 100% / 0.85",
+                "glass-blur": "22px",
+                "glass-saturate": "1.7",
+                "glass-brightness": "1.05",
+                "glass-edge": "0 0% 100% / 0.9",
+                "glass-edge-soft": "0 0% 100% / 0.34",
+                "glass-shade": "222 47% 11% / 0.07",
+                "glass-refraction": "201 96% 32% / 0.08",
+                "glass-shadow": "0 1px 2px hsl(222 47% 11% / 0.08),\n    0 12px 32px hsl(222 47% 11% / 0.12),\n    0 32px 80px hsl(222 47% 11% / 0.14)"
+            },
+            "dark": {
+                "ui-shadow-sm": "0 1px 2px hsl(0 0% 0% / 0.18)",
+                "ui-shadow-md": "0 12px 32px hsl(0 0% 0% / 0.24)",
+                "ui-shadow-lg": "0 28px 80px hsl(0 0% 0% / 0.36)",
+                "glass-bg": "224 20% 13% / 0.78",
+                "glass-bg-subtle": "224 20% 13% / 0.64",
+                "glass-bg-strong": "224 20% 13% / 0.9",
+                "glass-border": "210 30% 92% / 0.24",
+                "glass-highlight": "210 30% 96% / 0.1",
+                "glass-brightness": "1",
+                "glass-edge": "210 40% 98% / 0.24",
+                "glass-edge-soft": "210 40% 98% / 0.08",
+                "glass-shade": "240 40% 3% / 0.3",
+                "glass-refraction": "199 91% 56% / 0.1",
+                "glass-shadow": "0 1px 2px hsl(0 0% 0% / 0.3),\n    0 16px 40px hsl(0 0% 0% / 0.34),\n    0 40px 96px hsl(0 0% 0% / 0.38)"
+            }
+        },
+        "cssColors": {
+            "light": {},
+            "dark": {}
+        }
+    }
+};

package/dist/theme.d.ts

@@ -1,3 +1,5 @@
+import { type LumenThemePreset } from './theme-presets.generated.js';
+export { type LumenSurfaceMaterial, type LumenThemePreset, lumenThemePresetDefinitions } from './theme-presets.generated.js';
 export type LumenThemeTokens = Record<string, string>;
 export interface LumenContrastScore {
     ratio: number;
@@ -17,9 +19,9 @@ export declare const lumenRadiusTokenNames: readonly ["ui-radius-sm", "ui-radius
 export declare const lumenShadowTokenNames: readonly ["ui-shadow-sm", "ui-shadow-md", "ui-shadow-lg"];
 export declare const lumenTypographyTokenNames: readonly ["ui-font"];
 export declare const lumenMotionTokenNames: readonly ["ui-duration-fast", "ui-duration", "ui-duration-slow", "ui-ease", "ui-ease-emphasized"];
-export declare const lumenStructureTokenNames: readonly ["ui-radius-sm", "ui-radius", "ui-radius-lg", "ui-shadow-sm", "ui-shadow-md", "ui-shadow-lg", "ui-font", "ui-duration-fast", "ui-duration", "ui-duration-slow", "ui-ease", "ui-ease-emphasized"];
+export declare const lumenStructureTokenNames: readonly ["ui-radius-sm", "ui-radius", "ui-radius-lg", "ui-shadow-sm", "ui-shadow-md", "ui-shadow-lg", "ui-font", "ui-duration-fast", "ui-duration", "ui-duration-slow", "ui-ease", "ui-ease-emphasized", "ui-border-width", "ui-space-zero", "ui-space-xs", "ui-space-sm", "ui-space-md", "ui-space-lg", "ui-space-xl", "ui-space-2xl", "ui-space-3xl"];
 export declare const lumenColorTokenNames: readonly ["canvas", "surface", "surface-muted", "surface-strong", "line", "ink", "ink-soft", "ink-muted", "brand", "brand-solid", "brand-soft", "on-brand", "accent", "success", "warning", "danger", "on-danger", "glass-bg", "glass-bg-subtle", "glass-bg-strong", "glass-border", "glass-highlight", "glass-edge", "glass-edge-soft", "glass-shade", "glass-refraction"];
-export declare const lumenTokenNames: readonly ["canvas", "surface", "surface-muted", "surface-strong", "line", "ink", "ink-soft", "ink-muted", "brand", "brand-solid", "brand-soft", "on-brand", "accent", "success", "warning", "danger", "on-danger", "glass-bg", "glass-bg-subtle", "glass-bg-strong", "glass-border", "glass-highlight", "glass-blur", "glass-saturate", "glass-brightness", "glass-edge", "glass-edge-soft", "glass-shade", "glass-refraction", "glass-shadow", "ui-radius-sm", "ui-radius", "ui-radius-lg", "ui-shadow-sm", "ui-shadow-md", "ui-shadow-lg", "ui-font", "ui-duration-fast", "ui-duration", "ui-duration-slow", "ui-ease", "ui-ease-emphasized"];
+export declare const lumenTokenNames: readonly ["canvas", "surface", "surface-muted", "surface-strong", "line", "ink", "ink-soft", "ink-muted", "brand", "brand-solid", "brand-soft", "on-brand", "accent", "success", "warning", "danger", "on-danger", "glass-bg", "glass-bg-subtle", "glass-bg-strong", "glass-border", "glass-highlight", "glass-blur", "glass-saturate", "glass-brightness", "glass-edge", "glass-edge-soft", "glass-shade", "glass-refraction", "glass-shadow", "ui-radius-sm", "ui-radius", "ui-radius-lg", "ui-shadow-sm", "ui-shadow-md", "ui-shadow-lg", "ui-font", "ui-duration-fast", "ui-duration", "ui-duration-slow", "ui-ease", "ui-ease-emphasized", "ui-border-width", "ui-space-zero", "ui-space-xs", "ui-space-sm", "ui-space-md", "ui-space-lg", "ui-space-xl", "ui-space-2xl", "ui-space-3xl"];
 export type LumenSemanticColorTokenName = typeof lumenSemanticColorTokenNames[number];
 export type LumenGlassColorTokenName = typeof lumenGlassColorTokenNames[number];
 export type LumenGlassEffectTokenName = typeof lumenGlassEffectTokenNames[number];
@@ -33,6 +35,13 @@ export type LumenStructureTokenName = typeof lumenStructureTokenNames[number];
 export type LumenThemeTokenName = typeof lumenTokenNames[number];
 export declare const exportThemeCss: (tokens: LumenThemeTokens, selector?: string) => string;
 export declare const parseThemeCss: (css: string) => LumenThemeTokens;
+export declare const mergeThemeTokens: (tokens: LumenThemeTokens, overrides: Partial<LumenThemeTokens>) => LumenThemeTokens;
+export interface LumenThemePresetOptions {
+    scheme?: 'dark' | 'light';
+    overrides?: Partial<LumenThemeTokens>;
+}
+/** A preset configures tokens; components retain explicit control of glass surfaces. */
+export declare const createThemePreset: (preset?: LumenThemePreset, options?: LumenThemePresetOptions) => LumenThemeTokens;
 export declare const createThemePalette: (brand: string, accent?: string) => LumenThemeTokens;
 export interface LumenThemeFromHueOptions {
     accentHue?: number;
@@ -47,7 +56,6 @@ export interface LumenThemeFromHueOptions {
 export declare const createThemeFromHue: (hue: number, options?: LumenThemeFromHueOptions) => LumenThemeTokens;
 export declare const getContrastRatio: (foreground: string, background: string) => number;
 export declare const scoreThemeContrast: (tokens: LumenThemeTokens, foreground?: string, background?: string) => LumenContrastScore;
-export declare const mergeThemeTokens: (tokens: LumenThemeTokens, overrides: Partial<LumenThemeTokens>) => LumenThemeTokens;
 export declare const suggestReadableInk: (background: string) => LumenThemeContrastSuggestion;
 export declare const tuneThemeContrast: (tokens: LumenThemeTokens, foreground?: string, background?: string) => LumenThemeTokens;
 //# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"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"}