@lgtm-hq/turbo-themes 0.12.22 → 0.12.24

package/packages/core/dist/themes/css/helpers.js

@@ -0,0 +1,181 @@
+// SPDX-License-Identifier: MIT
+// Helper functions for CSS generation
+import { hexToHsl } from '../bulma.js';
+/**
+ * Traverses an object using a dot-separated path.
+ * Internal helper used by all token resolution functions.
+ */
+function traversePath(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined || typeof current !== 'object') {
+            return undefined;
+        }
+        // Safe: path is from hardcoded TOKEN_MAPPINGS, not user input
+        // nosemgrep: prototype-pollution-loop
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Unified token path resolver.
+ * Gets a value from tokens using a dot-separated path with optional prefix and fallback.
+ */
+export function resolveTokenPath(tokens, path, options) {
+    const { prefix, fallbackPath } = options ?? {};
+    // Build full path with optional prefix
+    const fullPath = prefix ? `${prefix}.${path}` : path;
+    // Try primary path
+    const value = traversePath(tokens, fullPath);
+    if (typeof value === 'string') {
+        return value;
+    }
+    // Try fallback path if provided
+    if (fallbackPath) {
+        const fallbackValue = traversePath(tokens, fallbackPath);
+        if (typeof fallbackValue === 'string') {
+            return fallbackValue;
+        }
+    }
+    return undefined;
+}
+/**
+ * Gets a nested value from an object using a dot-separated path.
+ * Convenience wrapper around resolveTokenPath.
+ */
+export function getTokenValue(tokens, path) {
+    return resolveTokenPath(tokens, path);
+}
+/**
+ * Gets a component token value with fallback.
+ * Convenience wrapper around resolveTokenPath for component tokens.
+ */
+export function getComponentTokenValue(tokens, componentPath, fallbackPath) {
+    if (!tokens.components) {
+        return fallbackPath ? (resolveTokenPath(tokens, fallbackPath) ?? '') : '';
+    }
+    return (resolveTokenPath(tokens, componentPath, { prefix: 'components', fallbackPath }) ?? '');
+}
+/**
+ * Converts a hex color to an HSL string.
+ */
+export function hexToHslString(hex) {
+    const hsl = hexToHsl(hex);
+    return `hsl(${hsl.h}, ${hsl.s}%, ${hsl.l}%)`;
+}
+/**
+ * Escapes a string for use in CSS selectors.
+ * Fallback implements CSS.escape algorithm per CSSOM spec when native is unavailable.
+ */
+export function escapeCssId(id) {
+    if (typeof CSS !== 'undefined' && CSS.escape) {
+        return CSS.escape(id);
+    }
+    // Fallback: escape per CSSOM spec (simplified for valid identifier chars)
+    return id.replace(/[\0-\x1f\x7f]|^-?[0-9]|[^a-zA-Z0-9_-]/g, (char) => {
+        if (char === '\0')
+            return '\uFFFD';
+        const code = char.charCodeAt(0);
+        return '\\' + code.toString(16) + ' ';
+    });
+}
+/**
+ * Validates and sanitizes a CSS color value.
+ * Returns the value if valid, or a transparent fallback if invalid.
+ */
+export function sanitizeCssColor(value) {
+    if (!value || typeof value !== 'string') {
+        return 'transparent';
+    }
+    // Allow hex colors, rgb/rgba/hsl/hsla functions, and named colors
+    const trimmed = value.trim();
+    // Hex color validation
+    if (/^#([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(trimmed)) {
+        return trimmed;
+    }
+    // RGB/RGBA/HSL/HSLA function validation
+    if (/^(rgb|rgba|hsl|hsla)\([^)]+\)$/i.test(trimmed)) {
+        // Additional check: no semicolons or braces in the value
+        if (!/[;{}]/.test(trimmed)) {
+            return trimmed;
+        }
+    }
+    // Named color validation (common named colors only)
+    const namedColors = new Set([
+        'transparent', 'inherit', 'currentColor', 'initial', 'unset',
+        'black', 'white', 'red', 'green', 'blue', 'yellow', 'orange',
+        'purple', 'gray', 'grey', 'pink', 'brown', 'cyan', 'magenta',
+    ]);
+    if (namedColors.has(trimmed.toLowerCase())) {
+        return trimmed;
+    }
+    // Default fallback for invalid values
+    return 'transparent';
+}
+/**
+ * Generates CSS variable declarations from a mapping array.
+ */
+export function generateVariables(tokens, mappings) {
+    return mappings.map((mapping) => {
+        let value = getTokenValue(tokens, mapping.tokenPath);
+        if (value === undefined && mapping.fallbackPath) {
+            value = getTokenValue(tokens, mapping.fallbackPath);
+        }
+        return `  ${mapping.cssVar}: ${value ?? ''};`;
+    });
+}
+/**
+ * Generates HSL component variables (h, s%, l%).
+ */
+export function generateHSLComponents(tokens, mapping) {
+    const hex = getTokenValue(tokens, mapping.tokenPath);
+    if (!hex)
+        return [];
+    const hsl = hexToHsl(hex);
+    return [
+        `  ${mapping.hVar}: ${hsl.h};`,
+        `  ${mapping.sVar}: ${hsl.s}%;`,
+        `  ${mapping.lVar}: ${hsl.l}%;`,
+    ];
+}
+/**
+ * Generates HSL color variables.
+ */
+export function generateHSLColors(tokens, mappings) {
+    return mappings.map((mapping) => {
+        const hex = getTokenValue(tokens, mapping.tokenPath);
+        if (!hex)
+            return `  ${mapping.cssVar}: ;`;
+        return `  ${mapping.cssVar}: ${hexToHslString(hex)};`;
+    });
+}
+/**
+ * Generates component token variables with fallbacks.
+ */
+export function generateComponentVariables(tokens, mappings) {
+    if (!tokens.components)
+        return [];
+    const lines = [];
+    let currentComponent = '';
+    for (const mapping of mappings) {
+        const component = mapping.componentPath.split('.')[0] ?? '';
+        // Add comment for new component section
+        if (component && component !== currentComponent) {
+            const componentName = component.charAt(0).toUpperCase() + component.slice(1);
+            lines.push(`  /* ${componentName} component tokens */`);
+            currentComponent = component;
+        }
+        // Special case for modal.bg which has a non-token fallback
+        let value;
+        if (mapping.componentPath === 'modal.bg' && !mapping.fallbackPath) {
+            value = getComponentTokenValue(tokens, mapping.componentPath, '') || 'rgba(10, 10, 10, 0.86)';
+        }
+        else {
+            value = getComponentTokenValue(tokens, mapping.componentPath, mapping.fallbackPath);
+        }
+        lines.push(`  ${mapping.cssVar}: ${value};`);
+    }
+    return lines;
+}
+//# sourceMappingURL=helpers.js.map

package/packages/core/dist/themes/css/helpers.js.map

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

package/packages/core/dist/themes/css/index.d.ts

@@ -0,0 +1,13 @@
+export * from './types.js';
+import type { ThemeFlavor } from '../types.js';
+/**
+ * Generate CSS for a specific flavor.
+ */
+export declare function cssForFlavor(flavor: ThemeFlavor): string;
+/**
+ * Generate global CSS overrides that apply theme variables.
+ */
+export declare function cssGlobalOverrides(): string;
+export { generateSyntaxHighlightingCSS } from './syntax-generator.js';
+export { generateThemeCSSVariables } from './bulma-generator.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/themes/css/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/themes/css/index.ts"],"names":[],"mappings":"AAGA,cAAc,YAAY,CAAC;AAE3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAOxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAGD,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC"}

package/packages/core/dist/themes/css/index.js

@@ -0,0 +1,26 @@
+// SPDX-License-Identifier: MIT
+// CSS generation module - Public API
+export * from './types.js';
+import { generateSyntaxHighlightingCSS } from './syntax-generator.js';
+import { generateThemeCSSVariables } from './bulma-generator.js';
+import { cssGlobalOverrides as globalOverrides } from './global-overrides.js';
+/**
+ * Generate CSS for a specific flavor.
+ */
+export function cssForFlavor(flavor) {
+    const syntaxCSS = generateSyntaxHighlightingCSS(flavor);
+    const variablesCSS = generateThemeCSSVariables(flavor);
+    return `/* SPDX-License-Identifier: MIT */
+${syntaxCSS}
+${variablesCSS}`;
+}
+/**
+ * Generate global CSS overrides that apply theme variables.
+ */
+export function cssGlobalOverrides() {
+    return globalOverrides();
+}
+// Re-export internal modules for advanced usage
+export { generateSyntaxHighlightingCSS } from './syntax-generator.js';
+export { generateThemeCSSVariables } from './bulma-generator.js';
+//# sourceMappingURL=index.js.map

package/packages/core/dist/themes/css/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/themes/css/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,qCAAqC;AAErC,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,kBAAkB,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE9E;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,MAAM,SAAS,GAAG,6BAA6B,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAEvD,OAAO;EACP,SAAS;EACT,YAAY,EAAE,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,eAAe,EAAE,CAAC;AAC3B,CAAC;AAED,gDAAgD;AAChD,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC"}

package/packages/core/dist/themes/css/mappings.d.ts

@@ -0,0 +1,57 @@
+import type { CSSVariableMapping, HSLVariableMapping, HSLColorMapping, ComponentTokenMapping } from './types.js';
+/** Bulma scheme variables */
+export declare const BULMA_SCHEME_MAPPINGS: CSSVariableMapping[];
+/** Primary color HSL components */
+export declare const PRIMARY_HSL_MAPPING: HSLVariableMapping;
+/** State colors as HSL */
+export declare const STATE_HSL_MAPPINGS: HSLColorMapping[];
+/** Text variables */
+export declare const TEXT_MAPPINGS: CSSVariableMapping[];
+/** Heading variables */
+export declare const HEADING_MAPPINGS: CSSVariableMapping[];
+/** Content element variables */
+export declare const CONTENT_MAPPINGS: CSSVariableMapping[];
+/** Table variables */
+export declare const TABLE_MAPPINGS: CSSVariableMapping[];
+/** Syntax highlighting variables */
+export declare const SYNTAX_MAPPINGS: CSSVariableMapping[];
+/** Surface/background variables */
+export declare const SURFACE_MAPPINGS: CSSVariableMapping[];
+/** Component token mappings (optional, with fallbacks) */
+export declare const COMPONENT_MAPPINGS: ComponentTokenMapping[];
+/** Syntax highlighting CSS class mappings */
+export declare const SYNTAX_CLASS_GROUPS: {
+    readonly comment: readonly string[];
+    readonly keyword: readonly string[];
+    readonly string: readonly string[];
+    readonly number: readonly string[];
+    readonly attr: readonly string[];
+    readonly title: readonly string[];
+};
+/** Core token mappings used by CSS generator */
+export declare const CORE_MAPPINGS: CSSVariableMapping[];
+/** CSS variable prefix */
+export declare const CSS_VAR_PREFIX: string;
+/** Optional group configurations */
+export declare const OPTIONAL_GROUPS: {
+    spacing: {
+        prefix: string;
+        properties: string[];
+    };
+    elevation: {
+        prefix: string;
+        properties: string[];
+    };
+    animation: {
+        prefix: string;
+        mappings: {
+            cssVar: string;
+            tokenPath: string;
+        }[];
+    };
+    opacity: {
+        prefix: string;
+        properties: string[];
+    };
+};
+//# sourceMappingURL=mappings.d.ts.map

package/packages/core/dist/themes/css/mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappings.d.ts","sourceRoot":"","sources":["../../../src/themes/css/mappings.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACtB,MAAM,YAAY,CAAC;AA+DpB,6BAA6B;AAC7B,eAAO,MAAM,qBAAqB,EAAE,kBAAkB,EACK,CAAC;AAE5D,mCAAmC;AACnC,eAAO,MAAM,mBAAmB,EAAE,kBACY,CAAC;AAE/C,0BAA0B;AAC1B,eAAO,MAAM,kBAAkB,EAAE,eAAe,EACa,CAAC;AAM9D,qBAAqB;AACrB,eAAO,MAAM,aAAa,EAAE,kBAAkB,EACW,CAAC;AAE1D,wBAAwB;AACxB,eAAO,MAAM,gBAAgB,EAAE,kBAAkB,EACW,CAAC;AAE7D,gCAAgC;AAChC,eAAO,MAAM,gBAAgB,EAAE,kBAAkB,EACW,CAAC;AAE7D,sBAAsB;AACtB,eAAO,MAAM,cAAc,EAAE,kBAAkB,EACW,CAAC;AAE3D,oCAAoC;AACpC,eAAO,MAAM,eAAe,EAAE,kBAAkB,EACW,CAAC;AAE5D,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,EAAE,kBAAkB,EACW,CAAC;AAM7D,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,EAAE,qBAAqB,EACJ,CAAC;AAMnD,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB,EAAsC;IACpE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC,CAAC;AAMF,gDAAgD;AAChD,eAAO,MAAM,aAAa,EAAE,kBAAkB,EACK,CAAC;AAEpD,0BAA0B;AAC1B,eAAO,MAAM,cAAc,QAAuB,CAAC;AAEnD,oCAAoC;AACpC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;CAA+B,CAAC"}

package/packages/core/dist/themes/css/mappings.js

@@ -0,0 +1,79 @@
+// SPDX-License-Identifier: MIT
+// CSS Variable Mappings - Generated from config/token-mappings.json
+// This file reads from the single source of truth configuration
+// Import the centralized mapping configuration
+// Note: Using require for JSON import compatibility
+import mappingConfig from '../../../../../config/token-mappings.json' with { type: 'json' };
+// Convert config entries to typed mappings
+function toVariableMapping(entry) {
+    return {
+        cssVar: entry.cssVar,
+        tokenPath: entry.tokenPath,
+        ...(entry.fallback ? { fallbackPath: entry.fallback } : {}),
+    };
+}
+function toComponentMapping(entry) {
+    return {
+        cssVar: entry.cssVar,
+        componentPath: entry.componentPath,
+        fallbackPath: entry.fallback,
+    };
+}
+function toHSLMapping(entry) {
+    return {
+        hVar: entry.hVar,
+        sVar: entry.sVar,
+        lVar: entry.lVar,
+        tokenPath: entry.tokenPath,
+    };
+}
+function toHSLColorMapping(entry) {
+    return {
+        cssVar: entry.cssVar,
+        tokenPath: entry.tokenPath,
+    };
+}
+// =============================================================================
+// Bulma Framework Mappings
+// =============================================================================
+/** Bulma scheme variables */
+export const BULMA_SCHEME_MAPPINGS = mappingConfig.bulma.schemeMappings.map(toVariableMapping);
+/** Primary color HSL components */
+export const PRIMARY_HSL_MAPPING = toHSLMapping(mappingConfig.bulma.primaryHsl);
+/** State colors as HSL */
+export const STATE_HSL_MAPPINGS = mappingConfig.bulma.stateHslMappings.map(toHSLColorMapping);
+// =============================================================================
+// Theme Variable Mappings
+// =============================================================================
+/** Text variables */
+export const TEXT_MAPPINGS = mappingConfig.theme.textMappings.map(toVariableMapping);
+/** Heading variables */
+export const HEADING_MAPPINGS = mappingConfig.theme.headingMappings.map(toVariableMapping);
+/** Content element variables */
+export const CONTENT_MAPPINGS = mappingConfig.theme.contentMappings.map(toVariableMapping);
+/** Table variables */
+export const TABLE_MAPPINGS = mappingConfig.theme.tableMappings.map(toVariableMapping);
+/** Syntax highlighting variables */
+export const SYNTAX_MAPPINGS = mappingConfig.theme.syntaxMappings.map(toVariableMapping);
+/** Surface/background variables */
+export const SURFACE_MAPPINGS = mappingConfig.theme.surfaceMappings.map(toVariableMapping);
+// =============================================================================
+// Component Token Mappings
+// =============================================================================
+/** Component token mappings (optional, with fallbacks) */
+export const COMPONENT_MAPPINGS = mappingConfig.components.map(toComponentMapping);
+// =============================================================================
+// Syntax Highlighting CSS Classes
+// =============================================================================
+/** Syntax highlighting CSS class mappings */
+export const SYNTAX_CLASS_GROUPS = mappingConfig.syntaxClassGroups;
+// =============================================================================
+// Core Mappings (for generator.ts and Python)
+// =============================================================================
+/** Core token mappings used by CSS generator */
+export const CORE_MAPPINGS = mappingConfig.coreMappings.map(toVariableMapping);
+/** CSS variable prefix */
+export const CSS_VAR_PREFIX = mappingConfig.prefix;
+/** Optional group configurations */
+export const OPTIONAL_GROUPS = mappingConfig.optionalGroups;
+//# sourceMappingURL=mappings.js.map

package/packages/core/dist/themes/css/mappings.js.map

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

package/packages/core/dist/themes/css/overrides/accessibility.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generate accessibility-related CSS overrides.
+ * Includes contrast fixes for themes that need WCAG compliance adjustments.
+ */
+export declare function cssAccessibilityOverrides(): string;
+//# sourceMappingURL=accessibility.d.ts.map

package/packages/core/dist/themes/css/overrides/accessibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../../../src/themes/css/overrides/accessibility.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CA6BlD"}

package/packages/core/dist/themes/css/overrides/accessibility.js

@@ -0,0 +1,37 @@
+// SPDX-License-Identifier: MIT
+// Accessibility CSS overrides - contrast fixes for specific themes
+/**
+ * Generate accessibility-related CSS overrides.
+ * Includes contrast fixes for themes that need WCAG compliance adjustments.
+ */
+export function cssAccessibilityOverrides() {
+    return `/* Accessibility contrast fixes (Axe) */
+[data-flavor='catppuccin-latte'] .navbar-item,
+[data-flavor='catppuccin-latte'] .has-text-centered > p,
+[data-flavor='catppuccin-latte'] a.navbar-item,
+[data-flavor='catppuccin-latte'] .title,
+[data-flavor='catppuccin-latte'] h1,
+[data-flavor='catppuccin-latte'] h2,
+[data-flavor='catppuccin-latte'] h3,
+[data-flavor='catppuccin-latte'] h4 {
+  color: #1e293b; /* strong slate for >=4.5:1 on light bg */
+}
+
+[data-flavor='catppuccin-latte'] .button.is-text,
+[data-flavor='catppuccin-latte'] .button.is-ghost,
+[data-flavor='catppuccin-latte'] .navbar-item.is-active {
+  color: #0b66d6; /* deeper blue for >=4.5:1 on light bg */
+}
+
+[data-flavor='github-dark'] strong,
+[data-flavor='github-dark'] th,
+[data-flavor='github-dark'] .has-text-centered > p {
+  color: #c9d1d9; /* github-dark foreground */
+}
+
+[data-flavor='github-dark'] .button.is-text,
+[data-flavor='github-dark'] .button.is-ghost {
+  color: #58a6ff; /* accessible link blue on dark bg */
+}`;
+}
+//# sourceMappingURL=accessibility.js.map

package/packages/core/dist/themes/css/overrides/accessibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility.js","sourceRoot":"","sources":["../../../../src/themes/css/overrides/accessibility.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,mEAAmE;AAEnE;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BP,CAAC;AACH,CAAC"}

package/packages/core/dist/themes/css/overrides/dropdown.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generate dropdown-related CSS overrides.
+ * Includes theme selector dropdown and menu item styles.
+ */
+export declare function cssDropdownOverrides(): string;
+//# sourceMappingURL=dropdown.d.ts.map

package/packages/core/dist/themes/css/overrides/dropdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dropdown.d.ts","sourceRoot":"","sources":["../../../../src/themes/css/overrides/dropdown.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CA8E7C"}

package/packages/core/dist/themes/css/overrides/dropdown.js

@@ -0,0 +1,86 @@
+// SPDX-License-Identifier: MIT
+// Dropdown CSS overrides - theme selector dropdown styling
+/**
+ * Generate dropdown-related CSS overrides.
+ * Includes theme selector dropdown and menu item styles.
+ */
+export function cssDropdownOverrides() {
+    return `/* Dropdown Theme Selector */
+.dropdown.is-theme {
+  --bulma-dropdown-item-h: var(--bulma-text-h);
+  --bulma-dropdown-item-s: var(--bulma-text-s);
+  --bulma-dropdown-item-color-l: var(--bulma-text-l);
+  --bulma-dropdown-item-background-l: var(--bulma-scheme-main-l);
+  --bulma-dropdown-item-selected-h: var(--bulma-link-h);
+  --bulma-dropdown-item-selected-s: var(--bulma-link-s);
+  --bulma-dropdown-item-selected-l: var(--bulma-link-l);
+  --bulma-dropdown-item-selected-background-l: var(--bulma-link-l);
+  --bulma-dropdown-item-selected-color-l: var(--bulma-link-invert-l);
+}
+.dropdown.is-theme .theme-flavor-trigger {
+  background: var(--theme-surface-1, inherit) !important;
+  color: var(--theme-text, inherit) !important;
+  border: 2px solid var(--theme-table-border, var(--bulma-border, currentColor)) !important;
+  border-radius: var(--bulma-radius, 0.375rem) !important;
+  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.05) !important;
+  transition: all 0.2s ease !important;
+  font-weight: 500 !important;
+}
+.dropdown.is-theme .theme-flavor-trigger:hover {
+  border-color: var(--theme-link, var(--bulma-link)) !important;
+  box-shadow: 0 2px 4px color-mix(in srgb, var(--theme-link, var(--bulma-link)), transparent 85%),
+    0 0 0 0.125em color-mix(in srgb, var(--theme-link, var(--bulma-link)), transparent 80%) !important;
+  background: var(--theme-surface-2, inherit) !important;
+}
+.dropdown.is-theme .theme-flavor-trigger:focus {
+  border-color: var(--theme-link, var(--bulma-link)) !important;
+  box-shadow: 0 0 0 0.125em color-mix(in srgb, var(--theme-link, var(--bulma-link)), transparent 80%),
+    0 2px 4px color-mix(in srgb, var(--theme-link, var(--bulma-link)), transparent 85%) !important;
+  outline: none !important;
+}
+.dropdown.is-theme .dropdown-menu {
+  background: var(--theme-surface-1, inherit) !important;
+  border: 2px solid var(--theme-table-border, var(--bulma-border, currentColor)) !important;
+  border-radius: var(--bulma-radius, 0.375rem) !important;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15), 0 2px 4px rgba(0, 0, 0, 0.1) !important;
+  margin-top: 0.25rem !important;
+}
+.dropdown.is-theme .dropdown-content {
+  background-color: transparent !important;
+  box-shadow: none !important;
+  padding: 0.5rem !important;
+  border: none !important;
+}
+.dropdown.is-theme .dropdown-item {
+  color: var(--theme-text, inherit) !important;
+  background-color: transparent !important;
+  border-radius: var(--bulma-radius-small, 0.25rem) !important;
+  padding: 0.625rem 1rem !important;
+  display: flex !important;
+  align-items: center !important;
+  gap: 0.75rem !important;
+  border: none !important;
+  transition: all 0.15s ease !important;
+  font-weight: 400 !important;
+}
+.dropdown.is-theme .dropdown-item:hover {
+  background: var(--theme-surface-2, inherit) !important;
+  color: var(--theme-link, var(--bulma-link)) !important;
+  transform: translateX(2px);
+}
+.dropdown.is-theme .dropdown-item.is-active {
+  background: var(--theme-link, var(--bulma-link)) !important;
+  color: var(--bulma-link-invert, var(--bulma-body-background-color)) !important;
+  font-weight: 500 !important;
+}
+.dropdown.is-theme .dropdown-item.is-active::before {
+  content: '\\2713';
+  margin-right: 0.25rem;
+  font-weight: bold;
+}
+.dropdown.is-theme .dropdown-item img {
+  border-radius: 50% !important;
+  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1) !important;
+}`;
+}
+//# sourceMappingURL=dropdown.js.map

package/packages/core/dist/themes/css/overrides/dropdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dropdown.js","sourceRoot":"","sources":["../../../../src/themes/css/overrides/dropdown.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,2DAA2D;AAE3D;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4EP,CAAC;AACH,CAAC"}

package/packages/core/dist/themes/css/overrides/forms.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generate form-related CSS overrides.
+ * Includes inputs, textareas, selects, checkboxes, and validation states.
+ */
+export declare function cssFormOverrides(): string;
+//# sourceMappingURL=forms.d.ts.map

package/packages/core/dist/themes/css/overrides/forms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.d.ts","sourceRoot":"","sources":["../../../../src/themes/css/overrides/forms.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAwHzC"}