@cube-dev/ui-kit 0.0.0-canary-43d3dd9 → 0.0.0-canary-1ec15f7

package/es/tasty/styles/inset.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 
@@ -11,7 +11,7 @@ export function insetStyle({ inset }) {
         inset = `${inset}px`;
     }
     if (!inset)
-        return '';
+        return;
     if (inset === true)
         inset = '0 0 0 0';
     const processed = parseStyle(inset);

package/es/tasty/styles/justify.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/styles/list.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/styles/margin.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/styles/outline.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/styles/padding.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/styles/place.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/styles/predefined.js

@@ -1,10 +1,11 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 
+import { isDevEnv } from '../utils/isDevEnv.js';
 import { alignStyle } from './align.js';
 import { borderStyle } from './border.js';
 import { colorStyle } from './color.js';
@@ -31,6 +32,7 @@ import { shadowStyle } from './shadow.js';
 import { styledScrollbarStyle } from './styledScrollbar.js';
 import { transitionStyle } from './transition.js';
 import { widthStyle } from './width.js';
+const devMode = isDevEnv();
 const numberConverter = (val) => {
     if (typeof val === 'number') {
         return `${val}px`;
@@ -50,6 +52,37 @@ const rowsConverter = (val) => {
     return;
 };
 export const STYLE_HANDLER_MAP = {};
+// Store initial handler state for reset functionality
+let initialHandlerMapSnapshot = null;
+/**
+ * Capture a snapshot of the current STYLE_HANDLER_MAP.
+ * Called after predefine() to preserve built-in handler state.
+ */
+function captureInitialHandlerState() {
+    initialHandlerMapSnapshot = {};
+    for (const key of Object.keys(STYLE_HANDLER_MAP)) {
+        // Shallow copy the array - handlers themselves are immutable
+        initialHandlerMapSnapshot[key] = [...STYLE_HANDLER_MAP[key]];
+    }
+}
+/**
+ * Reset STYLE_HANDLER_MAP to the initial built-in state.
+ * Called by resetConfig() to restore handlers after tests.
+ */
+export function resetHandlers() {
+    if (!initialHandlerMapSnapshot) {
+        // predefine() hasn't been called yet, nothing to reset
+        return;
+    }
+    // Clear current map
+    for (const key of Object.keys(STYLE_HANDLER_MAP)) {
+        delete STYLE_HANDLER_MAP[key];
+    }
+    // Restore initial state
+    for (const key of Object.keys(initialHandlerMapSnapshot)) {
+        STYLE_HANDLER_MAP[key] = [...initialHandlerMapSnapshot[key]];
+    }
+}
 export function defineCustomStyle(names, handler) {
     let handlerWithLookup;
     if (typeof names === 'function') {
@@ -154,7 +187,168 @@ export function predefine() {
     ]
         // @ts-ignore
         .forEach((handler) => defineCustomStyle(handler));
+    // Capture initial state after all built-in handlers are registered
+    captureInitialHandlerState();
     return { STYLE_HANDLER_MAP, defineCustomStyle, defineStyleAlias };
 }
+// ============================================================================
+// Handler Registration API (for configure())
+// ============================================================================
+/**
+ * Normalize a handler definition to a StyleHandler with __lookupStyles.
+ * - Function only: lookup styles inferred from key name
+ * - [string, fn]: single lookup style
+ * - [string[], fn]: multiple lookup styles
+ */
+export function normalizeHandlerDefinition(keyName, definition) {
+    let handler;
+    let lookupStyles;
+    if (typeof definition === 'function') {
+        // Function only - lookup styles inferred from key name
+        handler = definition;
+        lookupStyles = [keyName];
+    }
+    else if (Array.isArray(definition)) {
+        const [first, fn] = definition;
+        handler = fn;
+        if (typeof first === 'string') {
+            // [string, fn] - single lookup style
+            lookupStyles = [first];
+        }
+        else {
+            // [string[], fn] - multiple lookup styles
+            lookupStyles = first;
+        }
+    }
+    else {
+        throw new Error(`[Tasty] Invalid handler definition for "${keyName}". ` +
+            'Expected function, [string, function], or [string[], function].');
+    }
+    // Validate handler in dev mode
+    validateHandler(keyName, handler, lookupStyles);
+    // Create StyleHandler with __lookupStyles
+    const styleHandler = handler;
+    styleHandler.__lookupStyles = lookupStyles;
+    return styleHandler;
+}
+/**
+ * Validate a handler definition in development mode.
+ */
+function validateHandler(name, handler, lookupStyles) {
+    if (!devMode)
+        return;
+    if (typeof handler !== 'function') {
+        console.warn(`[Tasty] Handler "${name}" is not a function. ` +
+            'Handlers must be functions that return CSSMap, CSSMap[], or void.');
+    }
+    if (!lookupStyles ||
+        !Array.isArray(lookupStyles) ||
+        lookupStyles.length === 0) {
+        console.warn(`[Tasty] Handler "${name}" has invalid lookupStyles. ` +
+            'Expected non-empty array of style names.');
+    }
+}
+/**
+ * Validate a handler result in development mode.
+ * Call this after invoking a handler to check the return value.
+ */
+export function validateHandlerResult(name, result) {
+    if (!devMode)
+        return;
+    if (result === undefined || result === null)
+        return; // void is valid
+    // Check for empty string (migration from old pattern)
+    if (result === '') {
+        console.warn(`[Tasty] Handler "${name}" returned empty string. ` +
+            'Return void/undefined instead for no output.');
+        return;
+    }
+    // Check result is object (CSSMap or CSSMap[])
+    if (typeof result !== 'object') {
+        console.warn(`[Tasty] Handler "${name}" returned invalid type: ${typeof result}. ` +
+            'Expected CSSMap, CSSMap[], or void.');
+    }
+}
+/**
+ * Register a custom handler, replacing any existing handlers for the same lookup styles.
+ * This is called by configure() to process user-defined handlers.
+ */
+export function registerHandler(handler) {
+    const lookupStyles = handler.__lookupStyles;
+    if (!lookupStyles || lookupStyles.length === 0) {
+        if (devMode) {
+            console.warn('[Tasty] Cannot register handler without __lookupStyles property.');
+        }
+        return;
+    }
+    // Replace existing handlers for each lookup style
+    for (const styleName of lookupStyles) {
+        STYLE_HANDLER_MAP[styleName] = [handler];
+    }
+}
+// ============================================================================
+// Wrapped Style Handlers Export
+// ============================================================================
+/**
+ * Create a wrapped handler that can be safely called by users.
+ * The wrapper preserves __lookupStyles for proper registration.
+ */
+function wrapHandler(handler) {
+    const fn = handler;
+    const wrapped = ((props) => fn(props));
+    wrapped.__lookupStyles = handler.__lookupStyles;
+    return wrapped;
+}
+/**
+ * Exported object containing wrapped predefined style handlers.
+ * Users can import and call these to extend or delegate to built-in behavior.
+ *
+ * Internal handlers use *Style suffix for searchability.
+ * External API uses short names for convenience.
+ *
+ * @example
+ * ```ts
+ * import { styleHandlers, configure } from '@cube-dev/ui-kit';
+ *
+ * configure({
+ *   handlers: {
+ *     fill: ({ fill }) => {
+ *       if (fill?.startsWith('gradient:')) {
+ *         return { background: fill.slice(9) };
+ *       }
+ *       return styleHandlers.fill({ fill });
+ *     },
+ *   },
+ * });
+ * ```
+ */
+export const styleHandlers = {
+    align: wrapHandler(alignStyle),
+    border: wrapHandler(borderStyle),
+    color: wrapHandler(colorStyle),
+    display: wrapHandler(displayStyle),
+    fade: wrapHandler(fadeStyle),
+    fill: wrapHandler(fillStyle),
+    svgFill: wrapHandler(svgFillStyle),
+    flow: wrapHandler(flowStyle),
+    font: wrapHandler(fontStyle),
+    fontStyle: wrapHandler(fontStyleStyle),
+    gap: wrapHandler(gapStyle),
+    groupRadius: wrapHandler(groupRadiusAttr),
+    height: wrapHandler(heightStyle),
+    inset: wrapHandler(insetStyle),
+    justify: wrapHandler(justifyStyle),
+    margin: wrapHandler(marginStyle),
+    outline: wrapHandler(outlineStyle),
+    padding: wrapHandler(paddingStyle),
+    preset: wrapHandler(presetStyle),
+    radius: wrapHandler(radiusStyle),
+    reset: wrapHandler(resetStyle),
+    scrollbar: wrapHandler(scrollbarStyle),
+    shadow: wrapHandler(shadowStyle),
+    styledScrollbar: wrapHandler(styledScrollbarStyle),
+    transition: wrapHandler(transitionStyle),
+    width: wrapHandler(widthStyle),
+};
 
         

package/es/tasty/styles/preset.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 
@@ -28,7 +28,7 @@ function setCSSValue(styles, styleName, presetName, isPropOnly = false) {
 }
 export function presetStyle({ preset, fontSize, lineHeight, textTransform, letterSpacing, fontWeight, fontStyle, font, }) {
     if (!preset)
-        return '';
+        return;
     if (preset === true)
         preset = '';
     const processed = parseStyle(preset);

package/es/tasty/styles/radius.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 
@@ -13,7 +13,7 @@ export function radiusStyle({ radius }) {
         radius = `${radius}px`;
     }
     if (!radius)
-        return '';
+        return;
     if (radius === true)
         radius = '1r';
     const processed = parseStyle(radius);

package/es/tasty/styles/reset.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/styles/scrollbar.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/styles/shadow.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 
@@ -15,7 +15,7 @@ function toBoxShadow(shadow) {
 }
 export function shadowStyle({ shadow }) {
     if (!shadow)
-        return '';
+        return;
     if (shadow === true)
         shadow = 'var(--card-shadow)';
     return {

package/es/tasty/styles/styledScrollbar.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/styles/transition.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/styles/types.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/styles/width.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/tasty.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/types.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/utils/cache-wrapper.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/utils/case-converter.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/utils/colors.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/utils/dotize.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/utils/filterBaseProps.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/utils/getDisplayName.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/utils/isDevEnv.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/utils/mergeStyles.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/utils/modAttrs.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/utils/processTokens.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/utils/string.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/utils/styles.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/utils/typography.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/utils/warnings.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/zero/babel.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 
@@ -26,6 +26,7 @@
 import { declare } from '@babel/helper-plugin-utils';
 import * as t from '@babel/types';
 import { setGlobalPredefinedStates } from '../states/index.js';
+import { normalizeHandlerDefinition, registerHandler, } from '../styles/predefined.js';
 import { mergeStyles } from '../utils/mergeStyles.js';
 import { CUSTOM_UNITS, getGlobalFuncs, getGlobalParser, setGlobalPredefinedTokens, } from '../utils/styles.js';
 import { CSSWriter } from './css-writer.js';
@@ -54,6 +55,13 @@ export default declare((api, options) => {
         // Also update the global registry so customFunc() continues to work
         Object.assign(currentFuncs, config.funcs);
     }
+    // Apply custom handlers
+    if (config.handlers) {
+        for (const [name, definition] of Object.entries(config.handlers)) {
+            const handler = normalizeHandlerDefinition(name, definition);
+            registerHandler(handler);
+        }
+    }
     // Apply predefined tokens if configured
     if (config.tokens) {
         // Store tokens (keys are normalized to lowercase by setGlobalPredefinedTokens)

package/es/tasty/zero/css-writer.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/zero/extractor.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/zero/index.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tasty/zero/next.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */
 

package/es/tokens/base.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-43d3dd9
+ * @cube-dev/ui-kit v0.0.0-canary-1ec15f7
  * Released under the MIT license.
  */