@vobs/ui 0.1.0

package/dist/theme-data.js

@@ -0,0 +1,374 @@
+/** @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-4': '4px',
+    '--spacer-6': '6px',
+    '--spacer-8': '8px',
+    '--spacer-12': '12px',
+    '--spacer-16': '16px',
+    '--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-code': '450',
+    '--font-weight-medium': '500',
+    '--font-weight-strong': '600',
+    '--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)',
+};
+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-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-secondary': '#4B5563',
+        '--text-tertiary': '#5B6370',
+        '--text-disabled': '#525A68',
+        '--text-onbrand': '#FFFFFF',
+        '--icon-default': '#0F1117',
+        '--icon-secondary': '#4B5563',
+        '--icon-tertiary': '#5B6370',
+        '--icon-disabled': '#525A68',
+        '--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)',
+        '--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 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

@@ -0,0 +1,79 @@
+/** @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, 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;
+    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 interface ThemeControllerOptions {
+    readonly target: ThemeTarget;
+    readonly initialTheme?: ThemeName;
+    readonly initialBrand?: BrandInput;
+    readonly persistence?: ThemePersistence;
+    readonly systemPreference?: SystemThemePreference;
+    readonly onWarning?: (message: string) => void;
+}
+export interface ThemeController {
+    readonly theme: ThemeName;
+    readonly brand: BrandColor;
+    readonly state: ThemeState;
+    setTheme(theme: ThemeName): 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;