@cratis/components 3.6.1 → 4.1.0

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

@@ -1,38 +1,105 @@
-import React, { type ReactNode } from 'react';
-import { type BuildAvatarUrlParams } from '../Canvas/shapes/ChatBubble/Avatar';
-import { type ChatComposerLabels } from '../Canvas/shapes/ChatBubble/ChatComposer';
-import type { ChatTypingAuthor } from '../Canvas/shapes/ChatBubble/ChatTypingAuthor';
-import type { MentionCandidate } from '../Canvas/shapes/ChatBubble/Mentions';
-import type { ChatAuthor } from './ChatAuthor';
-import { type ChatIdentifier } from './ChatIdentifier';
-import type { ChatMention } from './ChatMention';
-import type { ChatMessage } from './ChatMessage';
-import type { ChatMessageAction } from './ChatMessageAction';
-import { type RelativeTimestampLabels } from './relativeTimestamp';
+import { type ReactNode } from 'react';
+import { type BuildAvatarUrlParams } from './Kit/Avatar/index.js';
+import { type ChatComposerLabels } from './Kit/ChatComposer.js';
+import type { ChatTypingAuthor } from './Kit/ChatTypingAuthor.js';
+import type { MentionCandidate } from './Kit/Mentions/index.js';
+import type { ChatAuthor } from './ChatAuthor.js';
+import { type ChatIdentifier } from './ChatIdentifier.js';
+import type { ChatMention } from './ChatMention.js';
+import type { ChatMessage } from './ChatMessage.js';
+import type { ChatMessageAction } from './ChatMessageAction.js';
+import { type RelativeTimestampLabels } from './relativeTimestamp.js';
+/** Overrides for every label the {@link ChatConversation} renders. Any field left unset falls
+ *  back to a literal English default — this library ships no i18n mechanism of its own, so a host
+ *  that localizes passes its own translated strings through here. */
 export interface ChatConversationLabels {
+    /** Shown when there are no messages yet. Defaults to `'No messages yet. Say hello!'`. */
     empty?: string;
+    /** One author typing. `{name}` is substituted. Defaults to `'{name} is typing'`. */
     typing?: string;
+    /** Two authors typing. `{first}`/`{second}` are substituted. Defaults to `'{first} and {second} are typing'`. */
     typingTwo?: string;
+    /** Three or more authors typing. Defaults to `'Several people are typing'`. */
     typingSeveral?: string;
+    /** Tooltip/accessible label for the quick-reply button. `{name}` is substituted. Defaults to `'Reply to {name}'`. */
     quickReplyTo?: string;
+    /** Overrides for the relative timestamps next to messages. */
     timestamps?: RelativeTimestampLabels;
+    /** Labels forwarded to the composer. */
     composer?: ChatComposerLabels;
 }
+/**
+ * Props for {@link ChatConversation}.
+ * @typeParam TMessage The host's message type — anything extending {@link ChatMessage}.
+ */
 export interface ChatConversationProps<TMessage extends ChatMessage = ChatMessage> {
+    /**
+     * The messages of the conversation, rendered in the order given. Hand this the array a live
+     * (observable) query delivers and the conversation re-renders as it changes.
+     */
     messages: TMessage[];
+    /**
+     * Invoked when a message is sent, with the trimmed body and who it mentions. Everything else
+     * about persisting the message is the host's business.
+     * @param body The message text, mentions written into it as plain `@Name`.
+     * @param mentions Who the body mentions.
+     */
     onSendMessage: (body: string, mentions: ChatMention[]) => void;
+    /**
+     * Resolves an author id into what it takes to render them — name, kind, whether an avatar
+     * image exists. Messages deliberately carry only the id; this is where the rest comes from.
+     * 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 an author, replacing the built-in initials circle entirely.
+     * @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;
+    /**
+     * Renders the display name for an author, replacing the built-in name text entirely.
+     * @param authorId The identifier of the author.
+     * @param author The resolved author, as {@link authorOf} answered.
+     * @returns What to render.
+     */
     renderAuthorName?: (authorId: ChatIdentifier, author: ChatAuthor) => ReactNode;
+    /** The host's own actions, offered as buttons on every message each is available for. */
     actions?: ChatMessageAction<TMessage>[];
+    /** Everyone who can be mentioned, when the host already holds the list. Omit (together with
+     *  {@link resolveMentionCandidates}) to turn mentions off. */
     mentionCandidates?: MentionCandidate[];
+    /**
+     * Resolves who can be mentioned as the person types, invoked with what has been typed after
+     * the `@`. May answer synchronously or with a promise.
+     * @param query What has been typed after the `@`.
+     * @returns The candidates matching the query.
+     */
     resolveMentionCandidates?: (query: string) => MentionCandidate[] | Promise<MentionCandidate[]>;
+    /** Who the conversation is currently waiting on — someone typing, or an agent working. */
     typingAuthors?: ChatTypingAuthor[];
+    /** Whether the quick-reply affordance (prefill the composer with `@Name`) is offered on
+     *  messages. Defaults to true. */
     quickReply?: boolean;
+    /** Builds the avatar image URL for every author shown. Omit to always show initials. */
     buildAvatarUrl?: (params: BuildAvatarUrlParams) => string;
+    /** Whether the composer takes focus when mounted. */
     autoFocus?: boolean;
+    /** Overrides for every label rendered. Unset fields fall back to literal English defaults. */
     labels?: ChatConversationLabels;
+    /** Additional class name for the conversation's root element. */
     className?: string;
 }
-export declare const ChatConversation: <TMessage extends ChatMessage = ChatMessage>({ messages, onSendMessage, authorOf, renderAvatar, renderAuthorName, actions, mentionCandidates, resolveMentionCandidates, typingAuthors, quickReply, buildAvatarUrl, autoFocus, labels, className, }: ChatConversationProps<TMessage>) => React.JSX.Element;
-//# sourceMappingURL=ChatConversation.d.ts.map
+/**
+ * One conversation — its messages and the composer to add to them. Host-agnostic by design: it
+ * renders whatever message array it is given (hand it a live query's data and it stays current),
+ * resolves authors through the host's {@link ChatConversationProps.authorOf | authorOf} and
+ * render callbacks, offers the host's own {@link ChatConversationProps.actions | actions} on
+ * each message, and reports sends back through
+ * {@link ChatConversationProps.onSendMessage | onSendMessage} without any opinion about the
+ * backend behind it. Mentions and the emoji picker come along through the composer.
+ */
+export declare const ChatConversation: <TMessage extends ChatMessage = ChatMessage>({ messages, onSendMessage, authorOf, renderAvatar, renderAuthorName, actions, mentionCandidates, resolveMentionCandidates, typingAuthors, quickReply, buildAvatarUrl, autoFocus, labels, className, }: ChatConversationProps<TMessage>) => import("react").JSX.Element;

package/dist/esm/Chat/ChatConversation.js

@@ -1,14 +1,14 @@
 import { jsxs, jsx } from 'react/jsx-runtime';
 import { useRef, useMemo, useEffect } from 'react';
-import { PersonAvatarCircle } from '../Canvas/shapes/ChatBubble/Avatar/PersonAvatarCircle.js';
-import { ChatAuthorKind } from '../Canvas/shapes/ChatBubble/ChatAuthorKind.js';
-import { ChatComposer } from '../Canvas/shapes/ChatBubble/ChatComposer.js';
-import { TypingIndicator } from '../Canvas/shapes/ChatBubble/TypingIndicator.js';
+import { PersonAvatarCircle } from './Kit/Avatar/PersonAvatarCircle.js';
+import { ChatAuthorKind } from './Kit/ChatAuthorKind.js';
+import { ChatComposer } from './Kit/ChatComposer.js';
+import { TypingIndicator } from './Kit/TypingIndicator.js';
 import { chatIdentifierString } from './ChatIdentifier.js';
 import { ChatMessageBody } from './ChatMessageBody.js';
 import { relativeTimestamp } from './relativeTimestamp.js';
 
-/** The message's timestamp as a `Date` — data that traveled through JSON may carry it as a string. */
+const ReplyIcon = () => (jsxs("svg", { width: '14', height: '14', viewBox: '0 0 24 24', fill: 'none', stroke: 'currentColor', strokeWidth: '2.5', "aria-hidden": 'true', children: [jsx("polyline", { points: '9 17 4 12 9 7' }), jsx("path", { d: 'M4 12h10a6 6 0 0 1 6 6v1' })] }));
 const timestampOf = (message) => message.timestamp instanceof Date ? message.timestamp : new Date(message.timestamp);
 const sameMinute = (left, right) => left.getFullYear() === right.getFullYear() &&
     left.getMonth() === right.getMonth() &&
@@ -18,36 +18,26 @@ const sameMinute = (left, right) => left.getFullYear() === right.getFullYear() &
 const computeRenderInfo = (messages) => messages.map((message, index) => {
     const previous = index > 0 ? messages[index - 1] : undefined;
     const next = index < messages.length - 1 ? messages[index + 1] : undefined;
-    const showAuthor = !previous || chatIdentifierString(previous.authorId) !== chatIdentifierString(message.authorId);
+    const showAuthor = !previous ||
+        chatIdentifierString(previous.authorId) !==
+            chatIdentifierString(message.authorId);
     const showTimestamp = !next ||
-        chatIdentifierString(next.authorId) !== chatIdentifierString(message.authorId) ||
+        chatIdentifierString(next.authorId) !==
+            chatIdentifierString(message.authorId) ||
         !sameMinute(timestampOf(message), timestampOf(next));
     return { showAuthor, showTimestamp };
 });
-/**
- * Composes the "X is typing" line from whoever the conversation is waiting on.
- * @param authors The authors currently typing or working.
- * @param labels Label overrides, as passed to {@link ChatConversation}.
- * @returns The label to show, empty when nobody is.
- */
 const typingLabel = (authors, labels) => {
     if (authors.length === 0)
         return '';
     if (authors.length === 1)
         return (labels?.typing ?? '{name} is typing').replace('{name}', authors[0].name);
     if (authors.length === 2)
-        return (labels?.typingTwo ?? '{first} and {second} are typing').replace('{first}', authors[0].name).replace('{second}', authors[1].name);
+        return (labels?.typingTwo ?? '{first} and {second} are typing')
+            .replace('{first}', authors[0].name)
+            .replace('{second}', authors[1].name);
     return labels?.typingSeveral ?? 'Several people are typing';
 };
-/**
- * One conversation — its messages and the composer to add to them. Host-agnostic by design: it
- * renders whatever message array it is given (hand it a live query's data and it stays current),
- * resolves authors through the host's {@link ChatConversationProps.authorOf | authorOf} and
- * render callbacks, offers the host's own {@link ChatConversationProps.actions | actions} on
- * each message, and reports sends back through
- * {@link ChatConversationProps.onSendMessage | onSendMessage} without any opinion about the
- * backend behind it. Mentions and the emoji picker come along through the composer.
- */
 const ChatConversation = ({ messages, onSendMessage, authorOf, renderAvatar, renderAuthorName, actions, mentionCandidates, resolveMentionCandidates, typingAuthors = [], quickReply = true, buildAvatarUrl, autoFocus = false, labels, className, }) => {
     const composerRef = useRef(null);
     const messagesEndRef = useRef(null);
@@ -55,17 +45,28 @@ const ChatConversation = ({ messages, onSendMessage, authorOf, renderAvatar, ren
     useEffect(() => {
         messagesEndRef.current?.scrollIntoView({ behavior: 'smooth', block: 'nearest' });
     }, [messages, typingAuthors.length]);
-    const authorFor = (authorId) => authorOf?.(authorId) ?? { name: chatIdentifierString(authorId), kind: ChatAuthorKind.User };
-    const send = (text, mentioned) => onSendMessage(text, mentioned.map(candidate => ({ id: candidate.id, name: candidate.name, kind: candidate.kind })));
+    const authorFor = (authorId) => authorOf?.(authorId) ?? {
+        name: chatIdentifierString(authorId),
+        kind: ChatAuthorKind.User,
+    };
+    const send = (text, mentioned) => onSendMessage(text, mentioned.map((candidate) => ({
+        id: candidate.id,
+        name: candidate.name,
+        kind: candidate.kind,
+    })));
     const quickReplyTo = (name) => composerRef.current?.prefill(`@${name} `);
     return (jsxs("div", { className: `cratis-chat-conversation${className ? ` ${className}` : ''}`, children: [jsxs("div", { className: 'cratis-chat-conversation__messages', children: [messages.length === 0 && (jsx("p", { className: 'cratis-chat-conversation__empty', children: labels?.empty ?? 'No messages yet. Say hello!' })), messages.map((message, index) => {
                         const author = authorFor(message.authorId);
                         const { showAuthor, showTimestamp } = renderInfo[index];
-                        const availableActions = (actions ?? []).filter(action => action.isAvailable?.(message) ?? true);
+                        const availableActions = (actions ?? []).filter((action) => action.isAvailable?.(message) ?? true);
                         const showActionsRow = quickReply || availableActions.length > 0;
-                        return (jsxs("div", { className: `cratis-chat-message${showAuthor ? '' : ' cratis-chat-message--continuation'}`, children: [showAuthor && (jsxs("div", { className: 'cratis-chat-message__author', children: [renderAvatar
-                                            ? renderAvatar(message.authorId, author)
-                                            : (jsx(PersonAvatarCircle, { userId: chatIdentifierString(message.authorId), name: author.name, hasAvatar: author.hasAvatar ?? false, size: 22, ownerType: author.kind === ChatAuthorKind.Agent ? 'Agents' : 'Users', version: author.avatarVersion, buildAvatarUrl: buildAvatarUrl })), jsx("span", { className: 'cratis-chat-message__author-name', children: renderAuthorName ? renderAuthorName(message.authorId, author) : author.name })] })), jsxs("div", { className: 'cratis-chat-message__content', children: [jsxs("div", { className: `cratis-chat-message__panel${showActionsRow ? ' cratis-chat-message__panel--with-actions' : ''}`, children: [jsx(ChatMessageBody, { body: message.body, mentions: message.mentions }), showActionsRow && (jsxs("div", { className: 'cratis-chat-message__actions', children: [quickReply && (jsx("button", { type: 'button', className: 'cratis-chat-message__action', title: (labels?.quickReplyTo ?? 'Reply to {name}').replace('{name}', author.name), "aria-label": (labels?.quickReplyTo ?? 'Reply to {name}').replace('{name}', author.name), onClick: () => quickReplyTo(author.name), children: jsx("i", { className: 'pi pi-reply', "aria-hidden": 'true' }) })), availableActions.map(action => (jsx("button", { type: 'button', className: 'cratis-chat-message__action', title: action.label, "aria-label": action.label, onClick: () => action.onInvoke(message), children: typeof action.icon === 'string' ? jsx("i", { className: action.icon, "aria-hidden": 'true' }) : action.icon }, action.id)))] }))] }), showTimestamp && (jsx("span", { className: 'cratis-chat-message__time', children: relativeTimestamp(timestampOf(message), new Date(), labels?.timestamps) }))] })] }, chatIdentifierString(message.id)));
+                        return (jsxs("div", { className: `cratis-chat-message${showAuthor ? '' : ' cratis-chat-message--continuation'}`, children: [showAuthor && (jsxs("div", { className: 'cratis-chat-message__author', children: [renderAvatar ? (renderAvatar(message.authorId, author)) : (jsx(PersonAvatarCircle, { userId: chatIdentifierString(message.authorId), name: author.name, hasAvatar: author.hasAvatar ?? false, size: 22, ownerType: author.kind === ChatAuthorKind.Agent
+                                                ? 'Agents'
+                                                : 'Users', version: author.avatarVersion, buildAvatarUrl: buildAvatarUrl })), jsx("span", { className: 'cratis-chat-message__author-name', children: renderAuthorName
+                                                ? renderAuthorName(message.authorId, author)
+                                                : author.name })] })), jsxs("div", { className: 'cratis-chat-message__content', children: [jsxs("div", { className: `cratis-chat-message__panel${showActionsRow ? ' cratis-chat-message__panel--with-actions' : ''}`, children: [jsx(ChatMessageBody, { body: message.body, mentions: message.mentions }), showActionsRow && (jsxs("div", { className: 'cratis-chat-message__actions', children: [quickReply && (jsx("button", { type: 'button', className: 'cratis-chat-message__action', title: (labels?.quickReplyTo ??
+                                                                'Reply to {name}').replace('{name}', author.name), "aria-label": (labels?.quickReplyTo ??
+                                                                'Reply to {name}').replace('{name}', author.name), onClick: () => quickReplyTo(author.name), children: jsx(ReplyIcon, {}) })), availableActions.map((action) => (jsx("button", { type: 'button', className: 'cratis-chat-message__action', title: action.label, "aria-label": action.label, onClick: () => action.onInvoke(message), children: typeof action.icon === 'string' ? (jsx("i", { className: action.icon, "aria-hidden": 'true' })) : (action.icon) }, action.id)))] }))] }), showTimestamp && (jsx("span", { className: 'cratis-chat-message__time', children: relativeTimestamp(timestampOf(message), new Date(), labels?.timestamps) }))] })] }, chatIdentifierString(message.id)));
                     }), jsx(TypingIndicator, { authors: typingAuthors, label: typingLabel(typingAuthors, labels), buildAvatarUrl: buildAvatarUrl }), jsx("div", { ref: messagesEndRef })] }), jsx(ChatComposer, { ref: composerRef, mentionCandidates: mentionCandidates, resolveMentionCandidates: resolveMentionCandidates, onSend: send, autoFocus: autoFocus, buildAvatarUrl: buildAvatarUrl, labels: labels?.composer })] }));
 };
 

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

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

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

@@ -1,6 +1,24 @@
+/**
+ * An identifier as the chat components accept it — a string, or anything that renders itself as
+ * one (a `Guid` from `@cratis/fundamentals`, a number, a custom id type). The components never
+ * inspect an identifier beyond turning it into a string, so a host can hand them whatever its
+ * data source delivers without mapping every record first.
+ */
 export type ChatIdentifier = string | {
     toString(): string;
 };
+/**
+ * The canonical string form of an identifier, used for React keys and comparisons.
+ * @param identifier The identifier to render.
+ * @returns The identifier as a string.
+ */
 export declare const chatIdentifierString: (identifier: ChatIdentifier) => string;
+/**
+ * Whether two identifiers refer to the same thing, compared by their string form so a `Guid`
+ * and the string it prints as are the same identifier.
+ * @param left One identifier, possibly not set.
+ * @param right The other identifier, possibly not set.
+ * @returns True when both are set and equal.
+ */
 export declare const sameChatIdentifier: (left?: ChatIdentifier, right?: ChatIdentifier) => boolean;
 //# sourceMappingURL=ChatIdentifier.d.ts.map

package/dist/esm/Chat/ChatIdentifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatIdentifier.d.ts","sourceRoot":"","sources":["../../../Chat/ChatIdentifier.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IAAE,QAAQ,IAAI,MAAM,CAAA;CAAE,CAAC;AAO7D,eAAO,MAAM,oBAAoB,GAAI,YAAY,cAAc,KAAG,MAA4B,CAAC;AAS/F,eAAO,MAAM,kBAAkB,GAAI,OAAO,cAAc,EAAE,QAAQ,cAAc,KAAG,OACJ,CAAC"}
+{"version":3,"file":"ChatIdentifier.d.ts","sourceRoot":"","sources":["../../../Chat/ChatIdentifier.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IAAE,QAAQ,IAAI,MAAM,CAAA;CAAE,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,YAAY,cAAc,KAAG,MAC5C,CAAC;AAEvB;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC3B,OAAO,cAAc,EACrB,QAAQ,cAAc,KACvB,OAAsF,CAAC"}

package/dist/esm/Chat/ChatIdentifier.js

@@ -1,18 +1,4 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-/**
- * The canonical string form of an identifier, used for React keys and comparisons.
- * @param identifier The identifier to render.
- * @returns The identifier as a string.
- */
 const chatIdentifierString = (identifier) => String(identifier);
-/**
- * Whether two identifiers refer to the same thing, compared by their string form so a `Guid`
- * and the string it prints as are the same identifier.
- * @param left One identifier, possibly not set.
- * @param right The other identifier, possibly not set.
- * @returns True when both are set and equal.
- */
 const sameChatIdentifier = (left, right) => left !== undefined && right !== undefined && String(left) === String(right);
 
 export { chatIdentifierString, sameChatIdentifier };

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

@@ -1 +1 @@
-{"version":3,"file":"ChatIdentifier.js","sources":["../../../Chat/ChatIdentifier.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACA;AAUA;;;;AAIG;AACI,MAAM,oBAAoB,GAAG,CAAC,UAA0B,KAAa,MAAM,CAAC,UAAU;AAE7F;;;;;;AAMG;AACI,MAAM,kBAAkB,GAAG,CAAC,IAAqB,EAAE,KAAsB,KAC5E,IAAI,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,KAAK;;"}
+{"version":3,"file":"ChatIdentifier.js","sources":["../../../Chat/ChatIdentifier.ts"],"sourcesContent":[null],"names":[],"mappings":"AAgBO,MAAM,oBAAoB,GAAG,CAAC,UAA0B,KAC3D,MAAM,CAAC,UAAU;AASd,MAAM,kBAAkB,GAAG,CAC9B,IAAqB,EACrB,KAAsB,KACZ,IAAI,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,KAAK;;"}

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

@@ -1,8 +1,16 @@
-import { ChatAuthorKind } from '../Canvas/shapes/ChatBubble/ChatAuthorKind';
-import type { ChatIdentifier } from './ChatIdentifier';
+import type { ChatAuthorKind } from './Kit/ChatAuthorKind.js';
+import type { ChatIdentifier } from './ChatIdentifier.js';
+/**
+ * Somebody a message mentions — a person or an agent. The mention is written into the message
+ * body as the plain text `@Name`, so the body stays readable on its own; this record is what
+ * lets the body render the mention distinctly and lets the host know who was addressed without
+ * re-parsing the text.
+ */
 export interface ChatMention {
+    /** The identifier of who is mentioned. */
     id: ChatIdentifier;
+    /** The name the mention is written with, exactly as it appears after the `@` in the body. */
     name: string;
+    /** Whether this is a person or an agent. */
     kind: ChatAuthorKind;
 }
-//# sourceMappingURL=ChatMention.d.ts.map

package/dist/esm/Chat/ChatMention.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=ChatMention.js.map

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

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

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

@@ -1,12 +1,28 @@
-import type { ChatIdentifier } from './ChatIdentifier';
-import type { ChatMention } from './ChatMention';
+import type { ChatIdentifier } from './ChatIdentifier.js';
+import type { ChatMention } from './ChatMention.js';
+/**
+ * The shape of a message as the chat components need it — deliberately minimal, so the arrays a
+ * host's own queries deliver can be handed to the components as they are (or with a thin map).
+ * Everything about the *author* beyond the identifier is resolved at render time through the
+ * host's `authorOf` resolver and render callbacks, so the message never goes stale when someone
+ * is renamed.
+ *
+ * Extend the interface for anything the host's own actions need — the components are generic
+ * over the message type, and every action callback receives the full message back.
+ */
 export interface ChatMessage {
+    /** The identifier of the message. */
     id: ChatIdentifier;
+    /** The identifier of the topic the message belongs to. */
     topicId: ChatIdentifier;
+    /** The identifier of whoever wrote it. Resolved to a name and avatar by the host at render time. */
     authorId: ChatIdentifier;
+    /** What was written. Mentions appear in it as plain `@Name` text. */
     body: string;
+    /** When it was written. */
     timestamp: Date;
+    /** Who the body mentions, so mentions can render distinctly without re-parsing the text. */
     mentions?: ChatMention[];
+    /** An open slot for whatever else the host's own message shape carries. */
     metadata?: Record<string, unknown>;
 }
-//# sourceMappingURL=ChatMessage.d.ts.map

package/dist/esm/Chat/ChatMessage.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=ChatMessage.js.map

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

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

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

@@ -1,10 +1,27 @@
 import type { ReactNode } from 'react';
-import type { ChatMessage } from './ChatMessage';
+import type { ChatMessage } from './ChatMessage.js';
+/**
+ * An action a host offers on messages — shown as a button on every message it is available for.
+ * The library ships no actions of its own; whatever a message can be turned into (a task, an
+ * issue, a document) is the host's business, expressed as descriptors like this one.
+ * @typeParam TMessage The host's message type, so {@link onInvoke} receives the full message back.
+ */
 export interface ChatMessageAction<TMessage extends ChatMessage = ChatMessage> {
+    /** Identifies the action among its siblings — used as the rendering key. */
     id: string;
+    /** The label, shown as the button's tooltip and accessible name. */
     label: string;
+    /** The icon — a CSS class name for an icon font the host provides, or a ready element. */
     icon: string | ReactNode;
+    /**
+     * Decides which messages the action is offered on. Omit to offer it on all of them.
+     * @param message The message the action would apply to.
+     * @returns True when the action should be offered.
+     */
     isAvailable?: (message: TMessage) => boolean;
+    /**
+     * Invoked when the action is picked on a message.
+     * @param message The message it was picked on.
+     */
     onInvoke: (message: TMessage) => void;
 }
-//# sourceMappingURL=ChatMessageAction.d.ts.map

package/dist/esm/Chat/ChatMessageAction.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=ChatMessageAction.js.map

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

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

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

@@ -1,8 +1,18 @@
 import React from 'react';
-import type { ChatMention } from './ChatMention';
+import type { ChatMention } from './ChatMention.js';
+/**
+ * Props for {@link ChatMessageBody}.
+ */
 export interface ChatMessageBodyProps {
+    /** The message text. Mentions appear in it as plain `@Name` text. */
     body: string;
+    /** Who the body mentions — these render distinctly. Omit for a body with no mentions. */
     mentions?: ChatMention[];
 }
+/**
+ * The text of one message. The body itself is plain text — including its `@Name` mentions — and
+ * this component is what makes the mentions *look* like mentions: each known one renders as its
+ * own element, marked with who it addresses, so a person and an agent mention can be styled
+ * apart and the host's own CSS can hang further behavior off them.
+ */
 export declare const ChatMessageBody: ({ body, mentions }: ChatMessageBodyProps) => React.JSX.Element;
-//# sourceMappingURL=ChatMessageBody.d.ts.map

package/dist/esm/Chat/ChatMessageBody.js

@@ -1,17 +1,9 @@
 import { jsx } from 'react/jsx-runtime';
 import React from 'react';
-import '../Canvas/shapes/ChatBubble/ChatAuthorKind.js';
-import { mentionSegments } from '../Canvas/shapes/ChatBubble/Mentions/mentionSegments.js';
+import './Kit/ChatAuthorKind.js';
+import { mentionSegments } from './Kit/Mentions/mentionSegments.js';
 
-/**
- * The text of one message. The body itself is plain text — including its `@Name` mentions — and
- * this component is what makes the mentions *look* like mentions: each known one renders as its
- * own element, marked with who it addresses, so a person and an agent mention can be styled
- * apart and the host's own CSS can hang further behavior off them.
- */
-const ChatMessageBody = ({ body, mentions }) => (jsx("p", { className: 'cratis-chat-message__body', children: mentionSegments(body, mentions ?? []).map((segment, index) => segment.mention
-        ? (jsx("span", { className: 'cratis-chat-message__mention', "data-kind": segment.mention.kind, children: segment.text }, index))
-        : jsx(React.Fragment, { children: segment.text }, index)) }));
+const ChatMessageBody = ({ body, mentions }) => (jsx("p", { className: 'cratis-chat-message__body', children: mentionSegments(body, mentions ?? []).map((segment, index) => segment.mention ? (jsx("span", { className: 'cratis-chat-message__mention', "data-kind": segment.mention.kind, children: segment.text }, index)) : (jsx(React.Fragment, { children: segment.text }, index))) }));
 
 export { ChatMessageBody };
 //# sourceMappingURL=ChatMessageBody.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ChatMessageBody.js","sources":["../../../Chat/ChatMessageBody.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":";;;;;AAmBA;;;;;AAKG;AACI,MAAM,eAAe,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAwB,MACpEA,GAAA,CAAA,GAAA,EAAA,EAAG,SAAS,EAAC,2BAA2B,EAAA,QAAA,EACnC,eAAe,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,KACtD,OAAO,CAAC;AACJ,WACIA,GAAA,CAAA,MAAA,EAAA,EAEI,SAAS,EAAC,8BAA8B,eAC7B,OAAO,CAAC,OAAO,CAAC,IAAI,YAE9B,OAAO,CAAC,IAAI,EAAA,EAJR,KAAK,CAKP;AAEX,UAAEA,GAAA,CAAC,KAAK,CAAC,QAAQ,EAAA,EAAA,QAAA,EAAc,OAAO,CAAC,IAAI,IAApB,KAAK,CAAiC,CACpE,EAAA,CACD;;"}
+{"version":3,"file":"ChatMessageBody.js","sources":["../../../Chat/ChatMessageBody.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":";;;;;AAwBO,MAAM,eAAe,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAwB,MACpEA,GAAA,CAAA,GAAA,EAAA,EAAG,SAAS,EAAC,2BAA2B,EAAA,QAAA,EACnC,eAAe,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,KACtD,OAAO,CAAC,OAAO,IACXA,GAAA,CAAA,MAAA,EAAA,EAEI,SAAS,EAAC,8BAA8B,EAAA,WAAA,EAC7B,OAAO,CAAC,OAAO,CAAC,IAAI,EAAA,QAAA,EAE9B,OAAO,CAAC,IAAI,IAJR,KAAK,CAKP,KAEPA,IAAC,KAAK,CAAC,QAAQ,EAAA,EAAA,QAAA,EAAc,OAAO,CAAC,IAAI,IAApB,KAAK,CAAiC,CAC9D,CACJ,EAAA,CACD;;"}