Use this page when a Plite doc makes a runtime, API, browser, package, or release claim. If a claim cannot name an owner here, narrow the claim or add the missing proof before publishing it.
On This Page
- Package Owners
- Runtime Claims
- React And DOM Claims
- Browser Proof Claims
- Collaboration And Layout Claims
- Docs And Release Claims
Package Owners
| Claim | Public docs | Source proof |
|---|---|---|
@platejs/plite owns editor runtime, document model, operations, helper APIs, transactions, extensions, and state fields. | Plite, Editor, Editor API | packages/plite/src/index.ts, packages/plite/src/interfaces/editor.ts, packages/plite/test/public-surface-contract.ts |
@platejs/plite-dom owns DOM conversion, clipboard helpers, hotkeys, and DOM coverage primitives. | Plite DOM, DOM Coverage Boundaries | packages/plite-dom/src/index.ts, packages/plite-dom/src/plugin/dom-coverage.ts, packages/plite-dom/src/utils/hotkeys.ts |
@platejs/plite-react owns React setup, <Plite>, <Editable>, hooks, DOM repair, overlays, and root rendering. | Plite React, Editable Component, Hooks | packages/plite-react/src/index.ts, packages/plite-react/src/components, packages/plite-react/src/hooks, packages/plite-react/test/surface-contract.tsx |
@platejs/browser owns browser proof infrastructure, not product editing APIs. | Browser, Editing Behavior, Selection And DOM | packages/browser/src, packages/browser/test, apps/www/tests/plite-browser |
Runtime Claims
| Claim | Public docs | Source proof |
|---|---|---|
Editors read with editor.read(...) and write with editor.update(...). | Overview, Installing Plite, Editor | packages/plite/src/interfaces/editor.ts, packages/plite/test/state-tx-public-api-contract.ts, packages/plite/test/editor-foundation-contract.ts |
Transaction helpers live on tx during editor.update(...). | Editing Behavior, Executing Commands, Transforms, Transforms API | packages/plite/test/transforms-contract.ts, packages/plite/test/state-tx-public-api-contract.ts |
| Extensions add named state and transaction groups instead of compatibility methods on the editor object. | Extensions, Why This Fork | packages/plite/src/core/editor-extension.ts, packages/plite/test/extension-methods-contract.ts, packages/plite/test/generic-extension-namespace-contract.ts |
Full document values use primary children, optional extra roots, and optional persistent meta. | Roots, Document Meta, Saving to a Database | packages/plite/src/core/public-state.ts, packages/plite/test/document-state-contract.ts, packages/plite/test/state-tx-public-api-contract.ts |
React And DOM Claims
| Claim | Public docs | Source proof |
|---|---|---|
React setup starts with usePliteEditor, <Plite>, and <Editable>. | React Editor Setup, Plite Component, Editable Component | packages/plite-react/src/hooks/use-plite-editor.ts, packages/plite-react/src/components/plite.tsx, packages/plite-react/src/components/editable.tsx |
Element, text, root, selector, decoration, annotation, and history hooks are public through @platejs/plite-react. | Hooks, Annotations, Roots | packages/plite-react/src/index.ts, packages/plite-react/src/hooks, packages/plite-react/test/provider-hooks-contract.tsx, packages/plite-react/test/surface-contract.tsx |
| Voids, hidden DOM coverage, editable islands, selection repair, and DOM strategy live in Plite React and Plite DOM. | Selection And DOM, Editable Component, DOM Coverage Boundaries, Rendering | packages/plite-react/src/components, packages/plite-react/src/dom-strategy, packages/plite-react/test/dom-strategy-and-scroll.tsx, packages/plite-react/test/plite-void-shell-contract.test.tsx |
Browser Proof Claims
| Claim | Public docs | Source proof |
|---|---|---|
Example behavior proof runs against /examples/plite/*, not docs pages. | Contributing, Browser | apps/www/tests/plite-browser/plite-examples.spec.ts, apps/www/tests/plite-browser/donor/examples |
| Generated stress and replay tests cover editing, paste, selection repair, undo/redo, and follow-up typing. | Editing Behavior, Selection And DOM, Browser | apps/www/tests/plite-browser/donor/stress/generated-editing.test.ts, apps/www/tests/plite-browser/donor/stress/replay.test.ts |
| Huge-document proof belongs to the example route and browser tests. | Improving Performance, Virtualized Rendering | apps/www/src/app/(app)/examples/plite/_examples/huge-document.tsx, apps/www/tests/plite-browser/donor/examples/huge-document.test.ts |
Collaboration And Layout Claims
| Claim | Public docs | Source proof |
|---|---|---|
@platejs/yjs owns Plite/Yjs mapping while apps own providers, auth, persistence, and room policy. | Plite Yjs, Operation Replay Substrate | packages/yjs/src, packages/yjs/test, apps/www/tests/plite-browser/donor/examples/yjs-hocuspocus.test.ts |
@platejs/plite-layout owns page geometry and paged editable proof, not the core editor contract. | Plite Layout, Improving Performance | packages/plite-layout/src, packages/plite-layout/test/page-layout-contract.test.ts, apps/www/src/app/(app)/examples/plite/_examples/pagination.tsx |
Docs And Release Claims
| Claim | Public docs | Source proof |
|---|---|---|
| Public docs use current package names and source-backed imports. | all Plite docs | pnpm --filter www check:docs, packages/plite/test/public-package-import-smoke.test.ts, packages/plite/test/public-package-types-smoke.ts |
| Browser-sensitive docs should name model, DOM, native selection where observable, focus, replay, and follow-up typing when claiming behavior. | Editing Behavior, Selection And DOM, Browser | packages/browser/src, apps/www/tests/plite-browser/donor |
| Release or deletion confidence uses the full Plite gate. | Contributing | pnpm check:plite, .github/workflows/plite-ci.yml |