@cube-dev/ui-kit 0.0.0-canary-76be278 → 0.0.0-canary-7e4ec9d

package/es/tasty/states/index.js

@@ -1,515 +0,0 @@
-/**
- * @license MIT
- * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-76be278
- * Released under the MIT license.
- */
-
-/**
- * Advanced State Mapping - Predefined States Management
- *
- * This module handles global and local predefined states for the Tasty styling system.
- * See ADVANCED_STATE_MAPPING.md for full specification.
- */
-import { hasStylesGenerated } from '../config';
-import { isDevEnv } from '../utils/isDevEnv';
-// Built-in state names that cannot be overridden
-const BUILTIN_STATES = new Set(['@starting']);
-// Reserved prefixes that are built-in
-const RESERVED_PREFIXES = ['@media', '@root', '@own', '@(', '@starting'];
-// Global predefined states storage
-let globalPredefinedStates = {};
-// Warnings tracking to avoid duplicates
-const emittedWarnings = new Set();
-const devMode = isDevEnv();
-/**
- * Emit a warning only once
- */
-function warnOnce(key, message) {
-    if (devMode && !emittedWarnings.has(key)) {
-        emittedWarnings.add(key);
-        console.warn(message);
-    }
-}
-/**
- * Configure global predefined states
- */
-export function setGlobalPredefinedStates(states) {
-    if (hasStylesGenerated()) {
-        const newStateNames = Object.keys(states).join(', ');
-        warnOnce(`dynamic-states:${newStateNames}`, `[Tasty] Cannot update predefined states after styles have been generated.\n` +
-            `The new definition(s) for ${newStateNames} will be ignored.`);
-        return;
-    }
-    // Validate state names
-    for (const [name, value] of Object.entries(states)) {
-        // Check for valid name format
-        if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(name)) {
-            warnOnce(`invalid-state-name:${name}`, `[Tasty] Invalid predefined state name '${name}'. Must start with '@' followed by a letter.`);
-            continue;
-        }
-        // Check for reserved names
-        if (BUILTIN_STATES.has(name)) {
-            warnOnce(`reserved-state:${name}`, `[Tasty] Cannot define predefined state '${name}'. This name is reserved for built-in functionality.`);
-            continue;
-        }
-        // Check for reserved prefixes (but only exact matches, not user-defined states like @mobile)
-        // Reserved prefixes are: @media, @root, @own, @(
-        // A user state like @mobile should NOT be blocked
-        const isReservedPrefix = name === '@media' ||
-            name === '@root' ||
-            name === '@own' ||
-            name.startsWith('@(');
-        if (isReservedPrefix) {
-            warnOnce(`reserved-prefix:${name}`, `[Tasty] Cannot define predefined state '${name}'. This prefix is reserved for built-in functionality.`);
-            continue;
-        }
-        // Check for cross-references
-        const crossRefs = extractPredefinedStateRefs(value);
-        if (crossRefs.length > 0) {
-            warnOnce(`cross-ref:${name}`, `[Tasty] Predefined state '${name}' references another predefined state '${crossRefs[0]}'.\n` +
-                `Predefined states cannot reference each other. Use the full definition instead.`);
-            continue;
-        }
-        // Check for duplicates
-        if (globalPredefinedStates[name] &&
-            globalPredefinedStates[name] !== value) {
-            warnOnce(`duplicate-state:${name}`, `[Tasty] Duplicate predefined state '${name}' in configure(). The last definition will be used.`);
-        }
-        globalPredefinedStates[name] = value;
-    }
-}
-/**
- * Get global predefined states
- */
-export function getGlobalPredefinedStates() {
-    return globalPredefinedStates;
-}
-/**
- * Clear global predefined states (for testing only)
- */
-export function clearGlobalPredefinedStates() {
-    globalPredefinedStates = {};
-    emittedWarnings.clear();
-}
-/**
- * Regex to match predefined state references in a string
- * Matches @name that is NOT followed by ( or : and is a complete word
- * Uses word boundary and negative lookahead
- */
-const PREDEFINED_STATE_PATTERN = /@([A-Za-z][A-Za-z0-9-]*)(?![A-Za-z0-9-:(])/g;
-/**
- * Extract predefined state references from a string
- */
-export function extractPredefinedStateRefs(value) {
-    const matches = value.matchAll(PREDEFINED_STATE_PATTERN);
-    const refs = [];
-    for (const match of matches) {
-        const stateName = '@' + match[1];
-        // Skip built-in states (@starting) and duplicates
-        // Note: @media, @root, @own are always followed by '(' so the regex
-        // negative lookahead (?![A-Za-z0-9-:(]) already excludes them
-        if (!BUILTIN_STATES.has(stateName) && !refs.includes(stateName)) {
-            refs.push(stateName);
-        }
-    }
-    return refs;
-}
-/**
- * Check if a state key is a predefined state reference
- */
-export function isPredefinedStateRef(stateKey) {
-    if (!stateKey.startsWith('@'))
-        return false;
-    if (BUILTIN_STATES.has(stateKey))
-        return false;
-    // Check if it's NOT a built-in prefix
-    for (const prefix of RESERVED_PREFIXES) {
-        if (stateKey === prefix || stateKey.startsWith(prefix)) {
-            // Check if it's exactly @media, @root, @own, or starts with @( or @media(
-            if (stateKey === '@media' ||
-                stateKey.startsWith('@media(') ||
-                stateKey.startsWith('@media:')) {
-                return false;
-            }
-            if (stateKey === '@root' || stateKey.startsWith('@root('))
-                return false;
-            if (stateKey === '@own' || stateKey.startsWith('@own('))
-                return false;
-            if (stateKey.startsWith('@('))
-                return false;
-        }
-    }
-    // Must match the predefined state pattern
-    return /^@[A-Za-z][A-Za-z0-9-]*$/.test(stateKey);
-}
-/**
- * Extract local predefined states from a styles object
- * Local predefined states are top-level keys starting with @ that have string values
- * and are valid predefined state names (not built-in like @media, @root, etc.)
- */
-export function extractLocalPredefinedStates(styles) {
-    const localStates = {};
-    if (!styles || typeof styles !== 'object') {
-        return localStates;
-    }
-    for (const [key, value] of Object.entries(styles)) {
-        // Check if it's a predefined state definition (starts with @, has string value)
-        if (key.startsWith('@') && typeof value === 'string') {
-            // Validate name format - must be @[letter][letters/numbers/dashes]*
-            if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(key)) {
-                continue; // Skip invalid names silently (might be something else)
-            }
-            // Skip built-in states
-            if (BUILTIN_STATES.has(key)) {
-                continue;
-            }
-            // Skip reserved prefixes
-            if (key === '@media' ||
-                key === '@root' ||
-                key === '@own' ||
-                key.startsWith('@(')) {
-                continue;
-            }
-            // Check for cross-references (predefined states cannot reference each other)
-            const crossRefs = extractPredefinedStateRefs(value);
-            if (crossRefs.length > 0) {
-                warnOnce(`local-cross-ref:${key}`, `[Tasty] Predefined state '${key}' references another predefined state '${crossRefs[0]}'.\n` +
-                    `Predefined states cannot reference each other. Use the full definition instead.`);
-                continue;
-            }
-            localStates[key] = value;
-        }
-    }
-    return localStates;
-}
-/**
- * Create a state parser context from styles
- */
-export function createStateParserContext(styles, isSubElement) {
-    const localStates = styles ? extractLocalPredefinedStates(styles) : {};
-    return {
-        localPredefinedStates: localStates,
-        globalPredefinedStates: getGlobalPredefinedStates(),
-        isSubElement,
-    };
-}
-/**
- * Resolve a predefined state reference to its value
- * Returns the resolved value or null if not found
- */
-export function resolvePredefinedState(stateKey, ctx) {
-    // Check local first (higher priority)
-    if (ctx.localPredefinedStates[stateKey]) {
-        return ctx.localPredefinedStates[stateKey];
-    }
-    // Then check global
-    if (ctx.globalPredefinedStates[stateKey]) {
-        return ctx.globalPredefinedStates[stateKey];
-    }
-    // Not found - emit warning
-    warnOnce(`undefined-state:${stateKey}`, `[Tasty] Undefined predefined state '${stateKey}'.\n` +
-        `Define it in configure({ states: { '${stateKey}': '...' } }) or in the component's styles.`);
-    return null;
-}
-/**
- * Normalize state key by trimming whitespace and removing trailing/leading operators
- */
-export function normalizeStateKey(stateKey) {
-    const warnings = [];
-    let key = stateKey;
-    // Check for whitespace-only
-    if (key.trim() === '') {
-        if (key !== '') {
-            warnings.push(`[Tasty] Whitespace-only state key normalized to default state ''.`);
-        }
-        return { key: '', warnings };
-    }
-    // Trim whitespace
-    key = key.trim();
-    // Remove trailing operators
-    const trailingOpMatch = key.match(/\s*[&|^]\s*$/);
-    if (trailingOpMatch) {
-        const originalKey = key;
-        key = key.slice(0, -trailingOpMatch[0].length).trim();
-        warnings.push(`[Tasty] State key '${originalKey}' has trailing operator. Normalized to '${key}'.`);
-    }
-    // Remove leading operators (except !)
-    const leadingOpMatch = key.match(/^\s*[&|^]\s*/);
-    if (leadingOpMatch) {
-        const originalKey = key;
-        key = key.slice(leadingOpMatch[0].length).trim();
-        warnings.push(`[Tasty] State key '${originalKey}' has leading operator. Normalized to '${key}'.`);
-    }
-    return { key, warnings };
-}
-/**
- * Expand dimension shorthands in a condition string
- * w -> width, h -> height, is -> inline-size, bs -> block-size
- */
-export function expandDimensionShorthands(condition) {
-    // Replace dimension shorthands (only when they appear as standalone words)
-    let result = condition;
-    // w -> width (but not part of other words)
-    result = result.replace(/\bw\b/g, 'width');
-    // h -> height
-    result = result.replace(/\bh\b/g, 'height');
-    // is -> inline-size
-    result = result.replace(/\bis\b/g, 'inline-size');
-    // bs -> block-size
-    result = result.replace(/\bbs\b/g, 'block-size');
-    return result;
-}
-/**
- * Convert tasty units in a string (e.g., 40x -> calc(var(--gap) * 40))
- */
-export function expandTastyUnits(value) {
-    // Match number followed by 'x' unit (tasty gap unit)
-    return value.replace(/(\d+(?:\.\d+)?)\s*x\b/g, (_, num) => {
-        return `calc(var(--gap) * ${num})`;
-    });
-}
-/**
- * Parse an advanced state key and return its type and components
- */
-export function parseAdvancedState(stateKey, ctx) {
-    const raw = stateKey;
-    // Check for @starting (exact match)
-    if (stateKey === '@starting') {
-        return {
-            type: 'starting',
-            condition: '',
-            raw,
-        };
-    }
-    // Check for @media:type (e.g., @media:print)
-    if (stateKey.startsWith('@media:')) {
-        const mediaType = stateKey.slice(7); // Remove '@media:'
-        if (!['all', 'screen', 'print', 'speech'].includes(mediaType)) {
-            warnOnce(`unknown-media-type:${mediaType}`, `[Tasty] Unknown media type '${mediaType}'. Valid types: all, screen, print, speech.`);
-        }
-        return {
-            type: 'media',
-            condition: '',
-            mediaType,
-            raw,
-        };
-    }
-    // Check for @media(...) - media query with condition
-    if (stateKey.startsWith('@media(')) {
-        const endParen = findMatchingParen(stateKey, 6);
-        if (endParen === -1) {
-            warnOnce(`unclosed-media:${stateKey}`, `[Tasty] Unclosed media query '${stateKey}'. Missing closing parenthesis.`);
-            return { type: 'modifier', condition: stateKey, raw };
-        }
-        let condition = stateKey.slice(7, endParen);
-        // Check for empty condition
-        if (!condition.trim()) {
-            warnOnce(`empty-media:${stateKey}`, `[Tasty] Empty media query condition '${stateKey}'.`);
-            return { type: 'modifier', condition: stateKey, raw };
-        }
-        // Expand shorthands and units
-        condition = expandDimensionShorthands(condition);
-        condition = expandTastyUnits(condition);
-        return {
-            type: 'media',
-            condition,
-            raw,
-        };
-    }
-    // Check for @root(...) - root state
-    if (stateKey.startsWith('@root(')) {
-        const endParen = findMatchingParen(stateKey, 5);
-        if (endParen === -1) {
-            warnOnce(`unclosed-root:${stateKey}`, `[Tasty] Unclosed root state '${stateKey}'. Missing closing parenthesis.`);
-            return { type: 'modifier', condition: stateKey, raw };
-        }
-        const condition = stateKey.slice(6, endParen);
-        if (!condition.trim()) {
-            warnOnce(`empty-root:${stateKey}`, `[Tasty] Empty root state condition '${stateKey}'.`);
-            return { type: 'modifier', condition: stateKey, raw };
-        }
-        return {
-            type: 'root',
-            condition,
-            raw,
-        };
-    }
-    // Check for @own(...) - sub-element own state
-    if (stateKey.startsWith('@own(')) {
-        const endParen = findMatchingParen(stateKey, 4);
-        if (endParen === -1) {
-            warnOnce(`unclosed-own:${stateKey}`, `[Tasty] Unclosed own state '${stateKey}'. Missing closing parenthesis.`);
-            return { type: 'modifier', condition: stateKey, raw };
-        }
-        const condition = stateKey.slice(5, endParen);
-        if (!condition.trim()) {
-            warnOnce(`empty-own:${stateKey}`, `[Tasty] Empty own state condition '${stateKey}'.`);
-            return { type: 'modifier', condition: stateKey, raw };
-        }
-        // Check if used outside sub-element context
-        if (!ctx.isSubElement) {
-            warnOnce(`own-outside-subelement:${stateKey}`, `[Tasty] @own(${condition}) used outside sub-element context.\n` +
-                `@own() is equivalent to '${condition}' at the root level. ` +
-                `Did you mean to use it inside a sub-element?`);
-            // Treat as regular modifier
-            return {
-                type: 'modifier',
-                condition,
-                raw,
-            };
-        }
-        return {
-            type: 'own',
-            condition,
-            raw,
-        };
-    }
-    // Check for @(...) - container query (unnamed or named)
-    if (stateKey.startsWith('@(')) {
-        const endParen = findMatchingParen(stateKey, 1);
-        if (endParen === -1) {
-            warnOnce(`unclosed-container:${stateKey}`, `[Tasty] Unclosed container query '${stateKey}'. Missing closing parenthesis.`);
-            return { type: 'modifier', condition: stateKey, raw };
-        }
-        const content = stateKey.slice(2, endParen);
-        if (!content.trim()) {
-            warnOnce(`empty-container:${stateKey}`, `[Tasty] Empty container query '${stateKey}'.`);
-            return { type: 'modifier', condition: stateKey, raw };
-        }
-        // Check if named container (first token is name, followed by comma)
-        const commaIndex = content.indexOf(',');
-        let containerName;
-        let condition;
-        if (commaIndex !== -1) {
-            // Named container: @(layout, w < 600px)
-            containerName = content.slice(0, commaIndex).trim();
-            condition = content.slice(commaIndex + 1).trim();
-        }
-        else {
-            // Unnamed container: @(w < 600px)
-            condition = content.trim();
-        }
-        // Check for style query (starts with $)
-        if (condition.startsWith('$')) {
-            // Style query: @(layout, $compact) or @(layout, $variant=compact)
-            const styleCondition = parseStyleQuery(condition);
-            if (!styleCondition) {
-                warnOnce(`invalid-style-query:${stateKey}`, `[Tasty] Invalid style query '${condition}' in container query.`);
-                return { type: 'modifier', condition: stateKey, raw };
-            }
-            condition = styleCondition;
-        }
-        else {
-            // Dimension query - expand shorthands and units
-            condition = expandDimensionShorthands(condition);
-            condition = expandTastyUnits(condition);
-        }
-        return {
-            type: 'container',
-            condition,
-            containerName,
-            raw,
-        };
-    }
-    // Check for predefined state reference
-    if (isPredefinedStateRef(stateKey)) {
-        const resolved = resolvePredefinedState(stateKey, ctx);
-        if (resolved) {
-            // Recursively parse the resolved value to extract the actual state type
-            // (e.g., @mobile -> @media(w < 768px) should become a media state)
-            const parsedResolved = parseAdvancedState(resolved, ctx);
-            return {
-                ...parsedResolved,
-                raw, // Keep original raw for traceability
-            };
-        }
-        // If not resolved, treat as modifier (will likely produce invalid CSS)
-        return {
-            type: 'modifier',
-            condition: stateKey,
-            raw,
-        };
-    }
-    // Regular modifier (boolean mod, pseudo-class, class, attribute)
-    return {
-        type: 'modifier',
-        condition: stateKey,
-        raw,
-    };
-}
-/**
- * Parse a style query condition (e.g., $compact, $variant=compact, $variant="very compact")
- */
-function parseStyleQuery(condition) {
-    // Remove $ prefix
-    const query = condition.slice(1);
-    // Check for comparison operators (not supported)
-    if (/[<>]/.test(query)) {
-        warnOnce(`style-query-comparison:${condition}`, `[Tasty] Style queries only support equality. '${condition}' is invalid. Use '${condition.split(/[<>]/)[0]}=...' instead.`);
-        return null;
-    }
-    // Check for equality
-    const eqIndex = query.indexOf('=');
-    if (eqIndex === -1) {
-        // Just existence check: style(--compact)
-        return `style(--${query})`;
-    }
-    const propName = query.slice(0, eqIndex).trim();
-    let value = query.slice(eqIndex + 1).trim();
-    // Handle quoted values
-    if ((value.startsWith('"') && value.endsWith('"')) ||
-        (value.startsWith("'") && value.endsWith("'"))) {
-        // Keep quotes for CSS
-    }
-    else {
-        // Add quotes if needed
-        value = `"${value}"`;
-    }
-    // Expand tasty units in value
-    value = expandTastyUnits(value);
-    return `style(--${propName}: ${value})`;
-}
-/**
- * Find matching closing parenthesis
- */
-function findMatchingParen(str, startIndex) {
-    let depth = 1;
-    let i = startIndex + 1;
-    while (i < str.length && depth > 0) {
-        if (str[i] === '(')
-            depth++;
-        else if (str[i] === ')')
-            depth--;
-        i++;
-    }
-    return depth === 0 ? i - 1 : -1;
-}
-/**
- * Check if a state key is an advanced state (starts with @)
- */
-export function isAdvancedState(stateKey) {
-    return stateKey.startsWith('@') || stateKey.startsWith('!@');
-}
-/**
- * Detect the type of advanced state from a raw state key
- */
-export function detectAdvancedStateType(stateKey) {
-    // Handle negation prefix
-    const key = stateKey.startsWith('!') ? stateKey.slice(1) : stateKey;
-    if (key === '@starting')
-        return 'starting';
-    if (key.startsWith('@media'))
-        return 'media';
-    if (key.startsWith('@root('))
-        return 'root';
-    if (key.startsWith('@own('))
-        return 'own';
-    if (key.startsWith('@('))
-        return 'container';
-    if (isPredefinedStateRef(key))
-        return 'predefined';
-    return 'modifier';
-}
-
-        

package/es/tasty/static/index.js

@@ -1,47 +0,0 @@
-/**
- * @license MIT
- * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-76be278
- * Released under the MIT license.
- */
-
-/**
- * Build-time only module for zero-runtime static site generation.
- *
- * Usage:
- * ```typescript
- * import { tastyStatic } from '@cube-dev/ui-kit/tasty/static';
- *
- * // Returns StaticStyle object (className + styles + toString)
- * const button = tastyStatic({
- *   fill: '#blue',
- *   padding: '2x',
- * });
- *
- * // Extend existing styles
- * const primaryButton = tastyStatic(button, {
- *   fill: '#purple',
- * });
- *
- * // Global styles (removed at build time)
- * tastyStatic('.heading', { preset: 'h1' });
- *
- * // Usage in JSX
- * <div className={button} />           // toString() coercion
- * <div className={button.className} /> // Explicit
- * ```
- *
- * Requires the Babel plugin to be configured:
- * ```javascript
- * // babel.config.js
- * plugins: [
- *   ['@cube-dev/ui-kit/tasty/zero/babel', { output: 'public/tasty.css' }]
- * ]
- * ```
- */
-export { tastyStatic } from './tastyStatic';
-export { createStaticStyle, isStaticStyle } from './types';
-// Re-export mergeStyles for advanced use cases
-export { mergeStyles } from '../utils/mergeStyles';
-
-        

package/es/tasty/static/tastyStatic.js

@@ -1,55 +0,0 @@
-/**
- * @license MIT
- * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-76be278
- * Released under the MIT license.
- */
-
-import { mergeStyles } from '../utils/mergeStyles';
-import { createStaticStyle, isStaticStyle } from './types';
-/**
- * Build-time only function for zero-runtime static site generation.
- *
- * This function is transformed by the Babel plugin:
- * - `tastyStatic(styles)` → StaticStyle object with className
- * - `tastyStatic(base, styles)` → StaticStyle object with merged styles
- * - `tastyStatic(selector, styles)` → removed entirely
- *
- * At runtime (during development/build), this function returns a placeholder.
- * In production, all calls are replaced/removed by the build plugin.
- */
-export function tastyStatic(stylesOrBaseOrSelector, styles) {
-    // This code only executes if the Babel plugin hasn't processed the file yet.
-    // In a properly configured build, this function is never called at runtime.
-    if (typeof stylesOrBaseOrSelector === 'string') {
-        // Selector mode: tastyStatic(selector, styles)
-        // The plugin will remove this call entirely
-        if (process.env.NODE_ENV !== 'production') {
-            console.warn(`[tasty] tastyStatic('${stylesOrBaseOrSelector}', styles) was called at runtime. ` +
-                'This indicates the Babel plugin is not configured. ' +
-                'Add @cube-dev/ui-kit/tasty/zero/babel to your Babel config.');
-        }
-        return; // void
-    }
-    if (isStaticStyle(stylesOrBaseOrSelector)) {
-        // Extension mode: tastyStatic(base, styles)
-        if (process.env.NODE_ENV !== 'production') {
-            console.warn('[tasty] tastyStatic(base, styles) was called at runtime. ' +
-                'This indicates the Babel plugin is not configured. ' +
-                'Add @cube-dev/ui-kit/tasty/zero/babel to your Babel config.');
-        }
-        // Merge styles for dev mode preview (won't have real classNames)
-        const mergedStyles = mergeStyles(stylesOrBaseOrSelector.styles, styles || {});
-        return createStaticStyle('__TASTY_STATIC_NOT_TRANSFORMED__', mergedStyles);
-    }
-    // Styles mode: tastyStatic(styles)
-    if (process.env.NODE_ENV !== 'production') {
-        console.warn('[tasty] tastyStatic(styles) was called at runtime. ' +
-            'This indicates the Babel plugin is not configured. ' +
-            'Add @cube-dev/ui-kit/tasty/zero/babel to your Babel config.');
-    }
-    // Return placeholder - styles won't be applied without the plugin
-    return createStaticStyle('__TASTY_STATIC_NOT_TRANSFORMED__', stylesOrBaseOrSelector);
-}
-
-        

package/es/tasty/static/types.js

@@ -1,34 +0,0 @@
-/**
- * @license MIT
- * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-76be278
- * Released under the MIT license.
- */
-
-/**
- * Create a StaticStyle object.
- * Used internally by the Babel plugin to generate output.
- */
-export function createStaticStyle(className, styles) {
-    return {
-        className,
-        styles,
-        toString() {
-            return this.className;
-        },
-    };
-}
-/**
- * Type guard to check if a value is a StaticStyle object.
- */
-export function isStaticStyle(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        'className' in value &&
-        'styles' in value &&
-        'toString' in value &&
-        typeof value.className === 'string' &&
-        typeof value.styles === 'object');
-}
-
-