inline-chat-kit 0.55.2 → 0.57.0

package/dist/ChatInput/AddCardsOverlay.d.ts

@@ -1,11 +1,28 @@
-import { default as React } from 'react';
+import { default as React, ReactNode } from 'react';
 import { InlineAnimConfig } from './ChatInput';
+/**
+ * One entry in the composer's "+" menu.
+ *
+ * `attach` is the one id the composer knows: without an `onSelect` of its own
+ * it opens the file picker, which is what the first built-in entry does.
+ */
+export interface ComposerMenuItem {
+    id: string;
+    label: string;
+    icon?: ReactNode;
+    onSelect?: () => void;
+}
+/** What the menu holds when the host says nothing, in the reader's language. */
+export declare function useDefaultComposerMenu(): ComposerMenuItem[];
 export interface AddCardsOverlayProps {
     isAddOpen: boolean;
     setIsAddOpen: React.Dispatch<React.SetStateAction<boolean>>;
-    onAdd?: (label?: string) => void;
+    /** Called with the entry's label and, second, its id — match on the id. */
+    onAdd?: (label?: string, id?: string) => void;
+    /** The entries. Defaults to Add, Design and Connectors. */
+    items?: ComposerMenuItem[];
     showInlineGlyph: boolean;
     showButtons: boolean;
     ac: InlineAnimConfig | undefined;
 }
-export declare function AddCardsOverlay({ isAddOpen, setIsAddOpen, onAdd, showInlineGlyph, showButtons, ac, }: AddCardsOverlayProps): React.JSX.Element;
+export declare function AddCardsOverlay({ isAddOpen, setIsAddOpen, onAdd, items, showInlineGlyph, showButtons, ac, }: AddCardsOverlayProps): React.JSX.Element;

package/dist/ChatInput/ChatInput.d.ts

@@ -1,5 +1,7 @@
 import { Attachment } from '../Attachments/Attachments';
+import { ComposerMenuItem } from './AddCardsOverlay';
 import { TranscribeHandler } from '../voice/useVoiceInput';
+import { ChatInputLabels } from '../labels/labels';
 export type ChatInputState = "idle" | "typing" | "responding" | "resting";
 export interface InlineAnimConfig {
     bubble: {
@@ -112,6 +114,14 @@ export interface ChatInputProps {
     onCancelEdit?: () => void;
     isEditing?: boolean;
     placeholder?: string;
+    /**
+     * What the "+" opens. Left out, the built-in three — Add, Design,
+     * Connectors. A list replaces them; an entry with id `"attach"` and no
+     * `onSelect` opens the file picker. `false` takes the "+" away altogether.
+     */
+    menu?: ComposerMenuItem[] | false;
+    /** Every word the composer says. See `ChatLabels`. */
+    labels?: Partial<ChatInputLabels>;
     animationConfig?: InlineAnimConfig;
     style?: React.CSSProperties;
 }

package/dist/ChatTurnRow/ChatTurnRow.d.ts

@@ -1,4 +1,4 @@
-import { Ref } from 'react';
+import { ReactNode, Ref } from 'react';
 import { Verdict } from '../AnswerActions/AnswerActions';
 import { ChatInputHandle, InlineAnimConfig } from '../ChatInput/ChatInput';
 import { Attachment } from '../Attachments/Attachments';
@@ -7,6 +7,9 @@ import { Decision } from '../Approval/Approval';
 import { FoldMotion } from '../QuestionGroup/QuestionGroup';
 import { Answer } from '../QuestionCard/types';
 import { ChatTurn } from '../useChatTurns/useChatTurns';
+import { CustomPart, CustomPartContext } from '../turnParts/turnParts';
+import { ComposerMenuItem } from '../ChatInput/AddCardsOverlay';
+import { ChatLabels } from '../labels/labels';
 export interface ChatTurnRowProps {
     turn: ChatTurn;
     /** This row owns the live composer: the one the reader types the next question into. */
@@ -22,6 +25,12 @@ export interface ChatTurnRowProps {
      */
     openArtifactId?: string | null;
     onOpenArtifact?: (turnId: string, artifactId: string) => void;
+    /**
+     * Set which artifact is open, or `null` to close it. What a custom card's
+     * `openArtifact` / `closeArtifact` call. Left out, `openArtifact` falls back
+     * to `onOpenArtifact` and `closeArtifact` does nothing. Keep it stable.
+     */
+    onArtifactChange?: (artifactId: string | null) => void;
     /** Stagger for the entrance, in seconds. */
     entranceDelay?: number;
     /** Passed through to the highlighter over the answer. */
@@ -92,24 +101,35 @@ export interface ChatTurnRowProps {
      * not keep the decision, it reports it. Write it back with `updatePart`.
      */
     onDecideApproval?: (turnId: string, partId: string, decision: Decision) => void;
+    /**
+     * Draws a `{ kind: "custom" }` part — the host's own card, in the answer.
+     *
+     * Called with the part and the turn it is in, and whatever it returns is
+     * drawn where the part sits among the others. Left out, or returning `null`,
+     * the part draws nothing: no placeholder, no error. A part the host does not
+     * recognise is a part it chose not to draw.
+     *
+     * **Keep it stable** — define it outside the component, or wrap it in
+     * `useCallback`. The row is memoised, and a new function every render is a
+     * changed prop on every row, so every finished answer re-renders on every
+     * frame of the one arriving. What the card needs to change — "applied", say
+     * — belongs in the part's `data`, written with `updatePart`, not in a
+     * closure: then only the row that owns it re-renders.
+     */
+    renderPart?: (part: CustomPart, context: CustomPartContext) => ReactNode;
+    /**
+     * The live composer's "+" menu. `false` takes the "+" away; a list replaces
+     * the built-in three. See `ChatInput`'s `menu`. Keep it stable, for the
+     * reason `renderPart` has to be.
+     */
+    composerMenu?: ComposerMenuItem[] | false;
+    /**
+     * Every word the row and everything in it says. Partial: what is left out
+     * stays English. Compared by content rather than identity, so an object
+     * written inline does not cost the memo anything — though for a whole
+     * conversation, one `LabelsProvider` around the list does the same job once.
+     */
+    labels?: ChatLabels;
     className?: string;
 }
-/**
- * One turn: the question as a composer that has become a bubble, and the
- * answer beneath it.
- *
- * Not `Message`, because it is not one. The user half is a live input that
- * morphs into its own bubble rather than a rendered record of what was typed
- * — which is the whole idea, and the reason the row is a turn.
- *
- * **Memoised, and the memo is load-bearing.** `useChatTurns` already leaves
- * untouched turns referentially identical when it rewrites one of them, but
- * that only pays off if the rows can act on it. Left inline in a `.map()`,
- * every row re-renders on every flush anyway, because the parent re-rendered.
- * Measured before this existed: streaming a second answer produced 366 DOM
- * mutations inside the first, already-finished turn.
- *
- * The two halves have to be in place together. Stable objects give React the
- * grounds to skip; `memo` is what makes it skip.
- */
-export declare const ChatTurnRow: import('react').MemoExoticComponent<({ turn, isActiveInput, inputRef, placeholder, animationConfig, foldMotion, openArtifactId, onOpenArtifact, entranceDelay, selectionMode, questionAlign, onDraft, onSubmit, onStop, onEdit, onCancelEdit, onCopy, onHighlight, onReplyInThread, onRegenerate, onShowVersion, onFeedback, feedback, answerActions, onAnswerQuestion, onEditQuestion, onDecideApproval, className, onTranscribe, }: ChatTurnRowProps) => import("react").JSX.Element>;
+export declare const ChatTurnRow: import('react').MemoExoticComponent<({ turn, isActiveInput, inputRef, placeholder, animationConfig, foldMotion, openArtifactId, onOpenArtifact, onArtifactChange, entranceDelay, selectionMode, questionAlign, onDraft, onSubmit, onStop, onEdit, onCancelEdit, onCopy, onHighlight, onReplyInThread, onRegenerate, onShowVersion, onFeedback, feedback, answerActions, onAnswerQuestion, onEditQuestion, onDecideApproval, renderPart, composerMenu, labels, className, onTranscribe, }: ChatTurnRowProps) => import("react").JSX.Element>;

package/dist/CodeBlock/CodeBlock.d.ts

@@ -1,4 +1,5 @@
 import { HTMLAttributes } from 'react';
+import { LabelsOf } from '../labels/labels';
 export interface CodeBlockProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "onCopy"> {
     code: string;
     /** The fence's language. Unknown ones render unhighlighted. */
@@ -11,6 +12,7 @@ export interface CodeBlockProps extends Omit<HTMLAttributes<HTMLDivElement>, "ch
     onCopy?: (code: string) => void;
     /** How long the button stays confirmed, in ms. */
     copiedFor?: number;
+    labels?: Partial<LabelsOf<"codeBlock">>;
 }
 /**
  * A fenced block: language, a copy button, and code that scrolls sideways
@@ -21,4 +23,4 @@ export interface CodeBlockProps extends Omit<HTMLAttributes<HTMLDivElement>, "ch
  * stops being preformatted, so this renders whole and the highlighter skips
  * it. Copy is what people want from code anyway.
  */
-export declare function CodeBlock({ code, lang, label, copyable, onCopy, copiedFor, className, ...rest }: CodeBlockProps): import("react").JSX.Element;
+export declare function CodeBlock({ code, lang, label, copyable, onCopy, copiedFor, labels, className, ...rest }: CodeBlockProps): import("react").JSX.Element;

package/dist/Context/Context.d.ts

@@ -1,12 +1,6 @@
 import { HTMLAttributes, ReactNode } from 'react';
-type Labels = {
-    name: string;
-    /** Between the two numbers: "128k of 1M". */
-    of: string;
-    tokens: string;
-    /** Said once it is past `warnAt`, and it should say what happens next. */
-    nearlyFull: string;
-};
+import { LabelsOf } from '../labels/labels';
+type Labels = LabelsOf<"context">;
 export interface ContextProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
     used: number;
     total: number;

package/dist/EmptyState/EmptyState.d.ts

@@ -21,4 +21,4 @@ export interface EmptyStateProps extends Omit<HTMLAttributes<HTMLDivElement>, "t
  * is not ours to do. `title` renders as text; wrap it yourself if it should be
  * a heading.
  */
-export declare function EmptyState({ icon, title, description, suggestions, onSuggestion, suggestionsLabel, children, className, ...rest }: EmptyStateProps): import("react").JSX.Element;
+export declare function EmptyState({ icon, title, description, suggestions, onSuggestion, suggestionsLabel: suggestionsProp, children, className, ...rest }: EmptyStateProps): import("react").JSX.Element;

package/dist/QuestionCard/QuestionCard.d.ts

@@ -1,4 +1,5 @@
 import { Answer, Question, QuestionState } from './types';
+import { LabelsOf } from '../labels/labels';
 export interface QuestionCardProps {
     question: Question;
     /** Shown in the badge. 1-based. */
@@ -10,7 +11,7 @@ export interface QuestionCardProps {
     onEdit?: () => void;
     /** Answers can be read but not changed. */
     readOnly?: boolean;
-    labels?: Partial<Record<"next" | "none" | "edit", string>>;
+    labels?: Partial<LabelsOf<"question">>;
 }
 /**
  * What an answer looks like once folded into a row.

package/dist/Reasoning/Reasoning.d.ts

@@ -1,7 +1,8 @@
 import { HTMLAttributes, ReactNode } from 'react';
+import { LabelsOf } from '../labels/labels';
 /** Still working it out, or finished. */
 export type ReasoningState = "thinking" | "done";
-type Labels = Record<"thinking" | "thought" | "thoughtFor", string>;
+type Labels = LabelsOf<"reasoning">;
 export interface ReasoningProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
     /** The thinking itself. Prose, not structure — see `Tool` for that. */
     children: ReactNode;

package/dist/Sources/Sources.d.ts

@@ -1,4 +1,5 @@
 import { HTMLAttributes, ReactNode } from 'react';
+import { LabelsOf } from '../labels/labels';
 /** Where a claim came from. */
 export interface Source {
     id: string;
@@ -10,11 +11,7 @@ export interface Source {
     /** The passage in the source that carries the claim. */
     quote?: string;
 }
-type Labels = {
-    title: string;
-    one: string;
-    many: string;
-};
+type Labels = LabelsOf<"sources">;
 export interface SourcesProps extends Omit<HTMLAttributes<HTMLElement>, "title" | "onSelect"> {
     sources: Source[];
     /** Heads the list. Defaults to `labels.title`. */

package/dist/TaskList/TaskList.d.ts

@@ -1,5 +1,6 @@
 import { HTMLAttributes, ReactNode } from 'react';
 import { WorkState } from '../stateGlyph/StateGlyph';
+import { LabelsOf } from '../labels/labels';
 /** The same four as a tool call. See `StateGlyph`. */
 export type TaskState = WorkState;
 export interface Task {
@@ -9,10 +10,7 @@ export interface Task {
     /** A line under the label — what it found, or why it failed. */
     detail?: ReactNode;
 }
-type Labels = Record<TaskState, string> & {
-    /** `{done}` and `{total}` are filled in. */
-    progress: string;
-};
+type Labels = LabelsOf<"tasks">;
 export interface TaskListProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
     tasks: Task[];
     /** Names the list, and gives it a row to fold into. */

package/dist/Tool/Tool.d.ts

@@ -1,8 +1,9 @@
 import { HTMLAttributes, ReactNode } from 'react';
 import { WorkState } from '../stateGlyph/StateGlyph';
+import { LabelsOf } from '../labels/labels';
 /** Queued, working, finished, or failed — the kit's four, shared with `TaskList`. */
 export type ToolState = WorkState;
-type Labels = Record<"input" | "output" | "error" | ToolState, string>;
+type Labels = LabelsOf<"tool">;
 export interface ToolProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "onToggle"> {
     /** What was called. Set in mono: it is an identifier, not prose. */
     name: string;

package/dist/demo.js

@@ -1,5 +1,5 @@
 "use client";
-import { Q as e, n as t, t as n } from "./ChatExperience-BwjmNCvw.js";
+import { et as e, n as t, t as n } from "./ChatExperience-Bawy_cnn.js";
 import { useCallback as r, useRef as i, useState as a } from "react";
 import { jsx as o, jsxs as s } from "react/jsx-runtime";
 import { AnimatePresence as c, motion as l } from "motion/react";

package/dist/index.d.ts

@@ -1,21 +1,23 @@
 export { ChatInput, defaultInlineAnimConfig } from './ChatInput/ChatInput';
 export type { ChatInputProps, ChatInputHandle, ChatInputState, InlineAnimConfig, } from './ChatInput/ChatInput';
 export { AddCardsOverlay } from './ChatInput/AddCardsOverlay';
-export type { AddCardsOverlayProps } from './ChatInput/AddCardsOverlay';
+export type { AddCardsOverlayProps, ComposerMenuItem } from './ChatInput/AddCardsOverlay';
 export { HoverActionsRow } from './ChatInput/HoverActionsRow';
 export type { HoverActionsRowProps } from './ChatInput/HoverActionsRow';
 export { MorphGlyph } from './ChatInput/MorphGlyph';
 export type { MorphGlyphProps } from './ChatInput/MorphGlyph';
 export { useChatTurns } from './useChatTurns/useChatTurns';
 export { mergeParts } from './turnParts/turnParts';
-export type { TurnPart, TurnPartUpdate } from './turnParts/turnParts';
+export type { CustomPart, CustomPartContext, TurnPart, TurnPartUpdate } from './turnParts/turnParts';
+export { LabelsProvider, defaultLabels } from './labels/labels';
+export type { ChatLabels, AnswerActionsLabels, ApprovalLabels, BranchLabels, ChainLabels, ChatInputLabels, ContextLabels, ReasoningLabels, SourcesLabels, TaskListLabels, ToolLabels, VoiceLabels, } from './labels/labels';
 export type { ChatAnnouncements, ChatTurn, SendContext, SendHandler, UseChatTurnsOptions, UseChatTurnsResult, } from './useChatTurns/useChatTurns';
 export { useVoiceInput } from './voice/useVoiceInput';
 export type { TranscribeContext, TranscribeHandler, UseVoiceInputOptions, VoiceInput, VoiceState, } from './voice/useVoiceInput';
 export { announce } from './announce/announce';
 export type { Politeness } from './announce/announce';
 export { ChatExperience } from './ChatExperience/ChatExperience';
-export type { ChatExperienceProps, ChatExperienceEmpty, ChatExperienceArtifact, PartWriter, } from './ChatExperience/ChatExperience';
+export type { ChatExperienceProps, ChatExperienceEmpty, ChatExperienceArtifact, ChatExperienceHeaderAction, PartWriter, } from './ChatExperience/ChatExperience';
 export { ChatHeader, headerIconSize } from './ChatHeader/ChatHeader';
 export type { ChatHeaderAction, ChatHeaderProps, ChatHeaderSize, ChatHeaderVariant, } from './ChatHeader/ChatHeader';
 export { ChatTurnRow } from './ChatTurnRow/ChatTurnRow';
@@ -35,7 +37,7 @@ export type { Source, SourcesProps } from './Sources/Sources';
 export { InlineCitation } from './InlineCitation/InlineCitation';
 export type { InlineCitationProps } from './InlineCitation/InlineCitation';
 export { Approval } from './Approval/Approval';
-export type { ApprovalProps, Decision } from './Approval/Approval';
+export type { ApprovalChoice, ApprovalProps, Decision } from './Approval/Approval';
 export { Context } from './Context/Context';
 export type { ContextProps } from './Context/Context';
 export { QuestionCard, answerChips } from './QuestionCard/QuestionCard';