@oh-just-another/react-ui 0.57.0

package/dist/toolbar.js

@@ -0,0 +1,282 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Circle, Frame, Hand, Image as ImageIcon, Lock, MousePointer2, PenLine, Redo2, Slash, Square, Type, Undo2, } from "lucide-react";
+import { defaultActionRegistry, formatHotkey } from "@oh-just-another/state";
+import { useEditorSelector } from "./context.js";
+import { useDiagramOptional, useHistory, useMode } from "./hooks.js";
+import { TOOLBAR_SEPARATOR_HEIGHT } from "./constants.js";
+import { Tooltip } from "./tooltip.js";
+/**
+ * Pixel size for icons rendered inside `du-icon-button` (32-px
+ * inside-group footprint). Lucide draws crisp at 16 px stroke-width
+ * 1.75.
+ */
+const TOOLBAR_ICON_SIZE = 16;
+const TOOLBAR_ICON_STROKE = 1.75;
+const iconProps = { size: TOOLBAR_ICON_SIZE, strokeWidth: TOOLBAR_ICON_STROKE };
+/**
+ * Maps an action's serializable `iconId` (declared in core, no React) to a
+ * concrete lucide icon, so a registry-driven `action-ref` button renders
+ * identically to the hardcoded toolbar.
+ */
+const ACTION_ICONS = {
+    "mode-select": MousePointer2,
+    "mode-hand": Hand,
+    "mode-rect": Square,
+    "mode-ellipse": Circle,
+    "mode-text": Type,
+    "mode-edge": Slash,
+    "mode-brush": PenLine,
+    "mode-frame": Frame,
+    "insert-image": ImageIcon,
+    "tool-lock": Lock,
+    undo: Undo2,
+    redo: Redo2,
+};
+/**
+ * Toolbar button sourced entirely from a registered action: label, icon
+ * (via `iconId`), hotkey tooltip, pressed state (`checked`) and disabled
+ * state (`predicate`) all come from `defaultActionRegistry`. Clicking
+ * dispatches the action. Subscribes to the editor's `change` event so the
+ * checked/disabled state stays live. Renders nothing if the action isn't
+ * registered (e.g. a host that didn't register `insert-image`).
+ */
+const ActionRefButton = ({ id }) => {
+    const editor = useDiagramOptional();
+    const [, force] = useState(0);
+    useEffect(() => {
+        if (!editor)
+            return undefined;
+        return editor.on("change", () => { force((n) => n + 1); });
+    }, [editor]);
+    const action = defaultActionRegistry.get(id);
+    if (!action)
+        return null;
+    const Icon = action.iconId ? ACTION_ICONS[action.iconId] : undefined;
+    const ctx = editor ? { editor } : null;
+    const active = ctx ? (action.checked?.(ctx) ?? false) : false;
+    const enabled = ctx ? (action.predicate ? action.predicate(ctx) : true) : false;
+    const matchers = action.hotkey === undefined ? [] : Array.isArray(action.hotkey) ? action.hotkey : [action.hotkey];
+    const first = matchers[0];
+    const title = `${action.label ?? id}${first ? ` (${formatHotkey(first)})` : ""}`;
+    return (_jsx(ToolbarButton, { title: title, active: active, disabled: !enabled, onClick: () => { if (editor)
+            defaultActionRegistry.dispatch(id, { editor }); }, children: Icon ? _jsx(Icon, { ...iconProps }) : (action.label ?? id) }));
+};
+/**
+ * Platform-correct zoom hotkey labels — ⌘ glyphs on macOS, "Ctrl+…"
+ * elsewhere. Descriptors mirror the bound zoom hotkeys; display uses the
+ * minus/plus glyphs.
+ */
+const HK_ZOOM_OUT = formatHotkey({ meta: true, key: "−" });
+const HK_ZOOM_IN = formatHotkey({ meta: true, key: "+" });
+const HK_ZOOM_RESET = formatHotkey({ meta: true, key: "0" });
+const HK_ZOOM_FIT = formatHotkey({ meta: true, key: "1" });
+/**
+ * Open an OS file picker for image(s) and insert them at the viewport
+ * centre via the editor's file-drop pipeline (same path as drag-and-drop,
+ * so sizing / GIF animation / Scene.files registration all apply).
+ * Multi-select supported — each file dispatched independently.
+ *
+ * Lives in the UI layer rather than the L2 `state` package because it
+ * touches the DOM (`<input type=file>`). Exported so hosts can wire it to
+ * a hotkey or a custom button.
+ */
+export const openImageFilePicker = (editor) => {
+    if (typeof document === "undefined")
+        return;
+    const input = document.createElement("input");
+    input.type = "file";
+    input.accept = "image/*";
+    input.multiple = true;
+    input.addEventListener("change", () => {
+        const files = input.files;
+        if (!files || files.length === 0)
+            return;
+        // Toolbar / hotkey invocation has no cursor position — land the
+        // image(s) at the viewport centre in world coords.
+        const vp = editor.scene.viewport;
+        const world = editor.screenToWorld({
+            x: vp.size.width / 2,
+            y: vp.size.height / 2,
+        });
+        for (const file of Array.from(files)) {
+            void editor.dispatchFileDrop(file, world);
+        }
+    });
+    input.click();
+};
+/** Convenience default — modes + tool-lock + undo/redo + zoom widget. */
+// Built from the action registry: modes / undo / redo / tool-lock are
+// `action-ref` (label·icon·hotkey·pressed·disabled sourced from the
+// action). Insert-image stays an inline `action` — it's host-registered at
+// runtime, so the default toolbar wires the file picker directly to be
+// robust even when the action isn't present.
+export const DEFAULT_TOOLBAR = [
+    { kind: "action-ref", id: "mode-select" },
+    { kind: "action-ref", id: "mode-hand" },
+    { kind: "action-ref", id: "mode-rect" },
+    { kind: "action-ref", id: "mode-ellipse" },
+    { kind: "action-ref", id: "mode-text" },
+    { kind: "action-ref", id: "mode-edge" },
+    { kind: "action-ref", id: "mode-brush" },
+    { kind: "action-ref", id: "mode-frame" },
+    {
+        kind: "action",
+        id: "insert-image",
+        label: _jsx(ImageIcon, { ...iconProps }),
+        title: "Insert image (I)",
+        onClick: (editor) => { openImageFilePicker(editor); },
+    },
+    { kind: "action-ref", id: "toggle-tool-lock" },
+    { kind: "divider" },
+    { kind: "action-ref", id: "undo" },
+    { kind: "action-ref", id: "redo" },
+    { kind: "divider" },
+];
+/**
+ * Creation-tool set for the vertical left dock. Just the creation tools +
+ * the tool-lock toggle — no undo/redo/zoom (those live in the menu /
+ * bottom-left). Hosts prepend their own leading items (e.g. a
+ * templates-library toggle) and render with
+ * `<Toolbar orientation="vertical" />`.
+ */
+export const DEFAULT_VERTICAL_TOOLBAR = [
+    { kind: "action-ref", id: "mode-select" },
+    { kind: "action-ref", id: "mode-hand" },
+    { kind: "divider" },
+    { kind: "action-ref", id: "mode-rect" },
+    { kind: "action-ref", id: "mode-ellipse" },
+    { kind: "action-ref", id: "mode-text" },
+    { kind: "action-ref", id: "mode-edge" },
+    { kind: "action-ref", id: "mode-brush" },
+    { kind: "action-ref", id: "mode-frame" },
+    {
+        kind: "action",
+        id: "insert-image",
+        label: _jsx(ImageIcon, { ...iconProps }),
+        title: "Insert image (I)",
+        onClick: (editor) => { openImageFilePicker(editor); },
+    },
+    { kind: "divider" },
+    { kind: "action-ref", id: "toggle-tool-lock" },
+];
+export const Toolbar = ({ items = DEFAULT_TOOLBAR, style, className, orientation = "horizontal", }) => {
+    const editor = useDiagramOptional();
+    const mode = useMode();
+    const { canUndo, canRedo, undo, redo } = useHistory();
+    const vertical = orientation === "vertical";
+    return (_jsx("div", { role: "toolbar", "aria-orientation": orientation, className: `du-button-group${vertical ? " du-button-group-vertical" : ""} ${className ?? ""}`.trim(), style: style, children: items.map((item, i) => {
+            switch (item.kind) {
+                case "divider":
+                    return _jsx(ToolbarDivider, { vertical: vertical }, i);
+                case "action-ref":
+                    return _jsx(ActionRefButton, { id: item.id }, i);
+                case "mode": {
+                    const active = mode === item.mode;
+                    return (_jsx(ToolbarButton, { ...(item.title !== undefined ? { title: item.title } : {}), disabled: !editor, active: active, onClick: () => editor?.setMode(item.mode), children: item.label }, i));
+                }
+                case "action":
+                    return (_jsx(ToolbarButton, { ...(item.title !== undefined ? { title: item.title } : {}), disabled: item.disabled ?? !editor, active: item.active, onClick: () => {
+                            if (editor)
+                                item.onClick(editor);
+                        }, children: item.label }, i));
+                case "undo":
+                    return (_jsx(ToolbarButton, { disabled: !canUndo, onClick: undo, children: item.label ?? "Undo" }, i));
+                case "redo":
+                    return (_jsx(ToolbarButton, { disabled: !canRedo, onClick: redo, children: item.label ?? "Redo" }, i));
+                case "tool-lock":
+                    return (_jsx(ToolLockButton, { ...(item.label !== undefined ? { label: item.label } : {}), ...(item.title !== undefined ? { title: item.title } : {}) }, i));
+            }
+        }) }));
+};
+/**
+ * Pressable tool-lock affordance. Reads `editor.toolLocked` reactively so
+ * the active state stays in sync when the user toggles via hotkey or
+ * context menu.
+ */
+export const ToolLockButton = ({ label = "🔒", title = "Lock current tool", }) => {
+    const editor = useDiagramOptional();
+    const locked = useEditorSelector((e) => e.toolLocked, false);
+    return (_jsx(ToolbarButton, { disabled: !editor, title: title, active: locked, onClick: () => editor?.setToolLocked(!locked), children: label }));
+};
+/** "−" — calls `editor.zoomOut()`. */
+export const ZoomOutButton = ({ label = "−", title = `Zoom out (${HK_ZOOM_OUT})`, className, style, }) => {
+    const editor = useDiagramOptional();
+    return (_jsx(ToolbarButton, { disabled: !editor, title: title, className: className, style: style, onClick: () => editor?.zoomOut(), children: label }));
+};
+/** "+" — calls `editor.zoomIn()`. */
+export const ZoomInButton = ({ label = "+", title = `Zoom in (${HK_ZOOM_IN})`, className, style, }) => {
+    const editor = useDiagramOptional();
+    return (_jsx(ToolbarButton, { disabled: !editor, title: title, className: className, style: style, onClick: () => editor?.zoomIn(), children: label }));
+};
+/** "100%" / "Reset" — calls `editor.resetZoom()`. */
+export const ResetZoomButton = ({ label = "100%", title = `Reset zoom to 100% (${HK_ZOOM_RESET})`, className, style, }) => {
+    const editor = useDiagramOptional();
+    return (_jsx(ToolbarButton, { disabled: !editor, title: title, className: className, style: style, onClick: () => editor?.resetZoom(), children: label }));
+};
+/** "Fit" — calls `editor.zoomToFit()`. */
+export const ZoomToFitButton = ({ label = "Fit", title = `Fit content to viewport (${HK_ZOOM_FIT})`, className, style, }) => {
+    const editor = useDiagramOptional();
+    return (_jsx(ToolbarButton, { disabled: !editor, title: title, className: className, style: style, onClick: () => editor?.zoomToFit(), children: label }));
+};
+/**
+ * Live zoom percent. Clicks reset zoom to 100% — same UX as the percent
+ * button in `ZoomWidget`.
+ */
+export const ZoomDisplay = ({ className, style }) => {
+    const editor = useDiagramOptional();
+    const zoom = useEditorSelector((e) => e.scene.viewport.zoom, 1);
+    const percent = `${Math.round(zoom * 100)}%`;
+    return (_jsx(ToolbarButton, { disabled: !editor, title: `Reset zoom to 100% (${HK_ZOOM_RESET})`, className: className, style: style, onClick: () => editor?.resetZoom(), children: _jsx("span", { style: { minWidth: 40, display: "inline-block", textAlign: "center" }, children: percent }) }));
+};
+/**
+ * Pre-composed inline zoom widget: − / current % / + / Fit. Equivalent
+ * to laying the four standalone buttons + display in a row.
+ */
+export const ZoomWidget = ({ className, style }) => (_jsxs("span", { className: className, style: { display: "inline-flex", alignItems: "center", gap: 2, ...style }, children: [_jsx(ZoomOutButton, {}), _jsx(ZoomDisplay, {}), _jsx(ZoomInButton, {}), _jsx(ZoomToFitButton, {})] }));
+/**
+ * Floating zoom controls — bottom-right cluster with rounded shadow
+ * chrome. Drops the widget into a corner so the toolbar stays free for
+ * tools. Hosts that need a different position pass `style`.
+ */
+export const FloatingZoomControls = ({ className, style, }) => (_jsxs("div", { className: className, style: {
+        position: "absolute",
+        bottom: 16,
+        right: 16,
+        display: "inline-flex",
+        alignItems: "center",
+        gap: 2,
+        padding: "4px 6px",
+        background: "var(--toolbar-bg, #1a1a1a)",
+        border: "1px solid var(--border, #2a2a2a)",
+        borderRadius: 6,
+        boxShadow: "0 2px 8px rgba(0, 0, 0, 0.18)",
+        zIndex: 50,
+        ...style,
+    }, children: [_jsx(ZoomOutButton, {}), _jsx(ZoomDisplay, {}), _jsx(ZoomInButton, {}), _jsx(ZoomToFitButton, {})] }));
+const ToolbarButton = ({ children, onClick, active, disabled, title, className, style, }) => {
+    const btn = (_jsx("button", { type: "button", onClick: onClick, disabled: disabled, "aria-label": title, "aria-pressed": active, className: `du-icon-button${active ? " is-active" : ""}${className ? ` ${className}` : ""}`, style: {
+            // Toolbar items are wider than square — labels can be 1-2
+            // characters or short words. Match the IconButton height but
+            // let the width grow with the content.
+            width: "auto",
+            minWidth: "var(--du-button-size, 36px)",
+            padding: "0 8px",
+            ...style,
+        }, children: children }));
+    // Wrap in Tooltip when there's text to show. Disabled / empty labels go
+    // raw — the shared-state tooltip would otherwise flash an empty box.
+    return title ? _jsx(Tooltip, { content: title, children: btn }) : btn;
+};
+const ToolbarDivider = ({ vertical = false }) => vertical ? (_jsx("span", { style: {
+        height: 1,
+        width: "100%",
+        background: "var(--du-ui-border, #333)",
+        margin: "4px 0",
+    } })) : (_jsx("span", { style: {
+        width: 1,
+        height: TOOLBAR_SEPARATOR_HEIGHT,
+        background: "var(--du-ui-border, #333)",
+        margin: "0 4px",
+    } }));
+//# sourceMappingURL=toolbar.js.map

package/dist/toolbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.js","sourceRoot":"","sources":["../src/toolbar.tsx"],"names":[],"mappings":"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"}

package/dist/tooltip.d.ts

@@ -0,0 +1,21 @@
+import { type ReactElement, type ReactNode } from "react";
+export type TooltipSide = "top" | "bottom" | "left" | "right";
+/** Provider — install once near the app root. Renders the portal. */
+export declare const TooltipProvider: ({ children }: {
+    readonly children: ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;
+export interface TooltipProps {
+    readonly content: ReactNode;
+    /** Side relative to the trigger. Default `"bottom"`. */
+    readonly side?: TooltipSide;
+    /** Disable the tooltip without changing the tree. */
+    readonly disabled?: boolean;
+    readonly children: ReactElement;
+}
+/**
+ * Wrap a single element to attach a shared-state tooltip. Returns the
+ * child with mouse / focus handlers spliced in — the trigger's existing
+ * handlers are preserved.
+ */
+export declare const Tooltip: ({ content, side, disabled, children }: TooltipProps) => ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
+//# sourceMappingURL=tooltip.d.ts.map

package/dist/tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../src/tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,EAWL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AA0Cf,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAkF9D,qEAAqE;AACrE,eAAO,MAAM,eAAe,GAAI,cAAc;IAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,4CA8B7E,CAAC;AAmEF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;CACjC;AAED;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAAI,uCAAkD,YAAY,+EA2DrF,CAAC"}

package/dist/tooltip.js

@@ -0,0 +1,217 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cloneElement, createContext, isValidElement, useContext, useEffect, useId, useLayoutEffect, useRef, useState, } from "react";
+import { createPortal } from "react-dom";
+import { TOOLTIP_HIDE_GRACE_MS, TOOLTIP_OFFSET_PX, TOOLTIP_OPEN_DELAY_MS, TOOLTIP_SKIP_DELAY_MS, } from "./constants.js";
+const listeners = new Set();
+let currentTarget = null;
+let openTimer = null;
+let hideTimer = null;
+let lastClosedAt = 0;
+let pointerDown = false;
+const notify = () => {
+    for (const l of listeners)
+        l(currentTarget);
+};
+const setTarget = (next) => {
+    currentTarget = next;
+    notify();
+};
+const subscribe = (l) => {
+    listeners.add(l);
+    return () => {
+        listeners.delete(l);
+    };
+};
+/** Open request — schedules the show (with delay or skip). */
+const requestOpen = (target) => {
+    if (pointerDown)
+        return;
+    if (hideTimer) {
+        clearTimeout(hideTimer);
+        hideTimer = null;
+    }
+    if (openTimer)
+        clearTimeout(openTimer);
+    const elapsedSinceLastClose = Date.now() - lastClosedAt;
+    const skipDelay = currentTarget !== null
+        || elapsedSinceLastClose < TOOLTIP_SKIP_DELAY_MS;
+    if (skipDelay) {
+        setTarget(target);
+        return;
+    }
+    openTimer = setTimeout(() => {
+        openTimer = null;
+        setTarget(target);
+    }, TOOLTIP_OPEN_DELAY_MS);
+};
+/** Close request — only acts if the leaving target matches the open one. */
+const requestClose = (id) => {
+    if (openTimer) {
+        clearTimeout(openTimer);
+        openTimer = null;
+    }
+    if (currentTarget?.id === id) {
+        if (hideTimer)
+            clearTimeout(hideTimer);
+        hideTimer = setTimeout(() => {
+            hideTimer = null;
+            lastClosedAt = Date.now();
+            setTarget(null);
+        }, TOOLTIP_HIDE_GRACE_MS);
+    }
+};
+/** Hard-close — used for pointerdown / Escape / unmount. */
+const forceClose = () => {
+    if (openTimer) {
+        clearTimeout(openTimer);
+        openTimer = null;
+    }
+    if (hideTimer) {
+        clearTimeout(hideTimer);
+        hideTimer = null;
+    }
+    if (currentTarget) {
+        lastClosedAt = Date.now();
+        setTarget(null);
+    }
+};
+/** Provider — install once near the app root. Renders the portal. */
+export const TooltipProvider = ({ children }) => {
+    // pointerdown anywhere closes. Capture phase so we beat the rest of the
+    // app to the event.
+    useEffect(() => {
+        const onDown = () => {
+            pointerDown = true;
+            forceClose();
+        };
+        const onUp = () => {
+            pointerDown = false;
+        };
+        const onKey = (ev) => {
+            if (ev.key === "Escape")
+                forceClose();
+        };
+        document.addEventListener("pointerdown", onDown, { capture: true });
+        document.addEventListener("pointerup", onUp, { capture: true });
+        document.addEventListener("keydown", onKey, { capture: true });
+        return () => {
+            document.removeEventListener("pointerdown", onDown, { capture: true });
+            document.removeEventListener("pointerup", onUp, { capture: true });
+            document.removeEventListener("keydown", onKey, { capture: true });
+        };
+    }, []);
+    return (_jsxs(TooltipProviderCtx.Provider, { value: true, children: [children, _jsx(TooltipPortal, {})] }));
+};
+const TooltipProviderCtx = createContext(false);
+const useHasProvider = () => useContext(TooltipProviderCtx);
+/**
+ * The singleton tooltip surface. Renders via portal into `document.body`
+ * so it can sit above modal overlays.
+ */
+const TooltipPortal = () => {
+    const [target, setTargetState] = useState(null);
+    useEffect(() => subscribe(setTargetState), []);
+    if (!target)
+        return null;
+    if (typeof document === "undefined")
+        return null;
+    return createPortal(_jsx(TooltipSurface, { target: target }), document.body);
+};
+const TooltipSurface = ({ target }) => {
+    const ref = useRef(null);
+    const [pos, setPos] = useState(null);
+    useLayoutEffect(() => {
+        const el = ref.current;
+        if (!el)
+            return;
+        const tipRect = el.getBoundingClientRect();
+        const { rect, side } = target;
+        let left = rect.left + rect.width / 2 - tipRect.width / 2;
+        let top = rect.top + rect.height / 2 - tipRect.height / 2;
+        switch (side) {
+            case "top":
+                top = rect.top - tipRect.height - TOOLTIP_OFFSET_PX;
+                break;
+            case "bottom":
+                top = rect.bottom + TOOLTIP_OFFSET_PX;
+                break;
+            case "left":
+                left = rect.left - tipRect.width - TOOLTIP_OFFSET_PX;
+                break;
+            case "right":
+                left = rect.right + TOOLTIP_OFFSET_PX;
+                break;
+        }
+        // Clamp to viewport — keep the tooltip on-screen at edges.
+        const pad = 4;
+        left = Math.max(pad, Math.min(left, window.innerWidth - tipRect.width - pad));
+        top = Math.max(pad, Math.min(top, window.innerHeight - tipRect.height - pad));
+        setPos({ left, top });
+    }, [target]);
+    const style = {
+        position: "fixed",
+        left: pos?.left ?? -9999,
+        top: pos?.top ?? -9999,
+        pointerEvents: "none",
+        zIndex: 10000,
+        visibility: pos ? "visible" : "hidden",
+    };
+    return (_jsx("div", { ref: ref, role: "tooltip", className: "du-tooltip", style: style, children: target.content }));
+};
+/**
+ * Wrap a single element to attach a shared-state tooltip. Returns the
+ * child with mouse / focus handlers spliced in — the trigger's existing
+ * handlers are preserved.
+ */
+export const Tooltip = ({ content, side = "bottom", disabled, children }) => {
+    const id = useId();
+    const hasProvider = useHasProvider();
+    // Fall back to native title= when there's no provider (degraded but
+    // functional — keeps stories / isolated tests working).
+    if (!hasProvider || disabled || content === undefined || content === null) {
+        if (!isValidElement(children))
+            return children;
+        if (typeof content === "string" && !disabled) {
+            return cloneElement(children, { title: content });
+        }
+        return children;
+    }
+    if (!isValidElement(children))
+        return children;
+    const child = children;
+    const open = (el) => {
+        requestOpen({
+            id,
+            content,
+            side,
+            rect: el.getBoundingClientRect(),
+        });
+    };
+    const onPointerEnter = (ev) => {
+        child.props.onPointerEnter?.(ev);
+        if (ev.pointerType === "touch")
+            return;
+        open(ev.currentTarget);
+    };
+    const onPointerLeave = (ev) => {
+        child.props.onPointerLeave?.(ev);
+        requestClose(id);
+    };
+    const onFocus = (ev) => {
+        child.props.onFocus?.(ev);
+        open(ev.currentTarget);
+    };
+    const onBlur = (ev) => {
+        child.props.onBlur?.(ev);
+        requestClose(id);
+    };
+    return cloneElement(child, {
+        onPointerEnter,
+        onPointerLeave,
+        onFocus,
+        onBlur,
+        // Strip the native title — it would race the custom tooltip.
+        title: undefined,
+    });
+};
+//# sourceMappingURL=tooltip.js.map

package/dist/tooltip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip.js","sourceRoot":"","sources":["../src/tooltip.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,UAAU,EACV,SAAS,EACT,KAAK,EACL,eAAe,EACf,MAAM,EACN,QAAQ,GAIT,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAuCxB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;AACtC,IAAI,aAAa,GAAyB,IAAI,CAAC;AAC/C,IAAI,SAAS,GAAyC,IAAI,CAAC;AAC3D,IAAI,SAAS,GAAyC,IAAI,CAAC;AAC3D,IAAI,YAAY,GAAG,CAAC,CAAC;AACrB,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,MAAM,MAAM,GAAG,GAAS,EAAE;IACxB,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,CAAC,CAAC,aAAa,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,IAA0B,EAAQ,EAAE;IACrD,aAAa,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,CAAC;AACX,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,CAAW,EAAgB,EAAE;IAC9C,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACjB,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,8DAA8D;AAC9D,MAAM,WAAW,GAAG,CAAC,MAAqB,EAAQ,EAAE;IAClD,IAAI,WAAW;QAAE,OAAO;IACxB,IAAI,SAAS,EAAE,CAAC;QACd,YAAY,CAAC,SAAS,CAAC,CAAC;QACxB,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC;IACD,IAAI,SAAS;QAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAEvC,MAAM,qBAAqB,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;IACxD,MAAM,SAAS,GAAG,aAAa,KAAK,IAAI;WACnC,qBAAqB,GAAG,qBAAqB,CAAC;IAEnD,IAAI,SAAS,EAAE,CAAC;QACd,SAAS,CAAC,MAAM,CAAC,CAAC;QAClB,OAAO;IACT,CAAC;IACD,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;QAC1B,SAAS,GAAG,IAAI,CAAC;QACjB,SAAS,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC,EAAE,qBAAqB,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,4EAA4E;AAC5E,MAAM,YAAY,GAAG,CAAC,EAAU,EAAQ,EAAE;IACxC,IAAI,SAAS,EAAE,CAAC;QACd,YAAY,CAAC,SAAS,CAAC,CAAC;QACxB,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC;IACD,IAAI,aAAa,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7B,IAAI,SAAS;YAAE,YAAY,CAAC,SAAS,CAAC,CAAC;QACvC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,SAAS,GAAG,IAAI,CAAC;YACjB,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC1B,SAAS,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC,EAAE,qBAAqB,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC,CAAC;AAEF,4DAA4D;AAC5D,MAAM,UAAU,GAAG,GAAS,EAAE;IAC5B,IAAI,SAAS,EAAE,CAAC;QACd,YAAY,CAAC,SAAS,CAAC,CAAC;QACxB,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC;IACD,IAAI,SAAS,EAAE,CAAC;QACd,YAAY,CAAC,SAAS,CAAC,CAAC;QACxB,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC;IACD,IAAI,aAAa,EAAE,CAAC;QAClB,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,SAAS,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAE,QAAQ,EAAoC,EAAE,EAAE;IAChF,wEAAwE;IACxE,oBAAoB;IACpB,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,WAAW,GAAG,IAAI,CAAC;YACnB,UAAU,EAAE,CAAC;QACf,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,GAAS,EAAE;YACtB,WAAW,GAAG,KAAK,CAAC;QACtB,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,CAAC,EAAiB,EAAQ,EAAE;YACxC,IAAI,EAAE,CAAC,GAAG,KAAK,QAAQ;gBAAE,UAAU,EAAE,CAAC;QACxC,CAAC,CAAC;QACF,QAAQ,CAAC,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YACvE,QAAQ,CAAC,mBAAmB,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YACnE,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CACL,MAAC,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,aACrC,QAAQ,EACT,KAAC,aAAa,KAAG,IACW,CAC/B,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,aAAa,CAAU,KAAK,CAAC,CAAC;AACzD,MAAM,cAAc,GAAG,GAAY,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;AAErE;;;GAGG;AACH,MAAM,aAAa,GAAG,GAAG,EAAE;IACzB,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAuB,IAAI,CAAC,CAAC;IACtE,SAAS,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;IAE/C,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAEjD,OAAO,YAAY,CAAC,KAAC,cAAc,IAAC,MAAM,EAAE,MAAM,GAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;AACzE,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,EAAE,MAAM,EAAsC,EAAE,EAAE;IACxE,MAAM,GAAG,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAuC,IAAI,CAAC,CAAC;IAE3E,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;QACvB,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,MAAM,OAAO,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAC;QAC3C,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9B,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;QAC1D,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1D,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,KAAK;gBACR,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,GAAG,iBAAiB,CAAC;gBACpD,MAAM;YACR,KAAK,QAAQ;gBACX,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,iBAAiB,CAAC;gBACtC,MAAM;YACR,KAAK,MAAM;gBACT,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,iBAAiB,CAAC;gBACrD,MAAM;YACR,KAAK,OAAO;gBACV,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,iBAAiB,CAAC;gBACtC,MAAM;QACV,CAAC;QACD,2DAA2D;QAC3D,MAAM,GAAG,GAAG,CAAC,CAAC;QACd,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC;QAC9E,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC;QAC9E,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IACxB,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,KAAK,GAAkB;QAC3B,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC,IAAI;QACxB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI;QACtB,aAAa,EAAE,MAAM;QACrB,MAAM,EAAE,KAAK;QACb,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;KACvC,CAAC;IAEF,OAAO,CACL,cAAK,GAAG,EAAE,GAAG,EAAE,IAAI,EAAC,SAAS,EAAC,SAAS,EAAC,YAAY,EAAC,KAAK,EAAE,KAAK,YAC9D,MAAM,CAAC,OAAO,GACX,CACP,CAAC;AACJ,CAAC,CAAC;AAWF;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,GAAG,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAgB,EAAE,EAAE;IACxF,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,oEAAoE;IACpE,wDAAwD;IACxD,IAAI,CAAC,WAAW,IAAI,QAAQ,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAC1E,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;QAC/C,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7C,OAAO,YAAY,CAAC,QAA4C,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAE/C,MAAM,KAAK,GAAG,QAMZ,CAAC;IAEH,MAAM,IAAI,GAAG,CAAC,EAAe,EAAQ,EAAE;QACrC,WAAW,CAAC;YACV,EAAE;YACF,OAAO;YACP,IAAI;YACJ,IAAI,EAAE,EAAE,CAAC,qBAAqB,EAAE;SACjC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,cAAc,GAAG,CAAC,EAAmC,EAAQ,EAAE;QACnE,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,EAAE,CAAC,WAAW,KAAK,OAAO;YAAE,OAAO;QACvC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;IACzB,CAAC,CAAC;IACF,MAAM,cAAc,GAAG,CAAC,EAAmC,EAAQ,EAAE;QACnE,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC;QACjC,YAAY,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,EAAiC,EAAQ,EAAE;QAC1D,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;IACzB,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,EAAiC,EAAQ,EAAE;QACzD,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QACzB,YAAY,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO,YAAY,CAAC,KAAK,EAAE;QACzB,cAAc;QACd,cAAc;QACd,OAAO;QACP,MAAM;QACN,6DAA6D;QAC7D,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/ui-layer.d.ts

@@ -0,0 +1,22 @@
+import type { CSSProperties, ReactNode } from "react";
+/**
+ * Absolute-positioned overlay that sits above the canvas surface and
+ * hosts every floating piece of UI (top bar, bottom bar, side panels,
+ * floating toolbars). The wrapper has `pointer-events: none` so pointer
+ * events fall through to the canvas everywhere the UI isn't drawn;
+ * individual children re-enable events on themselves.
+ *
+ * UI is layered, not laid out: the canvas occupies the full surface and
+ * the `<UILayer>` floats on top.
+ *
+ * Hosts can pass a `style` override (e.g. `{ right: 240 }`) when a docked
+ * side panel takes up part of the surface, so bars stop before the docked
+ * column's edge.
+ */
+export interface UILayerProps {
+    readonly children: ReactNode;
+    readonly className?: string;
+    readonly style?: CSSProperties;
+}
+export declare const UILayer: ({ children, className, style }: UILayerProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ui-layer.d.ts.map

package/dist/ui-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-layer.d.ts","sourceRoot":"","sources":["../src/ui-layer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;CAChC;AAED,eAAO,MAAM,OAAO,GAAI,gCAAgC,YAAY,4CAInE,CAAC"}

package/dist/ui-layer.js

@@ -0,0 +1,3 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+export const UILayer = ({ children, className, style }) => (_jsx("div", { className: `du-ui-layer ${className ?? ""}`.trim(), style: style, children: children }));
+//# sourceMappingURL=ui-layer.js.map

package/dist/ui-layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-layer.js","sourceRoot":"","sources":["../src/ui-layer.tsx"],"names":[],"mappings":";AAsBA,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAgB,EAAE,EAAE,CAAC,CACvE,cAAK,SAAS,EAAE,eAAe,SAAS,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,YAClE,QAAQ,GACL,CACP,CAAC"}

package/dist/versioning.d.ts

@@ -0,0 +1,32 @@
+import { type CSSProperties } from "react";
+import { type Branch, type Snapshot, type SnapshotStore } from "@oh-just-another/versioning";
+interface StoreSnapshot {
+    readonly branches: readonly Branch[];
+    readonly snapshots: readonly Snapshot[];
+    readonly currentBranchId: Branch["id"];
+}
+/**
+ * Subscribe to a `SnapshotStore` and return reactive lists of branches +
+ * snapshots + the currently-active branch. Pass `null` for hosts that
+ * haven't wired versioning — the hook returns empty arrays.
+ */
+export declare const useSnapshotStore: (store: SnapshotStore | null) => StoreSnapshot;
+export interface VersionPanelProps {
+    /** Required — host owns the store's lifecycle. */
+    readonly store: SnapshotStore;
+    /** Author identity used when capturing snapshots. */
+    readonly author: {
+        id: string;
+        name: string;
+    };
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+/**
+ * Side-panel with a tree of branches + snapshots and capture / restore /
+ * branch actions. Branches are flat, snapshots nested inside each branch
+ * (no DAG view).
+ */
+export declare const VersionPanel: ({ store, author, style, className }: VersionPanelProps) => import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=versioning.d.ts.map

package/dist/versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../src/versioning.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAC7E,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,aAAa,EAEnB,MAAM,6BAA6B,CAAC;AAIrC,UAAU,aAAa;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;CACxC;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,aAAa,GAAG,IAAI,KAAG,aA6B9D,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,qCAAqC,iBAAiB,4CAgRlF,CAAC"}