# Enesis Editor A high-performance **block markdown editor** built with Vue 3, TypeScript, ProseMirror, and the Lezer parsing framework. Documents are structured as distinct, interactive **Blocks** rather than a single flat string. Each block is a self-contained ProseMirror editor instance that stores raw markdown as plain text — no AST conversion, no mark storage. A Lezer-based 3-stage parsing pipeline renders syntax as visual decorations in real time, enabling live-preview editing of Obsidian-style references, task states, callouts, headings, and inline formatting. The editor is designed for the philosophy that **plain text should stay plain text** — formatting is purely decorative, never structural. This makes it ideal for note-taking apps, knowledge bases, and any tool that needs to edit rich markdown with programmatic access to the raw source. ## Vision Enesis is being built as a complete block-editing substrate: | Phase | Feature | Status | |---|---|---|---| | 1–5 | Core editor: clean content model, keyboard boundaries, focus/cursor, inline + block decorations, Lezer-only AST pipeline | **Done** | | 6 | Code block node views with CodeMirror 6, inline/block LaTeX with KaTeX | **Done** | | 6.75 | Build system — type declarations pass cleanly, dev app as interactive docs site | **Done** | | 7 | Reference & tag insertion handlers — `insertPageRef`, `insertBlockRef`, `insertTag` | **Done** | | 8 | Asset handling — image drop, upload protocol, inline preview | Planned | | 9 | Reference interactivity — clickable `[[page]]`, `((block))`, `#tag` chips with preview | Planned | | 10 | Multi-block editing — shared toolbar, drag handle, suggestion/mention menus | Planned | | 11 | WCAG 2.1 AA compliance, screen reader support, RTL, high contrast | Planned | | 12 | Third-party decoration plugin system | Planned | | 13 | History orchestration API across blocks | Planned | ## Design Principles - **Raw markdown in, raw markdown out.** ProseMirror never converts `**bold**` to ``. What you type is what's stored. - **Syntax through decorations, not marks.** Bold, italic, links, references, tags — all rendered via ProseMirror decorations, never via schema marks. This keeps the document model clean and pluggable. - **Lezer-based parsing.** All syntax features flow through a single `@lezer/markdown` AST walk with custom extensions for Obsidian-style elements. - **Block-level isolation.** Each block is an independent ProseMirror instance. Blocks coordinate via emitted events (`split`, `merge-previous`, `arrow-up-from-start`, etc.) — no shared state. ## Monorepo Structure ``` ├── apps/ │ └── dev/ Docs-style development site (Vue 3 + Vite) │ ├── src/ │ │ ├── components/ │ │ │ ├── LiveExample.vue Editable demo wrapper with source view │ │ │ └── AppLogo.vue Enesis brand mark │ │ ├── pages/ │ │ │ ├── index.vue Overview │ │ │ ├── basic-editing.vue Headings, paragraphs, rules │ │ │ ├── inline-marks.vue Bold, italic, code, strike, highlight │ │ │ ├── tasks.vue Task states & priorities │ │ │ ├── blockquotes.vue Blockquotes & callouts │ │ │ ├── links.vue Markdown links │ │ │ ├── refs-tags.vue Page refs, block refs, tags │ │ │ ├── code-blocks.vue Fenced code blocks │ │ │ ├── properties.vue Key::value properties & dates │ │ │ └── math.vue Inline & display LaTeX │ │ ├── App.vue Shell layout (Nuxt UI) with sidebar │ │ ├── main.ts App bootstrap (10 routes) │ │ └── style.css Tailwind v4 + Nuxt UI theme │ ├── public/ Static assets │ └── vite.config.ts Vite with Nuxt UI plugin │ ├── packages/ │ └── editor/ Core headless engine │ ├── src/ │ │ ├── index.ts Public API (Block component + plugin) │ │ ├── components/ │ │ │ └── Block.vue Self-contained ProseMirror block editor │ │ ├── composables/ │ │ │ ├── useMarkdownDecorations.ts ProseMirror decoration plugin │ │ │ ├── useBlockKeyboardHandlers.ts Keyboard handler (Enter, Backspace, arrows) │ │ │ ├── useCodeBlockView.ts CM6 NodeView for fenced code blocks │ │ │ └── usePatternPlugin.ts Pattern detection ([[, ((, /, #) │ │ └── lib/ │ │ ├── markdown-parser.ts Lezer parser configuration │ │ ├── markdown-extensions.ts Custom Lezer extensions │ │ ├── content-model.ts Markdown ↔ ProseMirror conversion │ │ ├── schema.ts Minimal ProseMirror schema │ │ ├── auto-close-plugin.ts Auto-close for ```, **, _ │ │ ├── logger.ts Namespace-based debug logger │ │ └── markdown-rules/ │ │ ├── engine.ts MarkdownRuleEngine (3-stage pipeline) │ │ ├── types.ts Shared type interfaces │ │ ├── inline-rules.ts Inline syntax rules │ │ ├── block-rules.ts Block syntax rules │ │ └── block-classifier.ts First-line regex classifier │ ├── vite.config.ts Library build (ESM, tailwind, vue) │ └── vitest.config.ts Test runner configuration │ ├── .forgejo/ │ └── workflows/ │ └── deploy.yml CI: build + deploy to Codeberg Pages │ ├── package.json Workspace root ├── pnpm-workspace.yaml pnpm workspace definition ├── AGENTS.md Project conventions for AI coding agents └── biome.json Linting & formatting ``` ## Quick Start ```bash pnpm install pnpm dev # Start the dev sandbox at localhost:5173 pnpm test # Run editor unit tests (Vitest) pnpm check # Lint & format check (Biome) ``` ## Scripts | Script | Description | |---|---| | `pnpm dev` | Start Vite dev server for `@enesis/dev` sandbox | | `pnpm build` | Build `@enesis/editor` library (ESM + type declarations) | | `pnpm test` | Run unit tests for `@enesis/editor` | | `pnpm check` | Run Biome lint & format check across the workspace | ## Deployment On push to `master`, a Forgejo Actions workflow builds the dev app and deploys it to **Codeberg Pages** at `https://enesismd.codeberg.page/editor/`. ## Technology | Layer | Technology | |---|---| | Framework | Vue 3 (Composition API, `