@llui/markdown-editor 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Franco Ponticelli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__llui_deps.json

@@ -0,0 +1,252 @@
+{
+  "compilerVersion": "0.3.0",
+  "components": {},
+  "helpers": {
+    "editor#markdownEditor": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "reads": [
+            "changeDebounceMs",
+            "defaultValue",
+            "namespace",
+            "onChange",
+            "onFormatChange",
+            "placeholder",
+            "plugins",
+            "plugins.length",
+            "readOnly",
+            "theme",
+            "toolbar",
+            "value"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    },
+    "format#computeFormatState": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "shape": "opaque"
+        },
+        {
+          "index": 1,
+          "reads": [
+            "canRedo",
+            "canUndo"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    },
+    "plugins/callout#calloutPlugin": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "reads": [
+            "defaultKind"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    },
+    "plugins/emoji#emojiPlugin": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "reads": [
+            "emoji"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    },
+    "plugins/image#imagePlugin": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "reads": [
+            "upload"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    },
+    "plugins/link#linkPlugin": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "reads": [
+            "defaultUrl"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    },
+    "plugins/math#mathPlugin": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "reads": [
+            "render"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    },
+    "plugins/mention#mentionPlugin": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "reads": [
+            "source"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    },
+    "plugins/mermaid#mermaidPlugin": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "reads": [
+            "render"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    },
+    "plugins/overlay#overlayRoot": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "reads": [
+            "attrs",
+            "before",
+            "open",
+            "transform",
+            "x",
+            "y",
+            "zIndex"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    },
+    "plugins/ui#definePluginUI": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "reads": [
+            "init",
+            "onEffect",
+            "update",
+            "view"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    },
+    "state#init": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "reads": [
+            "readOnly",
+            "value",
+            "value.length"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    },
+    "state#update": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "shape": "opaque"
+        },
+        {
+          "index": 1,
+          "reads": [
+            "charCount",
+            "format",
+            "id",
+            "overlay",
+            "query",
+            "readOnly",
+            "type",
+            "value",
+            "wordCount",
+            "x",
+            "y"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    },
+    "surfaces/link-dialog#linkDialog": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "reads": [
+            "dialog",
+            "id",
+            "onDialog",
+            "url"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    },
+    "surfaces/toolbar#toolbar": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "reads": [
+            "aria-label",
+            "blockSelect",
+            "format",
+            "glyphs",
+            "groups",
+            "items",
+            "send"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    }
+  },
+  "version": 2
+}

package/dist/editor.d.ts

@@ -0,0 +1,42 @@
+import { type EditorThemeClasses, type LexicalEditor } from 'lexical';
+import { type Signal, type SignalComponentDef } from '@llui/dom';
+import type { CommandItem, MarkdownPlugin } from './plugins/types.js';
+import { type EditorEffect, type EditorMsg, type EditorState, type FormatState } from './state.js';
+export interface EditorConfig {
+    /** Plugins composing the feature set; order defines transformer precedence.
+     * Defaults to `[corePlugin(), linkPlugin()]` so the minimal editor has GFM + links. */
+    plugins?: readonly MarkdownPlugin[];
+    /** Initial markdown (uncontrolled seed). */
+    defaultValue?: string;
+    /** Controlled: the consumer owns this signal; the editor follows it. */
+    value?: Signal<string>;
+    /** Debounced markdown-emission window (ms). Default 300. */
+    changeDebounceMs?: number;
+    placeholder?: string;
+    readOnly?: boolean;
+    /** Lexical theme class map. */
+    theme?: EditorThemeClasses;
+    /** Editor namespace (instance isolation). */
+    namespace?: string;
+    /** Outbound markdown (after debounce). */
+    onChange?: (markdown: string) => void;
+    /** Outbound format surface (for chrome built outside this package). */
+    onFormatChange?: (format: FormatState) => void;
+    /** Receives the live Lexical editor at mount (imperative access, collab hooks). */
+    onReady?: (editor: LexicalEditor) => void;
+    /** Render the built-in toolbar above the editor. Default false (minimal). */
+    toolbar?: boolean;
+}
+/** Hooks the chrome layer (toolbar/menus) uses to compose around the editor. */
+export interface EditorParts {
+    /** The merged, surface-filtered command items. */
+    items: readonly CommandItem[];
+    /** Reactive format signal for `connect`-style toolbars. */
+    format: Signal<FormatState>;
+}
+/**
+ * Build the markdown editor component. Embed it with `mountApp(el, markdownEditor(...))`
+ * or compose it inside a larger component.
+ */
+export declare function markdownEditor(config?: EditorConfig): SignalComponentDef<EditorState, EditorMsg, EditorEffect>;
+//# 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":"AAMA,OAAO,EAA2B,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAA;AAM9F,OAAO,EAAmC,KAAK,MAAM,EAAE,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAUjG,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAKrE,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,SAAS,EAEd,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,YAAY;IAC3B;2FACuF;IACvF,OAAO,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;IACnC,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IACtB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,uEAAuE;IACvE,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IAC9C,mFAAmF;IACnF,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAA;IACzC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,KAAK,EAAE,SAAS,WAAW,EAAE,CAAA;IAC7B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;CAC5B;AAOD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,GAAE,YAAiB,GACxB,kBAAkB,CAAC,WAAW,EAAE,SAAS,EAAE,YAAY,CAAC,CAwJ1D"}

package/dist/editor.js

@@ -0,0 +1,157 @@
+// `markdownEditor(config)` — the high-level component. Lexical owns the live
+// document; this wires the foreign seam to the markdown transformer converters,
+// surfaces the format state for the chrome, routes command intents back to the
+// live editor through effects, and COMPOSES plugin UI extensions (each plugin's
+// state slice + reducer + view + effects) into the single component.
+import { $getRoot, $setSelection } from 'lexical';
+import { $convertFromMarkdownString, $convertToMarkdownString, registerMarkdownShortcuts, } from '@lexical/markdown';
+import { component, div } from '@llui/dom';
+import { lexicalForeign, registerDecoratorBridges, PROGRAMMATIC_TAG, } from '@llui/lexical';
+import { corePlugin } from './plugins/core.js';
+import { linkPlugin } from './plugins/link.js';
+import { toolbar as renderToolbar } from './surfaces/toolbar.js';
+import { buildTransformers } from './transformers/registry.js';
+import { computeFormatState } from './format.js';
+import { makeOnEffect } from './effects.js';
+import { countWords, init, update, } from './state.js';
+/** Default plugin set when the consumer supplies none. */
+function defaultPlugins() {
+    return [corePlugin(), linkPlugin()];
+}
+/**
+ * Build the markdown editor component. Embed it with `mountApp(el, markdownEditor(...))`
+ * or compose it inside a larger component.
+ */
+export function markdownEditor(config = {}) {
+    const plugins = config.plugins && config.plugins.length > 0 ? config.plugins : defaultPlugins();
+    const transformers = buildTransformers(plugins);
+    const items = plugins.flatMap((p) => p.items ?? []);
+    const itemsById = new Map(items.map((i) => [i.id, i]));
+    // Share the merged item list with plugins that want it (e.g. the slash menu).
+    for (const plugin of plugins)
+        plugin.onItems?.(items);
+    const decorators = plugins.flatMap((p) => p.decorators ?? []);
+    const pluginUIs = plugins
+        .filter((p) => p.ui !== undefined)
+        .map((p) => ({ name: p.name, ui: p.ui }));
+    const pluginUIByName = new Map(pluginUIs.map((p) => [p.name, p.ui]));
+    // The live editor, captured at mount; effects dispatch through it.
+    let editorRef = null;
+    const getEditor = () => editorRef;
+    const baseOnEffect = makeOnEffect(getEditor, itemsById, {
+        onChange: config.onChange,
+        onFormatChange: config.onFormatChange,
+        applyValue: (editor, value) => editor.update(() => {
+            $convertFromMarkdownString(value, transformers);
+            // Clear selection so the reconciler doesn't pull DOM focus into the
+            // editor on an external push (e.g. typing in a bound source textarea).
+            $setSelection(null);
+        }, { tag: PROGRAMMATIC_TAG }),
+    });
+    const seedValue = config.value ? config.value.peek() : (config.defaultValue ?? '');
+    // ── Composed TEA: core + plugin UI slices ──────────────────────────────────
+    const composedInit = () => {
+        const [core, effects] = init({ value: seedValue, readOnly: config.readOnly ?? false });
+        const slices = {};
+        for (const { name, ui } of pluginUIs)
+            slices[name] = ui.init();
+        return [{ ...core, plugins: slices }, effects];
+    };
+    const composedUpdate = (state, msg) => {
+        if (msg.type === 'plugin') {
+            const ui = pluginUIByName.get(msg.name);
+            if (!ui?.update)
+                return [state, []];
+            const result = ui.update(state.plugins[msg.name], msg.msg);
+            const [slice, effects] = (Array.isArray(result) ? result : [result, []]);
+            return [
+                { ...state, plugins: { ...state.plugins, [msg.name]: slice } },
+                effects.map((effect) => ({ type: 'pluginEffect', name: msg.name, effect })),
+            ];
+        }
+        return update(state, msg);
+    };
+    const composedOnEffect = (effect, api) => {
+        if (effect.type === 'pluginEffect') {
+            const ui = pluginUIByName.get(effect.name);
+            ui?.onEffect?.(effect.effect, {
+                editor: getEditor,
+                send: (msg) => api.send({ type: 'plugin', name: effect.name, msg }),
+                emit: (msg) => api.send(msg),
+            });
+            return;
+        }
+        baseOnEffect(effect, api);
+    };
+    const view = ({ state, send, }) => {
+        const host = lexicalForeign({
+            namespace: config.namespace ?? 'llui-markdown',
+            theme: config.theme,
+            plugins,
+            serialize: (editor) => editor.getEditorState().read(() => $convertToMarkdownString(transformers)),
+            deserialize: (_editor, value) => {
+                $convertFromMarkdownString(value, transformers);
+                $setSelection(null);
+            },
+            defaultValue: config.value ? undefined : (config.defaultValue ?? ''),
+            ...(config.value ? { value: config.value } : {}),
+            readOnly: state.at('readOnly'),
+            ...(config.changeDebounceMs !== undefined
+                ? { changeDebounceMs: config.changeDebounceMs }
+                : {}),
+            register: (editor) => {
+                const disposers = [registerMarkdownShortcuts(editor, transformers)];
+                if (decorators.length > 0)
+                    disposers.push(registerDecoratorBridges(editor, decorators));
+                return () => {
+                    for (const dispose of disposers)
+                        dispose();
+                };
+            },
+            onReady: (editor) => {
+                editorRef = editor;
+                if (config.placeholder) {
+                    editor.getRootElement()?.setAttribute('data-placeholder', config.placeholder);
+                }
+                config.onReady?.(editor);
+            },
+            onChange: (value) => send({ type: 'markdownChanged', value }),
+            onSelectionChange: (ctx) => {
+                const format = computeFormatState(ctx.editor, ctx);
+                const text = ctx.editor.getEditorState().read(() => $getRoot().getTextContent());
+                // Toggle an empty marker so CSS can show the placeholder.
+                ctx.editor.getRootElement()?.setAttribute('data-empty', text === '' ? 'true' : 'false');
+                send({ type: 'formatChanged', format, wordCount: countWords(text), charCount: text.length });
+            },
+            emit: (msg) => send(msg),
+        });
+        // Plugin view contributions (overlays/panels) — each gets its own slice + send.
+        const pluginViews = pluginUIs.flatMap(({ name, ui }) => {
+            if (!ui.view)
+                return [];
+            const rendered = ui.view({
+                state: state.at(`plugins.${name}`),
+                send: (msg) => send({ type: 'plugin', name, msg }),
+                editor: getEditor,
+            });
+            return Array.isArray(rendered) ? rendered : [rendered];
+        });
+        if (!config.toolbar)
+            return [host, ...pluginViews];
+        return [
+            div({ 'data-scope': 'md-editor', 'data-part': 'root' }, [
+                renderToolbar({ format: state.at('format'), send, items }),
+                div({ 'data-scope': 'md-editor', 'data-part': 'surface' }, [host]),
+            ]),
+            ...pluginViews,
+        ];
+    };
+    return component({
+        name: 'MarkdownEditor',
+        init: composedInit,
+        update: composedUpdate,
+        view,
+        onEffect: composedOnEffect,
+    });
+}
+//# sourceMappingURL=editor.js.map

package/dist/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.js","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"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","sourcesContent":["// `markdownEditor(config)` — the high-level component. Lexical owns the live\n// document; this wires the foreign seam to the markdown transformer converters,\n// surfaces the format state for the chrome, routes command intents back to the\n// live editor through effects, and COMPOSES plugin UI extensions (each plugin's\n// state slice + reducer + view + effects) into the single component.\n\nimport { $getRoot, $setSelection, type EditorThemeClasses, type LexicalEditor } from 'lexical'\nimport {\n  $convertFromMarkdownString,\n  $convertToMarkdownString,\n  registerMarkdownShortcuts,\n} from '@lexical/markdown'\nimport { component, div, type Renderable, type Signal, type SignalComponentDef } from '@llui/dom'\nimport {\n  lexicalForeign,\n  registerDecoratorBridges,\n  PROGRAMMATIC_TAG,\n  type DecoratorBridge,\n} from '@llui/lexical'\nimport { corePlugin } from './plugins/core.js'\nimport { linkPlugin } from './plugins/link.js'\nimport { toolbar as renderToolbar } from './surfaces/toolbar.js'\nimport type { CommandItem, MarkdownPlugin } from './plugins/types.js'\nimport type { PluginUI } from './plugins/ui.js'\nimport { buildTransformers } from './transformers/registry.js'\nimport { computeFormatState } from './format.js'\nimport { makeOnEffect } from './effects.js'\nimport {\n  countWords,\n  init,\n  update,\n  type EditorEffect,\n  type EditorMsg,\n  type EditorOutMsg,\n  type EditorState,\n  type FormatState,\n} from './state.js'\n\nexport interface EditorConfig {\n  /** Plugins composing the feature set; order defines transformer precedence.\n   * Defaults to `[corePlugin(), linkPlugin()]` so the minimal editor has GFM + links. */\n  plugins?: readonly MarkdownPlugin[]\n  /** Initial markdown (uncontrolled seed). */\n  defaultValue?: string\n  /** Controlled: the consumer owns this signal; the editor follows it. */\n  value?: Signal<string>\n  /** Debounced markdown-emission window (ms). Default 300. */\n  changeDebounceMs?: number\n  placeholder?: string\n  readOnly?: boolean\n  /** Lexical theme class map. */\n  theme?: EditorThemeClasses\n  /** Editor namespace (instance isolation). */\n  namespace?: string\n  /** Outbound markdown (after debounce). */\n  onChange?: (markdown: string) => void\n  /** Outbound format surface (for chrome built outside this package). */\n  onFormatChange?: (format: FormatState) => void\n  /** Receives the live Lexical editor at mount (imperative access, collab hooks). */\n  onReady?: (editor: LexicalEditor) => void\n  /** Render the built-in toolbar above the editor. Default false (minimal). */\n  toolbar?: boolean\n}\n\n/** Hooks the chrome layer (toolbar/menus) uses to compose around the editor. */\nexport interface EditorParts {\n  /** The merged, surface-filtered command items. */\n  items: readonly CommandItem[]\n  /** Reactive format signal for `connect`-style toolbars. */\n  format: Signal<FormatState>\n}\n\n/** Default plugin set when the consumer supplies none. */\nfunction defaultPlugins(): MarkdownPlugin[] {\n  return [corePlugin(), linkPlugin()]\n}\n\n/**\n * Build the markdown editor component. Embed it with `mountApp(el, markdownEditor(...))`\n * or compose it inside a larger component.\n */\nexport function markdownEditor(\n  config: EditorConfig = {},\n): SignalComponentDef<EditorState, EditorMsg, EditorEffect> {\n  const plugins = config.plugins && config.plugins.length > 0 ? config.plugins : defaultPlugins()\n  const transformers = buildTransformers(plugins)\n\n  const items: CommandItem[] = plugins.flatMap((p) => p.items ?? [])\n  const itemsById = new Map(items.map((i) => [i.id, i]))\n  // Share the merged item list with plugins that want it (e.g. the slash menu).\n  for (const plugin of plugins) plugin.onItems?.(items)\n  const decorators: DecoratorBridge[] = plugins.flatMap((p) => p.decorators ?? [])\n  const pluginUIs: Array<{ name: string; ui: PluginUI }> = plugins\n    .filter((p): p is MarkdownPlugin & { ui: PluginUI } => p.ui !== undefined)\n    .map((p) => ({ name: p.name, ui: p.ui }))\n  const pluginUIByName = new Map(pluginUIs.map((p) => [p.name, p.ui]))\n\n  // The live editor, captured at mount; effects dispatch through it.\n  let editorRef: LexicalEditor | null = null\n  const getEditor = (): LexicalEditor | null => editorRef\n\n  const baseOnEffect = makeOnEffect(getEditor, itemsById, {\n    onChange: config.onChange,\n    onFormatChange: config.onFormatChange,\n    applyValue: (editor, value) =>\n      editor.update(\n        () => {\n          $convertFromMarkdownString(value, transformers)\n          // Clear selection so the reconciler doesn't pull DOM focus into the\n          // editor on an external push (e.g. typing in a bound source textarea).\n          $setSelection(null)\n        },\n        { tag: PROGRAMMATIC_TAG },\n      ),\n  })\n\n  const seedValue = config.value ? config.value.peek() : (config.defaultValue ?? '')\n\n  // ── Composed TEA: core + plugin UI slices ──────────────────────────────────\n  const composedInit = (): [EditorState, EditorEffect[]] => {\n    const [core, effects] = init({ value: seedValue, readOnly: config.readOnly ?? false })\n    const slices: Record<string, unknown> = {}\n    for (const { name, ui } of pluginUIs) slices[name] = ui.init()\n    return [{ ...core, plugins: slices }, effects]\n  }\n\n  const composedUpdate = (state: EditorState, msg: EditorMsg): [EditorState, EditorEffect[]] => {\n    if (msg.type === 'plugin') {\n      const ui = pluginUIByName.get(msg.name)\n      if (!ui?.update) return [state, []]\n      const result = ui.update(state.plugins[msg.name], msg.msg)\n      const [slice, effects] = (Array.isArray(result) ? result : [result, []]) as [\n        unknown,\n        unknown[],\n      ]\n      return [\n        { ...state, plugins: { ...state.plugins, [msg.name]: slice } },\n        effects.map((effect) => ({ type: 'pluginEffect' as const, name: msg.name, effect })),\n      ]\n    }\n    return update(state, msg)\n  }\n\n  const composedOnEffect = (\n    effect: EditorEffect,\n    api: { send: (msg: EditorMsg) => void; state: Signal<EditorState> },\n  ): void => {\n    if (effect.type === 'pluginEffect') {\n      const ui = pluginUIByName.get(effect.name)\n      ui?.onEffect?.(effect.effect, {\n        editor: getEditor,\n        send: (msg) => api.send({ type: 'plugin', name: effect.name, msg }),\n        emit: (msg) => api.send(msg as EditorMsg),\n      })\n      return\n    }\n    baseOnEffect(effect, api)\n  }\n\n  const view = ({\n    state,\n    send,\n  }: {\n    state: Signal<EditorState>\n    send: (msg: EditorMsg) => void\n  }): Renderable => {\n    const host = lexicalForeign<EditorOutMsg>({\n      namespace: config.namespace ?? 'llui-markdown',\n      theme: config.theme,\n      plugins,\n      serialize: (editor) =>\n        editor.getEditorState().read(() => $convertToMarkdownString(transformers)),\n      deserialize: (_editor, value) => {\n        $convertFromMarkdownString(value, transformers)\n        $setSelection(null)\n      },\n      defaultValue: config.value ? undefined : (config.defaultValue ?? ''),\n      ...(config.value ? { value: config.value } : {}),\n      readOnly: state.at('readOnly'),\n      ...(config.changeDebounceMs !== undefined\n        ? { changeDebounceMs: config.changeDebounceMs }\n        : {}),\n      register: (editor) => {\n        const disposers = [registerMarkdownShortcuts(editor, transformers)]\n        if (decorators.length > 0) disposers.push(registerDecoratorBridges(editor, decorators))\n        return () => {\n          for (const dispose of disposers) dispose()\n        }\n      },\n      onReady: (editor) => {\n        editorRef = editor\n        if (config.placeholder) {\n          editor.getRootElement()?.setAttribute('data-placeholder', config.placeholder)\n        }\n        config.onReady?.(editor)\n      },\n      onChange: (value) => send({ type: 'markdownChanged', value }),\n      onSelectionChange: (ctx) => {\n        const format = computeFormatState(ctx.editor, ctx)\n        const text = ctx.editor.getEditorState().read(() => $getRoot().getTextContent())\n        // Toggle an empty marker so CSS can show the placeholder.\n        ctx.editor.getRootElement()?.setAttribute('data-empty', text === '' ? 'true' : 'false')\n        send({ type: 'formatChanged', format, wordCount: countWords(text), charCount: text.length })\n      },\n      emit: (msg) => send(msg),\n    })\n\n    // Plugin view contributions (overlays/panels) — each gets its own slice + send.\n    const pluginViews: Renderable = pluginUIs.flatMap(({ name, ui }) => {\n      if (!ui.view) return []\n      const rendered = ui.view({\n        state: state.at(`plugins.${name}`),\n        send: (msg) => send({ type: 'plugin', name, msg }),\n        editor: getEditor,\n      })\n      return Array.isArray(rendered) ? rendered : [rendered]\n    })\n\n    if (!config.toolbar) return [host, ...pluginViews]\n    return [\n      div({ 'data-scope': 'md-editor', 'data-part': 'root' }, [\n        renderToolbar({ format: state.at('format'), send, items }),\n        div({ 'data-scope': 'md-editor', 'data-part': 'surface' }, [host]),\n      ]),\n      ...pluginViews,\n    ]\n  }\n\n  return component<EditorState, EditorMsg, EditorEffect>({\n    name: 'MarkdownEditor',\n    init: composedInit,\n    update: composedUpdate,\n    view,\n    onEffect: composedOnEffect,\n  })\n}\n"]}

package/dist/effects.d.ts

@@ -0,0 +1,17 @@
+import type { LexicalEditor } from 'lexical';
+import type { CommandItem } from './plugins/types.js';
+import type { EditorEffect, EditorMsg, FormatState } from './state.js';
+/** The api the component passes to `onEffect` (send + state). */
+export interface EffectApi {
+    send: (msg: EditorMsg) => void;
+}
+export interface EffectConfig {
+    onChange?: (markdown: string) => void;
+    onFormatChange?: (format: FormatState) => void;
+    /** Push markdown into the live editor (deserialize), without echoing onChange. */
+    applyValue: (editor: LexicalEditor, value: string) => void;
+}
+/** Build the component's `onEffect`. `getEditor` returns the live editor (set at
+ * mount via the foreign `onReady`); `items` is the merged id → command map. */
+export declare function makeOnEffect(getEditor: () => LexicalEditor | null, items: ReadonlyMap<string, CommandItem>, config: EffectConfig): (effect: EditorEffect, api: EffectApi) => void;
+//# sourceMappingURL=effects.d.ts.map

package/dist/effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../src/effects.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEtE,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,CAAA;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IAC9C,kFAAkF;IAClF,UAAU,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAC3D;AAED;+EAC+E;AAC/E,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,aAAa,GAAG,IAAI,EACrC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,EACvC,MAAM,EAAE,YAAY,GACnB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,KAAK,IAAI,CAwBhD"}

package/dist/effects.js

@@ -0,0 +1,33 @@
+// Effect handler: the only place TEA reaches back into the live Lexical editor.
+// `execCommand` looks an id up in the merged command-item map and runs it on the
+// editor captured at mount; emit* forward to the consumer's callbacks.
+/** Build the component's `onEffect`. `getEditor` returns the live editor (set at
+ * mount via the foreign `onReady`); `items` is the merged id → command map. */
+export function makeOnEffect(getEditor, items, config) {
+    return (effect, api) => {
+        switch (effect.type) {
+            case 'execCommand': {
+                const editor = getEditor();
+                const item = items.get(effect.id);
+                if (editor && item)
+                    item.run(editor, { send: api.send });
+                return;
+            }
+            case 'applyValue': {
+                const editor = getEditor();
+                if (editor)
+                    config.applyValue(editor, effect.value);
+                return;
+            }
+            case 'emitChange': {
+                config.onChange?.(effect.value);
+                return;
+            }
+            case 'emitFormat': {
+                config.onFormatChange?.(effect.format);
+                return;
+            }
+        }
+    };
+}
+//# sourceMappingURL=effects.js.map

package/dist/effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.js","sourceRoot":"","sources":["../src/effects.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,iFAAiF;AACjF,uEAAuE;AAkBvE;+EAC+E;AAC/E,MAAM,UAAU,YAAY,CAC1B,SAAqC,EACrC,KAAuC,EACvC,MAAoB;IAEpB,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;QACrB,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;gBAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;gBACjC,IAAI,MAAM,IAAI,IAAI;oBAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;gBACxD,OAAM;YACR,CAAC;YACD,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;gBAC1B,IAAI,MAAM;oBAAE,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;gBACnD,OAAM;YACR,CAAC;YACD,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBAC/B,OAAM;YACR,CAAC;YACD,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;gBACtC,OAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC,CAAA;AACH,CAAC","sourcesContent":["// Effect handler: the only place TEA reaches back into the live Lexical editor.\n// `execCommand` looks an id up in the merged command-item map and runs it on the\n// editor captured at mount; emit* forward to the consumer's callbacks.\n\nimport type { LexicalEditor } from 'lexical'\nimport type { CommandItem } from './plugins/types.js'\nimport type { EditorEffect, EditorMsg, FormatState } from './state.js'\n\n/** The api the component passes to `onEffect` (send + state). */\nexport interface EffectApi {\n  send: (msg: EditorMsg) => void\n}\n\nexport interface EffectConfig {\n  onChange?: (markdown: string) => void\n  onFormatChange?: (format: FormatState) => void\n  /** Push markdown into the live editor (deserialize), without echoing onChange. */\n  applyValue: (editor: LexicalEditor, value: string) => void\n}\n\n/** Build the component's `onEffect`. `getEditor` returns the live editor (set at\n * mount via the foreign `onReady`); `items` is the merged id → command map. */\nexport function makeOnEffect(\n  getEditor: () => LexicalEditor | null,\n  items: ReadonlyMap<string, CommandItem>,\n  config: EffectConfig,\n): (effect: EditorEffect, api: EffectApi) => void {\n  return (effect, api) => {\n    switch (effect.type) {\n      case 'execCommand': {\n        const editor = getEditor()\n        const item = items.get(effect.id)\n        if (editor && item) item.run(editor, { send: api.send })\n        return\n      }\n      case 'applyValue': {\n        const editor = getEditor()\n        if (editor) config.applyValue(editor, effect.value)\n        return\n      }\n      case 'emitChange': {\n        config.onChange?.(effect.value)\n        return\n      }\n      case 'emitFormat': {\n        config.onFormatChange?.(effect.format)\n        return\n      }\n    }\n  }\n}\n"]}

package/dist/format.d.ts

@@ -0,0 +1,6 @@
+import { type LexicalEditor } from 'lexical';
+import type { SelectionContext } from '@llui/lexical';
+import { type FormatState } from './state.js';
+/** Read the full format surface at the current selection (opens a read ctx). */
+export declare function computeFormatState(editor: LexicalEditor, history: Pick<SelectionContext, 'canUndo' | 'canRedo'>): FormatState;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoC,KAAK,aAAa,EAAE,MAAM,SAAS,CAAA;AAM9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAgC,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAE3E,gFAAgF;AAChF,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,SAAS,CAAC,GACrD,WAAW,CAuCb"}

package/dist/format.js

@@ -0,0 +1,51 @@
+// Compute the full toolbar FormatState from a Lexical selection — the base
+// rich-text format (from @llui/lexical) refined with list/code/link detection
+// (which needs the list/code/link packages this layer depends on).
+import { $getSelection, $isRangeSelection } from 'lexical';
+import { $findMatchingParent, $getNearestNodeOfType } from '@lexical/utils';
+import { ListNode, $isListItemNode } from '@lexical/list';
+import { $isCodeNode } from '@lexical/code-core';
+import { $isLinkNode } from '@lexical/link';
+import { $readBaseFormat } from '@llui/lexical';
+import { EMPTY_FORMAT } from './state.js';
+/** Read the full format surface at the current selection (opens a read ctx). */
+export function computeFormatState(editor, history) {
+    return editor.getEditorState().read(() => {
+        const base = $readBaseFormat();
+        if (!base.hasSelection) {
+            return { ...EMPTY_FORMAT, canUndo: history.canUndo, canRedo: history.canRedo };
+        }
+        let blockType = base.blockType;
+        let link = false;
+        const selection = $getSelection();
+        if ($isRangeSelection(selection)) {
+            const anchorNode = selection.anchor.getNode();
+            link = $findMatchingParent(anchorNode, (node) => $isLinkNode(node)) !== null;
+            if (base.blockType === 'other') {
+                const listItem = $findMatchingParent(anchorNode, (node) => $isListItemNode(node));
+                if (listItem) {
+                    const list = $getNearestNodeOfType(anchorNode, ListNode);
+                    if (list)
+                        blockType = list.getListType();
+                }
+                else {
+                    const top = anchorNode.getKey() === 'root' ? null : anchorNode.getTopLevelElement();
+                    if (top && $isCodeNode(top))
+                        blockType = 'code';
+                }
+            }
+        }
+        return {
+            bold: base.bold,
+            italic: base.italic,
+            strikethrough: base.strikethrough,
+            code: base.code,
+            link,
+            blockType,
+            alignment: base.alignment,
+            canUndo: history.canUndo,
+            canRedo: history.canRedo,
+        };
+    });
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,8EAA8E;AAC9E,mEAAmE;AAEnE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAsB,MAAM,SAAS,CAAA;AAC9E,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAC3E,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,OAAO,EAAE,YAAY,EAAoC,MAAM,YAAY,CAAA;AAE3E,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAChC,MAAqB,EACrB,OAAsD;IAEtD,OAAO,MAAM,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QACvC,MAAM,IAAI,GAAG,eAAe,EAAE,CAAA;QAC9B,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,EAAE,GAAG,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAA;QAChF,CAAC;QAED,IAAI,SAAS,GAAc,IAAI,CAAC,SAAS,CAAA;QACzC,IAAI,IAAI,GAAG,KAAK,CAAA;QAEhB,MAAM,SAAS,GAAG,aAAa,EAAE,CAAA;QACjC,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAA;YAC7C,IAAI,GAAG,mBAAmB,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAA;YAE5E,IAAI,IAAI,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAA;gBACjF,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,IAAI,GAAG,qBAAqB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;oBACxD,IAAI,IAAI;wBAAE,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;gBAC1C,CAAC;qBAAM,CAAC;oBACN,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAA;oBACnF,IAAI,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC;wBAAE,SAAS,GAAG,MAAM,CAAA;gBACjD,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI;YACJ,SAAS;YACT,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC","sourcesContent":["// Compute the full toolbar FormatState from a Lexical selection — the base\n// rich-text format (from @llui/lexical) refined with list/code/link detection\n// (which needs the list/code/link packages this layer depends on).\n\nimport { $getSelection, $isRangeSelection, type LexicalEditor } from 'lexical'\nimport { $findMatchingParent, $getNearestNodeOfType } from '@lexical/utils'\nimport { ListNode, $isListItemNode } from '@lexical/list'\nimport { $isCodeNode } from '@lexical/code-core'\nimport { $isLinkNode } from '@lexical/link'\nimport { $readBaseFormat } from '@llui/lexical'\nimport type { SelectionContext } from '@llui/lexical'\nimport { EMPTY_FORMAT, type BlockType, type FormatState } from './state.js'\n\n/** Read the full format surface at the current selection (opens a read ctx). */\nexport function computeFormatState(\n  editor: LexicalEditor,\n  history: Pick<SelectionContext, 'canUndo' | 'canRedo'>,\n): FormatState {\n  return editor.getEditorState().read(() => {\n    const base = $readBaseFormat()\n    if (!base.hasSelection) {\n      return { ...EMPTY_FORMAT, canUndo: history.canUndo, canRedo: history.canRedo }\n    }\n\n    let blockType: BlockType = base.blockType\n    let link = false\n\n    const selection = $getSelection()\n    if ($isRangeSelection(selection)) {\n      const anchorNode = selection.anchor.getNode()\n      link = $findMatchingParent(anchorNode, (node) => $isLinkNode(node)) !== null\n\n      if (base.blockType === 'other') {\n        const listItem = $findMatchingParent(anchorNode, (node) => $isListItemNode(node))\n        if (listItem) {\n          const list = $getNearestNodeOfType(anchorNode, ListNode)\n          if (list) blockType = list.getListType()\n        } else {\n          const top = anchorNode.getKey() === 'root' ? null : anchorNode.getTopLevelElement()\n          if (top && $isCodeNode(top)) blockType = 'code'\n        }\n      }\n    }\n\n    return {\n      bold: base.bold,\n      italic: base.italic,\n      strikethrough: base.strikethrough,\n      code: base.code,\n      link,\n      blockType,\n      alignment: base.alignment,\n      canUndo: history.canUndo,\n      canRedo: history.canRedo,\n    }\n  })\n}\n"]}