@searsuite/sear-assembly-plugin

Stable machine-readable identifier for this error category.

Adds one owned resource disposer in acquisition order.

Runs every disposer in reverse order and continues cleanup after individual failures.

DI token for resolving HeadlessToolbar.

Releases resources owned by SearToolbar.

Attaches this adapter to its host surface.

Creates a plugin with its stable identity and initial state.

Draw and event ordering hint; lower values run earlier.

Document-state export modules owned by this plugin state.

Declares which Sheet OT action names this plugin is interested in. The engine will only call apply when a transaction contains at least one operation matching these action names, unless the transaction is owned by this plugin.

• ['uc', 'rr', 'rc'] — only called for UpdateCell, ResizeRow, ResizeCol
• ['*'] — called for any transaction (wildcard)
• [] — only called for this plugin's own transactions

Stable plugin key used by PluginManager and SceneGraph ownership maps.

Optional history behavior for transactions owned by this plugin.

Shared transaction algebra used by history and collaboration.

Whether PluginManager should warn when another ordered plugin shares this depth.

Applies a transaction to plugin-owned state and returns the next state.

Optional. Return the pixel-space dirty rectangle that needs to be redrawn after this plugin processes transaction.

When implemented, SearCoreSheet.dispatch will call markDirty with the returned rect and skip a full-canvas re-render for this plugin. When omitted (or when null/undefined is returned), dispatch falls back to a full render pass.

Installs the editor's command check for plugin-owned runtime sessions.

Restricts state replacement to the owning editor's commit phase.

Returns this plugin's runtime configuration view for the current core.

Returns the plugin-owned state currently registered with the manager.

Reports whether the owning runtime has taken control of state replacement.

Optionally locks a committed plugin-owned local state value against retained handles.

Plugin pointer event handlers.

Return value contract:

• Return false to stop subsequent plugins from handling the same event.
• Return true / undefined / void to continue dispatching.

This mechanism allows a plugin to explicitly suppress downstream handlers after it has consumed an event, replacing the old coupled approach where one plugin directly modified another plugin's state.

Handles a double-click pointer event.

Receives one non-empty cell during SearCoreSheet's shared startup scan. The scan runs once after every plugin state has been registered, so plugins can build derived indexes without independently traversing the whole sheet.

Called after the final cell of the shared startup scan is delivered.

Handles the start of a pointer press sequence.

Handles pointer movement over the host surface.

Handles the end of a pointer press sequence.

Optional hook invoked when the host viewport or sheet dimensions change.

Receives scroll state changes from the active scroll manager.

Runs only after every step in the enclosing pipeline has succeeded and all staged plugin state has been committed. Use it for derived caches, notifications, persistence, and transport; never perform those effects in apply, because a later pipeline step may still fail.

Purely plans owner-targeted prerequisites before another owner's explicit transaction. Sheet runtimes stage these once, atomically with the original transaction, and retain them in the command pipeline for history and collaboration. Never mutate input state.

Registers default configuration values owned by this plugin.

Registers one or more plugin-owned state records with the host manager.

Produces scene nodes owned by this plugin for the current core state.

Fixes transaction and export metadata after the editor takes ownership.

Pins transaction and render hooks after plugin startup.

Closes runtime-owned extension writes after every plugin has initialized and started.

Replaces the plugin-owned state after an apply or runtime transition.

Constructs a key using the provided base name.

Unique plugin key string.

Creates a PluginManager bound to the host diagnostics channel when available.

DI token for resolving the runtime plugin manager.

Removes all registered plugins during host teardown.

Gives the owning runtime exclusive registry write access after assembly.

Visits plugins in depth order so event, apply and render flows stay deterministic.

Returns all registered plugins in insertion order.

Resolves a stable collaboration owner to its editor-local plugin instance.

Lists collaborative transaction owners registered in this runtime.

Lists document-state export contributions registered by plugin state owners.

Returns the state owned by a registered plugin key, if present.

Returns the history adapter contributed by a transaction's state owner.

Returns the shared transaction OT contribution for one local transaction owner.

Inverts a transaction through its owner's registered OT definition.

Registers a plugin under its key and rejects duplicate ownership.

Rebases a retained transaction over another committed transaction through the shared registry.

Unregisters a plugin and clears the manager-owned state reference.

Stable machine-readable identifier for this error category.

Permanently closes the registry and releases all published values.

Requires editor command dispatch for capability changes after assembly.

Registers one value and returns an idempotent disposer for that registration.

DI token for resolving SearToolbar.

Releases resources owned by SearToolbar.

Attaches this adapter to its host surface.

Creates a session-state contract error.

Stable machine-readable error code.

DI token for resolving the editor-local registry.

Rejects a retained contributor restore callback after editor initialization.

Captures every registered contributor while preserving state whose owner is not loaded.

Clears contributors and retained state owned by this registry instance.

Returns restore phases already completed by this editor lifecycle.

Returns sorted ids for currently registered contributors.

Loads a complete snapshot before lifecycle restoration begins.

Registers one state owner and returns an idempotent disposer.

Restores every registered contributor assigned to one ordered lifecycle phase.

Closes initialization-only restore operations for an assembled editor.

Plans all format owners against the same unchanged pre-clear state.

Assesses all owner constraints without planning or publishing any mutation.

Releases all editor-owned registrations.

Validates all owners before testing destination conflicts.

Plans all owners against the same pre-move state.

Registers one owner and returns an idempotent disposer.

Creates the command failure from the same assessment consumed by preview.

Stable machine-readable identifier for this error category.

Releases editor-owned contributions.

Validates the original intent before compiling dependent operation updates.

Registers one contribution with order-independent, idempotent disposal.

Registers every stable command id owned by this plugin.

Registers every stable command id owned by this plugin.

Plain configuration values consumed and wrapped by ConfigEngine.

Plugin key that owns this configuration unit.

Field selectors contributed by this state to named read-only data views.

When false, Core keeps the plugin private to PluginManager and skips DataEngine registration.

Field name written into the named view. Duplicate names in one view are rejected by DataEngine.

When false, a missing state or void field does not make the containing view unavailable.

Reads the field value from the current plugin-owned state whenever the view is requested.

Named data view that receives this field, such as a sheet-level read model.

Registers every typed state and event observation source owned by this plugin.

Registers every typed state and event observation source owned by this plugin.

Registers every runtime capability owned by this plugin.

Registers every local session value owned by this plugin.

Registers every local session value owned by this plugin.

Stable key under which the plugin registers state, config and scene nodes.

Initial state owned by the plugin.

DataEngine exposure metadata for this state registration.

Plugin key that owns the registered state.

State value to register for that plugin key.

Creates the transaction that reverses the supplied committed transaction.

Rebases a retained transaction over a transaction that committed later.

Reverses an operation list in rollback order.

Rebases an operation list over operations that committed later.

Whether committed transactions owned by this plugin may cross a collaboration transport.

Versioned operation family used by history and collaboration.

Stable wire identity independent from process-local PluginKey suffixes.

Explicit relations needed by third-party operation families.

Phantom member preserving the capability value type.

Contributors in the same phase that must restore before this one when they are registered.

Lifecycle phase in which restore() may safely update the owning feature.

Returns plain data or a supported built-in value; custom class instances are not session snapshots.

Restores local state during the declared lifecycle phase.

Stable, globally unique id used in the in-memory session snapshot.

Compile-time state carrier; never populated at runtime.

Plans removal of this owner's explicit formats without changing cell content.

Plans a captured source pattern using this owner's current target state.

Captured owner data that can be planned against another Sheet instance.

Unique registration identity, conventionally <owner>.rangeMove; not a document field or operation target.

Reports whether destination data outside the source would be replaced.

Reads current state and produces an isolated operation plan.

Rewrites plans after every state owner has contributed, for derived references.

Reads owner-specific invariants without mutation; rejected constraints throw a SearError.

Maps a source row to its final row; columns never change.