https://github.com/developer-1px/editable
editable
https://github.com/developer-1px/editable
Last synced: 19 days ago
JSON representation
editable
- Host: GitHub
- URL: https://github.com/developer-1px/editable
- Owner: developer-1px
- Created: 2026-06-21T02:32:06.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-07-05T00:25:13.000Z (about 1 month ago)
- Last Synced: 2026-07-05T02:11:35.842Z (about 1 month ago)
- Language: TypeScript
- Size: 1.76 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 28
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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:
```txt
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`](./archive/pre-composition-island).
## Run
```bash
pnpm install
pnpm dev
```
Open `http://localhost:3000/`.
## Verify
```bash
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`](./docs/manual-ime-acceptance.md) matrix.