@cube-dev/ui-kit 0.111.2 → 0.112.0

package/es/providers/TrackingProvider.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/providers/navigation.types.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/providers/navigationAdapter.default.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/services/notification.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/shared/form.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/shared/index.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/stories/Form.legacy-stories.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/stories/FormFieldArgs.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/stories/SimpleLayout.stories.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/stories/Tasty.stories.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/stories/components/ConfirmDeletionDialogForm.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/stories/components/DialogFormApp.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/stories/components/StyledButton.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/stories/lists/baseProps.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/stories/playground/PlaygroundEditor.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/stories/playground/PlaygroundLayout.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/stories/playground/PlaygroundOutput.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/stories/playground/PlaygroundPreview.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/stories/playground/components/Button.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/stories/playground/components/Card.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/stories/playground/components/ScrollProgress.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/stories/playground/examples.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/tasty/chunks/cacheKey.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/tasty/chunks/definitions.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 
@@ -293,7 +293,11 @@ export function categorizeStyleKeys(styles) {
     for (const key of keys) {
         // Skip the $ helper key (used for selector combinators)
         // Skip @keyframes and @properties (processed separately in useStyles)
-        if (key === '$' || key === '@keyframes' || key === '@properties') {
+        // Skip recipe (resolved before pipeline by resolveRecipes)
+        if (key === '$' ||
+            key === '@keyframes' ||
+            key === '@properties' ||
+            key === 'recipe') {
             continue;
         }
         if (isSelector(key)) {

package/es/tasty/chunks/index.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/tasty/chunks/renderChunk.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/tasty/config.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 
@@ -18,7 +18,7 @@
  * reconfigure will emit a warning and be ignored.
  */
 import { StyleInjector } from './injector/injector.js';
-import { clearPipelineCache } from './pipeline/index.js';
+import { clearPipelineCache, isSelector } from './pipeline/index.js';
 import { setGlobalPredefinedStates } from './states/index.js';
 import { normalizeHandlerDefinition, registerHandler, resetHandlers, } from './styles/predefined.js';
 import { isDevEnv } from './utils/is-dev-env.js';
@@ -46,6 +46,8 @@ let currentConfig = null;
 let globalKeyframes = null;
 // Global properties storage (null = no properties configured)
 let globalProperties = null;
+// Global recipes storage (null = no recipes configured)
+let globalRecipes = null;
 /**
  * Internal properties required by tasty core features.
  * These are always injected when styles are first generated.
@@ -216,6 +218,52 @@ function setGlobalProperties(properties) {
     }
     globalProperties = properties;
 }
+// ============================================================================
+// Global Recipes Management
+// ============================================================================
+/**
+ * Check if any global recipes are configured.
+ * Fast path: returns false if no recipes were ever set.
+ */
+export function hasGlobalRecipes() {
+    return globalRecipes !== null && Object.keys(globalRecipes).length > 0;
+}
+/**
+ * Get global recipes configuration.
+ * Returns null if no recipes configured (fast path for zero-overhead).
+ */
+export function getGlobalRecipes() {
+    return globalRecipes;
+}
+/**
+ * Set global recipes (called from configure).
+ * Internal use only.
+ */
+function setGlobalRecipes(recipes) {
+    if (stylesGenerated) {
+        warnOnce('recipes-after-styles', `[Tasty] Cannot update recipes after styles have been generated.\n` +
+            `The new recipes will be ignored.`);
+        return;
+    }
+    // Dev-mode validation
+    if (devMode) {
+        for (const [name, recipeStyles] of Object.entries(recipes)) {
+            for (const key of Object.keys(recipeStyles)) {
+                if (isSelector(key)) {
+                    warnOnce(`recipe-selector-${name}-${key}`, `[Tasty] Recipe "${name}" contains sub-element key "${key}". ` +
+                        `Recipes must be flat styles without sub-element keys. ` +
+                        `Remove the sub-element key from the recipe definition.`);
+                }
+                if (key === 'recipe') {
+                    warnOnce(`recipe-recursive-${name}`, `[Tasty] Recipe "${name}" contains a "recipe" key. ` +
+                        `Recipes cannot reference other recipes. ` +
+                        `Use comma-separated names for composition: recipe: 'base, elevated'.`);
+                }
+            }
+        }
+    }
+    globalRecipes = recipes;
+}
 /**
  * Check if configuration is locked (styles have been generated)
  */
@@ -258,6 +306,7 @@ export function configure(config = {}) {
     let mergedFuncs = {};
     let mergedHandlers = {};
     let mergedTokens = {};
+    let mergedRecipes = {};
     // Process plugins in order
     if (config.plugins) {
         for (const plugin of config.plugins) {
@@ -276,6 +325,9 @@ export function configure(config = {}) {
             if (plugin.tokens) {
                 mergedTokens = { ...mergedTokens, ...plugin.tokens };
             }
+            if (plugin.recipes) {
+                mergedRecipes = { ...mergedRecipes, ...plugin.recipes };
+            }
         }
     }
     // Direct config overrides plugins
@@ -294,6 +346,9 @@ export function configure(config = {}) {
     if (config.tokens) {
         mergedTokens = { ...mergedTokens, ...config.tokens };
     }
+    if (config.recipes) {
+        mergedRecipes = { ...mergedRecipes, ...config.recipes };
+    }
     // Handle predefined states
     if (Object.keys(mergedStates).length > 0) {
         setGlobalPredefinedStates(mergedStates);
@@ -355,8 +410,12 @@ export function configure(config = {}) {
         }
         setGlobalPredefinedTokens(processedTokens);
     }
-    // Create config without states, parser options, plugins, keyframes, properties, handlers, and tokens (handled separately)
-    const { states: _states, parserCacheSize: _parserCacheSize, units: _units, funcs: _funcs, plugins: _plugins, keyframes: _keyframes, properties: _properties, handlers: _handlers, tokens: _tokens, ...injectorConfig } = config;
+    // Handle recipes
+    if (Object.keys(mergedRecipes).length > 0) {
+        setGlobalRecipes(mergedRecipes);
+    }
+    // Create config without states, parser options, plugins, keyframes, properties, handlers, tokens, and recipes (handled separately)
+    const { states: _states, parserCacheSize: _parserCacheSize, units: _units, funcs: _funcs, plugins: _plugins, keyframes: _keyframes, properties: _properties, handlers: _handlers, tokens: _tokens, recipes: _recipes, ...injectorConfig } = config;
     const fullConfig = {
         ...createDefaultConfig(),
         ...currentConfig,
@@ -398,6 +457,7 @@ export function resetConfig() {
     currentConfig = null;
     globalKeyframes = null;
     globalProperties = null;
+    globalRecipes = null;
     resetGlobalPredefinedTokens();
     resetHandlers();
     clearPipelineCache();

package/es/tasty/debug.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/tasty/hooks/index.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/tasty/hooks/useGlobalStyles.js

@@ -1,13 +1,14 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 
 import { useInsertionEffect, useMemo, useRef } from 'react';
 import { injectGlobal } from '../injector/index.js';
 import { renderStyles } from '../pipeline/index.js';
+import { resolveRecipes } from '../utils/resolve-recipes.js';
 /**
  * Hook to inject global styles for a given selector.
  * Useful for styling elements by selector without generating classNames.
@@ -30,10 +31,16 @@ import { renderStyles } from '../pipeline/index.js';
  */
 export function useGlobalStyles(selector, styles) {
     const disposeRef = useRef(null);
+    // Resolve recipes before rendering (zero overhead if no recipes configured)
+    const resolvedStyles = useMemo(() => {
+        if (!styles)
+            return styles;
+        return resolveRecipes(styles);
+    }, [styles]);
     // Render styles with the provided selector
     // Note: renderStyles overload with selector string returns StyleResult[] directly
     const styleResults = useMemo(() => {
-        if (!styles)
+        if (!resolvedStyles)
             return [];
         // Validate selector - empty string would cause renderStyles to return RenderResult instead of StyleResult[]
         if (!selector) {
@@ -43,10 +50,10 @@ export function useGlobalStyles(selector, styles) {
             }
             return [];
         }
-        const result = renderStyles(styles, selector);
+        const result = renderStyles(resolvedStyles, selector);
         // When a non-empty selector is provided, renderStyles returns StyleResult[]
         return result;
-    }, [styles, selector]);
+    }, [resolvedStyles, selector]);
     // Inject as global styles
     useInsertionEffect(() => {
         disposeRef.current?.();

package/es/tasty/hooks/useKeyframes.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/tasty/hooks/useProperty.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/tasty/hooks/useRawCSS.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/tasty/hooks/useStyles.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 
@@ -11,6 +11,7 @@ import { getGlobalKeyframes, hasGlobalKeyframes } from '../config.js';
 import { allocateClassName, inject, keyframes, property } from '../injector/index.js';
 import { extractAnimationNamesFromStyles, extractLocalKeyframes, filterUsedKeyframes, hasLocalKeyframes, mergeKeyframes, replaceAnimationNames, } from '../keyframes/index.js';
 import { extractLocalProperties, hasLocalProperties } from '../properties/index.js';
+import { resolveRecipes } from '../utils/resolve-recipes.js';
 import { stringifyStyles } from '../utils/styles.js';
 /**
  * Check if styles contain @starting-style rules.
@@ -120,16 +121,22 @@ export function useStyles(styles) {
         key: '',
         styles: undefined,
     });
+    // Resolve recipes before any processing (zero overhead if no recipes configured)
+    const resolvedStyles = useMemo(() => {
+        if (!styles)
+            return styles;
+        return resolveRecipes(styles);
+    }, [styles]);
     // Compute style key - this is a primitive string that captures style content
     const styleKey = useMemo(() => {
-        if (!styles || Object.keys(styles).length === 0) {
+        if (!resolvedStyles || Object.keys(resolvedStyles).length === 0) {
             return '';
         }
-        return stringifyStyles(styles);
-    }, [styles]);
+        return stringifyStyles(resolvedStyles);
+    }, [resolvedStyles]);
     // Update ref when styleKey changes (content actually changed)
     if (stylesRef.current.key !== styleKey) {
-        stylesRef.current = { key: styleKey, styles };
+        stylesRef.current = { key: styleKey, styles: resolvedStyles };
     }
     // Process chunks: categorize, generate cache keys, render, and allocate classNames
     // Only depends on styleKey (primitive), not styles object reference

package/es/tasty/index.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 
@@ -10,7 +10,7 @@ import { okhslPlugin } from './plugins/index.js';
 export { tasty, Element } from './tasty.js';
 export { useStyles, useGlobalStyles, useRawCSS, useProperty, useKeyframes, } from './hooks/index.js';
 // Configuration API
-export { configure, getConfig, isConfigLocked, hasStylesGenerated, resetConfig, isTestEnvironment, hasGlobalKeyframes, getGlobalKeyframes, } from './config.js';
+export { configure, getConfig, isConfigLocked, hasStylesGenerated, resetConfig, isTestEnvironment, hasGlobalKeyframes, getGlobalKeyframes, hasGlobalRecipes, getGlobalRecipes, } from './config.js';
 // Plugins
 export { okhslPlugin, okhslFunc } from './plugins/index.js';
 configure({
@@ -29,6 +29,7 @@ export { renderStyles, isSelector } from './pipeline/index.js';
 export * from './utils/dotize.js';
 export * from './styles/list.js';
 export * from './utils/merge-styles.js';
+export { resolveRecipes } from './utils/resolve-recipes.js';
 export * from './utils/warnings.js';
 export * from './utils/get-display-name.js';
 export * from './utils/process-tokens.js';

package/es/tasty/injector/index.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/tasty/injector/injector.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/tasty/injector/sheet-manager.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/tasty/injector/types.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/tasty/keyframes/index.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/tasty/parser/classify.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/tasty/parser/const.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */
 

package/es/tasty/parser/lru.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.111.2
+ * @cube-dev/ui-kit v0.112.0
  * Released under the MIT license.
  */