@cube-dev/ui-kit 0.196.0 → 0.198.0

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

@@ -1 +1 @@
-{"version":3,"file":"usePopoverSync.js","names":["RefObject","useContext","useEffect","useEffectEvent","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","containerRefRef","t4","t5","current","triggerRefRef","t6","t7","t8","data","container","onPeerOpen","t9","data_0","container_0","onDismissAncestor","t10","offOpen","offDismiss","t11","wasOpenRef","t12","t13","delete","set","t14","t15","useDismissParentPopover","bus"],"sources":["../../../src/utils/react/usePopoverSync.ts"],"sourcesContent":["import {\n  RefObject,\n  useContext,\n  useEffect,\n  useEffectEvent,\n  useRef,\n} 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. Effect Events read current `isOpen`, `onClose` and container data, so the\n *    subscription effect's dep array includes only resource configuration. This\n *    keeps the existing subscriptions 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  // Track the latest containerRef via a stable ref-of-refs so the\n  // registry getters always see newly supplied ref wrappers. These getters\n  // are retained outside effects and cannot use Effect Events.\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  const onPeerOpen = useEffectEvent((data: PopoverOpenPayload) => {\n    if (data.menuId === menuId || !isOpen) return;\n    const container = containerRef?.current ?? null;\n    // Logical containment follows registry links across sibling portals.\n    if (isLogicalDescendantOf(data.triggerEl, menuId, container)) return;\n    onClose();\n  });\n\n  const onDismissAncestor = useEffectEvent(\n    (data: PopoverDismissAncestorPayload) => {\n      if (!isOpen) return;\n      const container = containerRef?.current;\n      const from = data?.from;\n      if (!container || !from) return;\n      if (container.contains(from)) onClose();\n    },\n  );\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    const offOpen = closeOnPeerOpen ? on('popover:open', onPeerOpen) : null;\n    const offDismiss = dismissOnInnerButtonPress\n      ? on('popover:dismiss-ancestor', onDismissAncestor)\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 (from: Element | null) => {\n    if (!from || !emit) return;\n    emit<PopoverDismissAncestorPayload>('popover:dismiss-ancestor', { from });\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"usePopoverSync.js","names":["RefObject","useContext","useEffect","useEffectEvent","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","containerRefRef","t4","t5","current","triggerRefRef","t6","t7","t8","data","container","onPeerOpen","t9","data_0","container_0","onDismissAncestor","t10","offOpen","offDismiss","t11","wasOpenRef","t12","t13","delete","set","t14","t15","useDismissParentPopover","bus","_c"],"sources":["../../../src/utils/react/usePopoverSync.ts"],"sourcesContent":["import {\n  RefObject,\n  useContext,\n  useEffect,\n  useEffectEvent,\n  useRef,\n} 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. Effect Events read current `isOpen`, `onClose` and container data, so the\n *    subscription effect's dep array includes only resource configuration. This\n *    keeps the existing subscriptions 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  // Track the latest containerRef via a stable ref-of-refs so the\n  // registry getters always see newly supplied ref wrappers. These getters\n  // are retained outside effects and cannot use Effect Events.\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  const onPeerOpen = useEffectEvent((data: PopoverOpenPayload) => {\n    if (data.menuId === menuId || !isOpen) return;\n    const container = containerRef?.current ?? null;\n    // Logical containment follows registry links across sibling portals.\n    if (isLogicalDescendantOf(data.triggerEl, menuId, container)) return;\n    onClose();\n  });\n\n  const onDismissAncestor = useEffectEvent(\n    (data: PopoverDismissAncestorPayload) => {\n      if (!isOpen) return;\n      const container = containerRef?.current;\n      const from = data?.from;\n      if (!container || !from) return;\n      if (container.contains(from)) onClose();\n    },\n  );\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    const offOpen = closeOnPeerOpen ? on('popover:open', onPeerOpen) : null;\n    const offDismiss = dismissOnInnerButtonPress\n      ? on('popover:dismiss-ancestor', onDismissAncestor)\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 (from: Element | null) => {\n    if (!from || !emit) return;\n    emit<PopoverDismissAncestorPayload>('popover:dismiss-ancestor', { from });\n  };\n}\n"],"mappings":"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"}

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

@@ -17,7 +17,7 @@ type Props = {
  * @param props - The object to process
  * @returns The modified object
  */
-declare function useQaProps<T extends Props>(props: T): T;
+export declare function useQaProps<T extends Props>(props: T): T;
 //#endregion
-export { useQaProps };
+export {};
 //# sourceMappingURL=useQaProps.d.ts.map

package/dist/utils/react/useQaProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 //#region src/utils/react/useQaProps.ts
 /**
 * Processes QA props.
@@ -16,8 +16,10 @@ function useQaProps(props) {
 		if (props[propName] !== void 0 || props[dataAttrName] !== void 0) {
 			const propValue = props[propName];
 			const dataAttrValue = props[dataAttrName];
-			if (!propValue) if (dataAttrValue) props[propName] = dataAttrValue;
-			else delete props[propName];
+			if (!propValue) {
+				if (dataAttrValue) props[propName] = dataAttrValue;
+				else delete props[propName];
+			}
 			delete props[dataAttrName];
 		}
 	};
@@ -25,7 +27,7 @@ function useQaProps(props) {
 	processQaAttribute("qaVal", "data-qa-val");
 	return props;
 }
-
 //#endregion
 export { useQaProps };
+
 //# sourceMappingURL=useQaProps.js.map

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

@@ -1 +1 @@
-{"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"}
+{"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;EACrE,IAAIJ,MAAMG,cAAcE,KAAAA,KAAaL,MAAMI,kBAAkBC,KAAAA,GAAW;GACtE,MAAMC,YAAYN,MAAMG;GACxB,MAAMI,gBAAgBP,MAAMI;GAE5B,IAAI,CAACE,WAAW;IACd,IAAIC,eAEFP,MAAMG,YAAYI;SAGlB,OAAOP,MAAMG;GAEjB;GAEA,OAAOH,MAAMI;EACf;CACF;CAGAF,mBAAmB,MAAM,SAAS;CAClCA,mBAAmB,SAAS,aAAa;CAEzC,OAAOF;AACT"}

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

@@ -1,7 +1,7 @@
 
 //#region src/utils/react/useScheme.d.ts
 /** The color scheme the document resolves to — the two arms of the `@dark` state. */
-type ColorScheme = 'light' | 'dark';
+export type ColorScheme = 'light' | 'dark';
 /**
  * The document's current color scheme, read once — the JS answer to `@dark`.
  *
@@ -9,7 +9,7 @@ type ColorScheme = 'light' | 'dark';
  * import time). In React use {@link useScheme}, which also re-renders on change.
  * Returns `'light'` with no DOM.
  */
-declare function resolveScheme(): ColorScheme;
+export declare function resolveScheme(): ColorScheme;
 /**
  * Whether the document is showing the high-contrast tier, read once — the JS
  * answer to `@hc`.
@@ -19,7 +19,7 @@ declare function resolveScheme(): ColorScheme;
  * `getPaletteConfig()`), while this is the tier the viewer asked for.
  * Returns `false` with no DOM.
  */
-declare function resolveHighContrast(): boolean;
+export declare function resolveHighContrast(): boolean;
 /**
  * Subscribe to ambient condition changes — either the scheme or the contrast
  * tier. Returns an unsubscribe function.
@@ -29,7 +29,7 @@ declare function resolveHighContrast(): boolean;
  * consumers that own a surface the stylesheet cannot reach — re-theming a Monaco
  * instance, re-rendering a chart.
  */
-declare function subscribeScheme(listener: () => void): () => void;
+export declare function subscribeScheme(listener: () => void): () => void;
 /**
  * The document's color scheme, kept live — `'light'` or `'dark'`.
  *
@@ -43,7 +43,7 @@ declare function subscribeScheme(listener: () => void): () => void;
  * exactly as the `@dark` state does. Under SSR it renders `'light'` and
  * re-renders with the real value after hydration.
  */
-declare function useScheme(): ColorScheme;
+export declare function useScheme(): ColorScheme;
 /**
  * Whether the document is showing the high-contrast tier, kept live — the hook
  * form of {@link resolveHighContrast}, following `<html data-contrast>` and
@@ -52,7 +52,6 @@ declare function useScheme(): ColorScheme;
  * Under SSR it renders `false` and re-renders with the real value after
  * hydration.
  */
-declare function useHighContrast(): boolean;
+export declare function useHighContrast(): boolean;
 //#endregion
-export { ColorScheme, resolveHighContrast, resolveScheme, subscribeScheme, useHighContrast, useScheme };
 //# sourceMappingURL=useScheme.d.ts.map

package/dist/utils/react/useScheme.js

@@ -1,6 +1,5 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { useSyncExternalStore } from "react";
-
 //#region src/utils/react/useScheme.ts
 /**
 * The ambient viewing conditions — the color scheme and the contrast tier the
@@ -176,7 +175,7 @@ function useScheme() {
 function useHighContrast() {
 	return useSyncExternalStore(subscribeScheme, resolveHighContrast, getServerHighContrast);
 }
-
 //#endregion
 export { AMBIENT_PREDEFINED_STATES, resolveHighContrast, resolveScheme, subscribeScheme, useHighContrast, useScheme };
+
 //# sourceMappingURL=useScheme.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useScheme.js","names":["useSyncExternalStore","SCHEME_KEY","CONTRAST_KEY","SCHEME_ATTR","CONTRAST_ATTR","DARK_QUERY","HIGH_CONTRAST_QUERY","AMBIENT_PREDEFINED_STATES","const","ColorScheme","mediaMatches","query","window","matchMedia","matches","rootAttribute","name","document","documentElement","getAttribute","resolveScheme","attribute","resolveHighContrast","listeners","Set","stopWatching","notify","forEach","listener","startWatching","teardowns","list","addEventListener","push","removeEventListener","MutationObserver","observer","observe","attributes","attributeFilter","disconnect","teardown","subscribeScheme","add","delete","size","getServerScheme","getServerHighContrast","useScheme","useHighContrast"],"sources":["../../../src/utils/react/useScheme.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\n/**\n * The ambient viewing conditions — the color scheme and the contrast tier the\n * document is showing right now.\n *\n * This module is the single owner of the definition: it builds the `@dark` /\n * `@hc` predefined states that `src/components/Root.tsx` registers with tasty,\n * *and* it answers the same question in JS. One definition, two readers, so the\n * CSS and the JS answers cannot drift apart.\n *\n * **For styling, do not use this.** `{ '': light, '@dark': dark, '@hc': hc }` is\n * the answer, and branching styles in JS gives up the conditionality that lets a\n * scheme flip repaint without a re-render. Two cases the state map cannot serve:\n *\n * 1. **Surfaces the stylesheet does not reach** — a Vega spec, a CodeMirror or\n *    Monaco theme, a third-party iframe. They take values, not CSS, so `@dark`\n *    never applies and the branch has to happen in JS.\n * 2. **Control state that is not styling** — seeding or labelling a control from\n *    the ambient condition, e.g. a Light/Dark or Normal/High-contrast preview\n *    selector that starts on whatever the page is already showing.\n *\n * Root-level only, and deliberately not a generic state reader: tasty's state\n * vocabulary mixes element-local states (`hovered`, `pressed`, `disabled`) with\n * ambient ones (`@media(…)`, `@root(…)`), and only the ambient half is\n * answerable without an element. Evaluating the state language in JS would mean\n * a second implementation of the state algebra to keep in agreement with the CSS\n * one, for a question almost every caller asks about the root anyway.\n */\n\n// ============================================================================\n// The definition\n// ============================================================================\n\n/**\n * The `data-*` attribute names the opt-in uses, and the media queries it falls\n * back to. `@root(scheme=dark)` compiles to `:root[data-scheme=\"dark\"]`, hence\n * the `data-` prefix on the DOM side and the bare key on the tasty side.\n */\nconst SCHEME_KEY = 'scheme';\nconst CONTRAST_KEY = 'contrast';\nconst SCHEME_ATTR = `data-${SCHEME_KEY}`;\nconst CONTRAST_ATTR = `data-${CONTRAST_KEY}`;\nconst DARK_QUERY = '(prefers-color-scheme: dark)';\nconst HIGH_CONTRAST_QUERY = '(prefers-contrast: more)';\n\n/**\n * The `@dark` / `@hc` state aliases, in tasty's DSL — registered globally by\n * `<Root>` via `setGlobalPredefinedStates()`.\n *\n * The attribute opt-in wins over the system preference, and the fallback is\n * gated on the attribute being *absent* (`!@root(scheme)`) rather than on it\n * being some other value — so `<html data-scheme=\"light\">` stays light inside a\n * dark OS, which is the whole point of an opt-in. {@link resolveScheme} and\n * {@link resolveHighContrast} read the same way.\n */\nexport const AMBIENT_PREDEFINED_STATES = {\n  '@dark': `@root(${SCHEME_KEY}=dark) | (!@root(${SCHEME_KEY}) & @media${DARK_QUERY})`,\n  '@hc': `@root(${CONTRAST_KEY}=high) | (!@root(${CONTRAST_KEY}) & @media${HIGH_CONTRAST_QUERY})`,\n} as const;\n\n/** The color scheme the document resolves to — the two arms of the `@dark` state. */\nexport type ColorScheme = 'light' | 'dark';\n\n// ============================================================================\n// Reading\n// ============================================================================\n\n/**\n * `matchMedia` is called per read rather than cached, so a test that stubs it\n * takes effect immediately. Missing (older jsdom, non-DOM runtimes) reads as\n * \"no preference\", which lands on the light / normal-contrast defaults.\n */\nfunction mediaMatches(query: string): boolean {\n  return typeof window !== 'undefined' &&\n    typeof window.matchMedia === 'function'\n    ? window.matchMedia(query).matches\n    : false;\n}\n\nfunction rootAttribute(name: string): string | null {\n  return typeof document === 'undefined'\n    ? null\n    : document.documentElement.getAttribute(name);\n}\n\n/**\n * The document's current color scheme, read once — the JS answer to `@dark`.\n *\n * Outside React (a chart spec built in a module, an editor theme registered at\n * import time). In React use {@link useScheme}, which also re-renders on change.\n * Returns `'light'` with no DOM.\n */\nexport function resolveScheme(): ColorScheme {\n  const attribute = rootAttribute(SCHEME_ATTR);\n\n  if (attribute !== null) {\n    return attribute === 'dark' ? 'dark' : 'light';\n  }\n\n  return mediaMatches(DARK_QUERY) ? 'dark' : 'light';\n}\n\n/**\n * Whether the document is showing the high-contrast tier, read once — the JS\n * answer to `@hc`.\n *\n * Note this is an *ambient* condition, not the theme's `contrastLevel`: the\n * level is a `PaletteConfig` seed the app supplies (read it with\n * `getPaletteConfig()`), while this is the tier the viewer asked for.\n * Returns `false` with no DOM.\n */\nexport function resolveHighContrast(): boolean {\n  const attribute = rootAttribute(CONTRAST_ATTR);\n\n  if (attribute !== null) {\n    return attribute === 'high';\n  }\n\n  return mediaMatches(HIGH_CONTRAST_QUERY);\n}\n\n// ============================================================================\n// Watching\n// ============================================================================\n\nconst listeners = new Set<() => void>();\n\nlet stopWatching: (() => void) | null = null;\n\nfunction notify() {\n  listeners.forEach((listener) => listener());\n}\n\n/**\n * Both inputs have to be watched, because either can decide the answer: the\n * attribute when the opt-in is set, the media query otherwise — an attribute flip\n * is invisible to `matchMedia` and a system flip is invisible to a\n * `MutationObserver`. One observer and one pair of query listeners are shared by\n * every subscriber, and torn down when the last one leaves.\n */\nfunction startWatching(): () => void {\n  if (typeof document === 'undefined') {\n    return () => {};\n  }\n\n  const teardowns: (() => void)[] = [];\n\n  // Guarded rather than assumed: jsdom ships neither `matchMedia` nor a\n  // `MediaQueryList` in every version, and a consumer's unit tests are exactly\n  // where a hook like this gets mounted. Losing one source of change is a stale\n  // value; throwing is a broken render.\n  if (\n    typeof window !== 'undefined' &&\n    typeof window.matchMedia === 'function'\n  ) {\n    for (const query of [DARK_QUERY, HIGH_CONTRAST_QUERY]) {\n      const list = window.matchMedia(query);\n\n      if (typeof list?.addEventListener !== 'function') continue;\n\n      list.addEventListener('change', notify);\n      teardowns.push(() => list.removeEventListener('change', notify));\n    }\n  }\n\n  if (typeof MutationObserver === 'function' && document.documentElement) {\n    const observer = new MutationObserver(notify);\n\n    observer.observe(document.documentElement, {\n      attributes: true,\n      attributeFilter: [SCHEME_ATTR, CONTRAST_ATTR],\n    });\n\n    teardowns.push(() => observer.disconnect());\n  }\n\n  return () => teardowns.forEach((teardown) => teardown());\n}\n\n/**\n * Subscribe to ambient condition changes — either the scheme or the contrast\n * tier. Returns an unsubscribe function.\n *\n * The listener takes no argument: re-read with {@link resolveScheme} /\n * {@link resolveHighContrast}, which is what the hooks below do. For non-React\n * consumers that own a surface the stylesheet cannot reach — re-theming a Monaco\n * instance, re-rendering a chart.\n */\nexport function subscribeScheme(listener: () => void): () => void {\n  listeners.add(listener);\n\n  if (!stopWatching) {\n    stopWatching = startWatching();\n  }\n\n  return () => {\n    listeners.delete(listener);\n\n    if (!listeners.size && stopWatching) {\n      stopWatching();\n      stopWatching = null;\n    }\n  };\n}\n\n// ============================================================================\n// React bindings\n// ============================================================================\n\n/**\n * Snapshots are primitives, so React bails out on an unchanged value and no\n * memoization is needed — a contrast change re-runs a `useScheme()` reader's\n * `getSnapshot` and stops there.\n */\nconst getServerScheme = (): ColorScheme => 'light';\nconst getServerHighContrast = () => false;\n\n/**\n * The document's color scheme, kept live — `'light'` or `'dark'`.\n *\n * ```tsx\n * const scheme = useScheme();\n *\n * <VegaChart spec={useMemo(() => buildSpec(scheme), [scheme])} />;\n * ```\n *\n * Follows both the `<html data-scheme>` opt-in and `prefers-color-scheme`,\n * exactly as the `@dark` state does. Under SSR it renders `'light'` and\n * re-renders with the real value after hydration.\n */\nexport function useScheme(): ColorScheme {\n  return useSyncExternalStore(subscribeScheme, resolveScheme, getServerScheme);\n}\n\n/**\n * Whether the document is showing the high-contrast tier, kept live — the hook\n * form of {@link resolveHighContrast}, following `<html data-contrast>` and\n * `prefers-contrast` exactly as the `@hc` state does.\n *\n * Under SSR it renders `false` and re-renders with the real value after\n * hydration.\n */\nexport function useHighContrast(): boolean {\n  return useSyncExternalStore(\n    subscribeScheme,\n    resolveHighContrast,\n    getServerHighContrast,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,MAAMC,aAAa;AACnB,MAAMC,eAAe;AACrB,MAAMC,cAAc,QAAQF;AAC5B,MAAMG,gBAAgB,QAAQF;AAC9B,MAAMG,aAAa;AACnB,MAAMC,sBAAsB;;;;;;;;;;;AAY5B,MAAaC,4BAA4B;CACvC,SAAS,SAASN,WAAU,mBAAoBA,WAAU,YAAaI,WAAU;CACjF,OAAO,SAASH,aAAY,mBAAoBA,aAAY,YAAaI,oBAAmB;CAC7F;;;;;;AAcD,SAASI,aAAaC,OAAwB;AAC5C,QAAO,OAAOC,WAAW,eACvB,OAAOA,OAAOC,eAAe,aAC3BD,OAAOC,WAAWF,MAAM,CAACG,UACzB;;AAGN,SAASC,cAAcC,MAA6B;AAClD,QAAO,OAAOC,aAAa,cACvB,OACAA,SAASC,gBAAgBC,aAAaH,KAAK;;;;;;;;;AAUjD,SAAgBI,gBAA6B;CAC3C,MAAMC,YAAYN,cAAcZ,YAAY;AAE5C,KAAIkB,cAAc,KAChB,QAAOA,cAAc,SAAS,SAAS;AAGzC,QAAOX,aAAaL,WAAW,GAAG,SAAS;;;;;;;;;;;AAY7C,SAAgBiB,sBAA+B;CAC7C,MAAMD,YAAYN,cAAcX,cAAc;AAE9C,KAAIiB,cAAc,KAChB,QAAOA,cAAc;AAGvB,QAAOX,aAAaJ,oBAAoB;;AAO1C,MAAMiB,4BAAY,IAAIC,KAAiB;AAEvC,IAAIC,eAAoC;AAExC,SAASC,SAAS;AAChBH,WAAUI,SAASC,aAAaA,UAAU,CAAC;;;;;;;;;AAU7C,SAASC,gBAA4B;AACnC,KAAI,OAAOZ,aAAa,YACtB,cAAa;CAGf,MAAMa,YAA4B,EAAE;AAMpC,KACE,OAAOlB,WAAW,eAClB,OAAOA,OAAOC,eAAe,WAE7B,MAAK,MAAMF,SAAS,CAACN,YAAYC,oBAAoB,EAAE;EACrD,MAAMyB,OAAOnB,OAAOC,WAAWF,MAAM;AAErC,MAAI,OAAOoB,MAAMC,qBAAqB,WAAY;AAElDD,OAAKC,iBAAiB,UAAUN,OAAO;AACvCI,YAAUG,WAAWF,KAAKG,oBAAoB,UAAUR,OAAO,CAAC;;AAIpE,KAAI,OAAOS,qBAAqB,cAAclB,SAASC,iBAAiB;EACtE,MAAMkB,WAAW,IAAID,iBAAiBT,OAAO;AAE7CU,WAASC,QAAQpB,SAASC,iBAAiB;GACzCoB,YAAY;GACZC,iBAAiB,CAACpC,aAAaC,cAAa;GAC7C,CAAC;AAEF0B,YAAUG,WAAWG,SAASI,YAAY,CAAC;;AAG7C,cAAaV,UAAUH,SAASc,aAAaA,UAAU,CAAC;;;;;;;;;;;AAY1D,SAAgBC,gBAAgBd,UAAkC;AAChEL,WAAUoB,IAAIf,SAAS;AAEvB,KAAI,CAACH,aACHA,gBAAeI,eAAe;AAGhC,cAAa;AACXN,YAAUqB,OAAOhB,SAAS;AAE1B,MAAI,CAACL,UAAUsB,QAAQpB,cAAc;AACnCA,iBAAc;AACdA,kBAAe;;;;;;;;;AAcrB,MAAMqB,wBAAqC;AAC3C,MAAMC,8BAA8B;;;;;;;;;;;;;;AAepC,SAAOC,YAAA;AAAA,QACEhD,qBAAqB0C,iBAAiBtB,eAAe0B,gBAAgB;;;;;;;;;;AAW9E,SAAOG,kBAAA;AAAA,QACEjD,qBACL0C,iBACApB,qBACAyB,sBACD"}
+{"version":3,"file":"useScheme.js","names":["useSyncExternalStore","SCHEME_KEY","CONTRAST_KEY","SCHEME_ATTR","CONTRAST_ATTR","DARK_QUERY","HIGH_CONTRAST_QUERY","AMBIENT_PREDEFINED_STATES","const","ColorScheme","mediaMatches","query","window","matchMedia","matches","rootAttribute","name","document","documentElement","getAttribute","resolveScheme","attribute","resolveHighContrast","listeners","Set","stopWatching","notify","forEach","listener","startWatching","teardowns","list","addEventListener","push","removeEventListener","MutationObserver","observer","observe","attributes","attributeFilter","disconnect","teardown","subscribeScheme","add","delete","size","getServerScheme","getServerHighContrast","useScheme","useHighContrast"],"sources":["../../../src/utils/react/useScheme.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\n/**\n * The ambient viewing conditions — the color scheme and the contrast tier the\n * document is showing right now.\n *\n * This module is the single owner of the definition: it builds the `@dark` /\n * `@hc` predefined states that `src/components/Root.tsx` registers with tasty,\n * *and* it answers the same question in JS. One definition, two readers, so the\n * CSS and the JS answers cannot drift apart.\n *\n * **For styling, do not use this.** `{ '': light, '@dark': dark, '@hc': hc }` is\n * the answer, and branching styles in JS gives up the conditionality that lets a\n * scheme flip repaint without a re-render. Two cases the state map cannot serve:\n *\n * 1. **Surfaces the stylesheet does not reach** — a Vega spec, a CodeMirror or\n *    Monaco theme, a third-party iframe. They take values, not CSS, so `@dark`\n *    never applies and the branch has to happen in JS.\n * 2. **Control state that is not styling** — seeding or labelling a control from\n *    the ambient condition, e.g. a Light/Dark or Normal/High-contrast preview\n *    selector that starts on whatever the page is already showing.\n *\n * Root-level only, and deliberately not a generic state reader: tasty's state\n * vocabulary mixes element-local states (`hovered`, `pressed`, `disabled`) with\n * ambient ones (`@media(…)`, `@root(…)`), and only the ambient half is\n * answerable without an element. Evaluating the state language in JS would mean\n * a second implementation of the state algebra to keep in agreement with the CSS\n * one, for a question almost every caller asks about the root anyway.\n */\n\n// ============================================================================\n// The definition\n// ============================================================================\n\n/**\n * The `data-*` attribute names the opt-in uses, and the media queries it falls\n * back to. `@root(scheme=dark)` compiles to `:root[data-scheme=\"dark\"]`, hence\n * the `data-` prefix on the DOM side and the bare key on the tasty side.\n */\nconst SCHEME_KEY = 'scheme';\nconst CONTRAST_KEY = 'contrast';\nconst SCHEME_ATTR = `data-${SCHEME_KEY}`;\nconst CONTRAST_ATTR = `data-${CONTRAST_KEY}`;\nconst DARK_QUERY = '(prefers-color-scheme: dark)';\nconst HIGH_CONTRAST_QUERY = '(prefers-contrast: more)';\n\n/**\n * The `@dark` / `@hc` state aliases, in tasty's DSL — registered globally by\n * `<Root>` via `setGlobalPredefinedStates()`.\n *\n * The attribute opt-in wins over the system preference, and the fallback is\n * gated on the attribute being *absent* (`!@root(scheme)`) rather than on it\n * being some other value — so `<html data-scheme=\"light\">` stays light inside a\n * dark OS, which is the whole point of an opt-in. {@link resolveScheme} and\n * {@link resolveHighContrast} read the same way.\n */\nexport const AMBIENT_PREDEFINED_STATES = {\n  '@dark': `@root(${SCHEME_KEY}=dark) | (!@root(${SCHEME_KEY}) & @media${DARK_QUERY})`,\n  '@hc': `@root(${CONTRAST_KEY}=high) | (!@root(${CONTRAST_KEY}) & @media${HIGH_CONTRAST_QUERY})`,\n} as const;\n\n/** The color scheme the document resolves to — the two arms of the `@dark` state. */\nexport type ColorScheme = 'light' | 'dark';\n\n// ============================================================================\n// Reading\n// ============================================================================\n\n/**\n * `matchMedia` is called per read rather than cached, so a test that stubs it\n * takes effect immediately. Missing (older jsdom, non-DOM runtimes) reads as\n * \"no preference\", which lands on the light / normal-contrast defaults.\n */\nfunction mediaMatches(query: string): boolean {\n  return typeof window !== 'undefined' &&\n    typeof window.matchMedia === 'function'\n    ? window.matchMedia(query).matches\n    : false;\n}\n\nfunction rootAttribute(name: string): string | null {\n  return typeof document === 'undefined'\n    ? null\n    : document.documentElement.getAttribute(name);\n}\n\n/**\n * The document's current color scheme, read once — the JS answer to `@dark`.\n *\n * Outside React (a chart spec built in a module, an editor theme registered at\n * import time). In React use {@link useScheme}, which also re-renders on change.\n * Returns `'light'` with no DOM.\n */\nexport function resolveScheme(): ColorScheme {\n  const attribute = rootAttribute(SCHEME_ATTR);\n\n  if (attribute !== null) {\n    return attribute === 'dark' ? 'dark' : 'light';\n  }\n\n  return mediaMatches(DARK_QUERY) ? 'dark' : 'light';\n}\n\n/**\n * Whether the document is showing the high-contrast tier, read once — the JS\n * answer to `@hc`.\n *\n * Note this is an *ambient* condition, not the theme's `contrastLevel`: the\n * level is a `PaletteConfig` seed the app supplies (read it with\n * `getPaletteConfig()`), while this is the tier the viewer asked for.\n * Returns `false` with no DOM.\n */\nexport function resolveHighContrast(): boolean {\n  const attribute = rootAttribute(CONTRAST_ATTR);\n\n  if (attribute !== null) {\n    return attribute === 'high';\n  }\n\n  return mediaMatches(HIGH_CONTRAST_QUERY);\n}\n\n// ============================================================================\n// Watching\n// ============================================================================\n\nconst listeners = new Set<() => void>();\n\nlet stopWatching: (() => void) | null = null;\n\nfunction notify() {\n  listeners.forEach((listener) => listener());\n}\n\n/**\n * Both inputs have to be watched, because either can decide the answer: the\n * attribute when the opt-in is set, the media query otherwise — an attribute flip\n * is invisible to `matchMedia` and a system flip is invisible to a\n * `MutationObserver`. One observer and one pair of query listeners are shared by\n * every subscriber, and torn down when the last one leaves.\n */\nfunction startWatching(): () => void {\n  if (typeof document === 'undefined') {\n    return () => {};\n  }\n\n  const teardowns: (() => void)[] = [];\n\n  // Guarded rather than assumed: jsdom ships neither `matchMedia` nor a\n  // `MediaQueryList` in every version, and a consumer's unit tests are exactly\n  // where a hook like this gets mounted. Losing one source of change is a stale\n  // value; throwing is a broken render.\n  if (\n    typeof window !== 'undefined' &&\n    typeof window.matchMedia === 'function'\n  ) {\n    for (const query of [DARK_QUERY, HIGH_CONTRAST_QUERY]) {\n      const list = window.matchMedia(query);\n\n      if (typeof list?.addEventListener !== 'function') continue;\n\n      list.addEventListener('change', notify);\n      teardowns.push(() => list.removeEventListener('change', notify));\n    }\n  }\n\n  if (typeof MutationObserver === 'function' && document.documentElement) {\n    const observer = new MutationObserver(notify);\n\n    observer.observe(document.documentElement, {\n      attributes: true,\n      attributeFilter: [SCHEME_ATTR, CONTRAST_ATTR],\n    });\n\n    teardowns.push(() => observer.disconnect());\n  }\n\n  return () => teardowns.forEach((teardown) => teardown());\n}\n\n/**\n * Subscribe to ambient condition changes — either the scheme or the contrast\n * tier. Returns an unsubscribe function.\n *\n * The listener takes no argument: re-read with {@link resolveScheme} /\n * {@link resolveHighContrast}, which is what the hooks below do. For non-React\n * consumers that own a surface the stylesheet cannot reach — re-theming a Monaco\n * instance, re-rendering a chart.\n */\nexport function subscribeScheme(listener: () => void): () => void {\n  listeners.add(listener);\n\n  if (!stopWatching) {\n    stopWatching = startWatching();\n  }\n\n  return () => {\n    listeners.delete(listener);\n\n    if (!listeners.size && stopWatching) {\n      stopWatching();\n      stopWatching = null;\n    }\n  };\n}\n\n// ============================================================================\n// React bindings\n// ============================================================================\n\n/**\n * Snapshots are primitives, so React bails out on an unchanged value and no\n * memoization is needed — a contrast change re-runs a `useScheme()` reader's\n * `getSnapshot` and stops there.\n */\nconst getServerScheme = (): ColorScheme => 'light';\nconst getServerHighContrast = () => false;\n\n/**\n * The document's color scheme, kept live — `'light'` or `'dark'`.\n *\n * ```tsx\n * const scheme = useScheme();\n *\n * <VegaChart spec={useMemo(() => buildSpec(scheme), [scheme])} />;\n * ```\n *\n * Follows both the `<html data-scheme>` opt-in and `prefers-color-scheme`,\n * exactly as the `@dark` state does. Under SSR it renders `'light'` and\n * re-renders with the real value after hydration.\n */\nexport function useScheme(): ColorScheme {\n  return useSyncExternalStore(subscribeScheme, resolveScheme, getServerScheme);\n}\n\n/**\n * Whether the document is showing the high-contrast tier, kept live — the hook\n * form of {@link resolveHighContrast}, following `<html data-contrast>` and\n * `prefers-contrast` exactly as the `@hc` state does.\n *\n * Under SSR it renders `false` and re-renders with the real value after\n * hydration.\n */\nexport function useHighContrast(): boolean {\n  return useSyncExternalStore(\n    subscribeScheme,\n    resolveHighContrast,\n    getServerHighContrast,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,MAAMC,aAAa;AACnB,MAAMC,eAAe;AACrB,MAAMC,cAAc,QAAQF;AAC5B,MAAMG,gBAAgB,QAAQF;AAC9B,MAAMG,aAAa;AACnB,MAAMC,sBAAsB;;;;;;;;;;;AAY5B,MAAaC,4BAA4B;CACvC,SAAS,SAASN,WAAU,mBAAoBA,WAAU,YAAaI,WAAU;CACjF,OAAO,SAASH,aAAY,mBAAoBA,aAAY,YAAaI,oBAAmB;AAC9F;;;;;;AAcA,SAASI,aAAaC,OAAwB;CAC5C,OAAO,OAAOC,WAAW,eACvB,OAAOA,OAAOC,eAAe,aAC3BD,OAAOC,WAAWF,KAAK,CAAC,CAACG,UACzB;AACN;AAEA,SAASC,cAAcC,MAA6B;CAClD,OAAO,OAAOC,aAAa,cACvB,OACAA,SAASC,gBAAgBC,aAAaH,IAAI;AAChD;;;;;;;;AASA,SAAgBI,gBAA6B;CAC3C,MAAMC,YAAYN,cAAcZ,WAAW;CAE3C,IAAIkB,cAAc,MAChB,OAAOA,cAAc,SAAS,SAAS;CAGzC,OAAOX,aAAaL,UAAU,IAAI,SAAS;AAC7C;;;;;;;;;;AAWA,SAAgBiB,sBAA+B;CAC7C,MAAMD,YAAYN,cAAcX,aAAa;CAE7C,IAAIiB,cAAc,MAChB,OAAOA,cAAc;CAGvB,OAAOX,aAAaJ,mBAAmB;AACzC;AAMA,MAAMiB,4BAAY,IAAIC,IAAgB;AAEtC,IAAIC,eAAoC;AAExC,SAASC,SAAS;CAChBH,UAAUI,SAASC,aAAaA,SAAS,CAAC;AAC5C;;;;;;;;AASA,SAASC,gBAA4B;CACnC,IAAI,OAAOZ,aAAa,aACtB,aAAa,CAAC;CAGhB,MAAMa,YAA4B,CAAA;CAMlC,IACE,OAAOlB,WAAW,eAClB,OAAOA,OAAOC,eAAe,YAE7B,KAAK,MAAMF,SAAS,CAACN,YAAYC,mBAAmB,GAAG;EACrD,MAAMyB,OAAOnB,OAAOC,WAAWF,KAAK;EAEpC,IAAI,OAAOoB,MAAMC,qBAAqB,YAAY;EAElDD,KAAKC,iBAAiB,UAAUN,MAAM;EACtCI,UAAUG,WAAWF,KAAKG,oBAAoB,UAAUR,MAAM,CAAC;CACjE;CAGF,IAAI,OAAOS,qBAAqB,cAAclB,SAASC,iBAAiB;EACtE,MAAMkB,WAAW,IAAID,iBAAiBT,MAAM;EAE5CU,SAASC,QAAQpB,SAASC,iBAAiB;GACzCoB,YAAY;GACZC,iBAAiB,CAACpC,aAAaC,aAAa;EAC9C,CAAC;EAED0B,UAAUG,WAAWG,SAASI,WAAW,CAAC;CAC5C;CAEA,aAAaV,UAAUH,SAASc,aAAaA,SAAS,CAAC;AACzD;;;;;;;;;;AAWA,SAAgBC,gBAAgBd,UAAkC;CAChEL,UAAUoB,IAAIf,QAAQ;CAEtB,IAAI,CAACH,cACHA,eAAeI,cAAc;CAG/B,aAAa;EACXN,UAAUqB,OAAOhB,QAAQ;EAEzB,IAAI,CAACL,UAAUsB,QAAQpB,cAAc;GACnCA,aAAa;GACbA,eAAe;EACjB;CACF;AACF;;;;;;AAWA,MAAMqB,wBAAqC;AAC3C,MAAMC,8BAA8B;;;;;;;;;;;;;;AAepC,SAAOC,YAAA;CAAA,OACEhD,qBAAqB0C,iBAAiBtB,eAAe0B,eAAe;AAAC;;;;;;;;;AAW9E,SAAOG,kBAAA;CAAA,OACEjD,qBACL0C,iBACApB,qBACAyB,qBACF;AAAC"}

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

@@ -4,10 +4,10 @@ interface ViewportSize {
   width: number;
   height: number;
 }
-type ViewportSizeParams = {
+export type ViewportSizeParams = {
   isDisabled?: boolean;
 };
-declare function useViewportSize(params?: ViewportSizeParams): ViewportSize;
+export declare function useViewportSize(params?: ViewportSizeParams): ViewportSize;
 //#endregion
-export { useViewportSize };
+export {};
 //# sourceMappingURL=useViewportSize.d.ts.map

package/dist/utils/react/useViewportSize.js

@@ -1,7 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { c } from "react/compiler-runtime";
 import { useEffect, useState } from "react";
-
 //#region src/utils/react/useViewportSize.ts
 let visualViewport = typeof window !== "undefined" && window.visualViewport;
 function useViewportSize(t0) {
@@ -54,7 +53,7 @@ function getViewportSize() {
 		height: visualViewport && visualViewport.height || (typeof window !== "undefined" ? window.innerHeight : 0)
 	};
 }
-
 //#endregion
 export { useViewportSize };
+
 //# sourceMappingURL=useViewportSize.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useViewportSize.js","names":["useEffect","useState","ViewportSize","width","height","visualViewport","window","ViewportSizeParams","isDisabled","useViewportSize","t0","$","_c","t1","undefined","params","size","setSize","_temp","t2","t3","onResize","_temp2","addEventListener","removeEventListener","size_0","newSize","getViewportSize","innerWidth","innerHeight"],"sources":["../../../src/utils/react/useViewportSize.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\ninterface ViewportSize {\n  width: number;\n  height: number;\n}\n\nlet visualViewport = typeof window !== 'undefined' && window.visualViewport;\n\nexport type ViewportSizeParams = {\n  isDisabled?: boolean;\n};\nexport function useViewportSize(params: ViewportSizeParams = {}): ViewportSize {\n  const { isDisabled } = params;\n\n  let [size, setSize] = useState(() => getViewportSize());\n\n  useEffect(() => {\n    if (isDisabled) {\n      return;\n    }\n    // Use visualViewport api to track available height even on iOS virtual keyboard opening\n    let onResize = () => {\n      setSize((size) => {\n        let newSize = getViewportSize();\n        if (newSize.width === size.width && newSize.height === size.height) {\n          return size;\n        }\n        return newSize;\n      });\n    };\n\n    if (!visualViewport) {\n      window.addEventListener('resize', onResize);\n    } else {\n      visualViewport.addEventListener('resize', onResize);\n    }\n\n    return () => {\n      if (!visualViewport) {\n        window.removeEventListener('resize', onResize);\n      } else {\n        visualViewport.removeEventListener('resize', onResize);\n      }\n    };\n  }, [isDisabled]);\n\n  return size;\n}\n\nfunction getViewportSize(): ViewportSize {\n  return {\n    width:\n      (visualViewport && visualViewport.width) ||\n      (typeof window !== 'undefined' ? window.innerWidth : 0),\n    height:\n      (visualViewport && visualViewport.height) ||\n      (typeof window !== 'undefined' ? window.innerHeight : 0),\n  };\n}\n"],"mappings":";;;;;AAOA,IAAIK,iBAAiB,OAAOC,WAAW,eAAeA,OAAOD;AAK7D,SAAOI,gBAAAC,IAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAAA,IAAAC;AAAA,KAAAF,EAAA,OAAAD,IAAA;AAAyBG,OAAAH,OAAAI,SAAA,EAA+B,GAA/BJ;AAA+BC,IAAA,KAAAD;AAAAC,IAAA,KAAAE;OAAAA,MAAAF,EAAA;CAC7D,MAAA,EAAAH,eAD8BK;CAG9B,MAAA,CAAAG,MAAAC,WAAsBhB,SAASiB,MAAwB;CAAC,IAAAC;CAAA,IAAAC;AAAA,KAAAT,EAAA,OAAAH,YAAA;AAE9CW,aAAA;AACR,OAAIX,WAAU;GAId,MAAAa,iBAAe;AACbJ,YAAQK,OAMN;;AAGJ,OAAI,CAACjB,eACHC,QAAMiB,iBAAkB,UAAUF,SAAS;OAE3ChB,gBAAckB,iBAAkB,UAAUF,SAAS;AACpD,gBAEM;AACL,QAAI,CAAChB,eACHC,QAAMkB,oBAAqB,UAAUH,SAAS;QAE9ChB,gBAAcmB,oBAAqB,UAAUH,SAAS;;;AAGzDD,OAAA,CAACZ,WAAW;AAAAG,IAAA,KAAAH;AAAAG,IAAA,KAAAQ;AAAAR,IAAA,KAAAS;QAAA;AAAAD,OAAAR,EAAA;AAAAS,OAAAT,EAAA;;AA5BfX,WAAUmB,IA4BPC,GAAa;AAAA,QAETJ;;AAnCF,SAAAM,OAAAG,QAAA;CAYC,MAAAC,UAAcC,iBAAiB;AAC/B,KAAID,QAAOvB,UAAWa,OAAIb,SAAUuB,QAAOtB,WAAYY,OAAIZ,OAAO,QACzDY;AACR,QACMU;;AAhBR,SAAAR,QAAA;AAAA,QAGgCS,iBAAiB;;AAmCxD,SAASA,kBAAgC;AACvC,QAAO;EACLxB,OACGE,kBAAkBA,eAAeF,UACjC,OAAOG,WAAW,cAAcA,OAAOsB,aAAa;EACvDxB,QACGC,kBAAkBA,eAAeD,WACjC,OAAOE,WAAW,cAAcA,OAAOuB,cAAc;EACzD"}
+{"version":3,"file":"useViewportSize.js","names":["useEffect","useState","ViewportSize","width","height","visualViewport","window","ViewportSizeParams","isDisabled","useViewportSize","t0","$","_c","t1","undefined","params","size","setSize","_temp","t2","t3","onResize","_temp2","addEventListener","removeEventListener","size_0","newSize","getViewportSize","innerWidth","innerHeight","_c","params"],"sources":["../../../src/utils/react/useViewportSize.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\ninterface ViewportSize {\n  width: number;\n  height: number;\n}\n\nlet visualViewport = typeof window !== 'undefined' && window.visualViewport;\n\nexport type ViewportSizeParams = {\n  isDisabled?: boolean;\n};\nexport function useViewportSize(params: ViewportSizeParams = {}): ViewportSize {\n  const { isDisabled } = params;\n\n  let [size, setSize] = useState(() => getViewportSize());\n\n  useEffect(() => {\n    if (isDisabled) {\n      return;\n    }\n    // Use visualViewport api to track available height even on iOS virtual keyboard opening\n    let onResize = () => {\n      setSize((size) => {\n        let newSize = getViewportSize();\n        if (newSize.width === size.width && newSize.height === size.height) {\n          return size;\n        }\n        return newSize;\n      });\n    };\n\n    if (!visualViewport) {\n      window.addEventListener('resize', onResize);\n    } else {\n      visualViewport.addEventListener('resize', onResize);\n    }\n\n    return () => {\n      if (!visualViewport) {\n        window.removeEventListener('resize', onResize);\n      } else {\n        visualViewport.removeEventListener('resize', onResize);\n      }\n    };\n  }, [isDisabled]);\n\n  return size;\n}\n\nfunction getViewportSize(): ViewportSize {\n  return {\n    width:\n      (visualViewport && visualViewport.width) ||\n      (typeof window !== 'undefined' ? window.innerWidth : 0),\n    height:\n      (visualViewport && visualViewport.height) ||\n      (typeof window !== 'undefined' ? window.innerHeight : 0),\n  };\n}\n"],"mappings":";;;;AAOA,IAAIK,iBAAiB,OAAOC,WAAW,eAAeA,OAAOD;AAK7D,SAAOI,gBAAAC,IAAA;CAAA,MAAAC,IAAAC,EAAA,CAAA;CAAA,IAAAC;CAAA,IAAAF,EAAA,OAAAD,IAAA;EAAyBG,KAAAH,OAAAI,KAAAA,IAAA,CAA8B,IAA9BJ;EAA+BC,EAAA,KAAAD;EAAAC,EAAA,KAAAE;CAAA,OAAAA,KAAAF,EAAA;CAC7D,MAAA,EAAAH,eAAuBO;CAEvB,MAAA,CAAAC,MAAAC,WAAsBhB,SAASiB,KAAuB;CAAE,IAAAC;CAAA,IAAAC;CAAA,IAAAT,EAAA,OAAAH,YAAA;EAE9CW,WAAA;GACR,IAAIX,YAAU;GAId,MAAAa,iBAAe;IACbJ,QAAQK,MAMP;GAAC;GAGJ,IAAI,CAACjB,gBACHC,OAAMiB,iBAAkB,UAAUF,QAAQ;QAE1ChB,eAAckB,iBAAkB,UAAUF,QAAQ;GACnD,aAEM;IACL,IAAI,CAAChB,gBACHC,OAAMkB,oBAAqB,UAAUH,QAAQ;SAE7ChB,eAAcmB,oBAAqB,UAAUH,QAAQ;GACtD;EACF;EACAD,KAAA,CAACZ,UAAU;EAACG,EAAA,KAAAH;EAAAG,EAAA,KAAAQ;EAAAR,EAAA,KAAAS;CAAA,OAAA;EAAAD,KAAAR,EAAA;EAAAS,KAAAT,EAAA;CAAA;CA5BfX,UAAUmB,IA4BPC,EAAY;CAAC,OAETJ;AAAI;AAnCN,SAAAM,OAAAG,QAAA;CAYC,MAAAC,UAAcC,gBAAgB;CAC9B,IAAID,QAAOvB,UAAWa,OAAIb,SAAUuB,QAAOtB,WAAYY,OAAIZ,QAAO,OACzDY;CACR,OACMU;AAAO;AAhBf,SAAAR,QAAA;CAAA,OAGgCS,gBAAgB;AAAC;AAmCxD,SAASA,kBAAgC;CACvC,OAAO;EACLxB,OACGE,kBAAkBA,eAAeF,UACjC,OAAOG,WAAW,cAAcA,OAAOsB,aAAa;EACvDxB,QACGC,kBAAkBA,eAAeD,WACjC,OAAOE,WAAW,cAAcA,OAAOuB,cAAc;CAC1D;AACF"}

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

@@ -1,8 +1,6 @@
 
 import { ReactNode } from "react";
-
 //#region src/utils/react/wrapNodeIfPlain.d.ts
-declare function wrapNodeIfPlain(children: ReactNode, render: () => ReactNode): ReactNode;
+export declare function wrapNodeIfPlain(children: ReactNode, render: () => ReactNode): ReactNode;
 //#endregion
-export { wrapNodeIfPlain };
 //# sourceMappingURL=wrapNodeIfPlain.d.ts.map

package/dist/utils/react/wrapNodeIfPlain.js

@@ -1,13 +1,12 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { Fragment, isValidElement } from "react";
-
 //#region src/utils/react/wrapNodeIfPlain.ts
 function wrapNodeIfPlain(children, render) {
 	const childrenIsFragment = Array.isArray(children) || isValidElement(children) && children.type === Fragment;
 	if (!children || !childrenIsFragment && isValidElement(children)) return children;
 	return render();
 }
-
 //#endregion
 export { wrapNodeIfPlain };
+
 //# sourceMappingURL=wrapNodeIfPlain.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"wrapNodeIfPlain.js","names":["Fragment","isValidElement","ReactNode","wrapNodeIfPlain","children","render","childrenIsFragment","Array","isArray","type"],"sources":["../../../src/utils/react/wrapNodeIfPlain.ts"],"sourcesContent":["import { Fragment, isValidElement, ReactNode } from 'react';\n\nexport function wrapNodeIfPlain(children: ReactNode, render: () => ReactNode) {\n  // Compared by `type`, not with `react-is`: the pinned `react-is@18` does not\n  // recognise React 19 elements, so it called every fragment a single element.\n  const childrenIsFragment =\n    Array.isArray(children) ||\n    (isValidElement(children) && children.type === Fragment);\n\n  if (!children || (!childrenIsFragment && isValidElement(children))) {\n    return children;\n  }\n\n  return render();\n}\n"],"mappings":";;;;AAEA,SAAgBG,gBAAgBC,UAAqBC,QAAyB;CAG5E,MAAMC,qBACJC,MAAMC,QAAQJ,SAAS,IACtBH,eAAeG,SAAS,IAAIA,SAASK,SAAST;AAEjD,KAAI,CAACI,YAAa,CAACE,sBAAsBL,eAAeG,SAAU,CAChE,QAAOA;AAGT,QAAOC,QAAQ"}
+{"version":3,"file":"wrapNodeIfPlain.js","names":["Fragment","isValidElement","ReactNode","wrapNodeIfPlain","children","render","childrenIsFragment","Array","isArray","type"],"sources":["../../../src/utils/react/wrapNodeIfPlain.ts"],"sourcesContent":["import { Fragment, isValidElement, ReactNode } from 'react';\n\nexport function wrapNodeIfPlain(children: ReactNode, render: () => ReactNode) {\n  // Compared by `type`, not with `react-is`: the pinned `react-is@18` does not\n  // recognise React 19 elements, so it called every fragment a single element.\n  const childrenIsFragment =\n    Array.isArray(children) ||\n    (isValidElement(children) && children.type === Fragment);\n\n  if (!children || (!childrenIsFragment && isValidElement(children))) {\n    return children;\n  }\n\n  return render();\n}\n"],"mappings":";;;AAEA,SAAgBG,gBAAgBC,UAAqBC,QAAyB;CAG5E,MAAMC,qBACJC,MAAMC,QAAQJ,QAAQ,KACrBH,eAAeG,QAAQ,KAAKA,SAASK,SAAST;CAEjD,IAAI,CAACI,YAAa,CAACE,sBAAsBL,eAAeG,QAAQ,GAC9D,OAAOA;CAGT,OAAOC,OAAO;AAChB"}

package/dist/utils/selection.d.ts

@@ -1,12 +1,10 @@
 
 import { Key } from "react-aria";
-
 //#region src/utils/selection.d.ts
 /**
  * Deduplicate/toggle keys in a selection: if a key appears twice it is
  * removed (toggled off), otherwise it is kept (selected).
  */
-declare function processSelectionArray(iterable: Iterable<Key>): string[];
+export declare function processSelectionArray(iterable: Iterable<Key>): string[];
 //#endregion
-export { processSelectionArray };
 //# sourceMappingURL=selection.d.ts.map

package/dist/utils/selection.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 //#region src/utils/selection.ts
 /**
 * Deduplicate/toggle keys in a selection: if a key appears twice it is
@@ -13,7 +13,7 @@ function processSelectionArray(iterable) {
 	}
 	return Array.from(resultSet);
 }
-
 //#endregion
 export { processSelectionArray };
+
 //# sourceMappingURL=selection.js.map

package/dist/utils/selection.js.map

@@ -1 +1 @@
-{"version":3,"file":"selection.js","names":["Key","processSelectionArray","iterable","Iterable","resultSet","Set","key","nKey","String","has","delete","add","Array","from"],"sources":["../../src/utils/selection.ts"],"sourcesContent":["import { Key } from 'react-aria';\n\n/**\n * Deduplicate/toggle keys in a selection: if a key appears twice it is\n * removed (toggled off), otherwise it is kept (selected).\n */\nexport function processSelectionArray(iterable: Iterable<Key>): string[] {\n  const resultSet = new Set<string>();\n  for (const key of iterable) {\n    const nKey = String(key);\n    if (resultSet.has(nKey)) {\n      resultSet.delete(nKey);\n    } else {\n      resultSet.add(nKey);\n    }\n  }\n  return Array.from(resultSet);\n}\n"],"mappings":";;;;;;AAMA,SAAgBC,sBAAsBC,UAAmC;CACvE,MAAME,4BAAY,IAAIC,KAAa;AACnC,MAAK,MAAMC,OAAOJ,UAAU;EAC1B,MAAMK,OAAOC,OAAOF,IAAI;AACxB,MAAIF,UAAUK,IAAIF,KAAK,CACrBH,WAAUM,OAAOH,KAAK;MAEtBH,WAAUO,IAAIJ,KAAK;;AAGvB,QAAOK,MAAMC,KAAKT,UAAU"}
+{"version":3,"file":"selection.js","names":["Key","processSelectionArray","iterable","Iterable","resultSet","Set","key","nKey","String","has","delete","add","Array","from"],"sources":["../../src/utils/selection.ts"],"sourcesContent":["import { Key } from 'react-aria';\n\n/**\n * Deduplicate/toggle keys in a selection: if a key appears twice it is\n * removed (toggled off), otherwise it is kept (selected).\n */\nexport function processSelectionArray(iterable: Iterable<Key>): string[] {\n  const resultSet = new Set<string>();\n  for (const key of iterable) {\n    const nKey = String(key);\n    if (resultSet.has(nKey)) {\n      resultSet.delete(nKey);\n    } else {\n      resultSet.add(nKey);\n    }\n  }\n  return Array.from(resultSet);\n}\n"],"mappings":";;;;;;AAMA,SAAgBC,sBAAsBC,UAAmC;CACvE,MAAME,4BAAY,IAAIC,IAAY;CAClC,KAAK,MAAMC,OAAOJ,UAAU;EAC1B,MAAMK,OAAOC,OAAOF,GAAG;EACvB,IAAIF,UAAUK,IAAIF,IAAI,GACpBH,UAAUM,OAAOH,IAAI;OAErBH,UAAUO,IAAIJ,IAAI;CAEtB;CACA,OAAOK,MAAMC,KAAKT,SAAS;AAC7B"}

package/dist/utils/styles.d.ts

@@ -1,6 +1,5 @@
 
 import { Styles } from "@tenphi/tasty";
-
 //#region src/utils/styles.d.ts
 /**
  * Split properties into style and non-style properties.
@@ -13,7 +12,6 @@ import { Styles } from "@tenphi/tasty";
  * @param propMap - Props-to-style alias map (e.g. `{ bg: 'fill' }`).
  * @param ignoreList - Properties to skip during extraction.
  */
-declare function extractStyles(props: object, styleList?: readonly string[], defaultStyles?: Styles, propMap?: Record<string, string>, ignoreList?: readonly string[]): Styles;
+export declare function extractStyles(props: object, styleList?: readonly string[], defaultStyles?: Styles, propMap?: Record<string, string>, ignoreList?: readonly string[]): Styles;
 //#endregion
-export { extractStyles };
 //# sourceMappingURL=styles.d.ts.map

package/dist/utils/styles.js

@@ -1,6 +1,5 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { isSelector, mergeStyles } from "@tenphi/tasty";
-
 //#region src/utils/styles.ts
 function isRecord(value) {
 	return !!value && typeof value === "object" && !Array.isArray(value);
@@ -71,7 +70,7 @@ function extractStyles(props, styleList = [], defaultStyles, propMap, ignoreList
 	}
 	return styles;
 }
-
 //#endregion
 export { extractStyles, mergeStyleLayers };
+
 //# sourceMappingURL=styles.js.map

package/dist/utils/styles.js.map

@@ -1 +1 @@
-{"version":3,"file":"styles.js","names":["isSelector","mergeStyles","Styles","StyleLayer","StyleRecord","Record","isRecord","value","Array","isArray","finalResets","layers","allowFalse","last","Map","layer","key","Object","keys","undefined","set","filter","mergeStyleLayers","present","merged","subLayers","sub","push","resets","length","fromEntries","extractStyles","props","styleList","defaultStyles","propMap","ignoreList","ignoreSet","Set","styleSet","record","styles","has","prop","styleName"],"sources":["../../src/utils/styles.ts"],"sourcesContent":["import { isSelector, mergeStyles } from '@tenphi/tasty';\n\nimport type { Styles } from '@tenphi/tasty';\n\ntype StyleLayer = Styles | null | undefined;\ntype StyleRecord = Record<string, unknown>;\n\nfunction isRecord(value: unknown): value is StyleRecord {\n  return !!value && typeof value === 'object' && !Array.isArray(value);\n}\n\n/**\n * The keys whose last explicit value across `layers` is a reset: `null`, or\n * `false` too where `allowFalse` (a sub-element key, which tasty drops for\n * either).\n */\nfunction finalResets(layers: StyleRecord[], allowFalse: boolean) {\n  const last = new Map<string, unknown>();\n\n  for (const layer of layers) {\n    for (const key of Object.keys(layer)) {\n      if (layer[key] !== undefined) last.set(key, layer[key]);\n    }\n  }\n\n  return [...last].filter(\n    ([key, value]) =>\n      value === null || (value === false && allowFalse && isSelector(key)),\n  );\n}\n\n/**\n * Merge runtime style layers with tasty's `mergeStyles`, later layers winning.\n * This is the algorithm tasty applies between an element's own styles and its\n * `styles` prop: a state map without a `''` key extends the one below it,\n * sub-elements merge key by key, and `undefined` keeps the lower value.\n *\n * Resets are the one difference. The result is not final: it is passed on as\n * some element's `styles`, which tasty merges over that element's own styles\n * once more. `mergeStyles` applies a `null` by deleting the key, so a consumer's\n * `{ padding: null }` would vanish here, before it reached the element whose\n * padding it was meant to remove. Every reset that is the last word on its key,\n * top-level or inside a sub-element, is therefore written back into the result.\n */\nexport function mergeStyleLayers(...layers: StyleLayer[]): Styles {\n  const present = layers.filter(isRecord) as StyleRecord[];\n  const merged = mergeStyles(...(present as Styles[])) as StyleRecord;\n\n  for (const [key, value] of finalResets(present, true)) merged[key] = value;\n\n  for (const key of Object.keys(merged)) {\n    if (!isSelector(key) || !isRecord(merged[key])) continue;\n\n    // The sub-element's layers since its last wholesale reset.\n    let subLayers: StyleRecord[] = [];\n\n    for (const layer of present) {\n      const sub = layer[key];\n\n      if (sub === null || sub === false) subLayers = [];\n      else if (isRecord(sub)) subLayers.push(sub);\n    }\n\n    const resets = finalResets(subLayers, false);\n\n    // Copied first: a sub-element present in one layer is that layer's object.\n    if (resets.length)\n      merged[key] = { ...merged[key], ...Object.fromEntries(resets) };\n  }\n\n  return merged as Styles;\n}\n\n/**\n * Split properties into style and non-style properties.\n * Collects style-related props from `props` (based on `styleList`)\n * and merges them with `defaultStyles` and `props.styles`.\n *\n * @param props - Component prop map.\n * @param styleList - List of style property names to extract.\n * @param defaultStyles - Default style map of the component.\n * @param propMap - Props-to-style alias map (e.g. `{ bg: 'fill' }`).\n * @param ignoreList - Properties to skip during extraction.\n */\nexport function extractStyles(\n  props: object,\n  styleList: readonly string[] = [],\n  defaultStyles?: Styles,\n  propMap?: Record<string, string>,\n  ignoreList: readonly string[] = [],\n): Styles {\n  const ignoreSet = new Set(ignoreList);\n  const styleSet = new Set(styleList);\n  const record = props as Record<string, unknown>;\n\n  // `props.styles` over the component defaults. The result is always a fresh\n  // object, so the style props below can be assigned onto it.\n  const styles = mergeStyleLayers(\n    defaultStyles,\n    !ignoreSet.has('styles') &&\n      record.styles &&\n      typeof record.styles === 'object'\n      ? (record.styles as Styles)\n      : undefined,\n  );\n\n  for (const prop of Object.keys(record)) {\n    if (ignoreSet.has(prop)) continue;\n\n    const styleName = propMap?.[prop] ?? prop;\n\n    if (styleSet.has(styleName)) {\n      styles[styleName] = record[prop] as Styles[keyof Styles];\n    }\n  }\n\n  return styles;\n}\n"],"mappings":";;;;AAOA,SAASM,SAASC,OAAsC;AACtD,QAAO,CAAC,CAACA,SAAS,OAAOA,UAAU,YAAY,CAACC,MAAMC,QAAQF,MAAM;;;;;;;AAQtE,SAASG,YAAYC,QAAuBC,YAAqB;CAC/D,MAAMC,uBAAO,IAAIC,KAAsB;AAEvC,MAAK,MAAMC,SAASJ,OAClB,MAAK,MAAMK,OAAOC,OAAOC,KAAKH,MAAM,CAClC,KAAIA,MAAMC,SAASG,OAAWN,MAAKO,IAAIJ,KAAKD,MAAMC,KAAK;AAI3D,QAAO,CAAC,GAAGH,KAAK,CAACQ,QACd,CAACL,KAAKT,WACLA,UAAU,QAASA,UAAU,SAASK,cAAcZ,WAAWgB,IACnE,CAAC;;;;;;;;;;;;;;;AAgBH,SAAgBM,iBAAiB,GAAGX,QAA8B;CAChE,MAAMY,UAAUZ,OAAOU,OAAOf,SAAS;CACvC,MAAMkB,SAASvB,YAAY,GAAIsB,QAAqB;AAEpD,MAAK,MAAM,CAACP,KAAKT,UAAUG,YAAYa,SAAS,KAAK,CAAEC,QAAOR,OAAOT;AAErE,MAAK,MAAMS,OAAOC,OAAOC,KAAKM,OAAO,EAAE;AACrC,MAAI,CAACxB,WAAWgB,IAAI,IAAI,CAACV,SAASkB,OAAOR,KAAK,CAAE;EAGhD,IAAIS,YAA2B,EAAE;AAEjC,OAAK,MAAMV,SAASQ,SAAS;GAC3B,MAAMG,MAAMX,MAAMC;AAElB,OAAIU,QAAQ,QAAQA,QAAQ,MAAOD,aAAY,EAAE;YACxCnB,SAASoB,IAAI,CAAED,WAAUE,KAAKD,IAAI;;EAG7C,MAAME,SAASlB,YAAYe,WAAW,MAAM;AAG5C,MAAIG,OAAOC,OACTL,QAAOR,OAAO;GAAE,GAAGQ,OAAOR;GAAM,GAAGC,OAAOa,YAAYF,OAAM;GAAG;;AAGnE,QAAOJ;;;;;;;;;;;;;AAcT,SAAgBO,cACdC,OACAC,YAA+B,EAAE,EACjCC,eACAC,SACAC,aAAgC,EAAE,EAC1B;CACR,MAAMC,YAAY,IAAIC,IAAIF,WAAW;CACrC,MAAMG,WAAW,IAAID,IAAIL,UAAU;CACnC,MAAMO,SAASR;CAIf,MAAMS,SAASnB,iBACbY,eACA,CAACG,UAAUK,IAAI,SAAS,IACtBF,OAAOC,UACP,OAAOD,OAAOC,WAAW,WACtBD,OAAOC,SACRtB,OACL;AAED,MAAK,MAAMwB,QAAQ1B,OAAOC,KAAKsB,OAAO,EAAE;AACtC,MAAIH,UAAUK,IAAIC,KAAK,CAAE;EAEzB,MAAMC,YAAYT,UAAUQ,SAASA;AAErC,MAAIJ,SAASG,IAAIE,UAAU,CACzBH,QAAOG,aAAaJ,OAAOG;;AAI/B,QAAOF"}
+{"version":3,"file":"styles.js","names":["isSelector","mergeStyles","Styles","StyleLayer","StyleRecord","Record","isRecord","value","Array","isArray","finalResets","layers","allowFalse","last","Map","layer","key","Object","keys","undefined","set","filter","mergeStyleLayers","present","merged","subLayers","sub","push","resets","length","fromEntries","extractStyles","props","styleList","defaultStyles","propMap","ignoreList","ignoreSet","Set","styleSet","record","styles","has","prop","styleName"],"sources":["../../src/utils/styles.ts"],"sourcesContent":["import { isSelector, mergeStyles } from '@tenphi/tasty';\n\nimport type { Styles } from '@tenphi/tasty';\n\ntype StyleLayer = Styles | null | undefined;\ntype StyleRecord = Record<string, unknown>;\n\nfunction isRecord(value: unknown): value is StyleRecord {\n  return !!value && typeof value === 'object' && !Array.isArray(value);\n}\n\n/**\n * The keys whose last explicit value across `layers` is a reset: `null`, or\n * `false` too where `allowFalse` (a sub-element key, which tasty drops for\n * either).\n */\nfunction finalResets(layers: StyleRecord[], allowFalse: boolean) {\n  const last = new Map<string, unknown>();\n\n  for (const layer of layers) {\n    for (const key of Object.keys(layer)) {\n      if (layer[key] !== undefined) last.set(key, layer[key]);\n    }\n  }\n\n  return [...last].filter(\n    ([key, value]) =>\n      value === null || (value === false && allowFalse && isSelector(key)),\n  );\n}\n\n/**\n * Merge runtime style layers with tasty's `mergeStyles`, later layers winning.\n * This is the algorithm tasty applies between an element's own styles and its\n * `styles` prop: a state map without a `''` key extends the one below it,\n * sub-elements merge key by key, and `undefined` keeps the lower value.\n *\n * Resets are the one difference. The result is not final: it is passed on as\n * some element's `styles`, which tasty merges over that element's own styles\n * once more. `mergeStyles` applies a `null` by deleting the key, so a consumer's\n * `{ padding: null }` would vanish here, before it reached the element whose\n * padding it was meant to remove. Every reset that is the last word on its key,\n * top-level or inside a sub-element, is therefore written back into the result.\n */\nexport function mergeStyleLayers(...layers: StyleLayer[]): Styles {\n  const present = layers.filter(isRecord) as StyleRecord[];\n  const merged = mergeStyles(...(present as Styles[])) as StyleRecord;\n\n  for (const [key, value] of finalResets(present, true)) merged[key] = value;\n\n  for (const key of Object.keys(merged)) {\n    if (!isSelector(key) || !isRecord(merged[key])) continue;\n\n    // The sub-element's layers since its last wholesale reset.\n    let subLayers: StyleRecord[] = [];\n\n    for (const layer of present) {\n      const sub = layer[key];\n\n      if (sub === null || sub === false) subLayers = [];\n      else if (isRecord(sub)) subLayers.push(sub);\n    }\n\n    const resets = finalResets(subLayers, false);\n\n    // Copied first: a sub-element present in one layer is that layer's object.\n    if (resets.length)\n      merged[key] = { ...merged[key], ...Object.fromEntries(resets) };\n  }\n\n  return merged as Styles;\n}\n\n/**\n * Split properties into style and non-style properties.\n * Collects style-related props from `props` (based on `styleList`)\n * and merges them with `defaultStyles` and `props.styles`.\n *\n * @param props - Component prop map.\n * @param styleList - List of style property names to extract.\n * @param defaultStyles - Default style map of the component.\n * @param propMap - Props-to-style alias map (e.g. `{ bg: 'fill' }`).\n * @param ignoreList - Properties to skip during extraction.\n */\nexport function extractStyles(\n  props: object,\n  styleList: readonly string[] = [],\n  defaultStyles?: Styles,\n  propMap?: Record<string, string>,\n  ignoreList: readonly string[] = [],\n): Styles {\n  const ignoreSet = new Set(ignoreList);\n  const styleSet = new Set(styleList);\n  const record = props as Record<string, unknown>;\n\n  // `props.styles` over the component defaults. The result is always a fresh\n  // object, so the style props below can be assigned onto it.\n  const styles = mergeStyleLayers(\n    defaultStyles,\n    !ignoreSet.has('styles') &&\n      record.styles &&\n      typeof record.styles === 'object'\n      ? (record.styles as Styles)\n      : undefined,\n  );\n\n  for (const prop of Object.keys(record)) {\n    if (ignoreSet.has(prop)) continue;\n\n    const styleName = propMap?.[prop] ?? prop;\n\n    if (styleSet.has(styleName)) {\n      styles[styleName] = record[prop] as Styles[keyof Styles];\n    }\n  }\n\n  return styles;\n}\n"],"mappings":";;;AAOA,SAASM,SAASC,OAAsC;CACtD,OAAO,CAAC,CAACA,SAAS,OAAOA,UAAU,YAAY,CAACC,MAAMC,QAAQF,KAAK;AACrE;;;;;;AAOA,SAASG,YAAYC,QAAuBC,YAAqB;CAC/D,MAAMC,uBAAO,IAAIC,IAAqB;CAEtC,KAAK,MAAMC,SAASJ,QAClB,KAAK,MAAMK,OAAOC,OAAOC,KAAKH,KAAK,GACjC,IAAIA,MAAMC,SAASG,KAAAA,GAAWN,KAAKO,IAAIJ,KAAKD,MAAMC,IAAI;CAI1D,OAAO,CAAC,GAAGH,IAAI,CAAC,CAACQ,QACd,CAACL,KAAKT,WACLA,UAAU,QAASA,UAAU,SAASK,cAAcZ,WAAWgB,GAAG,CACtE;AACF;;;;;;;;;;;;;;AAeA,SAAgBM,iBAAiB,GAAGX,QAA8B;CAChE,MAAMY,UAAUZ,OAAOU,OAAOf,QAAQ;CACtC,MAAMkB,SAASvB,YAAY,GAAIsB,OAAoB;CAEnD,KAAK,MAAM,CAACP,KAAKT,UAAUG,YAAYa,SAAS,IAAI,GAAGC,OAAOR,OAAOT;CAErE,KAAK,MAAMS,OAAOC,OAAOC,KAAKM,MAAM,GAAG;EACrC,IAAI,CAACxB,WAAWgB,GAAG,KAAK,CAACV,SAASkB,OAAOR,IAAI,GAAG;EAGhD,IAAIS,YAA2B,CAAA;EAE/B,KAAK,MAAMV,SAASQ,SAAS;GAC3B,MAAMG,MAAMX,MAAMC;GAElB,IAAIU,QAAQ,QAAQA,QAAQ,OAAOD,YAAY,CAAA;QAC1C,IAAInB,SAASoB,GAAG,GAAGD,UAAUE,KAAKD,GAAG;EAC5C;EAEA,MAAME,SAASlB,YAAYe,WAAW,KAAK;EAG3C,IAAIG,OAAOC,QACTL,OAAOR,OAAO;GAAE,GAAGQ,OAAOR;GAAM,GAAGC,OAAOa,YAAYF,MAAM;EAAE;CAClE;CAEA,OAAOJ;AACT;;;;;;;;;;;;AAaA,SAAgBO,cACdC,OACAC,YAA+B,CAAA,GAC/BC,eACAC,SACAC,aAAgC,CAAA,GACxB;CACR,MAAMC,YAAY,IAAIC,IAAIF,UAAU;CACpC,MAAMG,WAAW,IAAID,IAAIL,SAAS;CAClC,MAAMO,SAASR;CAIf,MAAMS,SAASnB,iBACbY,eACA,CAACG,UAAUK,IAAI,QAAQ,KACrBF,OAAOC,UACP,OAAOD,OAAOC,WAAW,WACtBD,OAAOC,SACRtB,KAAAA,CACN;CAEA,KAAK,MAAMwB,QAAQ1B,OAAOC,KAAKsB,MAAM,GAAG;EACtC,IAAIH,UAAUK,IAAIC,IAAI,GAAG;EAEzB,MAAMC,YAAYT,UAAUQ,SAASA;EAErC,IAAIJ,SAASG,IAAIE,SAAS,GACxBH,OAAOG,aAAaJ,OAAOG;CAE/B;CAEA,OAAOF;AACT"}

package/dist/utils/tree.d.ts

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

package/dist/utils/tree.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 //#region src/utils/tree.ts
 function toFlatTree(tree, includingFolders) {
 	return tree.reduce((result, node) => {
@@ -11,7 +11,7 @@ function toFlatTree(tree, includingFolders) {
 		return result;
 	}, []);
 }
-
 //#endregion
 export { toFlatTree };
+
 //# sourceMappingURL=tree.js.map

package/dist/utils/tree.js.map

@@ -1 +1 @@
-{"version":3,"file":"tree.js","names":["toFlatTree","tree","includingFolders","reduce","result","node","isLeaf","children","push"],"sources":["../../src/utils/tree.ts"],"sourcesContent":["export function toFlatTree(tree, includingFolders) {\n  return tree.reduce((result, node) => {\n    if (!node.isLeaf) {\n      result = [\n        ...result,\n        ...(includingFolders ? [node] : []),\n        ...toFlatTree(node.children || [], includingFolders),\n      ];\n    } else {\n      result.push(node);\n    }\n    return result;\n  }, []);\n}\n"],"mappings":";;AAAA,SAAgBA,WAAWC,MAAMC,kBAAkB;AACjD,QAAOD,KAAKE,QAAQC,QAAQC,SAAS;AACnC,MAAI,CAACA,KAAKC,OACRF,UAAS;GACP,GAAGA;GACH,GAAIF,mBAAmB,CAACG,KAAK,GAAG,EAAE;GAClC,GAAGL,WAAWK,KAAKE,YAAY,EAAE,EAAEL,iBAAiB;GACrD;MAEDE,QAAOI,KAAKH,KAAK;AAEnB,SAAOD;IACN,EAAE,CAAC"}
+{"version":3,"file":"tree.js","names":["toFlatTree","tree","includingFolders","reduce","result","node","isLeaf","children","push"],"sources":["../../src/utils/tree.ts"],"sourcesContent":["export function toFlatTree(tree, includingFolders) {\n  return tree.reduce((result, node) => {\n    if (!node.isLeaf) {\n      result = [\n        ...result,\n        ...(includingFolders ? [node] : []),\n        ...toFlatTree(node.children || [], includingFolders),\n      ];\n    } else {\n      result.push(node);\n    }\n    return result;\n  }, []);\n}\n"],"mappings":";;AAAA,SAAgBA,WAAWC,MAAMC,kBAAkB;CACjD,OAAOD,KAAKE,QAAQC,QAAQC,SAAS;EACnC,IAAI,CAACA,KAAKC,QACRF,SAAS;GACP,GAAGA;GACH,GAAIF,mBAAmB,CAACG,IAAI,IAAI,CAAA;GAChC,GAAGL,WAAWK,KAAKE,YAAY,CAAA,GAAIL,gBAAgB;EAAC;OAGtDE,OAAOI,KAAKH,IAAI;EAElB,OAAOD;CACT,GAAG,CAAA,CAAE;AACP"}

package/dist/utils/warnings.d.ts

@@ -1,6 +1,5 @@
 
 //#region src/utils/warnings.d.ts
-declare function propDeprecationWarning(name: any, props: any, propList: any): void;
+export declare function propDeprecationWarning(name: any, props: any, propList: any): void;
 //#endregion
-export { propDeprecationWarning };
 //# sourceMappingURL=warnings.d.ts.map

package/dist/utils/warnings.js

@@ -1,6 +1,5 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { isDevEnvOrTest } from "./is-dev-env.js";
-
 //#region src/utils/warnings.ts
 const SUGGESTED_PROP_MAP = {
 	disabled: "isDisabled",
@@ -27,7 +26,7 @@ function deprecationWarning(condition, { property, name, betterAlternative, reas
 	reason && warn(`Reason: ${typeof reason === "function" ? reason() : reason}`);
 	console.groupEnd();
 }
-
 //#endregion
 export { deprecationWarning, propDeprecationWarning, warn };
+
 //# sourceMappingURL=warnings.js.map

package/dist/utils/warnings.js.map

@@ -1 +1 @@
-{"version":3,"file":"warnings.js","names":["isDevEnvOrTest","SUGGESTED_PROP_MAP","disabled","loading","selected","PREFIX","propDeprecationWarning","name","props","propList","forEach","prop","suggestion","warn","args","console","deprecationWarning","condition","property","betterAlternative","reason","group","groupEnd"],"sources":["../../src/utils/warnings.ts"],"sourcesContent":["import { isDevEnvOrTest } from './is-dev-env';\n\nconst SUGGESTED_PROP_MAP = {\n  disabled: 'isDisabled',\n  loading: 'isLoading',\n  selected: 'isSelected',\n};\n\nconst PREFIX = 'CubeUIKit';\n\nexport function propDeprecationWarning(name, props, propList) {\n  propList.forEach((prop) => {\n    if (prop in props) {\n      const suggestion = SUGGESTED_PROP_MAP[prop];\n\n      warn(\n        `\"${prop}\" property of \"${name}\" component is deprecated.${\n          suggestion ? ` Use \"${suggestion}\" property instead.` : ''\n        }`,\n      );\n    }\n  });\n}\n\nexport function warn(...args) {\n  if (isDevEnvOrTest()) {\n    console.warn(`${PREFIX}:`, ...args);\n  }\n}\n\nexport function deprecationWarning(\n  condition: any,\n  {\n    property,\n    name,\n    betterAlternative,\n    reason,\n  }: {\n    property: string;\n    name: string;\n    betterAlternative: (() => string) | string;\n    reason?: (() => string) | string;\n  },\n) {\n  if (condition) return;\n\n  if (!isDevEnvOrTest()) return;\n\n  // we can make deprecations even better if we add the md syntax in the console.\n  // anyway, everything down below will be stripped in the production build\n  console.group(`⚠️ ${PREFIX}: Deprecation in ${name}`);\n  warn(\n    `\"${property}\" is deprecated, consider better alternative: ${\n      typeof betterAlternative === 'function'\n        ? (betterAlternative as () => string)()\n        : betterAlternative\n    }`,\n  );\n  reason &&\n    warn(\n      `Reason: ${\n        typeof reason === 'function' ? (reason as () => string)() : reason\n      }`,\n    );\n  console.groupEnd();\n}\n"],"mappings":";;;;AAEA,MAAMC,qBAAqB;CACzBC,UAAU;CACVC,SAAS;CACTC,UAAU;CACX;AAED,MAAMC,SAAS;AAEf,SAAgBC,uBAAuBC,MAAMC,OAAOC,UAAU;AAC5DA,UAASC,SAASC,SAAS;AACzB,MAAIA,QAAQH,OAAO;GACjB,MAAMI,aAAaX,mBAAmBU;AAEtCE,QACE,IAAIF,KAAI,iBAAkBJ,KAAI,4BAC5BK,aAAa,SAASA,WAAU,uBAAwB,KAE3D;;GAEH;;AAGJ,SAAgBC,KAAK,GAAGC,MAAM;AAC5B,KAAId,gBAAgB,CAClBe,SAAQF,KAAK,GAAGR,OAAM,IAAK,GAAGS,KAAK;;AAIvC,SAAgBE,mBACdC,WACA,EACEC,UACAX,MACAY,mBACAC,UAOF;AACA,KAAIH,UAAW;AAEf,KAAI,CAACjB,gBAAgB,CAAE;AAIvBe,SAAQM,MAAM,MAAMhB,OAAM,mBAAoBE,OAAO;AACrDM,MACE,IAAIK,SAAQ,gDACV,OAAOC,sBAAsB,aACxBA,mBAAoC,GACrCA,oBAEP;AACDC,WACEP,KACE,WACE,OAAOO,WAAW,aAAcA,QAAyB,GAAGA,SAE/D;AACHL,SAAQO,UAAU"}
+{"version":3,"file":"warnings.js","names":["isDevEnvOrTest","SUGGESTED_PROP_MAP","disabled","loading","selected","PREFIX","propDeprecationWarning","name","props","propList","forEach","prop","suggestion","warn","args","console","deprecationWarning","condition","property","betterAlternative","reason","group","groupEnd"],"sources":["../../src/utils/warnings.ts"],"sourcesContent":["import { isDevEnvOrTest } from './is-dev-env';\n\nconst SUGGESTED_PROP_MAP = {\n  disabled: 'isDisabled',\n  loading: 'isLoading',\n  selected: 'isSelected',\n};\n\nconst PREFIX = 'CubeUIKit';\n\nexport function propDeprecationWarning(name, props, propList) {\n  propList.forEach((prop) => {\n    if (prop in props) {\n      const suggestion = SUGGESTED_PROP_MAP[prop];\n\n      warn(\n        `\"${prop}\" property of \"${name}\" component is deprecated.${\n          suggestion ? ` Use \"${suggestion}\" property instead.` : ''\n        }`,\n      );\n    }\n  });\n}\n\nexport function warn(...args) {\n  if (isDevEnvOrTest()) {\n    console.warn(`${PREFIX}:`, ...args);\n  }\n}\n\nexport function deprecationWarning(\n  condition: any,\n  {\n    property,\n    name,\n    betterAlternative,\n    reason,\n  }: {\n    property: string;\n    name: string;\n    betterAlternative: (() => string) | string;\n    reason?: (() => string) | string;\n  },\n) {\n  if (condition) return;\n\n  if (!isDevEnvOrTest()) return;\n\n  // we can make deprecations even better if we add the md syntax in the console.\n  // anyway, everything down below will be stripped in the production build\n  console.group(`⚠️ ${PREFIX}: Deprecation in ${name}`);\n  warn(\n    `\"${property}\" is deprecated, consider better alternative: ${\n      typeof betterAlternative === 'function'\n        ? (betterAlternative as () => string)()\n        : betterAlternative\n    }`,\n  );\n  reason &&\n    warn(\n      `Reason: ${\n        typeof reason === 'function' ? (reason as () => string)() : reason\n      }`,\n    );\n  console.groupEnd();\n}\n"],"mappings":";;;AAEA,MAAMC,qBAAqB;CACzBC,UAAU;CACVC,SAAS;CACTC,UAAU;AACZ;AAEA,MAAMC,SAAS;AAEf,SAAgBC,uBAAuBC,MAAMC,OAAOC,UAAU;CAC5DA,SAASC,SAASC,SAAS;EACzB,IAAIA,QAAQH,OAAO;GACjB,MAAMI,aAAaX,mBAAmBU;GAEtCE,KACE,IAAIF,KAAI,iBAAkBJ,KAAI,4BAC5BK,aAAa,SAASA,WAAU,uBAAwB,IAE5D;EACF;CACF,CAAC;AACH;AAEA,SAAgBC,KAAK,GAAGC,MAAM;CAC5B,IAAId,eAAe,GACjBe,QAAQF,KAAK,GAAGR,OAAM,IAAK,GAAGS,IAAI;AAEtC;AAEA,SAAgBE,mBACdC,WACA,EACEC,UACAX,MACAY,mBACAC,UAOF;CACA,IAAIH,WAAW;CAEf,IAAI,CAACjB,eAAe,GAAG;CAIvBe,QAAQM,MAAM,MAAMhB,OAAM,mBAAoBE,MAAM;CACpDM,KACE,IAAIK,SAAQ,gDACV,OAAOC,sBAAsB,aACxBA,kBAAmC,IACpCA,mBAER;CACAC,UACEP,KACE,WACE,OAAOO,WAAW,aAAcA,OAAwB,IAAIA,QAEhE;CACFL,QAAQO,SAAS;AACnB"}

package/dist/version.d.ts

@@ -12,4 +12,5 @@ declare global {
   /** Replaced at build time by tsdown `define` */
   const __TASTY_VERSION__: string;
 }
+export {};
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,7 +1,7 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 //#region src/version.ts
-const VERSION = "0.196.0";
-const TASTY_VERSION = "3.9.9";
+const VERSION = "0.198.0";
+const TASTY_VERSION = "3.12.0";
 if (typeof window !== "undefined") {
 	const version = VERSION;
 	const tastyVersion = TASTY_VERSION;
@@ -15,7 +15,7 @@ if (typeof window !== "undefined") {
 		window.CubeUIKit.tastyVersion = tastyVersion;
 	}
 }
-
 //#endregion
 export { TASTY_VERSION, VERSION };
+
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","names":["global","Window","CubeUIKit","version","tastyVersion","__UIKIT_VERSION__","__TASTY_VERSION__","VERSION","TASTY_VERSION","window","console","error","loadedVersions"],"sources":["../src/version.ts"],"sourcesContent":["declare global {\n  interface Window {\n    CubeUIKit: {\n      version: string;\n      tastyVersion: string;\n    };\n  }\n\n  /** Replaced at build time by tsdown `define` */\n  const __UIKIT_VERSION__: string;\n  /** Replaced at build time by tsdown `define` */\n  const __TASTY_VERSION__: string;\n}\n\n// eslint-disable-next-line no-undef -- replaced at build time by tsdown `define`\nexport const VERSION: string = __UIKIT_VERSION__;\n// eslint-disable-next-line no-undef -- replaced at build time by tsdown `define`\nexport const TASTY_VERSION: string = __TASTY_VERSION__;\n\nif (typeof window !== 'undefined') {\n  const version = VERSION;\n  const tastyVersion = TASTY_VERSION;\n\n  // Ensure CubeUIKit is defined on window in a way bundlers recognize\n  window.CubeUIKit = window.CubeUIKit || { version, tastyVersion };\n\n  // Check for multiple versions\n  if (window.CubeUIKit.version && window.CubeUIKit.version !== version) {\n    console.error('More than one version of CubeUIKit is loaded', {\n      loadedVersions: [window.CubeUIKit.version, version],\n    });\n  } else {\n    window.CubeUIKit.version = version;\n    window.CubeUIKit.tastyVersion = tastyVersion;\n  }\n}\n"],"mappings":";;AAeA,MAAaO;AAEb,MAAaC;AAEb,IAAI,OAAOC,WAAW,aAAa;CACjC,MAAMN,UAAUI;CAChB,MAAMH,eAAeI;AAGrBC,QAAOP,YAAYO,OAAOP,aAAa;EAAEC;EAASC;EAAc;AAGhE,KAAIK,OAAOP,UAAUC,WAAWM,OAAOP,UAAUC,YAAYA,QAC3DO,SAAQC,MAAM,gDAAgD,EAC5DC,gBAAgB,CAACH,OAAOP,UAAUC,SAASA,QAAO,EACnD,CAAC;MACG;AACLM,SAAOP,UAAUC,UAAUA;AAC3BM,SAAOP,UAAUE,eAAeA"}
+{"version":3,"file":"version.js","names":["global","Window","CubeUIKit","version","tastyVersion","__UIKIT_VERSION__","__TASTY_VERSION__","VERSION","TASTY_VERSION","window","console","error","loadedVersions"],"sources":["../src/version.ts"],"sourcesContent":["declare global {\n  interface Window {\n    CubeUIKit: {\n      version: string;\n      tastyVersion: string;\n    };\n  }\n\n  /** Replaced at build time by tsdown `define` */\n  const __UIKIT_VERSION__: string;\n  /** Replaced at build time by tsdown `define` */\n  const __TASTY_VERSION__: string;\n}\n\n// eslint-disable-next-line no-undef -- replaced at build time by tsdown `define`\nexport const VERSION: string = __UIKIT_VERSION__;\n// eslint-disable-next-line no-undef -- replaced at build time by tsdown `define`\nexport const TASTY_VERSION: string = __TASTY_VERSION__;\n\nif (typeof window !== 'undefined') {\n  const version = VERSION;\n  const tastyVersion = TASTY_VERSION;\n\n  // Ensure CubeUIKit is defined on window in a way bundlers recognize\n  window.CubeUIKit = window.CubeUIKit || { version, tastyVersion };\n\n  // Check for multiple versions\n  if (window.CubeUIKit.version && window.CubeUIKit.version !== version) {\n    console.error('More than one version of CubeUIKit is loaded', {\n      loadedVersions: [window.CubeUIKit.version, version],\n    });\n  } else {\n    window.CubeUIKit.version = version;\n    window.CubeUIKit.tastyVersion = tastyVersion;\n  }\n}\n"],"mappings":";;AAeA,MAAaO,UAAAA;AAEb,MAAaC,gBAAAA;AAEb,IAAI,OAAOC,WAAW,aAAa;CACjC,MAAMN,UAAUI;CAChB,MAAMH,eAAeI;CAGrBC,OAAOP,YAAYO,OAAOP,aAAa;EAAEC;EAASC;CAAa;CAG/D,IAAIK,OAAOP,UAAUC,WAAWM,OAAOP,UAAUC,YAAYA,SAC3DO,QAAQC,MAAM,gDAAgD,EAC5DC,gBAAgB,CAACH,OAAOP,UAAUC,SAASA,OAAO,EACpD,CAAC;MACI;EACLM,OAAOP,UAAUC,UAAUA;EAC3BM,OAAOP,UAAUE,eAAeA;CAClC;AACF"}