@ttt-productions/chat-react 0.2.0

package/README.md

@@ -0,0 +1,31 @@
+# @ttt-productions/chat-react
+
+Chat **React UI** for TTT Productions apps: chat shell, composer, message list,
+attachment UI, the generic mention autocomplete UI, the name-resolver context,
+and the realtime-newest-window + infinite-older hooks.
+
+Built on the pure [`@ttt-productions/chat-core`](../chat-core) package
+(contracts, mention parser/serializer, grouping). A non-React consumer (a Cloud
+Function, a script, a future native/TV client) installs `chat-core` and pulls
+in none of this frontend tree.
+
+## Entry points
+
+- `.` — React components, hooks, the Firebase-client adapter config types
+  (`ChatCoreConfig`, `ChatAttachmentConfig`, `ChatUploadAdapter`,
+  `ChatMentionConfig`), and the React render types (`MessageRenderer`,
+  `RenderableMentionProvider`, `MentionResultRenderer`).
+- `./styles` — chat CSS. Import once in your app layout:
+  `import "@ttt-productions/chat-react/styles";`
+
+## Peers
+
+`react`, `react-dom`, `firebase`, `@tanstack/react-query`, and `lucide-react`
+are optional peers — provided by the consuming app.
+
+## Boundary
+
+`chat-react` does not import `ttt-core`, does not hardcode TTT origins, and does
+not build TTT storage paths. Consumers pass a chat upload adapter with opaque
+origin id, upload path builder, and optional metadata builder. TTT mention
+kinds, permissions, provider lists, routing, and search live in TTT code.

package/dist/context/ChatNameResolverContext.d.ts

@@ -0,0 +1,37 @@
+import * as React from "react";
+import type { ChatNameResolver, ChatPrewarmSenders } from "@ttt-productions/chat-core";
+type ChatNameResolverContextValue = {
+    resolveName: ChatNameResolver;
+    prewarm?: ChatPrewarmSenders;
+};
+export type ChatNameResolverProviderProps = {
+    resolveName: ChatNameResolver;
+    prewarm?: ChatPrewarmSenders;
+    children: React.ReactNode;
+};
+/**
+ * Wraps any chat-core consumer (typically the whole app shell) and provides
+ * a name resolver. Required for any tree that renders <ChatShell>, <MessageList>,
+ * or <MessageItemDefault>.
+ */
+export declare function ChatNameResolverProvider(props: ChatNameResolverProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Strict hook — throws if no provider is wrapped. Used inside chat-core's
+ * own renderers (MessageItemDefault, ReplyQuote) so a missing setup surfaces
+ * immediately on first render rather than silently rendering "User".
+ */
+export declare function useChatNameResolver(): ChatNameResolverContextValue;
+/**
+ * Optional variant — returns null instead of throwing when no provider is
+ * wrapped. Used internally by useChatMessages so headless callers (tests,
+ * data-only consumers that don't render UI) can still use the hook.
+ */
+export declare function useOptionalChatNameResolver(): ChatNameResolverContextValue | null;
+/**
+ * Convenience hook for renderers. Returns a resolved string — never null —
+ * by falling back to "User" when the cache hasn't filled yet. Re-renders
+ * automatically once the upstream cache settles.
+ */
+export declare function useResolvedSenderName(senderId: string): string;
+export {};
+//# sourceMappingURL=ChatNameResolverContext.d.ts.map

package/dist/context/ChatNameResolverContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatNameResolverContext.d.ts","sourceRoot":"","sources":["../../src/context/ChatNameResolverContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEvF,KAAK,4BAA4B,GAAG;IAClC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAIF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,WAAW,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,2CAQ5E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,4BAA4B,CAQlE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,4BAA4B,GAAG,IAAI,CAEjF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG9D"}

package/dist/context/ChatNameResolverContext.js

@@ -0,0 +1,44 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as React from "react";
+const ChatNameResolverContext = React.createContext(null);
+/**
+ * Wraps any chat-core consumer (typically the whole app shell) and provides
+ * a name resolver. Required for any tree that renders <ChatShell>, <MessageList>,
+ * or <MessageItemDefault>.
+ */
+export function ChatNameResolverProvider(props) {
+    const { resolveName, prewarm, children } = props;
+    const value = React.useMemo(() => ({ resolveName, prewarm }), [resolveName, prewarm]);
+    return (_jsx(ChatNameResolverContext.Provider, { value: value, children: children }));
+}
+/**
+ * Strict hook — throws if no provider is wrapped. Used inside chat-core's
+ * own renderers (MessageItemDefault, ReplyQuote) so a missing setup surfaces
+ * immediately on first render rather than silently rendering "User".
+ */
+export function useChatNameResolver() {
+    const ctx = React.useContext(ChatNameResolverContext);
+    if (!ctx) {
+        throw new Error("[chat-core] ChatNameResolverProvider is required. Wrap your ChatShell tree with <ChatNameResolverProvider>.");
+    }
+    return ctx;
+}
+/**
+ * Optional variant — returns null instead of throwing when no provider is
+ * wrapped. Used internally by useChatMessages so headless callers (tests,
+ * data-only consumers that don't render UI) can still use the hook.
+ */
+export function useOptionalChatNameResolver() {
+    return React.useContext(ChatNameResolverContext);
+}
+/**
+ * Convenience hook for renderers. Returns a resolved string — never null —
+ * by falling back to "User" when the cache hasn't filled yet. Re-renders
+ * automatically once the upstream cache settles.
+ */
+export function useResolvedSenderName(senderId) {
+    const { resolveName } = useChatNameResolver();
+    return resolveName(senderId) ?? "User";
+}
+//# sourceMappingURL=ChatNameResolverContext.js.map

package/dist/context/ChatNameResolverContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatNameResolverContext.js","sourceRoot":"","sources":["../../src/context/ChatNameResolverContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,MAAM,uBAAuB,GAAG,KAAK,CAAC,aAAa,CAAsC,IAAI,CAAC,CAAC;AAQ/F;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAoC;IAC3E,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IACtF,OAAO,CACL,KAAC,uBAAuB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC3C,QAAQ,GACwB,CACpC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;IACtD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,6GAA6G,CAC9G,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO,KAAK,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,EAAE,WAAW,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC9C,OAAO,WAAW,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC;AACzC,CAAC"}

package/dist/firestore/queries.d.ts

@@ -0,0 +1,5 @@
+import type { Firestore, Query, DocumentData } from "firebase/firestore";
+export declare function threadDocPath(chatCollectionPath: string | string[], threadId: string): string[];
+export declare function messagesColPath(chatCollectionPath: string | string[], threadId: string, messagesSubcollection?: string): [string, string, ...string[]];
+export declare function newestWindowQuery(db: Firestore, chatCollectionPath: string | string[], threadId: string, createdAtField: string, pageSize: number, messagesSubcollection?: string): Query<DocumentData>;
+//# sourceMappingURL=queries.d.ts.map

package/dist/firestore/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/firestore/queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOzE,wBAAgB,aAAa,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/F;AAED,wBAAgB,eAAe,CAC7B,kBAAkB,EAAE,MAAM,GAAG,MAAM,EAAE,EACrC,QAAQ,EAAE,MAAM,EAChB,qBAAqB,SAAa,GACjC,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAG/B;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,SAAS,EACb,kBAAkB,EAAE,MAAM,GAAG,MAAM,EAAE,EACrC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,qBAAqB,SAAa,GACjC,KAAK,CAAC,YAAY,CAAC,CAOrB"}

package/dist/firestore/queries.js

@@ -0,0 +1,16 @@
+import { collection, query, orderBy, limit } from "firebase/firestore";
+function normalizeSegments(path) {
+    return Array.isArray(path) ? path : [path];
+}
+export function threadDocPath(chatCollectionPath, threadId) {
+    return [...normalizeSegments(chatCollectionPath), threadId];
+}
+export function messagesColPath(chatCollectionPath, threadId, messagesSubcollection = "messages") {
+    const segments = [...normalizeSegments(chatCollectionPath), threadId, messagesSubcollection];
+    return segments;
+}
+export function newestWindowQuery(db, chatCollectionPath, threadId, createdAtField, pageSize, messagesSubcollection = "messages") {
+    const path = messagesColPath(chatCollectionPath, threadId, messagesSubcollection);
+    return query(collection(db, path[0], ...path.slice(1)), orderBy(createdAtField, "desc"), limit(pageSize));
+}
+//# sourceMappingURL=queries.js.map

package/dist/firestore/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../src/firestore/queries.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEvE,SAAS,iBAAiB,CAAC,IAAuB;IAChD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,kBAAqC,EAAE,QAAgB;IACnF,OAAO,CAAC,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,kBAAqC,EACrC,QAAgB,EAChB,qBAAqB,GAAG,UAAU;IAElC,MAAM,QAAQ,GAAG,CAAC,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IAC7F,OAAO,QAAyC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,EAAa,EACb,kBAAqC,EACrC,QAAgB,EAChB,cAAsB,EACtB,QAAgB,EAChB,qBAAqB,GAAG,UAAU;IAElC,MAAM,IAAI,GAAG,eAAe,CAAC,kBAAkB,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IAClF,OAAO,KAAK,CACV,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EACzC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,EAC/B,KAAK,CAAC,QAAQ,CAAC,CAChB,CAAC;AACJ,CAAC"}

package/dist/hooks/useChatMessages.d.ts

@@ -0,0 +1,12 @@
+import type { ChatMessageV1 } from "@ttt-productions/chat-core";
+import type { ChatCoreConfig } from "../types.js";
+export type UseChatMessagesResult = {
+    allowed: boolean;
+    isInitialLoading: boolean;
+    messages: ChatMessageV1[];
+    fetchOlder: () => Promise<void>;
+    hasOlder: boolean;
+    isFetchingOlder: boolean;
+};
+export declare function useChatMessages(config: ChatCoreConfig): UseChatMessagesResult;
+//# sourceMappingURL=useChatMessages.d.ts.map

package/dist/hooks/useChatMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatMessages.d.ts","sourceRoot":"","sources":["../../src/hooks/useChatMessages.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAclD,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAsDF,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CA4I7E"}

package/dist/hooks/useChatMessages.js

@@ -0,0 +1,139 @@
+"use client";
+import * as React from "react";
+import { collection, getDocs, onSnapshot, orderBy, query, startAfter, limit, } from "firebase/firestore";
+import { useInfiniteQuery } from "@tanstack/react-query";
+import { toMillis } from "@ttt-productions/firebase-helpers";
+import { canAccessThread } from "./useChatThreadAccess.js";
+import { messagesColPath, newestWindowQuery } from "../firestore/queries.js";
+import { useOptionalChatNameResolver } from "../context/ChatNameResolverContext.js";
+// Safety limit to prevent memory exhaustion
+const MAX_PAGE_SIZE = 100;
+function mapMsg(doc, threadId) {
+    const d = doc.data();
+    const createdAt = toMillis(d.createdAt);
+    if (!createdAt) {
+        console.error('[useChatMessages] Message missing valid createdAt:', doc.id, d.createdAt);
+    }
+    // replyTo: the new shape uses senderId, not senderUsername. Tolerate older
+    // docs that still have senderUsername — drop the name and keep what we can.
+    const replyTo = d.replyTo
+        ? {
+            messageId: d.replyTo.messageId,
+            senderId: d.replyTo.senderId ?? "",
+            messagePreview: d.replyTo.messagePreview,
+        }
+        : undefined;
+    return {
+        messageId: doc.id,
+        threadId,
+        createdAt: createdAt || 0,
+        senderId: d.senderId,
+        text: d.text ?? "",
+        type: d.type,
+        attachment: d.attachment ?? undefined,
+        replyTo,
+        isSystemMessage: d.isSystemMessage ?? undefined,
+        meta: d.meta,
+    };
+}
+function dedupeAndSortAsc(all) {
+    const m = new Map();
+    for (const x of all)
+        m.set(x.messageId, x);
+    return Array.from(m.values()).sort((a, b) => a.createdAt - b.createdAt);
+}
+function messagesCol(db, chatCollectionPath, threadId, messagesSubcollection) {
+    const path = messagesColPath(chatCollectionPath, threadId, messagesSubcollection);
+    return collection(db, path[0], ...path.slice(1));
+}
+export function useChatMessages(config) {
+    const { db, chatCollectionPath, messagesSubcollection = "messages", threadId, pageSize: requestedPageSize = 20, currentUserId, isAdmin, accessMode, threadAllowedUserIds, createdAtField = "createdAt", } = config;
+    const pageSize = Math.min(requestedPageSize, MAX_PAGE_SIZE);
+    if (requestedPageSize > MAX_PAGE_SIZE) {
+        console.warn(`[useChatMessages] Requested pageSize ${requestedPageSize} exceeds maximum ${MAX_PAGE_SIZE}. Using ${MAX_PAGE_SIZE}.`);
+    }
+    const pathKey = JSON.stringify(Array.isArray(chatCollectionPath) ? chatCollectionPath : [chatCollectionPath]);
+    const allowed = React.useMemo(() => canAccessThread({
+        accessMode,
+        isAdmin,
+        currentUserId,
+        allowedUserIds: threadAllowedUserIds,
+    }), [accessMode, isAdmin, currentUserId, threadAllowedUserIds]);
+    const [newest, setNewest] = React.useState({
+        ready: false,
+        newestDesc: [],
+        oldestDocInWindow: null,
+    });
+    React.useEffect(() => {
+        if (!allowed)
+            return;
+        const q = newestWindowQuery(db, chatCollectionPath, threadId, createdAtField, pageSize, messagesSubcollection);
+        const unsub = onSnapshot(q, (snap) => {
+            const docs = snap.docs;
+            const mapped = docs.map((d) => mapMsg(d, threadId));
+            setNewest({
+                ready: true,
+                newestDesc: mapped,
+                oldestDocInWindow: docs[docs.length - 1] ?? null,
+            });
+        });
+        return () => unsub();
+    }, [allowed, db, pathKey, threadId, createdAtField, pageSize, messagesSubcollection]);
+    const older = useInfiniteQuery({
+        queryKey: ["chat-core", "older", pathKey, threadId, messagesSubcollection, pageSize],
+        enabled: allowed && newest.ready,
+        initialPageParam: undefined,
+        queryFn: async ({ pageParam }) => {
+            const baseCol = messagesCol(db, chatCollectionPath, threadId, messagesSubcollection);
+            const cursor = pageParam ?? (newest.oldestDocInWindow ?? undefined);
+            if (!cursor) {
+                return {
+                    itemsDesc: [],
+                    nextCursor: undefined,
+                };
+            }
+            const q = query(baseCol, orderBy(createdAtField, "desc"), startAfter(cursor), limit(pageSize));
+            const snap = await getDocs(q);
+            const docs = snap.docs;
+            const itemsDesc = docs.map((d) => mapMsg(d, threadId));
+            const nextCursor = docs.length === pageSize ? docs[docs.length - 1] : undefined;
+            return { itemsDesc, nextCursor };
+        },
+        getNextPageParam: (last) => last.nextCursor,
+    });
+    const fetchOlder = React.useCallback(async () => {
+        await older.fetchNextPage();
+    }, [older.fetchNextPage]);
+    const messages = React.useMemo(() => {
+        if (!allowed)
+            return [];
+        const olderDesc = (older.data?.pages ?? []).flatMap((p) => p.itemsDesc);
+        return dedupeAndSortAsc([...olderDesc, ...newest.newestDesc]);
+    }, [allowed, older.data, newest.newestDesc]);
+    // Pre-warm name cache for all visible senders (and reply-to senders).
+    // Optional resolver: silent no-op if no provider is wrapped.
+    const resolverCtx = useOptionalChatNameResolver();
+    const senderIds = React.useMemo(() => {
+        const set = new Set();
+        for (const m of messages) {
+            set.add(m.senderId);
+            if (m.replyTo?.senderId)
+                set.add(m.replyTo.senderId);
+        }
+        return Array.from(set);
+    }, [messages]);
+    React.useEffect(() => {
+        if (resolverCtx?.prewarm && senderIds.length > 0) {
+            resolverCtx.prewarm(senderIds);
+        }
+    }, [resolverCtx, senderIds]);
+    return {
+        allowed,
+        isInitialLoading: allowed ? !newest.ready : false,
+        messages,
+        fetchOlder,
+        hasOlder: Boolean(older.hasNextPage),
+        isFetchingOlder: older.isFetchingNextPage,
+    };
+}
+//# sourceMappingURL=useChatMessages.js.map

package/dist/hooks/useChatMessages.js.map

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

package/dist/hooks/useChatThreadAccess.d.ts

@@ -0,0 +1,8 @@
+import type { ChatAccessMode } from "@ttt-productions/chat-core";
+export declare function canAccessThread(args: {
+    accessMode: ChatAccessMode;
+    isAdmin: boolean;
+    currentUserId: string;
+    allowedUserIds?: string[];
+}): boolean;
+//# sourceMappingURL=useChatThreadAccess.d.ts.map

package/dist/hooks/useChatThreadAccess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatThreadAccess.d.ts","sourceRoot":"","sources":["../../src/hooks/useChatThreadAccess.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,UAAU,EAAE,cAAc,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,GAAG,OAAO,CAkBV"}

package/dist/hooks/useChatThreadAccess.js

@@ -0,0 +1,19 @@
+export function canAccessThread(args) {
+    const { accessMode, isAdmin, currentUserId, allowedUserIds } = args;
+    // Admin always bypasses access checks (admin moderation surfaces).
+    if (isAdmin)
+        return true;
+    // Unauthenticated users never have access regardless of mode.
+    if (!currentUserId)
+        return false;
+    if (accessMode === "firestore-rules") {
+        // Defer to Firestore rules. If rules deny, onSnapshot will surface
+        // permission-denied, but chat-core does not pre-deny.
+        return true;
+    }
+    // accessMode === "explicit-allowlist"
+    if (!allowedUserIds)
+        return false;
+    return allowedUserIds.includes(currentUserId);
+}
+//# sourceMappingURL=useChatThreadAccess.js.map

package/dist/hooks/useChatThreadAccess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatThreadAccess.js","sourceRoot":"","sources":["../../src/hooks/useChatThreadAccess.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,IAK/B;IACC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAEpE,mEAAmE;IACnE,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC;IAEzB,8DAA8D;IAC9D,IAAI,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IAEjC,IAAI,UAAU,KAAK,iBAAiB,EAAE,CAAC;QACrC,mEAAmE;QACnE,sDAAsD;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sCAAsC;IACtC,IAAI,CAAC,cAAc;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,cAAc,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;AAChD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export type { ChatCoreConfig, ChatAttachmentConfig, ChatUploadAdapter, ChatMentionConfig, MessageRenderer, MessageRendererRegistry, RenderableMentionProvider, MentionResultRenderer, } from "./types.js";
+export type { ChatNameResolverProviderProps } from "./context/ChatNameResolverContext.js";
+export { ChatNameResolverProvider, useChatNameResolver, useOptionalChatNameResolver, useResolvedSenderName, } from "./context/ChatNameResolverContext.js";
+export type { UseChatMessagesResult } from "./hooks/useChatMessages.js";
+export { useChatMessages } from "./hooks/useChatMessages.js";
+export { canAccessThread } from "./hooks/useChatThreadAccess.js";
+export type { ChatShellProps } from "./ui/ChatShell.js";
+export { ChatShell } from "./ui/ChatShell.js";
+export { MessageList } from "./ui/MessageList.js";
+export type { ComposerProps } from "./ui/Composer.js";
+export { Composer } from "./ui/Composer.js";
+export type { MessageItemDefaultProps } from "./ui/MessageItemDefault.js";
+export { MessageItemDefault } from "./ui/MessageItemDefault.js";
+export { MessageActions, ThreadActions } from "./ui/menus.js";
+export { MessageText, type MessageTextProps } from "./mentions/MessageText.js";
+export { MentionAutocomplete, type MentionAutocompleteProps, } from "./mentions/MentionAutocomplete.js";
+export { useMentionAutocomplete, type UseMentionAutocompleteArgs, type UseMentionAutocompleteResult, type AutocompleteState, type AutocompleteResultGroup, } from "./mentions/use-mention-autocomplete.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":"AASA,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAG9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,YAAY,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,GAC9B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,sBAAsB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,wCAAwC,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+"use client";
+export { ChatNameResolverProvider, useChatNameResolver, useOptionalChatNameResolver, useResolvedSenderName, } from "./context/ChatNameResolverContext.js";
+export { useChatMessages } from "./hooks/useChatMessages.js";
+export { canAccessThread } from "./hooks/useChatThreadAccess.js";
+export { ChatShell } from "./ui/ChatShell.js";
+export { MessageList } from "./ui/MessageList.js";
+export { Composer } from "./ui/Composer.js";
+export { MessageItemDefault } from "./ui/MessageItemDefault.js";
+export { MessageActions, ThreadActions } from "./ui/menus.js";
+export { MessageText } from "./mentions/MessageText.js";
+export { MentionAutocomplete, } from "./mentions/MentionAutocomplete.js";
+export { useMentionAutocomplete, } from "./mentions/use-mention-autocomplete.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,YAAY,CAAC;AAsBb,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAI9C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAIjE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAyB,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EACL,mBAAmB,GAEpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,sBAAsB,GAKvB,MAAM,wCAAwC,CAAC"}

package/dist/mentions/MentionAutocomplete.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Visual autocomplete dropdown for the mention system.
+ *
+ * Pure presentation — driven entirely by `state` from `useMentionAutocomplete`.
+ * The consumer is expected to absolutely-position this near the textarea (or
+ * use its caret position via a wrapping container). chat-core does not
+ * compute textarea-caret coordinates; that's the consumer's job.
+ *
+ * Selecting a result fires `onSelect(ref)`. Hovering / arrow-keying updates
+ * the highlight via `onHighlight(index)`.
+ */
+import type { AutocompleteState } from './use-mention-autocomplete.js';
+import type { MentionRef } from '@ttt-productions/chat-core';
+export interface MentionAutocompleteProps<TKind extends string = string> {
+    state: AutocompleteState<TKind>;
+    onSelect: (ref: MentionRef<TKind>) => void;
+    onHighlight?: (flatIndex: number) => void;
+    /** Class name applied to the outer container. */
+    className?: string;
+}
+export declare function MentionAutocomplete<TKind extends string = string>(props: MentionAutocompleteProps<TKind>): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=MentionAutocomplete.d.ts.map

package/dist/mentions/MentionAutocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MentionAutocomplete.d.ts","sourceRoot":"","sources":["../../src/mentions/MentionAutocomplete.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAG7D,MAAM,WAAW,wBAAwB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IACrE,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAChC,QAAQ,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC3C,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAC/D,KAAK,EAAE,wBAAwB,CAAC,KAAK,CAAC,kDAoEvC"}

package/dist/mentions/MentionAutocomplete.js

@@ -0,0 +1,21 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from '@ttt-productions/ui-core';
+export function MentionAutocomplete(props) {
+    const { state, onSelect, onHighlight, className } = props;
+    if (!state.open)
+        return null;
+    const anyResults = state.flatResults.length > 0;
+    const anyLoading = state.groups.some((g) => g.loading);
+    let flatIndex = 0;
+    return (_jsxs("div", { role: "listbox", "aria-label": "Mentions", className: cn('chat-mention-autocomplete', 'rounded-md border bg-popover text-popover-foreground shadow-md', 'max-h-72 overflow-y-auto min-w-[16rem]', className), children: [!anyResults && anyLoading && (_jsx("div", { className: "px-3 py-2 text-xs text-muted-foreground", children: "Searching\u2026" })), !anyResults && !anyLoading && (_jsx("div", { className: "px-3 py-2 text-xs text-muted-foreground", children: state.showingRecent ? 'No recent mentions' : 'No matches' })), state.groups.map((group) => (_jsxs("div", { className: "chat-mention-group", children: [_jsx("div", { className: "px-3 pt-2 pb-1 text-xs font-semibold text-muted-foreground", children: state.showingRecent ? `Recent ${group.label}` : group.label }), group.loading && group.results.length === 0 && (_jsx("div", { className: "px-3 pb-2 text-xs text-muted-foreground", children: "Loading\u2026" })), _jsx("ul", { children: group.results.map((ref) => {
+                            const myIndex = flatIndex;
+                            flatIndex += 1;
+                            const highlighted = myIndex === state.highlightedIndex;
+                            return (_jsx("li", { children: _jsx("button", { type: "button", role: "option", "aria-selected": highlighted, className: cn('w-full text-left px-3 py-2 text-sm hover:bg-accent hover:text-accent-foreground', highlighted && 'bg-accent text-accent-foreground'), onMouseEnter: () => onHighlight?.(myIndex), onClick: (e) => {
+                                        e.preventDefault();
+                                        onSelect(ref);
+                                    }, children: group.renderResult ? group.renderResult(ref) : _jsxs("span", { children: ["@", ref.displayText] }) }) }, `${ref.kind}:${ref.id}`));
+                        }) })] }, group.kind)))] }));
+}
+//# sourceMappingURL=MentionAutocomplete.js.map

package/dist/mentions/MentionAutocomplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MentionAutocomplete.js","sourceRoot":"","sources":["../../src/mentions/MentionAutocomplete.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAgBb,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAU9C,MAAM,UAAU,mBAAmB,CACjC,KAAsC;IAEtC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAC1D,IAAI,CAAC,KAAK,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAE7B,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAEvD,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,OAAO,CACL,eACE,IAAI,EAAC,SAAS,gBACH,UAAU,EACrB,SAAS,EAAE,EAAE,CACX,2BAA2B,EAC3B,gEAAgE,EAChE,wCAAwC,EACxC,SAAS,CACV,aAEA,CAAC,UAAU,IAAI,UAAU,IAAI,CAC5B,cAAK,SAAS,EAAC,yCAAyC,gCAAiB,CAC1E,EACA,CAAC,UAAU,IAAI,CAAC,UAAU,IAAI,CAC7B,cAAK,SAAS,EAAC,yCAAyC,YACrD,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,YAAY,GACtD,CACP,EACA,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAC3B,eAAsB,SAAS,EAAC,oBAAoB,aAClD,cAAK,SAAS,EAAC,4DAA4D,YACxE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GACxD,EACL,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAC9C,cAAK,SAAS,EAAC,yCAAyC,8BAAe,CACxE,EACD,uBACG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;4BACzB,MAAM,OAAO,GAAG,SAAS,CAAC;4BAC1B,SAAS,IAAI,CAAC,CAAC;4BACf,MAAM,WAAW,GAAG,OAAO,KAAK,KAAK,CAAC,gBAAgB,CAAC;4BACvD,OAAO,CACL,uBACE,iBACE,IAAI,EAAC,QAAQ,EACb,IAAI,EAAC,QAAQ,mBACE,WAAW,EAC1B,SAAS,EAAE,EAAE,CACX,iFAAiF,EACjF,WAAW,IAAI,kCAAkC,CAClD,EACD,YAAY,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,EAC1C,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;wCACb,CAAC,CAAC,cAAc,EAAE,CAAC;wCACnB,QAAQ,CAAC,GAAG,CAAC,CAAC;oCAChB,CAAC,YAEA,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,gCAAQ,GAAG,CAAC,WAAW,IAAQ,GACxE,IAhBF,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,EAAE,CAiB3B,CACN,CAAC;wBACJ,CAAC,CAAC,GACC,KAjCG,KAAK,CAAC,IAAI,CAkCd,CACP,CAAC,IACE,CACP,CAAC;AACJ,CAAC"}

package/dist/mentions/MessageText.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Renders message text with inline mention chips.
+ *
+ * Walks the parser output and renders each segment: text segments as
+ * `<span>`, mention segments via the consumer-supplied `renderMention`
+ * callback (or a default chip when omitted).
+ *
+ * Pure, no context. Safe to use inside MessageItem renderers, ReplyQuote
+ * previews, or any other text surface that should honor mention tokens.
+ */
+import type { ReactNode } from 'react';
+import type { MentionRef } from '@ttt-productions/chat-core';
+export interface MessageTextProps<TKind extends string = string> {
+    /** Raw message text containing optional `@[kind:id|displayText]` tokens. */
+    text: string;
+    /**
+     * Custom mention renderer. When omitted, mentions render as a
+     * `<span class="chat-mention-chip">@{displayText}</span>` chip — consumers
+     * style via CSS. To make mentions clickable / linked / role-aware, supply
+     * a renderMention.
+     */
+    renderMention?: (ref: MentionRef<TKind>) => ReactNode;
+    /** Optional className applied to the wrapping `<span>`. */
+    className?: string;
+}
+export declare function MessageText<TKind extends string = string>(props: MessageTextProps<TKind>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=MessageText.d.ts.map

package/dist/mentions/MessageText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageText.d.ts","sourceRoot":"","sources":["../../src/mentions/MessageText.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAG7D,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IAC7D,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC;IACtD,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAUD,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,2CAiBxF"}

package/dist/mentions/MessageText.js

@@ -0,0 +1,20 @@
+'use client';
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { parseMentionTokens } from '@ttt-productions/chat-core';
+function DefaultMentionChip({ ref }) {
+    return (_jsxs("span", { className: "chat-mention-chip", "data-mention-kind": ref.kind, "data-mention-id": ref.id, children: ["@", ref.displayText] }));
+}
+export function MessageText(props) {
+    const { text, renderMention, className } = props;
+    const segments = parseMentionTokens(text);
+    return (_jsx("span", { className: className, children: segments.map((seg, i) => {
+            if (seg.type === 'text') {
+                return _jsx("span", { children: seg.text }, i);
+            }
+            if (renderMention) {
+                return _jsx("span", { children: renderMention(seg.ref) }, i);
+            }
+            return _jsx(DefaultMentionChip, { ref: seg.ref }, i);
+        }) }));
+}
+//# sourceMappingURL=MessageText.js.map

package/dist/mentions/MessageText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageText.js","sourceRoot":"","sources":["../../src/mentions/MessageText.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAeb,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAgBhE,SAAS,kBAAkB,CAAuB,EAAE,GAAG,EAA8B;IACnF,OAAO,CACL,gBAAM,SAAS,EAAC,mBAAmB,uBAAoB,GAAG,CAAC,IAAI,qBAAmB,GAAG,CAAC,EAAE,kBACpF,GAAG,CAAC,WAAW,IACZ,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAgC,KAA8B;IACvF,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IACjD,MAAM,QAAQ,GAAG,kBAAkB,CAAQ,IAAI,CAAC,CAAC;IAEjD,OAAO,CACL,eAAM,SAAS,EAAE,SAAS,YACvB,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACvB,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,yBAAe,GAAG,CAAC,IAAI,IAAZ,CAAC,CAAmB,CAAC;YACzC,CAAC;YACD,IAAI,aAAa,EAAE,CAAC;gBAClB,OAAO,yBAAe,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAA1B,CAAC,CAAiC,CAAC;YACvD,CAAC;YACD,OAAO,KAAC,kBAAkB,IAAS,GAAG,EAAE,GAAG,CAAC,GAAG,IAAf,CAAC,CAAkB,CAAC;QACtD,CAAC,CAAC,GACG,CACR,CAAC;AACJ,CAAC"}

package/dist/mentions/use-mention-autocomplete.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Composer-side mention autocomplete state hook.
+ *
+ * Detects when the user types the trigger character (default `@`) inside the
+ * provided textarea, captures the live query (the text between the trigger
+ * and the cursor), debounces searches across all configured providers, and
+ * tracks the anchor positions of inserted mentions so the composer can
+ * convert display text back to wire tokens on send.
+ *
+ * Returns an `AutocompleteState` value tailored for the `<MentionAutocomplete>`
+ * UI component, plus an `insertMention` action and a `getValueWithTokens`
+ * accessor the composer calls on send.
+ *
+ * Generic over `TKind` and `TContext`; chat-core inspects neither.
+ */
+import { type RefObject } from 'react';
+import type { MentionAnchor, MentionRef, RecentMentionsAdapter } from '@ttt-productions/chat-core';
+import type { RenderableMentionProvider } from '../types.js';
+export type AutocompleteResultGroup<TKind extends string = string> = {
+    kind: TKind;
+    label: string;
+    results: MentionRef<TKind>[];
+    /** True if `search` is in flight for this provider. */
+    loading: boolean;
+    /** Provider-supplied custom renderer for individual results, if any. */
+    renderResult?: (ref: MentionRef<TKind>) => import('react').ReactNode;
+};
+export type AutocompleteState<TKind extends string = string> = {
+    /** True iff the dropdown should be visible. */
+    open: boolean;
+    /** Current query text (everything after the trigger up to the cursor). */
+    query: string;
+    /** Results grouped by provider, in the order the consumer passed providers. */
+    groups: AutocompleteResultGroup<TKind>[];
+    /** When true, groups are recent picks (`getRecent`) rather than search results. */
+    showingRecent: boolean;
+    /** Index of the currently highlighted result, flattened across all groups. */
+    highlightedIndex: number;
+    /** Flat array of all results in display order. Used internally for keyboard nav. */
+    flatResults: MentionRef<TKind>[];
+};
+export interface UseMentionAutocompleteArgs<TKind extends string, TContext> {
+    textareaRef: RefObject<HTMLTextAreaElement | null>;
+    /** Current textarea value (controlled). */
+    value: string;
+    /** Setter for the textarea value. */
+    onChange: (next: string) => void;
+    /** Providers in display order. Empty list disables the system entirely. */
+    providers: RenderableMentionProvider<TKind, TContext>[];
+    /** Consumer-controlled context passed to each provider's `search`. */
+    context: TContext;
+    /** Optional recent-mentions adapter. */
+    recent?: RecentMentionsAdapter<TKind>;
+    /** Trigger character. Defaults to `'@'`. Must be exactly one character. */
+    trigger?: string;
+    /**
+     * Minimum query length to fire `search`. Below this, recent picks are shown
+     * (if `recent` is supplied) or the dropdown stays empty. Default: 0 (search
+     * fires immediately on trigger).
+     */
+    minQueryLength?: number;
+    /** Debounce window in ms for search calls. Default: 200. */
+    searchDebounceMs?: number;
+}
+export interface UseMentionAutocompleteResult<TKind extends string = string> {
+    state: AutocompleteState<TKind>;
+    /** Handle keydown from the textarea — returns true if the event was handled. */
+    handleKeyDown: (event: import('react').KeyboardEvent<HTMLTextAreaElement>) => boolean;
+    /** Programmatically insert a mention at the trigger position (called by the autocomplete UI). */
+    insertMention: (ref: MentionRef<TKind>) => void;
+    /**
+     * Returns the current textarea value with all tracked mention anchors
+     * substituted back to wire tokens. Call this from the composer's send path.
+     */
+    getValueWithTokens: () => string;
+    /** Anchor list — exposed for tests and consumers that need the raw positions. */
+    anchors: MentionAnchor<TKind>[];
+    /** Close the dropdown imperatively (e.g. on send). */
+    close: () => void;
+}
+export declare function useMentionAutocomplete<TKind extends string, TContext>(args: UseMentionAutocompleteArgs<TKind, TContext>): UseMentionAutocompleteResult<TKind>;
+//# sourceMappingURL=use-mention-autocomplete.d.ts.map

package/dist/mentions/use-mention-autocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mention-autocomplete.d.ts","sourceRoot":"","sources":["../../src/mentions/use-mention-autocomplete.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAqD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE1F,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,MAAM,uBAAuB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,IAAI;IACnE,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7B,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,OAAO,OAAO,EAAE,SAAS,CAAC;CACtE,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,IAAI;IAC7D,+CAA+C;IAC/C,IAAI,EAAE,OAAO,CAAC;IACd,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,MAAM,EAAE,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;IACzC,mFAAmF;IACnF,aAAa,EAAE,OAAO,CAAC;IACvB,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,CAAC;IACzB,oFAAoF;IACpF,WAAW,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;CAClC,CAAC;AAEF,MAAM,WAAW,0BAA0B,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ;IACxE,WAAW,EAAE,SAAS,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IACnD,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,2EAA2E;IAC3E,SAAS,EAAE,yBAAyB,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;IACxD,sEAAsE;IACtE,OAAO,EAAE,QAAQ,CAAC;IAClB,wCAAwC;IACxC,MAAM,CAAC,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACtC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA4B,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IACzE,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAChC,gFAAgF;IAChF,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC,KAAK,OAAO,CAAC;IACtF,iGAAiG;IACjG,aAAa,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAChD;;;OAGG;IACH,kBAAkB,EAAE,MAAM,MAAM,CAAC;IACjC,iFAAiF;IACjF,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;IAChC,sDAAsD;IACtD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAMD,wBAAgB,sBAAsB,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,EACnE,IAAI,EAAE,0BAA0B,CAAC,KAAK,EAAE,QAAQ,CAAC,GAChD,4BAA4B,CAAC,KAAK,CAAC,CAgVrC"}