@cube-dev/ui-kit 0.114.0 → 0.116.0

package/dist/utils/raf.d.ts

@@ -0,0 +1,22 @@
+
+//#region src/utils/raf.d.ts
+/**
+ * Chains N requestAnimationFrame calls and returns a cancel function.
+ * Useful for ensuring layout is complete before performing operations.
+ *
+ * @param callback - The function to call after N frames
+ * @param count - Number of RAF cycles to wait (default: 1)
+ * @returns A function to cancel the pending RAF call
+ *
+ * @example
+ * const cancel = chainRaf(() => {
+ *   updatePosition();
+ * }, 3);
+ *
+ * // Later, if needed:
+ * cancel();
+ */
+declare function chainRaf(callback: () => void, count?: number): () => void;
+//#endregion
+export { chainRaf };
+//# sourceMappingURL=raf.d.ts.map

package/dist/utils/raf.js

@@ -0,0 +1,41 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+//#region src/utils/raf.ts
+/**
+* Chains N requestAnimationFrame calls and returns a cancel function.
+* Useful for ensuring layout is complete before performing operations.
+*
+* @param callback - The function to call after N frames
+* @param count - Number of RAF cycles to wait (default: 1)
+* @returns A function to cancel the pending RAF call
+*
+* @example
+* const cancel = chainRaf(() => {
+*   updatePosition();
+* }, 3);
+*
+* // Later, if needed:
+* cancel();
+*/
+function chainRaf(callback, count = 1) {
+	let rafId = null;
+	let cancelled = false;
+	const scheduleNext = (remaining) => {
+		if (cancelled) return;
+		if (remaining <= 0) {
+			callback();
+			return;
+		}
+		rafId = requestAnimationFrame(() => {
+			scheduleNext(remaining - 1);
+		});
+	};
+	scheduleNext(count);
+	return () => {
+		cancelled = true;
+		if (rafId !== null) cancelAnimationFrame(rafId);
+	};
+}
+
+//#endregion
+export { chainRaf };
+//# sourceMappingURL=raf.js.map

package/dist/utils/raf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raf.js","names":[],"sources":["../../src/utils/raf.ts"],"sourcesContent":["/**\n * Chains N requestAnimationFrame calls and returns a cancel function.\n * Useful for ensuring layout is complete before performing operations.\n *\n * @param callback - The function to call after N frames\n * @param count - Number of RAF cycles to wait (default: 1)\n * @returns A function to cancel the pending RAF call\n *\n * @example\n * const cancel = chainRaf(() => {\n *   updatePosition();\n * }, 3);\n *\n * // Later, if needed:\n * cancel();\n */\nexport function chainRaf(callback: () => void, count: number = 1): () => void {\n  let rafId: number | null = null;\n  let cancelled = false;\n\n  const scheduleNext = (remaining: number) => {\n    if (cancelled) return;\n\n    if (remaining <= 0) {\n      callback();\n      return;\n    }\n\n    rafId = requestAnimationFrame(() => {\n      scheduleNext(remaining - 1);\n    });\n  };\n\n  scheduleNext(count);\n\n  return () => {\n    cancelled = true;\n    if (rafId !== null) {\n      cancelAnimationFrame(rafId);\n    }\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAgBA,SAAgB,SAAS,UAAsB,QAAgB,GAAe;CAC5E,IAAI,QAAuB;CAC3B,IAAI,YAAY;CAEhB,MAAM,gBAAgB,cAAsB;AAC1C,MAAI,UAAW;AAEf,MAAI,aAAa,GAAG;AAClB,aAAU;AACV;;AAGF,UAAQ,4BAA4B;AAClC,gBAAa,YAAY,EAAE;IAC3B;;AAGJ,cAAa,MAAM;AAEnB,cAAa;AACX,cAAY;AACZ,MAAI,UAAU,KACZ,sBAAqB,MAAM"}

package/dist/utils/random.d.ts

@@ -0,0 +1,10 @@
+
+//#region src/utils/random.d.ts
+declare function random(min: number, max: number): number;
+/**
+ * Generates a unique random ID using current timestamp and random number
+ */
+declare function generateRandomId(): string;
+//#endregion
+export { generateRandomId, random };
+//# sourceMappingURL=random.d.ts.map

package/dist/utils/random.js

@@ -0,0 +1,17 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+//#region src/utils/random.ts
+function random(min, max) {
+	const realMin = min < max ? min : max;
+	const realMax = min < max ? max : min;
+	return realMin + Math.random() * (realMax - realMin);
+}
+/**
+* Generates a unique random ID using current timestamp and random number
+*/
+function generateRandomId() {
+	return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
+}
+
+//#endregion
+export { generateRandomId, random };
+//# sourceMappingURL=random.js.map

package/dist/utils/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","names":[],"sources":["../../src/utils/random.ts"],"sourcesContent":["export function random(min: number, max: number) {\n  const realMin = min < max ? min : max;\n  const realMax = min < max ? max : min;\n\n  return realMin + Math.random() * (realMax - realMin);\n}\n\n/**\n * Generates a unique random ID using current timestamp and random number\n */\nexport function generateRandomId(): string {\n  return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;\n}\n"],"mappings":";;AAAA,SAAgB,OAAO,KAAa,KAAa;CAC/C,MAAM,UAAU,MAAM,MAAM,MAAM;CAClC,MAAM,UAAU,MAAM,MAAM,MAAM;AAElC,QAAO,UAAU,KAAK,QAAQ,IAAI,UAAU;;;;;AAM9C,SAAgB,mBAA2B;AACzC,QAAO,GAAG,KAAK,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,UAAU,GAAG,GAAG"}

package/dist/utils/range.d.ts

@@ -0,0 +1,6 @@
+
+//#region src/utils/range.d.ts
+declare function range<Length extends number>(count: Length): Array<number>;
+//#endregion
+export { range };
+//# sourceMappingURL=range.d.ts.map

package/dist/utils/range.js

@@ -0,0 +1,9 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+//#region src/utils/range.ts
+function range(count) {
+	return Array.from({ length: count }, (_, i) => i);
+}
+
+//#endregion
+export { range };
+//# sourceMappingURL=range.js.map

package/dist/utils/range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.js","names":[],"sources":["../../src/utils/range.ts"],"sourcesContent":["export function range<Length extends number>(count: Length): Array<number> {\n  return Array.from({ length: count }, (_, i) => i);\n}\n"],"mappings":";;AAAA,SAAgB,MAA6B,OAA8B;AACzE,QAAO,MAAM,KAAK,EAAE,QAAQ,OAAO,GAAG,GAAG,MAAM,EAAE"}

package/dist/utils/react/RenderCache.d.ts

@@ -0,0 +1,23 @@
+
+import { ReactElement } from "react";
+
+//#region src/utils/react/RenderCache.d.ts
+interface RenderCacheProps<T> {
+  items: T[];
+  renderKeys: (string | number)[];
+  getKey: (item: T) => string | number;
+  children: (item: T) => ReactElement;
+}
+/**
+ * RenderCache optimizes rendering of item lists by reusing
+ * previously rendered elements for unchanged items.
+ */
+declare function RenderCache<T>({
+  items,
+  renderKeys,
+  getKey,
+  children
+}: RenderCacheProps<T>): ReactElement;
+//#endregion
+export { RenderCache, RenderCacheProps };
+//# sourceMappingURL=RenderCache.d.ts.map

package/dist/utils/react/RenderCache.js

@@ -0,0 +1,30 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+import { useRef } from "react";
+import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
+
+//#region src/utils/react/RenderCache.tsx
+/**
+* RenderCache optimizes rendering of item lists by reusing
+* previously rendered elements for unchanged items.
+*/
+function RenderCache({ items, renderKeys, getKey, children }) {
+	const cacheRef = useRef(/* @__PURE__ */ new Map());
+	const rendered = items.map((item) => {
+		const key = getKey(item);
+		const shouldRerender = renderKeys.includes(key);
+		const cached = cacheRef.current.get(key);
+		if (!cached || shouldRerender) {
+			const element = children(item);
+			cacheRef.current.set(key, element);
+			return element;
+		}
+		return cached;
+	});
+	const currentKeys = new Set(items.map(getKey));
+	for (const key of cacheRef.current.keys()) if (!currentKeys.has(key)) cacheRef.current.delete(key);
+	return /* @__PURE__ */ jsx(Fragment$1, { children: rendered });
+}
+
+//#endregion
+export { RenderCache };
+//# sourceMappingURL=RenderCache.js.map

package/dist/utils/react/RenderCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderCache.js","names":[],"sources":["../../../src/utils/react/RenderCache.tsx"],"sourcesContent":["import { ReactElement, useRef } from 'react';\n\nexport interface RenderCacheProps<T> {\n  items: T[];\n  renderKeys: (string | number)[];\n  getKey: (item: T) => string | number;\n  children: (item: T) => ReactElement;\n}\n\n/**\n * RenderCache optimizes rendering of item lists by reusing\n * previously rendered elements for unchanged items.\n */\nexport function RenderCache<T>({\n  items,\n  renderKeys,\n  getKey,\n  children,\n}: RenderCacheProps<T>): ReactElement {\n  // Store previous renders\n  const cacheRef = useRef<Map<string | number, ReactElement>>(new Map());\n\n  const rendered = items.map((item) => {\n    const key = getKey(item);\n    const shouldRerender = renderKeys.includes(key);\n    const cached = cacheRef.current.get(key);\n\n    if (!cached || shouldRerender) {\n      const element = children(item);\n      cacheRef.current.set(key, element);\n      return element;\n    }\n\n    return cached;\n  });\n\n  // Optionally clean up cache for items no longer present\n  const currentKeys = new Set(items.map(getKey));\n  for (const key of cacheRef.current.keys()) {\n    if (!currentKeys.has(key)) {\n      cacheRef.current.delete(key);\n    }\n  }\n\n  return <>{rendered}</>;\n}\n"],"mappings":";;;;;;;;;AAaA,SAAgB,YAAe,EAC7B,OACA,YACA,QACA,YACoC;CAEpC,MAAM,WAAW,uBAA2C,IAAI,KAAK,CAAC;CAEtE,MAAM,WAAW,MAAM,KAAK,SAAS;EACnC,MAAM,MAAM,OAAO,KAAK;EACxB,MAAM,iBAAiB,WAAW,SAAS,IAAI;EAC/C,MAAM,SAAS,SAAS,QAAQ,IAAI,IAAI;AAExC,MAAI,CAAC,UAAU,gBAAgB;GAC7B,MAAM,UAAU,SAAS,KAAK;AAC9B,YAAS,QAAQ,IAAI,KAAK,QAAQ;AAClC,UAAO;;AAGT,SAAO;GACP;CAGF,MAAM,cAAc,IAAI,IAAI,MAAM,IAAI,OAAO,CAAC;AAC9C,MAAK,MAAM,OAAO,SAAS,QAAQ,MAAM,CACvC,KAAI,CAAC,YAAY,IAAI,IAAI,CACvB,UAAS,QAAQ,OAAO,IAAI;AAIhC,QAAO,4CAAG,WAAY"}

package/dist/utils/react/Slots.d.ts

@@ -0,0 +1,10 @@
+
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/utils/react/Slots.d.ts
+declare function useSlotProps(props: Record<string, any>, defaultSlot: any): Record<string, any>;
+declare function SlotProvider(props: any): react_jsx_runtime0.JSX.Element;
+declare function ClearSlots(props: any): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { ClearSlots, SlotProvider, useSlotProps };
+//# sourceMappingURL=Slots.d.ts.map

package/dist/utils/react/Slots.js

@@ -0,0 +1,40 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+import { mergeProps } from "./mergeProps.js";
+import { Children, cloneElement, createContext, useContext, useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/utils/react/Slots.tsx
+const INITIAL_VALUE = {};
+let SlotContext = createContext(INITIAL_VALUE);
+function useSlotProps(props, defaultSlot) {
+	let slot = props.slot || defaultSlot;
+	let slotProps = (useContext(SlotContext) ?? INITIAL_VALUE)[slot];
+	return mergeProps(slotProps, props);
+}
+function SlotProvider(props) {
+	let parentSlots = useContext(SlotContext) ?? INITIAL_VALUE;
+	let { slots = {}, children } = props;
+	let value = useMemo(() => Object.keys(parentSlots).concat(Object.keys(slots)).reduce((o, p) => ({
+		...o,
+		[p]: mergeProps(parentSlots[p] ?? {}, slots[p] ?? {})
+	}), {}), [parentSlots, slots]);
+	return /* @__PURE__ */ jsx(SlotContext.Provider, {
+		value,
+		children
+	});
+}
+function ClearSlots(props) {
+	const { children, ...otherProps } = props;
+	let content = children;
+	if (Children.toArray(children).length <= 1) {
+		if (typeof children === "function") content = cloneElement(Children.only(children), otherProps);
+	}
+	return /* @__PURE__ */ jsx(SlotContext.Provider, {
+		value: INITIAL_VALUE,
+		children: content
+	});
+}
+
+//#endregion
+export { ClearSlots, SlotProvider, useSlotProps };
+//# sourceMappingURL=Slots.js.map

package/dist/utils/react/Slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Slots.js","names":[],"sources":["../../../src/utils/react/Slots.tsx"],"sourcesContent":["import {\n  Children,\n  cloneElement,\n  createContext,\n  useContext,\n  useMemo,\n} from 'react';\n\nimport { mergeProps } from './mergeProps';\n\nconst INITIAL_VALUE = {};\n\nlet SlotContext = createContext<Object>(INITIAL_VALUE);\n\nexport function useSlotProps(\n  props: Record<string, any>,\n  defaultSlot,\n): Record<string, any> {\n  let slot: string = props.slot || defaultSlot;\n  let allSlots = useContext(SlotContext) ?? INITIAL_VALUE;\n  let slotProps: Record<string, any> = allSlots[slot];\n\n  return mergeProps(slotProps, props);\n}\n\nexport function SlotProvider(props) {\n  let parentSlots = useContext(SlotContext) ?? INITIAL_VALUE;\n  let { slots = {}, children } = props;\n\n  // Merge props for each slot from parent context and props\n  let value = useMemo(\n    () =>\n      Object.keys(parentSlots)\n        .concat(Object.keys(slots))\n        .reduce(\n          (o, p) => ({\n            ...o,\n            [p]: mergeProps(parentSlots[p] ?? {}, slots[p] ?? {}),\n          }),\n          {},\n        ),\n    [parentSlots, slots],\n  );\n\n  return <SlotContext.Provider value={value}>{children}</SlotContext.Provider>;\n}\n\nexport function ClearSlots(props) {\n  const { children, ...otherProps } = props;\n  let content = children;\n\n  if (Children.toArray(children).length <= 1) {\n    if (typeof children === 'function') {\n      // need to know if the node is a string or something else that react can render that doesn't get props\n      content = cloneElement(Children.only(children), otherProps);\n    }\n  }\n\n  return (\n    <SlotContext.Provider value={INITIAL_VALUE}>{content}</SlotContext.Provider>\n  );\n}\n"],"mappings":";;;;;;AAUA,MAAM,gBAAgB,EAAE;AAExB,IAAI,cAAc,cAAsB,cAAc;AAEtD,SAAgB,aACd,OACA,aACqB;CACrB,IAAI,OAAe,MAAM,QAAQ;CAEjC,IAAI,aADW,WAAW,YAAY,IAAI,eACI;AAE9C,QAAO,WAAW,WAAW,MAAM;;AAGrC,SAAgB,aAAa,OAAO;CAClC,IAAI,cAAc,WAAW,YAAY,IAAI;CAC7C,IAAI,EAAE,QAAQ,EAAE,EAAE,aAAa;CAG/B,IAAI,QAAQ,cAER,OAAO,KAAK,YAAY,CACrB,OAAO,OAAO,KAAK,MAAM,CAAC,CAC1B,QACE,GAAG,OAAO;EACT,GAAG;GACF,IAAI,WAAW,YAAY,MAAM,EAAE,EAAE,MAAM,MAAM,EAAE,CAAC;EACtD,GACD,EAAE,CACH,EACL,CAAC,aAAa,MAAM,CACrB;AAED,QAAO,oBAAC,YAAY;EAAgB;EAAQ;GAAgC;;AAG9E,SAAgB,WAAW,OAAO;CAChC,MAAM,EAAE,UAAU,GAAG,eAAe;CACpC,IAAI,UAAU;AAEd,KAAI,SAAS,QAAQ,SAAS,CAAC,UAAU,GACvC;MAAI,OAAO,aAAa,WAEtB,WAAU,aAAa,SAAS,KAAK,SAAS,EAAE,WAAW;;AAI/D,QACE,oBAAC,YAAY;EAAS,OAAO;YAAgB;GAA+B"}

package/dist/utils/react/chain.d.ts

@@ -0,0 +1,9 @@
+
+//#region src/utils/react/chain.d.ts
+/**
+ * Calls all functions in the order they were chained with the same arguments.
+ */
+declare function chain(...callbacks: any[]): (...args: any[]) => void;
+//#endregion
+export { chain };
+//# sourceMappingURL=chain.d.ts.map

package/dist/utils/react/chain.js

@@ -0,0 +1,14 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+//#region src/utils/react/chain.ts
+/**
+* Calls all functions in the order they were chained with the same arguments.
+*/
+function chain(...callbacks) {
+	return (...args) => {
+		for (let callback of callbacks) if (typeof callback === "function") callback(...args);
+	};
+}
+
+//#endregion
+export { chain };
+//# sourceMappingURL=chain.js.map

package/dist/utils/react/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","names":[],"sources":["../../../src/utils/react/chain.ts"],"sourcesContent":["/**\n * Calls all functions in the order they were chained with the same arguments.\n */\nexport function chain(...callbacks) {\n  return (...args) => {\n    for (let callback of callbacks) {\n      if (typeof callback === 'function') {\n        callback(...args);\n      }\n    }\n  };\n}\n"],"mappings":";;;;;AAGA,SAAgB,MAAM,GAAG,WAAW;AAClC,SAAQ,GAAG,SAAS;AAClB,OAAK,IAAI,YAAY,UACnB,KAAI,OAAO,aAAa,WACtB,UAAS,GAAG,KAAK"}

package/dist/utils/react/forwardRefWithGenerics.d.ts

@@ -0,0 +1,33 @@
+
+import * as react from "react";
+import { ReactElement } from "react";
+import { DOMRef } from "@react-types/shared";
+
+//#region src/utils/react/forwardRefWithGenerics.d.ts
+/**
+ * A helper for creating forwardRef components with generic types.
+ * This solves the issue where React's forwardRef doesn't work well with generic components,
+ * especially when props include required children from CollectionBase<T> or similar types.
+ *
+ * @example
+ * ```tsx
+ * function MySelect<T extends object>(
+ *   props: MySelectProps<T>,
+ *   ref: DOMRef<HTMLDivElement>
+ * ) {
+ *   // component implementation
+ *   return <div ref={ref}>...</div>;
+ * }
+ *
+ * const MySelectWithRef = forwardRefWithGenerics(MySelect);
+ *
+ * // Usage:
+ * <MySelectWithRef<ItemType> items={items} ref={myRef} />
+ * ```
+ */
+declare function forwardRefWithGenerics<TProps extends Record<string, any>, TElement extends HTMLElement = HTMLElement>(component: <T extends object>(props: TProps, ref: DOMRef<TElement>) => ReactElement): <T extends object>(props: TProps & {
+  ref?: DOMRef<TElement>;
+}) => ReactElement<unknown, string | react.JSXElementConstructor<any>>;
+//#endregion
+export { forwardRefWithGenerics };
+//# sourceMappingURL=forwardRefWithGenerics.d.ts.map

package/dist/utils/react/forwardRefWithGenerics.js

@@ -0,0 +1,33 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+//#region src/utils/react/forwardRefWithGenerics.tsx
+/**
+* A helper for creating forwardRef components with generic types.
+* This solves the issue where React's forwardRef doesn't work well with generic components,
+* especially when props include required children from CollectionBase<T> or similar types.
+*
+* @example
+* ```tsx
+* function MySelect<T extends object>(
+*   props: MySelectProps<T>,
+*   ref: DOMRef<HTMLDivElement>
+* ) {
+*   // component implementation
+*   return <div ref={ref}>...</div>;
+* }
+*
+* const MySelectWithRef = forwardRefWithGenerics(MySelect);
+*
+* // Usage:
+* <MySelectWithRef<ItemType> items={items} ref={myRef} />
+* ```
+*/
+function forwardRefWithGenerics(component) {
+	return function ComponentWithRef(props) {
+		const { ref = null, ...otherProps } = props;
+		return component(otherProps, ref);
+	};
+}
+
+//#endregion
+export { forwardRefWithGenerics };
+//# sourceMappingURL=forwardRefWithGenerics.js.map

package/dist/utils/react/forwardRefWithGenerics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forwardRefWithGenerics.js","names":[],"sources":["../../../src/utils/react/forwardRefWithGenerics.tsx"],"sourcesContent":["import { DOMRef } from '@react-types/shared';\nimport { ReactElement } from 'react';\n\n/**\n * A helper for creating forwardRef components with generic types.\n * This solves the issue where React's forwardRef doesn't work well with generic components,\n * especially when props include required children from CollectionBase<T> or similar types.\n *\n * @example\n * ```tsx\n * function MySelect<T extends object>(\n *   props: MySelectProps<T>,\n *   ref: DOMRef<HTMLDivElement>\n * ) {\n *   // component implementation\n *   return <div ref={ref}>...</div>;\n * }\n *\n * const MySelectWithRef = forwardRefWithGenerics(MySelect);\n *\n * // Usage:\n * <MySelectWithRef<ItemType> items={items} ref={myRef} />\n * ```\n */\nexport function forwardRefWithGenerics<\n  TProps extends Record<string, any>,\n  TElement extends HTMLElement = HTMLElement,\n>(\n  component: <T extends object>(\n    props: TProps,\n    ref: DOMRef<TElement>,\n  ) => ReactElement,\n) {\n  return function ComponentWithRef<T extends object>(\n    props: TProps & { ref?: DOMRef<TElement> },\n  ) {\n    const { ref = null, ...otherProps } = props;\n    return component(otherProps as TProps, ref);\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAwBA,SAAgB,uBAId,WAIA;AACA,QAAO,SAAS,iBACd,OACA;EACA,MAAM,EAAE,MAAM,MAAM,GAAG,eAAe;AACtC,SAAO,UAAU,YAAsB,IAAI"}

package/dist/utils/react/index.d.ts

@@ -0,0 +1,19 @@
+
+import { _modAttrs } from "../../tasty/utils/mod-attrs.js";
+import "../../tasty/index.js";
+import { chain } from "./chain.js";
+import { forwardRefWithGenerics } from "./forwardRefWithGenerics.js";
+import { isTextOnly } from "./isTextOnly.js";
+import { mergeProps } from "./mergeProps.js";
+import { ClearSlots, SlotProvider, useSlotProps } from "./Slots.js";
+import { useLayoutEffect } from "./useLayoutEffect.js";
+import { mergeRefs, useCombinedRefs } from "./useCombinedRefs.js";
+import { wrapNodeIfPlain } from "./wrapNodeIfPlain.js";
+import { useViewportSize } from "./useViewportSize.js";
+import { useQaProps } from "./useQaProps.js";
+import { EventBusContextValue, EventBusListener, EventBusProvider, useEventBus, useEventListener } from "./useEventBus.js";
+import { UseControlledFocusVisibleResult, useControlledFocusVisible } from "./useControlledFocusVisible.js";
+import { RenderCache, RenderCacheProps } from "./RenderCache.js";
+import { useLocalStorage } from "./useLocalStorage.js";
+import { DynamicIcon, IconRenderFn, ResolvedIcon, resolveIcon } from "./resolveIcon.js";
+import { useMergeStyles } from "./useMergeStyles.js";

package/dist/utils/react/interactions.js

@@ -0,0 +1,22 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+import { useState } from "react";
+import { useFocus, useFocusVisible } from "react-aria";
+
+//#region src/utils/react/interactions.ts
+function useFocus$1({ isDisabled }, onlyVisible = false) {
+	let [isFocused, setIsFocused] = useState(false);
+	if (isDisabled && isFocused) setIsFocused(false);
+	let { isFocusVisible } = useFocusVisible({});
+	let { focusProps } = useFocus({
+		isDisabled,
+		onFocusChange: setIsFocused
+	});
+	return {
+		focusProps,
+		isFocused: isFocused && (onlyVisible ? isFocusVisible : true)
+	};
+}
+
+//#endregion
+export { useFocus$1 as useFocus };
+//# sourceMappingURL=interactions.js.map

package/dist/utils/react/interactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactions.js","names":["useFocus","reactAriaUseFocus"],"sources":["../../../src/utils/react/interactions.ts"],"sourcesContent":["import { useState } from 'react';\nimport { useFocus as reactAriaUseFocus, useFocusVisible } from 'react-aria';\n\nexport function useFocus(\n  { isDisabled }: { isDisabled?: boolean },\n  onlyVisible = false,\n) {\n  let [isFocused, setIsFocused] = useState(false);\n\n  // React-aria detaches focus handlers when disabled, so blur events\n  // aren't captured. Clear stale focus synchronously during render\n  // to avoid a one-frame glitch (useEffect would be too late).\n  if (isDisabled && isFocused) {\n    setIsFocused(false);\n  }\n\n  let { isFocusVisible } = useFocusVisible({});\n  let { focusProps } = reactAriaUseFocus({\n    isDisabled,\n    onFocusChange: setIsFocused,\n  });\n\n  return {\n    focusProps,\n    isFocused: isFocused && (onlyVisible ? isFocusVisible : true),\n  };\n}\n"],"mappings":";;;;;AAGA,SAAgBA,WACd,EAAE,cACF,cAAc,OACd;CACA,IAAI,CAAC,WAAW,gBAAgB,SAAS,MAAM;AAK/C,KAAI,cAAc,UAChB,cAAa,MAAM;CAGrB,IAAI,EAAE,mBAAmB,gBAAgB,EAAE,CAAC;CAC5C,IAAI,EAAE,eAAeC,SAAkB;EACrC;EACA,eAAe;EAChB,CAAC;AAEF,QAAO;EACL;EACA,WAAW,cAAc,cAAc,iBAAiB;EACzD"}

package/dist/utils/react/isTextOnly.d.ts

@@ -0,0 +1,6 @@
+
+//#region src/utils/react/isTextOnly.d.ts
+declare function isTextOnly(children: any): boolean;
+//#endregion
+export { isTextOnly };
+//# sourceMappingURL=isTextOnly.d.ts.map

package/dist/utils/react/isTextOnly.js

@@ -0,0 +1,11 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+import { Children, isValidElement } from "react";
+
+//#region src/utils/react/isTextOnly.ts
+function isTextOnly(children) {
+	return Children.toArray(children).every((c) => !isValidElement(c));
+}
+
+//#endregion
+export { isTextOnly };
+//# sourceMappingURL=isTextOnly.js.map

package/dist/utils/react/isTextOnly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isTextOnly.js","names":[],"sources":["../../../src/utils/react/isTextOnly.ts"],"sourcesContent":["import { Children, isValidElement } from 'react';\n\nexport function isTextOnly(children) {\n  return Children.toArray(children).every((c) => !isValidElement(c));\n}\n"],"mappings":";;;;AAEA,SAAgB,WAAW,UAAU;AACnC,QAAO,SAAS,QAAQ,SAAS,CAAC,OAAO,MAAM,CAAC,eAAe,EAAE,CAAC"}

package/dist/utils/react/mapProps.js

@@ -0,0 +1,14 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+//#region src/utils/react/mapProps.ts
+/** Converts AriaButtonProps to CubeButtonProps */
+function ariaToCubeButtonProps(props) {
+	const { type, ...filteredProps } = props;
+	return {
+		...filteredProps,
+		htmlType: type
+	};
+}
+
+//#endregion
+export { ariaToCubeButtonProps };
+//# sourceMappingURL=mapProps.js.map

package/dist/utils/react/mapProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapProps.js","names":[],"sources":["../../../src/utils/react/mapProps.ts"],"sourcesContent":["import { AriaButtonProps } from 'react-aria';\n\nimport { CubeButtonProps } from '../../components/actions';\n\n/** Converts AriaButtonProps to CubeButtonProps */\nexport function ariaToCubeButtonProps(\n  props: AriaButtonProps<'button'>,\n): CubeButtonProps {\n  const { type, ...filteredProps } = props;\n\n  return {\n    ...filteredProps,\n    htmlType: type,\n  };\n}\n\n/** Converts CubeButtonProps to AriaButtonProps */\nexport function cubeToAriaButtonProps(\n  props: CubeButtonProps,\n): AriaButtonProps<'button'> {\n  const { htmlType, ...filteredProps } = props;\n\n  return {\n    ...filteredProps,\n    type: htmlType,\n  };\n}\n"],"mappings":";;;AAKA,SAAgB,sBACd,OACiB;CACjB,MAAM,EAAE,MAAM,GAAG,kBAAkB;AAEnC,QAAO;EACL,GAAG;EACH,UAAU;EACX"}

package/dist/utils/react/mergeProps.d.ts

@@ -0,0 +1,17 @@
+
+import { Props } from "../../tasty/types.js";
+import "../../tasty/index.js";
+
+//#region src/utils/react/mergeProps.d.ts
+type Merge<T> = T extends [infer F, ...infer R] ? F extends undefined ? Merge<R> : F & Merge<R> : T extends [infer L] ? L : unknown;
+/**
+ * Merges multiple props objects together. Event handlers are chained,
+ * classNames are combined, and ids are deduplicated - different ids
+ * will trigger a side-effect and re-render components hooked up with `useId`.
+ * For all other props, the last prop object overrides all previous ones.
+ * @param args - Multiple sets of props to merge together.
+ */
+declare function mergeProps<T extends (Props | undefined)[], K = Merge<T>>(...args: T): K;
+//#endregion
+export { mergeProps };
+//# sourceMappingURL=mergeProps.d.ts.map

package/dist/utils/react/mergeProps.js

@@ -0,0 +1,34 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+import { mergeStyles } from "../../tasty/utils/merge-styles.js";
+import { chain } from "./chain.js";
+import { mergeIds } from "./useId.js";
+import clsx from "clsx";
+
+//#region src/utils/react/mergeProps.tsx
+/**
+* Merges multiple props objects together. Event handlers are chained,
+* classNames are combined, and ids are deduplicated - different ids
+* will trigger a side-effect and re-render components hooked up with `useId`.
+* For all other props, the last prop object overrides all previous ones.
+* @param args - Multiple sets of props to merge together.
+*/
+function mergeProps(...args) {
+	let result = {};
+	for (let props of args) {
+		for (let key in result) if (/^on[A-Z]/.test(key) && typeof result[key] === "function" && props && typeof props[key] === "function") result[key] = chain(result[key], props[key]);
+		else if (key === "className" && typeof result.className === "string" && props && typeof props.className === "string") result[key] = clsx(result.className, props.className);
+		else if ((key === "styles" || key.endsWith("Styles")) && typeof result.styles === "object" && props && typeof props.styles === "object") result[key] = mergeStyles(result[key], props[key]);
+		else if (key === "mods" && result.mods && props?.mods) result.mods = {
+			...result.mods,
+			...props?.mods
+		};
+		else if (key === "id" && result.id && props?.id) result.id = mergeIds(result.id, props?.id);
+		else result[key] = props && props[key] !== void 0 ? props[key] : result[key];
+		for (let key in props) if (result[key] === void 0) result[key] = props[key];
+	}
+	return result;
+}
+
+//#endregion
+export { mergeProps };
+//# sourceMappingURL=mergeProps.js.map

package/dist/utils/react/mergeProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeProps.js","names":[],"sources":["../../../src/utils/react/mergeProps.tsx"],"sourcesContent":["import clsx from 'clsx';\n\nimport { mergeStyles, Props } from '../../tasty';\n\nimport { chain } from './chain';\nimport { mergeIds } from './useId';\n\ntype Merge<T> = T extends [infer F, ...infer R]\n  ? F extends undefined\n    ? Merge<R>\n    : F & Merge<R>\n  : T extends [infer L]\n    ? L\n    : unknown;\n\n/**\n * Merges multiple props objects together. Event handlers are chained,\n * classNames are combined, and ids are deduplicated - different ids\n * will trigger a side-effect and re-render components hooked up with `useId`.\n * For all other props, the last prop object overrides all previous ones.\n * @param args - Multiple sets of props to merge together.\n */\nexport function mergeProps<T extends (Props | undefined)[], K = Merge<T>>(\n  ...args: T\n): K {\n  let result: any = {};\n\n  for (let props of args) {\n    for (let key in result) {\n      // Chain events\n      if (\n        /^on[A-Z]/.test(key) &&\n        typeof result[key] === 'function' &&\n        props &&\n        typeof props[key] === 'function'\n      ) {\n        result[key] = chain(result[key], props[key]);\n\n        // Merge classnames, sometimes classNames are empty string which eval to false, so we just need to do a type check\n      } else if (\n        key === 'className' &&\n        typeof result.className === 'string' &&\n        props &&\n        typeof props.className === 'string'\n      ) {\n        result[key] = clsx(result.className, props.className);\n      } else if (\n        (key === 'styles' || key.endsWith('Styles')) &&\n        typeof result.styles === 'object' &&\n        props &&\n        typeof props.styles === 'object'\n      ) {\n        result[key] = mergeStyles(result[key], props[key]);\n      } else if (key === 'mods' && result.mods && props?.mods) {\n        result.mods = { ...result.mods, ...props?.mods };\n      } else if (key === 'id' && result.id && props?.id) {\n        result.id = mergeIds(result.id, props?.id);\n        // Override others\n      } else {\n        result[key] =\n          props && props[key] !== undefined ? props[key] : result[key];\n      }\n    }\n\n    // Add props from b that are not in a\n    for (let key in props) {\n      if (result[key] === undefined) {\n        result[key] = props[key];\n      }\n    }\n  }\n\n  return result as K;\n}\n"],"mappings":";;;;;;;;;;;;;;AAsBA,SAAgB,WACd,GAAG,MACA;CACH,IAAI,SAAc,EAAE;AAEpB,MAAK,IAAI,SAAS,MAAM;AACtB,OAAK,IAAI,OAAO,OAEd,KACE,WAAW,KAAK,IAAI,IACpB,OAAO,OAAO,SAAS,cACvB,SACA,OAAO,MAAM,SAAS,WAEtB,QAAO,OAAO,MAAM,OAAO,MAAM,MAAM,KAAK;WAI5C,QAAQ,eACR,OAAO,OAAO,cAAc,YAC5B,SACA,OAAO,MAAM,cAAc,SAE3B,QAAO,OAAO,KAAK,OAAO,WAAW,MAAM,UAAU;YAEpD,QAAQ,YAAY,IAAI,SAAS,SAAS,KAC3C,OAAO,OAAO,WAAW,YACzB,SACA,OAAO,MAAM,WAAW,SAExB,QAAO,OAAO,YAAY,OAAO,MAAM,MAAM,KAAK;WACzC,QAAQ,UAAU,OAAO,QAAQ,OAAO,KACjD,QAAO,OAAO;GAAE,GAAG,OAAO;GAAM,GAAG,OAAO;GAAM;WACvC,QAAQ,QAAQ,OAAO,MAAM,OAAO,GAC7C,QAAO,KAAK,SAAS,OAAO,IAAI,OAAO,GAAG;MAG1C,QAAO,OACL,SAAS,MAAM,SAAS,SAAY,MAAM,OAAO,OAAO;AAK9D,OAAK,IAAI,OAAO,MACd,KAAI,OAAO,SAAS,OAClB,QAAO,OAAO,MAAM;;AAK1B,QAAO"}

package/dist/utils/react/nullableValue.d.ts

@@ -0,0 +1,12 @@
+
+import { Props } from "../../tasty/types.js";
+import "../../tasty/index.js";
+
+//#region src/utils/react/nullableValue.d.ts
+type WithNullableValue<T extends Props> = Omit<T, 'value' | 'defaultValue'> & {
+  value?: T['value'] | any;
+  defaultValue?: T['defaultValue'] | any;
+};
+//#endregion
+export { WithNullableValue };
+//# sourceMappingURL=nullableValue.d.ts.map

package/dist/utils/react/nullableValue.js

@@ -0,0 +1,29 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+//#region src/utils/react/nullableValue.ts
+function castNullableStringValue(props) {
+	return castNullableField(props, ["value", "defaultValue"], "string", (v) => String(v));
+}
+function castNullableNumberValue(props) {
+	return castNullableField(props, ["value", "defaultValue"], "number", (v) => Number(v));
+}
+function castNullableArrayValue(props) {
+	return castNullableField(props, ["value", "defaultValue"], "object", (v) => Array.isArray(v) ? v : []);
+}
+function castNullableIsSelected(props) {
+	return castNullableField(props, ["isSelected", "defaultSelected"], "boolean", (v) => !!v);
+}
+function castNullableField(props, keys, type, cast) {
+	props = { ...props };
+	keys.forEach((key) => {
+		if (props[key] === null) props[key] = void 0;
+		if (type && cast && props[key] != null && typeof props[key] != type) {
+			props[key] = cast(props[key]);
+			console.warn("Wrong value type in", props, "in keys", JSON.stringify(keys));
+		}
+	});
+	return props;
+}
+
+//#endregion
+export { castNullableArrayValue, castNullableIsSelected, castNullableNumberValue, castNullableStringValue };
+//# sourceMappingURL=nullableValue.js.map

package/dist/utils/react/nullableValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nullableValue.js","names":[],"sources":["../../../src/utils/react/nullableValue.ts"],"sourcesContent":["import { Props } from '../../tasty';\n\nexport function castNullableStringValue<T>(props: T): T {\n  return castNullableField(props, ['value', 'defaultValue'], 'string', (v) =>\n    String(v),\n  );\n}\n\nexport function castNullableNumberValue<T>(props: T): T {\n  return castNullableField(props, ['value', 'defaultValue'], 'number', (v) =>\n    Number(v),\n  );\n}\n\nexport function castNullableArrayValue<T>(props: T): T {\n  return castNullableField(props, ['value', 'defaultValue'], 'object', (v) =>\n    Array.isArray(v) ? v : [],\n  );\n}\n\nexport function castNullableIsSelected<T>(props: T): T {\n  return castNullableField(\n    props,\n    ['isSelected', 'defaultSelected'],\n    'boolean',\n    (v) => !!v,\n  );\n}\n\nexport function castNullableSelectedKey<T>(props: T): T {\n  return castNullableField(props, ['selectedKey', 'defaultSelectedKey']);\n}\n\nexport function castNullableField<T>(\n  props: T,\n  keys: string[],\n  type?: string,\n  cast?: (k: any) => any,\n): T {\n  props = { ...props };\n\n  keys.forEach((key) => {\n    if (props[key] === null) {\n      props[key] = undefined;\n    }\n\n    if (type && cast && props[key] != null && typeof props[key] != type) {\n      props[key] = cast(props[key]);\n\n      console.warn(\n        'Wrong value type in',\n        props,\n        'in keys',\n        JSON.stringify(keys),\n      );\n    }\n  });\n\n  return props;\n}\n\nexport type WithNullableValue<T extends Props> = Omit<\n  T,\n  'value' | 'defaultValue'\n> & {\n  value?: T['value'] | any;\n  defaultValue?: T['defaultValue'] | any;\n};\n\nexport type WithNullableSelected<T extends Props> = Omit<\n  T,\n  'isSelected' | 'defaultSelected'\n> & {\n  isSelected?: T['isSelected'] | any;\n  defaultSelected?: T['defaultSelected'] | any;\n};\n\nexport type WithNullableSelectedKey<T extends Props> = Omit<\n  T,\n  'selectedKey' | 'defaultSelectedKey'\n> & {\n  selectedKey?: T['selectedKey'] | any;\n  defaultSelectedKey?: T['defaultSelectedKey'] | any;\n};\n"],"mappings":";;AAEA,SAAgB,wBAA2B,OAAa;AACtD,QAAO,kBAAkB,OAAO,CAAC,SAAS,eAAe,EAAE,WAAW,MACpE,OAAO,EAAE,CACV;;AAGH,SAAgB,wBAA2B,OAAa;AACtD,QAAO,kBAAkB,OAAO,CAAC,SAAS,eAAe,EAAE,WAAW,MACpE,OAAO,EAAE,CACV;;AAGH,SAAgB,uBAA0B,OAAa;AACrD,QAAO,kBAAkB,OAAO,CAAC,SAAS,eAAe,EAAE,WAAW,MACpE,MAAM,QAAQ,EAAE,GAAG,IAAI,EAAE,CAC1B;;AAGH,SAAgB,uBAA0B,OAAa;AACrD,QAAO,kBACL,OACA,CAAC,cAAc,kBAAkB,EACjC,YACC,MAAM,CAAC,CAAC,EACV;;AAOH,SAAgB,kBACd,OACA,MACA,MACA,MACG;AACH,SAAQ,EAAE,GAAG,OAAO;AAEpB,MAAK,SAAS,QAAQ;AACpB,MAAI,MAAM,SAAS,KACjB,OAAM,OAAO;AAGf,MAAI,QAAQ,QAAQ,MAAM,QAAQ,QAAQ,OAAO,MAAM,QAAQ,MAAM;AACnE,SAAM,OAAO,KAAK,MAAM,KAAK;AAE7B,WAAQ,KACN,uBACA,OACA,WACA,KAAK,UAAU,KAAK,CACrB;;GAEH;AAEF,QAAO"}

package/dist/utils/react/resolveIcon.d.ts

@@ -0,0 +1,30 @@
+
+import { Mods } from "../../tasty/types.js";
+import "../../tasty/index.js";
+import { ReactNode } from "react";
+
+//#region src/utils/react/resolveIcon.d.ts
+/**
+ * Function that receives mods (can be destructured) and returns an icon or true for empty slot.
+ * @example
+ * icon={({ loading, selected }) => loading ? <SpinnerIcon /> : <Icon />}
+ */
+type IconRenderFn<T extends Mods = Mods> = (mods: T) => ReactNode | true;
+/** Dynamic icon prop: ReactNode, true for empty slot, or render function */
+type DynamicIcon<T extends Mods = Mods> = ReactNode | true | IconRenderFn<T>;
+interface ResolvedIcon {
+  /** The icon content to render (null for empty slot) */
+  content: ReactNode | null;
+  /** Whether the slot should be rendered (true even for empty slots) */
+  hasSlot: boolean;
+}
+/**
+ * Resolves a dynamic icon prop to its content and slot state.
+ * - If `true`: empty slot (hasSlot=true, content=null)
+ * - If function: call with mods, then process result
+ * - Otherwise: use as-is
+ */
+declare function resolveIcon<T extends Mods>(icon: DynamicIcon<T> | undefined, mods: T): ResolvedIcon;
+//#endregion
+export { DynamicIcon, IconRenderFn, ResolvedIcon, resolveIcon };
+//# sourceMappingURL=resolveIcon.d.ts.map

package/dist/utils/react/resolveIcon.js

@@ -0,0 +1,41 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+//#region src/utils/react/resolveIcon.ts
+/**
+* Resolves a dynamic icon prop to its content and slot state.
+* - If `true`: empty slot (hasSlot=true, content=null)
+* - If function: call with mods, then process result
+* - Otherwise: use as-is
+*/
+function resolveIcon(icon, mods) {
+	if (icon === void 0 || icon === null || icon === false) return {
+		content: null,
+		hasSlot: false
+	};
+	if (icon === true) return {
+		content: null,
+		hasSlot: true
+	};
+	if (typeof icon === "function") {
+		const result = icon(mods);
+		if (result === true) return {
+			content: null,
+			hasSlot: true
+		};
+		if (result === void 0 || result === null || result === false) return {
+			content: null,
+			hasSlot: false
+		};
+		return {
+			content: result,
+			hasSlot: true
+		};
+	}
+	return {
+		content: icon,
+		hasSlot: true
+	};
+}
+
+//#endregion
+export { resolveIcon };
+//# sourceMappingURL=resolveIcon.js.map