@cube-dev/ui-kit 0.135.0 → 0.136.0

package/dist/utils/modules.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 //#region src/utils/react/forwardRefWithGenerics.tsx
 /**
 * A helper for creating forwardRef components with generic types.

package/dist/utils/react/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { chain } from "./chain.js";
 import { forwardRefWithGenerics } from "./forwardRefWithGenerics.js";
 import { isTextOnly } from "./isTextOnly.js";

package/dist/utils/react/interactions.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { createSharedStore } from "./sharedStore.js";
 import { useEffect } from "react";
 import { useFocusVisible } from "react-aria";

package/dist/utils/react/useEventBus.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import React, { createContext, useCallback, useContext, useEffect, useRef } from "react";
 
 //#region src/utils/react/useEventBus.ts

package/dist/utils/react/useId.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | 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.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { mergeStyles } from "@tenphi/tasty";
 import { useMemo } from "react";
 

package/dist/utils/react/usePopoverSync.js

@@ -0,0 +1,69 @@
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
+import { useEventBus } from "./useEventBus.js";
+import { useEffect, useRef } from "react";
+
+//#region src/utils/react/usePopoverSync.ts
+/**
+* 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.
+*/
+function usePopoverSync({ menuId, isOpen, onClose, enabled = true }) {
+	const { emit, on } = useEventBus();
+	const isOpenRef = useRef(isOpen);
+	useEffect(() => {
+		isOpenRef.current = isOpen;
+	}, [isOpen]);
+	const onCloseRef = useRef(onClose);
+	useEffect(() => {
+		onCloseRef.current = onClose;
+	}, [onClose]);
+	useEffect(() => {
+		if (!enabled) return;
+		return on("popover:open", (data) => {
+			if (data.menuId !== menuId && isOpenRef.current) onCloseRef.current();
+		});
+	}, [
+		on,
+		menuId,
+		enabled
+	]);
+	const wasOpenRef = useRef(false);
+	useEffect(() => {
+		if (!enabled) {
+			wasOpenRef.current = false;
+			return;
+		}
+		if (isOpen && !wasOpenRef.current) {
+			wasOpenRef.current = true;
+			emit("popover:open", { menuId });
+		} else if (!isOpen) wasOpenRef.current = false;
+	}, [
+		isOpen,
+		emit,
+		menuId,
+		enabled
+	]);
+}
+
+//#endregion
+export { usePopoverSync };
+//# sourceMappingURL=usePopoverSync.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePopoverSync.js","names":[],"sources":["../../../src/utils/react/usePopoverSync.ts"],"sourcesContent":["import { useEffect, useRef } from 'react';\n\nimport { 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\n/**\n * Coordinates the \"only one popover open at a time\" invariant via the EventBus.\n *\n * - When `isOpen` flips `false -> true`, emits `popover:open` once.\n * - While open, listens for peers' `popover:open` events and calls `onClose`.\n *\n * Implementation notes (ALL of these matter — losing any one re-introduces a\n * race that surfaces only under rapid trigger switching, which is hard to\n * reproduce in tests):\n *\n * 1. `isOpen` and `onClose` are read through refs inside the listener, so the\n *    subscription effect's dep array does NOT include `isOpen`/`onClose`. This\n *    keeps the listener identity stable across open/close transitions and\n *    avoids the unsubscribe-emit-resubscribe window where an emit can be\n *    delivered to a stale listener (or no listener).\n * 2. The emit fires only on the `false -> true` transition, gated by\n *    `wasOpenRef`. A re-render where `isOpen` is still `true` must NOT\n *    re-emit, otherwise it could re-trigger listeners on peers that just\n *    opened in the same render flush.\n * 3. The `enabled` flag short-circuits both effects symmetrically. When it\n *    flips off, `wasOpenRef` is reset so re-enabling later still emits if\n *    `isOpen` is true at that moment.\n */\nexport function usePopoverSync({\n  menuId,\n  isOpen,\n  onClose,\n  enabled = true,\n}: UsePopoverSyncOptions): void {\n  const { emit, on } = useEventBus();\n\n  const isOpenRef = useRef(isOpen);\n  useEffect(() => {\n    isOpenRef.current = isOpen;\n  }, [isOpen]);\n\n  const onCloseRef = useRef(onClose);\n  useEffect(() => {\n    onCloseRef.current = onClose;\n  }, [onClose]);\n\n  useEffect(() => {\n    if (!enabled) return;\n    return on('popover:open', (data: { menuId: string }) => {\n      if (data.menuId !== menuId && isOpenRef.current) {\n        onCloseRef.current();\n      }\n    });\n  }, [on, menuId, enabled]);\n\n  const wasOpenRef = useRef(false);\n  useEffect(() => {\n    if (!enabled) {\n      wasOpenRef.current = false;\n      return;\n    }\n    if (isOpen && !wasOpenRef.current) {\n      wasOpenRef.current = true;\n      emit('popover:open', { menuId });\n    } else if (!isOpen) {\n      wasOpenRef.current = false;\n    }\n  }, [isOpen, emit, menuId, enabled]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAgB,eAAe,EAC7B,QACA,QACA,SACA,UAAU,QACoB;CAC9B,MAAM,EAAE,MAAM,OAAO,aAAa;CAElC,MAAM,YAAY,OAAO,OAAO;AAChC,iBAAgB;AACd,YAAU,UAAU;IACnB,CAAC,OAAO,CAAC;CAEZ,MAAM,aAAa,OAAO,QAAQ;AAClC,iBAAgB;AACd,aAAW,UAAU;IACpB,CAAC,QAAQ,CAAC;AAEb,iBAAgB;AACd,MAAI,CAAC,QAAS;AACd,SAAO,GAAG,iBAAiB,SAA6B;AACtD,OAAI,KAAK,WAAW,UAAU,UAAU,QACtC,YAAW,SAAS;IAEtB;IACD;EAAC;EAAI;EAAQ;EAAQ,CAAC;CAEzB,MAAM,aAAa,OAAO,MAAM;AAChC,iBAAgB;AACd,MAAI,CAAC,SAAS;AACZ,cAAW,UAAU;AACrB;;AAEF,MAAI,UAAU,CAAC,WAAW,SAAS;AACjC,cAAW,UAAU;AACrB,QAAK,gBAAgB,EAAE,QAAQ,CAAC;aACvB,CAAC,OACV,YAAW,UAAU;IAEtB;EAAC;EAAQ;EAAM;EAAQ;EAAQ,CAAC"}

package/dist/utils/react/useQaProps.js

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

package/dist/utils/react/useViewportSize.js

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

package/dist/utils/react/wrapNodeIfPlain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 import { isValidElement } from "react";
 import { isFragment } from "react-is";
 

package/dist/utils/selection.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 //#region src/utils/selection.ts
 /**
 * Deduplicate/toggle keys in a selection: if a key appears twice it is

package/dist/utils/styles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 //#region src/utils/styles.ts
 /**
 * Split properties into style and non-style properties.

package/dist/utils/tree.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 //#region src/utils/tree.ts
 function toFlatTree(tree, includingFolders) {
 	return tree.reduce((result, node) => {

package/dist/utils/warnings.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 //#region src/utils/warnings.ts
 const SUGGESTED_PROP_MAP = {
 	disabled: "isDisabled",

package/dist/version.js

@@ -1,6 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.135.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.136.0 | Cube Dev Team */
 //#region src/version.ts
-const VERSION = "0.135.0";
+const VERSION = "0.136.0";
 if (typeof window !== "undefined") {
 	const version = VERSION;
 	window.CubeUIKit = window.CubeUIKit || { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cube-dev/ui-kit",
-  "version": "0.135.0",
+  "version": "0.136.0",
   "type": "module",
   "description": "UIKit for Cube Projects",
   "repository": {
@@ -113,6 +113,7 @@
     "eslint-plugin-storybook": "^10.2.3",
     "globals": "^16.0.0",
     "husky": "^6.0.0",
+    "jsdom": "^29.1.1",
     "lint-staged": "^10.0.0",
     "markdown-table": "^3.0.3",
     "npm-run-all": "^4.1.5",