@editora/core

Runtime architecture, commands, lifecycle, and configuration model for @editora/core.

Responsibilities

• ContentEditable orchestration and command execution
• Plugin manager and command registration lifecycle
• Web component bootstrapping and custom element behavior
• Selection/mutation and history integration points
• Runtime config updates (setConfig) in web component mode

Installation

npm i @editora/core

Typical Usage

import { createEditor } from "@editora/core";

const editor = createEditor({
  element: document.getElementById("editor"),
  plugins: "bold italic link",
  toolbar: "undo redo | bold italic | link",
});

API Surface

Surface	Type	Notes
createEditor(options)	Function	Creates vanilla runtime adapter instance
initWebComponent()	Function	Registers <editora-editor> when needed
Editor	Class export	Legacy runtime class export
EditorState	Class export	Editor state model
EditorSelection	Type export	Selection typing
Schema	Class export	Node schema model
Node, NodeSpec	Type exports	Schema node contracts
PluginManager	Class export	Plugin registration + command routing
Plugin, ToolbarItem	Type exports	Plugin contracts
PluginRuntime, createPluginRuntime	Runtime exports	Plugin runtime context APIs
PluginRuntimeContext	Type export	Runtime context typing
KeyboardShortcutManager	Class export	Keyboard shortcut orchestration
KeyboardShortcut, KeyboardShortcutConfig	Type exports	Shortcut contracts
SpellcheckPlugin, MediaPlugin	Enterprise exports	Enterprise plugin bridges
SpellcheckConfig, MediaConfig	Type exports	Enterprise config types
export * from './core'	Module re-export	Core architecture layer
export * from './ui'	Module re-export	UI layer exports used by editor
export * from './utils/statusBarUtils'	Module re-export	Status bar utility exports
export * from './config'	Module re-export	Runtime config exports
export * from './adapters'	Module re-export	Adapter layer exports
export * from './webcomponent'	Module re-export	Web component class + helpers
@editora/core/webcomponent	Package subpath	Web component runtime entry
@editora/core/webcomponent-core	Package subpath	Minimal web component entry
@editora/core/plugin-loader	Package subpath	Plugin loader entry
@editora/core/webcomponent.css	Package subpath	Web component stylesheet

Config Groups

Config Group	Purpose
toolbar	Toolbar layout and behavior
autosave	Save interval and persistence target
security	Sanitization and policy controls
performance	Input debounce and scanning controls
accessibility	ARIA and keyboard options

Best Practices

• Scope command execution to active instance only.
• Preserve selection for dialog-driven commands.
• Validate multi-instance panel/dialog host behavior.

Accessibility

Enable ARIA + keyboard navigation and verify focus flow across toolbar/content/dialogs.

Performance Notes

Use debounced input handling and viewport-only scan for large documents and multi-editor pages.