@vobs/ui 0.3.0 → 1.0.0

package/dist/theme-data.js

@@ -1,417 +0,0 @@
-/** @license MIT
- * Copyright (c) 2026 vobsjs
- * @vobs/ui
- */
-export const DEFAULT_THEME = 'dark';
-export const DEFAULT_BRAND_ID = 'green';
-export const DEFAULT_BRAND_COLOR = '#32F08C';
-export const brandPresets = [
-    { id: 'green', label: 'Nimbus Green', color: DEFAULT_BRAND_COLOR },
-    { id: 'blue', label: 'Nimbus Blue', color: '#80C1FF' },
-    { id: 'purple', label: 'Nimbus Purple', color: '#8E80FF' },
-    { id: 'yellow', label: 'Nimbus Yellow', color: '#FFD080' },
-    { id: 'red', label: 'Nimbus Red', color: '#FF8080' },
-    { id: 'teal', label: 'Nimbus Teal', color: '#2DD288' },
-    { id: 'cyan', label: 'Nimbus Cyan', color: '#04CBE5' },
-    { id: 'violet', label: 'Nimbus Violet', color: '#BFA5FF' },
-    { id: 'slate', label: 'Nimbus Slate', color: '#AFB9CF' },
-    { id: 'neutral', label: 'Nimbus Neutral', color: '#BABABA' },
-];
-export const primitiveTokenValues = {
-    '--radius-2': '2px',
-    '--radius-4': '4px',
-    '--radius-6': '6px',
-    '--radius-8': '8px',
-    '--radius-10': '10px',
-    '--radius-full': '9999px',
-    '--spacer-0': '0px',
-    '--spacer-2': '2px',
-    '--spacer-4': '4px',
-    '--spacer-6': '6px',
-    '--spacer-8': '8px',
-    '--spacer-10': '10px',
-    '--spacer-12': '12px',
-    '--spacer-14': '14px',
-    '--spacer-16': '16px',
-    '--spacer-20': '20px',
-    '--spacer-24': '24px',
-    '--spacer-32': '32px',
-    '--spacer-40': '40px',
-    '--k-icon-xs': '14px',
-    '--k-icon-sm': '16px',
-    '--k-icon-md': '20px',
-    '--k-icon-lg': '24px',
-    '--font-family-default': 'SF Pro Text',
-    '--font-family-heading': 'SF Pro',
-    '--font-family-mono': 'JetBrains Mono',
-    '--font-family-base': 'var(--font-family-default)',
-    '--font-family-heading-alias': 'var(--font-family-heading)',
-    '--font-family-mono-alias': 'var(--font-family-mono)',
-    '--body-xs-font-family': '"SF Pro Text", system-ui, -apple-system, sans-serif',
-    '--body-xs-font-size': '10px',
-    '--body-xs-font-weight': '400',
-    '--body-xs-line-height': '14px',
-    '--body-sm-font-family': '"SF Pro Text", system-ui, -apple-system, sans-serif',
-    '--body-sm-font-size': '11px',
-    '--body-sm-font-weight': '400',
-    '--body-sm-line-height': '16px',
-    '--body-sm-strong-font-family': '"SF Pro Text", system-ui, -apple-system, sans-serif',
-    '--body-sm-strong-font-size': '11px',
-    '--body-sm-strong-font-weight': '500',
-    '--body-sm-strong-line-height': '16px',
-    '--body-md-font-family': '"SF Pro Text", system-ui, -apple-system, sans-serif',
-    '--body-md-font-size': '12px',
-    '--body-md-font-weight': '400',
-    '--body-md-line-height': '18px',
-    '--body-md-strong-font-family': '"SF Pro Text", system-ui, -apple-system, sans-serif',
-    '--body-md-strong-font-size': '12px',
-    '--body-md-strong-font-weight': '500',
-    '--body-md-strong-line-height': '18px',
-    '--body-base-font-family': '"SF Pro Text", system-ui, -apple-system, sans-serif',
-    '--body-base-font-size': '13px',
-    '--body-base-font-weight': '400',
-    '--body-base-line-height': '20px',
-    '--body-base-strong-font-family': '"SF Pro Text", system-ui, -apple-system, sans-serif',
-    '--body-base-strong-font-size': '13px',
-    '--body-base-strong-font-weight': '500',
-    '--body-base-strong-line-height': '20px',
-    '--heading-3xs-font-family': '"SF Pro Text", system-ui, -apple-system, sans-serif',
-    '--heading-3xs-font-size': '11px',
-    '--heading-3xs-font-weight': '600',
-    '--heading-3xs-line-height': '16px',
-    '--heading-2xs-font-family': '"SF Pro Text", system-ui, -apple-system, sans-serif',
-    '--heading-2xs-font-size': '12px',
-    '--heading-2xs-font-weight': '600',
-    '--heading-2xs-line-height': '18px',
-    '--heading-xs-font-family': '"SF Pro Text", system-ui, -apple-system, sans-serif',
-    '--heading-xs-font-size': '13px',
-    '--heading-xs-font-weight': '600',
-    '--heading-xs-line-height': '20px',
-    '--heading-sm-font-family': '"SF Pro Text", system-ui, -apple-system, sans-serif',
-    '--heading-sm-font-size': '16px',
-    '--heading-sm-font-weight': '600',
-    '--heading-sm-line-height': '24px',
-    '--heading-md-font-family': '"SF Pro", system-ui, -apple-system, sans-serif',
-    '--heading-md-font-size': '20px',
-    '--heading-md-font-weight': '600',
-    '--heading-md-line-height': '28px',
-    '--heading-lg-font-family': '"SF Pro", system-ui, -apple-system, sans-serif',
-    '--heading-lg-font-size': '22px',
-    '--heading-lg-font-weight': '600',
-    '--heading-lg-line-height': '30px',
-    '--heading-xl-font-family': '"SF Pro", system-ui, -apple-system, sans-serif',
-    '--heading-xl-font-size': '24px',
-    '--heading-xl-font-weight': '600',
-    '--heading-xl-line-height': '32px',
-    '--heading-2xl-font-family': '"SF Pro", system-ui, -apple-system, sans-serif',
-    '--heading-2xl-font-size': '28px',
-    '--heading-2xl-font-weight': '600',
-    '--heading-2xl-line-height': '36px',
-    '--heading-3xl-font-family': '"SF Pro", system-ui, -apple-system, sans-serif',
-    '--heading-3xl-font-size': '32px',
-    '--heading-3xl-font-weight': '600',
-    '--heading-3xl-line-height': '40px',
-    '--code-editor-font-family': '"JetBrains Mono", system-ui, -apple-system, sans-serif',
-    '--code-editor-font-size': '13px',
-    '--code-editor-font-weight': '450',
-    '--code-editor-line-height': '20px',
-    '--code-terminal-font-family': '"JetBrains Mono", system-ui, -apple-system, sans-serif',
-    '--code-terminal-font-size': '12px',
-    '--code-terminal-font-weight': '450',
-    '--code-terminal-line-height': '18px',
-    '--font-weight-default': '400',
-    '--font-weight-regular': 'var(--font-weight-default)',
-    '--font-weight-code': '450',
-    '--font-weight-medium': '500',
-    '--font-weight-strong': '600',
-    '--font-weight-semibold': 'var(--font-weight-strong)',
-    '--z-index-dropdown': '2000',
-    '--z-index-drawer': '2500',
-    '--z-index-modal': '3000',
-    '--z-index-notification': '3500',
-    '--z-index-tooltip': '4000',
-    '--transition-fast': '0.12s ease',
-    '--transition-normal': '0.2s ease',
-    '--transition-slow': '0.3s ease',
-    '--breakpoint-sm': '576px',
-    '--breakpoint-md': '768px',
-    '--breakpoint-lg': '1024px',
-    '--breakpoint-xl': '1280px',
-};
-const semanticAliases = {
-    '--color-background': 'var(--bg-base-default)',
-    '--color-surface': 'var(--bg-base-secondary)',
-    '--color-surface-variant': 'var(--bg-base-tertiary)',
-    '--color-overlay-1': 'var(--bg-overlay-l1)',
-    '--color-overlay-2': 'var(--bg-overlay-l2)',
-    '--color-overlay-3': 'var(--bg-overlay-l3)',
-    '--color-overlay-4': 'var(--bg-overlay-l4)',
-    '--color-card': 'var(--bg-base-secondary)',
-    '--color-tooltip': 'var(--bg-tooltip)',
-    '--color-menu': 'var(--bg-menu)',
-    '--color-foreground': 'var(--text-default)',
-    '--color-foreground-hover': 'var(--text-default-hover)',
-    '--color-on-surface': 'var(--text-default)',
-    '--color-on-surface-variant': 'var(--text-secondary)',
-    '--color-muted-foreground': 'var(--text-secondary)',
-    '--color-disabled-foreground': 'var(--text-disabled)',
-    '--color-border': 'var(--border-neutral-l1)',
-    '--color-border-strong': 'var(--border-neutral-l2)',
-    '--color-border-stronger': 'var(--border-neutral-l3)',
-    '--color-border-contrast': 'var(--border-contrast)',
-    '--color-outline': 'var(--border-neutral-l1)',
-    '--color-primary': 'var(--bg-brand)',
-    '--color-primary-hover': 'var(--bg-brand-hover)',
-    '--color-primary-disabled': 'var(--bg-brand-disabled)',
-    '--color-primary-soft': 'var(--bg-brand-popup)',
-    '--color-accent': 'var(--bg-brand)',
-    '--color-on-primary': 'var(--text-onbrand)',
-    '--color-info': 'var(--status-primary-default)',
-    '--color-success': 'var(--status-success-default)',
-    '--color-warning': 'var(--status-warning-default)',
-    '--color-error': 'var(--status-error-default)',
-    '--color-error-soft': 'var(--status-error-surface-l1)',
-    '--color-foreground-muted': 'var(--text-secondary)',
-    '--accent-blue': 'var(--status-primary-default)',
-    '--code-string': 'var(--code-text)',
-};
-export const themeTokenValues = {
-    dark: {
-        '--bg-base-default': '#1A1B1D',
-        '--bg-base-secondary': '#222427',
-        '--bg-base-tertiary': '#2A2D31',
-        '--bg-tooltip': '#1A1B1D',
-        '--bg-menu': '#202123',
-        '--bg-invert': '#DADDE5',
-        '--bg-invert-hover': '#EDEFF2',
-        '--bg-invert-active': '#979AA4',
-        '--bg-invert-disabled': 'rgba(224, 226, 242, 0.12)',
-        '--bg-overlay-l1': 'rgba(224, 226, 242, 0.04)',
-        '--bg-overlay-l2': 'rgba(224, 226, 242, 0.06)',
-        '--bg-overlay-l3': 'rgba(224, 226, 242, 0.08)',
-        '--bg-overlay-l4': 'rgba(224, 226, 242, 0.12)',
-        '--text-default': '#D1D3DB',
-        '--text-default-hover': '#F5F9FE',
-        '--text-default-active': '#F5F9FE',
-        '--text-secondary': '#9599A6',
-        '--text-secondary-hover': '#D1D3DB',
-        '--text-secondary-active': '#D1D3DB',
-        '--text-tertiary': '#666B75',
-        '--text-disabled': '#666B75',
-        '--text-onbrand': '#0C0C0D',
-        '--text-onaccent': '#0C0C0D',
-        '--icon-default': '#D1D3DB',
-        '--icon-default-hover': '#F5F9FE',
-        '--icon-default-active': '#F5F9FE',
-        '--icon-secondary': '#9599A6',
-        '--icon-secondary-hover': '#D1D3DB',
-        '--icon-secondary-active': '#D1D3DB',
-        '--icon-tertiary': '#666B75',
-        '--icon-disabled': '#666B75',
-        '--icon-onbrand': '#0C0C0D',
-        '--icon-onaccent': '#0C0C0D',
-        '--border-neutral-l1': 'rgba(224, 226, 242, 0.1)',
-        '--border-neutral-l2': 'rgba(224, 226, 242, 0.16)',
-        '--border-neutral-l3': 'rgba(224, 226, 242, 0.2)',
-        '--border-contrast': '#FFFFFF',
-        '--status-primary-default': '#387BFF',
-        '--status-primary-hover': '#4C88FF',
-        '--status-primary-active': '#1759DD',
-        '--status-primary-surface-l1': 'rgba(53, 121, 255, 0.18)',
-        '--status-primary-surface-l2': 'rgba(53, 121, 255, 0.28)',
-        '--status-primary-surface-l3': 'rgba(53, 121, 255, 0.36)',
-        '--status-info-default': 'var(--status-primary-default)',
-        '--status-info-surface-l1': 'var(--status-primary-surface-l1)',
-        '--status-success-default': '#33C192',
-        '--status-success-hover': '#5ED4AD',
-        '--status-success-active': '#27B082',
-        '--status-success-surface-l1': 'rgba(0, 165, 110, 0.18)',
-        '--status-success-surface-l2': 'rgba(0, 165, 110, 0.28)',
-        '--status-success-surface-l3': 'rgba(0, 165, 110, 0.36)',
-        '--status-alert-default': '#D29D00',
-        '--status-alert-hover': '#DFB949',
-        '--status-alert-active': '#AB8820',
-        '--status-alert-surface-l1': 'rgba(210, 157, 0, 0.16)',
-        '--status-alert-surface-l2': 'rgba(210, 157, 0, 0.28)',
-        '--status-alert-surface-l3': 'rgba(210, 157, 0, 0.36)',
-        '--status-warning-default': '#D27E24',
-        '--status-warning-hover': '#D78B28',
-        '--status-warning-active': '#B46510',
-        '--status-warning-surface-l1': 'rgba(210, 126, 36, 0.16)',
-        '--status-warning-surface-l2': 'rgba(210, 126, 36, 0.28)',
-        '--status-warning-surface-l3': 'rgba(210, 126, 36, 0.36)',
-        '--status-error-default': '#F65A5A',
-        '--status-error-hover': '#F86262',
-        '--status-error-active': '#B33636',
-        '--status-error-surface-l1': 'rgba(246, 70, 70, 0.18)',
-        '--status-error-surface-l2': 'rgba(246, 70, 70, 0.28)',
-        '--status-error-surface-l3': 'rgba(246, 70, 70, 0.36)',
-        '--code-text': '#E0E3EE',
-        '--code-doc': '#7F838C',
-        '--code-link': '#3C7EFF',
-        '--code-number': '#F48CCA',
-        '--code-action': '#B38CFF',
-        '--code-instruction': '#F0D8FF',
-        '--code-function': '#F29D79',
-        '--code-constant': '#80BBFF',
-        '--code-parameter': '#82D99F',
-        '--code-attribute': '#DED47E',
-        '--code-tag': '#F2858C',
-        ...semanticAliases,
-    },
-    light: {
-        '--bg-base-default': '#FFFFFF',
-        '--bg-base-secondary': '#F5F6F8',
-        '--bg-base-tertiary': '#EDF0F5',
-        '--bg-tooltip': '#0F1117',
-        '--bg-menu': '#FFFFFF',
-        '--bg-invert': '#0F1117',
-        '--bg-invert-hover': '#1F2937',
-        '--bg-invert-active': '#374151',
-        '--bg-invert-disabled': 'rgba(15, 17, 23, 0.12)',
-        '--bg-overlay-l1': 'rgba(0, 0, 0, 0.04)',
-        '--bg-overlay-l2': 'rgba(0, 0, 0, 0.06)',
-        '--bg-overlay-l3': 'rgba(0, 0, 0, 0.08)',
-        '--bg-overlay-l4': 'rgba(0, 0, 0, 0.12)',
-        '--text-default': '#0F1117',
-        '--text-default-hover': '#000000',
-        '--text-default-active': '#000000',
-        '--text-secondary': '#4B5563',
-        '--text-secondary-hover': '#1F2937',
-        '--text-secondary-active': '#1F2937',
-        '--text-tertiary': '#5B6370',
-        '--text-disabled': '#525A68',
-        '--text-onbrand': '#FFFFFF',
-        '--text-onaccent': '#FFFFFF',
-        '--icon-default': '#0F1117',
-        '--icon-default-hover': '#000000',
-        '--icon-default-active': '#000000',
-        '--icon-secondary': '#4B5563',
-        '--icon-secondary-hover': '#1F2937',
-        '--icon-secondary-active': '#1F2937',
-        '--icon-tertiary': '#5B6370',
-        '--icon-disabled': '#525A68',
-        '--icon-onbrand': '#FFFFFF',
-        '--icon-onaccent': '#FFFFFF',
-        '--border-neutral-l1': 'rgba(0, 0, 0, 0.12)',
-        '--border-neutral-l2': 'rgba(0, 0, 0, 0.18)',
-        '--border-neutral-l3': 'rgba(0, 0, 0, 0.25)',
-        '--border-contrast': '#0F1117',
-        '--status-success-default': '#16A34A',
-        '--status-warning-default': '#CA8A04',
-        '--status-error-default': '#DC2626',
-        '--status-info-default': '#2E69FF',
-        '--status-success-surface-l1': 'rgba(22, 163, 74, 0.08)',
-        '--status-warning-surface-l1': 'rgba(202, 138, 4, 0.08)',
-        '--status-error-surface-l1': 'rgba(220, 38, 38, 0.08)',
-        '--status-info-surface-l1': 'rgba(46, 105, 255, 0.08)',
-        ...semanticAliases,
-    },
-};
-export function resolveBrandColor(value = DEFAULT_BRAND_ID) {
-    if (typeof value === 'object') {
-        const color = normalizeHexColor(value.color);
-        return {
-            id: value.id?.trim() || 'custom',
-            label: value.label?.trim() || value.id?.trim() || color,
-            color,
-        };
-    }
-    const input = value.trim();
-    const preset = brandPresets.find((item) => item.id === input || item.color.toLowerCase() === input.toLowerCase());
-    if (preset !== undefined)
-        return preset;
-    const color = normalizeHexColor(input);
-    return { id: 'custom', label: color, color };
-}
-export function deriveBrandTokens(color) {
-    const normalized = normalizeHexColor(color);
-    if (normalized === DEFAULT_BRAND_COLOR) {
-        return {
-            background: DEFAULT_BRAND_COLOR,
-            hover: '#0FDC78',
-            disabled: 'rgba(50, 240, 140, 0.2)',
-            soft: 'rgba(50, 240, 140, 0.12)',
-            onBrand: '#0C0C0D',
-        };
-    }
-    const dark = perceivedBrightness(normalized) < 150;
-    return {
-        background: normalized,
-        hover: mixHex(normalized, dark ? '#FFFFFF' : '#000000', 0.14),
-        disabled: hexToRgba(normalized, 0.3),
-        soft: hexToRgba(normalized, 0.12),
-        onBrand: contrastRatio(normalized, '#FFFFFF') >= contrastRatio(normalized, '#0C0C0D')
-            ? '#FFFFFF'
-            : '#0C0C0D',
-    };
-}
-export function deriveBrandTextColor(color) {
-    const normalized = normalizeHexColor(color);
-    if (contrastRatio(normalized, '#FFFFFF') >= 4.5)
-        return normalized;
-    let low = 0;
-    let high = 1;
-    for (let index = 0; index < 24; index += 1) {
-        const amount = (low + high) / 2;
-        const candidate = mixHex(normalized, '#000000', amount);
-        if (contrastRatio(candidate, '#FFFFFF') >= 4.5)
-            high = amount;
-        else
-            low = amount;
-    }
-    return mixHex(normalized, '#000000', high);
-}
-export function normalizeHexColor(value) {
-    const input = value.trim();
-    const short = /^#?([0-9a-f]{3})$/iu.exec(input);
-    if (short?.[1] !== undefined) {
-        return `#${Array.from(short[1], (character) => character.repeat(2)).join('')}`.toUpperCase();
-    }
-    const full = /^#?([0-9a-f]{6})$/iu.exec(input);
-    if (full?.[1] !== undefined)
-        return `#${full[1]}`.toUpperCase();
-    throw new TypeError(`Invalid brand color: ${value}`);
-}
-export function contrastRatio(left, right) {
-    const leftLuminance = relativeLuminance(normalizeHexColor(left));
-    const rightLuminance = relativeLuminance(normalizeHexColor(right));
-    const lighter = Math.max(leftLuminance, rightLuminance);
-    const darker = Math.min(leftLuminance, rightLuminance);
-    return (lighter + 0.05) / (darker + 0.05);
-}
-function relativeLuminance(color) {
-    const { red, green, blue } = hexToRgb(color);
-    const linear = (channel) => {
-        const value = channel / 255;
-        return value <= 0.04045 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
-    };
-    return 0.2126 * linear(red) + 0.7152 * linear(green) + 0.0722 * linear(blue);
-}
-function perceivedBrightness(color) {
-    const { red, green, blue } = hexToRgb(color);
-    return red * 0.299 + green * 0.587 + blue * 0.114;
-}
-function mixHex(color, target, amount) {
-    const sourceRgb = hexToRgb(color);
-    const targetRgb = hexToRgb(target);
-    const mix = (source, destination) => Math.round(source + (destination - source) * amount);
-    return rgbToHex(mix(sourceRgb.red, targetRgb.red), mix(sourceRgb.green, targetRgb.green), mix(sourceRgb.blue, targetRgb.blue));
-}
-function hexToRgba(color, alpha) {
-    const { red, green, blue } = hexToRgb(color);
-    return `rgba(${red}, ${green}, ${blue}, ${alpha})`;
-}
-function hexToRgb(color) {
-    const normalized = normalizeHexColor(color).slice(1);
-    return {
-        red: Number.parseInt(normalized.slice(0, 2), 16),
-        green: Number.parseInt(normalized.slice(2, 4), 16),
-        blue: Number.parseInt(normalized.slice(4, 6), 16),
-    };
-}
-function rgbToHex(red, green, blue) {
-    return `#${[red, green, blue]
-        .map((channel) => channel.toString(16).padStart(2, '0'))
-        .join('')}`.toUpperCase();
-}

package/dist/theme.d.ts

@@ -1,97 +0,0 @@
-/** @license MIT
- * Copyright (c) 2026 vobsjs
- * @vobs/ui
- */
-import { type BrandColor, type BrandInput, type ThemeName } from './theme-data.js';
-export { brandPresets, contrastRatio, DEFAULT_BRAND_COLOR, DEFAULT_BRAND_ID, DEFAULT_THEME, deriveBrandTokens, deriveBrandTextColor, normalizeHexColor, resolveBrandColor, type BrandColor, type BrandColorInput, type BrandInput, type BrandTokens, type ThemeName, } from './theme-data.js';
-export interface ThemeStyleTarget {
-    setProperty(name: string, value: string): void;
-    removeProperty(name: string): string;
-}
-export interface ThemeTarget {
-    readonly style: ThemeStyleTarget;
-    setAttribute(name: string, value: string): void;
-}
-export interface ThemePersistence {
-    readTheme?(): unknown;
-    writeTheme?(theme: ThemeName): void;
-    writeSystemTheme?(): void;
-    readBrand?(): unknown;
-    writeBrand?(brand: BrandColor): void;
-}
-export interface SystemThemePreference {
-    read(): ThemeName;
-    subscribe?(listener: (theme: ThemeName) => void): () => void;
-}
-export interface ThemeStorage {
-    getItem(key: string): string | null;
-    setItem(key: string, value: string): void;
-}
-export interface ThemeMediaQuery {
-    readonly matches: boolean;
-    addEventListener(type: 'change', listener: (event: {
-        readonly matches: boolean;
-    }) => void): void;
-    removeEventListener(type: 'change', listener: (event: {
-        readonly matches: boolean;
-    }) => void): void;
-}
-export interface ThemeState {
-    readonly theme: ThemeName;
-    readonly brand: BrandColor;
-}
-export type ThemePreference = ThemeName | 'system';
-export declare const THEME_PREFERENCE_CHANGE_EVENT = "vobs:theme-preference-change";
-export declare const THEME_STATE_CHANGE_EVENT = "vobs:theme-state-change";
-export interface ThemePreferenceChangeDetail {
-    readonly shellId?: string;
-    readonly theme?: ThemePreference;
-    readonly brand?: BrandInput;
-}
-export interface ThemeStateChangeDetail {
-    readonly shellId: string;
-    readonly theme: ThemeName;
-    readonly preference: ThemePreference;
-    readonly brand: BrandColor;
-}
-export interface ThemeControllerOptions {
-    readonly target: ThemeTarget;
-    readonly initialTheme?: ThemeName;
-    readonly initialPreference?: ThemePreference;
-    readonly initialBrand?: BrandInput;
-    readonly persistence?: ThemePersistence;
-    readonly systemPreference?: SystemThemePreference;
-    readonly onWarning?: (message: string) => void;
-}
-export interface ThemeController {
-    readonly theme: ThemeName;
-    readonly preference: ThemePreference;
-    readonly brand: BrandColor;
-    readonly state: ThemeState;
-    setTheme(theme: ThemeName): void;
-    setPreference(preference: ThemePreference): void;
-    toggleTheme(): ThemeName;
-    setBrand(brand: BrandInput): BrandColor;
-    subscribe(listener: (state: ThemeState) => void): () => void;
-    destroy(): void;
-}
-export interface ThemeAttributes {
-    readonly 'data-theme': ThemeName;
-    readonly 'data-brand': string;
-    readonly style?: string;
-}
-export declare function createThemeController(options: ThemeControllerOptions): ThemeController;
-export declare function createStorageThemePersistence(storage: ThemeStorage, keys?: {
-    readonly theme?: string;
-    readonly brand?: string;
-}): ThemePersistence;
-export declare function createMediaThemePreference(query: ThemeMediaQuery): SystemThemePreference;
-export declare function createThemeState(theme?: ThemeName, brand?: BrandInput): ThemeState;
-export declare function createThemeAttributes(state: ThemeState): ThemeAttributes;
-export declare function createThemeBootstrapScript(state: ThemeState): string;
-/**
- * Reads a design-token value (CSS variable) for the active theme, for third-party adapters (contract ui-adapters.md §3.1).
- * Data source: tokens.css variables on html[data-theme] (getComputedStyle reads the latest effective value).
- * Returns undefined without a document (SSR/non-browser) or when the variable is undefined — adapters must degrade gracefully.
- */
-export declare function resolveUiToken(name: `--${string}`): string | undefined;