@cube-dev/ui-kit 0.197.0 → 0.198.0

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

@@ -1,17 +1,14 @@
 
-import * as react from "react";
 import { ReactElement } from "react";
 import { DOMRef } from "@react-types/shared";
-
 //#region src/utils/react/forwardRefWithGenerics.d.ts
 /**
  * @deprecated Declare a ref prop on a generic component, or preserve an
  * existing forwardRef wrapper with a cast that restores its generic. This
  * helper's returned `<T>` is unused, so props lose their item generic.
  */
-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 & {
+export 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>>;
+}) => ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
 //#endregion
-export { forwardRefWithGenerics };
 //# sourceMappingURL=forwardRefWithGenerics.d.ts.map

package/dist/utils/react/forwardRefWithGenerics.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 //#region src/utils/react/forwardRefWithGenerics.tsx
 /**
 * @deprecated Declare a ref prop on a generic component, or preserve an
@@ -11,7 +11,7 @@ function forwardRefWithGenerics(component) {
 		return component(otherProps, ref);
 	};
 }
-
 //#endregion
 export { forwardRefWithGenerics };
+
 //# sourceMappingURL=forwardRefWithGenerics.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"forwardRefWithGenerics.js","names":["DOMRef","ReactElement","forwardRefWithGenerics","Record","HTMLElement","component","props","TProps","ref","TElement","ComponentWithRef","otherProps"],"sources":["../../../src/utils/react/forwardRefWithGenerics.tsx"],"sourcesContent":["import { DOMRef } from '@react-types/shared';\nimport { ReactElement } from 'react';\n\n/**\n * @deprecated Declare a ref prop on a generic component, or preserve an\n * existing forwardRef wrapper with a cast that restores its generic. This\n * helper's returned `<T>` is unused, so props lose their item generic.\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":";;;;;;;AAQA,SAAgBE,uBAIdG,WAIA;AACA,QAAO,SAASK,iBACdJ,OACA;EACA,MAAM,EAAEE,MAAM,MAAM,GAAGG,eAAeL;AACtC,SAAOD,UAAUM,YAAsBH,IAAI"}
+{"version":3,"file":"forwardRefWithGenerics.js","names":["DOMRef","ReactElement","forwardRefWithGenerics","Record","HTMLElement","component","props","TProps","ref","TElement","ComponentWithRef","otherProps"],"sources":["../../../src/utils/react/forwardRefWithGenerics.tsx"],"sourcesContent":["import { DOMRef } from '@react-types/shared';\nimport { ReactElement } from 'react';\n\n/**\n * @deprecated Declare a ref prop on a generic component, or preserve an\n * existing forwardRef wrapper with a cast that restores its generic. This\n * helper's returned `<T>` is unused, so props lose their item generic.\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":";;;;;;;AAQA,SAAgBE,uBAIdG,WAIA;CACA,OAAO,SAASK,iBACdJ,OACA;EACA,MAAM,EAAEE,MAAM,MAAM,GAAGG,eAAeL;EACtC,OAAOD,UAAUM,YAAsBH,GAAG;CAC5C;AACF"}

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

@@ -20,4 +20,4 @@ import { DynamicIcon, IconRenderFn, ResolvedIcon, resolveIcon } from "./resolveI
 import { useMergeStyles } from "./useMergeStyles.js";
 import { UseBufferedValueOptions, UseBufferedValueResult, useBufferedValue } from "./useBufferedValue.js";
 import { modAttrs } from "@tenphi/tasty";
-export { modAttrs };
+export { ClearSlots, type ColorScheme, type DisabledElementOptions, type DisabledElementProps, type DynamicIcon, type EventBusContextValue, type EventBusListener, EventBusProvider, type IconRenderFn, RenderCache, type RenderCacheProps, type ResolvedIcon, SlotProvider, type UseBufferedValueOptions, type UseBufferedValueResult, type UseControlledFocusVisibleResult, type UsePopoverSyncOptions, chain, forwardRefWithGenerics, getDisabledElementProps, isTextOnly, mergeProps, mergeRefs, modAttrs, omitActivationEventProps, resolveHighContrast, resolveIcon, resolveScheme, subscribeScheme, useBufferedValue, useCombinedRefs, useControlledFocusVisible, useDismissParentPopover, useEventBus, useEventListener, useHighContrast, useLayoutEffect, useLocalStorage, useMergeStyles, usePopoverSync, useQaProps, useScheme, useSlotProps, useViewportSize, wrapNodeIfPlain };

package/dist/utils/react/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { chain } from "./chain.js";
 import { useLayoutEffect } from "./useLayoutEffect.js";
 import { mergeProps } from "./mergeProps.js";
@@ -20,5 +20,4 @@ import { resolveIcon } from "./resolveIcon.js";
 import { useMergeStyles } from "./useMergeStyles.js";
 import { useBufferedValue } from "./useBufferedValue.js";
 import { modAttrs } from "@tenphi/tasty";
-
-export { modAttrs };
+export { ClearSlots, EventBusProvider, RenderCache, SlotProvider, chain, forwardRefWithGenerics, getDisabledElementProps, isTextOnly, mergeProps, mergeRefs, modAttrs, omitActivationEventProps, resolveHighContrast, resolveIcon, resolveScheme, subscribeScheme, useBufferedValue, useCombinedRefs, useControlledFocusVisible, useDismissParentPopover, useEventBus, useEventListener, useHighContrast, useLayoutEffect, useLocalStorage, useMergeStyles, usePopoverSync, useQaProps, useScheme, useSlotProps, useViewportSize, wrapNodeIfPlain };

package/dist/utils/react/interactions.js

@@ -1,11 +1,10 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { c } from "react/compiler-runtime";
 import { useRef, useState } from "react";
 import { useFocus } from "react-aria";
 import { isFocusVisible, useFocusVisibleListener } from "@react-aria/interactions";
 import { getActiveElement, getOwnerDocument } from "@react-aria/utils";
-
 //#region src/utils/react/interactions.ts
 /**
 * Whether the element holds focus, disabled or not: a control that keeps
@@ -91,7 +90,7 @@ function useFocus$1(t0) {
 	} else t8 = $[9];
 	return t8;
 }
-
 //#endregion
 export { useFocus$1 as useFocus };
+
 //# sourceMappingURL=interactions.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"interactions.js","names":["isFocusVisible","getIsFocusVisible","useFocusVisibleListener","getActiveElement","getOwnerDocument","useRef","useState","useFocus","reactAriaUseFocus","useLayoutEffect","t0","$","_c","onlyVisible","undefined","isFocused","setIsFocused","setIsFocusVisible","focusedElementRef","t1","Symbol","for","element","current","dropLostFocus","t2","focusVisibleRef","isListening","t3","t4","visible","t5","t6","onFocus","event","target","onBlur","onFocusChange","focused","focusProps","t7","t8"],"sources":["../../../src/utils/react/interactions.ts"],"sourcesContent":["import {\n  isFocusVisible as getIsFocusVisible,\n  useFocusVisibleListener,\n} from '@react-aria/interactions';\nimport { getActiveElement, getOwnerDocument } from '@react-aria/utils';\nimport { useRef, useState } from 'react';\nimport { useFocus as reactAriaUseFocus } from 'react-aria';\n\nimport { useLayoutEffect } from './useLayoutEffect';\n\n/**\n * Whether the element holds focus, disabled or not: a control that keeps\n * focus while `aria-disabled` still shows where focus is.\n */\nexport function useFocus(onlyVisible = false) {\n  let [isFocused, setIsFocused] = useState(false);\n  let [isFocusVisible, setIsFocusVisible] = useState(false);\n\n  // No blur reaches React when the focused element is replaced (a tooltip\n  // wrapper added or dropped), disabled through a `fieldset` or stripped of its\n  // tabIndex. So a focus the element no longer holds is dropped after each\n  // render of this control and, when the change came from elsewhere without\n  // re-rendering it, on the next key or pointer press React Aria reports (keys\n  // typed in a text field don't count).\n  let focusedElementRef = useRef<Element | null>(null);\n\n  let dropLostFocus = () => {\n    let element = focusedElementRef.current;\n\n    // React Aria's own check, which also looks inside a shadow root.\n    if (element && element !== getActiveElement(getOwnerDocument(element))) {\n      focusedElementRef.current = null;\n      setIsFocused(false);\n    }\n  };\n\n  // Keep the listener's value, not the raw global modality: react-aria ignores keys\n  // typed in a text input, so focus moved after typing there shows no ring.\n  let focusVisibleRef = useRef(getIsFocusVisible());\n  // Only a focused element takes it into state: updating state on every button\n  // re-rendered all of them on each keyboard/pointer switch.\n  let isListening = onlyVisible && isFocused;\n\n  useFocusVisibleListener(\n    (visible) => {\n      focusVisibleRef.current = visible;\n      dropLostFocus();\n\n      if (isListening) {\n        setIsFocusVisible(visible);\n      }\n    },\n    [isListening],\n  );\n\n  useLayoutEffect(() => {\n    dropLostFocus();\n  });\n\n  let { focusProps } = reactAriaUseFocus({\n    onFocus: (event) => {\n      focusedElementRef.current = event.target;\n    },\n    onBlur: () => {\n      focusedElementRef.current = null;\n    },\n    onFocusChange: (focused) => {\n      setIsFocused(focused);\n\n      if (focused) {\n        setIsFocusVisible(focusVisibleRef.current);\n      }\n    },\n  });\n\n  return {\n    focusProps,\n    isFocused: isFocused && (onlyVisible ? isFocusVisible : true),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,SAAOO,WAAAG,IAAA;CAAA,MAAAC,IAAAC,EAAA,GAAA;CAAkB,MAAAC,cAAAH,OAAAI,SAAA,QAAAJ;CACvB,MAAA,CAAAK,WAAAC,gBAAgCV,SAAS,MAAM;CAC/C,MAAA,CAAAN,kBAAAiB,qBAA0CX,SAAS,MAAM;CAQzD,MAAAY,oBAAwBb,OAAuB,KAAK;CAAC,IAAAc;AAAA,KAAAR,EAAA,OAAAS,OAAAC,IAAA,4BAAA,EAAA;AAEjCF,aAAA;GAClB,MAAAG,UAAcJ,kBAAiBK;AAG/B,OAAID,WAAWA,YAAYnB,iBAAiBC,iBAAiBkB,QAAQ,CAAC,EAAA;AACpEJ,sBAAiBK,UAAW;AAC5BP,iBAAa,MAAM;;;AAEtBL,IAAA,KAAAQ;OAAAA,MAAAR,EAAA;CARD,MAAAa,gBAAoBL;CAQlB,IAAAM;AAAA,KAAAd,EAAA,OAAAS,OAAAC,IAAA,4BAAA,EAAA;AAI2BI,OAAAxB,gBAAmB;AAAAU,IAAA,KAAAc;OAAAA,MAAAd,EAAA;CAAhD,MAAAe,kBAAsBrB,OAAOoB,GAAoB;CAGjD,MAAAE,cAAkBd,eAAAE;CAAyB,IAAAa;CAAA,IAAAC;AAAA,KAAAlB,EAAA,OAAAgB,aAAA;AAGzCC,QAAAE,YAAA;AACEJ,mBAAeH,UAAWO;AAC1BN,kBAAe;AAEf,OAAIG,YACFV,mBAAkBa,QAAQ;;AAG9BD,OAAA,CAACF,YAAY;AAAAhB,IAAA,KAAAgB;AAAAhB,IAAA,KAAAiB;AAAAjB,IAAA,KAAAkB;QAAA;AAAAD,OAAAjB,EAAA;AAAAkB,OAAAlB,EAAA;;AATfT,yBACE0B,IAQAC,GACD;CAAA,IAAAE;AAAA,KAAApB,EAAA,OAAAS,OAAAC,IAAA,4BAAA,EAAA;AAEeU,aAAA;AACdP,kBAAe;;AAChBb,IAAA,KAAAoB;OAAAA,MAAApB,EAAA;AAFDF,mBAAgBsB,GAEd;CAAA,IAAAC;AAAA,KAAArB,EAAA,OAAAS,OAAAC,IAAA,4BAAA,EAAA;AAEqCW,OAAA;GAAAC,UAC5BC,UAAA;AACPhB,sBAAiBK,UAAWW,MAAKC;;GAClCC,cACO;AACNlB,sBAAiBK,UAAW;;GAC7Bc,gBACcC,YAAA;AACbtB,iBAAasB,QAAQ;AAErB,QAAIA,QACFrB,mBAAkBS,gBAAeH,QAAS;;GAG/C;AAAAZ,IAAA,KAAAqB;OAAAA,MAAArB,EAAA;CAdD,MAAA,EAAA4B,eAAqB/B,SAAkBwB,GAcrC;CAIW,MAAAQ,KAAAzB,cAAcF,cAAAb,mBAAA;CAAoC,IAAAyC;AAAA,KAAA9B,EAAA,OAAA4B,cAAA5B,EAAA,OAAA6B,IAAA;AAFxDC,OAAA;GAAAF;GAAAxB,WAEMyB;GACZ;AAAA7B,IAAA,KAAA4B;AAAA5B,IAAA,KAAA6B;AAAA7B,IAAA,KAAA8B;OAAAA,MAAA9B,EAAA;AAAA,QAHM8B"}
+{"version":3,"file":"interactions.js","names":["isFocusVisible","getIsFocusVisible","useFocusVisibleListener","getActiveElement","getOwnerDocument","useRef","useState","useFocus","reactAriaUseFocus","useLayoutEffect","t0","$","_c","onlyVisible","undefined","isFocused","setIsFocused","setIsFocusVisible","focusedElementRef","t1","Symbol","for","element","current","dropLostFocus","t2","focusVisibleRef","isListening","t3","t4","visible","t5","t6","onFocus","event","target","onBlur","onFocusChange","focused","focusProps","t7","t8","useFocus","_c","isFocusVisible","getIsFocusVisible","reactAriaUseFocus"],"sources":["../../../src/utils/react/interactions.ts"],"sourcesContent":["import {\n  isFocusVisible as getIsFocusVisible,\n  useFocusVisibleListener,\n} from '@react-aria/interactions';\nimport { getActiveElement, getOwnerDocument } from '@react-aria/utils';\nimport { useRef, useState } from 'react';\nimport { useFocus as reactAriaUseFocus } from 'react-aria';\n\nimport { useLayoutEffect } from './useLayoutEffect';\n\n/**\n * Whether the element holds focus, disabled or not: a control that keeps\n * focus while `aria-disabled` still shows where focus is.\n */\nexport function useFocus(onlyVisible = false) {\n  let [isFocused, setIsFocused] = useState(false);\n  let [isFocusVisible, setIsFocusVisible] = useState(false);\n\n  // No blur reaches React when the focused element is replaced (a tooltip\n  // wrapper added or dropped), disabled through a `fieldset` or stripped of its\n  // tabIndex. So a focus the element no longer holds is dropped after each\n  // render of this control and, when the change came from elsewhere without\n  // re-rendering it, on the next key or pointer press React Aria reports (keys\n  // typed in a text field don't count).\n  let focusedElementRef = useRef<Element | null>(null);\n\n  let dropLostFocus = () => {\n    let element = focusedElementRef.current;\n\n    // React Aria's own check, which also looks inside a shadow root.\n    if (element && element !== getActiveElement(getOwnerDocument(element))) {\n      focusedElementRef.current = null;\n      setIsFocused(false);\n    }\n  };\n\n  // Keep the listener's value, not the raw global modality: react-aria ignores keys\n  // typed in a text input, so focus moved after typing there shows no ring.\n  let focusVisibleRef = useRef(getIsFocusVisible());\n  // Only a focused element takes it into state: updating state on every button\n  // re-rendered all of them on each keyboard/pointer switch.\n  let isListening = onlyVisible && isFocused;\n\n  useFocusVisibleListener(\n    (visible) => {\n      focusVisibleRef.current = visible;\n      dropLostFocus();\n\n      if (isListening) {\n        setIsFocusVisible(visible);\n      }\n    },\n    [isListening],\n  );\n\n  useLayoutEffect(() => {\n    dropLostFocus();\n  });\n\n  let { focusProps } = reactAriaUseFocus({\n    onFocus: (event) => {\n      focusedElementRef.current = event.target;\n    },\n    onBlur: () => {\n      focusedElementRef.current = null;\n    },\n    onFocusChange: (focused) => {\n      setIsFocused(focused);\n\n      if (focused) {\n        setIsFocusVisible(focusVisibleRef.current);\n      }\n    },\n  });\n\n  return {\n    focusProps,\n    isFocused: isFocused && (onlyVisible ? isFocusVisible : true),\n  };\n}\n"],"mappings":";;;;;;;;;;;;AAcA,SAAOO,WAAAG,IAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAAkB,MAAAC,cAAAH,OAAAI,KAAAA,IAAA,QAAAJ;CACvB,MAAA,CAAAK,WAAAC,gBAAgCV,SAAS,KAAK;CAC9C,MAAA,CAAAN,kBAAAiB,qBAA0CX,SAAS,KAAK;CAQxD,MAAAY,oBAAwBb,OAAuB,IAAI;CAAE,IAAAc;CAAA,IAAAR,EAAA,OAAAS,OAAAC,IAAA,2BAAA,GAAA;EAEjCF,WAAA;GAClB,MAAAG,UAAcJ,kBAAiBK;GAG/B,IAAID,WAAWA,YAAYnB,iBAAiBC,iBAAiBkB,OAAO,CAAC,GAAC;IACpEJ,kBAAiBK,UAAW;IAC5BP,aAAa,KAAK;GAAC;EACpB;EACFL,EAAA,KAAAQ;CAAA,OAAAA,KAAAR,EAAA;CARD,MAAAa,gBAAoBL;CAQlB,IAAAM;CAAA,IAAAd,EAAA,OAAAS,OAAAC,IAAA,2BAAA,GAAA;EAI2BI,KAAAxB,eAAkB;EAACU,EAAA,KAAAc;CAAA,OAAAA,KAAAd,EAAA;CAAhD,MAAAe,kBAAsBrB,OAAOoB,EAAmB;CAGhD,MAAAE,cAAkBd,eAAAE;CAAyB,IAAAa;CAAA,IAAAC;CAAA,IAAAlB,EAAA,OAAAgB,aAAA;EAGzCC,MAAAE,YAAA;GACEJ,gBAAeH,UAAWO;GAC1BN,cAAc;GAEd,IAAIG,aACFV,kBAAkBa,OAAO;EAC1B;EAEHD,KAAA,CAACF,WAAW;EAAChB,EAAA,KAAAgB;EAAAhB,EAAA,KAAAiB;EAAAjB,EAAA,KAAAkB;CAAA,OAAA;EAAAD,KAAAjB,EAAA;EAAAkB,KAAAlB,EAAA;CAAA;CATfT,wBACE0B,IAQAC,EACF;CAAC,IAAAE;CAAA,IAAApB,EAAA,OAAAS,OAAAC,IAAA,2BAAA,GAAA;EAEeU,WAAA;GACdP,cAAc;EAAC;EAChBb,EAAA,KAAAoB;CAAA,OAAAA,KAAApB,EAAA;CAFDF,kBAAgBsB,EAEf;CAAC,IAAAC;CAAA,IAAArB,EAAA,OAAAS,OAAAC,IAAA,2BAAA,GAAA;EAEqCW,KAAA;GAAAC,UAC5BC,UAAA;IACPhB,kBAAiBK,UAAWW,MAAKC;GAAR;GAC1BC,cACO;IACNlB,kBAAiBK,UAAW;GAAH;GAC1Bc,gBACcC,YAAA;IACbtB,aAAasB,OAAO;IAEpB,IAAIA,SACFrB,kBAAkBS,gBAAeH,OAAQ;GAC1C;EAEL;EAACZ,EAAA,KAAAqB;CAAA,OAAAA,KAAArB,EAAA;CAdD,MAAA,EAAA4B,eAAqB/B,SAAkBwB,EActC;CAIY,MAAAQ,KAAAzB,cAAcF,cAAAb,mBAAA;CAAoC,IAAAyC;CAAA,IAAA9B,EAAA,OAAA4B,cAAA5B,EAAA,OAAA6B,IAAA;EAFxDC,KAAA;GAAAF;GAAAxB,WAEMyB;EACb;EAAC7B,EAAA,KAAA4B;EAAA5B,EAAA,KAAA6B;EAAA7B,EAAA,KAAA8B;CAAA,OAAAA,KAAA9B,EAAA;CAAA,OAHM8B;AAGN"}

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

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

package/dist/utils/react/isTextOnly.js

@@ -1,11 +1,10 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.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

@@ -1 +1 @@
-{"version":3,"file":"isTextOnly.js","names":["Children","isValidElement","isTextOnly","children","toArray","every","c"],"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,SAAgBE,WAAWC,UAAU;AACnC,QAAOH,SAASI,QAAQD,SAAS,CAACE,OAAOC,MAAM,CAACL,eAAeK,EAAE,CAAC"}
+{"version":3,"file":"isTextOnly.js","names":["Children","isValidElement","isTextOnly","children","toArray","every","c"],"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,SAAgBE,WAAWC,UAAU;CACnC,OAAOH,SAASI,QAAQD,QAAQ,CAAC,CAACE,OAAOC,MAAM,CAACL,eAAeK,CAAC,CAAC;AACnE"}

package/dist/utils/react/mapProps.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"mapProps.js","names":["AriaButtonProps","CubeButtonProps","ariaToCubeButtonProps","props","Omit","Pick","type","filteredProps","htmlType","cubeToAriaButtonProps"],"sources":["../../../src/utils/react/mapProps.ts"],"sourcesContent":["import { AriaButtonProps } from 'react-aria';\n\nimport { CubeButtonProps } from '../../components/actions/Button/Button';\n\n/** Converts AriaButtonProps to CubeButtonProps */\nexport function ariaToCubeButtonProps(\n  props: AriaButtonProps<'button'>,\n): Omit<AriaButtonProps<'button'>, 'type'> & Pick<CubeButtonProps, 'htmlType'> {\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  // Cube's handlers target its supported HTML elements; Aria declares the\n  // same events against a broader Element/FocusableElement boundary.\n  return {\n    ...filteredProps,\n    type: htmlType,\n  } as AriaButtonProps<'button'>;\n}\n"],"mappings":";;;AAKA,SAAgBE,sBACdC,OAC6E;CAC7E,MAAM,EAAEG,MAAM,GAAGC,kBAAkBJ;AAEnC,QAAO;EACL,GAAGI;EACHC,UAAUF;EACX"}
+{"version":3,"file":"mapProps.js","names":["AriaButtonProps","CubeButtonProps","ariaToCubeButtonProps","props","Omit","Pick","type","filteredProps","htmlType","cubeToAriaButtonProps"],"sources":["../../../src/utils/react/mapProps.ts"],"sourcesContent":["import { AriaButtonProps } from 'react-aria';\n\nimport { CubeButtonProps } from '../../components/actions/Button/Button';\n\n/** Converts AriaButtonProps to CubeButtonProps */\nexport function ariaToCubeButtonProps(\n  props: AriaButtonProps<'button'>,\n): Omit<AriaButtonProps<'button'>, 'type'> & Pick<CubeButtonProps, 'htmlType'> {\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  // Cube's handlers target its supported HTML elements; Aria declares the\n  // same events against a broader Element/FocusableElement boundary.\n  return {\n    ...filteredProps,\n    type: htmlType,\n  } as AriaButtonProps<'button'>;\n}\n"],"mappings":";;;AAKA,SAAgBE,sBACdC,OAC6E;CAC7E,MAAM,EAAEG,MAAM,GAAGC,kBAAkBJ;CAEnC,OAAO;EACL,GAAGI;EACHC,UAAUF;CACZ;AACF"}

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

@@ -1,6 +1,5 @@
 
 import { Props } from "../../props.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;
 /**
@@ -10,7 +9,7 @@ type Merge<T> = T extends [infer F, ...infer R] ? F extends undefined ? Merge<R>
  * 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;
+export declare function mergeProps<T extends (Props | undefined)[], K = Merge<T>>(...args: T): K;
 //#endregion
-export { mergeProps };
+export {};
 //# sourceMappingURL=mergeProps.d.ts.map

package/dist/utils/react/mergeProps.js

@@ -1,9 +1,8 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { chain } from "./chain.js";
 import { mergeIds } from "./useId.js";
 import { mergeStyles } from "@tenphi/tasty";
 import clsx from "clsx";
-
 //#region src/utils/react/mergeProps.tsx
 /**
 * Merges multiple props objects together. Event handlers are chained,
@@ -28,7 +27,7 @@ function mergeProps(...args) {
 	}
 	return result;
 }
-
 //#endregion
 export { mergeProps };
+
 //# sourceMappingURL=mergeProps.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"mergeProps.js","names":["mergeStyles","clsx","chain","mergeIds","Props","Merge","T","F","R","L","mergeProps","args","K","result","props","key","test","className","endsWith","styles","mods","id","undefined"],"sources":["../../../src/utils/react/mergeProps.tsx"],"sourcesContent":["import { mergeStyles } from '@tenphi/tasty';\nimport clsx from 'clsx';\n\nimport { chain } from './chain';\nimport { mergeIds } from './useId';\n\nimport type { Props } from '../../props';\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":";;;;;;;;;;;;;;AAuBA,SAAgBU,WACd,GAAGC,MACA;CACH,IAAIE,SAAc,EAAE;AAEpB,MAAK,IAAIC,SAASH,MAAM;AACtB,OAAK,IAAII,OAAOF,OAEd,KACE,WAAWG,KAAKD,IAAI,IACpB,OAAOF,OAAOE,SAAS,cACvBD,SACA,OAAOA,MAAMC,SAAS,WAEtBF,QAAOE,OAAOb,MAAMW,OAAOE,MAAMD,MAAMC,KAAK;WAI5CA,QAAQ,eACR,OAAOF,OAAOI,cAAc,YAC5BH,SACA,OAAOA,MAAMG,cAAc,SAE3BJ,QAAOE,OAAOd,KAAKY,OAAOI,WAAWH,MAAMG,UAAU;YAEpDF,QAAQ,YAAYA,IAAIG,SAAS,SAAS,KAC3C,OAAOL,OAAOM,WAAW,YACzBL,SACA,OAAOA,MAAMK,WAAW,SAExBN,QAAOE,OAAOf,YAAYa,OAAOE,MAAMD,MAAMC,KAAK;WACzCA,QAAQ,UAAUF,OAAOO,QAAQN,OAAOM,KACjDP,QAAOO,OAAO;GAAE,GAAGP,OAAOO;GAAM,GAAGN,OAAOM;GAAM;WACvCL,QAAQ,QAAQF,OAAOQ,MAAMP,OAAOO,GAC7CR,QAAOQ,KAAKlB,SAASU,OAAOQ,IAAIP,OAAOO,GAAG;MAG1CR,QAAOE,OACLD,SAASA,MAAMC,SAASO,SAAYR,MAAMC,OAAOF,OAAOE;AAK9D,OAAK,IAAIA,OAAOD,MACd,KAAID,OAAOE,SAASO,OAClBT,QAAOE,OAAOD,MAAMC;;AAK1B,QAAOF"}
+{"version":3,"file":"mergeProps.js","names":["mergeStyles","clsx","chain","mergeIds","Props","Merge","T","F","R","L","mergeProps","args","K","result","props","key","test","className","endsWith","styles","mods","id","undefined"],"sources":["../../../src/utils/react/mergeProps.tsx"],"sourcesContent":["import { mergeStyles } from '@tenphi/tasty';\nimport clsx from 'clsx';\n\nimport { chain } from './chain';\nimport { mergeIds } from './useId';\n\nimport type { Props } from '../../props';\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":";;;;;;;;;;;;;AAuBA,SAAgBU,WACd,GAAGC,MACA;CACH,IAAIE,SAAc,CAAC;CAEnB,KAAK,IAAIC,SAASH,MAAM;EACtB,KAAK,IAAII,OAAOF,QAEd,IACE,WAAWG,KAAKD,GAAG,KACnB,OAAOF,OAAOE,SAAS,cACvBD,SACA,OAAOA,MAAMC,SAAS,YAEtBF,OAAOE,OAAOb,MAAMW,OAAOE,MAAMD,MAAMC,IAAI;OAGtC,IACLA,QAAQ,eACR,OAAOF,OAAOI,cAAc,YAC5BH,SACA,OAAOA,MAAMG,cAAc,UAE3BJ,OAAOE,OAAOd,KAAKY,OAAOI,WAAWH,MAAMG,SAAS;OAC/C,KACJF,QAAQ,YAAYA,IAAIG,SAAS,QAAQ,MAC1C,OAAOL,OAAOM,WAAW,YACzBL,SACA,OAAOA,MAAMK,WAAW,UAExBN,OAAOE,OAAOf,YAAYa,OAAOE,MAAMD,MAAMC,IAAI;OAC5C,IAAIA,QAAQ,UAAUF,OAAOO,QAAQN,OAAOM,MACjDP,OAAOO,OAAO;GAAE,GAAGP,OAAOO;GAAM,GAAGN,OAAOM;EAAK;OAC1C,IAAIL,QAAQ,QAAQF,OAAOQ,MAAMP,OAAOO,IAC7CR,OAAOQ,KAAKlB,SAASU,OAAOQ,IAAIP,OAAOO,EAAE;OAGzCR,OAAOE,OACLD,SAASA,MAAMC,SAASO,KAAAA,IAAYR,MAAMC,OAAOF,OAAOE;EAK9D,KAAK,IAAIA,OAAOD,OACd,IAAID,OAAOE,SAASO,KAAAA,GAClBT,OAAOE,OAAOD,MAAMC;CAG1B;CAEA,OAAOF;AACT"}

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

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

package/dist/utils/react/nullableValue.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 //#region src/utils/react/nullableValue.ts
 function castNullableStringValue(props, emptyValue = "") {
 	return castNullableField(props, ["value", "defaultValue"], "string", (v) => String(v), emptyValue);
@@ -32,7 +32,7 @@ function castNullableField(props, keys, type, cast, emptyValue) {
 	});
 	return props;
 }
-
 //#endregion
-export { castNullableArrayValue, castNullableIsSelected, castNullableNumberValue, castNullableStringValue };
+export { castNullableArrayValue, castNullableField, castNullableIsSelected, castNullableNumberValue, castNullableStringValue };
+
 //# sourceMappingURL=nullableValue.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"nullableValue.js","names":["Props","castNullableStringValue","props","T","emptyValue","castNullableField","v","String","castNullableNumberValue","Number","NaN","castNullableArrayValue","Array","isArray","castNullableIsSelected","castNullableSelectedKey","keys","type","cast","k","forEach","key","index","undefined","console","warn","JSON","stringify","WithNullableValue","Omit","value","defaultValue","WithNullableSelected","isSelected","defaultSelected","WithNullableSelectedKey","selectedKey","defaultSelectedKey"],"sources":["../../../src/utils/react/nullableValue.ts"],"sourcesContent":["import type { Props } from '../../props';\n\n// Each value helper turns a controlled `null` into the control's own empty\n// value, so `null` means \"controlled, no value\"; see `castNullableField`.\n\nexport function castNullableStringValue<T>(\n  props: T,\n  /** `null` for controls whose state takes it, such as a radio group. */\n  emptyValue: string | null = '',\n): T {\n  return castNullableField(\n    props,\n    ['value', 'defaultValue'],\n    'string',\n    (v) => String(v),\n    emptyValue,\n  );\n}\n\nexport function castNullableNumberValue<T>(props: T): T {\n  return castNullableField(\n    props,\n    ['value', 'defaultValue'],\n    'number',\n    (v) => Number(v),\n    NaN,\n  );\n}\n\nexport function castNullableArrayValue<T>(props: T): T {\n  return castNullableField(\n    props,\n    ['value', 'defaultValue'],\n    'object',\n    (v) => (Array.isArray(v) ? v : []),\n    [],\n  );\n}\n\nexport function castNullableIsSelected<T>(props: T): T {\n  return castNullableField(\n    props,\n    ['isSelected', 'defaultSelected'],\n    'boolean',\n    (v) => !!v,\n    false,\n  );\n}\n\nexport function castNullableSelectedKey<T>(props: T): T {\n  return castNullableField(props, ['selectedKey', 'defaultSelectedKey']);\n}\n\n/**\n * Replaces `null` in `keys` and casts a value of the wrong `type`.\n *\n * The first key is the controlled one, and its `null` becomes `emptyValue`. Pass the control's own\n * empty value (`''`, `NaN`, `[]`, or `null` where React Stately takes it) so that `null` means\n * \"controlled, no value\": the field stays controlled and clears. Left out, `null` becomes\n * `undefined`, which switches the control to uncontrolled mode and keeps its last value on screen.\n * `null` in the other keys (`defaultValue`) always becomes `undefined`.\n */\nexport function castNullableField<T>(\n  props: T,\n  keys: string[],\n  type?: string,\n  cast?: (k: any) => any,\n  emptyValue?: unknown,\n): T {\n  props = { ...props };\n\n  keys.forEach((key, index) => {\n    if (props[key] === null) {\n      props[key] = index === 0 ? emptyValue : 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\n// Values are intentionally permissive: the helpers above coerce input models.\n// A generic indexed access unioned with `any` has the same type, but declaration\n// emit can inline its type parameter outside the generic scope.\nexport type WithNullableValue<T extends Props> = Omit<\n  T,\n  'value' | 'defaultValue'\n> & {\n  value?: any;\n  defaultValue?: any;\n};\n\nexport type WithNullableSelected<T extends Props> = Omit<\n  T,\n  'isSelected' | 'defaultSelected'\n> & {\n  isSelected?: any;\n  defaultSelected?: any;\n};\n\nexport type WithNullableSelectedKey<T extends Props> = Omit<\n  T,\n  'selectedKey' | 'defaultSelectedKey'\n> & {\n  selectedKey?: any;\n  defaultSelectedKey?: any;\n};\n"],"mappings":";;AAKA,SAAgBC,wBACdC,OAEAE,aAA4B,IACzB;AACH,QAAOC,kBACLH,OACA,CAAC,SAAS,eAAe,EACzB,WACCI,MAAMC,OAAOD,EAAE,EAChBF,WACD;;AAGH,SAAgBI,wBAA2BN,OAAa;AACtD,QAAOG,kBACLH,OACA,CAAC,SAAS,eAAe,EACzB,WACCI,MAAMG,OAAOH,EAAE,EAChBI,IACD;;AAGH,SAAgBC,uBAA0BT,OAAa;AACrD,QAAOG,kBACLH,OACA,CAAC,SAAS,eAAe,EACzB,WACCI,MAAOM,MAAMC,QAAQP,EAAE,GAAGA,IAAI,EAAG,EAClC,EACF,CAAC;;AAGH,SAAgBQ,uBAA0BZ,OAAa;AACrD,QAAOG,kBACLH,OACA,CAAC,cAAc,kBAAkB,EACjC,YACCI,MAAM,CAAC,CAACA,GACT,MACD;;;;;;;;;;;AAgBH,SAAgBD,kBACdH,OACAc,MACAC,MACAC,MACAd,YACG;AACHF,SAAQ,EAAE,GAAGA,OAAO;AAEpBc,MAAKI,SAASC,KAAKC,UAAU;AAC3B,MAAIpB,MAAMmB,SAAS,KACjBnB,OAAMmB,OAAOC,UAAU,IAAIlB,aAAamB;AAG1C,MAAIN,QAAQC,QAAQhB,MAAMmB,QAAQ,QAAQ,OAAOnB,MAAMmB,QAAQJ,MAAM;AACnEf,SAAMmB,OAAOH,KAAKhB,MAAMmB,KAAK;AAE7BG,WAAQC,KACN,uBACAvB,OACA,WACAwB,KAAKC,UAAUX,KACjB,CAAC;;GAEH;AAEF,QAAOd"}
+{"version":3,"file":"nullableValue.js","names":["Props","castNullableStringValue","props","T","emptyValue","castNullableField","v","String","castNullableNumberValue","Number","NaN","castNullableArrayValue","Array","isArray","castNullableIsSelected","castNullableSelectedKey","keys","type","cast","k","forEach","key","index","undefined","console","warn","JSON","stringify","WithNullableValue","Omit","value","defaultValue","WithNullableSelected","isSelected","defaultSelected","WithNullableSelectedKey","selectedKey","defaultSelectedKey"],"sources":["../../../src/utils/react/nullableValue.ts"],"sourcesContent":["import type { Props } from '../../props';\n\n// Each value helper turns a controlled `null` into the control's own empty\n// value, so `null` means \"controlled, no value\"; see `castNullableField`.\n\nexport function castNullableStringValue<T>(\n  props: T,\n  /** `null` for controls whose state takes it, such as a radio group. */\n  emptyValue: string | null = '',\n): T {\n  return castNullableField(\n    props,\n    ['value', 'defaultValue'],\n    'string',\n    (v) => String(v),\n    emptyValue,\n  );\n}\n\nexport function castNullableNumberValue<T>(props: T): T {\n  return castNullableField(\n    props,\n    ['value', 'defaultValue'],\n    'number',\n    (v) => Number(v),\n    NaN,\n  );\n}\n\nexport function castNullableArrayValue<T>(props: T): T {\n  return castNullableField(\n    props,\n    ['value', 'defaultValue'],\n    'object',\n    (v) => (Array.isArray(v) ? v : []),\n    [],\n  );\n}\n\nexport function castNullableIsSelected<T>(props: T): T {\n  return castNullableField(\n    props,\n    ['isSelected', 'defaultSelected'],\n    'boolean',\n    (v) => !!v,\n    false,\n  );\n}\n\nexport function castNullableSelectedKey<T>(props: T): T {\n  return castNullableField(props, ['selectedKey', 'defaultSelectedKey']);\n}\n\n/**\n * Replaces `null` in `keys` and casts a value of the wrong `type`.\n *\n * The first key is the controlled one, and its `null` becomes `emptyValue`. Pass the control's own\n * empty value (`''`, `NaN`, `[]`, or `null` where React Stately takes it) so that `null` means\n * \"controlled, no value\": the field stays controlled and clears. Left out, `null` becomes\n * `undefined`, which switches the control to uncontrolled mode and keeps its last value on screen.\n * `null` in the other keys (`defaultValue`) always becomes `undefined`.\n */\nexport function castNullableField<T>(\n  props: T,\n  keys: string[],\n  type?: string,\n  cast?: (k: any) => any,\n  emptyValue?: unknown,\n): T {\n  props = { ...props };\n\n  keys.forEach((key, index) => {\n    if (props[key] === null) {\n      props[key] = index === 0 ? emptyValue : 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\n// Values are intentionally permissive: the helpers above coerce input models.\n// A generic indexed access unioned with `any` has the same type, but declaration\n// emit can inline its type parameter outside the generic scope.\nexport type WithNullableValue<T extends Props> = Omit<\n  T,\n  'value' | 'defaultValue'\n> & {\n  value?: any;\n  defaultValue?: any;\n};\n\nexport type WithNullableSelected<T extends Props> = Omit<\n  T,\n  'isSelected' | 'defaultSelected'\n> & {\n  isSelected?: any;\n  defaultSelected?: any;\n};\n\nexport type WithNullableSelectedKey<T extends Props> = Omit<\n  T,\n  'selectedKey' | 'defaultSelectedKey'\n> & {\n  selectedKey?: any;\n  defaultSelectedKey?: any;\n};\n"],"mappings":";;AAKA,SAAgBC,wBACdC,OAEAE,aAA4B,IACzB;CACH,OAAOC,kBACLH,OACA,CAAC,SAAS,cAAc,GACxB,WACCI,MAAMC,OAAOD,CAAC,GACfF,UACF;AACF;AAEA,SAAgBI,wBAA2BN,OAAa;CACtD,OAAOG,kBACLH,OACA,CAAC,SAAS,cAAc,GACxB,WACCI,MAAMG,OAAOH,CAAC,GACfI,GACF;AACF;AAEA,SAAgBC,uBAA0BT,OAAa;CACrD,OAAOG,kBACLH,OACA,CAAC,SAAS,cAAc,GACxB,WACCI,MAAOM,MAAMC,QAAQP,CAAC,IAAIA,IAAI,CAAA,GAC/B,CAAA,CACF;AACF;AAEA,SAAgBQ,uBAA0BZ,OAAa;CACrD,OAAOG,kBACLH,OACA,CAAC,cAAc,iBAAiB,GAChC,YACCI,MAAM,CAAC,CAACA,GACT,KACF;AACF;;;;;;;;;;AAeA,SAAgBD,kBACdH,OACAc,MACAC,MACAC,MACAd,YACG;CACHF,QAAQ,EAAE,GAAGA,MAAM;CAEnBc,KAAKI,SAASC,KAAKC,UAAU;EAC3B,IAAIpB,MAAMmB,SAAS,MACjBnB,MAAMmB,OAAOC,UAAU,IAAIlB,aAAamB,KAAAA;EAG1C,IAAIN,QAAQC,QAAQhB,MAAMmB,QAAQ,QAAQ,OAAOnB,MAAMmB,QAAQJ,MAAM;GACnEf,MAAMmB,OAAOH,KAAKhB,MAAMmB,IAAI;GAE5BG,QAAQC,KACN,uBACAvB,OACA,WACAwB,KAAKC,UAAUX,IAAI,CACrB;EACF;CACF,CAAC;CAED,OAAOd;AACT"}

package/dist/utils/react/overlayKeyPropagation.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 //#region src/utils/react/overlayKeyPropagation.ts
 /**
 * Keys whose final handling belongs to the overlay around a control, not to
@@ -7,7 +7,7 @@
 * the document, so a `Tab` held here left a Dialog's first or last control
 * unable to wrap (CUB-5603).
 */
-const OVERLAY_KEYS = new Set(["Escape", "Tab"]);
+const OVERLAY_KEYS = /* @__PURE__ */ new Set(["Escape", "Tab"]);
 /**
 * Let `Escape` and `Tab` keep travelling out of a trigger or list, and hold
 * every other key exactly as before.
@@ -40,7 +40,7 @@ function allowOverlayKeysToPropagate(event) {
 	}
 	if (!isOverlayKey) event.stopPropagation();
 }
-
 //#endregion
 export { allowOverlayKeysToPropagate };
+
 //# sourceMappingURL=overlayKeyPropagation.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"overlayKeyPropagation.js","names":["KeyboardEvent","MaybeAugmentedKeyboardEvent","continuePropagation","isPropagationStopped","OVERLAY_KEYS","Set","allowOverlayKeysToPropagate","event","isOverlayKey","has","key","stopPropagation"],"sources":["../../../src/utils/react/overlayKeyPropagation.ts"],"sourcesContent":["import type { KeyboardEvent } from 'react';\n\n/**\n * A key event as it reaches a handler that may or may not have been wrapped by\n * React Aria's `useKeyboard`.\n */\ntype MaybeAugmentedKeyboardEvent = KeyboardEvent<any> & {\n  continuePropagation?: () => void;\n  isPropagationStopped?: () => boolean;\n};\n\n/**\n * Keys whose final handling belongs to the overlay around a control, not to\n * the control. `Escape` dismisses it (CUB-4839). `Tab` is how its `FocusScope`\n * keeps focus inside: React Aria contains focus from a `keydown` listener on\n * the document, so a `Tab` held here left a Dialog's first or last control\n * unable to wrap (CUB-5603).\n */\nconst OVERLAY_KEYS = new Set(['Escape', 'Tab']);\n\n/**\n * Let `Escape` and `Tab` keep travelling out of a trigger or list, and hold\n * every other key exactly as before.\n *\n * Every other key stays contained: releasing them too would let `Enter` and\n * typeahead reach ancestor shortcuts and form submits, which callers have\n * always had held here.\n *\n * Shape-aware because the same `onKeyDown` is reached two ways and the DEFAULT\n * is opposite between them:\n *\n * - Wrapped by `useKeyboard`, the event is augmented and propagation is\n *   stopped unless the handler opts out. `createEventHandler` also keeps that\n *   decision for the LIFE of the handler rather than per event — nothing\n *   resets it when the next key arrives — so an earlier opt-out would keep\n *   releasing later keys until a render replaced the handler. Re-asserting the\n *   default here is what keeps the opt-out from outliving its own event.\n * - Spread straight onto an element, the event is an ordinary React one and\n *   propagation is the default, so containment is what has to be asked for.\n *\n * Getting this backwards is silent in one direction and loud in the other:\n * calling `stopPropagation()` on a plain event really does stop it.\n */\nexport function allowOverlayKeysToPropagate(\n  event: MaybeAugmentedKeyboardEvent,\n) {\n  const isOverlayKey = OVERLAY_KEYS.has(event.key);\n\n  if (typeof event.continuePropagation === 'function') {\n    if (isOverlayKey) {\n      event.continuePropagation();\n    } else if (event.isPropagationStopped?.() === false) {\n      // Only ever called when the flag is already clear, which is the one case\n      // `stopPropagation` does not warn about.\n      event.stopPropagation();\n    }\n\n    return;\n  }\n\n  if (!isOverlayKey) event.stopPropagation();\n}\n"],"mappings":";;;;;;;;;AAkBA,MAAMI,eAAe,IAAIC,IAAI,CAAC,UAAU,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;AAyB/C,SAAgBC,4BACdC,OACA;CACA,MAAMC,eAAeJ,aAAaK,IAAIF,MAAMG,IAAI;AAEhD,KAAI,OAAOH,MAAML,wBAAwB,YAAY;AACnD,MAAIM,aACFD,OAAML,qBAAqB;WAClBK,MAAMJ,wBAAwB,KAAK,MAG5CI,OAAMI,iBAAiB;AAGzB;;AAGF,KAAI,CAACH,aAAcD,OAAMI,iBAAiB"}
+{"version":3,"file":"overlayKeyPropagation.js","names":["KeyboardEvent","MaybeAugmentedKeyboardEvent","continuePropagation","isPropagationStopped","OVERLAY_KEYS","Set","allowOverlayKeysToPropagate","event","isOverlayKey","has","key","stopPropagation"],"sources":["../../../src/utils/react/overlayKeyPropagation.ts"],"sourcesContent":["import type { KeyboardEvent } from 'react';\n\n/**\n * A key event as it reaches a handler that may or may not have been wrapped by\n * React Aria's `useKeyboard`.\n */\ntype MaybeAugmentedKeyboardEvent = KeyboardEvent<any> & {\n  continuePropagation?: () => void;\n  isPropagationStopped?: () => boolean;\n};\n\n/**\n * Keys whose final handling belongs to the overlay around a control, not to\n * the control. `Escape` dismisses it (CUB-4839). `Tab` is how its `FocusScope`\n * keeps focus inside: React Aria contains focus from a `keydown` listener on\n * the document, so a `Tab` held here left a Dialog's first or last control\n * unable to wrap (CUB-5603).\n */\nconst OVERLAY_KEYS = new Set(['Escape', 'Tab']);\n\n/**\n * Let `Escape` and `Tab` keep travelling out of a trigger or list, and hold\n * every other key exactly as before.\n *\n * Every other key stays contained: releasing them too would let `Enter` and\n * typeahead reach ancestor shortcuts and form submits, which callers have\n * always had held here.\n *\n * Shape-aware because the same `onKeyDown` is reached two ways and the DEFAULT\n * is opposite between them:\n *\n * - Wrapped by `useKeyboard`, the event is augmented and propagation is\n *   stopped unless the handler opts out. `createEventHandler` also keeps that\n *   decision for the LIFE of the handler rather than per event — nothing\n *   resets it when the next key arrives — so an earlier opt-out would keep\n *   releasing later keys until a render replaced the handler. Re-asserting the\n *   default here is what keeps the opt-out from outliving its own event.\n * - Spread straight onto an element, the event is an ordinary React one and\n *   propagation is the default, so containment is what has to be asked for.\n *\n * Getting this backwards is silent in one direction and loud in the other:\n * calling `stopPropagation()` on a plain event really does stop it.\n */\nexport function allowOverlayKeysToPropagate(\n  event: MaybeAugmentedKeyboardEvent,\n) {\n  const isOverlayKey = OVERLAY_KEYS.has(event.key);\n\n  if (typeof event.continuePropagation === 'function') {\n    if (isOverlayKey) {\n      event.continuePropagation();\n    } else if (event.isPropagationStopped?.() === false) {\n      // Only ever called when the flag is already clear, which is the one case\n      // `stopPropagation` does not warn about.\n      event.stopPropagation();\n    }\n\n    return;\n  }\n\n  if (!isOverlayKey) event.stopPropagation();\n}\n"],"mappings":";;;;;;;;;AAkBA,MAAMI,+BAAe,IAAIC,IAAI,CAAC,UAAU,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;AAyB9C,SAAgBC,4BACdC,OACA;CACA,MAAMC,eAAeJ,aAAaK,IAAIF,MAAMG,GAAG;CAE/C,IAAI,OAAOH,MAAML,wBAAwB,YAAY;EACnD,IAAIM,cACFD,MAAML,oBAAoB;OACrB,IAAIK,MAAMJ,uBAAuB,MAAM,OAG5CI,MAAMI,gBAAgB;EAGxB;CACF;CAEA,IAAI,CAACH,cAAcD,MAAMI,gBAAgB;AAC3C"}

package/dist/utils/react/programmaticFocus.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 //#region src/utils/react/programmaticFocus.ts
 /**
 * Telling focus the user moved from focus a component moved for them.
@@ -52,7 +52,7 @@ function markFocusRestoreWindow(duration) {
 function isFocusRestoration() {
 	return depth > 0 || Date.now() < restoreWindowEndsAt;
 }
-
 //#endregion
 export { focusProgrammatically, isFocusRestoration, markFocusRestoreWindow };
+
 //# sourceMappingURL=programmaticFocus.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"programmaticFocus.js","names":["depth","restoreWindowEndsAt","focusProgrammatically","element","HTMLElement","options","FocusOptions","focus","markFocusRestoreWindow","duration","Math","max","Date","now","isFocusRestoration"],"sources":["../../../src/utils/react/programmaticFocus.ts"],"sourcesContent":["/**\n * Telling focus the user moved from focus a component moved for them.\n *\n * Handing focus back to a trigger after its overlay closes is not the same\n * event as a user tabbing onto that trigger, but the DOM cannot tell them\n * apart: `.focus()` produces an ordinary focus event, and the modality is\n * still \"keyboard\" from whatever the user just did, so anything keyed off\n * focus-visible treats it as a deliberate arrival. A trigger's tooltip pops up\n * unasked — and then absorbs the user's next `Escape` from its own\n * document-level listener (CUB-4839).\n *\n * Two mechanisms, because restoration reaches us two ways:\n *\n * - `focusProgrammatically` for restores WE perform. `focus()` dispatches\n *   `focus`/`focusin` synchronously, so a flag set around the call is readable\n *   by every handler that runs for it and gone immediately afterwards. Exact,\n *   with no window to tune.\n *\n * - `markFocusRestoreWindow` for restores React Aria performs. A `FocusScope`\n *   restores on unmount, from inside React's own commit, and offers no hook to\n *   wrap — so an overlay that is closing declares the window instead. Coarser\n *   on purpose: it can only make a tooltip skip one arrival that lands while\n *   an overlay is going away, which is the case it exists for.\n */\nlet depth = 0;\nlet restoreWindowEndsAt = 0;\n\n/**\n * Focus `element` without the UI reading it as the user arriving there.\n */\nexport function focusProgrammatically(\n  element: HTMLElement | null | undefined,\n  options?: FocusOptions,\n) {\n  if (!element) return;\n\n  depth++;\n\n  try {\n    element.focus(options);\n  } finally {\n    depth--;\n  }\n}\n\n/**\n * Declare that focus is about to be restored by machinery we cannot wrap, for\n * roughly `duration` ms. Called by a closing overlay.\n */\nexport function markFocusRestoreWindow(duration: number) {\n  restoreWindowEndsAt = Math.max(restoreWindowEndsAt, Date.now() + duration);\n}\n\n/**\n * Whether the focus being handled right now is a restoration rather than the\n * user arriving. Only meaningful inside a focus handler.\n */\nexport function isFocusRestoration() {\n  return depth > 0 || Date.now() < restoreWindowEndsAt;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,IAAIA,QAAQ;AACZ,IAAIC,sBAAsB;;;;AAK1B,SAAgBC,sBACdC,SACAE,SACA;AACA,KAAI,CAACF,QAAS;AAEdH;AAEA,KAAI;AACFG,UAAQI,MAAMF,QAAQ;WACd;AACRL;;;;;;;AAQJ,SAAgBQ,uBAAuBC,UAAkB;AACvDR,uBAAsBS,KAAKC,IAAIV,qBAAqBW,KAAKC,KAAK,GAAGJ,SAAS;;;;;;AAO5E,SAAgBK,qBAAqB;AACnC,QAAOd,QAAQ,KAAKY,KAAKC,KAAK,GAAGZ"}
+{"version":3,"file":"programmaticFocus.js","names":["depth","restoreWindowEndsAt","focusProgrammatically","element","HTMLElement","SVGElement","options","FocusOptions","focus","markFocusRestoreWindow","duration","Math","max","Date","now","isFocusRestoration"],"sources":["../../../src/utils/react/programmaticFocus.ts"],"sourcesContent":["/**\n * Telling focus the user moved from focus a component moved for them.\n *\n * Handing focus back to a trigger after its overlay closes is not the same\n * event as a user tabbing onto that trigger, but the DOM cannot tell them\n * apart: `.focus()` produces an ordinary focus event, and the modality is\n * still \"keyboard\" from whatever the user just did, so anything keyed off\n * focus-visible treats it as a deliberate arrival. A trigger's tooltip pops up\n * unasked — and then absorbs the user's next `Escape` from its own\n * document-level listener (CUB-4839).\n *\n * Two mechanisms, because restoration reaches us two ways:\n *\n * - `focusProgrammatically` for restores WE perform. `focus()` dispatches\n *   `focus`/`focusin` synchronously, so a flag set around the call is readable\n *   by every handler that runs for it and gone immediately afterwards. Exact,\n *   with no window to tune.\n *\n * - `markFocusRestoreWindow` for restores React Aria performs. A `FocusScope`\n *   restores on unmount, from inside React's own commit, and offers no hook to\n *   wrap — so an overlay that is closing declares the window instead. Coarser\n *   on purpose: it can only make a tooltip skip one arrival that lands while\n *   an overlay is going away, which is the case it exists for.\n */\nlet depth = 0;\nlet restoreWindowEndsAt = 0;\n\n/**\n * Focus `element` without the UI reading it as the user arriving there.\n */\nexport function focusProgrammatically(\n  element: HTMLElement | SVGElement | null | undefined,\n  options?: FocusOptions,\n) {\n  if (!element) return;\n\n  depth++;\n\n  try {\n    element.focus(options);\n  } finally {\n    depth--;\n  }\n}\n\n/**\n * Declare that focus is about to be restored by machinery we cannot wrap, for\n * roughly `duration` ms. Called by a closing overlay.\n */\nexport function markFocusRestoreWindow(duration: number) {\n  restoreWindowEndsAt = Math.max(restoreWindowEndsAt, Date.now() + duration);\n}\n\n/**\n * Whether the focus being handled right now is a restoration rather than the\n * user arriving. Only meaningful inside a focus handler.\n */\nexport function isFocusRestoration() {\n  return depth > 0 || Date.now() < restoreWindowEndsAt;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,IAAIA,QAAQ;AACZ,IAAIC,sBAAsB;;;;AAK1B,SAAgBC,sBACdC,SACAG,SACA;CACA,IAAI,CAACH,SAAS;CAEdH;CAEA,IAAI;EACFG,QAAQK,MAAMF,OAAO;CACvB,UAAU;EACRN;CACF;AACF;;;;;AAMA,SAAgBS,uBAAuBC,UAAkB;CACvDT,sBAAsBU,KAAKC,IAAIX,qBAAqBY,KAAKC,IAAI,IAAIJ,QAAQ;AAC3E;;;;;AAMA,SAAgBK,qBAAqB;CACnC,OAAOf,QAAQ,KAAKa,KAAKC,IAAI,IAAIb;AACnC"}

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

@@ -1,17 +1,16 @@
 
 import { Mods } from "@tenphi/tasty";
 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;
+export 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 {
+export type DynamicIcon<T extends Mods = Mods> = ReactNode | true | IconRenderFn<T>;
+export 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) */
@@ -23,7 +22,6 @@ interface ResolvedIcon {
  * - 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;
+export 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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 //#region src/utils/react/resolveIcon.ts
 /**
 * Resolves a dynamic icon prop to its content and slot state.
@@ -35,7 +35,7 @@ function resolveIcon(icon, mods) {
 		hasSlot: true
 	};
 }
-
 //#endregion
 export { resolveIcon };
+
 //# sourceMappingURL=resolveIcon.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"resolveIcon.js","names":["Mods","ReactNode","IconRenderFn","mods","T","DynamicIcon","ResolvedIcon","content","hasSlot","resolveIcon","icon","undefined","result"],"sources":["../../../src/utils/react/resolveIcon.ts"],"sourcesContent":["import { Mods } from '@tenphi/tasty';\nimport { ReactNode } from 'react';\n\n/**\n * Function that receives mods (can be destructured) and returns an icon or true for empty slot.\n * @example\n * icon={({ loading, selected }) => loading ? <SpinnerIcon /> : <Icon />}\n */\nexport type IconRenderFn<T extends Mods = Mods> = (mods: T) => ReactNode | true;\n\n/** Dynamic icon prop: ReactNode, true for empty slot, or render function */\nexport type DynamicIcon<T extends Mods = Mods> =\n  | ReactNode\n  | true\n  | IconRenderFn<T>;\n\nexport interface ResolvedIcon {\n  /** The icon content to render (null for empty slot) */\n  content: ReactNode | null;\n  /** Whether the slot should be rendered (true even for empty slots) */\n  hasSlot: boolean;\n}\n\n/**\n * Resolves a dynamic icon prop to its content and slot state.\n * - If `true`: empty slot (hasSlot=true, content=null)\n * - If function: call with mods, then process result\n * - Otherwise: use as-is\n */\nexport function resolveIcon<T extends Mods>(\n  icon: DynamicIcon<T> | undefined,\n  mods: T,\n): ResolvedIcon {\n  if (icon === undefined || icon === null || icon === false) {\n    return { content: null, hasSlot: false };\n  }\n\n  if (icon === true) {\n    return { content: null, hasSlot: true };\n  }\n\n  if (typeof icon === 'function') {\n    const result = (icon as IconRenderFn<T>)(mods);\n    if (result === true) {\n      return { content: null, hasSlot: true };\n    }\n    if (result === undefined || result === null || result === false) {\n      return { content: null, hasSlot: false };\n    }\n    return { content: result, hasSlot: true };\n  }\n\n  return { content: icon, hasSlot: true };\n}\n"],"mappings":";;;;;;;;AA6BA,SAAgBS,YACdC,MACAP,MACc;AACd,KAAIO,SAASC,UAAaD,SAAS,QAAQA,SAAS,MAClD,QAAO;EAAEH,SAAS;EAAMC,SAAS;EAAO;AAG1C,KAAIE,SAAS,KACX,QAAO;EAAEH,SAAS;EAAMC,SAAS;EAAM;AAGzC,KAAI,OAAOE,SAAS,YAAY;EAC9B,MAAME,SAAUF,KAAyBP,KAAK;AAC9C,MAAIS,WAAW,KACb,QAAO;GAAEL,SAAS;GAAMC,SAAS;GAAM;AAEzC,MAAII,WAAWD,UAAaC,WAAW,QAAQA,WAAW,MACxD,QAAO;GAAEL,SAAS;GAAMC,SAAS;GAAO;AAE1C,SAAO;GAAED,SAASK;GAAQJ,SAAS;GAAM;;AAG3C,QAAO;EAAED,SAASG;EAAMF,SAAS;EAAM"}
+{"version":3,"file":"resolveIcon.js","names":["Mods","ReactNode","IconRenderFn","mods","T","DynamicIcon","ResolvedIcon","content","hasSlot","resolveIcon","icon","undefined","result"],"sources":["../../../src/utils/react/resolveIcon.ts"],"sourcesContent":["import { Mods } from '@tenphi/tasty';\nimport { ReactNode } from 'react';\n\n/**\n * Function that receives mods (can be destructured) and returns an icon or true for empty slot.\n * @example\n * icon={({ loading, selected }) => loading ? <SpinnerIcon /> : <Icon />}\n */\nexport type IconRenderFn<T extends Mods = Mods> = (mods: T) => ReactNode | true;\n\n/** Dynamic icon prop: ReactNode, true for empty slot, or render function */\nexport type DynamicIcon<T extends Mods = Mods> =\n  ReactNode | true | IconRenderFn<T>;\n\nexport interface ResolvedIcon {\n  /** The icon content to render (null for empty slot) */\n  content: ReactNode | null;\n  /** Whether the slot should be rendered (true even for empty slots) */\n  hasSlot: boolean;\n}\n\n/**\n * Resolves a dynamic icon prop to its content and slot state.\n * - If `true`: empty slot (hasSlot=true, content=null)\n * - If function: call with mods, then process result\n * - Otherwise: use as-is\n */\nexport function resolveIcon<T extends Mods>(\n  icon: DynamicIcon<T> | undefined,\n  mods: T,\n): ResolvedIcon {\n  if (icon === undefined || icon === null || icon === false) {\n    return { content: null, hasSlot: false };\n  }\n\n  if (icon === true) {\n    return { content: null, hasSlot: true };\n  }\n\n  if (typeof icon === 'function') {\n    const result = (icon as IconRenderFn<T>)(mods);\n    if (result === true) {\n      return { content: null, hasSlot: true };\n    }\n    if (result === undefined || result === null || result === false) {\n      return { content: null, hasSlot: false };\n    }\n    return { content: result, hasSlot: true };\n  }\n\n  return { content: icon, hasSlot: true };\n}\n"],"mappings":";;;;;;;;AA2BA,SAAgBS,YACdC,MACAP,MACc;CACd,IAAIO,SAASC,KAAAA,KAAaD,SAAS,QAAQA,SAAS,OAClD,OAAO;EAAEH,SAAS;EAAMC,SAAS;CAAM;CAGzC,IAAIE,SAAS,MACX,OAAO;EAAEH,SAAS;EAAMC,SAAS;CAAK;CAGxC,IAAI,OAAOE,SAAS,YAAY;EAC9B,MAAME,SAAUF,KAAyBP,IAAI;EAC7C,IAAIS,WAAW,MACb,OAAO;GAAEL,SAAS;GAAMC,SAAS;EAAK;EAExC,IAAII,WAAWD,KAAAA,KAAaC,WAAW,QAAQA,WAAW,OACxD,OAAO;GAAEL,SAAS;GAAMC,SAAS;EAAM;EAEzC,OAAO;GAAED,SAASK;GAAQJ,SAAS;EAAK;CAC1C;CAEA,OAAO;EAAED,SAASG;EAAMF,SAAS;CAAK;AACxC"}

package/dist/utils/react/sharedStore.js

@@ -1,9 +1,8 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { isDevEnv } from "../is-dev-env.js";
 import { c } from "react/compiler-runtime";
 import { useSyncExternalStore } from "react";
-
 //#region src/utils/react/sharedStore.ts
 /**
 * Create a shared store that survives hot-reloads.
@@ -44,7 +43,7 @@ function createSharedStore(name, initialState) {
 	};
 	return useSharedStore;
 }
-
 //#endregion
 export { createSharedStore };
+
 //# sourceMappingURL=sharedStore.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"sharedStore.js","names":["useSyncExternalStore","useEvent","isDevEnv","Updater","S","prev","StoreHolder","state","listeners","Set","createSharedStore","name","initialState","UseSharedStoreHook","cacheKey","existing","globalThis","holder","console","warn","getSnapshot","subscribe","cb","add","delete","setStore","update","forEach","l","useSharedStore","$","_c","t0","t1","t2","u"],"sources":["../../../src/utils/react/sharedStore.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\nimport { useEvent } from '../../_internal/hooks/use-event';\nimport { isDevEnv } from '../is-dev-env';\n\n/** Like React.setState: either a value or a function of the previous value */\ntype Updater<S> = S | ((prev: S) => S);\n\n/* Internal shape kept on globalThis */\ninterface StoreHolder<S> {\n  state: S;\n  listeners: Set<() => void>;\n}\n\n/**\n * Create a shared store that survives hot-reloads.\n *\n * Pass a unique `name` once per logical store module:\n *   export const useSidebarStore = createSharedStore('sidebar', { open: false });\n */\nexport function createSharedStore<S>(\n  name: string,\n  initialState: S,\n): UseSharedStoreHook<S> {\n  const cacheKey = `__sharedStore_${name}__`;\n  const existing: StoreHolder<S> | undefined =\n    cacheKey && (globalThis as any)[cacheKey];\n\n  const holder: StoreHolder<S> = existing ?? {\n    state: initialState,\n    listeners: new Set<() => void>(),\n  };\n\n  /* Warn if someone tries to “re-initialise” with a different value */\n  if (isDevEnv() && existing && existing.state !== initialState) {\n    console.warn(\n      `[createSharedStore] Store \"${name}\" already exists – ` +\n        'the new initialState is ignored to preserve hot-reload state.',\n    );\n  }\n\n  if (cacheKey && !existing) {\n    (globalThis as any)[cacheKey] = holder;\n  }\n\n  const getSnapshot = () => holder.state;\n\n  const subscribe = (cb: () => void) => {\n    holder.listeners.add(cb);\n\n    return () => holder.listeners.delete(cb);\n  };\n\n  const setStore = (update: Updater<S>) => {\n    holder.state =\n      typeof update === 'function'\n        ? (update as (prev: S) => S)(holder.state)\n        : update;\n\n    holder.listeners.forEach((l) => l());\n  };\n\n  const useSharedStore: UseSharedStoreHook<S> = () => {\n    return [useSyncExternalStore(subscribe, getSnapshot), useEvent(setStore)];\n  };\n\n  return useSharedStore;\n}\n\ntype UseSharedStoreHook<S> = () => readonly [S, (u: Updater<S>) => void];\n"],"mappings":";;;;;;;;;;;;;AAoBA,SAAgBU,kBACdC,MACAC,cACuB;CACvB,MAAME,WAAW,iBAAiBH,KAAI;CACtC,MAAMI,WACJD,YAAaE,WAAmBF;CAElC,MAAMG,SAAyBF,YAAY;EACzCR,OAAOK;EACPJ,2BAAW,IAAIC,KAAgB;EAChC;AAGD,KAAIP,UAAU,IAAIa,YAAYA,SAASR,UAAUK,aAC/CM,SAAQC,KACN,8BAA8BR,KAAI,kFAEnC;AAGH,KAAIG,YAAY,CAACC,SACf,CAACC,WAAmBF,YAAYG;CAGlC,MAAMG,oBAAoBH,OAAOV;CAEjC,MAAMc,aAAaC,OAAmB;AACpCL,SAAOT,UAAUe,IAAID,GAAG;AAExB,eAAaL,OAAOT,UAAUgB,OAAOF,GAAG;;CAG1C,MAAMG,YAAYC,WAAuB;AACvCT,SAAOV,QACL,OAAOmB,WAAW,aACbA,OAA0BT,OAAOV,MAAM,GACxCmB;AAENT,SAAOT,UAAUmB,SAASC,MAAMA,GAAG,CAAC;;CAGtC,MAAMC,uBAAwC;EAAA,MAAAC,IAAAC,EAAA,EAAA;EACpC,MAAAC,KAAAhC,qBAAqBqB,WAAWD,YAAY;EAAE,MAAAa,KAAAhC,SAASwB,SAAS;EAAA,IAAAS;AAAA,MAAAJ,EAAA,OAAAE,MAAAF,EAAA,OAAAG,IAAA;AAAjEC,QAAA,CAACF,IAA8CC,GAAmB;AAAAH,KAAA,KAAAE;AAAAF,KAAA,KAAAG;AAAAH,KAAA,KAAAI;QAAAA,MAAAJ,EAAA;AAAA,SAAlEI;;AAGT,QAAOL"}
+{"version":3,"file":"sharedStore.js","names":["useSyncExternalStore","useEvent","isDevEnv","Updater","S","prev","StoreHolder","state","listeners","Set","createSharedStore","name","initialState","UseSharedStoreHook","cacheKey","existing","globalThis","holder","console","warn","getSnapshot","subscribe","cb","add","delete","setStore","update","forEach","l","useSharedStore","$","_c","t0","t1","t2","u","_c"],"sources":["../../../src/utils/react/sharedStore.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\nimport { useEvent } from '../../_internal/hooks/use-event';\nimport { isDevEnv } from '../is-dev-env';\n\n/** Like React.setState: either a value or a function of the previous value */\ntype Updater<S> = S | ((prev: S) => S);\n\n/* Internal shape kept on globalThis */\ninterface StoreHolder<S> {\n  state: S;\n  listeners: Set<() => void>;\n}\n\n/**\n * Create a shared store that survives hot-reloads.\n *\n * Pass a unique `name` once per logical store module:\n *   export const useSidebarStore = createSharedStore('sidebar', { open: false });\n */\nexport function createSharedStore<S>(\n  name: string,\n  initialState: S,\n): UseSharedStoreHook<S> {\n  const cacheKey = `__sharedStore_${name}__`;\n  const existing: StoreHolder<S> | undefined =\n    cacheKey && (globalThis as any)[cacheKey];\n\n  const holder: StoreHolder<S> = existing ?? {\n    state: initialState,\n    listeners: new Set<() => void>(),\n  };\n\n  /* Warn if someone tries to “re-initialise” with a different value */\n  if (isDevEnv() && existing && existing.state !== initialState) {\n    console.warn(\n      `[createSharedStore] Store \"${name}\" already exists – ` +\n        'the new initialState is ignored to preserve hot-reload state.',\n    );\n  }\n\n  if (cacheKey && !existing) {\n    (globalThis as any)[cacheKey] = holder;\n  }\n\n  const getSnapshot = () => holder.state;\n\n  const subscribe = (cb: () => void) => {\n    holder.listeners.add(cb);\n\n    return () => holder.listeners.delete(cb);\n  };\n\n  const setStore = (update: Updater<S>) => {\n    holder.state =\n      typeof update === 'function'\n        ? (update as (prev: S) => S)(holder.state)\n        : update;\n\n    holder.listeners.forEach((l) => l());\n  };\n\n  const useSharedStore: UseSharedStoreHook<S> = () => {\n    return [useSyncExternalStore(subscribe, getSnapshot), useEvent(setStore)];\n  };\n\n  return useSharedStore;\n}\n\ntype UseSharedStoreHook<S> = () => readonly [S, (u: Updater<S>) => void];\n"],"mappings":";;;;;;;;;;;;AAoBA,SAAgBU,kBACdC,MACAC,cACuB;CACvB,MAAME,WAAW,iBAAiBH,KAAI;CACtC,MAAMI,WACJD,YAAaE,WAAmBF;CAElC,MAAMG,SAAyBF,YAAY;EACzCR,OAAOK;EACPJ,2BAAW,IAAIC,IAAgB;CACjC;CAGA,IAAIP,SAAS,KAAKa,YAAYA,SAASR,UAAUK,cAC/CM,QAAQC,KACN,8BAA8BR,KAAI,iFAEpC;CAGF,IAAIG,YAAY,CAACC,UACf,WAAoBD,YAAYG;CAGlC,MAAMG,oBAAoBH,OAAOV;CAEjC,MAAMc,aAAaC,OAAmB;EACpCL,OAAOT,UAAUe,IAAID,EAAE;EAEvB,aAAaL,OAAOT,UAAUgB,OAAOF,EAAE;CACzC;CAEA,MAAMG,YAAYC,WAAuB;EACvCT,OAAOV,QACL,OAAOmB,WAAW,aACbA,OAA0BT,OAAOV,KAAK,IACvCmB;EAENT,OAAOT,UAAUmB,SAASC,MAAMA,EAAE,CAAC;CACrC;CAEA,MAAMC,uBAAwC;EAAA,MAAAC,IAAAC,EAAA,CAAA;EACpC,MAAAC,KAAAhC,qBAAqBqB,WAAWD,WAAW;EAAG,MAAAa,KAAAhC,SAASwB,QAAQ;EAAC,IAAAS;EAAA,IAAAJ,EAAA,OAAAE,MAAAF,EAAA,OAAAG,IAAA;GAAjEC,KAAA,CAACF,IAA8CC,EAAkB;GAACH,EAAA,KAAAE;GAAAF,EAAA,KAAAG;GAAAH,EAAA,KAAAI;EAAA,OAAAA,KAAAJ,EAAA;EAAA,OAAlEI;CAAkE;CAG3E,OAAOL;AACT"}

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

@@ -1,6 +1,6 @@
 
 //#region src/utils/react/useBufferedValue.d.ts
-interface UseBufferedValueOptions<T> {
+export interface UseBufferedValueOptions<T> {
   /**
    * Identity of a value, for values `Object.is` doesn't compare usefully — an array of colour
    * stops, a settings object. Defaults to the value itself, which is what strings want.
@@ -13,7 +13,7 @@ interface UseBufferedValueOptions<T> {
   /** Escape hatch: `false` makes the hook inert and passes `value`/`onChange` straight through. */
   isBuffered?: boolean;
 }
-interface UseBufferedValueResult<T> {
+export interface UseBufferedValueResult<T> {
   /** Render this instead of `value`. `undefined` passes through, meaning uncontrolled. */
   value: T | undefined;
   /** Call this instead of `onChange`. Still emits once per call, in the same tick. */
@@ -50,7 +50,6 @@ interface UseBufferedValueResult<T> {
  * happens to equal a value still in flight, is read as our own echo. Telling those apart needs a
  * sequence number from the store rather than value matching.
  */
-declare function useBufferedValue<T>(value: T | undefined, onChange?: (next: T) => void, options?: UseBufferedValueOptions<T>): UseBufferedValueResult<T>;
+export declare function useBufferedValue<T>(value: T | undefined, onChange?: (next: T) => void, options?: UseBufferedValueOptions<T>): UseBufferedValueResult<T>;
 //#endregion
-export { UseBufferedValueOptions, UseBufferedValueResult, useBufferedValue };
 //# sourceMappingURL=useBufferedValue.d.ts.map

package/dist/utils/react/useBufferedValue.js

@@ -1,7 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { useCallback, useRef, useState } from "react";
-
 //#region src/utils/react/useBufferedValue.ts
 const NOTHING_PENDING = [];
 /**
@@ -80,7 +79,7 @@ function useBufferedValue(value, onChange, options = {}) {
 		}, [])
 	};
 }
-
 //#endregion
 export { useBufferedValue };
+
 //# sourceMappingURL=useBufferedValue.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useBufferedValue.js","names":["useCallback","useRef","useState","useLayoutEffect","NOTHING_PENDING","UseBufferedValueOptions","getKey","value","T","isDisabled","isReadOnly","isBuffered","UseBufferedValueResult","onChange","next","reset","useBufferedValue","options","isActive","undefined","keyOf","valueKey","draft","setDraft","pendingRef","seenKeyRef","latestRef","pending","current","propMoved","echoAt","indexOf","isExternal","isAhead","length","rendered","slice","handleChange","latestOnChange","latestKeyOf","latestIsActive","latestValue"],"sources":["../../../src/utils/react/useBufferedValue.ts"],"sourcesContent":["import { useCallback, useRef, useState } from 'react';\n\nimport { useLayoutEffect } from './useLayoutEffect';\n\nconst NOTHING_PENDING: unknown[] = [];\n\nexport interface UseBufferedValueOptions<T> {\n  /**\n   * Identity of a value, for values `Object.is` doesn't compare usefully — an array of colour\n   * stops, a settings object. Defaults to the value itself, which is what strings want.\n   */\n  getKey?: (value: T) => unknown;\n  /** Nothing can be typed into a disabled control, so there is nothing to protect. */\n  isDisabled?: boolean;\n  /** Same for a read-only one. */\n  isReadOnly?: boolean;\n  /** Escape hatch: `false` makes the hook inert and passes `value`/`onChange` straight through. */\n  isBuffered?: boolean;\n}\n\nexport interface UseBufferedValueResult<T> {\n  /** Render this instead of `value`. `undefined` passes through, meaning uncontrolled. */\n  value: T | undefined;\n  /** Call this instead of `onChange`. Still emits once per call, in the same tick. */\n  onChange: (next: T) => void;\n  /** Drop the buffer and let `value` win again. The text fields call it on blur. */\n  reset: () => void;\n}\n\n/**\n * Holds a controlled value locally so a parent that echoes the new value back *late* cannot\n * overwrite what the user is doing.\n *\n * **Why any of this is needed.** A controlled `<input>` renders whatever string its parent hands\n * it. If the parent hands back the pre-keystroke string — because its state reaches the component\n * through a store that publishes a render late, or through a debounce, or a deferred update —\n * React writes that stale string into the DOM node, and a native `value` assignment collapses the\n * selection to the end. Typing in the middle of a field throws the caret to the end. The value\n * eventually lands, so it looks like a caret bug rather than a data-flow one.\n *\n * The buffer keeps the typed text on screen until the parent catches up, while still emitting\n * `onChange` once per keystroke — so nothing downstream changes: no debouncing, no commit-on-blur,\n * no swallowed calls.\n *\n * Generic on purpose. The same lateness affects values that aren't strings (a colour scale's array\n * of stops emitted through a chart-spec pipeline), and `getKey` is where those pass the signature\n * function they already have.\n *\n * ```tsx\n * const buffered = useBufferedValue(value, onChange, { isReadOnly, isDisabled });\n *\n * <input value={buffered.value} onChange={buffered.onChange} onBlur={buffered.reset} />\n * ```\n *\n * One case it cannot resolve: an external change that lands *between* an emit and its echo, and\n * happens to equal a value still in flight, is read as our own echo. Telling those apart needs a\n * sequence number from the store rather than value matching.\n */\nexport function useBufferedValue<T>(\n  value: T | undefined,\n  onChange?: (next: T) => void,\n  options: UseBufferedValueOptions<T> = {},\n): UseBufferedValueResult<T> {\n  const { getKey, isDisabled, isReadOnly, isBuffered = true } = options;\n\n  // An `undefined` value means the control is uncontrolled — it already owns its text.\n  const isActive =\n    isBuffered && value !== undefined && !isDisabled && !isReadOnly;\n\n  const keyOf = (next: T | undefined): unknown =>\n    getKey && next != null ? getKey(next) : next;\n  const valueKey = keyOf(value);\n\n  // The only state, and the only thing that can force a render: what the user typed. It is rendered\n  // *while we are ahead of the parent* and ignored otherwise — which is what makes adopting an\n  // external value free, since there is nothing to write.\n  const [draft, setDraft] = useState(value);\n  // Keys we have emitted that the parent hasn't echoed back yet. A queue rather than one slot: the\n  // user can type again before the first echo returns, and each echo has to be recognised as ours\n  // or applying it would swallow everything typed after it.\n  const pendingRef = useRef<unknown[]>(NOTHING_PENDING);\n  // The last value we accepted as the parent's opinion — not the last one we rendered.\n  const seenKeyRef = useRef<unknown>(valueKey);\n  const latestRef = useRef({ value, onChange, keyOf, isActive });\n\n  // These three refs are read during render but written *only* in an event handler or after commit,\n  // never during a render. That is what keeps them honest under concurrent rendering: React may\n  // discard a render (an interrupted pass, a StrictMode double-invoke), and a discarded render runs\n  // no effects, so it cannot leave the bookkeeping describing a pass that never committed.\n  const pending = pendingRef.current;\n  const propMoved = valueKey !== seenKeyRef.current;\n  // Our own echo, a render or more late — possibly an earlier emit a later one superseded.\n  const echoAt = propMoved ? pending.indexOf(valueKey) : -1;\n  // A real change from the parent: undo/redo, a reset, a transformed value, another record.\n  const isExternal = propMoved && echoAt < 0;\n  const isAhead = isActive && !isExternal && pending.length > 0;\n  // Not being ahead is the whole of \"the parent wins\", so an external change needs no state write\n  // and costs no extra render. Being ahead — including when the value is the stale one the parent\n  // held *before* the keystroke — is what stops React writing that string back and collapsing the\n  // selection.\n  const rendered = isAhead ? draft : value;\n\n  useLayoutEffect(() => {\n    latestRef.current = { value, onChange, keyOf, isActive };\n    seenKeyRef.current = valueKey;\n\n    if (!isActive || isExternal) {\n      pendingRef.current = NOTHING_PENDING;\n    } else if (echoAt >= 0) {\n      pendingRef.current = pending.slice(echoAt + 1);\n    }\n  });\n\n  const handleChange = useCallback((next: T) => {\n    const {\n      onChange: latestOnChange,\n      keyOf: latestKeyOf,\n      isActive: latestIsActive,\n    } = latestRef.current;\n\n    if (latestIsActive) {\n      // A ref write in an event handler, which runs after a commit — never mid-render.\n      pendingRef.current = [...pendingRef.current, latestKeyOf(next)];\n      setDraft(next);\n    }\n\n    latestOnChange?.(next);\n  }, []);\n\n  const reset = useCallback(() => {\n    const { value: latestValue } = latestRef.current;\n\n    // Emptying the queue is what hands control back: with nothing in flight we are no longer ahead,\n    // so the parent's value is rendered again. `setDraft` is only here to schedule that render.\n    pendingRef.current = NOTHING_PENDING;\n    setDraft(latestValue);\n  }, []);\n\n  return { value: rendered, onChange: handleChange, reset };\n}\n"],"mappings":";;;;;AAIA,MAAMI,kBAA6B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDrC,SAAgBY,iBACdT,OACAM,UACAI,UAAsC,EAAE,EACb;CAC3B,MAAM,EAAEX,QAAQG,YAAYC,YAAYC,aAAa,SAASM;CAG9D,MAAMC,WACJP,cAAcJ,UAAUY,UAAa,CAACV,cAAc,CAACC;CAEvD,MAAMU,SAASN,SACbR,UAAUQ,QAAQ,OAAOR,OAAOQ,KAAK,GAAGA;CAC1C,MAAMO,WAAWD,MAAMb,MAAM;CAK7B,MAAM,CAACe,OAAOC,YAAYrB,SAASK,MAAM;CAIzC,MAAMiB,aAAavB,OAAkBG,gBAAgB;CAErD,MAAMqB,aAAaxB,OAAgBoB,SAAS;CAC5C,MAAMK,YAAYzB,OAAO;EAAEM;EAAOM;EAAUO;EAAOF;EAAU,CAAC;CAM9D,MAAMS,UAAUH,WAAWI;CAC3B,MAAMC,YAAYR,aAAaI,WAAWG;CAE1C,MAAME,SAASD,YAAYF,QAAQI,QAAQV,SAAS,GAAG;CAEvD,MAAMW,aAAaH,aAAaC,SAAS;CAMzC,MAAMK,WALUjB,YAAY,CAACc,cAAcL,QAAQO,SAAS,IAKjCZ,QAAQf;AAEnCJ,yBAAsB;AACpBuB,YAAUE,UAAU;GAAErB;GAAOM;GAAUO;GAAOF;GAAU;AACxDO,aAAWG,UAAUP;AAErB,MAAI,CAACH,YAAYc,WACfR,YAAWI,UAAUxB;WACZ0B,UAAU,EACnBN,YAAWI,UAAUD,QAAQS,MAAMN,SAAS,EAAE;GAEhD;AA2BF,QAAO;EAAEvB,OAAO4B;EAAUtB,UAzBLb,aAAac,WAAY;GAC5C,MAAM,EACJD,UAAUyB,gBACVlB,OAAOmB,aACPrB,UAAUsB,mBACRd,UAAUE;AAEd,OAAIY,gBAAgB;AAElBhB,eAAWI,UAAU,CAAC,GAAGJ,WAAWI,SAASW,YAAYzB,OAAK,CAAC;AAC/DS,aAAST,OAAK;;AAGhBwB,oBAAiBxB,OAAK;KACrB,EAAE,CAAC;EAW4CC,OATpCf,kBAAkB;GAC9B,MAAM,EAAEO,OAAOkC,gBAAgBf,UAAUE;AAIzCJ,cAAWI,UAAUxB;AACrBmB,YAASkB,YAAY;KACpB,EAAE,CAAC;EAEmD"}
+{"version":3,"file":"useBufferedValue.js","names":["useCallback","useRef","useState","useLayoutEffect","NOTHING_PENDING","UseBufferedValueOptions","getKey","value","T","isDisabled","isReadOnly","isBuffered","UseBufferedValueResult","onChange","next","reset","useBufferedValue","options","isActive","undefined","keyOf","valueKey","draft","setDraft","pendingRef","seenKeyRef","latestRef","pending","current","propMoved","echoAt","indexOf","isExternal","isAhead","length","rendered","slice","handleChange","latestOnChange","latestKeyOf","latestIsActive","latestValue"],"sources":["../../../src/utils/react/useBufferedValue.ts"],"sourcesContent":["import { useCallback, useRef, useState } from 'react';\n\nimport { useLayoutEffect } from './useLayoutEffect';\n\nconst NOTHING_PENDING: unknown[] = [];\n\nexport interface UseBufferedValueOptions<T> {\n  /**\n   * Identity of a value, for values `Object.is` doesn't compare usefully — an array of colour\n   * stops, a settings object. Defaults to the value itself, which is what strings want.\n   */\n  getKey?: (value: T) => unknown;\n  /** Nothing can be typed into a disabled control, so there is nothing to protect. */\n  isDisabled?: boolean;\n  /** Same for a read-only one. */\n  isReadOnly?: boolean;\n  /** Escape hatch: `false` makes the hook inert and passes `value`/`onChange` straight through. */\n  isBuffered?: boolean;\n}\n\nexport interface UseBufferedValueResult<T> {\n  /** Render this instead of `value`. `undefined` passes through, meaning uncontrolled. */\n  value: T | undefined;\n  /** Call this instead of `onChange`. Still emits once per call, in the same tick. */\n  onChange: (next: T) => void;\n  /** Drop the buffer and let `value` win again. The text fields call it on blur. */\n  reset: () => void;\n}\n\n/**\n * Holds a controlled value locally so a parent that echoes the new value back *late* cannot\n * overwrite what the user is doing.\n *\n * **Why any of this is needed.** A controlled `<input>` renders whatever string its parent hands\n * it. If the parent hands back the pre-keystroke string — because its state reaches the component\n * through a store that publishes a render late, or through a debounce, or a deferred update —\n * React writes that stale string into the DOM node, and a native `value` assignment collapses the\n * selection to the end. Typing in the middle of a field throws the caret to the end. The value\n * eventually lands, so it looks like a caret bug rather than a data-flow one.\n *\n * The buffer keeps the typed text on screen until the parent catches up, while still emitting\n * `onChange` once per keystroke — so nothing downstream changes: no debouncing, no commit-on-blur,\n * no swallowed calls.\n *\n * Generic on purpose. The same lateness affects values that aren't strings (a colour scale's array\n * of stops emitted through a chart-spec pipeline), and `getKey` is where those pass the signature\n * function they already have.\n *\n * ```tsx\n * const buffered = useBufferedValue(value, onChange, { isReadOnly, isDisabled });\n *\n * <input value={buffered.value} onChange={buffered.onChange} onBlur={buffered.reset} />\n * ```\n *\n * One case it cannot resolve: an external change that lands *between* an emit and its echo, and\n * happens to equal a value still in flight, is read as our own echo. Telling those apart needs a\n * sequence number from the store rather than value matching.\n */\nexport function useBufferedValue<T>(\n  value: T | undefined,\n  onChange?: (next: T) => void,\n  options: UseBufferedValueOptions<T> = {},\n): UseBufferedValueResult<T> {\n  const { getKey, isDisabled, isReadOnly, isBuffered = true } = options;\n\n  // An `undefined` value means the control is uncontrolled — it already owns its text.\n  const isActive =\n    isBuffered && value !== undefined && !isDisabled && !isReadOnly;\n\n  const keyOf = (next: T | undefined): unknown =>\n    getKey && next != null ? getKey(next) : next;\n  const valueKey = keyOf(value);\n\n  // The only state, and the only thing that can force a render: what the user typed. It is rendered\n  // *while we are ahead of the parent* and ignored otherwise — which is what makes adopting an\n  // external value free, since there is nothing to write.\n  const [draft, setDraft] = useState(value);\n  // Keys we have emitted that the parent hasn't echoed back yet. A queue rather than one slot: the\n  // user can type again before the first echo returns, and each echo has to be recognised as ours\n  // or applying it would swallow everything typed after it.\n  const pendingRef = useRef<unknown[]>(NOTHING_PENDING);\n  // The last value we accepted as the parent's opinion — not the last one we rendered.\n  const seenKeyRef = useRef<unknown>(valueKey);\n  const latestRef = useRef({ value, onChange, keyOf, isActive });\n\n  // These three refs are read during render but written *only* in an event handler or after commit,\n  // never during a render. That is what keeps them honest under concurrent rendering: React may\n  // discard a render (an interrupted pass, a StrictMode double-invoke), and a discarded render runs\n  // no effects, so it cannot leave the bookkeeping describing a pass that never committed.\n  const pending = pendingRef.current;\n  const propMoved = valueKey !== seenKeyRef.current;\n  // Our own echo, a render or more late — possibly an earlier emit a later one superseded.\n  const echoAt = propMoved ? pending.indexOf(valueKey) : -1;\n  // A real change from the parent: undo/redo, a reset, a transformed value, another record.\n  const isExternal = propMoved && echoAt < 0;\n  const isAhead = isActive && !isExternal && pending.length > 0;\n  // Not being ahead is the whole of \"the parent wins\", so an external change needs no state write\n  // and costs no extra render. Being ahead — including when the value is the stale one the parent\n  // held *before* the keystroke — is what stops React writing that string back and collapsing the\n  // selection.\n  const rendered = isAhead ? draft : value;\n\n  useLayoutEffect(() => {\n    latestRef.current = { value, onChange, keyOf, isActive };\n    seenKeyRef.current = valueKey;\n\n    if (!isActive || isExternal) {\n      pendingRef.current = NOTHING_PENDING;\n    } else if (echoAt >= 0) {\n      pendingRef.current = pending.slice(echoAt + 1);\n    }\n  });\n\n  const handleChange = useCallback((next: T) => {\n    const {\n      onChange: latestOnChange,\n      keyOf: latestKeyOf,\n      isActive: latestIsActive,\n    } = latestRef.current;\n\n    if (latestIsActive) {\n      // A ref write in an event handler, which runs after a commit — never mid-render.\n      pendingRef.current = [...pendingRef.current, latestKeyOf(next)];\n      setDraft(next);\n    }\n\n    latestOnChange?.(next);\n  }, []);\n\n  const reset = useCallback(() => {\n    const { value: latestValue } = latestRef.current;\n\n    // Emptying the queue is what hands control back: with nothing in flight we are no longer ahead,\n    // so the parent's value is rendered again. `setDraft` is only here to schedule that render.\n    pendingRef.current = NOTHING_PENDING;\n    setDraft(latestValue);\n  }, []);\n\n  return { value: rendered, onChange: handleChange, reset };\n}\n"],"mappings":";;;;AAIA,MAAMI,kBAA6B,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDnC,SAAgBY,iBACdT,OACAM,UACAI,UAAsC,CAAC,GACZ;CAC3B,MAAM,EAAEX,QAAQG,YAAYC,YAAYC,aAAa,SAASM;CAG9D,MAAMC,WACJP,cAAcJ,UAAUY,KAAAA,KAAa,CAACV,cAAc,CAACC;CAEvD,MAAMU,SAASN,SACbR,UAAUQ,QAAQ,OAAOR,OAAOQ,IAAI,IAAIA;CAC1C,MAAMO,WAAWD,MAAMb,KAAK;CAK5B,MAAM,CAACe,OAAOC,YAAYrB,SAASK,KAAK;CAIxC,MAAMiB,aAAavB,OAAkBG,eAAe;CAEpD,MAAMqB,aAAaxB,OAAgBoB,QAAQ;CAC3C,MAAMK,YAAYzB,OAAO;EAAEM;EAAOM;EAAUO;EAAOF;CAAS,CAAC;CAM7D,MAAMS,UAAUH,WAAWI;CAC3B,MAAMC,YAAYR,aAAaI,WAAWG;CAE1C,MAAME,SAASD,YAAYF,QAAQI,QAAQV,QAAQ,IAAI;CAEvD,MAAMW,aAAaH,aAAaC,SAAS;CAMzC,MAAMK,WALUjB,YAAY,CAACc,cAAcL,QAAQO,SAAS,IAKjCZ,QAAQf;CAEnCJ,wBAAsB;EACpBuB,UAAUE,UAAU;GAAErB;GAAOM;GAAUO;GAAOF;EAAS;EACvDO,WAAWG,UAAUP;EAErB,IAAI,CAACH,YAAYc,YACfR,WAAWI,UAAUxB;OAChB,IAAI0B,UAAU,GACnBN,WAAWI,UAAUD,QAAQS,MAAMN,SAAS,CAAC;CAEjD,CAAC;CA2BD,OAAO;EAAEvB,OAAO4B;EAAUtB,UAzBLb,aAAac,WAAY;GAC5C,MAAM,EACJD,UAAUyB,gBACVlB,OAAOmB,aACPrB,UAAUsB,mBACRd,UAAUE;GAEd,IAAIY,gBAAgB;IAElBhB,WAAWI,UAAU,CAAC,GAAGJ,WAAWI,SAASW,YAAYzB,MAAI,CAAC;IAC9DS,SAAST,MAAI;GACf;GAEAwB,iBAAiBxB,MAAI;EACvB,GAAG,CAAA,CAWiCuB;EAActB,OATpCf,kBAAkB;GAC9B,MAAM,EAAEO,OAAOkC,gBAAgBf,UAAUE;GAIzCJ,WAAWI,UAAUxB;GACrBmB,SAASkB,WAAW;EACtB,GAAG,CAAA,CAE+C1B;CAAM;AAC1D"}

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

@@ -1,9 +1,7 @@
 
 import { Ref, RefObject } from "react";
-
 //#region src/utils/react/useCombinedRefs.d.ts
-declare function mergeRefs<T>(...refs: Array<Ref<T> | undefined>): (value: T | null) => void;
-declare function useCombinedRefs<T>(...refs: Array<Ref<T> | undefined>): RefObject<T>;
+export declare function mergeRefs<T>(...refs: Array<Ref<T> | undefined>): (value: T | null) => void;
+export declare function useCombinedRefs<T>(...refs: Array<Ref<T> | undefined>): RefObject<T>;
 //#endregion
-export { mergeRefs, useCombinedRefs };
 //# sourceMappingURL=useCombinedRefs.d.ts.map