@cube-dev/ui-kit 0.0.0-canary-703d044 → 0.0.0-canary-82495e0

package/es/tasty/utils/warnings.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * Released under the MIT license.
  */
 

package/es/tokens.js

@@ -1,7 +1,7 @@
 /**
  * @license MIT
  * author: Cube Dev Team
- * @cube-dev/ui-kit v0.0.0-canary-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * 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-703d044
+ * @cube-dev/ui-kit v0.0.0-canary-82495e0
  * Released under the MIT license.
  */
 
-export const VERSION = '0.0.0-canary-703d044';
+export const VERSION = '0.0.0-canary-82495e0';
 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-703d044",
+  "version": "0.0.0-canary-82495e0",
   "description": "UIKit for Cube Projects",
   "keywords": [
     "uikit"

package/types/tasty/chunks/cacheKey.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Chunk-specific cache key generation.
+ *
+ * Generates cache keys that only include styles relevant to a specific chunk,
+ * enabling more granular caching and reuse.
+ */
+import { Styles } from '../styles/types';
+/**
+ * Generate a cache key for a specific chunk.
+ *
+ * Only includes the styles that belong to this chunk, allowing
+ * chunks to be cached independently.
+ *
+ * @param styles - The full styles object
+ * @param chunkName - Name of the chunk
+ * @param styleKeys - Keys of styles belonging to this chunk
+ * @returns A stable cache key string
+ */
+export declare function generateChunkCacheKey(styles: Styles, chunkName: string, styleKeys: string[]): string;

package/types/tasty/chunks/definitions.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Style chunk definitions for CSS chunking optimization.
+ *
+ * Styles are grouped into chunks based on:
+ * 1. Handler dependencies - styles that share a handler MUST be in the same chunk
+ * 2. Logical grouping - related styles grouped for better cache reuse
+ *
+ * See STYLE_CHUNKING_SPEC.md for detailed rationale.
+ */
+/**
+ * Appearance chunk - visual styling with independent handlers
+ */
+export declare const APPEARANCE_CHUNK_STYLES: readonly ["fill", "color", "opacity", "border", "radius", "outline", "shadow", "fade"];
+/**
+ * Font chunk - typography styles
+ * ⚠️ presetStyle handler requires: preset, fontSize, lineHeight, letterSpacing,
+ *    textTransform, fontWeight, fontStyle, font - all MUST stay together
+ */
+export declare const FONT_CHUNK_STYLES: readonly ["preset", "font", "fontWeight", "fontStyle", "fontSize", "lineHeight", "letterSpacing", "textTransform", "textAlign", "whiteSpace", "textDecoration", "textOverflow", "wordBreak", "wordWrap", "boldFontWeight"];
+/**
+ * Dimension chunk - sizing and spacing
+ * ⚠️ paddingStyle handler requires all padding variants together
+ * ⚠️ marginStyle handler requires all margin variants together
+ */
+export declare const DIMENSION_CHUNK_STYLES: readonly ["padding", "paddingTop", "paddingRight", "paddingBottom", "paddingLeft", "paddingBlock", "paddingInline", "margin", "marginTop", "marginRight", "marginBottom", "marginLeft", "marginBlock", "marginInline", "width", "height", "minWidth", "maxWidth", "minHeight", "maxHeight", "flexBasis", "flexGrow", "flexShrink", "flex"];
+/**
+ * Container chunk - display, flow, and grid layout
+ * ⚠️ FORCED TOGETHER by transitive handler dependencies:
+ *    displayStyle(display,hide) + flowStyle(display,flow) +
+ *    gapStyle(display,flow,gap) + groupRadiusAttr(groupRadius,flow)
+ */
+export declare const CONTAINER_CHUNK_STYLES: readonly ["display", "hide", "flow", "gap", "groupRadius", "placeItems", "placeContent", "alignItems", "alignContent", "justifyItems", "justifyContent", "align", "justify", "place", "columnGap", "rowGap", "gridColumns", "gridRows", "gridTemplate", "gridAreas", "gridAutoFlow", "gridAutoColumns", "gridAutoRows"];
+/**
+ * Scrollbar chunk - scrollbar and overflow
+ * ⚠️ scrollbarStyle handler requires scrollbar ↔ overflow together
+ */
+export declare const SCROLLBAR_CHUNK_STYLES: readonly ["scrollbar", "overflow", "styledScrollbar"];
+/**
+ * Position chunk - element positioning (all independent handlers)
+ */
+export declare const POSITION_CHUNK_STYLES: readonly ["position", "inset", "top", "right", "bottom", "left", "zIndex", "gridArea", "gridColumn", "gridRow", "order", "placeSelf", "alignSelf", "justifySelf"];
+export declare const CHUNK_NAMES: {
+    readonly SUBCOMPONENTS: "subcomponents";
+    readonly APPEARANCE: "appearance";
+    readonly FONT: "font";
+    readonly DIMENSION: "dimension";
+    readonly CONTAINER: "container";
+    readonly SCROLLBAR: "scrollbar";
+    readonly POSITION: "position";
+    readonly MISC: "misc";
+};
+export type ChunkName = (typeof CHUNK_NAMES)[keyof typeof CHUNK_NAMES];
+/**
+ * Pre-computed map for O(1) style-to-chunk lookup.
+ * Built once at module load time.
+ */
+export declare const STYLE_TO_CHUNK: Map<string, ChunkName>;
+export interface ChunkInfo {
+    /** Name of the chunk */
+    name: ChunkName | string;
+    /** Style keys belonging to this chunk */
+    styleKeys: string[];
+}
+/**
+ * Categorize style keys into chunks.
+ *
+ * Returns chunks in a deterministic order (by CHUNK_ORDER) regardless
+ * of the order of keys in the input styles object.
+ *
+ * @param styles - The styles object to categorize
+ * @returns Map of chunk name to array of style keys in that chunk (in priority order)
+ */
+export declare function categorizeStyleKeys(styles: Record<string, unknown>): Map<string, string[]>;

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

@@ -0,0 +1,4 @@
+export { APPEARANCE_CHUNK_STYLES, FONT_CHUNK_STYLES, DIMENSION_CHUNK_STYLES, CONTAINER_CHUNK_STYLES, SCROLLBAR_CHUNK_STYLES, POSITION_CHUNK_STYLES, CHUNK_NAMES, STYLE_TO_CHUNK, categorizeStyleKeys, } from './definitions';
+export type { ChunkName, ChunkInfo } from './definitions';
+export { generateChunkCacheKey } from './cacheKey';
+export { renderStylesForChunk } from './renderChunk';

package/types/tasty/chunks/renderChunk.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Chunk-specific style rendering.
+ *
+ * Renders styles for a specific chunk by filtering the styles object
+ * to only include relevant keys before passing to renderStyles.
+ */
+import { Styles } from '../styles/types';
+import { RenderResult } from '../utils/renderStyles';
+/**
+ * Render styles for a specific chunk.
+ *
+ * Creates a filtered styles object containing only the keys for this chunk,
+ * then delegates to the existing renderStyles function.
+ *
+ * @param styles - The full styles object
+ * @param chunkName - Name of the chunk being rendered
+ * @param styleKeys - Keys of styles belonging to this chunk
+ * @returns RenderResult with rules for this chunk
+ */
+export declare function renderStylesForChunk(styles: Styles, chunkName: string, styleKeys: string[]): RenderResult;

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

@@ -0,0 +1,4 @@
+export { useStyles } from './useStyles';
+export type { UseStylesOptions, UseStylesResult } from './useStyles';
+export { useGlobalStyles } from './useGlobalStyles';
+export type { UseGlobalStylesOptions } from './useGlobalStyles';

package/types/tasty/hooks/useGlobalStyles.d.ts

@@ -0,0 +1,32 @@
+import { Styles } from '../styles/types';
+export interface UseGlobalStylesOptions {
+    /**
+     * CSS selector to apply styles to (e.g., '.my-class', ':root', 'body')
+     */
+    selector: string;
+    /**
+     * Tasty styles object
+     */
+    styles?: Styles;
+}
+/**
+ * Hook to inject global styles for a given selector.
+ * Useful for styling elements by selector without generating classNames.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   useGlobalStyles({
+ *     selector: '.card',
+ *     styles: {
+ *       padding: '2x',
+ *       radius: '1r',
+ *       fill: '#white',
+ *     }
+ *   });
+ *
+ *   return <div className="card">Content</div>;
+ * }
+ * ```
+ */
+export declare function useGlobalStyles({ selector, styles, }: UseGlobalStylesOptions): void;

package/types/tasty/hooks/useStyles.d.ts

@@ -0,0 +1,38 @@
+import { Styles } from '../styles/types';
+export interface UseStylesOptions {
+    /**
+     * Tasty styles object to generate CSS classes for
+     */
+    styles?: Styles;
+}
+export interface UseStylesResult {
+    /**
+     * Generated className(s) to apply to the element.
+     * Can be empty string if no styles are provided.
+     * With chunking enabled, may contain multiple space-separated class names.
+     */
+    className: string;
+}
+/**
+ * Hook to generate CSS classes from Tasty styles.
+ * Handles style rendering, className allocation, and CSS injection.
+ *
+ * Uses chunking to split styles into logical groups for better caching
+ * and CSS reuse across components.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { className } = useStyles({
+ *     styles: {
+ *       padding: '2x',
+ *       fill: '#purple',
+ *       radius: '1r',
+ *     }
+ *   });
+ *
+ *   return <div className={className}>Styled content</div>;
+ * }
+ * ```
+ */
+export declare function useStyles({ styles }: UseStylesOptions): UseStylesResult;

package/types/tasty/index.d.ts

@@ -1,4 +1,8 @@
 export { tasty, Element } from './tasty';
+export { useStyles, useGlobalStyles } from './hooks';
+export type { UseStylesOptions, UseStylesResult, UseGlobalStylesOptions, } from './hooks';
+export { CHUNK_NAMES, STYLE_TO_CHUNK, categorizeStyleKeys } from './chunks';
+export type { ChunkName, ChunkInfo } from './chunks';
 export * from './utils/filterBaseProps';
 export * from './utils/colors';
 export * from './utils/styles';

package/types/tasty/tasty.d.ts

@@ -1,7 +1,7 @@
 import { AllHTMLAttributes, ComponentType, ForwardRefExoticComponent, JSX, PropsWithoutRef, RefAttributes } from 'react';
 import { Styles, StylesInterface } from './styles/types';
 import { AllBaseProps, BaseProps, BaseStyleProps, Props, Tokens } from './types';
-import { StyleValue, StyleValueStateMap } from './utils/styles';
+import type { StyleValue, StyleValueStateMap } from './utils/styles';
 type StyleList = readonly (keyof {
     [key in keyof StylesInterface]: StylesInterface[key];
 })[];