entangle-ui 0.9.0 → 0.11.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"MinimapTitle.js","sources":["src/components/editor/Minimap/MinimapTitle.tsx"],"sourcesContent":["import { MINIMAP_SLOT } from './Minimap.types';\n\nimport type { MinimapTitleProps } from './Minimap.types';\n\n/**\n * Title strip rendered above (or inside the top of) the Minimap canvas\n * body. Picked out of `<Minimap>` children by the `MINIMAP_SLOT` symbol —\n * does not render itself in place, so its tree position has no effect on\n * its placement.\n */\nconst MinimapTitleImpl: (props: MinimapTitleProps) => null = () => null;\n\nexport const MinimapTitle = Object.assign(MinimapTitleImpl, {\n  displayName: 'Minimap.Title',\n  [MINIMAP_SLOT]: 'title' as const,\n});\n"],"names":[],"mappings":";;AAIA;;;;;AAKG;AACH,MAAM,gBAAgB,GAAuC,MAAM,IAAI;MAE1D,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE;AAC1D,IAAA,WAAW,EAAE,eAAe;IAC5B,CAAC,YAAY,GAAG,OAAgB;AACjC,CAAA;;;;"}

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

@@ -0,0 +1,69 @@
+"use client";
+import { jsx } from 'react/jsx-runtime';
+import { useRef, useState, useMemo, useCallback } from 'react';
+import '../../primitives/viewport/Viewport.js';
+import '../../primitives/viewport/ViewportLayer.js';
+import '../../primitives/viewport/ViewportWorld.js';
+import '../../primitives/viewport/ViewportOverlay.js';
+import { useViewportContext } from '../../primitives/viewport/ViewportContext.js';
+import '../../../utils/devWarn.js';
+import { useLatest } from '../../../hooks/useLatest/useLatest.js';
+import { useResizeObserver } from '../../../hooks/useResizeObserver/useResizeObserver.js';
+import '../../../hooks/useBreakpoint/useBreakpoint.js';
+import './../../../assets/src/theme/lightTheme.css.ts.vanilla-Ct6f9Iym.css';
+import '@vanilla-extract/css';
+import './../../../assets/src/theme/darkTheme.css.ts.vanilla-BHZ3ecRn.css';
+import './../../../assets/src/theme/globalScrollbars.css.ts.vanilla-BAJwnUEJ.css';
+import '../../../hooks/useNavigationHistory/useNavigationHistory.js';
+import { Minimap } from './Minimap.js';
+
+function placementToStyle(placement, margin) {
+    if (typeof placement === 'object') {
+        return { position: 'absolute', pointerEvents: 'auto', ...placement };
+    }
+    const style = {
+        position: 'absolute',
+        pointerEvents: 'auto',
+    };
+    if (placement.startsWith('top'))
+        style.top = margin;
+    else
+        style.bottom = margin;
+    if (placement.endsWith('left'))
+        style.left = margin;
+    else
+        style.right = margin;
+    return style;
+}
+/**
+ * Auto-bound minimap for use inside a `<Viewport>`. Reads live `transform`
+ * and `size` from `useViewportContext()`, positions itself in a corner
+ * (or custom anchor), and wires `onNavigate` to the viewport handle's
+ * `centerOn`. Falls back to the manual `<Minimap>` if you need the
+ * minimap outside the Viewport tree.
+ *
+ * Recognized by `<Viewport>` as an overlay child — drop it among layers
+ * and world/overlay siblings without an explicit `<ViewportOverlay>` wrapper.
+ */
+const ViewportMinimap = ({ placement = 'bottom-right', margin = 12, responsive = false, width: widthProp, onNavigate: userOnNavigate, ref, ...minimapProps }) => {
+    const { transform, size, handle } = useViewportContext();
+    const wrapperRef = useRef(null);
+    const [measuredWidth, setMeasuredWidth] = useState(null);
+    useResizeObserver(wrapperRef, entry => {
+        setMeasuredWidth(entry.contentRect.width);
+    }, { enabled: responsive });
+    const wrapperStyle = useMemo(() => placementToStyle(placement, margin), [placement, margin]);
+    const effectiveWidth = responsive
+        ? (measuredWidth ?? widthProp ?? 200)
+        : widthProp;
+    const userOnNavigateRef = useLatest(userOnNavigate);
+    const handleNavigate = useCallback((info) => {
+        handle.centerOn(info.worldPoint);
+        userOnNavigateRef.current?.(info);
+    }, [handle, userOnNavigateRef]);
+    return (jsx("div", { ref: wrapperRef, style: wrapperStyle, children: jsx(Minimap, { ...minimapProps, ref: ref, transform: transform, viewportSize: size, width: effectiveWidth, onNavigate: handleNavigate }) }));
+};
+ViewportMinimap.displayName = 'ViewportMinimap';
+
+export { ViewportMinimap };
+//# sourceMappingURL=ViewportMinimap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ViewportMinimap.js","sources":["src/components/editor/Minimap/ViewportMinimap.tsx"],"sourcesContent":["'use client';\n\nimport React, { useCallback, useMemo, useRef, useState } from 'react';\n\nimport { useViewportContext } from '@/components/primitives/viewport';\nimport { useLatest, useResizeObserver } from '@/hooks';\n\nimport { Minimap } from './Minimap';\n\nimport type {\n  MinimapHandle,\n  MinimapNavigateInfo,\n  MinimapProps,\n} from './Minimap.types';\n\nexport type ViewportMinimapPlacement =\n  | 'top-left'\n  | 'top-right'\n  | 'bottom-left'\n  | 'bottom-right'\n  | {\n      top?: number | string;\n      right?: number | string;\n      bottom?: number | string;\n      left?: number | string;\n      width?: number | string;\n      height?: number | string;\n    };\n\nexport interface ViewportMinimapProps extends Omit<\n  MinimapProps,\n  'transform' | 'viewportSize' | 'ref'\n> {\n  /**\n   * Anchored position inside the parent `<Viewport>`. Use a preset for\n   * the four corners, or an object for custom anchoring.\n   * @default 'bottom-right'\n   */\n  placement?: ViewportMinimapPlacement;\n  /**\n   * Distance (CSS px) from the viewport edge when using a preset placement.\n   * Ignored when `placement` is an object.\n   * @default 12\n   */\n  margin?: number;\n  /**\n   * When true, the minimap width tracks the wrapper's measured width via\n   * ResizeObserver. The wrapper size must be controlled externally (e.g.\n   * via custom `placement` or a parent container). The `width` prop, if\n   * provided, becomes a fallback used until the first measurement lands.\n   * @default false\n   */\n  responsive?: boolean;\n  /** Imperative handle (same shape as `<Minimap>`'s). */\n  ref?: React.Ref<MinimapHandle>;\n}\n\nfunction placementToStyle(\n  placement: ViewportMinimapPlacement,\n  margin: number\n): React.CSSProperties {\n  if (typeof placement === 'object') {\n    return { position: 'absolute', pointerEvents: 'auto', ...placement };\n  }\n  const style: React.CSSProperties = {\n    position: 'absolute',\n    pointerEvents: 'auto',\n  };\n  if (placement.startsWith('top')) style.top = margin;\n  else style.bottom = margin;\n  if (placement.endsWith('left')) style.left = margin;\n  else style.right = margin;\n  return style;\n}\n\n/**\n * Auto-bound minimap for use inside a `<Viewport>`. Reads live `transform`\n * and `size` from `useViewportContext()`, positions itself in a corner\n * (or custom anchor), and wires `onNavigate` to the viewport handle's\n * `centerOn`. Falls back to the manual `<Minimap>` if you need the\n * minimap outside the Viewport tree.\n *\n * Recognized by `<Viewport>` as an overlay child — drop it among layers\n * and world/overlay siblings without an explicit `<ViewportOverlay>` wrapper.\n */\nexport const ViewportMinimap = ({\n  placement = 'bottom-right',\n  margin = 12,\n  responsive = false,\n  width: widthProp,\n  onNavigate: userOnNavigate,\n  ref,\n  ...minimapProps\n}: ViewportMinimapProps): React.ReactElement => {\n  const { transform, size, handle } = useViewportContext();\n  const wrapperRef = useRef<HTMLDivElement>(null);\n  const [measuredWidth, setMeasuredWidth] = useState<number | null>(null);\n\n  useResizeObserver(\n    wrapperRef,\n    entry => {\n      setMeasuredWidth(entry.contentRect.width);\n    },\n    { enabled: responsive }\n  );\n\n  const wrapperStyle = useMemo(\n    () => placementToStyle(placement, margin),\n    [placement, margin]\n  );\n\n  const effectiveWidth = responsive\n    ? (measuredWidth ?? widthProp ?? 200)\n    : widthProp;\n\n  const userOnNavigateRef = useLatest(userOnNavigate);\n  const handleNavigate = useCallback(\n    (info: MinimapNavigateInfo): void => {\n      handle.centerOn(info.worldPoint);\n      userOnNavigateRef.current?.(info);\n    },\n    [handle, userOnNavigateRef]\n  );\n\n  return (\n    <div ref={wrapperRef} style={wrapperStyle}>\n      <Minimap\n        {...minimapProps}\n        ref={ref}\n        transform={transform}\n        viewportSize={size}\n        width={effectiveWidth}\n        onNavigate={handleNavigate}\n      />\n    </div>\n  );\n};\n\nViewportMinimap.displayName = 'ViewportMinimap';\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAyDA;AAIE;AACE;;AAEF;AACE;AACA;;AAEF;AAAiC;;AAC5B;AACL;AAAgC;;AAC3B;AACL;AACF;AAEA;;;;;;;;;AASG;AACI;;AAUL;;AAGA;AAGI;AACF;;;AAUA;;AAGF;AACA;AAEI;AACA;AACF;AAIF;AAYF;AAEA;;"}

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":["import type { MinimapItem } from './Minimap.types';\nimport type { WorldRect } from '@/components/primitives/viewport';\n\n/**\n * Compute the tight axis-aligned bounding box of a set of minimap items,\n * with optional uniform padding (in world units) on every side.\n *\n * An empty input returns a zero-area rect at the origin so the minimap\n * can still render a meaningful surface.\n */\nexport function computeBoundsFromItems(\n  items: ReadonlyArray<MinimapItem>,\n  padding: number = 0\n): WorldRect {\n  if (items.length === 0) {\n    return { x: 0, y: 0, width: 0, height: 0 };\n  }\n\n  let minX = Infinity;\n  let minY = Infinity;\n  let maxX = -Infinity;\n  let maxY = -Infinity;\n\n  for (const item of items) {\n    let l = 0;\n    let t = 0;\n    let r = 0;\n    let b = 0;\n    switch (item.type) {\n      case 'rect':\n        l = item.x;\n        t = item.y;\n        r = item.x + item.width;\n        b = item.y + item.height;\n        break;\n      case 'circle':\n        l = item.cx - item.r;\n        t = item.cy - item.r;\n        r = item.cx + item.r;\n        b = item.cy + item.r;\n        break;\n      case 'line':\n        l = Math.min(item.x1, item.x2);\n        t = Math.min(item.y1, item.y2);\n        r = Math.max(item.x1, item.x2);\n        b = Math.max(item.y1, item.y2);\n        break;\n      case 'custom':\n        l = item.bounds.x;\n        t = item.bounds.y;\n        r = item.bounds.x + item.bounds.width;\n        b = item.bounds.y + item.bounds.height;\n        break;\n    }\n    if (l < minX) minX = l;\n    if (t < minY) minY = t;\n    if (r > maxX) maxX = r;\n    if (b > maxY) maxY = b;\n  }\n\n  return {\n    x: minX - padding,\n    y: minY - padding,\n    width: maxX - minX + 2 * padding,\n    height: maxY - minY + 2 * padding,\n  };\n}\n"],"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":["import { Minimap as MinimapBase } from './Minimap';\nimport { MinimapCorner } from './MinimapCorner';\nimport { MinimapFooter } from './MinimapFooter';\nimport { MinimapTitle } from './MinimapTitle';\n\ntype MinimapCompound = typeof MinimapBase & {\n  Title: typeof MinimapTitle;\n  Footer: typeof MinimapFooter;\n  Corner: typeof MinimapCorner;\n};\n\nconst MinimapWithSlots = MinimapBase as MinimapCompound;\nMinimapWithSlots.Title = MinimapTitle;\nMinimapWithSlots.Footer = MinimapFooter;\nMinimapWithSlots.Corner = MinimapCorner;\n\nexport const Minimap = MinimapWithSlots;\nexport { MinimapTitle, MinimapFooter, MinimapCorner };\nexport { ViewportMinimap } from './ViewportMinimap';\nexport { computeBoundsFromItems } from './computeBoundsFromItems';\nexport {\n  useMinimapContext,\n  useMinimapHover,\n  useMinimapGeometry,\n  useMinimapDragState,\n} from './MinimapContext';\nexport { MINIMAP_SLOT } from './Minimap.types';\n\nexport type {\n  MinimapProps,\n  MinimapItem,\n  MinimapRectItem,\n  MinimapCircleItem,\n  MinimapLineItem,\n  MinimapCustomItem,\n  MinimapNavigateInfo,\n  MinimapNavigatePhase,\n  MinimapInteractionConfig,\n  MinimapDrawInfo,\n  MinimapContextValue,\n  MinimapHandle,\n  MinimapSlotKind,\n  MinimapSlotMarker,\n  MinimapTitleProps,\n  MinimapFooterProps,\n  MinimapCornerProps,\n  MinimapTitlePlacement,\n  MinimapFooterPlacement,\n  MinimapCornerSide,\n} from './Minimap.types';\nexport type { MinimapGeometryState, MinimapHoverState } from './MinimapStore';\nexport type {\n  ViewportMinimapProps,\n  ViewportMinimapPlacement,\n} from './ViewportMinimap';\n"],"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":["import type { Point2D } from '@/components/primitives/canvas/canvas.types';\nimport type {\n  ViewportTransform,\n  ViewportSize,\n  WorldRect,\n} from '@/components/primitives/viewport';\n\n/** Axis-aligned rectangle in minimap (CSS-pixel) coordinates. */\nexport interface MinimapScreenRect {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\n/**\n * Derive minimap height from a width + `worldBounds` aspect ratio,\n * clamped to `[minHeight, maxHeight]`.\n *\n * When `worldBounds` is zero-area, falls back to `minHeight` (the minimap\n * still renders a usable surface so users see the viewport rect).\n */\nexport function computeMinimapHeight(\n  width: number,\n  worldBounds: WorldRect,\n  minHeight: number,\n  maxHeight: number\n): number {\n  if (worldBounds.width <= 0 || worldBounds.height <= 0) {\n    return minHeight;\n  }\n  const ratio = worldBounds.height / worldBounds.width;\n  const raw = width * ratio;\n  return Math.min(maxHeight, Math.max(minHeight, raw));\n}\n\n/**\n * Uniform scale that fits `worldBounds` inside `minimapSize`, preserving\n * the world aspect ratio. If the minimap was clamped (e.g. height hit\n * `maxHeight`), the resulting content is letterboxed.\n */\nexport function computeMinimapScale(\n  worldBounds: WorldRect,\n  minimapSize: ViewportSize\n): number {\n  if (worldBounds.width <= 0 || worldBounds.height <= 0) {\n    return 1;\n  }\n  return Math.min(\n    minimapSize.width / worldBounds.width,\n    minimapSize.height / worldBounds.height\n  );\n}\n\n/** Letterbox offset (each side) when world and minimap aspect ratios differ. */\nexport function computeMinimapOffset(\n  worldBounds: WorldRect,\n  minimapSize: ViewportSize,\n  scale: number\n): Point2D {\n  const usedW = worldBounds.width * scale;\n  const usedH = worldBounds.height * scale;\n  return {\n    x: (minimapSize.width - usedW) / 2,\n    y: (minimapSize.height - usedH) / 2,\n  };\n}\n\n/** Map a world point to minimap CSS pixel coordinates. */\nexport function worldToMinimap(\n  point: Point2D,\n  worldBounds: WorldRect,\n  minimapSize: ViewportSize\n): Point2D {\n  const scale = computeMinimapScale(worldBounds, minimapSize);\n  const offset = computeMinimapOffset(worldBounds, minimapSize, scale);\n  return {\n    x: offset.x + (point.x - worldBounds.x) * scale,\n    y: offset.y + (point.y - worldBounds.y) * scale,\n  };\n}\n\n/** Inverse of `worldToMinimap`: minimap CSS point → world point. */\nexport function minimapToWorld(\n  point: Point2D,\n  worldBounds: WorldRect,\n  minimapSize: ViewportSize\n): Point2D {\n  // Zero-area bounds have no meaningful inverse mapping — collapse everything\n  // to the bounds origin so navigation still emits a stable point.\n  if (worldBounds.width <= 0 || worldBounds.height <= 0) {\n    return { x: worldBounds.x, y: worldBounds.y };\n  }\n  const scale = computeMinimapScale(worldBounds, minimapSize);\n  const offset = computeMinimapOffset(worldBounds, minimapSize, scale);\n  return {\n    x: worldBounds.x + (point.x - offset.x) / scale,\n    y: worldBounds.y + (point.y - offset.y) / scale,\n  };\n}\n\n/**\n * Viewport rect (in minimap CSS px) for a given main-viewport transform\n * and size. The world-space region visible in the main viewport is at\n * `(-tx / zoom, -ty / zoom)` with size `viewportSize / zoom`.\n */\nexport function getViewportRectOnMinimap(\n  transform: ViewportTransform,\n  viewportSize: ViewportSize,\n  worldBounds: WorldRect,\n  minimapSize: ViewportSize\n): MinimapScreenRect {\n  const scale = computeMinimapScale(worldBounds, minimapSize);\n  const offset = computeMinimapOffset(worldBounds, minimapSize, scale);\n  const zoom = transform.zoom === 0 ? 1 : transform.zoom;\n\n  const worldX = -transform.x / zoom;\n  const worldY = -transform.y / zoom;\n  const worldW = viewportSize.width / zoom;\n  const worldH = viewportSize.height / zoom;\n\n  return {\n    x: offset.x + (worldX - worldBounds.x) * scale,\n    y: offset.y + (worldY - worldBounds.y) * scale,\n    width: worldW * scale,\n    height: worldH * scale,\n  };\n}\n\n/** Current world-space center of the main viewport. */\nexport function getViewportCenterWorld(\n  transform: ViewportTransform,\n  viewportSize: ViewportSize\n): Point2D {\n  const zoom = transform.zoom === 0 ? 1 : transform.zoom;\n  return {\n    x: (-transform.x + viewportSize.width / 2) / zoom,\n    y: (-transform.y + viewportSize.height / 2) / zoom,\n  };\n}\n\n/**\n * Build the shared coordinate helpers used by built-in drawing,\n * `renderOverlay`, and custom items. `transform`/`viewportSize` are not\n * needed by the helpers themselves but are passed downstream alongside\n * this bundle to form the public `MinimapDrawInfo`.\n */\nexport function buildDrawInfo(\n  worldBounds: WorldRect,\n  minimapSize: ViewportSize\n): {\n  scale: number;\n  offset: Point2D;\n  worldToMinimap: (point: Point2D) => Point2D;\n  minimapToWorld: (point: Point2D) => Point2D;\n} {\n  const scale = computeMinimapScale(worldBounds, minimapSize);\n  const offset = computeMinimapOffset(worldBounds, minimapSize, scale);\n  return {\n    scale,\n    offset,\n    worldToMinimap: (p: Point2D) => worldToMinimap(p, worldBounds, minimapSize),\n    minimapToWorld: (p: Point2D) => minimapToWorld(p, worldBounds, minimapSize),\n  };\n}\n"],"names":[],"mappings":"AAeA;;;;;;AAMG;AACG,SAAU,oBAAoB,CAClC,KAAa,EACb,WAAsB,EACtB,SAAiB,EACjB,SAAiB,EAAA;AAEjB,IAAA,IAAI,WAAW,CAAC,KAAK,IAAI,CAAC,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC,EAAE;AACrD,QAAA,OAAO,SAAS;IAClB;IACA,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,GAAG,WAAW,CAAC,KAAK;AACpD,IAAA,MAAM,GAAG,GAAG,KAAK,GAAG,KAAK;AACzB,IAAA,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AACtD;AAEA;;;;AAIG;AACG,SAAU,mBAAmB,CACjC,WAAsB,EACtB,WAAyB,EAAA;AAEzB,IAAA,IAAI,WAAW,CAAC,KAAK,IAAI,CAAC,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC,EAAE;AACrD,QAAA,OAAO,CAAC;IACV;IACA,OAAO,IAAI,CAAC,GAAG,CACb,WAAW,CAAC,KAAK,GAAG,WAAW,CAAC,KAAK,EACrC,WAAW,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CACxC;AACH;AAEA;SACgB,oBAAoB,CAClC,WAAsB,EACtB,WAAyB,EACzB,KAAa,EAAA;AAEb,IAAA,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,GAAG,KAAK;AACvC,IAAA,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,GAAG,KAAK;IACxC,OAAO;QACL,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,GAAG,KAAK,IAAI,CAAC;QAClC,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,GAAG,KAAK,IAAI,CAAC;KACpC;AACH;AAEA;SACgB,cAAc,CAC5B,KAAc,EACd,WAAsB,EACtB,WAAyB,EAAA;IAEzB,MAAM,KAAK,GAAG,mBAAmB,CAAC,WAAW,EAAE,WAAW,CAAC;IAC3D,MAAM,MAAM,GAAG,oBAAoB,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,CAAC;IACpE,OAAO;AACL,QAAA,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,KAAK;AAC/C,QAAA,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,KAAK;KAChD;AACH;AAEA;SACgB,cAAc,CAC5B,KAAc,EACd,WAAsB,EACtB,WAAyB,EAAA;;;AAIzB,IAAA,IAAI,WAAW,CAAC,KAAK,IAAI,CAAC,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC,EAAE;AACrD,QAAA,OAAO,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE;IAC/C;IACA,MAAM,KAAK,GAAG,mBAAmB,CAAC,WAAW,EAAE,WAAW,CAAC;IAC3D,MAAM,MAAM,GAAG,oBAAoB,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,CAAC;IACpE,OAAO;AACL,QAAA,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,KAAK;AAC/C,QAAA,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,KAAK;KAChD;AACH;AAEA;;;;AAIG;AACG,SAAU,wBAAwB,CACtC,SAA4B,EAC5B,YAA0B,EAC1B,WAAsB,EACtB,WAAyB,EAAA;IAEzB,MAAM,KAAK,GAAG,mBAAmB,CAAC,WAAW,EAAE,WAAW,CAAC;IAC3D,MAAM,MAAM,GAAG,oBAAoB,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,CAAC;AACpE,IAAA,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,IAAI;IAEtD,MAAM,MAAM,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI;IAClC,MAAM,MAAM,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI;AAClC,IAAA,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,GAAG,IAAI;AACxC,IAAA,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,GAAG,IAAI;IAEzC,OAAO;AACL,QAAA,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,IAAI,KAAK;AAC9C,QAAA,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,IAAI,KAAK;QAC9C,KAAK,EAAE,MAAM,GAAG,KAAK;QACrB,MAAM,EAAE,MAAM,GAAG,KAAK;KACvB;AACH;AAEA;AACM,SAAU,sBAAsB,CACpC,SAA4B,EAC5B,YAA0B,EAAA;AAE1B,IAAA,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,IAAI;IACtD,OAAO;AACL,QAAA,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,YAAY,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI;AACjD,QAAA,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI;KACnD;AACH;AAEA;;;;;AAKG;AACG,SAAU,aAAa,CAC3B,WAAsB,EACtB,WAAyB,EAAA;IAOzB,MAAM,KAAK,GAAG,mBAAmB,CAAC,WAAW,EAAE,WAAW,CAAC;IAC3D,MAAM,MAAM,GAAG,oBAAoB,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,CAAC;IACpE,OAAO;QACL,KAAK;QACL,MAAM;AACN,QAAA,cAAc,EAAE,CAAC,CAAU,KAAK,cAAc,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC;AAC3E,QAAA,cAAc,EAAE,CAAC,CAAU,KAAK,cAAc,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC;KAC5E;AACH;;;;"}

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":["import { buildDrawInfo, getViewportRectOnMinimap } from './minimapCoords';\n\nimport type { MinimapDrawInfo, MinimapItem } from './Minimap.types';\nimport type { MinimapScreenRect } from './minimapCoords';\nimport type {\n  ViewportTransform,\n  ViewportSize,\n  WorldRect,\n} from '@/components/primitives/viewport';\n\nexport interface MinimapDrawColors {\n  background: string;\n  defaultItem: string;\n  viewportRectStroke: string;\n  outsideOverlay: string;\n}\n\nexport interface MinimapDrawInput {\n  ctx: CanvasRenderingContext2D;\n  size: ViewportSize;\n  worldBounds: WorldRect;\n  transform: ViewportTransform;\n  viewportSize: ViewportSize;\n  items: ReadonlyArray<MinimapItem>;\n  colors: MinimapDrawColors;\n  renderOverlay?: (\n    ctx: CanvasRenderingContext2D,\n    info: MinimapDrawInfo\n  ) => void;\n}\n\n/**\n * Render a full minimap frame: background → items → caller `renderOverlay`\n * → dimmed shroud around the viewport rect → viewport rect outline. The\n * caller is responsible for DPR scaling on `ctx` before invoking.\n */\nexport function drawMinimap(input: MinimapDrawInput): void {\n  const {\n    ctx,\n    size,\n    worldBounds,\n    transform,\n    viewportSize,\n    items,\n    colors,\n    renderOverlay,\n  } = input;\n\n  ctx.clearRect(0, 0, size.width, size.height);\n  ctx.fillStyle = colors.background;\n  ctx.fillRect(0, 0, size.width, size.height);\n\n  const helpers = buildDrawInfo(worldBounds, size);\n  const info: MinimapDrawInfo = {\n    minimapSize: size,\n    worldBounds,\n    transform,\n    viewportSize,\n    ...helpers,\n  };\n\n  ctx.save();\n  ctx.beginPath();\n  ctx.rect(0, 0, size.width, size.height);\n  ctx.clip();\n\n  for (const item of items) {\n    const color = item.color ?? colors.defaultItem;\n    ctx.fillStyle = color;\n    ctx.strokeStyle = color;\n\n    switch (item.type) {\n      case 'rect': {\n        const topLeft = info.worldToMinimap({ x: item.x, y: item.y });\n        ctx.fillRect(\n          topLeft.x,\n          topLeft.y,\n          Math.max(1, item.width * info.scale),\n          Math.max(1, item.height * info.scale)\n        );\n        break;\n      }\n      case 'circle': {\n        const center = info.worldToMinimap({ x: item.cx, y: item.cy });\n        const r = Math.max(0.5, item.r * info.scale);\n        ctx.beginPath();\n        ctx.arc(center.x, center.y, r, 0, Math.PI * 2);\n        ctx.fill();\n        break;\n      }\n      case 'line': {\n        const a = info.worldToMinimap({ x: item.x1, y: item.y1 });\n        const b = info.worldToMinimap({ x: item.x2, y: item.y2 });\n        ctx.lineWidth = item.lineWidth ?? 1;\n        ctx.beginPath();\n        ctx.moveTo(a.x, a.y);\n        ctx.lineTo(b.x, b.y);\n        ctx.stroke();\n        break;\n      }\n      case 'custom': {\n        ctx.save();\n        item.draw(ctx, info);\n        ctx.restore();\n        break;\n      }\n    }\n  }\n\n  if (renderOverlay) {\n    ctx.save();\n    renderOverlay(ctx, info);\n    ctx.restore();\n  }\n\n  ctx.restore();\n\n  const vr = getViewportRectOnMinimap(\n    transform,\n    viewportSize,\n    worldBounds,\n    size\n  );\n  drawOutsideOverlay(ctx, size, vr, colors.outsideOverlay);\n\n  ctx.strokeStyle = colors.viewportRectStroke;\n  ctx.lineWidth = 1;\n  const strokeW = Math.max(0, vr.width - 1);\n  const strokeH = Math.max(0, vr.height - 1);\n  ctx.strokeRect(vr.x + 0.5, vr.y + 0.5, strokeW, strokeH);\n}\n\nfunction drawOutsideOverlay(\n  ctx: CanvasRenderingContext2D,\n  size: ViewportSize,\n  rect: MinimapScreenRect,\n  color: string\n): void {\n  const rl = Math.max(0, Math.min(size.width, rect.x));\n  const rt = Math.max(0, Math.min(size.height, rect.y));\n  const rr = Math.max(0, Math.min(size.width, rect.x + rect.width));\n  const rb = Math.max(0, Math.min(size.height, rect.y + rect.height));\n\n  ctx.fillStyle = color;\n  if (rt > 0) ctx.fillRect(0, 0, size.width, rt);\n  if (rb < size.height) ctx.fillRect(0, rb, size.width, size.height - rb);\n  if (rl > 0 && rt < rb) ctx.fillRect(0, rt, rl, rb - rt);\n  if (rr < size.width && rt < rb) {\n    ctx.fillRect(rr, rt, size.width - rr, rb - rt);\n  }\n}\n"],"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":["import type { MinimapItem } from './Minimap.types';\nimport type { Point2D } from '@/components/primitives/canvas/canvas.types';\nimport type { WorldRect } from '@/components/primitives/viewport';\n\n/** Distance from point P to line segment A-B (in world units). */\nfunction distancePointToSegment(p: Point2D, a: Point2D, b: Point2D): number {\n  const dx = b.x - a.x;\n  const dy = b.y - a.y;\n  const lenSq = dx * dx + dy * dy;\n  if (lenSq === 0) {\n    const ex = p.x - a.x;\n    const ey = p.y - a.y;\n    return Math.hypot(ex, ey);\n  }\n  let t = ((p.x - a.x) * dx + (p.y - a.y) * dy) / lenSq;\n  t = Math.max(0, Math.min(1, t));\n  const cx = a.x + t * dx;\n  const cy = a.y + t * dy;\n  return Math.hypot(p.x - cx, p.y - cy);\n}\n\n/**\n * Hit-test a world point against the item list, returning the topmost\n * (last-drawn) match. `lineToleranceWorld` is the picking radius (world\n * units) used for line items.\n */\nexport function hitTestItems(\n  worldPoint: Point2D,\n  items: ReadonlyArray<MinimapItem>,\n  lineToleranceWorld: number\n): string | null {\n  for (let i = items.length - 1; i >= 0; i -= 1) {\n    const item = items[i];\n    if (!item) continue;\n    if (pointHitsItem(worldPoint, item, lineToleranceWorld)) {\n      return item.id;\n    }\n  }\n  return null;\n}\n\nfunction pointHitsItem(\n  p: Point2D,\n  item: MinimapItem,\n  lineToleranceWorld: number\n): boolean {\n  switch (item.type) {\n    case 'rect':\n      return (\n        p.x >= item.x &&\n        p.x <= item.x + item.width &&\n        p.y >= item.y &&\n        p.y <= item.y + item.height\n      );\n    case 'circle': {\n      const dx = p.x - item.cx;\n      const dy = p.y - item.cy;\n      return dx * dx + dy * dy <= item.r * item.r;\n    }\n    case 'line':\n      return (\n        distancePointToSegment(\n          p,\n          { x: item.x1, y: item.y1 },\n          { x: item.x2, y: item.y2 }\n        ) <= lineToleranceWorld\n      );\n    case 'custom':\n      return inWorldRect(p, item.bounds);\n  }\n}\n\nfunction inWorldRect(p: Point2D, rect: WorldRect): boolean {\n  return (\n    p.x >= rect.x &&\n    p.x <= rect.x + rect.width &&\n    p.y >= rect.y &&\n    p.y <= rect.y + rect.height\n  );\n}\n"],"names":[],"mappings":"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"}