entangle-ui 0.8.2 → 0.10.0

package/dist/esm/components/primitives/viewport/viewportMath.js

@@ -0,0 +1,77 @@
+import { clamp } from '../../../utils/mathUtils.js';
+
+/**
+ * Compute a transform that fits `bounds` (in world coordinates) into the
+ * viewport `size`, with optional uniform inner `padding` in screen pixels.
+ *
+ * The resulting transform preserves aspect ratio (uniform zoom on both axes)
+ * and centers the content within the viewport.
+ */
+function computeFitTransform(bounds, size, padding, limits) {
+    const innerW = Math.max(1, size.width - padding * 2);
+    const innerH = Math.max(1, size.height - padding * 2);
+    // Degenerate bounds — fall back to identity scale, center on bounds origin
+    const w = bounds.width > 0 ? bounds.width : 1;
+    const h = bounds.height > 0 ? bounds.height : 1;
+    const zoomX = innerW / w;
+    const zoomY = innerH / h;
+    const zoom = clamp(Math.min(zoomX, zoomY), limits.minZoom, limits.maxZoom);
+    // Center of world bounds maps to center of viewport
+    const worldCx = bounds.x + bounds.width / 2;
+    const worldCy = bounds.y + bounds.height / 2;
+    const screenCx = size.width / 2;
+    const screenCy = size.height / 2;
+    return {
+        x: screenCx - worldCx * zoom,
+        y: screenCy - worldCy * zoom,
+        zoom,
+    };
+}
+/**
+ * Compute a transform that centers `point` (world coordinates) in the
+ * viewport, optionally setting a new zoom.
+ */
+function computeCenterTransform(point, size, current, limits, nextZoom) {
+    const zoom = clamp(nextZoom ?? current.zoom, limits.minZoom, limits.maxZoom);
+    return {
+        x: size.width / 2 - point.x * zoom,
+        y: size.height / 2 - point.y * zoom,
+        zoom,
+    };
+}
+/**
+ * Compute the new transform for a "zoom toward pivot" gesture.
+ *
+ * The world point currently under `pivot` (screen pixels) stays under
+ * the pivot after the zoom change.
+ */
+function computeZoomTowardPivot(pivot, factor, current, limits) {
+    const nextZoom = clamp(current.zoom * factor, limits.minZoom, limits.maxZoom);
+    // World position under pivot before zoom
+    const worldX = (pivot.x - current.x) / (current.zoom || 1);
+    const worldY = (pivot.y - current.y) / (current.zoom || 1);
+    // Keep world point under pivot after zoom
+    return {
+        x: pivot.x - worldX * nextZoom,
+        y: pivot.y - worldY * nextZoom,
+        zoom: nextZoom,
+    };
+}
+/**
+ * Normalize a rectangle so that width and height are non-negative,
+ * adjusting the origin accordingly. Useful for marquee selection
+ * where the user may drag in any direction.
+ */
+function normalizeRect(rect) {
+    const x = rect.width < 0 ? rect.x + rect.width : rect.x;
+    const y = rect.height < 0 ? rect.y + rect.height : rect.y;
+    return {
+        x,
+        y,
+        width: Math.abs(rect.width),
+        height: Math.abs(rect.height),
+    };
+}
+
+export { computeCenterTransform, computeFitTransform, computeZoomTowardPivot, normalizeRect };
+//# sourceMappingURL=viewportMath.js.map

package/dist/esm/components/primitives/viewport/viewportMath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewportMath.js","sources":["../../../../../../src/components/primitives/viewport/viewportMath.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/components/shell/AppShell/AppShell.js

@@ -42,7 +42,7 @@ const AppShellRoot = ({ viewportLock = false, topChromeSeparator = 'border', sid
         left: true,
         right: true,
     });
-    const isToolbarVisible = useCallback((position) => toolbarVisibility[position] ?? true, [toolbarVisibility]);
+    const isToolbarVisible = useCallback((position) => toolbarVisibility[position], [toolbarVisibility]);
     const setToolbarVisible = useCallback((position, visible) => {
         setToolbarVisibility(prev => ({ ...prev, [position]: visible }));
     }, []);

package/dist/esm/components/shell/AppShell/AppShell.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppShell.js","sources":["../../../../../../src/components/shell/AppShell/AppShell.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AA2BA;AAEA;AACE;AACA;AACA;AACA;AACD;AAEM;AAEP;AAEA;AAkBA;AAEA;;AAYE;AAAiC;;AAG/B;AACA;;AAMU;AACA;AACD;AAUT;AACE;;AAeN;AACA;AAEA;AAmBA;AAEA;AAmBA;AAEA;AAEA;AAYE;AAGE;AACA;AACA;AACD;;;AASG;;AAKJ;;;;;AAMG;;;;;AAMA;;AAiBL;AAEA;AAEA;AAEO;AACL;AACA;AACA;AACA;AACD;;"}
+{"version":3,"file":"AppShell.js","sources":["../../../../../../src/components/shell/AppShell/AppShell.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AA8BA;AAEA;AACE;AACA;AACA;AACA;AACD;AAEM;AAEP;AAEA;AAkBA;AAEA;;AAYE;AAAiC;;AAG/B;AACA;;AAMU;AACA;AACD;AAUT;AACE;;AAeN;AACA;AAEA;AAmBA;AAEA;AAmBA;AAEA;AAEA;AAYE;AAGE;AACA;AACA;AACD;AAED;;AAOI;;AAKJ;;;;;AAMG;;;;;AAMA;;AAiBL;AAEA;AAEA;AAEO;AACL;AACA;AACA;AACA;AACD;;"}

package/dist/esm/components/shell/FloatingPanel/FloatingPanel.css.js

@@ -1,18 +1,19 @@
-import './../../../assets/src/components/shell/FloatingPanel/FloatingPanel.css.ts.vanilla-1rIAXEFp.css';
+import './../../../assets/src/components/shell/FloatingPanel/FloatingPanel.css.ts.vanilla-CRaeYJ2b.css';
 
-var collapsibleHidden = 'FloatingPanel_collapsibleHidden__exxnv7b';
-var collapsibleVisible = 'FloatingPanel_collapsibleVisible__exxnv7a';
-var header = 'FloatingPanel_header__exxnv76';
-var headerActions = 'FloatingPanel_headerActions__exxnv78';
-var headerButton = 'FloatingPanel_headerButton__exxnv79';
-var panel = 'FloatingPanel_panel__exxnv75';
+var collapsibleHidden = 'FloatingPanel_collapsibleHidden__exxnv7c';
+var collapsibleVisible = 'FloatingPanel_collapsibleVisible__exxnv7b';
+var header = 'FloatingPanel_header__exxnv77';
+var headerActions = 'FloatingPanel_headerActions__exxnv79';
+var headerButton = 'FloatingPanel_headerButton__exxnv7a';
+var managerRoot = 'FloatingPanel_managerRoot__exxnv75';
+var panel = 'FloatingPanel_panel__exxnv76';
 var panelHeightVar = 'var(--panelHeightVar__exxnv73)';
 var panelWidthVar = 'var(--panelWidthVar__exxnv72)';
 var panelZIndexVar = 'var(--panelZIndexVar__exxnv74)';
 var posXVar = 'var(--posXVar__exxnv70)';
 var posYVar = 'var(--posYVar__exxnv71)';
-var resizeHandle = 'FloatingPanel_resizeHandle__exxnv7c';
-var title = 'FloatingPanel_title__exxnv77';
+var resizeHandle = 'FloatingPanel_resizeHandle__exxnv7d';
+var title = 'FloatingPanel_title__exxnv78';
 
-export { collapsibleHidden, collapsibleVisible, header, headerActions, headerButton, panel, panelHeightVar, panelWidthVar, panelZIndexVar, posXVar, posYVar, resizeHandle, title };
+export { collapsibleHidden, collapsibleVisible, header, headerActions, headerButton, managerRoot, panel, panelHeightVar, panelWidthVar, panelZIndexVar, posXVar, posYVar, resizeHandle, title };
 //# sourceMappingURL=FloatingPanel.css.js.map

package/dist/esm/components/shell/FloatingPanel/FloatingPanel.css.js.map

@@ -1 +1 @@
-{"version":3,"file":"FloatingPanel.css.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"FloatingPanel.css.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;"}

package/dist/esm/components/shell/FloatingPanel/FloatingPanel.js

@@ -1,14 +1,15 @@
 "use client";
 import { jsx, jsxs } from 'react/jsx-runtime';
-import { useRef, useState, useCallback, useMemo, useId, useEffect, createContext, useContext } from 'react';
 import { assignInlineVars } from '@vanilla-extract/dynamic';
-import { cx } from '../../../utils/cx.js';
-import { useMergedRef } from '../../../hooks/useMergedRef/useMergedRef.js';
-import { ScrollArea } from '../../layout/ScrollArea/ScrollArea.js';
-import { CloseIcon } from '../../Icons/CloseIcon.js';
-import { ChevronUpIcon } from '../../Icons/ChevronUpIcon.js';
+import { useRef, useState, useCallback, useMemo, useId, useEffect, createContext, useContext } from 'react';
 import { ChevronDownIcon } from '../../Icons/ChevronDownIcon.js';
-import { panelZIndexVar, panelHeightVar, panelWidthVar, posYVar, posXVar, header, title, headerActions, headerButton, collapsibleHidden, collapsibleVisible, resizeHandle, panel } from './FloatingPanel.css.js';
+import { ChevronUpIcon } from '../../Icons/ChevronUpIcon.js';
+import { CloseIcon } from '../../Icons/CloseIcon.js';
+import { ScrollArea } from '../../layout/ScrollArea/ScrollArea.js';
+import { useLatest } from '../../../hooks/useLatest/useLatest.js';
+import { useMergedRef } from '../../../hooks/useMergedRef/useMergedRef.js';
+import { cx } from '../../../utils/cx.js';
+import { managerRoot, panelZIndexVar, panelHeightVar, panelWidthVar, posYVar, posXVar, header, title, headerActions, headerButton, collapsibleHidden, collapsibleVisible, resizeHandle, panel } from './FloatingPanel.css.js';
 
 // --- FloatingManager Context ---
 const FloatingManagerContext = 
@@ -38,8 +39,13 @@ const FloatingManager = ({ baseZIndex = 100, children, }) => {
         const index = stackRef.current.indexOf(id);
         return baseZIndex + (index >= 0 ? index : 0);
     }, [baseZIndex]);
-    const contextValue = useMemo(() => ({ bringToFront, getZIndex, register, unregister }), [revision, bringToFront, getZIndex, register, unregister]);
-    return (jsx(FloatingManagerContext.Provider, { value: contextValue, children: children }));
+    const contextValue = useMemo(() => ({ bringToFront, getZIndex, register, unregister }), 
+    // `revision` is bumped whenever the panel stack changes; it intentionally
+    // busts this memo so consumers re-render and re-read z-indices from the
+    // (otherwise stable) getZIndex, even though it is not read in the factory.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [revision, bringToFront, getZIndex, register, unregister]);
+    return (jsx(FloatingManagerContext.Provider, { value: contextValue, children: jsx("div", { className: managerRoot, children: children }) }));
 };
 FloatingManager.displayName = 'FloatingManager';
 // --- FloatingPanel Component ---
@@ -72,35 +78,65 @@ const FloatingPanel = ({ title: panelTitle, position: controlledPosition, defaul
             setInternalCollapsed(next);
         onCollapsedChange?.(next);
     }, [isCollapsed, controlledCollapsed, onCollapsedChange]);
-    // FloatingManager registration -- use stable id, run once
-    const managerRef = useRef(manager);
-    managerRef.current = manager;
+    const handleCollapseKeyDown = useCallback((e) => {
+        if (e.key === 'Enter' || e.key === ' ') {
+            e.preventDefault();
+            toggleCollapse();
+        }
+    }, [toggleCollapse]);
+    const handleCloseKeyDown = useCallback((e) => {
+        if (e.key === 'Enter' || e.key === ' ') {
+            e.preventDefault();
+            onClose?.();
+        }
+    }, [onClose]);
+    // FloatingManager registration -- use stable id, run once. Latest manager via
+    // useLatest so the register/unregister effect and handlers read it without
+    // writing a ref during render.
+    const managerRef = useLatest(manager);
     useEffect(() => {
         managerRef.current?.register(id);
+        // Reading the latest manager from the ref at cleanup is intentional.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
         return () => managerRef.current?.unregister(id);
+        // Register/unregister exactly once per id. managerRef is a stable useLatest
+        // ref read at both register and unregister time; the manager is read via
+        // the ref because the manager context value changes on every panel
+        // registration and must not re-trigger this effect.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [id]);
     const handleBringToFront = useCallback(() => {
         managerRef.current?.bringToFront(id);
-    }, [id]);
+    }, [id, managerRef]);
     const zIndex = manager?.getZIndex(id) ?? 100;
     // --- Drag ---
     const panelRef = useRef(null);
     const setPanelRef = useMergedRef(panelRef, externalRef);
-    const dragOffsetRef = useRef({ x: 0, y: 0 });
     const handleDragStart = useCallback((e) => {
         e.preventDefault();
         const target = e.currentTarget;
         target.setPointerCapture(e.pointerId);
-        dragOffsetRef.current = {
-            x: e.clientX - pos.x,
-            y: e.clientY - pos.y,
-        };
+        // Track the pointer delta from the drag start, so positioning is
+        // independent of the coordinate space the panel lives in.
+        const startPointer = { x: e.clientX, y: e.clientY };
+        const startPos = { x: pos.x, y: pos.y };
+        const bounds = panelRef.current?.offsetParent?.getBoundingClientRect();
+        const panelRect = panelRef.current?.getBoundingClientRect();
         const handleDragMove = (me) => {
-            const newX = me.clientX - dragOffsetRef.current.x;
-            const newY = me.clientY - dragOffsetRef.current.y;
-            const clampedX = Math.max(0, Math.min(newX, window.innerWidth - 50));
-            const clampedY = Math.max(0, Math.min(newY, window.innerHeight - 30));
-            setPos({ x: clampedX, y: clampedY });
+            const newX = startPos.x + (me.clientX - startPointer.x);
+            const newY = startPos.y + (me.clientY - startPointer.y);
+            // Clamp within the positioned container when one is available,
+            // keeping a small margin of the panel on-screen.
+            const maxX = bounds
+                ? Math.max(0, bounds.width - (panelRect?.width ?? 50))
+                : Number.POSITIVE_INFINITY;
+            const maxY = bounds
+                ? Math.max(0, bounds.height - 30)
+                : Number.POSITIVE_INFINITY;
+            setPos({
+                x: Math.max(0, Math.min(newX, maxX)),
+                y: Math.max(0, Math.min(newY, maxY)),
+            });
         };
         const handleDragEnd = () => {
             target.removeEventListener('pointermove', handleDragMove);
@@ -143,7 +179,7 @@ const FloatingPanel = ({ title: panelTitle, position: controlledPosition, defaul
     return (jsxs("div", { ref: setPanelRef, className: cx(panel, className), "data-testid": testId, role: "dialog", "aria-modal": "false", "aria-label": panelTitle, tabIndex: -1, onPointerDown: handleBringToFront, style: {
             ...style,
             ...inlineVars,
-        }, ...rest, children: [jsxs("div", { className: header, onPointerDown: handleDragStart, "data-testid": "panel-header", children: [jsx("span", { className: title, children: panelTitle }), jsxs("div", { className: headerActions, children: [jsx("span", { className: headerButton, role: "button", tabIndex: 0, onClick: toggleCollapse, "aria-label": isCollapsed ? 'Expand panel' : 'Collapse panel', children: isCollapsed ? (jsx(ChevronDownIcon, { size: "sm", color: "secondary", decorative: true })) : (jsx(ChevronUpIcon, { size: "sm", color: "secondary", decorative: true })) }), closable && onClose && (jsx("span", { className: headerButton, role: "button", tabIndex: 0, onClick: onClose, "aria-label": "Close panel", children: jsx(CloseIcon, { size: "sm", color: "secondary", decorative: true }) }))] })] }), jsx("div", { className: isCollapsed ? collapsibleHidden : collapsibleVisible, children: jsx(ScrollArea, { direction: "both", scrollbarVisibility: "auto", scrollbarWidth: 5, autoFill: true, children: children }) }), resizable && !isCollapsed && (jsx("div", { className: resizeHandle, onPointerDown: handleResizeStart, "data-testid": "resize-handle" }))] }));
+        }, ...rest, children: [jsxs("div", { className: header, onPointerDown: handleDragStart, "data-testid": "panel-header", children: [jsx("span", { className: title, children: panelTitle }), jsxs("div", { className: headerActions, children: [jsx("span", { className: headerButton, role: "button", tabIndex: 0, onClick: toggleCollapse, onKeyDown: handleCollapseKeyDown, "aria-label": isCollapsed ? 'Expand panel' : 'Collapse panel', children: isCollapsed ? (jsx(ChevronDownIcon, { size: "sm", color: "secondary", decorative: true })) : (jsx(ChevronUpIcon, { size: "sm", color: "secondary", decorative: true })) }), closable && onClose && (jsx("span", { className: headerButton, role: "button", tabIndex: 0, onClick: onClose, onKeyDown: handleCloseKeyDown, "aria-label": "Close panel", children: jsx(CloseIcon, { size: "sm", color: "secondary", decorative: true }) }))] })] }), jsx("div", { className: isCollapsed ? collapsibleHidden : collapsibleVisible, children: jsx(ScrollArea, { direction: "both", scrollbarVisibility: "auto", scrollbarWidth: 5, autoFill: true, children: children }) }), resizable && !isCollapsed && (jsx("div", { className: resizeHandle, onPointerDown: handleResizeStart, "data-testid": "resize-handle" }))] }));
 };
 FloatingPanel.displayName = 'FloatingPanel';
 

package/dist/esm/components/shell/FloatingPanel/FloatingPanel.js.map

@@ -1 +1 @@
-{"version":3,"file":"FloatingPanel.js","sources":["../../../../../../src/components/shell/FloatingPanel/FloatingPanel.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;AA0CA;AAEA;AACE;AAEF;AAEO;AAIL;;AAGA;;;;;;AAOA;AACE;;;AAIF;AACE;;AACoC;;;;AAKtC;;AAGI;AACF;AAIF;AAKA;AAKF;AAEA;AAEA;;AA6BE;AACA;AACA;;;AAKA;AACA;AAEI;;AACA;AACF;;;AAOF;AACA;AAEI;;AACA;AACF;;;AAMF;AACA;AACE;;;AAEA;;;AAIF;AACA;;AAGE;;AAEF;AAEA;AACE;AACF;;;AAKA;;AAEA;AAEA;;AAGI;AACA;;AAGE;AACA;;AAGF;;;;;;AAMA;;AAGE;AACA;AACF;AAEA;AACA;AACF;;AAKF;;;AAII;AACA;AAEA;AACA;AACA;AACA;AAEA;AACE;AACA;AACA;AACA;;AAEF;;AAGE;AACA;AACF;AAEA;AACA;AACF;;AAKA;AACA;AACA;AACA;AACA;AACD;AAED;AAWM;AACA;;AAwDR;AAEA;;"}
+{"version":3,"file":"FloatingPanel.js","sources":["../../../../../../src/components/shell/FloatingPanel/FloatingPanel.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;AA+CA;AAEA;AACE;AAEF;AAEO;AAIL;;AAGA;;;;;;AAOA;AACE;;;AAIF;AACE;;AACoC;;;;AAKtC;;AAGI;AACF;AAIF;;;;;;AASA;AAKF;AAEA;AAEA;;AA6BE;AACA;AACA;;;AAKA;AACA;AAEI;;AACA;AACF;;;AAOF;AACA;AAEI;;AACA;AACF;;;AAMF;AACA;AACE;;;AAEA;;AAGF;AAEI;;AAEE;;AAEJ;AAIF;AAEI;;;;AAIF;;;;AAOF;;AAGE;;;;;;;;;AASF;AAEA;AACE;AACF;;;AAKA;;AAGA;;AAGI;AACA;;;AAIA;AACA;;;AAIA;AACE;AACA;;;;AAIE;AACA;;AAEA;AACA;AACF;AACE;AACA;AACD;AACH;;AAGE;AACA;AACF;AAEA;AACA;AACF;;AAKF;;;AAII;AACA;AAEA;AACA;AACA;AACA;AAEA;AACE;AACA;AACA;AACA;;AAEF;;AAGE;AACA;AACF;AAEA;AACA;AACF;;AAKA;AACA;AACA;AACA;AACA;AACD;AAED;AAWM;AACA;;AA0DR;AAEA;;"}

package/dist/esm/components/shell/MenuBar/MenuBar.js

@@ -34,6 +34,7 @@ const MenuBarItem = ({ onClick, shortcut: shortcutText, disabled = false, icon,
 };
 MenuBarItem.displayName = 'MenuBar.Item';
 const MenuBarSub = ({ label, children, disabled = false, className, style, testId, ref, ...rest }) => {
+    const { menuOffset } = useMenuBar();
     const [open, setOpen] = useState(false);
     const closeTimer = useRef(null);
     const handleEnter = useCallback(() => {
@@ -45,7 +46,9 @@ const MenuBarSub = ({ label, children, disabled = false, className, style, testI
             setOpen(true);
     }, [disabled]);
     const handleLeave = useCallback(() => {
-        closeTimer.current = setTimeout(() => setOpen(false), SUBMENU_CLOSE_DELAY);
+        closeTimer.current = setTimeout(() => {
+            setOpen(false);
+        }, SUBMENU_CLOSE_DELAY);
     }, []);
     useEffect(() => {
         return () => {
@@ -53,7 +56,7 @@ const MenuBarSub = ({ label, children, disabled = false, className, style, testI
                 clearTimeout(closeTimer.current);
         };
     }, []);
-    return (jsxs("div", { ref: ref, className: cx(subContainer, className), style: style, "data-testid": testId, onMouseEnter: handleEnter, onMouseLeave: handleLeave, ...rest, children: [jsxs("button", { className: subTrigger, role: "menuitem", "aria-haspopup": "true", "aria-expanded": open, disabled: disabled, type: "button", tabIndex: -1, children: [jsx("span", { children: label }), jsx(ChevronRight, {})] }), open && (jsx("div", { className: subDropdown, role: "menu", children: children }))] }));
+    return (jsxs("div", { ref: ref, className: cx(subContainer, className), style: style, "data-testid": testId, onMouseEnter: handleEnter, onMouseLeave: handleLeave, ...rest, children: [jsxs("button", { className: subTrigger, role: "menuitem", "aria-haspopup": "true", "aria-expanded": open, disabled: disabled, type: "button", tabIndex: -1, children: [jsx("span", { children: label }), jsx(ChevronRight, {})] }), open && (jsx("div", { className: subDropdown, role: "menu", style: { left: `calc(100% + ${menuOffset}px)` }, children: children }))] }));
 };
 MenuBarSub.displayName = 'MenuBar.Sub';
 const MenuBarSeparator = ({ className, style, testId, ref, ...rest }) => {
@@ -69,7 +72,9 @@ const MenuBarMenu = ({ label, children, disabled = false, className, style, test
     const isOpen = openMenuId === menuId;
     useEffect(() => {
         registerMenu(menuId);
-        return () => unregisterMenu(menuId);
+        return () => {
+            unregisterMenu(menuId);
+        };
     }, [menuId, registerMenu, unregisterMenu]);
     const handleClick = useCallback(() => {
         if (disabled)
@@ -129,17 +134,23 @@ const MenuBarMenu = ({ label, children, disabled = false, className, style, test
             }
         };
         document.addEventListener('mousedown', handleOutsideClick);
-        return () => document.removeEventListener('mousedown', handleOutsideClick);
+        return () => {
+            document.removeEventListener('mousedown', handleOutsideClick);
+        };
     }, [isOpen, setOpenMenuId]);
-    return (jsxs("div", { ref: ref, className: cx(menuContainer, className), style: style, "data-testid": testId, ...rest, children: [jsx("button", { ref: triggerRef, className: trigger({ active: isOpen }), onClick: handleClick, onMouseEnter: handleMouseEnter, onKeyDown: handleKeyDown, disabled: disabled, type: "button", role: "menuitem", "aria-haspopup": "true", "aria-expanded": isOpen, tabIndex: -1, children: label }), isOpen && (jsx("div", { ref: dropdownRef, className: dropdown, role: "menu", "aria-label": label, onKeyDown: handleDropdownKeyDown, style: { top: `calc(100% + ${menuOffset}px)` }, children: children }))] }));
+    return (jsxs("div", { ref: ref, className: cx(menuContainer, className), style: style, "data-testid": testId, ...rest, children: [jsx("button", { ref: triggerRef, className: trigger({ active: isOpen }), onClick: handleClick, onMouseEnter: handleMouseEnter, onKeyDown: handleKeyDown, disabled: disabled, type: "button", role: "menuitem", "aria-haspopup": "true", "aria-expanded": isOpen, tabIndex: -1, children: label }), isOpen && (jsx("div", { ref: dropdownRef, className: dropdown, role: "menu", "aria-label": label, 
+                // Focusable programmatically so the open menu can receive focus and
+                // handle arrow-key navigation across its items.
+                tabIndex: -1, onKeyDown: handleDropdownKeyDown, style: { top: `calc(100% + ${menuOffset}px)` }, children: children }))] }));
 };
 MenuBarMenu.displayName = 'MenuBar.Menu';
 // --- Root Component ---
 const MenuBarRoot = ({ size = 'md', menuOffset = 2, children, className, style, testId, ref: externalRef, ...rest }) => {
     const [openMenuId, setOpenMenuId] = useState(null);
-    const menuIdsRef = useRef([]);
+    // Registered child menu ids, kept in state so the context value stays
+    // reactive (previously a ref + forceUpdate, which read the ref during render).
+    const [menuIds, setMenuIds] = useState([]);
     const safeMenuOffset = Math.max(0, menuOffset);
-    const [, forceUpdate] = useState(0);
     const barRef = useRef(null);
     const setBarRef = useMemo(() => (node) => {
         barRef.current = node;
@@ -147,19 +158,14 @@ const MenuBarRoot = ({ size = 'md', menuOffset = 2, children, className, style,
             externalRef(node);
         }
         else if (externalRef && typeof externalRef === 'object') {
-            externalRef.current =
-                node;
+            externalRef.current = node;
         }
     }, [externalRef]);
     const registerMenu = useCallback((id) => {
-        if (!menuIdsRef.current.includes(id)) {
-            menuIdsRef.current = [...menuIdsRef.current, id];
-            forceUpdate(c => c + 1);
-        }
+        setMenuIds(prev => (prev.includes(id) ? prev : [...prev, id]));
     }, []);
     const unregisterMenu = useCallback((id) => {
-        menuIdsRef.current = menuIdsRef.current.filter(m => m !== id);
-        forceUpdate(c => c + 1);
+        setMenuIds(prev => prev.filter(m => m !== id));
     }, []);
     const handleBarKeyDown = useCallback((e) => {
         if (!barRef.current)
@@ -191,7 +197,7 @@ const MenuBarRoot = ({ size = 'md', menuOffset = 2, children, className, style,
         setOpenMenuId,
         registerMenu,
         unregisterMenu,
-        menuIds: menuIdsRef.current,
+        menuIds,
     }), [
         size,
         safeMenuOffset,
@@ -199,6 +205,7 @@ const MenuBarRoot = ({ size = 'md', menuOffset = 2, children, className, style,
         setOpenMenuId,
         registerMenu,
         unregisterMenu,
+        menuIds,
     ]);
     return (jsx(MenuBarContext.Provider, { value: contextValue, children: jsx("div", { ref: setBarRef, className: cx(menuBarRoot({ size }), className), style: style, "data-testid": testId, role: "menubar", onKeyDown: handleBarKeyDown, tabIndex: 0, ...rest, children: children }) }));
 };

package/dist/esm/components/shell/MenuBar/MenuBar.js.map

@@ -1 +1 @@
-{"version":3,"file":"MenuBar.js","sources":["../../../../../../src/components/shell/MenuBar/MenuBar.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAmCA;AAEA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACD;AAED;AAEA;AAEA;AAEA;AAGM;AACA;AACD;AAML;AAEA;AAaE;AAEA;;AAEI;;;AAGJ;AAEA;AAkBF;AAEA;AAEA;;AAYE;AAEA;AACE;AACE;AACA;;AAEF;;AACF;AAEA;AACE;;;AAIA;;AAC0B;AAC1B;;AAGF;AA6BF;AAEA;AAEA;AAOE;AAUF;AAEA;AAEA;AAEA;AAWE;AACA;AAOA;AACA;AACA;;;AAIE;;AAGF;AACE;;;;AAIF;;;;;;AAOA;AAEI;;;;;;;;;AAWA;;;AAGE;;AAEJ;AAIF;AAEI;;AAOA;;AAEE;AACA;;AACK;;;AAIL;;AACK;;;AAGL;;AAEJ;;;AAMA;;AAEA;AACE;;;;;AAOF;AAEA;;AAEF;;AAuCF;AAEA;AAEA;AAEA;;AAYE;;;AAGA;;AAGI;AACA;;;AAEO;AACJ;AACC;;AAEN;AAIF;;;;;;AAOA;AACE;;;AAIF;;;AAII;;AASA;;AAEE;AACA;;AAEA;AACE;;;AAEG;;;AAIL;AACA;AACE;;;AAGN;AAIF;;AAGI;;;;;;AAMD;;;;;;;AAQA;;AAmBL;AAEA;AAEA;AAEO;AACL;AACA;AACA;AACA;AACD;;"}
+{"version":3,"file":"MenuBar.js","sources":["../../../../../../src/components/shell/MenuBar/MenuBar.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAsCA;AAEA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACD;AAED;AAEA;AAEA;AAEA;AAGM;AACA;AACD;AAML;AAEA;AAaE;AAEA;;AAEI;;;AAGJ;AAEA;AAkBF;AAEA;AAEA;AAWE;;AAEA;AAEA;AACE;AACE;AACA;;AAEF;;AACF;AAEA;AACE;;;;;AAMA;;AAC0B;AAC1B;;;AAoCJ;AAEA;AAEA;AAOE;AAUF;AAEA;AAEA;AAEA;AAWE;AACA;AAOA;AACA;AACA;;;AAIE;;AAEA;;AAGF;AACE;;;;AAIF;;;;;;AAOA;AAEI;;;;;;;;;AAWA;;;AAGE;;AAEJ;AAIF;AAEI;;AAOA;;AAEE;AACA;;AACK;;;AAIL;;AACK;;;AAGL;;AAEJ;;;AAMA;;AAEA;AACE;;;;;AAOF;AAEA;AACA;AACE;AACF;AACF;AAEA;;;;AAwCF;AAEA;AAEA;AAEA;;;;;;AAgBE;;AAGI;AACA;;;AAEO;AACL;;AAEJ;AAIF;;;AAIA;AACE;;AAGF;;;AAII;;AASA;;AAEE;AACA;;AAEA;AACE;;;AAEG;;;AAIL;AACA;AACE;;;AAGN;AAIF;;AAGI;;;;;;AAMD;;;;;;;;AASA;;AAmBL;AAEA;AAEA;AAEO;AACL;AACA;AACA;AACA;AACD;;"}

package/dist/esm/components/shell/StatusBar/StatusBar.js.map

@@ -1 +1 @@
-{"version":3,"file":"StatusBar.js","sources":["../../../../../../src/components/shell/StatusBar/StatusBar.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAkBA;AACE;AACD;AAED;AAEA;AAEA;AAWI;AAWF;AAGF;AAEA;AAeI;;;AAeE;;AAiBF;AAYF;AAGF;AAEA;AAEA;AAWE;;AAiBF;AAEA;AAEA;AAEO;AACL;AACA;AACD;;"}
+{"version":3,"file":"StatusBar.js","sources":["../../../../../../src/components/shell/StatusBar/StatusBar.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAqBA;AACE;AACD;AAED;AAEA;AAEA;AAWI;AAWF;AAGF;AAEA;AAeI;;;AAeE;;AAiBF;AAYF;AAGF;AAEA;AAEA;AAWE;;AAiBF;AAEA;AAEA;AAEO;AACL;AACA;AACD;;"}

package/dist/esm/components/shell/Toolbar/Toolbar.js

@@ -22,7 +22,9 @@ const ToolbarButton = /*#__PURE__*/ React.memo(({ onClick, icon, children, toolt
 ToolbarButton.displayName = 'Toolbar.Button';
 const ToolbarToggle = /*#__PURE__*/ React.memo(({ pressed, onPressedChange, icon, children, tooltip, disabled = false, className, style, testId, ref, ...rest }) => {
     const { size } = useToolbar();
-    return (jsxs("button", { onClick: () => onPressedChange(!pressed), disabled: disabled, className: cx(toolbarButton({ size, variant: 'default', active: pressed }), className), style: style, "data-testid": testId, ref: ref, title: tooltip, type: "button", tabIndex: -1, "aria-pressed": pressed, ...rest, children: [icon, !icon && children] }));
+    return (jsxs("button", { onClick: () => {
+            onPressedChange(!pressed);
+        }, disabled: disabled, className: cx(toolbarButton({ size, variant: 'default', active: pressed }), className), style: style, "data-testid": testId, ref: ref, title: tooltip, type: "button", tabIndex: -1, "aria-pressed": pressed, ...rest, children: [icon, !icon && children] }));
 });
 ToolbarToggle.displayName = 'Toolbar.Toggle';
 const ToolbarGroupComp = /*#__PURE__*/ React.memo(({ children, className, style, testId, ref, ...rest }) => {
@@ -48,8 +50,7 @@ const ToolbarRoot = ({ orientation = 'horizontal', size = 'md', children, classN
             externalRef(node);
         }
         else if (externalRef && typeof externalRef === 'object') {
-            externalRef.current =
-                node;
+            externalRef.current = node;
         }
     }, [externalRef]);
     const handleKeyDown = useCallback((e) => {

package/dist/esm/components/shell/Toolbar/Toolbar.js.map

@@ -1 +1 @@
-{"version":3,"file":"Toolbar.js","sources":["../../../../../../src/components/shell/Toolbar/Toolbar.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AA4BA;AACE;AACA;AACD;AAED;AAEA;AAEA;AAGA;;AAIA;AAEA;AAEA;AAeI;AAEA;AAoBF;AAGF;AAEA;AAeI;AAEA;AAqBF;AAGF;AAEA;AAEI;AAEA;AAYF;AAGF;AAEA;AAEI;;AAcF;AAGF;AAEA;;AAWE;AAGF;AAEA;AAEA;AAWE;;AAII;AACA;;;AAEO;AACJ;AACC;;AAEN;AAIF;AAEI;AACA;;AAEA;AACA;;AAEA;;AAGA;AACA;AAEA;;AAEE;AACA;;AACK;;;AAIL;;AACK;;AAEL;;AACK;;;;AAIT;AAIF;AACE;AACA;;;AAGA;AACE;AACA;;;;;AA2BN;AAEA;AAEA;AAEO;AACL;AACA;AACA;AACA;AACA;AACD;;"}
+{"version":3,"file":"Toolbar.js","sources":["../../../../../../src/components/shell/Toolbar/Toolbar.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AA+BA;AACE;AACA;AACD;AAED;AAEA;AAEA;AAGA;;AAIA;AAEA;AAEA;AAeI;AAEA;AAoBF;AAGF;AAEA;AAeI;AAEA;AAGM;AACF;AAmBN;AAGF;AAEA;AAEI;AAEA;AAYF;AAGF;AAEA;AAEI;;AAcF;AAGF;AAEA;;AAWE;AAGF;AAEA;AAEA;AAWE;;AAII;AACA;;;AAEO;AACL;;AAEJ;AAIF;AAEI;AACA;;AAEA;AACA;;AAEA;;AAGA;AACA;AAEA;;AAEE;AACA;;AACK;;;AAIL;;AACK;;AAEL;;AACK;;;;AAIT;AAIF;AACE;AACA;;;AAGA;AACE;AACA;;;;;AA2BN;AAEA;AAEA;AAEO;AACL;AACA;AACA;AACA;AACA;AACD;;"}

package/dist/esm/context/KeyboardContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"KeyboardContext.js","sources":["../../../../src/context/KeyboardContext.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAQA;AACE;AACA;;AAGF;AAQO;AAEH;AACA;AAKF;AAGK;AAYD;AACJ;AAEA;AACE;AACE;AACE;;AAEJ;AACF;AAEA;AACE;AACE;AACE;;AAEJ;AACF;;AAGE;AACA;AACF;AACF;;"}
+{"version":3,"file":"KeyboardContext.js","sources":["../../../../src/context/KeyboardContext.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAcA;AACE;AACA;;AAGF;AAQO;AAEH;AACA;AAKF;AAGK;AAYD;AACJ;AAEA;AACE;AACE;AACE;;AAEJ;AACF;AAEA;AACE;AACE;AACE;;AAEJ;AACF;;AAGE;AACA;AACF;AACF;;"}

package/dist/esm/hooks/useBreakpoint/useBreakpoint.js

@@ -0,0 +1,44 @@
+"use client";
+import { useMemo } from 'react';
+import { useMediaQuery } from '../useMediaQuery/useMediaQuery.js';
+import { breakpoints, BREAKPOINT_ORDER } from '../../theme/breakpoints.js';
+
+const SM_QUERY = `(min-width: ${breakpoints.sm}px)`;
+const MD_QUERY = `(min-width: ${breakpoints.md}px)`;
+const LG_QUERY = `(min-width: ${breakpoints.lg}px)`;
+const XL_QUERY = `(min-width: ${breakpoints.xl}px)`;
+function resolveCurrent(map) {
+    for (let i = BREAKPOINT_ORDER.length - 1; i >= 0; i -= 1) {
+        const name = BREAKPOINT_ORDER[i];
+        if (name && map[name])
+            return name;
+    }
+    return 'xs';
+}
+/**
+ * Reactive named-breakpoint matcher.
+ *
+ * Returns booleans for each named breakpoint plus the largest matching
+ * `current`. Built on top of `useMediaQuery`. Breakpoint values come from
+ * `@/theme/breakpoints` and match the values used by `Stack` and other
+ * responsive layout components.
+ *
+ * @example
+ * ```tsx
+ * const { md, current } = useBreakpoint();
+ * return md ? <Sidebar /> : <BottomSheet />;
+ * ```
+ */
+function useBreakpoint() {
+    const sm = useMediaQuery(SM_QUERY);
+    const md = useMediaQuery(MD_QUERY);
+    const lg = useMediaQuery(LG_QUERY);
+    const xl = useMediaQuery(XL_QUERY);
+    return useMemo(() => {
+        const map = { xs: true, sm, md, lg, xl };
+        return { ...map, current: resolveCurrent(map) };
+    }, [sm, md, lg, xl]);
+}
+
+export { useBreakpoint };
+//# sourceMappingURL=useBreakpoint.js.map

package/dist/esm/hooks/useBreakpoint/useBreakpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBreakpoint.js","sources":["../../../../../src/hooks/useBreakpoint/useBreakpoint.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAUA;AACA;AACA;AACA;AAEA;AACE;AACE;AACA;AAAuB;;AAEzB;AACF;AAEA;;;;;;;;;;;;;AAaG;;AAED;AACA;AACA;AACA;;AAGE;;;AAGJ;;"}

package/dist/esm/hooks/useClickOutside/useClickOutside.js

@@ -1,5 +1,6 @@
 "use client";
-import { useRef, useEffect } from 'react';
+import { useEffect } from 'react';
+import { useLatest } from '../useLatest/useLatest.js';
 
 function isOutside(target, refs) {
     if (!(target instanceof Node))
@@ -32,13 +33,11 @@ function isOutside(target, refs) {
  */
 function useClickOutside(ref, handler, options = {}) {
     const { enabled = true, event = 'mousedown' } = options;
-    const handlerRef = useRef(handler);
-    const refsRef = useRef([]);
-    // Latest handler — invoked from the listener without re-subscribing.
-    handlerRef.current = handler;
-    // Latest ref(s) — refreshed every render so consumers may pass inline
-    // arrays without forcing a re-subscribe of the document listener.
-    refsRef.current = Array.isArray(ref) ? ref : [ref];
+    // Latest handler / ref(s), refreshed after each commit so the document
+    // listener reads live values without re-subscribing and consumers may pass
+    // inline arrays.
+    const handlerRef = useLatest(handler);
+    const refsRef = useLatest(Array.isArray(ref) ? ref : [ref]);
     useEffect(() => {
         if (!enabled)
             return;
@@ -53,7 +52,8 @@ function useClickOutside(ref, handler, options = {}) {
         return () => {
             document.removeEventListener(event, listener);
         };
-    }, [enabled, event]);
+        // handlerRef/refsRef are stable useLatest refs; listed to satisfy the rule.
+    }, [enabled, event, handlerRef, refsRef]);
 }
 
 export { useClickOutside };

package/dist/esm/hooks/useClickOutside/useClickOutside.js.map

@@ -1 +1 @@
-{"version":3,"file":"useClickOutside.js","sources":["../../../../../src/hooks/useClickOutside/useClickOutside.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAoBA;AACE;AAA+B;AAE/B;AACE;AACA;AACE;;;AAGJ;AACF;AAEA;;;;;;;;;;;;;;;;;AAiBG;AACG;;AAOJ;AACA;;AAGA;;;AAGA;;AAGE;;;;AAGA;;AAEI;;AAEJ;AAEA;AACA;AACE;AACF;AACF;AACF;;"}
+{"version":3,"file":"useClickOutside.js","sources":["../../../../../src/hooks/useClickOutside/useClickOutside.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAwBA;AACE;AAA+B;AAE/B;AACE;AACA;AACE;;;AAGJ;AACF;AAEA;;;;;;;;;;;;;;;;;AAiBG;AACG;;;;;AAUJ;;;AAIE;;;;AAGA;;AAEI;;AAEJ;AAEA;AACA;AACE;AACF;;;AAGJ;;"}

package/dist/esm/hooks/useClipboard/useClipboard.js

@@ -24,6 +24,10 @@ function writeViaExecCommand(text) {
     textarea.select();
     let succeeded = false;
     try {
+        // Legacy fallback used only when navigator.clipboard.writeText is
+        // unavailable (the modern primary path). execCommand has no modern
+        // synchronous equivalent for this fallback scenario.
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
         succeeded = document.execCommand('copy');
     }
     catch {

package/dist/esm/hooks/useClipboard/useClipboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"useClipboard.js","sources":["../../../../../src/hooks/useClipboard/useClipboard.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AASA;AAEA;;AAGI;;AAGA;;;AAGF;AACF;AAEA;;AACuC;;AAGrC;AACA;AACA;AACA;AACA;AACA;;;AAIA;AACE;;AACA;;;AAGF;AACA;AACF;AAEA;;;;;;;;;;;;;;;;;;AAkBG;AACG;AAGJ;;;AAKA;AACA;;;;;AAKA;;AAGE;AACF;AAEA;AACE;AACE;AACA;;;AAIJ;AACE;;;AAGA;;;AAGF;;AAII;AAEA;AACA;;;AAKA;AACE;;;AAEA;;AAGF;AACE;AACE;;AAEE;;;;AAGF;;;;;AAMJ;AACE;;;;;AAMA;AACE;;;;;AAKA;;;AAGF;AACA;;;;AAKF;AACF;;AAKA;AACE;AACE;AACA;;AAEJ;;;;;;;;;AAUJ;;"}
+{"version":3,"file":"useClipboard.js","sources":["../../../../../src/hooks/useClipboard/useClipboard.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAUA;AAEA;;AAGI;;AAGA;;;AAGF;AACF;AAEA;;AACuC;;AAGrC;AACA;AACA;AACA;AACA;AACA;;;AAIA;;;;;AAKE;;AACA;;;AAGF;AACA;AACF;AAEA;;;;;;;;;;;;;;;;;;AAkBG;AACG;AAGJ;;;AAKA;AACA;;;;;AAKA;;AAGE;AACF;AAEA;AACE;AACE;AACA;;;AAIJ;AACE;;;AAGA;;;AAGF;;AAII;AAEA;AACA;;;AAKA;AACE;;;AAEA;;AAGF;AACE;AACE;;AAEE;;;;AAGF;;;;;AAMJ;AACE;;;;;AAMA;AACE;;;;;AAKA;;;AAGF;AACA;;;;AAKF;AACF;;AAKA;AACE;AACE;AACA;;AAEJ;;;;;;;;;AAUJ;;"}

package/dist/esm/hooks/useControlledState/useControlledState.js.map

@@ -1 +1 @@
-{"version":3,"file":"useControlledState.js","sources":["../../../../../src/hooks/useControlledState/useControlledState.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAgBA;;;;;;;;;;;;;;;;;;;;;;;AAuBG;AACG;;AAKJ;;;AAIA;;;;AAMA;AACA;AACA;;AAGE;AACF;;AAGE;AACF;;;;AAKE;AACA;;;;AAOM;AAEJ;;AAEJ;AAEA;AAEI;AACE;AACA;AACF;AAGA;;AAEE;;AAEF;AACF;;AAKF;AACF;;"}
+{"version":3,"file":"useControlledState.js","sources":["../../../../../src/hooks/useControlledState/useControlledState.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAiBA;;;;;;;;;;;;;;;;;;;;;;;AAuBG;AACG;;AAKJ;;;AAIA;;;;AAMA;AACA;AACA;;AAGE;AACF;;AAGE;AACF;;;;AAKE;AACA;;;;AAOM;AAEJ;;AAEJ;AAEA;AAEI;AACE;AACA;AACF;AAGA;;AAEE;;AAEF;AACF;;AAKF;AACF;;"}