@weasel-js/core 1.10.1 → 1.11.0

package/dist/interactions/actions/useStandardActions.js

@@ -1,169 +1,27 @@
-import { moveAction as e } from "./move/action.js";
-import { resizeAction as t } from "./resize/action.js";
-import { rotateAction as n } from "./rotate/action.js";
-import { areaSelectAction as r } from "./defaults/areaSelect.js";
-import { insertAction as i } from "./insert/action.js";
-import { insertRepositionAction as a } from "./insert/repositionAction.js";
-import { clearSelectionAction as o } from "./defaults/clearSelection.js";
-import { cloneAction as ee } from "./clone/action.js";
-import { viewportDragPanAction as te } from "./defaults/viewportDragPan.js";
-import { editAnchorsAction as ne } from "./edit-anchors/action.js";
-import { lassoSelectAction as re } from "./lasso-select/action.js";
-import { pinchZoomAction as s } from "./defaults/pinchZoom.js";
-import { deleteAction as c } from "./defaults/delete.js";
-import { ingestAction as l } from "./defaults/ingest.js";
-import { clipboardCopyAction as u, clipboardCutAction as d, clipboardPasteAction as f, clipboardPasteEventAction as p } from "./clipboard/action.js";
-import { enterTextEditAction as m } from "./defaults/enterTextEdit.js";
-import { escapeAction as h } from "./defaults/escape.js";
-import { cancelGestureAction as g } from "./defaults/cancelGesture.js";
-import { selectAllAction as _ } from "./defaults/selectAll.js";
-import { duplicateAction as v } from "./defaults/duplicate.js";
-import { nudgeDownAction as y, nudgeLeftAction as b, nudgeRightAction as x, nudgeUpAction as S } from "./defaults/nudge.js";
-import { transformAgainAction as C } from "./transform-again/action.js";
-import { groupAction as w, ungroupAction as T } from "./defaults/group.js";
-import { redoAction as E, undoAction as D } from "./defaults/undoRedo.js";
-import { flipAction as O } from "./flip/action.js";
-import { reorderBackwardAction as k, reorderForwardAction as A } from "./defaults/reorder.js";
-import { alignBottomAction as j, alignCenterXAction as M, alignCenterYAction as N, alignLeftAction as P, alignRightAction as F, alignTopAction as I } from "./align/action.js";
-import { distributeHorizontalAction as L, distributeVerticalAction as R } from "./distribute/action.js";
-import { pathfinderCropAction as z, pathfinderDivideAction as B, pathfinderExcludeAction as V, pathfinderIntersectAction as H, pathfinderMergeAction as U, pathfinderSubtractAction as W, pathfinderTrimAction as G, pathfinderUnionAction as K } from "./booleans/action.js";
-import { createOutlinesAction as ie } from "./outlines/createOutlinesAction.js";
-import { outlineStrokeAction as q } from "./outlines/outlineStrokeAction.js";
-import { insertRotateAction as J } from "./insert/rotateAction.js";
-import { enterPathEditAction as Y } from "./defaults/enterPathEdit.js";
-import { exitPathEditAction as ae } from "./defaults/exitPathEdit.js";
-import { insertPathAnchorAction as oe } from "./defaults/insertPathAnchor.js";
-import { bendSegmentAction as se } from "./defaults/bendSegment.js";
-import { cutPathAtAnchorAction as ce, deleteAnchorsAction as le, marqueeAnchorsAction as ue, nudgeAnchorsDownAction as de, nudgeAnchorsLeftAction as fe, nudgeAnchorsRightAction as pe, nudgeAnchorsUpAction as me, selectAnchorAction as he } from "./defaults/anchorEditing.js";
-import { makeHandlesSymmetricAction as ge, retractHandlesAction as _e } from "./defaults/anchorHandles.js";
-import { averageAnchorsAction as ve, joinAnchorsAction as ye } from "./defaults/anchorJoin.js";
-import { offsetPathAction as be, simplifyPathAction as xe } from "./pathCommands/simplifyOffset.js";
-import { joinPathsAction as Se, snipAtCrossingsAction as Ce } from "./pathCommands/cutJoin.js";
-import { setFillAction as X } from "./defaults/setFill.js";
-import { setStrokeAction as we } from "./defaults/setStroke.js";
-import { setFillOpacityAction as Te } from "./defaults/setFillOpacity.js";
-import { setStrokeOpacityAction as Ee } from "./defaults/setStrokeOpacity.js";
-import { useEffect as Z } from "react";
-import { useLatest as Q } from "@weasel-js/react";
-import "@weasel-js/routing";
-import { useActionsRegistry as De, useOptionalActiveToolContext as Oe, useOptionalDepRegistry as ke } from "@weasel-js/routing/react";
+import { KIT_STANDARD_ACTIONS } from "../../canvas/SceneCanvas/namedPresets.js";
+import { useActionSet, useStandardDeps } from "./useActionSet.js";
+
 //#region src/interactions/actions/useStandardActions.ts
-var $ = [
-	h,
-	g,
-	_,
-	v,
-	C,
-	me,
-	de,
-	fe,
-	pe,
-	le,
-	c,
-	w,
-	T,
-	D,
-	E,
-	O,
-	S,
-	y,
-	b,
-	x,
-	A,
-	k,
-	P,
-	M,
-	F,
-	I,
-	N,
-	j,
-	L,
-	R,
-	K,
-	W,
-	H,
-	V,
-	B,
-	z,
-	G,
-	U,
-	ie,
-	q,
-	e,
-	t,
-	n,
-	r,
-	i,
-	J,
-	a,
-	ee,
-	ne,
-	Y,
-	ae,
-	oe,
-	se,
-	ce,
-	_e,
-	ge,
-	ve,
-	ye,
-	xe,
-	be,
-	Ce,
-	Se,
-	ue,
-	he,
-	re,
-	s,
-	te,
-	o,
-	m,
-	X,
-	we,
-	Te,
-	Ee,
-	l,
-	d,
-	u,
-	f,
-	p
-], Ae = $.map((e) => e.id), je = { "clipboard.pasteEvent": "ingest" };
-function Me(e) {
-	let t = Q(e), n = Oe(), r = Q(n), i = ke();
-	Z(() => {
-		if (!i) return;
-		let e = [];
-		for (let n of [
-			"selection",
-			"view",
-			"scene",
-			"history"
-		]) e.push(i.register(n, () => t.current[n]));
-		return e.push(i.register("activeTool", () => t.current.activeTool ?? r.current)), () => {
-			for (let t of e) t();
-		};
-	}, [
-		i,
-		t,
-		r
-	]);
-	let a = De(), o = e.exclude ? [...e.exclude].join("\0") : "";
-	Z(() => {
-		if (!a || !i) return;
-		let e = new Set(o ? o.split("\0") : []), t = $.filter((t) => !e.has(t.id)).filter((t) => {
-			let n = je[t.id];
-			return n === void 0 || e.has(n);
-		}).map((e) => a.register(e));
-		return () => {
-			for (let e of t) e();
-		};
-	}, [
-		a,
-		i,
-		o
-	]);
+/** Every id `useStandardActions` can register, each core preset's in turn and
+*  then the tool-driven ones. It holds `clipboard.pasteEvent` back while
+*  `ingest` is registered. */
+var KIT_STANDARD_ACTION_IDS = KIT_STANDARD_ACTIONS.map((a) => a.id);
+/**
+* Register each kit-standard dep source and action descriptor into the
+* surrounding `<ActionsProvider>` and `<DepRegistryProvider>` (typically
+* provided by `<SceneCanvas>`); a silent no-op when either is absent.
+*
+* Each dep option is published as a live source in the dep registry under its
+* canonical name (`selection`, `scene`, …). The source reads the latest
+* option value at invocation time, so consumers don't have to memoize their
+* dep objects.
+*/
+function useStandardActions(opts) {
+	const { actions = KIT_STANDARD_ACTIONS, exclude, ...deps } = opts;
+	useStandardDeps(deps);
+	useActionSet(actions, exclude);
 }
-//#endregion
-export { Ae as KIT_STANDARD_ACTION_IDS, Me as useStandardActions };
 
+//#endregion
+export { KIT_STANDARD_ACTION_IDS, useStandardActions };
 //# sourceMappingURL=useStandardActions.js.map

package/dist/interactions/actions/useStandardActions.js.map

@@ -1 +1 @@
-{"version":3,"file":"useStandardActions.js","names":["KIT_STANDARD_DESCRIPTORS","escapeAction","cancelGestureAction","selectAllAction","duplicateAction","transformAgainAction","nudgeAnchorsUpAction","nudgeAnchorsDownAction","nudgeAnchorsLeftAction","nudgeAnchorsRightAction","deleteAnchorsAction","deleteAction","groupAction","ungroupAction","undoAction","redoAction","flipAction","nudgeUpAction","nudgeDownAction","nudgeLeftAction","nudgeRightAction","reorderForwardAction","reorderBackwardAction","alignLeftAction","alignCenterXAction","alignRightAction","alignTopAction","alignCenterYAction","alignBottomAction","distributeHorizontalAction","distributeVerticalAction","pathfinderUnionAction","pathfinderSubtractAction","pathfinderIntersectAction","pathfinderExcludeAction","pathfinderDivideAction","pathfinderCropAction","pathfinderTrimAction","pathfinderMergeAction","createOutlinesAction","outlineStrokeAction","moveAction","resizeAction","rotateAction","areaSelectAction","insertAction","insertRotateAction","insertRepositionAction","cloneAction","editAnchorsAction","enterPathEditAction","exitPathEditAction","insertPathAnchorAction","bendSegmentAction","cutPathAtAnchorAction","retractHandlesAction","makeHandlesSymmetricAction","averageAnchorsAction","joinAnchorsAction","simplifyPathAction","offsetPathAction","snipAtCrossingsAction","joinPathsAction","marqueeAnchorsAction","selectAnchorAction","lassoSelectAction","pinchZoomAction","viewportDragPanAction","clearSelectionAction","enterTextEditAction","setFillAction","setStrokeAction","setFillOpacityAction","setStrokeOpacityAction","ingestAction","clipboardCutAction","clipboardCopyAction","clipboardPasteAction","clipboardPasteEventAction","KIT_STANDARD_ACTION_IDS","a","YIELDS_TO","useStandardActions","optsRef","useLatest","opts","activeToolCtx","useOptionalActiveToolContext","activeToolCtxRef","depReg","useOptionalDepRegistry","unregisters","key","u","reg","useActionsRegistry","excludeKey","excluded","over"],"sources":["../../../src/interactions/actions/useStandardActions.ts"],"sourcesContent":["/**\n * @experimental\n * `useStandardActions` — register the kit-standard action descriptors into the\n * nearest `<ActionsProvider>` and publish dep sources into the nearest\n * `<DepRegistryProvider>`. Falls back silently to a no-op when either is\n * not in scope.\n */\nimport { useEffect } from 'react';\nimport type { Action } from '@weasel-js/routing';\nimport { useActionsRegistry } from '@weasel-js/routing/react';\nimport { useLatest } from '@weasel-js/react';\nimport { type DepName, type DepSchema } from '@weasel-js/routing';\nimport { useOptionalDepRegistry } from '@weasel-js/routing/react';\n// Reaches depSchema.ts so tsup's per-entry dts compiler resolves `DepSchema['selection']`\n// here; `tsc --noEmit` happens to pick it up via test files, tsup does not. It MUST be\n// `import type` — a bare `import './depSchema'` makes esbuild emit a runtime import that it\n// then drops under the package's `sideEffects: false`, warning on every build.\nimport type {} from './depSchema';\nimport { useOptionalActiveToolContext } from '@weasel-js/routing/react';\n\nimport { escapeAction } from './defaults/escape';\nimport { cancelGestureAction } from './defaults/cancelGesture';\nimport { selectAllAction } from './defaults/selectAll';\nimport { deleteAction } from './defaults/delete';\nimport { duplicateAction } from './defaults/duplicate';\nimport { transformAgainAction } from './transform-again/action';\nimport { groupAction, ungroupAction } from './defaults/group';\nimport { undoAction, redoAction } from './defaults/undoRedo';\nimport { flipAction } from './flip/action';\nimport {\n  nudgeUpAction, nudgeDownAction, nudgeLeftAction, nudgeRightAction,\n} from './defaults/nudge';\nimport { reorderForwardAction, reorderBackwardAction } from './defaults/reorder';\nimport {\n  alignLeftAction, alignRightAction, alignTopAction, alignBottomAction,\n  alignCenterXAction, alignCenterYAction,\n} from './align/action';\nimport {\n  distributeHorizontalAction, distributeVerticalAction,\n} from './distribute/action';\nimport {\n  pathfinderUnionAction, pathfinderSubtractAction, pathfinderIntersectAction,\n  pathfinderExcludeAction, pathfinderDivideAction, pathfinderCropAction,\n  pathfinderTrimAction, pathfinderMergeAction,\n} from './booleans/action';\nimport { createOutlinesAction } from './outlines/createOutlinesAction';\nimport { outlineStrokeAction } from './outlines/outlineStrokeAction';\nimport { moveAction } from './move/action';\nimport { resizeAction } from './resize/action';\nimport { rotateAction } from './rotate/action';\nimport { areaSelectAction } from './defaults/areaSelect';\nimport { insertAction } from './insert/action';\nimport { insertRotateAction } from './insert/rotateAction';\nimport { insertRepositionAction } from './insert/repositionAction';\nimport { clearSelectionAction } from './defaults/clearSelection';\nimport { cloneAction } from './clone/action';\nimport { editAnchorsAction } from './edit-anchors/action';\nimport { enterPathEditAction } from './defaults/enterPathEdit';\nimport { exitPathEditAction } from './defaults/exitPathEdit';\nimport { insertPathAnchorAction } from './defaults/insertPathAnchor';\nimport { bendSegmentAction } from './defaults/bendSegment';\nimport { makeHandlesSymmetricAction, retractHandlesAction } from './defaults/anchorHandles';\nimport { averageAnchorsAction, joinAnchorsAction } from './defaults/anchorJoin';\nimport {\n  joinPathsAction, offsetPathAction, simplifyPathAction, snipAtCrossingsAction,\n} from './pathCommands';\nimport {\n  nudgeAnchorsUpAction,\n  nudgeAnchorsDownAction,\n  nudgeAnchorsLeftAction,\n  nudgeAnchorsRightAction,\n  deleteAnchorsAction,\n  cutPathAtAnchorAction,\n  marqueeAnchorsAction,\n  selectAnchorAction,\n} from './defaults/anchorEditing';\nimport { lassoSelectAction } from './lasso-select/action';\nimport { pinchZoomAction } from './defaults/pinchZoom';\nimport { viewportDragPanAction } from './defaults/viewportDragPan';\nimport { enterTextEditAction } from './defaults/enterTextEdit';\nimport { setFillAction } from './defaults/setFill';\nimport { setStrokeAction } from './defaults/setStroke';\nimport { setFillOpacityAction } from './defaults/setFillOpacity';\nimport { setStrokeOpacityAction } from './defaults/setStrokeOpacity';\nimport { ingestAction } from './defaults/ingest';\nimport {\n  clipboardCopyAction, clipboardCutAction, clipboardPasteAction, clipboardPasteEventAction,\n} from './clipboard/action';\n\n/** @experimental */\nexport interface UseStandardActionsOptions {\n  /** Kit selection state — ids of currently selected nodes. */\n  selection?: DepSchema['selection'];\n  /** Current viewport — camera position + scale. */\n  view?: DepSchema['view'];\n  /** Scene tree — structural reads + undoable mutations. */\n  scene?: DepSchema['scene'];\n  /** Undo/redo history bound to the current scene. */\n  history?: DepSchema['history'];\n  /** Currently active tool id + hotkey-hold stack. */\n  activeTool?: DepSchema['activeTool'];\n  /**\n   * Ids of kit-standard actions to leave unregistered, so a consumer can bind\n   * its own. Ids that name no kit action are ignored;\n   * `KIT_STANDARD_ACTION_IDS` is the full list.\n   */\n  exclude?: Iterable<string>;\n}\n\n/**\n * The ordered list of all kit-standard action descriptors. `viewport.pan`\n * and `viewport.zoom` are NOT in this list — they're registered conditionally\n * by SceneCanvas's `useViewportActions` based on the `viewport.pan` /\n * `viewport.zoom` flags.\n */\nconst KIT_STANDARD_DESCRIPTORS: Action[] = [\n  escapeAction,\n  cancelGestureAction,\n  selectAllAction,\n  duplicateAction,\n  transformAgainAction,\n  // Ahead of their node-level twins: with no mode registry nothing filters\n  // by capability, so a keystroke goes to the first of these that is enabled.\n  nudgeAnchorsUpAction,\n  nudgeAnchorsDownAction,\n  nudgeAnchorsLeftAction,\n  nudgeAnchorsRightAction,\n  deleteAnchorsAction,\n  deleteAction,\n  groupAction,\n  ungroupAction,\n  undoAction,\n  redoAction,\n  flipAction,\n  nudgeUpAction,\n  nudgeDownAction,\n  nudgeLeftAction,\n  nudgeRightAction,\n  reorderForwardAction,\n  reorderBackwardAction,\n  alignLeftAction,\n  alignCenterXAction,\n  alignRightAction,\n  alignTopAction,\n  alignCenterYAction,\n  alignBottomAction,\n  distributeHorizontalAction,\n  distributeVerticalAction,\n  pathfinderUnionAction,\n  pathfinderSubtractAction,\n  pathfinderIntersectAction,\n  pathfinderExcludeAction,\n  pathfinderDivideAction,\n  pathfinderCropAction,\n  pathfinderTrimAction,\n  pathfinderMergeAction,\n  createOutlinesAction,\n  outlineStrokeAction,\n  moveAction,\n  resizeAction,\n  rotateAction,\n  areaSelectAction,\n  insertAction,\n  insertRotateAction,\n  insertRepositionAction,\n  cloneAction,\n  editAnchorsAction,\n  enterPathEditAction,\n  exitPathEditAction,\n  insertPathAnchorAction,\n  bendSegmentAction,\n  cutPathAtAnchorAction,\n  retractHandlesAction,\n  makeHandlesSymmetricAction,\n  averageAnchorsAction,\n  joinAnchorsAction,\n  simplifyPathAction,\n  offsetPathAction,\n  snipAtCrossingsAction,\n  joinPathsAction,\n  marqueeAnchorsAction,\n  selectAnchorAction,\n  lassoSelectAction,\n  pinchZoomAction,\n  viewportDragPanAction,\n  clearSelectionAction,\n  enterTextEditAction,\n  setFillAction,\n  setStrokeAction,\n  setFillOpacityAction,\n  setStrokeOpacityAction,\n  ingestAction,\n  clipboardCutAction,\n  clipboardCopyAction,\n  clipboardPasteAction,\n  clipboardPasteEventAction,\n];\n\n/** Every id `useStandardActions` can register, in registration order. It\n *  holds `clipboard.pasteEvent` back unless `ingest` is excluded. */\nexport const KIT_STANDARD_ACTION_IDS: readonly string[] =\n  KIT_STANDARD_DESCRIPTORS.map((a) => a.id);\n\n/**\n * Kit-standard actions that stay unregistered while another one is\n * registered, because that one binds the same gesture and does everything\n * this one does: both answering it would act twice. Keyed by the action that\n * yields.\n */\nconst YIELDS_TO: Readonly<Record<string, string>> = {\n  'clipboard.pasteEvent': 'ingest',\n};\n\n/**\n * @experimental\n * Register each kit-standard dep source and action descriptor into the\n * surrounding `<ActionsProvider>` and `<DepRegistryProvider>` (typically\n * provided by `<SceneCanvas>`); a silent no-op when either is absent.\n *\n * Each option is published as a live source in the dep registry under its\n * canonical name (`selection`, `scene`, …). The source reads the latest\n * option value at invocation time, so consumers don't have to memoize their\n * dep objects.\n */\nexport function useStandardActions(opts: UseStandardActionsOptions): void {\n  // --- Stabilize opts via ref ---\n  const optsRef = useLatest(opts);\n\n  // --- activeTool fallback: read from context when not supplied in opts ---\n  const activeToolCtx = useOptionalActiveToolContext();\n  const activeToolCtxRef = useLatest(activeToolCtx);\n\n  // --- Dep source registration ---\n  const depReg = useOptionalDepRegistry();\n\n  useEffect(() => {\n    if (!depReg) return;\n    const unregisters: Array<() => void> = [];\n    const keys = ['selection', 'view', 'scene', 'history'] as const;\n    for (const key of keys) {\n      unregisters.push(\n        depReg.register(key as DepName, () => optsRef.current[key] as DepSchema[DepName]),\n      );\n    }\n    // activeTool: prefer the explicit opt; fall back to the context value so\n    // SceneCanvas doesn't need to thread it through StandardActionsRegistrar.\n    unregisters.push(\n      depReg.register('activeTool' as DepName, () =>\n        (optsRef.current.activeTool ?? activeToolCtxRef.current) as DepSchema[DepName],\n      ),\n    );\n    return () => { for (const u of unregisters) u(); };\n  }, [depReg, optsRef, activeToolCtxRef]);\n\n  // --- Action descriptor registration ---\n  const reg = useActionsRegistry();\n\n  // Joined so a fresh array of the same ids does not re-register every render.\n  const excludeKey = opts.exclude ? [...opts.exclude].join('\\u0000') : '';\n\n  useEffect(() => {\n    if (!reg || !depReg) return;\n    const excluded = new Set(excludeKey ? excludeKey.split('\\u0000') : []);\n    const unregisters = KIT_STANDARD_DESCRIPTORS\n      .filter((a) => !excluded.has(a.id))\n      .filter((a) => {\n        const over = YIELDS_TO[a.id];\n        return over === undefined || excluded.has(over);\n      })\n      .map((a) => reg.register(a));\n    return () => { for (const u of unregisters) u(); };\n  }, [reg, depReg, excludeKey]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmHA,IAAMA,IAAqC;CACzCC;CACAC;CACAC;CACAC;CACAC;CAGAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;CACAC;AACF,GAIaC,KACX/E,EAAyB,KAAK,MAAMgF,EAAE,EAAE,GAQpCC,KAA8C,EAClD,wBAAwB,SAC1B;AAaA,SAAgBC,GAAmB,GAAuC;CAExE,IAAMC,IAAUC,EAAUC,CAAI,GAGxBC,IAAgBC,GAA6B,GAC7CC,IAAmBJ,EAAUE,CAAa,GAG1CG,IAASC,GAAuB;CAEtC,QAAgB;EACd,IAAI,CAACD,GAAQ;EACb,IAAME,IAAiC,CAAC;EAExC,KAAK,IAAMC,KAAO;GADJ;GAAa;GAAQ;GAAS;EAC1B,GAChB,EAAY,KACVH,EAAO,SAASG,SAAsBT,EAAQ,QAAQS,EAA0B,CAClF;EASF,OALAD,EAAY,KACVF,EAAO,SAAS,oBACbN,EAAQ,QAAQ,cAAcK,EAAiB,OAClD,CACF,SACa;GAAE,KAAK,IAAMK,KAAKF,GAAa,EAAE;EAAG;CACnD,GAAG;EAACF;EAAQN;EAASK;CAAgB,CAAC;CAGtC,IAAMM,IAAMC,GAAmB,GAGzBC,IAAaX,EAAK,UAAU,CAAC,GAAGA,EAAK,OAAO,CAAC,CAAC,KAAK,IAAQ,IAAI;CAErE,QAAgB;EACd,IAAI,CAACS,KAAO,CAACL,GAAQ;EACrB,IAAMQ,IAAW,IAAI,IAAID,IAAaA,EAAW,MAAM,IAAQ,IAAI,CAAC,CAAC,GAC/DL,IAAc3F,EACjB,QAAQ,MAAM,CAACiG,EAAS,IAAIjB,EAAE,EAAE,CAAC,CAAC,CAClC,QAAQ,MAAM;GACb,IAAMkB,IAAOjB,GAAUD,EAAE;GACzB,OAAOkB,MAAS,KAAA,KAAaD,EAAS,IAAIC,CAAI;EAChD,CAAC,CAAC,CACD,KAAK,MAAMJ,EAAI,SAASd,CAAC,CAAC;EAC7B,aAAa;GAAE,KAAK,IAAMa,KAAKF,GAAa,EAAE;EAAG;CACnD,GAAG;EAACG;EAAKL;EAAQO;CAAU,CAAC;AAC9B"}
+{"version":3,"file":"useStandardActions.js","names":[],"sources":["../../../src/interactions/actions/useStandardActions.ts"],"sourcesContent":["/**\n * `useStandardActions` — register the kit-standard action descriptors into the\n * nearest `<ActionsProvider>` and publish dep sources into the nearest\n * `<DepRegistryProvider>`. Falls back silently to a no-op when either is\n * not in scope.\n */\nimport type { Action } from '@weasel-js/routing';\nimport { KIT_STANDARD_ACTIONS } from '../../canvas/SceneCanvas/namedPresets';\nimport { useActionSet, useStandardDeps, type StandardDeps } from './useActionSet';\n\n/** Options for `useStandardActions`: which actions to register, and the deps they read. */\nexport interface UseStandardActionsOptions extends StandardDeps {\n  /**\n   * The actions to register, in order. Default: every kit-standard action\n   * (`KIT_STANDARD_ACTION_IDS`). A preset's `actions` is a set in this form.\n   */\n  actions?: readonly Action[];\n  /**\n   * Ids of kit-standard actions to leave unregistered, so a consumer can bind\n   * its own. Ids that name no kit action are ignored;\n   * `KIT_STANDARD_ACTION_IDS` is the full list.\n   */\n  exclude?: Iterable<string>;\n}\n\n/** Every id `useStandardActions` can register, each core preset's in turn and\n *  then the tool-driven ones. It holds `clipboard.pasteEvent` back while\n *  `ingest` is registered. */\nexport const KIT_STANDARD_ACTION_IDS: readonly string[] = KIT_STANDARD_ACTIONS.map((a) => a.id);\n\n/**\n * Register each kit-standard dep source and action descriptor into the\n * surrounding `<ActionsProvider>` and `<DepRegistryProvider>` (typically\n * provided by `<SceneCanvas>`); a silent no-op when either is absent.\n *\n * Each dep option is published as a live source in the dep registry under its\n * canonical name (`selection`, `scene`, …). The source reads the latest\n * option value at invocation time, so consumers don't have to memoize their\n * dep objects.\n */\nexport function useStandardActions(opts: UseStandardActionsOptions): void {\n  const { actions = KIT_STANDARD_ACTIONS, exclude, ...deps } = opts;\n  useStandardDeps(deps);\n  useActionSet(actions, exclude);\n}\n"],"mappings":";;;;;;;AA4BA,IAAa,0BAA6C,qBAAqB,KAAK,MAAM,EAAE,EAAE;;;;;;;;;;;AAY9F,SAAgB,mBAAmB,MAAuC;CACxE,MAAM,EAAE,UAAU,sBAAsB,SAAS,GAAG,SAAS;CAC7D,gBAAgB,IAAI;CACpB,aAAa,SAAS,OAAO;AAC/B"}

package/dist/interactions/gestures/dragGesture/dragGesture.js

@@ -1,108 +1,149 @@
-import { useCallback as e, useMemo as t, useRef as n, useState as r } from "react";
-import { useLatest as i } from "@weasel-js/react";
+import { useCallback, useMemo, useRef, useState } from "react";
+import { useLatest } from "@weasel-js/react";
+
 //#region src/interactions/gestures/dragGesture/dragGesture.ts
-function a(a = {}) {
-	let o = i(a), s = n(null), [, c] = r(0), l = n("idle"), u = e((e) => {
-		l.current = e, c((e) => e + 1);
-	}, []), d = e(() => {
-		let e = s.current;
+/**
+* The base drag primitive: tracks a pointer from press to release, with an
+* optional threshold below which the gesture stays pending and commits
+* nothing.
+*
+* It is a gesture and only a gesture — it says where the pointer went, never
+* what that should do. `useDragRect` and `useDragRadial` build on it, and
+* actions decide what to make of the result.
+*/
+function useDragGesture(options = {}) {
+	const optsRef = useLatest(options);
+	const stateRef = useRef(null);
+	const [, setPhaseTick] = useState(0);
+	const phaseRef = useRef("idle");
+	const bumpPhase = useCallback((next) => {
+		phaseRef.current = next;
+		setPhaseTick((n) => n + 1);
+	}, []);
+	const buildCtx = useCallback(() => {
+		const s = stateRef.current;
 		return {
 			get start() {
-				return e.start;
+				return s.start;
 			},
 			get current() {
-				return e.current;
+				return s.current;
 			},
 			get modifiers() {
-				return e.modifiers;
+				return s.modifiers;
 			},
 			get scratch() {
-				return e.scratch;
+				return s.scratch;
 			},
 			get phase() {
-				return e.phase;
+				return s.phase;
 			}
 		};
-	}, []), f = e((e, t) => {
-		let n = o.current, r = n.initScratch ? n.initScratch() : {}, i = n.thresholdReached ? "pending" : "active", a = s.current !== null;
-		s.current = {
-			phase: i,
-			start: e,
-			current: e,
-			modifiers: t,
-			scratch: r
-		}, u(i), a || n.onGestureStart?.(), n.onStart?.(d());
+	}, []);
+	const start = useCallback((point, modifiers) => {
+		const opts = optsRef.current;
+		const scratch = opts.initScratch ? opts.initScratch() : {};
+		const initialPhase = opts.thresholdReached ? "pending" : "active";
+		const restart = stateRef.current !== null;
+		stateRef.current = {
+			phase: initialPhase,
+			start: point,
+			current: point,
+			modifiers,
+			scratch
+		};
+		bumpPhase(initialPhase);
+		if (!restart) opts.onGestureStart?.();
+		opts.onStart?.(buildCtx());
 	}, [
-		d,
-		u,
-		o
-	]), p = e((e, t) => {
-		let n = s.current;
-		if (!n) return !1;
-		n.current = e, n.modifiers = t;
-		let r = o.current;
-		if (n.phase === "pending" && r.thresholdReached) {
-			let e = d();
-			r.thresholdReached(e) && (n.phase = "active", u("active"), r.onActivate?.(d()));
+		buildCtx,
+		bumpPhase,
+		optsRef
+	]);
+	const move = useCallback((point, modifiers) => {
+		const s = stateRef.current;
+		if (!s) return false;
+		s.current = point;
+		s.modifiers = modifiers;
+		const opts = optsRef.current;
+		if (s.phase === "pending" && opts.thresholdReached) {
+			const ctx = buildCtx();
+			if (opts.thresholdReached(ctx)) {
+				s.phase = "active";
+				bumpPhase("active");
+				opts.onActivate?.(buildCtx());
+			}
 		}
-		return r.onMove?.(d()), !0;
+		opts.onMove?.(buildCtx());
+		return true;
 	}, [
-		d,
-		u,
-		o
-	]), m = e(() => {
-		let e = s.current, t = o.current;
-		if (!e) return;
-		let n = {
+		buildCtx,
+		bumpPhase,
+		optsRef
+	]);
+	const end = useCallback(() => {
+		const s = stateRef.current;
+		const opts = optsRef.current;
+		if (!s) return;
+		const endCtx = {
 			get start() {
-				return e.start;
+				return s.start;
 			},
 			get current() {
-				return e.current;
+				return s.current;
 			},
 			get modifiers() {
-				return e.modifiers;
+				return s.modifiers;
 			},
 			get scratch() {
-				return e.scratch;
+				return s.scratch;
 			},
 			get phase() {
-				return e.phase;
+				return s.phase;
 			},
-			wasSubThreshold: e.phase === "pending"
-		}, r = !1;
+			wasSubThreshold: s.phase === "pending"
+		};
+		let committed = false;
 		try {
-			r = t.onEnd?.(n) !== !1;
+			committed = opts.onEnd?.(endCtx) !== false;
 		} finally {
-			s.current = null, u("idle"), t.onGestureEnd?.(r);
+			stateRef.current = null;
+			bumpPhase("idle");
+			opts.onGestureEnd?.(committed);
 		}
-	}, [u, o]), h = e(() => {
-		let e = s.current, t = o.current;
-		e && (t.onCancel?.(d()), s.current = null, u("idle"), t.onGestureEnd?.(!1));
+	}, [bumpPhase, optsRef]);
+	const cancel = useCallback(() => {
+		const s = stateRef.current;
+		const opts = optsRef.current;
+		if (!s) return;
+		opts.onCancel?.(buildCtx());
+		stateRef.current = null;
+		bumpPhase("idle");
+		opts.onGestureEnd?.(false);
 	}, [
-		d,
-		u,
-		o
+		buildCtx,
+		bumpPhase,
+		optsRef
 	]);
-	return t(() => ({
-		start: f,
-		move: p,
-		end: m,
-		cancel: h,
+	return useMemo(() => ({
+		start,
+		move,
+		end,
+		cancel,
 		get phase() {
-			return l.current;
+			return phaseRef.current;
 		},
 		get isActive() {
-			return l.current !== "idle";
+			return phaseRef.current !== "idle";
 		}
 	}), [
-		f,
-		p,
-		m,
-		h
+		start,
+		move,
+		end,
+		cancel
 	]);
 }
-//#endregion
-export { a as useDragGesture };
 
+//#endregion
+export { useDragGesture };
 //# sourceMappingURL=dragGesture.js.map

package/dist/interactions/gestures/dragGesture/dragGesture.js.map

@@ -1 +1 @@
-{"version":3,"file":"dragGesture.js","names":["useDragGesture","optsRef","useLatest","options","stateRef","useRef","setPhaseTick","useState","phaseRef","bumpPhase","useCallback","next","n","buildCtx","s","start","opts","scratch","initialPhase","restart","point","move","modifiers","ctx","end","endCtx","committed","cancel","useMemo"],"sources":["../../../../src/interactions/gestures/dragGesture/dragGesture.ts"],"sourcesContent":["import { useCallback, useMemo, useRef, useState } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { ModifierState } from '../types';\n\n/** Pointer position in both world (gesture-coord) and client (CSS-px) space. */\nexport interface DragGesturePoint {\n  worldX: number;\n  worldY: number;\n  clientX: number;\n  clientY: number;\n}\n\n/** Phase exposed on the public controller and inside ctx for callbacks. */\nexport type DragGesturePhase = 'idle' | 'pending' | 'active';\n\n/** Live gesture context handed to lifecycle callbacks. Within callbacks, ctx\n *  reflects the moment the callback fires (e.g. ctx.phase is 'active' inside\n *  onActivate, even though the move that triggered it was during 'pending'). */\nexport interface DragGestureCtx<TScratch = unknown> {\n  start: DragGesturePoint;\n  current: DragGesturePoint;\n  modifiers: ModifierState;\n  scratch: TScratch;\n  /** 'pending' or 'active'. Never 'idle' inside a callback. */\n  phase: 'pending' | 'active';\n}\n\n/** The context handed to `onEnd`, adding whether the gesture ever passed its\n *  activation threshold. */\nexport interface DragGestureEndCtx<TScratch = unknown>\n  extends DragGestureCtx<TScratch> {\n  /** True if phase never reached 'active'. Wrappers without thresholdReached\n   *  always see false here (their gesture activates at start()). */\n  wasSubThreshold: boolean;\n}\n\n/** Options for `useDragGesture`: when the gesture becomes active, and what to\n *  do at each point in its lifecycle. */\nexport interface UseDragGestureOptions<TScratch = unknown> {\n  initScratch?: () => TScratch;\n  /** Predicate consulted on each move while phase === 'pending'. Return true\n   *  to transition to 'active'. The transition fires onActivate before the\n   *  triggering move's onMove. When omitted, gesture activates at start(). */\n  thresholdReached?: (ctx: DragGestureCtx<TScratch>) => boolean;\n  onStart?: (ctx: DragGestureCtx<TScratch>) => void;\n  onActivate?: (ctx: DragGestureCtx<TScratch>) => void;\n  onMove?: (ctx: DragGestureCtx<TScratch>) => void;\n  onEnd?: (ctx: DragGestureEndCtx<TScratch>) => boolean | void;\n  onCancel?: (ctx: DragGestureCtx<TScratch>) => void;\n  /** Fired when a gesture opens. A `start()` that replaces a live gesture\n   *  does not fire it again. */\n  onGestureStart?: () => void;\n  /** Fired once per `onGestureStart`, when that gesture ends or cancels. */\n  onGestureEnd?: (committed: boolean) => void;\n}\n\n/** Drives a drag gesture. The owner feeds it pointer positions; it decides\n *  when the drag has really begun and calls back accordingly. */\nexport interface DragGestureController {\n  start(point: DragGesturePoint, modifiers: ModifierState): void;\n  move(point: DragGesturePoint, modifiers: ModifierState): boolean;\n  end(): void;\n  cancel(): void;\n  readonly phase: DragGesturePhase;\n  readonly isActive: boolean;\n}\n\ninterface InternalState<TScratch> {\n  phase: 'pending' | 'active';\n  start: DragGesturePoint;\n  current: DragGesturePoint;\n  modifiers: ModifierState;\n  scratch: TScratch;\n}\n\n/**\n * The base drag primitive: tracks a pointer from press to release, with an\n * optional threshold below which the gesture stays pending and commits\n * nothing.\n *\n * It is a gesture and only a gesture — it says where the pointer went, never\n * what that should do. `useDragRect` and `useDragRadial` build on it, and\n * actions decide what to make of the result.\n */\nexport function useDragGesture<TScratch = unknown>(\n  options: UseDragGestureOptions<TScratch> = {},\n): DragGestureController {\n  const optsRef = useLatest(options);\n  const stateRef = useRef<InternalState<TScratch> | null>(null);\n  const [, setPhaseTick] = useState(0);\n  const phaseRef = useRef<DragGesturePhase>('idle');\n  const bumpPhase = useCallback((next: DragGesturePhase) => {\n    phaseRef.current = next;\n    setPhaseTick((n) => n + 1);\n  }, []);\n\n  const buildCtx = useCallback((): DragGestureCtx<TScratch> => {\n    const s = stateRef.current!;\n    return {\n      get start() { return s.start; },\n      get current() { return s.current; },\n      get modifiers() { return s.modifiers; },\n      get scratch() { return s.scratch; },\n      get phase() { return s.phase; },\n    };\n  }, []);\n\n  const start = useCallback((point: DragGesturePoint, modifiers: ModifierState) => {\n    const opts = optsRef.current;\n    const scratch = opts.initScratch ? opts.initScratch() : ({} as TScratch);\n    const initialPhase: 'pending' | 'active' = opts.thresholdReached ? 'pending' : 'active';\n    const restart = stateRef.current !== null;\n    stateRef.current = {\n      phase: initialPhase,\n      start: point,\n      current: point,\n      modifiers,\n      scratch,\n    };\n    bumpPhase(initialPhase);\n    if (!restart) opts.onGestureStart?.();\n    opts.onStart?.(buildCtx());\n  }, [buildCtx, bumpPhase, optsRef]);\n\n  const move = useCallback((point: DragGesturePoint, modifiers: ModifierState): boolean => {\n    const s = stateRef.current;\n    if (!s) return false;\n    s.current = point;\n    s.modifiers = modifiers;\n    const opts = optsRef.current;\n    if (s.phase === 'pending' && opts.thresholdReached) {\n      const ctx = buildCtx();\n      if (opts.thresholdReached(ctx)) {\n        s.phase = 'active';\n        bumpPhase('active');\n        opts.onActivate?.(buildCtx());\n      }\n    }\n    opts.onMove?.(buildCtx());\n    return true;\n  }, [buildCtx, bumpPhase, optsRef]);\n\n  const end = useCallback(() => {\n    const s = stateRef.current;\n    const opts = optsRef.current;\n    if (!s) return;\n    const wasSubThreshold = s.phase === 'pending';\n    const endCtx: DragGestureEndCtx<TScratch> = {\n      get start() { return s.start; },\n      get current() { return s.current; },\n      get modifiers() { return s.modifiers; },\n      get scratch() { return s.scratch; },\n      get phase() { return s.phase; },\n      wasSubThreshold,\n    };\n    let committed = false;\n    try {\n      const r = opts.onEnd?.(endCtx);\n      committed = r !== false;\n    } finally {\n      stateRef.current = null;\n      bumpPhase('idle');\n      opts.onGestureEnd?.(committed);\n    }\n  }, [bumpPhase, optsRef]);\n\n  const cancel = useCallback(() => {\n    const s = stateRef.current;\n    const opts = optsRef.current;\n    if (!s) return;\n    opts.onCancel?.(buildCtx());\n    stateRef.current = null;\n    bumpPhase('idle');\n    opts.onGestureEnd?.(false);\n  }, [buildCtx, bumpPhase, optsRef]);\n\n  return useMemo<DragGestureController>(() => ({\n    start, move, end, cancel,\n    get phase() { return phaseRef.current; },\n    get isActive() { return phaseRef.current !== 'idle'; },\n  }), [start, move, end, cancel]);\n}\n"],"mappings":"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"}
+{"version":3,"file":"dragGesture.js","names":[],"sources":["../../../../src/interactions/gestures/dragGesture/dragGesture.ts"],"sourcesContent":["import { useCallback, useMemo, useRef, useState } from 'react';\nimport { useLatest } from '@weasel-js/react';\nimport type { ModifierState } from '../types';\n\n/** Pointer position in both world (gesture-coord) and client (CSS-px) space. */\nexport interface DragGesturePoint {\n  worldX: number;\n  worldY: number;\n  clientX: number;\n  clientY: number;\n}\n\n/** Phase exposed on the public controller and inside ctx for callbacks. */\nexport type DragGesturePhase = 'idle' | 'pending' | 'active';\n\n/** Live gesture context handed to lifecycle callbacks. Within callbacks, ctx\n *  reflects the moment the callback fires (e.g. ctx.phase is 'active' inside\n *  onActivate, even though the move that triggered it was during 'pending'). */\nexport interface DragGestureCtx<TScratch = unknown> {\n  start: DragGesturePoint;\n  current: DragGesturePoint;\n  modifiers: ModifierState;\n  scratch: TScratch;\n  /** 'pending' or 'active'. Never 'idle' inside a callback. */\n  phase: 'pending' | 'active';\n}\n\n/** The context handed to `onEnd`, adding whether the gesture ever passed its\n *  activation threshold. */\nexport interface DragGestureEndCtx<TScratch = unknown>\n  extends DragGestureCtx<TScratch> {\n  /** True if phase never reached 'active'. Wrappers without thresholdReached\n   *  always see false here (their gesture activates at start()). */\n  wasSubThreshold: boolean;\n}\n\n/** Options for `useDragGesture`: when the gesture becomes active, and what to\n *  do at each point in its lifecycle. */\nexport interface UseDragGestureOptions<TScratch = unknown> {\n  initScratch?: () => TScratch;\n  /** Predicate consulted on each move while phase === 'pending'. Return true\n   *  to transition to 'active'. The transition fires onActivate before the\n   *  triggering move's onMove. When omitted, gesture activates at start(). */\n  thresholdReached?: (ctx: DragGestureCtx<TScratch>) => boolean;\n  onStart?: (ctx: DragGestureCtx<TScratch>) => void;\n  onActivate?: (ctx: DragGestureCtx<TScratch>) => void;\n  onMove?: (ctx: DragGestureCtx<TScratch>) => void;\n  onEnd?: (ctx: DragGestureEndCtx<TScratch>) => boolean | void;\n  onCancel?: (ctx: DragGestureCtx<TScratch>) => void;\n  /** Fired when a gesture opens. A `start()` that replaces a live gesture\n   *  does not fire it again. */\n  onGestureStart?: () => void;\n  /** Fired once per `onGestureStart`, when that gesture ends or cancels. */\n  onGestureEnd?: (committed: boolean) => void;\n}\n\n/** Drives a drag gesture. The owner feeds it pointer positions; it decides\n *  when the drag has really begun and calls back accordingly. */\nexport interface DragGestureController {\n  start(point: DragGesturePoint, modifiers: ModifierState): void;\n  move(point: DragGesturePoint, modifiers: ModifierState): boolean;\n  end(): void;\n  cancel(): void;\n  readonly phase: DragGesturePhase;\n  readonly isActive: boolean;\n}\n\ninterface InternalState<TScratch> {\n  phase: 'pending' | 'active';\n  start: DragGesturePoint;\n  current: DragGesturePoint;\n  modifiers: ModifierState;\n  scratch: TScratch;\n}\n\n/**\n * The base drag primitive: tracks a pointer from press to release, with an\n * optional threshold below which the gesture stays pending and commits\n * nothing.\n *\n * It is a gesture and only a gesture — it says where the pointer went, never\n * what that should do. `useDragRect` and `useDragRadial` build on it, and\n * actions decide what to make of the result.\n */\nexport function useDragGesture<TScratch = unknown>(\n  options: UseDragGestureOptions<TScratch> = {},\n): DragGestureController {\n  const optsRef = useLatest(options);\n  const stateRef = useRef<InternalState<TScratch> | null>(null);\n  const [, setPhaseTick] = useState(0);\n  const phaseRef = useRef<DragGesturePhase>('idle');\n  const bumpPhase = useCallback((next: DragGesturePhase) => {\n    phaseRef.current = next;\n    setPhaseTick((n) => n + 1);\n  }, []);\n\n  const buildCtx = useCallback((): DragGestureCtx<TScratch> => {\n    const s = stateRef.current!;\n    return {\n      get start() { return s.start; },\n      get current() { return s.current; },\n      get modifiers() { return s.modifiers; },\n      get scratch() { return s.scratch; },\n      get phase() { return s.phase; },\n    };\n  }, []);\n\n  const start = useCallback((point: DragGesturePoint, modifiers: ModifierState) => {\n    const opts = optsRef.current;\n    const scratch = opts.initScratch ? opts.initScratch() : ({} as TScratch);\n    const initialPhase: 'pending' | 'active' = opts.thresholdReached ? 'pending' : 'active';\n    const restart = stateRef.current !== null;\n    stateRef.current = {\n      phase: initialPhase,\n      start: point,\n      current: point,\n      modifiers,\n      scratch,\n    };\n    bumpPhase(initialPhase);\n    if (!restart) opts.onGestureStart?.();\n    opts.onStart?.(buildCtx());\n  }, [buildCtx, bumpPhase, optsRef]);\n\n  const move = useCallback((point: DragGesturePoint, modifiers: ModifierState): boolean => {\n    const s = stateRef.current;\n    if (!s) return false;\n    s.current = point;\n    s.modifiers = modifiers;\n    const opts = optsRef.current;\n    if (s.phase === 'pending' && opts.thresholdReached) {\n      const ctx = buildCtx();\n      if (opts.thresholdReached(ctx)) {\n        s.phase = 'active';\n        bumpPhase('active');\n        opts.onActivate?.(buildCtx());\n      }\n    }\n    opts.onMove?.(buildCtx());\n    return true;\n  }, [buildCtx, bumpPhase, optsRef]);\n\n  const end = useCallback(() => {\n    const s = stateRef.current;\n    const opts = optsRef.current;\n    if (!s) return;\n    const wasSubThreshold = s.phase === 'pending';\n    const endCtx: DragGestureEndCtx<TScratch> = {\n      get start() { return s.start; },\n      get current() { return s.current; },\n      get modifiers() { return s.modifiers; },\n      get scratch() { return s.scratch; },\n      get phase() { return s.phase; },\n      wasSubThreshold,\n    };\n    let committed = false;\n    try {\n      const r = opts.onEnd?.(endCtx);\n      committed = r !== false;\n    } finally {\n      stateRef.current = null;\n      bumpPhase('idle');\n      opts.onGestureEnd?.(committed);\n    }\n  }, [bumpPhase, optsRef]);\n\n  const cancel = useCallback(() => {\n    const s = stateRef.current;\n    const opts = optsRef.current;\n    if (!s) return;\n    opts.onCancel?.(buildCtx());\n    stateRef.current = null;\n    bumpPhase('idle');\n    opts.onGestureEnd?.(false);\n  }, [buildCtx, bumpPhase, optsRef]);\n\n  return useMemo<DragGestureController>(() => ({\n    start, move, end, cancel,\n    get phase() { return phaseRef.current; },\n    get isActive() { return phaseRef.current !== 'idle'; },\n  }), [start, move, end, cancel]);\n}\n"],"mappings":"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"}

package/dist/interactions/gestures/dragGesture/dragPointOf.js

@@ -1,6 +1,7 @@
-import { clientToWorld as e } from "../../../core/viewport/clientToWorld.js";
+import { clientToWorld } from "../../../core/viewport/clientToWorld.js";
+
 //#region src/interactions/gestures/dragGesture/dragPointOf.ts
-var t = {
+var IDENTITY = {
 	x: 0,
 	y: 0,
 	scale: {
@@ -8,16 +9,22 @@ var t = {
 		y: 1
 	}
 };
-function n(n, r, i = t) {
-	let [a, o] = e(n.clientX, n.clientY, r.getBoundingClientRect(), i);
+/**
+* The {@link DragGesturePoint} a pointer event stands for, for feeding
+* `useDragGesture`, `useDragRect`, or `useDragRadial` from raw pointer
+* handlers. `element` is the surface the gesture is measured on. With no
+* `view`, world coordinates are the position inside the element in CSS pixels.
+*/
+function dragPointOf(event, element, view = IDENTITY) {
+	const [worldX, worldY] = clientToWorld(event.clientX, event.clientY, element.getBoundingClientRect(), view);
 	return {
-		clientX: n.clientX,
-		clientY: n.clientY,
-		worldX: a,
-		worldY: o
+		clientX: event.clientX,
+		clientY: event.clientY,
+		worldX,
+		worldY
 	};
 }
-//#endregion
-export { n as dragPointOf };
 
+//#endregion
+export { dragPointOf };
 //# sourceMappingURL=dragPointOf.js.map

package/dist/interactions/gestures/dragGesture/dragPointOf.js.map

@@ -1 +1 @@
-{"version":3,"file":"dragPointOf.js","names":["IDENTITY","dragPointOf","worldX","worldY","clientToWorld","event","element","view"],"sources":["../../../../src/interactions/gestures/dragGesture/dragPointOf.ts"],"sourcesContent":["import { clientToWorld, type ViewLike } from 'core/viewport/clientToWorld';\nimport type { DragGesturePoint } from './dragGesture';\n\nconst IDENTITY: ViewLike = { x: 0, y: 0, scale: { x: 1, y: 1 } };\n\n/**\n * The {@link DragGesturePoint} a pointer event stands for, for feeding\n * `useDragGesture`, `useDragRect`, or `useDragRadial` from raw pointer\n * handlers. `element` is the surface the gesture is measured on. With no\n * `view`, world coordinates are the position inside the element in CSS pixels.\n */\nexport function dragPointOf(\n  event: { clientX: number; clientY: number },\n  element: { getBoundingClientRect(): { left: number; top: number } },\n  view: ViewLike = IDENTITY,\n): DragGesturePoint {\n  const [worldX, worldY] = clientToWorld(event.clientX, event.clientY, element.getBoundingClientRect(), view);\n  return { clientX: event.clientX, clientY: event.clientY, worldX, worldY };\n}\n"],"mappings":";;AAGA,IAAMA,IAAqB;CAAE,GAAG;CAAG,GAAG;CAAG,OAAO;EAAE,GAAG;EAAG,GAAG;CAAE;AAAE;AAQ/D,SAAgBC,EACd,GACA,GACA,IAAiBD,GACC;CAClB,IAAM,CAACE,GAAQC,KAAUC,EAAcC,EAAM,SAASA,EAAM,SAASC,EAAQ,sBAAsB,GAAGC,CAAI;CAC1G,OAAO;EAAE,SAASF,EAAM;EAAS,SAASA,EAAM;EAAS;EAAQ;CAAO;AAC1E"}
+{"version":3,"file":"dragPointOf.js","names":[],"sources":["../../../../src/interactions/gestures/dragGesture/dragPointOf.ts"],"sourcesContent":["import { clientToWorld, type ViewLike } from 'core/viewport/clientToWorld';\nimport type { DragGesturePoint } from './dragGesture';\n\nconst IDENTITY: ViewLike = { x: 0, y: 0, scale: { x: 1, y: 1 } };\n\n/**\n * The {@link DragGesturePoint} a pointer event stands for, for feeding\n * `useDragGesture`, `useDragRect`, or `useDragRadial` from raw pointer\n * handlers. `element` is the surface the gesture is measured on. With no\n * `view`, world coordinates are the position inside the element in CSS pixels.\n */\nexport function dragPointOf(\n  event: { clientX: number; clientY: number },\n  element: { getBoundingClientRect(): { left: number; top: number } },\n  view: ViewLike = IDENTITY,\n): DragGesturePoint {\n  const [worldX, worldY] = clientToWorld(event.clientX, event.clientY, element.getBoundingClientRect(), view);\n  return { clientX: event.clientX, clientY: event.clientY, worldX, worldY };\n}\n"],"mappings":";;;AAGA,IAAM,WAAqB;CAAE,GAAG;CAAG,GAAG;CAAG,OAAO;EAAE,GAAG;EAAG,GAAG;CAAE;AAAE;;;;;;;AAQ/D,SAAgB,YACd,OACA,SACA,OAAiB,UACC;CAClB,MAAM,CAAC,QAAQ,UAAU,cAAc,MAAM,SAAS,MAAM,SAAS,QAAQ,sBAAsB,GAAG,IAAI;CAC1G,OAAO;EAAE,SAAS,MAAM;EAAS,SAAS,MAAM;EAAS;EAAQ;CAAO;AAC1E"}