@weasel-js/core 1.9.4 → 1.10.0

package/dist/tools/builtin/slice/useSliceTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSliceTool.js","names":["VERTEX_RADIUS_PX","useSliceTool","scratchRef","useRef","optsRef","useLatest","options","live","useMemo","listeners","notify","fn","createPointerFollower","actions","points","pending","ActionDisabledReason","reset","commit","cut","deps","place","pts","first","scale","withinPxRadius","x","y","eligible","sliceAction","\"slice\"","p","params","reason","at","endCtx","overlay","t","viewToTransform","view","toScreen","worldToScreen","run","stroke","OVERLAY_ROLE_STROKES","\"cut\"","out","polylineFromPoints","ellipsePath","defineTool","keybinding"],"sources":["../../../../src/tools/builtin/slice/useSliceTool.ts"],"sourcesContent":["import { useMemo, useRef } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { defineTool } from '../../overlayBinding';\nimport type { Tool } from '../../overlayBinding';\nimport type { RenderLayer } from 'core/layers/render';\nimport type { DrawCommand } from '../../../renderer';\nimport type { Action, ActionDeps, InvocationCtx, ToolKeybinding } from '@weasel-js/routing';\nimport { ActionDisabledReason } from '@weasel-js/routing';\nimport { createPointerFollower } from '../shared/pointerFollower';\nimport { sliceAction } from 'interactions/actions/defaults/slice';\nimport { withinPxRadius } from 'core/viewport/pxExtent';\nimport { worldToScreen } from 'core/viewport/viewTransform';\nimport { viewToTransform } from 'core/viewport/view';\nimport { ellipsePath, polylineFromPoints } from '@weasel-js/geom';\nimport { OVERLAY_ROLE_STROKES } from 'canvas/overlayRoleStrokes';\n\n/** Options for `useSliceTool`. */\nexport interface UseSliceToolOptions {\n  /** Override the default keybinding (`{ key: 'K' }`). Pass `null` to omit. */\n  keybinding?: ToolKeybinding | null;\n  /** Screen-px radius around the first point within which a click closes the\n   *  cut into a loop and commits it. Default `8`. */\n  closeHitRadius?: number;\n}\n\n/** The click-by-click cut in progress, in world coords. */\nexport interface SliceScratch {\n  points: { x: number; y: number }[];\n}\n\nconst VERTEX_RADIUS_PX = 3;\n\n/**\n * Knife tool. A drag cuts along a straight line, and an Alt-drag along its\n * freehand trail, through `sliceAction`. Clicks place a cut one point at a\n * time: Enter or a double-click commits it, Escape discards it, Backspace\n * takes back the last point, and a click on the first point closes it into a\n * loop and commits. While points are placed, a drag places one more where it\n * is released instead of cutting on its own.\n *\n * Every cut goes to the `slice` dep, which decides what it does to the scene.\n * `<SceneCanvas>` publishes one that cuts every path the cut crosses. The pending cut paints through\n * `Tool.overlay`, trailing to the pointer when the host publishes one.\n */\nexport function useSliceTool(options: UseSliceToolOptions = {}): Tool<null> {\n  const scratchRef = useRef<SliceScratch>({ points: [] });\n  const optsRef = useLatest({ closeHitRadius: options.closeHitRadius ?? 8 });\n\n  // What the overlay layer's `subscribe` hears: a change to the points, and,\n  // while any are placed, every move of the pointer the rubber band follows.\n  const live = useMemo(() => {\n    const listeners = new Set<() => void>();\n    const notify = (): void => { for (const fn of [...listeners]) fn(); };\n    return {\n      notify,\n      listen(fn: () => void): () => void {\n        listeners.add(fn);\n        return () => { listeners.delete(fn); };\n      },\n      ...createPointerFollower(notify),\n    };\n  }, []);\n\n  const actions = useMemo<Action[]>(() => {\n    const points = () => scratchRef.current.points;\n    const pending = () => (points().length > 0 ? true : ActionDisabledReason.NotApplicable);\n\n    const reset = (): void => {\n      scratchRef.current.points = [];\n      live.unfollow();\n      live.notify();\n    };\n    const commit = (deps: ActionDeps): void => {\n      const cut = points().slice();\n      reset();\n      if (cut.length >= 2) deps.slice?.commit(cut);\n    };\n    const place = (deps: ActionDeps, x: number, y: number): void => {\n      const pts = points();\n      const first = pts[0];\n      const scale = deps.view?.get().scale ?? { x: 1, y: 1 };\n      if (pts.length >= 3 && withinPxRadius(x - first.x, y - first.y, optsRef.current.closeHitRadius, scale)) {\n        pts.push({ x: first.x, y: first.y });\n        commit(deps);\n        return;\n      }\n      pts.push({ x, y });\n      live.follow(deps.pointer);\n      live.notify();\n    };\n\n    const eligible = { capability: 'edits-page' } as const;\n    return [\n      sliceAction,\n      {\n        id: 'slice.addPoint',\n        label: 'Slice — place point',\n        eligible,\n        requires: ['slice', 'view', 'pointer'],\n        enabled: (deps) => (deps?.['slice'] ? true : ActionDisabledReason.NotApplicable),\n        invoker: {\n          timing: 'immediate',\n          run: (deps, params) => {\n            const p = params as { pressX?: number; pressY?: number } | undefined;\n            if (p?.pressX === undefined || p.pressY === undefined) return;\n            place(deps, p.pressX, p.pressY);\n          },\n        },\n      },\n      {\n        id: 'slice.dragPoint',\n        label: 'Slice — drag out a point',\n        eligible,\n        requires: ['slice', 'view', 'pointer'],\n        enabled: pending,\n        invoker: {\n          timing: 'ongoing',\n          // The dispatcher hands `onEnd` a context with empty deps.\n          start: ({ deps }: InvocationCtx) => ({\n            onMove: () => {},\n            onEnd: (endCtx: InvocationCtx, reason: 'commit' | 'cancel') => {\n              if (reason === 'cancel' || points().length === 0) return;\n              const at = endCtx.drag?.current ?? endCtx.world;\n              place(deps, at.x, at.y);\n            },\n          }),\n        },\n      },\n      {\n        id: 'slice.finish',\n        label: 'Slice — cut along the points',\n        eligible,\n        requires: ['slice'],\n        enabled: pending,\n        invoker: {\n          timing: 'immediate',\n          run: (deps, params) => {\n            // A double click arrives after both of its clicks, so the second\n            // has already placed a point on top of the first.\n            if ((params as { viaDoubleClick?: boolean } | undefined)?.viaDoubleClick) points().pop();\n            commit(deps);\n          },\n        },\n      },\n      {\n        id: 'slice.dropPoint',\n        label: 'Slice — take back the last point',\n        eligible,\n        enabled: pending,\n        invoker: {\n          timing: 'immediate',\n          run: () => {\n            points().pop();\n            if (points().length === 0) reset();\n            else live.notify();\n          },\n        },\n      },\n      {\n        id: 'slice.cancel',\n        label: 'Slice — discard the points',\n        eligible,\n        // Declining with nothing placed leaves Escape to the ambient `escape`.\n        enabled: pending,\n        invoker: { timing: 'immediate', run: () => reset() },\n      },\n    ];\n  }, [live, optsRef]);\n\n  const overlay = useMemo<RenderLayer<unknown>>(() => ({\n    id: 'slice-pending-cut',\n    label: 'Slice — pending cut',\n    space: 'screen',\n    subscribe: live.listen,\n    draw: (_data, view) => {\n      const pts = scratchRef.current.points;\n      if (pts.length === 0) return [];\n      const t = viewToTransform(view);\n      const toScreen = (p: { x: number; y: number }) => {\n        const [x, y] = worldToScreen(p.x, p.y, t);\n        return { x, y };\n      };\n      const run = pts.map(toScreen);\n      const at = live.pointer()?.get();\n      if (at) run.push(toScreen({ x: at.worldX, y: at.worldY }));\n      const stroke = OVERLAY_ROLE_STROKES['cut'];\n      const out: DrawCommand[] = [];\n      if (run.length >= 2) out.push({ kind: 'path', path: polylineFromPoints(run), stroke });\n      for (const p of pts.map(toScreen)) {\n        out.push({\n          kind: 'path',\n          path: ellipsePath({\n            x: p.x - VERTEX_RADIUS_PX,\n            y: p.y - VERTEX_RADIUS_PX,\n            width: VERTEX_RADIUS_PX * 2,\n            height: VERTEX_RADIUS_PX * 2,\n          }),\n          fill: stroke.paint,\n        });\n      }\n      return out;\n    },\n  }), [live]);\n\n  const { keybinding } = options;\n  return useMemo(() => defineTool<null>({\n    id: 'slice',\n    capabilities: ['edits-page'],\n    hookName: 'useSliceTool',\n    cursor: 'crosshair',\n    presentation: { label: 'Slice', group: 'shape' },\n    ...(keybinding === null ? {} : { keybinding: keybinding ?? { key: 'K' } }),\n    actions,\n    overlay,\n    onDeactivate: () => {\n      scratchRef.current.points = [];\n      live.unfollow();\n      live.notify();\n    },\n    bindings: [\n      { spec: { kind: 'click', mods: { shift: 'optional', alt: 'optional' } }, actionId: 'slice.addPoint' },\n      {\n        spec: { kind: 'doubleClick', mods: { shift: 'optional', alt: 'optional' } },\n        actionId: 'slice.finish',\n        opts: { params: { viaDoubleClick: true } },\n      },\n      // Ahead of the cutting drags: it declines unless points are placed.\n      { spec: { kind: 'drag', mods: { shift: 'optional', alt: 'optional' } }, actionId: 'slice.dragPoint' },\n      { spec: { kind: 'drag' }, actionId: 'slice' },\n      { spec: { kind: 'drag', mods: { alt: true } }, actionId: 'slice', opts: { params: { cut: 'freehand' } } },\n      { spec: { kind: 'key', key: 'Enter' }, actionId: 'slice.finish' },\n      { spec: { kind: 'key', key: 'Escape' }, actionId: 'slice.cancel' },\n      { spec: { kind: 'key', key: 'Backspace' }, actionId: 'slice.dropPoint' },\n    ],\n  }), [actions, overlay, keybinding, live]);\n}\n"],"mappings":"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"}
+{"version":3,"file":"useSliceTool.js","names":["VERTEX_RADIUS_PX","useSliceTool","scratchRef","useRef","optsRef","useLatest","options","live","useMemo","changed","createEmitter","createPointerFollower","actions","points","pending","ActionDisabledReason","reset","commit","cut","deps","place","pts","first","scale","withinPxRadius","x","y","eligible","sliceAction","\"slice\"","p","params","reason","at","endCtx","overlay","t","viewToTransform","view","toScreen","worldToScreen","run","stroke","OVERLAY_ROLE_STROKES","\"cut\"","out","polylineFromPoints","ellipsePath","defineTool","keybinding"],"sources":["../../../../src/tools/builtin/slice/useSliceTool.ts"],"sourcesContent":["import { useMemo, useRef } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport { defineTool } from '../../overlayBinding';\nimport type { Tool } from '../../overlayBinding';\nimport type { RenderLayer } from 'core/layers/render';\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport type { Action, ActionDeps, InvocationCtx, ToolKeybinding } from '@weasel-js/routing';\nimport { ActionDisabledReason } from '@weasel-js/routing';\nimport { createPointerFollower } from '../shared/pointerFollower';\nimport { sliceAction } from 'interactions/actions/defaults/slice';\nimport { withinPxRadius } from '@weasel-js/geom';\nimport { worldToScreen } from 'core/viewport/viewTransform';\nimport { viewToTransform } from 'core/viewport/view';\nimport { ellipsePath, polylineFromPoints } from '@weasel-js/geom';\nimport { OVERLAY_ROLE_STROKES } from 'canvas/overlayRoleStrokes';\nimport { createEmitter } from '@weasel-js/registry';\n\n/** Options for `useSliceTool`. */\nexport interface UseSliceToolOptions {\n  /** Override the default keybinding (`{ key: 'K' }`). Pass `null` to omit. */\n  keybinding?: ToolKeybinding | null;\n  /** Screen-px radius around the first point within which a click closes the\n   *  cut into a loop and commits it. Default `8`. */\n  closeHitRadius?: number;\n}\n\n/** The click-by-click cut in progress, in world coords. */\nexport interface SliceScratch {\n  points: { x: number; y: number }[];\n}\n\nconst VERTEX_RADIUS_PX = 3;\n\n/**\n * Knife tool. A drag cuts along a straight line, and an Alt-drag along its\n * freehand trail, through `sliceAction`. Clicks place a cut one point at a\n * time: Enter or a double-click commits it, Escape discards it, Backspace\n * takes back the last point, and a click on the first point closes it into a\n * loop and commits. While points are placed, a drag places one more where it\n * is released instead of cutting on its own.\n *\n * Every cut goes to the `slice` dep, which decides what it does to the scene.\n * `<SceneCanvas>` publishes one that cuts every path the cut crosses.\n */\nexport function useSliceTool(options: UseSliceToolOptions = {}): Tool {\n  const scratchRef = useRef<SliceScratch>({ points: [] });\n  const optsRef = useLatest({ closeHitRadius: options.closeHitRadius ?? 8 });\n\n  // What the overlay layer's `subscribe` hears: a change to the points, and,\n  // while any are placed, every move of the pointer the rubber band follows.\n  const live = useMemo(() => {\n    const changed = createEmitter();\n    return {\n      notify: changed.emit,\n      listen: changed.subscribe,\n      ...createPointerFollower(changed.emit),\n    };\n  }, []);\n\n  const actions = useMemo<Action[]>(() => {\n    const points = () => scratchRef.current.points;\n    const pending = () => (points().length > 0 ? true : ActionDisabledReason.NotApplicable);\n\n    const reset = (): void => {\n      scratchRef.current.points = [];\n      live.unfollow();\n      live.notify();\n    };\n    const commit = (deps: ActionDeps): void => {\n      const cut = points().slice();\n      reset();\n      if (cut.length >= 2) deps.slice?.commit(cut);\n    };\n    const place = (deps: ActionDeps, x: number, y: number): void => {\n      const pts = points();\n      const first = pts[0];\n      const scale = deps.view?.get().scale ?? { x: 1, y: 1 };\n      if (pts.length >= 3 && withinPxRadius(x - first.x, y - first.y, optsRef.current.closeHitRadius, scale)) {\n        pts.push({ x: first.x, y: first.y });\n        commit(deps);\n        return;\n      }\n      pts.push({ x, y });\n      live.follow(deps.pointer);\n      live.notify();\n    };\n\n    const eligible = { capability: 'edits-page' } as const;\n    return [\n      sliceAction,\n      {\n        id: 'slice.addPoint',\n        label: 'Slice — place point',\n        eligible,\n        requires: ['slice', 'view', 'pointer'],\n        enabled: (deps) => (deps?.['slice'] ? true : ActionDisabledReason.NotApplicable),\n        invoker: {\n          timing: 'immediate',\n          run: (deps, params) => {\n            const p = params as { pressX?: number; pressY?: number } | undefined;\n            if (p?.pressX === undefined || p.pressY === undefined) return;\n            place(deps, p.pressX, p.pressY);\n          },\n        },\n      },\n      {\n        id: 'slice.dragPoint',\n        label: 'Slice — drag out a point',\n        eligible,\n        requires: ['slice', 'view', 'pointer'],\n        enabled: pending,\n        invoker: {\n          timing: 'ongoing',\n          // The dispatcher hands `onEnd` a context with empty deps.\n          start: ({ deps }: InvocationCtx) => ({\n            onMove: () => {},\n            onEnd: (endCtx: InvocationCtx, reason: 'commit' | 'cancel') => {\n              if (reason === 'cancel' || points().length === 0) return;\n              const at = endCtx.drag?.current ?? endCtx.world;\n              place(deps, at.x, at.y);\n            },\n          }),\n        },\n      },\n      {\n        id: 'slice.finish',\n        label: 'Slice — cut along the points',\n        eligible,\n        requires: ['slice'],\n        enabled: pending,\n        invoker: {\n          timing: 'immediate',\n          run: (deps, params) => {\n            // A double click arrives after both of its clicks, so the second\n            // has already placed a point on top of the first.\n            if ((params as { viaDoubleClick?: boolean } | undefined)?.viaDoubleClick) points().pop();\n            commit(deps);\n          },\n        },\n      },\n      {\n        id: 'slice.dropPoint',\n        label: 'Slice — take back the last point',\n        eligible,\n        enabled: pending,\n        invoker: {\n          timing: 'immediate',\n          run: () => {\n            points().pop();\n            if (points().length === 0) reset();\n            else live.notify();\n          },\n        },\n      },\n      {\n        id: 'slice.cancel',\n        label: 'Slice — discard the points',\n        eligible,\n        // Declining with nothing placed leaves Escape to the ambient `escape`.\n        enabled: pending,\n        invoker: { timing: 'immediate', run: () => reset() },\n      },\n    ];\n  }, [live, optsRef]);\n\n  const overlay = useMemo<RenderLayer<unknown>>(() => ({\n    id: 'slice-pending-cut',\n    label: 'Slice — pending cut',\n    space: 'screen',\n    subscribe: live.listen,\n    draw: (_data, view) => {\n      const pts = scratchRef.current.points;\n      if (pts.length === 0) return [];\n      const t = viewToTransform(view);\n      const toScreen = (p: { x: number; y: number }) => {\n        const [x, y] = worldToScreen(p.x, p.y, t);\n        return { x, y };\n      };\n      const run = pts.map(toScreen);\n      const at = live.pointer()?.get();\n      if (at) run.push(toScreen({ x: at.worldX, y: at.worldY }));\n      const stroke = OVERLAY_ROLE_STROKES['cut'];\n      const out: DrawCommand[] = [];\n      if (run.length >= 2) out.push({ kind: 'path', path: polylineFromPoints(run), stroke });\n      for (const p of pts.map(toScreen)) {\n        out.push({\n          kind: 'path',\n          path: ellipsePath({\n            x: p.x - VERTEX_RADIUS_PX,\n            y: p.y - VERTEX_RADIUS_PX,\n            width: VERTEX_RADIUS_PX * 2,\n            height: VERTEX_RADIUS_PX * 2,\n          }),\n          fill: { paint: stroke.paint },\n        });\n      }\n      return out;\n    },\n  }), [live]);\n\n  const { keybinding } = options;\n  return useMemo(() => defineTool({\n    id: 'slice',\n    capabilities: ['edits-page'],\n    hookName: 'useSliceTool',\n    cursor: 'crosshair',\n    presentation: { label: 'Slice', group: 'shape' },\n    ...(keybinding === null ? {} : { keybinding: keybinding ?? { key: 'K' } }),\n    actions,\n    overlay,\n    onDeactivate: () => {\n      scratchRef.current.points = [];\n      live.unfollow();\n      live.notify();\n    },\n    bindings: [\n      { spec: { kind: 'click', mods: { shift: 'optional', alt: 'optional' } }, actionId: 'slice.addPoint' },\n      {\n        spec: { kind: 'doubleClick', mods: { shift: 'optional', alt: 'optional' } },\n        actionId: 'slice.finish',\n        opts: { params: { viaDoubleClick: true } },\n      },\n      // Ahead of the cutting drags: it declines unless points are placed.\n      { spec: { kind: 'drag', mods: { shift: 'optional', alt: 'optional' } }, actionId: 'slice.dragPoint', opts: { yields: true } },\n      { spec: { kind: 'drag' }, actionId: 'slice' },\n      { spec: { kind: 'drag', mods: { alt: true } }, actionId: 'slice', opts: { params: { cut: 'freehand' } } },\n      { spec: { kind: 'key', key: 'Enter' }, actionId: 'slice.finish' },\n      { spec: { kind: 'key', key: 'Escape' }, actionId: 'slice.cancel' },\n      { spec: { kind: 'key', key: 'Backspace' }, actionId: 'slice.dropPoint' },\n    ],\n  }), [actions, overlay, keybinding, live]);\n}\n"],"mappings":"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"}

package/dist/tools/builtin/star/useStarTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"useStarTool.js","names":["StarIcon","MIN_POINTS","MAX_POINTS","useStarTool","initialPoints","options","pointsRef","useRef","innerRatioRef","useLatest","innerRatio","setPointsTick","useState","bumpPoints","useCallback","n","adjustPointsAction","useMemo","p","params","step","defineTool","cursorFor","insertBindingBehaviors","behaviors","label"],"sources":["../../../../src/tools/builtin/star/useStarTool.tsx"],"sourcesContent":["import { useCallback, useMemo, useRef, useState } from 'react';\nimport { defineTool } from '../../overlayBinding';\nimport { StarIcon } from '../../../icons';\nimport type { Tool } from '../../overlayBinding';\nimport { insertBindingBehaviors, type InsertToolOptions } from '../shared/insertToolOptions';\nimport type { Action } from '@weasel-js/routing';\nimport { useLatest } from '@weasel-js/react';\nimport { cursorFor } from '@weasel-js/cursor';\n\n/** A point in world coordinates. */\nexport interface StarPoint { x: number; y: number }\n\n/** Options for `useStarTool`. */\nexport interface UseStarToolOptions extends InsertToolOptions {\n  label?: string;\n  /** Initial point count. Persists across gestures (Illustrator\n   *  convention), adjustable mid-drag via ArrowUp/Down or wheel\n   *  (range 3–32). */\n  points?: number;\n  /** Inner-radius / outer-radius ratio. Default 0.5. Consumers wanting\n   *  per-instance ratios should override the `insert` dep. */\n  innerRatio?: number;\n}\n\nconst MIN_POINTS = 3;\nconst MAX_POINTS = 32;\n\n/**\n * Drag-from-center star tool. Pointerdown sets center; drag determines\n * outer radius + rotation; release commits via `insertAction`. Inner\n * radius = outer × `innerRatio` (default 0.5). Point count defaults to\n * 5, adjustable mid-gesture via ArrowUp/Down or wheel.\n *\n * Live preview painted by the dispatcher overlay layer reading\n * `insertAction.overlay()`. Consumers wanting custom star geometry\n * override the `insert` dep.\n */\nexport function useStarTool<TNode extends { id: string } = { id: string }>(\n  options: UseStarToolOptions = {},\n): Tool<null> {\n  const {\n    points: initialPoints = 5,\n    innerRatio = 0.5,\n    label = 'Star',\n    behaviors,\n  } = options;\n  const pointsRef = useRef(initialPoints);\n  const innerRatioRef = useLatest(innerRatio);\n  const [, setPointsTick] = useState(0);\n  const bumpPoints = useCallback(() => setPointsTick((n) => n + 1), []);\n\n  // Wheel-to-adjust-points action. Phase-gated to `[engaged]` so it\n  // fires only mid-drag.\n  const adjustPointsAction = useMemo<Action>(\n    () => ({\n      id: 'star.adjustPoints',\n      label: 'Star — adjust points',\n      invoker: {\n        timing: 'immediate' as const,\n        run: (_deps, params) => {\n          const p = params as { deltaY?: number; delta?: number } | undefined;\n          // `delta` comes from the ArrowUp/ArrowDown key bindings; `deltaY`\n          // from the wheel. Wheel up (deltaY > 0 under natural scrolling)\n          // adds a point.\n          const step = p?.delta ?? (p?.deltaY !== undefined && p.deltaY !== 0\n            ? (p.deltaY > 0 ? 1 : -1)\n            : 0);\n          if (step === 0) return;\n          pointsRef.current = step > 0\n            ? Math.min(MAX_POINTS, pointsRef.current + 1)\n            : Math.max(MIN_POINTS, pointsRef.current - 1);\n          bumpPoints();\n        },\n      },\n    }),\n    [bumpPoints],\n  );\n\n  void ({} as TNode);\n\n  return useMemo(\n    () =>\n      defineTool<null>({\n        id: 'star',\n        capabilities: ['creates-shapes'],\n        hookName: 'useStarTool',\n        cursor: cursorFor('crosshairStar', { fallback: 'crosshair' }),\n        // Registered by <ToolActionsMounter>, inside the ActionsProvider —\n        // see `ToolDef.actions` for why the hook can't register it itself.\n        actions: [adjustPointsAction],\n        presentation: {\n          label,\n          group: 'shape',\n          icon: <StarIcon />,\n        },\n        bindings: [\n          // Default = drag from corner; anchor dot in the overlay sells\n          // the click point. Alt flips to center mode (live toggle).\n          {\n            spec: { kind: 'drag' },\n            actionId: 'insert',\n            opts: {\n              params: () => ({\n                kind: 'star',\n                points: pointsRef.current,\n                innerRadiusRatio: innerRatioRef.current,\n              }),\n              ...insertBindingBehaviors(behaviors),\n            },\n          },\n          {\n            spec: { kind: 'wheel', phase: 'engaged' },\n            actionId: 'star.adjustPoints',\n          },\n          {\n            spec: { kind: 'wheel', phase: 'engaged', mods: { shift: true } },\n            actionId: 'insert.adjustRotation',\n          },\n          // ArrowUp/Down → adjust point count. Ported off the phase table for\n          // the same reason as polygon's: as an `initial.keyDown` route the\n          // key was claimed on the tool pipeline while `nudge.*` matched the\n          // same press on the interactions dispatcher, so both fired.\n          {\n            spec: { kind: 'key', key: 'ArrowUp' },\n            actionId: 'star.adjustPoints',\n            opts: { params: { delta: 1 } },\n          },\n          {\n            spec: { kind: 'key', key: 'ArrowDown' },\n            actionId: 'star.adjustPoints',\n            opts: { params: { delta: -1 } },\n          },\n        ],\n      }),\n    [adjustPointsAction, behaviors, label, innerRatioRef],\n  );\n}\n"],"mappings":";;;;;;;;AAwBA,IAAMC,IAAa,GACbC,IAAa;AAYnB,SAAgBC,EACd,IAA8B,CAAC,GACnB;CACZ,IAAM,EACJ,QAAQC,IAAgB,GACxB,gBAAa,IACb,WAAQ,QACR,iBACEC,GACEC,IAAYC,EAAOH,CAAa,GAChCI,IAAgBC,EAAUC,CAAU,GACpC,GAAGC,KAAiBC,EAAS,CAAC,GAC9BC,IAAaC,QAAkBH,GAAe,MAAMI,IAAI,CAAC,GAAG,CAAC,CAAC,GAI9DC,IAAqBC,SAClB;EACL,IAAI;EACJ,OAAO;EACP,SAAS;GACP,QAAQ;GACR,MAAM,GAAO,MAAW;IACtB,IAAMC,IAAIC,GAIJC,IAAOF,GAAG,UAAUA,GAAG,WAAW,KAAA,KAAaA,EAAE,WAAW,IAC7DA,EAAE,SAAS,IAAI,IAAI,KACpB;IACJ,AAAIE,MAAS,MACb,EAAU,UAAUA,IAAO,IACvB,KAAK,IAAIlB,GAAYI,EAAU,UAAU,CAAC,IAC1C,KAAK,IAAIL,GAAYK,EAAU,UAAU,CAAC,GAC9CO,EAAW;GACb;EACF;CACF,IACA,CAACA,CAAU,CACb;CAIA,OAAOI,QAEHI,EAAiB;EACf,IAAI;EACJ,cAAc,CAAC,gBAAgB;EAC/B,UAAU;EACV,QAAQC,EAAU,iBAAiB,EAAE,UAAU,YAAY,CAAC;EAG5D,SAAS,CAACN,CAAkB;EAC5B,cAAc;GACZ;GACA,OAAO;GACP,MAAM,kBAAChB,GAAD,CAAW,CAAA;EACnB;EACA,UAAU;GAGR;IACE,MAAM,EAAE,MAAM,OAAO;IACrB,UAAU;IACV,MAAM;KACJ,eAAe;MACb,MAAM;MACN,QAAQM,EAAU;MAClB,kBAAkBE,EAAc;KAClC;KACA,GAAGe,EAAuBC,CAAS;IACrC;GACF;GACA;IACE,MAAM;KAAE,MAAM;KAAS,OAAO;IAAU;IACxC,UAAU;GACZ;GACA;IACE,MAAM;KAAE,MAAM;KAAS,OAAO;KAAW,MAAM,EAAE,OAAO,GAAK;IAAE;IAC/D,UAAU;GACZ;GAKA;IACE,MAAM;KAAE,MAAM;KAAO,KAAK;IAAU;IACpC,UAAU;IACV,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;GAC/B;GACA;IACE,MAAM;KAAE,MAAM;KAAO,KAAK;IAAY;IACtC,UAAU;IACV,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,EAAE;GAChC;EACF;CACF,CAAC,GACH;EAACR;EAAoBQ;EAAWC;EAAOjB;CAAa,CACtD;AACF"}
+{"version":3,"file":"useStarTool.js","names":["StarIcon","MIN_POINTS","MAX_POINTS","useStarTool","initialPoints","options","pointsRef","useRef","innerRatioRef","useLatest","innerRatio","setPointsTick","useState","bumpPoints","useCallback","n","adjustPointsAction","useMemo","p","params","step","defineTool","cursorFor","insertBindingBehaviors","behaviors","label"],"sources":["../../../../src/tools/builtin/star/useStarTool.tsx"],"sourcesContent":["import { useCallback, useMemo, useRef, useState } from 'react';\nimport { defineTool } from '../../overlayBinding';\nimport { StarIcon } from '../../../icons';\nimport type { Tool } from '../../overlayBinding';\nimport { insertBindingBehaviors, type InsertToolOptions } from '../shared/insertToolOptions';\nimport type { Action } from '@weasel-js/routing';\nimport { useLatest } from '@weasel-js/react';\nimport { cursorFor } from '@weasel-js/cursor';\n\n/** A point in world coordinates. */\nexport interface StarPoint { x: number; y: number }\n\n/** Options for `useStarTool`. */\nexport interface UseStarToolOptions extends InsertToolOptions {\n  label?: string;\n  /** Initial point count. Persists across gestures (Illustrator\n   *  convention), adjustable mid-drag via ArrowUp/Down or wheel\n   *  (range 3–32). */\n  points?: number;\n  /** Inner-radius / outer-radius ratio. Default 0.5. Consumers wanting\n   *  per-instance ratios should override the `insert` dep. */\n  innerRatio?: number;\n}\n\nconst MIN_POINTS = 3;\nconst MAX_POINTS = 32;\n\n/**\n * Drag-from-center star tool. Pointerdown sets center; drag determines\n * outer radius + rotation; release commits via `insertAction`. Inner\n * radius = outer × `innerRatio` (default 0.5). Point count defaults to\n * 5, adjustable mid-gesture via ArrowUp/Down or wheel.\n *\n * Live preview painted by the dispatcher overlay layer reading\n * `insertAction.overlay()`. Consumers wanting custom star geometry\n * override the `insert` dep.\n */\nexport function useStarTool<TNode extends { id: string } = { id: string }>(\n  options: UseStarToolOptions = {},\n): Tool {\n  const {\n    points: initialPoints = 5,\n    innerRatio = 0.5,\n    label = 'Star',\n    behaviors,\n  } = options;\n  const pointsRef = useRef(initialPoints);\n  const innerRatioRef = useLatest(innerRatio);\n  const [, setPointsTick] = useState(0);\n  const bumpPoints = useCallback(() => setPointsTick((n) => n + 1), []);\n\n  // Wheel-to-adjust-points action. Phase-gated to `[engaged]` so it\n  // fires only mid-drag.\n  const adjustPointsAction = useMemo<Action>(\n    () => ({\n      id: 'star.adjustPoints',\n      label: 'Star — adjust points',\n      invoker: {\n        timing: 'immediate' as const,\n        run: (_deps, params) => {\n          const p = params as { deltaY?: number; delta?: number } | undefined;\n          // `delta` comes from the ArrowUp/ArrowDown key bindings; `deltaY`\n          // from the wheel. Wheel up (deltaY > 0 under natural scrolling)\n          // adds a point.\n          const step = p?.delta ?? (p?.deltaY !== undefined && p.deltaY !== 0\n            ? (p.deltaY > 0 ? 1 : -1)\n            : 0);\n          if (step === 0) return;\n          pointsRef.current = step > 0\n            ? Math.min(MAX_POINTS, pointsRef.current + 1)\n            : Math.max(MIN_POINTS, pointsRef.current - 1);\n          bumpPoints();\n        },\n      },\n    }),\n    [bumpPoints],\n  );\n\n  void ({} as TNode);\n\n  return useMemo(\n    () =>\n      defineTool({\n        id: 'star',\n        capabilities: ['creates-shapes'],\n        hookName: 'useStarTool',\n        cursor: cursorFor('crosshairStar', { fallback: 'crosshair' }),\n        // Registered by <ToolActionsMounter>, inside the ActionsProvider —\n        // see `ToolDef.actions` for why the hook can't register it itself.\n        actions: [adjustPointsAction],\n        presentation: {\n          label,\n          group: 'shape',\n          icon: <StarIcon />,\n        },\n        bindings: [\n          // Default = drag from corner; anchor dot in the overlay sells\n          // the click point. Alt flips to center mode (live toggle).\n          {\n            spec: { kind: 'drag' },\n            actionId: 'insert',\n            opts: {\n              params: () => ({\n                kind: 'star',\n                points: pointsRef.current,\n                innerRadiusRatio: innerRatioRef.current,\n              }),\n              ...insertBindingBehaviors(behaviors),\n            },\n          },\n          {\n            spec: { kind: 'wheel', phase: 'engaged' },\n            actionId: 'star.adjustPoints',\n          },\n          {\n            spec: { kind: 'wheel', phase: 'engaged', mods: { shift: true } },\n            actionId: 'insert.adjustRotation',\n          },\n          // ArrowUp/Down → adjust point count. Ported off the phase table for\n          // the same reason as polygon's: as an `initial.keyDown` route the\n          // key was claimed on the tool pipeline while `nudge.*` matched the\n          // same press on the interactions dispatcher, so both fired.\n          {\n            spec: { kind: 'key', key: 'ArrowUp' },\n            actionId: 'star.adjustPoints',\n            opts: { params: { delta: 1 } },\n          },\n          {\n            spec: { kind: 'key', key: 'ArrowDown' },\n            actionId: 'star.adjustPoints',\n            opts: { params: { delta: -1 } },\n          },\n        ],\n      }),\n    [adjustPointsAction, behaviors, label, innerRatioRef],\n  );\n}\n"],"mappings":";;;;;;;;AAwBA,IAAMC,IAAa,GACbC,IAAa;AAYnB,SAAgBC,EACd,IAA8B,CAAC,GACzB;CACN,IAAM,EACJ,QAAQC,IAAgB,GACxB,gBAAa,IACb,WAAQ,QACR,iBACEC,GACEC,IAAYC,EAAOH,CAAa,GAChCI,IAAgBC,EAAUC,CAAU,GACpC,GAAGC,KAAiBC,EAAS,CAAC,GAC9BC,IAAaC,QAAkBH,GAAe,MAAMI,IAAI,CAAC,GAAG,CAAC,CAAC,GAI9DC,IAAqBC,SAClB;EACL,IAAI;EACJ,OAAO;EACP,SAAS;GACP,QAAQ;GACR,MAAM,GAAO,MAAW;IACtB,IAAMC,IAAIC,GAIJC,IAAOF,GAAG,UAAUA,GAAG,WAAW,KAAA,KAAaA,EAAE,WAAW,IAC7DA,EAAE,SAAS,IAAI,IAAI,KACpB;IACJ,AAAIE,MAAS,MACb,EAAU,UAAUA,IAAO,IACvB,KAAK,IAAIlB,GAAYI,EAAU,UAAU,CAAC,IAC1C,KAAK,IAAIL,GAAYK,EAAU,UAAU,CAAC,GAC9CO,EAAW;GACb;EACF;CACF,IACA,CAACA,CAAU,CACb;CAIA,OAAOI,QAEHI,EAAW;EACT,IAAI;EACJ,cAAc,CAAC,gBAAgB;EAC/B,UAAU;EACV,QAAQC,EAAU,iBAAiB,EAAE,UAAU,YAAY,CAAC;EAG5D,SAAS,CAACN,CAAkB;EAC5B,cAAc;GACZ;GACA,OAAO;GACP,MAAM,kBAAChB,GAAD,CAAW,CAAA;EACnB;EACA,UAAU;GAGR;IACE,MAAM,EAAE,MAAM,OAAO;IACrB,UAAU;IACV,MAAM;KACJ,eAAe;MACb,MAAM;MACN,QAAQM,EAAU;MAClB,kBAAkBE,EAAc;KAClC;KACA,GAAGe,EAAuBC,CAAS;IACrC;GACF;GACA;IACE,MAAM;KAAE,MAAM;KAAS,OAAO;IAAU;IACxC,UAAU;GACZ;GACA;IACE,MAAM;KAAE,MAAM;KAAS,OAAO;KAAW,MAAM,EAAE,OAAO,GAAK;IAAE;IAC/D,UAAU;GACZ;GAKA;IACE,MAAM;KAAE,MAAM;KAAO,KAAK;IAAU;IACpC,UAAU;IACV,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;GAC/B;GACA;IACE,MAAM;KAAE,MAAM;KAAO,KAAK;IAAY;IACtC,UAAU;IACV,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,EAAE;GAChC;EACF;CACF,CAAC,GACH;EAACR;EAAoBQ;EAAWC;EAAOjB;CAAa,CACtD;AACF"}

package/dist/tools/builtin/text/useTextTool.js

@@ -179,6 +179,14 @@ o.options = {
 			description: "Ink for the range.",
 			alpha: !0,
 			default: "#000000"
+		},
+		noFill: {
+			kind: "boolean",
+			name: "No fill",
+			description: "Draw the range with no fill.",
+			icon: "paintNone",
+			control: "toggle",
+			default: !1
 		}
 	}
 };

package/dist/tools/builtin/text/useTextTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"useTextTool.js","names":["TextIcon","PRESENTATION","createElement","useTextTool","options","useMemo","defineTool","insertBindingBehaviors","behaviors","PERCENT","v","flag","name"],"sources":["../../../../src/tools/builtin/text/useTextTool.ts"],"sourcesContent":["import { useMemo, createElement } from 'react';\nimport type { PrefGroup } from '@weasel-js/prefs';\nimport { defineTool } from '../../overlayBinding';\nimport type { Tool } from '../../overlayBinding';\nimport { insertBindingBehaviors, type InsertToolOptions } from '../shared/insertToolOptions';\nimport { TextIcon } from '../../../icons';\n\nconst PRESENTATION = {\n  label: 'Text',\n  icon: createElement(TextIcon),\n  group: 'type',\n};\n\n/** Text tool. Drag-rect insertion is owned end-to-end by the dispatcher's\n *  `insertAction` (kind: `'text'`); click-on-selected-text-node enters edit\n *  mode via the `enterTextEdit` action.\n *\n *  Consumers must register both the `insert` dep (e.g. through\n *  `SceneCanvas`'s `useInsertDepSource`) and the `textEdit` dep\n *  (`enterTextEditAction`'s contract — see\n *  `src/interactions/actions/defaults/enterTextEdit.ts`). Custom node\n *  factories and hit gating belong on those deps, not on the tool. */\nexport function useTextTool(options: InsertToolOptions = {}): Tool<undefined> {\n  const { behaviors } = options;\n  return useMemo<Tool<undefined>>(\n    () =>\n      defineTool<undefined>({\n        id: 'text',\n        keybinding: { key: 'T' },\n        capabilities: ['creates-text'],\n        hookName: 'useTextTool',\n        cursor: 'text',\n        presentation: PRESENTATION,\n        bindings: [\n          { spec: { kind: 'drag' }, actionId: 'insert', opts: { params: { kind: 'text' }, ...insertBindingBehaviors(behaviors) } },\n          { spec: { kind: 'click', target: 'selected-body' }, actionId: 'enterTextEdit' },\n        ],\n      }),\n    [behaviors],\n  );\n}\n\n/** Both script primitives are fractions of the inherited size, so both read\n *  as percentages. The step is a tenth of a point because the field snaps the\n *  *displayed* value to it, and a coarser one would render a superscript's\n *  58.3% as 60% and commit that on the next edit. */\nconst PERCENT = {\n  toDisplay: (v: number) => Math.round(v * 1000) / 10,\n  // Rounded rather than divided: 33.3 / 100 is 0.33299999999999996, and that\n  // dust would be written into the document and shown back on the next read.\n  fromDisplay: (v: number) => Math.round(v * 1000) / 100_000,\n  suffix: '%',\n};\n\n/** A run flag: on or off per character, drawn as one segment of a bar. */\nconst flag = (name: string, icon: string) =>\n  ({\n    kind: 'boolean',\n    name,\n    description: `${name} for the characters in the range.`,\n    icon,\n    control: 'toggle',\n    default: false,\n  }) as const;\n\n/**\n * What the tool offers while a caret range is active — the character half of\n * text styling, against the node-level Character group a selection shows.\n *\n * Keyed by {@link StyledRun} field, so a host reads values out of a\n * `RangeStyle` and writes a `RunStylePatch` back with no name mapping of its\n * own. `script` is a preset over `baselineShift` and `fontScale`, so all three\n * are here and naming either primitive overrides that half.\n */\nuseTextTool.options = {\n  name: 'Text',\n  description: 'Character styling for the selected range.',\n  children: {\n    bold: {\n      ...flag('Bold', 'bold'),\n      pair: { with: ['italic', 'underline', 'strikethrough', 'overline'], label: 'Character style' },\n    },\n    italic: flag('Italic', 'italic'),\n    underline: flag('Underline', 'underline'),\n    strikethrough: flag('Strikethrough', 'strikethrough'),\n    overline: flag('Overline', 'overline'),\n    // Clearable: the two values are exclusive *and* absent is a third state,\n    // so clicking the lit segment turns the script off.\n    script: {\n      kind: 'enum',\n      name: 'Script',\n      description: 'Raise or lower the range off the baseline, at a smaller size.',\n      control: 'toggle',\n      clearable: true,\n      default: undefined,\n      options: [\n        { value: 'super', label: 'Superscript', icon: 'superscript' },\n        { value: 'sub', label: 'Subscript', icon: 'subscript' },\n      ],\n    },\n    textTransform: {\n      kind: 'enum',\n      name: 'Case',\n      description: 'Draw the range in capitals, lowercase or title case. The text itself is unchanged.',\n      control: 'toggle',\n      default: 'none',\n      options: [{ value: 'none', label: 'None', short: ['–'] }, { value: 'uppercase', label: 'Uppercase', short: ['AA'] }, { value: 'lowercase', label: 'Lowercase', short: ['aa'] }, { value: 'capitalize', label: 'Capitalize', short: ['Aa'] }],\n    },\n    fontVariantCaps: {\n      kind: 'enum',\n      name: 'Small caps',\n      description: 'Draw lowercase letters in the range as smaller capitals. The text itself is unchanged.',\n      control: 'toggle',\n      default: 'normal',\n      options: [{ value: 'normal', label: 'Normal', short: ['–'] }, { value: 'small-caps', label: 'Small caps', short: ['Sc'] }],\n    },\n    fontFamily: {\n      kind: 'font-family',\n      name: 'Font',\n      description: 'Typeface for the range.',\n      default: undefined,\n    },\n    // Listed from the weights the range's family has registered. Bold is a\n    // preset over it: toggling Bold clears it, picking one clears Bold.\n    fontWeight: {\n      kind: 'font-weight',\n      name: 'Weight',\n      description: 'Weight of the range, from the faces its family has.',\n      default: undefined,\n    },\n    fontSize: { kind: 'number', name: 'Size', description: 'Type size.', min: 1, step: 1, default: 16 },\n    letterSpacing: {\n      kind: 'number',\n      name: 'Tracking',\n      // The typographic term, short enough for a strip; `name` stays the\n      // accessible one.\n      short: ['VA'],\n      description: 'Space added between characters.',\n      step: 0.1,\n      default: 0,\n    },\n    baselineShift: {\n      kind: 'number',\n      name: 'Baseline shift',\n      short: ['Shift'],\n      description: 'Raise or lower the range, in ems of the inherited size.',\n      step: 0.001,\n      unit: PERCENT,\n      default: 0,\n    },\n    fontScale: {\n      kind: 'number',\n      name: 'Scale',\n      description: 'Size of the range against the inherited size.',\n      min: 0.01,\n      step: 0.001,\n      unit: PERCENT,\n      default: 1,\n    },\n    fill: {\n      kind: 'color',\n      name: 'Color',\n      description: 'Ink for the range.',\n      alpha: true,\n      default: '#000000',\n    },\n  },\n} satisfies PrefGroup;\n"],"mappings":"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"}
+{"version":3,"file":"useTextTool.js","names":["TextIcon","PRESENTATION","createElement","useTextTool","options","useMemo","defineTool","insertBindingBehaviors","behaviors","PERCENT","v","flag","name"],"sources":["../../../../src/tools/builtin/text/useTextTool.ts"],"sourcesContent":["import { useMemo, createElement } from 'react';\nimport type { PrefGroup } from '@weasel-js/prefs';\nimport { defineTool } from '../../overlayBinding';\nimport type { Tool } from '../../overlayBinding';\nimport { insertBindingBehaviors, type InsertToolOptions } from '../shared/insertToolOptions';\nimport { TextIcon } from '../../../icons';\n\nconst PRESENTATION = {\n  label: 'Text',\n  icon: createElement(TextIcon),\n  group: 'type',\n};\n\n/** Text tool. Drag-rect insertion is owned end-to-end by the dispatcher's\n *  `insertAction` (kind: `'text'`); click-on-selected-text-node enters edit\n *  mode via the `enterTextEdit` action.\n *\n *  Consumers must register both the `insert` dep (e.g. through\n *  `SceneCanvas`'s `useInsertDepSource`) and the `textEdit` dep\n *  (`enterTextEditAction`'s contract — see\n *  `src/interactions/actions/defaults/enterTextEdit.ts`). Custom node\n *  factories and hit gating belong on those deps, not on the tool. */\nexport function useTextTool(options: InsertToolOptions = {}): Tool {\n  const { behaviors } = options;\n  return useMemo<Tool>(\n    () =>\n      defineTool({\n        id: 'text',\n        keybinding: { key: 'T' },\n        capabilities: ['creates-text'],\n        hookName: 'useTextTool',\n        cursor: 'text',\n        presentation: PRESENTATION,\n        bindings: [\n          { spec: { kind: 'drag' }, actionId: 'insert', opts: { params: { kind: 'text' }, ...insertBindingBehaviors(behaviors) } },\n          { spec: { kind: 'click', target: 'selected-body' }, actionId: 'enterTextEdit' },\n        ],\n      }),\n    [behaviors],\n  );\n}\n\n/** Both script primitives are fractions of the inherited size, so both read\n *  as percentages. The step is a tenth of a point because the field snaps the\n *  *displayed* value to it, and a coarser one would render a superscript's\n *  58.3% as 60% and commit that on the next edit. */\nconst PERCENT = {\n  toDisplay: (v: number) => Math.round(v * 1000) / 10,\n  // Rounded rather than divided: 33.3 / 100 is 0.33299999999999996, and that\n  // dust would be written into the document and shown back on the next read.\n  fromDisplay: (v: number) => Math.round(v * 1000) / 100_000,\n  suffix: '%',\n};\n\n/** A run flag: on or off per character, drawn as one segment of a bar. */\nconst flag = (name: string, icon: string) =>\n  ({\n    kind: 'boolean',\n    name,\n    description: `${name} for the characters in the range.`,\n    icon,\n    control: 'toggle',\n    default: false,\n  }) as const;\n\n/**\n * What the tool offers while a caret range is active — the character half of\n * text styling, against the node-level Character group a selection shows.\n *\n * Keyed by {@link StyledRun} field, so a host reads values out of a\n * `RangeStyle` and writes a `RunStylePatch` back with no name mapping of its\n * own. `script` is a preset over `baselineShift` and `fontScale`, so all three\n * are here and naming either primitive overrides that half. `noFill` is the one\n * key that is not a field: on, it is `fill: null`.\n */\nuseTextTool.options = {\n  name: 'Text',\n  description: 'Character styling for the selected range.',\n  children: {\n    bold: {\n      ...flag('Bold', 'bold'),\n      pair: { with: ['italic', 'underline', 'strikethrough', 'overline'], label: 'Character style' },\n    },\n    italic: flag('Italic', 'italic'),\n    underline: flag('Underline', 'underline'),\n    strikethrough: flag('Strikethrough', 'strikethrough'),\n    overline: flag('Overline', 'overline'),\n    // Clearable: the two values are exclusive *and* absent is a third state,\n    // so clicking the lit segment turns the script off.\n    script: {\n      kind: 'enum',\n      name: 'Script',\n      description: 'Raise or lower the range off the baseline, at a smaller size.',\n      control: 'toggle',\n      clearable: true,\n      default: undefined,\n      options: [\n        { value: 'super', label: 'Superscript', icon: 'superscript' },\n        { value: 'sub', label: 'Subscript', icon: 'subscript' },\n      ],\n    },\n    textTransform: {\n      kind: 'enum',\n      name: 'Case',\n      description: 'Draw the range in capitals, lowercase or title case. The text itself is unchanged.',\n      control: 'toggle',\n      default: 'none',\n      options: [{ value: 'none', label: 'None', short: ['–'] }, { value: 'uppercase', label: 'Uppercase', short: ['AA'] }, { value: 'lowercase', label: 'Lowercase', short: ['aa'] }, { value: 'capitalize', label: 'Capitalize', short: ['Aa'] }],\n    },\n    fontVariantCaps: {\n      kind: 'enum',\n      name: 'Small caps',\n      description: 'Draw lowercase letters in the range as smaller capitals. The text itself is unchanged.',\n      control: 'toggle',\n      default: 'normal',\n      options: [{ value: 'normal', label: 'Normal', short: ['–'] }, { value: 'small-caps', label: 'Small caps', short: ['Sc'] }],\n    },\n    fontFamily: {\n      kind: 'font-family',\n      name: 'Font',\n      description: 'Typeface for the range.',\n      default: undefined,\n    },\n    // Listed from the weights the range's family has registered. Bold is a\n    // preset over it: toggling Bold clears it, picking one clears Bold.\n    fontWeight: {\n      kind: 'font-weight',\n      name: 'Weight',\n      description: 'Weight of the range, from the faces its family has.',\n      default: undefined,\n    },\n    fontSize: { kind: 'number', name: 'Size', description: 'Type size.', min: 1, step: 1, default: 16 },\n    letterSpacing: {\n      kind: 'number',\n      name: 'Tracking',\n      // The typographic term, short enough for a strip; `name` stays the\n      // accessible one.\n      short: ['VA'],\n      description: 'Space added between characters.',\n      step: 0.1,\n      default: 0,\n    },\n    baselineShift: {\n      kind: 'number',\n      name: 'Baseline shift',\n      short: ['Shift'],\n      description: 'Raise or lower the range, in ems of the inherited size.',\n      step: 0.001,\n      unit: PERCENT,\n      default: 0,\n    },\n    fontScale: {\n      kind: 'number',\n      name: 'Scale',\n      description: 'Size of the range against the inherited size.',\n      min: 0.01,\n      step: 0.001,\n      unit: PERCENT,\n      default: 1,\n    },\n    fill: {\n      kind: 'color',\n      name: 'Color',\n      description: 'Ink for the range.',\n      alpha: true,\n      default: '#000000',\n    },\n    noFill: {\n      kind: 'boolean',\n      name: 'No fill',\n      description: 'Draw the range with no fill.',\n      icon: 'paintNone',\n      control: 'toggle',\n      default: false,\n    },\n  },\n} satisfies PrefGroup;\n"],"mappings":"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"}

package/dist/tools/builtin/weight/useWeightTool.js

@@ -0,0 +1,77 @@
+import { defineTool as e } from "../../overlayBinding.js";
+import { placedRig as t } from "../bone/placedRig.js";
+import { createBoneOverlay as n } from "../bone/boneOverlay.js";
+import { createRigEditState as r } from "../bone/rigEditState.js";
+import { createWeightActions as i, weighedPaths as a } from "./weightActions.js";
+import { createWeightOverlay as o } from "./weightOverlay.js";
+import { useMemo as s } from "react";
+import { useLatest as c } from "@weasel-js/react";
+//#region src/tools/builtin/weight/useWeightTool.ts
+function l(l) {
+	let u = s(() => r(), []), d = l.state ?? u, f = c({
+		scene: l.scene,
+		rig: l.rig,
+		radius: l.radius ?? 24,
+		reach: l.reach ?? 10
+	}), p = s(() => ({
+		state: d,
+		scene: () => f.current.scene,
+		placed: () => t(f.current.scene, f.current.rig()),
+		reachPx: () => f.current.reach,
+		radiusPx: () => f.current.radius,
+		painted: d.painted,
+		paint: d.paint
+	}), [f, d]), m = s(() => i(p), [p]), h = s(() => [o({
+		id: "weight-tool-points",
+		paths: () => a(p),
+		active: d.active,
+		subscribe: d.listen
+	}), n({
+		id: "weight-tool-skeleton",
+		skeleton: () => p.placed()?.skeleton ?? null,
+		active: d.active,
+		subscribe: d.listen
+	})], [p, d]), { keybinding: g } = l;
+	return s(() => e({
+		id: "weight",
+		capabilities: ["edits-page"],
+		hookName: "useWeightTool",
+		cursor: "crosshair",
+		presentation: {
+			label: "Weight",
+			group: "shape"
+		},
+		...g === null ? {} : { keybinding: g ?? { key: "W" } },
+		actions: m,
+		overlay: h,
+		onDeactivate: () => p.paint(null),
+		bindings: [{
+			spec: {
+				kind: "click",
+				mods: {
+					shift: "optional",
+					alt: "optional"
+				}
+			},
+			actionId: "weight.click"
+		}, {
+			spec: {
+				kind: "drag",
+				mods: {
+					shift: "optional",
+					alt: "optional"
+				}
+			},
+			actionId: "weight.paint"
+		}]
+	}), [
+		m,
+		h,
+		g,
+		p
+	]);
+}
+//#endregion
+export { l as useWeightTool };
+
+//# sourceMappingURL=useWeightTool.js.map

package/dist/tools/builtin/weight/useWeightTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWeightTool.js","names":["useWeightTool","ownState","useMemo","createRigEditState","state","options","opts","useLatest","env","placedRig","actions","createWeightActions","overlay","createWeightOverlay","weighedPaths","createBoneOverlay","defineTool","keybinding"],"sources":["../../../../src/tools/builtin/weight/useWeightTool.ts"],"sourcesContent":["import { useMemo } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { ToolKeybinding } from '@weasel-js/routing';\nimport type { NodeId, Scene } from 'core/scene/types';\nimport { defineTool } from '../../overlayBinding';\nimport type { Tool } from '../../overlayBinding';\nimport { createBoneOverlay } from '../bone/boneOverlay';\nimport { placedRig } from '../bone/placedRig';\nimport { createRigEditState, type RigEditState } from '../bone/rigEditState';\nimport { createWeightActions, weighedPaths, type WeightEnv } from './weightActions';\nimport { createWeightOverlay } from './weightOverlay';\n\n/** Options for `useWeightTool`. */\nexport interface UseWeightToolOptions {\n  scene: Scene<unknown, string, unknown>;\n  /** The node whose data holds the skeleton; the tool paints the paths under it. */\n  rig: () => NodeId | null;\n  /** Shared with `useBoneTool`, so both act on one joint. Default: the tool's own. */\n  state?: RigEditState;\n  /** Override the default keybinding (`{ key: 'W' }`). Pass `null` to omit. */\n  keybinding?: ToolKeybinding | null;\n  /** The brush's radius in screen px. Default 24. */\n  radius?: number;\n  /** Screen px around a joint within which a click picks it. Default 10. */\n  reach?: number;\n}\n\n/**\n * Paints how much the active joint weighs each point of the paths under a rig node, into\n * their `data.skin`. A click on a joint makes it the active one. A drag is a round brush:\n * points under it follow the active joint more, the nearer the brush's center, and their\n * other joints give way; with Alt held they follow it less. A click away from any joint is\n * one dab. Every point shows as a dot colored by the active joint's share of it. A stroke is\n * one undo entry, and until it ends its weights are in `state.painted()`, which `useRigNode`\n * binds when given the same `state` as `painting`.\n */\nexport function useWeightTool(options: UseWeightToolOptions): Tool {\n  const ownState = useMemo(() => createRigEditState(), []);\n  const state = options.state ?? ownState;\n  const opts = useLatest({\n    scene: options.scene, rig: options.rig, radius: options.radius ?? 24, reach: options.reach ?? 10,\n  });\n  const env = useMemo((): WeightEnv => ({\n    state,\n    scene: () => opts.current.scene,\n    placed: () => placedRig(opts.current.scene, opts.current.rig()),\n    reachPx: () => opts.current.reach,\n    radiusPx: () => opts.current.radius,\n    painted: state.painted,\n    paint: state.paint,\n  }), [opts, state]);\n\n  const actions = useMemo(() => createWeightActions(env), [env]);\n  const overlay = useMemo(() => [\n    createWeightOverlay({\n      id: 'weight-tool-points',\n      paths: () => weighedPaths(env),\n      active: state.active,\n      subscribe: state.listen,\n    }),\n    createBoneOverlay({\n      id: 'weight-tool-skeleton',\n      skeleton: () => env.placed()?.skeleton ?? null,\n      active: state.active,\n      subscribe: state.listen,\n    }),\n  ], [env, state]);\n\n  const { keybinding } = options;\n  return useMemo(() => defineTool({\n    id: 'weight',\n    capabilities: ['edits-page'],\n    hookName: 'useWeightTool',\n    cursor: 'crosshair',\n    presentation: { label: 'Weight', group: 'shape' },\n    ...(keybinding === null ? {} : { keybinding: keybinding ?? { key: 'W' } }),\n    actions,\n    overlay,\n    onDeactivate: () => env.paint(null),\n    bindings: [\n      { spec: { kind: 'click', mods: { shift: 'optional', alt: 'optional' } }, actionId: 'weight.click' },\n      { spec: { kind: 'drag', mods: { shift: 'optional', alt: 'optional' } }, actionId: 'weight.paint' },\n    ],\n  }), [actions, overlay, keybinding, env]);\n}\n"],"mappings":";;;;;;;;;AAoCA,SAAgBA,EAAc,GAAqC;CACjE,IAAMC,IAAWC,QAAcC,EAAmB,GAAG,CAAC,CAAC,GACjDC,IAAQC,EAAQ,SAASJ,GACzBK,IAAOC,EAAU;EACrB,OAAOF,EAAQ;EAAO,KAAKA,EAAQ;EAAK,QAAQA,EAAQ,UAAU;EAAI,OAAOA,EAAQ,SAAS;CAChG,CAAC,GACKG,IAAMN,SAA0B;EACpC;EACA,aAAaI,EAAK,QAAQ;EAC1B,cAAcG,EAAUH,EAAK,QAAQ,OAAOA,EAAK,QAAQ,IAAI,CAAC;EAC9D,eAAeA,EAAK,QAAQ;EAC5B,gBAAgBA,EAAK,QAAQ;EAC7B,SAASF,EAAM;EACf,OAAOA,EAAM;CACf,IAAI,CAACE,GAAMF,CAAK,CAAC,GAEXM,IAAUR,QAAcS,EAAoBH,CAAG,GAAG,CAACA,CAAG,CAAC,GACvDI,IAAUV,QAAc,CAC5BW,EAAoB;EAClB,IAAI;EACJ,aAAaC,EAAaN,CAAG;EAC7B,QAAQJ,EAAM;EACd,WAAWA,EAAM;CACnB,CAAC,GACDW,EAAkB;EAChB,IAAI;EACJ,gBAAgBP,EAAI,OAAO,CAAC,EAAE,YAAY;EAC1C,QAAQJ,EAAM;EACd,WAAWA,EAAM;CACnB,CAAC,CACH,GAAG,CAACI,GAAKJ,CAAK,CAAC,GAET,EAAE,kBAAeC;CACvB,OAAOH,QAAcc,EAAW;EAC9B,IAAI;EACJ,cAAc,CAAC,YAAY;EAC3B,UAAU;EACV,QAAQ;EACR,cAAc;GAAE,OAAO;GAAU,OAAO;EAAQ;EAChD,GAAIC,MAAe,OAAO,CAAC,IAAI,EAAE,YAAYA,KAAc,EAAE,KAAK,IAAI,EAAE;EACxE;EACA;EACA,oBAAoBT,EAAI,MAAM,IAAI;EAClC,UAAU,CACR;GAAE,MAAM;IAAE,MAAM;IAAS,MAAM;KAAE,OAAO;KAAY,KAAK;IAAW;GAAE;GAAG,UAAU;EAAe,GAClG;GAAE,MAAM;IAAE,MAAM;IAAQ,MAAM;KAAE,OAAO;KAAY,KAAK;IAAW;GAAE;GAAG,UAAU;EAAe,CACnG;CACF,CAAC,GAAG;EAACE;EAASE;EAASK;EAAYT;CAAG,CAAC;AACzC"}

package/dist/tools/builtin/weight/weightActions.js

@@ -0,0 +1,112 @@
+import { createSetDataOp as e } from "../../../core/ops/setData.js";
+import { defaultCommitAdapter as t } from "../../../interactions/actions/defaultCommitAdapter.js";
+import { dataRestPath as n } from "../../../animation/rig/skinBinding.js";
+import { sceneReach as r } from "../bone/placedRig.js";
+import { ActionDisabledReason as i } from "@weasel-js/routing";
+import { brushWeights as a, jointAt as o, setWeights as s, skinnable as c } from "@weasel-js/animator";
+//#region src/tools/builtin/weight/weightActions.ts
+function l(e) {
+	let t = e.placed();
+	if (!t) return [];
+	let r = e.scene(), i = e.painted(), a = [], o = (e) => {
+		for (let t of r.childrenOf(e)) {
+			let e = r.get(t), s = e && n(e);
+			if (e && s) {
+				let n = i.get(t) ?? e.data?.skin ?? {};
+				a.push({
+					id: t,
+					path: c(s),
+					skin: n
+				});
+			}
+			o(t);
+		}
+	};
+	return o(t.id), a;
+}
+var u = { capability: "edits-page" }, d = (e) => {
+	let t = e.state.active();
+	return t !== null && e.placed()?.skeleton.joints.some((e) => e.name === t) ? t : null;
+};
+function f(e, t, n, i, o, c) {
+	let u = r(t, e.radiusPx()), d = null;
+	for (let { id: t, path: r, skin: f } of l(e)) {
+		let l = a(r.coords, i, o, u, f[n], c);
+		l.size !== 0 && (d ??= new Map(e.painted()), d.set(t, s(f, r.coords.length >> 1, n, l)));
+	}
+	return d;
+}
+function p(n, r) {
+	let i = n.scene(), a = [];
+	for (let [t, r] of n.painted()) {
+		let n = i.get(t)?.data;
+		n !== void 0 && a.push(e({
+			id: t,
+			from: n,
+			to: {
+				...n,
+				skin: r
+			},
+			label: "Paint weights"
+		}));
+	}
+	a.length > 0 && (r.applyOps ? r.applyOps(a, "Paint weights") : i.applyBatch(a, "Paint weights", t(i, r.selection?.adapterMethods))), n.paint(null);
+}
+function m(e) {
+	return [{
+		id: "weight.paint",
+		label: "Weight — paint the active joint's weights",
+		eligible: u,
+		requires: [
+			"view",
+			"selection",
+			"applyOps"
+		],
+		enabled: () => d(e) !== null || i.NotApplicable,
+		invoker: {
+			timing: "ongoing",
+			start: ({ deps: t, drag: n, world: r, modifiers: i }) => {
+				let a = d(e);
+				if (a === null) return {};
+				let o = (n, r, i) => {
+					let o = f(e, t, a, n, r, i ? "remove" : "add");
+					o && e.paint(o);
+				}, s = n?.start ?? r;
+				return o(s.x, s.y, i.alt), {
+					onMove: (e) => o(e.world.x, e.world.y, e.modifiers.alt),
+					onEnd: (n, r) => {
+						r === "cancel" ? e.paint(null) : p(e, t);
+					}
+				};
+			}
+		}
+	}, {
+		id: "weight.click",
+		label: "Weight — pick a joint, or dab its weight",
+		eligible: u,
+		requires: [
+			"view",
+			"selection",
+			"applyOps"
+		],
+		enabled: () => e.placed() ? !0 : i.NotApplicable,
+		invoker: {
+			timing: "immediate",
+			run: (t, n) => {
+				let i = n, a = e.placed();
+				if (!a || i?.pressX === void 0 || i.pressY === void 0) return;
+				let s = o(a.skeleton, i.pressX, i.pressY, r(t, e.reachPx()));
+				if (s !== null) {
+					e.state.setActive(s);
+					return;
+				}
+				let c = d(e), l = c === null ? null : f(e, t, c, i.pressX, i.pressY, i.mods?.alt ? "remove" : "add");
+				l && (e.paint(l), p(e, t));
+			}
+		}
+	}];
+}
+//#endregion
+export { m as createWeightActions, l as weighedPaths };
+
+//# sourceMappingURL=weightActions.js.map

package/dist/tools/builtin/weight/weightActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weightActions.js","names":["weighedPaths","rig","env","scene","painted","out","walk","id","parent","node","rest","dataRestPath","skin","skinnable","eligible","activeJoint","name","j","dab","radius","sceneReach","deps","next","hits","brushWeights","path","x","y","joint","mode","setWeights","commitPainted","ops","data","createSetDataOp","defaultCommitAdapter","createWeightActions","ActionDisabledReason","stroke","alt","press","drag","world","modifiers","move","reason","p","params","hit","jointAt"],"sources":["../../../../src/tools/builtin/weight/weightActions.ts"],"sourcesContent":["import type { Action, ActionDeps, InvocationCtx } from '@weasel-js/routing';\nimport { ActionDisabledReason } from '@weasel-js/routing';\nimport type { PolygonPath } from '@weasel-js/geom';\nimport type { Op } from '@weasel-js/history';\nimport { createSetDataOp } from 'core/ops/setData';\nimport type { NodeId, Scene } from 'core/scene/types';\nimport { defaultCommitAdapter } from 'interactions/actions/defaultCommitAdapter';\nimport type { RigNodeData } from '../../../animation/rig/rigNode';\nimport { jointAt } from '@weasel-js/animator';\nimport { skinnable, type Skin } from '@weasel-js/animator';\nimport { dataRestPath } from '../../../animation/rig/skinBinding';\nimport { brushWeights, setWeights } from '@weasel-js/animator';\nimport { sceneReach, type PlacedRig } from '../bone/placedRig';\nimport type { RigEditState } from '../bone/rigEditState';\n\n/** One path under the rig node, where it is drawn, with the weights now showing. */\nexport interface WeighedPath {\n  id: NodeId;\n  path: PolygonPath;\n  skin: Skin;\n}\n\n/** What the weight tool's actions read and write, all of it the tool's own. */\nexport interface WeightEnv {\n  scene(): Scene<unknown, string, unknown>;\n  placed(): PlacedRig | null;\n  state: RigEditState;\n  /** Screen px around a joint within which a click picks it. */\n  reachPx(): number;\n  /** The brush's radius in screen px. */\n  radiusPx(): number;\n  /** Weights a stroke has painted and not yet committed, by node. */\n  painted(): ReadonlyMap<NodeId, Skin>;\n  paint(next: ReadonlyMap<NodeId, Skin> | null): void;\n}\n\n/** Every path under the rig node, with what `env.painted()` holds for it in place of its\n *  `data.skin`. */\nexport function weighedPaths(env: Pick<WeightEnv, 'scene' | 'placed' | 'painted'>): WeighedPath[] {\n  const rig = env.placed();\n  if (!rig) return [];\n  const scene = env.scene();\n  const painted = env.painted();\n  const out: WeighedPath[] = [];\n  const walk = (parent: NodeId): void => {\n    for (const id of scene.childrenOf(parent)) {\n      const node = scene.get(id);\n      const rest = node && dataRestPath(node);\n      if (node && rest) {\n        const skin = painted.get(id) ?? (node.data as RigNodeData | null | undefined)?.skin ?? {};\n        out.push({ id, path: skinnable(rest), skin });\n      }\n      walk(id);\n    }\n  };\n  walk(rig.id);\n  return out;\n}\n\nconst eligible = { capability: 'edits-page' } as const;\n\nconst activeJoint = (env: WeightEnv): string | null => {\n  const name = env.state.active();\n  return name !== null && env.placed()?.skeleton.joints.some((j) => j.name === name) ? name : null;\n};\n\n/** One dab of the brush at `(x, y)`: what `env.painted()` becomes, or `null` if no point moved. */\nfunction dab(env: WeightEnv, deps: ActionDeps, joint: string, x: number, y: number, mode: 'add' | 'remove'): Map<NodeId, Skin> | null {\n  const radius = sceneReach(deps, env.radiusPx());\n  let next: Map<NodeId, Skin> | null = null;\n  for (const { id, path, skin } of weighedPaths(env)) {\n    const hits = brushWeights(path.coords, x, y, radius, skin[joint], mode);\n    if (hits.size === 0) continue;\n    next ??= new Map(env.painted());\n    next.set(id, setWeights(skin, path.coords.length >> 1, joint, hits));\n  }\n  return next;\n}\n\n/** Write what a stroke painted into each node's `data.skin`, as one undo entry. */\nfunction commitPainted(env: WeightEnv, deps: ActionDeps): void {\n  const scene = env.scene();\n  const ops: Op[] = [];\n  for (const [id, skin] of env.painted()) {\n    const data = scene.get(id)?.data;\n    if (data !== undefined) ops.push(createSetDataOp({ id, from: data, to: { ...(data as object), skin }, label: 'Paint weights' }));\n  }\n  if (ops.length > 0) {\n    if (deps.applyOps) deps.applyOps(ops, 'Paint weights');\n    else scene.applyBatch(ops, 'Paint weights', defaultCommitAdapter(scene, deps.selection?.adapterMethods));\n  }\n  env.paint(null);\n}\n\n/** The weight tool's actions: `weight.paint` and `weight.click`. */\nexport function createWeightActions(env: WeightEnv): Action[] {\n  const editing = () => (env.placed() ? true : ActionDisabledReason.NotApplicable);\n  return [\n    {\n      id: 'weight.paint',\n      label: 'Weight — paint the active joint\\'s weights',\n      eligible,\n      requires: ['view', 'selection', 'applyOps'],\n      enabled: () => (activeJoint(env) !== null ? true : ActionDisabledReason.NotApplicable),\n      invoker: {\n        timing: 'ongoing',\n        start: ({ deps, drag, world, modifiers }: InvocationCtx) => {\n          const joint = activeJoint(env);\n          if (joint === null) return {};\n          const stroke = (x: number, y: number, alt: boolean): void => {\n            const next = dab(env, deps, joint, x, y, alt ? 'remove' : 'add');\n            if (next) env.paint(next);\n          };\n          const press = drag?.start ?? world;\n          stroke(press.x, press.y, modifiers.alt);\n          return {\n            onMove: (move: InvocationCtx) => stroke(move.world.x, move.world.y, move.modifiers.alt),\n            // The dispatcher hands `onEnd` a context with empty deps.\n            onEnd: (_end: InvocationCtx, reason: 'commit' | 'cancel') => {\n              if (reason === 'cancel') env.paint(null);\n              else commitPainted(env, deps);\n            },\n          };\n        },\n      },\n    },\n    {\n      id: 'weight.click',\n      label: 'Weight — pick a joint, or dab its weight',\n      eligible,\n      requires: ['view', 'selection', 'applyOps'],\n      enabled: editing,\n      invoker: {\n        timing: 'immediate',\n        run: (deps, params) => {\n          const p = params as { pressX?: number; pressY?: number; mods?: { alt?: boolean } } | undefined;\n          const rig = env.placed();\n          if (!rig || p?.pressX === undefined || p.pressY === undefined) return;\n          const hit = jointAt(rig.skeleton, p.pressX, p.pressY, sceneReach(deps, env.reachPx()));\n          if (hit !== null) {\n            env.state.setActive(hit);\n            return;\n          }\n          const joint = activeJoint(env);\n          const next = joint === null ? null : dab(env, deps, joint, p.pressX, p.pressY, p.mods?.alt ? 'remove' : 'add');\n          if (!next) return;\n          env.paint(next);\n          commitPainted(env, deps);\n        },\n      },\n    },\n  ];\n}\n"],"mappings":"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"}

package/dist/tools/builtin/weight/weightOverlay.js

@@ -0,0 +1,61 @@
+import { viewToTransform as e } from "../../../core/viewport/view.js";
+import { worldToScreen as t } from "../../../core/viewport/viewTransform.js";
+import { ellipsePath as n } from "@weasel-js/geom";
+//#region src/tools/builtin/weight/weightOverlay.ts
+var r = 3.5, i = "#10161d", a = [
+	31,
+	111,
+	139
+], o = [
+	255,
+	138,
+	61
+], s = "#8a94a3", c = (e) => {
+	let t = a.map((t, n) => Math.round(t + (o[n] - t) * e));
+	return `rgb(${t[0]}, ${t[1]}, ${t[2]})`;
+};
+function l(a) {
+	return {
+		id: a.id,
+		label: "Weights",
+		space: "screen",
+		subscribe: a.subscribe,
+		draw: (o, l) => {
+			let u = e(l), d = a.active(), f = [];
+			for (let { path: e, skin: o } of a.paths()) {
+				let a = d === null ? void 0 : o[d], l;
+				if (d !== null) {
+					l = Array(e.coords.length >> 1).fill(0);
+					for (let e in o) o[e].forEach((e, t) => {
+						t < l.length && (l[t] += e);
+					});
+				}
+				for (let o = 0; 2 * o + 1 < e.coords.length; o++) {
+					let [p, m] = t(e.coords[2 * o], e.coords[2 * o + 1], u), h = l && l[o] > 0 ? (a?.[o] ?? 0) / l[o] : 0;
+					f.push({
+						kind: "path",
+						path: n({
+							x: p - r,
+							y: m - r,
+							width: 2 * r,
+							height: 2 * r
+						}),
+						fill: { paint: {
+							kind: "solid",
+							color: d === null ? s : c(h)
+						} },
+						stroke: {
+							paint: { color: i },
+							width: 1
+						}
+					});
+				}
+			}
+			return f;
+		}
+	};
+}
+//#endregion
+export { l as createWeightOverlay };
+
+//# sourceMappingURL=weightOverlay.js.map

package/dist/tools/builtin/weight/weightOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weightOverlay.js","names":["POINT_RADIUS_PX","RIM","COLD","HOT","IDLE","mix","c","v","k","w","createWeightOverlay","source","t","viewToTransform","view","active","out","weights","skin","total","path","joint","i","x","y","worldToScreen","share","ellipsePath"],"sources":["../../../../src/tools/builtin/weight/weightOverlay.ts"],"sourcesContent":["import { ellipsePath } from '@weasel-js/geom';\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport type { RenderLayer } from 'core/layers/render';\nimport { viewToTransform } from 'core/viewport/view';\nimport { worldToScreen } from 'core/viewport/viewTransform';\nimport type { WeighedPath } from './weightActions';\n\nconst POINT_RADIUS_PX = 3.5;\nconst RIM = '#10161d';\n/** No weight, and all of it. */\nconst COLD = [0x1f, 0x6f, 0x8b];\nconst HOT = [0xff, 0x8a, 0x3d];\nconst IDLE = '#8a94a3';\n\nconst mix = (w: number): string => {\n  const c = COLD.map((v, k) => Math.round(v + (HOT[k] - v) * w));\n  return `rgb(${c[0]}, ${c[1]}, ${c[2]})`;\n};\n\n/**\n * A screen-space layer drawing a dot on every point of every path under a rig, anchors and\n * curve handles alike, colored by how much the active joint weighs it. With no joint active\n * the dots are gray.\n */\nexport function createWeightOverlay(source: {\n  id: string;\n  paths(): readonly WeighedPath[];\n  active(): string | null;\n  subscribe(fn: () => void): () => void;\n}): RenderLayer<unknown> {\n  return {\n    id: source.id,\n    label: 'Weights',\n    space: 'screen',\n    subscribe: source.subscribe,\n    draw: (_data, view) => {\n      const t = viewToTransform(view);\n      const active = source.active();\n      const out: DrawCommand[] = [];\n      for (const { path, skin } of source.paths()) {\n        const weights = active === null ? undefined : skin[active];\n        let total: number[] | undefined;\n        if (active !== null) {\n          total = new Array<number>(path.coords.length >> 1).fill(0);\n          for (const joint in skin) skin[joint].forEach((w, i) => { if (i < total!.length) total![i] += w; });\n        }\n        for (let i = 0; 2 * i + 1 < path.coords.length; i++) {\n          const [x, y] = worldToScreen(path.coords[2 * i], path.coords[2 * i + 1], t);\n          const share = total && total[i] > 0 ? (weights?.[i] ?? 0) / total[i] : 0;\n          out.push({\n            kind: 'path',\n            path: ellipsePath({ x: x - POINT_RADIUS_PX, y: y - POINT_RADIUS_PX, width: 2 * POINT_RADIUS_PX, height: 2 * POINT_RADIUS_PX }),\n            fill: { paint: { kind: 'solid', color: active === null ? IDLE : mix(share) } },\n            stroke: { paint: { color: RIM }, width: 1 },\n          });\n        }\n      }\n      return out;\n    },\n  };\n}\n"],"mappings":";;;;AAOA,IAAMA,IAAkB,KAClBC,IAAM,WAENC,IAAO;CAAC;CAAM;CAAM;AAAI,GACxBC,IAAM;CAAC;CAAM;CAAM;AAAI,GACvBC,IAAO,WAEPC,KAAO,MAAsB;CACjC,IAAMC,IAAIJ,EAAK,KAAK,GAAG,MAAM,KAAK,MAAMK,KAAKJ,EAAIK,KAAKD,KAAKE,CAAC,CAAC;CAC7D,OAAO,OAAOH,EAAE,GAAG,IAAIA,EAAE,GAAG,IAAIA,EAAE,GAAG;AACvC;AAOA,SAAgBI,EAAoB,GAKX;CACvB,OAAO;EACL,IAAIC,EAAO;EACX,OAAO;EACP,OAAO;EACP,WAAWA,EAAO;EAClB,OAAO,GAAO,MAAS;GACrB,IAAMC,IAAIC,EAAgBC,CAAI,GACxBC,IAASJ,EAAO,OAAO,GACvBK,IAAqB,CAAC;GAC5B,KAAK,IAAM,EAAE,SAAM,aAAUL,EAAO,MAAM,GAAG;IAC3C,IAAMM,IAAUF,MAAW,OAAO,KAAA,IAAYG,EAAKH,IAC/CI;IACJ,IAAIJ,MAAW,MAAM;KACnB,IAAY,MAAcK,EAAK,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;KACzD,KAAK,IAAMC,KAASH,GAAM,EAAKG,EAAM,CAAC,SAAS,GAAG,MAAM;MAAE,AAAIC,IAAIH,EAAO,WAAQ,EAAOG,MAAMb;KAAG,CAAC;IACpG;IACA,KAAK,IAAIa,IAAI,GAAG,IAAIA,IAAI,IAAIF,EAAK,OAAO,QAAQ,KAAK;KACnD,IAAM,CAACG,GAAGC,KAAKC,EAAcL,EAAK,OAAO,IAAIE,IAAIF,EAAK,OAAO,IAAIE,IAAI,IAAIV,CAAC,GACpEc,IAAQP,KAASA,EAAMG,KAAK,KAAKL,IAAUK,MAAM,KAAKH,EAAMG,KAAK;KACvE,EAAI,KAAK;MACP,MAAM;MACN,MAAMK,EAAY;OAAE,GAAGJ,IAAIvB;OAAiB,GAAGwB,IAAIxB;OAAiB,OAAO,IAAIA;OAAiB,QAAQ,IAAIA;MAAgB,CAAC;MAC7H,MAAM,EAAE,OAAO;OAAE,MAAM;OAAS,OAAOe,MAAW,OAAOX,IAAOC,EAAIqB,CAAK;MAAE,EAAE;MAC7E,QAAQ;OAAE,OAAO,EAAE,OAAOzB,EAAI;OAAG,OAAO;MAAE;KAC5C,CAAC;IACH;GACF;GACA,OAAOe;EACT;CACF;AACF"}

package/dist/tools/overlayBinding.js.map

@@ -1 +1 @@
-{"version":3,"file":"overlayBinding.js","names":["useTools","routingUseTools","useTools$1","useTools","defineTool"],"sources":["../../src/tools/overlayBinding.ts"],"sourcesContent":["/**\n * The routing types that carry an overlay, bound to the kit's `RenderLayer`.\n *\n * `@weasel-js/routing` never reads an overlay — it collects the live ones and\n * hands them back in scope order — so it leaves the element type open. What a\n * weasel canvas draws is a `RenderLayer`, and every kit call site should see\n * that rather than `unknown`, so core binds the parameter once, here, and\n * re-exports these names under the ones they have always had.\n */\nimport type { RenderLayer } from 'core/layers/render';\nimport { useTools as routingUseTools, useContributions as routingUseContributions } from '@weasel-js/routing/react';\nimport type {\n  Contribution as RoutingContribution,\n  ContributionChrome as RoutingContributionChrome,\n  Tool as RoutingTool,\n  ToolDef as RoutingToolDef,\n  AnyToolOf,\n} from '@weasel-js/routing';\nimport type {\n  ToolsApi as RoutingToolsApi,\n  UseToolsOptions as RoutingUseToolsOptions,\n  ContributionsApi as RoutingContributionsApi,\n  UseContributionsOptions as RoutingUseContributionsOptions,\n} from '@weasel-js/routing/react';\n\n/** What a canvas overlay is, at this layer. */\nexport type Overlay = RenderLayer<unknown>;\n\ndeclare module '@weasel-js/routing' {\n  interface OverlaySchema { overlay: RenderLayer<unknown> }\n}\n\n/** Routing's `Contribution`, with overlays typed as `RenderLayer`. */\nexport type Contribution = RoutingContribution<Overlay>;\n/** Routing's `ContributionChrome`, with overlays typed as `RenderLayer`. */\nexport type ContributionChrome = RoutingContributionChrome<Overlay>;\n/** Routing's `Tool`, with overlays typed as `RenderLayer`. */\nexport type Tool<TScratch = unknown> = RoutingTool<TScratch, Overlay>;\n/** A `Tool` of any scratch type: the element type for a list of mixed tools. */\nexport type AnyTool = AnyToolOf<Overlay>;\n/** Routing's `ToolDef` (what `defineTool` takes), with overlays typed as `RenderLayer`. */\nexport type ToolDef<TScratch = void> = RoutingToolDef<TScratch, Overlay>;\n/** Routing's `ToolsApi`, with overlays typed as `RenderLayer`. */\nexport type ToolsApi = RoutingToolsApi<Overlay>;\n/** Routing's `UseToolsOptions`, with overlays typed as `RenderLayer`. */\nexport type UseToolsOptions = RoutingUseToolsOptions<Overlay>;\nexport type ContributionsApi = RoutingContributionsApi<Overlay>;\nexport type UseContributionsOptions = RoutingUseContributionsOptions<Overlay>;\n\n// Routing's own authoring functions: the `OverlaySchema` merge above makes\n// their overlay default `Overlay`, so there is one `defineTool`, not a wrapper.\nexport { defineTool } from '@weasel-js/routing';\n/** Routing's `useTools`, typed for `RenderLayer` overlays. */\nexport const useTools: (opts: UseToolsOptions) => ToolsApi = routingUseTools;\nexport const useContributions: (opts: UseContributionsOptions) => ContributionsApi =\n  routingUseContributions;\n"],"mappings":";;;AAqDA,IAAaA,IAAgDC"}
+{"version":3,"file":"overlayBinding.js","names":["useTools","routingUseTools","useTools$1","useTools","defineTool"],"sources":["../../src/tools/overlayBinding.ts"],"sourcesContent":["/**\n * The routing types that carry an overlay, bound to the kit's `RenderLayer`.\n *\n * `@weasel-js/routing` never reads an overlay — it collects the live ones and\n * hands them back in scope order — so it leaves the element type open. What a\n * weasel canvas draws is a `RenderLayer`, and every kit call site should see\n * that rather than `unknown`, so core binds the parameter once, here, and\n * re-exports these names under the ones they have always had.\n */\nimport type { RenderLayer } from 'core/layers/render';\nimport { useTools as routingUseTools, useContributions as routingUseContributions } from '@weasel-js/routing/react';\nimport type {\n  Contribution as RoutingContribution,\n  ContributionChrome as RoutingContributionChrome,\n  Tool as RoutingTool,\n  ToolDef as RoutingToolDef,\n} from '@weasel-js/routing';\nimport type {\n  ToolsApi as RoutingToolsApi,\n  UseToolsOptions as RoutingUseToolsOptions,\n  ContributionsApi as RoutingContributionsApi,\n  UseContributionsOptions as RoutingUseContributionsOptions,\n} from '@weasel-js/routing/react';\n\n/** What a canvas overlay is, at this layer. */\nexport type Overlay = RenderLayer<unknown>;\n\ndeclare module '@weasel-js/routing' {\n  interface OverlaySchema { overlay: RenderLayer<unknown> }\n}\n\n/** Routing's `Contribution`, with overlays typed as `RenderLayer`. */\nexport type Contribution = RoutingContribution<Overlay>;\n/** Routing's `ContributionChrome`, with overlays typed as `RenderLayer`. */\nexport type ContributionChrome = RoutingContributionChrome<Overlay>;\n/** Routing's `Tool`, with overlays typed as `RenderLayer`. */\nexport type Tool = RoutingTool<Overlay>;\n/** The same type as `Tool`, kept for code that imports it by this name. */\nexport type AnyTool = Tool;\n/** Routing's `ToolDef` (what `defineTool` takes), with overlays typed as `RenderLayer`. */\nexport type ToolDef = RoutingToolDef<Overlay>;\n/** Routing's `ToolsApi`, with overlays typed as `RenderLayer`. */\nexport type ToolsApi = RoutingToolsApi<Overlay>;\n/** Routing's `UseToolsOptions`, with overlays typed as `RenderLayer`. */\nexport type UseToolsOptions = RoutingUseToolsOptions<Overlay>;\nexport type ContributionsApi = RoutingContributionsApi<Overlay>;\nexport type UseContributionsOptions = RoutingUseContributionsOptions<Overlay>;\n\n// Routing's own authoring functions: the `OverlaySchema` merge above makes\n// their overlay default `Overlay`, so there is one `defineTool`, not a wrapper.\nexport { defineTool } from '@weasel-js/routing';\n/** Routing's `useTools`, typed for `RenderLayer` overlays. */\nexport const useTools: (opts: UseToolsOptions) => ToolsApi = routingUseTools;\nexport const useContributions: (opts: UseContributionsOptions) => ContributionsApi =\n  routingUseContributions;\n"],"mappings":";;;AAoDA,IAAaA,IAAgDC"}

package/dist/tools/useKeybindings.js

@@ -3,12 +3,13 @@ import { makeToolResetToDefaultAction as n } from "../interactions/actions/defau
 import { useEffect as r, useRef as i } from "react";
 import { useLatest as a } from "@weasel-js/react";
 import { useActionsRegistry as o } from "@weasel-js/routing/react";
+import { eligibleForMode as s } from "@weasel-js/modes";
 //#region src/tools/useKeybindings.ts
-function s(s, c = {}) {
-	let l = a(s), u = a(c), d = i(s.active), f = o(), { disable: p = !1 } = c;
+function c(c, l = {}) {
+	let u = a(c), d = a(l), f = i(c.active), p = o(), { disable: m = !1 } = l;
 	r(() => {
-		if (p || !f || Object.keys(l.current.registry).length === 0) return;
-		let r = [], i = l.current.registry;
+		if (m || !p || Object.keys(u.current.registry).length === 0) return;
+		let r = [], i = u.current.registry;
 		for (let e in i) {
 			let t = i[e].keybinding;
 			if (!t) continue;
@@ -24,27 +25,32 @@ function s(s, c = {}) {
 		let a = [];
 		if (r.length > 0) {
 			let n = e(r);
-			a.push(f.register(t(n, (e) => u.current.isToolEligible?.(e) ?? !0)));
+			a.push(p.register(t(n, (e) => {
+				let t = d.current.modes;
+				if (!t) return !0;
+				let n = u.current.registry[e]?.eligibility.capabilities;
+				return s(t.current(), n ?? []);
+			})));
 		}
-		return a.push(f.register(n(() => {
-			let e = u.current.defaultTool;
+		return a.push(p.register(n(() => {
+			let e = d.current.defaultTool;
 			if (e === null) return null;
-			let t = e ?? d.current;
+			let t = e ?? f.current;
 			if (!t) return null;
-			let n = l.current;
+			let n = u.current;
 			return !n.has(t) || n.active === t ? null : t;
 		}))), () => {
 			for (let e of a) e();
 		};
 	}, [
-		f,
-		s,
-		l,
+		p,
+		c,
 		u,
-		p
+		d,
+		m
 	]);
 }
 //#endregion
-export { s as useKeybindings };
+export { c as useKeybindings };
 
 //# sourceMappingURL=useKeybindings.js.map

package/dist/tools/useKeybindings.js.map

@@ -1 +1 @@
-{"version":3,"file":"useKeybindings.js","names":["useKeybindings","toolsRef","useLatest","tools","optionsRef","options","initialActiveRef","useRef","registry","useActionsRegistry","disable","specs","allTools","toolId","binding","keys","key","unregisters","bindings","buildToolActivateBindings","makeToolActivateAction","makeToolResetToDefaultAction","opt","target","api","u"],"sources":["../../src/tools/useKeybindings.ts"],"sourcesContent":["// src/tools/useKeybindings.ts\nimport { useEffect, useRef } from 'react';\nimport { useActionsRegistry } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport {\n  makeToolActivateAction,\n  buildToolActivateBindings,\n  type ToolActivateBindingSpec,\n} from 'interactions/actions/defaults/toolActivate';\nimport { makeToolResetToDefaultAction } from 'interactions/actions/defaults/toolResetToDefault';\nimport type { ToolsApi } from './overlayBinding';\n\n/** Options for `useKeybindings`. */\nexport interface UseKeybindingsOptions {\n  /** Skip all wiring. Useful for touch apps or test isolation. */\n  disable?: boolean;\n  /** Tool id Escape switches to. When omitted, defaults to whatever\n   *  `tools.active` was when the hook first ran (i.e. the initial active\n   *  tool). Pass `null` to disable Escape-returns-to-default behavior. */\n  defaultTool?: string | null;\n  /**\n   * Gate for keyboard tool activation: return false to refuse a tool the\n   * active mode doesn't allow. `<SceneCanvas>` wires this from\n   * its `modes` registry + each tool's `eligibility.capabilities`, using the same predicate\n   * `ToolPalette` uses to grey a button out — so the grey-out becomes a\n   * guarantee rather than a hint.\n   *\n   * Omit for consumers with no mode registry: every tool stays activatable.\n   */\n  isToolEligible?: (toolId: string) => boolean;\n}\n\n/** Wire the single-key tool-activation shortcuts (V, P, T, …) and Escape to\n *  return to the default tool. Activation is gated on what the active mode\n *  allows, so a key cannot reach a tool the palette greys out. */\nexport function useKeybindings(\n  tools: ToolsApi,\n  options: UseKeybindingsOptions = {},\n): void {\n  const toolsRef = useLatest(tools);\n  const optionsRef = useLatest(options);\n  // Snapshot the initial active tool — used as the Escape target when the\n  // consumer doesn't pass an explicit `defaultTool`. Captured in a ref\n  // (not state) so it survives re-renders without re-syncing.\n  const initialActiveRef = useRef(tools.active);\n\n  // Held-key engagement is not here: a tool declares `ToolDef.hotkey` and\n  // assembly registers `tool.offhand` from the declaration.\n  const registry = useActionsRegistry();\n\n  // --- Tool-activate: register one parametric `tool.activate` action.\n  // The single descriptor carries a `defaultBinding: BoundGesture[]` with one\n  // entry per tool — each entry pairs a key spec with `opts.params.toolId`.\n  // The invoker reads `params.toolId` and calls `setActive`. Imperative\n  // callers (palette, toolbar) reach the same effect via\n  // `registry.trigger('tool.activate', { toolId })`.\n  //\n  // Every key comes from a `ToolDef.keybinding` in the tools registry.\n  const { disable = false } = options;\n  useEffect(() => {\n    if (disable) return;\n    if (!registry) return;\n    // No tools, no tool keys: nothing to activate and nothing to return to.\n    if (Object.keys(toolsRef.current.registry).length === 0) return;\n\n    const specs: ToolActivateBindingSpec[] = [];\n\n    const allTools = toolsRef.current.registry;\n    for (const toolId in allTools) {\n      const binding = allTools[toolId].keybinding;\n      if (!binding) continue;\n      // `KeyBinding.key` may be an array of aliases: one binding per key.\n      const keys = typeof binding.key === 'string' ? [binding.key] : binding.key;\n      for (const key of keys) {\n        if (!key) continue;\n        specs.push({ toolId, keyOpts: { ...binding, key } });\n      }\n    }\n\n    const unregisters: Array<() => void> = [];\n\n    if (specs.length > 0) {\n      const bindings = buildToolActivateBindings(specs);\n      unregisters.push(registry.register(makeToolActivateAction(\n        bindings,\n        (toolId) => optionsRef.current.isToolEligible?.(toolId) ?? true,\n      )));\n    }\n\n    // Escape-returns-to-default. Registered here rather than in the deleted\n    // document listener so it competes in the dispatcher's Escape ladder\n    // instead of firing in parallel with it — see\n    // `makeToolResetToDefaultAction` for the ordering and the behavior\n    // change that implies.\n    unregisters.push(registry.register(makeToolResetToDefaultAction(() => {\n      const opt = optionsRef.current.defaultTool;\n      if (opt === null) return null;\n      const target = opt ?? initialActiveRef.current;\n      if (!target) return null;\n      const api = toolsRef.current;\n      if (!api.has(target) || api.active === target) return null;\n      return target;\n    })));\n\n    return () => { for (const u of unregisters) u(); };\n  }, [registry, tools, toolsRef, optionsRef, disable]);\n}\n\n"],"mappings":";;;;;;AAmCA,SAAgBA,EACd,GACA,IAAiC,CAAC,GAC5B;CACN,IAAMC,IAAWC,EAAUC,CAAK,GAC1BC,IAAaF,EAAUG,CAAO,GAI9BC,IAAmBC,EAAOJ,EAAM,MAAM,GAItCK,IAAWC,EAAmB,GAU9B,EAAE,aAAU,OAAUJ;CAC5B,QAAgB;EAId,IAHIK,KACA,CAACF,KAED,OAAO,KAAKP,EAAS,QAAQ,QAAQ,CAAC,CAAC,WAAW,GAAG;EAEzD,IAAMU,IAAmC,CAAC,GAEpCC,IAAWX,EAAS,QAAQ;EAClC,KAAK,IAAMY,KAAUD,GAAU;GAC7B,IAAME,IAAUF,EAASC,EAAO,CAAC;GACjC,IAAI,CAACC,GAAS;GAEd,IAAMC,IAAO,OAAOD,EAAQ,OAAQ,WAAW,CAACA,EAAQ,GAAG,IAAIA,EAAQ;GACvE,KAAK,IAAME,KAAOD,GAChB,AAAKC,KACLL,EAAM,KAAK;IAAE;IAAQ,SAAS;KAAE,GAAGG;KAAS;IAAI;GAAE,CAAC;EAEvD;EAEA,IAAMG,IAAiC,CAAC;EAExC,IAAIN,EAAM,SAAS,GAAG;GACpB,IAAMO,IAAWC,EAA0BR,CAAK;GAChD,EAAY,KAAKH,EAAS,SAASY,EACjCF,IACC,MAAWd,EAAW,QAAQ,iBAAiBS,CAAM,KAAK,EAC7D,CAAC,CAAC;EACJ;EAiBA,OAVAI,EAAY,KAAKT,EAAS,SAASa,QAAmC;GACpE,IAAMC,IAAMlB,EAAW,QAAQ;GAC/B,IAAIkB,MAAQ,MAAM,OAAO;GACzB,IAAMC,IAASD,KAAOhB,EAAiB;GACvC,IAAI,CAACiB,GAAQ,OAAO;GACpB,IAAMC,IAAMvB,EAAS;GAErB,OADI,CAACuB,EAAI,IAAID,CAAM,KAAKC,EAAI,WAAWD,IAAe,OAC/CA;EACT,CAAC,CAAC,CAAC,SAEU;GAAE,KAAK,IAAME,KAAKR,GAAa,EAAE;EAAG;CACnD,GAAG;EAACT;EAAUL;EAAOF;EAAUG;EAAYM;CAAO,CAAC;AACrD"}
+{"version":3,"file":"useKeybindings.js","names":["useKeybindings","toolsRef","useLatest","tools","optionsRef","options","initialActiveRef","useRef","registry","useActionsRegistry","disable","specs","allTools","toolId","binding","keys","key","unregisters","bindings","buildToolActivateBindings","makeToolActivateAction","modes","tags","eligibleForMode","makeToolResetToDefaultAction","opt","target","api","u"],"sources":["../../src/tools/useKeybindings.ts"],"sourcesContent":["// src/tools/useKeybindings.ts\nimport { useEffect, useRef } from 'react';\nimport { useActionsRegistry } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport { eligibleForMode, type ModeRegistry } from '@weasel-js/modes';\nimport {\n  makeToolActivateAction,\n  buildToolActivateBindings,\n  type ToolActivateBindingSpec,\n} from 'interactions/actions/defaults/toolActivate';\nimport { makeToolResetToDefaultAction } from 'interactions/actions/defaults/toolResetToDefault';\nimport type { ToolsApi } from './overlayBinding';\n\n/** Options for `useKeybindings`. */\nexport interface UseKeybindingsOptions {\n  /** Skip all wiring. Useful for touch apps or test isolation. */\n  disable?: boolean;\n  /** Tool id Escape switches to. When omitted, defaults to whatever\n   *  `tools.active` was when the hook first ran (i.e. the initial active\n   *  tool). Pass `null` to disable Escape-returns-to-default behavior. */\n  defaultTool?: string | null;\n  /**\n   * The modes that gate keyboard tool activation: a key is refused when the\n   * active mode does not allow every tag in the tool's\n   * `eligibility.capabilities` — the predicate `ToolPalette` greys a button\n   * out by, so the grey-out is a guarantee rather than a hint. `<SceneCanvas>`\n   * passes its `modes` prop, whoever built the `ToolsApi`.\n   *\n   * Omit for consumers with no mode registry: every tool stays activatable.\n   */\n  modes?: ModeRegistry;\n}\n\n/** Wire the single-key tool-activation shortcuts (V, P, T, …) and Escape to\n *  return to the default tool. Activation is gated on what the active mode\n *  allows, so a key cannot reach a tool the palette greys out. */\nexport function useKeybindings(\n  tools: ToolsApi,\n  options: UseKeybindingsOptions = {},\n): void {\n  const toolsRef = useLatest(tools);\n  const optionsRef = useLatest(options);\n  // Snapshot the initial active tool — used as the Escape target when the\n  // consumer doesn't pass an explicit `defaultTool`. Captured in a ref\n  // (not state) so it survives re-renders without re-syncing.\n  const initialActiveRef = useRef(tools.active);\n\n  // Held-key engagement is not here: a tool declares `ToolDef.hotkey` and\n  // assembly registers `tool.offhand` from the declaration.\n  const registry = useActionsRegistry();\n\n  // --- Tool-activate: register one parametric `tool.activate` action.\n  // The single descriptor carries a `defaultBinding: BoundGesture[]` with one\n  // entry per tool — each entry pairs a key spec with `opts.params.toolId`.\n  // The invoker reads `params.toolId` and calls `setActive`. Imperative\n  // callers (palette, toolbar) reach the same effect via\n  // `registry.trigger('tool.activate', { toolId })`.\n  //\n  // Every key comes from a `ToolDef.keybinding` in the tools registry.\n  const { disable = false } = options;\n  useEffect(() => {\n    if (disable) return;\n    if (!registry) return;\n    // No tools, no tool keys: nothing to activate and nothing to return to.\n    if (Object.keys(toolsRef.current.registry).length === 0) return;\n\n    const specs: ToolActivateBindingSpec[] = [];\n\n    const allTools = toolsRef.current.registry;\n    for (const toolId in allTools) {\n      const binding = allTools[toolId].keybinding;\n      if (!binding) continue;\n      // `KeyBinding.key` may be an array of aliases: one binding per key.\n      const keys = typeof binding.key === 'string' ? [binding.key] : binding.key;\n      for (const key of keys) {\n        if (!key) continue;\n        specs.push({ toolId, keyOpts: { ...binding, key } });\n      }\n    }\n\n    const unregisters: Array<() => void> = [];\n\n    if (specs.length > 0) {\n      const bindings = buildToolActivateBindings(specs);\n      unregisters.push(registry.register(makeToolActivateAction(\n        bindings,\n        (toolId) => {\n          const modes = optionsRef.current.modes;\n          if (!modes) return true;\n          const tags = toolsRef.current.registry[toolId]?.eligibility.capabilities;\n          return eligibleForMode(modes.current(), tags ?? []);\n        },\n      )));\n    }\n\n    // Escape-returns-to-default. Registered here rather than in the deleted\n    // document listener so it competes in the dispatcher's Escape ladder\n    // instead of firing in parallel with it — see\n    // `makeToolResetToDefaultAction` for the ordering and the behavior\n    // change that implies.\n    unregisters.push(registry.register(makeToolResetToDefaultAction(() => {\n      const opt = optionsRef.current.defaultTool;\n      if (opt === null) return null;\n      const target = opt ?? initialActiveRef.current;\n      if (!target) return null;\n      const api = toolsRef.current;\n      if (!api.has(target) || api.active === target) return null;\n      return target;\n    })));\n\n    return () => { for (const u of unregisters) u(); };\n  }, [registry, tools, toolsRef, optionsRef, disable]);\n}\n\n"],"mappings":";;;;;;;AAoCA,SAAgBA,EACd,GACA,IAAiC,CAAC,GAC5B;CACN,IAAMC,IAAWC,EAAUC,CAAK,GAC1BC,IAAaF,EAAUG,CAAO,GAI9BC,IAAmBC,EAAOJ,EAAM,MAAM,GAItCK,IAAWC,EAAmB,GAU9B,EAAE,aAAU,OAAUJ;CAC5B,QAAgB;EAId,IAHIK,KACA,CAACF,KAED,OAAO,KAAKP,EAAS,QAAQ,QAAQ,CAAC,CAAC,WAAW,GAAG;EAEzD,IAAMU,IAAmC,CAAC,GAEpCC,IAAWX,EAAS,QAAQ;EAClC,KAAK,IAAMY,KAAUD,GAAU;GAC7B,IAAME,IAAUF,EAASC,EAAO,CAAC;GACjC,IAAI,CAACC,GAAS;GAEd,IAAMC,IAAO,OAAOD,EAAQ,OAAQ,WAAW,CAACA,EAAQ,GAAG,IAAIA,EAAQ;GACvE,KAAK,IAAME,KAAOD,GAChB,AAAKC,KACLL,EAAM,KAAK;IAAE;IAAQ,SAAS;KAAE,GAAGG;KAAS;IAAI;GAAE,CAAC;EAEvD;EAEA,IAAMG,IAAiC,CAAC;EAExC,IAAIN,EAAM,SAAS,GAAG;GACpB,IAAMO,IAAWC,EAA0BR,CAAK;GAChD,EAAY,KAAKH,EAAS,SAASY,EACjCF,IACC,MAAW;IACV,IAAMG,IAAQjB,EAAW,QAAQ;IACjC,IAAI,CAACiB,GAAO,OAAO;IACnB,IAAMC,IAAOrB,EAAS,QAAQ,SAASY,EAAO,EAAE,YAAY;IAC5D,OAAOU,EAAgBF,EAAM,QAAQ,GAAGC,KAAQ,CAAC,CAAC;GACpD,CACF,CAAC,CAAC;EACJ;EAiBA,OAVAL,EAAY,KAAKT,EAAS,SAASgB,QAAmC;GACpE,IAAMC,IAAMrB,EAAW,QAAQ;GAC/B,IAAIqB,MAAQ,MAAM,OAAO;GACzB,IAAMC,IAASD,KAAOnB,EAAiB;GACvC,IAAI,CAACoB,GAAQ,OAAO;GACpB,IAAMC,IAAM1B,EAAS;GAErB,OADI,CAAC0B,EAAI,IAAID,CAAM,KAAKC,EAAI,WAAWD,IAAe,OAC/CA;EACT,CAAC,CAAC,CAAC,SAEU;GAAE,KAAK,IAAME,KAAKX,GAAa,EAAE;EAAG;CACnD,GAAG;EAACT;EAAUL;EAAOF;EAAUG;EAAYM;CAAO,CAAC;AACrD"}