@cube-dev/ui-kit 0.114.0 → 0.116.0

package/dist/chunks/definitions.js

@@ -0,0 +1,261 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+import { isSelector } from "../pipeline/index.js";
+
+//#region src/tasty/chunks/definitions.ts
+/**
+* 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.
+*
+* ============================================================================
+* ⚠️  CRITICAL ARCHITECTURAL CONSTRAINT: NO CROSS-CHUNK HANDLER DEPENDENCIES
+* ============================================================================
+*
+* Style handlers declare their dependencies via `__lookupStyles` array.
+* This creates a dependency graph where handlers read multiple style props.
+*
+* **ALL styles in a handler's `__lookupStyles` MUST be in the SAME chunk.**
+*
+* Why this matters:
+* 1. Each chunk computes a cache key from ONLY its own style values
+* 2. If a handler reads a style from another chunk, that value isn't in the cache key
+* 3. Changing the cross-chunk style won't invalidate this chunk's cache
+* 4. Result: stale CSS output or incorrect cache hits
+*
+* Example of a violation:
+* ```
+* // flowStyle.__lookupStyles = ['display', 'flow']
+* // If 'display' is in DISPLAY chunk and 'flow' is in LAYOUT chunk:
+* // - User sets { display: 'grid', flow: 'column' }
+* // - LAYOUT chunk caches CSS with flow=column, display=grid
+* // - User changes to { display: 'flex', flow: 'column' }
+* // - LAYOUT chunk cache key unchanged (only has 'flow')
+* // - Returns stale CSS computed with display=grid!
+* ```
+*
+* Before adding/moving styles, verify:
+* 1. Find all handlers that use this style (grep for the style name in __lookupStyles)
+* 2. Ensure ALL styles from each handler's __lookupStyles are in the same chunk
+* ============================================================================
+*/
+/**
+* Appearance chunk - visual styling with independent handlers
+*/
+const APPEARANCE_CHUNK_STYLES = [
+	"fill",
+	"color",
+	"opacity",
+	"border",
+	"radius",
+	"outline",
+	"outlineOffset",
+	"shadow",
+	"fade"
+];
+/**
+* Font chunk - typography styles
+*
+* Handler dependencies (all styles in each handler MUST stay in this chunk):
+* ⚠️ presetStyle: preset, fontSize, lineHeight, letterSpacing, textTransform,
+*    fontWeight, fontStyle, font
+*/
+const FONT_CHUNK_STYLES = [
+	"preset",
+	"font",
+	"fontWeight",
+	"fontStyle",
+	"fontSize",
+	"lineHeight",
+	"letterSpacing",
+	"textTransform",
+	"fontFamily",
+	"textAlign",
+	"textDecoration",
+	"wordBreak",
+	"wordWrap",
+	"boldFontWeight"
+];
+/**
+* Dimension chunk - sizing and spacing
+*
+* Handler dependencies (all styles in each handler MUST stay in this chunk):
+* ⚠️ paddingStyle: padding, paddingTop/Right/Bottom/Left, paddingBlock/Inline
+* ⚠️ marginStyle: margin, marginTop/Right/Bottom/Left, marginBlock/Inline
+* ⚠️ widthStyle: width, minWidth, maxWidth
+* ⚠️ heightStyle: height, minHeight, maxHeight
+*/
+const DIMENSION_CHUNK_STYLES = [
+	"padding",
+	"paddingTop",
+	"paddingRight",
+	"paddingBottom",
+	"paddingLeft",
+	"paddingBlock",
+	"paddingInline",
+	"margin",
+	"marginTop",
+	"marginRight",
+	"marginBottom",
+	"marginLeft",
+	"marginBlock",
+	"marginInline",
+	"width",
+	"minWidth",
+	"maxWidth",
+	"height",
+	"minHeight",
+	"maxHeight",
+	"flexBasis",
+	"flexGrow",
+	"flexShrink",
+	"flex"
+];
+/**
+* Display chunk - display mode, layout flow, text overflow, and scrollbar
+*
+* Handler dependencies (all styles in each handler MUST stay in this chunk):
+* ⚠️ displayStyle: display, hide, textOverflow, overflow, whiteSpace
+* ⚠️ flowStyle: display, flow
+* ⚠️ gapStyle: display, flow, gap
+* ⚠️ scrollbarStyle: scrollbar, overflow
+*/
+const DISPLAY_CHUNK_STYLES = [
+	"display",
+	"hide",
+	"textOverflow",
+	"overflow",
+	"whiteSpace",
+	"flow",
+	"gap",
+	"scrollbar",
+	"styledScrollbar"
+];
+/**
+* Layout chunk - flex/grid alignment and grid templates
+*
+* Note: flow and gap are in DISPLAY chunk due to handler dependencies
+* (flowStyle and gapStyle both require 'display' prop).
+*/
+const LAYOUT_CHUNK_STYLES = [
+	"placeItems",
+	"placeContent",
+	"alignItems",
+	"alignContent",
+	"justifyItems",
+	"justifyContent",
+	"align",
+	"justify",
+	"place",
+	"columnGap",
+	"rowGap",
+	"gridColumns",
+	"gridRows",
+	"gridTemplate",
+	"gridAreas",
+	"gridAutoFlow",
+	"gridAutoColumns",
+	"gridAutoRows"
+];
+/**
+* Position chunk - element positioning
+*
+* Handler dependencies (all styles in each handler MUST stay in this chunk):
+* ⚠️ insetStyle: inset, insetBlock, insetInline, top, right, bottom, left
+*/
+const POSITION_CHUNK_STYLES = [
+	"position",
+	"inset",
+	"insetBlock",
+	"insetInline",
+	"top",
+	"right",
+	"bottom",
+	"left",
+	"zIndex",
+	"gridArea",
+	"gridColumn",
+	"gridRow",
+	"order",
+	"placeSelf",
+	"alignSelf",
+	"justifySelf",
+	"transform",
+	"transition",
+	"animation"
+];
+const CHUNK_NAMES = {
+	COMBINED: "combined",
+	SUBCOMPONENTS: "subcomponents",
+	APPEARANCE: "appearance",
+	FONT: "font",
+	DIMENSION: "dimension",
+	DISPLAY: "display",
+	LAYOUT: "layout",
+	POSITION: "position",
+	MISC: "misc"
+};
+/**
+* Pre-computed map for O(1) style-to-chunk lookup.
+* Built once at module load time.
+*/
+const STYLE_TO_CHUNK = /* @__PURE__ */ new Map();
+function populateStyleToChunkMap() {
+	for (const style of APPEARANCE_CHUNK_STYLES) STYLE_TO_CHUNK.set(style, CHUNK_NAMES.APPEARANCE);
+	for (const style of FONT_CHUNK_STYLES) STYLE_TO_CHUNK.set(style, CHUNK_NAMES.FONT);
+	for (const style of DIMENSION_CHUNK_STYLES) STYLE_TO_CHUNK.set(style, CHUNK_NAMES.DIMENSION);
+	for (const style of DISPLAY_CHUNK_STYLES) STYLE_TO_CHUNK.set(style, CHUNK_NAMES.DISPLAY);
+	for (const style of LAYOUT_CHUNK_STYLES) STYLE_TO_CHUNK.set(style, CHUNK_NAMES.LAYOUT);
+	for (const style of POSITION_CHUNK_STYLES) STYLE_TO_CHUNK.set(style, CHUNK_NAMES.POSITION);
+}
+populateStyleToChunkMap();
+/**
+* Chunk processing order. This ensures deterministic className allocation
+* regardless of style key order in the input.
+*/
+const CHUNK_ORDER = [
+	CHUNK_NAMES.APPEARANCE,
+	CHUNK_NAMES.FONT,
+	CHUNK_NAMES.DIMENSION,
+	CHUNK_NAMES.DISPLAY,
+	CHUNK_NAMES.LAYOUT,
+	CHUNK_NAMES.POSITION,
+	CHUNK_NAMES.MISC,
+	CHUNK_NAMES.SUBCOMPONENTS
+];
+new Map(CHUNK_ORDER.map((name, index) => [name, index]));
+/**
+* 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)
+*/
+function categorizeStyleKeys(styles) {
+	const chunkData = {};
+	const keys = Object.keys(styles);
+	for (const key of keys) {
+		if (key === "$" || key === "@keyframes" || key === "@properties" || key === "recipe") continue;
+		if (isSelector(key)) {
+			if (!chunkData[CHUNK_NAMES.SUBCOMPONENTS]) chunkData[CHUNK_NAMES.SUBCOMPONENTS] = [];
+			chunkData[CHUNK_NAMES.SUBCOMPONENTS].push(key);
+		} else {
+			const chunkName = STYLE_TO_CHUNK.get(key) ?? CHUNK_NAMES.MISC;
+			if (!chunkData[chunkName]) chunkData[chunkName] = [];
+			chunkData[chunkName].push(key);
+		}
+	}
+	const orderedChunks = /* @__PURE__ */ new Map();
+	for (const chunkName of CHUNK_ORDER) if (chunkData[chunkName] && chunkData[chunkName].length > 0) orderedChunks.set(chunkName, chunkData[chunkName].sort());
+	for (const chunkName of Object.keys(chunkData)) if (!orderedChunks.has(chunkName)) orderedChunks.set(chunkName, chunkData[chunkName].sort());
+	return orderedChunks;
+}
+
+//#endregion
+export { CHUNK_NAMES, categorizeStyleKeys };
+//# sourceMappingURL=definitions.js.map

package/dist/chunks/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","names":[],"sources":["../../src/tasty/chunks/definitions.ts"],"sourcesContent":["/**\n * Style chunk definitions for CSS chunking optimization.\n *\n * Styles are grouped into chunks based on:\n * 1. Handler dependencies - styles that share a handler MUST be in the same chunk\n * 2. Logical grouping - related styles grouped for better cache reuse\n *\n * See STYLE_CHUNKING_SPEC.md for detailed rationale.\n *\n * ============================================================================\n * ⚠️  CRITICAL ARCHITECTURAL CONSTRAINT: NO CROSS-CHUNK HANDLER DEPENDENCIES\n * ============================================================================\n *\n * Style handlers declare their dependencies via `__lookupStyles` array.\n * This creates a dependency graph where handlers read multiple style props.\n *\n * **ALL styles in a handler's `__lookupStyles` MUST be in the SAME chunk.**\n *\n * Why this matters:\n * 1. Each chunk computes a cache key from ONLY its own style values\n * 2. If a handler reads a style from another chunk, that value isn't in the cache key\n * 3. Changing the cross-chunk style won't invalidate this chunk's cache\n * 4. Result: stale CSS output or incorrect cache hits\n *\n * Example of a violation:\n * ```\n * // flowStyle.__lookupStyles = ['display', 'flow']\n * // If 'display' is in DISPLAY chunk and 'flow' is in LAYOUT chunk:\n * // - User sets { display: 'grid', flow: 'column' }\n * // - LAYOUT chunk caches CSS with flow=column, display=grid\n * // - User changes to { display: 'flex', flow: 'column' }\n * // - LAYOUT chunk cache key unchanged (only has 'flow')\n * // - Returns stale CSS computed with display=grid!\n * ```\n *\n * Before adding/moving styles, verify:\n * 1. Find all handlers that use this style (grep for the style name in __lookupStyles)\n * 2. Ensure ALL styles from each handler's __lookupStyles are in the same chunk\n * ============================================================================\n */\n\nimport { isSelector } from '../pipeline';\n\n// ============================================================================\n// Chunk Style Lists\n// ============================================================================\n\n/**\n * Appearance chunk - visual styling with independent handlers\n */\nexport const APPEARANCE_CHUNK_STYLES = [\n  'fill', // fillStyle (independent)\n  'color', // colorStyle (independent)\n  'opacity', // independent\n  'border', // borderStyle (independent)\n  'radius', // radiusStyle (independent)\n  'outline', // outlineStyle: outline ↔ outlineOffset\n  'outlineOffset', // outlineStyle: outline ↔ outlineOffset\n  'shadow', // shadowStyle (independent)\n  'fade', // fadeStyle (independent)\n] as const;\n\n/**\n * Font chunk - typography styles\n *\n * Handler dependencies (all styles in each handler MUST stay in this chunk):\n * ⚠️ presetStyle: preset, fontSize, lineHeight, letterSpacing, textTransform,\n *    fontWeight, fontStyle, font\n */\nexport const FONT_CHUNK_STYLES = [\n  // All from presetStyle handler - MUST stay together\n  'preset',\n  'font',\n  'fontWeight',\n  'fontStyle',\n  'fontSize',\n  'lineHeight',\n  'letterSpacing',\n  'textTransform',\n  // Independent text styles grouped for cohesion\n  'fontFamily', // independent alias (logical grouping with font styles)\n  'textAlign',\n  'textDecoration',\n  'wordBreak',\n  'wordWrap',\n  'boldFontWeight',\n] as const;\n\n/**\n * Dimension chunk - sizing and spacing\n *\n * Handler dependencies (all styles in each handler MUST stay in this chunk):\n * ⚠️ paddingStyle: padding, paddingTop/Right/Bottom/Left, paddingBlock/Inline\n * ⚠️ marginStyle: margin, marginTop/Right/Bottom/Left, marginBlock/Inline\n * ⚠️ widthStyle: width, minWidth, maxWidth\n * ⚠️ heightStyle: height, minHeight, maxHeight\n */\nexport const DIMENSION_CHUNK_STYLES = [\n  // All from paddingStyle handler - MUST stay together\n  'padding',\n  'paddingTop',\n  'paddingRight',\n  'paddingBottom',\n  'paddingLeft',\n  'paddingBlock',\n  'paddingInline',\n  // All from marginStyle handler - MUST stay together\n  'margin',\n  'marginTop',\n  'marginRight',\n  'marginBottom',\n  'marginLeft',\n  'marginBlock',\n  'marginInline',\n  // widthStyle handler - MUST stay together\n  'width',\n  'minWidth',\n  'maxWidth',\n  // heightStyle handler - MUST stay together\n  'height',\n  'minHeight',\n  'maxHeight',\n  'flexBasis',\n  'flexGrow',\n  'flexShrink',\n  'flex',\n] as const;\n\n/**\n * Display chunk - display mode, layout flow, text overflow, and scrollbar\n *\n * Handler dependencies (all styles in each handler MUST stay in this chunk):\n * ⚠️ displayStyle: display, hide, textOverflow, overflow, whiteSpace\n * ⚠️ flowStyle: display, flow\n * ⚠️ gapStyle: display, flow, gap\n * ⚠️ scrollbarStyle: scrollbar, overflow\n */\nexport const DISPLAY_CHUNK_STYLES = [\n  // displayStyle handler\n  'display',\n  'hide',\n  'textOverflow',\n  'overflow', // also used by scrollbarStyle\n  'whiteSpace',\n  // flowStyle handler (requires display)\n  'flow',\n  // gapStyle handler (requires display, flow)\n  'gap',\n  // scrollbarStyle handler (requires overflow)\n  'scrollbar',\n  'styledScrollbar', // styledScrollbarStyle (deprecated)\n] as const;\n\n/**\n * Layout chunk - flex/grid alignment and grid templates\n *\n * Note: flow and gap are in DISPLAY chunk due to handler dependencies\n * (flowStyle and gapStyle both require 'display' prop).\n */\nexport const LAYOUT_CHUNK_STYLES = [\n  // Alignment styles (all independent handlers)\n  'placeItems',\n  'placeContent',\n  'alignItems',\n  'alignContent',\n  'justifyItems',\n  'justifyContent',\n  'align', // alignStyle (independent)\n  'justify', // justifyStyle (independent)\n  'place', // placeStyle (independent)\n  'columnGap',\n  'rowGap',\n  // Grid template styles\n  'gridColumns',\n  'gridRows',\n  'gridTemplate',\n  'gridAreas',\n  'gridAutoFlow',\n  'gridAutoColumns',\n  'gridAutoRows',\n] as const;\n\n/**\n * Position chunk - element positioning\n *\n * Handler dependencies (all styles in each handler MUST stay in this chunk):\n * ⚠️ insetStyle: inset, insetBlock, insetInline, top, right, bottom, left\n */\nexport const POSITION_CHUNK_STYLES = [\n  'position',\n  // All from insetStyle handler - MUST stay together\n  'inset',\n  'insetBlock',\n  'insetInline',\n  'top',\n  'right',\n  'bottom',\n  'left',\n  'zIndex',\n  'gridArea',\n  'gridColumn',\n  'gridRow',\n  'order',\n  'placeSelf',\n  'alignSelf',\n  'justifySelf',\n  'transform',\n  'transition',\n  'animation',\n] as const;\n\n// ============================================================================\n// Chunk Names\n// ============================================================================\n\nexport const CHUNK_NAMES = {\n  /** Special chunk for styles that cannot be split (e.g., @starting-style) */\n  COMBINED: 'combined',\n  SUBCOMPONENTS: 'subcomponents',\n  APPEARANCE: 'appearance',\n  FONT: 'font',\n  DIMENSION: 'dimension',\n  DISPLAY: 'display',\n  LAYOUT: 'layout',\n  POSITION: 'position',\n  MISC: 'misc',\n} as const;\n\nexport type ChunkName = (typeof CHUNK_NAMES)[keyof typeof CHUNK_NAMES];\n\n// ============================================================================\n// Style-to-Chunk Lookup Map (O(1) categorization)\n// ============================================================================\n\n/**\n * Pre-computed map for O(1) style-to-chunk lookup.\n * Built once at module load time.\n */\nexport const STYLE_TO_CHUNK: Map<string, ChunkName> = new Map();\n\n// Populate the lookup map\nfunction populateStyleToChunkMap() {\n  for (const style of APPEARANCE_CHUNK_STYLES) {\n    STYLE_TO_CHUNK.set(style, CHUNK_NAMES.APPEARANCE);\n  }\n  for (const style of FONT_CHUNK_STYLES) {\n    STYLE_TO_CHUNK.set(style, CHUNK_NAMES.FONT);\n  }\n  for (const style of DIMENSION_CHUNK_STYLES) {\n    STYLE_TO_CHUNK.set(style, CHUNK_NAMES.DIMENSION);\n  }\n  for (const style of DISPLAY_CHUNK_STYLES) {\n    STYLE_TO_CHUNK.set(style, CHUNK_NAMES.DISPLAY);\n  }\n  for (const style of LAYOUT_CHUNK_STYLES) {\n    STYLE_TO_CHUNK.set(style, CHUNK_NAMES.LAYOUT);\n  }\n  for (const style of POSITION_CHUNK_STYLES) {\n    STYLE_TO_CHUNK.set(style, CHUNK_NAMES.POSITION);\n  }\n}\n\n// Initialize at module load\npopulateStyleToChunkMap();\n\n// ============================================================================\n// Chunk Priority Order\n// ============================================================================\n\n/**\n * Chunk processing order. This ensures deterministic className allocation\n * regardless of style key order in the input.\n */\nconst CHUNK_ORDER: readonly string[] = [\n  CHUNK_NAMES.APPEARANCE,\n  CHUNK_NAMES.FONT,\n  CHUNK_NAMES.DIMENSION,\n  CHUNK_NAMES.DISPLAY,\n  CHUNK_NAMES.LAYOUT,\n  CHUNK_NAMES.POSITION,\n  CHUNK_NAMES.MISC,\n  CHUNK_NAMES.SUBCOMPONENTS,\n] as const;\n\n/**\n * Map from chunk name to its priority index for sorting.\n */\nconst CHUNK_PRIORITY: Map<string, number> = new Map(\n  CHUNK_ORDER.map((name, index) => [name, index]),\n);\n\n// ============================================================================\n// Chunk Info Interface\n// ============================================================================\n\nexport interface ChunkInfo {\n  /** Name of the chunk */\n  name: ChunkName | string;\n  /** Style keys belonging to this chunk */\n  styleKeys: string[];\n}\n\n// ============================================================================\n// Style Categorization\n// ============================================================================\n\n/**\n * Categorize style keys into chunks.\n *\n * Returns chunks in a deterministic order (by CHUNK_ORDER) regardless\n * of the order of keys in the input styles object.\n *\n * @param styles - The styles object to categorize\n * @returns Map of chunk name to array of style keys in that chunk (in priority order)\n */\nexport function categorizeStyleKeys(\n  styles: Record<string, unknown>,\n): Map<string, string[]> {\n  // First pass: collect keys into chunks (unordered)\n  const chunkData: Record<string, string[]> = {};\n  const keys = Object.keys(styles);\n\n  for (const key of keys) {\n    // Skip the $ helper key (used for selector combinators)\n    // Skip @keyframes and @properties (processed separately in useStyles)\n    // Skip recipe (resolved before pipeline by resolveRecipes)\n    if (\n      key === '$' ||\n      key === '@keyframes' ||\n      key === '@properties' ||\n      key === 'recipe'\n    ) {\n      continue;\n    }\n\n    if (isSelector(key)) {\n      // All selectors go into the subcomponents chunk\n      if (!chunkData[CHUNK_NAMES.SUBCOMPONENTS]) {\n        chunkData[CHUNK_NAMES.SUBCOMPONENTS] = [];\n      }\n      chunkData[CHUNK_NAMES.SUBCOMPONENTS].push(key);\n    } else {\n      // Look up the chunk for this style, default to misc\n      const chunkName = STYLE_TO_CHUNK.get(key) ?? CHUNK_NAMES.MISC;\n      if (!chunkData[chunkName]) {\n        chunkData[chunkName] = [];\n      }\n      chunkData[chunkName].push(key);\n    }\n  }\n\n  // Second pass: build ordered Map based on CHUNK_ORDER\n  const orderedChunks = new Map<string, string[]>();\n\n  // Add chunks in priority order\n  for (const chunkName of CHUNK_ORDER) {\n    if (chunkData[chunkName] && chunkData[chunkName].length > 0) {\n      // Sort keys within chunk for consistent cache key generation\n      orderedChunks.set(chunkName, chunkData[chunkName].sort());\n    }\n  }\n\n  // Handle any unknown chunks (shouldn't happen, but be defensive)\n  for (const chunkName of Object.keys(chunkData)) {\n    if (!orderedChunks.has(chunkName)) {\n      orderedChunks.set(chunkName, chunkData[chunkName].sort());\n    }\n  }\n\n  return orderedChunks;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,MAAa,0BAA0B;CACrC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;;;;;AASD,MAAa,oBAAoB;CAE/B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACD;;;;;;;;;;AAWD,MAAa,yBAAyB;CAEpC;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;;;;;;;AAWD,MAAa,uBAAuB;CAElC;CACA;CACA;CACA;CACA;CAEA;CAEA;CAEA;CACA;CACD;;;;;;;AAQD,MAAa,sBAAsB;CAEjC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;;;;AAQD,MAAa,wBAAwB;CACnC;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAMD,MAAa,cAAc;CAEzB,UAAU;CACV,eAAe;CACf,YAAY;CACZ,MAAM;CACN,WAAW;CACX,SAAS;CACT,QAAQ;CACR,UAAU;CACV,MAAM;CACP;;;;;AAYD,MAAa,iCAAyC,IAAI,KAAK;AAG/D,SAAS,0BAA0B;AACjC,MAAK,MAAM,SAAS,wBAClB,gBAAe,IAAI,OAAO,YAAY,WAAW;AAEnD,MAAK,MAAM,SAAS,kBAClB,gBAAe,IAAI,OAAO,YAAY,KAAK;AAE7C,MAAK,MAAM,SAAS,uBAClB,gBAAe,IAAI,OAAO,YAAY,UAAU;AAElD,MAAK,MAAM,SAAS,qBAClB,gBAAe,IAAI,OAAO,YAAY,QAAQ;AAEhD,MAAK,MAAM,SAAS,oBAClB,gBAAe,IAAI,OAAO,YAAY,OAAO;AAE/C,MAAK,MAAM,SAAS,sBAClB,gBAAe,IAAI,OAAO,YAAY,SAAS;;AAKnD,yBAAyB;;;;;AAUzB,MAAM,cAAiC;CACrC,YAAY;CACZ,YAAY;CACZ,YAAY;CACZ,YAAY;CACZ,YAAY;CACZ,YAAY;CACZ,YAAY;CACZ,YAAY;CACb;AAK2C,IAAI,IAC9C,YAAY,KAAK,MAAM,UAAU,CAAC,MAAM,MAAM,CAAC,CAChD;;;;;;;;;;AA0BD,SAAgB,oBACd,QACuB;CAEvB,MAAM,YAAsC,EAAE;CAC9C,MAAM,OAAO,OAAO,KAAK,OAAO;AAEhC,MAAK,MAAM,OAAO,MAAM;AAItB,MACE,QAAQ,OACR,QAAQ,gBACR,QAAQ,iBACR,QAAQ,SAER;AAGF,MAAI,WAAW,IAAI,EAAE;AAEnB,OAAI,CAAC,UAAU,YAAY,eACzB,WAAU,YAAY,iBAAiB,EAAE;AAE3C,aAAU,YAAY,eAAe,KAAK,IAAI;SACzC;GAEL,MAAM,YAAY,eAAe,IAAI,IAAI,IAAI,YAAY;AACzD,OAAI,CAAC,UAAU,WACb,WAAU,aAAa,EAAE;AAE3B,aAAU,WAAW,KAAK,IAAI;;;CAKlC,MAAM,gCAAgB,IAAI,KAAuB;AAGjD,MAAK,MAAM,aAAa,YACtB,KAAI,UAAU,cAAc,UAAU,WAAW,SAAS,EAExD,eAAc,IAAI,WAAW,UAAU,WAAW,MAAM,CAAC;AAK7D,MAAK,MAAM,aAAa,OAAO,KAAK,UAAU,CAC5C,KAAI,CAAC,cAAc,IAAI,UAAU,CAC/B,eAAc,IAAI,WAAW,UAAU,WAAW,MAAM,CAAC;AAI7D,QAAO"}

package/dist/chunks/renderChunk.js

@@ -0,0 +1,68 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+import { extractLocalPredefinedStates } from "../states/index.js";
+import { renderStyles } from "../pipeline/index.js";
+import { CHUNK_NAMES } from "./definitions.js";
+
+//#region src/tasty/chunks/renderChunk.ts
+/**
+* Chunk-specific style rendering.
+*
+* Renders styles for a specific chunk by filtering the styles object
+* to only include relevant keys before passing to 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.
+*
+* IMPORTANT: Local predefined states (e.g., '@mobile': '@media(w < 600px)')
+* are always included in the filtered styles, regardless of which chunk is
+* being rendered. This ensures that state references like '@mobile' in any
+* chunk can be properly resolved by the pipeline.
+*
+* @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
+*/
+function renderStylesForChunk(styles, chunkName, styleKeys) {
+	if (styleKeys.length === 0) return {
+		rules: [],
+		className: ""
+	};
+	if (chunkName === CHUNK_NAMES.SUBCOMPONENTS) return renderSubcomponentsChunk(styles, styleKeys);
+	const localPredefinedStates = extractLocalPredefinedStates(styles);
+	const filteredStyles = {};
+	for (const [key, value] of Object.entries(localPredefinedStates)) filteredStyles[key] = value;
+	for (const key of styleKeys) {
+		const value = styles[key];
+		if (value !== void 0) filteredStyles[key] = value;
+	}
+	return renderStyles(filteredStyles);
+}
+/**
+* Render the subcomponents chunk.
+*
+* Subcomponents (selectors like Label, &::before, etc.) contain nested
+* style objects that need to be preserved in their entirety.
+*
+* @param styles - The full styles object
+* @param selectorKeys - Keys of selectors in this chunk
+* @returns RenderResult with rules for all subcomponents
+*/
+function renderSubcomponentsChunk(styles, selectorKeys) {
+	const localPredefinedStates = extractLocalPredefinedStates(styles);
+	const filteredStyles = {};
+	for (const [key, value] of Object.entries(localPredefinedStates)) filteredStyles[key] = value;
+	for (const key of selectorKeys) {
+		const value = styles[key];
+		if (value !== void 0) filteredStyles[key] = value;
+	}
+	if (styles.$ !== void 0) filteredStyles.$ = styles.$;
+	return renderStyles(filteredStyles);
+}
+
+//#endregion
+export { renderStylesForChunk };
+//# sourceMappingURL=renderChunk.js.map

package/dist/chunks/renderChunk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderChunk.js","names":[],"sources":["../../src/tasty/chunks/renderChunk.ts"],"sourcesContent":["/**\n * Chunk-specific style rendering.\n *\n * Renders styles for a specific chunk by filtering the styles object\n * to only include relevant keys before passing to renderStyles.\n */\n\nimport { RenderResult, renderStyles } from '../pipeline';\nimport { extractLocalPredefinedStates } from '../states';\nimport { Styles } from '../styles/types';\n\nimport { CHUNK_NAMES } from './definitions';\n\n/**\n * Render styles for a specific chunk.\n *\n * Creates a filtered styles object containing only the keys for this chunk,\n * then delegates to the existing renderStyles function.\n *\n * IMPORTANT: Local predefined states (e.g., '@mobile': '@media(w < 600px)')\n * are always included in the filtered styles, regardless of which chunk is\n * being rendered. This ensures that state references like '@mobile' in any\n * chunk can be properly resolved by the pipeline.\n *\n * @param styles - The full styles object\n * @param chunkName - Name of the chunk being rendered\n * @param styleKeys - Keys of styles belonging to this chunk\n * @returns RenderResult with rules for this chunk\n */\nexport function renderStylesForChunk(\n  styles: Styles,\n  chunkName: string,\n  styleKeys: string[],\n): RenderResult {\n  // Empty chunk - return empty result\n  if (styleKeys.length === 0) {\n    return { rules: [], className: '' };\n  }\n\n  // For subcomponents, we need to preserve the nested structure\n  if (chunkName === CHUNK_NAMES.SUBCOMPONENTS) {\n    return renderSubcomponentsChunk(styles, styleKeys);\n  }\n\n  // Extract local predefined states from the full styles object\n  // These must be included for state resolution to work across chunks\n  const localPredefinedStates = extractLocalPredefinedStates(styles);\n\n  // For regular chunks, create a filtered styles object\n  // This is memory-efficient: we only create a shallow copy with filtered keys\n  const filteredStyles: Styles = {};\n\n  // First, add local predefined states so they're available for resolution\n  for (const [key, value] of Object.entries(localPredefinedStates)) {\n    filteredStyles[key] = value;\n  }\n\n  // Then add the chunk's style keys\n  for (const key of styleKeys) {\n    const value = styles[key];\n    if (value !== undefined) {\n      filteredStyles[key] = value;\n    }\n  }\n\n  // Delegate to existing renderStyles\n  return renderStyles(filteredStyles);\n}\n\n/**\n * Render the subcomponents chunk.\n *\n * Subcomponents (selectors like Label, &::before, etc.) contain nested\n * style objects that need to be preserved in their entirety.\n *\n * @param styles - The full styles object\n * @param selectorKeys - Keys of selectors in this chunk\n * @returns RenderResult with rules for all subcomponents\n */\nfunction renderSubcomponentsChunk(\n  styles: Styles,\n  selectorKeys: string[],\n): RenderResult {\n  // Extract local predefined states from the full styles object\n  // These must be included for state resolution to work in nested styles\n  const localPredefinedStates = extractLocalPredefinedStates(styles);\n\n  // Create a styles object containing only the selector keys\n  const filteredStyles: Styles = {};\n\n  // First, add local predefined states so they're available for resolution\n  for (const [key, value] of Object.entries(localPredefinedStates)) {\n    filteredStyles[key] = value;\n  }\n\n  // Then add the selector keys\n  for (const key of selectorKeys) {\n    const value = styles[key];\n    if (value !== undefined) {\n      filteredStyles[key] = value;\n    }\n  }\n\n  // Also copy the $ helper if present (used for selector combinators)\n  if (styles.$ !== undefined) {\n    filteredStyles.$ = styles.$;\n  }\n\n  // Delegate to existing renderStyles\n  return renderStyles(filteredStyles);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAgB,qBACd,QACA,WACA,WACc;AAEd,KAAI,UAAU,WAAW,EACvB,QAAO;EAAE,OAAO,EAAE;EAAE,WAAW;EAAI;AAIrC,KAAI,cAAc,YAAY,cAC5B,QAAO,yBAAyB,QAAQ,UAAU;CAKpD,MAAM,wBAAwB,6BAA6B,OAAO;CAIlE,MAAM,iBAAyB,EAAE;AAGjC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,sBAAsB,CAC9D,gBAAe,OAAO;AAIxB,MAAK,MAAM,OAAO,WAAW;EAC3B,MAAM,QAAQ,OAAO;AACrB,MAAI,UAAU,OACZ,gBAAe,OAAO;;AAK1B,QAAO,aAAa,eAAe;;;;;;;;;;;;AAarC,SAAS,yBACP,QACA,cACc;CAGd,MAAM,wBAAwB,6BAA6B,OAAO;CAGlE,MAAM,iBAAyB,EAAE;AAGjC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,sBAAsB,CAC9D,gBAAe,OAAO;AAIxB,MAAK,MAAM,OAAO,cAAc;EAC9B,MAAM,QAAQ,OAAO;AACrB,MAAI,UAAU,OACZ,gBAAe,OAAO;;AAK1B,KAAI,OAAO,MAAM,OACf,gBAAe,IAAI,OAAO;AAI5B,QAAO,aAAa,eAAe"}

package/dist/components/Block.d.ts

@@ -0,0 +1,11 @@
+
+import { AllBaseProps, ContainerStyleProps } from "../tasty/types.js";
+import "../tasty/index.js";
+import * as react from "react";
+
+//#region src/components/Block.d.ts
+interface CubeBlockProps extends Omit<AllBaseProps, keyof ContainerStyleProps | 'as'>, ContainerStyleProps {}
+declare const Block: react.ForwardRefExoticComponent<CubeBlockProps & react.RefAttributes<unknown>>;
+//#endregion
+export { Block, CubeBlockProps };
+//# sourceMappingURL=Block.d.ts.map

package/dist/components/Block.js

@@ -0,0 +1,22 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+import { extractStyles } from "../tasty/utils/styles.js";
+import { CONTAINER_STYLES } from "../tasty/styles/list.js";
+import { tasty } from "../tasty/tasty.js";
+import { filterBaseProps } from "../tasty/utils/filter-base-props.js";
+import { forwardRef } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/components/Block.tsx
+const BlockElement = tasty({ styles: { display: "block" } });
+const Block = forwardRef(function Block(props, ref) {
+	const styles = extractStyles(props, CONTAINER_STYLES);
+	return /* @__PURE__ */ jsx(BlockElement, {
+		...filterBaseProps(props, { eventProps: true }),
+		ref,
+		styles
+	});
+});
+
+//#endregion
+export { Block };
+//# sourceMappingURL=Block.js.map

package/dist/components/Block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Block.js","names":[],"sources":["../../src/components/Block.tsx"],"sourcesContent":["import { forwardRef } from 'react';\n\nimport {\n  AllBaseProps,\n  CONTAINER_STYLES,\n  ContainerStyleProps,\n  extractStyles,\n  filterBaseProps,\n  tasty,\n} from '../tasty';\n\nconst BlockElement = tasty({\n  styles: {\n    display: 'block',\n  },\n});\n\nexport interface CubeBlockProps\n  extends Omit<AllBaseProps, keyof ContainerStyleProps | 'as'>,\n    ContainerStyleProps {}\n\nexport const Block = forwardRef(function Block(props: CubeBlockProps, ref) {\n  const styles = extractStyles(props, CONTAINER_STYLES);\n\n  return (\n    <BlockElement\n      {...filterBaseProps(props, { eventProps: true })}\n      ref={ref}\n      styles={styles}\n    />\n  );\n});\n"],"mappings":";;;;;;;;;AAWA,MAAM,eAAe,MAAM,EACzB,QAAQ,EACN,SAAS,SACV,EACF,CAAC;AAMF,MAAa,QAAQ,WAAW,SAAS,MAAM,OAAuB,KAAK;CACzE,MAAM,SAAS,cAAc,OAAO,iBAAiB;AAErD,QACE,oBAAC;EACC,GAAI,gBAAgB,OAAO,EAAE,YAAY,MAAM,CAAC;EAC3C;EACG;GACR;EAEJ"}

package/dist/components/CollectionItem.d.ts

@@ -0,0 +1,24 @@
+
+import { CubeItemBadgeProps } from "./content/ItemBadge/ItemBadge.js";
+import { CubeItemProps } from "./content/Item/Item.js";
+import { CubeItemActionProps } from "./actions/ItemAction/ItemAction.js";
+import "./actions/index.js";
+import "../index.js";
+import * as react from "react";
+import { ReactElement } from "react";
+import { ItemProps } from "react-stately";
+import * as _react_types_shared0 from "@react-types/shared";
+
+//#region src/components/CollectionItem.d.ts
+interface CubeCollectionItemProps<T> extends ItemProps<T>, Omit<CubeItemProps, 'children'> {
+  onAction?: () => void;
+  wrapper?: (item: ReactElement) => ReactElement;
+  [key: string]: any;
+}
+declare const _CollectionItem: (<T>(props: CubeCollectionItemProps<T>) => ReactElement) & {
+  Action: react.ForwardRefExoticComponent<Omit<CubeItemActionProps, "ref"> & react.RefAttributes<_react_types_shared0.FocusableRefValue<HTMLElement, HTMLElement>>>;
+  Badge: react.ForwardRefExoticComponent<CubeItemBadgeProps & react.RefAttributes<HTMLDivElement>>;
+};
+//#endregion
+export { CubeCollectionItemProps, _CollectionItem };
+//# sourceMappingURL=CollectionItem.d.ts.map

package/dist/components/CollectionItem.js

@@ -0,0 +1,50 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+import { ItemAction } from "./actions/ItemAction/ItemAction.js";
+import { ItemBadge } from "./content/ItemBadge/ItemBadge.js";
+import { Item } from "react-stately";
+
+//#region src/components/CollectionItem.tsx
+/**
+* Service props that are used by react-stately or parent components
+* and should not be passed to the Item component.
+*/
+const SERVICE_PROPS = new Set([
+	"textValue",
+	"hasChildItems",
+	"childItems",
+	"title",
+	"onAction",
+	"wrapper",
+	"keywords",
+	"forceMount"
+]);
+/**
+* Filters out service props from collection item props, returning only
+* props that should be passed to the Item component.
+*
+* This eliminates the need to manually extract and pass Item props
+* in components like MenuItem, ListBox Option, and Select Option.
+*
+* @param itemProps - The props from a collection item (node.props)
+* @returns Filtered props safe to spread onto Item component
+*
+* @example
+* ```tsx
+* const itemProps = filterCollectionItemProps(item.props);
+* return <Item {...itemProps} />;
+* ```
+*/
+function filterCollectionItemProps(itemProps) {
+	if (!itemProps) return {};
+	const filtered = {};
+	for (const key in itemProps) if (Object.prototype.hasOwnProperty.call(itemProps, key) && !SERVICE_PROPS.has(key)) filtered[key] = itemProps[key];
+	return filtered;
+}
+const _CollectionItem = Object.assign(Item, {
+	Action: ItemAction,
+	Badge: ItemBadge
+});
+
+//#endregion
+export { _CollectionItem, filterCollectionItemProps };
+//# sourceMappingURL=CollectionItem.js.map

package/dist/components/CollectionItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollectionItem.js","names":[],"sources":["../../src/components/CollectionItem.tsx"],"sourcesContent":["import { ReactElement } from 'react';\nimport { Item, ItemProps } from 'react-stately';\n\nimport { ItemAction } from './actions/ItemAction';\nimport { CubeItemProps } from './content/Item/Item';\nimport { ItemBadge } from './content/ItemBadge';\n\nexport interface CubeCollectionItemProps<T>\n  extends ItemProps<T>,\n    Omit<CubeItemProps, 'children'> {\n  onAction?: () => void;\n  wrapper?: (item: ReactElement) => ReactElement;\n  [key: string]: any;\n}\n\n/**\n * Service props that are used by react-stately or parent components\n * and should not be passed to the Item component.\n */\nconst SERVICE_PROPS = new Set([\n  // React Stately props\n  'textValue',\n  'hasChildItems',\n  'childItems',\n  'title',\n  // Custom service props\n  'onAction',\n  'wrapper',\n  'keywords', // CommandMenu-specific\n  'forceMount', // CommandMenu-specific\n]);\n\n/**\n * Filters out service props from collection item props, returning only\n * props that should be passed to the Item component.\n *\n * This eliminates the need to manually extract and pass Item props\n * in components like MenuItem, ListBox Option, and Select Option.\n *\n * @param itemProps - The props from a collection item (node.props)\n * @returns Filtered props safe to spread onto Item component\n *\n * @example\n * ```tsx\n * const itemProps = filterCollectionItemProps(item.props);\n * return <Item {...itemProps} />;\n * ```\n */\nexport function filterCollectionItemProps(\n  itemProps: Record<string, any> | undefined,\n): Record<string, any> {\n  if (!itemProps) {\n    return {};\n  }\n\n  const filtered: Record<string, any> = {};\n\n  for (const key in itemProps) {\n    if (\n      Object.prototype.hasOwnProperty.call(itemProps, key) &&\n      !SERVICE_PROPS.has(key)\n    ) {\n      filtered[key] = itemProps[key];\n    }\n  }\n\n  return filtered;\n}\n\nconst _CollectionItem = Object.assign(\n  Item as <T>(props: CubeCollectionItemProps<T>) => ReactElement,\n  {\n    Action: ItemAction,\n    Badge: ItemBadge,\n  },\n);\n\nexport { _CollectionItem as CollectionItem };\n"],"mappings":";;;;;;;;;;AAmBA,MAAM,gBAAgB,IAAI,IAAI;CAE5B;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACD,CAAC;;;;;;;;;;;;;;;;;AAkBF,SAAgB,0BACd,WACqB;AACrB,KAAI,CAAC,UACH,QAAO,EAAE;CAGX,MAAM,WAAgC,EAAE;AAExC,MAAK,MAAM,OAAO,UAChB,KACE,OAAO,UAAU,eAAe,KAAK,WAAW,IAAI,IACpD,CAAC,cAAc,IAAI,IAAI,CAEvB,UAAS,OAAO,UAAU;AAI9B,QAAO;;AAGT,MAAM,kBAAkB,OAAO,OAC7B,MACA;CACE,QAAQ;CACR,OAAO;CACR,CACF"}