@cube-dev/ui-kit 0.182.0 → 0.184.0

package/dist/utils/react/useLocalStorage.js

@@ -1,6 +1,7 @@
-/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.184.0 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
-import { useCallback, useSyncExternalStore } from "react";
+import { c } from "react-compiler-runtime";
+import { useSyncExternalStore } from "react";
 
 //#region src/utils/react/useLocalStorage.ts
 /** Global registry of listeners per key for same-tab cross-instance sync */
@@ -63,37 +64,81 @@ function getInitialValue(initialValue) {
 * ```
 */
 function useLocalStorage(key, initialValue) {
-	const resolvedInitial = getInitialValue(initialValue);
-	return [useSyncExternalStore(useCallback((onStoreChange) => {
-		if (!key) return () => {};
-		if (!listeners.has(key)) listeners.set(key, /* @__PURE__ */ new Set());
-		listeners.get(key).add(onStoreChange);
-		const handleStorageEvent = (event) => {
-			if (event.key === key) onStoreChange();
+	const $ = c(15);
+	let t0;
+	if ($[0] !== initialValue) {
+		t0 = getInitialValue(initialValue);
+		$[0] = initialValue;
+		$[1] = t0;
+	} else t0 = $[1];
+	const resolvedInitial = t0;
+	let t1;
+	if ($[2] !== key) {
+		t1 = (onStoreChange) => {
+			if (!key) return _temp;
+			if (!listeners.has(key)) listeners.set(key, /* @__PURE__ */ new Set());
+			listeners.get(key).add(onStoreChange);
+			const handleStorageEvent = (event) => {
+				if (event.key === key) onStoreChange();
+			};
+			window.addEventListener("storage", handleStorageEvent);
+			return () => {
+				listeners.get(key)?.delete(onStoreChange);
+				if (listeners.get(key)?.size === 0) listeners.delete(key);
+				window.removeEventListener("storage", handleStorageEvent);
+			};
 		};
-		window.addEventListener("storage", handleStorageEvent);
-		return () => {
-			listeners.get(key)?.delete(onStoreChange);
-			if (listeners.get(key)?.size === 0) listeners.delete(key);
-			window.removeEventListener("storage", handleStorageEvent);
+		$[2] = key;
+		$[3] = t1;
+	} else t1 = $[3];
+	const subscribe = t1;
+	let t2;
+	if ($[4] !== key || $[5] !== resolvedInitial) {
+		t2 = () => {
+			if (!key || !isLocalStorageAvailable()) return resolvedInitial;
+			return parseJSON(localStorage.getItem(key), resolvedInitial);
 		};
-	}, [key]), useCallback(() => {
-		if (!key || !isLocalStorageAvailable()) return resolvedInitial;
-		return parseJSON(localStorage.getItem(key), resolvedInitial);
-	}, [key, resolvedInitial]), useCallback(() => {
-		return resolvedInitial;
-	}, [resolvedInitial])), useEvent((update) => {
-		if (!key || !isLocalStorageAvailable()) return;
-		const currentValue = parseJSON(localStorage.getItem(key), resolvedInitial);
-		const newValue = typeof update === "function" ? update(currentValue) : update;
-		try {
-			localStorage.setItem(key, JSON.stringify(newValue));
-			notifyListeners(key);
-		} catch (error) {
-			console.error(`[useLocalStorage] Failed to save "${key}":`, error);
-		}
-	})];
+		$[4] = key;
+		$[5] = resolvedInitial;
+		$[6] = t2;
+	} else t2 = $[6];
+	const getSnapshot = t2;
+	let t3;
+	if ($[7] !== resolvedInitial) {
+		t3 = () => resolvedInitial;
+		$[7] = resolvedInitial;
+		$[8] = t3;
+	} else t3 = $[8];
+	const storedValue = useSyncExternalStore(subscribe, getSnapshot, t3);
+	let t4;
+	if ($[9] !== key || $[10] !== resolvedInitial) {
+		t4 = (update) => {
+			if (!key || !isLocalStorageAvailable()) return;
+			const currentValue = parseJSON(localStorage.getItem(key), resolvedInitial);
+			const newValue = typeof update === "function" ? update(currentValue) : update;
+			try {
+				localStorage.setItem(key, JSON.stringify(newValue));
+				notifyListeners(key);
+			} catch (t5) {
+				const error = t5;
+				console.error(`[useLocalStorage] Failed to save "${key}":`, error);
+			}
+		};
+		$[9] = key;
+		$[10] = resolvedInitial;
+		$[11] = t4;
+	} else t4 = $[11];
+	const setValue = useEvent(t4);
+	let t5;
+	if ($[12] !== setValue || $[13] !== storedValue) {
+		t5 = [storedValue, setValue];
+		$[12] = setValue;
+		$[13] = storedValue;
+		$[14] = t5;
+	} else t5 = $[14];
+	return t5;
 }
+function _temp() {}
 
 //#endregion
 export { useLocalStorage };

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

@@ -1 +1 @@
-{"version":3,"file":"useLocalStorage.js","names":[],"sources":["../../../src/utils/react/useLocalStorage.ts"],"sourcesContent":["import { useCallback, useSyncExternalStore } from 'react';\n\nimport { useEvent } from '../../_internal/hooks/use-event';\n\n/** Like React.setState: either a value or a function of the previous value */\ntype Updater<T> = T | ((prev: T) => T);\n\n/** Global registry of listeners per key for same-tab cross-instance sync */\nconst listeners = new Map<string, Set<() => void>>();\n\n/** Notify all listeners for a given key */\nfunction notifyListeners(key: string): void {\n  listeners.get(key)?.forEach((listener) => listener());\n}\n\n/** Check if localStorage is available */\nfunction isLocalStorageAvailable(): boolean {\n  try {\n    const testKey = '__localStorage_test__';\n    window.localStorage.setItem(testKey, testKey);\n    window.localStorage.removeItem(testKey);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** Safely parse JSON with fallback */\nfunction parseJSON<T>(value: string | null, fallback: T): T {\n  if (value === null) {\n    return fallback;\n  }\n\n  try {\n    return JSON.parse(value) as T;\n  } catch {\n    return fallback;\n  }\n}\n\n/** Get initial value, supporting lazy initializer */\nfunction getInitialValue<T>(initialValue: T | (() => T)): T {\n  return typeof initialValue === 'function'\n    ? (initialValue as () => T)()\n    : initialValue;\n}\n\n/**\n * A hook to persist state in localStorage with cross-instance synchronization.\n *\n * Features:\n * - JSON serialization/deserialization\n * - Syncs between hook instances with the same key (same tab)\n * - Syncs across browser tabs via storage event\n * - SSR-safe (gracefully handles missing localStorage)\n * - Supports lazy initial value\n *\n * @param key - The localStorage key. Pass `null` or `undefined` to disable the hook.\n * @param initialValue - Initial value or lazy initializer function\n * @returns Tuple of [value, setValue] similar to useState\n *\n * @example\n * ```tsx\n * // Basic usage\n * const [theme, setTheme] = useLocalStorage('theme', 'light');\n *\n * // With lazy initializer\n * const [settings, setSettings] = useLocalStorage('settings', () => getDefaultSettings());\n *\n * // Disabled (returns initialValue, setValue is no-op)\n * const [value, setValue] = useLocalStorage(null, 'default');\n *\n * // Conditionally enabled\n * const [data, setData] = useLocalStorage(isEnabled ? 'my-key' : null, {});\n * ```\n */\nexport function useLocalStorage<T>(\n  key: string | null | undefined,\n  initialValue: T | (() => T),\n): readonly [T, (value: Updater<T>) => void] {\n  const resolvedInitial = getInitialValue(initialValue);\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => {\n      if (!key) {\n        return () => {};\n      }\n\n      // Add to same-tab listeners\n      if (!listeners.has(key)) {\n        listeners.set(key, new Set());\n      }\n      listeners.get(key)!.add(onStoreChange);\n\n      // Listen for cross-tab changes\n      const handleStorageEvent = (event: StorageEvent) => {\n        if (event.key === key) {\n          onStoreChange();\n        }\n      };\n      window.addEventListener('storage', handleStorageEvent);\n\n      return () => {\n        listeners.get(key)?.delete(onStoreChange);\n        if (listeners.get(key)?.size === 0) {\n          listeners.delete(key);\n        }\n        window.removeEventListener('storage', handleStorageEvent);\n      };\n    },\n    [key],\n  );\n\n  const getSnapshot = useCallback((): T => {\n    if (!key || !isLocalStorageAvailable()) {\n      return resolvedInitial;\n    }\n\n    return parseJSON(localStorage.getItem(key), resolvedInitial);\n  }, [key, resolvedInitial]);\n\n  const getServerSnapshot = useCallback((): T => {\n    return resolvedInitial;\n  }, [resolvedInitial]);\n\n  const storedValue = useSyncExternalStore(\n    subscribe,\n    getSnapshot,\n    getServerSnapshot,\n  );\n\n  const setValue = useEvent((update: Updater<T>) => {\n    if (!key || !isLocalStorageAvailable()) {\n      return;\n    }\n\n    const currentValue = parseJSON<T>(\n      localStorage.getItem(key),\n      resolvedInitial,\n    );\n    const newValue =\n      typeof update === 'function'\n        ? (update as (prev: T) => T)(currentValue)\n        : update;\n\n    try {\n      localStorage.setItem(key, JSON.stringify(newValue));\n      notifyListeners(key);\n    } catch (error) {\n      console.error(`[useLocalStorage] Failed to save \"${key}\":`, error);\n    }\n  });\n\n  return [storedValue, setValue] as const;\n}\n"],"mappings":";;;;;;AAQA,MAAM,4BAAY,IAAI,KAA8B;;AAGpD,SAAS,gBAAgB,KAAmB;AAC1C,WAAU,IAAI,IAAI,EAAE,SAAS,aAAa,UAAU,CAAC;;;AAIvD,SAAS,0BAAmC;AAC1C,KAAI;EACF,MAAM,UAAU;AAChB,SAAO,aAAa,QAAQ,SAAS,QAAQ;AAC7C,SAAO,aAAa,WAAW,QAAQ;AACvC,SAAO;SACD;AACN,SAAO;;;;AAKX,SAAS,UAAa,OAAsB,UAAgB;AAC1D,KAAI,UAAU,KACZ,QAAO;AAGT,KAAI;AACF,SAAO,KAAK,MAAM,MAAM;SAClB;AACN,SAAO;;;;AAKX,SAAS,gBAAmB,cAAgC;AAC1D,QAAO,OAAO,iBAAiB,aAC1B,cAA0B,GAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCN,SAAgB,gBACd,KACA,cAC2C;CAC3C,MAAM,kBAAkB,gBAAgB,aAAa;AAyErD,QAAO,CA5Ba,qBA3CF,aACf,kBAA8B;AAC7B,MAAI,CAAC,IACH,cAAa;AAIf,MAAI,CAAC,UAAU,IAAI,IAAI,CACrB,WAAU,IAAI,qBAAK,IAAI,KAAK,CAAC;AAE/B,YAAU,IAAI,IAAI,CAAE,IAAI,cAAc;EAGtC,MAAM,sBAAsB,UAAwB;AAClD,OAAI,MAAM,QAAQ,IAChB,gBAAe;;AAGnB,SAAO,iBAAiB,WAAW,mBAAmB;AAEtD,eAAa;AACX,aAAU,IAAI,IAAI,EAAE,OAAO,cAAc;AACzC,OAAI,UAAU,IAAI,IAAI,EAAE,SAAS,EAC/B,WAAU,OAAO,IAAI;AAEvB,UAAO,oBAAoB,WAAW,mBAAmB;;IAG7D,CAAC,IAAI,CACN,EAEmB,kBAAqB;AACvC,MAAI,CAAC,OAAO,CAAC,yBAAyB,CACpC,QAAO;AAGT,SAAO,UAAU,aAAa,QAAQ,IAAI,EAAE,gBAAgB;IAC3D,CAAC,KAAK,gBAAgB,CAAC,EAEA,kBAAqB;AAC7C,SAAO;IACN,CAAC,gBAAgB,CAAC,CAMpB,EAEgB,UAAU,WAAuB;AAChD,MAAI,CAAC,OAAO,CAAC,yBAAyB,CACpC;EAGF,MAAM,eAAe,UACnB,aAAa,QAAQ,IAAI,EACzB,gBACD;EACD,MAAM,WACJ,OAAO,WAAW,aACb,OAA0B,aAAa,GACxC;AAEN,MAAI;AACF,gBAAa,QAAQ,KAAK,KAAK,UAAU,SAAS,CAAC;AACnD,mBAAgB,IAAI;WACb,OAAO;AACd,WAAQ,MAAM,qCAAqC,IAAI,KAAK,MAAM;;GAEpE,CAE4B"}
+{"version":3,"file":"useLocalStorage.js","names":["useCallback","useSyncExternalStore","useEvent","Updater","T","prev","listeners","Map","Set","notifyListeners","key","get","forEach","listener","isLocalStorageAvailable","testKey","window","localStorage","setItem","removeItem","parseJSON","value","fallback","JSON","parse","getInitialValue","initialValue","useLocalStorage","$","_c","t0","resolvedInitial","t1","onStoreChange","_temp","has","set","add","handleStorageEvent","event","addEventListener","delete","size","removeEventListener","subscribe","t2","getItem","getSnapshot","t3","getServerSnapshot","storedValue","t4","update","currentValue","newValue","stringify","t5","error","console","setValue","const"],"sources":["../../../src/utils/react/useLocalStorage.ts"],"sourcesContent":["import { useCallback, useSyncExternalStore } from 'react';\n\nimport { useEvent } from '../../_internal/hooks/use-event';\n\n/** Like React.setState: either a value or a function of the previous value */\ntype Updater<T> = T | ((prev: T) => T);\n\n/** Global registry of listeners per key for same-tab cross-instance sync */\nconst listeners = new Map<string, Set<() => void>>();\n\n/** Notify all listeners for a given key */\nfunction notifyListeners(key: string): void {\n  listeners.get(key)?.forEach((listener) => listener());\n}\n\n/** Check if localStorage is available */\nfunction isLocalStorageAvailable(): boolean {\n  try {\n    const testKey = '__localStorage_test__';\n    window.localStorage.setItem(testKey, testKey);\n    window.localStorage.removeItem(testKey);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** Safely parse JSON with fallback */\nfunction parseJSON<T>(value: string | null, fallback: T): T {\n  if (value === null) {\n    return fallback;\n  }\n\n  try {\n    return JSON.parse(value) as T;\n  } catch {\n    return fallback;\n  }\n}\n\n/** Get initial value, supporting lazy initializer */\nfunction getInitialValue<T>(initialValue: T | (() => T)): T {\n  return typeof initialValue === 'function'\n    ? (initialValue as () => T)()\n    : initialValue;\n}\n\n/**\n * A hook to persist state in localStorage with cross-instance synchronization.\n *\n * Features:\n * - JSON serialization/deserialization\n * - Syncs between hook instances with the same key (same tab)\n * - Syncs across browser tabs via storage event\n * - SSR-safe (gracefully handles missing localStorage)\n * - Supports lazy initial value\n *\n * @param key - The localStorage key. Pass `null` or `undefined` to disable the hook.\n * @param initialValue - Initial value or lazy initializer function\n * @returns Tuple of [value, setValue] similar to useState\n *\n * @example\n * ```tsx\n * // Basic usage\n * const [theme, setTheme] = useLocalStorage('theme', 'light');\n *\n * // With lazy initializer\n * const [settings, setSettings] = useLocalStorage('settings', () => getDefaultSettings());\n *\n * // Disabled (returns initialValue, setValue is no-op)\n * const [value, setValue] = useLocalStorage(null, 'default');\n *\n * // Conditionally enabled\n * const [data, setData] = useLocalStorage(isEnabled ? 'my-key' : null, {});\n * ```\n */\nexport function useLocalStorage<T>(\n  key: string | null | undefined,\n  initialValue: T | (() => T),\n): readonly [T, (value: Updater<T>) => void] {\n  const resolvedInitial = getInitialValue(initialValue);\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => {\n      if (!key) {\n        return () => {};\n      }\n\n      // Add to same-tab listeners\n      if (!listeners.has(key)) {\n        listeners.set(key, new Set());\n      }\n      listeners.get(key)!.add(onStoreChange);\n\n      // Listen for cross-tab changes\n      const handleStorageEvent = (event: StorageEvent) => {\n        if (event.key === key) {\n          onStoreChange();\n        }\n      };\n      window.addEventListener('storage', handleStorageEvent);\n\n      return () => {\n        listeners.get(key)?.delete(onStoreChange);\n        if (listeners.get(key)?.size === 0) {\n          listeners.delete(key);\n        }\n        window.removeEventListener('storage', handleStorageEvent);\n      };\n    },\n    [key],\n  );\n\n  const getSnapshot = useCallback((): T => {\n    if (!key || !isLocalStorageAvailable()) {\n      return resolvedInitial;\n    }\n\n    return parseJSON(localStorage.getItem(key), resolvedInitial);\n  }, [key, resolvedInitial]);\n\n  const getServerSnapshot = useCallback((): T => {\n    return resolvedInitial;\n  }, [resolvedInitial]);\n\n  const storedValue = useSyncExternalStore(\n    subscribe,\n    getSnapshot,\n    getServerSnapshot,\n  );\n\n  const setValue = useEvent((update: Updater<T>) => {\n    if (!key || !isLocalStorageAvailable()) {\n      return;\n    }\n\n    const currentValue = parseJSON<T>(\n      localStorage.getItem(key),\n      resolvedInitial,\n    );\n    const newValue =\n      typeof update === 'function'\n        ? (update as (prev: T) => T)(currentValue)\n        : update;\n\n    try {\n      localStorage.setItem(key, JSON.stringify(newValue));\n      notifyListeners(key);\n    } catch (error) {\n      console.error(`[useLocalStorage] Failed to save \"${key}\":`, error);\n    }\n  });\n\n  return [storedValue, setValue] as const;\n}\n"],"mappings":";;;;;;;AAQA,MAAMM,4BAAY,IAAIC,KAA8B;;AAGpD,SAASE,gBAAgBC,KAAmB;AAC1CJ,WAAUK,IAAID,IAAI,EAAEE,SAASC,aAAaA,UAAU,CAAC;;;AAIvD,SAASC,0BAAmC;AAC1C,KAAI;EACF,MAAMC,UAAU;AAChBC,SAAOC,aAAaC,QAAQH,SAASA,QAAQ;AAC7CC,SAAOC,aAAaE,WAAWJ,QAAQ;AACvC,SAAO;SACD;AACN,SAAO;;;;AAKX,SAASK,UAAaC,OAAsBC,UAAgB;AAC1D,KAAID,UAAU,KACZ,QAAOC;AAGT,KAAI;AACF,SAAOC,KAAKC,MAAMH,MAAM;SAClB;AACN,SAAOC;;;;AAKX,SAASG,gBAAmBC,cAAgC;AAC1D,QAAO,OAAOA,iBAAiB,aAC1BA,cAA0B,GAC3BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCN,SAAOC,gBAAAjB,KAAAgB,cAAA;CAAA,MAAAE,IAAAC,EAAA,GAAA;CAAA,IAAAC;AAAA,KAAAF,EAAA,OAAAF,cAAA;AAImBI,OAAAL,gBAAgBC,aAAa;AAAAE,IAAA,KAAAF;AAAAE,IAAA,KAAAE;OAAAA,MAAAF,EAAA;CAArD,MAAAG,kBAAwBD;CAA8B,IAAAE;AAAA,KAAAJ,EAAA,OAAAlB,KAAA;AAGpDsB,QAAAC,kBAAA;AACE,OAAI,CAACvB,IAAG,QACCwB;AAIT,OAAI,CAAC5B,UAAS6B,IAAKzB,IAAI,CACrBJ,WAAS8B,IAAK1B,qBAAK,IAAIF,KAAK,CAAC;AAE/BF,aAASK,IAAKD,IAAI,CAAA2B,IAAMJ,cAAc;GAGtC,MAAAK,sBAA2BC,UAAA;AACzB,QAAIA,MAAK7B,QAASA,IAChBuB,gBAAe;;AAGnBjB,UAAMwB,iBAAkB,WAAWF,mBAAmB;AAAA,gBAE/C;AACLhC,cAASK,IAAKD,IAAY,EAAA+B,OAACR,cAAc;AACzC,QAAI3B,UAASK,IAAKD,IAAU,EAAAgC,SAAK,EAC/BpC,WAASmC,OAAQ/B,IAAI;AAEvBM,WAAM2B,oBAAqB,WAAWL,mBAAmB;;;AAE5DV,IAAA,KAAAlB;AAAAkB,IAAA,KAAAI;OAAAA,MAAAJ,EAAA;CA3BH,MAAAgB,YAAkBZ;CA6BhB,IAAAa;AAAA,KAAAjB,EAAA,OAAAlB,OAAAkB,EAAA,OAAAG,iBAAA;AAE8Bc,aAAA;AAC9B,OAAI,CAACnC,OAAD,CAASI,yBAAyB,CAAA,QAC7BiB;AACR,UAEMX,UAAUH,aAAY6B,QAASpC,IAAI,EAAEqB,gBAAgB;;AAC7DH,IAAA,KAAAlB;AAAAkB,IAAA,KAAAG;AAAAH,IAAA,KAAAiB;OAAAA,MAAAjB,EAAA;CAND,MAAAmB,cAAoBF;CAMO,IAAAG;AAAA,KAAApB,EAAA,OAAAG,iBAAA;AAEWiB,aAC7BjB;AACRH,IAAA,KAAAG;AAAAH,IAAA,KAAAoB;OAAAA,MAAApB,EAAA;CAED,MAAAsB,cAAoBjD,qBAClB2C,WACAG,aANwBC,GAQzB;CAAC,IAAAG;AAAA,KAAAvB,EAAA,OAAAlB,OAAAkB,EAAA,QAAAG,iBAAA;AAEwBoB,QAAAC,WAAA;AACxB,OAAI,CAAC1C,OAAD,CAASI,yBAAyB,CAAA;GAItC,MAAAuC,eAAqBjC,UACnBH,aAAY6B,QAASpC,IAAI,EACzBqB,gBACD;GACD,MAAAuB,WACE,OAAOF,WAAW,aACbA,OAA0BC,aACrB,GAFVD;AAIF,OAAA;AACEnC,iBAAYC,QAASR,KAAKa,KAAIgC,UAAWD,SAAS,CAAC;AACnD7C,oBAAgBC,IAAI;YAAA8C,IAAA;IACbC,MAAAA,QAAAA;AACPC,YAAOD,MAAO,qCAAqC/C,IAAG,KAAM+C,MAAM;;;AAErE7B,IAAA,KAAAlB;AAAAkB,IAAA,MAAAG;AAAAH,IAAA,MAAAuB;OAAAA,MAAAvB,EAAA;CApBD,MAAA+B,WAAiBzD,SAASiD,GAoBxB;CAAC,IAAAK;AAAA,KAAA5B,EAAA,QAAA+B,YAAA/B,EAAA,QAAAsB,aAAA;AAEIM,OAAA,CAACN,aAAaS,SAAS;AAAA/B,IAAA,MAAA+B;AAAA/B,IAAA,MAAAsB;AAAAtB,IAAA,MAAA4B;OAAAA,MAAA5B,EAAA;AAAA,QAAvB4B;;AA7EF,SAAAtB,QAAA"}

package/dist/utils/react/useMergeStyles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.184.0 | Cube Dev Team */
 import { mergeStyles } from "@tenphi/tasty";
 import { useMemo } from "react";
 

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

@@ -1 +1 @@
-{"version":3,"file":"useMergeStyles.js","names":[],"sources":["../../../src/utils/react/useMergeStyles.ts"],"sourcesContent":["import { mergeStyles, Styles } from '@tenphi/tasty';\nimport { useMemo } from 'react';\n\n/**\n * Hook to merge base styles with sub-element style props.\n *\n * This simplifies the common pattern of accepting props like `tabListStyles`,\n * `prefixStyles`, etc. that should merge into `styles.TabList`, `styles.Prefix`, etc.\n *\n * @param styles - Base styles object\n * @param subStylesMap - Mapping of sub-element names to their additional styles\n * @returns Merged styles object\n *\n * @example\n * ```tsx\n * const { styles, tabListStyles, prefixStyles, suffixStyles, ...rest } = props;\n *\n * const mergedStyles = useMergeStyles(styles, {\n *   TabList: tabListStyles,\n *   Prefix: prefixStyles,\n *   Suffix: suffixStyles,\n * });\n *\n * return <TabsElement styles={mergedStyles} {...rest} />;\n * ```\n */\nexport function useMergeStyles(\n  styles: Styles | undefined,\n  subStylesMap: Record<string, Styles | undefined>,\n): Styles {\n  // Extract values for dependency array - must be stable\n  const subStylesValues = Object.values(subStylesMap);\n\n  return useMemo(() => {\n    // Build sub-element styles object from the map\n    const subStyles: Styles = {};\n\n    for (const [element, elementStyles] of Object.entries(subStylesMap)) {\n      if (elementStyles != null) {\n        subStyles[element] = elementStyles;\n      }\n    }\n\n    // Merge base styles with sub-element styles\n    return mergeStyles(styles, subStyles);\n  }, [styles, ...subStylesValues]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,eACd,QACA,cACQ;AAIR,QAAO,cAAc;EAEnB,MAAM,YAAoB,EAAE;AAE5B,OAAK,MAAM,CAAC,SAAS,kBAAkB,OAAO,QAAQ,aAAa,CACjE,KAAI,iBAAiB,KACnB,WAAU,WAAW;AAKzB,SAAO,YAAY,QAAQ,UAAU;IACpC,CAAC,QAAQ,GAdY,OAAO,OAAO,aAAa,CAcpB,CAAC"}
+{"version":3,"file":"useMergeStyles.js","names":["mergeStyles","Styles","useMemo","useMergeStyles","styles","subStylesMap","Record","subStylesValues","Object","values","subStyles","element","elementStyles","entries"],"sources":["../../../src/utils/react/useMergeStyles.ts"],"sourcesContent":["import { mergeStyles, Styles } from '@tenphi/tasty';\nimport { useMemo } from 'react';\n\n/**\n * Hook to merge base styles with sub-element style props.\n *\n * This simplifies the common pattern of accepting props like `tabListStyles`,\n * `prefixStyles`, etc. that should merge into `styles.TabList`, `styles.Prefix`, etc.\n *\n * @param styles - Base styles object\n * @param subStylesMap - Mapping of sub-element names to their additional styles\n * @returns Merged styles object\n *\n * @example\n * ```tsx\n * const { styles, tabListStyles, prefixStyles, suffixStyles, ...rest } = props;\n *\n * const mergedStyles = useMergeStyles(styles, {\n *   TabList: tabListStyles,\n *   Prefix: prefixStyles,\n *   Suffix: suffixStyles,\n * });\n *\n * return <TabsElement styles={mergedStyles} {...rest} />;\n * ```\n */\nexport function useMergeStyles(\n  styles: Styles | undefined,\n  subStylesMap: Record<string, Styles | undefined>,\n): Styles {\n  // Extract values for dependency array - must be stable\n  const subStylesValues = Object.values(subStylesMap);\n\n  return useMemo(() => {\n    // Build sub-element styles object from the map\n    const subStyles: Styles = {};\n\n    for (const [element, elementStyles] of Object.entries(subStylesMap)) {\n      if (elementStyles != null) {\n        subStyles[element] = elementStyles;\n      }\n    }\n\n    // Merge base styles with sub-element styles\n    return mergeStyles(styles, subStyles);\n  }, [styles, ...subStylesValues]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgBG,eACdC,QACAC,cACQ;AAIR,QAAOH,cAAc;EAEnB,MAAMQ,YAAoB,EAAE;AAE5B,OAAK,MAAM,CAACC,SAASC,kBAAkBJ,OAAOK,QAAQR,aAAa,CACjE,KAAIO,iBAAiB,KACnBF,WAAUC,WAAWC;AAKzB,SAAOZ,YAAYI,QAAQM,UAAU;IACpC,CAACN,QAAQ,GAdYI,OAAOC,OAAOJ,aAAa,CAcpB,CAAC"}

package/dist/utils/react/useOverlayEscapeGuard.js

@@ -1,5 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.184.0 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
+import { c } from "react-compiler-runtime";
 
 //#region src/utils/react/useOverlayEscapeGuard.ts
 /**
@@ -26,14 +27,29 @@ import { useEvent } from "../../_internal/hooks/use-event.js";
 * closure, so the frozen copy still sees the current `isOpen`.
 */
 function useOverlayEscapeGuard(overlayProps, isOpen) {
-	const onKeyDown = useEvent((event) => {
-		if (event.key === "Escape" && !isOpen) return;
-		overlayProps.onKeyDown?.(event);
-	});
-	return {
-		...overlayProps,
-		onKeyDown
-	};
+	const $ = c(6);
+	let t0;
+	if ($[0] !== isOpen || $[1] !== overlayProps) {
+		t0 = (event) => {
+			if (event.key === "Escape" && !isOpen) return;
+			overlayProps.onKeyDown?.(event);
+		};
+		$[0] = isOpen;
+		$[1] = overlayProps;
+		$[2] = t0;
+	} else t0 = $[2];
+	const onKeyDown = useEvent(t0);
+	let t1;
+	if ($[3] !== onKeyDown || $[4] !== overlayProps) {
+		t1 = {
+			...overlayProps,
+			onKeyDown
+		};
+		$[3] = onKeyDown;
+		$[4] = overlayProps;
+		$[5] = t1;
+	} else t1 = $[5];
+	return t1;
 }
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"useOverlayEscapeGuard.js","names":[],"sources":["../../../src/utils/react/useOverlayEscapeGuard.ts"],"sourcesContent":["import { useEvent } from '../../_internal';\n\nimport type { DOMAttributes, KeyboardEvent } from 'react';\n\ntype OverlayDOMProps = DOMAttributes<any>;\n\n/**\n * Stops a CLOSED overlay from answering for `Escape` (CUB-4839).\n *\n * `useOverlay`'s `Escape` handler calls `stopPropagation()` and\n * `preventDefault()` for every `Escape` it sees, and only THEN asks whether\n * this overlay is the topmost one allowed to act on it — unlike\n * `onInteractOutside`, which it gates on `isOpen` up front. An overlay that has\n * already closed therefore consumes the key and does nothing with it, so the\n * `Escape` meant for the Dialog around it closes nothing at all.\n *\n * That is reachable here because our overlays stay mounted for their exit\n * transition while still holding DOM focus: pick an option from a list inside a\n * Dialog and the very next `Escape` lands in the closing list.\n *\n * Passing `useOverlay` an `isKeyboardDismissDisabled` of its own does NOT work,\n * and that is the reason this exists. `DisplayTransition` preserves content\n * across an exit by replaying the children it stored while the overlay was\n * open, so every value that subtree captured — `isKeyboardDismissDisabled`\n * included — stays frozen at its open-state reading for exactly the window\n * this has to guard. `useEvent` gets around it by returning a handler whose\n * identity never changes while its body always runs the latest render's\n * closure, so the frozen copy still sees the current `isOpen`.\n */\nexport function useOverlayEscapeGuard<T extends OverlayDOMProps>(\n  overlayProps: T,\n  isOpen: boolean | undefined,\n): T {\n  const onKeyDown = useEvent((event: KeyboardEvent<any>) => {\n    // Decline it, so it reaches whoever can actually act on it.\n    if (event.key === 'Escape' && !isOpen) return;\n\n    overlayProps.onKeyDown?.(event);\n  });\n\n  return { ...overlayProps, onKeyDown };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAgB,sBACd,cACA,QACG;CACH,MAAM,YAAY,UAAU,UAA8B;AAExD,MAAI,MAAM,QAAQ,YAAY,CAAC,OAAQ;AAEvC,eAAa,YAAY,MAAM;GAC/B;AAEF,QAAO;EAAE,GAAG;EAAc;EAAW"}
+{"version":3,"file":"useOverlayEscapeGuard.js","names":["useEvent","DOMAttributes","KeyboardEvent","OverlayDOMProps","useOverlayEscapeGuard","overlayProps","isOpen","$","_c","t0","event","key","onKeyDown","t1"],"sources":["../../../src/utils/react/useOverlayEscapeGuard.ts"],"sourcesContent":["import { useEvent } from '../../_internal';\n\nimport type { DOMAttributes, KeyboardEvent } from 'react';\n\ntype OverlayDOMProps = DOMAttributes<any>;\n\n/**\n * Stops a CLOSED overlay from answering for `Escape` (CUB-4839).\n *\n * `useOverlay`'s `Escape` handler calls `stopPropagation()` and\n * `preventDefault()` for every `Escape` it sees, and only THEN asks whether\n * this overlay is the topmost one allowed to act on it — unlike\n * `onInteractOutside`, which it gates on `isOpen` up front. An overlay that has\n * already closed therefore consumes the key and does nothing with it, so the\n * `Escape` meant for the Dialog around it closes nothing at all.\n *\n * That is reachable here because our overlays stay mounted for their exit\n * transition while still holding DOM focus: pick an option from a list inside a\n * Dialog and the very next `Escape` lands in the closing list.\n *\n * Passing `useOverlay` an `isKeyboardDismissDisabled` of its own does NOT work,\n * and that is the reason this exists. `DisplayTransition` preserves content\n * across an exit by replaying the children it stored while the overlay was\n * open, so every value that subtree captured — `isKeyboardDismissDisabled`\n * included — stays frozen at its open-state reading for exactly the window\n * this has to guard. `useEvent` gets around it by returning a handler whose\n * identity never changes while its body always runs the latest render's\n * closure, so the frozen copy still sees the current `isOpen`.\n */\nexport function useOverlayEscapeGuard<T extends OverlayDOMProps>(\n  overlayProps: T,\n  isOpen: boolean | undefined,\n): T {\n  const onKeyDown = useEvent((event: KeyboardEvent<any>) => {\n    // Decline it, so it reaches whoever can actually act on it.\n    if (event.key === 'Escape' && !isOpen) return;\n\n    overlayProps.onKeyDown?.(event);\n  });\n\n  return { ...overlayProps, onKeyDown };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAOI,sBAAAC,cAAAC,QAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAAA,IAAAC;AAAA,KAAAF,EAAA,OAAAD,UAAAC,EAAA,OAAAF,cAAA;AAIsBI,QAAAC,UAAA;AAEzB,OAAIA,MAAKC,QAAS,YAAd,CAA2BL,OAAM;AAErCD,gBAAYO,YAAaF,MAAM;;AAChCH,IAAA,KAAAD;AAAAC,IAAA,KAAAF;AAAAE,IAAA,KAAAE;OAAAA,MAAAF,EAAA;CALD,MAAAK,YAAkBZ,SAASS,GAKzB;CAAC,IAAAI;AAAA,KAAAN,EAAA,OAAAK,aAAAL,EAAA,OAAAF,cAAA;AAEIQ,OAAA;GAAA,GAAKR;GAAYO;GAAa;AAAAL,IAAA,KAAAK;AAAAL,IAAA,KAAAF;AAAAE,IAAA,KAAAM;OAAAA,MAAAN,EAAA;AAAA,QAA9BM"}

package/dist/utils/react/usePopoverSync.js

@@ -1,6 +1,7 @@
-/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.184.0 | Cube Dev Team */
 import { EventBusContext, useEventBus } from "./useEventBus.js";
-import { useCallback, useContext, useEffect, useRef } from "react";
+import { c } from "react-compiler-runtime";
+import { useContext, useEffect, useRef } from "react";
 
 //#region src/utils/react/usePopoverSync.ts
 /**
@@ -73,82 +74,176 @@ function isLogicalDescendantOf(target, ancestorMenuId, ancestorContainer) {
 *    flips off, `wasOpenRef` is reset so re-enabling later still emits if
 *    `isOpen` is true at that moment.
 */
-function usePopoverSync({ menuId, isOpen, onClose, enabled = true, triggerRef, containerRef, dismissOnInnerButtonPress = true, closeOnPeerOpen = true }) {
+function usePopoverSync(t0) {
+	const $ = c(28);
+	const { menuId, isOpen, onClose, enabled: t1, triggerRef, containerRef, dismissOnInnerButtonPress: t2, closeOnPeerOpen: t3 } = t0;
+	const enabled = t1 === void 0 ? true : t1;
+	const dismissOnInnerButtonPress = t2 === void 0 ? true : t2;
+	const closeOnPeerOpen = t3 === void 0 ? true : t3;
 	const { emit, on } = useEventBus();
 	const isOpenRef = useRef(isOpen);
-	useEffect(() => {
-		isOpenRef.current = isOpen;
-	}, [isOpen]);
+	let t4;
+	let t5;
+	if ($[0] !== isOpen) {
+		t4 = () => {
+			isOpenRef.current = isOpen;
+		};
+		t5 = [isOpen];
+		$[0] = isOpen;
+		$[1] = t4;
+		$[2] = t5;
+	} else {
+		t4 = $[1];
+		t5 = $[2];
+	}
+	useEffect(t4, t5);
 	const onCloseRef = useRef(onClose);
-	useEffect(() => {
-		onCloseRef.current = onClose;
-	}, [onClose]);
+	let t6;
+	let t7;
+	if ($[3] !== onClose) {
+		t6 = () => {
+			onCloseRef.current = onClose;
+		};
+		t7 = [onClose];
+		$[3] = onClose;
+		$[4] = t6;
+		$[5] = t7;
+	} else {
+		t6 = $[4];
+		t7 = $[5];
+	}
+	useEffect(t6, t7);
 	const containerRefRef = useRef(containerRef);
-	useEffect(() => {
-		containerRefRef.current = containerRef;
-	}, [containerRef]);
+	let t8;
+	let t9;
+	if ($[6] !== containerRef) {
+		t8 = () => {
+			containerRefRef.current = containerRef;
+		};
+		t9 = [containerRef];
+		$[6] = containerRef;
+		$[7] = t8;
+		$[8] = t9;
+	} else {
+		t8 = $[7];
+		t9 = $[8];
+	}
+	useEffect(t8, t9);
 	const triggerRefRef = useRef(triggerRef);
-	useEffect(() => {
-		triggerRefRef.current = triggerRef;
-	}, [triggerRef]);
-	useEffect(() => {
-		if (!enabled) return;
-		const offOpen = closeOnPeerOpen ? on("popover:open", (data) => {
-			if (data.menuId === menuId || !isOpenRef.current) return;
-			const container = containerRefRef.current?.current ?? null;
-			if (isLogicalDescendantOf(data.triggerEl, menuId, container)) return;
-			onCloseRef.current();
-		}) : null;
-		const offDismiss = dismissOnInnerButtonPress ? on("popover:dismiss-ancestor", (data) => {
-			if (!isOpenRef.current) return;
-			const container = containerRefRef.current?.current;
-			const from = data?.from;
-			if (!container || !from) return;
-			if (container.contains(from)) onCloseRef.current();
-		}) : null;
-		return () => {
-			offOpen?.();
-			offDismiss?.();
+	let t10;
+	let t11;
+	if ($[9] !== triggerRef) {
+		t10 = () => {
+			triggerRefRef.current = triggerRef;
+		};
+		t11 = [triggerRef];
+		$[9] = triggerRef;
+		$[10] = t10;
+		$[11] = t11;
+	} else {
+		t10 = $[10];
+		t11 = $[11];
+	}
+	useEffect(t10, t11);
+	let t12;
+	let t13;
+	if ($[12] !== closeOnPeerOpen || $[13] !== dismissOnInnerButtonPress || $[14] !== enabled || $[15] !== menuId || $[16] !== on) {
+		t12 = () => {
+			if (!enabled) return;
+			const offOpen = closeOnPeerOpen ? on("popover:open", (data) => {
+				if (data.menuId === menuId || !isOpenRef.current) return;
+				const container = containerRefRef.current?.current ?? null;
+				if (isLogicalDescendantOf(data.triggerEl, menuId, container)) return;
+				onCloseRef.current();
+			}) : null;
+			const offDismiss = dismissOnInnerButtonPress ? on("popover:dismiss-ancestor", (data_0) => {
+				if (!isOpenRef.current) return;
+				const container_0 = containerRefRef.current?.current;
+				const from = data_0?.from;
+				if (!container_0 || !from) return;
+				if (container_0.contains(from)) onCloseRef.current();
+			}) : null;
+			return () => {
+				offOpen?.();
+				offDismiss?.();
+			};
 		};
-	}, [
-		on,
-		menuId,
-		enabled,
-		dismissOnInnerButtonPress,
-		closeOnPeerOpen
-	]);
+		t13 = [
+			on,
+			menuId,
+			enabled,
+			dismissOnInnerButtonPress,
+			closeOnPeerOpen
+		];
+		$[12] = closeOnPeerOpen;
+		$[13] = dismissOnInnerButtonPress;
+		$[14] = enabled;
+		$[15] = menuId;
+		$[16] = on;
+		$[17] = t12;
+		$[18] = t13;
+	} else {
+		t12 = $[17];
+		t13 = $[18];
+	}
+	useEffect(t12, t13);
 	const wasOpenRef = useRef(false);
-	useEffect(() => {
-		if (!enabled) {
-			if (wasOpenRef.current) openPopovers.delete(menuId);
-			wasOpenRef.current = false;
-			return;
-		}
-		if (isOpen && !wasOpenRef.current) {
-			wasOpenRef.current = true;
-			openPopovers.set(menuId, {
-				getContainerEl: () => containerRefRef.current?.current ?? null,
-				getTriggerEl: () => triggerRefRef.current?.current ?? null
-			});
-			emit("popover:open", {
-				menuId,
-				triggerEl: triggerRefRef.current?.current ?? null
-			});
-		} else if (!isOpen && wasOpenRef.current) {
-			wasOpenRef.current = false;
-			openPopovers.delete(menuId);
-		}
-	}, [
-		isOpen,
-		emit,
-		menuId,
-		enabled
-	]);
-	useEffect(() => {
-		return () => {
+	let t14;
+	let t15;
+	if ($[19] !== emit || $[20] !== enabled || $[21] !== isOpen || $[22] !== menuId) {
+		t14 = () => {
+			if (!enabled) {
+				if (wasOpenRef.current) openPopovers.delete(menuId);
+				wasOpenRef.current = false;
+				return;
+			}
+			if (isOpen && !wasOpenRef.current) {
+				wasOpenRef.current = true;
+				openPopovers.set(menuId, {
+					getContainerEl: () => containerRefRef.current?.current ?? null,
+					getTriggerEl: () => triggerRefRef.current?.current ?? null
+				});
+				emit("popover:open", {
+					menuId,
+					triggerEl: triggerRefRef.current?.current ?? null
+				});
+			} else if (!isOpen && wasOpenRef.current) {
+				wasOpenRef.current = false;
+				openPopovers.delete(menuId);
+			}
+		};
+		t15 = [
+			isOpen,
+			emit,
+			menuId,
+			enabled
+		];
+		$[19] = emit;
+		$[20] = enabled;
+		$[21] = isOpen;
+		$[22] = menuId;
+		$[23] = t14;
+		$[24] = t15;
+	} else {
+		t14 = $[23];
+		t15 = $[24];
+	}
+	useEffect(t14, t15);
+	let t16;
+	let t17;
+	if ($[25] !== menuId) {
+		t16 = () => () => {
 			openPopovers.delete(menuId);
 		};
-	}, [menuId]);
+		t17 = [menuId];
+		$[25] = menuId;
+		$[26] = t16;
+		$[27] = t17;
+	} else {
+		t16 = $[26];
+		t17 = $[27];
+	}
+	useEffect(t16, t17);
 }
 /**
 * Hook that returns a dispatcher to close the popover that contains a given
@@ -177,11 +272,18 @@ function usePopoverSync({ menuId, isOpen, onClose, enabled = true, triggerRef, c
 * the dismiss flow gracefully degrades rather than throwing.
 */
 function useDismissParentPopover() {
+	const $ = c(2);
 	const emit = useContext(EventBusContext)?.emit;
-	return useCallback((from) => {
-		if (!from || !emit) return;
-		emit("popover:dismiss-ancestor", { from });
-	}, [emit]);
+	let t0;
+	if ($[0] !== emit) {
+		t0 = (from) => {
+			if (!from || !emit) return;
+			emit("popover:dismiss-ancestor", { from });
+		};
+		$[0] = emit;
+		$[1] = t0;
+	} else t0 = $[1];
+	return t0;
 }
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"usePopoverSync.js","names":[],"sources":["../../../src/utils/react/usePopoverSync.ts"],"sourcesContent":["import { RefObject, useCallback, useContext, useEffect, useRef } from 'react';\n\nimport { EventBusContext, useEventBus } from './useEventBus';\n\nexport interface UsePopoverSyncOptions {\n  /** Stable identifier for this popover instance (typically a generateRandomId() memo). */\n  menuId: string;\n  /** Current open state of this popover. */\n  isOpen: boolean;\n  /** Called when another popover opens while this one is open. */\n  onClose: () => void;\n  /**\n   * When `false`, this popover does not participate in the sync (no listening,\n   * no emitting). Useful for \"dummy\" triggers that proxy a real one (see\n   * `MenuTrigger`'s `isDummy`). Defaults to `true`.\n   */\n  enabled?: boolean;\n  /**\n   * Ref to the popover's trigger element. When provided, the element is\n   * included in the `popover:open` emit payload so peers can detect whether\n   * the new opener is nested inside their own overlay (and skip closing in\n   * that case). Optional — omitting it preserves the legacy \"always close on\n   * peer open\" behaviour.\n   */\n  triggerRef?: RefObject<HTMLElement | null>;\n  /**\n   * Ref to the overlay/container element that hosts this popover's content.\n   * When provided, the listener performs a DOM `contains()` check on incoming\n   * peer triggers: peers whose trigger lives inside this container are\n   * considered nested children and do NOT close us.\n   */\n  containerRef?: RefObject<HTMLElement | null>;\n  /**\n   * Whether this overlay closes when a Button/ItemButton inside its container\n   * is pressed. Defaults to `true` (popover semantics — popovers are transient\n   * surfaces and any action inside them should dismiss them). Set to `false`\n   * for modals/trays/fullscreen dialogs — buttons inside a Dialog should not\n   * auto-close it. Requires `containerRef` to be set; without it the listener\n   * has no way to determine whether the dispatching button is \"inside\" this\n   * overlay and is effectively a no-op.\n   */\n  dismissOnInnerButtonPress?: boolean;\n  /**\n   * Whether this overlay closes when a peer popover opens. Defaults to `true`\n   * (popover semantics — only one popover open at a time). Set to `false` for\n   * modals/trays/fullscreen dialogs so a peer popover opening cannot bypass\n   * the dialog's own `isDismissable` / `onClose` handling and yank it shut.\n   *\n   * The host still EMITS `popover:open` regardless of this flag, so opening a\n   * modal/tray correctly dismisses any peer popover that was open before.\n   */\n  closeOnPeerOpen?: boolean;\n}\n\ninterface PopoverOpenPayload {\n  menuId: string;\n  triggerEl: Element | null;\n}\n\ninterface PopoverDismissAncestorPayload {\n  /** The DOM node of the button that requested the dismiss. */\n  from: Element | null;\n}\n\ninterface PopoverRegistryEntry {\n  getContainerEl: () => Element | null;\n  getTriggerEl: () => Element | null;\n}\n\n/**\n * Module-level registry of currently open popovers. Lets us resolve the\n * LOGICAL parent of an arbitrary element across portal boundaries.\n *\n * Popover content is portaled to a shared root (`document.body` by default —\n * see `Overlay.tsx`), so a grandchild popover's trigger lives inside a\n * sibling portal rather than physically inside its grandparent's container.\n * A naive `container.contains(triggerEl)` check therefore misses the\n * relationship and closes the grandparent — the bug that surfaces with 3+\n * levels of `SubMenuTrigger` nesting.\n *\n * The registry stores closures over the host's refs so reads always see the\n * latest `.current` value without forcing a re-register per render.\n */\nconst openPopovers = new Map<string, PopoverRegistryEntry>();\n\n/**\n * Find the open popover whose container directly contains `target`. Returns\n * `null` for elements that live outside every registered popover (e.g. a\n * top-level trigger button rendered next to its overlay root).\n */\nfunction findOwningPopover(\n  target: Element | null,\n): [string, PopoverRegistryEntry] | null {\n  if (!target) return null;\n  for (const entry of openPopovers) {\n    if (entry[1].getContainerEl()?.contains(target)) {\n      return entry;\n    }\n  }\n  return null;\n}\n\n/**\n * Returns `true` when `target` is nested inside the overlay identified by\n * `ancestorMenuId` — either as a direct DOM descendant of `ancestorContainer`\n * or as a descendant of a chain of popovers whose triggers eventually land\n * inside it. Used by `popover:open` peers to avoid closing themselves when a\n * grand-child overlay opens through a portal.\n */\nfunction isLogicalDescendantOf(\n  target: Element | null,\n  ancestorMenuId: string,\n  ancestorContainer: Element | null,\n): boolean {\n  if (ancestorContainer && target && ancestorContainer.contains(target)) {\n    return true;\n  }\n  let cur: Element | null = target;\n  const visited = new Set<string>();\n  while (cur) {\n    const owner = findOwningPopover(cur);\n    if (!owner) return false;\n    const [id, entry] = owner;\n    if (visited.has(id)) return false;\n    visited.add(id);\n    if (id === ancestorMenuId) return true;\n    cur = entry.getTriggerEl();\n  }\n  return false;\n}\n\n/**\n * Coordinates the \"only one popover open at a time\" invariant via the EventBus.\n *\n * - When `isOpen` flips `false -> true`, emits `popover:open` once.\n * - While open, listens for peers' `popover:open` events and calls `onClose`.\n *\n * Implementation notes (ALL of these matter — losing any one re-introduces a\n * race that surfaces only under rapid trigger switching, which is hard to\n * reproduce in tests):\n *\n * 1. `isOpen` and `onClose` are read through refs inside the listener, so the\n *    subscription effect's dep array does NOT include `isOpen`/`onClose`. This\n *    keeps the listener identity stable across open/close transitions and\n *    avoids the unsubscribe-emit-resubscribe window where an emit can be\n *    delivered to a stale listener (or no listener).\n * 2. The emit fires only on the `false -> true` transition, gated by\n *    `wasOpenRef`. A re-render where `isOpen` is still `true` must NOT\n *    re-emit, otherwise it could re-trigger listeners on peers that just\n *    opened in the same render flush.\n * 3. The `enabled` flag short-circuits both effects symmetrically. When it\n *    flips off, `wasOpenRef` is reset so re-enabling later still emits if\n *    `isOpen` is true at that moment.\n */\nexport function usePopoverSync({\n  menuId,\n  isOpen,\n  onClose,\n  enabled = true,\n  triggerRef,\n  containerRef,\n  dismissOnInnerButtonPress = true,\n  closeOnPeerOpen = true,\n}: UsePopoverSyncOptions): void {\n  const { emit, on } = useEventBus();\n\n  const isOpenRef = useRef(isOpen);\n  useEffect(() => {\n    isOpenRef.current = isOpen;\n  }, [isOpen]);\n\n  const onCloseRef = useRef(onClose);\n  useEffect(() => {\n    onCloseRef.current = onClose;\n  }, [onClose]);\n\n  // Track the latest containerRef via a stable ref-of-refs so the listener\n  // never resubscribes when callers pass freshly-created ref wrappers across\n  // renders. Same pattern as `onCloseRef` above — without this the listener's\n  // effect would churn for any caller that doesn't memoize its refs.\n  const containerRefRef = useRef(containerRef);\n  useEffect(() => {\n    containerRefRef.current = containerRef;\n  }, [containerRef]);\n\n  const triggerRefRef = useRef(triggerRef);\n  useEffect(() => {\n    triggerRefRef.current = triggerRef;\n  }, [triggerRef]);\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    // `popover:open` listener — gated on `closeOnPeerOpen`. Modals/trays opt\n    // out so a peer popover opening cannot bypass the dialog's\n    // `isDismissable` / `onClose` handling and call `state.close()` directly.\n    // Note: the EMIT side (lower in this hook) still fires regardless, so\n    // opening a modal still correctly dismisses peer popovers.\n    const offOpen = closeOnPeerOpen\n      ? on('popover:open', (data: PopoverOpenPayload) => {\n          if (data.menuId === menuId || !isOpenRef.current) return;\n          const container = containerRefRef.current?.current ?? null;\n          // Nested-popover guard: stay open when the opening peer's trigger is\n          // a LOGICAL descendant of our overlay. Direct DOM containment only\n          // covers the first level — for grand-child popovers the trigger lives\n          // in a sibling portal, so we walk the registered popover chain back\n          // up via each parent's trigger element. Without this, opening a\n          // third-level `SubMenuTrigger` would close every ancestor menu.\n          if (isLogicalDescendantOf(data.triggerEl, menuId, container)) return;\n          onCloseRef.current();\n        })\n      : null;\n\n    // `popover:dismiss-ancestor` is emitted by `Button` / `ItemButton` (and any\n    // consumer using `useDismissParentPopover`) after their `onPress` runs.\n    // Only popover-type overlays subscribe; modals/trays opt out via\n    // `dismissOnInnerButtonPress: false` so a Button inside a Dialog content\n    // does NOT auto-close the Dialog.\n    const offDismiss = dismissOnInnerButtonPress\n      ? on(\n          'popover:dismiss-ancestor',\n          (data: PopoverDismissAncestorPayload) => {\n            if (!isOpenRef.current) return;\n            const container = containerRefRef.current?.current;\n            const from = data?.from;\n            // Require both a container and an originating element so we can do\n            // the contains-check. Hosts without `containerRef` (e.g.\n            // `use-anchored-menu`, `use-context-menu`) are silently no-op.\n            if (!container || !from) return;\n            if (container.contains(from)) onCloseRef.current();\n          },\n        )\n      : null;\n\n    return () => {\n      offOpen?.();\n      offDismiss?.();\n    };\n  }, [on, menuId, enabled, dismissOnInnerButtonPress, closeOnPeerOpen]);\n\n  const wasOpenRef = useRef(false);\n  useEffect(() => {\n    if (!enabled) {\n      if (wasOpenRef.current) {\n        openPopovers.delete(menuId);\n      }\n      wasOpenRef.current = false;\n      return;\n    }\n    if (isOpen && !wasOpenRef.current) {\n      wasOpenRef.current = true;\n      // Register BEFORE emitting so peers' listeners (deferred via the\n      // bus's `setTimeout(0)`) can already see us in the registry when\n      // they walk the logical chain.\n      openPopovers.set(menuId, {\n        getContainerEl: () => containerRefRef.current?.current ?? null,\n        getTriggerEl: () => triggerRefRef.current?.current ?? null,\n      });\n      emit<PopoverOpenPayload>('popover:open', {\n        menuId,\n        triggerEl: triggerRefRef.current?.current ?? null,\n      });\n    } else if (!isOpen && wasOpenRef.current) {\n      wasOpenRef.current = false;\n      openPopovers.delete(menuId);\n    }\n  }, [isOpen, emit, menuId, enabled]);\n\n  // Final cleanup on unmount: covers the case where a host unmounts while\n  // still flagged open (e.g. a parent unmount tears down a child popover\n  // before its close transition runs).\n  useEffect(() => {\n    return () => {\n      openPopovers.delete(menuId);\n    };\n  }, [menuId]);\n}\n\n/**\n * Hook that returns a dispatcher to close the popover that contains a given\n * DOM element. Used by `Button` / `ItemButton` to implement the default\n * \"press inside a popover closes the popover\" behaviour. Custom (non-Cube)\n * interactive controls can call this directly:\n *\n * ```tsx\n * const dismiss = useDismissParentPopover();\n * <MyCustomPressable onPress={(e) => { doThing(); dismiss(e.currentTarget); }} />\n * ```\n *\n * The actual dismiss is dispatched through the EventBus, which defers via\n * `setTimeout(0)` — so the user's synchronous handler (and any React state\n * updates it triggers) flushes BEFORE the popover closes. This is critical\n * for the \"open a hoisted modal from a popover footer\" case: the modal\n * mounts first, then the popover closes.\n *\n * Only popover-type containers (those that pass `dismissOnInnerButtonPress`\n * as `true`, the default) react to the event. Modal/tray/fullscreen Dialog\n * containers explicitly opt out so a Button inside their content does not\n * auto-close them.\n *\n * When called outside an `EventBusProvider` (e.g. in unit tests that render\n * a Button without wrapping in `<Root>`), the returned function is a no-op —\n * the dismiss flow gracefully degrades rather than throwing.\n */\nexport function useDismissParentPopover() {\n  // Read context defensively: `Button` / `ItemButton` use this hook\n  // unconditionally, but tests (and standalone usages outside `<Root>`) may\n  // mount them without an `EventBusProvider`. A throw would crash every\n  // Button render in those cases.\n  const bus = useContext(EventBusContext);\n  const emit = bus?.emit;\n  return useCallback(\n    (from: Element | null) => {\n      if (!from || !emit) return;\n      emit<PopoverDismissAncestorPayload>('popover:dismiss-ancestor', { from });\n    },\n    [emit],\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"usePopoverSync.js","names":["RefObject","useCallback","useContext","useEffect","useRef","EventBusContext","useEventBus","UsePopoverSyncOptions","menuId","isOpen","onClose","enabled","triggerRef","HTMLElement","containerRef","dismissOnInnerButtonPress","closeOnPeerOpen","PopoverOpenPayload","triggerEl","Element","PopoverDismissAncestorPayload","from","PopoverRegistryEntry","getContainerEl","getTriggerEl","openPopovers","Map","findOwningPopover","target","entry","contains","isLogicalDescendantOf","ancestorMenuId","ancestorContainer","cur","visited","Set","owner","id","has","add","usePopoverSync","t0","$","_c","t1","t2","t3","undefined","emit","on","isOpenRef","t4","t5","current","onCloseRef","t6","t7","containerRefRef","t8","t9","triggerRefRef","t10","t11","t12","t13","offOpen","data","container","offDismiss","data_0","container_0","wasOpenRef","t14","t15","delete","set","t16","t17","useDismissParentPopover","bus"],"sources":["../../../src/utils/react/usePopoverSync.ts"],"sourcesContent":["import { RefObject, useCallback, useContext, useEffect, useRef } from 'react';\n\nimport { EventBusContext, useEventBus } from './useEventBus';\n\nexport interface UsePopoverSyncOptions {\n  /** Stable identifier for this popover instance (typically a generateRandomId() memo). */\n  menuId: string;\n  /** Current open state of this popover. */\n  isOpen: boolean;\n  /** Called when another popover opens while this one is open. */\n  onClose: () => void;\n  /**\n   * When `false`, this popover does not participate in the sync (no listening,\n   * no emitting). Useful for \"dummy\" triggers that proxy a real one (see\n   * `MenuTrigger`'s `isDummy`). Defaults to `true`.\n   */\n  enabled?: boolean;\n  /**\n   * Ref to the popover's trigger element. When provided, the element is\n   * included in the `popover:open` emit payload so peers can detect whether\n   * the new opener is nested inside their own overlay (and skip closing in\n   * that case). Optional — omitting it preserves the legacy \"always close on\n   * peer open\" behaviour.\n   */\n  triggerRef?: RefObject<HTMLElement | null>;\n  /**\n   * Ref to the overlay/container element that hosts this popover's content.\n   * When provided, the listener performs a DOM `contains()` check on incoming\n   * peer triggers: peers whose trigger lives inside this container are\n   * considered nested children and do NOT close us.\n   */\n  containerRef?: RefObject<HTMLElement | null>;\n  /**\n   * Whether this overlay closes when a Button/ItemButton inside its container\n   * is pressed. Defaults to `true` (popover semantics — popovers are transient\n   * surfaces and any action inside them should dismiss them). Set to `false`\n   * for modals/trays/fullscreen dialogs — buttons inside a Dialog should not\n   * auto-close it. Requires `containerRef` to be set; without it the listener\n   * has no way to determine whether the dispatching button is \"inside\" this\n   * overlay and is effectively a no-op.\n   */\n  dismissOnInnerButtonPress?: boolean;\n  /**\n   * Whether this overlay closes when a peer popover opens. Defaults to `true`\n   * (popover semantics — only one popover open at a time). Set to `false` for\n   * modals/trays/fullscreen dialogs so a peer popover opening cannot bypass\n   * the dialog's own `isDismissable` / `onClose` handling and yank it shut.\n   *\n   * The host still EMITS `popover:open` regardless of this flag, so opening a\n   * modal/tray correctly dismisses any peer popover that was open before.\n   */\n  closeOnPeerOpen?: boolean;\n}\n\ninterface PopoverOpenPayload {\n  menuId: string;\n  triggerEl: Element | null;\n}\n\ninterface PopoverDismissAncestorPayload {\n  /** The DOM node of the button that requested the dismiss. */\n  from: Element | null;\n}\n\ninterface PopoverRegistryEntry {\n  getContainerEl: () => Element | null;\n  getTriggerEl: () => Element | null;\n}\n\n/**\n * Module-level registry of currently open popovers. Lets us resolve the\n * LOGICAL parent of an arbitrary element across portal boundaries.\n *\n * Popover content is portaled to a shared root (`document.body` by default —\n * see `Overlay.tsx`), so a grandchild popover's trigger lives inside a\n * sibling portal rather than physically inside its grandparent's container.\n * A naive `container.contains(triggerEl)` check therefore misses the\n * relationship and closes the grandparent — the bug that surfaces with 3+\n * levels of `SubMenuTrigger` nesting.\n *\n * The registry stores closures over the host's refs so reads always see the\n * latest `.current` value without forcing a re-register per render.\n */\nconst openPopovers = new Map<string, PopoverRegistryEntry>();\n\n/**\n * Find the open popover whose container directly contains `target`. Returns\n * `null` for elements that live outside every registered popover (e.g. a\n * top-level trigger button rendered next to its overlay root).\n */\nfunction findOwningPopover(\n  target: Element | null,\n): [string, PopoverRegistryEntry] | null {\n  if (!target) return null;\n  for (const entry of openPopovers) {\n    if (entry[1].getContainerEl()?.contains(target)) {\n      return entry;\n    }\n  }\n  return null;\n}\n\n/**\n * Returns `true` when `target` is nested inside the overlay identified by\n * `ancestorMenuId` — either as a direct DOM descendant of `ancestorContainer`\n * or as a descendant of a chain of popovers whose triggers eventually land\n * inside it. Used by `popover:open` peers to avoid closing themselves when a\n * grand-child overlay opens through a portal.\n */\nfunction isLogicalDescendantOf(\n  target: Element | null,\n  ancestorMenuId: string,\n  ancestorContainer: Element | null,\n): boolean {\n  if (ancestorContainer && target && ancestorContainer.contains(target)) {\n    return true;\n  }\n  let cur: Element | null = target;\n  const visited = new Set<string>();\n  while (cur) {\n    const owner = findOwningPopover(cur);\n    if (!owner) return false;\n    const [id, entry] = owner;\n    if (visited.has(id)) return false;\n    visited.add(id);\n    if (id === ancestorMenuId) return true;\n    cur = entry.getTriggerEl();\n  }\n  return false;\n}\n\n/**\n * Coordinates the \"only one popover open at a time\" invariant via the EventBus.\n *\n * - When `isOpen` flips `false -> true`, emits `popover:open` once.\n * - While open, listens for peers' `popover:open` events and calls `onClose`.\n *\n * Implementation notes (ALL of these matter — losing any one re-introduces a\n * race that surfaces only under rapid trigger switching, which is hard to\n * reproduce in tests):\n *\n * 1. `isOpen` and `onClose` are read through refs inside the listener, so the\n *    subscription effect's dep array does NOT include `isOpen`/`onClose`. This\n *    keeps the listener identity stable across open/close transitions and\n *    avoids the unsubscribe-emit-resubscribe window where an emit can be\n *    delivered to a stale listener (or no listener).\n * 2. The emit fires only on the `false -> true` transition, gated by\n *    `wasOpenRef`. A re-render where `isOpen` is still `true` must NOT\n *    re-emit, otherwise it could re-trigger listeners on peers that just\n *    opened in the same render flush.\n * 3. The `enabled` flag short-circuits both effects symmetrically. When it\n *    flips off, `wasOpenRef` is reset so re-enabling later still emits if\n *    `isOpen` is true at that moment.\n */\nexport function usePopoverSync({\n  menuId,\n  isOpen,\n  onClose,\n  enabled = true,\n  triggerRef,\n  containerRef,\n  dismissOnInnerButtonPress = true,\n  closeOnPeerOpen = true,\n}: UsePopoverSyncOptions): void {\n  const { emit, on } = useEventBus();\n\n  const isOpenRef = useRef(isOpen);\n  useEffect(() => {\n    isOpenRef.current = isOpen;\n  }, [isOpen]);\n\n  const onCloseRef = useRef(onClose);\n  useEffect(() => {\n    onCloseRef.current = onClose;\n  }, [onClose]);\n\n  // Track the latest containerRef via a stable ref-of-refs so the listener\n  // never resubscribes when callers pass freshly-created ref wrappers across\n  // renders. Same pattern as `onCloseRef` above — without this the listener's\n  // effect would churn for any caller that doesn't memoize its refs.\n  const containerRefRef = useRef(containerRef);\n  useEffect(() => {\n    containerRefRef.current = containerRef;\n  }, [containerRef]);\n\n  const triggerRefRef = useRef(triggerRef);\n  useEffect(() => {\n    triggerRefRef.current = triggerRef;\n  }, [triggerRef]);\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    // `popover:open` listener — gated on `closeOnPeerOpen`. Modals/trays opt\n    // out so a peer popover opening cannot bypass the dialog's\n    // `isDismissable` / `onClose` handling and call `state.close()` directly.\n    // Note: the EMIT side (lower in this hook) still fires regardless, so\n    // opening a modal still correctly dismisses peer popovers.\n    const offOpen = closeOnPeerOpen\n      ? on('popover:open', (data: PopoverOpenPayload) => {\n          if (data.menuId === menuId || !isOpenRef.current) return;\n          const container = containerRefRef.current?.current ?? null;\n          // Nested-popover guard: stay open when the opening peer's trigger is\n          // a LOGICAL descendant of our overlay. Direct DOM containment only\n          // covers the first level — for grand-child popovers the trigger lives\n          // in a sibling portal, so we walk the registered popover chain back\n          // up via each parent's trigger element. Without this, opening a\n          // third-level `SubMenuTrigger` would close every ancestor menu.\n          if (isLogicalDescendantOf(data.triggerEl, menuId, container)) return;\n          onCloseRef.current();\n        })\n      : null;\n\n    // `popover:dismiss-ancestor` is emitted by `Button` / `ItemButton` (and any\n    // consumer using `useDismissParentPopover`) after their `onPress` runs.\n    // Only popover-type overlays subscribe; modals/trays opt out via\n    // `dismissOnInnerButtonPress: false` so a Button inside a Dialog content\n    // does NOT auto-close the Dialog.\n    const offDismiss = dismissOnInnerButtonPress\n      ? on(\n          'popover:dismiss-ancestor',\n          (data: PopoverDismissAncestorPayload) => {\n            if (!isOpenRef.current) return;\n            const container = containerRefRef.current?.current;\n            const from = data?.from;\n            // Require both a container and an originating element so we can do\n            // the contains-check. Hosts without `containerRef` (e.g.\n            // `use-anchored-menu`, `use-context-menu`) are silently no-op.\n            if (!container || !from) return;\n            if (container.contains(from)) onCloseRef.current();\n          },\n        )\n      : null;\n\n    return () => {\n      offOpen?.();\n      offDismiss?.();\n    };\n  }, [on, menuId, enabled, dismissOnInnerButtonPress, closeOnPeerOpen]);\n\n  const wasOpenRef = useRef(false);\n  useEffect(() => {\n    if (!enabled) {\n      if (wasOpenRef.current) {\n        openPopovers.delete(menuId);\n      }\n      wasOpenRef.current = false;\n      return;\n    }\n    if (isOpen && !wasOpenRef.current) {\n      wasOpenRef.current = true;\n      // Register BEFORE emitting so peers' listeners (deferred via the\n      // bus's `setTimeout(0)`) can already see us in the registry when\n      // they walk the logical chain.\n      openPopovers.set(menuId, {\n        getContainerEl: () => containerRefRef.current?.current ?? null,\n        getTriggerEl: () => triggerRefRef.current?.current ?? null,\n      });\n      emit<PopoverOpenPayload>('popover:open', {\n        menuId,\n        triggerEl: triggerRefRef.current?.current ?? null,\n      });\n    } else if (!isOpen && wasOpenRef.current) {\n      wasOpenRef.current = false;\n      openPopovers.delete(menuId);\n    }\n  }, [isOpen, emit, menuId, enabled]);\n\n  // Final cleanup on unmount: covers the case where a host unmounts while\n  // still flagged open (e.g. a parent unmount tears down a child popover\n  // before its close transition runs).\n  useEffect(() => {\n    return () => {\n      openPopovers.delete(menuId);\n    };\n  }, [menuId]);\n}\n\n/**\n * Hook that returns a dispatcher to close the popover that contains a given\n * DOM element. Used by `Button` / `ItemButton` to implement the default\n * \"press inside a popover closes the popover\" behaviour. Custom (non-Cube)\n * interactive controls can call this directly:\n *\n * ```tsx\n * const dismiss = useDismissParentPopover();\n * <MyCustomPressable onPress={(e) => { doThing(); dismiss(e.currentTarget); }} />\n * ```\n *\n * The actual dismiss is dispatched through the EventBus, which defers via\n * `setTimeout(0)` — so the user's synchronous handler (and any React state\n * updates it triggers) flushes BEFORE the popover closes. This is critical\n * for the \"open a hoisted modal from a popover footer\" case: the modal\n * mounts first, then the popover closes.\n *\n * Only popover-type containers (those that pass `dismissOnInnerButtonPress`\n * as `true`, the default) react to the event. Modal/tray/fullscreen Dialog\n * containers explicitly opt out so a Button inside their content does not\n * auto-close them.\n *\n * When called outside an `EventBusProvider` (e.g. in unit tests that render\n * a Button without wrapping in `<Root>`), the returned function is a no-op —\n * the dismiss flow gracefully degrades rather than throwing.\n */\nexport function useDismissParentPopover() {\n  // Read context defensively: `Button` / `ItemButton` use this hook\n  // unconditionally, but tests (and standalone usages outside `<Root>`) may\n  // mount them without an `EventBusProvider`. A throw would crash every\n  // Button render in those cases.\n  const bus = useContext(EventBusContext);\n  const emit = bus?.emit;\n  return useCallback(\n    (from: Element | null) => {\n      if (!from || !emit) return;\n      emit<PopoverDismissAncestorPayload>('popover:dismiss-ancestor', { from });\n    },\n    [emit],\n  );\n}\n"],"mappings":"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"}

package/dist/utils/react/useQaProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.184.0 | Cube Dev Team */
 //#region src/utils/react/useQaProps.ts
 /**
 * Processes QA props.

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

@@ -1 +1 @@
-{"version":3,"file":"useQaProps.js","names":[],"sources":["../../../src/utils/react/useQaProps.ts"],"sourcesContent":["type Props = {\n  qa?: string;\n  qaVal?: string;\n  'data-qa'?: string;\n  'data-qa-val'?: string;\n};\n\n/**\n * Processes QA props.\n * If `qa` or `qaVal` props are present, they are not modified and have higher priority.\n * Otherwise, maps `data-qa` to `qa` and `data-qa-val` to `qaVal`.\n * Data attributes are always removed.\n * Modifies the original props object without copying it.\n * Accepts only non-falsy values, otherwise deletes both props.\n *\n * @param props - The object to process\n * @returns The modified object\n */\nexport function useQaProps<T extends Props>(props: T): T {\n  // Helper function to process qa attributes\n  const processQaAttribute = (propName: string, dataAttrName: string) => {\n    if (props[propName] !== undefined || props[dataAttrName] !== undefined) {\n      const propValue = props[propName];\n      const dataAttrValue = props[dataAttrName];\n\n      if (!propValue) {\n        if (dataAttrValue) {\n          // If prop is empty but data-attr is truthy, map data-attr to prop\n          props[propName] = dataAttrValue;\n        } else {\n          // Both values are falsy, delete both\n          delete props[propName];\n        }\n      }\n\n      delete props[dataAttrName];\n    }\n  };\n\n  // Process qa attributes\n  processQaAttribute('qa', 'data-qa');\n  processQaAttribute('qaVal', 'data-qa-val');\n\n  return props;\n}\n"],"mappings":";;;;;;;;;;;;;AAkBA,SAAgB,WAA4B,OAAa;CAEvD,MAAM,sBAAsB,UAAkB,iBAAyB;AACrE,MAAI,MAAM,cAAc,UAAa,MAAM,kBAAkB,QAAW;GACtE,MAAM,YAAY,MAAM;GACxB,MAAM,gBAAgB,MAAM;AAE5B,OAAI,CAAC,UACH,KAAI,cAEF,OAAM,YAAY;OAGlB,QAAO,MAAM;AAIjB,UAAO,MAAM;;;AAKjB,oBAAmB,MAAM,UAAU;AACnC,oBAAmB,SAAS,cAAc;AAE1C,QAAO"}
+{"version":3,"file":"useQaProps.js","names":["Props","qa","qaVal","useQaProps","props","T","processQaAttribute","propName","dataAttrName","undefined","propValue","dataAttrValue"],"sources":["../../../src/utils/react/useQaProps.ts"],"sourcesContent":["type Props = {\n  qa?: string;\n  qaVal?: string;\n  'data-qa'?: string;\n  'data-qa-val'?: string;\n};\n\n/**\n * Processes QA props.\n * If `qa` or `qaVal` props are present, they are not modified and have higher priority.\n * Otherwise, maps `data-qa` to `qa` and `data-qa-val` to `qaVal`.\n * Data attributes are always removed.\n * Modifies the original props object without copying it.\n * Accepts only non-falsy values, otherwise deletes both props.\n *\n * @param props - The object to process\n * @returns The modified object\n */\nexport function useQaProps<T extends Props>(props: T): T {\n  // Helper function to process qa attributes\n  const processQaAttribute = (propName: string, dataAttrName: string) => {\n    if (props[propName] !== undefined || props[dataAttrName] !== undefined) {\n      const propValue = props[propName];\n      const dataAttrValue = props[dataAttrName];\n\n      if (!propValue) {\n        if (dataAttrValue) {\n          // If prop is empty but data-attr is truthy, map data-attr to prop\n          props[propName] = dataAttrValue;\n        } else {\n          // Both values are falsy, delete both\n          delete props[propName];\n        }\n      }\n\n      delete props[dataAttrName];\n    }\n  };\n\n  // Process qa attributes\n  processQaAttribute('qa', 'data-qa');\n  processQaAttribute('qaVal', 'data-qa-val');\n\n  return props;\n}\n"],"mappings":";;;;;;;;;;;;;AAkBA,SAAgBG,WAA4BC,OAAa;CAEvD,MAAME,sBAAsBC,UAAkBC,iBAAyB;AACrE,MAAIJ,MAAMG,cAAcE,UAAaL,MAAMI,kBAAkBC,QAAW;GACtE,MAAMC,YAAYN,MAAMG;GACxB,MAAMI,gBAAgBP,MAAMI;AAE5B,OAAI,CAACE,UACH,KAAIC,cAEFP,OAAMG,YAAYI;OAGlB,QAAOP,MAAMG;AAIjB,UAAOH,MAAMI;;;AAKjBF,oBAAmB,MAAM,UAAU;AACnCA,oBAAmB,SAAS,cAAc;AAE1C,QAAOF"}

package/dist/utils/react/useScheme.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.184.0 | Cube Dev Team */
 import { useSyncExternalStore } from "react";
 
 //#region src/utils/react/useScheme.ts