Interface ActionsRegistryExperimental

Start an ongoing action driven by UI (color picker, opacity slider). Returns a control object with update(params) and end(reason).

Returns null if no dispatcher is wired into this registry, the action is unknown, or its invoker is not ongoing.

See Dispatcher.beginUiOngoing for full semantics including auto-commit when a prior UI handle for the same action is in flight.

Wire a DepRegistry into the registry so trigger() / begin() can resolve action deps even when this provider is mounted ABOVE the dep registry (e.g. a consumer's root <ActionsProvider> reused by SceneCanvas's ActionsProviderIfRoot). Takes precedence over the dep registry read from context at the provider's own level. Call with null to detach.

Wire a dispatcher into the registry so begin() can delegate to it. Call with null to detach. Idempotent.

Subscribe to registry mutations. The callback fires after any register/unregister that changes the version. Returns an unsubscribe function. Designed for useSyncExternalStore-driven surfaces (e.g. <ActionBar> in @weasel-js/ui) that need to re-render when the action set changes.

Fire an immediate-invoker action by id. The optional params arg is forwarded to ImmediateInvoker.run as its second argument — use it for parametric actions (e.g. trigger('tool.activate', { toolId: 'rect' })). Ongoing-invoker actions are not reachable from trigger.