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

package/es/tokens/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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/ResizeSensor.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/modules.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/promise.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/raf.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/random.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/range.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/RenderCache.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/Slots.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/chain.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/forwardRefWithGenerics.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/interactions.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/isTextOnly.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/mapProps.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/mergeProps.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/nullableValue.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/resolveIcon.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/sharedStore.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/useCombinedRefs.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/useControlledFocusVisible.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/useEventBus.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/useId.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/useIsDarwin.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/useKeySymbols.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/useLayoutEffect.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/useLocalStorage.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/useQaProps.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/useViewportSize.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/react/wrapNodeIfPlain.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/utils/tree.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-1f888ae
  * Released under the MIT license.
  */
 

package/es/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-1f888ae
  * Released under the MIT license.
  */
 

package/es/version.js

@@ -1,11 +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-1f888ae
  * Released under the MIT license.
  */
 
-export const VERSION = '0.0.0-canary-43d3dd9';
+export const VERSION = '0.0.0-canary-1f888ae';
 if (typeof window !== 'undefined') {
     const version = VERSION;
     // Ensure CubeUIKit is defined on window in a way bundlers recognize

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cube-dev/ui-kit",
-  "version": "0.0.0-canary-43d3dd9",
+  "version": "0.0.0-canary-1f888ae",
   "description": "UIKit for Cube Projects",
   "keywords": [
     "uikit"

package/types/tasty/config.d.ts

@@ -13,6 +13,7 @@
 import type { KeyframesSteps } from './injector/types';
 import type { StyleDetails, UnitHandler } from './parser/types';
 import type { TastyPlugin } from './plugins/types';
+import type { StyleHandlerDefinition } from './utils/styles';
 /**
  * Configuration options for the Tasty style system
  */
@@ -93,6 +94,35 @@ export interface TastyConfig {
      * ```
      */
     keyframes?: Record<string, KeyframesSteps>;
+    /**
+     * Custom style handlers that transform style properties into CSS declarations.
+     * Handlers replace built-in handlers for the same style name.
+     * @example
+     * ```ts
+     * import { styleHandlers } from '@cube-dev/ui-kit';
+     *
+     * configure({
+     *   handlers: {
+     *     // Override fill with custom behavior
+     *     fill: ({ fill }) => {
+     *       if (fill?.startsWith('gradient:')) {
+     *         return { background: fill.slice(9) };
+     *       }
+     *       return styleHandlers.fill({ fill });
+     *     },
+     *     // Add new custom style
+     *     elevation: ({ elevation }) => {
+     *       const level = parseInt(elevation) || 1;
+     *       return {
+     *         'box-shadow': `0 ${level * 2}px ${level * 4}px rgba(0,0,0,0.1)`,
+     *         'z-index': String(level * 100),
+     *       };
+     *     },
+     *   },
+     * });
+     * ```
+     */
+    handlers?: Record<string, StyleHandlerDefinition>;
     /**
      * Predefined tokens that are replaced during style parsing.
      * Token values are processed through the parser (like component tokens).

package/types/tasty/index.d.ts

@@ -13,6 +13,7 @@ export * from './utils/filterBaseProps';
 export * from './utils/colors';
 export * from './utils/styles';
 export * from './utils/modAttrs';
+export { styleHandlers } from './styles';
 export { renderStyles, isSelector } from './pipeline';
 export type { StyleResult, RenderResult } from './pipeline';
 export * from './utils/dotize';

package/types/tasty/plugins/types.d.ts

@@ -1,6 +1,7 @@
 import type { StyleDetails, UnitHandler } from '../parser/types';
+import type { StyleHandlerDefinition } from '../utils/styles';
 /**
- * A tasty plugin that extends the style system with custom functions, units, or states.
+ * A tasty plugin that extends the style system with custom functions, units, states, or handlers.
  */
 export interface TastyPlugin {
     /** Unique name for the plugin (used for debugging and conflict detection) */
@@ -11,6 +12,20 @@ export interface TastyPlugin {
     units?: Record<string, string | UnitHandler>;
     /** Custom state aliases (e.g., `'@mobile': '@media(w < 768px)'`) */
     states?: Record<string, string>;
+    /**
+     * Custom style handlers that transform style properties into CSS declarations.
+     * Handlers replace built-in handlers for the same style name.
+     * @example
+     * ```ts
+     * handlers: {
+     *   // Simple handler - lookup style inferred from key
+     *   fill: ({ fill }) => fill ? { 'background-color': fill } : undefined,
+     *   // Multi-property handler
+     *   spacing: [['gap', 'padding'], ({ gap, padding }) => ({ ... })],
+     * }
+     * ```
+     */
+    handlers?: Record<string, StyleHandlerDefinition>;
     /** Predefined tokens replaced during style parsing (`$name` or `#name`) */
     tokens?: {
         [key: `$${string}` | `#${string}`]: string | number;

package/types/tasty/styles/boxShadow.combinator.d.ts

@@ -1,6 +1,6 @@
-export declare function boxShadowCombinator(styles: any): "" | {
+export declare function boxShadowCombinator(styles: any): {
     'box-shadow': string;
-};
+} | undefined;
 export declare namespace boxShadowCombinator {
     var __lookupStyles: string[];
 }

package/types/tasty/styles/color.d.ts

@@ -1,8 +1,8 @@
 export declare function colorStyle({ color }: {
     color: any;
-}): "" | {
+}): {
     color: any;
-};
+} | undefined;
 export declare namespace colorStyle {
     var __lookupStyles: string[];
 }

package/types/tasty/styles/dimension.d.ts

@@ -1 +1 @@
-export declare function dimensionStyle(name: any): (val: any) => "" | Record<string, string | string[]>;
+export declare function dimensionStyle(name: any): (val: any) => Record<string, string | string[]> | undefined;

package/types/tasty/styles/fade.d.ts

@@ -1,9 +1,9 @@
 export declare function fadeStyle({ fade }: {
     fade: any;
-}): "" | {
+}): {
     mask: any;
     'mask-composite': string;
-};
+} | undefined;
 export declare namespace fadeStyle {
     var __lookupStyles: string[];
 }

package/types/tasty/styles/fill.d.ts

@@ -1,16 +1,16 @@
 export declare function fillStyle({ fill }: {
     fill: any;
-}): "" | {
+}): {
     'background-color': any;
-};
+} | undefined;
 export declare namespace fillStyle {
     var __lookupStyles: string[];
 }
 export declare function svgFillStyle({ svgFill }: {
     svgFill: any;
-}): "" | {
+}): {
     fill: any;
-};
+} | undefined;
 export declare namespace svgFillStyle {
     var __lookupStyles: string[];
 }

package/types/tasty/styles/groupRadius.d.ts

@@ -1,11 +1,11 @@
 export declare function groupRadiusAttr({ groupRadius, flow }: {
     groupRadius: any;
     flow: any;
-}): "" | {
+}): {
     $: string;
     'border-radius': any;
     '--local-radius': any;
-}[];
+}[] | undefined;
 export declare namespace groupRadiusAttr {
     var __lookupStyles: string[];
 }

package/types/tasty/styles/height.d.ts

@@ -1,6 +1,6 @@
 export declare function heightStyle({ height }: {
     height: any;
-}): "" | Record<string, string | string[]>;
+}): Record<string, string | string[]> | undefined;
 export declare namespace heightStyle {
     var __lookupStyles: string[];
 }

package/types/tasty/styles/index.d.ts

@@ -1,5 +1,7 @@
+import { styleHandlers } from './predefined';
 declare const STYLE_HANDLER_MAP: {
     [x: string]: import("..").StyleHandler[];
 }, defineCustomStyle: typeof import("./predefined").defineCustomStyle, defineStyleAlias: typeof import("./predefined").defineStyleAlias;
-export { STYLE_HANDLER_MAP, defineCustomStyle, defineStyleAlias };
+export { STYLE_HANDLER_MAP, defineCustomStyle, defineStyleAlias, styleHandlers, };
 export * from './createStyle';
+export { normalizeHandlerDefinition, registerHandler, validateHandlerResult, } from './predefined';

package/types/tasty/styles/predefined.d.ts

@@ -1,4 +1,29 @@
-import { RawStyleHandler, StyleHandler } from '../utils/styles';
+import { RawStyleHandler, StyleHandler, StyleHandlerDefinition } from '../utils/styles';
+import { alignStyle } from './align';
+import { borderStyle } from './border';
+import { colorStyle } from './color';
+import { displayStyle } from './display';
+import { fadeStyle } from './fade';
+import { fillStyle, svgFillStyle } from './fill';
+import { flowStyle } from './flow';
+import { fontStyle } from './font';
+import { fontStyleStyle } from './fontStyle';
+import { gapStyle } from './gap';
+import { groupRadiusAttr } from './groupRadius';
+import { heightStyle } from './height';
+import { insetStyle } from './inset';
+import { justifyStyle } from './justify';
+import { marginStyle } from './margin';
+import { outlineStyle } from './outline';
+import { paddingStyle } from './padding';
+import { presetStyle } from './preset';
+import { radiusStyle } from './radius';
+import { resetStyle } from './reset';
+import { scrollbarStyle } from './scrollbar';
+import { shadowStyle } from './shadow';
+import { styledScrollbarStyle } from './styledScrollbar';
+import { transitionStyle } from './transition';
+import { widthStyle } from './width';
 type StyleHandlerMap = Record<string, StyleHandler[]>;
 export declare const STYLE_HANDLER_MAP: StyleHandlerMap;
 export declare function defineCustomStyle(names: string[] | StyleHandler, handler?: RawStyleHandler): void;
@@ -9,4 +34,72 @@ export declare function predefine(): {
     defineCustomStyle: typeof defineCustomStyle;
     defineStyleAlias: typeof defineStyleAlias;
 };
+/**
+ * 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 declare function normalizeHandlerDefinition(keyName: string, definition: StyleHandlerDefinition): StyleHandler;
+/**
+ * Validate a handler result in development mode.
+ * Call this after invoking a handler to check the return value.
+ */
+export declare function validateHandlerResult(name: string, result: unknown): 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 declare function registerHandler(handler: StyleHandler): void;
+/**
+ * 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 declare const styleHandlers: {
+    readonly align: typeof alignStyle;
+    readonly border: typeof borderStyle;
+    readonly color: typeof colorStyle;
+    readonly display: typeof displayStyle;
+    readonly fade: typeof fadeStyle;
+    readonly fill: typeof fillStyle;
+    readonly svgFill: typeof svgFillStyle;
+    readonly flow: typeof flowStyle;
+    readonly font: typeof fontStyle;
+    readonly fontStyle: typeof fontStyleStyle;
+    readonly gap: typeof gapStyle;
+    readonly groupRadius: typeof groupRadiusAttr;
+    readonly height: typeof heightStyle;
+    readonly inset: typeof insetStyle;
+    readonly justify: typeof justifyStyle;
+    readonly margin: typeof marginStyle;
+    readonly outline: typeof outlineStyle;
+    readonly padding: typeof paddingStyle;
+    readonly preset: typeof presetStyle;
+    readonly radius: typeof radiusStyle;
+    readonly reset: typeof resetStyle;
+    readonly scrollbar: typeof scrollbarStyle;
+    readonly shadow: typeof shadowStyle;
+    readonly styledScrollbar: typeof styledScrollbarStyle;
+    readonly transition: typeof transitionStyle;
+    readonly width: typeof widthStyle;
+};
 export {};

package/types/tasty/styles/preset.d.ts

@@ -8,7 +8,7 @@ export declare function presetStyle({ preset, fontSize, lineHeight, textTransfor
     fontWeight?: string | number;
     fontStyle?: string;
     font?: string;
-}): "" | Styles;
+}): Styles | undefined;
 export declare namespace presetStyle {
     var __lookupStyles: string[];
 }