glirastes 0.1.0

package/dist/react/hooks/use-drag-resize-panel.js

@@ -0,0 +1,306 @@
+import { useState, useCallback, useEffect, useRef, } from 'react';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_SNAP_RADIUS = 100;
+const DEFAULT_EDGE_THRESHOLD = 20;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function readSessionNumber(key) {
+    if (typeof window === 'undefined')
+        return null;
+    try {
+        const stored = sessionStorage.getItem(key);
+        return stored ? Number(stored) : null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeSessionNumber(key, value) {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        sessionStorage.setItem(key, String(value));
+    }
+    catch {
+        // Ignore errors from private browsing or quota limits
+    }
+}
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+export function useDragResizePanel(options) {
+    const { panelRef, width: defaultWidth, height: defaultHeight, minWidth, minHeight, maxWidth, maxHeight, initialPosition, snapToCenter = false, snapRadius = DEFAULT_SNAP_RADIUS, edgeThreshold = DEFAULT_EDGE_THRESHOLD, persistDimensions = false, draggable = true, resizable = true, } = options;
+    const storagePrefix = persistDimensions === true
+        ? 'chat-panel'
+        : typeof persistDimensions === 'string'
+            ? persistDimensions
+            : null;
+    // -----------------------------------------------------------------------
+    // Position state (null = default centered)
+    // -----------------------------------------------------------------------
+    const [position, setPosition] = useState(() => initialPosition ?? null);
+    // -----------------------------------------------------------------------
+    // Size state (with optional session-storage persistence)
+    // -----------------------------------------------------------------------
+    const [size, setSize] = useState(() => {
+        if (storagePrefix) {
+            const storedWidth = readSessionNumber(`${storagePrefix}-width`);
+            const storedHeight = readSessionNumber(`${storagePrefix}-height`);
+            return {
+                width: storedWidth ?? defaultWidth,
+                height: storedHeight ?? defaultHeight,
+            };
+        }
+        return { width: defaultWidth, height: defaultHeight };
+    });
+    // Sync to incoming prop changes. Without this, the `size` state is
+    // frozen at mount time and consumers updating their `size` / `width` /
+    // `height` props see no effect until a hard reload.
+    useEffect(() => {
+        setSize({ width: defaultWidth, height: defaultHeight });
+    }, [defaultWidth, defaultHeight]);
+    // -----------------------------------------------------------------------
+    // Interaction states
+    // -----------------------------------------------------------------------
+    const [isDragging, setIsDragging] = useState(false);
+    const [isResizing, setIsResizing] = useState(false);
+    const [activeEdge, setActiveEdge] = useState(null);
+    const [isNearSnapZone, setIsNearSnapZone] = useState(false);
+    const [nearEdge, setNearEdge] = useState({ top: false, left: false, right: false });
+    // -----------------------------------------------------------------------
+    // Refs for drag/resize start state (mutable, never trigger re-renders)
+    // -----------------------------------------------------------------------
+    const dragStartRef = useRef(null);
+    const resizeStartRef = useRef(null);
+    const wasDraggingRef = useRef(false);
+    // -----------------------------------------------------------------------
+    // Snap-to-center helpers
+    // -----------------------------------------------------------------------
+    const shouldSnapToCenter = useCallback((x, _y) => {
+        if (!snapToCenter || typeof window === 'undefined')
+            return false;
+        const panel = panelRef.current;
+        if (!panel)
+            return false;
+        const viewportCenterX = window.innerWidth / 2;
+        const panelHeight = panel.getBoundingClientRect().height;
+        const defaultY = window.innerHeight - 16 - panelHeight;
+        return (Math.abs(x - viewportCenterX) < snapRadius &&
+            Math.abs(_y - defaultY) < snapRadius);
+    }, [snapToCenter, panelRef, snapRadius]);
+    // -----------------------------------------------------------------------
+    // Drag handlers
+    // -----------------------------------------------------------------------
+    const handleDragStart = useCallback((e) => {
+        if (!draggable)
+            return;
+        if (e.button !== 0)
+            return;
+        if (e.target.closest('button'))
+            return;
+        const panel = panelRef.current;
+        if (!panel)
+            return;
+        const rect = panel.getBoundingClientRect();
+        // When position is null (centered), the rendering uses
+        // transform: translate(-50%, 0), so x represents the center of the panel.
+        // We compute the initial x as rect.left + rect.width / 2 for smooth drag.
+        dragStartRef.current = {
+            mouseX: e.clientX,
+            mouseY: e.clientY,
+            panelX: position?.x ?? rect.left + rect.width / 2,
+            panelY: position?.y ?? rect.top,
+        };
+        setIsDragging(true);
+        e.preventDefault();
+    }, [draggable, panelRef, position]);
+    const handleDoubleClickHeader = useCallback(() => {
+        if (snapToCenter) {
+            setPosition(null);
+        }
+    }, [snapToCenter]);
+    // -----------------------------------------------------------------------
+    // Edge resize handler (memoized, returns a function per edge)
+    // -----------------------------------------------------------------------
+    const handleEdgeResizeStart = useCallback((edge) => (e) => {
+        if (!resizable)
+            return;
+        if (e.button !== 0)
+            return;
+        const panel = panelRef.current;
+        if (!panel)
+            return;
+        const rect = panel.getBoundingClientRect();
+        resizeStartRef.current = {
+            mouseX: e.clientX,
+            mouseY: e.clientY,
+            width: rect.width,
+            height: rect.height,
+            positionX: position?.x ?? rect.left + rect.width / 2,
+            positionY: position?.y ?? rect.top,
+            edge,
+        };
+        setIsResizing(true);
+        setActiveEdge(edge);
+        e.preventDefault();
+        e.stopPropagation();
+    }, [resizable, panelRef, position]);
+    // -----------------------------------------------------------------------
+    // Edge detection
+    // -----------------------------------------------------------------------
+    const handlePanelMouseMove = useCallback((e) => {
+        const panel = panelRef.current;
+        if (!panel || isDragging || isResizing)
+            return;
+        const rect = panel.getBoundingClientRect();
+        setNearEdge({
+            top: e.clientY - rect.top < edgeThreshold,
+            left: e.clientX - rect.left < edgeThreshold,
+            right: e.clientX - rect.left > rect.width - edgeThreshold,
+        });
+    }, [panelRef, isDragging, isResizing, edgeThreshold]);
+    const handlePanelMouseLeave = useCallback(() => {
+        if (!isDragging && !isResizing) {
+            setNearEdge({ top: false, left: false, right: false });
+        }
+    }, [isDragging, isResizing]);
+    // -----------------------------------------------------------------------
+    // Persist dimensions to sessionStorage
+    // -----------------------------------------------------------------------
+    useEffect(() => {
+        if (storagePrefix) {
+            writeSessionNumber(`${storagePrefix}-width`, size.width);
+            writeSessionNumber(`${storagePrefix}-height`, size.height);
+        }
+    }, [storagePrefix, size.width, size.height]);
+    // -----------------------------------------------------------------------
+    // Global mouse listeners for active drag / resize
+    // -----------------------------------------------------------------------
+    useEffect(() => {
+        if (!isDragging && !isResizing)
+            return;
+        // Prevent accidental text selection during drag/resize
+        const prevUserSelect = document.body.style.userSelect;
+        document.body.style.userSelect = 'none';
+        const onMouseMove = (e) => {
+            if (isDragging && dragStartRef.current) {
+                const newX = dragStartRef.current.panelX +
+                    (e.clientX - dragStartRef.current.mouseX);
+                const newY = dragStartRef.current.panelY +
+                    (e.clientY - dragStartRef.current.mouseY);
+                setPosition({ x: newX, y: newY });
+                if (snapToCenter) {
+                    setIsNearSnapZone(shouldSnapToCenter(newX, newY));
+                }
+            }
+            if (isResizing && resizeStartRef.current) {
+                const start = resizeStartRef.current;
+                if (start.edge === 'top') {
+                    const deltaY = start.mouseY - e.clientY;
+                    let newHeight = start.height + deltaY;
+                    newHeight = Math.max(minHeight, newHeight);
+                    if (maxHeight != null)
+                        newHeight = Math.min(maxHeight, newHeight);
+                    const actualDelta = newHeight - start.height;
+                    setSize((prev) => ({ ...prev, height: newHeight }));
+                    // Move position up so the bottom edge stays anchored
+                    if (start.positionY != null) {
+                        setPosition((prev) => prev ? { ...prev, y: start.positionY - actualDelta } : prev);
+                    }
+                }
+                else if (start.edge === 'left') {
+                    const deltaX = start.mouseX - e.clientX;
+                    let newWidth = start.width + deltaX;
+                    newWidth = Math.max(minWidth, newWidth);
+                    if (maxWidth != null)
+                        newWidth = Math.min(maxWidth, newWidth);
+                    const actualDelta = newWidth - start.width;
+                    setSize((prev) => ({ ...prev, width: newWidth }));
+                    // Shift center left so the right edge stays anchored
+                    // (position.x is center due to translate(-50%, 0))
+                    if (start.positionX != null) {
+                        setPosition((prev) => prev ? { ...prev, x: start.positionX - actualDelta / 2 } : prev);
+                    }
+                }
+                else {
+                    const deltaX = e.clientX - start.mouseX;
+                    let newWidth = start.width + deltaX;
+                    newWidth = Math.max(minWidth, newWidth);
+                    if (maxWidth != null)
+                        newWidth = Math.min(maxWidth, newWidth);
+                    const actualDelta = newWidth - start.width;
+                    setSize((prev) => ({ ...prev, width: newWidth }));
+                    // Shift center right so the left edge stays anchored
+                    if (start.positionX != null) {
+                        setPosition((prev) => prev ? { ...prev, x: start.positionX + actualDelta / 2 } : prev);
+                    }
+                }
+            }
+        };
+        const onMouseUp = () => {
+            if (isDragging) {
+                wasDraggingRef.current = true;
+                setIsDragging(false);
+                setIsNearSnapZone(false);
+                dragStartRef.current = null;
+            }
+            if (isResizing) {
+                setIsResizing(false);
+                setActiveEdge(null);
+                resizeStartRef.current = null;
+            }
+        };
+        document.addEventListener('mousemove', onMouseMove);
+        document.addEventListener('mouseup', onMouseUp);
+        return () => {
+            document.body.style.userSelect = prevUserSelect;
+            document.removeEventListener('mousemove', onMouseMove);
+            document.removeEventListener('mouseup', onMouseUp);
+        };
+    }, [
+        isDragging,
+        isResizing,
+        snapToCenter,
+        shouldSnapToCenter,
+        minWidth,
+        minHeight,
+        maxWidth,
+        maxHeight,
+    ]);
+    // -----------------------------------------------------------------------
+    // Snap-on-release: detect transition from isDragging=true to false
+    // -----------------------------------------------------------------------
+    useEffect(() => {
+        if (!isDragging && wasDraggingRef.current) {
+            wasDraggingRef.current = false;
+            if (snapToCenter &&
+                position &&
+                shouldSnapToCenter(position.x, position.y)) {
+                setPosition(null);
+            }
+        }
+    }, [isDragging, snapToCenter, position, shouldSnapToCenter]);
+    // -----------------------------------------------------------------------
+    // Return
+    // -----------------------------------------------------------------------
+    return {
+        position,
+        size,
+        isDragging,
+        isResizing,
+        activeEdge,
+        isNearSnapZone,
+        nearEdge,
+        handlers: {
+            onDragStart: handleDragStart,
+            onDoubleClickHeader: handleDoubleClickHeader,
+            onEdgeResizeStart: handleEdgeResizeStart,
+            onPanelMouseMove: handlePanelMouseMove,
+            onPanelMouseLeave: handlePanelMouseLeave,
+        },
+    };
+}
+//# sourceMappingURL=use-drag-resize-panel.js.map

package/dist/react/hooks/use-drag-resize-panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-drag-resize-panel.js","sourceRoot":"","sources":["../../../src/react/hooks/use-drag-resize-panel.ts"],"names":[],"mappings":"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"}

package/dist/react/hooks/use-draggable-position.d.ts

@@ -0,0 +1,25 @@
+export interface UseDraggablePositionOptions {
+    /** Enable dragging. Default: true */
+    enabled?: boolean;
+    /** Movement threshold in px before a mousedown is treated as a drag. Default: 5 */
+    dragThreshold?: number;
+    /** SessionStorage key prefix for persisting position. Falsy = no persistence. */
+    persistKey?: string | false;
+}
+export interface UseDraggablePositionReturn {
+    /** Current position, or null if at default (not yet dragged / reset). */
+    position: {
+        x: number;
+        y: number;
+    } | null;
+    /** Whether the user is currently dragging. */
+    isDragging: boolean;
+    /** Attach to onMouseDown on the draggable element. */
+    onMouseDown: (e: React.MouseEvent<HTMLElement>) => void;
+    /** Whether the last interaction was a drag (true) vs a click (false).
+     *  Reset to false on the next mousedown. Use to suppress onClick. */
+    wasDragged: boolean;
+    /** Programmatically reset to default position. */
+    resetPosition: () => void;
+}
+export declare function useDraggablePosition(options?: UseDraggablePositionOptions): UseDraggablePositionReturn;

package/dist/react/hooks/use-draggable-position.js

@@ -0,0 +1,132 @@
+import { useState, useCallback, useEffect, useRef } from 'react';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function readPosition(key) {
+    if (typeof window === 'undefined')
+        return null;
+    try {
+        const raw = sessionStorage.getItem(key);
+        if (!raw)
+            return null;
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.x === 'number' && typeof parsed.y === 'number') {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function writePosition(key, pos) {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        if (pos) {
+            sessionStorage.setItem(key, JSON.stringify(pos));
+        }
+        else {
+            sessionStorage.removeItem(key);
+        }
+    }
+    catch {
+        // Ignore quota / private-browsing errors
+    }
+}
+function clampToViewport(x, y, elWidth, elHeight) {
+    const margin = 8;
+    return {
+        x: Math.max(margin, Math.min(x, window.innerWidth - elWidth - margin)),
+        y: Math.max(margin, Math.min(y, window.innerHeight - elHeight - margin)),
+    };
+}
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+export function useDraggablePosition(options = {}) {
+    const { enabled = true, dragThreshold = 5, persistKey = false } = options;
+    const storageKey = persistKey ? `draggable-pos-${persistKey}` : null;
+    const [position, setPosition] = useState(() => (storageKey ? readPosition(storageKey) : null));
+    const [isDragging, setIsDragging] = useState(false);
+    const [wasDragged, setWasDragged] = useState(false);
+    const dragRef = useRef(null);
+    // Persist position changes
+    useEffect(() => {
+        if (storageKey) {
+            writePosition(storageKey, position);
+        }
+    }, [storageKey, position]);
+    // ------ mousedown handler ------
+    const onMouseDown = useCallback((e) => {
+        if (!enabled)
+            return;
+        if (e.button !== 0)
+            return;
+        // Don't intercept clicks on nested interactive children (but allow
+        // when the matched element is the container itself, i.e. currentTarget)
+        const interactiveEl = e.target.closest('button, a, input, [role="button"]');
+        if (interactiveEl && interactiveEl !== e.currentTarget) {
+            return;
+        }
+        const el = e.currentTarget;
+        const rect = el.getBoundingClientRect();
+        dragRef.current = {
+            startMouseX: e.clientX,
+            startMouseY: e.clientY,
+            startElX: rect.left,
+            startElY: rect.top,
+            el,
+            didMove: false,
+        };
+        setWasDragged(false);
+        // We don't preventDefault here yet — we do it once we confirm a drag
+    }, [enabled]);
+    // ------ global mousemove / mouseup ------
+    useEffect(() => {
+        const onMouseMove = (e) => {
+            const drag = dragRef.current;
+            if (!drag)
+                return;
+            const dx = e.clientX - drag.startMouseX;
+            const dy = e.clientY - drag.startMouseY;
+            if (!drag.didMove) {
+                if (Math.abs(dx) < dragThreshold && Math.abs(dy) < dragThreshold) {
+                    return; // Below threshold — not a drag yet
+                }
+                drag.didMove = true;
+                setIsDragging(true);
+                // Prevent text selection once we start dragging
+                document.body.style.userSelect = 'none';
+            }
+            const rect = drag.el.getBoundingClientRect();
+            const newX = drag.startElX + dx;
+            const newY = drag.startElY + dy;
+            const clamped = clampToViewport(newX, newY, rect.width, rect.height);
+            setPosition(clamped);
+        };
+        const onMouseUp = () => {
+            const drag = dragRef.current;
+            if (!drag)
+                return;
+            if (drag.didMove) {
+                setWasDragged(true);
+                document.body.style.userSelect = '';
+            }
+            dragRef.current = null;
+            setIsDragging(false);
+        };
+        document.addEventListener('mousemove', onMouseMove);
+        document.addEventListener('mouseup', onMouseUp);
+        return () => {
+            document.removeEventListener('mousemove', onMouseMove);
+            document.removeEventListener('mouseup', onMouseUp);
+        };
+    }, [dragThreshold]);
+    const resetPosition = useCallback(() => {
+        setPosition(null);
+        setWasDragged(false);
+    }, []);
+    return { position, isDragging, onMouseDown, wasDragged, resetPosition };
+}
+//# sourceMappingURL=use-draggable-position.js.map

package/dist/react/hooks/use-draggable-position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-draggable-position.js","sourceRoot":"","sources":["../../../src/react/hooks/use-draggable-position.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AA6BjE,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,OAAO,MAAM,CAAC,CAAC,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YACjE,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,GAAW,EAAE,GAAoC;IACtE,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC;YACR,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yCAAyC;IAC3C,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,CAAS,EAAE,CAAS,EAAE,OAAe,EAAE,QAAgB;IAC9E,MAAM,MAAM,GAAG,CAAC,CAAC;IACjB,OAAO;QACL,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;QACtE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;KACzE,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E,MAAM,UAAU,oBAAoB,CAClC,UAAuC,EAAE;IAEzC,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,aAAa,GAAG,CAAC,EAAE,UAAU,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAE1E,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAErE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CACtC,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CACrD,CAAC;IACF,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,OAAO,GAAG,MAAM,CAOZ,IAAI,CAAC,CAAC;IAEhB,2BAA2B;IAC3B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,UAAU,EAAE,CAAC;YACf,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE3B,kCAAkC;IAClC,MAAM,WAAW,GAAG,WAAW,CAC7B,CAAC,CAAgC,EAAE,EAAE;QACnC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC3B,mEAAmE;QACnE,wEAAwE;QACxE,MAAM,aAAa,GAAI,CAAC,CAAC,MAAsB,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC;QAC7F,IAAI,aAAa,IAAI,aAAa,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;YACvD,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,CAAC,CAAC,aAAa,CAAC;QAC3B,MAAM,IAAI,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAC;QAExC,OAAO,CAAC,OAAO,GAAG;YAChB,WAAW,EAAE,CAAC,CAAC,OAAO;YACtB,WAAW,EAAE,CAAC,CAAC,OAAO;YACtB,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,QAAQ,EAAE,IAAI,CAAC,GAAG;YAClB,EAAE;YACF,OAAO,EAAE,KAAK;SACf,CAAC;QAEF,aAAa,CAAC,KAAK,CAAC,CAAC;QAErB,qEAAqE;IACvE,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,2CAA2C;IAC3C,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,CAAC,CAAa,EAAE,EAAE;YACpC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;YAC7B,IAAI,CAAC,IAAI;gBAAE,OAAO;YAElB,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC;YACxC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC;YAExC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC;oBACjE,OAAO,CAAC,mCAAmC;gBAC7C,CAAC;gBACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;gBACpB,aAAa,CAAC,IAAI,CAAC,CAAC;gBACpB,gDAAgD;gBAChD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC;YAC1C,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,qBAAqB,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACrE,WAAW,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC,CAAC;QAEF,MAAM,SAAS,GAAG,GAAG,EAAE;YACrB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;YAC7B,IAAI,CAAC,IAAI;gBAAE,OAAO;YAElB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,aAAa,CAAC,IAAI,CAAC,CAAC;gBACpB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC;YACtC,CAAC;YAED,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;YACvB,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC,CAAC;QAEF,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACpD,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAChD,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,mBAAmB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YACvD,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACrD,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpB,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;QACrC,WAAW,CAAC,IAAI,CAAC,CAAC;QAClB,aAAa,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;AAC1E,CAAC"}

package/dist/react/hooks/use-keyboard-shortcut.d.ts

@@ -0,0 +1,20 @@
+export interface UseKeyboardShortcutOptions {
+    /** Disable without removing the call site. Default: true. */
+    enabled?: boolean;
+    /**
+     * When true, the handler fires even if the event target is an editable
+     * element (input / textarea / contenteditable). Default: false — except
+     * for the `escape` key which always fires.
+     */
+    allowInEditable?: boolean;
+}
+/**
+ * Global keyboard shortcut. `mod` maps to ⌘ on Mac and Ctrl elsewhere.
+ * Escape always fires regardless of focused element so modal-style widgets
+ * can close even while an input has focus.
+ *
+ * @example
+ * useKeyboardShortcut('mod+i', () => setOpen((v) => !v));
+ * useKeyboardShortcut('escape', () => setOpen(false), { enabled: open });
+ */
+export declare function useKeyboardShortcut(combo: string | false | null | undefined, handler: () => void, options?: UseKeyboardShortcutOptions): void;

package/dist/react/hooks/use-keyboard-shortcut.js

@@ -0,0 +1,91 @@
+import { useEffect, useRef } from 'react';
+function isMac() {
+    if (typeof navigator === 'undefined')
+        return false;
+    return /Mac|iPhone|iPad|iPod/.test(navigator.platform || navigator.userAgent || '');
+}
+function parseCombo(combo) {
+    const parts = combo.toLowerCase().trim().split('+').map((p) => p.trim()).filter(Boolean);
+    if (parts.length === 0)
+        return null;
+    const result = { key: '', mod: false, shift: false, alt: false };
+    for (const part of parts) {
+        if (part === 'mod' || part === 'cmd' || part === 'ctrl' || part === 'meta' || part === 'control') {
+            result.mod = true;
+        }
+        else if (part === 'shift') {
+            result.shift = true;
+        }
+        else if (part === 'alt' || part === 'option' || part === 'opt') {
+            result.alt = true;
+        }
+        else {
+            result.key = part;
+        }
+    }
+    return result.key ? result : null;
+}
+function matches(event, combo) {
+    const wantMod = combo.mod;
+    const gotMod = isMac() ? event.metaKey : event.ctrlKey;
+    if (wantMod !== gotMod)
+        return false;
+    if (combo.shift !== event.shiftKey)
+        return false;
+    if (combo.alt !== event.altKey)
+        return false;
+    const key = event.key.toLowerCase();
+    if (combo.key === 'escape')
+        return key === 'escape' || key === 'esc';
+    return key === combo.key;
+}
+function isEditableTarget(target) {
+    if (!(target instanceof HTMLElement))
+        return false;
+    const tag = target.tagName;
+    if (tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT')
+        return true;
+    if (target.isContentEditable)
+        return true;
+    return false;
+}
+/**
+ * Global keyboard shortcut. `mod` maps to ⌘ on Mac and Ctrl elsewhere.
+ * Escape always fires regardless of focused element so modal-style widgets
+ * can close even while an input has focus.
+ *
+ * @example
+ * useKeyboardShortcut('mod+i', () => setOpen((v) => !v));
+ * useKeyboardShortcut('escape', () => setOpen(false), { enabled: open });
+ */
+export function useKeyboardShortcut(combo, handler, options = {}) {
+    const { enabled = true, allowInEditable = false } = options;
+    const handlerRef = useRef(handler);
+    handlerRef.current = handler;
+    useEffect(() => {
+        if (!enabled || !combo)
+            return;
+        const parsed = parseCombo(combo);
+        if (!parsed)
+            return;
+        const listener = (event) => {
+            if (event.defaultPrevented)
+                return;
+            if (!matches(event, parsed))
+                return;
+            // Shortcuts that include ⌘/Ctrl always fire (e.g. ⌘I, ⌘K) — even
+            // inside a textarea — matching standard webapp conventions. Escape
+            // always fires so modal-style widgets can close from any focus.
+            // Bare-key shortcuts are suppressed in editable targets.
+            const isEscape = parsed.key === 'escape';
+            const skipEditableCheck = allowInEditable || isEscape || parsed.mod;
+            if (!skipEditableCheck && isEditableTarget(event.target))
+                return;
+            event.preventDefault();
+            handlerRef.current();
+        };
+        window.addEventListener('keydown', listener);
+        return () => window.removeEventListener('keydown', listener);
+    }, [combo, enabled, allowInEditable]);
+}
+//# sourceMappingURL=use-keyboard-shortcut.js.map

package/dist/react/hooks/use-keyboard-shortcut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-keyboard-shortcut.js","sourceRoot":"","sources":["../../../src/react/hooks/use-keyboard-shortcut.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAoB1C,SAAS,KAAK;IACZ,IAAI,OAAO,SAAS,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IACnD,OAAO,sBAAsB,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,MAAM,GAAU,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IACxE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACjG,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5B,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;QACtB,CAAC;aAAM,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACjE,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACpC,CAAC;AAED,SAAS,OAAO,CAAC,KAAoB,EAAE,KAAY;IACjD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC;IAC1B,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;IACvD,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACrC,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC7C,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,KAAK,CAAC;IACrE,OAAO,GAAG,KAAK,KAAK,CAAC,GAAG,CAAC;AAC3B,CAAC;AAED,SAAS,gBAAgB,CAAC,MAA0B;IAClD,IAAI,CAAC,CAAC,MAAM,YAAY,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IACnD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC;IAC3B,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3E,IAAI,MAAM,CAAC,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAwC,EACxC,OAAmB,EACnB,UAAsC,EAAE;IAExC,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,eAAe,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK;YAAE,OAAO;QAC/B,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,MAAM,QAAQ,GAAG,CAAC,KAAoB,EAAE,EAAE;YACxC,IAAI,KAAK,CAAC,gBAAgB;gBAAE,OAAO;YACnC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;gBAAE,OAAO;YACpC,iEAAiE;YACjE,mEAAmE;YACnE,gEAAgE;YAChE,yDAAyD;YACzD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC;YACzC,MAAM,iBAAiB,GAAG,eAAe,IAAI,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC;YACpE,IAAI,CAAC,iBAAiB,IAAI,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC;gBAAE,OAAO;YACjE,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC7C,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/react/hooks/use-mentions.d.ts

@@ -0,0 +1,23 @@
+import type { UseMentionsReturn } from '../types.js';
+/**
+ * Hook for accessing mention search and selection.
+ *
+ * @example
+ * ```tsx
+ * function MentionSearch() {
+ *   const { query, results, select, isSearching } = useMentions();
+ *
+ *   return (
+ *     <div>
+ *       {isSearching && <Spinner />}
+ *       {results.map(r => (
+ *         <button key={r.id} onClick={() => select(r)}>
+ *           {r.label}
+ *         </button>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useMentions(): UseMentionsReturn;