How cp949/geul works
Geul is a block editor built around a persistent JSON document model, with a headless Tiptap-backed controller and React UI. The principal workflow is to initialize a document, edit it through the React bindings and controller, then validate and represent the resulting model; HTML and GFM import/export provide interoperability branches. The graph includes model validation, editor assembly and editing commands, and the documented IO capabilities. Some subsystem links rely on README package-level descriptions because their implementation excerpts were not provided.
Main entry points: editor-controller.ts Editor controller · types.ts JSON document · document-structure-validation.ts Document validation · production-editor-session.ts Editor session
Components 20
Document model
- JSON document
packages/model/src/types.ts - Document validation
packages/model/src/document-structure-validation.ts - Block schemas
packages/model/src/block-schema.ts - Table grid validation
packages/model/src/table-grid-validation.ts
Headless editor
- Editor controller
packages/core/src/editor-controller.ts - Editor session
packages/core/src/production-editor-session.ts - Editor assembly
packages/core/src/production-editor-assembly.ts - Model projection
packages/core/src/model-to-tiptap.ts - Block commands
packages/core/src/generic-block-commands.ts - Media upload
packages/core/src/media-upload.ts
React interface
- Editor provider
packages/react/src/editor-provider.tsx - Editor content
packages/react/src/editor-content.tsx - Editing UI
packages/react/src/formatting-toolbar.tsx - Media toolbar
packages/react/src/media-toolbar.tsx
Document interchange
- Markdown import
packages/io/src/markdown/import-markdown.ts - HTML import
packages/io/src/html/import-html.ts - Clipboard parsing
packages/io/src/clipboard/clipboard-table-parser.ts - HTML export
packages/io/src/html/export-html.ts - Markdown export
packages/io/src/markdown/export-markdown.ts
Other components
- Editor user
Connections 20
- Editor user → Editor provider: edits with
README.md - Editor provider → Editor content: renders
- Editor provider → Editor controller: binds to
README.md - Editing UI → Editor controller: issues commands
- Media toolbar → Editor controller: issues commands
- Editor controller → Editor session: creates
packages/core/src/editor-controller.ts - Editor controller → Block commands: creates
packages/core/src/editor-controller.ts - Editor controller → Model projection: uses
packages/core/src/editor-controller.ts - Editor session → Editor assembly: assembles
- Editor session → Model projection: projects model
- Editor controller → Media upload: supports upload
- JSON document → Document validation: validated by
packages/model/src/document-structure-validation.ts - Document validation → Block schemas: checks blocks
packages/model/src/document-structure-validation.ts - Document validation → Table grid validation: checks tables
- Editor controller → JSON document: updates document
README.md - Markdown import → JSON document: imports to
README.md - HTML import → JSON document: imports to
README.md - Clipboard parsing → JSON document: parses clipboard
- JSON document → HTML export: exports as HTML
README.md - JSON document → Markdown export: exports as GFM
README.md