@happyvertical/smrt-ui 0.30.0

package/dist/themes/registry.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Theme Registry
+ *
+ * Central registry for all available themes. Provides utilities for
+ * theme lookup, validation, and management.
+ */
+import type { Theme, ThemePreset } from './types.js';
+/**
+ * Map of all built-in themes
+ */
+export declare const themes: Record<ThemePreset, Theme>;
+/**
+ * List of available theme presets (built-in only)
+ */
+export declare const availablePresets: ThemePreset[];
+/**
+ * Get a theme by preset name
+ * Checks built-in themes first, then custom registered themes
+ * @param preset - Theme preset identifier
+ * @returns The theme definition
+ * @throws Error if preset is invalid
+ */
+export declare function getTheme(preset: ThemePreset): Theme;
+/**
+ * Check if a preset is valid (built-in or custom)
+ * @param preset - Value to check
+ * @returns True if valid theme preset
+ */
+export declare function isValidPreset(preset: string): preset is ThemePreset;
+/**
+ * Get theme display name
+ * @param preset - Theme preset
+ * @returns Human-readable theme name
+ */
+export declare function getThemeName(preset: ThemePreset): string;
+/**
+ * Get all themes as array (built-in only)
+ * @returns Array of theme definitions
+ */
+export declare function getAllThemes(): Theme[];
+/**
+ * Get theme options for UI selection
+ * @returns Array of {value, label} objects
+ */
+export declare function getThemeOptions(): {
+    value: ThemePreset;
+    label: string;
+}[];
+/**
+ * Register a custom theme in the registry
+ * @internal Use registerTheme from create-theme.ts instead
+ */
+export declare function registerCustomTheme(theme: Theme): void;
+/**
+ * Get a custom theme by id
+ * @internal
+ */
+export declare function getCustomTheme(id: string): Theme | undefined;
+/**
+ * Check if a custom theme is registered
+ * @internal
+ */
+export declare function hasCustomTheme(id: string): boolean;
+//# sourceMappingURL=registry.d.ts.map

package/dist/themes/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/themes/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,CAI7C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,EAAoC,CAAC;AAE/E;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAiBnD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,WAAW,CAInE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAMxD;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,KAAK,EAAE,CAEtC;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CASzE;AAOD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAEtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAE5D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAElD"}

package/dist/themes/registry.js

@@ -0,0 +1,122 @@
+/**
+ * Theme Registry
+ *
+ * Central registry for all available themes. Provides utilities for
+ * theme lookup, validation, and management.
+ */
+import { glassTheme } from './glass/index.js';
+import { materialTheme } from './material/index.js';
+import { studioTheme } from './studio/index.js';
+/**
+ * Map of all built-in themes
+ */
+export const themes = {
+    material: materialTheme,
+    glass: glassTheme,
+    studio: studioTheme,
+};
+/**
+ * List of available theme presets (built-in only)
+ */
+export const availablePresets = ['material', 'glass', 'studio'];
+/**
+ * Get a theme by preset name
+ * Checks built-in themes first, then custom registered themes
+ * @param preset - Theme preset identifier
+ * @returns The theme definition
+ * @throws Error if preset is invalid
+ */
+export function getTheme(preset) {
+    // Check built-in themes first
+    const builtInTheme = themes[preset];
+    if (builtInTheme) {
+        return builtInTheme;
+    }
+    // Check custom themes (imported dynamically to avoid circular deps)
+    // This will be populated by registerTheme from create-theme.ts
+    const customTheme = getCustomTheme(preset);
+    if (customTheme) {
+        return customTheme;
+    }
+    throw new Error(`Unknown theme preset: ${preset}. Available: ${getAllPresetNames().join(', ')}`);
+}
+/**
+ * Check if a preset is valid (built-in or custom)
+ * @param preset - Value to check
+ * @returns True if valid theme preset
+ */
+export function isValidPreset(preset) {
+    return (availablePresets.includes(preset) || hasCustomTheme(preset));
+}
+/**
+ * Get theme display name
+ * @param preset - Theme preset
+ * @returns Human-readable theme name
+ */
+export function getThemeName(preset) {
+    const theme = themes[preset];
+    if (theme)
+        return theme.name;
+    const customTheme = getCustomTheme(preset);
+    return customTheme?.name ?? preset;
+}
+/**
+ * Get all themes as array (built-in only)
+ * @returns Array of theme definitions
+ */
+export function getAllThemes() {
+    return Object.values(themes);
+}
+/**
+ * Get theme options for UI selection
+ * @returns Array of {value, label} objects
+ */
+export function getThemeOptions() {
+    const builtInOptions = availablePresets.map((preset) => ({
+        value: preset,
+        label: themes[preset].name,
+    }));
+    const customOptions = getCustomThemeOptions();
+    return [...builtInOptions, ...customOptions];
+}
+// --- Custom Theme Support ---
+// WeakMap to store custom themes without polluting module scope
+const customThemeRegistry = new Map();
+/**
+ * Register a custom theme in the registry
+ * @internal Use registerTheme from create-theme.ts instead
+ */
+export function registerCustomTheme(theme) {
+    customThemeRegistry.set(theme.id, theme);
+}
+/**
+ * Get a custom theme by id
+ * @internal
+ */
+export function getCustomTheme(id) {
+    return customThemeRegistry.get(id);
+}
+/**
+ * Check if a custom theme is registered
+ * @internal
+ */
+export function hasCustomTheme(id) {
+    return customThemeRegistry.has(id);
+}
+/**
+ * Get all custom theme options for UI
+ * @internal
+ */
+function getCustomThemeOptions() {
+    return Array.from(customThemeRegistry.entries()).map(([id, theme]) => ({
+        value: id,
+        label: theme.name,
+    }));
+}
+/**
+ * Get all preset names including custom themes
+ * @internal
+ */
+function getAllPresetNames() {
+    return [...availablePresets, ...customThemeRegistry.keys()];
+}

package/dist/themes/shared.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Shared Theme Tokens
+ *
+ * Common spacing, border radius, and duration scales used across all themes.
+ */
+import type { BorderRadiusScale, DurationScale, EasingScale, SpacingScale } from './types.js';
+/**
+ * Shared spacing scale (consistent across all themes)
+ */
+export declare const spacingScale: SpacingScale;
+/**
+ * Material-3 spacing aliases (issue #1431).
+ *
+ * Components authored against Material-3 vocabulary consume `--smrt-spacing-sm`
+ * / `-md` / `-xl` etc. The numeric scale above is canonical; these aliases map
+ * the named sizes onto numeric-scale keys so both vocabularies resolve. Emitted
+ * in addition to (never instead of) the numeric scale.
+ */
+export declare const spacingAliases: Record<string, keyof SpacingScale>;
+/**
+ * Shared border radius scale
+ */
+export declare const borderRadiusScale: BorderRadiusScale;
+/**
+ * Material-3 border-radius aliases (issue #1431).
+ *
+ * Maps Material-3 named radii (`extra-small` … `extra-large`) onto the
+ * canonical t-shirt scale. Emitted in addition to the canonical names.
+ */
+export declare const borderRadiusAliases: Record<string, keyof BorderRadiusScale>;
+/**
+ * Shared duration scale
+ */
+export declare const durationScale: DurationScale;
+/**
+ * Material-3 motion-duration aliases (issue #1431).
+ *
+ * Components consume Material-3 motion tokens (`short2`, `short3`, `medium1`…).
+ * These map onto absolute millisecond values following the M3 motion spec
+ * (short1=50 … long4=600). Emitted in addition to the canonical
+ * instant/fast/normal/slow/slower scale so both vocabularies resolve.
+ */
+export declare const durationAliases: Record<string, string>;
+/**
+ * Shared font-family aliases (issue #1431).
+ *
+ * The base body font is `--smrt-font-family`; components also reference a
+ * monospace family. Emitted as an explicit token so monospace surfaces (code,
+ * transcripts, module IDs) are themeable rather than frozen at a fallback.
+ */
+export declare const fontFamilyAliases: Record<string, string>;
+/**
+ * Shared named font-weight tokens (issue #1431).
+ *
+ * The typography scale exposes per-variant weights; these named weights cover
+ * generic emphasis (badges, progress labels) that aren't tied to a variant.
+ */
+export declare const fontWeightTokens: Record<string, string>;
+/**
+ * Shared z-index scale (issue #1431).
+ *
+ * Stacking-context tokens for overlay surfaces so consumers stop hardcoding
+ * magic numbers and overlays can be re-layered theme-wide.
+ */
+export declare const zIndexTokens: Record<string, string>;
+/**
+ * Material Design 3 easings
+ */
+export declare const materialEasing: EasingScale;
+/**
+ * Apple-style easings (for Glass theme)
+ */
+export declare const appleEasing: EasingScale;
+/**
+ * Studio-style easings (for Studio theme - snappier)
+ */
+export declare const studioEasing: EasingScale;
+//# sourceMappingURL=shared.d.ts.map

package/dist/themes/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/themes/shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,YAsB1B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,YAAY,CAQ7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,iBAS/B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,iBAAiB,CAMvE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,aAM3B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAalD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEpD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKnD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAW/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,WAO5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,WAOzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,WAO1B,CAAC"}

package/dist/themes/shared.js

@@ -0,0 +1,179 @@
+/**
+ * Shared Theme Tokens
+ *
+ * Common spacing, border radius, and duration scales used across all themes.
+ */
+/**
+ * Shared spacing scale (consistent across all themes)
+ */
+export const spacingScale = {
+    0: '0',
+    0.5: '0.125rem',
+    1: '0.25rem',
+    1.5: '0.375rem',
+    2: '0.5rem',
+    2.5: '0.625rem',
+    3: '0.75rem',
+    3.5: '0.875rem',
+    4: '1rem',
+    5: '1.25rem',
+    6: '1.5rem',
+    7: '1.75rem',
+    8: '2rem',
+    9: '2.25rem',
+    10: '2.5rem',
+    11: '2.75rem',
+    12: '3rem',
+    14: '3.5rem',
+    16: '4rem',
+    20: '5rem',
+    24: '6rem',
+};
+/**
+ * Material-3 spacing aliases (issue #1431).
+ *
+ * Components authored against Material-3 vocabulary consume `--smrt-spacing-sm`
+ * / `-md` / `-xl` etc. The numeric scale above is canonical; these aliases map
+ * the named sizes onto numeric-scale keys so both vocabularies resolve. Emitted
+ * in addition to (never instead of) the numeric scale.
+ */
+export const spacingAliases = {
+    xs: 1, // 0.25rem
+    sm: 2, // 0.5rem
+    md: 4, // 1rem
+    lg: 6, // 1.5rem
+    xl: 8, // 2rem
+    '2xl': 12, // 3rem
+    '3xl': 16, // 4rem
+};
+/**
+ * Shared border radius scale
+ */
+export const borderRadiusScale = {
+    none: '0',
+    sm: '0.25rem',
+    md: '0.5rem',
+    lg: '0.75rem',
+    xl: '1rem',
+    '2xl': '1.5rem',
+    '3xl': '2rem',
+    full: '9999px',
+};
+/**
+ * Material-3 border-radius aliases (issue #1431).
+ *
+ * Maps Material-3 named radii (`extra-small` … `extra-large`) onto the
+ * canonical t-shirt scale. Emitted in addition to the canonical names.
+ */
+export const borderRadiusAliases = {
+    'extra-small': 'sm',
+    small: 'sm',
+    medium: 'md',
+    large: 'lg',
+    'extra-large': 'xl',
+};
+/**
+ * Shared duration scale
+ */
+export const durationScale = {
+    instant: '0ms',
+    fast: '100ms',
+    normal: '200ms',
+    slow: '300ms',
+    slower: '500ms',
+};
+/**
+ * Material-3 motion-duration aliases (issue #1431).
+ *
+ * Components consume Material-3 motion tokens (`short2`, `short3`, `medium1`…).
+ * These map onto absolute millisecond values following the M3 motion spec
+ * (short1=50 … long4=600). Emitted in addition to the canonical
+ * instant/fast/normal/slow/slower scale so both vocabularies resolve.
+ */
+export const durationAliases = {
+    short1: '50ms',
+    short2: '100ms',
+    short3: '150ms',
+    short4: '200ms',
+    medium1: '250ms',
+    medium2: '300ms',
+    medium3: '350ms',
+    medium4: '400ms',
+    long1: '450ms',
+    long2: '500ms',
+    long3: '550ms',
+    long4: '600ms',
+};
+/**
+ * Shared font-family aliases (issue #1431).
+ *
+ * The base body font is `--smrt-font-family`; components also reference a
+ * monospace family. Emitted as an explicit token so monospace surfaces (code,
+ * transcripts, module IDs) are themeable rather than frozen at a fallback.
+ */
+export const fontFamilyAliases = {
+    mono: 'ui-monospace, "SF Mono", "Monaco", "Cascadia Code", "Consolas", monospace',
+};
+/**
+ * Shared named font-weight tokens (issue #1431).
+ *
+ * The typography scale exposes per-variant weights; these named weights cover
+ * generic emphasis (badges, progress labels) that aren't tied to a variant.
+ */
+export const fontWeightTokens = {
+    normal: '400',
+    medium: '500',
+    semibold: '600',
+    bold: '700',
+};
+/**
+ * Shared z-index scale (issue #1431).
+ *
+ * Stacking-context tokens for overlay surfaces so consumers stop hardcoding
+ * magic numbers and overlays can be re-layered theme-wide.
+ */
+export const zIndexTokens = {
+    dropdown: '1000',
+    sticky: '1100',
+    overlay: '1200',
+    modal: '1300',
+    dialog: '1300',
+    popover: '1400',
+    toast: '1500',
+    tooltip: '1600',
+    // Full-screen blocking loaders must sit above ALL other layers (#1373).
+    loading: '1700',
+};
+/**
+ * Material Design 3 easings
+ */
+export const materialEasing = {
+    standard: 'cubic-bezier(0.2, 0, 0, 1)',
+    standardDecelerate: 'cubic-bezier(0, 0, 0.2, 1)',
+    standardAccelerate: 'cubic-bezier(0.3, 0, 1, 1)',
+    emphasized: 'cubic-bezier(0.2, 0, 0, 1)',
+    emphasizedDecelerate: 'cubic-bezier(0.05, 0.7, 0.1, 1)',
+    emphasizedAccelerate: 'cubic-bezier(0.3, 0, 0.8, 0.15)',
+};
+/**
+ * Apple-style easings (for Glass theme)
+ */
+export const appleEasing = {
+    standard: 'cubic-bezier(0.4, 0, 0.2, 1)',
+    standardDecelerate: 'cubic-bezier(0, 0, 0.2, 1)',
+    standardAccelerate: 'cubic-bezier(0.4, 0, 1, 1)',
+    emphasized: 'cubic-bezier(0.2, 0.8, 0.2, 1)',
+    emphasizedDecelerate: 'cubic-bezier(0.16, 1, 0.3, 1)',
+    emphasizedAccelerate: 'cubic-bezier(0.4, 0, 0.2, 1)',
+};
+/**
+ * Studio-style easings (for Studio theme - snappier)
+ */
+export const studioEasing = {
+    standard: 'cubic-bezier(0.4, 0, 0.2, 1)',
+    standardDecelerate: 'cubic-bezier(0, 0, 0.2, 1)',
+    standardAccelerate: 'cubic-bezier(0.4, 0, 1, 1)',
+    emphasized: 'cubic-bezier(0.25, 0.1, 0.25, 1)',
+    emphasizedDecelerate: 'cubic-bezier(0.0, 0, 0.2, 1)',
+    emphasizedAccelerate: 'cubic-bezier(0.4, 0, 1, 1)',
+};

package/dist/themes/studio/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Studio Theme
+ *
+ * Google AI Studio-inspired flat design theme.
+ * Minimal shadows, monochromatic base with vibrant accents,
+ * clean lines, and a focus on content clarity.
+ */
+import type { Theme } from '../types.js';
+/**
+ * Studio theme definition
+ */
+export declare const studioTheme: Theme;
+export default studioTheme;
+//# sourceMappingURL=index.d.ts.map

package/dist/themes/studio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/themes/studio/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAGV,KAAK,EAEN,MAAM,aAAa,CAAC;AA+QrB;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,KAYzB,CAAC;AAEF,eAAe,WAAW,CAAC"}