@weasel-js/core 1.8.0 → 1.9.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","pointer","offPointer","notify","fn","next","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 type { SliceDep, ViewApi } from 'interactions/actions/depSchema';\nimport type { PointerContextValue } from 'features/pointer/PointerContext';\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    let pointer: PointerContextValue | null = null;\n    let offPointer: (() => void) | null = null;\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      pointer: () => pointer,\n      follow(next: PointerContextValue | undefined): void {\n        if (!next || next === pointer) return;\n        offPointer?.();\n        pointer = next;\n        offPointer = next.subscribe(notify);\n      },\n      unfollow(): void {\n        offPointer?.();\n        offPointer = null;\n        pointer = null;\n      },\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 as SliceDep | undefined)?.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 as ViewApi | undefined)?.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 as PointerContextValue | undefined);\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          start: () => ({\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(endCtx.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","listeners","pointer","offPointer","notify","fn","next","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 type { PointerContextValue } from 'features/pointer/PointerContext';\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    let pointer: PointerContextValue | null = null;\n    let offPointer: (() => void) | null = null;\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      pointer: () => pointer,\n      follow(next: PointerContextValue | undefined): void {\n        if (!next || next === pointer) return;\n        offPointer?.();\n        pointer = next;\n        offPointer = next.subscribe(notify);\n      },\n      unfollow(): void {\n        offPointer?.();\n        offPointer = null;\n        pointer = null;\n      },\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          start: () => ({\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(endCtx.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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"}

package/dist/version.js

@@ -1,5 +1,5 @@
 //#region src/version.ts
-var e = "1.8.0";
+var e = "1.9.0";
 //#endregion
 export { e as VERSION };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weasel-js/core",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Domain-agnostic 2D scene graph primitives for React: viewport math, drag/resize/insert/clone interactions, layered canvas rendering.",
   "license": "MIT",
   "author": "orochi235",
@@ -85,22 +85,23 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "peerDependencies": {
-    "@weasel-js/font": "1.8.0",
+    "@weasel-js/font": "1.9.0",
     "react": ">=18"
   },
   "dependencies": {
-    "@msb235/blits": "0.4.0",
-    "@weasel-js/cursor": "1.8.0",
-    "@weasel-js/geom": "1.8.0",
-    "@weasel-js/gestures": "1.8.0",
-    "@weasel-js/history": "1.8.0",
-    "@weasel-js/modes": "1.8.0",
-    "@weasel-js/quantity": "1.8.0",
-    "@weasel-js/paint": "1.8.0",
-    "@weasel-js/react": "1.8.0",
-    "@weasel-js/registry": "1.8.0",
-    "@weasel-js/routing": "1.8.0",
-    "@weasel-js/text": "1.8.0",
+    "@msb235/blits": "0.6.0",
+    "@weasel-js/cursor": "1.9.0",
+    "@weasel-js/geom": "1.9.0",
+    "@weasel-js/gestures": "1.9.0",
+    "@weasel-js/history": "1.9.0",
+    "@weasel-js/modes": "1.9.0",
+    "@weasel-js/quantity": "1.9.0",
+    "@weasel-js/paint": "1.9.0",
+    "@weasel-js/react": "1.9.0",
+    "@weasel-js/registry": "1.9.0",
+    "@weasel-js/routing": "1.9.0",
+    "@weasel-js/select": "1.9.0",
+    "@weasel-js/text": "1.9.0",
     "earcut": "3.2.3",
     "polygon-clipping": "^0.15.7"
   },
@@ -118,7 +119,7 @@
     "2d"
   ],
   "devDependencies": {
-    "@weasel-js/modes": "1.8.0",
-    "@weasel-js/theme": "1.8.0"
+    "@weasel-js/modes": "1.9.0",
+    "@weasel-js/theme": "1.9.0"
   }
 }