entangle-ui 0.9.0 → 0.10.0

package/dist/esm/components/editor/Minimap/computeBoundsFromItems.js

@@ -0,0 +1,65 @@
+/**
+ * Compute the tight axis-aligned bounding box of a set of minimap items,
+ * with optional uniform padding (in world units) on every side.
+ *
+ * An empty input returns a zero-area rect at the origin so the minimap
+ * can still render a meaningful surface.
+ */
+function computeBoundsFromItems(items, padding = 0) {
+    if (items.length === 0) {
+        return { x: 0, y: 0, width: 0, height: 0 };
+    }
+    let minX = Infinity;
+    let minY = Infinity;
+    let maxX = -Infinity;
+    let maxY = -Infinity;
+    for (const item of items) {
+        let l = 0;
+        let t = 0;
+        let r = 0;
+        let b = 0;
+        switch (item.type) {
+            case 'rect':
+                l = item.x;
+                t = item.y;
+                r = item.x + item.width;
+                b = item.y + item.height;
+                break;
+            case 'circle':
+                l = item.cx - item.r;
+                t = item.cy - item.r;
+                r = item.cx + item.r;
+                b = item.cy + item.r;
+                break;
+            case 'line':
+                l = Math.min(item.x1, item.x2);
+                t = Math.min(item.y1, item.y2);
+                r = Math.max(item.x1, item.x2);
+                b = Math.max(item.y1, item.y2);
+                break;
+            case 'custom':
+                l = item.bounds.x;
+                t = item.bounds.y;
+                r = item.bounds.x + item.bounds.width;
+                b = item.bounds.y + item.bounds.height;
+                break;
+        }
+        if (l < minX)
+            minX = l;
+        if (t < minY)
+            minY = t;
+        if (r > maxX)
+            maxX = r;
+        if (b > maxY)
+            maxY = b;
+    }
+    return {
+        x: minX - padding,
+        y: minY - padding,
+        width: maxX - minX + 2 * padding,
+        height: maxY - minY + 2 * padding,
+    };
+}
+
+export { computeBoundsFromItems };
+//# sourceMappingURL=computeBoundsFromItems.js.map

package/dist/esm/components/editor/Minimap/computeBoundsFromItems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeBoundsFromItems.js","sources":["../../../../../../src/components/editor/Minimap/computeBoundsFromItems.ts"],"sourcesContent":[null],"names":[],"mappings":"AAGA;;;;;;AAMG;SACa,sBAAsB,CACpC,KAAiC,EACjC,UAAkB,CAAC,EAAA;AAEnB,IAAA,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;AACtB,QAAA,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;IAC5C;IAEA,IAAI,IAAI,GAAG,QAAQ;IACnB,IAAI,IAAI,GAAG,QAAQ;AACnB,IAAA,IAAI,IAAI,GAAG,CAAC,QAAQ;AACpB,IAAA,IAAI,IAAI,GAAG,CAAC,QAAQ;AAEpB,IAAA,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;QACxB,IAAI,CAAC,GAAG,CAAC;QACT,IAAI,CAAC,GAAG,CAAC;QACT,IAAI,CAAC,GAAG,CAAC;QACT,IAAI,CAAC,GAAG,CAAC;AACT,QAAA,QAAQ,IAAI,CAAC,IAAI;AACf,YAAA,KAAK,MAAM;AACT,gBAAA,CAAC,GAAG,IAAI,CAAC,CAAC;AACV,gBAAA,CAAC,GAAG,IAAI,CAAC,CAAC;gBACV,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK;gBACvB,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM;gBACxB;AACF,YAAA,KAAK,QAAQ;gBACX,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;gBACpB,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;gBACpB,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;gBACpB,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;gBACpB;AACF,YAAA,KAAK,MAAM;AACT,gBAAA,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;AAC9B,gBAAA,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;AAC9B,gBAAA,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;AAC9B,gBAAA,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC9B;AACF,YAAA,KAAK,QAAQ;AACX,gBAAA,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,gBAAA,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,gBAAA,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK;AACrC,gBAAA,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM;gBACtC;;QAEJ,IAAI,CAAC,GAAG,IAAI;YAAE,IAAI,GAAG,CAAC;QACtB,IAAI,CAAC,GAAG,IAAI;YAAE,IAAI,GAAG,CAAC;QACtB,IAAI,CAAC,GAAG,IAAI;YAAE,IAAI,GAAG,CAAC;QACtB,IAAI,CAAC,GAAG,IAAI;YAAE,IAAI,GAAG,CAAC;IACxB;IAEA,OAAO;QACL,CAAC,EAAE,IAAI,GAAG,OAAO;QACjB,CAAC,EAAE,IAAI,GAAG,OAAO;AACjB,QAAA,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,OAAO;AAChC,QAAA,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,OAAO;KAClC;AACH;;;;"}

package/dist/esm/components/editor/Minimap/index.js

@@ -0,0 +1,15 @@
+import { Minimap as Minimap$1 } from './Minimap.js';
+import { MinimapCorner } from './MinimapCorner.js';
+import { MinimapFooter } from './MinimapFooter.js';
+import { MinimapTitle } from './MinimapTitle.js';
+export { ViewportMinimap } from './ViewportMinimap.js';
+export { useMinimapContext, useMinimapDragState, useMinimapGeometry, useMinimapHover } from './MinimapContext.js';
+
+const MinimapWithSlots = Minimap$1;
+MinimapWithSlots.Title = MinimapTitle;
+MinimapWithSlots.Footer = MinimapFooter;
+MinimapWithSlots.Corner = MinimapCorner;
+const Minimap = MinimapWithSlots;
+
+export { Minimap, MinimapCorner, MinimapFooter, MinimapTitle };
+//# sourceMappingURL=index.js.map

package/dist/esm/components/editor/Minimap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../../../src/components/editor/Minimap/index.ts"],"sourcesContent":[null],"names":["MinimapBase"],"mappings":";;;;;;;AAWA,MAAM,gBAAgB,GAAGA,SAA8B;AACvD,gBAAgB,CAAC,KAAK,GAAG,YAAY;AACrC,gBAAgB,CAAC,MAAM,GAAG,aAAa;AACvC,gBAAgB,CAAC,MAAM,GAAG,aAAa;AAEhC,MAAM,OAAO,GAAG;;;;"}

package/dist/esm/components/editor/Minimap/minimapCoords.js

@@ -0,0 +1,105 @@
+/**
+ * Derive minimap height from a width + `worldBounds` aspect ratio,
+ * clamped to `[minHeight, maxHeight]`.
+ *
+ * When `worldBounds` is zero-area, falls back to `minHeight` (the minimap
+ * still renders a usable surface so users see the viewport rect).
+ */
+function computeMinimapHeight(width, worldBounds, minHeight, maxHeight) {
+    if (worldBounds.width <= 0 || worldBounds.height <= 0) {
+        return minHeight;
+    }
+    const ratio = worldBounds.height / worldBounds.width;
+    const raw = width * ratio;
+    return Math.min(maxHeight, Math.max(minHeight, raw));
+}
+/**
+ * Uniform scale that fits `worldBounds` inside `minimapSize`, preserving
+ * the world aspect ratio. If the minimap was clamped (e.g. height hit
+ * `maxHeight`), the resulting content is letterboxed.
+ */
+function computeMinimapScale(worldBounds, minimapSize) {
+    if (worldBounds.width <= 0 || worldBounds.height <= 0) {
+        return 1;
+    }
+    return Math.min(minimapSize.width / worldBounds.width, minimapSize.height / worldBounds.height);
+}
+/** Letterbox offset (each side) when world and minimap aspect ratios differ. */
+function computeMinimapOffset(worldBounds, minimapSize, scale) {
+    const usedW = worldBounds.width * scale;
+    const usedH = worldBounds.height * scale;
+    return {
+        x: (minimapSize.width - usedW) / 2,
+        y: (minimapSize.height - usedH) / 2,
+    };
+}
+/** Map a world point to minimap CSS pixel coordinates. */
+function worldToMinimap(point, worldBounds, minimapSize) {
+    const scale = computeMinimapScale(worldBounds, minimapSize);
+    const offset = computeMinimapOffset(worldBounds, minimapSize, scale);
+    return {
+        x: offset.x + (point.x - worldBounds.x) * scale,
+        y: offset.y + (point.y - worldBounds.y) * scale,
+    };
+}
+/** Inverse of `worldToMinimap`: minimap CSS point → world point. */
+function minimapToWorld(point, worldBounds, minimapSize) {
+    // Zero-area bounds have no meaningful inverse mapping — collapse everything
+    // to the bounds origin so navigation still emits a stable point.
+    if (worldBounds.width <= 0 || worldBounds.height <= 0) {
+        return { x: worldBounds.x, y: worldBounds.y };
+    }
+    const scale = computeMinimapScale(worldBounds, minimapSize);
+    const offset = computeMinimapOffset(worldBounds, minimapSize, scale);
+    return {
+        x: worldBounds.x + (point.x - offset.x) / scale,
+        y: worldBounds.y + (point.y - offset.y) / scale,
+    };
+}
+/**
+ * Viewport rect (in minimap CSS px) for a given main-viewport transform
+ * and size. The world-space region visible in the main viewport is at
+ * `(-tx / zoom, -ty / zoom)` with size `viewportSize / zoom`.
+ */
+function getViewportRectOnMinimap(transform, viewportSize, worldBounds, minimapSize) {
+    const scale = computeMinimapScale(worldBounds, minimapSize);
+    const offset = computeMinimapOffset(worldBounds, minimapSize, scale);
+    const zoom = transform.zoom === 0 ? 1 : transform.zoom;
+    const worldX = -transform.x / zoom;
+    const worldY = -transform.y / zoom;
+    const worldW = viewportSize.width / zoom;
+    const worldH = viewportSize.height / zoom;
+    return {
+        x: offset.x + (worldX - worldBounds.x) * scale,
+        y: offset.y + (worldY - worldBounds.y) * scale,
+        width: worldW * scale,
+        height: worldH * scale,
+    };
+}
+/** Current world-space center of the main viewport. */
+function getViewportCenterWorld(transform, viewportSize) {
+    const zoom = transform.zoom === 0 ? 1 : transform.zoom;
+    return {
+        x: (-transform.x + viewportSize.width / 2) / zoom,
+        y: (-transform.y + viewportSize.height / 2) / zoom,
+    };
+}
+/**
+ * Build the shared coordinate helpers used by built-in drawing,
+ * `renderOverlay`, and custom items. `transform`/`viewportSize` are not
+ * needed by the helpers themselves but are passed downstream alongside
+ * this bundle to form the public `MinimapDrawInfo`.
+ */
+function buildDrawInfo(worldBounds, minimapSize) {
+    const scale = computeMinimapScale(worldBounds, minimapSize);
+    const offset = computeMinimapOffset(worldBounds, minimapSize, scale);
+    return {
+        scale,
+        offset,
+        worldToMinimap: (p) => worldToMinimap(p, worldBounds, minimapSize),
+        minimapToWorld: (p) => minimapToWorld(p, worldBounds, minimapSize),
+    };
+}
+
+export { buildDrawInfo, computeMinimapHeight, computeMinimapOffset, computeMinimapScale, getViewportCenterWorld, getViewportRectOnMinimap, minimapToWorld, worldToMinimap };
+//# sourceMappingURL=minimapCoords.js.map

package/dist/esm/components/editor/Minimap/minimapCoords.js.map

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

package/dist/esm/components/editor/Minimap/minimapDrawing.js

@@ -0,0 +1,93 @@
+import { buildDrawInfo, getViewportRectOnMinimap } from './minimapCoords.js';
+
+/**
+ * Render a full minimap frame: background → items → caller `renderOverlay`
+ * → dimmed shroud around the viewport rect → viewport rect outline. The
+ * caller is responsible for DPR scaling on `ctx` before invoking.
+ */
+function drawMinimap(input) {
+    const { ctx, size, worldBounds, transform, viewportSize, items, colors, renderOverlay, } = input;
+    ctx.clearRect(0, 0, size.width, size.height);
+    ctx.fillStyle = colors.background;
+    ctx.fillRect(0, 0, size.width, size.height);
+    const helpers = buildDrawInfo(worldBounds, size);
+    const info = {
+        minimapSize: size,
+        worldBounds,
+        transform,
+        viewportSize,
+        ...helpers,
+    };
+    ctx.save();
+    ctx.beginPath();
+    ctx.rect(0, 0, size.width, size.height);
+    ctx.clip();
+    for (const item of items) {
+        const color = item.color ?? colors.defaultItem;
+        ctx.fillStyle = color;
+        ctx.strokeStyle = color;
+        switch (item.type) {
+            case 'rect': {
+                const topLeft = info.worldToMinimap({ x: item.x, y: item.y });
+                ctx.fillRect(topLeft.x, topLeft.y, Math.max(1, item.width * info.scale), Math.max(1, item.height * info.scale));
+                break;
+            }
+            case 'circle': {
+                const center = info.worldToMinimap({ x: item.cx, y: item.cy });
+                const r = Math.max(0.5, item.r * info.scale);
+                ctx.beginPath();
+                ctx.arc(center.x, center.y, r, 0, Math.PI * 2);
+                ctx.fill();
+                break;
+            }
+            case 'line': {
+                const a = info.worldToMinimap({ x: item.x1, y: item.y1 });
+                const b = info.worldToMinimap({ x: item.x2, y: item.y2 });
+                ctx.lineWidth = item.lineWidth ?? 1;
+                ctx.beginPath();
+                ctx.moveTo(a.x, a.y);
+                ctx.lineTo(b.x, b.y);
+                ctx.stroke();
+                break;
+            }
+            case 'custom': {
+                ctx.save();
+                item.draw(ctx, info);
+                ctx.restore();
+                break;
+            }
+        }
+    }
+    if (renderOverlay) {
+        ctx.save();
+        renderOverlay(ctx, info);
+        ctx.restore();
+    }
+    ctx.restore();
+    const vr = getViewportRectOnMinimap(transform, viewportSize, worldBounds, size);
+    drawOutsideOverlay(ctx, size, vr, colors.outsideOverlay);
+    ctx.strokeStyle = colors.viewportRectStroke;
+    ctx.lineWidth = 1;
+    const strokeW = Math.max(0, vr.width - 1);
+    const strokeH = Math.max(0, vr.height - 1);
+    ctx.strokeRect(vr.x + 0.5, vr.y + 0.5, strokeW, strokeH);
+}
+function drawOutsideOverlay(ctx, size, rect, color) {
+    const rl = Math.max(0, Math.min(size.width, rect.x));
+    const rt = Math.max(0, Math.min(size.height, rect.y));
+    const rr = Math.max(0, Math.min(size.width, rect.x + rect.width));
+    const rb = Math.max(0, Math.min(size.height, rect.y + rect.height));
+    ctx.fillStyle = color;
+    if (rt > 0)
+        ctx.fillRect(0, 0, size.width, rt);
+    if (rb < size.height)
+        ctx.fillRect(0, rb, size.width, size.height - rb);
+    if (rl > 0 && rt < rb)
+        ctx.fillRect(0, rt, rl, rb - rt);
+    if (rr < size.width && rt < rb) {
+        ctx.fillRect(rr, rt, size.width - rr, rb - rt);
+    }
+}
+
+export { drawMinimap };
+//# sourceMappingURL=minimapDrawing.js.map

package/dist/esm/components/editor/Minimap/minimapDrawing.js.map

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

package/dist/esm/components/editor/Minimap/minimapHitTest.js

@@ -0,0 +1,59 @@
+/** Distance from point P to line segment A-B (in world units). */
+function distancePointToSegment(p, a, b) {
+    const dx = b.x - a.x;
+    const dy = b.y - a.y;
+    const lenSq = dx * dx + dy * dy;
+    if (lenSq === 0) {
+        const ex = p.x - a.x;
+        const ey = p.y - a.y;
+        return Math.hypot(ex, ey);
+    }
+    let t = ((p.x - a.x) * dx + (p.y - a.y) * dy) / lenSq;
+    t = Math.max(0, Math.min(1, t));
+    const cx = a.x + t * dx;
+    const cy = a.y + t * dy;
+    return Math.hypot(p.x - cx, p.y - cy);
+}
+/**
+ * Hit-test a world point against the item list, returning the topmost
+ * (last-drawn) match. `lineToleranceWorld` is the picking radius (world
+ * units) used for line items.
+ */
+function hitTestItems(worldPoint, items, lineToleranceWorld) {
+    for (let i = items.length - 1; i >= 0; i -= 1) {
+        const item = items[i];
+        if (!item)
+            continue;
+        if (pointHitsItem(worldPoint, item, lineToleranceWorld)) {
+            return item.id;
+        }
+    }
+    return null;
+}
+function pointHitsItem(p, item, lineToleranceWorld) {
+    switch (item.type) {
+        case 'rect':
+            return (p.x >= item.x &&
+                p.x <= item.x + item.width &&
+                p.y >= item.y &&
+                p.y <= item.y + item.height);
+        case 'circle': {
+            const dx = p.x - item.cx;
+            const dy = p.y - item.cy;
+            return dx * dx + dy * dy <= item.r * item.r;
+        }
+        case 'line':
+            return (distancePointToSegment(p, { x: item.x1, y: item.y1 }, { x: item.x2, y: item.y2 }) <= lineToleranceWorld);
+        case 'custom':
+            return inWorldRect(p, item.bounds);
+    }
+}
+function inWorldRect(p, rect) {
+    return (p.x >= rect.x &&
+        p.x <= rect.x + rect.width &&
+        p.y >= rect.y &&
+        p.y <= rect.y + rect.height);
+}
+
+export { hitTestItems };
+//# sourceMappingURL=minimapHitTest.js.map

package/dist/esm/components/editor/Minimap/minimapHitTest.js.map

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

package/dist/esm/components/editor/Minimap/useMinimapGestures.js

@@ -0,0 +1,299 @@
+"use client";
+import { useRef, useCallback, useMemo } from 'react';
+import '../../../utils/devWarn.js';
+import { useLatest } from '../../../hooks/useLatest/useLatest.js';
+import '../../../hooks/useBreakpoint/useBreakpoint.js';
+import './../../../assets/src/theme/lightTheme.css.ts.vanilla-Ct6f9Iym.css';
+import '../../../node_modules/@vanilla-extract/css/dist/vanilla-extract-css.esm.js';
+import './../../../assets/src/theme/darkTheme.css.ts.vanilla-BHZ3ecRn.css';
+import 'react/jsx-runtime';
+import './../../../assets/src/theme/globalScrollbars.css.ts.vanilla-BAJwnUEJ.css';
+import '../../../hooks/useNavigationHistory/useNavigationHistory.js';
+import { minimapToWorld, getViewportRectOnMinimap, getViewportCenterWorld } from './minimapCoords.js';
+import { hitTestItems } from './minimapHitTest.js';
+
+const CLICK_THRESHOLD_PX = 3;
+/** Hover line-picking tolerance, in minimap CSS px. Translated to world units per gesture. */
+const LINE_HIT_TOLERANCE_MINIMAP_PX = 4;
+function getLocalPointerPosition(e, container) {
+    if (!container)
+        return { x: 0, y: 0 };
+    const rect = container.getBoundingClientRect();
+    return { x: e.clientX - rect.left, y: e.clientY - rect.top };
+}
+function pointInRect(p, r) {
+    return (p.x >= r.x && p.x <= r.x + r.width && p.y >= r.y && p.y <= r.y + r.height);
+}
+/**
+ * Pointer + keyboard gesture machine for `<Minimap>`. All live props and
+ * the `onNavigate` callback are read through `useLatest` refs so the
+ * returned handlers are stable for the lifetime of the component —
+ * pointer event listeners never re-attach on prop changes.
+ *
+ * Hover state and drag state are written directly to the `MinimapStore`,
+ * not local React state, so slice subscribers (`useMinimapHover`,
+ * `useMinimapDragState`) re-render independently and don't see the rest
+ * of the world thrash.
+ */
+function useMinimapGestures(opts) {
+    const { containerRef, store } = opts;
+    // Live refs — handlers always see the latest values without re-binding.
+    const worldBoundsRef = useLatest(opts.worldBounds);
+    const transformRef = useLatest(opts.transform);
+    const viewportSizeRef = useLatest(opts.viewportSize);
+    const minimapSizeRef = useLatest(opts.minimapSize);
+    const itemsRef = useLatest(opts.items);
+    const interactionsRef = useLatest(opts.interactions);
+    const keyboardPanStepRef = useLatest(opts.keyboardPanStep);
+    const disabledRef = useLatest(opts.disabled);
+    const onNavigateRef = useLatest(opts.onNavigate);
+    const stateRef = useRef(null);
+    const emit = useCallback((info) => {
+        onNavigateRef.current?.(info);
+    }, [onNavigateRef]);
+    const updateHover = useCallback((screen) => {
+        if (!screen) {
+            store.setHover({ hoverWorldPoint: null, hoveredItemId: null });
+            return;
+        }
+        const worldBounds = worldBoundsRef.current;
+        const minimapSize = minimapSizeRef.current;
+        const items = itemsRef.current;
+        const worldPoint = minimapToWorld(screen, worldBounds, minimapSize);
+        const scaleX = worldBounds.width > 0 ? minimapSize.width / worldBounds.width : 1;
+        const scaleY = worldBounds.height > 0 ? minimapSize.height / worldBounds.height : 1;
+        const scale = Math.min(scaleX, scaleY) || 1;
+        const tolerance = LINE_HIT_TOLERANCE_MINIMAP_PX / scale;
+        store.setHover({
+            hoverWorldPoint: worldPoint,
+            hoveredItemId: hitTestItems(worldPoint, items, tolerance),
+        });
+    }, [store, worldBoundsRef, minimapSizeRef, itemsRef]);
+    const handlePointerDown = useCallback((e) => {
+        if (disabledRef.current || e.button !== 0)
+            return;
+        const container = containerRef.current;
+        if (!container)
+            return;
+        const screen = getLocalPointerPosition(e, container);
+        const worldBounds = worldBoundsRef.current;
+        const minimapSize = minimapSizeRef.current;
+        const transform = transformRef.current;
+        const viewportSize = viewportSizeRef.current;
+        const interactions = interactionsRef.current;
+        const viewportRect = getViewportRectOnMinimap(transform, viewportSize, worldBounds, minimapSize);
+        const inside = pointInRect(screen, viewportRect);
+        let mode = null;
+        let grabOffsetWorld;
+        if (inside && interactions.dragViewportRect) {
+            mode = 'drag-rect';
+            const pointerWorld = minimapToWorld(screen, worldBounds, minimapSize);
+            const center = getViewportCenterWorld(transform, viewportSize);
+            grabOffsetWorld = {
+                x: pointerWorld.x - center.x,
+                y: pointerWorld.y - center.y,
+            };
+        }
+        else if (!inside && interactions.click) {
+            // Tap-vs-drag is resolved on pointermove / pointerup.
+            // dragFromEmpty (if enabled) takes over after the click threshold.
+            mode = 'pending-click';
+        }
+        else if (!inside && interactions.dragFromEmpty) {
+            mode = 'drag-pan';
+        }
+        else {
+            return;
+        }
+        e.preventDefault();
+        container.setPointerCapture(e.pointerId);
+        stateRef.current = {
+            pointerId: e.pointerId,
+            mode,
+            startScreen: screen,
+            grabOffsetWorld,
+        };
+        if (mode === 'drag-pan') {
+            const worldPoint = minimapToWorld(screen, worldBounds, minimapSize);
+            store.setIsDragging(true);
+            emit({ worldPoint, phase: 'drag-start' });
+        }
+        else if (mode === 'drag-rect') {
+            store.setIsDragging(true);
+            const center = getViewportCenterWorld(transform, viewportSize);
+            emit({ worldPoint: center, phase: 'drag-start' });
+        }
+    }, [
+        containerRef,
+        disabledRef,
+        interactionsRef,
+        transformRef,
+        viewportSizeRef,
+        worldBoundsRef,
+        minimapSizeRef,
+        store,
+        emit,
+    ]);
+    const handlePointerMove = useCallback((e) => {
+        const container = containerRef.current;
+        if (!container)
+            return;
+        const screen = getLocalPointerPosition(e, container);
+        // Always update hover state — independent of gesture capture.
+        updateHover(screen);
+        const state = stateRef.current;
+        if (state?.pointerId !== e.pointerId)
+            return;
+        const worldBounds = worldBoundsRef.current;
+        const minimapSize = minimapSizeRef.current;
+        const interactions = interactionsRef.current;
+        const dx = screen.x - state.startScreen.x;
+        const dy = screen.y - state.startScreen.y;
+        const moved = Math.hypot(dx, dy) >= CLICK_THRESHOLD_PX;
+        if (state.mode === 'pending-click') {
+            if (!moved)
+                return;
+            if (interactions.dragFromEmpty) {
+                state.mode = 'drag-pan';
+                store.setIsDragging(true);
+                const worldPoint = minimapToWorld(screen, worldBounds, minimapSize);
+                emit({ worldPoint, phase: 'drag-start' });
+            }
+            else {
+                // Threshold exceeded but drag-from-empty is disabled — cancel the click.
+                state.mode = 'cancelled';
+            }
+            return;
+        }
+        if (state.mode === 'cancelled')
+            return;
+        if (state.mode === 'drag-pan') {
+            const worldPoint = minimapToWorld(screen, worldBounds, minimapSize);
+            emit({ worldPoint, phase: 'drag' });
+            return;
+        }
+        // Only 'drag-rect' remains after the early returns above.
+        const pointerWorld = minimapToWorld(screen, worldBounds, minimapSize);
+        const offset = state.grabOffsetWorld ?? { x: 0, y: 0 };
+        emit({
+            worldPoint: {
+                x: pointerWorld.x - offset.x,
+                y: pointerWorld.y - offset.y,
+            },
+            phase: 'drag',
+        });
+    }, [
+        containerRef,
+        worldBoundsRef,
+        minimapSizeRef,
+        interactionsRef,
+        store,
+        emit,
+        updateHover,
+    ]);
+    const handlePointerLeave = useCallback(() => {
+        if (stateRef.current)
+            return; // keep hover during drag (pointer capture)
+        updateHover(null);
+    }, [updateHover]);
+    const endGesture = useCallback((e, cancelled) => {
+        const state = stateRef.current;
+        if (state?.pointerId !== e.pointerId)
+            return;
+        const container = containerRef.current;
+        if (container?.hasPointerCapture(e.pointerId)) {
+            container.releasePointerCapture(e.pointerId);
+        }
+        if (!cancelled) {
+            const worldBounds = worldBoundsRef.current;
+            const minimapSize = minimapSizeRef.current;
+            const screen = getLocalPointerPosition(e, container);
+            if (state.mode === 'pending-click') {
+                const worldPoint = minimapToWorld(state.startScreen, worldBounds, minimapSize);
+                emit({ worldPoint, phase: 'click' });
+            }
+            else if (state.mode === 'drag-pan') {
+                const worldPoint = minimapToWorld(screen, worldBounds, minimapSize);
+                emit({ worldPoint, phase: 'drag-end' });
+            }
+            else if (state.mode === 'drag-rect') {
+                const pointerWorld = minimapToWorld(screen, worldBounds, minimapSize);
+                const offset = state.grabOffsetWorld ?? { x: 0, y: 0 };
+                emit({
+                    worldPoint: {
+                        x: pointerWorld.x - offset.x,
+                        y: pointerWorld.y - offset.y,
+                    },
+                    phase: 'drag-end',
+                });
+            }
+        }
+        stateRef.current = null;
+        store.setIsDragging(false);
+    }, [containerRef, worldBoundsRef, minimapSizeRef, store, emit]);
+    const handlePointerUp = useCallback((e) => {
+        endGesture(e, false);
+    }, [endGesture]);
+    const handlePointerCancel = useCallback((e) => {
+        endGesture(e, true);
+    }, [endGesture]);
+    const handleKeyDown = useCallback((e) => {
+        if (disabledRef.current)
+            return;
+        let dx = 0;
+        let dy = 0;
+        switch (e.key) {
+            case 'ArrowLeft':
+                dx = -1;
+                break;
+            case 'ArrowRight':
+                dx = 1;
+                break;
+            case 'ArrowUp':
+                dy = -1;
+                break;
+            case 'ArrowDown':
+                dy = 1;
+                break;
+            default:
+                return;
+        }
+        e.preventDefault();
+        const transform = transformRef.current;
+        const viewportSize = viewportSizeRef.current;
+        const keyboardPanStep = keyboardPanStepRef.current;
+        const zoom = transform.zoom === 0 ? 1 : transform.zoom;
+        const worldViewW = viewportSize.width / zoom;
+        const worldViewH = viewportSize.height / zoom;
+        const stepMul = e.shiftKey ? 5 : 1;
+        const stepW = worldViewW * keyboardPanStep * stepMul;
+        const stepH = worldViewH * keyboardPanStep * stepMul;
+        const currentCenter = getViewportCenterWorld(transform, viewportSize);
+        emit({
+            worldPoint: {
+                x: currentCenter.x + dx * stepW,
+                y: currentCenter.y + dy * stepH,
+            },
+            phase: 'click',
+        });
+    }, [disabledRef, transformRef, viewportSizeRef, keyboardPanStepRef, emit]);
+    const handlers = useMemo(() => ({
+        onPointerDown: handlePointerDown,
+        onPointerMove: handlePointerMove,
+        onPointerUp: handlePointerUp,
+        onPointerCancel: handlePointerCancel,
+        onPointerLeave: handlePointerLeave,
+        onKeyDown: handleKeyDown,
+    }), [
+        handlePointerDown,
+        handlePointerMove,
+        handlePointerUp,
+        handlePointerCancel,
+        handlePointerLeave,
+        handleKeyDown,
+    ]);
+    return { handlers };
+}
+
+export { useMinimapGestures };
+//# sourceMappingURL=useMinimapGestures.js.map