@llui/lexical 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,78 @@
+{
+  "compilerVersion": "0.3.0",
+  "components": {},
+  "helpers": {
+    "foreign#lexicalForeign": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "reads": [
+            "changeDebounceMs",
+            "defaultValue",
+            "namespace",
+            "nodes",
+            "onError",
+            "plugins",
+            "readOnly",
+            "theme",
+            "value"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    },
+    "register#matchesCombo": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "reads": [
+            "altKey",
+            "ctrlKey",
+            "key",
+            "key.length",
+            "metaKey",
+            "shiftKey"
+          ],
+          "shape": "state-value"
+        },
+        {
+          "index": 1,
+          "reads": [
+            "alt",
+            "ctrl",
+            "key",
+            "mod",
+            "shift"
+          ],
+          "shape": "state-value"
+        },
+        {
+          "index": 2,
+          "shape": "opaque"
+        }
+      ]
+    },
+    "register#registerShortcuts": {
+      "helperLocalPaths": [],
+      "kind": "view-helper",
+      "viaParams": [
+        {
+          "index": 0,
+          "shape": "opaque"
+        },
+        {
+          "index": 1,
+          "reads": [
+            "length"
+          ],
+          "shape": "state-value"
+        }
+      ]
+    }
+  },
+  "version": 2
+}

package/dist/decorator.d.ts

@@ -0,0 +1,40 @@
+import { DecoratorNode, type DOMConversionMap, type EditorConfig, type LexicalEditor, type LexicalNode, type NodeKey, type SerializedLexicalNode, type Spread } from 'lexical';
+import type { DecoratorBridge } from './plugin.js';
+export type SerializedLLuiDecoratorNode = Spread<{
+    bridgeType: string;
+    data: unknown;
+}, SerializedLexicalNode>;
+/** A generic decorator node that mounts an LLui sub-view via a registered
+ * {@link DecoratorBridge}. */
+export declare class LLuiDecoratorNode extends DecoratorNode<HTMLElement> {
+    __bridgeType: string;
+    __data: unknown;
+    static getType(): string;
+    static clone(node: LLuiDecoratorNode): LLuiDecoratorNode;
+    constructor(bridgeType: string, data: unknown, key?: NodeKey);
+    createDOM(_config: EditorConfig): HTMLElement;
+    updateDOM(): false;
+    /** LLui decorators are block-level (callouts, math/mermaid blocks, embeds). */
+    isInline(): false;
+    static importDOM(): DOMConversionMap | null;
+    /** The bridge type id this node renders (used by markdown transformers). */
+    getBridgeType(): string;
+    /** Read the latest serialized data (for the sub-view). */
+    getData(): unknown;
+    /** Persist new data into the node (markdown-serializable). */
+    setData(data: unknown): void;
+    decorate(editor: LexicalEditor): HTMLElement;
+    exportJSON(): SerializedLLuiDecoratorNode;
+    static importJSON(json: SerializedLLuiDecoratorNode): LLuiDecoratorNode;
+}
+/** Create a decorator node for `bridgeType` carrying `data`. */
+export declare function $createLLuiDecoratorNode(bridgeType: string, data: unknown): LLuiDecoratorNode;
+export declare function $isLLuiDecoratorNode(node: LexicalNode | null | undefined): node is LLuiDecoratorNode;
+/**
+ * Wire decorator bridges onto an editor: register the bridge registry, place
+ * each decoration element into its node's DOM, and dispose sub-apps when their
+ * nodes are destroyed. Returns a disposer that tears down all live sub-apps.
+ * Typically called from a plugin's `register`.
+ */
+export declare function registerDecoratorBridges(editor: LexicalEditor, bridges: readonly DecoratorBridge[]): () => void;
+//# sourceMappingURL=decorator.d.ts.map

package/dist/decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator.d.ts","sourceRoot":"","sources":["../src/decorator.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,qBAAqB,EAC1B,KAAK,MAAM,EACZ,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EAAgB,eAAe,EAAE,MAAM,aAAa,CAAA;AAEhE,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAC9C;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,EACrC,qBAAqB,CACtB,CAAA;AAcD;8BAC8B;AAC9B,qBAAa,iBAAkB,SAAQ,aAAa,CAAC,WAAW,CAAC;IAC/D,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,OAAO,CAAA;WAEC,OAAO,IAAI,MAAM;WAIjB,KAAK,CAAC,IAAI,EAAE,iBAAiB,GAAG,iBAAiB;gBAIrD,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO;IAMnD,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IAM7C,SAAS,IAAI,KAAK;IAI3B,+EAA+E;IACtE,QAAQ,IAAI,KAAK;WAIV,SAAS,IAAI,gBAAgB,GAAG,IAAI;IAIpD,4EAA4E;IAC5E,aAAa,IAAI,MAAM;IAIvB,0DAA0D;IAC1D,OAAO,IAAI,OAAO;IAIlB,8DAA8D;IAC9D,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAInB,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW;IAsB5C,UAAU,IAAI,2BAA2B;WAUlC,UAAU,CAAC,IAAI,EAAE,2BAA2B,GAAG,iBAAiB;CAGjF;AAED,gEAAgE;AAChE,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAE7F;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GACnC,IAAI,IAAI,iBAAiB,CAE3B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,SAAS,eAAe,EAAE,GAClC,MAAM,IAAI,CAqCZ"}

package/dist/decorator.js

@@ -0,0 +1,147 @@
+// The DecoratorNode ↔ LLui sub-view bridge.
+//
+// `LLuiDecoratorNode` is a single generic node class: it stores a `bridgeType`
+// + serialized `data` (so it round-trips through markdown) and, when decorated,
+// mounts the matching {@link DecoratorBridge}'s LLui sub-app into its DOM. Each
+// sub-app is an independent TEA loop with its own `send`/state. Registries and
+// live mount disposers are keyed per-editor (no module-global mutable state, so
+// multiple editors and SSR stay isolated).
+import { $getNodeByKey, DecoratorNode, } from 'lexical';
+const REGISTRIES = new WeakMap();
+const MOUNTS = new WeakMap();
+function mountsFor(editor) {
+    let mounts = MOUNTS.get(editor);
+    if (!mounts) {
+        mounts = new Map();
+        MOUNTS.set(editor, mounts);
+    }
+    return mounts;
+}
+/** A generic decorator node that mounts an LLui sub-view via a registered
+ * {@link DecoratorBridge}. */
+export class LLuiDecoratorNode extends DecoratorNode {
+    __bridgeType;
+    __data;
+    static getType() {
+        return 'llui-decorator';
+    }
+    static clone(node) {
+        return new LLuiDecoratorNode(node.__bridgeType, node.__data, node.__key);
+    }
+    constructor(bridgeType, data, key) {
+        super(key);
+        this.__bridgeType = bridgeType;
+        this.__data = data;
+    }
+    createDOM(_config) {
+        const el = document.createElement('div');
+        el.setAttribute('data-llui-decorator', this.__bridgeType);
+        return el;
+    }
+    updateDOM() {
+        return false;
+    }
+    /** LLui decorators are block-level (callouts, math/mermaid blocks, embeds). */
+    isInline() {
+        return false;
+    }
+    static importDOM() {
+        return null;
+    }
+    /** The bridge type id this node renders (used by markdown transformers). */
+    getBridgeType() {
+        return this.getLatest().__bridgeType;
+    }
+    /** Read the latest serialized data (for the sub-view). */
+    getData() {
+        return this.getLatest().__data;
+    }
+    /** Persist new data into the node (markdown-serializable). */
+    setData(data) {
+        this.getWritable().__data = data;
+    }
+    decorate(editor) {
+        const container = document.createElement('div');
+        const bridge = REGISTRIES.get(editor)?.get(this.__bridgeType);
+        if (!bridge)
+            return container;
+        const key = this.getKey();
+        const api = {
+            editor,
+            update: (next) => editor.update(() => {
+                const node = $getNodeByKey(key);
+                if ($isLLuiDecoratorNode(node))
+                    node.setData(next);
+            }),
+        };
+        const mounts = mountsFor(editor);
+        // Re-decoration (data change): tear the previous sub-app down first.
+        mounts.get(key)?.();
+        mounts.set(key, bridge.mount(container, this.getData(), api));
+        return container;
+    }
+    exportJSON() {
+        return {
+            ...super.exportJSON(),
+            type: 'llui-decorator',
+            version: 1,
+            bridgeType: this.__bridgeType,
+            data: this.__data,
+        };
+    }
+    static importJSON(json) {
+        return new LLuiDecoratorNode(json.bridgeType, json.data);
+    }
+}
+/** Create a decorator node for `bridgeType` carrying `data`. */
+export function $createLLuiDecoratorNode(bridgeType, data) {
+    return new LLuiDecoratorNode(bridgeType, data);
+}
+export function $isLLuiDecoratorNode(node) {
+    return node instanceof LLuiDecoratorNode;
+}
+/**
+ * Wire decorator bridges onto an editor: register the bridge registry, place
+ * each decoration element into its node's DOM, and dispose sub-apps when their
+ * nodes are destroyed. Returns a disposer that tears down all live sub-apps.
+ * Typically called from a plugin's `register`.
+ */
+export function registerDecoratorBridges(editor, bridges) {
+    // Merge into any existing registry so multiple decorator plugins compose.
+    const registry = REGISTRIES.get(editor) ?? new Map();
+    for (const bridge of bridges)
+        registry.set(bridge.type, bridge);
+    REGISTRIES.set(editor, registry);
+    const unregisterDecorator = editor.registerDecoratorListener((decorators) => {
+        for (const key of Object.keys(decorators)) {
+            const decoration = decorators[key];
+            const host = editor.getElementByKey(key);
+            if (host && decoration && decoration.parentElement !== host) {
+                host.replaceChildren(decoration);
+            }
+        }
+    });
+    const unregisterMutation = editor.registerMutationListener(LLuiDecoratorNode, (mutations) => {
+        const mounts = MOUNTS.get(editor);
+        if (!mounts)
+            return;
+        for (const [key, kind] of mutations) {
+            if (kind === 'destroyed') {
+                mounts.get(key)?.();
+                mounts.delete(key);
+            }
+        }
+    });
+    return () => {
+        unregisterDecorator();
+        unregisterMutation();
+        const mounts = MOUNTS.get(editor);
+        if (mounts) {
+            for (const dispose of mounts.values())
+                dispose();
+            mounts.clear();
+        }
+        REGISTRIES.delete(editor);
+    };
+}
+//# sourceMappingURL=decorator.js.map

package/dist/decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator.js","sourceRoot":"","sources":["../src/decorator.ts"],"names":[],"mappings":"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","sourcesContent":["// The DecoratorNode ↔ LLui sub-view bridge.\n//\n// `LLuiDecoratorNode` is a single generic node class: it stores a `bridgeType`\n// + serialized `data` (so it round-trips through markdown) and, when decorated,\n// mounts the matching {@link DecoratorBridge}'s LLui sub-app into its DOM. Each\n// sub-app is an independent TEA loop with its own `send`/state. Registries and\n// live mount disposers are keyed per-editor (no module-global mutable state, so\n// multiple editors and SSR stay isolated).\n\nimport {\n  $getNodeByKey,\n  DecoratorNode,\n  type DOMConversionMap,\n  type EditorConfig,\n  type LexicalEditor,\n  type LexicalNode,\n  type NodeKey,\n  type SerializedLexicalNode,\n  type Spread,\n} from 'lexical'\nimport type { DecoratorApi, DecoratorBridge } from './plugin.js'\n\nexport type SerializedLLuiDecoratorNode = Spread<\n  { bridgeType: string; data: unknown },\n  SerializedLexicalNode\n>\n\nconst REGISTRIES = new WeakMap<LexicalEditor, Map<string, DecoratorBridge>>()\nconst MOUNTS = new WeakMap<LexicalEditor, Map<NodeKey, () => void>>()\n\nfunction mountsFor(editor: LexicalEditor): Map<NodeKey, () => void> {\n  let mounts = MOUNTS.get(editor)\n  if (!mounts) {\n    mounts = new Map()\n    MOUNTS.set(editor, mounts)\n  }\n  return mounts\n}\n\n/** A generic decorator node that mounts an LLui sub-view via a registered\n * {@link DecoratorBridge}. */\nexport class LLuiDecoratorNode extends DecoratorNode<HTMLElement> {\n  __bridgeType: string\n  __data: unknown\n\n  static override getType(): string {\n    return 'llui-decorator'\n  }\n\n  static override clone(node: LLuiDecoratorNode): LLuiDecoratorNode {\n    return new LLuiDecoratorNode(node.__bridgeType, node.__data, node.__key)\n  }\n\n  constructor(bridgeType: string, data: unknown, key?: NodeKey) {\n    super(key)\n    this.__bridgeType = bridgeType\n    this.__data = data\n  }\n\n  override createDOM(_config: EditorConfig): HTMLElement {\n    const el = document.createElement('div')\n    el.setAttribute('data-llui-decorator', this.__bridgeType)\n    return el\n  }\n\n  override updateDOM(): false {\n    return false\n  }\n\n  /** LLui decorators are block-level (callouts, math/mermaid blocks, embeds). */\n  override isInline(): false {\n    return false\n  }\n\n  static override importDOM(): DOMConversionMap | null {\n    return null\n  }\n\n  /** The bridge type id this node renders (used by markdown transformers). */\n  getBridgeType(): string {\n    return this.getLatest().__bridgeType\n  }\n\n  /** Read the latest serialized data (for the sub-view). */\n  getData(): unknown {\n    return this.getLatest().__data\n  }\n\n  /** Persist new data into the node (markdown-serializable). */\n  setData(data: unknown): void {\n    this.getWritable().__data = data\n  }\n\n  override decorate(editor: LexicalEditor): HTMLElement {\n    const container = document.createElement('div')\n    const bridge = REGISTRIES.get(editor)?.get(this.__bridgeType)\n    if (!bridge) return container\n\n    const key = this.getKey()\n    const api: DecoratorApi<unknown> = {\n      editor,\n      update: (next) =>\n        editor.update(() => {\n          const node = $getNodeByKey(key)\n          if ($isLLuiDecoratorNode(node)) node.setData(next)\n        }),\n    }\n\n    const mounts = mountsFor(editor)\n    // Re-decoration (data change): tear the previous sub-app down first.\n    mounts.get(key)?.()\n    mounts.set(key, bridge.mount(container, this.getData(), api))\n    return container\n  }\n\n  override exportJSON(): SerializedLLuiDecoratorNode {\n    return {\n      ...super.exportJSON(),\n      type: 'llui-decorator',\n      version: 1,\n      bridgeType: this.__bridgeType,\n      data: this.__data,\n    }\n  }\n\n  static override importJSON(json: SerializedLLuiDecoratorNode): LLuiDecoratorNode {\n    return new LLuiDecoratorNode(json.bridgeType, json.data)\n  }\n}\n\n/** Create a decorator node for `bridgeType` carrying `data`. */\nexport function $createLLuiDecoratorNode(bridgeType: string, data: unknown): LLuiDecoratorNode {\n  return new LLuiDecoratorNode(bridgeType, data)\n}\n\nexport function $isLLuiDecoratorNode(\n  node: LexicalNode | null | undefined,\n): node is LLuiDecoratorNode {\n  return node instanceof LLuiDecoratorNode\n}\n\n/**\n * Wire decorator bridges onto an editor: register the bridge registry, place\n * each decoration element into its node's DOM, and dispose sub-apps when their\n * nodes are destroyed. Returns a disposer that tears down all live sub-apps.\n * Typically called from a plugin's `register`.\n */\nexport function registerDecoratorBridges(\n  editor: LexicalEditor,\n  bridges: readonly DecoratorBridge[],\n): () => void {\n  // Merge into any existing registry so multiple decorator plugins compose.\n  const registry = REGISTRIES.get(editor) ?? new Map<string, DecoratorBridge>()\n  for (const bridge of bridges) registry.set(bridge.type, bridge)\n  REGISTRIES.set(editor, registry)\n\n  const unregisterDecorator = editor.registerDecoratorListener<HTMLElement>((decorators) => {\n    for (const key of Object.keys(decorators)) {\n      const decoration = decorators[key]\n      const host = editor.getElementByKey(key)\n      if (host && decoration && decoration.parentElement !== host) {\n        host.replaceChildren(decoration)\n      }\n    }\n  })\n\n  const unregisterMutation = editor.registerMutationListener(LLuiDecoratorNode, (mutations) => {\n    const mounts = MOUNTS.get(editor)\n    if (!mounts) return\n    for (const [key, kind] of mutations) {\n      if (kind === 'destroyed') {\n        mounts.get(key)?.()\n        mounts.delete(key)\n      }\n    }\n  })\n\n  return () => {\n    unregisterDecorator()\n    unregisterMutation()\n    const mounts = MOUNTS.get(editor)\n    if (mounts) {\n      for (const dispose of mounts.values()) dispose()\n      mounts.clear()\n    }\n    REGISTRIES.delete(editor)\n  }\n}\n"]}

package/dist/foreign.d.ts

@@ -0,0 +1,48 @@
+import { type EditorThemeClasses, type Klass, type LexicalEditor, type LexicalNode } from 'lexical';
+import { type Mountable, type Signal } from '@llui/dom';
+import type { LexicalPlugin } from './plugin.js';
+/** Lexical update tag marking a programmatic write (seed / controlled setValue),
+ * so the outbound change listener doesn't echo it back to the host. */
+export declare const PROGRAMMATIC_TAG = "@llui/lexical:programmatic";
+/** Context handed to the selection callback on every commit. */
+export interface SelectionContext {
+    editor: LexicalEditor;
+    canUndo: boolean;
+    canRedo: boolean;
+}
+export interface LexicalForeignOptions<Emit = unknown> {
+    /** Editor namespace (instance isolation; required for distinct editors). */
+    namespace: string;
+    theme?: EditorThemeClasses;
+    /** Node classes registered in addition to the plugins' own nodes. */
+    nodes?: ReadonlyArray<Klass<LexicalNode>>;
+    /** Plugins: their `nodes` are merged, `register`/`shortcuts` wired at mount. */
+    plugins?: ReadonlyArray<LexicalPlugin<Emit>>;
+    /** Serialize the live document → string (runs in a read context). */
+    serialize: (editor: LexicalEditor) => string;
+    /** Deserialize a string into the document (runs in an update context). */
+    deserialize: (editor: LexicalEditor, value: string) => void;
+    /** Initial document (uncontrolled) — ignored when `value` is provided. */
+    defaultValue?: string;
+    /** Controlled document signal; the editor follows it (echo-guarded). */
+    value?: Signal<string>;
+    /** Reactive read-only flag (always supplied by the host's state). */
+    readOnly: Signal<boolean>;
+    /** Debounce window (ms) for outbound serialization. Default 300. */
+    changeDebounceMs?: number;
+    /** Outbound: serialized document changed (debounced, real edits only). */
+    onChange?: (value: string) => void;
+    /** Outbound: selection / format / structure changed (every commit). */
+    onSelectionChange?: (ctx: SelectionContext) => void;
+    /** Host emit, handed to each plugin's `register` context. */
+    emit?: (msg: Emit) => void;
+    /** Receives the live editor at mount (host dispatches commands through it). */
+    onReady?: (editor: LexicalEditor) => void;
+    /** Extra registration after rich-text (e.g. markdown shortcuts). Disposer. */
+    register?: (editor: LexicalEditor) => () => void;
+    onError?: (error: Error) => void;
+}
+/** Mount Lexical into an LLui view. Returns a `Mountable` placed in the view
+ * array; Lexical is created on mount and destroyed on the component's dispose. */
+export declare function lexicalForeign<Emit = unknown>(opts: LexicalForeignOptions<Emit>): Mountable;
+//# sourceMappingURL=foreign.d.ts.map

package/dist/foreign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreign.d.ts","sourceRoot":"","sources":["../src/foreign.ts"],"names":[],"mappings":"AASA,OAAO,EAKL,KAAK,kBAAkB,EACvB,KAAK,KAAK,EACV,KAAK,aAAa,EAClB,KAAK,WAAW,EACjB,MAAM,SAAS,CAAA;AAIhB,OAAO,EAAW,KAAK,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,aAAa,CAAA;AAG/D;uEACuE;AACvE,eAAO,MAAM,gBAAgB,+BAA+B,CAAA;AAE5D,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,CAAA;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,qBAAqB,CAAC,IAAI,GAAG,OAAO;IACnD,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,qEAAqE;IACrE,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAA;IACzC,gFAAgF;IAChF,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAA;IAC5C,qEAAqE;IACrE,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,CAAA;IAC5C,0EAA0E;IAC1E,WAAW,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3D,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IACtB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IACzB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,CAAA;IACnD,6DAA6D;IAC7D,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,IAAI,CAAA;IAC1B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAA;IACzC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,IAAI,CAAA;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CACjC;AAgBD;kFACkF;AAClF,wBAAgB,cAAc,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC,GAAG,SAAS,CA4J3F"}

package/dist/foreign.js

@@ -0,0 +1,156 @@
+// The load-bearing seam: mount a Lexical editor inside an LLui view via
+// `foreign()`. Lexical owns the contentEditable subtree; LLui owns the chrome.
+//
+// Inbound (controlled): a `value` signal drives the document, echo-suppressed so
+// the editor never fights its own emissions. Outbound: a debounced
+// update-listener serializes the document and a synchronous one surfaces the
+// selection/format. Serialize/deserialize are injected so this stays
+// markdown-agnostic — the markdown layer supplies the transformer converters.
+import { CAN_REDO_COMMAND, CAN_UNDO_COMMAND, COMMAND_PRIORITY_LOW, createEditor, } from 'lexical';
+import { registerRichText } from '@lexical/rich-text';
+import { registerHistory, createEmptyHistoryState } from '@lexical/history';
+import { mergeRegister } from '@lexical/utils';
+import { foreign } from '@llui/dom';
+import { registerShortcuts } from './register.js';
+/** Lexical update tag marking a programmatic write (seed / controlled setValue),
+ * so the outbound change listener doesn't echo it back to the host. */
+export const PROGRAMMATIC_TAG = '@llui/lexical:programmatic';
+/** Mount Lexical into an LLui view. Returns a `Mountable` placed in the view
+ * array; Lexical is created on mount and destroyed on the component's dispose. */
+export function lexicalForeign(opts) {
+    const debounceMs = opts.changeDebounceMs ?? 300;
+    const boot = (el) => {
+        // De-duplicate node classes by reference: registering the same Klass twice
+        // (e.g. two decorator plugins sharing LLuiDecoratorNode) throws in Lexical.
+        const nodeSet = new Set(opts.nodes ?? []);
+        for (const plugin of opts.plugins ?? []) {
+            for (const node of plugin.nodes ?? [])
+                nodeSet.add(node);
+        }
+        const nodes = [...nodeSet];
+        const editor = createEditor({
+            namespace: opts.namespace,
+            nodes,
+            theme: opts.theme,
+            editable: !opts.readOnly.peek(),
+            onError: (error) => {
+                if (opts.onError)
+                    opts.onError(error);
+                else
+                    throw error;
+            },
+        });
+        // Vanilla Lexical does NOT make the root editable — the caller must set
+        // `contenteditable` (the React `<ContentEditable>` does this). Without it the
+        // browser shows no caret and ignores typing.
+        el.setAttribute('contenteditable', opts.readOnly.peek() ? 'false' : 'true');
+        editor.setRootElement(el);
+        opts.onReady?.(editor);
+        let lastEmitted = opts.value ? opts.value.peek() : (opts.defaultValue ?? '');
+        let canUndo = false;
+        let canRedo = false;
+        let debounceTimer;
+        // Seed the initial document (programmatic — not echoed outbound). Discrete so
+        // the host is populated synchronously at mount (before the first paint/read).
+        // NB: seeding happens AFTER registration below, so plugins/decorator bridges
+        // are live when the seed document is built (e.g. a callout in the seed needs
+        // its bridge registered to decorate).
+        const ctx = { emit: (msg) => opts.emit?.(msg) };
+        const pluginDisposers = (opts.plugins ?? []).map((plugin) => {
+            const reg = plugin.register?.(editor, ctx) ?? (() => { });
+            const shortcuts = plugin.shortcuts ? registerShortcuts(editor, plugin.shortcuts) : () => { };
+            return () => {
+                reg();
+                shortcuts();
+            };
+        });
+        const emitSelection = () => opts.onSelectionChange?.({ editor, canUndo, canRedo });
+        const baseDispose = mergeRegister(registerRichText(editor), registerHistory(editor, createEmptyHistoryState(), 1000), opts.register?.(editor) ?? (() => { }), editor.registerCommand(CAN_UNDO_COMMAND, (payload) => {
+            canUndo = payload;
+            emitSelection();
+            return false;
+        }, COMMAND_PRIORITY_LOW), editor.registerCommand(CAN_REDO_COMMAND, (payload) => {
+            canRedo = payload;
+            emitSelection();
+            return false;
+        }, COMMAND_PRIORITY_LOW), editor.registerUpdateListener(({ editorState, tags }) => {
+            emitSelection();
+            if (tags.has(PROGRAMMATIC_TAG))
+                return;
+            if (debounceTimer !== undefined)
+                clearTimeout(debounceTimer);
+            debounceTimer = setTimeout(() => {
+                editorState.read(() => {
+                    const next = opts.serialize(editor);
+                    lastEmitted = next;
+                    opts.onChange?.(next);
+                });
+            }, debounceMs);
+        }), ...pluginDisposers);
+        // Seed now that rich-text, history, plugins, and decorator bridges are live.
+        editor.update(() => opts.deserialize(editor, lastEmitted), {
+            tag: PROGRAMMATIC_TAG,
+            discrete: true,
+        });
+        return {
+            editor,
+            getLastEmitted: () => lastEmitted,
+            setLastEmitted: (value) => {
+                lastEmitted = value;
+            },
+            dispose: () => {
+                if (debounceTimer !== undefined)
+                    clearTimeout(debounceTimer);
+                baseDispose();
+            },
+        };
+    };
+    const readOnly = opts.readOnly;
+    const controlled = opts.value;
+    if (controlled) {
+        return foreign({
+            tag: 'div',
+            state: { value: controlled, readOnly },
+            mount: ({ el, state }) => {
+                const b = boot(el);
+                const unbindValue = state.value.bind((incoming) => {
+                    if (incoming === b.getLastEmitted())
+                        return;
+                    b.editor.update(() => opts.deserialize(b.editor, incoming), { tag: PROGRAMMATIC_TAG });
+                    b.setLastEmitted(incoming);
+                });
+                const unbindReadOnly = state.readOnly.bind((ro) => {
+                    b.editor.setEditable(!ro);
+                    el.setAttribute('contenteditable', ro ? 'false' : 'true');
+                });
+                return {
+                    dispose: () => {
+                        unbindValue();
+                        unbindReadOnly();
+                        b.dispose();
+                    },
+                };
+            },
+            unmount: (inst) => inst.dispose(),
+        });
+    }
+    return foreign({
+        tag: 'div',
+        state: { readOnly },
+        mount: ({ el, state }) => {
+            const b = boot(el);
+            const unbindReadOnly = state.readOnly.bind((ro) => {
+                b.editor.setEditable(!ro);
+                el.contentEditable = ro ? 'false' : 'true';
+            });
+            return {
+                dispose: () => {
+                    unbindReadOnly();
+                    b.dispose();
+                },
+            };
+        },
+        unmount: (inst) => inst.dispose(),
+    });
+}
+//# sourceMappingURL=foreign.js.map

package/dist/foreign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreign.js","sourceRoot":"","sources":["../src/foreign.ts"],"names":[],"mappings":"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","sourcesContent":["// The load-bearing seam: mount a Lexical editor inside an LLui view via\n// `foreign()`. Lexical owns the contentEditable subtree; LLui owns the chrome.\n//\n// Inbound (controlled): a `value` signal drives the document, echo-suppressed so\n// the editor never fights its own emissions. Outbound: a debounced\n// update-listener serializes the document and a synchronous one surfaces the\n// selection/format. Serialize/deserialize are injected so this stays\n// markdown-agnostic — the markdown layer supplies the transformer converters.\n\nimport {\n  CAN_REDO_COMMAND,\n  CAN_UNDO_COMMAND,\n  COMMAND_PRIORITY_LOW,\n  createEditor,\n  type EditorThemeClasses,\n  type Klass,\n  type LexicalEditor,\n  type LexicalNode,\n} from 'lexical'\nimport { registerRichText } from '@lexical/rich-text'\nimport { registerHistory, createEmptyHistoryState } from '@lexical/history'\nimport { mergeRegister } from '@lexical/utils'\nimport { foreign, type Mountable, type Signal } from '@llui/dom'\nimport type { LexicalPlugin, PluginContext } from './plugin.js'\nimport { registerShortcuts } from './register.js'\n\n/** Lexical update tag marking a programmatic write (seed / controlled setValue),\n * so the outbound change listener doesn't echo it back to the host. */\nexport const PROGRAMMATIC_TAG = '@llui/lexical:programmatic'\n\n/** Context handed to the selection callback on every commit. */\nexport interface SelectionContext {\n  editor: LexicalEditor\n  canUndo: boolean\n  canRedo: boolean\n}\n\nexport interface LexicalForeignOptions<Emit = unknown> {\n  /** Editor namespace (instance isolation; required for distinct editors). */\n  namespace: string\n  theme?: EditorThemeClasses\n  /** Node classes registered in addition to the plugins' own nodes. */\n  nodes?: ReadonlyArray<Klass<LexicalNode>>\n  /** Plugins: their `nodes` are merged, `register`/`shortcuts` wired at mount. */\n  plugins?: ReadonlyArray<LexicalPlugin<Emit>>\n  /** Serialize the live document → string (runs in a read context). */\n  serialize: (editor: LexicalEditor) => string\n  /** Deserialize a string into the document (runs in an update context). */\n  deserialize: (editor: LexicalEditor, value: string) => void\n  /** Initial document (uncontrolled) — ignored when `value` is provided. */\n  defaultValue?: string\n  /** Controlled document signal; the editor follows it (echo-guarded). */\n  value?: Signal<string>\n  /** Reactive read-only flag (always supplied by the host's state). */\n  readOnly: Signal<boolean>\n  /** Debounce window (ms) for outbound serialization. Default 300. */\n  changeDebounceMs?: number\n  /** Outbound: serialized document changed (debounced, real edits only). */\n  onChange?: (value: string) => void\n  /** Outbound: selection / format / structure changed (every commit). */\n  onSelectionChange?: (ctx: SelectionContext) => void\n  /** Host emit, handed to each plugin's `register` context. */\n  emit?: (msg: Emit) => void\n  /** Receives the live editor at mount (host dispatches commands through it). */\n  onReady?: (editor: LexicalEditor) => void\n  /** Extra registration after rich-text (e.g. markdown shortcuts). Disposer. */\n  register?: (editor: LexicalEditor) => () => void\n  onError?: (error: Error) => void\n}\n\n/** The booted editor + echo-guard accessors, shared by both control modes. */\ninterface BootResult {\n  editor: LexicalEditor\n  getLastEmitted: () => string\n  setLastEmitted: (value: string) => void\n  /** Tear down listeners, history, plugins, and the pending debounce timer. */\n  dispose: () => void\n}\n\n/** The `foreign` instance — only a disposer is needed at unmount. */\ninterface ForeignInst {\n  dispose: () => void\n}\n\n/** Mount Lexical into an LLui view. Returns a `Mountable` placed in the view\n * array; Lexical is created on mount and destroyed on the component's dispose. */\nexport function lexicalForeign<Emit = unknown>(opts: LexicalForeignOptions<Emit>): Mountable {\n  const debounceMs = opts.changeDebounceMs ?? 300\n\n  const boot = (el: Element): BootResult => {\n    // De-duplicate node classes by reference: registering the same Klass twice\n    // (e.g. two decorator plugins sharing LLuiDecoratorNode) throws in Lexical.\n    const nodeSet = new Set<Klass<LexicalNode>>(opts.nodes ?? [])\n    for (const plugin of opts.plugins ?? []) {\n      for (const node of plugin.nodes ?? []) nodeSet.add(node)\n    }\n    const nodes = [...nodeSet]\n\n    const editor = createEditor({\n      namespace: opts.namespace,\n      nodes,\n      theme: opts.theme,\n      editable: !opts.readOnly.peek(),\n      onError: (error: Error) => {\n        if (opts.onError) opts.onError(error)\n        else throw error\n      },\n    })\n    // Vanilla Lexical does NOT make the root editable — the caller must set\n    // `contenteditable` (the React `<ContentEditable>` does this). Without it the\n    // browser shows no caret and ignores typing.\n    el.setAttribute('contenteditable', opts.readOnly.peek() ? 'false' : 'true')\n    editor.setRootElement(el as HTMLElement)\n    opts.onReady?.(editor)\n\n    let lastEmitted = opts.value ? opts.value.peek() : (opts.defaultValue ?? '')\n    let canUndo = false\n    let canRedo = false\n    let debounceTimer: ReturnType<typeof setTimeout> | undefined\n\n    // Seed the initial document (programmatic — not echoed outbound). Discrete so\n    // the host is populated synchronously at mount (before the first paint/read).\n    // NB: seeding happens AFTER registration below, so plugins/decorator bridges\n    // are live when the seed document is built (e.g. a callout in the seed needs\n    // its bridge registered to decorate).\n\n    const ctx: PluginContext<Emit> = { emit: (msg) => opts.emit?.(msg) }\n    const pluginDisposers = (opts.plugins ?? []).map((plugin) => {\n      const reg = plugin.register?.(editor, ctx) ?? (() => {})\n      const shortcuts = plugin.shortcuts ? registerShortcuts(editor, plugin.shortcuts) : () => {}\n      return () => {\n        reg()\n        shortcuts()\n      }\n    })\n\n    const emitSelection = (): void => opts.onSelectionChange?.({ editor, canUndo, canRedo })\n\n    const baseDispose = mergeRegister(\n      registerRichText(editor),\n      registerHistory(editor, createEmptyHistoryState(), 1000),\n      opts.register?.(editor) ?? (() => {}),\n      editor.registerCommand(\n        CAN_UNDO_COMMAND,\n        (payload: boolean) => {\n          canUndo = payload\n          emitSelection()\n          return false\n        },\n        COMMAND_PRIORITY_LOW,\n      ),\n      editor.registerCommand(\n        CAN_REDO_COMMAND,\n        (payload: boolean) => {\n          canRedo = payload\n          emitSelection()\n          return false\n        },\n        COMMAND_PRIORITY_LOW,\n      ),\n      editor.registerUpdateListener(({ editorState, tags }) => {\n        emitSelection()\n        if (tags.has(PROGRAMMATIC_TAG)) return\n        if (debounceTimer !== undefined) clearTimeout(debounceTimer)\n        debounceTimer = setTimeout(() => {\n          editorState.read(() => {\n            const next = opts.serialize(editor)\n            lastEmitted = next\n            opts.onChange?.(next)\n          })\n        }, debounceMs)\n      }),\n      ...pluginDisposers,\n    )\n\n    // Seed now that rich-text, history, plugins, and decorator bridges are live.\n    editor.update(() => opts.deserialize(editor, lastEmitted), {\n      tag: PROGRAMMATIC_TAG,\n      discrete: true,\n    })\n\n    return {\n      editor,\n      getLastEmitted: () => lastEmitted,\n      setLastEmitted: (value) => {\n        lastEmitted = value\n      },\n      dispose: () => {\n        if (debounceTimer !== undefined) clearTimeout(debounceTimer)\n        baseDispose()\n      },\n    }\n  }\n\n  const readOnly = opts.readOnly\n  const controlled = opts.value\n\n  if (controlled) {\n    return foreign<ForeignInst, { value: Signal<string>; readOnly: Signal<boolean> }>({\n      tag: 'div',\n      state: { value: controlled, readOnly },\n      mount: ({ el, state }) => {\n        const b = boot(el)\n        const unbindValue = state.value.bind((incoming) => {\n          if (incoming === b.getLastEmitted()) return\n          b.editor.update(() => opts.deserialize(b.editor, incoming), { tag: PROGRAMMATIC_TAG })\n          b.setLastEmitted(incoming)\n        })\n        const unbindReadOnly = state.readOnly.bind((ro) => {\n          b.editor.setEditable(!ro)\n          el.setAttribute('contenteditable', ro ? 'false' : 'true')\n        })\n        return {\n          dispose: () => {\n            unbindValue()\n            unbindReadOnly()\n            b.dispose()\n          },\n        }\n      },\n      unmount: (inst) => inst.dispose(),\n    })\n  }\n\n  return foreign<ForeignInst, { readOnly: Signal<boolean> }>({\n    tag: 'div',\n    state: { readOnly },\n    mount: ({ el, state }) => {\n      const b = boot(el)\n      const unbindReadOnly = state.readOnly.bind((ro) => {\n        b.editor.setEditable(!ro)\n        ;(el as HTMLElement).contentEditable = ro ? 'false' : 'true'\n      })\n      return {\n        dispose: () => {\n          unbindReadOnly()\n          b.dispose()\n        },\n      }\n    },\n    unmount: (inst) => inst.dispose(),\n  })\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { type ShortcutSpec, type PluginContext, type DecoratorApi, type DecoratorBridge, type LexicalPlugin, decoratorBridge, } from './plugin.js';
+export { type ParsedCombo, parseCombo, matchesCombo, isMacPlatform, registerShortcuts, } from './register.js';
+export { type BaseBlockType, type Alignment, type BaseFormat, $readBaseFormat, readBaseFormat, } from './selection.js';
+export { PROGRAMMATIC_TAG, type SelectionContext, type LexicalForeignOptions, lexicalForeign, } from './foreign.js';
+export { type SerializedLLuiDecoratorNode, LLuiDecoratorNode, $createLLuiDecoratorNode, $isLLuiDecoratorNode, registerDecoratorBridges, } from './decorator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,eAAe,GAChB,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,KAAK,WAAW,EAChB,UAAU,EACV,YAAY,EACZ,aAAa,EACb,iBAAiB,GAClB,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,eAAe,EACf,cAAc,GACf,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,cAAc,GACf,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,KAAK,2BAA2B,EAChC,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// `@llui/lexical` — low-level binding between Lexical and the LLui signal runtime.
+export { decoratorBridge, } from './plugin.js';
+export { parseCombo, matchesCombo, isMacPlatform, registerShortcuts, } from './register.js';
+export { $readBaseFormat, readBaseFormat, } from './selection.js';
+export { PROGRAMMATIC_TAG, lexicalForeign, } from './foreign.js';
+export { LLuiDecoratorNode, $createLLuiDecoratorNode, $isLLuiDecoratorNode, registerDecoratorBridges, } from './decorator.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,OAAO,EAML,eAAe,GAChB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAEL,UAAU,EACV,YAAY,EACZ,aAAa,EACb,iBAAiB,GAClB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAIL,eAAe,EACf,cAAc,GACf,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,gBAAgB,EAGhB,cAAc,GACf,MAAM,cAAc,CAAA;AAErB,OAAO,EAEL,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,gBAAgB,CAAA","sourcesContent":["// `@llui/lexical` — low-level binding between Lexical and the LLui signal runtime.\n\nexport {\n  type ShortcutSpec,\n  type PluginContext,\n  type DecoratorApi,\n  type DecoratorBridge,\n  type LexicalPlugin,\n  decoratorBridge,\n} from './plugin.js'\n\nexport {\n  type ParsedCombo,\n  parseCombo,\n  matchesCombo,\n  isMacPlatform,\n  registerShortcuts,\n} from './register.js'\n\nexport {\n  type BaseBlockType,\n  type Alignment,\n  type BaseFormat,\n  $readBaseFormat,\n  readBaseFormat,\n} from './selection.js'\n\nexport {\n  PROGRAMMATIC_TAG,\n  type SelectionContext,\n  type LexicalForeignOptions,\n  lexicalForeign,\n} from './foreign.js'\n\nexport {\n  type SerializedLLuiDecoratorNode,\n  LLuiDecoratorNode,\n  $createLLuiDecoratorNode,\n  $isLLuiDecoratorNode,\n  registerDecoratorBridges,\n} from './decorator.js'\n"]}

package/dist/plugin.d.ts

@@ -0,0 +1,64 @@
+import type { Klass, LexicalEditor, LexicalNode } from 'lexical';
+import { type SignalComponentDef } from '@llui/dom';
+/** A keyboard shortcut bound to an editor action.
+ *
+ * `combo` is a normalized chord: `Mod` resolves to ⌘ on macOS and Ctrl
+ * elsewhere, e.g. `Mod-b`, `Mod-Shift-7`, `Mod-Alt-1`. `run` returns `true`
+ * when it handled the event (which stops propagation / prevents default). */
+export interface ShortcutSpec {
+    combo: string;
+    run: (editor: LexicalEditor) => boolean;
+}
+/** Context handed to `plugin.register` so a plugin can talk back to the host
+ * (e.g. open a slash menu) without owning the host's `send`. `Emit` is the
+ * host message type; `@llui/lexical` leaves it `unknown`, hosts narrow it. */
+export interface PluginContext<Emit = unknown> {
+    /** Emit a host message into the embedding component's update loop. */
+    emit: (msg: Emit) => void;
+}
+/** Imperative handle a decorator sub-view uses to talk to its Lexical node. */
+export interface DecoratorApi<Data> {
+    /** Persist new node data (writes into the Lexical node → markdown-serializable). */
+    update: (next: Data) => void;
+    /** The owning Lexical editor (for dispatching commands, reading state). */
+    editor: LexicalEditor;
+}
+/**
+ * Bridges a custom node type to an LLui sub-view. The sub-view's
+ * `State`/`Msg`/`Effect` and `Data` types are fully erased here: a bridge is
+ * stored monomorphically in the registry, and `mount` builds + mounts the
+ * sub-app, returning a disposer. Authors construct bridges with the typed
+ * {@link decoratorBridge} helper, which captures concrete types in a closure.
+ */
+export interface DecoratorBridge {
+    /** The id used by the contributing markdown transformer. */
+    type: string;
+    /** Mount the sub-view for a node's (deserialized) data; returns a disposer. */
+    mount: (container: Element, data: unknown, api: DecoratorApi<unknown>) => () => void;
+}
+/**
+ * Author-facing constructor for a {@link DecoratorBridge}. Preserves the
+ * sub-component's `State`/`Msg`/`Effect` and the node `Data` type at the
+ * definition site; only the node's serialized payload is narrowed back to
+ * `Data` at mount time (the single deserialization-boundary cast, exactly like
+ * `JSON.parse` returning a declared type).
+ */
+export declare function decoratorBridge<Data, S, M extends {
+    type: string;
+}, E extends {
+    type: string;
+} = never>(type: string, factory: (data: Data, api: DecoratorApi<Data>) => SignalComponentDef<S, M, E>): DecoratorBridge;
+/** A composable unit of editor behaviour. */
+export interface LexicalPlugin<Emit = unknown> {
+    /** Stable identifier (also used for de-duplication and overrides). */
+    name: string;
+    /** Lexical node classes registered on the editor config. */
+    nodes?: ReadonlyArray<Klass<LexicalNode>>;
+    /** Imperative registration (commands, listeners). Returns a disposer. */
+    register?: (editor: LexicalEditor, ctx: PluginContext<Emit>) => () => void;
+    /** Keyboard shortcuts wired through a single KEY_DOWN command. */
+    shortcuts?: readonly ShortcutSpec[];
+    /** Decorator bridges this plugin owns. */
+    decorators?: readonly DecoratorBridge[];
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAChE,OAAO,EAAY,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAE7D;;;;6EAI6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAA;CACxC;AAED;;8EAE8E;AAC9E,MAAM,WAAW,aAAa,CAAC,IAAI,GAAG,OAAO;IAC3C,sEAAsE;IACtE,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,IAAI,CAAA;CAC1B;AAED,+EAA+E;AAC/E,MAAM,WAAW,YAAY,CAAC,IAAI;IAChC,oFAAoF;IACpF,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;IAC5B,2EAA2E;IAC3E,MAAM,EAAE,aAAa,CAAA;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAA;IACZ,+EAA+E;IAC/E,KAAK,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,MAAM,IAAI,CAAA;CACrF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EACJ,CAAC,EACD,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC1B,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,EAElC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC5E,eAAe,CAYjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,aAAa,CAAC,IAAI,GAAG,OAAO;IAC3C,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAA;IACzC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,CAAA;IAC1E,kEAAkE;IAClE,SAAS,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IACnC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;CACxC"}

package/dist/plugin.js

@@ -0,0 +1,29 @@
+// The plugin contract for the LLui ↔ Lexical binding.
+//
+// A plugin is a pure descriptor: it contributes Lexical node classes, an
+// imperative `register` step (commands/listeners), keyboard shortcuts, and
+// decorator bridges (LLui sub-views mounted inside Lexical DecoratorNodes).
+// It is intentionally markdown-agnostic — `@llui/markdown-editor` extends this
+// contract with markdown transformers and toolbar items.
+import { mountApp } from '@llui/dom';
+/**
+ * Author-facing constructor for a {@link DecoratorBridge}. Preserves the
+ * sub-component's `State`/`Msg`/`Effect` and the node `Data` type at the
+ * definition site; only the node's serialized payload is narrowed back to
+ * `Data` at mount time (the single deserialization-boundary cast, exactly like
+ * `JSON.parse` returning a declared type).
+ */
+export function decoratorBridge(type, factory) {
+    return {
+        type,
+        mount: (container, data, api) => {
+            const typedApi = {
+                editor: api.editor,
+                update: (next) => api.update(next),
+            };
+            const handle = mountApp(container, factory(data, typedApi));
+            return () => handle.dispose();
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,4EAA4E;AAC5E,+EAA+E;AAC/E,yDAAyD;AAGzD,OAAO,EAAE,QAAQ,EAA2B,MAAM,WAAW,CAAA;AA0C7D;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAM7B,IAAY,EACZ,OAA6E;IAE7E,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC9B,MAAM,QAAQ,GAAuB;gBACnC,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;aACnC,CAAA;YACD,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,IAAY,EAAE,QAAQ,CAAC,CAAC,CAAA;YACnE,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAA;QAC/B,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["// The plugin contract for the LLui ↔ Lexical binding.\n//\n// A plugin is a pure descriptor: it contributes Lexical node classes, an\n// imperative `register` step (commands/listeners), keyboard shortcuts, and\n// decorator bridges (LLui sub-views mounted inside Lexical DecoratorNodes).\n// It is intentionally markdown-agnostic — `@llui/markdown-editor` extends this\n// contract with markdown transformers and toolbar items.\n\nimport type { Klass, LexicalEditor, LexicalNode } from 'lexical'\nimport { mountApp, type SignalComponentDef } from '@llui/dom'\n\n/** A keyboard shortcut bound to an editor action.\n *\n * `combo` is a normalized chord: `Mod` resolves to ⌘ on macOS and Ctrl\n * elsewhere, e.g. `Mod-b`, `Mod-Shift-7`, `Mod-Alt-1`. `run` returns `true`\n * when it handled the event (which stops propagation / prevents default). */\nexport interface ShortcutSpec {\n  combo: string\n  run: (editor: LexicalEditor) => boolean\n}\n\n/** Context handed to `plugin.register` so a plugin can talk back to the host\n * (e.g. open a slash menu) without owning the host's `send`. `Emit` is the\n * host message type; `@llui/lexical` leaves it `unknown`, hosts narrow it. */\nexport interface PluginContext<Emit = unknown> {\n  /** Emit a host message into the embedding component's update loop. */\n  emit: (msg: Emit) => void\n}\n\n/** Imperative handle a decorator sub-view uses to talk to its Lexical node. */\nexport interface DecoratorApi<Data> {\n  /** Persist new node data (writes into the Lexical node → markdown-serializable). */\n  update: (next: Data) => void\n  /** The owning Lexical editor (for dispatching commands, reading state). */\n  editor: LexicalEditor\n}\n\n/**\n * Bridges a custom node type to an LLui sub-view. The sub-view's\n * `State`/`Msg`/`Effect` and `Data` types are fully erased here: a bridge is\n * stored monomorphically in the registry, and `mount` builds + mounts the\n * sub-app, returning a disposer. Authors construct bridges with the typed\n * {@link decoratorBridge} helper, which captures concrete types in a closure.\n */\nexport interface DecoratorBridge {\n  /** The id used by the contributing markdown transformer. */\n  type: string\n  /** Mount the sub-view for a node's (deserialized) data; returns a disposer. */\n  mount: (container: Element, data: unknown, api: DecoratorApi<unknown>) => () => void\n}\n\n/**\n * Author-facing constructor for a {@link DecoratorBridge}. Preserves the\n * sub-component's `State`/`Msg`/`Effect` and the node `Data` type at the\n * definition site; only the node's serialized payload is narrowed back to\n * `Data` at mount time (the single deserialization-boundary cast, exactly like\n * `JSON.parse` returning a declared type).\n */\nexport function decoratorBridge<\n  Data,\n  S,\n  M extends { type: string },\n  E extends { type: string } = never,\n>(\n  type: string,\n  factory: (data: Data, api: DecoratorApi<Data>) => SignalComponentDef<S, M, E>,\n): DecoratorBridge {\n  return {\n    type,\n    mount: (container, data, api) => {\n      const typedApi: DecoratorApi<Data> = {\n        editor: api.editor,\n        update: (next) => api.update(next),\n      }\n      const handle = mountApp(container, factory(data as Data, typedApi))\n      return () => handle.dispose()\n    },\n  }\n}\n\n/** A composable unit of editor behaviour. */\nexport interface LexicalPlugin<Emit = unknown> {\n  /** Stable identifier (also used for de-duplication and overrides). */\n  name: string\n  /** Lexical node classes registered on the editor config. */\n  nodes?: ReadonlyArray<Klass<LexicalNode>>\n  /** Imperative registration (commands, listeners). Returns a disposer. */\n  register?: (editor: LexicalEditor, ctx: PluginContext<Emit>) => () => void\n  /** Keyboard shortcuts wired through a single KEY_DOWN command. */\n  shortcuts?: readonly ShortcutSpec[]\n  /** Decorator bridges this plugin owns. */\n  decorators?: readonly DecoratorBridge[]\n}\n"]}

package/dist/register.d.ts

@@ -0,0 +1,23 @@
+import { type LexicalEditor } from 'lexical';
+import type { ShortcutSpec } from './plugin.js';
+/** A parsed chord. `mod` means ⌘ on macOS / Ctrl elsewhere. */
+export interface ParsedCombo {
+    key: string;
+    mod: boolean;
+    shift: boolean;
+    alt: boolean;
+    ctrl: boolean;
+}
+/** Parse a chord like `Mod-Shift-7` into its parts. Case-insensitive on
+ * modifiers; the final segment is the key (lower-cased for letters). */
+export declare function parseCombo(combo: string): ParsedCombo;
+/** Does a keyboard event satisfy a parsed chord? `mod` maps to ⌘ on macOS and
+ * Ctrl elsewhere; all declared modifiers must match exactly (no extras). */
+export declare function matchesCombo(event: KeyboardEvent, combo: ParsedCombo, isMac: boolean): boolean;
+/** Best-effort macOS detection (browser only; defaults to false off-DOM). */
+export declare function isMacPlatform(): boolean;
+/** Register a set of shortcuts on the editor through one KEY_DOWN handler.
+ * Returns a disposer. The first matching shortcut whose `run` returns `true`
+ * wins and the event is consumed. */
+export declare function registerShortcuts(editor: LexicalEditor, shortcuts: readonly ShortcutSpec[]): () => void;
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAGA,OAAO,EAA6C,KAAK,aAAa,EAAE,MAAM,SAAS,CAAA;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,OAAO,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,EAAE,OAAO,CAAA;IACZ,IAAI,EAAE,OAAO,CAAA;CACd;AAED;wEACwE;AACxE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAkBrD;AAED;4EAC4E;AAC5E,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAc9F;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,IAAI,OAAO,CAKvC;AAED;;qCAEqC;AACrC,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,SAAS,YAAY,EAAE,GACjC,MAAM,IAAI,CAmBZ"}

package/dist/register.js

@@ -0,0 +1,80 @@
+// Keyboard-shortcut wiring: parse normalized chord strings and register them
+// through a single KEY_DOWN command on the editor.
+import { COMMAND_PRIORITY_NORMAL, KEY_DOWN_COMMAND } from 'lexical';
+/** Parse a chord like `Mod-Shift-7` into its parts. Case-insensitive on
+ * modifiers; the final segment is the key (lower-cased for letters). */
+export function parseCombo(combo) {
+    const parts = combo
+        .split('-')
+        .map((p) => p.trim())
+        .filter((p) => p.length > 0);
+    const result = { key: '', mod: false, shift: false, alt: false, ctrl: false };
+    for (let i = 0; i < parts.length; i++) {
+        const part = parts[i];
+        const isLast = i === parts.length - 1;
+        const lower = part.toLowerCase();
+        if (!isLast && (lower === 'mod' || lower === 'cmd' || lower === 'meta'))
+            result.mod = true;
+        else if (!isLast && lower === 'ctrl')
+            result.ctrl = true;
+        else if (!isLast && lower === 'shift')
+            result.shift = true;
+        else if (!isLast && (lower === 'alt' || lower === 'option' || lower === 'opt'))
+            result.alt = true;
+        else
+            result.key = part.length === 1 ? part.toLowerCase() : part;
+    }
+    return result;
+}
+/** Does a keyboard event satisfy a parsed chord? `mod` maps to ⌘ on macOS and
+ * Ctrl elsewhere; all declared modifiers must match exactly (no extras). */
+export function matchesCombo(event, combo, isMac) {
+    const eventKey = event.key.length === 1 ? event.key.toLowerCase() : event.key;
+    if (eventKey !== combo.key)
+        return false;
+    const modActive = isMac ? event.metaKey : event.ctrlKey;
+    const otherCtrl = isMac ? event.ctrlKey : event.metaKey;
+    if (combo.mod !== modActive)
+        return false;
+    // An explicit `ctrl` on macOS targets the control key specifically.
+    if (combo.ctrl !== (isMac ? event.ctrlKey : false)) {
+        if (!(combo.mod && !isMac))
+            return false;
+    }
+    if (!combo.mod && !combo.ctrl && otherCtrl)
+        return false;
+    if (combo.shift !== event.shiftKey)
+        return false;
+    if (combo.alt !== event.altKey)
+        return false;
+    return true;
+}
+/** Best-effort macOS detection (browser only; defaults to false off-DOM). */
+export function isMacPlatform() {
+    if (typeof navigator === 'undefined')
+        return false;
+    const platform = navigator.platform ?? '';
+    const ua = navigator.userAgent ?? '';
+    return /mac|iphone|ipad|ipod/i.test(platform) || /mac/i.test(ua);
+}
+/** Register a set of shortcuts on the editor through one KEY_DOWN handler.
+ * Returns a disposer. The first matching shortcut whose `run` returns `true`
+ * wins and the event is consumed. */
+export function registerShortcuts(editor, shortcuts) {
+    if (shortcuts.length === 0)
+        return () => { };
+    const parsed = shortcuts.map((s) => ({ spec: s, combo: parseCombo(s.combo) }));
+    const mac = isMacPlatform();
+    return editor.registerCommand(KEY_DOWN_COMMAND, (event) => {
+        for (const { spec, combo } of parsed) {
+            if (matchesCombo(event, combo, mac)) {
+                if (spec.run(editor)) {
+                    event.preventDefault();
+                    return true;
+                }
+            }
+        }
+        return false;
+    }, COMMAND_PRIORITY_NORMAL);
+}
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"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","sourcesContent":["// Keyboard-shortcut wiring: parse normalized chord strings and register them\n// through a single KEY_DOWN command on the editor.\n\nimport { COMMAND_PRIORITY_NORMAL, KEY_DOWN_COMMAND, type LexicalEditor } from 'lexical'\nimport type { ShortcutSpec } from './plugin.js'\n\n/** A parsed chord. `mod` means ⌘ on macOS / Ctrl elsewhere. */\nexport interface ParsedCombo {\n  key: string\n  mod: boolean\n  shift: boolean\n  alt: boolean\n  ctrl: boolean\n}\n\n/** Parse a chord like `Mod-Shift-7` into its parts. Case-insensitive on\n * modifiers; the final segment is the key (lower-cased for letters). */\nexport function parseCombo(combo: string): ParsedCombo {\n  const parts = combo\n    .split('-')\n    .map((p) => p.trim())\n    .filter((p) => p.length > 0)\n  const result: ParsedCombo = { key: '', mod: false, shift: false, alt: false, ctrl: false }\n  for (let i = 0; i < parts.length; i++) {\n    const part = parts[i]!\n    const isLast = i === parts.length - 1\n    const lower = part.toLowerCase()\n    if (!isLast && (lower === 'mod' || lower === 'cmd' || lower === 'meta')) result.mod = true\n    else if (!isLast && lower === 'ctrl') result.ctrl = true\n    else if (!isLast && lower === 'shift') result.shift = true\n    else if (!isLast && (lower === 'alt' || lower === 'option' || lower === 'opt'))\n      result.alt = true\n    else result.key = part.length === 1 ? part.toLowerCase() : part\n  }\n  return result\n}\n\n/** Does a keyboard event satisfy a parsed chord? `mod` maps to ⌘ on macOS and\n * Ctrl elsewhere; all declared modifiers must match exactly (no extras). */\nexport function matchesCombo(event: KeyboardEvent, combo: ParsedCombo, isMac: boolean): boolean {\n  const eventKey = event.key.length === 1 ? event.key.toLowerCase() : event.key\n  if (eventKey !== combo.key) return false\n  const modActive = isMac ? event.metaKey : event.ctrlKey\n  const otherCtrl = isMac ? event.ctrlKey : event.metaKey\n  if (combo.mod !== modActive) return false\n  // An explicit `ctrl` on macOS targets the control key specifically.\n  if (combo.ctrl !== (isMac ? event.ctrlKey : false)) {\n    if (!(combo.mod && !isMac)) return false\n  }\n  if (!combo.mod && !combo.ctrl && otherCtrl) return false\n  if (combo.shift !== event.shiftKey) return false\n  if (combo.alt !== event.altKey) return false\n  return true\n}\n\n/** Best-effort macOS detection (browser only; defaults to false off-DOM). */\nexport function isMacPlatform(): boolean {\n  if (typeof navigator === 'undefined') return false\n  const platform = navigator.platform ?? ''\n  const ua = navigator.userAgent ?? ''\n  return /mac|iphone|ipad|ipod/i.test(platform) || /mac/i.test(ua)\n}\n\n/** Register a set of shortcuts on the editor through one KEY_DOWN handler.\n * Returns a disposer. The first matching shortcut whose `run` returns `true`\n * wins and the event is consumed. */\nexport function registerShortcuts(\n  editor: LexicalEditor,\n  shortcuts: readonly ShortcutSpec[],\n): () => void {\n  if (shortcuts.length === 0) return () => {}\n  const parsed = shortcuts.map((s) => ({ spec: s, combo: parseCombo(s.combo) }))\n  const mac = isMacPlatform()\n  return editor.registerCommand(\n    KEY_DOWN_COMMAND,\n    (event: KeyboardEvent) => {\n      for (const { spec, combo } of parsed) {\n        if (matchesCombo(event, combo, mac)) {\n          if (spec.run(editor)) {\n            event.preventDefault()\n            return true\n          }\n        }\n      }\n      return false\n    },\n    COMMAND_PRIORITY_NORMAL,\n  )\n}\n"]}

package/dist/selection.d.ts

@@ -0,0 +1,25 @@
+import { type LexicalEditor } from 'lexical';
+/** Block kinds resolvable without list/code packages. Anything else → 'other',
+ * which the markdown layer refines (list, code, …). */
+export type BaseBlockType = 'paragraph' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'quote' | 'other';
+export type Alignment = 'left' | 'center' | 'right' | 'justify' | 'start' | 'end' | null;
+/** The generic format surface at the current selection. */
+export interface BaseFormat {
+    bold: boolean;
+    italic: boolean;
+    strikethrough: boolean;
+    underline: boolean;
+    code: boolean;
+    blockType: BaseBlockType;
+    alignment: Alignment;
+    /** The resolved top-level block element key (lets the markdown layer refine). */
+    blockKey: string | null;
+    hasSelection: boolean;
+    isCollapsed: boolean;
+}
+/** Read the base format at the current selection. Must run inside a Lexical
+ * read/update context (it calls `$`-prefixed APIs). */
+export declare function $readBaseFormat(): BaseFormat;
+/** Convenience wrapper that opens a read context on `editor`. */
+export declare function readBaseFormat(editor: LexicalEditor): BaseFormat;
+//# sourceMappingURL=selection.d.ts.map

package/dist/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../src/selection.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,SAAS,CAAA;AAGhB;uDACuD;AACvD,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,OAAO,GACP,OAAO,CAAA;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,IAAI,CAAA;AAExF,2DAA2D;AAC3D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf,aAAa,EAAE,OAAO,CAAA;IACtB,SAAS,EAAE,OAAO,CAAA;IAClB,IAAI,EAAE,OAAO,CAAA;IACb,SAAS,EAAE,aAAa,CAAA;IACxB,SAAS,EAAE,SAAS,CAAA;IACpB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,YAAY,EAAE,OAAO,CAAA;IACrB,WAAW,EAAE,OAAO,CAAA;CACrB;AAkCD;uDACuD;AACvD,wBAAgB,eAAe,IAAI,UAAU,CA8B5C;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAEhE"}

package/dist/selection.js

@@ -0,0 +1,73 @@
+// Generic (rich-text level) selection → format reader. `@llui/markdown-editor`
+// composes this with list/code detection to build its full toolbar FormatState.
+import { $getSelection, $isElementNode, $isRangeSelection, $isRootOrShadowRoot, } from 'lexical';
+import { $isHeadingNode, $isQuoteNode } from '@lexical/rich-text';
+const EMPTY = {
+    bold: false,
+    italic: false,
+    strikethrough: false,
+    underline: false,
+    code: false,
+    blockType: 'paragraph',
+    alignment: null,
+    blockKey: null,
+    hasSelection: false,
+    isCollapsed: true,
+};
+function mapAlignment(format) {
+    switch (format) {
+        case 'left':
+            return 'left';
+        case 'center':
+            return 'center';
+        case 'right':
+            return 'right';
+        case 'justify':
+            return 'justify';
+        case 'start':
+            return 'start';
+        case 'end':
+            return 'end';
+        default:
+            return null;
+    }
+}
+/** Read the base format at the current selection. Must run inside a Lexical
+ * read/update context (it calls `$`-prefixed APIs). */
+export function $readBaseFormat() {
+    const selection = $getSelection();
+    if (!$isRangeSelection(selection))
+        return EMPTY;
+    const anchorNode = selection.anchor.getNode();
+    let blockElement = anchorNode;
+    if (!$isRootOrShadowRoot(anchorNode)) {
+        const top = anchorNode.getTopLevelElement();
+        if (top !== null)
+            blockElement = top;
+    }
+    let blockType = 'other';
+    if ($isHeadingNode(blockElement))
+        blockType = blockElement.getTag();
+    else if ($isQuoteNode(blockElement))
+        blockType = 'quote';
+    else if (blockElement.getType() === 'paragraph')
+        blockType = 'paragraph';
+    const alignment = $isElementNode(blockElement) ? mapAlignment(blockElement.getFormatType()) : null;
+    return {
+        bold: selection.hasFormat('bold'),
+        italic: selection.hasFormat('italic'),
+        strikethrough: selection.hasFormat('strikethrough'),
+        underline: selection.hasFormat('underline'),
+        code: selection.hasFormat('code'),
+        blockType,
+        alignment,
+        blockKey: blockElement.getKey(),
+        hasSelection: true,
+        isCollapsed: selection.isCollapsed(),
+    };
+}
+/** Convenience wrapper that opens a read context on `editor`. */
+export function readBaseFormat(editor) {
+    return editor.getEditorState().read(() => $readBaseFormat());
+}
+//# sourceMappingURL=selection.js.map

package/dist/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../src/selection.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GAGpB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAgCjE,MAAM,KAAK,GAAe;IACxB,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,KAAK;IACb,aAAa,EAAE,KAAK;IACpB,SAAS,EAAE,KAAK;IAChB,IAAI,EAAE,KAAK;IACX,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,IAAI;IACd,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,IAAI;CAClB,CAAA;AAED,SAAS,YAAY,CAAC,MAAyB;IAC7C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,MAAM,CAAA;QACf,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAA;QACjB,KAAK,OAAO;YACV,OAAO,OAAO,CAAA;QAChB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAA;QAClB,KAAK,OAAO;YACV,OAAO,OAAO,CAAA;QAChB,KAAK,KAAK;YACR,OAAO,KAAK,CAAA;QACd;YACE,OAAO,IAAI,CAAA;IACf,CAAC;AACH,CAAC;AAED;uDACuD;AACvD,MAAM,UAAU,eAAe;IAC7B,MAAM,SAAS,GAAG,aAAa,EAAE,CAAA;IACjC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAA;IAE/C,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAA;IAC7C,IAAI,YAAY,GAAG,UAAU,CAAA;IAC7B,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,UAAU,CAAC,kBAAkB,EAAE,CAAA;QAC3C,IAAI,GAAG,KAAK,IAAI;YAAE,YAAY,GAAG,GAAG,CAAA;IACtC,CAAC;IAED,IAAI,SAAS,GAAkB,OAAO,CAAA;IACtC,IAAI,cAAc,CAAC,YAAY,CAAC;QAAE,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,CAAA;SAC9D,IAAI,YAAY,CAAC,YAAY,CAAC;QAAE,SAAS,GAAG,OAAO,CAAA;SACnD,IAAI,YAAY,CAAC,OAAO,EAAE,KAAK,WAAW;QAAE,SAAS,GAAG,WAAW,CAAA;IAExE,MAAM,SAAS,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAElG,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;QACjC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC;QACrC,aAAa,EAAE,SAAS,CAAC,SAAS,CAAC,eAAe,CAAC;QACnD,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC;QAC3C,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;QACjC,SAAS;QACT,SAAS;QACT,QAAQ,EAAE,YAAY,CAAC,MAAM,EAAE;QAC/B,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,SAAS,CAAC,WAAW,EAAE;KACrC,CAAA;AACH,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,MAAqB;IAClD,OAAO,MAAM,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC,CAAA;AAC9D,CAAC","sourcesContent":["// Generic (rich-text level) selection → format reader. `@llui/markdown-editor`\n// composes this with list/code detection to build its full toolbar FormatState.\n\nimport {\n  $getSelection,\n  $isElementNode,\n  $isRangeSelection,\n  $isRootOrShadowRoot,\n  type ElementFormatType,\n  type LexicalEditor,\n} from 'lexical'\nimport { $isHeadingNode, $isQuoteNode } from '@lexical/rich-text'\n\n/** Block kinds resolvable without list/code packages. Anything else → 'other',\n * which the markdown layer refines (list, code, …). */\nexport type BaseBlockType =\n  | 'paragraph'\n  | 'h1'\n  | 'h2'\n  | 'h3'\n  | 'h4'\n  | 'h5'\n  | 'h6'\n  | 'quote'\n  | 'other'\n\nexport type Alignment = 'left' | 'center' | 'right' | 'justify' | 'start' | 'end' | null\n\n/** The generic format surface at the current selection. */\nexport interface BaseFormat {\n  bold: boolean\n  italic: boolean\n  strikethrough: boolean\n  underline: boolean\n  code: boolean\n  blockType: BaseBlockType\n  alignment: Alignment\n  /** The resolved top-level block element key (lets the markdown layer refine). */\n  blockKey: string | null\n  hasSelection: boolean\n  isCollapsed: boolean\n}\n\nconst EMPTY: BaseFormat = {\n  bold: false,\n  italic: false,\n  strikethrough: false,\n  underline: false,\n  code: false,\n  blockType: 'paragraph',\n  alignment: null,\n  blockKey: null,\n  hasSelection: false,\n  isCollapsed: true,\n}\n\nfunction mapAlignment(format: ElementFormatType): Alignment {\n  switch (format) {\n    case 'left':\n      return 'left'\n    case 'center':\n      return 'center'\n    case 'right':\n      return 'right'\n    case 'justify':\n      return 'justify'\n    case 'start':\n      return 'start'\n    case 'end':\n      return 'end'\n    default:\n      return null\n  }\n}\n\n/** Read the base format at the current selection. Must run inside a Lexical\n * read/update context (it calls `$`-prefixed APIs). */\nexport function $readBaseFormat(): BaseFormat {\n  const selection = $getSelection()\n  if (!$isRangeSelection(selection)) return EMPTY\n\n  const anchorNode = selection.anchor.getNode()\n  let blockElement = anchorNode\n  if (!$isRootOrShadowRoot(anchorNode)) {\n    const top = anchorNode.getTopLevelElement()\n    if (top !== null) blockElement = top\n  }\n\n  let blockType: BaseBlockType = 'other'\n  if ($isHeadingNode(blockElement)) blockType = blockElement.getTag()\n  else if ($isQuoteNode(blockElement)) blockType = 'quote'\n  else if (blockElement.getType() === 'paragraph') blockType = 'paragraph'\n\n  const alignment = $isElementNode(blockElement) ? mapAlignment(blockElement.getFormatType()) : null\n\n  return {\n    bold: selection.hasFormat('bold'),\n    italic: selection.hasFormat('italic'),\n    strikethrough: selection.hasFormat('strikethrough'),\n    underline: selection.hasFormat('underline'),\n    code: selection.hasFormat('code'),\n    blockType,\n    alignment,\n    blockKey: blockElement.getKey(),\n    hasSelection: true,\n    isCollapsed: selection.isCollapsed(),\n  }\n}\n\n/** Convenience wrapper that opens a read context on `editor`. */\nexport function readBaseFormat(editor: LexicalEditor): BaseFormat {\n  return editor.getEditorState().read(() => $readBaseFormat())\n}\n"]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@llui/lexical",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "peerDependencies": {
+    "@llui/dom": "^0.9.0",
+    "lexical": "^0.45.0",
+    "@lexical/history": "^0.45.0",
+    "@lexical/rich-text": "^0.45.0",
+    "@lexical/selection": "^0.45.0",
+    "@lexical/utils": "^0.45.0"
+  },
+  "devDependencies": {
+    "lexical": "^0.45.0",
+    "@lexical/headless": "^0.45.0",
+    "@lexical/history": "^0.45.0",
+    "@lexical/rich-text": "^0.45.0",
+    "@lexical/selection": "^0.45.0",
+    "@lexical/utils": "^0.45.0",
+    "typescript": "^6.0.0",
+    "vitest": "^4.1.2",
+    "@llui/dom": "0.9.0"
+  },
+  "sideEffects": false,
+  "description": "Low-level binding between Lexical and the LLui signal runtime — mount Lexical via foreign(), plugin contract, and the DecoratorNode ↔ LLui sub-view bridge",
+  "keywords": [
+    "llui",
+    "lexical",
+    "editor",
+    "signal",
+    "tea"
+  ],
+  "author": "Franco Ponticelli <franco.ponticelli@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fponticelli/llui.git",
+    "directory": "packages/lexical"
+  },
+  "bugs": {
+    "url": "https://github.com/fponticelli/llui/issues"
+  },
+  "homepage": "https://github.com/fponticelli/llui/tree/main/packages/lexical#readme",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check": "tsc --noEmit -p tsconfig.check.json",
+    "lint": "eslint src",
+    "test": "vitest run"
+  }
+}