@jini-ai/ui 0.1.0

package/dist/features/rich-text-input/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/rich-text-input/mention-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-node.js","sourceRoot":"","sources":["../../../src/features/rich-text-input/mention-node.ts"],"names":[],"mappings":"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"}

package/dist/features/rich-text-input/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/rich-text-input/mention-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-parser.d.ts","sourceRoot":"","sources":["../../../src/features/rich-text-input/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"}

package/dist/features/rich-text-input/mention-parser.js

@@ -0,0 +1,239 @@
+export function buildMentionToken(label) {
+    return label.startsWith('@') ? label : `@${label}`;
+}
+export function parseMentionParts(text, entities, options = {}) {
+    if (!text)
+        return null;
+    if (!text.includes('@'))
+        return null;
+    const highlightUnknown = options.highlightUnknown ?? true;
+    const known = getMentionTokenIndex(entities);
+    const parts = [];
+    let scanStart = 0;
+    let copiedUntil = 0;
+    let found = false;
+    while (scanStart < text.length) {
+        const start = text.indexOf('@', scanStart);
+        if (start === -1)
+            break;
+        if (!isMentionBoundary(text, start)) {
+            scanStart = start + 1;
+            continue;
+        }
+        const knownMatch = findKnownMentionAt(text, known, start);
+        const unknownMatch = highlightUnknown ? findUnknownMentionAt(text, start) : null;
+        const match = knownMatch && (!unknownMatch || knownMatch.token.length >= unknownMatch.token.length)
+            ? knownMatch
+            : unknownMatch;
+        if (!match) {
+            scanStart = start + 1;
+            continue;
+        }
+        if (match.start > copiedUntil) {
+            parts.push({ kind: 'text', text: text.slice(copiedUntil, match.start) });
+        }
+        parts.push({
+            kind: 'mention',
+            entity: match.entity,
+            text: match.token,
+        });
+        found = true;
+        copiedUntil = match.start + match.token.length;
+        scanStart = copiedUntil;
+    }
+    if (copiedUntil < text.length) {
+        parts.push({ kind: 'text', text: text.slice(copiedUntil) });
+    }
+    // Every 'text' part pushed above is guarded to be non-empty (`match.start
+    // > copiedUntil` / `copiedUntil < text.length`), and each is immediately
+    // followed by that iteration's mention part — so `parts` never contains
+    // an empty or adjacent-duplicate 'text' entry that would need coalescing.
+    // An earlier version of this function ran the result through a
+    // coalesce-adjacent-and-drop-empty pass copied from the origin; removed
+    // per this package's coverage-driven-refactor policy once the loop proved
+    // every branch of that pass was unreachable from this one real call site
+    // (Phase 9.5: a dead branch gets refactored out, not padded with a test).
+    return found ? parts : null;
+}
+const mentionTokenIndexCache = new WeakMap();
+function getMentionTokenIndex(entities) {
+    const cached = mentionTokenIndexCache.get(entities);
+    if (cached)
+        return cached;
+    const root = { children: new Map() };
+    const seen = new Set();
+    const normalized = entities
+        .map((entity) => {
+        const token = entity.token ?? buildMentionToken(entity.label);
+        return {
+            id: entity.id,
+            kind: entity.kind,
+            label: entity.label,
+            token,
+            ...(entity.title ? { title: entity.title } : {}),
+        };
+    })
+        .filter((entity) => {
+        if (!entity.token || entity.token === '@')
+            return false;
+        const key = `${entity.kind}:${entity.token}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    })
+        // The preceding .filter() step already excludes every entity whose
+        // `token` is falsy, so by the time .sort() runs every element's `token`
+        // is a real string — the `!` documents that (noUncheckedIndexedAccess
+        // makes `.length` on an optional string require narrowing) rather than
+        // adding an unreachable `?? 0` fallback branch no real input can hit.
+        .sort((a, b) => b.token.length - a.token.length);
+    for (const entity of normalized) {
+        // `normalized` was already filtered above to exclude any falsy/`'@'`
+        // token, so `token` here is always a real, non-`'@'` string.
+        const token = entity.token;
+        let node = root;
+        for (const char of token) {
+            let child = node.children.get(char);
+            if (!child) {
+                child = { children: new Map() };
+                node.children.set(char, child);
+            }
+            node = child;
+        }
+        if (!node.entity) {
+            node.entity = entity;
+            node.token = token;
+        }
+    }
+    const index = { root };
+    mentionTokenIndexCache.set(entities, index);
+    return index;
+}
+function findKnownMentionAt(text, index, start) {
+    let best = null;
+    let node = index.root;
+    for (let i = start; i < text.length; i += 1) {
+        // `i < text.length` is the loop condition itself, so `text[i]` is always
+        // defined here — the `!` documents that instead of adding an
+        // unreachable `?? ''` fallback (noUncheckedIndexedAccess requires
+        // narrowing a string index read either way).
+        node = node.children.get(text[i]);
+        if (!node)
+            break;
+        if (node.entity && node.token && isMentionRightBoundary(text, i + 1)) {
+            best = { start, token: node.token, entity: node.entity };
+        }
+    }
+    return best;
+}
+function findUnknownMentionAt(text, start) {
+    let end = start + 1;
+    // Both `text[end]` reads below are only ever evaluated once a preceding
+    // `end < text.length` check (the `||`'s left side / the `&&`'s left side)
+    // has already passed, so `text[end]` is always defined — `!` documents
+    // that instead of an unreachable `?? ''` fallback.
+    if (end >= text.length || /[\s@]/.test(text[end]))
+        return null;
+    while (end < text.length && !/[\s@]/.test(text[end])) {
+        end += 1;
+    }
+    const token = text.slice(start, end);
+    return {
+        start,
+        token,
+        entity: {
+            id: `unknown:${token}`,
+            kind: 'unknown',
+            label: token.slice(1),
+            token,
+            title: token,
+        },
+    };
+}
+/**
+ * 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 function isMentionBoundary(text, start) {
+    if (start === 0)
+        return true;
+    // `start > 0` here (the `start === 0` case already returned), so
+    // `start - 1` is always a valid index — `!` documents that instead of an
+    // unreachable `?? ''` fallback.
+    return /[\s([{"']/.test(text[start - 1]);
+}
+/**
+ * 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 function isMentionRightBoundary(text, end) {
+    if (end >= text.length)
+        return true;
+    // `end < text.length` here — `!` documents the always-defined read
+    // instead of an unreachable `?? ''` fallback.
+    return /[\s@]/.test(text[end]);
+}
+/**
+ * Submit-time right boundary for reconciling a *still-visible atomic pill*
+ * against serialized text. Looser than `isMentionRightBoundary`: a pill stays
+ * "referenced" even when the user types trailing punctuation right after it
+ * (e.g. `@Slack,` or `@Notion.`), so the character after the token may also
+ * be sentence/clause punctuation that cannot be part of a mention token.
+ */
+function isMentionSubmitRightBoundary(text, end) {
+    if (end >= text.length)
+        return true;
+    // `end < text.length` here — `!` documents the always-defined read
+    // instead of an unreachable `?? ''` fallback.
+    return /[\s@,.;:!?)\]}"'»”’]/.test(text[end]);
+}
+/**
+ * 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 function mentionTokenPresent(text, label) {
+    const token = buildMentionToken(label);
+    let from = 0;
+    let start = text.indexOf(token, from);
+    while (start !== -1) {
+        if (isMentionBoundary(text, start) &&
+            isMentionSubmitRightBoundary(text, start + token.length)) {
+            return true;
+        }
+        from = start + 1;
+        start = text.indexOf(token, from);
+    }
+    return false;
+}
+/**
+ * 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 function foldPresentMentions(text, present, known) {
+    const result = [...present];
+    const seen = new Set(present.map((e) => `${e.kind}:${e.id}`));
+    const parts = parseMentionParts(text, known, { highlightUnknown: false });
+    if (parts) {
+        for (const part of parts) {
+            if (part.kind === 'mention' && part.entity.kind !== 'unknown') {
+                const key = `${part.entity.kind}:${part.entity.id}`;
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    result.push(part.entity);
+                }
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=mention-parser.js.map

package/dist/features/rich-text-input/mention-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-parser.js","sourceRoot":"","sources":["../../../src/features/rich-text-input/mention-parser.ts"],"names":[],"mappings":"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"}

package/dist/features/rich-text-input/react/components/CaretFloatingLayer.d.ts

@@ -0,0 +1,20 @@
+import type { ReactNode, RefObject } from 'react';
+import type { CaretRect } from '../../types.js';
+export interface CaretFloatingLayerProps {
+    /** Where to anchor the popover — typically the trigger match's
+     *  `anchorRect`, or `null` while no trigger is active. */
+    caret: CaretRect | null;
+    open: boolean;
+    /** Confines the popover's left/right clamp to this element's box instead
+     *  of the whole viewport (e.g. a chat panel narrower than the window). */
+    boundaryRef?: RefObject<HTMLElement | null> | undefined;
+    children: ReactNode;
+    className?: string;
+}
+/** Origin: `apps/web/src/components/composer/CaretFloatingLayer.tsx`. A
+ *  portal (`document.body`) positioned against a caret rect — the
+ *  mention/command popover renders inside this. No OD-specific surface;
+ *  ported verbatim except for the extracted `useCaretFloatingLayerPosition`
+ *  hook and generic class/CSS-variable names. */
+export declare function CaretFloatingLayer({ caret, open, boundaryRef, children, className, }: CaretFloatingLayerProps): import("react").ReactPortal | null;
+//# sourceMappingURL=CaretFloatingLayer.d.ts.map

package/dist/features/rich-text-input/react/components/CaretFloatingLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CaretFloatingLayer.d.ts","sourceRoot":"","sources":["../../../../../src/features/rich-text-input/react/components/CaretFloatingLayer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,MAAM,WAAW,uBAAuB;IACtC;8DAC0D;IAC1D,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC;IACd;8EAC0E;IAC1E,WAAW,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IACxD,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;iDAIiD;AACjD,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,SAA4C,GAC7C,EAAE,uBAAuB,sCA4BzB"}

package/dist/features/rich-text-input/react/components/CaretFloatingLayer.js

@@ -0,0 +1,33 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createPortal } from 'react-dom';
+import { CARET_LAYER_PREFERRED_WIDTH } from '../../constants.js';
+import { useCaretFloatingLayerPosition } from '../hooks/useCaretFloatingLayerPosition.js';
+/** Origin: `apps/web/src/components/composer/CaretFloatingLayer.tsx`. A
+ *  portal (`document.body`) positioned against a caret rect — the
+ *  mention/command popover renders inside this. No OD-specific surface;
+ *  ported verbatim except for the extracted `useCaretFloatingLayerPosition`
+ *  hook and generic class/CSS-variable names. */
+export function CaretFloatingLayer({ caret, open, boundaryRef, children, className = 'rich-text-caret-floating-layer', }) {
+    const { pos, layerRef } = useCaretFloatingLayerPosition(caret, open, boundaryRef);
+    if (!open || !caret || typeof document === 'undefined')
+        return null;
+    const style = pos
+        ? {
+            position: 'fixed',
+            left: `${pos.left}px`,
+            top: `${pos.top}px`,
+            width: `${pos.width}px`,
+            ['--rich-text-caret-layer-max-height']: `${pos.maxHeight}px`,
+        }
+        : {
+            // Pre-measure off-screen so sizing causes no flash.
+            position: 'fixed',
+            left: '-9999px',
+            top: '0px',
+            width: `${CARET_LAYER_PREFERRED_WIDTH}px`,
+            visibility: 'hidden',
+        };
+    return createPortal(_jsx("div", { ref: layerRef, className: className, "data-placement": pos?.placement ?? 'above', style: style, children: children }), document.body);
+}
+//# sourceMappingURL=CaretFloatingLayer.js.map

package/dist/features/rich-text-input/react/components/CaretFloatingLayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CaretFloatingLayer.js","sourceRoot":"","sources":["../../../../../src/features/rich-text-input/react/components/CaretFloatingLayer.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;AAc1F;;;;iDAIiD;AACjD,MAAM,UAAU,kBAAkB,CAAC,EACjC,KAAK,EACL,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,SAAS,GAAG,gCAAgC,GACpB;IACxB,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,6BAA6B,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAElF,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAEpE,MAAM,KAAK,GAAkB,GAAG;QAC9B,CAAC,CAAC;YACE,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,GAAG,GAAG,CAAC,IAAI,IAAI;YACrB,GAAG,EAAE,GAAG,GAAG,CAAC,GAAG,IAAI;YACnB,KAAK,EAAE,GAAG,GAAG,CAAC,KAAK,IAAI;YACvB,CAAC,oCAA8C,CAAC,EAAE,GAAG,GAAG,CAAC,SAAS,IAAI;SACvE;QACH,CAAC,CAAC;YACE,oDAAoD;YACpD,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,SAAS;YACf,GAAG,EAAE,KAAK;YACV,KAAK,EAAE,GAAG,2BAA2B,IAAI;YACzC,UAAU,EAAE,QAAQ;SACrB,CAAC;IAEN,OAAO,YAAY,CACjB,cAAK,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,oBAAkB,GAAG,EAAE,SAAS,IAAI,OAAO,EAAE,KAAK,EAAE,KAAK,YAC9F,QAAQ,GACL,EACN,QAAQ,CAAC,IAAI,CACd,CAAC;AACJ,CAAC"}

package/dist/features/rich-text-input/react/components/RichTextInput.d.ts

@@ -0,0 +1,61 @@
+import type { MentionEntity, PopoverNavigationKey, RichTextInputHandle, RichTextTriggerConfig, RichTextTriggerMatch } from '../../types.js';
+export interface RichTextInputProps {
+    placeholder: string;
+    /** Host-controlled value. Reseeded into the editor only when it changes
+     *  for a reason other than the user's own typing — see `useSeededValue`. */
+    value: string;
+    /** Rendered as pills (via `setText`/seeding) and used to fold plain-text
+     *  `@token`s into the reported mention list. */
+    knownMentions: MentionEntity[];
+    /** Fires on every real text change with the serialized plain text + the
+     *  mentions currently referenced by it (atomic nodes + matched plain
+     *  `@token`s). */
+    onChange(text: string, mentions: MentionEntity[]): void;
+    /** The trigger (if any) active at the caret, e.g. to drive a popover. */
+    onTriggerChange(match: RichTextTriggerMatch | null): void;
+    /** Plain Enter with no popover open and no IME composition in progress. */
+    onSubmit(): void;
+    /** Pasted files/images — omit to fall back to plain-text paste only. */
+    onPasteFiles?: ((files: File[]) => void) | undefined;
+    /** Whether a popover is open; gates the arrow/tab/enter/escape routing. */
+    popoverOpen: boolean;
+    /** Routes a popover key to the host; returns true when the host consumed it. */
+    onPopoverKey(key: PopoverNavigationKey): boolean;
+    /** Optional combobox a11y: announces the active row of a portaled listbox
+     *  without moving DOM focus. */
+    comboboxAria?: {
+        activeId: string | null;
+        expanded: boolean;
+    } | undefined;
+    title?: string | undefined;
+    testId?: string | undefined;
+    /** `aria-controls` target — must match the host's portaled listbox id. */
+    mentionListboxId?: string | undefined;
+    namespace?: string | undefined;
+    /** Which trigger characters are recognized at the caret. Defaults to an
+     *  inline `@mention` + a line-start-anchored `/command`, matching the
+     *  origin. Pass `[]` to disable trigger detection entirely. */
+    triggers?: readonly RichTextTriggerConfig[] | undefined;
+    /** Which `triggers` entry's character `insertMention` deletes before
+     *  splicing in the picked mention node. Defaults to `'mention'`. */
+    mentionTriggerId?: string | undefined;
+    /** Resolves a per-mention color, applied as a CSS custom property on that
+     *  mention's DOM element — see `useMentionColorStamping`. Omit for
+     *  CSS-only (className-driven) mention styling. */
+    resolveMentionColor?: ((mention: MentionEntity) => string | undefined) | undefined;
+}
+/**
+ * Origin: `apps/web/src/components/composer/LexicalComposerInput.tsx` (OD's
+ * chat composer input). A plain-text Lexical editor (not a full block/marks
+ * rich text editor) with atomic `@mention`/`/command` trigger tokens, a
+ * single-paragraph model (Enter submits, Shift+Enter soft-breaks), and an
+ * imperative handle mirroring a controlled `<textarea>`'s usual operations.
+ *
+ * The origin's `EditorRefPlugin` (a ref-bridging plugin needed because its
+ * `forwardRef` component lived OUTSIDE the `LexicalComposer` context) is
+ * dropped: `EditorSurface` above is itself inside that context, so its
+ * `useImperativeHandle` reads `editor` directly from
+ * `useLexicalComposerContext()`.
+ */
+export declare const RichTextInput: import("react").ForwardRefExoticComponent<RichTextInputProps & import("react").RefAttributes<RichTextInputHandle>>;
+//# sourceMappingURL=RichTextInput.d.ts.map

package/dist/features/rich-text-input/react/components/RichTextInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RichTextInput.d.ts","sourceRoot":"","sources":["../../../../../src/features/rich-text-input/react/components/RichTextInput.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,aAAa,EAEb,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AAWxB,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB;gFAC4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd;oDACgD;IAChD,aAAa,EAAE,aAAa,EAAE,CAAC;IAC/B;;sBAEkB;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IACxD,yEAAyE;IACzE,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1D,2EAA2E;IAC3E,QAAQ,IAAI,IAAI,CAAC;IACjB,wEAAwE;IACxE,YAAY,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACrD,2EAA2E;IAC3E,WAAW,EAAE,OAAO,CAAC;IACrB,gFAAgF;IAChF,YAAY,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC;IACjD;oCACgC;IAChC,YAAY,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IAC1E,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;mEAE+D;IAC/D,QAAQ,CAAC,EAAE,SAAS,qBAAqB,EAAE,GAAG,SAAS,CAAC;IACxD;wEACoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC;;uDAEmD;IACnD,mBAAmB,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,aAAa,KAAK,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CACpF;AAgKD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,oHAuBzB,CAAC"}