@cube-dev/ui-kit 0.141.0 → 0.142.1

package/dist/providers/navigationAdapter.default.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/providers/navigationAdapter.default.ts
 /**
 * Converts a Path object to a string URL

package/dist/tokens/base.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/tokens/base.ts
 /**
 * Base design system tokens.

package/dist/tokens/colors.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import { PALETTE_TOKENS } from "./palette.js";
 
 //#region src/tokens/colors.ts

package/dist/tokens/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import { BASE_TOKENS } from "./base.js";
 import { COLOR_TOKENS } from "./colors.js";
 import { LAYOUT_TOKENS } from "./layout.js";

package/dist/tokens/layout.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/tokens/layout.ts
 /**
 * Layout-related tokens for common UI dimensions.

package/dist/tokens/palette.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import { glaze } from "@tenphi/glaze";
 
 //#region src/tokens/palette.ts

package/dist/tokens/shadows.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/tokens/shadows.ts
 /**
 * Shadow tokens using tasty shorthand syntax.

package/dist/tokens/sizes.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/tokens/sizes.ts
 /**
 * Component size values in pixels.

package/dist/tokens/spacing.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/tokens/spacing.ts
 /**
 * Spacing tokens using tasty multiplier syntax.

package/dist/tokens/typography.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/tokens/typography.ts
 /**
 * Typography presets for headings, text, and special styles.

package/dist/utils/ResizeSensor.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/utils/ResizeSensor.ts
 /**
 * Iterate over each of the provided element(s).

package/dist/utils/index.d.ts

@@ -10,6 +10,7 @@ import { wrapNodeIfPlain } from "./react/wrapNodeIfPlain.js";
 import { useViewportSize } from "./react/useViewportSize.js";
 import { useQaProps } from "./react/useQaProps.js";
 import { EventBusContextValue, EventBusListener, EventBusProvider, useEventBus, useEventListener } from "./react/useEventBus.js";
+import { UsePopoverSyncOptions, useDismissParentPopover, usePopoverSync } from "./react/usePopoverSync.js";
 import { UseControlledFocusVisibleResult, useControlledFocusVisible } from "./react/useControlledFocusVisible.js";
 import { RenderCache, RenderCacheProps } from "./react/RenderCache.js";
 import { useLocalStorage } from "./react/useLocalStorage.js";

package/dist/utils/is-dev-env.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/utils/is-dev-env.ts
 function isDevEnv() {
 	if (typeof window !== "undefined" && window.localStorage) try {

package/dist/utils/modules.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/utils/modules.ts
 function extractModule(promise) {
 	return promise.then((module) => module.default || module);

package/dist/utils/promise.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/utils/promise.ts
 function timeout(ms = 30) {
 	return new Promise((resolve) => {

package/dist/utils/raf.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/utils/raf.ts
 /**
 * Chains N requestAnimationFrame calls and returns a cancel function.

package/dist/utils/random.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/utils/random.ts
 function random(min, max) {
 	const realMin = min < max ? min : max;

package/dist/utils/range.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/utils/range.ts
 function range(count) {
 	return Array.from({ length: count }, (_, i) => i);

package/dist/utils/react/RenderCache.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import { useRef } from "react";
 import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
 

package/dist/utils/react/Slots.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import { mergeProps } from "./mergeProps.js";
 import { Children, cloneElement, createContext, useContext, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";

package/dist/utils/react/chain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/utils/react/chain.ts
 /**
 * Calls all functions in the order they were chained with the same arguments.

package/dist/utils/react/forwardRefWithGenerics.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/utils/react/forwardRefWithGenerics.tsx
 /**
 * A helper for creating forwardRef components with generic types.

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

@@ -10,6 +10,7 @@ import { wrapNodeIfPlain } from "./wrapNodeIfPlain.js";
 import { useViewportSize } from "./useViewportSize.js";
 import { useQaProps } from "./useQaProps.js";
 import { EventBusContextValue, EventBusListener, EventBusProvider, useEventBus, useEventListener } from "./useEventBus.js";
+import { UsePopoverSyncOptions, useDismissParentPopover, usePopoverSync } from "./usePopoverSync.js";
 import { UseControlledFocusVisibleResult, useControlledFocusVisible } from "./useControlledFocusVisible.js";
 import { RenderCache, RenderCacheProps } from "./RenderCache.js";
 import { useLocalStorage } from "./useLocalStorage.js";

package/dist/utils/react/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import { chain } from "./chain.js";
 import { forwardRefWithGenerics } from "./forwardRefWithGenerics.js";
 import { isTextOnly } from "./isTextOnly.js";
@@ -10,6 +10,7 @@ import { wrapNodeIfPlain } from "./wrapNodeIfPlain.js";
 import { useViewportSize } from "./useViewportSize.js";
 import { useQaProps } from "./useQaProps.js";
 import { EventBusProvider, useEventBus, useEventListener } from "./useEventBus.js";
+import { useDismissParentPopover, usePopoverSync } from "./usePopoverSync.js";
 import { useControlledFocusVisible } from "./useControlledFocusVisible.js";
 import { RenderCache } from "./RenderCache.js";
 import { useLocalStorage } from "./useLocalStorage.js";

package/dist/utils/react/interactions.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import { useState } from "react";
 import { useFocus, useFocusVisible } from "react-aria";
 

package/dist/utils/react/isTextOnly.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import { Children, isValidElement } from "react";
 
 //#region src/utils/react/isTextOnly.ts

package/dist/utils/react/mapProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/utils/react/mapProps.ts
 /** Converts AriaButtonProps to CubeButtonProps */
 function ariaToCubeButtonProps(props) {

package/dist/utils/react/mergeProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import { chain } from "./chain.js";
 import { mergeIds } from "./useId.js";
 import { mergeStyles } from "@tenphi/tasty";

package/dist/utils/react/nullableValue.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/utils/react/nullableValue.ts
 function castNullableStringValue(props) {
 	return castNullableField(props, ["value", "defaultValue"], "string", (v) => String(v));

package/dist/utils/react/resolveIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 //#region src/utils/react/resolveIcon.ts
 /**
 * Resolves a dynamic icon prop to its content and slot state.

package/dist/utils/react/sharedStore.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { useSyncExternalStore } from "react";
 

package/dist/utils/react/useCombinedRefs.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import { useEffect, useRef } from "react";
 
 //#region src/utils/react/useCombinedRefs.ts

package/dist/utils/react/useControlledFocusVisible.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import { createSharedStore } from "./sharedStore.js";
 import { useEffect } from "react";
 import { useFocusVisible } from "react-aria";

package/dist/utils/react/useEventBus.js

@@ -1,5 +1,5 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
-import React, { createContext, useCallback, useContext, useEffect, useRef } from "react";
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
+import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef } from "react";
 
 //#region src/utils/react/useEventBus.ts
 const EventBusContext = createContext(null);
@@ -18,6 +18,7 @@ const EventBusContext = createContext(null);
 * ```
 */
 function EventBusProvider({ children }) {
+	const parentBus = useContext(EventBusContext);
 	const listeners = useRef({});
 	const off = useCallback((event, listener) => {
 		const eventListeners = listeners.current[event];
@@ -30,22 +31,30 @@ function EventBusProvider({ children }) {
 		const eventListeners = listeners.current[event];
 		if (eventListeners) eventListeners.forEach((listener) => listener(data));
 	}, []);
-	const contextValue = {
-		emit: useCallback((event, data) => {
-			setTimeout(() => {
-				emitSync(event, data);
-			}, 0);
-		}, []),
+	const emit = useCallback((event, data) => {
+		setTimeout(() => {
+			emitSync(event, data);
+		}, 0);
+	}, [emitSync]);
+	const on = useCallback((event, listener) => {
+		if (!listeners.current[event]) listeners.current[event] = [];
+		listeners.current[event].push(listener);
+		return () => {
+			off(event, listener);
+		};
+	}, [off]);
+	const localContextValue = useMemo(() => ({
+		emit,
 		emitSync,
-		on: useCallback((event, listener) => {
-			if (!listeners.current[event]) listeners.current[event] = [];
-			listeners.current[event].push(listener);
-			return () => {
-				off(event, listener);
-			};
-		}, [off]),
+		on,
 		off
-	};
+	}), [
+		emit,
+		emitSync,
+		on,
+		off
+	]);
+	const contextValue = parentBus ?? localContextValue;
 	return React.createElement(EventBusContext.Provider, { value: contextValue }, children);
 }
 /**
@@ -121,5 +130,5 @@ function useEventListener(event, listener, deps = []) {
 }
 
 //#endregion
-export { EventBusProvider, useEventBus, useEventListener };
+export { EventBusContext, EventBusProvider, useEventBus, useEventListener };
 //# sourceMappingURL=useEventBus.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useEventBus.js","names":[],"sources":["../../../src/utils/react/useEventBus.ts"],"sourcesContent":["import React, {\n  createContext,\n  ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useRef,\n} from 'react';\n\nexport type EventBusListener<T = any> = (data: T) => void;\n\nexport interface EventBusContextValue {\n  emit: <T = any>(event: string, data?: T) => void;\n  emitSync: <T = any>(event: string, data?: T) => void;\n  on: <T = any>(event: string, listener: EventBusListener<T>) => () => void;\n  off: <T = any>(event: string, listener: EventBusListener<T>) => void;\n}\n\nconst EventBusContext = createContext<EventBusContextValue | null>(null);\n\nexport interface EventBusProviderProps {\n  children: ReactNode;\n}\n\n/**\n * EventBusProvider provides a global event system for the application.\n *\n * @example\n * ```tsx\n * function App() {\n *   return (\n *     <EventBusProvider>\n *       <YourComponents />\n *     </EventBusProvider>\n *   );\n * }\n * ```\n */\nexport function EventBusProvider({ children }: EventBusProviderProps) {\n  const listeners = useRef<Record<string, EventBusListener[]>>({});\n\n  const off = useCallback(\n    <T = any>(event: string, listener: EventBusListener<T>) => {\n      const eventListeners = listeners.current[event];\n      if (eventListeners) {\n        listeners.current[event] = eventListeners.filter((l) => l !== listener);\n\n        // Clean up empty event arrays\n        if (listeners.current[event].length === 0) {\n          delete listeners.current[event];\n        }\n      }\n    },\n    [],\n  );\n\n  const emitSync = useCallback(<T = any>(event: string, data?: T) => {\n    const eventListeners = listeners.current[event];\n    if (eventListeners) {\n      eventListeners.forEach((listener) => listener(data));\n    }\n  }, []);\n\n  const emit = useCallback(<T = any>(event: string, data?: T) => {\n    // Use setTimeout to ensure async emission after current render cycle\n    setTimeout(() => {\n      emitSync(event, data);\n    }, 0);\n  }, []);\n\n  const on = useCallback(\n    <T = any>(event: string, listener: EventBusListener<T>) => {\n      if (!listeners.current[event]) {\n        listeners.current[event] = [];\n      }\n      listeners.current[event].push(listener);\n\n      // Return cleanup function\n      return () => {\n        off(event, listener);\n      };\n    },\n    [off],\n  );\n\n  const contextValue: EventBusContextValue = {\n    emit,\n    emitSync,\n    on,\n    off,\n  };\n\n  return React.createElement(\n    EventBusContext.Provider,\n    { value: contextValue },\n    children,\n  );\n}\n\n/**\n * Hook to access the event bus functionality.\n * Must be used within an EventBusProvider.\n *\n * @example\n * ```tsx\n * function Component() {\n *   const { emit, emitSync, on } = useEventBus();\n *\n *   const handleClick = () => {\n *     emit('user-action', { type: 'click', target: 'button' });\n *   };\n *\n *   const handleSyncAction = () => {\n *     emitSync('sync-action', { immediate: true });\n *   };\n *\n *   useEffect(() => {\n *     const unsubscribe = on('data-updated', (data) => {\n *       console.log('Data updated:', data);\n *     });\n *\n *     return unsubscribe;\n *   }, [on]);\n *\n *   return (\n *     <div>\n *       <button onClick={handleClick}>Async Event</button>\n *       <button onClick={handleSyncAction}>Sync Event</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useEventBus(): EventBusContextValue {\n  const context = useContext(EventBusContext);\n\n  if (!context) {\n    throw new Error('useEventBus must be used within an EventBusProvider');\n  }\n\n  return context;\n}\n\n/**\n * Convenience hook for subscribing to events with automatic cleanup.\n * The listener will be automatically unsubscribed when the component unmounts\n * or when the dependencies change.\n *\n * @param event - The event name to listen for\n * @param listener - The callback function to execute when the event is emitted\n * @param deps - Dependency array for the effect (similar to useEffect)\n *\n * @example\n * ```tsx\n * function NotificationComponent() {\n *   const [message, setMessage] = useState('');\n *\n *   useEventListener('notification', (data) => {\n *     setMessage(data.message);\n *   }, []);\n *\n *   return <div>{message}</div>;\n * }\n * ```\n */\nexport function useEventListener<T = any>(\n  event: string,\n  listener: EventBusListener<T>,\n  deps: React.DependencyList = [],\n) {\n  const { on } = useEventBus();\n\n  useEffect(() => {\n    const unsubscribe = on(event, listener);\n    return unsubscribe;\n  }, [event, on, ...deps]);\n}\n"],"mappings":";;;;AAkBA,MAAM,kBAAkB,cAA2C,KAAK;;;;;;;;;;;;;;;AAoBxE,SAAgB,iBAAiB,EAAE,YAAmC;CACpE,MAAM,YAAY,OAA2C,EAAE,CAAC;CAEhE,MAAM,MAAM,aACA,OAAe,aAAkC;EACzD,MAAM,iBAAiB,UAAU,QAAQ;AACzC,MAAI,gBAAgB;AAClB,aAAU,QAAQ,SAAS,eAAe,QAAQ,MAAM,MAAM,SAAS;AAGvE,OAAI,UAAU,QAAQ,OAAO,WAAW,EACtC,QAAO,UAAU,QAAQ;;IAI/B,EAAE,CACH;CAED,MAAM,WAAW,aAAsB,OAAe,SAAa;EACjE,MAAM,iBAAiB,UAAU,QAAQ;AACzC,MAAI,eACF,gBAAe,SAAS,aAAa,SAAS,KAAK,CAAC;IAErD,EAAE,CAAC;CAwBN,MAAM,eAAqC;EACzC,MAvBW,aAAsB,OAAe,SAAa;AAE7D,oBAAiB;AACf,aAAS,OAAO,KAAK;MACpB,EAAE;KACJ,EAAE,CAAC;EAmBJ;EACA,IAlBS,aACC,OAAe,aAAkC;AACzD,OAAI,CAAC,UAAU,QAAQ,OACrB,WAAU,QAAQ,SAAS,EAAE;AAE/B,aAAU,QAAQ,OAAO,KAAK,SAAS;AAGvC,gBAAa;AACX,QAAI,OAAO,SAAS;;KAGxB,CAAC,IAAI,CACN;EAMC;EACD;AAED,QAAO,MAAM,cACX,gBAAgB,UAChB,EAAE,OAAO,cAAc,EACvB,SACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCH,SAAgB,cAAoC;CAClD,MAAM,UAAU,WAAW,gBAAgB;AAE3C,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,sDAAsD;AAGxE,QAAO;;;;;;;;;;;;;;;;;;;;;;;;AAyBT,SAAgB,iBACd,OACA,UACA,OAA6B,EAAE,EAC/B;CACA,MAAM,EAAE,OAAO,aAAa;AAE5B,iBAAgB;AAEd,SADoB,GAAG,OAAO,SAAS;IAEtC;EAAC;EAAO;EAAI,GAAG;EAAK,CAAC"}
+{"version":3,"file":"useEventBus.js","names":[],"sources":["../../../src/utils/react/useEventBus.ts"],"sourcesContent":["import React, {\n  createContext,\n  ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n} from 'react';\n\nexport type EventBusListener<T = any> = (data: T) => void;\n\nexport interface EventBusContextValue {\n  emit: <T = any>(event: string, data?: T) => void;\n  emitSync: <T = any>(event: string, data?: T) => void;\n  on: <T = any>(event: string, listener: EventBusListener<T>) => () => void;\n  off: <T = any>(event: string, listener: EventBusListener<T>) => void;\n}\n\nexport const EventBusContext = createContext<EventBusContextValue | null>(null);\n\nexport interface EventBusProviderProps {\n  children: ReactNode;\n}\n\n/**\n * EventBusProvider provides a global event system for the application.\n *\n * @example\n * ```tsx\n * function App() {\n *   return (\n *     <EventBusProvider>\n *       <YourComponents />\n *     </EventBusProvider>\n *   );\n * }\n * ```\n */\nexport function EventBusProvider({ children }: EventBusProviderProps) {\n  // If we're already inside a parent EventBusProvider (e.g. the global Root\n  // one), DO NOT create a fresh bus — that would isolate listeners and\n  // emitters across the boundary. This matters because overlays (Popover,\n  // Modal, Tray) re-wrap their content with our `Provider` from\n  // `provider.tsx`, which transparently nests an EventBusProvider. Cross-\n  // overlay events such as `popover:dismiss-ancestor` (a Button inside a\n  // popover footer dismissing the popover host) only work when both sides\n  // share the same bus.\n  const parentBus = useContext(EventBusContext);\n\n  const listeners = useRef<Record<string, EventBusListener[]>>({});\n\n  const off = useCallback(\n    <T = any>(event: string, listener: EventBusListener<T>) => {\n      const eventListeners = listeners.current[event];\n      if (eventListeners) {\n        listeners.current[event] = eventListeners.filter((l) => l !== listener);\n\n        // Clean up empty event arrays\n        if (listeners.current[event].length === 0) {\n          delete listeners.current[event];\n        }\n      }\n    },\n    [],\n  );\n\n  const emitSync = useCallback(<T = any>(event: string, data?: T) => {\n    const eventListeners = listeners.current[event];\n    if (eventListeners) {\n      eventListeners.forEach((listener) => listener(data));\n    }\n  }, []);\n\n  const emit = useCallback(\n    <T = any>(event: string, data?: T) => {\n      setTimeout(() => {\n        emitSync(event, data);\n      }, 0);\n    },\n    [emitSync],\n  );\n\n  const on = useCallback(\n    <T = any>(event: string, listener: EventBusListener<T>) => {\n      if (!listeners.current[event]) {\n        listeners.current[event] = [];\n      }\n      listeners.current[event].push(listener);\n\n      // Return cleanup function\n      return () => {\n        off(event, listener);\n      };\n    },\n    [off],\n  );\n\n  // Always compute the local contextValue so hook order stays stable, then\n  // pick parent OR local. `useMemo` keeps the local value referentially\n  // stable across renders — every consumer of `EventBusContext` (notably\n  // `useDismissParentPopover` inside every `Button` / `ItemButton`) would\n  // otherwise re-render on every render of this provider.\n  const localContextValue = useMemo<EventBusContextValue>(\n    () => ({ emit, emitSync, on, off }),\n    [emit, emitSync, on, off],\n  );\n\n  const contextValue = parentBus ?? localContextValue;\n\n  return React.createElement(\n    EventBusContext.Provider,\n    { value: contextValue },\n    children,\n  );\n}\n\n/**\n * Hook to access the event bus functionality.\n * Must be used within an EventBusProvider.\n *\n * @example\n * ```tsx\n * function Component() {\n *   const { emit, emitSync, on } = useEventBus();\n *\n *   const handleClick = () => {\n *     emit('user-action', { type: 'click', target: 'button' });\n *   };\n *\n *   const handleSyncAction = () => {\n *     emitSync('sync-action', { immediate: true });\n *   };\n *\n *   useEffect(() => {\n *     const unsubscribe = on('data-updated', (data) => {\n *       console.log('Data updated:', data);\n *     });\n *\n *     return unsubscribe;\n *   }, [on]);\n *\n *   return (\n *     <div>\n *       <button onClick={handleClick}>Async Event</button>\n *       <button onClick={handleSyncAction}>Sync Event</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useEventBus(): EventBusContextValue {\n  const context = useContext(EventBusContext);\n\n  if (!context) {\n    throw new Error('useEventBus must be used within an EventBusProvider');\n  }\n\n  return context;\n}\n\n/**\n * Convenience hook for subscribing to events with automatic cleanup.\n * The listener will be automatically unsubscribed when the component unmounts\n * or when the dependencies change.\n *\n * @param event - The event name to listen for\n * @param listener - The callback function to execute when the event is emitted\n * @param deps - Dependency array for the effect (similar to useEffect)\n *\n * @example\n * ```tsx\n * function NotificationComponent() {\n *   const [message, setMessage] = useState('');\n *\n *   useEventListener('notification', (data) => {\n *     setMessage(data.message);\n *   }, []);\n *\n *   return <div>{message}</div>;\n * }\n * ```\n */\nexport function useEventListener<T = any>(\n  event: string,\n  listener: EventBusListener<T>,\n  deps: React.DependencyList = [],\n) {\n  const { on } = useEventBus();\n\n  useEffect(() => {\n    const unsubscribe = on(event, listener);\n    return unsubscribe;\n  }, [event, on, ...deps]);\n}\n"],"mappings":";;;;AAmBA,MAAa,kBAAkB,cAA2C,KAAK;;;;;;;;;;;;;;;AAoB/E,SAAgB,iBAAiB,EAAE,YAAmC;CASpE,MAAM,YAAY,WAAW,gBAAgB;CAE7C,MAAM,YAAY,OAA2C,EAAE,CAAC;CAEhE,MAAM,MAAM,aACA,OAAe,aAAkC;EACzD,MAAM,iBAAiB,UAAU,QAAQ;AACzC,MAAI,gBAAgB;AAClB,aAAU,QAAQ,SAAS,eAAe,QAAQ,MAAM,MAAM,SAAS;AAGvE,OAAI,UAAU,QAAQ,OAAO,WAAW,EACtC,QAAO,UAAU,QAAQ;;IAI/B,EAAE,CACH;CAED,MAAM,WAAW,aAAsB,OAAe,SAAa;EACjE,MAAM,iBAAiB,UAAU,QAAQ;AACzC,MAAI,eACF,gBAAe,SAAS,aAAa,SAAS,KAAK,CAAC;IAErD,EAAE,CAAC;CAEN,MAAM,OAAO,aACD,OAAe,SAAa;AACpC,mBAAiB;AACf,YAAS,OAAO,KAAK;KACpB,EAAE;IAEP,CAAC,SAAS,CACX;CAED,MAAM,KAAK,aACC,OAAe,aAAkC;AACzD,MAAI,CAAC,UAAU,QAAQ,OACrB,WAAU,QAAQ,SAAS,EAAE;AAE/B,YAAU,QAAQ,OAAO,KAAK,SAAS;AAGvC,eAAa;AACX,OAAI,OAAO,SAAS;;IAGxB,CAAC,IAAI,CACN;CAOD,MAAM,oBAAoB,eACjB;EAAE;EAAM;EAAU;EAAI;EAAK,GAClC;EAAC;EAAM;EAAU;EAAI;EAAI,CAC1B;CAED,MAAM,eAAe,aAAa;AAElC,QAAO,MAAM,cACX,gBAAgB,UAChB,EAAE,OAAO,cAAc,EACvB,SACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCH,SAAgB,cAAoC;CAClD,MAAM,UAAU,WAAW,gBAAgB;AAE3C,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,sDAAsD;AAGxE,QAAO;;;;;;;;;;;;;;;;;;;;;;;;AAyBT,SAAgB,iBACd,OACA,UACA,OAA6B,EAAE,EAC/B;CACA,MAAM,EAAE,OAAO,aAAa;AAE5B,iBAAgB;AAEd,SADoB,GAAG,OAAO,SAAS;IAEtC;EAAC;EAAO;EAAI,GAAG;EAAK,CAAC"}

package/dist/utils/react/useId.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { useEffect, useRef, useState } from "react";
 import { useSSRSafeId } from "@react-aria/ssr";

package/dist/utils/react/useIsDarwin.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import { useEffect, useState } from "react";
 
 //#region src/utils/react/useIsDarwin.ts

package/dist/utils/react/useKeySymbols.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import { useIsDarwin } from "./useIsDarwin.js";
 import { useMemo } from "react";
 

package/dist/utils/react/useLayoutEffect.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import * as React$1 from "react";
 
 //#region src/utils/react/useLayoutEffect.tsx

package/dist/utils/react/useLocalStorage.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.141.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.142.1 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { useCallback, useSyncExternalStore } from "react";
 

package/dist/utils/react/useMergeStyles.js

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

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

@@ -0,0 +1,116 @@
+
+import { RefObject } from "react";
+
+//#region src/utils/react/usePopoverSync.d.ts
+interface UsePopoverSyncOptions {
+  /** Stable identifier for this popover instance (typically a generateRandomId() memo). */
+  menuId: string;
+  /** Current open state of this popover. */
+  isOpen: boolean;
+  /** Called when another popover opens while this one is open. */
+  onClose: () => void;
+  /**
+   * When `false`, this popover does not participate in the sync (no listening,
+   * no emitting). Useful for "dummy" triggers that proxy a real one (see
+   * `MenuTrigger`'s `isDummy`). Defaults to `true`.
+   */
+  enabled?: boolean;
+  /**
+   * Ref to the popover's trigger element. When provided, the element is
+   * included in the `popover:open` emit payload so peers can detect whether
+   * the new opener is nested inside their own overlay (and skip closing in
+   * that case). Optional — omitting it preserves the legacy "always close on
+   * peer open" behaviour.
+   */
+  triggerRef?: RefObject<HTMLElement | null>;
+  /**
+   * Ref to the overlay/container element that hosts this popover's content.
+   * When provided, the listener performs a DOM `contains()` check on incoming
+   * peer triggers: peers whose trigger lives inside this container are
+   * considered nested children and do NOT close us.
+   */
+  containerRef?: RefObject<HTMLElement | null>;
+  /**
+   * Whether this overlay closes when a Button/ItemButton inside its container
+   * is pressed. Defaults to `true` (popover semantics — popovers are transient
+   * surfaces and any action inside them should dismiss them). Set to `false`
+   * for modals/trays/fullscreen dialogs — buttons inside a Dialog should not
+   * auto-close it. Requires `containerRef` to be set; without it the listener
+   * has no way to determine whether the dispatching button is "inside" this
+   * overlay and is effectively a no-op.
+   */
+  dismissOnInnerButtonPress?: boolean;
+  /**
+   * Whether this overlay closes when a peer popover opens. Defaults to `true`
+   * (popover semantics — only one popover open at a time). Set to `false` for
+   * modals/trays/fullscreen dialogs so a peer popover opening cannot bypass
+   * the dialog's own `isDismissable` / `onClose` handling and yank it shut.
+   *
+   * The host still EMITS `popover:open` regardless of this flag, so opening a
+   * modal/tray correctly dismisses any peer popover that was open before.
+   */
+  closeOnPeerOpen?: boolean;
+}
+/**
+ * Coordinates the "only one popover open at a time" invariant via the EventBus.
+ *
+ * - When `isOpen` flips `false -> true`, emits `popover:open` once.
+ * - While open, listens for peers' `popover:open` events and calls `onClose`.
+ *
+ * Implementation notes (ALL of these matter — losing any one re-introduces a
+ * race that surfaces only under rapid trigger switching, which is hard to
+ * reproduce in tests):
+ *
+ * 1. `isOpen` and `onClose` are read through refs inside the listener, so the
+ *    subscription effect's dep array does NOT include `isOpen`/`onClose`. This
+ *    keeps the listener identity stable across open/close transitions and
+ *    avoids the unsubscribe-emit-resubscribe window where an emit can be
+ *    delivered to a stale listener (or no listener).
+ * 2. The emit fires only on the `false -> true` transition, gated by
+ *    `wasOpenRef`. A re-render where `isOpen` is still `true` must NOT
+ *    re-emit, otherwise it could re-trigger listeners on peers that just
+ *    opened in the same render flush.
+ * 3. The `enabled` flag short-circuits both effects symmetrically. When it
+ *    flips off, `wasOpenRef` is reset so re-enabling later still emits if
+ *    `isOpen` is true at that moment.
+ */
+declare function usePopoverSync({
+  menuId,
+  isOpen,
+  onClose,
+  enabled,
+  triggerRef,
+  containerRef,
+  dismissOnInnerButtonPress,
+  closeOnPeerOpen
+}: UsePopoverSyncOptions): void;
+/**
+ * Hook that returns a dispatcher to close the popover that contains a given
+ * DOM element. Used by `Button` / `ItemButton` to implement the default
+ * "press inside a popover closes the popover" behaviour. Custom (non-Cube)
+ * interactive controls can call this directly:
+ *
+ * ```tsx
+ * const dismiss = useDismissParentPopover();
+ * <MyCustomPressable onPress={(e) => { doThing(); dismiss(e.currentTarget); }} />
+ * ```
+ *
+ * The actual dismiss is dispatched through the EventBus, which defers via
+ * `setTimeout(0)` — so the user's synchronous handler (and any React state
+ * updates it triggers) flushes BEFORE the popover closes. This is critical
+ * for the "open a hoisted modal from a popover footer" case: the modal
+ * mounts first, then the popover closes.
+ *
+ * Only popover-type containers (those that pass `dismissOnInnerButtonPress`
+ * as `true`, the default) react to the event. Modal/tray/fullscreen Dialog
+ * containers explicitly opt out so a Button inside their content does not
+ * auto-close them.
+ *
+ * When called outside an `EventBusProvider` (e.g. in unit tests that render
+ * a Button without wrapping in `<Root>`), the returned function is a no-op —
+ * the dismiss flow gracefully degrades rather than throwing.
+ */
+declare function useDismissParentPopover(): (from: Element | null) => void;
+//#endregion
+export { UsePopoverSyncOptions, useDismissParentPopover, usePopoverSync };
+//# sourceMappingURL=usePopoverSync.d.ts.map