API reference
@searsuite/sear-assembly-setup
Public Sheet and Doc editor composition, lifecycle, commands, queries, and host-adapter wiring.
204 exportsderived from source
Concept 1
Choose an editor entry point
createSheetEditor() assembles one visual Sheet editor from an initial document, selected plugins, and host-provided
platform, rendering, and input adapters. Use createDocEditor() for a standalone rich-text document. A Workbook
host uses createWorkbookEditor() when it needs stable Sheet identities and switching between Sheets.
Import these entry points from their owning @searsuite/sear-assembly-* package. The assembly connects contracts;
it does not take ownership of a feature's document state. If no visual host is needed, createHeadlessEditor()
provides a smaller entry point for server work and tests.
Use when: the application is ready to provide the adapters required by its chosen editor and to own the editor lifecycle. Start with the headless assembly when rendering and input are unnecessary.
Concept 2
Follow state through the editor lifecycle
createEmptySheetDocumentState() supplies a starting Sheet state. After creation, application actions and input
handlers run typed commands through editor.commands; state owners stage operations, and the editor commits them
together. Queries read the current state, observations report committed changes, and capabilities expose services
owned by this editor instance.
A visual Sheet session also contains viewport and other local state. That session is separate from the durable
document. A Workbook captures the mounted Sheet's document and local session before switching Sheets. Call
editor.destroy() when the host unmounts the editor so adapters, listeners, and plugins release their resources.
Related concepts: commands define the mutation path; plugins own feature state; the Workbook assembly owns Sheet structure and switching.
- classCaretPluginsource ↗
-
class CaretPlugin extends DocPlugin<null>Owns caret movement, focus, blink state, and caret overlay rendering.
constructorconstructor CaretPlugin(caretState: DocCaretState): CaretPluginCreates a CaretPlugin instance.
caretState: DocCaretState
propertysymbolstatic readonly symbol: typeof symbolDI token for resolving CaretPlugin.
methodapply apply(_state: null, _transaction: unknown): nullApplies a transaction to plugin-owned state and returns the next state.
_state: null_transaction: unknown
methodconfigure configure(context: DocPluginSetupContext): voidConfigures the document editor before runtime start.
context: DocPluginSetupContext
methodgetPluginConfig getPluginConfig(): nullReturns this plugin's runtime configuration view for the current core.
methodonEditorDestroy onEditorDestroy(): voidReleases resources owned by this plugin before the Core is destroyed.
methodregisterCommands registerCommands(commands: DocCommandBus): voidRegisters every stable command id owned by this document plugin.
commands: DocCommandBus
methodregisterKeyboardHandlers registerKeyboardHandlers(__namedParameters: DocKeyboardHandlerRegistrationContext): voidRegisters keyboard-to-command bindings owned by this document plugin.
__namedParameters: DocKeyboardHandlerRegistrationContext
methodregisterState registerState(): { key: PluginKey; state: null }Registers one or more plugin-owned state records with the host manager.
methodrender render(): Node<NodeProperties>[] | nullProduces scene nodes owned by this plugin for the current core state.
methodregisterServicesstatic registerServices(context: DocPluginServiceContext): voidRegisters caret-owned state before the plugin is resolved.
context: DocPluginServiceContext
Inherited members 39
Inherited from DocPlugin.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getState
- hasStateWriteBoundary
- initialize
- lockCommittedState
- onClick
- onDblClick
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerBlockFlows
- registerCapabilities
- registerConfig
- registerInlineStyleRenderers
- registerInlineStyles
- registerLineBoxes
- registerObservations
- registerSessionState
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- start
- classDefaultSheetClipboardDataSourcesource ↗
-
class DefaultSheetClipboardDataSource extends SheetClipboardDataSourceDefault data source bridging clipboard commands to the active Sheet data view.
constructorconstructor DefaultSheetClipboardDataSource(dataEngine: DataEngine, queries: SheetQueryRegistry, ownerFormats: SheetFormatTransferRegistry, platform: Platform, rangeMoves: SheetRangeMoveRegistry, cutSession: SheetClipboardCutSession, identity: SheetClipboardSheetIdentity): DefaultSheetClipboardDataSourcedataEngine: DataEnginequeries: SheetQueryRegistryownerFormats: SheetFormatTransferRegistryplatform: PlatformrangeMoves: SheetRangeMoveRegistrycutSession: SheetClipboardCutSessionidentity: SheetClipboardSheetIdentity
propertycutSession readonly cutSession: SheetClipboardCutSessionpropertycutSourceId readonly cutSourceId: stringpropertyformatTarget readonly formatTarget: PluginKeypropertytarget readonly target: PluginKeymethodbindPreviewRuntime bindPreviewRuntime(core: SearCoreSheet, plugins: PluginManager<SearCoreSheet, CellProperties>, bridge: SheetClipboardWorkbookBridge | null): voidcore: SearCoreSheetplugins: PluginManager<SearCoreSheet, CellProperties>bridge: SheetClipboardWorkbookBridge | null
methodcaptureMergedRanges captureMergedRanges(range: SheetRangeBounds): readonly SheetClipboardMergedRange[]range: SheetRangeBounds
methodcaptureOwnerFormats captureOwnerFormats(range: SheetRangeBounds): readonly SheetPortableFormatTransfer[]range: SheetRangeBounds
methodclearOwnerFormats clearOwnerFormats(range: SheetRangeBounds): readonly SheetFormatTransferPlan[]range: SheetRangeBounds
methodcreateClipboardCutId createClipboardCutId(): stringmethodgetColumnCount getColumnCount(): numbermethodgetMergedRange getMergedRange(row: number, column: number): SheetRangeBounds | nullOptional host projection for rejecting writes hidden by merged cells.
row: numbercolumn: number
methodgetRowCount getRowCount(): numbermethodgetSelection getSelection(): SheetRangeBounds | nullmethodisRowVisible isRowVisible(row: number): booleanrow: number
methodplanClearMergedRanges planClearMergedRanges(range: SheetRangeBounds): { operations: UpdateCellOTOperation<SheetCellMerge>[]; target: PluginKey }range: SheetRangeBounds
methodplanOwnerFormats planOwnerFormats(captured: readonly SheetPortableFormatTransfer[], target: SheetRangeBounds): readonly SheetFormatTransferPlan[]captured: readonly SheetPortableFormatTransfer[]target: SheetRangeBounds
methodplanPasteMergedRanges planPasteMergedRanges(merges: readonly SheetClipboardMergedRange[], target: SheetClipboardCellPoint): { operations: UpdateCellOTOperation<SheetCellMerge>[]; target: PluginKey }merges: readonly SheetClipboardMergedRange[]target: SheetClipboardCellPoint
methodplanRangeMove planRangeMove(source: SheetClipboardRangeInput, destination: SheetClipboardRangeInput): readonly SheetRangeMovePlan[]source: SheetClipboardRangeInputdestination: SheetClipboardRangeInput
methodprepareCrossSheetCut prepareCrossSheetCut(cutId: string, clearPipeline: Pipeline): voidcutId: stringclearPipeline: Pipeline
methodreadCell readCell(row: number, column: number): CellMatrixElement | nullrow: numbercolumn: number
methodreadCellFormat readCellFormat(row: number, column: number): CellFormat | nullrow: numbercolumn: number
methodscheduleCrossSheetMove scheduleCrossSheetMove(cutId: string, sourceId: string, pastePipeline: Pipeline): Promise<void>cutId: stringsourceId: stringpastePipeline: Pipeline
- classDocCaretStatesource ↗
-
class DocCaretStateShared caret blink state used by document feature plugins and render layout.
constructorconstructor DocCaretState(): DocCaretStatepropertysymbolstatic readonly symbol: typeof symbolDI token for resolving caret state owned by CaretPlugin.
methodenforceCommandBoundary enforceCommandBoundary(isCommandExecuting: (): boolean): voidCloses direct caret writes after editor assembly.
isCommandExecuting: (): boolean
methodisVisible isVisible(): booleanReturns whether the caret should be painted in the current frame.
methodreset reset(): voidRestarts the blink cycle with the caret visible.
methodsetVisible setVisible(visible: boolean): voidSets the current caret visibility.
visible: boolean
methodtoggle toggle(): booleanToggles the caret visibility for a blink tick.
- classDocContentRenderPluginsource ↗
-
class DocContentRenderPlugin extends DocPlugin<null>Default content renderer for text nodes laid out by the document layout engine.
constructorconstructor DocContentRenderPlugin(): DocContentRenderPluginCreates a DocContentRenderPlugin instance.
propertysymbolstatic readonly symbol: typeof symbolDI token for resolving DocContentRenderPlugin.
methodapply apply(_state: null, _transaction: unknown): nullApplies a transaction to plugin-owned state and returns the next state.
_state: null_transaction: unknown
methodconfigure configure(context: DocPluginSetupContext): voidConfigures the document editor before runtime start.
context: DocPluginSetupContext
methodgetPluginConfig getPluginConfig(): nullReturns this plugin's runtime configuration view for the current core.
methodonEditorDestroy onEditorDestroy(): voidReleases resources owned by this plugin before the Core is destroyed.
methodregisterState registerState(): { key: PluginKey; state: null }Registers one or more plugin-owned state records with the host manager.
methodrender render(searCore: SearCoreDoc): Node<NodeProperties>[] | nullProduces scene nodes owned by this plugin for the current core state.
searCore: SearCoreDoc
Inherited members 42
Inherited from DocPlugin.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getState
- hasStateWriteBoundary
- initialize
- lockCommittedState
- onClick
- onDblClick
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerBlockFlows
- registerCapabilities
- registerCommands
- registerConfig
- registerInlineStyleRenderers
- registerInlineStyles
- registerKeyboardHandlers
- registerLineBoxes
- registerObservations
- registerSessionState
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- start
- registerServices
- classDocDebugOverlayPluginsource ↗
-
class DocDebugOverlayPlugin extends DocPlugin<null>Debug overlay for document block-level render bounds.
constructorconstructor DocDebugOverlayPlugin(): DocDebugOverlayPluginCreates a DocDebugOverlayPlugin instance.
propertysymbolstatic readonly symbol: typeof symbolDI token for resolving DocDebugOverlayPlugin.
methodapply apply(_state: null, _transaction: unknown): nullApplies a transaction to plugin-owned state and returns the next state.
_state: null_transaction: unknown
methodconfigure configure(context: DocPluginSetupContext): voidConfigures the document editor before runtime start.
context: DocPluginSetupContext
methodgetPluginConfig getPluginConfig(): nullReturns this plugin's runtime configuration view for the current core.
methodonEditorDestroy onEditorDestroy(): voidReleases resources owned by this plugin before the Core is destroyed.
methodregisterState registerState(): { key: PluginKey; state: null }Registers one or more plugin-owned state records with the host manager.
methodrender render(): Node<NodeProperties>[] | nullProduces scene nodes owned by this plugin for the current core state.
methodstart start(): voidStarts runtime behavior after the first document frame.
Inherited members 41
Inherited from DocPlugin.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getState
- hasStateWriteBoundary
- initialize
- lockCommittedState
- onClick
- onDblClick
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerBlockFlows
- registerCapabilities
- registerCommands
- registerConfig
- registerInlineStyleRenderers
- registerInlineStyles
- registerKeyboardHandlers
- registerLineBoxes
- registerObservations
- registerSessionState
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- registerServices
- classDocInputBindingRegistrysource ↗
-
class DocInputBindingRegistryRegistry that lets multiple document plugins contribute handlers to single-subscription input adapters.
constructorconstructor DocInputBindingRegistry(): DocInputBindingRegistrypropertysymbolstatic readonly symbol: typeof symbolDI token for resolving the input binding registry.
methodclear clear(): voidRemoves every registered handler.
methodcreateKeyboardHandlers createKeyboardHandlers(): KeyboardRouterHandlersCreates the composed keyboard handlers passed to the host keyboard adapter.
methodcreateTextHandlers createTextHandlers(): TextInputHandlersCreates the composed text handlers passed to the host text adapter.
methodenforceCommandBoundary enforceCommandBoundary(isCommandExecuting: (): boolean, isTearingDown: (): boolean): voidCloses registration changes after editor startup.
isCommandExecuting: (): booleanisTearingDown: (): boolean
methodregisterKeyboardHandlers registerKeyboardHandlers(handlers: KeyboardRouterHandlers): (): voidAdds keyboard-action handlers and returns a disposer.
handlers: KeyboardRouterHandlers
methodregisterTextHandlers registerTextHandlers(handlers: TextInputHandlers): (): voidAdds text-input handlers and returns a disposer.
handlers: TextInputHandlers
- classDocRenderLayoutServicesource ↗
-
class DocRenderLayoutServiceOwns Doc layout cache, page map, and viewport range derivation.
constructorconstructor DocRenderLayoutService(inputPlugin: DocInputPlugin, extensions: DocRuntimeExtensionRegistry, renderContext: RenderContext, scrollManager: ScrollManager, sceneTree: Tree<PositionRect<templateLiteral>>, configuration: DocEditorRuntimeConfiguration, configEngine: ConfigEngine, cursorManager: DocCursorManager, compositionProvider: DocCompositionProvider, layoutEngine: DocLayoutEngine, virtualLayouts: DocVirtualLayoutStore, commands: DocCommandBus): DocRenderLayoutServiceCreates a render-layout service for one standalone document editor.
inputPlugin: DocInputPluginextensions: DocRuntimeExtensionRegistryrenderContext: RenderContextscrollManager: ScrollManagersceneTree: Tree<PositionRect<templateLiteral>>configuration: DocEditorRuntimeConfigurationconfigEngine: ConfigEnginecursorManager: DocCursorManagercompositionProvider: DocCompositionProviderlayoutEngine: DocLayoutEnginevirtualLayouts: DocVirtualLayoutStorecommands: DocCommandBus
propertysymbolstatic readonly symbol: typeof symbolDI token for resolving the render-layout service.
methodgetLatestVirtualLayoutSummary getLatestVirtualLayoutSummary(): DocVirtualLayoutSummary | nullmethodprepareRenderLayout prepareRenderLayout(contentRect: DocEditorContentRect, viewport: DocEditorViewport, renderOperations?: DocRenderOperations): DocRenderLayoutBuilds the current render layout before plugins produce render nodes.
contentRect: DocEditorContentRectviewport: DocEditorViewportrenderOperations: DocRenderOperations
methodprepareViewportLayout prepareViewportLayout(contentRect: DocEditorContentRect, viewport: DocEditorViewport): DocRenderLayoutReuses the previous full-document layout and updates only viewport-derived fields.
contentRect: DocEditorContentRectviewport: DocEditorViewport
methodrecordBlockRenderDebugSnapshot recordBlockRenderDebugSnapshot(snapshot: DocBlockRenderDebugSnapshot): voidRecords block-render reuse/debug stats for the latest render frame.
snapshot: DocBlockRenderDebugSnapshot
methodrecordRenderPrepareTiming recordRenderPrepareTiming(mode: DocRenderPrepareMode, durationMs: number): voidmode: DocRenderPrepareModedurationMs: number
methodrefreshInteractionLayout refreshInteractionLayout(contentRect: DocEditorContentRect, _viewport: DocEditorViewport): DocRenderLayout | nullReuses the latest layout snapshot and refreshes selection/caret geometry only.
contentRect: DocEditorContentRect_viewport: DocEditorViewport
methodreset reset(): voidClears cached layout and page state.
methodsubscribeVirtualLayoutSummary subscribeVirtualLayoutSummary(listener: DocVirtualLayoutSummaryListener): (): voidlistener: DocVirtualLayoutSummaryListener
- classHistoryPluginsource ↗
-
class HistoryPlugin extends DocPlugin<null>Tracks committed document snapshots and contributes transaction-safe undo/redo commands.
constructorconstructor HistoryPlugin(input: DocInputPlugin, platform?: Platform): HistoryPlugininput: DocInputPluginplatform: Platform
propertysymbolstatic readonly symbol: typeof symbolDI token for resolving HistoryPlugin.
methodapply apply(_state: null, _transaction: Transaction): nullApplies a transaction to plugin-owned state and returns the next state.
_state: null_transaction: Transaction
methodconfigure configure(context: DocPluginSetupContext): voidRegisters document undo and redo shortcuts with the composed keyboard adapter.
context: DocPluginSetupContext
methodgetPluginConfig getPluginConfig(): nullReturns this plugin's runtime configuration view for the current core.
methodgetStatus getStatus(): DocHistoryStatusmethodinitialize initialize(): voidAligns the history baseline with state restored before Core initialization.
methodonEditorDestroy onEditorDestroy(): voidReleases resources owned by this plugin before the Core is destroyed.
methodonTransactionCommitted onTransactionCommitted(transaction: Transaction): voidUpdates history only after Core has committed the owning document transaction.
transaction: Transaction
methodregisterCommands registerCommands(commands: DocCommandBus): voidRegisters every stable command id owned by this document plugin.
commands: DocCommandBus
methodregisterKeyboardHandlers registerKeyboardHandlers(__namedParameters: DocKeyboardHandlerRegistrationContext): voidRegisters keyboard-to-command bindings owned by this document plugin.
__namedParameters: DocKeyboardHandlerRegistrationContext
methodregisterObservations registerObservations(observations: ObservationRegistry): voidRegisters typed state and event observations owned by this document plugin.
observations: ObservationRegistry
methodregisterSessionState registerSessionState(registry: SessionStateRegistry): voidRegisters local state that must survive an in-memory editor remount.
registry: SessionStateRegistry
methodregisterState registerState(): { dataEngine: { enabled: boolean }; key: PluginKey; state: null }Registers one or more plugin-owned state records with the host manager.
methodrender render(): Node<NodeProperties>[] | nullProduces scene nodes owned by this plugin for the current core state.
methodsubscribe subscribe(listener: (status: DocHistoryStatus): void): (): voidlistener: (status: DocHistoryStatus): void
Inherited members 36
Inherited from DocPlugin.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getState
- hasStateWriteBoundary
- lockCommittedState
- onClick
- onDblClick
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- projectTransaction
- registerBlockFlows
- registerCapabilities
- registerConfig
- registerInlineStyleRenderers
- registerInlineStyles
- registerLineBoxes
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- start
- registerServices
- classRichTextBlockNodesource ↗
-
class RichTextBlockNode extends RichTextVisualNodeScene node that indexes and draws one top-level rich-text block.
constructorconstructor RichTextBlockNode(input: { block: { id: string; index: number }; font: string; lineRenderer: RichTextLineRenderer; lines: readonly RichTextRenderLine[]; origin?: Pick<PositionRectProps, "x" | "y">; rect: PositionRectProps }): RichTextBlockNodeCreates a block-level rich-text scene node.
input: { block: { id: string; index: number }; font: string; lineRenderer: RichTextLineRenderer; lines: readonly RichTextRenderLine[]; origin?: Pick<PositionRectProps, "x" | "y">; rect: PositionRectProps }
methoddrawScene drawScene(context: RenderContext, clipRegion?: ClipRegion): voidDraws all visible text runs inside this block.
context: RenderContextclipRegion: ClipRegion
Inherited members 42
Inherited from RichTextVisualNode.
- childKeys
- depth
- name
- nodeKey
- parentKey
- positionRect
- properties
- randomColorKey
- sticky
- bottom
- configEngine
- fill
- height
- horizontalAlign
- left
- lineDash
- right
- stroke
- strokeWidth
- top
- verticalAlign
- width
- x
- y
- add
- addEventListener
- bindRuntime
- clear
- dispose
- draw
- drawHit
- emit
- enforceWriteBoundary
- getNodeByNodeKey
- getNodeByRandomColorKey
- off
- on
- query
- removeChild
- removeEventListener
- setStickyTree
- toJSON
- classRichTextRunNodesource ↗
-
class RichTextRunNode extends RichTextVisualNodeScene node that draws one contiguous styled rich-text run in world coordinates.
constructorconstructor RichTextRunNode(input: { baselineY: number; font: string; fontAscent: number; fontDescent: number; properties: Partial<RichTextRenderNodeProperties>; rect: PositionRectProps; runRenderer: RichTextRunRenderer; style?: Readonly<Record<string, unknown>>; … }): RichTextRunNodeCreates a text-run scene node.
input: { baselineY: number; font: string; fontAscent: number; fontDescent: number; properties: Partial<RichTextRenderNodeProperties>; rect: PositionRectProps; runRenderer: RichTextRunRenderer; style?: Readonly<Record<string, unknown>>; … }
methoddrawScene drawScene(context: RenderContext, clipRegion?: ClipRegion): voidDraws the text run into the active world-space transform.
context: RenderContextclipRegion: ClipRegion
Inherited members 42
Inherited from RichTextVisualNode.
- childKeys
- depth
- name
- nodeKey
- parentKey
- positionRect
- properties
- randomColorKey
- sticky
- bottom
- configEngine
- fill
- height
- horizontalAlign
- left
- lineDash
- right
- stroke
- strokeWidth
- top
- verticalAlign
- width
- x
- y
- add
- addEventListener
- bindRuntime
- clear
- dispose
- draw
- drawHit
- emit
- enforceWriteBoundary
- getNodeByNodeKey
- getNodeByRandomColorKey
- off
- on
- query
- removeChild
- removeEventListener
- setStickyTree
- toJSON
- classSelectionPluginsource ↗
-
class SelectionPlugin extends DocPlugin<null>Owns document selection commands, select-all shortcut, and pointer drag selection.
constructorconstructor SelectionPlugin(input: DocInputPlugin): SelectionPlugininput: DocInputPlugin
propertysymbolstatic readonly symbol: typeof symbolDI token for resolving SelectionPlugin.
methodapply apply(_state: null, _transaction: unknown): nullApplies a transaction to plugin-owned state and returns the next state.
_state: null_transaction: unknown
methodconfigure configure(context: DocPluginSetupContext): voidConfigures the document editor before runtime start.
context: DocPluginSetupContext
methodgetPluginConfig getPluginConfig(): nullReturns this plugin's runtime configuration view for the current core.
methodonEditorDestroy onEditorDestroy(): voidReleases resources owned by this plugin before the Core is destroyed.
methodregisterCommands registerCommands(commands: DocCommandBus): voidRegisters every stable command id owned by this document plugin.
commands: DocCommandBus
methodregisterKeyboardHandlers registerKeyboardHandlers(__namedParameters: DocKeyboardHandlerRegistrationContext): voidRegisters keyboard-to-command bindings owned by this document plugin.
__namedParameters: DocKeyboardHandlerRegistrationContext
methodregisterObservations registerObservations(observations: ObservationRegistry): voidRegisters the host-facing selection observation.
observations: ObservationRegistry
methodregisterSessionState registerSessionState(registry: SessionStateRegistry): voidRegisters selection-owned local remount state.
registry: SessionStateRegistry
methodregisterState registerState(): { key: PluginKey; state: null }Registers one or more plugin-owned state records with the host manager.
methodrender render(): Node<NodeProperties>[] | nullProduces scene nodes owned by this plugin for the current core state.
methodstart start(): voidStarts runtime behavior after the first document frame.
Inherited members 37
Inherited from DocPlugin.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getState
- hasStateWriteBoundary
- initialize
- lockCommittedState
- onClick
- onDblClick
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerBlockFlows
- registerCapabilities
- registerConfig
- registerInlineStyleRenderers
- registerInlineStyles
- registerLineBoxes
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- registerServices
- classSheetDebugOverlayPluginsource ↗
-
class SheetDebugOverlayPlugin extends SheetPlugin<null>Empty Sheet debug overlay placeholder used by hosts that enable ?debug.
constructorconstructor SheetDebugOverlayPlugin(): SheetDebugOverlayPluginCreates a SheetDebugOverlayPlugin instance.
propertysymbolstatic readonly symbol: typeof symbolDI token for resolving SheetDebugOverlayPlugin.
methodapply apply(_state: null, _transaction: unknown): nullApplies a transaction to plugin-owned state and returns the next state.
_state: null_transaction: unknown
methodgetPluginConfig getPluginConfig(): nullReturns this plugin's runtime configuration view for the current core.
methodregisterState registerState(): { key: PluginKey; state: null }Registers one or more plugin-owned state records with the host manager.
methodrender render(): Node<CellProperties>[] | nullProduces scene nodes owned by this plugin for the current core state.
Inherited members 44
Inherited from SheetPlugin.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- configure
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getState
- hasStateWriteBoundary
- initialize
- lockCommittedState
- onClick
- onDblClick
- onEditorDestroy
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerCapabilities
- registerCellVisualReaders
- registerCommands
- registerConfig
- registerFormatTransfers
- registerObservations
- registerQueries
- registerRangeMoves
- registerSessionState
- registerStructureMoves
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- start
- registerServices
- classSheetPluginsource ↗
-
class SheetPlugin<StateType> extends Plugin<SearCoreSheet, CellProperties, StateType>, PluginExtension<SheetCommandBus, ObservationRegistry, SessionStateRegistry, SheetRuntimeExtensionRegistry, SheetQueryRegistry>Convenience base class for a Plugin targeting createSheetEditor().
constructorconstructor SheetPlugin<StateType>(__namedParameters: PluginSpec<StateType>): SheetPlugin<StateType>Creates a plugin with its stable identity and initial state.
__namedParameters: PluginSpec<StateType>
methodconfigure configure(context: SheetPluginSetupContext): voidConfigures the Sheet editor before its Core is created.
context: SheetPluginSetupContext
methodinitialize initialize(context: SheetPluginRuntimeContext): voidPrepares behavior that requires initialized Core state but must run before the first frame and other runtime effects.
context: SheetPluginRuntimeContext
methodonEditorDestroy onEditorDestroy(context: SheetPluginRuntimeContext): voidReleases resources owned by this plugin before the Core is destroyed.
This deliberately does not use the name
destroy: DI containers may treat a no-argument destroy() method as an owned-instance disposer.context: SheetPluginRuntimeContext
methodregisterCapabilities registerCapabilities(registry: SheetRuntimeExtensionRegistry): voidPublishes typed runtime services owned by this plugin.
registry: SheetRuntimeExtensionRegistry
methodregisterCellVisualReaders registerCellVisualReaders(registry: SheetCellVisualReaderRegistry, context: SheetCellVisualReaderRegistrationContext): voidRegisters plugin-owned properties used to compose rendered Sheet cells.
registry: SheetCellVisualReaderRegistrycontext: SheetCellVisualReaderRegistrationContext
methodregisterCommands registerCommands(commands: SheetCommandBus): voidRegisters every stable command id owned by this plugin.
commands: SheetCommandBus
methodregisterFormatTransfers registerFormatTransfers(registry: SheetFormatTransferRegistry): voidContributes owner-defined format capture and transfer plans.
registry: SheetFormatTransferRegistry
methodregisterObservations registerObservations(observations: ObservationRegistry): voidRegisters typed state and event observations owned by this plugin.
observations: ObservationRegistry
methodregisterQueries registerQueries(queries: SheetQueryRegistry): voidqueries: SheetQueryRegistry
methodregisterRangeMoves registerRangeMoves(registry: SheetRangeMoveRegistry): voidContributes state-owner planning for same-sheet cell moves.
registry: SheetRangeMoveRegistry
methodregisterSessionState registerSessionState(registry: SessionStateRegistry): voidRegisters local state that must survive an in-memory editor remount.
registry: SessionStateRegistry
methodregisterStructureMoves registerStructureMoves(registry: SheetStructureMoveRegistry): voidContributes preflight and dependent operation planning for whole-axis reordering.
registry: SheetStructureMoveRegistry
methodstart start(context: SheetPluginRuntimeContext): voidStarts runtime behavior after the Core has rendered its first frame.
context: SheetPluginRuntimeContext
methodregisterServicesstatic registerServices(context: SheetPluginServiceContext): voidRegisters bindings required before this Sheet plugin is instantiated.
context: SheetPluginServiceContext
Inherited members 34
Inherited from Plugin.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- apply
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getPluginConfig
- getState
- hasStateWriteBoundary
- lockCommittedState
- onClick
- onDblClick
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerConfig
- registerState
- render
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- classSheetRuntimeExtensionRegistrysource ↗
-
class SheetRuntimeExtensionRegistry extends RuntimeCapabilityRegistryRegistry for typed sheet runtime extension values.
Third-party plugins use this registry to publish and consume capabilities without mutating the runtime facade shape directly.
constructorconstructor SheetRuntimeExtensionRegistry(): SheetRuntimeExtensionRegistryInherited members 7
Inherited from RuntimeCapabilityRegistry.
- classTextInputPluginsource ↗
-
class TextInputPlugin extends DocPlugin<null>Owns printable text input and delete bindings.
constructorconstructor TextInputPlugin(): TextInputPluginCreates a TextInputPlugin instance.
propertysymbolstatic readonly symbol: typeof symbolDI token for resolving TextInputPlugin.
methodapply apply(_state: null, _transaction: unknown): nullApplies a transaction to plugin-owned state and returns the next state.
_state: null_transaction: unknown
methodconfigure configure(context: DocPluginSetupContext): voidConfigures the document editor before runtime start.
context: DocPluginSetupContext
methodgetPluginConfig getPluginConfig(): nullReturns this plugin's runtime configuration view for the current core.
methodonEditorDestroy onEditorDestroy(): voidReleases resources owned by this plugin before the Core is destroyed.
methodregisterCommands registerCommands(commands: DocCommandBus): voidRegisters every stable command id owned by this document plugin.
commands: DocCommandBus
methodregisterKeyboardHandlers registerKeyboardHandlers(__namedParameters: DocKeyboardHandlerRegistrationContext): voidRegisters keyboard-to-command bindings owned by this document plugin.
__namedParameters: DocKeyboardHandlerRegistrationContext
methodregisterState registerState(): { key: PluginKey; state: null }Registers one or more plugin-owned state records with the host manager.
methodrender render(): Node<NodeProperties>[] | nullProduces scene nodes owned by this plugin for the current core state.
methodregisterServicesstatic registerServices(context: DocPluginServiceContext): voidRegisters text node model support owned by this plugin.
context: DocPluginServiceContext
Inherited members 39
Inherited from DocPlugin.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getState
- hasStateWriteBoundary
- initialize
- lockCommittedState
- onClick
- onDblClick
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerBlockFlows
- registerCapabilities
- registerConfig
- registerInlineStyleRenderers
- registerInlineStyles
- registerLineBoxes
- registerObservations
- registerSessionState
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- start
- classViewportOverlayNodesource ↗
-
class ViewportOverlayNode extends RichTextVisualNodeViewport overlay node that draws transient UI under an identity transform.
constructorconstructor ViewportOverlayNode(input: { depth?: number; drawOverlay: (context: RenderContext): void; nodeKey: string; rect: PositionRectProps; role?: "selection" | "caret" }): ViewportOverlayNodeCreates a viewport overlay render node.
input: { depth?: number; drawOverlay: (context: RenderContext): void; nodeKey: string; rect: PositionRectProps; role?: "selection" | "caret" }
methoddrawScene drawScene(context: RenderContext): voidDraws overlay content; the node owns transform isolation for viewport-space plugins.
context: RenderContext
Inherited members 42
Inherited from RichTextVisualNode.
- childKeys
- depth
- name
- nodeKey
- parentKey
- positionRect
- properties
- randomColorKey
- sticky
- bottom
- configEngine
- fill
- height
- horizontalAlign
- left
- lineDash
- right
- stroke
- strokeWidth
- top
- verticalAlign
- width
- x
- y
- add
- addEventListener
- bindRuntime
- clear
- dispose
- draw
- drawHit
- emit
- enforceWriteBoundary
- getNodeByNodeKey
- getNodeByRandomColorKey
- off
- on
- query
- removeChild
- removeEventListener
- setStickyTree
- toJSON
- interfaceCaptureDocSessionStateCommandResultsource ↗
-
interface CaptureDocSessionStateCommandResult extends DocCommandResultResult of capturing editor-local state for an in-memory document remount.
propertysessionState readonly sessionState: DocSessionState - interfaceCaptureSheetSessionStateCommandResultsource ↗
-
interface CaptureSheetSessionStateCommandResult extends SheetCommandResultResult of capturing editor-local state for an in-memory workbook remount.
propertysessionState readonly sessionState: SheetSessionState - interfaceDocBaseServicessource ↗
-
interface DocBaseServicesBase service instances created before runtime adapters and plugins are wired.
propertyconfigEngine readonly configEngine: ConfigEngineConfiguration engine registered in the DI container.
propertystage readonly stage: SceneGraph<RichTextRenderNodeProperties>Scene graph that owns standalone document content render nodes.
- interfaceDocDocumentStatesource ↗
-
interface DocDocumentStateDocument-owned rich content eligible for future ExportPlugin serialization.
propertydocument readonly document: RichDocNode[]Rich-document tree owned by this editor document.
- interfaceDocEditorsource ↗
-
interface DocEditorPublic standalone document editor API returned by
createDocEditor().propertycapabilities readonly capabilities: RuntimeCapabilityReaderRead-only access to typed services owned by this editor's isolated runtime.
propertycommands readonly commands: DocCommandBusThe supported command entry point for document user and program actions.
propertyobservations readonly observations: ObservationRegistryTyped editor-local state and event observations exposed to the host.
methoddestroy destroy(): voidReleases listeners, timers, adapter state, and DI-owned services for this editor instance.
methodfocus focus(): voidRequests focus for the host text-input adapter, preserving IME placement.
methodgetDocument getDocument(): RichDocNode[]Returns a clone of the current rich-document content.
methodgetText getText(): stringReturns the current plain-text view using one newline between paragraphs.
methodloadDocument loadDocument(document: RichDocNode[]): voidReplaces the document content and renders the new state.
document: RichDocNode[]
methodrender render(): voidRenders the current editor state into the configured render context.
- interfaceDocEditorAdapterssource ↗
-
interface DocEditorAdaptersPlatform-specific services required to assemble a standalone document editor.
propertyeventRegistrar eventRegistrar?: InjectableImplementation<EventRegistrar>Optional host event registrar; defaults to a headless registrar when omitted.
propertykeyboardRouter keyboardRouter: InjectableImplementation<KeyboardRouter>Keyboard router for action keys such as arrows, backspace, enter, and select-all.
propertyplatform platform: InjectableImplementation<Platform>Platform implementation that owns timers, resize observation, and diagnostics.
propertypointerCapture pointerCapture: InjectableImplementation<PointerCapture>Host-wide pointer capture adapter that emits render-root view coordinates.
propertyscroller scroller?: InjectableImplementation<Scroller & { getPublisher: unknown }>Optional host scroller adapter for wheel/touch viewport scrolling.
propertytextInput textInput: InjectableImplementation<TextInput>Text input adapter for printable text, paste/cut, and IME composition.
methodcreateRenderContext createRenderContext(): RenderContextCreates the visible render context used by the document editor.
methodcreateTextShaper createTextShaper(renderContext: RenderContext): TextShaperOptional text-shaping adapter; omission uses render-context measurements.
renderContext: RenderContext
methodregisterEnvironment registerEnvironment(container: Container): voidRegisters host environment values, such as keyboard and pointer event sources. Runs after base services are registered and before adapters are resolved.
container: Container
- interfaceDocEditorChangesource ↗
-
interface DocEditorChangeSnapshot delivered when the document content changes.
- interfaceDocEditorConfigurationsource ↗
-
interface DocEditorConfigurationConfiguration for assembling a standalone rich-document editor.
propertyadapters adapters: DocEditorAdaptersPlatform adapters supplied by the host application.
propertydefaultPlugins defaultPlugins?: false | readonly DocPluginImplementation<DocPlugin<unknown>>[]Default document feature plugins; pass false to assemble only custom plugins.
propertydevicePixelRatio devicePixelRatio?: numberRaster scale used to initialize and resize the render context.
propertydocumentState documentState: DocDocumentStateInitial document-owned state.
propertyfontFamily fontFamily?: stringDefault font family and fallback list applied to document text.
propertyfontSize fontSize?: numberDefault font size applied when measuring and rendering document text.
propertyincrementalRenderPolicyLimits incrementalRenderPolicyLimits?: IncrementalRenderPolicyLimitsConfigGuardrails used when deciding whether document block raster reuse should run for a frame.
propertylineHeightMultiplier lineHeightMultiplier?: numberDefault line-height multiplier applied to paragraphs without an explicit override.
propertyparagraphSpacingAfter paragraphSpacingAfter?: numberDefault spacing after non-final paragraphs.
propertyplugins plugins?: DocPluginImplementation<DocPlugin<unknown>>[]Document plugins installed after the default editing and rendering features.
propertysessionState sessionState?: Readonly<Record<string, unknown>>Optional editor-local state restored during an in-memory remount.
propertyverticalAlign verticalAlign?: DocVerticalAlignVertical positioning used by standalone document layout; defaults to top.
propertyviewport viewport?: DocEditorViewportInitial viewport size; defaults to 800 by 600 when the host cannot know it yet.
methodcontentRect contentRect(viewport: DocEditorViewport): DocEditorContentRectResolves the editable content rectangle from the current viewport. Hosts use this to add page margins, rulers, or chrome without changing core document layout.
viewport: DocEditorViewport
methodonCreated onCreated(editor: DocEditor): voidCalled once the editor object has been assembled and initial content rendered.
editor: DocEditor
- interfaceDocEditorContentRectsource ↗
-
interface DocEditorContentRect extends DocEditorViewportRectangle used for document text layout and rendering.
- interfaceDocEditorViewportsource ↗
-
interface DocEditorViewportViewport dimensions in host-view coordinates.
- interfaceDocHistoryEntrysource ↗
-
interface DocHistoryEntryDetached before/after snapshots for one committed document mutation.
propertyafterDocument readonly afterDocument: RichDocNode[]propertyafterSelection readonly afterSelection: DocSelectionpropertybeforeDocument readonly beforeDocument: RichDocNode[]propertybeforeSelection readonly beforeSelection: DocSelectionpropertyoperations readonly operations?: readonly RichDocOTOperation[]RichDoc OT operations committed by the document mutation.
- interfaceDocHistorySessionStatesource ↗
-
interface DocHistorySessionStateDocument-local undo and redo stacks retained during editor remounts.
- interfaceDocHistoryStatussource ↗
-
interface DocHistoryStatusCurrent document undo/redo availability.
- interfaceDocInlineStyleStatussource ↗
-
interface DocInlineStyleStatusWhether one inline style can be applied, is active, and has a common selected value.
- interfaceDocRenderLayoutsource ↗
-
interface DocRenderLayoutLayout/cache/page-map result exposed to document plugins for one render pass.
propertyblockLayoutDiff readonly blockLayoutDiff: DocBlockLayoutDiffBlock-level diff between the previous and current layout caches.
propertycomposingCaretPixelOffset readonly composingCaretPixelOffset: numberPixel offset from composing-text start to the IME caret.
propertycursorX readonly cursorX: numberCursor x in world coordinates.
propertycursorY readonly cursorY: numberCursor y in world coordinates.
propertydocumentRect readonly documentRect: { height: number; width: number; x: number; y: number }Current document layout rectangle in world coordinates.
propertylayoutCache readonly layoutCache: DocLayoutCacheLatest full-document layout cache.
propertypageMap readonly pageMap: DocPageMapLatest page map derived from the layout cache.
propertyvisibleBlocks readonly visibleBlocks: readonly DocBlockLayout[]Laid-out blocks selected for plugin-owned render nodes.
- interfaceDocRuntimesource ↗
-
interface DocRuntimeRuntime services assembled after Doc base services and host environment values are available.
propertyeventEngine readonly eventEngine: EventEngine<NodeProperties>Event pipeline and hit-testing facade for document interactions.
propertyeventRegistrar readonly eventRegistrar: EventRegistrarEvent registrar selected by the host or the headless fallback.
propertypluginManager readonly pluginManager: PluginManager<SearCoreDoc, NodeProperties>Document plugin manager populated by feature registration.
propertyrenderContexts readonly renderContexts: { hit: RenderContext; main: RenderContext; offScreen: RenderContext }Render contexts for visible, off-screen, and hit-test layers.
propertyrenderEngine readonly renderEngine: DocRenderEngineDocument render engine populated with the shared Sheet-like strategy chain.
propertyscrollManager readonly scrollManager: ScrollManagerScroll manager coordinating document viewport state.
- interfaceDocViewportSessionStatesource ↗
-
interface DocViewportSessionStateLocal viewport position retained while remounting one document editor.
- interfaceExportDocStateCommandResultsource ↗
-
interface ExportDocStateCommandResult extends DocCommandResultResult of exporting detached document-owned state for an in-memory remount.
propertydocumentState readonly documentState: DocDocumentState - interfaceExportSheetStateCommandResultsource ↗
-
interface ExportSheetStateCommandResult extends SheetCommandResultCommand result for exporting the current sheet state snapshot.
The pipeline is intentionally empty: exporting state must not mutate OT state, request rendering, or produce local effects.
propertysheetState readonly sheetState: SheetDocumentStateCloned state payload suitable for workbook persistence or sheet remounting.
- interfaceRichTextRenderLinesource ↗
-
interface RichTextRenderLineMinimal layout-line shape consumed by rich-text render nodes.
propertychars readonly chars: readonly RichTextRenderChar[]propertycharStartOffset readonly charStartOffset: numberpropertycursorXOffsets readonly cursorXOffsets?: readonly number[]propertyfontAscent readonly fontAscent: numberpropertyheight readonly height: numberpropertytextNodePath readonly textNodePath: readonly number[]propertyx readonly x: numberpropertyy readonly y: number - interfaceRichTextRenderNodePropertiessource ↗
-
interface RichTextRenderNodeProperties extends NodePropertiesRender-node properties used by rich-text scene graphs.
propertyblockId readonly blockId?: stringStable top-level rich-text block id.
propertyblockIndex readonly blockIndex?: numberTop-level rich-text block index.
propertylineIndex readonly lineIndex?: numberLayout line index inside the full rich-text snapshot.
propertyrenderRole readonly renderRole?: "block" | "line" | "page" | "text-run" | "selection" | "caret" | "composition"Semantic role for rich-text render nodes.
Inherited members 24
Inherited from NodeProperties.
- interfaceSheetClipboardWorkbookBridgesource ↗
-
interface SheetClipboardWorkbookBridgeWorkbook-owned endpoint for an atomic move between two sheets.
methodcommitMove commitMove(cutId: string, sourceId: string, targetId: string, targetAfter: SheetDocumentState): Promise<void>cutId: stringsourceId: stringtargetId: stringtargetAfter: SheetDocumentState
methodprepareCut prepareCut(cutId: string, sourceId: string, sourceBefore: SheetDocumentState, clearedSource: SheetDocumentState): voidcutId: stringsourceId: stringsourceBefore: SheetDocumentStateclearedSource: SheetDocumentState
- interfaceSheetDocumentStatesource ↗
-
interface SheetDocumentStateDocument data owned by one sheet and eligible for future ExportPlugin serialization.
propertycellAlignments cellAlignments: AlignmentMatrixpropertycellBorders cellBorders?: CellBorderMatrixSparse custom cell-edge state; absence initializes an empty border owner.
propertycellFills cellFills: CellFillMatrixSparse cell fill state.
propertycellFormats cellFormats: CellFormatMatrixSparse per-cell number-format state.
propertycellHighlights cellHighlights: CellHighlightMatrixSparse conditional highlight rules anchored at their range starts.
propertycellMerges cellMerges: CellMergeMatrixpropertycellVerticalAlignments cellVerticalAlignments: VerticalAlignmentMatrixSparse vertical cell alignment state.
propertycolumnSizes columnSizes: ColumnShapeDimensionsCSRMatrixpropertydataValidations dataValidations?: DataValidationMatrixSparse data validation rules anchored at range starts.
propertyduplicates duplicates: DuplicateMatrixSparse duplicate-item highlight state.
propertyfilters filters?: SheetFilterMatrixSheet-owned filter range and column rules.
propertyfixedRows fixedRows?: FixedRowMatrixSparse per-row fixed state.
propertyfreeze freeze?: SheetFreezeMatrixPersistent top and left freeze boundaries.
propertyrowSizes rowSizes: RowShapeDimensionsCSRMatrixpropertysheetData sheetData: SheetMatrix - interfaceSheetEditorsource ↗
-
interface SheetEditorPublic contract for SheetEditor.
propertycapabilities readonly capabilities: RuntimeCapabilityReaderRead-only access to typed services owned by this editor's isolated runtime.
propertycommands readonly commands: SheetCommandBusThe sole supported entry point for user and program commands.
propertyobservations readonly observations: ObservationRegistryTyped editor-local state and event observations exposed to the host.
propertyqueries readonly queries: SheetQueryRegistryTyped runtime query registry for side-effect-free editor reads.
methoddestroy destroy(): voidReleases runtime services and every active host observation subscription.
- interfaceSheetEditorAdapterssource ↗
-
interface SheetEditorAdaptersPlatform-specific services required to assemble the default sheet editor.
propertyclipboard clipboard?: InjectableImplementation<SheetClipboard>propertycollabTransport collabTransport: InjectableImplementation<CollabTransport>propertycursorEngine cursorEngine: InjectableImplementation<CursorEngine>propertyeventRegistrar eventRegistrar: InjectableImplementation<EventRegistrar>propertyfileDownload fileDownload?: InjectableImplementation<FileDownload>Optional host file-save capability; existing environment bindings take precedence. The editor owns newly created adapters.
propertyformulaBar formulaBar?: InjectableImplementation<SearFormulaBar>Optional formula input surface supplied by the host.
propertykeyboardRouter keyboardRouter: InjectableImplementation<KeyboardRouter>propertyplatform platform: InjectableImplementation<Platform>propertypointerCapture pointerCapture: InjectableImplementation<PointerCapture>propertyscroller scroller: InjectableImplementation<Scroller & { getPublisher: unknown }>propertytextInput textInput: InjectableImplementation<TextInput>propertytoolbar toolbar: InjectableImplementation<SearToolbar>propertyuserInteraction userInteraction?: InjectableImplementation<UserInteractionService>Host-owned service for decisions that require a user response.
propertywebServiceClient webServiceClient?: InjectableImplementation<WebServiceClient>Asynchronous web-service transport used by host-managed formula caches.
propertyxmlXPathEvaluator xmlXPathEvaluator?: InjectableImplementation<XmlXPathEvaluator>XML/XPath evaluator used by XML-backed formula plugins.
methodcreateFunctionRegistry createFunctionRegistry(): IFunctionRegistryCreates the function catalog owned by this editor or its parent workbook.
methodcreateRenderContexts createRenderContexts(): { hitRenderContext: RenderContext; offScreenRenderContext: RenderContext; renderContext: RenderContext }methodcreateTextShaper createTextShaper(renderContext: RenderContext): TextShaperCreates an editor-local text shaper; omission uses render-context measurements.
renderContext: RenderContext
methodregisterEnvironment registerEnvironment(container: Container): voidcontainer: Container
- interfaceSheetEditorConfigurationsource ↗
-
interface SheetEditorConfigurationPublic contract for SheetEditorConfiguration.
propertyadapters adapters: SheetEditorAdapterspropertycellFontFamily cellFontFamily?: stringDefault font family and fallback list used by ordinary Sheet cells.
propertycellFontSize cellFontSize?: numberDefault font size used by ordinary Sheet cells.
propertyembeddedEditor embeddedEditor?: SheetEmbeddedEditorOptional editor used to render and edit rich text embedded in Sheet cells.
propertyplugins plugins?: SheetEditorPluginImplementation[]propertysessionState sessionState?: Readonly<Record<string, unknown>>Optional editor-local state restored when remounting a workbook sheet.
propertysheetState sheetState: SheetDocumentStatepropertyviewport viewport?: { height: number; width: number }methodonCreated onCreated(editor: SheetEditor): voideditor: SheetEditor
- interfaceSheetPluginImplementationsource ↗
-
interface SheetPluginImplementation<TPlugin>Injectable SheetPlugin class accepted by createSheetEditor().
constructorconstructor SheetPluginImplementation(...args: never[]): TPluginargs: never[]
propertysymbol readonly symbol: symbolmethodregisterServices registerServices(context: SheetPluginServiceContext): voidcontext: SheetPluginServiceContext
- interfaceSheetPluginRuntimesource ↗
-
interface SheetPluginRuntime extends SheetPluginSetupRuntimeRuntime capabilities available after the command bus is bound and Core exists.
Inherited members 19
Inherited from SheetPluginSetupRuntime.
- interfaceSheetPluginRuntimeContextsource ↗
-
interface SheetPluginRuntimeContext extends SheetPluginSetupContextSheet setup capabilities plus the Core created by createSheetEditor().
- interfaceSheetPluginServiceContextsource ↗
-
interface SheetPluginServiceContextServices available while createSheetEditor() registers Sheet plugins.
propertycontainer readonly container: Container - interfaceSheetPluginSetupContextsource ↗
-
interface SheetPluginSetupContextTyped public services available before createSheetEditor() creates its Core.
propertycontainer readonly container: Containerpropertyruntime readonly runtime: SheetPluginSetupRuntimemethodaddStrategy addStrategy(token: symbol, strategy: RenderStrategy<CellProperties>, position: { before: symbol } | { after: symbol }): voidtoken: symbolstrategy: RenderStrategy<CellProperties>position: { before: symbol } | { after: symbol }
- interfaceSheetPluginSetupRuntimesource ↗
-
interface SheetPluginSetupRuntimeStable host capabilities available before the command bus and Core are ready. Services are grouped by responsibility so plugins need not rely on untyped container lookups for normal extension work.
propertycells readonly cells: { catalog: CellTypeCatalog }propertycollaboration readonly collaboration: { session: Pick<CollaborationSession, "getStatus"> }propertyconfig readonly config: ConfigEnginepropertydata readonly data: SheetDataEnginepropertyembeddedEditor readonly embeddedEditor?: { editor: SheetEmbeddedEditor }Optional Sheet-facing rich-text editor supplied by the host.
propertyevents readonly events: { engine: EventEngine<CellProperties>; registrar: EventRegistrar }propertyextensions readonly extensions: SheetRuntimeExtensionRegistrypropertyformula readonly formula: { externalServices: IFormulaExternalServiceProvider; functions: IFunctionRegistry; results: FormulaResultProviderRegistry; richResults: FormulaRichResultProviderRegistry; sources: FormulaSourceProviderRegistry; textServices: IFormulaTextServiceProvider; webService: WebServiceClient; xmlXPath: XmlXPathEvaluator }propertyinput readonly input: { cursor: CursorEngine; cursorRules: CursorRegistry; keyboard: KeyboardRouter; pointer: PointerCapture; text: TextInput }propertyinteraction readonly interaction: { pipelineSteps: PipelineStepExecutorRegistry; reducers: SheetInteractionReducerRegistry; store: SheetInteractionStore }propertylifecycle readonly lifecycle: SheetLifecycleCoordinatorpropertyobservations readonly observations: ObservationRegistrypropertyplatform readonly platform: Platformpropertyplugins readonly plugins: PluginManager<SearCoreSheet, CellProperties>propertyqueries readonly queries: SheetQueryRegistrypropertyrender readonly render: { cellVisualReaders: SheetCellVisualReaderRegistry; contexts: { hit: RenderContext; main: RenderContext; offScreen: RenderContext }; coordinator: SheetRenderCoordinatorManager; dirtyTracker: GenerationalDirtyTracker; dirtyTree: Tree<PositionRect<templateLiteral>>; engine: SheetRenderEngine; rendererRegistry: SheetRendererRegistry<CellProperties>; stage: SceneGraph<CellProperties>; … }propertyscroll readonly scroll: { coordinates: CoordinateEngine; manager: ScrollManager; scroller: Scroller; transformer: CoordinateTransformer }propertysession readonly session: SessionStateRegistryEditor-local capture and restore registry shared by every session-state owner.
propertytextShaper readonly textShaper: TextShaper - interfaceSheetScrollToInputsource ↗
-
interface SheetScrollToInputPublic programmatic input for an absolute world-space viewport position.
- interfaceSheetViewportSessionStatesource ↗
-
interface SheetViewportSessionStateLocal viewport position retained while remounting one workbook sheet.
- typeDocInlineStyleStatesource ↗
-
type DocInlineStyleState = Readonly<Record<string, DocInlineStyleStatus>>Inline style state consumed by document toolbars and other host controls.
- typeDocSessionStatesource ↗
-
type DocSessionState = SessionStateSnapshotOpaque in-memory contributor snapshot retained while remounting a document editor.
- typeDocViewportScrollInputsource ↗
-
type DocViewportScrollInput = ScrollManagerStateInternal adapter input for one platform-originated document scroll state update.
- typeDocVirtualLayoutSummaryListenersource ↗
-
type DocVirtualLayoutSummaryListener = (summary: DocVirtualLayoutSummary): void - typeSheetRuntimeCapabilityReadersource ↗
-
type SheetRuntimeCapabilityReader = RuntimeCapabilityReaderRead-only view of editor-local runtime capabilities exposed to hosts.
- typeSheetRuntimeCapabilityTokensource ↗
-
type SheetRuntimeCapabilityToken = RuntimeCapability<T>Typed extension capability exposed through the sheet runtime facade.
- typeSheetScrollInputsource ↗
-
type SheetScrollInput = ScrollManagerStateInternal adapter input for one platform-originated scroll state update.
- typeSheetSessionStatesource ↗
-
type SheetSessionState = SessionStateSnapshotOpaque, in-memory contributor snapshot retained per sheet while a workbook editor is open.
- variableApplyDocViewportScrollCommandsource ↗
-
ApplyDocViewportScrollCommand: DocCommandDefinition<ScrollManagerState, DocCommandResult>Applies one platform-originated document scroll update.
- variableApplyViewportScrollCommandsource ↗
-
ApplyViewportScrollCommand: SheetCommandDefinition<ScrollManagerState, SheetCommandResult> - variableCaptureDocSessionStateCommandsource ↗
-
CaptureDocSessionStateCommand: DocCommandDefinition<void, CaptureDocSessionStateCommandResult>Captures every registered local document session contributor.
- variableCaptureSheetSessionStateCommandsource ↗
-
CaptureSheetSessionStateCommand: SheetCommandDefinition<void, CaptureSheetSessionStateCommandResult>Captures local state that must survive switching away from one workbook sheet.
- variableDefaultDocFeaturePluginssource ↗
-
DefaultDocFeaturePlugins: readonly [typeof ParagraphPlugin, typeof CompositionPlugin, typeof TextInputPlugin, typeof SelectionPlugin, typeof CaretPlugin, typeof DocContentRenderPlugin, typeof RichTextLineBoxPlugin, typeof FontFamilyTextStylePlugin, typeof FontSizeTextStylePlugin, typeof BoldTextStylePlugin, typeof ItalicTextStylePlugin, typeof UnderlineTextStylePlugin, typeof StrikethroughTextStylePlugin, typeof TextColorStylePlugin, typeof TablePlugin, typeof HistoryPlugin]Default feature plugins installed by createDocEditor unless overridden.
- variableDocDocumentObservationsource ↗
-
DocDocumentObservation: StateObservationDefinition<DocEditorChange>Committed document content exposed as an editor-local typed state observation.
- variableDocHistorySessionStateDefinitionsource ↗
-
DocHistorySessionStateDefinition: SessionStateDefinition<DocHistorySessionState>Stable session-state identity owned by document history.
- variableDocHistoryStatusObservationsource ↗
-
DocHistoryStatusObservation: StateObservationDefinition<DocHistoryStatus>Undo/redo availability exposed as an editor-local state observation.
- variableDocInlineStyleObservationsource ↗
-
DocInlineStyleObservation: StateObservationDefinition<Readonly<Record<string, DocInlineStyleStatus>>>Current inline-style availability and activation for the document selection.
- variableDocSelectionObservationsource ↗
-
DocSelectionObservation: StateObservationDefinition<DocSelection>Current document selection exposed as an editor-local typed observation.
- variableDocSelectionSessionStateDefinitionsource ↗
-
DocSelectionSessionStateDefinition: SessionStateDefinition<DocSelection>Stable identity for local document selection retained during remounts.
- variableDocViewportObservationsource ↗
-
DocViewportObservation: StateObservationDefinition<DocViewportSessionState>Current document viewport position exposed to hosts and plugins.
- variableDocViewportSessionStateDefinitionsource ↗
-
DocViewportSessionStateDefinition: SessionStateDefinition<DocViewportSessionState>Stable session-state identity owned by the document viewport assembly.
- variableExportDocStateCommandsource ↗
-
ExportDocStateCommand: DocCommandDefinition<void, ExportDocStateCommandResult>Exports the current document-owned state without local session values.
- variableExportSheetStateCommandsource ↗
-
ExportSheetStateCommand: SheetCommandDefinition<void, ExportSheetStateCommandResult>Host command that exports a cloned state snapshot for the active SheetEditor.
- variableRedoDocCommandsource ↗
-
RedoDocCommand: DocCommandDefinition<void, DocCommandResult>Re-applies the most recently undone document mutation.
- variableRenderDocViewportCommandsource ↗
-
RenderDocViewportCommand: DocCommandDefinition<void, DocCommandResult>Renders the document viewport after the committed scroll state changes.
- variableResizeDocViewportCommandsource ↗
-
ResizeDocViewportCommand: DocCommandDefinition<DocEditorViewport, DocCommandResult>Resizes the standalone document viewport.
- variableResizeSheetViewportCommandsource ↗
-
ResizeSheetViewportCommand: SheetCommandDefinition<{ height: number; width: number }, SheetCommandResult> - variableScrollDocViewportToCommandsource ↗
-
ScrollDocViewportToCommand: DocCommandDefinition<DocViewportSessionState, DocCommandResult>Scrolls the standalone document viewport to an absolute world position.
- variableScrollViewportToCommandsource ↗
-
ScrollViewportToCommand: SheetCommandDefinition<SheetScrollToInput, SheetCommandResult> - variableSheetClipboardWorkbookBridgeSymbolsource ↗
-
SheetClipboardWorkbookBridgeSymbol: typeof SheetClipboardWorkbookBridgeSymbol - variableSheetRuntimeCapabilitysource ↗
-
SheetRuntimeCapability: { Cells: SheetRuntimeCapability<{ catalog: CellTypeCatalog }>; Collaboration: SheetRuntimeCapability<{ session: Pick<CollaborationSession, "getStatus"> }>; Commands: SheetRuntimeCapability<SheetCommandBus>; Config: SheetRuntimeCapability<ConfigEngine<any>>; Data: SheetRuntimeCapability<SheetDataEngine>; EmbeddedEditor: SheetRuntimeCapability<{ editor: SheetEmbeddedEditor }>; Events: SheetRuntimeCapability<{ engine: EventEngine<CellProperties>; registrar: EventRegistrar }>; Formula: SheetRuntimeCapability<{ externalServices: IFormulaExternalServiceProvider; functions: IFunctionRegistry; results: FormulaResultProviderRegistry; richResults: FormulaRichResultProviderRegistry; sources: FormulaSourceProviderRegistry; textServices: IFormulaTextServiceProvider; webService: WebServiceClient; xmlXPath: XmlXPathEvaluator }>; … } - variableSheetViewportSessionStateDefinitionsource ↗
-
SheetViewportSessionStateDefinition: SessionStateDefinition<SheetViewportSessionState>Stable session-state identity owned by the Sheet viewport assembly.
- variableUndoDocCommandsource ↗
-
UndoDocCommand: DocCommandDefinition<void, DocCommandResult>Reverts the most recent committed document mutation.
- variableUnregisterSheetInputValidatorCommandsource ↗
-
UnregisterSheetInputValidatorCommand: SheetCommandDefinition<number, SheetCommandResult>Removes one editor-local input validator through the Sheet command bus.
- variableUpdateDocDefaultConfigCommandsource ↗
-
UpdateDocDefaultConfigCommand: DocCommandDefinition<EditorDefaultConfigOverrides<DocConfig>, DocCommandResult>Updates editor-local Doc defaults without changing document state.
- variableUpdateSheetDefaultConfigCommandsource ↗
-
UpdateSheetDefaultConfigCommand: SheetCommandDefinition<EditorDefaultConfigOverrides<SheetConfig>, SheetCommandResult>Updates editor-local Sheet defaults without changing document state.
- functioncloneSheetDocumentStatesource ↗
-
cloneSheetDocumentState(state: SheetDocumentState): SheetDocumentStateTakes ownership of an input Sheet snapshot without retaining caller-owned mutable values.
state: SheetDocumentState
- functioncreateDefaultSheetDocumentStateExportRegistrysource ↗
-
createDefaultSheetDocumentStateExportRegistry(): DocumentStateCodecRegistry<SheetDocumentState>Creates the default registry for built-in Sheet document-state modules.
- functioncreateDocEditorsource ↗
-
createDocEditor(options: DocEditorConfiguration): DocEditorAssembles a standalone rich-document editor from platform-neutral adapters and document content.
The editor owns its DI container, selected document plugins, rendering services, input adapters, and lifecycle. Product chrome remains a host concern and communicates with the editor through its public facade.
ReturnsA fully initialized rich-document editor facade.
Exampleconst editor = createDocEditor({ adapters, documentState }); editor.focus(); editor.destroy();options: DocEditorConfigurationPlatform adapters, initial document state, plugins, and viewport configuration.
- functioncreateEmptySheetDocumentStatesource ↗
-
createEmptySheetDocumentState(rowCount: number, columnCount: number): SheetDocumentStateCreates an empty Sheet document with matching dimensions for import adapters.
rowCount: numbercolumnCount: number
- functioncreateRichTextRunRectsource ↗
-
createRichTextRunRect(x: number, baselineY: number, width: number, height: number, fontAscent: number): PositionRect<templateLiteral>Creates a world-space rectangle for one rich-text line/run.
x: numberbaselineY: numberwidth: numberheight: numberfontAscent: number
- functioncreateSheetEditorsource ↗
-
createSheetEditor(options: SheetEditorConfiguration): SheetEditorAssembles the default sheet editor runtime from platform adapters and state.
The returned editor owns an isolated dependency container, plugin graph, and render lifecycle. Hosts interact with it through commands, queries, observations, and capabilities, and must call
destroy()when the session is no longer mounted.ReturnsA fully initialized Sheet editor facade.
Exampleconst editor = createSheetEditor({ adapters, sheetState, plugins }); await editor.commands.run(command, input); editor.destroy();options: SheetEditorConfigurationPlatform adapters, initial Sheet state, plugins, and runtime configuration.
- functiondefineSheetRuntimeCapabilitysource ↗
-
defineSheetRuntimeCapability<T>(id: string): SheetRuntimeCapability<T>Defines a typed runtime capability token.
ReturnsImmutable capability descriptor.
id: stringStable capability id.
- functiondeserializeSheetDocumentStatesource ↗
-
deserializeSheetDocumentState<TSheetState>(payload: unknown, registry?: DocumentStateCodecRegistry<TSheetState>, path?: string): TSheetStateDeserializes one Sheet document state through registered state-owner codecs.
payload: unknownregistry: DocumentStateCodecRegistry<TSheetState>path: string
- functionregisterDefaultDependenciessource ↗
-
registerDefaultDependencies(container: Container): voidRegisters the small common runtime set into an explicit host container.
container: Container
- functionregisterDefaultDocFeaturessource ↗
-
registerDefaultDocFeatures(container: Container, manager: PluginManager<SearCoreDoc, NodeProperties>, implementations: false | readonly DocPluginImplementation<DocPlugin<unknown>>[] | undefined): DocPlugin<unknown>[]Registers the default document feature plugins selected for one editor instance.
container: Containermanager: PluginManager<SearCoreDoc, NodeProperties>implementations: false | readonly DocPluginImplementation<DocPlugin<unknown>>[] | undefined
- functionregisterDocBaseServicessource ↗
-
registerDocBaseServices(container: Container, adapters: DocEditorAdapters, _viewport: DocEditorViewport, defaultConfigOverrides?: EditorDefaultConfigOverrides<DocConfig>): DocBaseServicesRegisters document editor base services into the DI container.
container: Containeradapters: DocEditorAdapters_viewport: DocEditorViewportdefaultConfigOverrides: EditorDefaultConfigOverrides<DocConfig>
- functionregisterDocConfigCommandssource ↗
-
registerDocConfigCommands(commands: DocCommandBus, config: ConfigEngine<DocConfig>): voidRegisters Doc configuration changes on the owning command bus.
commands: DocCommandBusconfig: ConfigEngine<DocConfig>
- functionregisterDocDocumentObservationsource ↗
-
registerDocDocumentObservation(observations: ObservationRegistry, document: DocDocumentSessionCoordinator): voidRegisters the document-owned read projection with the editor observation registry.
observations: ObservationRegistrydocument: DocDocumentSessionCoordinator
- functionregisterDocFeaturePluginssource ↗
-
registerDocFeaturePlugins(container: Container, manager: PluginManager<SearCoreDoc, NodeProperties>, implementations: readonly DocPluginImplementation<DocPlugin<unknown>>[] | undefined): DocPlugin<unknown>[]Registers document feature plugin instances with the Core-owned PluginManager.
container: Containermanager: PluginManager<SearCoreDoc, NodeProperties>implementations: readonly DocPluginImplementation<DocPlugin<unknown>>[] | undefined
- functionregisterDocInlineStyleObservationsource ↗
-
registerDocInlineStyleObservation(observations: ObservationRegistry, input: DocInputPlugin, inlineStyles: RichTextInlineStyleRegistry): voidRegisters the selection-derived inline-style state with the editor observation registry.
observations: ObservationRegistryinput: DocInputPlugininlineStyles: RichTextInlineStyleRegistry
- functionregisterDocRuntimesource ↗
-
registerDocRuntime(container: Container, adapters: DocEditorAdapters, viewport: DocEditorViewport): DocRuntimeRegisters render, input, scroll, command, and plugin runtime services for Doc.
container: Containeradapters: DocEditorAdaptersviewport: DocEditorViewport
- functionregisterDocSessionStateCommandssource ↗
-
registerDocSessionStateCommands(commands: DocCommandBus, session: SessionStateRegistry): voidRegisters the in-memory document session capture command.
commands: DocCommandBussession: SessionStateRegistry
- functionregisterDocStateSnapshotCommandssource ↗
-
registerDocStateSnapshotCommands(commands: DocCommandBus, document: DocDocumentSessionCoordinator): voidRegisters the document-owned state snapshot command.
commands: DocCommandBusdocument: DocDocumentSessionCoordinator
- functionregisterDocViewportCommandssource ↗
-
registerDocViewportCommands(input: { commands: DocCommandBus; renderCoordinator: DocRenderCoordinator; scrollManager: ScrollManager; viewportEnvironment: DocViewportEnvironment }): voidRegisters viewport-owned document commands on the editor command bus.
input: { commands: DocCommandBus; renderCoordinator: DocRenderCoordinator; scrollManager: ScrollManager; viewportEnvironment: DocViewportEnvironment }
- functionregisterDocViewportStatesource ↗
-
registerDocViewportState(session: SessionStateRegistry, observations: ObservationRegistry, scrollManager: ScrollManager): voidRegisters viewport remount state and its host-facing observation.
session: SessionStateRegistryobservations: ObservationRegistryscrollManager: ScrollManager
- functionregisterSheetConfigCommandssource ↗
-
registerSheetConfigCommands(commands: SheetCommandBus, config: ConfigEngine<SheetConfig>): voidRegisters Sheet configuration changes on the owning command bus.
commands: SheetCommandBusconfig: ConfigEngine<SheetConfig>
- functionregisterSheetPluginCapabilitiessource ↗
-
registerSheetPluginCapabilities(plugins: readonly unknown[], registry: SheetRuntimeExtensionRegistry): voidPublishes every typed runtime capability contributed by Sheet plugins.
plugins: readonly unknown[]registry: SheetRuntimeExtensionRegistry
- functionregisterSheetPluginCellVisualReaderssource ↗
-
registerSheetPluginCellVisualReaders(plugins: readonly unknown[], registry: SheetCellVisualReaderRegistry, context: SheetCellVisualReaderRegistrationContext): voidRegisters every plugin-owned Sheet cell visual reader.
plugins: readonly unknown[]registry: SheetCellVisualReaderRegistrycontext: SheetCellVisualReaderRegistrationContext
- functionregisterSheetPluginCommandssource ↗
-
registerSheetPluginCommands(plugins: readonly unknown[], commands: SheetCommandBus): voidRuns the register sheet plugin commands helper.
plugins: readonly unknown[]commands: SheetCommandBus
- functionregisterSheetPluginObservationssource ↗
-
registerSheetPluginObservations(plugins: readonly unknown[], observations: ObservationRegistry): voidRegisters every typed observation source contributed by Sheet plugins.
plugins: readonly unknown[]observations: ObservationRegistry
- functionregisterSheetPluginQueriessource ↗
-
registerSheetPluginQueries(plugins: readonly unknown[], queries: SheetQueryRegistry): voidplugins: readonly unknown[]queries: SheetQueryRegistry
- functionregisterSheetPluginSessionStatessource ↗
-
registerSheetPluginSessionStates(plugins: readonly unknown[], registry: SessionStateRegistry): voidRegisters every local session-state adapter contributed by Sheet plugins.
plugins: readonly unknown[]registry: SessionStateRegistry
- functionregisterSheetSessionStateCommandssource ↗
-
registerSheetSessionStateCommands(commands: SheetCommandBus, session: SessionStateRegistry): voidRegisters the in-memory Sheet session capture command.
commands: SheetCommandBussession: SessionStateRegistry
- functionregisterSheetStateSnapshotCommandssource ↗
-
registerSheetStateSnapshotCommands(commands: SheetCommandBus, pluginManager: PluginManager<SearCoreSheet, CellProperties>): voidRegisters sheet state snapshot commands for the default sheet assembly.
commands: SheetCommandBuspluginManager: PluginManager<SearCoreSheet, CellProperties>
- functionregisterSheetViewportCommandssource ↗
-
registerSheetViewportCommands(commands: SheetCommandBus, scrollManager: ScrollManager, resizeController: SheetViewportResizeController): voidRegisters viewport-owned commands on the editor command bus.
commands: SheetCommandBusscrollManager: ScrollManagerresizeController: SheetViewportResizeController
- functionregisterSheetViewportSessionStatesource ↗
-
registerSheetViewportSessionState(registry: SessionStateRegistry, scrollManager: ScrollManager): voidRegisters viewport-owned local remount state with the editor-local registry.
registry: SessionStateRegistryscrollManager: ScrollManager
- functionserializeSheetDocumentStatesource ↗
-
serializeSheetDocumentState<TSheetState>(sheetState: TSheetState, registry?: DocumentStateCodecRegistry<TSheetState>): SearSheetDocumentFileSerializes one Sheet document state through registered state-owner codecs.
sheetState: TSheetStateregistry: DocumentStateCodecRegistry<TSheetState>
- enumBoldTextStyleKeysource ↗
-
enum BoldTextStyleKeyPersisted style key owned by the bold text-style plugin.
enum memberBold Bold: "bold" - classBoldTextStylePluginsource ↗
-
class BoldTextStylePlugin extends InlineTextStylePluginBaseContributes bold rendering and bold document commands.
constructorconstructor BoldTextStylePlugin(): BoldTextStylePluginpropertysymbolstatic readonly symbol: typeof symbolDI token for resolving BoldTextStylePlugin.
methodregisterCommands registerCommands(commands: DocCommandBus): voidRegisters every stable command id owned by this document plugin.
commands: DocCommandBus
methodregisterKeyboardHandlers registerKeyboardHandlers(__namedParameters: DocKeyboardHandlerRegistrationContext): voidRegisters keyboard-to-command bindings owned by this document plugin.
__namedParameters: DocKeyboardHandlerRegistrationContext
Inherited members 46
Inherited from InlineTextStylePluginBase.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- apply
- configure
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getPluginConfig
- getState
- hasStateWriteBoundary
- initialize
- lockCommittedState
- onClick
- onDblClick
- onEditorDestroy
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerBlockFlows
- registerCapabilities
- registerConfig
- registerInlineStyleRenderers
- registerInlineStyles
- registerLineBoxes
- registerObservations
- registerSessionState
- registerState
- render
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- start
- registerServices
- variableClearDocCompositionCommandsource ↗
-
ClearDocCompositionCommand: DocCommandDefinition<void, DocCommandResult>Clears the active IME composition preview text.
- functiondefineDocRuntimeCapabilitysource ↗
-
defineDocRuntimeCapability<T>(id: string): DocRuntimeCapability<T>Creates a typed document runtime capability token.
id: string
- functiondefineSessionStatesource ↗
-
defineSessionState<State>(id: string): SessionStateDefinition<State>Creates an immutable typed identity for one local session value.
id: string
- variableDeleteDocBackwardCommandsource ↗
-
DeleteDocBackwardCommand: DocCommandDefinition<void, DocCommandResult>Deletes content before the current document selection.
- variableDocCaretPluginKeysource ↗
-
DocCaretPluginKey: PluginKey - variableDocCompositionPluginKeysource ↗
-
DocCompositionPluginKey: PluginKey - variableDocContentRenderPluginKeysource ↗
-
DocContentRenderPluginKey: PluginKeyDefault document feature plugin keys used by command pipelines.
- interfaceDocInteractionRuntimesource ↗
-
interface DocInteractionRuntimeView services exposed to document interaction plugins.
methodgetContentRect getContentRect(): DocInteractionContentRectmethodgetRoot getRoot(): unknownmethodgetViewport getViewport(): DocInteractionViewportmethodreadRootViewOffset readRootViewOffset(): { x: number; y: number }methodresolveCursorFromPointer resolveCursorFromPointer(input: DocPointerInput): DocCursorPosinput: DocPointerInput
methodsubscribePointerDrag subscribePointerDrag(handlers: DocPointerDragHandlers): (): voidhandlers: DocPointerDragHandlers
- classDocPluginsource ↗
-
class DocPlugin<StateType> extends Plugin<SearCoreDoc, NodeProperties, StateType>, PluginExtension<DocCommandBus, ObservationRegistry, SessionStateRegistry, DocRuntimeExtensionRegistry>Convenience base class for a Plugin targeting createDocEditor().
constructorconstructor DocPlugin<StateType>(__namedParameters: PluginSpec<StateType>): DocPlugin<StateType>Creates a plugin with its stable identity and initial state.
__namedParameters: PluginSpec<StateType>
methodconfigure configure(context: DocPluginSetupContext): voidConfigures the document editor before runtime start.
context: DocPluginSetupContext
methodinitialize initialize(context: DocPluginRuntimeContext): voidPrepares behavior that requires initialized Core state but must run before runtime effects.
context: DocPluginRuntimeContext
methodonEditorDestroy onEditorDestroy(context: DocPluginRuntimeContext): voidReleases resources owned by this plugin before the Core is destroyed.
context: DocPluginRuntimeContext
methodregisterBlockFlows registerBlockFlows(registry: RichTextBlockFlowRegistry): voidRegisters plugin-owned top-level block flow resolvers.
registry: RichTextBlockFlowRegistry
methodregisterCapabilities registerCapabilities(registry: DocRuntimeExtensionRegistry): voidPublishes typed runtime services owned by this document plugin.
registry: DocRuntimeExtensionRegistry
methodregisterCommands registerCommands(commands: DocCommandBus): voidRegisters every stable command id owned by this document plugin.
commands: DocCommandBus
methodregisterInlineStyleRenderers registerInlineStyleRenderers(registry: RichTextRunRenderRegistry): voidRegisters plugin-owned render behavior for styled text runs.
registry: RichTextRunRenderRegistry
methodregisterInlineStyles registerInlineStyles(registry: RichTextInlineStyleRegistry): voidRegisters plugin-owned inline text style readers and mutation policies.
registry: RichTextInlineStyleRegistry
methodregisterKeyboardHandlers registerKeyboardHandlers(context: DocKeyboardHandlerRegistrationContext): voidRegisters keyboard-to-command bindings owned by this document plugin.
context: DocKeyboardHandlerRegistrationContext
methodregisterLineBoxes registerLineBoxes(registry: RichTextLineBoxRegistry): voidRegisters plugin-owned rich-text line box resolvers.
registry: RichTextLineBoxRegistry
methodregisterObservations registerObservations(observations: ObservationRegistry): voidRegisters typed state and event observations owned by this document plugin.
observations: ObservationRegistry
methodregisterSessionState registerSessionState(registry: SessionStateRegistry): voidRegisters local state that must survive an in-memory editor remount.
registry: SessionStateRegistry
methodstart start(context: DocPluginRuntimeContext): voidStarts runtime behavior after the first document frame.
context: DocPluginRuntimeContext
methodregisterServicesstatic registerServices(context: DocPluginServiceContext): voidRegisters bindings required before this Doc plugin is instantiated.
context: DocPluginServiceContext
Inherited members 34
Inherited from Plugin.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- apply
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getPluginConfig
- getState
- hasStateWriteBoundary
- lockCommittedState
- onClick
- onDblClick
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerConfig
- registerState
- render
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- interfaceDocPluginImplementationsource ↗
-
interface DocPluginImplementation<TPlugin>Injectable DocPlugin class accepted by createDocEditor().
constructorconstructor DocPluginImplementation(...args: never[]): TPluginargs: never[]
propertysymbol readonly symbol: symbolmethodregisterServices registerServices(context: DocPluginServiceContext): voidcontext: DocPluginServiceContext
- interfaceDocPluginRuntimesource ↗
-
interface DocPluginRuntimeStable host capabilities supplied to a DocPlugin after editor assembly.
propertycommands readonly commands: DocCommandBusCommand bus exposed by the document editor instance.
propertydocument readonly document: { blockFlows: RichTextBlockFlowRegistry; core: SearCoreDoc; cursor: DocCursorManager; inlineStyles: RichTextInlineStyleRegistry; input: DocInputPlugin; layout: DocLayoutEngine; lineBoxes: RichTextLineBoxRegistry; nodes: DocNodeRegistry }Rich-document domain services.
propertyevents readonly events: { engine: EventEngine<NodeProperties>; registrar: EventRegistrar }Event and hit-test services used by document interactions.
propertyextensions readonly extensions: DocRuntimeExtensionRegistryExtension capability registry for third-party document plugins.
propertyinput readonly input: { keyboard: KeyboardRouter; pointer: PointerCapture; text: TextInput }Host input adapters used by document editing commands.
propertyobservations readonly observations: ObservationRegistryTyped state and event observations owned by this editor instance.
propertyplatform readonly platform: PlatformPlatform adapter for timers, resize observation, and diagnostics.
propertyplugins readonly plugins: PluginManager<SearCoreDoc, NodeProperties>Ordered document plugin registry for this editor.
propertyrender readonly render: { context: RenderContext; engine: DocRenderEngineCapability }Document render services and visible context.
propertyscroll readonly scroll: { manager: ScrollManager }Scroll state shared by document layout and rendering.
propertysession readonly session: SessionStateRegistryLocal remount state contributed by built-in and third-party plugins.
propertytextShaper readonly textShaper: TextShaperText shaper used by document layout and rendering.
- variableDocPluginRuntimeCapabilitysource ↗
-
DocPluginRuntimeCapability: { CaretState: DocRuntimeCapability<DocCaretStateCapability>; Composition: DocRuntimeCapability<DocCompositionManager>; InputBindings: DocRuntimeCapability<DocInputBindingRegistryCapability>; Interaction: DocRuntimeCapability<DocInteractionRuntime> }Runtime extension tokens owned by document plugins assembled by editor composition roots.
- interfaceDocPluginRuntimeContextsource ↗
-
interface DocPluginRuntimeContext extends DocPluginSetupContextDocument setup capabilities plus the Core created by createDocEditor().
propertycore readonly core: SearCoreDocCore document runtime.
- interfaceDocPluginServiceContextsource ↗
-
interface DocPluginServiceContextServices available while createDocEditor() registers document plugins.
propertycontainer readonly container: ContainerDI container used by the document assembly root.
- interfaceDocPluginSetupContextsource ↗
-
interface DocPluginSetupContextTyped public services available before createDocEditor() starts Core.
- variableDocRuntimeCapabilitysource ↗
-
DocRuntimeCapability: { BlockFlows: DocRuntimeCapability<RichTextBlockFlowRegistry>; Commands: DocRuntimeCapability<DocCommandBus>; Config: DocRuntimeCapability<ConfigEngine<any>>; Document: DocRuntimeCapability<{ blockFlows: RichTextBlockFlowRegistry; core: SearCoreDoc; cursor: DocCursorManager; inlineStyles: RichTextInlineStyleRegistry; input: DocInputPlugin; layout: DocLayoutEngine; lineBoxes: RichTextLineBoxRegistry; nodes: DocNodeRegistry }>; Events: DocRuntimeCapability<{ engine: EventEngine<NodeProperties>; registrar: EventRegistrar }>; InlineStyles: DocRuntimeCapability<RichTextInlineStyleRegistry>; Input: DocRuntimeCapability<{ keyboard: KeyboardRouter; pointer: PointerCapture; text: TextInput }>; LayoutService: DocRuntimeCapability<DocRenderLayoutServiceCapability>; … }Document runtime capabilities registered by the default assembly root.
- typeDocRuntimeCapabilityReadersource ↗
-
type DocRuntimeCapabilityReader = RuntimeCapabilityReaderRead-only view of editor-local document runtime capabilities exposed to hosts.
- variableDocRuntimeCapabilityTokensource ↗
-
DocRuntimeCapabilityToken: { BlockFlows: DocRuntimeCapability<RichTextBlockFlowRegistry>; Commands: DocRuntimeCapability<DocCommandBus>; Config: DocRuntimeCapability<ConfigEngine<any>>; Document: DocRuntimeCapability<{ blockFlows: RichTextBlockFlowRegistry; core: SearCoreDoc; cursor: DocCursorManager; inlineStyles: RichTextInlineStyleRegistry; input: DocInputPlugin; layout: DocLayoutEngine; lineBoxes: RichTextLineBoxRegistry; nodes: DocNodeRegistry }>; Events: DocRuntimeCapability<{ engine: EventEngine<NodeProperties>; registrar: EventRegistrar }>; InlineStyles: DocRuntimeCapability<RichTextInlineStyleRegistry>; Input: DocRuntimeCapability<{ keyboard: KeyboardRouter; pointer: PointerCapture; text: TextInput }>; LayoutService: DocRuntimeCapability<DocRenderLayoutServiceCapability>; … }Document runtime capabilities registered by the default assembly root.
- classDocRuntimeExtensionRegistrysource ↗
-
class DocRuntimeExtensionRegistry extends RuntimeCapabilityRegistryRegistry of extension capabilities available to document plugins.
constructorconstructor DocRuntimeExtensionRegistry(): DocRuntimeExtensionRegistrypropertysymbolstatic readonly symbol: typeof symbolDI token for resolving the document runtime extension registry.
Inherited members 7
Inherited from RuntimeCapabilityRegistry.
- interfaceDocVirtualLayoutSummarysource ↗
-
interface DocVirtualLayoutSummaryPublic virtual layout summary exposed through the Doc layout-service capability.
propertyblockRender readonly blockRender?: DocBlockRenderDebugSnapshotpropertycacheHits readonly cacheHits: numberpropertycacheMisses readonly cacheMisses: numberpropertycursorBlock readonly cursorBlock: number | nullpropertydocumentHeight readonly documentHeight: numberpropertyheightIndexUpdated readonly heightIndexUpdated: booleanpropertyinitialLoadMs readonly initialLoadMs?: numberpropertymaterializedBlocks readonly materializedBlocks: numberpropertymaterializedIndexes readonly materializedIndexes: stringpropertymodel readonly model: "reused" | "rebuilt"propertyrangeEnd readonly rangeEnd: numberpropertyrangeStart readonly rangeStart: numberpropertyrenderPhase readonly renderPhase?: DocVirtualLayoutRenderPhasepropertytimings readonly timings: DocVirtualLayoutTimingSummarypropertytotalBlocks readonly totalBlocks: number - variableFocusDocCommandsource ↗
-
FocusDocCommand: DocCommandDefinition<void, DocCommandResult>Focuses the host text-input adapter for the document editor.
- enumFontFamilyTextStyleKeysource ↗
-
enum FontFamilyTextStyleKeyPersisted style key owned by the font-family text-style plugin.
enum memberFontFamily FontFamily: "fontFamily" - classFontFamilyTextStylePluginsource ↗
-
class FontFamilyTextStylePlugin extends InlineTextStylePluginBaseContributes font-family rendering and the set-font-family document command.
constructorconstructor FontFamilyTextStylePlugin(): FontFamilyTextStylePluginpropertysymbolstatic readonly symbol: typeof symbolDI token for resolving FontFamilyTextStylePlugin.
methodregisterCommands registerCommands(commands: DocCommandBus): voidRegisters every stable command id owned by this document plugin.
commands: DocCommandBus
Inherited members 47
Inherited from InlineTextStylePluginBase.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- apply
- configure
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getPluginConfig
- getState
- hasStateWriteBoundary
- initialize
- lockCommittedState
- onClick
- onDblClick
- onEditorDestroy
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerBlockFlows
- registerCapabilities
- registerConfig
- registerInlineStyleRenderers
- registerInlineStyles
- registerKeyboardHandlers
- registerLineBoxes
- registerObservations
- registerSessionState
- registerState
- render
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- start
- registerServices
- enumFontSizeTextStyleKeysource ↗
-
enum FontSizeTextStyleKeyPersisted style key owned by the font-size text-style plugin.
enum memberFontSize FontSize: "fontSize" - classFontSizeTextStylePluginsource ↗
-
class FontSizeTextStylePlugin extends InlineTextStylePluginBaseContributes font-size rendering and the set-font-size document command.
constructorconstructor FontSizeTextStylePlugin(): FontSizeTextStylePluginpropertysymbolstatic readonly symbol: typeof symbolDI token for resolving FontSizeTextStylePlugin.
methodregisterCommands registerCommands(commands: DocCommandBus): voidRegisters every stable command id owned by this document plugin.
commands: DocCommandBus
Inherited members 47
Inherited from InlineTextStylePluginBase.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- apply
- configure
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getPluginConfig
- getState
- hasStateWriteBoundary
- initialize
- lockCommittedState
- onClick
- onDblClick
- onEditorDestroy
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerBlockFlows
- registerCapabilities
- registerConfig
- registerInlineStyleRenderers
- registerInlineStyles
- registerKeyboardHandlers
- registerLineBoxes
- registerObservations
- registerSessionState
- registerState
- render
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- start
- registerServices
- variableInsertDocTableCommandsource ↗
-
InsertDocTableCommand: DocCommandDefinition<InsertDocTableInput, DocCommandResult>Inserts a table block at the current document position.
- interfaceInsertDocTableInputsource ↗
-
interface InsertDocTableInputInput accepted by InsertDocTableCommand.
- variableInsertDocTextCommandsource ↗
-
InsertDocTextCommand: DocCommandDefinition<InsertDocTextInput, DocCommandResult>Inserts text at the current document selection.
- interfaceInsertDocTextInputsource ↗
-
interface InsertDocTextInputInput accepted by InsertDocTextCommand.
propertytext readonly text: stringText to insert at the current document selection.
- enumItalicTextStyleKeysource ↗
-
enum ItalicTextStyleKeyenum memberItalic Italic: "italic" - classItalicTextStylePluginsource ↗
-
class ItalicTextStylePlugin extends InlineTextStylePluginBaseContributes italic rendering, mutation, and keyboard commands.
constructorconstructor ItalicTextStylePlugin(): ItalicTextStylePluginpropertysymbolstatic readonly symbol: typeof symbolmethodregisterCommands registerCommands(commands: DocCommandBus): voidRegisters every stable command id owned by this document plugin.
commands: DocCommandBus
methodregisterKeyboardHandlers registerKeyboardHandlers(__namedParameters: DocKeyboardHandlerRegistrationContext): voidRegisters keyboard-to-command bindings owned by this document plugin.
__namedParameters: DocKeyboardHandlerRegistrationContext
Inherited members 46
Inherited from InlineTextStylePluginBase.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- apply
- configure
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getPluginConfig
- getState
- hasStateWriteBoundary
- initialize
- lockCommittedState
- onClick
- onDblClick
- onEditorDestroy
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerBlockFlows
- registerCapabilities
- registerConfig
- registerInlineStyleRenderers
- registerInlineStyles
- registerLineBoxes
- registerObservations
- registerSessionState
- registerState
- render
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- start
- registerServices
- variableLoadDocumentCommandsource ↗
-
LoadDocumentCommand: DocCommandDefinition<LoadDocumentInput, DocCommandResult>Replaces the active document content.
- interfaceLoadDocumentInputsource ↗
-
interface LoadDocumentInputInput accepted by LoadDocumentCommand.
propertydocument readonly document: RichDocNode[]Rich-document content to load into the document editor.
- variableMoveDocCursorCommandsource ↗
-
MoveDocCursorCommand: DocCommandDefinition<MoveDocCursorInput, DocCommandResult>Moves the current document cursor.
- interfaceMoveDocCursorInputsource ↗
-
interface MoveDocCursorInputInput accepted by MoveDocCursorCommand.
- classParagraphPluginsource ↗
-
class ParagraphPlugin extends DocPlugin<null>Registers paragraph and text node model support plus block-level commands.
constructorconstructor ParagraphPlugin(): ParagraphPluginCreates a ParagraphPlugin instance.
propertysymbolstatic readonly symbol: typeof symbolDI token for resolving ParagraphPlugin.
methodapply apply(_state: null, _transaction: unknown): nullApplies a transaction to plugin-owned state and returns the next state.
_state: null_transaction: unknown
methodconfigure configure(context: DocPluginSetupContext): voidConfigures the document editor before runtime start.
context: DocPluginSetupContext
methodgetPluginConfig getPluginConfig(): nullReturns this plugin's runtime configuration view for the current core.
methodonEditorDestroy onEditorDestroy(): voidReleases resources owned by this plugin before the Core is destroyed.
methodregisterBlockFlows registerBlockFlows(registry: RichTextBlockFlowRegistry): voidRegisters plugin-owned top-level block flow resolvers.
registry: RichTextBlockFlowRegistry
methodregisterCommands registerCommands(commands: DocCommandBus): voidRegisters every stable command id owned by this document plugin.
commands: DocCommandBus
methodregisterKeyboardHandlers registerKeyboardHandlers(__namedParameters: DocKeyboardHandlerRegistrationContext): voidRegisters keyboard-to-command bindings owned by this document plugin.
__namedParameters: DocKeyboardHandlerRegistrationContext
methodregisterLineBoxes registerLineBoxes(registry: RichTextLineBoxRegistry): voidRegisters plugin-owned rich-text line box resolvers.
registry: RichTextLineBoxRegistry
methodregisterState registerState(): { key: PluginKey; state: null }Registers one or more plugin-owned state records with the host manager.
methodrender render(): Node<NodeProperties>[] | nullProduces scene nodes owned by this plugin for the current core state.
methodregisterServicesstatic registerServices(context: DocPluginServiceContext): voidRegisters paragraph node model support owned by this plugin.
context: DocPluginServiceContext
Inherited members 37
Inherited from DocPlugin.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getState
- hasStateWriteBoundary
- initialize
- lockCommittedState
- onClick
- onDblClick
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerCapabilities
- registerConfig
- registerInlineStyleRenderers
- registerInlineStyles
- registerObservations
- registerSessionState
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- start
- functionreadSessionStatesource ↗
-
readSessionState<State>(snapshot: SessionStateSnapshot, definition: SessionStateDefinition<State>): State | undefinedReads one contributor value from an opaque snapshot through its typed definition.
snapshot: SessionStateSnapshotdefinition: SessionStateDefinition<State>
- functionregisterDocPluginCapabilitiessource ↗
-
registerDocPluginCapabilities(plugins: readonly unknown[], registry: DocRuntimeExtensionRegistry): voidPublishes every typed runtime capability contributed by document plugins.
plugins: readonly unknown[]registry: DocRuntimeExtensionRegistry
- functionregisterDocPluginCommandssource ↗
-
registerDocPluginCommands(plugins: readonly unknown[], commands: DocCommandBus): (): voidRuns the register document plugin commands helper.
plugins: readonly unknown[]commands: DocCommandBus
- functionregisterDocPluginInlineStylessource ↗
-
registerDocPluginInlineStyles(plugins: readonly unknown[], registry: RichTextInlineStyleRegistry): (): voidRegisters every inline text-style contribution owned by document plugins.
plugins: readonly unknown[]registry: RichTextInlineStyleRegistry
- functionregisterDocPluginLineBoxessource ↗
-
registerDocPluginLineBoxes(plugins: readonly unknown[], registry: RichTextLineBoxRegistry): (): voidRegisters every rich-text line box contribution owned by document plugins.
plugins: readonly unknown[]registry: RichTextLineBoxRegistry
- functionregisterDocPluginObservationssource ↗
-
registerDocPluginObservations(plugins: readonly unknown[], observations: ObservationRegistry): voidRegisters every typed observation source contributed by document plugins.
plugins: readonly unknown[]observations: ObservationRegistry
- functionregisterDocPluginSessionStatessource ↗
-
registerDocPluginSessionStates(plugins: readonly unknown[], registry: SessionStateRegistry): voidRegisters every local session-state adapter contributed by document plugins.
plugins: readonly unknown[]registry: SessionStateRegistry
- variableRenderDocCommandsource ↗
-
RenderDocCommand: DocCommandDefinition<void, DocCommandResult>Requests a document render without changing content.
- typeRichTextInlineStylesource ↗
-
type RichTextInlineStyle = Readonly<Record<string, unknown>>Domain-neutral inline style bag carried by measured rich-text chars.
- classRichTextLineBoxPluginsource ↗
-
class RichTextLineBoxPlugin extends DocPlugin<null>Registers rich-text line box resolution for document layout.
constructorconstructor RichTextLineBoxPlugin(): RichTextLineBoxPluginpropertysymbolstatic readonly symbol: typeof symbolDI token for resolving RichTextLineBoxPlugin.
methodapply apply(_state: null, _transaction: unknown): nullApplies a transaction to plugin-owned state and returns the next state.
_state: null_transaction: unknown
methodgetPluginConfig getPluginConfig(): nullReturns this plugin's runtime configuration view for the current core.
methodregisterLineBoxes registerLineBoxes(registry: RichTextLineBoxRegistry): voidRegisters plugin-owned rich-text line box resolvers.
registry: RichTextLineBoxRegistry
methodregisterState registerState(): { key: PluginKey; state: null }Registers one or more plugin-owned state records with the host manager.
methodrender render(): Node<NodeProperties>[] | nullProduces scene nodes owned by this plugin for the current core state.
Inherited members 43
Inherited from DocPlugin.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- configure
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getState
- hasStateWriteBoundary
- initialize
- lockCommittedState
- onClick
- onDblClick
- onEditorDestroy
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerBlockFlows
- registerCapabilities
- registerCommands
- registerConfig
- registerInlineStyleRenderers
- registerInlineStyles
- registerKeyboardHandlers
- registerObservations
- registerSessionState
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- start
- registerServices
- variableSelectAllDocCommandsource ↗
-
SelectAllDocCommand: DocCommandDefinition<void, DocCommandResult>Selects all document content.
- interfaceSessionStateAdaptersource ↗
-
interface SessionStateAdapter<State>Captures and restores one detached local session value.
propertyrestoreAfter readonly restoreAfter?: readonly SessionStateDefinition<unknown>[]Contributors in the same phase that must restore before this one when they are registered.
propertyrestorePhase readonly restorePhase: SessionStateRestorePhaseLifecycle phase in which restore() may safely update the owning feature.
methodcapture capture(): State | undefinedReturns plain data or a supported built-in value; custom class instances are not session snapshots.
methodrestore restore(state: State): voidRestores local state during the declared lifecycle phase.
state: State
- interfaceSessionStateDefinitionsource ↗
-
interface SessionStateDefinition<State>Typed identity owned and exported by one local-state contributor.
- classSessionStateErrorsource ↗
-
class SessionStateError extends SearErrorError raised when a session-state contributor violates its registry contract.
constructorconstructor SessionStateError(code: SessionStateErrorCode, message: string, details?: SearErrorDetails): SessionStateErrorCreates a session-state contract error.
code: SessionStateErrorCodemessage: stringdetails: SearErrorDetails
propertycode readonly code: SessionStateErrorCodeStable machine-readable error code.
Inherited members 9
Inherited from SearError.
- variableSessionStateErrorCodesource ↗
-
SessionStateErrorCode: { invalidDefinition: "SEAR_SESSION_STATE_INVALID_DEFINITION"; invalidRestoreDependency: "SEAR_SESSION_STATE_INVALID_RESTORE_DEPENDENCY"; invalidRestoreOrder: "SEAR_SESSION_STATE_INVALID_RESTORE_ORDER"; invalidRestorePhase: "SEAR_SESSION_STATE_INVALID_RESTORE_PHASE"; registrationConflict: "SEAR_SESSION_STATE_REGISTRATION_CONFLICT"; restoreDependencyCycle: "SEAR_SESSION_STATE_RESTORE_DEPENDENCY_CYCLE"; restoreInProgress: "SEAR_SESSION_STATE_RESTORE_IN_PROGRESS"; restorePhaseClosed: "SEAR_SESSION_STATE_RESTORE_PHASE_CLOSED"; … }Stable machine-readable errors raised by session-state contracts.
- classSessionStateRegistrysource ↗
-
class SessionStateRegistryEditor-local coordinator for all built-in and plugin-contributed session state.
constructorconstructor SessionStateRegistry(): SessionStateRegistrypropertysymbolstatic readonly symbol: typeof symbolDI token for resolving the editor-local registry.
methodassertRestorationOpen assertRestorationOpen(): voidRejects a retained contributor restore callback after editor initialization.
methodcapture capture(): SessionStateSnapshotCaptures every registered contributor while preserving state whose owner is not loaded.
methodclear clear(lifecycleToken?: object): voidClears contributors and retained state owned by this registry instance.
lifecycleToken: object
methodgetCompletedRestorePhases getCompletedRestorePhases(): readonly SessionStateRestorePhase[]Returns restore phases already completed by this editor lifecycle.
methodgetRegisteredStateIds getRegisteredStateIds(): readonly string[]Returns sorted ids for currently registered contributors.
methodloadSnapshot loadSnapshot(snapshot: SessionStateSnapshot): voidLoads a complete snapshot before lifecycle restoration begins.
snapshot: SessionStateSnapshot
methodregister register<State>(definition: SessionStateDefinition<State>, adapter: SessionStateAdapter<State>): (): voidRegisters one state owner and returns an idempotent disposer.
definition: SessionStateDefinition<State>adapter: SessionStateAdapter<State>
methodrestorePhase restorePhase(phase: SessionStateRestorePhase): voidRestores every registered contributor assigned to one ordered lifecycle phase.
phase: SessionStateRestorePhase
methodsealRestoration sealRestoration(lifecycleToken: object): voidCloses initialization-only restore operations for an assembled editor.
lifecycleToken: object
- variableSessionStateRestorePhasesource ↗
-
SessionStateRestorePhase: { AfterInitialize: "afterInitialize"; BeforeInitialize: "beforeInitialize" }Ordered lifecycle phases in which local state may be restored.
- typeSessionStateSnapshotsource ↗
-
type SessionStateSnapshot = Readonly<Record<string, unknown>>Opaque in-memory snapshot keyed by contributor-owned definition ids.
- variableSetDocBoldCommandsource ↗
-
SetDocBoldCommand: DocCommandDefinition<SetDocBoldInput, DocCommandResult>Sets whether the selected document text is bold.
- interfaceSetDocBoldInputsource ↗
-
interface SetDocBoldInputInput accepted by SetDocBoldCommand. A null or false value clears bold.
propertybold readonly bold: boolean | null - variableSetDocCompositionCommandsource ↗
-
SetDocCompositionCommand: DocCommandDefinition<SetDocCompositionInput, DocCommandResult>Sets the active IME composition preview text.
- interfaceSetDocCompositionInputsource ↗
-
interface SetDocCompositionInputInput accepted by SetDocCompositionCommand.
propertycaretOffset readonly caretOffset: numberCaret offset inside the composing text.
propertytext readonly text: stringCurrent composing text emitted by the host input method.
- variableSetDocFontFamilyCommandsource ↗
-
SetDocFontFamilyCommand: DocCommandDefinition<SetDocFontFamilyInput, DocCommandResult>Sets the font family on the selected document text.
- interfaceSetDocFontFamilyInputsource ↗
-
interface SetDocFontFamilyInputInput accepted by SetDocFontFamilyCommand. A null or empty value clears the font family.
propertyfontFamily readonly fontFamily: string | null - variableSetDocFontSizeCommandsource ↗
-
SetDocFontSizeCommand: DocCommandDefinition<SetDocFontSizeInput, DocCommandResult>Sets the font size in pixels on the selected document text.
- interfaceSetDocFontSizeInputsource ↗
-
interface SetDocFontSizeInputInput accepted by SetDocFontSizeCommand. A null or empty value clears the font size.
propertyfontSize readonly fontSize: number | null - variableSetDocItalicCommandsource ↗
-
SetDocItalicCommand: DocCommandDefinition<SetDocItalicInput, DocCommandResult> - interfaceSetDocItalicInputsource ↗
-
interface SetDocItalicInputpropertyitalic readonly italic: boolean | null - variableSetDocSelectionCommandsource ↗
-
SetDocSelectionCommand: DocCommandDefinition<SetDocSelectionInput, DocCommandResult>Sets the active document selection without changing content.
- interfaceSetDocSelectionInputsource ↗
-
interface SetDocSelectionInputInput accepted by SetDocSelectionCommand.
propertyselection readonly selection: DocSelectionSelection to make active in the document editor.
- variableSetDocStrikethroughCommandsource ↗
-
SetDocStrikethroughCommand: DocCommandDefinition<SetDocStrikethroughInput, DocCommandResult> - interfaceSetDocStrikethroughInputsource ↗
-
interface SetDocStrikethroughInputpropertystrikethrough readonly strikethrough: boolean | null - variableSetDocTextColorCommandsource ↗
-
SetDocTextColorCommand: DocCommandDefinition<SetDocTextColorInput, DocCommandResult>Sets the text color on the selected document text.
- interfaceSetDocTextColorInputsource ↗
-
interface SetDocTextColorInputInput accepted by SetDocTextColorCommand. A null or empty value clears the text color.
propertycolor readonly color: string | null - variableSetDocUnderlineCommandsource ↗
-
SetDocUnderlineCommand: DocCommandDefinition<SetDocUnderlineInput, DocCommandResult> - interfaceSetDocUnderlineInputsource ↗
-
interface SetDocUnderlineInputpropertyunderline readonly underline: boolean | null - variableSplitDocParagraphCommandsource ↗
-
SplitDocParagraphCommand: DocCommandDefinition<void, DocCommandResult>Splits the current paragraph at the current document selection.
- enumStrikethroughTextStyleKeysource ↗
-
enum StrikethroughTextStyleKeyenum memberStrikethrough Strikethrough: "strikethrough" - classStrikethroughTextStylePluginsource ↗
-
class StrikethroughTextStylePlugin extends InlineTextStylePluginBaseContributes strikethrough rendering, mutation, and keyboard commands.
constructorconstructor StrikethroughTextStylePlugin(): StrikethroughTextStylePluginpropertysymbolstatic readonly symbol: typeof symbolmethodregisterCommands registerCommands(commands: DocCommandBus): voidRegisters every stable command id owned by this document plugin.
commands: DocCommandBus
methodregisterKeyboardHandlers registerKeyboardHandlers(__namedParameters: DocKeyboardHandlerRegistrationContext): voidRegisters keyboard-to-command bindings owned by this document plugin.
__namedParameters: DocKeyboardHandlerRegistrationContext
Inherited members 46
Inherited from InlineTextStylePluginBase.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- apply
- configure
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getPluginConfig
- getState
- hasStateWriteBoundary
- initialize
- lockCommittedState
- onClick
- onDblClick
- onEditorDestroy
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerBlockFlows
- registerCapabilities
- registerConfig
- registerInlineStyleRenderers
- registerInlineStyles
- registerLineBoxes
- registerObservations
- registerSessionState
- registerState
- render
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- start
- registerServices
- classTablePluginsource ↗
-
class TablePlugin extends DocPlugin<null>Contributes table model and insertion command without adding table knowledge to Core.
constructorconstructor TablePlugin(): TablePluginCreates a TablePlugin instance.
propertysymbolstatic readonly symbol: typeof symbolDI token for resolving TablePlugin.
methodapply apply(_state: null, _transaction: unknown): nullApplies a transaction to plugin-owned state and returns the next state.
_state: null_transaction: unknown
methodconfigure configure(context: DocPluginSetupContext): voidConfigures the document editor before runtime start.
context: DocPluginSetupContext
methodgetPluginConfig getPluginConfig(): nullReturns this plugin's runtime configuration view for the current core.
methodonEditorDestroy onEditorDestroy(): voidReleases resources owned by this plugin before the Core is destroyed.
methodregisterCommands registerCommands(commands: DocCommandBus): voidRegisters every stable command id owned by this document plugin.
commands: DocCommandBus
methodregisterState registerState(): { key: PluginKey; state: null }Registers one or more plugin-owned state records with the host manager.
methodrender render(): Node<NodeProperties>[] | nullProduces scene nodes owned by this plugin for the current core state.
methodregisterServicesstatic registerServices(context: DocPluginServiceContext): voidRegisters table node model support owned by this plugin.
context: DocPluginServiceContext
Inherited members 40
Inherited from DocPlugin.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getState
- hasStateWriteBoundary
- initialize
- lockCommittedState
- onClick
- onDblClick
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerBlockFlows
- registerCapabilities
- registerConfig
- registerInlineStyleRenderers
- registerInlineStyles
- registerKeyboardHandlers
- registerLineBoxes
- registerObservations
- registerSessionState
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- start
- enumTextColorStyleKeysource ↗
-
enum TextColorStyleKeyPersisted style key owned by the text-color style plugin.
enum memberColor Color: "color" - classTextColorStylePluginsource ↗
-
class TextColorStylePlugin extends InlineTextStylePluginBaseContributes text-color rendering and mutation for text nodes.
constructorconstructor TextColorStylePlugin(): TextColorStylePluginCreates a TextColorStylePlugin instance.
propertysymbolstatic readonly symbol: typeof symbolDI token for resolving TextColorStylePlugin.
methodregisterCommands registerCommands(commands: DocCommandBus): voidRegisters every stable command id owned by this document plugin.
commands: DocCommandBus
Inherited members 47
Inherited from InlineTextStylePluginBase.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- apply
- configure
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getPluginConfig
- getState
- hasStateWriteBoundary
- initialize
- lockCommittedState
- onClick
- onDblClick
- onEditorDestroy
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerBlockFlows
- registerCapabilities
- registerConfig
- registerInlineStyleRenderers
- registerInlineStyles
- registerKeyboardHandlers
- registerLineBoxes
- registerObservations
- registerSessionState
- registerState
- render
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- start
- registerServices
- variableToggleDocBoldCommandsource ↗
-
ToggleDocBoldCommand: DocCommandDefinition<void, DocCommandResult>Toggles bold on the selected document text.
- variableToggleDocItalicCommandsource ↗
-
ToggleDocItalicCommand: DocCommandDefinition<void, DocCommandResult> - variableToggleDocStrikethroughCommandsource ↗
-
ToggleDocStrikethroughCommand: DocCommandDefinition<void, DocCommandResult> - variableToggleDocUnderlineCommandsource ↗
-
ToggleDocUnderlineCommand: DocCommandDefinition<void, DocCommandResult> - enumUnderlineTextStyleKeysource ↗
-
enum UnderlineTextStyleKeyenum memberUnderline Underline: "underline" - classUnderlineTextStylePluginsource ↗
-
class UnderlineTextStylePlugin extends InlineTextStylePluginBaseContributes underline rendering, mutation, and keyboard commands.
constructorconstructor UnderlineTextStylePlugin(): UnderlineTextStylePluginpropertysymbolstatic readonly symbol: typeof symbolmethodregisterCommands registerCommands(commands: DocCommandBus): voidRegisters every stable command id owned by this document plugin.
commands: DocCommandBus
methodregisterKeyboardHandlers registerKeyboardHandlers(__namedParameters: DocKeyboardHandlerRegistrationContext): voidRegisters keyboard-to-command bindings owned by this document plugin.
__namedParameters: DocKeyboardHandlerRegistrationContext
Inherited members 46
Inherited from InlineTextStylePluginBase.
- depth
- documentState
- interestedIn
- pluginKey
- transactionHistory
- transactionOT
- warnOnDuplicateDepth
- key
- apply
- configure
- dirtyRect
- enforceRuntimeWriteBoundary
- enforceStateWriteBoundary
- getPluginConfig
- getState
- hasStateWriteBoundary
- initialize
- lockCommittedState
- onClick
- onDblClick
- onEditorDestroy
- onInitialDataCell
- onInitialDataComplete
- onMouseDown
- onMouseMove
- onMouseUp
- onResize
- onScroll
- onTransactionCommitted
- projectTransaction
- registerBlockFlows
- registerCapabilities
- registerConfig
- registerInlineStyleRenderers
- registerInlineStyles
- registerLineBoxes
- registerObservations
- registerSessionState
- registerState
- render
- sealRuntimeMetadata
- sealRuntimeMethods
- sealRuntimeWrites
- setState
- start
- registerServices
No public exports match that search.