@jini-ai/ui 0.1.0

package/dist/features/iframe-pool/react/hooks/useIframeKeepAlivePool.js

@@ -0,0 +1,63 @@
+import { useContext, useEffect, useMemo, useRef } from 'react';
+import { selectMatchingEvictions } from '../../rules.js';
+import { IframeKeepAliveContext } from '../pool-context.js';
+/**
+ * Reads the nearest `IframeKeepAlivePoolProvider`'s pool. If none is
+ * mounted, returns a self-contained single-entry fallback pool so a
+ * `PooledIframe` still works standalone — it just gets no LRU/keep-alive
+ * benefit (only ever holds the entries its own caller attaches, and never
+ * enforces a mounted-count limit).
+ */
+export function useIframeKeepAlivePool() {
+    const pool = useContext(IframeKeepAliveContext);
+    const fallbackEntriesRef = useRef(new Map());
+    const fallbackActiveKeysRef = useRef(new Set());
+    const fallbackPool = useMemo(() => {
+        const removeFallbackEntry = (key) => {
+            const entry = fallbackEntriesRef.current.get(key);
+            if (!entry)
+                return;
+            entry.element.remove();
+            fallbackEntriesRef.current.delete(key);
+            fallbackActiveKeysRef.current.delete(key);
+        };
+        return {
+            attach(key, host, create) {
+                let entry = fallbackEntriesRef.current.get(key);
+                if (!entry) {
+                    entry = { key, element: create(), lastUsedAt: Date.now() };
+                    fallbackEntriesRef.current.set(key, entry);
+                }
+                entry.lastUsedAt = Date.now();
+                fallbackActiveKeysRef.current.add(key);
+                host.appendChild(entry.element);
+                return entry.element;
+            },
+            release(key) {
+                removeFallbackEntry(key);
+            },
+            evict(key) {
+                removeFallbackEntry(key);
+            },
+            evictMatching(predicate) {
+                // The fallback pool only ever holds a single active entry and never
+                // parks, so `includeActive` makes no practical difference here — a
+                // matching entry is always removed regardless of that option.
+                const entries = Array.from(fallbackEntriesRef.current.values());
+                const keys = selectMatchingEvictions(entries, fallbackActiveKeysRef.current, predicate, true);
+                for (const key of keys)
+                    removeFallbackEntry(key);
+            },
+        };
+    }, []);
+    useEffect(() => () => {
+        for (const key of Array.from(fallbackEntriesRef.current.keys())) {
+            const entry = fallbackEntriesRef.current.get(key);
+            entry?.element.remove();
+            fallbackEntriesRef.current.delete(key);
+            fallbackActiveKeysRef.current.delete(key);
+        }
+    }, []);
+    return pool ?? fallbackPool;
+}
+//# sourceMappingURL=useIframeKeepAlivePool.js.map

package/dist/features/iframe-pool/react/hooks/useIframeKeepAlivePool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIframeKeepAlivePool.js","sourceRoot":"","sources":["../../../../../src/features/iframe-pool/react/hooks/useIframeKeepAlivePool.ts"],"names":[],"mappings":"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"}

package/dist/features/iframe-pool/react/pool-context.d.ts

@@ -0,0 +1,3 @@
+import type { IframeKeepAlivePoolValue } from '../types.js';
+export declare const IframeKeepAliveContext: import("react").Context<IframeKeepAlivePoolValue | null>;
+//# sourceMappingURL=pool-context.d.ts.map

package/dist/features/iframe-pool/react/pool-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool-context.d.ts","sourceRoot":"","sources":["../../../../src/features/iframe-pool/react/pool-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5D,eAAO,MAAM,sBAAsB,0DAAuD,CAAC"}

package/dist/features/iframe-pool/react/pool-context.js

@@ -0,0 +1,3 @@
+import { createContext } from 'react';
+export const IframeKeepAliveContext = createContext(null);
+//# sourceMappingURL=pool-context.js.map

package/dist/features/iframe-pool/react/pool-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool-context.js","sourceRoot":"","sources":["../../../../src/features/iframe-pool/react/pool-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAGtC,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAkC,IAAI,CAAC,CAAC"}

package/dist/features/iframe-pool/rules.d.ts

@@ -0,0 +1,17 @@
+import type { IframeKeepAlivePoolEntry } from './types.js';
+/**
+ * LRU eviction selection: given the pool's current entries and which keys
+ * are currently active (mounted/in-use), returns the keys of the
+ * least-recently-used *inactive* entries to remove so the total entry count
+ * no longer exceeds `maxMounted`. Never selects an active entry — an
+ * over-`maxMounted` pool with too few inactive entries simply stays over
+ * the limit until something is released. Generic over `TKey` so the LRU
+ * mechanics are independently testable and reusable outside this feature.
+ */
+export declare function selectLruEvictions<TKey>(entries: readonly IframeKeepAlivePoolEntry<TKey>[], activeKeys: ReadonlySet<TKey>, maxMounted: number): TKey[];
+/**
+ * Predicate-based eviction selection: every entry matching `predicate`,
+ * restricted to inactive entries unless `includeActive` is set.
+ */
+export declare function selectMatchingEvictions<TKey>(entries: readonly IframeKeepAlivePoolEntry<TKey>[], activeKeys: ReadonlySet<TKey>, predicate: (entry: IframeKeepAlivePoolEntry<TKey>) => boolean, includeActive: boolean): TKey[];
+//# sourceMappingURL=rules.d.ts.map

package/dist/features/iframe-pool/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/features/iframe-pool/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EACrC,OAAO,EAAE,SAAS,wBAAwB,CAAC,IAAI,CAAC,EAAE,EAClD,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC,EAC7B,UAAU,EAAE,MAAM,GACjB,IAAI,EAAE,CAcR;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAC1C,OAAO,EAAE,SAAS,wBAAwB,CAAC,IAAI,CAAC,EAAE,EAClD,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC,EAC7B,SAAS,EAAE,CAAC,KAAK,EAAE,wBAAwB,CAAC,IAAI,CAAC,KAAK,OAAO,EAC7D,aAAa,EAAE,OAAO,GACrB,IAAI,EAAE,CAIR"}

package/dist/features/iframe-pool/rules.js

@@ -0,0 +1,34 @@
+/**
+ * LRU eviction selection: given the pool's current entries and which keys
+ * are currently active (mounted/in-use), returns the keys of the
+ * least-recently-used *inactive* entries to remove so the total entry count
+ * no longer exceeds `maxMounted`. Never selects an active entry — an
+ * over-`maxMounted` pool with too few inactive entries simply stays over
+ * the limit until something is released. Generic over `TKey` so the LRU
+ * mechanics are independently testable and reusable outside this feature.
+ */
+export function selectLruEvictions(entries, activeKeys, maxMounted) {
+    const inactiveByLru = entries
+        .filter((entry) => !activeKeys.has(entry.key))
+        .slice()
+        .sort((a, b) => a.lastUsedAt - b.lastUsedAt);
+    const evictions = [];
+    let remaining = entries.length;
+    for (const entry of inactiveByLru) {
+        if (remaining <= maxMounted)
+            break;
+        evictions.push(entry.key);
+        remaining--;
+    }
+    return evictions;
+}
+/**
+ * Predicate-based eviction selection: every entry matching `predicate`,
+ * restricted to inactive entries unless `includeActive` is set.
+ */
+export function selectMatchingEvictions(entries, activeKeys, predicate, includeActive) {
+    return entries
+        .filter((entry) => (includeActive || !activeKeys.has(entry.key)) && predicate(entry))
+        .map((entry) => entry.key);
+}
+//# sourceMappingURL=rules.js.map

package/dist/features/iframe-pool/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../src/features/iframe-pool/rules.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAkD,EAClD,UAA6B,EAC7B,UAAkB;IAElB,MAAM,aAAa,GAAG,OAAO;SAC1B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SAC7C,KAAK,EAAE;SACP,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IAE/C,MAAM,SAAS,GAAW,EAAE,CAAC;IAC7B,IAAI,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,IAAI,SAAS,IAAI,UAAU;YAAE,MAAM;QACnC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,SAAS,EAAE,CAAC;IACd,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAkD,EAClD,UAA6B,EAC7B,SAA6D,EAC7D,aAAsB;IAEtB,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,aAAa,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC;SACpF,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC"}

package/dist/features/iframe-pool/types.d.ts

@@ -0,0 +1,24 @@
+export interface IframeKeepAlivePoolEntry<TKey = string> {
+    key: TKey;
+    element: HTMLIFrameElement;
+    lastUsedAt: number;
+}
+export interface IframeKeepAlivePoolEvictOptions {
+    /** Also remove the entry if it's currently mounted/active, not just parked. */
+    includeActive?: boolean;
+}
+export interface IframeKeepAlivePoolValue {
+    /** Mounts (or reuses) the iframe for `key` under `host`, creating it via `create()` on first use. */
+    attach(key: string, host: HTMLElement, create: () => HTMLIFrameElement): HTMLIFrameElement;
+    /** Marks `key` inactive and parks its iframe off-DOM instead of destroying it. */
+    release(key: string): void;
+    /** Destroys the iframe for `key` immediately, wherever it currently sits. */
+    evict(key: string): void;
+    /** Destroys every parked (or, with `includeActive`, every) entry `predicate` matches. */
+    evictMatching(predicate: (entry: IframeKeepAlivePoolEntry) => boolean, options?: IframeKeepAlivePoolEvictOptions): void;
+}
+export interface IframeKeepAlivePoolConfig {
+    /** Maximum iframes kept mounted (active + parked) at once. Defaults to `DEFAULT_MAX_MOUNTED_IFRAMES`. */
+    maxMounted?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/features/iframe-pool/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/iframe-pool/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB,CAAC,IAAI,GAAG,MAAM;IACrD,GAAG,EAAE,IAAI,CAAC;IACV,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,+BAA+B;IAC9C,+EAA+E;IAC/E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,qGAAqG;IACrG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;IAC3F,kFAAkF;IAClF,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,6EAA6E;IAC7E,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yFAAyF;IACzF,aAAa,CACX,SAAS,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,EACvD,OAAO,CAAC,EAAE,+BAA+B,GACxC,IAAI,CAAC;CACT;AAED,MAAM,WAAW,yBAAyB;IACxC,yGAAyG;IACzG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/features/iframe-pool/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/features/iframe-pool/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/iframe-pool/types.ts"],"names":[],"mappings":""}

package/dist/features/lexical-rich-text-editor/constants.d.ts

@@ -0,0 +1,16 @@
+import type { RichTextTriggerConfig } from './types.js';
+/** Lexical editor theme: maps node types to CSS class names. */
+export declare const EDITOR_THEME: {
+    readonly paragraph: "rich-text-input-paragraph";
+};
+export declare const DEFAULT_TEST_ID = "rich-text-input";
+/** Matches the origin's two triggers: an inline `@mention` and a
+ *  line-start-anchored `/command`. A host may override this entirely. */
+export declare const DEFAULT_TRIGGERS: readonly RichTextTriggerConfig[];
+/** CaretFloatingLayer positioning constants. */
+export declare const CARET_LAYER_GAP = 8;
+export declare const CARET_LAYER_MARGIN = 8;
+export declare const CARET_LAYER_HARD_MAX_HEIGHT = 460;
+export declare const CARET_LAYER_MIN_WIDTH = 320;
+export declare const CARET_LAYER_PREFERRED_WIDTH = 420;
+//# sourceMappingURL=constants.d.ts.map

package/dist/features/lexical-rich-text-editor/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/features/lexical-rich-text-editor/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,gEAAgE;AAChE,eAAO,MAAM,YAAY;;CAEf,CAAC;AAEX,eAAO,MAAM,eAAe,oBAAoB,CAAC;AAEjD;yEACyE;AACzE,eAAO,MAAM,gBAAgB,EAAE,SAAS,qBAAqB,EAG5D,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,2BAA2B,MAAM,CAAC"}

package/dist/features/lexical-rich-text-editor/constants.js

@@ -0,0 +1,18 @@
+/** Lexical editor theme: maps node types to CSS class names. */
+export const EDITOR_THEME = {
+    paragraph: 'rich-text-input-paragraph',
+};
+export const DEFAULT_TEST_ID = 'rich-text-input';
+/** Matches the origin's two triggers: an inline `@mention` and a
+ *  line-start-anchored `/command`. A host may override this entirely. */
+export const DEFAULT_TRIGGERS = [
+    { id: 'mention', character: '@', anchor: 'inline' },
+    { id: 'command', character: '/', anchor: 'line-start' },
+];
+/** CaretFloatingLayer positioning constants. */
+export const CARET_LAYER_GAP = 8; // gap between caret and popover edge
+export const CARET_LAYER_MARGIN = 8; // viewport edge margin
+export const CARET_LAYER_HARD_MAX_HEIGHT = 460; // never taller than this
+export const CARET_LAYER_MIN_WIDTH = 320;
+export const CARET_LAYER_PREFERRED_WIDTH = 420;
+//# sourceMappingURL=constants.js.map

package/dist/features/lexical-rich-text-editor/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/features/lexical-rich-text-editor/constants.ts"],"names":[],"mappings":"AAEA,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS,EAAE,2BAA2B;CAC9B,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAEjD;yEACyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAqC;IAChE,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE;IACnD,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE;CACxD,CAAC;AAEF,gDAAgD;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,CAAC,qCAAqC;AACvE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,CAAC,uBAAuB;AAC5D,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC,CAAC,yBAAyB;AACzE,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC"}

package/dist/features/lexical-rich-text-editor/deserialize.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Origin: `apps/web/src/components/composer/deserialize.ts`. Ported
+ * verbatim, except `buildInlineMentionParts` → `parseMentionParts` (this
+ * package's generalized mention parser, see `mention-parser.ts`).
+ */
+import { type LexicalEditor } from 'lexical';
+import type { MentionEntity } from './types.js';
+export declare function setRichTextFromPlainText(editor: LexicalEditor, text: string, knownMentions: MentionEntity[]): void;
+//# sourceMappingURL=deserialize.d.ts.map

package/dist/features/lexical-rich-text-editor/deserialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deserialize.d.ts","sourceRoot":"","sources":["../../../src/features/lexical-rich-text-editor/deserialize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQhD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,aAAa,EAAE,GAC7B,IAAI,CAyCN"}

package/dist/features/lexical-rich-text-editor/deserialize.js

@@ -0,0 +1,55 @@
+/**
+ * Origin: `apps/web/src/components/composer/deserialize.ts`. Ported
+ * verbatim, except `buildInlineMentionParts` → `parseMentionParts` (this
+ * package's generalized mention parser, see `mention-parser.ts`).
+ */
+import { $createLineBreakNode, $createParagraphNode, $createTextNode, $getRoot, } from 'lexical';
+import { $createMentionNode } from './mention-node.js';
+import { parseMentionParts } from './mention-parser.js';
+// Rebuild the whole editor from a plain `@token` string. Known `@token`
+// runs (matched against `knownMentions`) become atomic mention nodes;
+// everything else is plain text. Newlines map to LineBreakNodes inside a
+// single paragraph so serialization round-trips to a single `\n`. Caret is
+// placed at the end inside the same update so post-seed typing keeps the
+// caret.
+export function setRichTextFromPlainText(editor, text, knownMentions) {
+    // `discrete: true` commits the update synchronously. This matters both for
+    // tests reading the state back on the next line AND for a host's
+    // setText/clear → onChange round-trip, where a deferred update could let a
+    // stale serialize slip through before the rebuild lands. On a mounted
+    // editor it behaves like a normal update (just flushed immediately).
+    editor.update(() => {
+        const root = $getRoot();
+        root.clear();
+        const p = $createParagraphNode();
+        const lines = text.split('\n');
+        lines.forEach((line, i) => {
+            if (i > 0)
+                p.append($createLineBreakNode());
+            if (!line)
+                return;
+            const parts = parseMentionParts(line, knownMentions, { highlightUnknown: false });
+            if (!parts) {
+                p.append($createTextNode(line));
+                return;
+            }
+            for (const part of parts) {
+                if (part.kind === 'mention' && part.entity.kind !== 'unknown') {
+                    p.append($createMentionNode({
+                        mentionId: part.entity.id,
+                        mentionKind: part.entity.kind,
+                        token: part.text,
+                        label: part.entity.label,
+                        title: part.entity.title,
+                    }));
+                }
+                else if (part.text) {
+                    p.append($createTextNode(part.text));
+                }
+            }
+        });
+        root.append(p);
+        p.selectEnd();
+    }, { discrete: true });
+}
+//# sourceMappingURL=deserialize.js.map

package/dist/features/lexical-rich-text-editor/deserialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deserialize.js","sourceRoot":"","sources":["../../../src/features/lexical-rich-text-editor/deserialize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,QAAQ,GAET,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,wEAAwE;AACxE,sEAAsE;AACtE,yEAAyE;AACzE,2EAA2E;AAC3E,yEAAyE;AACzE,SAAS;AACT,MAAM,UAAU,wBAAwB,CACtC,MAAqB,EACrB,IAAY,EACZ,aAA8B;IAE9B,2EAA2E;IAC3E,iEAAiE;IACjE,2EAA2E;IAC3E,sEAAsE;IACtE,qEAAqE;IACrE,MAAM,CAAC,MAAM,CACX,GAAG,EAAE;QACH,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,oBAAoB,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACxB,IAAI,CAAC,GAAG,CAAC;gBAAE,CAAC,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC,CAAC;YAC5C,IAAI,CAAC,IAAI;gBAAE,OAAO;YAClB,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAC;YAClF,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;gBAChC,OAAO;YACT,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBAC9D,CAAC,CAAC,MAAM,CACN,kBAAkB,CAAC;wBACjB,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE;wBACzB,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;wBAC7B,KAAK,EAAE,IAAI,CAAC,IAAI;wBAChB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;wBACxB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;qBACzB,CAAC,CACH,CAAC;gBACJ,CAAC;qBAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBACrB,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBACvC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACf,CAAC,CAAC,SAAS,EAAE,CAAC;IAChB,CAAC,EACD,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;AACJ,CAAC"}

package/dist/features/lexical-rich-text-editor/index.d.ts

@@ -0,0 +1,12 @@
+export type { MentionEntity, MentionPart, MentionInsert, CaretRect, RichTextTriggerAnchor, RichTextTriggerConfig, RichTextTriggerMatch, PopoverNavigationKey, SerializedRichText, RichTextInputHandle, } from './types.js';
+export { DEFAULT_TRIGGERS, DEFAULT_TEST_ID } from './constants.js';
+export { buildMentionToken, parseMentionParts, isMentionBoundary, isMentionRightBoundary, mentionTokenPresent, foldPresentMentions, } from './mention-parser.js';
+export { MentionNode, $createMentionNode, $isMentionNode, type MentionPayload, type SerializedMentionNode, } from './mention-node.js';
+export { serializeRichText } from './serialize.js';
+export { setRichTextFromPlainText } from './deserialize.js';
+export { detectActiveTrigger, buildTriggerDeletionRegex, buildAnyTriggerDeletionRegex, buildTriggerMatch, readCaretRect, computeCaretFloatingLayerPosition, type CaretFloatingLayerPosition, } from './rules.js';
+export { RichTextInput, type RichTextInputProps } from './react/components/RichTextInput.js';
+export { CaretFloatingLayer, type CaretFloatingLayerProps, } from './react/components/CaretFloatingLayer.js';
+export { useMentionColorStamping, MENTION_COLOR_PROPERTY, } from './react/hooks/useMentionColorStamping.js';
+export { useCaretFloatingLayerPosition } from './react/hooks/useCaretFloatingLayerPosition.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/lexical-rich-text-editor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/lexical-rich-text-editor/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,WAAW,EACX,aAAa,EACb,SAAS,EACT,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEnE,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,4BAA4B,EAC5B,iBAAiB,EACjB,aAAa,EACb,iCAAiC,EACjC,KAAK,0BAA0B,GAChC,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC7F,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,6BAA6B,EAAE,MAAM,gDAAgD,CAAC"}

package/dist/features/lexical-rich-text-editor/index.js

@@ -0,0 +1,11 @@
+export { DEFAULT_TRIGGERS, DEFAULT_TEST_ID } from './constants.js';
+export { buildMentionToken, parseMentionParts, isMentionBoundary, isMentionRightBoundary, mentionTokenPresent, foldPresentMentions, } from './mention-parser.js';
+export { MentionNode, $createMentionNode, $isMentionNode, } from './mention-node.js';
+export { serializeRichText } from './serialize.js';
+export { setRichTextFromPlainText } from './deserialize.js';
+export { detectActiveTrigger, buildTriggerDeletionRegex, buildAnyTriggerDeletionRegex, buildTriggerMatch, readCaretRect, computeCaretFloatingLayerPosition, } from './rules.js';
+export { RichTextInput } from './react/components/RichTextInput.js';
+export { CaretFloatingLayer, } from './react/components/CaretFloatingLayer.js';
+export { useMentionColorStamping, MENTION_COLOR_PROPERTY, } from './react/hooks/useMentionColorStamping.js';
+export { useCaretFloatingLayerPosition } from './react/hooks/useCaretFloatingLayerPosition.js';
+//# sourceMappingURL=index.js.map

package/dist/features/lexical-rich-text-editor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/lexical-rich-text-editor/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEnE,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,cAAc,GAGf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,4BAA4B,EAC5B,iBAAiB,EACjB,aAAa,EACb,iCAAiC,GAElC,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAA2B,MAAM,qCAAqC,CAAC;AAC7F,OAAO,EACL,kBAAkB,GAEnB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,6BAA6B,EAAE,MAAM,gDAAgD,CAAC"}

package/dist/features/lexical-rich-text-editor/mention-node.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The atomic `@mention` node. Extends `TextNode` so the node's *text* remains
+ * the literal `@token` and serialization back to the wire format is free:
+ * `getTextContent()` already yields `@token`. Lexical token mode deletes the
+ * node as one entity but still allows character-by-character caret
+ * navigation, so `rules.ts` adds explicit keyboard normalization for arrows.
+ *
+ * Origin: `apps/web/src/components/composer/MentionNode.ts`. The origin
+ * imported OD's `connectorBrandColor`/`resolveBrandTheme` directly to color
+ * a `connector`-kind pill's `--m-hue` CSS custom property, and installed a
+ * document-wide `MutationObserver` to re-stamp every mounted pill on a live
+ * theme flip. Both are dropped from this node entirely — no per-instance
+ * color logic and no global observer belong on a generic Lexical node class.
+ * A host that wants per-kind/per-entity coloring supplies a
+ * `resolveMentionColor` callback to `RichTextInput`, applied by
+ * `react/hooks/useMentionColorStamping.ts` via Lexical's own
+ * `registerMutationListener` (scoped to that one editor instance, not the
+ * whole document) — see that file for the replacement mechanism.
+ */
+import { TextNode, type EditorConfig, type LexicalNode, type NodeKey, type SerializedTextNode, type Spread } from 'lexical';
+import type { MentionEntity } from './types.js';
+export interface MentionPayload {
+    mentionId: string;
+    mentionKind: string;
+    /** Literal `"@token"` — this IS the node text. */
+    token: string;
+    label: string;
+    title?: string | undefined;
+}
+export type SerializedMentionNode = Spread<{
+    mentionId: string;
+    mentionKind: string;
+    token: string;
+    label: string;
+    title?: string;
+}, SerializedTextNode>;
+export declare class MentionNode extends TextNode {
+    __mentionId: string;
+    __mentionKind: string;
+    __token: string;
+    __label: string;
+    __title: string | undefined;
+    static getType(): string;
+    static clone(node: MentionNode): MentionNode;
+    constructor(p: MentionPayload, text?: string, key?: NodeKey);
+    getEntity(): MentionEntity;
+    getToken(): string;
+    createDOM(config: EditorConfig): HTMLElement;
+    updateDOM(prev: this, dom: HTMLElement, config: EditorConfig): boolean;
+    isToken(): true;
+    exportJSON(): SerializedMentionNode;
+    static importJSON(json: SerializedMentionNode): MentionNode;
+}
+export declare function $createMentionNode(p: MentionPayload): MentionNode;
+export declare function $isMentionNode(n: LexicalNode | null | undefined): n is MentionNode;
+//# sourceMappingURL=mention-node.d.ts.map

package/dist/features/lexical-rich-text-editor/mention-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-node.d.ts","sourceRoot":"","sources":["../../../src/features/lexical-rich-text-editor/mention-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EACL,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,kBAAkB,EACvB,KAAK,MAAM,EACZ,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,CACxC;IACE,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,kBAAkB,CACnB,CAAC;AAEF,qBAAa,WAAY,SAAQ,QAAQ;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5B,MAAM,CAAC,OAAO,IAAI,MAAM;IAIxB,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW;gBAchC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO;IAe3D,SAAS,IAAI,aAAa;IAU1B,QAAQ,IAAI,MAAM;IAIlB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW;IAa5C,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO;IA0BtE,OAAO,IAAI,IAAI;IAIf,UAAU,IAAI,qBAAqB;IAanC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,qBAAqB,GAAG,WAAW;CAS5D;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,cAAc,GAAG,WAAW,CAQjE;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,IAAI,WAAW,CAElF"}

package/dist/features/lexical-rich-text-editor/mention-node.js

@@ -0,0 +1,142 @@
+/**
+ * The atomic `@mention` node. Extends `TextNode` so the node's *text* remains
+ * the literal `@token` and serialization back to the wire format is free:
+ * `getTextContent()` already yields `@token`. Lexical token mode deletes the
+ * node as one entity but still allows character-by-character caret
+ * navigation, so `rules.ts` adds explicit keyboard normalization for arrows.
+ *
+ * Origin: `apps/web/src/components/composer/MentionNode.ts`. The origin
+ * imported OD's `connectorBrandColor`/`resolveBrandTheme` directly to color
+ * a `connector`-kind pill's `--m-hue` CSS custom property, and installed a
+ * document-wide `MutationObserver` to re-stamp every mounted pill on a live
+ * theme flip. Both are dropped from this node entirely — no per-instance
+ * color logic and no global observer belong on a generic Lexical node class.
+ * A host that wants per-kind/per-entity coloring supplies a
+ * `resolveMentionColor` callback to `RichTextInput`, applied by
+ * `react/hooks/useMentionColorStamping.ts` via Lexical's own
+ * `registerMutationListener` (scoped to that one editor instance, not the
+ * whole document) — see that file for the replacement mechanism.
+ */
+import { TextNode, } from 'lexical';
+export class MentionNode extends TextNode {
+    __mentionId;
+    __mentionKind;
+    __token;
+    __label;
+    __title;
+    static getType() {
+        return 'rich-text-mention';
+    }
+    static clone(node) {
+        return new MentionNode({
+            mentionId: node.__mentionId,
+            mentionKind: node.__mentionKind,
+            token: node.__token,
+            label: node.__label,
+            title: node.__title,
+        }, node.__text, node.__key);
+    }
+    constructor(p, text, key) {
+        super(text ?? p.token, key); // node TEXT = token → serializes verbatim
+        this.__mentionId = p.mentionId;
+        this.__mentionKind = p.mentionKind;
+        this.__token = p.token;
+        this.__label = p.label;
+        this.__title = p.title;
+        // NOTE: token mode is applied in $createMentionNode, NOT here. Calling
+        // this.setMode('token') in the constructor recurses to a stack overflow:
+        // setMode → getWritable → (for an existing node) clone() → new
+        // MentionNode → setMode → … Lexical's clone protocol copies `__mode`
+        // from the previous node in `TextNode.afterCloneFrom`, so clones
+        // preserve token mode without re-running setMode.
+    }
+    getEntity() {
+        return {
+            id: this.__mentionId,
+            kind: this.__mentionKind,
+            label: this.__label,
+            token: this.__token,
+            ...(this.__title ? { title: this.__title } : {}),
+        };
+    }
+    getToken() {
+        return this.__token;
+    }
+    createDOM(config) {
+        const dom = super.createDOM(config); // <span> wrapping the token text
+        dom.className = `rich-text-mention rich-text-mention--${this.__mentionKind}`;
+        dom.contentEditable = 'false';
+        dom.setAttribute('contenteditable', 'false');
+        dom.setAttribute('data-mention', '');
+        dom.setAttribute('data-mention-id', this.__mentionId);
+        dom.setAttribute('data-mention-kind', this.__mentionKind);
+        dom.setAttribute('data-mention-label', this.__label);
+        if (this.__title)
+            dom.setAttribute('title', this.__title);
+        return dom;
+    }
+    updateDOM(prev, dom, config) {
+        // `TextNode.updateDOM` declares its previous-node param with a polymorphic
+        // `this`. Match that signature exactly so the override is type-compatible;
+        // inside MentionNode `this` is MentionNode, so the `__mention*` reads below
+        // are still well typed.
+        const updated = super.updateDOM(prev, dom, config);
+        if (prev.__mentionKind !== this.__mentionKind) {
+            dom.className = `rich-text-mention rich-text-mention--${this.__mentionKind}`;
+            dom.setAttribute('data-mention-kind', this.__mentionKind);
+        }
+        if (prev.__label !== this.__label) {
+            dom.setAttribute('data-mention-label', this.__label);
+        }
+        if (prev.__mentionId !== this.__mentionId) {
+            dom.setAttribute('data-mention-id', this.__mentionId);
+        }
+        if (prev.__title !== this.__title) {
+            if (this.__title)
+                dom.setAttribute('title', this.__title);
+            else
+                dom.removeAttribute('title');
+        }
+        return updated;
+    }
+    // Token mode keeps the mention indivisible. Text must still be insertable on
+    // either side as sibling text nodes so users can click/arrow around a pill
+    // and continue writing inline.
+    isToken() {
+        return true;
+    }
+    exportJSON() {
+        return {
+            ...super.exportJSON(),
+            type: MentionNode.getType(),
+            version: 1,
+            mentionId: this.__mentionId,
+            mentionKind: this.__mentionKind,
+            token: this.__token,
+            label: this.__label,
+            ...(this.__title ? { title: this.__title } : {}),
+        };
+    }
+    static importJSON(json) {
+        return $createMentionNode({
+            mentionId: json.mentionId,
+            mentionKind: json.mentionKind,
+            token: json.token,
+            label: json.label,
+            title: json.title,
+        });
+    }
+}
+export function $createMentionNode(p) {
+    // setMode here (on a freshly-created node, before it is cloned) is safe:
+    // getWritable returns the node itself, so there is no clone recursion. All
+    // later clones inherit the mode via TextNode.afterCloneFrom. Keep token
+    // mode out of the constructor (see the note there).
+    const node = new MentionNode(p);
+    node.setMode('token'); // atomic: single caret stop, whole-node delete
+    return node;
+}
+export function $isMentionNode(n) {
+    return n instanceof MentionNode;
+}
+//# sourceMappingURL=mention-node.js.map

package/dist/features/lexical-rich-text-editor/mention-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-node.js","sourceRoot":"","sources":["../../../src/features/lexical-rich-text-editor/mention-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EACL,QAAQ,GAMT,MAAM,SAAS,CAAC;AAuBjB,MAAM,OAAO,WAAY,SAAQ,QAAQ;IACvC,WAAW,CAAS;IACpB,aAAa,CAAS;IACtB,OAAO,CAAS;IAChB,OAAO,CAAS;IAChB,OAAO,CAAqB;IAE5B,MAAM,CAAC,OAAO;QACZ,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAiB;QAC5B,OAAO,IAAI,WAAW,CACpB;YACE,SAAS,EAAE,IAAI,CAAC,WAAW;YAC3B,WAAW,EAAE,IAAI,CAAC,aAAa;YAC/B,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,KAAK,EAAE,IAAI,CAAC,OAAO;SACpB,EACD,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,KAAK,CACX,CAAC;IACJ,CAAC;IAED,YAAY,CAAiB,EAAE,IAAa,EAAE,GAAa;QACzD,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,0CAA0C;QACvE,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,SAAS,CAAC;QAC/B,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC;QACvB,uEAAuE;QACvE,yEAAyE;QACzE,+DAA+D;QAC/D,qEAAqE;QACrE,iEAAiE;QACjE,kDAAkD;IACpD,CAAC;IAED,SAAS;QACP,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,WAAW;YACpB,IAAI,EAAE,IAAI,CAAC,aAAa;YACxB,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD,CAAC;IACJ,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,SAAS,CAAC,MAAoB;QAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,iCAAiC;QACtE,GAAG,CAAC,SAAS,GAAG,wCAAwC,IAAI,CAAC,aAAa,EAAE,CAAC;QAC7E,GAAG,CAAC,eAAe,GAAG,OAAO,CAAC;QAC9B,GAAG,CAAC,YAAY,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;QAC7C,GAAG,CAAC,YAAY,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACrC,GAAG,CAAC,YAAY,CAAC,iBAAiB,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACtD,GAAG,CAAC,YAAY,CAAC,mBAAmB,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1D,GAAG,CAAC,YAAY,CAAC,oBAAoB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACrD,IAAI,IAAI,CAAC,OAAO;YAAE,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1D,OAAO,GAAG,CAAC;IACb,CAAC;IAED,SAAS,CAAC,IAAU,EAAE,GAAgB,EAAE,MAAoB;QAC1D,2EAA2E;QAC3E,2EAA2E;QAC3E,4EAA4E;QAC5E,wBAAwB;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;YAC9C,GAAG,CAAC,SAAS,GAAG,wCAAwC,IAAI,CAAC,aAAa,EAAE,CAAC;YAC7E,GAAG,CAAC,YAAY,CAAC,mBAAmB,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,GAAG,CAAC,YAAY,CAAC,oBAAoB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,GAAG,CAAC,YAAY,CAAC,iBAAiB,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,OAAO;gBAAE,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;;gBACrD,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,6EAA6E;IAC7E,2EAA2E;IAC3E,+BAA+B;IAC/B,OAAO;QACL,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU;QACR,OAAO;YACL,GAAG,KAAK,CAAC,UAAU,EAAE;YACrB,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE;YAC3B,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,IAAI,CAAC,WAAW;YAC3B,WAAW,EAAE,IAAI,CAAC,aAAa;YAC/B,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,IAA2B;QAC3C,OAAO,kBAAkB,CAAC;YACxB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAiB;IAClD,yEAAyE;IACzE,2EAA2E;IAC3E,wEAAwE;IACxE,oDAAoD;IACpD,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,+CAA+C;IACtE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAiC;IAC9D,OAAO,CAAC,YAAY,WAAW,CAAC;AAClC,CAAC"}

package/dist/features/lexical-rich-text-editor/mention-parser.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Parses `@token` mentions out of a committed plain-text string. This is the
+ * "reconcile a document model back into a string" side of the picture —
+ * used by `deserialize.ts` to decide which `@token` runs become atomic
+ * mention nodes, and available to hosts that need the same rule to fold
+ * plain-text-typed `@token`s into a "currently referenced" entity list.
+ *
+ * Origin: `apps/web/src/utils/inlineMentions.ts`. Ported verbatim (trie-based
+ * longest-match lookup, left/right boundary rules) — the only OD-specific
+ * surface was `InlineMentionKind`'s fixed union, replaced by `MentionEntity`'s
+ * free-form `kind: string` (see `types.ts`).
+ */
+import type { MentionEntity, MentionPart } from './types.js';
+export declare function buildMentionToken(label: string): string;
+export declare function parseMentionParts(text: string, entities: MentionEntity[], options?: {
+    highlightUnknown?: boolean;
+}): MentionPart[] | null;
+/**
+ * Left boundary rule: `@<token>` is a candidate mention only when the
+ * character before `@` is the start of the string or whitespace / opening
+ * bracket / quote.
+ */
+export declare function isMentionBoundary(text: string, start: number): boolean;
+/**
+ * Right boundary rule: the unknown-mention regex is `/@[^\s@]+/`, so a
+ * `@<token>` candidate is the full mention only when the character after the
+ * token is the end of the string, whitespace, or another `@`.
+ */
+export declare function isMentionRightBoundary(text: string, end: number): boolean;
+/**
+ * Whether `@label` appears in `text` as a standalone inline mention (proper
+ * left boundary, not a substring of a longer word). Useful for a host that
+ * reconciles a "currently referenced" entity list against typed text at
+ * submit time — a chip whose `@token` the user deleted should not be kept.
+ */
+export declare function mentionTokenPresent(text: string, label: string): boolean;
+/**
+ * Folds plain-text `@token` runs that still match a known entity into
+ * `present` (entities already backed by an atomic mention node in the
+ * tree). A host that inserts mentions as plain text rather than atomic
+ * nodes (e.g. via `insertText` instead of `insertMention`) needs this to
+ * keep a "currently referenced" list in sync with what's actually typed.
+ *
+ * Origin: `LexicalComposerInput.tsx`'s `foldPresentEntities`.
+ */
+export declare function foldPresentMentions(text: string, present: MentionEntity[], known: MentionEntity[]): MentionEntity[];
+//# sourceMappingURL=mention-parser.d.ts.map

package/dist/features/lexical-rich-text-editor/mention-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-parser.d.ts","sourceRoot":"","sources":["../../../src/features/lexical-rich-text-editor/mention-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3C,WAAW,EAAE,GAAG,IAAI,CAyDtB;AAkHD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAMtE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAKzE;AAsBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAexE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,aAAa,EAAE,EACxB,KAAK,EAAE,aAAa,EAAE,GACrB,aAAa,EAAE,CAgBjB"}