@weasel-js/routing 1.15.0 → 1.15.1

package/dist/{index-C2EcHkCp.d.ts → index-D-XFwx8D.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 {

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-D-XFwx8D.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,6 +1,6 @@
-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';
+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-ZUAFANMN.js';
+import { actionItems, actionItemTitle, resolveParams, ActionDisabledReason } from './chunk-Z2BZBJ7W.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-Z2BZBJ7W.js';
 import { hasTag, matchQuery } 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';

package/dist/{internal-C8-r3Zmo.d.ts → internal-nqfC0td8.d.ts}

@@ -1,4 +1,4 @@
-import { r as Dispatcher, d as ActionsRegistry, C as Contribution, W as WorldPoint, s as AffordanceHit, t as DispatchTrace, v as LongPressOptions, R as RuleCtx, w as DepSchema } from './index-C2EcHkCp.js';
+import { r as Dispatcher, d as ActionsRegistry, C as Contribution, W as WorldPoint, s as AffordanceHit, t as DispatchTrace, v as LongPressOptions, R as RuleCtx, w as DepSchema } from './index-D-XFwx8D.js';
 import { RefObject } from 'react';
 import { BodyClassification } from '@weasel-js/gestures';
 import { PaintedCursorState, CursorSink } from '@weasel-js/cursor';
@@ -102,6 +102,13 @@ interface UseGestureDispatcherOptions {
      * nest under.
      */
     hears?: 'scope' | 'own';
+    /**
+     * With no canvas: hear no key while a canvas dispatching on `actions`
+     * itself holds the keys. That canvas hears everything this one does, and
+     * runs it with its own views and deps. For an app-wide dispatcher whose
+     * canvases share its registry. Default `false`.
+     */
+    yieldKeys?: boolean;
     /** Every entry in play, keyed by id: tools and any other contribution
      *  whose bindings this dispatcher routes. */
     entriesById: ReadonlyMap<string, Contribution<unknown>>;

package/dist/internal.d.ts

@@ -1,5 +1,5 @@
-export { a as DispatcherViewTarget, V as ViewIdResolver } from './internal-C8-r3Zmo.js';
-import './index-C2EcHkCp.js';
+export { a as DispatcherViewTarget, V as ViewIdResolver } from './internal-nqfC0td8.js';
+import './index-D-XFwx8D.js';
 import '@weasel-js/history';
 import '@weasel-js/prefs';
 import '@weasel-js/geom';

package/dist/react.d.ts

@@ -1,9 +1,9 @@
-import { U as UseGestureDispatcherOptions } from './internal-C8-r3Zmo.js';
-export { D as DispatcherChannels } from './internal-C8-r3Zmo.js';
+import { U as UseGestureDispatcherOptions } from './internal-nqfC0td8.js';
+export { D as DispatcherChannels } from './internal-nqfC0td8.js';
 import * as react from 'react';
 import { ReactNode, ReactElement } from 'react';
-import { D as DepRegistry, a as DepName, b as DepSource, S as ScopeNode, L as LastOperationKeeper, A as Action, c as ActionDeps, M as MenuHost, d as ActionsRegistry, e as ActionDisabledReason, B as BoundGesture, f as ActionVariant, g as LastOperationStore, h as LastOperation, i as MenuDef, j as DepNode, T as ToolNode, K as KeymapDescription, W as WorldPoint, N as NodeId, k as KernelOverlay, C as Contribution, l as Tool, O as OverlayPosition } from './index-C2EcHkCp.js';
-export { m as ActiveToolContextProvider, n as ActiveToolContextProviderIfRoot, o as ActiveToolContextProviderProps, p as ActiveToolContextValue, u as useActiveToolContext, q as useOptionalActiveToolContext } from './index-C2EcHkCp.js';
+import { D as DepRegistry, a as DepName, b as DepSource, S as ScopeNode, L as LastOperationKeeper, A as Action, c as ActionDeps, M as MenuHost, d as ActionsRegistry, e as ActionDisabledReason, B as BoundGesture, f as ActionVariant, g as LastOperationStore, h as LastOperation, i as MenuDef, j as DepNode, T as ToolNode, K as KeymapDescription, W as WorldPoint, N as NodeId, k as KernelOverlay, C as Contribution, l as Tool, O as OverlayPosition } from './index-D-XFwx8D.js';
+export { m as ActiveToolContextProvider, n as ActiveToolContextProviderIfRoot, o as ActiveToolContextProviderProps, p as ActiveToolContextValue, u as useActiveToolContext, q as useOptionalActiveToolContext } from './index-D-XFwx8D.js';
 import { IconRef } from '@weasel-js/icons';
 import { ModeRegistry } from '@weasel-js/modes';
 import '@weasel-js/gestures';
@@ -119,6 +119,8 @@ interface CommandOptions {
     keys?: BoundGesture | readonly BoundGesture[];
     /** Shown beside the label. */
     icon?: IconRef;
+    /** The registry group a bar drawing one group gathers it under. */
+    group?: string;
     /** Words a palette finds it by and a tagged bar or menu gathers it under. */
     tags?: readonly string[];
     /** One entry each in a bar, menu or palette; `run` receives the chosen one's params. */
@@ -129,7 +131,7 @@ interface CommandOptions {
  * for the calling component's lifetime, so a menu, toolbar, palette or key
  * can run it. Callbacks and option functions may be new on every render: the
  * latest are read when used, and the action is replaced only when `id`,
- * `label`, `icon`, `keys`, `tags` or `variants` change by value.
+ * `label`, `icon`, `group`, `keys`, `tags` or `variants` change by value.
  */
 declare function useCommand(id: string, label: string, run: (params?: Readonly<Record<string, unknown>>) => void, options?: CommandOptions): void;
 

package/dist/react.js

@@ -1,7 +1,7 @@
-import { createKeymapStack, createDispatchTrace, createDispatcher, describeKeymap, assembleEntries, liveScope, offhandKeyFor, makeToolOffhandAction, buildToolOffhandBindings, dlog, reportRouteConflicts, isTool, clientToCanvas, LONG_PRESS_HAPTIC_MS, multiTouchGestureId, openPointerSession, addCarrySurface, carryGestureId, anyBinding, isEditableTarget, focusedControlOwnsKey, itemsFromClipboardData, itemsFromDataTransfer, itemTypesFromDataTransfer, immediateParams } from './chunk-ZK72IBMI.js';
-import { useDepRegistry, actionsNodeOf, useAction, useActionsRegistry, useOptionalDepRegistry, ActionsNode, MenuHostContext, DepRegistryContext, ActionsContext } from './chunk-3SPPC6UP.js';
-export { ActionsProvider, DepRegistryProvider, useAction, useActionsRegistry, useDepRegistry, useDepSource, useMenuHost, useMenus, useOptionalDepRegistry } from './chunk-3SPPC6UP.js';
-import { NO_OVERRIDES, ScopeNode, depNodeOf, DepNode, actionCursor, buildDepsFromRequires } from './chunk-A6MN3I6R.js';
+import { createKeymapStack, createDispatchTrace, createDispatcher, describeKeymap, assembleEntries, liveScope, offhandKeyFor, makeToolOffhandAction, buildToolOffhandBindings, dlog, reportRouteConflicts, isTool, clientToCanvas, LONG_PRESS_HAPTIC_MS, multiTouchGestureId, openPointerSession, addCarrySurface, carryGestureId, anyBinding, isEditableTarget, itemsFromClipboardData, itemsFromDataTransfer, itemTypesFromDataTransfer, immediateParams, focusedControlOwnsKey } from './chunk-ZUAFANMN.js';
+import { useDepRegistry, actionsNodeOf, useAction, useActionsRegistry, useOptionalDepRegistry, ActionsNode, MenuHostContext, DepRegistryContext, ActionsContext } from './chunk-VAUJJODS.js';
+export { ActionsProvider, DepRegistryProvider, useAction, useActionsRegistry, useDepRegistry, useDepSource, useMenuHost, useMenus, useOptionalDepRegistry } from './chunk-VAUJJODS.js';
+import { NO_OVERRIDES, ScopeNode, depNodeOf, DepNode, actionCursor, buildDepsFromRequires } from './chunk-Z2BZBJ7W.js';
 import { createContext, useState, useContext, useEffect, useRef, useMemo, useCallback, useSyncExternalStore } from 'react';
 import { isApplePlatform, heldPointers, createPointerRecognizer, isInControlWithin, longPressEvents, stylusOf } from '@weasel-js/gestures';
 import { useLatest, useKitSettings, useStableByContent, sameList, isDev } from '@weasel-js/react';
@@ -187,7 +187,10 @@ function createDispatchCore(src) {
     }),
     batch,
     keymaps: () => src.context().keymaps,
-    holdsKeys: () => canvas ? src.actions().holdsKeys() : src.actions().isActive(),
+    holdsKeys: () => {
+      const a = src.actions();
+      return canvas ? a.holdsKeys() : a.isActive() && !(src.yieldKeys === true && a.holdsKeys());
+    },
     pointerOver: () => over,
     setPointerOver: (next) => {
       over = canvas !== null && next;
@@ -1011,6 +1014,7 @@ function attachInput(canvas, src, channels) {
     clientToLocal: src.clientToLocal,
     context: src.context,
     actions: src.actions,
+    yieldKeys: src.yieldKeys,
     uses: () => {
       redraw.sync(src.dispatchers());
     },
@@ -1112,7 +1116,7 @@ function trackPointerOver(listeners, canvas, core, keys) {
 
 // src/interactions/dispatcher/useGestureDispatcher.tsx
 function useGestureDispatcher(opts) {
-  const { canvasRef, actions, entriesById, enabled = true, keyboard = true, affordanceAt, classifyTarget, dispatcher: dispatcherOpt, trace: traceOpt, clientToWorld, clientToLocal, requestRedraw, paintedCursor, cursorSink, getRuleCtx, onClick, onDoubleClick, views, channels, longPress, claimKeys = false, hears = "scope" } = opts;
+  const { canvasRef, actions, entriesById, enabled = true, keyboard = true, affordanceAt, classifyTarget, dispatcher: dispatcherOpt, trace: traceOpt, clientToWorld, clientToLocal, requestRedraw, paintedCursor, cursorSink, getRuleCtx, onClick, onDoubleClick, views, channels, longPress, claimKeys = false, hears = "scope", yieldKeys = false } = opts;
   const pointerChannel = channels?.pointer !== false;
   const hoverChannel = channels?.hover ?? pointerChannel;
   const wheelChannel = channels?.wheel !== false;
@@ -1201,7 +1205,8 @@ function useGestureDispatcher(opts) {
       kitSettings: () => kitSettingsRef.current,
       onClick: () => onClickRef.current,
       onDoubleClick: () => onDoubleClickRef.current,
-      clicks: clicksRef.current
+      clicks: clicksRef.current,
+      yieldKeys
     }, {
       keyboard,
       pointer: pointerChannel,
@@ -1215,6 +1220,7 @@ function useGestureDispatcher(opts) {
   }, [
     enabled,
     keyboard,
+    yieldKeys,
     canvasRef,
     pointerChannel,
     hoverChannel,
@@ -1245,6 +1251,7 @@ function useCommand(id, label, run, options) {
   const hasEnabled = options?.enabled !== void 0;
   const hasActive = options?.active !== void 0;
   const icon = options?.icon;
+  const group = options?.group;
   const action = useMemo(() => {
     const read = () => latest.current.options;
     const a = {
@@ -1258,8 +1265,9 @@ function useCommand(id, label, run, options) {
     if (hasEnabled) a.enabled = () => read()?.enabled?.() ?? true;
     if (hasActive) a.active = () => read()?.active?.() ?? false;
     if (icon !== void 0) a.icon = icon;
+    if (group !== void 0) a.group = group;
     return a;
-  }, [id, label, icon, keys, tags, variants, hasEnabled, hasActive, latest]);
+  }, [id, label, icon, group, keys, tags, variants, hasEnabled, hasActive, latest]);
   useAction(action);
 }
 function bindingOf(keys) {