Interactive OS Editable

@interactive-os/editable is a JSON-backed contenteditable experiment focused on one hard invariant: native IME input and application rendering must never replace the same live DOM node at the same time.

The current implementation keeps @interactive-os/json-document as canonical state and mounts one coordinator that owns the entire editable subtree. Pure command planning, keyed DOM projection, and native-mutation grammar sit behind small internal seams; browser event ordering and the live IME lease remain together in the coordinator. Ordinary input is converted to model commands before the browser mutates DOM. During composition the module pins the browser-owned text node and lends that block to the IME; proven-disjoint remote updates are queued until settling, while local or same-block commands return composition_conflict and must be retried afterward.

getJsonEditableDocumentHost(editor) exposes a document-host capability for delayed or causal changes without widening the established JsonEditable shape. It flushes pending native input before a ready change, defers while the browser still owns a composition island, and identifies coordinator-owned native, application, history, and ready publications with a pre-commit sequence. The demo wires the SHA-pinned json-document causal inbox through that capability; “지연 편집 추적” exercises both positional rebase after a local insertion, selection correction, and settle-time retry during IME composition. Ready changes always update canonical selection, but automatic settle and causal publication restore DOM selection only while the editable root already owns focus. A background change therefore cannot reclaim focus from another control.

Enter is handled as a structural intent, independently from DOM ownership. A semantic paragraph event is retained and replayed once composition settles; candidate-confirming keydown Enter by itself is never treated as a paragraph. Non-cancelable native splits are accepted only when they exactly match one bounded, expected split and are then rebuilt from canonical JSON.

React renders the toolbar and diagnostics only. It provides an empty root to the editor and never renders descendants inside that root.

The package enforces a direct-child layer rule:

public facade -> browser -> core

Cross-layer imports must use the child layer's index.ts; public-to-core grandchild imports, browser-to-core implementation imports, and upward imports are rejected by pnpm run check:editable-layers.

The previous implementation is preserved unchanged under archive/pre-composition-island.

Run

pnpm install
pnpm dev

Open http://localhost:3000/.

Verify

pnpm run test:core
pnpm run check:editable-layers
pnpm run verify:browser
pnpm run verify:internal

Synthetic composition tests verify the coordinator protocol only. Actual IME acceptance still requires the manual IME acceptance matrix.