@cratis/components 3.6.0 → 4.0.0

package/dist/esm/Chat/ChatSidebar.d.ts

@@ -1,38 +1,137 @@
-import React from 'react';
-import type { DrawerRootProps } from '@primereact/types/primitive/drawer';
-import type { ChatConversationLabels, ChatConversationProps } from './ChatConversation';
-import { type ChatIdentifier } from './ChatIdentifier';
-import type { ChatMention } from './ChatMention';
-import type { ChatMessage } from './ChatMessage';
-import type { ChatTopic } from './ChatTopic';
-import type { ChatTopicListLabels } from './ChatTopicList';
+import type { ButtonHTMLAttributes, HTMLAttributes } from 'react';
+import type { ChatConversationLabels, ChatConversationProps } from './ChatConversation.js';
+import { type ChatIdentifier } from './ChatIdentifier.js';
+import type { ChatMention } from './ChatMention.js';
+import type { ChatMessage } from './ChatMessage.js';
+import type { ChatTopic } from './ChatTopic.js';
+import type { ChatTopicListLabels } from './ChatTopicList.js';
+type ChatSidebarPartAttributes<TElement> = HTMLAttributes<TElement> & {
+    [attribute: `data-${string}`]: string | number | boolean | undefined;
+};
+type ChatSidebarButtonAttributes = Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onClick' | 'type'>;
+/** Stable Cratis-owned parts for styling a {@link ChatSidebar}. */
+export interface ChatSidebarParts {
+    /** Viewport overlay layer the sidebar portals into — only paints/blocks when {@link ChatSidebarProps.modal} is true. */
+    backdrop?: ChatSidebarPartAttributes<HTMLDivElement>;
+    /** The sidebar panel itself. */
+    root?: ChatSidebarPartAttributes<HTMLDivElement>;
+    /** Header containing the back affordance, title, and close button. */
+    header?: ChatSidebarPartAttributes<HTMLElement>;
+    /** The topic list title, or the open topic's name. */
+    title?: ChatSidebarPartAttributes<HTMLHeadingElement>;
+    /** Back-to-topics button, present only while a topic is open. */
+    back?: ChatSidebarButtonAttributes;
+    /** Close button. */
+    close?: ChatSidebarButtonAttributes;
+    /** The topic list / conversation content region. */
+    content?: ChatSidebarPartAttributes<HTMLDivElement>;
+}
+/** Overrides for every label the {@link ChatSidebar} and its children render. Any field left
+ *  unset falls back to a literal English default. */
 export interface ChatSidebarLabels {
+    /** The sidebar's title while the topic list is showing. Defaults to `'Topics'`. */
     topics?: string;
+    /** Placeholder title for a topic that has not been named yet. Defaults to `'New topic'`. */
     unnamedTopic?: string;
+    /** Tooltip/accessible label for the back-to-topics button. Defaults to `'Back to topics'`. */
     back?: string;
+    /** Accessible label for the close button. Defaults to `'Close chat'`. */
     close?: string;
+    /** Labels forwarded to the {@link ChatTopicList}. */
     topicList?: ChatTopicListLabels;
+    /** Labels forwarded to the {@link ChatConversation}. */
     conversation?: ChatConversationLabels;
 }
+/**
+ * Props for {@link ChatSidebar}.
+ * @typeParam TMessage The host's message type — anything extending {@link ChatMessage}.
+ * @typeParam TTopic The host's topic type — anything extending {@link ChatTopic}.
+ */
 export interface ChatSidebarProps<TMessage extends ChatMessage = ChatMessage, TTopic extends ChatTopic = ChatTopic> extends Omit<ChatConversationProps<TMessage>, 'messages' | 'onSendMessage' | 'labels' | 'className'> {
+    /** Whether the sidebar is open. */
     open: boolean;
+    /** Invoked when the sidebar asks to close — the host owns {@link open}, so closing means the host flips it. */
     onClose: () => void;
+    /**
+     * The topics, in any order. Hand this the array a live (observable) query delivers and the
+     * sidebar re-renders as it changes.
+     */
     topics: TTopic[];
+    /**
+     * The messages — either the whole chat or just the open topic's; the sidebar shows those of
+     * the open topic by matching on `topicId` either way. Hand this the array a live
+     * (observable) query delivers and the conversation re-renders as it changes.
+     */
     messages: TMessage[];
+    /**
+     * The open topic, for hosts that own the selection themselves: an identifier opens that
+     * topic's conversation, `null` shows the topic list, and leaving the prop unset lets the
+     * sidebar keep the selection internally.
+     */
     selectedTopicId?: ChatIdentifier | null;
+    /**
+     * Invoked when the open topic changes — a topic was opened (or just started), or the person
+     * went back to the list.
+     * @param topicId The identifier of the topic now open, or undefined for the list.
+     * @param topic The topic itself, when it is known in {@link topics}.
+     */
     onTopicSelected?: (topicId: ChatIdentifier | undefined, topic?: TTopic) => void;
+    /**
+     * Invoked when a new topic is asked for. Creating the topic is the host's business; answer
+     * with its identifier (directly or through a promise) and the sidebar opens it, ready for
+     * the first message. Omit to leave the new-topic affordance off.
+     * @returns The identifier of the topic that was started, when the host created one.
+     */
     onStartTopic?: () => ChatIdentifier | undefined | Promise<ChatIdentifier | undefined>;
+    /**
+     * Invoked when a message is sent, with the topic it belongs to, the trimmed body and who it
+     * mentions. Everything else about persisting the message is the host's business.
+     * @param topicId The identifier of the topic the message was sent in.
+     * @param body The message text, mentions written into it as plain `@Name`.
+     * @param mentions Who the body mentions.
+     */
     onSendMessage: (topicId: ChatIdentifier, body: string, mentions: ChatMention[]) => void;
+    /**
+     * Invoked when the very first message is sent in a topic that has no name yet — the host
+     * asks its LLM (or whatever it prefers) for a good name and supplies it through the topic
+     * data; until then the topic renders its pending placeholder. Not invoked again for later
+     * messages, and never for a topic that already has a name.
+     * @param topic The topic that needs a name.
+     * @param firstMessageBody The message to derive the name from.
+     */
     onRequestTopicName?: (topic: TTopic, firstMessageBody: string) => void;
+    /**
+     * Decides whether a topic counts as unnamed — see {@link ChatTopicListProps.isTopicUnnamed}.
+     * @param topic The topic to check.
+     * @returns True when the topic has no usable name yet.
+     */
     isTopicUnnamed?: (topic: TTopic) => boolean;
+    /** Which edge the sidebar opens from. Defaults to `'right'`. */
     position?: 'left' | 'right';
+    /** The sidebar's width, any CSS length. Defaults to `'24rem'`. */
     width?: string;
+    /**
+     * Whether the sidebar is modal — a backdrop behind it, and dismissing by Escape or clicking
+     * outside. Defaults to false: a chat lives *next to* the work, so it should not block it —
+     * the background stays visible and interactive, and only the close/back affordances dismiss it.
+     */
     modal?: boolean;
+    /** Overrides for every label rendered. Unset fields fall back to literal English defaults. */
     labels?: ChatSidebarLabels;
+    /** Additional class name for the sidebar's panel element. */
     className?: string;
-    pt?: DrawerRootProps['pt'];
-    ptOptions?: DrawerRootProps['ptOptions'];
-    unstyled?: boolean;
+    /** Cratis-owned per-part attributes. */
+    pt?: ChatSidebarParts;
 }
-export declare const ChatSidebar: <TMessage extends ChatMessage = ChatMessage, TTopic extends ChatTopic = ChatTopic>({ open, onClose, topics, messages, selectedTopicId, onTopicSelected, onStartTopic, onSendMessage, onRequestTopicName, isTopicUnnamed, position, width, modal, labels, className, pt, ptOptions, unstyled, ...conversation }: ChatSidebarProps<TMessage, TTopic>) => React.JSX.Element;
-//# sourceMappingURL=ChatSidebar.d.ts.map
+/**
+ * A topic-based chat in a sidebar next to the view, built on Components' own overlay primitives
+ * (React Aria internally, for accessible dismissal and focus handling). It opens on the topic
+ * list; picking a topic (or starting a new one) slides into that conversation, with a back
+ * affordance to the list. Everything about *data* is the host's: topics and messages come in as
+ * arrays (hand it live query data and it stays current), sends and new topics go out as
+ * callbacks, and when the first message lands in an unnamed topic the sidebar asks the host for
+ * a name through {@link ChatSidebarProps.onRequestTopicName | onRequestTopicName} — rendering a
+ * pending placeholder until the name arrives.
+ */
+export declare const ChatSidebar: <TMessage extends ChatMessage = ChatMessage, TTopic extends ChatTopic = ChatTopic>({ open, onClose, topics, messages, selectedTopicId, onTopicSelected, onStartTopic, onSendMessage, onRequestTopicName, isTopicUnnamed, position, width, modal, labels, className, pt, ...conversation }: ChatSidebarProps<TMessage, TTopic>) => import("react").JSX.Element;
+export {};

package/dist/esm/Chat/ChatSidebar.js

@@ -1,32 +1,32 @@
-import { jsx, jsxs } from 'react/jsx-runtime';
+import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
 import { useState } from 'react';
-import { Drawer } from 'primereact/drawer';
+import { ModalOverlay, Modal } from 'react-aria-components';
 import { ChatConversation } from './ChatConversation.js';
 import { sameChatIdentifier } from './ChatIdentifier.js';
 import { ChatTopicList } from './ChatTopicList.js';
 import { isTopicUnnamed } from './isTopicUnnamed.js';
 import { shouldRequestTopicName } from './shouldRequestTopicName.js';
 
-/**
- * A topic-based chat in a sidebar next to the view, built on PrimeReact's Drawer. It opens on
- * the topic list; picking a topic (or starting a new one) slides into that conversation, with a
- * back affordance to the list. Everything about *data* is the host's: topics and messages come
- * in as arrays (hand it live query data and it stays current), sends and new topics go out as
- * callbacks, and when the first message lands in an unnamed topic the sidebar asks the host for
- * a name through {@link ChatSidebarProps.onRequestTopicName | onRequestTopicName} — rendering a
- * pending placeholder until the name arrives.
- */
-const ChatSidebar = ({ open, onClose, topics, messages, selectedTopicId, onTopicSelected, onStartTopic, onSendMessage, onRequestTopicName, isTopicUnnamed: isTopicUnnamed$1, position = 'right', width = '24rem', modal = false, labels, className, pt, ptOptions, unstyled, ...conversation }) => {
-    const [internalSelectedId, setInternalSelectedId] = useState(undefined);
+const classNames = (...values) => values.filter(Boolean).join(' ');
+const BackIcon = () => (jsxs("svg", { width: '14', height: '14', viewBox: '0 0 24 24', fill: 'none', stroke: 'currentColor', strokeWidth: '2.5', "aria-hidden": 'true', children: [jsx("line", { x1: '19', y1: '12', x2: '5', y2: '12' }), jsx("polyline", { points: '12 19 5 12 12 5' })] }));
+const ChatSidebar = ({ open, onClose, topics, messages, selectedTopicId, onTopicSelected, onStartTopic, onSendMessage, onRequestTopicName, isTopicUnnamed: isTopicUnnamed$1, position = 'right', width = '24rem', modal = false, labels, className, pt, ...conversation }) => {
+    const [internalSelectedId, setInternalSelectedId] = useState();
     const isControlled = selectedTopicId !== undefined;
-    const openTopicId = isControlled ? (selectedTopicId ?? undefined) : internalSelectedId;
-    const openTopic = openTopicId !== undefined ? topics.find(topic => sameChatIdentifier(topic.id, openTopicId)) : undefined;
+    const openTopicId = isControlled
+        ? (selectedTopicId ?? undefined)
+        : internalSelectedId;
+    const openTopic = openTopicId === undefined
+        ? undefined
+        : topics.find((topic) => sameChatIdentifier(topic.id, openTopicId));
     const unnamed = isTopicUnnamed$1 ?? isTopicUnnamed;
     const select = (topicId, topic) => {
         if (!isControlled) {
             setInternalSelectedId(topicId);
         }
-        onTopicSelected?.(topicId, topic ?? (topicId !== undefined ? topics.find(candidate => sameChatIdentifier(candidate.id, topicId)) : undefined));
+        onTopicSelected?.(topicId, topic ??
+            (topicId === undefined
+                ? undefined
+                : topics.find((candidate) => sameChatIdentifier(candidate.id, topicId))));
     };
     const startTopic = async () => {
         const topicId = await onStartTopic?.();
@@ -36,29 +36,36 @@ const ChatSidebar = ({ open, onClose, topics, messages, selectedTopicId, onTopic
     };
     const openMessages = openTopicId === undefined
         ? []
-        : messages.filter(message => sameChatIdentifier(message.topicId, openTopicId));
+        : messages.filter((message) => sameChatIdentifier(message.topicId, openTopicId));
     const send = (body, mentions) => {
         if (openTopicId === undefined)
             return;
         onSendMessage(openTopicId, body, mentions);
-        if (openTopic && shouldRequestTopicName(unnamed(openTopic), openMessages.length)) {
+        if (openTopic &&
+            shouldRequestTopicName(unnamed(openTopic), openMessages.length)) {
             onRequestTopicName?.(openTopic, body);
         }
     };
-    const handleOpenChange = (event) => {
-        if (!event.value) {
-            onClose();
-        }
-    };
     const title = openTopicId === undefined
         ? (labels?.topics ?? 'Topics')
         : openTopic && !unnamed(openTopic)
             ? openTopic.name
             : (labels?.unnamedTopic ?? 'New topic');
     const titleIsPending = openTopicId !== undefined && (!openTopic || unnamed(openTopic));
-    return (jsx(Drawer.Root, { open: open, position: position, dismissable: modal, onOpenChange: handleOpenChange, pt: pt, ptOptions: ptOptions, unstyled: unstyled, children: jsxs(Drawer.Portal, { children: [modal && jsx(Drawer.Backdrop, {}), jsxs(Drawer.Popup, { className: `cratis-chat-sidebar${className ? ` ${className}` : ''}`, style: { width }, children: [jsxs(Drawer.Header, { className: 'cratis-chat-sidebar__header', children: [openTopicId !== undefined && (jsx("button", { type: 'button', className: 'cratis-chat-sidebar__back', title: labels?.back ?? 'Back to topics', "aria-label": labels?.back ?? 'Back to topics', onClick: () => select(undefined), children: jsx("i", { className: 'pi pi-arrow-left', "aria-hidden": 'true' }) })), jsx(Drawer.Title, { className: `cratis-chat-sidebar__title${titleIsPending ? ' cratis-chat-sidebar__title--pending' : ''}`, children: title }), jsx(Drawer.Close, { className: 'cratis-chat-sidebar__close', "aria-label": labels?.close ?? 'Close chat', children: jsx("i", { className: 'pi pi-times', "aria-hidden": 'true' }) })] }), jsx(Drawer.Content, { className: 'cratis-chat-sidebar__content', children: openTopicId === undefined
-                                ? (jsx(ChatTopicList, { topics: topics, onOpen: topic => select(topic.id, topic), onStart: onStartTopic ? () => { void startTopic(); } : undefined, authorOf: conversation.authorOf, renderAvatar: conversation.renderAvatar, isTopicUnnamed: isTopicUnnamed$1, buildAvatarUrl: conversation.buildAvatarUrl, labels: { unnamedTopic: labels?.unnamedTopic, ...labels?.topicList } }))
-                                : (jsx(ChatConversation, { ...conversation, messages: openMessages, onSendMessage: send, labels: labels?.conversation })) })] })] }) }));
+    const panel = (jsxs(Fragment, { children: [jsxs("header", { ...pt?.header, className: classNames('cratis-chat-sidebar__header', pt?.header?.className), "data-cratis-part": 'header', children: [openTopicId !== undefined && (jsx("button", { ...pt?.back, type: 'button', className: classNames('cratis-chat-sidebar__back', pt?.back?.className), "data-cratis-part": 'back', title: labels?.back ?? 'Back to topics', "aria-label": labels?.back ?? 'Back to topics', onClick: () => select(undefined), children: jsx(BackIcon, {}) })), jsx("h2", { ...pt?.title, className: classNames('cratis-chat-sidebar__title', titleIsPending
+                            ? 'cratis-chat-sidebar__title--pending'
+                            : undefined, pt?.title?.className), "data-cratis-part": 'title', children: title }), jsx("button", { ...pt?.close, type: 'button', className: classNames('cratis-chat-sidebar__close', pt?.close?.className), "data-cratis-part": 'close', "aria-label": labels?.close ?? 'Close chat', onClick: onClose, children: jsx("span", { "aria-hidden": 'true', children: "\u00D7" }) })] }), jsx("div", { ...pt?.content, className: classNames('cratis-chat-sidebar__content', pt?.content?.className), "data-cratis-part": 'content', children: openTopicId === undefined ? (jsx(ChatTopicList, { topics: topics, onOpen: (topic) => select(topic.id, topic), onStart: onStartTopic
+                        ? () => {
+                            void startTopic();
+                        }
+                        : undefined, authorOf: conversation.authorOf, renderAvatar: conversation.renderAvatar, isTopicUnnamed: isTopicUnnamed$1, buildAvatarUrl: conversation.buildAvatarUrl, labels: {
+                        unnamedTopic: labels?.unnamedTopic,
+                        ...labels?.topicList,
+                    } })) : (jsx(ChatConversation, { ...conversation, messages: openMessages, onSendMessage: send, labels: labels?.conversation })) })] }));
+    return (jsx(ModalOverlay, { ...pt?.backdrop, isOpen: open, onOpenChange: (openState) => {
+            if (!openState)
+                onClose();
+        }, isDismissable: modal, isKeyboardDismissDisabled: !modal, className: classNames('cratis-chat-sidebar__backdrop', pt?.backdrop?.className), "data-cratis-part": 'backdrop', "data-modal": modal, "data-open": open || undefined, "data-selected": openTopicId !== undefined || undefined, children: jsx(Modal, { ...pt?.root, className: classNames('cratis-chat-sidebar', pt?.root?.className, className), style: { width, ...pt?.root?.style }, "data-cratis-part": 'root', "data-position": position, "data-open": open || undefined, "data-selected": openTopicId !== undefined || undefined, children: panel }) }));
 };
 
 export { ChatSidebar };

package/dist/esm/Chat/ChatSidebar.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChatSidebar.js","sources":["../../../Chat/ChatSidebar.tsx"],"sourcesContent":[null],"names":["isTopicUnnamed","defaultIsTopicUnnamed","_jsx","PrimeDrawer","_jsxs"],"mappings":"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"}
+{"version":3,"file":"ChatSidebar.js","sources":["../../../Chat/ChatSidebar.tsx"],"sourcesContent":[null],"names":["_jsxs","_jsx","isTopicUnnamed","defaultIsTopicUnnamed","_Fragment"],"mappings":"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"}

package/dist/esm/Chat/ChatSidebarForObservableQueries.d.ts

@@ -1,15 +1,39 @@
 import React from 'react';
 import type { Constructor } from '@cratis/fundamentals';
 import type { IObservableQueryFor } from '@cratis/arc/queries';
-import { type ChatSidebarProps } from './ChatSidebar';
-import type { ChatIdentifier } from './ChatIdentifier';
-import type { ChatMessage } from './ChatMessage';
-import type { ChatTopic } from './ChatTopic';
+import { type ChatSidebarProps } from './ChatSidebar.js';
+import type { ChatIdentifier } from './ChatIdentifier.js';
+import type { ChatMessage } from './ChatMessage.js';
+import type { ChatTopic } from './ChatTopic.js';
+/**
+ * Props for {@link ChatSidebarForObservableQueries}.
+ * @typeParam TMessage The message type the messages query returns — anything extending {@link ChatMessage}.
+ * @typeParam TTopic The topic type the topics query returns — anything extending {@link ChatTopic}.
+ * @typeParam TTopicsQuery The observable query delivering the topics.
+ * @typeParam TMessagesQuery The observable query delivering the open topic's messages.
+ * @typeParam TTopicsArguments The topics query's argument type.
+ * @typeParam TMessagesArguments The messages query's argument type.
+ */
 export interface ChatSidebarForObservableQueriesProps<TMessage extends ChatMessage, TTopic extends ChatTopic, TTopicsQuery extends IObservableQueryFor<TTopic[], TTopicsArguments>, TMessagesQuery extends IObservableQueryFor<TMessage[], TMessagesArguments>, TTopicsArguments extends object = object, TMessagesArguments extends object = object> extends Omit<ChatSidebarProps<TMessage, TTopic>, 'topics' | 'messages' | 'selectedTopicId'> {
+    /** The observable query delivering the topics. */
     topicsQuery: Constructor<TTopicsQuery>;
+    /** Arguments for the topics query, when it takes any. */
     topicsArguments?: TTopicsArguments;
+    /** The observable query delivering the open topic's messages. */
     messagesQuery: Constructor<TMessagesQuery>;
+    /**
+     * Arguments for the messages query, derived from the open topic. Answer undefined while no
+     * topic is open — the messages query is not subscribed until there is one.
+     * @param topicId The identifier of the open topic, or undefined for none.
+     * @returns The arguments, or undefined to hold the subscription.
+     */
     messagesArguments: (topicId: ChatIdentifier | undefined) => TMessagesArguments | undefined;
 }
+/**
+ * The {@link ChatSidebar} bound to real-time Cratis Arc observable queries — one for the topics,
+ * one for the open topic's messages — so both stay current as the read models change
+ * server-side. This is a thin, optional convenience on top of the pure {@link ChatSidebar}: every
+ * callback contract (sending, starting topics, naming, authors, actions, mentions) is exactly
+ * the same, and a host that prefers to own its subscriptions uses {@link ChatSidebar} directly.
+ */
 export declare const ChatSidebarForObservableQueries: <TMessage extends ChatMessage, TTopic extends ChatTopic, TTopicsQuery extends IObservableQueryFor<TTopic[], TTopicsArguments>, TMessagesQuery extends IObservableQueryFor<TMessage[], TMessagesArguments>, TTopicsArguments extends object = object, TMessagesArguments extends object = object>({ topicsQuery, topicsArguments, messagesQuery, messagesArguments, onTopicSelected, ...sidebar }: ChatSidebarForObservableQueriesProps<TMessage, TTopic, TTopicsQuery, TMessagesQuery, TTopicsArguments, TMessagesArguments>) => React.JSX.Element;
-//# sourceMappingURL=ChatSidebarForObservableQueries.d.ts.map

package/dist/esm/Chat/ChatSidebarForObservableQueries.js

@@ -3,20 +3,15 @@ import { useState } from 'react';
 import { useObservableQuery } from '@cratis/arc.react/queries';
 import { ChatSidebar } from './ChatSidebar.js';
 
-/**
- * The {@link ChatSidebar} bound to real-time Cratis Arc observable queries — one for the topics,
- * one for the open topic's messages — so both stay current as the read models change
- * server-side. This is a thin, optional convenience on top of the pure {@link ChatSidebar}: every
- * callback contract (sending, starting topics, naming, authors, actions, mentions) is exactly
- * the same, and a host that prefers to own its subscriptions uses {@link ChatSidebar} directly.
- */
 const ChatSidebarForObservableQueries = ({ topicsQuery, topicsArguments, messagesQuery, messagesArguments, onTopicSelected, ...sidebar }) => {
     const [selectedId, setSelectedId] = useState(undefined);
     const [topicsResult] = useObservableQuery(topicsQuery, topicsArguments);
     const messagesQueryArguments = messagesArguments(selectedId);
     const [messagesResult] = useObservableQuery(messagesQuery, messagesQueryArguments, undefined, selectedId !== undefined && messagesQueryArguments !== undefined);
     const topics = Array.isArray(topicsResult.data) ? topicsResult.data : [];
-    const messages = selectedId !== undefined && Array.isArray(messagesResult.data) ? messagesResult.data : [];
+    const messages = selectedId !== undefined && Array.isArray(messagesResult.data)
+        ? messagesResult.data
+        : [];
     return (jsx(ChatSidebar, { ...sidebar, topics: topics, messages: messages, selectedTopicId: selectedId ?? null, onTopicSelected: (topicId, topic) => {
             setSelectedId(topicId);
             onTopicSelected?.(topicId, topic);

package/dist/esm/Chat/ChatSidebarForObservableQueries.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChatSidebarForObservableQueries.js","sources":["../../../Chat/ChatSidebarForObservableQueries.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":";;;;;AAgDA;;;;;;AAMG;MACU,+BAA+B,GAAG,CAO7C,EACE,WAAW,EACX,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,GAAG,OAAO,EAC+G,KAAI;IAC7H,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAA6B,SAAS,CAAC;IAEnF,MAAM,CAAC,YAAY,CAAC,GAAG,kBAAkB,CAA2C,WAAW,EAAE,eAAe,CAAC;AAEjH,IAAA,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,UAAU,CAAC;IAC5D,MAAM,CAAC,cAAc,CAAC,GAAG,kBAAkB,CACvC,aAAa,EACb,sBAAsB,EACtB,SAAS,EACT,UAAU,KAAK,SAAS,IAAI,sBAAsB,KAAK,SAAS,CACnE;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,GAAG,EAAE;IACxE,MAAM,QAAQ,GAAG,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,IAAI,GAAG,EAAE;IAE1G,QACIA,GAAA,CAAC,WAAW,EAAA,EAAA,GACJ,OAAO,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,eAAe,EAAE,UAAU,IAAI,IAAI,EACnC,eAAe,EAAE,CAAC,OAAO,EAAE,KAAK,KAAI;YAChC,aAAa,CAAC,OAAO,CAAC;AACtB,YAAA,eAAe,GAAG,OAAO,EAAE,KAAK,CAAC;QACrC,CAAC,EAAA,CACH;AAEV;;"}
+{"version":3,"file":"ChatSidebarForObservableQueries.js","sources":["../../../Chat/ChatSidebarForObservableQueries.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":";;;;;MA2Da,+BAA+B,GAAG,CAO7C,EACE,WAAW,EACX,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,GAAG,OAAO,EAQb,KAAI;IACD,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAA6B,SAAS,CAAC;IAEnF,MAAM,CAAC,YAAY,CAAC,GAAG,kBAAkB,CACrC,WAAW,EACX,eAAe,CAClB;AAED,IAAA,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,UAAU,CAAC;IAC5D,MAAM,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAKvC,aAAa,EACb,sBAAsB,EACtB,SAAS,EACT,UAAU,KAAK,SAAS,IAAI,sBAAsB,KAAK,SAAS,CACnE;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,GAAG,EAAE;AACxE,IAAA,MAAM,QAAQ,GACV,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI;UACvD,cAAc,CAAC;UACf,EAAE;IAEZ,QACIA,GAAA,CAAC,WAAW,EAAA,EAAA,GACJ,OAAO,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,eAAe,EAAE,UAAU,IAAI,IAAI,EACnC,eAAe,EAAE,CAAC,OAAO,EAAE,KAAK,KAAI;YAChC,aAAa,CAAC,OAAO,CAAC;AACtB,YAAA,eAAe,GAAG,OAAO,EAAE,KAAK,CAAC;QACrC,CAAC,EAAA,CACH;AAEV;;"}

package/dist/esm/Chat/ChatTopic.d.ts

@@ -1,10 +1,21 @@
-import type { ChatIdentifier } from './ChatIdentifier';
+import type { ChatIdentifier } from './ChatIdentifier.js';
+/**
+ * A topic — one conversation among many. A topic without a {@link name} is considered unnamed:
+ * the components render a placeholder for it until the host supplies the real name, which is how
+ * host-side auto-naming (ask an LLM for a title from the first message) shows up while it is
+ * still underway.
+ */
 export interface ChatTopic {
+    /** The identifier of the topic. */
     id: ChatIdentifier;
+    /** The name. Leave unset (or blank) while the topic has not been named yet. */
     name?: string;
+    /** The identifier of whoever started it. Resolved to a name and avatar by the host at render time. */
     startedBy?: ChatIdentifier;
+    /** When it was started. */
     started?: Date;
+    /** When something last happened in it — used to order the topic list. Falls back to {@link started}. */
     lastActivity?: Date;
+    /** An open slot for whatever else the host's own topic shape carries. */
     metadata?: Record<string, unknown>;
 }
-//# sourceMappingURL=ChatTopic.d.ts.map

package/dist/esm/Chat/ChatTopic.js

@@ -1,2 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
 export {};
 //# sourceMappingURL=ChatTopic.js.map

package/dist/esm/Chat/ChatTopic.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChatTopic.js","sourceRoot":"","sources":["../../../Chat/ChatTopic.ts"],"names":[],"mappings":""}
+{"version":3,"file":"ChatTopic.js","sourceRoot":"","sources":["../../../Chat/ChatTopic.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/esm/Chat/ChatTopicList.d.ts

@@ -1,26 +1,76 @@
-import React, { type ReactNode } from 'react';
-import { type BuildAvatarUrlParams } from '../Canvas/shapes/ChatBubble/Avatar';
-import type { ChatAuthor } from './ChatAuthor';
-import { type ChatIdentifier } from './ChatIdentifier';
-import type { ChatTopic } from './ChatTopic';
-import { type RelativeTimestampLabels } from './relativeTimestamp';
+import type { ReactNode } from 'react';
+import { type BuildAvatarUrlParams } from './Kit/Avatar/index.js';
+import type { ChatAuthor } from './ChatAuthor.js';
+import { type ChatIdentifier } from './ChatIdentifier.js';
+import type { ChatTopic } from './ChatTopic.js';
+import { type RelativeTimestampLabels } from './relativeTimestamp.js';
+/** Overrides for every label the {@link ChatTopicList} renders. Any field left unset falls back
+ *  to a literal English default. */
 export interface ChatTopicListLabels {
+    /** The new-topic button. Defaults to `'New topic'`. */
     newTopic?: string;
+    /** Placeholder name for a topic that has not been named yet. Defaults to `'New topic'`. */
     unnamedTopic?: string;
+    /** The started-by line under a topic's name. `{name}` is substituted. Defaults to `'Started by {name}'`. */
     startedBy?: string;
+    /** Shown when there are no topics yet. Defaults to `'No topics yet. Start the first one!'`. */
     empty?: string;
+    /** Overrides for the relative last-activity timestamps. */
     timestamps?: RelativeTimestampLabels;
 }
+/**
+ * Props for {@link ChatTopicList}.
+ * @typeParam TTopic The host's topic type — anything extending {@link ChatTopic}.
+ */
 export interface ChatTopicListProps<TTopic extends ChatTopic = ChatTopic> {
+    /**
+     * The topics, in any order — the list orders them by most recent activity itself. Hand this
+     * the array a live (observable) query delivers and the list re-renders as it changes.
+     */
     topics: TTopic[];
+    /**
+     * Invoked when a topic is picked from the list.
+     * @param topic The topic that was picked.
+     */
     onOpen: (topic: TTopic) => void;
+    /**
+     * Invoked when a new topic is asked for. Creating the topic is the host's business — the
+     * component only raises the intent. Omit to leave the new-topic affordance off.
+     */
     onStart?: () => void;
+    /**
+     * Resolves an author id into what it takes to render whoever started a topic. Omit to fall
+     * back to rendering the id itself as the name.
+     * @param authorId The identifier of the author to resolve.
+     * @returns The author.
+     */
     authorOf?: (authorId: ChatIdentifier) => ChatAuthor;
+    /**
+     * Renders the avatar for whoever started a topic, replacing the built-in initials circle.
+     * @param authorId The identifier of the author.
+     * @param author The resolved author, as {@link authorOf} answered.
+     * @returns What to render.
+     */
     renderAvatar?: (authorId: ChatIdentifier, author: ChatAuthor) => ReactNode;
+    /**
+     * Decides whether a topic counts as unnamed and renders the pending placeholder. Defaults to
+     * "no name, or only whitespace" — override when the host's backend stores a literal
+     * placeholder for unnamed topics instead.
+     * @param topic The topic to check.
+     * @returns True when the topic has no usable name yet.
+     */
     isTopicUnnamed?: (topic: TTopic) => boolean;
+    /** Builds the avatar image URL for topic starters. Omit to always show initials. */
     buildAvatarUrl?: (params: BuildAvatarUrlParams) => string;
+    /** Overrides for every label rendered. Unset fields fall back to literal English defaults. */
     labels?: ChatTopicListLabels;
+    /** Additional class name for the list's root element. */
     className?: string;
 }
-export declare const ChatTopicList: <TTopic extends ChatTopic = ChatTopic>({ topics, onOpen, onStart, authorOf, renderAvatar, isTopicUnnamed, buildAvatarUrl, labels, className, }: ChatTopicListProps<TTopic>) => React.JSX.Element;
-//# sourceMappingURL=ChatTopicList.d.ts.map
+/**
+ * The topics of a chat, most recently active first — pick one to open its conversation, or start
+ * a new one. A topic that has not been named yet renders a placeholder in a pending style: with
+ * host-side auto-naming, the name arrives through the data once the host has produced it, and
+ * the placeholder simply stops being needed.
+ */
+export declare const ChatTopicList: <TTopic extends ChatTopic = ChatTopic>({ topics, onOpen, onStart, authorOf, renderAvatar, isTopicUnnamed, buildAvatarUrl, labels, className, }: ChatTopicListProps<TTopic>) => import("react").JSX.Element;

package/dist/esm/Chat/ChatTopicList.js

@@ -1,27 +1,31 @@
 import { jsxs, jsx } from 'react/jsx-runtime';
-import { PersonAvatarCircle } from '../Canvas/shapes/ChatBubble/Avatar/PersonAvatarCircle.js';
-import { ChatAuthorKind } from '../Canvas/shapes/ChatBubble/ChatAuthorKind.js';
+import { PersonAvatarCircle } from './Kit/Avatar/PersonAvatarCircle.js';
+import { ChatAuthorKind } from './Kit/ChatAuthorKind.js';
 import { chatIdentifierString } from './ChatIdentifier.js';
 import { isTopicUnnamed } from './isTopicUnnamed.js';
 import { relativeTimestamp } from './relativeTimestamp.js';
 import { topicsByActivity } from './topicsByActivity.js';
 
-/**
- * The topics of a chat, most recently active first — pick one to open its conversation, or start
- * a new one. A topic that has not been named yet renders a placeholder in a pending style: with
- * host-side auto-naming, the name arrives through the data once the host has produced it, and
- * the placeholder simply stops being needed.
- */
+const PlusIcon = () => (jsxs("svg", { width: '14', height: '14', viewBox: '0 0 24 24', fill: 'none', stroke: 'currentColor', strokeWidth: '2.5', "aria-hidden": 'true', children: [jsx("line", { x1: '12', y1: '5', x2: '12', y2: '19' }), jsx("line", { x1: '5', y1: '12', x2: '19', y2: '12' })] }));
 const ChatTopicList = ({ topics, onOpen, onStart, authorOf, renderAvatar, isTopicUnnamed: isTopicUnnamed$1, buildAvatarUrl, labels, className, }) => {
     const unnamed = isTopicUnnamed$1 ?? isTopicUnnamed;
-    const authorFor = (authorId) => authorOf?.(authorId) ?? { name: chatIdentifierString(authorId), kind: ChatAuthorKind.User };
-    return (jsxs("div", { className: `cratis-chat-topics${className ? ` ${className}` : ''}`, children: [onStart && (jsxs("button", { type: 'button', className: 'cratis-chat-topics__start', onClick: onStart, children: [jsx("i", { className: 'pi pi-plus', "aria-hidden": 'true' }), jsx("span", { children: labels?.newTopic ?? 'New topic' })] })), topics.length === 0 && (jsx("p", { className: 'cratis-chat-topics__empty', children: labels?.empty ?? 'No topics yet. Start the first one!' })), jsx("div", { className: 'cratis-chat-topics__list', role: 'list', children: topicsByActivity(topics).map(topic => {
-                    const starter = topic.startedBy !== undefined ? authorFor(topic.startedBy) : undefined;
+    const authorFor = (authorId) => authorOf?.(authorId) ?? {
+        name: chatIdentifierString(authorId),
+        kind: ChatAuthorKind.User,
+    };
+    return (jsxs("div", { className: `cratis-chat-topics${className ? ` ${className}` : ''}`, children: [onStart && (jsxs("button", { type: 'button', className: 'cratis-chat-topics__start', onClick: onStart, children: [jsx(PlusIcon, {}), jsx("span", { children: labels?.newTopic ?? 'New topic' })] })), topics.length === 0 && (jsx("p", { className: 'cratis-chat-topics__empty', children: labels?.empty ?? 'No topics yet. Start the first one!' })), jsx("ul", { className: 'cratis-chat-topics__list', children: topicsByActivity(topics).map((topic) => {
+                    const starter = topic.startedBy === undefined
+                        ? undefined
+                        : authorFor(topic.startedBy);
                     const isPending = unnamed(topic);
                     const activity = topic.lastActivity ?? topic.started;
-                    return (jsxs("button", { type: 'button', role: 'listitem', className: 'cratis-chat-topics__topic', onClick: () => onOpen(topic), children: [topic.startedBy !== undefined && starter && (renderAvatar
-                                ? renderAvatar(topic.startedBy, starter)
-                                : (jsx(PersonAvatarCircle, { userId: chatIdentifierString(topic.startedBy), name: starter.name, hasAvatar: starter.hasAvatar ?? false, size: 28, ownerType: starter.kind === ChatAuthorKind.Agent ? 'Agents' : 'Users', version: starter.avatarVersion, buildAvatarUrl: buildAvatarUrl }))), jsxs("span", { className: 'cratis-chat-topics__details', children: [jsx("span", { className: `cratis-chat-topics__name${isPending ? ' cratis-chat-topics__name--pending' : ''}`, children: isPending ? (labels?.unnamedTopic ?? 'New topic') : topic.name }), starter && (jsx("span", { className: 'cratis-chat-topics__started-by', children: (labels?.startedBy ?? 'Started by {name}').replace('{name}', starter.name) }))] }), activity !== undefined && (jsx("span", { className: 'cratis-chat-topics__activity', children: relativeTimestamp(activity, new Date(), labels?.timestamps) }))] }, chatIdentifierString(topic.id)));
+                    return (jsx("li", { children: jsxs("button", { type: 'button', className: 'cratis-chat-topics__topic', onClick: () => onOpen(topic), children: [topic.startedBy !== undefined &&
+                                    starter &&
+                                    (renderAvatar ? (renderAvatar(topic.startedBy, starter)) : (jsx(PersonAvatarCircle, { userId: chatIdentifierString(topic.startedBy), name: starter.name, hasAvatar: starter.hasAvatar ?? false, size: 28, ownerType: starter.kind === ChatAuthorKind.Agent
+                                            ? 'Agents'
+                                            : 'Users', version: starter.avatarVersion, buildAvatarUrl: buildAvatarUrl }))), jsxs("span", { className: 'cratis-chat-topics__details', children: [jsx("span", { className: `cratis-chat-topics__name${isPending ? ' cratis-chat-topics__name--pending' : ''}`, children: isPending
+                                                ? (labels?.unnamedTopic ?? 'New topic')
+                                                : topic.name }), starter && (jsx("span", { className: 'cratis-chat-topics__started-by', children: (labels?.startedBy ?? 'Started by {name}').replace('{name}', starter.name) }))] }), activity !== undefined && (jsx("span", { className: 'cratis-chat-topics__activity', children: relativeTimestamp(activity, new Date(), labels?.timestamps) }))] }) }, chatIdentifierString(topic.id)));
                 }) })] }));
 };
 

package/dist/esm/Chat/ChatTopicList.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChatTopicList.js","sources":["../../../Chat/ChatTopicList.tsx"],"sourcesContent":[null],"names":["isTopicUnnamed","defaultIsTopicUnnamed","_jsxs","_jsx"],"mappings":"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"}
+{"version":3,"file":"ChatTopicList.js","sources":["../../../Chat/ChatTopicList.tsx"],"sourcesContent":[null],"names":["_jsxs","_jsx","isTopicUnnamed","defaultIsTopicUnnamed"],"mappings":"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"}

package/dist/esm/Chat/Kit/AnchoredOverlay.d.ts

@@ -0,0 +1,34 @@
+import React, { ReactNode, RefObject } from 'react';
+/** The side of the anchor the overlay prefers to open on. */
+export type AnchoredOverlaySide = 'above' | 'below' | 'left' | 'right';
+/** Horizontal alignment relative to the anchor (for above/below overlays). */
+export type AnchoredOverlayAlign = 'left' | 'right' | 'center';
+/**
+ * Props for a fixed-position portalled overlay anchored to an element on the board. Board overlays
+ * (menus, pickers, tooltips) must float above everything: the slice columns use content-visibility
+ * paint containment for virtualization, which clips any absolutely-positioned descendant to the
+ * column box — portaling is what lets an overlay escape.
+ */
+export interface AnchoredOverlayProps {
+    /** The element the overlay anchors to. */
+    anchorRef: RefObject<HTMLElement | null>;
+    /** Whether the overlay is shown. */
+    open: boolean;
+    /** The preferred side; above/below flip when the viewport leaves no room. */
+    side?: AnchoredOverlaySide;
+    /** Horizontal alignment for above/below overlays. */
+    align?: AnchoredOverlayAlign;
+    /** Gap between the anchor and the overlay in pixels. */
+    gap?: number;
+    /** The overlay content. */
+    children: ReactNode;
+}
+/**
+ * Renders its children into a fixed-position portal on <body>, anchored to an element on the board.
+ * Board overlays (menus, pickers, tooltips) must float above everything: the slice columns use
+ * content-visibility paint containment for virtualization, which clips any absolutely-positioned
+ * descendant to the column box — portaling is what lets an overlay escape (the same approach the
+ * Cratis Dropdown takes with appendTo=document.body).
+ */
+export declare const AnchoredOverlay: React.FC<AnchoredOverlayProps>;
+//# sourceMappingURL=AnchoredOverlay.d.ts.map

package/dist/esm/Chat/Kit/AnchoredOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnchoredOverlay.d.ts","sourceRoot":"","sources":["../../../../Chat/Kit/AnchoredOverlay.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAA6B,MAAM,OAAO,CAAC;AAG/E,6DAA6D;AAC7D,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvE,8EAA8E;AAC9E,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACjC,0CAA0C;IAC1C,SAAS,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAEzC,oCAAoC;IACpC,IAAI,EAAE,OAAO,CAAC;IAEd,6EAA6E;IAC7E,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAE3B,qDAAqD;IACrD,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAE7B,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,2BAA2B;IAC3B,QAAQ,EAAE,SAAS,CAAC;CACvB;AAiDD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAqC1D,CAAC"}