@weasel-js/core 1.11.1 → 1.13.0-rc.0

package/dist/features/text/useSceneTextEdit.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSceneTextEdit.js","names":[],"sources":["../../../src/features/text/useSceneTextEdit.ts"],"sourcesContent":["/**\n * `useSceneTextEdit` — scene-aware wrapper around `useTextEdit`: scene\n * lookups for text / style / runs / screen-pose, and\n * `scene.update(id, { data })` for commits. The overlay and a double-click\n * both read the pose a node is painted at, so text inside a container whose\n * pose is a frame is edited where it is drawn.\n *\n * Defaults assume the node's `data` carries `text` / `style` / `runs`\n * directly. For custom data shapes, override any of the optional projections.\n * Consumers with non-rect poses should drop down to raw `useTextEdit` and\n * supply their own `getScreenPose`.\n */\nimport { useCallback, useMemo, useRef, type MouseEvent } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { asNodeId } from '../../core/scene/types';\nimport { scenePaintedPoseOf } from '../../canvas/derivedPath';\nimport type { Scene } from '../../core/scene/types';\nimport { drawOneEditing, type EditingDrawOne } from './editingDrawOne';\nimport { textHitAt } from './textHitAt';\nimport type { Stroke, Fill } from '@weasel-js/paint';\nimport { resolveScreenLength } from '@weasel-js/paint';\nimport { clientToCanvas } from '@weasel-js/routing';\nimport { findMountedCanvas, type MountedCanvas } from '../../canvas/mountedCanvases';\nimport type { View } from '../../core/viewport/view';\nimport type { RectPose } from 'core/geometry/unionBounds';\nimport { poseFrameOf } from '@weasel-js/geom';\nimport { isTextData, type StyledRun, type TextPaint, type TextStyle, type TextVerticalAlign } from '@weasel-js/text';\nimport { textBoxOf, type TextOverflow } from '../../canvas/nodeShapes/textPainter';\nimport { useTextEdit, type TextEditClipRect, type TextEditScreenPose, type UseTextEditReturn } from '@weasel-js/text-dom';\n\n/** Shape the default projections expect `data` to satisfy. All fields\n *  optional so any object satisfies the constraint — projections fill in\n *  the gaps for non-default shapes. */\nexport interface DefaultTextData {\n  text?: string;\n  style?: TextStyle;\n  runs?: readonly StyledRun[];\n  fill?: Fill | null;\n  stroke?: Stroke | null;\n  verticalAlign?: TextVerticalAlign;\n  padding?: number;\n  overflow?: TextOverflow;\n}\n\n/** All-optional projections + fontSize fallback. */\nexport interface UseSceneTextEditOptions<TData> {\n  /**\n   * Is this node text? A double-click opens an edit only on a node that\n   * answers yes, and passes through any other to the text under it. Default:\n   * `isTextData`, the test `inferredNodeRouting` classifies a text node by. Pass one when `getText` reads some other shape.\n   */\n  isText?: (data: TData) => boolean;\n  /** Read plain text from `data`. Default: `data.text ?? ''`. */\n  getText?: (data: TData) => string;\n  /** Read style from `data`. Default: `data.style`. */\n  getStyle?: (data: TData) => TextStyle | undefined;\n  /** Read the node's paint from `data`. Default: `data.fill` / `data.stroke`. */\n  getPaint?: (data: TData) => TextPaint | undefined;\n  /** Read rich-text runs from `data`. Default: `data.runs`. */\n  getRuns?: (data: TData) => readonly StyledRun[] | undefined;\n  /** Read the box vertical alignment from `data`. Default: `data.verticalAlign`. */\n  getVerticalAlign?: (data: TData) => TextVerticalAlign | undefined;\n  /** Read the inset from the node's box to its text from `data`. Default: `data.padding`. */\n  getPadding?: (data: TData) => number | undefined;\n  /** Read whether the node cuts its text at its box from `data`, which the\n   *  overlay then does too. Default: `data.overflow`. */\n  getOverflow?: (data: TData) => TextOverflow | undefined;\n  /** Produce updated data with new text. Default: `{ ...data, text }`. */\n  setText?: (data: TData, text: string) => TData;\n  /** Produce updated data with new runs. Default: `{ ...data, runs }`. */\n  setRuns?: (data: TData, runs: StyledRun[]) => TData;\n  /**\n   * Produce updated data with a new node-wide style. Default:\n   * `{ ...data, style }`. Written only when a range toggle has to *clear* a\n   * flag the node itself sets — the run algebra is additive, so that edit\n   * lowers the node flag and raises it on the runs outside the range. See\n   * `useTextEdit`'s `setStyle`.\n   *\n   * An edit's text, runs, and style are folded through these three and\n   * written as one `scene.update`, so a commit is one undo step.\n   */\n  setStyle?: (data: TData, style: TextStyle) => TData;\n  /** Fallback fontSize when `style.fontSize` is unset. Default `16`. */\n  defaultFontSize?: number;\n  /**\n   * The view to project through. Omit it and the view is read live from the\n   * weasel canvas mounted inside `container` (the one a double-click landed\n   * on, when there are several). With no canvas there, the node's world box\n   * is passed through as screen pixels.\n   *\n   * A thunk is re-read on every projection; a plain `View` is the value from\n   * the render that supplied it.\n   */\n  view?: View | (() => View);\n  /**\n   * Forwarded to `useTextEdit`: is `el` part of the editor's own chrome?\n   * Focus moving into it does not end the edit. Wire it to whatever renders\n   * the character controls.\n   */\n  isEditorChrome?: (el: Element) => boolean;\n  /** Forwarded to `useTextEdit`: what Escape does to the edit. */\n  escape?: 'cancel' | 'commit';\n  /** Forwarded to `useTextEdit`: how long an edit waits for its face. */\n  fontHold?: number;\n  /** Forwarded to `useTextEdit`: called as an edit of the node `id` opens,\n   *  whichever way it was started. */\n  onStart?: (id: string) => void;\n  /** Forwarded to `useTextEdit`: called as the edit of `id` closes, after\n   *  any commit has been written to the scene. */\n  onEnd?: (id: string) => void;\n}\n\nfunction resolveView(view: View | (() => View) | undefined): View | undefined {\n  return typeof view === 'function' ? view() : view;\n}\n\n/** Return shape extends `UseTextEditReturn` with an `onDoubleClick`\n *  binding for the canvas container. Double-clicking inside a text\n *  node enters edit mode with the caret seeded at the clicked glyph. */\nexport interface UseSceneTextEditReturn extends UseTextEditReturn {\n  /** Bind to the element wrapping `<SceneCanvas>` (the same element\n   *  passed as `container`, or any ancestor that receives the dblclick\n   *  bubble). Starts an edit on the top-most text node under the cursor. */\n  onDoubleClick: (e: MouseEvent<HTMLElement>) => void;\n  /** The `isText` option asked of the node with this id: what\n   *  `TextEditDep.isTextNode` wants, so both ways into an edit agree. */\n  isTextNode: (id: string) => boolean;\n  /**\n   * `defaultDrawOne`, less the glyphs of the node being edited: the overlay\n   * stands in for its text, and the rest of the node, a `background` among\n   * it, goes on painting. Pass it as `layers.scene.drawOne`, with\n   * `paintBounds: defaultPaintBounds`, in place of an `alphaFor` that hides\n   * the whole node.\n   */\n  drawOne: EditingDrawOne;\n}\n\n/** How each field is read from a node's `data`: the option's projection, else the default shape. */\nfunction projectionsOf<TData extends DefaultTextData>(opts: { readonly current: UseSceneTextEditOptions<TData> }) {\n  return {\n    isText: (data: TData): boolean =>\n      opts.current.isText ? opts.current.isText(data) : isTextData(data),\n    text: (data: TData): string =>\n      opts.current.getText ? opts.current.getText(data) : (data.text ?? ''),\n    style: (data: TData): TextStyle | undefined =>\n      opts.current.getStyle ? opts.current.getStyle(data) : data.style,\n    runs: (data: TData): readonly StyledRun[] | undefined =>\n      opts.current.getRuns ? opts.current.getRuns(data) : data.runs,\n    verticalAlign: (data: TData): TextVerticalAlign | undefined =>\n      opts.current.getVerticalAlign ? opts.current.getVerticalAlign(data) : data.verticalAlign,\n    padding: (data: TData): number | undefined =>\n      opts.current.getPadding ? opts.current.getPadding(data) : data.padding,\n    overflow: (data: TData): TextOverflow | undefined =>\n      opts.current.getOverflow ? opts.current.getOverflow(data) : data.overflow,\n  };\n}\n\n/** Wire double-click-to-edit text on a scene: mounts a DOM editing overlay\n *  over the node being edited and writes the result back as an undoable op. */\nexport function useSceneTextEdit<\n  TData extends DefaultTextData,\n  TLayer extends string,\n  TPose extends RectPose = RectPose,\n>(\n  scene: Scene<TData, TLayer, TPose>,\n  container: HTMLElement | null,\n  options: UseSceneTextEditOptions<TData> = {},\n): UseSceneTextEditReturn {\n  // Refs, so the useTextEdit callbacks always see the current values\n  // without re-binding.\n  const sceneRef = useLatest(scene);\n  const optsRef = useLatest(options);\n  const containerRef = useLatest(container);\n  // The last double-click's target, so the overlay projects through the\n  // canvas the edit was opened on.\n  const openedOnRef = useRef<EventTarget | null>(null);\n\n  // The canvas's box in container pixels is both the origin its view projects\n  // from and the region its glyphs are clipped to.\n  const surface = (): { canvas: MountedCanvas; box: TextEditClipRect } | null => {\n    const root = containerRef.current;\n    const canvas = root ? findMountedCanvas(root, openedOnRef.current) : null;\n    if (!root || !canvas) return null;\n    const a = canvas.element.getBoundingClientRect();\n    const b = root.getBoundingClientRect();\n    return {\n      canvas,\n      box: {\n        x: a.left - b.left - root.clientLeft + root.scrollLeft,\n        y: a.top - b.top - root.clientTop + root.scrollTop,\n        width: a.width,\n        height: a.height,\n      },\n    };\n  };\n\n  const read = useMemo(() => projectionsOf(optsRef), [optsRef]);\n\n  const edit = useTextEdit({\n    container,\n    isEditorChrome: (el) => optsRef.current.isEditorChrome?.(el) ?? false,\n    escape: options.escape,\n    fontHold: options.fontHold,\n    onStart: (id) => optsRef.current.onStart?.(id),\n    onEnd: (id) => optsRef.current.onEnd?.(id),\n    getText: (id) => {\n      const node = sceneRef.current.get(asNodeId(id));\n      return node ? read.text(node.data) : '';\n    },\n    getStyle: (id) => {\n      const node = sceneRef.current.get(asNodeId(id));\n      return node ? read.style(node.data) : undefined;\n    },\n    getPaint: (id) => {\n      const node = sceneRef.current.get(asNodeId(id));\n      if (!node) return undefined;\n      const get = optsRef.current.getPaint;\n      return get ? get(node.data) : { fill: node.data.fill, stroke: node.data.stroke };\n    },\n    getScreenPose: (id) => {\n      const scene = sceneRef.current;\n      const node = scene.get(asNodeId(id));\n      if (!node) return null;\n      const at = surface();\n      const view = resolveView(optsRef.current.view) ?? at?.canvas.getView();\n      return screenPoseOf(node.data, scenePaintedPoseOf(scene)(node), read, view, at?.box, optsRef.current.defaultFontSize);\n    },\n    getClipRect: () => surface()?.box ?? null,\n    getRuns: (id) => {\n      const node = sceneRef.current.get(asNodeId(id));\n      return node ? read.runs(node.data) : undefined;\n    },\n    commit: (id, { text, runs, style }) => {\n      const nid = asNodeId(id);\n      const node = sceneRef.current.get(nid);\n      if (!node) return;\n      const { setText, setRuns, setStyle } = optsRef.current;\n      let data = setText ? setText(node.data, text) : { ...node.data, text };\n      if (runs) data = setRuns ? setRuns(data, runs) : { ...data, runs };\n      if (style) data = setStyle ? setStyle(data, style) : { ...data, style };\n      sceneRef.current.update(nid, { data });\n    },\n  });\n\n  const onDoubleClick = useCallback((e: MouseEvent<HTMLElement>) => {\n    // The dblclick bubbles from the canvas up to any wrapping container; the\n    // element it started on is what the click coordinates are relative to.\n    const canvas = e.target instanceof HTMLElement ? e.target : null;\n    if (!canvas) return;\n    // Inside the editor a double-click selects a word, and its target is a run\n    // span whose box the click would be measured against as if it were a canvas.\n    if (canvas.closest('[contenteditable=\"true\"]')) return;\n\n    // The click is un-projected here; `textHitAt` takes it back through the\n    // frame the node is drawn in.\n    const [canvasX, canvasY] = clientToCanvas(canvas, e.clientX, e.clientY);\n    const root = containerRef.current;\n    const view = resolveView(optsRef.current.view)\n      ?? (root ? findMountedCanvas(root, canvas)?.getView() : undefined);\n    const cx = view ? canvasX / view.scale.x + view.x : canvasX;\n    const cy = view ? canvasY / view.scale.y + view.y : canvasY;\n    const hit = textHitAt(sceneRef.current, read, cx, cy);\n    if (!hit) return;\n    openedOnRef.current = canvas;\n    edit.startEdit(hit.id, { caret: hit.caret });\n  }, [edit, containerRef, optsRef, read, sceneRef]);\n\n  const isTextNode = useCallback((id: string): boolean => {\n    const node = sceneRef.current.get(asNodeId(id));\n    return node !== undefined && read.isText(node.data);\n  }, [read, sceneRef]);\n\n  const drawOne = useMemo(() => drawOneEditing(edit.editingId), [edit.editingId]);\n  return { ...edit, onDoubleClick, isTextNode, drawOne };\n}\n\n/** The overlay's pose for a node painted at `painted`: its text box, inset\n *  about the box center, which is all the overlay's frame needs, projected\n *  through `view`. */\nfunction screenPoseOf<TData extends DefaultTextData>(\n  d: TData,\n  painted: RectPose,\n  read: ReturnType<typeof projectionsOf<TData>>,\n  view: View | undefined,\n  origin: TextEditClipRect | undefined,\n  defaultFontSize = 16,\n): TextEditScreenPose {\n  const inset = textBoxOf({ padding: read.padding(d) }, painted);\n  const box = screenBoxOf({ ...painted, ...inset }, view, origin);\n  return {\n    ...box,\n    // Against `zoom`, the same factor the overlay scales back up by, so a\n    // `{ px }` size arrives on screen at the pixel count it names.\n    fontSize: resolveScreenLength(read.style(d)?.fontSize ?? defaultFontSize, box.zoom),\n    verticalAlign: read.verticalAlign(d),\n    ...(read.overflow(d) === 'clip' ? { clip: clipToBox(inset, painted) } : {}),\n  };\n}\n\n/** How far `box` reaches past `inner` on each side: the overlay's cut at\n *  `box` when its own pose is `inner`. */\nfunction clipToBox(inner: RectPose, box: RectPose): NonNullable<TextEditScreenPose['clip']> {\n  return {\n    top: inner.y - box.y,\n    left: inner.x - box.x,\n    bottom: box.y + box.height - (inner.y + inner.height),\n    right: box.x + box.width - (inner.x + inner.width),\n  };\n}\n\n/**\n * `pose`'s box as the overlay takes it, `origin` being the canvas's corner in\n * container pixels. Only the box center is projected, since the overlay's\n * frame is about it. Width and height stay in world units and reach the\n * screen through the overlay's own `scale(zoom)` — see\n * `TextEditScreenPose.zoom`.\n */\nfunction screenBoxOf(\n  pose: RectPose,\n  view: View | undefined,\n  origin: { x: number; y: number } | undefined,\n): Pick<TextEditScreenPose, 'x' | 'y' | 'width' | 'height' | 'frame'> & { zoom: number } {\n  const zoom = view ? view.scale.x : 1;\n  const zoomY = view ? view.scale.y : 1;\n  const cx = (origin?.x ?? 0) + (pose.x + pose.width / 2 - (view?.x ?? 0)) * zoom;\n  const cy = (origin?.y ?? 0) + (pose.y + pose.height / 2 - (view?.y ?? 0)) * zoomY;\n  return {\n    x: cx - (pose.width * zoom) / 2,\n    y: cy - (pose.height * zoom) / 2,\n    width: pose.width,\n    height: pose.height,\n    zoom,\n    frame: frameLinearOf(pose, zoomY / zoom),\n  };\n}\n\n/** The linear part of the frame `pose` is drawn in, as the overlay takes it.\n *  `stretch` is the view's y scale over its x scale: the overlay scales both\n *  axes by the x scale, so the frame carries what is left of y. */\nfunction frameLinearOf(pose: unknown, stretch: number): TextEditScreenPose['frame'] {\n  const m = poseFrameOf(pose);\n  if (!m && stretch === 1) return undefined;\n  const [a, b, c, d] = m ?? [1, 0, 0, 1];\n  return [a, b * stretch, c, d * stretch];\n}\n"],"mappings":"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"}
+{"version":3,"file":"useSceneTextEdit.js","names":[],"sources":["../../../src/features/text/useSceneTextEdit.ts"],"sourcesContent":["/**\n * `useSceneTextEdit` — scene-aware wrapper around `useTextEdit`: scene\n * lookups for text / style / runs / screen-pose, and\n * `scene.update(id, { data })` for commits. The overlay and a double-click\n * both read the pose a node is painted at, so text inside a container whose\n * pose is a frame is edited where it is drawn.\n *\n * Defaults assume the node's `data` carries `text` / `style` / `runs`\n * directly. For custom data shapes, override any of the optional projections.\n * Consumers with non-rect poses should drop down to raw `useTextEdit` and\n * supply their own `getScreenPose`.\n */\nimport { useCallback, useEffect, useMemo, useRef, type MouseEvent } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { asNodeId } from '../../core/scene/types';\nimport { scenePaintedPoseOf } from '../../canvas/derivedPath';\nimport type { Scene } from '../../core/scene/types';\nimport { drawOneEditing, type EditingDrawOne } from './editingDrawOne';\nimport { textHitAt } from './textHitAt';\nimport { editedData, sceneTextDrafts } from './sceneTextDrafts';\nimport type { Stroke, Fill, Inherit } from '@weasel-js/paint';\nimport { resolveScreenLength } from '@weasel-js/paint';\nimport { inheritedPaintIn } from '../../canvas/inheritedPaints';\nimport { withInheritedPaint } from '../../core/scene/inheritedPaint';\nimport { clientToCanvas } from '@weasel-js/routing';\nimport { findMountedCanvas, type MountedCanvas } from '../../canvas/mountedCanvases';\nimport type { View } from '../../core/viewport/view';\nimport type { RectPose } from 'core/geometry/unionBounds';\nimport { poseFrameOf } from '@weasel-js/geom';\nimport { isTextData, type StyledRun, type TextPaint, type TextStyle, type TextVerticalAlign } from '@weasel-js/text';\nimport { textBoxOf, type TextOverflow } from '../../canvas/nodeShapes/textPainter';\nimport { useTextEdit, type TextEditClipRect, type TextEditScreenPose, type UseTextEditReturn } from '@weasel-js/text-dom';\n\n/** Shape the default projections expect `data` to satisfy. All fields\n *  optional so any object satisfies the constraint — projections fill in\n *  the gaps for non-default shapes. */\nexport interface DefaultTextData {\n  text?: string;\n  style?: TextStyle;\n  runs?: readonly StyledRun[];\n  fill?: Fill | Inherit | null;\n  stroke?: Stroke | Inherit | null;\n  verticalAlign?: TextVerticalAlign;\n  padding?: number;\n  overflow?: TextOverflow;\n}\n\n/** All-optional projections + fontSize fallback. */\nexport interface UseSceneTextEditOptions<TData> {\n  /**\n   * Is this node text? A double-click opens an edit only on a node that\n   * answers yes, and passes through any other to the text under it. Default:\n   * `isTextData`, the test `inferredNodeRouting` classifies a text node by. Pass one when `getText` reads some other shape.\n   */\n  isText?: (data: TData) => boolean;\n  /** Read plain text from `data`. Default: `data.text ?? ''`. */\n  getText?: (data: TData) => string;\n  /** Read style from `data`. Default: `data.style`. */\n  getStyle?: (data: TData) => TextStyle | undefined;\n  /** Read the node's paint from `data`. Default: `data.fill` / `data.stroke`. */\n  getPaint?: (data: TData) => TextPaint | undefined;\n  /** Read rich-text runs from `data`. Default: `data.runs`. */\n  getRuns?: (data: TData) => readonly StyledRun[] | undefined;\n  /** Read the box vertical alignment from `data`. Default: `data.verticalAlign`. */\n  getVerticalAlign?: (data: TData) => TextVerticalAlign | undefined;\n  /** Read the inset from the node's box to its text from `data`. Default: `data.padding`. */\n  getPadding?: (data: TData) => number | undefined;\n  /** Read whether the node cuts its text at its box from `data`, which the\n   *  overlay then does too. Default: `data.overflow`. */\n  getOverflow?: (data: TData) => TextOverflow | undefined;\n  /** Produce updated data with new text. Default: `{ ...data, text }`. */\n  setText?: (data: TData, text: string) => TData;\n  /** Produce updated data with new runs. Default: `{ ...data, runs }`. */\n  setRuns?: (data: TData, runs: StyledRun[]) => TData;\n  /**\n   * Produce updated data with a new node-wide style. Default:\n   * `{ ...data, style }`. Written only when a range toggle has to *clear* a\n   * flag the node itself sets — the run algebra is additive, so that edit\n   * lowers the node flag and raises it on the runs outside the range. See\n   * `useTextEdit`'s `setStyle`.\n   *\n   * An edit's text, runs, and style are folded through these three and\n   * written as one `scene.update`, so a commit is one undo step.\n   */\n  setStyle?: (data: TData, style: TextStyle) => TData;\n  /** Fallback fontSize when `style.fontSize` is unset. Default `16`. */\n  defaultFontSize?: number;\n  /**\n   * The view to project through. Omit it and the view is read live from the\n   * weasel canvas mounted inside `container` (the one a double-click landed\n   * on, when there are several). With no canvas there, the node's world box\n   * is passed through as screen pixels.\n   *\n   * A thunk is re-read on every projection; a plain `View` is the value from\n   * the render that supplied it.\n   */\n  view?: View | (() => View);\n  /**\n   * Forwarded to `useTextEdit`: is `el` part of the editor's own chrome?\n   * Focus moving into it does not end the edit. Wire it to whatever renders\n   * the character controls.\n   */\n  isEditorChrome?: (el: Element) => boolean;\n  /** Forwarded to `useTextEdit`: what Escape does to the edit. */\n  escape?: 'cancel' | 'commit';\n  /** Forwarded to `useTextEdit`: how long an edit waits for its face. */\n  fontHold?: number;\n  /** Forwarded to `useTextEdit`: called as an edit of the node `id` opens,\n   *  whichever way it was started. */\n  onStart?: (id: string) => void;\n  /** Forwarded to `useTextEdit`: called as the edit of `id` closes, after\n   *  any commit has been written to the scene. */\n  onEnd?: (id: string) => void;\n}\n\nfunction resolveView(view: View | (() => View) | undefined): View | undefined {\n  return typeof view === 'function' ? view() : view;\n}\n\n/** Return shape extends `UseTextEditReturn` with an `onDoubleClick`\n *  binding for the canvas container. Double-clicking inside a text\n *  node enters edit mode with the caret seeded at the clicked glyph. */\nexport interface UseSceneTextEditReturn extends UseTextEditReturn {\n  /** Bind to the element wrapping `<SceneCanvas>` (the same element\n   *  passed as `container`, or any ancestor that receives the dblclick\n   *  bubble). Starts an edit on the top-most text node under the cursor. */\n  onDoubleClick: (e: MouseEvent<HTMLElement>) => void;\n  /** The `isText` option asked of the node with this id: what\n   *  `TextEditDep.isTextNode` wants, so both ways into an edit agree. */\n  isTextNode: (id: string) => boolean;\n  /**\n   * `defaultDrawOne`, less the glyphs of the node being edited: the overlay\n   * stands in for its text, and the rest of the node, a `background` among\n   * it, goes on painting. Pass it as `layers.scene.drawOne`, with\n   * `paintBounds: defaultPaintBounds`, in place of an `alphaFor` that hides\n   * the whole node.\n   */\n  drawOne: EditingDrawOne;\n}\n\n/** How each field is read from a node's `data`: the option's projection, else the default shape. */\nfunction projectionsOf<TData extends DefaultTextData>(opts: { readonly current: UseSceneTextEditOptions<TData> }) {\n  return {\n    isText: (data: TData): boolean =>\n      opts.current.isText ? opts.current.isText(data) : isTextData(data),\n    text: (data: TData): string =>\n      opts.current.getText ? opts.current.getText(data) : (data.text ?? ''),\n    style: (data: TData): TextStyle | undefined =>\n      opts.current.getStyle ? opts.current.getStyle(data) : data.style,\n    runs: (data: TData): readonly StyledRun[] | undefined =>\n      opts.current.getRuns ? opts.current.getRuns(data) : data.runs,\n    verticalAlign: (data: TData): TextVerticalAlign | undefined =>\n      opts.current.getVerticalAlign ? opts.current.getVerticalAlign(data) : data.verticalAlign,\n    padding: (data: TData): number | undefined =>\n      opts.current.getPadding ? opts.current.getPadding(data) : data.padding,\n    overflow: (data: TData): TextOverflow | undefined =>\n      opts.current.getOverflow ? opts.current.getOverflow(data) : data.overflow,\n  };\n}\n\n/** Wire double-click-to-edit text on a scene: mounts a DOM editing overlay\n *  over the node being edited and writes the result back as an undoable op. */\nexport function useSceneTextEdit<\n  TData extends DefaultTextData,\n  TLayer extends string,\n  TPose extends RectPose = RectPose,\n>(\n  scene: Scene<TData, TLayer, TPose>,\n  container: HTMLElement | null,\n  options: UseSceneTextEditOptions<TData> = {},\n): UseSceneTextEditReturn {\n  // Refs, so the useTextEdit callbacks always see the current values\n  // without re-binding.\n  const sceneRef = useLatest(scene);\n  const optsRef = useLatest(options);\n  const containerRef = useLatest(container);\n  // The last double-click's target, so the overlay projects through the\n  // canvas the edit was opened on.\n  const openedOnRef = useRef<EventTarget | null>(null);\n  const drafts = useMemo(() => sceneTextDrafts(sceneRef, optsRef), [sceneRef, optsRef]);\n  useEffect(() => () => drafts.close(), [drafts]);\n\n  // The canvas's box in container pixels is both the origin its view projects\n  // from and the region its glyphs are clipped to.\n  const surface = (): { canvas: MountedCanvas; box: TextEditClipRect } | null => {\n    const root = containerRef.current;\n    const canvas = root ? findMountedCanvas(root, openedOnRef.current) : null;\n    if (!root || !canvas) return null;\n    const a = canvas.element.getBoundingClientRect();\n    const b = root.getBoundingClientRect();\n    return {\n      canvas,\n      box: {\n        x: a.left - b.left - root.clientLeft + root.scrollLeft,\n        y: a.top - b.top - root.clientTop + root.scrollTop,\n        width: a.width,\n        height: a.height,\n      },\n    };\n  };\n\n  const read = useMemo(() => projectionsOf(optsRef), [optsRef]);\n\n  const edit = useTextEdit({\n    container,\n    isEditorChrome: (el) => optsRef.current.isEditorChrome?.(el) ?? false,\n    escape: options.escape,\n    fontHold: options.fontHold,\n    onStart: (id) => optsRef.current.onStart?.(id),\n    onEnd: (id) => {\n      drafts.end(id);\n      optsRef.current.onEnd?.(id);\n    },\n    onDraft: drafts.draft,\n    getText: (id) => {\n      const node = sceneRef.current.get(asNodeId(id));\n      return node ? read.text(node.data) : '';\n    },\n    getStyle: (id) => {\n      const node = sceneRef.current.get(asNodeId(id));\n      return node ? read.style(node.data) : undefined;\n    },\n    getPaint: (id) => {\n      const node = sceneRef.current.get(asNodeId(id));\n      if (!node) return undefined;\n      const get = optsRef.current.getPaint;\n      return get ? get(node.data) : shownTextPaint(sceneRef.current, node);\n    },\n    getScreenPose: (id) => {\n      const scene = sceneRef.current;\n      const node = scene.get(asNodeId(id));\n      if (!node) return null;\n      const at = surface();\n      const view = resolveView(optsRef.current.view) ?? at?.canvas.getView();\n      return screenPoseOf(node.data, scenePaintedPoseOf(scene)(node), read, view, at?.box, optsRef.current.defaultFontSize);\n    },\n    getClipRect: () => surface()?.box ?? null,\n    getRuns: (id) => {\n      const node = sceneRef.current.get(asNodeId(id));\n      return node ? read.runs(node.data) : undefined;\n    },\n    commit: (id, { text, runs, style }) => {\n      const nid = asNodeId(id);\n      const node = sceneRef.current.get(nid);\n      if (!node) return;\n      drafts.commit(id, editedData(node.data, { text, runs, style }, optsRef.current));\n    },\n  });\n\n  const onDoubleClick = useCallback((e: MouseEvent<HTMLElement>) => {\n    // The dblclick bubbles from the canvas up to any wrapping container; the\n    // element it started on is what the click coordinates are relative to.\n    const canvas = e.target instanceof HTMLElement ? e.target : null;\n    if (!canvas) return;\n    // Inside the editor a double-click selects a word, and its target is a run\n    // span whose box the click would be measured against as if it were a canvas.\n    if (canvas.closest('[contenteditable=\"true\"]')) return;\n\n    // The click is un-projected here; `textHitAt` takes it back through the\n    // frame the node is drawn in.\n    const [canvasX, canvasY] = clientToCanvas(canvas, e.clientX, e.clientY);\n    const root = containerRef.current;\n    const view = resolveView(optsRef.current.view)\n      ?? (root ? findMountedCanvas(root, canvas)?.getView() : undefined);\n    const cx = view ? canvasX / view.scale.x + view.x : canvasX;\n    const cy = view ? canvasY / view.scale.y + view.y : canvasY;\n    const hit = textHitAt(sceneRef.current, read, cx, cy);\n    if (!hit) return;\n    openedOnRef.current = canvas;\n    edit.startEdit(hit.id, { caret: hit.caret });\n  }, [edit, containerRef, optsRef, read, sceneRef]);\n\n  const isTextNode = useCallback((id: string): boolean => {\n    const node = sceneRef.current.get(asNodeId(id));\n    return node !== undefined && read.isText(node.data);\n  }, [read, sceneRef]);\n\n  const drawOne = useMemo(() => drawOneEditing(edit.editingId), [edit.editingId]);\n  return { ...edit, onDoubleClick, isTextNode, drawOne };\n}\n\n/** The overlay's pose for a node painted at `painted`: its text box, inset\n *  about the box center, which is all the overlay's frame needs, projected\n *  through `view`. */\nfunction screenPoseOf<TData extends DefaultTextData>(\n  d: TData,\n  painted: RectPose,\n  read: ReturnType<typeof projectionsOf<TData>>,\n  view: View | undefined,\n  origin: TextEditClipRect | undefined,\n  defaultFontSize = 16,\n): TextEditScreenPose {\n  const inset = textBoxOf({ padding: read.padding(d) }, painted);\n  const box = screenBoxOf({ ...painted, ...inset }, view, origin);\n  return {\n    ...box,\n    // Against `zoom`, the same factor the overlay scales back up by, so a\n    // `{ px }` size arrives on screen at the pixel count it names.\n    fontSize: resolveScreenLength(read.style(d)?.fontSize ?? defaultFontSize, box.zoom),\n    verticalAlign: read.verticalAlign(d),\n    ...(read.overflow(d) === 'clip' ? { clip: clipToBox(inset, painted) } : {}),\n  };\n}\n\n/** How far `box` reaches past `inner` on each side: the overlay's cut at\n *  `box` when its own pose is `inner`. */\nfunction clipToBox(inner: RectPose, box: RectPose): NonNullable<TextEditScreenPose['clip']> {\n  return {\n    top: inner.y - box.y,\n    left: inner.x - box.x,\n    bottom: box.y + box.height - (inner.y + inner.height),\n    right: box.x + box.width - (inner.x + inner.width),\n  };\n}\n\n/**\n * `pose`'s box as the overlay takes it, `origin` being the canvas's corner in\n * container pixels. Only the box center is projected, since the overlay's\n * frame is about it. Width and height stay in world units and reach the\n * screen through the overlay's own `scale(zoom)` — see\n * `TextEditScreenPose.zoom`.\n */\nfunction screenBoxOf(\n  pose: RectPose,\n  view: View | undefined,\n  origin: { x: number; y: number } | undefined,\n): Pick<TextEditScreenPose, 'x' | 'y' | 'width' | 'height' | 'frame'> & { zoom: number } {\n  const zoom = view ? view.scale.x : 1;\n  const zoomY = view ? view.scale.y : 1;\n  const cx = (origin?.x ?? 0) + (pose.x + pose.width / 2 - (view?.x ?? 0)) * zoom;\n  const cy = (origin?.y ?? 0) + (pose.y + pose.height / 2 - (view?.y ?? 0)) * zoomY;\n  return {\n    x: cx - (pose.width * zoom) / 2,\n    y: cy - (pose.height * zoom) / 2,\n    width: pose.width,\n    height: pose.height,\n    zoom,\n    frame: frameLinearOf(pose, zoomY / zoom),\n  };\n}\n\n/** The linear part of the frame `pose` is drawn in, as the overlay takes it.\n *  `stretch` is the view's y scale over its x scale: the overlay scales both\n *  axes by the x scale, so the frame carries what is left of y. */\nfunction frameLinearOf(pose: unknown, stretch: number): TextEditScreenPose['frame'] {\n  const m = poseFrameOf(pose);\n  if (!m && stretch === 1) return undefined;\n  const [a, b, c, d] = m ?? [1, 0, 0, 1];\n  return [a, b * stretch, c, d * stretch];\n}\n\n/** A text node's paint as the canvas paints it: an inherited one is its container's. */\nfunction shownTextPaint<TData extends DefaultTextData>(\n  scene: Scene<TData, string, unknown>,\n  node: NonNullable<ReturnType<Scene<TData, string, unknown>['get']>>,\n): TextPaint {\n  const { fill, stroke } = withInheritedPaint(node.data, inheritedPaintIn(scene, node));\n  return { fill, stroke };\n}\n"],"mappings":"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"}

package/dist/features/viewports/aim.js

@@ -0,0 +1,105 @@
+import { ZOOM_FLOOR } from "../../core/viewport/zoomBounds.js";
+import { normalizeView } from "../../core/viewport/view.js";
+import { fitViewToBounds } from "../../core/viewport/fitViewToBounds.js";
+
+//#region src/features/viewports/aim.ts
+/** The aim of view `viewId` (`null`: a surface's root) showing world rect `rect`. */
+function rectAim(viewId, rect) {
+	return {
+		viewId,
+		kind: "rect",
+		extent: rect,
+		outlineIn(space) {
+			const { x, y, width, height } = rect;
+			const out = [];
+			for (const corner of [
+				{
+					x,
+					y
+				},
+				{
+					x: x + width,
+					y
+				},
+				{
+					x: x + width,
+					y: y + height
+				},
+				{
+					x,
+					y: y + height
+				}
+			]) {
+				const p = space.project(corner);
+				if (!p) return null;
+				out.push(p);
+			}
+			return out;
+		},
+		pannedIn(space, from, to) {
+			const a = space.unproject(from);
+			const b = space.unproject(to);
+			if (!a || !b) return null;
+			return rectAim(viewId, {
+				...rect,
+				x: rect.x + (b.x - a.x),
+				y: rect.y + (b.y - a.y)
+			});
+		}
+	};
+}
+/** Whether `aim` is core's 2D rect aim, so its `extent` is a world rect. */
+function isRectAim(aim) {
+	return aim.kind === "rect";
+}
+/** A 2D view's frame: `view` is its camera and `size` its frame; frame px are measured from the frame's top-left. */
+function aimSpace2d(viewId, view, size) {
+	return {
+		viewId,
+		kind: "2d",
+		size: {
+			width: size.width,
+			height: size.height
+		},
+		project: (p) => ({
+			x: (p.x - view.x) * view.scale.x,
+			y: (p.y - view.y) * view.scale.y
+		}),
+		unproject: (px) => ({
+			x: px.x / view.scale.x + view.x,
+			y: px.y / view.scale.y + view.y
+		})
+	};
+}
+var UNUSED_CURRENT = {
+	x: 0,
+	y: 0,
+	scale: {
+		x: 1,
+		y: 1
+	}
+};
+/**
+* The camera that shows `rect` in a frame of `size`: `'exact'` per axis (the inverse of `viewportWorldRect`),
+* `'contain'` uniform and centered. Not clamped to a zoom range, and finite for an empty rect or frame. Normalized.
+*/
+function viewForAim(rect, size, fit) {
+	if (!(rect.width > 0 && rect.height > 0 && size.width > 0 && size.height > 0)) return normalizeView({
+		x: rect.x,
+		y: rect.y,
+		scale: {
+			x: ZOOM_FLOOR,
+			y: ZOOM_FLOOR
+		}
+	});
+	return normalizeView(fitViewToBounds(rect, size, UNUSED_CURRENT, {
+		mode: fit === "exact" ? "stretch" : "contain",
+		padding: 0,
+		minScale: 0,
+		maxScale: Infinity
+	}));
+}
+
+//#endregion
+export { aimSpace2d, isRectAim, rectAim, viewForAim };
+//# sourceMappingURL=aim.js.map

package/dist/features/viewports/aim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aim.js","names":[],"sources":["../../../src/features/viewports/aim.ts"],"sourcesContent":["import { fitViewToBounds, type Bounds } from 'core/viewport/fitViewToBounds';\nimport type { Dims } from 'core/layers/render';\nimport { normalizeView, type View } from 'core/viewport/view';\nimport { ZOOM_FLOOR } from 'core/viewport/zoomBounds';\n\n/** A point in a view's world. A 2D world is the plane z = 0, so `z` is absent there. */\nexport interface AimPoint {\n  x: number;\n  y: number;\n  z?: number;\n}\n\n/** A closed outline in a frame's CSS px, from the frame's top-left; at least 3 points. */\nexport type AimOutline = readonly { x: number; y: number }[];\n\n/** A target view, as an aim is drawn into it: its world, and its frame. */\nexport interface AimSpace {\n  /** The view whose frame this is; `null` for a surface's root view. */\n  readonly viewId: string | null;\n  /** `'2d'` for core's views; any other value is its owner's (kernel3d: `'3d'`). */\n  readonly kind: string;\n  readonly size: { width: number; height: number };\n  /** World point to frame px; `null` where the point does not draw (behind a 3D camera). */\n  project(p: AimPoint): { x: number; y: number } | null;\n  /** Frame px to the world point under it; `null` where there is none (a 3D ray missing its plane). */\n  unproject(px: { x: number; y: number }): AimPoint | null;\n}\n\n/** What a viewport shows, read in the world of the view it names. */\nexport interface ViewAim<TExtent = unknown> {\n  readonly viewId: string | null;\n  /** Discriminates `extent`: `'rect'` for core's 2D views. */\n  readonly kind: string;\n  /** Where the aim lies in its world, in its owner's own terms. */\n  readonly extent: TExtent;\n  /** The aim's outline in `space`'s frame, or `null` when it cannot be drawn there. */\n  outlineIn(space: AimSpace): AimOutline | null;\n  /** This aim moved so the world point under frame px `from` in `space` ends up under `to`; `null` when either misses. */\n  pannedIn(space: AimSpace, from: { x: number; y: number }, to: { x: number; y: number }): ViewAim<TExtent> | null;\n}\n\n/** Core's 2D aim: a world rect a view shows. */\nexport type RectAim = ViewAim<Bounds> & { readonly kind: 'rect' };\n\n/** The aim of view `viewId` (`null`: a surface's root) showing world rect `rect`. */\nexport function rectAim(viewId: string | null, rect: Bounds): RectAim {\n  return {\n    viewId,\n    kind: 'rect',\n    extent: rect,\n    outlineIn(space) {\n      const { x, y, width, height } = rect;\n      const out: { x: number; y: number }[] = [];\n      for (const corner of [\n        { x, y },\n        { x: x + width, y },\n        { x: x + width, y: y + height },\n        { x, y: y + height },\n      ]) {\n        const p = space.project(corner);\n        if (!p) return null;\n        out.push(p);\n      }\n      return out;\n    },\n    pannedIn(space, from, to) {\n      const a = space.unproject(from);\n      const b = space.unproject(to);\n      if (!a || !b) return null;\n      return rectAim(viewId, { ...rect, x: rect.x + (b.x - a.x), y: rect.y + (b.y - a.y) });\n    },\n  };\n}\n\n/** Whether `aim` is core's 2D rect aim, so its `extent` is a world rect. */\nexport function isRectAim(aim: ViewAim): aim is RectAim {\n  return aim.kind === 'rect';\n}\n\n/** A 2D view's frame: `view` is its camera and `size` its frame; frame px are measured from the frame's top-left. */\nexport function aimSpace2d(viewId: string | null, view: View, size: Dims): AimSpace {\n  return {\n    viewId,\n    kind: '2d',\n    size: { width: size.width, height: size.height },\n    project: (p) => ({ x: (p.x - view.x) * view.scale.x, y: (p.y - view.y) * view.scale.y }),\n    unproject: (px) => ({ x: px.x / view.scale.x + view.x, y: px.y / view.scale.y + view.y }),\n  };\n}\n\nconst UNUSED_CURRENT: View = { x: 0, y: 0, scale: { x: 1, y: 1 } };\n\n/**\n * The camera that shows `rect` in a frame of `size`: `'exact'` per axis (the inverse of `viewportWorldRect`),\n * `'contain'` uniform and centered. Not clamped to a zoom range, and finite for an empty rect or frame. Normalized.\n */\nexport function viewForAim(rect: Bounds, size: Dims, fit: 'exact' | 'contain'): View {\n  if (!(rect.width > 0 && rect.height > 0 && size.width > 0 && size.height > 0)) {\n    return normalizeView({ x: rect.x, y: rect.y, scale: { x: ZOOM_FLOOR, y: ZOOM_FLOOR } });\n  }\n  return normalizeView(fitViewToBounds(rect, size, UNUSED_CURRENT, {\n    mode: fit === 'exact' ? 'stretch' : 'contain', padding: 0, minScale: 0, maxScale: Infinity,\n  }));\n}\n"],"mappings":";;;;;;AA6CA,SAAgB,QAAQ,QAAuB,MAAuB;CACpE,OAAO;EACL;EACA,MAAM;EACN,QAAQ;EACR,UAAU,OAAO;GACf,MAAM,EAAE,GAAG,GAAG,OAAO,WAAW;GAChC,MAAM,MAAkC,CAAC;GACzC,KAAK,MAAM,UAAU;IACnB;KAAE;KAAG;IAAE;IACP;KAAE,GAAG,IAAI;KAAO;IAAE;IAClB;KAAE,GAAG,IAAI;KAAO,GAAG,IAAI;IAAO;IAC9B;KAAE;KAAG,GAAG,IAAI;IAAO;GACrB,GAAG;IACD,MAAM,IAAI,MAAM,QAAQ,MAAM;IAC9B,IAAI,CAAC,GAAG,OAAO;IACf,IAAI,KAAK,CAAC;GACZ;GACA,OAAO;EACT;EACA,SAAS,OAAO,MAAM,IAAI;GACxB,MAAM,IAAI,MAAM,UAAU,IAAI;GAC9B,MAAM,IAAI,MAAM,UAAU,EAAE;GAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,OAAO;GACrB,OAAO,QAAQ,QAAQ;IAAE,GAAG;IAAM,GAAG,KAAK,KAAK,EAAE,IAAI,EAAE;IAAI,GAAG,KAAK,KAAK,EAAE,IAAI,EAAE;GAAG,CAAC;EACtF;CACF;AACF;;AAGA,SAAgB,UAAU,KAA8B;CACtD,OAAO,IAAI,SAAS;AACtB;;AAGA,SAAgB,WAAW,QAAuB,MAAY,MAAsB;CAClF,OAAO;EACL;EACA,MAAM;EACN,MAAM;GAAE,OAAO,KAAK;GAAO,QAAQ,KAAK;EAAO;EAC/C,UAAU,OAAO;GAAE,IAAI,EAAE,IAAI,KAAK,KAAK,KAAK,MAAM;GAAG,IAAI,EAAE,IAAI,KAAK,KAAK,KAAK,MAAM;EAAE;EACtF,YAAY,QAAQ;GAAE,GAAG,GAAG,IAAI,KAAK,MAAM,IAAI,KAAK;GAAG,GAAG,GAAG,IAAI,KAAK,MAAM,IAAI,KAAK;EAAE;CACzF;AACF;AAEA,IAAM,iBAAuB;CAAE,GAAG;CAAG,GAAG;CAAG,OAAO;EAAE,GAAG;EAAG,GAAG;CAAE;AAAE;;;;;AAMjE,SAAgB,WAAW,MAAc,MAAY,KAAgC;CACnF,IAAI,EAAE,KAAK,QAAQ,KAAK,KAAK,SAAS,KAAK,KAAK,QAAQ,KAAK,KAAK,SAAS,IACzE,OAAO,cAAc;EAAE,GAAG,KAAK;EAAG,GAAG,KAAK;EAAG,OAAO;GAAE,GAAG;GAAY,GAAG;EAAW;CAAE,CAAC;CAExF,OAAO,cAAc,gBAAgB,MAAM,MAAM,gBAAgB;EAC/D,MAAM,QAAQ,UAAU,YAAY;EAAW,SAAS;EAAG,UAAU;EAAG,UAAU;CACpF,CAAC,CAAC;AACJ"}

package/dist/features/viewports/viewMarker.js

@@ -0,0 +1,82 @@
+import { aimSpace2d } from "./aim.js";
+import { pointInPolygon, pointSegmentDist2, polygonFromPoints } from "@weasel-js/geom";
+
+//#region src/features/viewports/viewMarker.ts
+/** The marker style a {@link ViewMarkerProps.style} fills in from: the minimap indicator's. */
+var VIEW_MARKER_DEFAULT_STYLE = {
+	stroke: "#ffffff",
+	width: 1,
+	dash: [2, 3]
+};
+/** The aim `source` names: a view's through `host`, or one handed in by value. */
+function markerSourceAim(source, host) {
+	return source === null || typeof source === "string" ? host.aimOf(source) : source.aim();
+}
+/** A screen-space layer, id `view-marker:<id>`, drawing `props`'s source aim in the frame it is handed. */
+function createViewMarkerLayer(props, host) {
+	const { id } = props();
+	return {
+		id: `view-marker:${id}`,
+		label: `View marker ${id}`,
+		space: "screen",
+		draw: (_data, view, dims) => {
+			const { source, target, style } = props();
+			if (source === target) return [];
+			const outline = markerSourceAim(source, host)?.outlineIn(aimSpace2d(target, view, dims));
+			if (!outline) return [];
+			const d = VIEW_MARKER_DEFAULT_STYLE;
+			return [{
+				kind: "path",
+				path: polygonFromPoints(outline),
+				stroke: {
+					paint: {
+						kind: "solid",
+						color: style?.stroke ?? d.stroke
+					},
+					width: style?.width ?? d.width,
+					dash: [...style?.dash ?? d.dash]
+				}
+			}];
+		}
+	};
+}
+/** A press this many screen px outside the outline still counts. */
+var VIEW_MARKER_HIT_SLOP_PX = 4;
+/**
+* The grab for a press at frame px `at` in `space`, the marker's target, or
+* `null` when the marker is not interactive, its source has no writer or no
+* aim, or `at` is not on its outline or within {@link VIEW_MARKER_HIT_SLOP_PX} of it. A surface with views
+* calls this itself; a canvas with none, such as a detached minimap, calls it to route a press to its marker.
+*/
+function grabViewMarker(props, host, space, at) {
+	const { id, source, target, interactive } = props;
+	if (interactive === false || source === target) return null;
+	const write = source === null || typeof source === "string" ? (aim) => {
+		host.setAim(source, aim);
+	} : source.setAim?.bind(source);
+	if (!write) return null;
+	const startAim = markerSourceAim(source, host);
+	const outline = startAim?.outlineIn(space);
+	if (!startAim || !outline || !outlineHolds(outline, at, VIEW_MARKER_HIT_SLOP_PX)) return null;
+	return {
+		markerId: id,
+		moveTo: (world) => {
+			const to = space.project(world);
+			const next = to && startAim.pannedIn(space, at, to);
+			if (next) write(next);
+		}
+	};
+}
+function outlineHolds(outline, p, slop) {
+	if (pointInPolygon(outline.flatMap((q) => [q.x, q.y]), p.x, p.y)) return true;
+	for (let i = 0; i < outline.length; i++) {
+		const a = outline[i];
+		const b = outline[(i + 1) % outline.length];
+		if (pointSegmentDist2(p.x, p.y, a.x, a.y, b.x, b.y) <= slop * slop) return true;
+	}
+	return false;
+}
+
+//#endregion
+export { VIEW_MARKER_DEFAULT_STYLE, VIEW_MARKER_HIT_SLOP_PX, createViewMarkerLayer, grabViewMarker, markerSourceAim };
+//# sourceMappingURL=viewMarker.js.map

package/dist/features/viewports/viewMarker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewMarker.js","names":[],"sources":["../../../src/features/viewports/viewMarker.ts"],"sourcesContent":["import { pointInPolygon, pointSegmentDist2, polygonFromPoints } from '@weasel-js/geom';\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport type { RenderLayer } from 'core/layers/render';\nimport { aimSpace2d, type AimOutline, type AimSpace, type ViewAim } from './aim';\n\n/** An aim handed in by value (another surface's view, a 3D pane), with the writer that moves it. */\nexport interface AimSource {\n  aim(): ViewAim | null;\n  setAim?(aim: ViewAim): void;\n}\n\n/** How a marker's outline is stroked, in screen px. */\nexport interface ViewMarkerStyle {\n  stroke?: string;\n  width?: number;\n  dash?: readonly number[];\n}\n\n/** One view's aim, drawn inside another view's frame. */\nexport interface ViewMarkerProps {\n  /** Unique among the markers on one surface. */\n  id: string;\n  /** Whose aim: a view id on this surface, `null` for the root view, or an aim by value. */\n  source: string | null | AimSource;\n  /** Whose frame it is drawn in, after that view's layers: a view id, or `null` for the root. */\n  target: string | null;\n  /** Screen px. Default: stroke `#ffffff`, width 1, dash [2, 3]. */\n  style?: ViewMarkerStyle;\n  /** Default true: dragging the marker edits the source's aim. A source with no writer is never interactive.\n   *  A marker grabs its whole interior plus {@link VIEW_MARKER_HIT_SLOP_PX}, so one covering much of its\n   *  frame takes every press there; `false` opts out. */\n  interactive?: boolean;\n}\n\n/** The marker style a {@link ViewMarkerProps.style} fills in from: the minimap indicator's. */\nexport const VIEW_MARKER_DEFAULT_STYLE: Required<ViewMarkerStyle> = { stroke: '#ffffff', width: 1, dash: [2, 3] };\n\n/** What a marker resolves aims through: the surface's views. */\nexport interface ViewMarkerHost {\n  aimOf(id: string | null): ViewAim | null;\n  setAim(id: string | null, aim: ViewAim): boolean;\n}\n\n/** The aim `source` names: a view's through `host`, or one handed in by value. */\nexport function markerSourceAim(source: ViewMarkerProps['source'], host: ViewMarkerHost): ViewAim | null {\n  return source === null || typeof source === 'string' ? host.aimOf(source) : source.aim();\n}\n\n/** A screen-space layer, id `view-marker:<id>`, drawing `props`'s source aim in the frame it is handed. */\nexport function createViewMarkerLayer(props: () => ViewMarkerProps, host: ViewMarkerHost): RenderLayer<unknown> {\n  const { id } = props();\n  return {\n    id: `view-marker:${id}`,\n    label: `View marker ${id}`,\n    space: 'screen',\n    draw: (_data, view, dims): DrawCommand[] => {\n      const { source, target, style } = props();\n      if (source === target) return [];\n      const aim = markerSourceAim(source, host);\n      const outline = aim?.outlineIn(aimSpace2d(target, view, dims));\n      if (!outline) return [];\n      const d = VIEW_MARKER_DEFAULT_STYLE;\n      return [{\n        kind: 'path',\n        path: polygonFromPoints(outline),\n        stroke: {\n          paint: { kind: 'solid', color: style?.stroke ?? d.stroke },\n          width: style?.width ?? d.width,\n          dash: [...(style?.dash ?? d.dash)],\n        },\n      }];\n    },\n  };\n}\n\n/** A press on a marker, held for the drag: where it started, and the aim it started from. */\nexport interface ViewMarkerGrab {\n  readonly markerId: string;\n  /** Pan the source so the world point under the press ends up under `world`, a point in the target's world. */\n  moveTo(world: { x: number; y: number }): void;\n}\n\n/** A press this many screen px outside the outline still counts. */\nexport const VIEW_MARKER_HIT_SLOP_PX = 4;\n\n/**\n * The grab for a press at frame px `at` in `space`, the marker's target, or\n * `null` when the marker is not interactive, its source has no writer or no\n * aim, or `at` is not on its outline or within {@link VIEW_MARKER_HIT_SLOP_PX} of it. A surface with views\n * calls this itself; a canvas with none, such as a detached minimap, calls it to route a press to its marker.\n */\nexport function grabViewMarker(\n  props: ViewMarkerProps,\n  host: ViewMarkerHost,\n  space: AimSpace,\n  at: { x: number; y: number },\n): ViewMarkerGrab | null {\n  const { id, source, target, interactive } = props;\n  if (interactive === false || source === target) return null;\n  const write = source === null || typeof source === 'string'\n    ? (aim: ViewAim) => { host.setAim(source, aim); }\n    : source.setAim?.bind(source);\n  if (!write) return null;\n  const startAim = markerSourceAim(source, host);\n  const outline = startAim?.outlineIn(space);\n  if (!startAim || !outline || !outlineHolds(outline, at, VIEW_MARKER_HIT_SLOP_PX)) return null;\n  return {\n    markerId: id,\n    moveTo: (world) => {\n      const to = space.project(world);\n      const next = to && startAim.pannedIn(space, at, to);\n      if (next) write(next);\n    },\n  };\n}\n\nfunction outlineHolds(outline: AimOutline, p: { x: number; y: number }, slop: number): boolean {\n  if (pointInPolygon(outline.flatMap((q) => [q.x, q.y]), p.x, p.y)) return true;\n  for (let i = 0; i < outline.length; i++) {\n    const a = outline[i]!;\n    const b = outline[(i + 1) % outline.length]!;\n    if (pointSegmentDist2(p.x, p.y, a.x, a.y, b.x, b.y) <= slop * slop) return true;\n  }\n  return false;\n}\n"],"mappings":";;;;;AAmCA,IAAa,4BAAuD;CAAE,QAAQ;CAAW,OAAO;CAAG,MAAM,CAAC,GAAG,CAAC;AAAE;;AAShH,SAAgB,gBAAgB,QAAmC,MAAsC;CACvG,OAAO,WAAW,QAAQ,OAAO,WAAW,WAAW,KAAK,MAAM,MAAM,IAAI,OAAO,IAAI;AACzF;;AAGA,SAAgB,sBAAsB,OAA8B,MAA4C;CAC9G,MAAM,EAAE,OAAO,MAAM;CACrB,OAAO;EACL,IAAI,eAAe;EACnB,OAAO,eAAe;EACtB,OAAO;EACP,OAAO,OAAO,MAAM,SAAwB;GAC1C,MAAM,EAAE,QAAQ,QAAQ,UAAU,MAAM;GACxC,IAAI,WAAW,QAAQ,OAAO,CAAC;GAE/B,MAAM,UADM,gBAAgB,QAAQ,IACpB,CAAA,EAAK,UAAU,WAAW,QAAQ,MAAM,IAAI,CAAC;GAC7D,IAAI,CAAC,SAAS,OAAO,CAAC;GACtB,MAAM,IAAI;GACV,OAAO,CAAC;IACN,MAAM;IACN,MAAM,kBAAkB,OAAO;IAC/B,QAAQ;KACN,OAAO;MAAE,MAAM;MAAS,OAAO,OAAO,UAAU,EAAE;KAAO;KACzD,OAAO,OAAO,SAAS,EAAE;KACzB,MAAM,CAAC,GAAI,OAAO,QAAQ,EAAE,IAAK;IACnC;GACF,CAAC;EACH;CACF;AACF;;AAUA,IAAa,0BAA0B;;;;;;;AAQvC,SAAgB,eACd,OACA,MACA,OACA,IACuB;CACvB,MAAM,EAAE,IAAI,QAAQ,QAAQ,gBAAgB;CAC5C,IAAI,gBAAgB,SAAS,WAAW,QAAQ,OAAO;CACvD,MAAM,QAAQ,WAAW,QAAQ,OAAO,WAAW,YAC9C,QAAiB;EAAE,KAAK,OAAO,QAAQ,GAAG;CAAG,IAC9C,OAAO,QAAQ,KAAK,MAAM;CAC9B,IAAI,CAAC,OAAO,OAAO;CACnB,MAAM,WAAW,gBAAgB,QAAQ,IAAI;CAC7C,MAAM,UAAU,UAAU,UAAU,KAAK;CACzC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,aAAa,SAAS,IAAI,uBAAuB,GAAG,OAAO;CACzF,OAAO;EACL,UAAU;EACV,SAAS,UAAU;GACjB,MAAM,KAAK,MAAM,QAAQ,KAAK;GAC9B,MAAM,OAAO,MAAM,SAAS,SAAS,OAAO,IAAI,EAAE;GAClD,IAAI,MAAM,MAAM,IAAI;EACtB;CACF;AACF;AAEA,SAAS,aAAa,SAAqB,GAA6B,MAAuB;CAC7F,IAAI,eAAe,QAAQ,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO;CACzE,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;EACvC,MAAM,IAAI,QAAQ;EAClB,MAAM,IAAI,SAAS,IAAI,KAAK,QAAQ;EACpC,IAAI,kBAAkB,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,MAAM,OAAO;CAC7E;CACA,OAAO;AACT"}

package/dist/features/viewports/viewMarkerDrag.js

@@ -0,0 +1,55 @@
+import { hitPredicate } from "@weasel-js/gestures";
+
+//#region src/features/viewports/viewMarkerDrag.ts
+/** The action id a drag on a view marker routes to. */
+var VIEW_MARKER_DRAG = "view.marker.drag";
+/** The id of the entry {@link createViewMarkerContribution} builds. */
+var VIEW_MARKER_ENTRY_ID = "view-marker";
+var MARKER_KIND_PREFIX = "layer:view-marker:";
+function grabIn(affordance) {
+	return affordance?.payload ?? null;
+}
+/** Drags the grabbed marker. There is nothing to commit, so a cancel ends where a release does. */
+function viewMarkerDragAction() {
+	return {
+		id: VIEW_MARKER_DRAG,
+		label: "View marker — drag",
+		invoker: {
+			timing: "ongoing",
+			start: (ctx) => {
+				const grab = grabIn(ctx.drag?.affordance);
+				if (!grab) return {};
+				return {
+					kind: VIEW_MARKER_DRAG,
+					onMove: (m) => {
+						grab.moveTo(m.drag?.current ?? m.world);
+					}
+				};
+			}
+		}
+	};
+}
+/**
+* The always-on entry (id `'view-marker'`) that binds a drag on any marker to {@link VIEW_MARKER_DRAG}.
+* A `<SceneCanvas>` installs it unless `actions={null}` or a `tools` takeover leaves it out; to turn marker
+* dragging back on there, pass it in `ambient`, or in the takeover's own `useTools` ambient list.
+*/
+function createViewMarkerContribution() {
+	return {
+		id: VIEW_MARKER_ENTRY_ID,
+		eligibility: { always: true },
+		actions: [viewMarkerDragAction()],
+		bindings: [{
+			spec: {
+				kind: "drag",
+				target: { kindOf: hitPredicate((hit) => hit?.kind?.startsWith(MARKER_KIND_PREFIX) ?? false) }
+			},
+			actionId: VIEW_MARKER_DRAG,
+			opts: { id: "view-marker.drag" }
+		}]
+	};
+}
+
+//#endregion
+export { VIEW_MARKER_DRAG, VIEW_MARKER_ENTRY_ID, createViewMarkerContribution, viewMarkerDragAction };
+//# sourceMappingURL=viewMarkerDrag.js.map

package/dist/features/viewports/viewMarkerDrag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewMarkerDrag.js","names":[],"sources":["../../../src/features/viewports/viewMarkerDrag.ts"],"sourcesContent":["import { hitPredicate } from '@weasel-js/gestures';\nimport type { Action, InvocationCtx } from '@weasel-js/routing';\nimport type { SurfaceContribution } from 'canvas/surfaceContribution';\nimport type { ViewMarkerGrab } from './viewMarker';\n\n/** The action id a drag on a view marker routes to. */\nexport const VIEW_MARKER_DRAG = 'view.marker.drag';\n\n/** The id of the entry {@link createViewMarkerContribution} builds. */\nexport const VIEW_MARKER_ENTRY_ID = 'view-marker';\n\nconst MARKER_KIND_PREFIX = 'layer:view-marker:';\n\nfunction grabIn(affordance: unknown): ViewMarkerGrab | null {\n  return (affordance as { payload?: ViewMarkerGrab } | null | undefined)?.payload ?? null;\n}\n\n/** Drags the grabbed marker. There is nothing to commit, so a cancel ends where a release does. */\nexport function viewMarkerDragAction(): Action {\n  return {\n    id: VIEW_MARKER_DRAG,\n    label: 'View marker — drag',\n    invoker: {\n      timing: 'ongoing',\n      start: (ctx: InvocationCtx) => {\n        const grab = grabIn(ctx.drag?.affordance);\n        if (!grab) return {};\n        return {\n          kind: VIEW_MARKER_DRAG,\n          onMove: (m: InvocationCtx) => { grab.moveTo(m.drag?.current ?? m.world); },\n        };\n      },\n    },\n  };\n}\n\n/**\n * The always-on entry (id `'view-marker'`) that binds a drag on any marker to {@link VIEW_MARKER_DRAG}.\n * A `<SceneCanvas>` installs it unless `actions={null}` or a `tools` takeover leaves it out; to turn marker\n * dragging back on there, pass it in `ambient`, or in the takeover's own `useTools` ambient list.\n */\nexport function createViewMarkerContribution(): SurfaceContribution {\n  return {\n    id: VIEW_MARKER_ENTRY_ID,\n    eligibility: { always: true },\n    actions: [viewMarkerDragAction()],\n    bindings: [{\n      spec: {\n        kind: 'drag',\n        target: { kindOf: hitPredicate((hit) => (hit as { kind?: string } | null | undefined)?.kind?.startsWith(MARKER_KIND_PREFIX) ?? false) },\n      },\n      actionId: VIEW_MARKER_DRAG,\n      opts: { id: 'view-marker.drag' },\n    }],\n  };\n}\n"],"mappings":";;;;AAMA,IAAa,mBAAmB;;AAGhC,IAAa,uBAAuB;AAEpC,IAAM,qBAAqB;AAE3B,SAAS,OAAO,YAA4C;CAC1D,OAAQ,YAAgE,WAAW;AACrF;;AAGA,SAAgB,uBAA+B;CAC7C,OAAO;EACL,IAAI;EACJ,OAAO;EACP,SAAS;GACP,QAAQ;GACR,QAAQ,QAAuB;IAC7B,MAAM,OAAO,OAAO,IAAI,MAAM,UAAU;IACxC,IAAI,CAAC,MAAM,OAAO,CAAC;IACnB,OAAO;KACL,MAAM;KACN,SAAS,MAAqB;MAAE,KAAK,OAAO,EAAE,MAAM,WAAW,EAAE,KAAK;KAAG;IAC3E;GACF;EACF;CACF;AACF;;;;;;AAOA,SAAgB,+BAAoD;CAClE,OAAO;EACL,IAAI;EACJ,aAAa,EAAE,QAAQ,KAAK;EAC5B,SAAS,CAAC,qBAAqB,CAAC;EAChC,UAAU,CAAC;GACT,MAAM;IACJ,MAAM;IACN,QAAQ,EAAE,QAAQ,cAAc,QAAS,KAA8C,MAAM,WAAW,kBAAkB,KAAK,KAAK,EAAE;GACxI;GACA,UAAU;GACV,MAAM,EAAE,IAAI,mBAAmB;EACjC,CAAC;CACH;AACF"}