@weasel-js/routing 1.15.0 → 1.15.2

package/dist/{index-C2EcHkCp.d.ts → index-CBxf3Cxm.d.ts}

@@ -589,6 +589,69 @@ type OngoingOverlay = {
 /** A handle's overlays as a list: empty when it has none. */
 declare function overlaysOf(handle: OngoingHandle): readonly OngoingOverlay[];
 
+/**
+ * The options a gesture binding hands the action it fires, and reading their params.
+ */
+
+/** Per-invocation options the dispatcher reads from a `GestureBinding`'s
+ *  `opts` field and passes to `OngoingInvoker.start`. */
+interface BindingOpts {
+    /** The id a binding override names this binding by, `<owner>.<role>`:
+     *  `undo.key`, `rect.drag`, `nudge.left.big`. Without one it is its owner and
+     *  its position (`<entry>#<n>`, `<action>@<n>`), which moves when the defaults
+     *  are reordered, so a binding a host may persist an override for declares one. */
+    id?: string;
+    /** Gesture behaviors the action's own invoker runs. Routing carries the
+     *  array to the action and never reads an element, so the element type is
+     *  open here; `@weasel-js/core` narrows it. */
+    behaviors?: unknown[];
+    /** Per-binding action parameters, which an immediate invoker reads via the
+     *  second arg to `run`.
+     *
+     *  May also be a thunk evaluated each time the value is needed, so a tool
+     *  can close over refs that mutate during a gesture (e.g. polygon `sides`
+     *  adjusted mid-drag via ArrowUp). An ongoing invoker that wants the latest
+     *  values at commit re-calls it inside `onEnd` via
+     *  `resolveParams(opts?.params)`. */
+    params?: Record<string, unknown> | (() => Record<string, unknown>);
+    /**
+     * The views this binding is live in, by id, where `null` is the surface's
+     * own camera. Omitted means every view.
+     *
+     * A binding that names the view an input landed in outranks every binding
+     * that does not, whatever their scope tiers: naming a view is the most
+     * specific thing a binding can say about where it applies. Without that, a
+     * drag bound inside a minimap view loses to the active tool's marquee.
+     */
+    views?: readonly (string | null)[];
+    /**
+     * Says this binding is declared ahead of another on the same input on
+     * purpose: its action declines through `enabled()` when the input is not its
+     * to take, and the next binding fires. The dispatcher does that for any
+     * binding; this tells the route-conflict check the order is the design.
+     */
+    yields?: boolean;
+    /**
+     * For a key binding: live while the pointer is over the surface, whichever
+     * canvas holds the keys, and only then. For a key that means "here" — a
+     * magnifier's peek — on a page with more than one surface that hears it.
+     * A held key follows the pointer: one already down when it arrives presses
+     * the binding, and leaving releases it.
+     */
+    over?: boolean;
+    /**
+     * Keys for some of the action's `modifierRoles` on this binding, by role
+     * id, over the action's defaults and any tuning's.
+     */
+    roles?: RoleRebinds;
+    /** Screen travel, in CSS pixels, a drag makes before this binding's ongoing action starts, over the
+     *  action's own `dragThresholdPx`. See `OngoingInvoker.dragThresholdPx`. */
+    dragThresholdPx?: number;
+}
+/** Resolve `BindingOpts.params` to a concrete record (calling the thunk if
+ *  needed). Returns `undefined` for absent params. */
+declare function resolveParams(params: BindingOpts['params']): Record<string, unknown> | undefined;
+
 /**
  * Invoker — pluggable invocation strategy for an Action.
  *
@@ -779,64 +842,7 @@ interface InvocationCtx {
      */
     roles?: Readonly<Record<string, boolean>>;
 }
-/** Per-invocation options the dispatcher reads from a `GestureBinding`'s
- *  `opts` field and passes to `OngoingInvoker.start`. */
-interface BindingOpts {
-    /** The id a binding override names this binding by, `<owner>.<role>`:
-     *  `undo.key`, `rect.drag`, `nudge.left.big`. Without one it is its owner and
-     *  its position (`<entry>#<n>`, `<action>@<n>`), which moves when the defaults
-     *  are reordered, so a binding a host may persist an override for declares one. */
-    id?: string;
-    /** Gesture behaviors the action's own invoker runs. Routing carries the
-     *  array to the action and never reads an element, so the element type is
-     *  open here; `@weasel-js/core` narrows it. */
-    behaviors?: unknown[];
-    /** Per-binding action parameters, which an immediate invoker reads via the
-     *  second arg to `run`.
-     *
-     *  May also be a thunk evaluated each time the value is needed, so a tool
-     *  can close over refs that mutate during a gesture (e.g. polygon `sides`
-     *  adjusted mid-drag via ArrowUp). An ongoing invoker that wants the latest
-     *  values at commit re-calls it inside `onEnd` via
-     *  `resolveParams(opts?.params)`. */
-    params?: Record<string, unknown> | (() => Record<string, unknown>);
-    /**
-     * The views this binding is live in, by id, where `null` is the surface's
-     * own camera. Omitted means every view.
-     *
-     * A binding that names the view an input landed in outranks every binding
-     * that does not, whatever their scope tiers: naming a view is the most
-     * specific thing a binding can say about where it applies. Without that, a
-     * drag bound inside a minimap view loses to the active tool's marquee.
-     */
-    views?: readonly (string | null)[];
-    /**
-     * Says this binding is declared ahead of another on the same input on
-     * purpose: its action declines through `enabled()` when the input is not its
-     * to take, and the next binding fires. The dispatcher does that for any
-     * binding; this tells the route-conflict check the order is the design.
-     */
-    yields?: boolean;
-    /**
-     * For a key binding: live while the pointer is over the surface, whichever
-     * canvas holds the keys, and only then. For a key that means "here" — a
-     * magnifier's peek — on a page with more than one surface that hears it.
-     * A held key follows the pointer: one already down when it arrives presses
-     * the binding, and leaving releases it.
-     */
-    over?: boolean;
-    /**
-     * Keys for some of the action's `modifierRoles` on this binding, by role
-     * id, over the action's defaults and any tuning's.
-     */
-    roles?: RoleRebinds;
-    /** Screen travel, in CSS pixels, a drag makes before this binding's ongoing action starts, over the
-     *  action's own `dragThresholdPx`. See {@link OngoingInvoker.dragThresholdPx}. */
-    dragThresholdPx?: number;
-}
-/** Resolve `BindingOpts.params` to a concrete record (calling the thunk if
- *  needed). Returns `undefined` for absent params. */
-declare function resolveParams(params: BindingOpts['params']): Record<string, unknown> | undefined;
+
 /** The deps an action receives, composed per call from what it `requires`.
  *  Each name resolves to its {@link DepSchema} entry, and is absent when no
  *  source registered it; a name nothing has declared passes through as
@@ -885,6 +891,13 @@ interface OngoingHandle {
      * faithfully leaves it out, and its action gets no panel.
      */
     replay?(params: Record<string, unknown>): void;
+    /**
+     * Params this gesture's commit took from what it edited rather than from its binding, read once it has ended:
+     * a held warp's own grid and tolerance, say, which the binding's settings do not reach. The last-operation
+     * panel shows them over the resolved params, and `replay` is handed them, so a change to one field leaves the
+     * rest as the gesture found them.
+     */
+    params?(): Readonly<Record<string, unknown>>;
     /**
      * Optional preview surface: the in-flight state the canvas's preview-ghost
      * layer renders on top of the committed scene during the gesture.
@@ -1314,6 +1327,10 @@ interface ActionTuning<P = Record<string, unknown>> {
     /** Keys for some of the action's `modifierRoles`, by role id. A binding's
      *  own `opts.roles` is laid over these. */
     roles?: RoleRebinds;
+    /** Told the params the last-operation panel just set for the action, which hold for the rest of the session.
+     *  A tuning whose `params` thunk reads a host's store writes the ones it supplies back there, so the store, and
+     *  whatever draws it, says what the next run will use rather than overriding it. */
+    keep?(params: Readonly<Record<string, unknown>>): void;
 }
 /** `action` with each tuning applied in turn, a later one's params over an
  *  earlier one's. Applying a tuning to a copy it already tuned changes nothing. */
@@ -1346,7 +1363,8 @@ interface LastOperationStore {
      * Undo the operation's entry, put back the selection it ran on, and run it again with `patch` laid over its
      * values (a gesture is replayed by its handle), keeping the entry that makes in place of the old one: the
      * history, or the journal open on it, still holds one entry for it. The merged values become the action's
-     * params for the rest of the session, under any tuning. Returns whether it ran.
+     * params for the rest of the session, under any tuning, and each tuning that keeps them is handed them
+     * (`ActionTuning.keep`). Returns whether it ran.
      */
     adjust(patch: Readonly<Record<string, unknown>>): boolean;
     /** Forget the operation; the scene and the history stay as they are. */
@@ -1364,6 +1382,8 @@ interface LastOperationHost {
     paramsOf(id: string, given: Record<string, unknown> | undefined): Record<string, unknown>;
     /** Run the action live for `id` here with `params`, as `trigger` would. */
     rerun(id: string, params: Record<string, unknown>): void;
+    /** Hand `params`, which a panel change made `id`'s for the session, to each tuning of `id` that keeps them. */
+    keep(id: string, params: Readonly<Record<string, unknown>>): void;
 }
 /** The store one actions tree keeps at its root. `onSession` is told when an action's session params change. */
 declare class LastOperationKeeper implements LastOperationStore {
@@ -3697,8 +3717,9 @@ interface KeyBinding {
      */
     key: string | readonly string[];
     /**
-     * Require Cmd (mac) or Ctrl (others). When `true`, exactly one of
-     * `metaKey`/`ctrlKey` must be held. Default `false` (both forbidden).
+     * Require `mod`: Cmd on an Apple platform, Ctrl elsewhere, with the other
+     * key forbidden — `mod` as `@weasel-js/gestures` defines it. Default `false`
+     * (both forbidden).
      */
     mod?: boolean;
     /** Require Alt. Default `false` (forbidden). */
@@ -3721,10 +3742,12 @@ interface KeyBinding {
  * `preventDefault`. Shared by the tool dispatcher (`useKeybindings`) and the
  * gesture dispatcher so the rules can't drift.
  */
-declare function matchesKeyBinding(e: KeyboardEvent, b: KeyBinding): boolean;
+declare function matchesKeyBinding(e: KeyBindingEvent, b: KeyBinding, isMac?: boolean): boolean;
+/** The fields of a keyboard event {@link matchesKeyBinding} reads, so a React event passes as readily as a DOM one. */
+type KeyBindingEvent = Pick<KeyboardEvent, 'key' | 'metaKey' | 'ctrlKey' | 'shiftKey' | 'altKey'>;
 /** Which history step `e` asks for: Mod+Z undoes, Shift+Mod+Z and Mod+Y redo. `null` for anything else. Takes a
  *  React keyboard event as readily as a DOM one. */
-declare function historyKey(e: Pick<KeyboardEvent, 'key' | 'metaKey' | 'ctrlKey' | 'shiftKey' | 'altKey'>): 'undo' | 'redo' | null;
+declare function historyKey(e: KeyBindingEvent, isMac?: boolean): 'undo' | 'redo' | null;
 
 /**
  * Key chords a major browser or the desktop under it takes before a page can:

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { x as ALWAYS, A as Action, c as ActionDeps, e as ActionDisabledReason, e as ActionDisabledReasonValue, y as ActionDispatch, z as ActionEnabledResult, E as ActionEntry, F as ActionItem, G as ActionParamSchema, H as ActionParams, I as ActionPresentation, J as ActionSettings, P as ActionSettingsState, Q as ActionShortcut, U as ActionSource, V as ActionTuning, X as ActionTunings, Y as ActionUnavailable, f as ActionVariant, Z as ActionsProp, d as ActionsRegistry, s as AffordanceHit, _ as AnyTool, $ as AssemblyInputs, a0 as BROWSER_RESERVED_CHORDS, a1 as BindingOpts, a2 as BindingOverrides, a3 as BindingScope, a4 as BindingSource, a5 as BodyPredicate, B as BoundGesture, a6 as Bounds, a7 as BuildRuleCtxArgs, a8 as COARSE_TARGET_SCALE, a9 as CaptureGestureOptions, aa as CaptureKeyOptions, ab as CaptureKind, ac as CapturedSpec, ad as Carried, ae as Carry, af as CarryCallbacks, ag as CarryPayload, ah as CarryPointer, ai as CarryStage, aj as Condition, ak as Conflict, C as Contribution, al as ContributionChrome, am as ContributionDeps, an as ContributionRouting, ao as DEFAULT_ALLOWED_CAPABILITIES, ap as DEFAULT_DEVICE_PROFILE, aq as DebugSink, ar as DepListing, a as DepName, D as DepRegistry, w as DepSchema, b as DepSource, as as DetectedDeviceFacts, at as DeviceProfile, au as DispatchRecord, av as DispatchRecordInput, t as DispatchTrace, r as Dispatcher, aw as DispatcherContext, ax as DragSample, ay as DroppedCandidate, az as Eligibility, aA as EligibilityState, aB as GestureBinding, aC as GestureKitSettings, aD as HandleKind, aE as HitShape, aF as HotkeyTrigger, aG as INGEST_STRING_MIMES, aH as ImmediateInvoker, aI as ImmediateParams, aJ as InvocationCtx, aK as Invoker, aL as KEYMAP_HOLD, k as KernelOverlay, aM as KeyBinding, aN as KeyReach, aO as KeymapDef, K as KeymapDescription, aP as KeymapRow, aQ as KeymapStack, aR as KeymapUnbound, aS as KeymapVerdict, h as LastOperation, g as LastOperationStore, v as LongPressOptions, aT as LongPressState, aU as LongPressStore, aV as MatchOutcome, aW as MatchResult, aX as MenuAccess, aY as MenuCustomAt, i as MenuDef, aZ as MenuHit, M as MenuHost, a_ as MenuOpenRequest, a$ as MenuSources, b0 as MenuWhen, b1 as ModeShortcutHandlers, b2 as ModeSwitchLogEntry, b3 as ModifierRole, b4 as ModifierRoles, b5 as ModifierState, b6 as NEVER, N as NodeId, b7 as OngoingHandle, b8 as OngoingInvoker, b9 as OngoingOverlay, ba as OpenKeymap, bb as OpenMenu, O as OverlayPosition, bc as OverlayRole, bd as OverlaySchema, be as OwnedMenuDef, bf as PREDICATE_TARGET, bg as PendingIngestItem, bh as PendingLongPress, bi as PlacedBy, bj as Point2, bk as PointerSession, bl as PointerSessionCallbacks, bm as PointerSessionCancelReason, bn as PointerSessionOptions, bo as RankedCandidate, bp as RecordCandidate, bq as RegistryEntry, br as ReservedChord, bs as ResizeAnchor, bt as ResolveAllOptions, bu as ResolveOnlyResult, bv as ResolvedBindingOverrides, bw as ResolvedCandidate, bx as RoleKeys, by as RoleRebinds, bz as Rule, R as RuleCtx, bA as ScopedBinding, bB as ScratchKey, bC as ScratchStore, bD as SelectionApi, bE as SelectionSnapshotDep, bF as Selector, bG as SpecificityPart, bH as TOOL_OFFHAND_ID, l as Tool, bI as ToolDef, bJ as ToolEntry, bK as ToolKeybinding, bL as ToolModifiers, bM as ToolOffhandBindingSpec, bN as ToolOptionStep, bO as ToolOptionValues, bP as ToolOptions, bQ as ToolPresentation, bR as ToolScopes, bS as ToolSet, bT as ToolSlot, bU as TraceLogEntry, bV as TraceRing, bW as TunedBinding, bX as UiOngoingControl, bY as ViewportGestureKind, bZ as WalkStep, W as WorldPoint, b_ as actionBindings, b$ as actionCursor, c0 as actionItemTitle, c1 as actionItems, c2 as actionSettingsParams, c3 as actionShortcuts, c4 as actionsTagged, c5 as admitIngestMime, c6 as assembleEntries, c7 as bindingId, c8 as browserReservedChord, c9 as buildDepsFromRequires, ca as buildRouteRegistry, cb as buildRuleCtx, cc as buildToolOffhandBindings, cd as captureGesture, ce as captureKey, cf as clientToCanvas, cg as clientToCanvasRect, ch as createDepRegistry, ci as createDispatchTrace, cj as createDispatcher, ck as createKeymapStack, cl as createLongPressStore, cm as createMenuHost, cn as createToolOptionValues, co as createTraceRing, cp as defineTool, cq as deleteScratch, cr as describeKeymap, cs as describeRule, ct as dlog, cu as dwarn, cv as evaluate, cw as evaluateActive, cx as evaluateEnabled, cy as findConflicts, cz as getScratch, cA as heldKeySpec, cB as historyKey, cC as holdPreview, cD as holdPreviewId, cE as isAnchor, cF as isAnchorOrControl, cG as isBalanceGrip, cH as isBody, cI as isControlHandle, cJ as isCornerWidget, cK as isDebugEnabled, cL as isEmpty, cM as isPathEditPart, cN as isResizeHandle, cO as isRotateHandle, cP as isSegment, cQ as isSelectedBody, cR as isTool, cS as isToolSet, cT as isUnselectedBody, cU as itemTypesFromDataTransfer, cV as itemsFromClipboardData, cW as itemsFromDataTransfer, cX as itemsFromFiles, cY as keySpecShortcut, cZ as keymapContribution, c_ as keymapLeaderBindingId, c$ as keymapLeaderId, d0 as keymapShortcuts, d1 as keysHeld, d2 as liveScope, d3 as makeToolOffhandAction, d4 as matchActionItem, d5 as matchBest, d6 as matchSorted, d7 as matchSortedWithBarred, d8 as matchesKeyBinding, d9 as mergeContributions, da as mergeMenuDefs, db as modeShortcutSpec, dc as modeShortcuts, dd as modifierStateOf, de as multiTouchGestureId, df as offhandKeyFor, dg as openPointerSession, dh as overlaysOf, di as overriddenBindings, dj as pendingKindOf, dk as pickMenu, dl as pointerGestureId, dm as readActionSettings, dn as reportRouteConflicts, dp as resolveBindingOverrides, dq as resolveDeviceProfile, dr as resolveMenu, ds as resolveParams, dt as resolveSchemaMenu, du as returnToModeDefault, dv as roleReader, dw as routesForSpec, dx as ruleCanHoldIn, dy as rulesExclusive, dz as scopeBindings, dA as scratchKey, dB as setScratch, dC as startCarry, dD as steppedOption, dE as taggedActionItems, dF as targetConsultsAffordance, dG as toolIdsOf, dH as toolOptionParams, dI as toolOptionSteps, dJ as toolSet, dK as toolSetHas, dL as tuneAction, dM as validateActionDefaultBinding, dN as validateActionId, dO as withoutTools } from './index-C2EcHkCp.js';
+export { x as ALWAYS, A as Action, c as ActionDeps, e as ActionDisabledReason, e as ActionDisabledReasonValue, y as ActionDispatch, z as ActionEnabledResult, E as ActionEntry, F as ActionItem, G as ActionParamSchema, H as ActionParams, I as ActionPresentation, J as ActionSettings, P as ActionSettingsState, Q as ActionShortcut, U as ActionSource, V as ActionTuning, X as ActionTunings, Y as ActionUnavailable, f as ActionVariant, Z as ActionsProp, d as ActionsRegistry, s as AffordanceHit, _ as AnyTool, $ as AssemblyInputs, a0 as BROWSER_RESERVED_CHORDS, a1 as BindingOpts, a2 as BindingOverrides, a3 as BindingScope, a4 as BindingSource, a5 as BodyPredicate, B as BoundGesture, a6 as Bounds, a7 as BuildRuleCtxArgs, a8 as COARSE_TARGET_SCALE, a9 as CaptureGestureOptions, aa as CaptureKeyOptions, ab as CaptureKind, ac as CapturedSpec, ad as Carried, ae as Carry, af as CarryCallbacks, ag as CarryPayload, ah as CarryPointer, ai as CarryStage, aj as Condition, ak as Conflict, C as Contribution, al as ContributionChrome, am as ContributionDeps, an as ContributionRouting, ao as DEFAULT_ALLOWED_CAPABILITIES, ap as DEFAULT_DEVICE_PROFILE, aq as DebugSink, ar as DepListing, a as DepName, D as DepRegistry, w as DepSchema, b as DepSource, as as DetectedDeviceFacts, at as DeviceProfile, au as DispatchRecord, av as DispatchRecordInput, t as DispatchTrace, r as Dispatcher, aw as DispatcherContext, ax as DragSample, ay as DroppedCandidate, az as Eligibility, aA as EligibilityState, aB as GestureBinding, aC as GestureKitSettings, aD as HandleKind, aE as HitShape, aF as HotkeyTrigger, aG as INGEST_STRING_MIMES, aH as ImmediateInvoker, aI as ImmediateParams, aJ as InvocationCtx, aK as Invoker, aL as KEYMAP_HOLD, k as KernelOverlay, aM as KeyBinding, aN as KeyReach, aO as KeymapDef, K as KeymapDescription, aP as KeymapRow, aQ as KeymapStack, aR as KeymapUnbound, aS as KeymapVerdict, h as LastOperation, g as LastOperationStore, v as LongPressOptions, aT as LongPressState, aU as LongPressStore, aV as MatchOutcome, aW as MatchResult, aX as MenuAccess, aY as MenuCustomAt, i as MenuDef, aZ as MenuHit, M as MenuHost, a_ as MenuOpenRequest, a$ as MenuSources, b0 as MenuWhen, b1 as ModeShortcutHandlers, b2 as ModeSwitchLogEntry, b3 as ModifierRole, b4 as ModifierRoles, b5 as ModifierState, b6 as NEVER, N as NodeId, b7 as OngoingHandle, b8 as OngoingInvoker, b9 as OngoingOverlay, ba as OpenKeymap, bb as OpenMenu, O as OverlayPosition, bc as OverlayRole, bd as OverlaySchema, be as OwnedMenuDef, bf as PREDICATE_TARGET, bg as PendingIngestItem, bh as PendingLongPress, bi as PlacedBy, bj as Point2, bk as PointerSession, bl as PointerSessionCallbacks, bm as PointerSessionCancelReason, bn as PointerSessionOptions, bo as RankedCandidate, bp as RecordCandidate, bq as RegistryEntry, br as ReservedChord, bs as ResizeAnchor, bt as ResolveAllOptions, bu as ResolveOnlyResult, bv as ResolvedBindingOverrides, bw as ResolvedCandidate, bx as RoleKeys, by as RoleRebinds, bz as Rule, R as RuleCtx, bA as ScopedBinding, bB as ScratchKey, bC as ScratchStore, bD as SelectionApi, bE as SelectionSnapshotDep, bF as Selector, bG as SpecificityPart, bH as TOOL_OFFHAND_ID, l as Tool, bI as ToolDef, bJ as ToolEntry, bK as ToolKeybinding, bL as ToolModifiers, bM as ToolOffhandBindingSpec, bN as ToolOptionStep, bO as ToolOptionValues, bP as ToolOptions, bQ as ToolPresentation, bR as ToolScopes, bS as ToolSet, bT as ToolSlot, bU as TraceLogEntry, bV as TraceRing, bW as TunedBinding, bX as UiOngoingControl, bY as ViewportGestureKind, bZ as WalkStep, W as WorldPoint, b_ as actionBindings, b$ as actionCursor, c0 as actionItemTitle, c1 as actionItems, c2 as actionSettingsParams, c3 as actionShortcuts, c4 as actionsTagged, c5 as admitIngestMime, c6 as assembleEntries, c7 as bindingId, c8 as browserReservedChord, c9 as buildDepsFromRequires, ca as buildRouteRegistry, cb as buildRuleCtx, cc as buildToolOffhandBindings, cd as captureGesture, ce as captureKey, cf as clientToCanvas, cg as clientToCanvasRect, ch as createDepRegistry, ci as createDispatchTrace, cj as createDispatcher, ck as createKeymapStack, cl as createLongPressStore, cm as createMenuHost, cn as createToolOptionValues, co as createTraceRing, cp as defineTool, cq as deleteScratch, cr as describeKeymap, cs as describeRule, ct as dlog, cu as dwarn, cv as evaluate, cw as evaluateActive, cx as evaluateEnabled, cy as findConflicts, cz as getScratch, cA as heldKeySpec, cB as historyKey, cC as holdPreview, cD as holdPreviewId, cE as isAnchor, cF as isAnchorOrControl, cG as isBalanceGrip, cH as isBody, cI as isControlHandle, cJ as isCornerWidget, cK as isDebugEnabled, cL as isEmpty, cM as isPathEditPart, cN as isResizeHandle, cO as isRotateHandle, cP as isSegment, cQ as isSelectedBody, cR as isTool, cS as isToolSet, cT as isUnselectedBody, cU as itemTypesFromDataTransfer, cV as itemsFromClipboardData, cW as itemsFromDataTransfer, cX as itemsFromFiles, cY as keySpecShortcut, cZ as keymapContribution, c_ as keymapLeaderBindingId, c$ as keymapLeaderId, d0 as keymapShortcuts, d1 as keysHeld, d2 as liveScope, d3 as makeToolOffhandAction, d4 as matchActionItem, d5 as matchBest, d6 as matchSorted, d7 as matchSortedWithBarred, d8 as matchesKeyBinding, d9 as mergeContributions, da as mergeMenuDefs, db as modeShortcutSpec, dc as modeShortcuts, dd as modifierStateOf, de as multiTouchGestureId, df as offhandKeyFor, dg as openPointerSession, dh as overlaysOf, di as overriddenBindings, dj as pendingKindOf, dk as pickMenu, dl as pointerGestureId, dm as readActionSettings, dn as reportRouteConflicts, dp as resolveBindingOverrides, dq as resolveDeviceProfile, dr as resolveMenu, ds as resolveParams, dt as resolveSchemaMenu, du as returnToModeDefault, dv as roleReader, dw as routesForSpec, dx as ruleCanHoldIn, dy as rulesExclusive, dz as scopeBindings, dA as scratchKey, dB as setScratch, dC as startCarry, dD as steppedOption, dE as taggedActionItems, dF as targetConsultsAffordance, dG as toolIdsOf, dH as toolOptionParams, dI as toolOptionSteps, dJ as toolSet, dK as toolSetHas, dL as tuneAction, dM as validateActionDefaultBinding, dN as validateActionId, dO as withoutTools } from './index-CBxf3Cxm.js';
 export { CONTROL_SELECTOR, ChannelRef, DRAG_THRESHOLD_PX, DescribeRouteOptions, GESTURE_DESCRIPTORS, GestureArgSpec, GestureDescriptor, GestureName, IngestItem, InputEvent, LONG_PRESS_MS, ModRequirement, ModifierKey, ParsedModifiers, ParsedRoute, PhaseAtom, PhaseContext, RESERVED_ID_NAMES, RESERVED_ID_PREFIXES, ROUTE_FIELD_DEFINITIONS, ROUTE_TERMS, RouteDescriptionPart, RouteFieldName, RouteTermLabel, activatesFocusedControl, canonicalModifiers, collapseShiftPairs, describeRoute, describeRouteParts, focusedControlOwnsKey, formatPhaseAtom, formatRoute, getGestureDescriptor, isEditableTarget, isInControlWithin, isKnownGestureName, matchKey, matchModifiers, matchPhase, matchSpec, matchTarget, parseRoute, pastDragThreshold, routeGestureForSpecKind, specKindForRouteGesture, specificity } from '@weasel-js/gestures';
 export { SelectionExtendKey, SelectionMode } from '@weasel-js/select';
 export { View } from '@weasel-js/geom';

package/dist/index.js

@@ -1,7 +1,7 @@
-export { ALWAYS, COARSE_TARGET_SCALE, DEFAULT_ALLOWED_CAPABILITIES, DEFAULT_DEVICE_PROFILE, GESTURE_DESCRIPTORS, INGEST_STRING_MIMES, KEYMAP_HOLD, LONG_PRESS_MS, NEVER, PREDICATE_TARGET, TOOL_OFFHAND_ID, activatesFocusedControl, admitIngestMime, assembleEntries, buildRouteRegistry, buildRuleCtx, buildToolOffhandBindings, clientToCanvas, clientToCanvasRect, createDispatchTrace, createDispatcher, createKeymapStack, createLongPressStore, createTraceRing, describeKeymap, describeRule, dlog, dwarn, evaluate, findConflicts, focusedControlOwnsKey, getGestureDescriptor, heldKeySpec, historyKey, isDebugEnabled, isEditableTarget, isKnownGestureName, isTool, itemTypesFromDataTransfer, itemsFromClipboardData, itemsFromDataTransfer, itemsFromFiles, keymapContribution, keymapLeaderBindingId, keymapLeaderId, keymapShortcuts, liveScope, makeToolOffhandAction, matchBest, matchKey, matchModifiers, matchPhase, matchSorted, matchSortedWithBarred, matchSpec, matchTarget, matchesKeyBinding, modifierStateOf, multiTouchGestureId, offhandKeyFor, openPointerSession, pendingKindOf, pointerGestureId, reportRouteConflicts, resolveDeviceProfile, routeGestureForSpecKind, routesForSpec, ruleCanHoldIn, rulesExclusive, scopeBindings, specKindForRouteGesture, specificity, startCarry, targetConsultsAffordance } from './chunk-ZK72IBMI.js';
-import { actionItems, actionItemTitle, resolveParams, ActionDisabledReason } from './chunk-A6MN3I6R.js';
-export { ActionDisabledReason, RESERVED_ID_NAMES, RESERVED_ID_PREFIXES, ROUTE_FIELD_DEFINITIONS, ROUTE_TERMS, actionBindings, actionCursor, actionItemTitle, actionItems, actionSettingsParams, actionShortcuts, bindingId, buildDepsFromRequires, canonicalModifiers, collapseShiftPairs, createDepRegistry, createMenuHost, describeRoute, describeRouteParts, evaluateActive, evaluateEnabled, formatPhaseAtom, formatRoute, keySpecShortcut, keysHeld, mergeMenuDefs, overriddenBindings, parseRoute, pickMenu, readActionSettings, resolveBindingOverrides, resolveMenu, resolveParams, resolveSchemaMenu, roleReader, tuneAction, validateActionDefaultBinding, validateActionId } from './chunk-A6MN3I6R.js';
-import { hasTag, matchQuery } from '@weasel-js/registry';
+export { ALWAYS, COARSE_TARGET_SCALE, DEFAULT_ALLOWED_CAPABILITIES, DEFAULT_DEVICE_PROFILE, GESTURE_DESCRIPTORS, INGEST_STRING_MIMES, KEYMAP_HOLD, LONG_PRESS_MS, NEVER, PREDICATE_TARGET, TOOL_OFFHAND_ID, activatesFocusedControl, admitIngestMime, assembleEntries, buildRouteRegistry, buildRuleCtx, buildToolOffhandBindings, clientToCanvas, clientToCanvasRect, createDispatchTrace, createDispatcher, createKeymapStack, createLongPressStore, createTraceRing, describeKeymap, describeRule, dlog, dwarn, evaluate, findConflicts, focusedControlOwnsKey, getGestureDescriptor, heldKeySpec, historyKey, isDebugEnabled, isEditableTarget, isKnownGestureName, isTool, itemTypesFromDataTransfer, itemsFromClipboardData, itemsFromDataTransfer, itemsFromFiles, keymapContribution, keymapLeaderBindingId, keymapLeaderId, keymapShortcuts, liveScope, makeToolOffhandAction, matchBest, matchKey, matchModifiers, matchPhase, matchSorted, matchSortedWithBarred, matchSpec, matchTarget, matchesKeyBinding, modifierStateOf, multiTouchGestureId, offhandKeyFor, openPointerSession, pendingKindOf, pointerGestureId, reportRouteConflicts, resolveDeviceProfile, routeGestureForSpecKind, routesForSpec, ruleCanHoldIn, rulesExclusive, scopeBindings, specKindForRouteGesture, specificity, startCarry, targetConsultsAffordance } from './chunk-HCO42UVG.js';
+import { actionItems, actionItemTitle, resolveParams, ActionDisabledReason } from './chunk-TTIRQ4BV.js';
+export { ActionDisabledReason, RESERVED_ID_NAMES, RESERVED_ID_PREFIXES, ROUTE_FIELD_DEFINITIONS, ROUTE_TERMS, actionBindings, actionCursor, actionItemTitle, actionItems, actionSettingsParams, actionShortcuts, bindingId, buildDepsFromRequires, canonicalModifiers, collapseShiftPairs, createDepRegistry, createMenuHost, describeRoute, describeRouteParts, evaluateActive, evaluateEnabled, formatPhaseAtom, formatRoute, keySpecShortcut, keysHeld, mergeMenuDefs, overriddenBindings, parseRoute, pickMenu, readActionSettings, resolveBindingOverrides, resolveMenu, resolveParams, resolveSchemaMenu, roleReader, tuneAction, validateActionDefaultBinding, validateActionId } from './chunk-TTIRQ4BV.js';
+import { hasTag, matchQuery, createEmitter } from '@weasel-js/registry';
 import { bodyPredicate, hitPredicate, key, isApplePlatform, createPointerRecognizer, RESERVED_ID_PREFIXES, RESERVED_ID_NAMES, DOUBLE_CLICK_MAX_MS } from '@weasel-js/gestures';
 export { CONTROL_SELECTOR, DRAG_THRESHOLD_PX, isInControlWithin, pastDragThreshold } from '@weasel-js/gestures';
 import { modeLabel } from '@weasel-js/modes';
@@ -375,24 +375,17 @@ function captureKey(target, opts = {}) {
     ...opts.apple !== void 0 ? { apple: opts.apple } : {}
   });
 }
-
-// src/tools/toolOptions.ts
 var NONE = Object.freeze({});
 function createToolOptionValues() {
   const values = /* @__PURE__ */ new Map();
-  const listeners = /* @__PURE__ */ new Set();
+  const changed = createEmitter();
   return {
     get: (toolId) => values.get(toolId) ?? NONE,
     set(toolId, option, value) {
       values.set(toolId, { ...values.get(toolId), [option]: value });
-      for (const l of [...listeners]) l();
+      changed.emit();
     },
-    subscribe(listener) {
-      listeners.add(listener);
-      return () => {
-        listeners.delete(listener);
-      };
-    }
+    subscribe: changed.subscribe
   };
 }
 function leafOf(options, option) {