@haklex/rich-compose 0.7.0 → 0.9.0

package/README.md

@@ -1,16 +1,16 @@
 # @haklex/rich-compose
 
-Compose primitives for haklex rich content renderers — Gundam-style assembly of Lexical nodes, sync/lazy renderers, and Provider stacks.
+Compose primitives for haklex rich content — Gundam-style assembly of Lexical nodes, sync/lazy renderers, edit-side decorators, and Provider stacks. Powers both `composeRenderer` (read-only) and `composeEditor` (editable).
 
 ## Why
 
-The legacy `@haklex/rich-kit-shiro/renderer` (now removed) shipped every default renderer eagerly: even when a consumer overrode `CodeBlock` or `LinkCard`, the upstream `shiki` and `LinkCardRenderer` chains stayed in the production bundle. `rich-compose` solves three problems at once:
+The legacy `@haklex/rich-kit-shiro/renderer` (now removed) shipped every default renderer eagerly: overriding `CodeBlock` or `LinkCard` left the original `shiki` and `LinkCardRenderer` chains in the bundle. `rich-compose` solves three problems at once:
 
 1. **Subtractable** — drop a module by not importing it.
-2. **Replaceable** — swap a default renderer with no leftover bytes from the original.
+2. **Replaceable** — swap a default renderer with no leftover bytes.
 3. **Extensible** — add new renderer slots (sync or lazy) without touching the package.
 
-Tree-shake is enforced by physical subpath isolation (`./modules/<name>/node` separates Klasses from heavy renderer code) plus ESM-only emit.
+Tree-shake is enforced by physical subpath isolation (`./modules/<name>/node` separates Klasses from heavy renderer code; `./modules/<name>` vs `./modules/<name>/edit` separates static-only from editor-only chains) plus ESM-only emit.
 
 ## Installation
 
@@ -26,26 +26,45 @@ pnpm add @haklex/rich-compose
 | `lexical` / `@lexical/react` | `^0.44.0` |
 | `@haklex/rich-editor`        | workspace |
 
-Per-module upstream packages (`@haklex/rich-ext-*`, `@haklex/rich-renderer-*`) are optional peers — install only those you compose into your renderer.
+Per-module upstream packages (`@haklex/rich-ext-*`, `@haklex/rich-renderer-*`) are optional peers — install only those you compose.
 
 ## Quick start
 
+### Read-only renderer
+
 ```tsx
-import { composeRenderer } from '@haklex/rich-compose'
-import { embedModule } from '@haklex/rich-compose/modules/embed'
-import { codeBlockModule } from '@haklex/rich-compose/modules/code-block'
-import { linkCardModule } from '@haklex/rich-compose/modules/link-card'
-// import any modules you need...
+import { composeRenderer } from '@haklex/rich-compose';
+import { allRendererModules } from '@haklex/rich-compose/renderer';
 
-const RichContent = composeRenderer({
-  modules: [embedModule, codeBlockModule, linkCardModule],
-})
+const RichContent = composeRenderer({ modules: allRendererModules });
 
 // Render
-<RichContent value={editorState} theme="light" variant="article" />
+<RichContent value={editorState} theme="light" variant="article" />;
+```
+
+Or cherry-pick:
+
+```tsx
+import { composeRenderer } from '@haklex/rich-compose';
+import { embedModule } from '@haklex/rich-compose/modules/embed';
+import { codeBlockModule } from '@haklex/rich-compose/modules/code-block';
+
+const RichContent = composeRenderer({ modules: [embedModule, codeBlockModule] });
+```
+
+### Editor
+
+```tsx
+import { composeEditor } from '@haklex/rich-compose';
+import { allEditorModules } from '@haklex/rich-compose/editor';
+
+const RichEditor = composeEditor({ modules: allEditorModules });
+
+// Use like @haklex/rich-editor's RichEditor — accepts the same props plus children for plugins.
+<RichEditor initialValue={state} onChange={setState} variant="article" />;
 ```
 
-`composeRenderer` returns a memoized React component compatible with `<RichRenderer>`'s prop surface (theme, variant, value, className, style, …).
+Both helpers return memoized React components. `composeEditor` internally wires `composeRenderer` for nested editor states.
 
 ## Three consumer modes
 
@@ -55,11 +74,12 @@ Import the module sugar. Klass + renderer + (optional) lazy/SSR fallback are wir
 
 ```tsx
 import { embedModule } from '@haklex/rich-compose/modules/embed';
+import { embedEditModule } from '@haklex/rich-compose/modules/embed/edit';
 ```
 
 ### Mode B — custom renderer (tree-shake the default)
 
-Import the Klass from the `/node` subpath; supply your own renderer. The default renderer's chunk never enters the bundle.
+Import the Klass from `/node`; supply your own renderer.
 
 ```tsx
 import { GalleryNode } from '@haklex/rich-compose/modules/gallery/node';
@@ -71,7 +91,7 @@ const myGalleryModule: RichRendererModule = {
 };
 ```
 
-For modules with no custom Klass (most of the renderer-only modules), simply construct a module with the same `name` and your renderer:
+For renderer-only modules (no custom Klass), construct with matching `name`:
 
 ```tsx
 const myLinkCardModule: RichRendererModule = {
@@ -82,10 +102,9 @@ const myLinkCardModule: RichRendererModule = {
 
 ### Mode C — wrap the default
 
-Pull the default renderer from `/renderer` and wrap it.
+Pull the default renderer from `/renderer` and wrap.
 
 ```tsx
-import { LinkCardNode } from '@haklex/rich-compose/modules/link-card/node'; // when applicable
 import { LinkCardRenderer } from '@haklex/rich-compose/modules/link-card/renderer';
 
 const wrappedModule: RichRendererModule = {
@@ -100,40 +119,32 @@ const wrappedModule: RichRendererModule = {
 };
 ```
 
-## `RichRendererModule` shape
+## Module shapes
+
+`RichRendererModule` (read-only) and `RichEditorModule` (editor superset).
 
 ```ts
 interface RichRendererModule {
   name: string; // dedup key
-  nodes?: Klass<LexicalNode>[]; // optional — omit for builtin types
+  nodes?: Klass<LexicalNode>[]; // base Klasses
   renderers?: Partial<RendererConfig>; // sync renderer map
-  Provider?: ComponentType<{ children: ReactNode }>; // optional internal provider
+  Provider?: ComponentType<{ children: ReactNode }>; // shared provider
   lazyRenderers?: Partial<{
-    // code-split renderers
     [K in RendererKey]: () => Promise<{ default: NonNullable<RendererConfig[K]> }>;
   }>;
-  ssrFallback?: Partial<Record<RendererKey, ReactNode>>; // deterministic fallback
+  ssrFallback?: Partial<Record<RendererKey, ReactNode>>;
 }
-```
-
-`composeRenderer` merges modules, dedups Klasses, wraps lazy loaders in `React.lazy` (factory built once per compose), stacks Providers, and always sets `NestedContentRendererProvider` to a recursive closure for nested editor states.
-
-## Lazy modules
 
-`code-block` and `mermaid` ship lazy by default with deterministic `ssrFallback`s. The `excalidraw` Klass renders through its own upstream `decorate()` which code-splits internally.
-
-To override a lazy renderer (e.g., for a sync, pre-tokenized code block on SSR), pass an entry in `overrides`:
-
-```ts
-composeRenderer({
-  modules: [
-    /* ... */
-  ],
-  overrides: { CodeBlock: PreTokenizedCodeBlock },
-});
+interface RichEditorModule extends RichRendererModule {
+  editNodes?: Klass<LexicalNode>[]; // edit-side subclasses (override base by getType)
+  editRenderers?: Partial<RendererConfig>; // override renderers in editor mode
+  EditorProvider?: ComponentType<{ children: ReactNode }>; // editor-only provider
+  plugins?: ReactNode; // module-owned editor plugins
+  actions?: ReactNode; // module-owned action UI
+}
 ```
 
-The lazy chunk is still emitted but never fetched at runtime.
+`composeRenderer` consumes `RichRendererModule[]`; `composeEditor` consumes `RichEditorModule[]`. Each editor module spreads its renderer-only counterpart, so `allEditorModules` is a strict superset of `allRendererModules`.
 
 ## Dedup rules
 
@@ -145,52 +156,93 @@ modules:
 
 nodes:
   reference seen          → skip
-  same getType collision  → throw at compose time
-                            (multiple Klass instances break instanceof)
+  subclass override       → edit Klass replaces base Klass (same getType, A extends B)
+  unrelated collision     → throw at compose time
+                            (would break instanceof across module boundaries)
 ```
 
-## Module catalog
+## Lazy modules
+
+`code-block` and `mermaid` ship lazy by default with deterministic `ssrFallback`s. `excalidraw`'s Klass code-splits internally via its own `decorate()`.
 
-| Module         | Klass             | Renderer mode                   | Source                    |
-| -------------- | ----------------- | ------------------------------- | ------------------------- |
-| `alert`        | builtin           | sync                            | `rich-renderer-alert`     |
-| `banner`       | builtin           | sync                            | `rich-renderer-banner`    |
-| `chat`         | `ChatNode`        | sync                            | `rich-ext-chat`           |
-| `code-block`   | builtin           | lazy + ssr fallback             | `rich-renderer-codeblock` |
-| `code-snippet` | `CodeSnippetNode` | sync                            | `rich-ext-code-snippet`   |
-| `embed`        | `EmbedNode`       | sync (via node decorate)        | `rich-ext-embed`          |
-| `excalidraw`   | `ExcalidrawNode`  | via node decorate               | `rich-ext-excalidraw`     |
-| `gallery`      | `GalleryNode`     | sync                            | `rich-ext-gallery`        |
-| `image`        | builtin           | sync                            | `rich-renderer-image`     |
-| `link-card`    | builtin           | sync                            | `rich-renderer-linkcard`  |
-| `mention`      | builtin           | sync                            | `rich-renderer-mention`   |
-| `mermaid`      | builtin           | lazy + ssr fallback             | `rich-renderer-mermaid`   |
-| `nested-doc`   | `NestedDocNode`   | recursive (via composeRenderer) | `rich-ext-nested-doc`     |
-| `ruby`         | builtin           | sync                            | `rich-renderer-ruby`      |
-| `video`        | builtin           | sync                            | `rich-renderer-video`     |
-
-Not shipped (handled by `@haklex/rich-editor`'s default renderers via Klass `decorate()`): `katex`, `poll`, `tag`, `footnote`. To override these, pass `overrides` to `composeRenderer`:
+To override a lazy renderer (e.g., pre-tokenized code block for SSR), pass `overrides`:
 
 ```ts
 composeRenderer({
-  modules: [
-    /* ... */
-  ],
-  overrides: { KaTeX: MyKaTeXRenderer, Poll: MyPollRenderer },
+  modules: allRendererModules,
+  overrides: { CodeBlock: PreTokenizedCodeBlock },
 });
 ```
 
-> **Note**: `@haklex/rich-editor` registers a wide set of custom Klasses in `customNodes` (LinkCard, Mention, Image, Video, KaTeX, Mermaid, Alert, Banner, Ruby, Tag, Poll, CodeBlock, Footnote, etc.). Modules for these contribute only renderer mappings — there is no Klass to register, hence no `node.ts` and no `/node` subpath.
+The lazy chunk is still emitted but never fetched at runtime.
+
+## Module catalog
+
+| Module         | Base Klass        | Edit Klass            | Mode                            | Source                    |
+| -------------- | ----------------- | --------------------- | ------------------------------- | ------------------------- |
+| `alert`        | builtin           | —                     | sync                            | `rich-renderer-alert`     |
+| `banner`       | builtin           | —                     | sync                            | `rich-renderer-banner`    |
+| `chat`         | `ChatNode`        | `ChatEditNode`        | sync                            | `rich-ext-chat`           |
+| `code-block`   | builtin           | —                     | lazy + ssr fallback             | `rich-renderer-codeblock` |
+| `code-snippet` | `CodeSnippetNode` | `CodeSnippetEditNode` | sync                            | `rich-ext-code-snippet`   |
+| `embed`        | `EmbedNode`       | `EmbedEditNode`       | sync (via node decorate)        | `rich-ext-embed`          |
+| `excalidraw`   | `ExcalidrawNode`  | `ExcalidrawEditNode`  | via node decorate               | `rich-ext-excalidraw`     |
+| `gallery`      | `GalleryNode`     | `GalleryEditNode`     | sync                            | `rich-ext-gallery`        |
+| `image`        | builtin           | —                     | sync                            | `rich-renderer-image`     |
+| `katex`        | —                 | builtin               | edit-only (no static renderer)  | `rich-renderer-katex`     |
+| `link-card`    | builtin           | —                     | sync                            | `rich-renderer-linkcard`  |
+| `mention`      | builtin           | —                     | sync                            | `rich-renderer-mention`   |
+| `mermaid`      | builtin           | —                     | lazy + ssr fallback             | `rich-renderer-mermaid`   |
+| `nested-doc`   | `NestedDocNode`   | `NestedDocEditNode`   | recursive (via composeRenderer) | `rich-ext-nested-doc`     |
+| `poll`         | `PollNode`        | `PollEditNode`        | sync                            | `rich-ext-poll`           |
+| `ruby`         | builtin           | —                     | sync                            | `rich-renderer-ruby`      |
+| `video`        | builtin           | —                     | sync                            | `rich-renderer-video`     |
+
+`katex` ships only an edit module — KaTeX rendering for the read-only side is wired by the host renderer via `decorate()`.
 
 ## Sub-path exports
 
-| Path                                           | Description                             |
-| ---------------------------------------------- | --------------------------------------- |
-| `@haklex/rich-compose`                         | core: `composeRenderer`, types, helpers |
-| `@haklex/rich-compose/modules/<name>`          | full module barrel                      |
-| `@haklex/rich-compose/modules/<name>/node`     | Klass(es) only (when applicable)        |
-| `@haklex/rich-compose/modules/<name>/renderer` | default renderer only                   |
-| `@haklex/rich-compose/style.css`               | core styles (skeletons, layout shell)   |
+| Path                                           | Description                                                     |
+| ---------------------------------------------- | --------------------------------------------------------------- |
+| `@haklex/rich-compose`                         | core: `composeRenderer`, `composeEditor`, types, helpers        |
+| `@haklex/rich-compose/renderer`                | aggregate barrel — every renderer module + `allRendererModules` |
+| `@haklex/rich-compose/editor`                  | aggregate barrel — every editor module + `allEditorModules`     |
+| `@haklex/rich-compose/modules/<name>`          | renderer-side module barrel                                     |
+| `@haklex/rich-compose/modules/<name>/edit`     | editor-side module (extends the renderer module)                |
+| `@haklex/rich-compose/modules/<name>/node`     | Klass(es) only (when applicable)                                |
+| `@haklex/rich-compose/modules/<name>/renderer` | default renderer only                                           |
+| `@haklex/rich-compose/style.css`               | all-in-one CSS bundle — prose body + tokens + every module      |
+| `@haklex/rich-compose/style/foundation.css`    | prose body + theme tokens + variant classes (no modules)        |
+| `@haklex/rich-compose/style/table.css`         | built-in table renderer                                         |
+| `@haklex/rich-compose/style/<name>.css`        | per-module CSS (alert, banner, image, video, …)                 |
+
+Aggregate barrels are convenient defaults; the fine-grained `/modules/<name>` and `/modules/<name>/edit` subpaths stay available for dynamic-import and selective inclusion.
+
+## CSS strategy
+
+Two consumer patterns:
+
+**All-in-one (default).** One import covers everything `rich-compose` can render:
+
+```ts
+import '@haklex/rich-compose/style.css';
+```
+
+**Fine-grained (advanced).** Use this when you've overridden one or more default renderers and want to drop their CSS from your bundle. Import `foundation.css` plus the modules you keep — never reach into `rich-renderer-*` or `rich-ext-*` packages directly:
+
+```ts
+import '@haklex/rich-compose/style/foundation.css';
+import '@haklex/rich-compose/style/alert.css';
+import '@haklex/rich-compose/style/image.css';
+import '@haklex/rich-compose/style/ruby.css';
+// …only modules whose default renderer you kept
+```
+
+Module subpaths mirror the JS module subpaths (`modules/<name>` ↔ `style/<name>.css`).
+
+### Why not auto-injected via `import` side effects
+
+Earlier versions tried to side-effect-import each module's CSS from inside `modules/<name>/index.ts`. Combined with `sideEffects: ["**/*.css"]` (which marks `.mjs` files as side-effect-free) and bundler optimizations such as Next.js `optimizePackageImports`, those bare CSS imports were tree-shaken away — modules rendered but their styling was missing. The explicit subpath model above eliminates that footgun: the consumer states which CSS they want, and the bundler honors it deterministically.
 
 ## Part of Haklex
 

package/dist/core/compose-editor.d.ts

@@ -0,0 +1,5 @@
+import { RichEditorProps } from '@haklex/rich-editor';
+import { ComponentType } from 'react';
+import { ComposeEditorOptions } from './types';
+export declare function composeEditor(opts: ComposeEditorOptions): ComponentType<RichEditorProps>;
+//# sourceMappingURL=compose-editor.d.ts.map

package/dist/core/compose-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-editor.d.ts","sourceRoot":"","sources":["../../src/core/compose-editor.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,KAAK,aAAa,EAAwD,MAAM,OAAO,CAAC;AAKjG,OAAO,KAAK,EAAE,oBAAoB,EAAoB,MAAM,SAAS,CAAC;AAwCtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,aAAa,CAAC,eAAe,CAAC,CA2ExF"}

package/dist/core/dedup.d.ts

@@ -6,11 +6,12 @@ import { RichRendererModule } from './types';
  *   2. Same module.name → replace previous module entirely; warn in dev
  *   3. Else → append
  */
-export declare function mergeModules(preset: RichRendererModule[] | undefined, modules: RichRendererModule[] | undefined): RichRendererModule[];
+export declare function mergeModules<M extends RichRendererModule>(preset: M[] | undefined, modules: M[] | undefined): M[];
 /**
- * Dedup by class reference. Throws if two distinct Klasses share the same
- * `getType()` — multiple Klass instances will break `instanceof` checks
- * across module boundaries.
+ * Dedup by class reference. When two Klasses share the same `getType()`,
+ * a subclass relationship (edit Klass extends base Klass) auto-resolves:
+ * the subclass replaces its parent. Unrelated collisions throw — `instanceof`
+ * would break across module boundaries.
  */
 export declare function dedupNodes(nodes: Klass<LexicalNode>[]): Klass<LexicalNode>[];
 //# sourceMappingURL=dedup.d.ts.map

package/dist/core/dedup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../src/core/dedup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,kBAAkB,EAAE,GAAG,SAAS,EACxC,OAAO,EAAE,kBAAkB,EAAE,GAAG,SAAS,GACxC,kBAAkB,EAAE,CA0BtB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC,EAAE,CAyB5E"}
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../src/core/dedup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,kBAAkB,EACvD,MAAM,EAAE,CAAC,EAAE,GAAG,SAAS,EACvB,OAAO,EAAE,CAAC,EAAE,GAAG,SAAS,GACvB,CAAC,EAAE,CAyBL;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC,EAAE,CAwC5E"}

package/dist/core/index.d.ts

@@ -1,5 +1,6 @@
 export { composeRenderer } from './compose';
+export { composeEditor } from './compose-editor';
 export { dedupNodes, mergeModules } from './dedup';
 export { wrapLazy } from './lazy';
-export type { ComposeRendererOptions, RendererKey, RichRendererBaseProps, RichRendererModule, } from './types';
+export type { ComposeEditorOptions, ComposeRendererOptions, RendererKey, RichEditorModule, RichRendererBaseProps, RichRendererModule, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,YAAY,EACV,sBAAsB,EACtB,WAAW,EACX,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/core/types.d.ts

@@ -4,52 +4,39 @@ import { ComponentType, CSSProperties, ReactNode } from 'react';
 import { BuiltinNodeRenderer } from '../static-renderer/types';
 export type RendererKey = keyof RendererConfig;
 export interface RichRendererModule {
-    /**
-     * Lazy renderers. Each loader returns the renderer component as default
-     * export. composeRenderer wraps each in `React.lazy` (factory created
-     * once at compose time) + `<Suspense fallback={ssrFallback?.[type]}>`.
-     */
     lazyRenderers?: Partial<{
         [K in RendererKey]: () => Promise<{
             default: NonNullable<RendererConfig[K]>;
         }>;
     }>;
-    /** Stable identifier; used for dedup, debug logs, and Provider DevTools naming. */
     name: string;
-    /**
-     * Lexical node classes. Always synchronous. Optional — modules that only
-     * override renderers for Lexical builtin types omit this field.
-     * composeRenderer treats missing `nodes` as `[]`.
-     */
     nodes?: Klass<LexicalNode>[];
-    /**
-     * Optional context provider. composeRenderer stacks Providers in module
-     * order outside `<RichRenderer>`. Module Providers are for internal
-     * plumbing only — do not redeclare `NestedContentRendererProvider`,
-     * composeRenderer manages it.
-     */
     Provider?: ComponentType<{
         children: ReactNode;
     }>;
-    /** type → Component map. Sync renderers. */
     renderers?: Partial<RendererConfig>;
-    /**
-     * SSR / Suspense fallback. Must be deterministic — no Date.now, no random,
-     * no client-only API access. Renders identically server-side and during
-     * client hydration.
-     */
     ssrFallback?: Partial<Record<RendererKey, ReactNode>>;
 }
+export interface RichEditorModule extends RichRendererModule {
+    actions?: ReactNode;
+    editNodes?: Klass<LexicalNode>[];
+    EditorProvider?: ComponentType<{
+        children: ReactNode;
+    }>;
+    editRenderers?: Partial<RendererConfig>;
+    plugins?: ReactNode;
+}
 export interface ComposeRendererOptions {
-    /** Pass-through to `<RichRenderer>` for `paragraph` / `link` / `autolink` etc. */
     builtinNodeOverrides?: Record<string, BuiltinNodeRenderer>;
-    /** Appended to preset; later modules override earlier on `name` collision. */
     modules?: RichRendererModule[];
-    /** Final renderer overrides; takes precedence over module-supplied renderers. */
     overrides?: Partial<RendererConfig>;
-    /** Starting set; can be `shiroPreset`, custom array, or omitted. */
     preset?: RichRendererModule[];
 }
+export interface ComposeEditorOptions {
+    modules?: RichEditorModule[];
+    overrides?: Partial<RendererConfig>;
+    preset?: RichEditorModule[];
+}
 export interface RichRendererBaseProps {
     as?: keyof React.JSX.IntrinsicElements;
     className?: string;

package/dist/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;SACrB,CAAC,IAAI,WAAW,GAAG,MAAM,OAAO,CAAC;YAAE,OAAO,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAA;SAAE,CAAC;KAC/E,CAAC,CAAC;IAEH,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;IAE7B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;QAAE,QAAQ,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAElD,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAEpC;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,sBAAsB;IACrC,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC3D,8EAA8E;IAC9E,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,oEAAoE;IACpE,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;SACrB,CAAC,IAAI,WAAW,GAAG,MAAM,OAAO,CAAC;YAAE,OAAO,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAA;SAAE,CAAC;KAC/E,CAAC,CAAC;IACH,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,aAAa,CAAC;QAAE,QAAQ,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;IACjC,cAAc,CAAC,EAAE,aAAa,CAAC;QAAE,QAAQ,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IACxD,aAAa,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B"}

package/dist/editor.d.ts

@@ -0,0 +1,20 @@
+import { alertEditModule } from './modules/alert/edit';
+import { bannerEditModule } from './modules/banner/edit';
+import { chatEditModule } from './modules/chat/edit';
+import { codeBlockEditModule } from './modules/code-block/edit';
+import { codeSnippetEditModule } from './modules/code-snippet/edit';
+import { embedEditModule } from './modules/embed/edit';
+import { excalidrawEditModule } from './modules/excalidraw/edit';
+import { galleryEditModule } from './modules/gallery/edit';
+import { imageEditModule } from './modules/image/edit';
+import { katexEditModule } from './modules/katex/edit';
+import { linkCardEditModule } from './modules/link-card/edit';
+import { mentionEditModule } from './modules/mention/edit';
+import { mermaidEditModule } from './modules/mermaid/edit';
+import { nestedDocEditModule } from './modules/nested-doc/edit';
+import { pollEditModule } from './modules/poll/edit';
+import { rubyEditModule } from './modules/ruby/edit';
+import { videoEditModule } from './modules/video/edit';
+export { alertEditModule, bannerEditModule, chatEditModule, codeBlockEditModule, codeSnippetEditModule, embedEditModule, excalidrawEditModule, galleryEditModule, imageEditModule, katexEditModule, linkCardEditModule, mentionEditModule, mermaidEditModule, nestedDocEditModule, pollEditModule, rubyEditModule, videoEditModule, };
+export declare const allEditorModules: import('./core').RichEditorModule[];
+//# sourceMappingURL=editor.d.ts.map

package/dist/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,eAAe,GAChB,CAAC;AAEF,eAAO,MAAM,gBAAgB,qCAkB5B,CAAC"}

package/dist/editor.mjs

@@ -0,0 +1,39 @@
+import { alertEditModule } from "./modules/alert/edit.mjs";
+import { bannerEditModule } from "./modules/banner/edit.mjs";
+import { chatEditModule } from "./modules/chat/edit.mjs";
+import { codeBlockEditModule } from "./modules/code-block/edit.mjs";
+import { codeSnippetEditModule } from "./modules/code-snippet/edit.mjs";
+import { embedEditModule } from "./modules/embed/edit.mjs";
+import { excalidrawEditModule } from "./modules/excalidraw/edit.mjs";
+import { galleryEditModule } from "./modules/gallery/edit.mjs";
+import { imageEditModule } from "./modules/image/edit.mjs";
+import { katexEditModule } from "./modules/katex/edit.mjs";
+import { linkCardEditModule } from "./modules/link-card/edit.mjs";
+import { mentionEditModule } from "./modules/mention/edit.mjs";
+import { mermaidEditModule } from "./modules/mermaid/edit.mjs";
+import { nestedDocEditModule } from "./modules/nested-doc/edit.mjs";
+import { pollEditModule } from "./modules/poll/edit.mjs";
+import { rubyEditModule } from "./modules/ruby/edit.mjs";
+import { videoEditModule } from "./modules/video/edit.mjs";
+//#region src/editor.ts
+var allEditorModules = [
+	alertEditModule,
+	bannerEditModule,
+	chatEditModule,
+	codeBlockEditModule,
+	codeSnippetEditModule,
+	embedEditModule,
+	excalidrawEditModule,
+	galleryEditModule,
+	imageEditModule,
+	katexEditModule,
+	linkCardEditModule,
+	mentionEditModule,
+	mermaidEditModule,
+	nestedDocEditModule,
+	pollEditModule,
+	rubyEditModule,
+	videoEditModule
+];
+//#endregion
+export { alertEditModule, allEditorModules, bannerEditModule, chatEditModule, codeBlockEditModule, codeSnippetEditModule, embedEditModule, excalidrawEditModule, galleryEditModule, imageEditModule, katexEditModule, linkCardEditModule, mentionEditModule, mermaidEditModule, nestedDocEditModule, pollEditModule, rubyEditModule, videoEditModule };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export type { ComposeRendererOptions, RendererKey, RichRendererBaseProps, RichRendererModule, } from './core';
-export { composeRenderer, dedupNodes, mergeModules, wrapLazy } from './core';
+export type { ComposeEditorOptions, ComposeRendererOptions, RendererKey, RichEditorModule, RichRendererBaseProps, RichRendererModule, } from './core';
+export { composeEditor, composeRenderer, dedupNodes, mergeModules, wrapLazy } from './core';
 export type { BuiltinNodeRenderer, RichRendererProps } from './static-renderer';
 export { RichRenderer } from './static-renderer';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,WAAW,EACX,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC7E,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC5F,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}