@wallarm-org/design-system 3.2.0 → 3.3.0

package/dist/components/WallyAssistant/WallyAssistant.d.ts

@@ -0,0 +1,56 @@
+import { type FC, type ReactNode, type Ref } from 'react';
+import { type ChatProps } from '../Chat/index.js';
+import type { ChatContextItem, ChatMessage, ChatStatus, ChatSuggestionItem, ChatToolPermission } from './model/model.js';
+import type { ChatViewConfig } from './views/ChatViewContext.js';
+/** DOM attribute names WallyAssistant keeps for its own props (now or later); they never reach the root. */
+export type WallyAssistantReservedProps = 'children' | 'onSubmit' | 'onCopy' | 'title' | 'defaultValue' | 'onError';
+/** WallyAssistant's own props (everything that isn't a `Chat` root attribute). */
+export interface WallyAssistantOwnProps extends Omit<ChatViewConfig, 'status'> {
+    messages: readonly ChatMessage[];
+    /** Default 'ready'. */
+    status?: ChatStatus;
+    suggestions?: readonly ChatSuggestionItem[];
+    permissions?: readonly ChatToolPermission[];
+    context?: readonly ChatContextItem[];
+    value?: string;
+    onValueChange?: (value: string) => void;
+    /** Disables the textarea, Send and the suggestion pills (e.g. `!agent.isReady`). */
+    disabled?: boolean;
+    /** Focus management, e.g. focus the input after a thread switch. */
+    textareaRef?: Ref<HTMLTextAreaElement>;
+    /** Trimmed text. Not called when empty, while running, while an approval is pending, or when disabled. */
+    onSubmit: (text: string) => void;
+    /** Stop button, and Esc in the textarea while running (also inside a Drawer/Dialog: ChatInput
+     *  claims that Esc from the layer, so no host recipe is needed). */
+    onStop?: () => void;
+    /** Default: onSubmit(suggestion.prompt ?? suggestion.label). */
+    onSuggestionSelect?: (suggestion: ChatSuggestionItem) => void;
+    /** Absent, or no permissions → no permissions button in the input. */
+    onPermissionChange?: (permission: ChatToolPermission, allowed: boolean) => void;
+    /** Absent → context chips aren't removable. */
+    onContextRemove?: (item: ChatContextItem) => void;
+    header?: ReactNode;
+    /** ChatHeaderTitle children, e.g. a thread Select (Figma Variant2). */
+    headerTitle?: ReactNode;
+    /** New chat, history, close: your Buttons, so analytics land on them. */
+    headerActions?: ReactNode;
+    /** Replaces the greeting and its pills (e.g. a history-loading state). */
+    emptyState?: ReactNode;
+    /** Top of ChatFooter, above the suggestions (banners). */
+    footerStart?: ReactNode;
+    /** Extra toolbar items in the input, between permissions and Send. */
+    inputTools?: ReactNode;
+    /** Replaces the whole ChatInput composition (you wire value and submit yourself). */
+    input?: ReactNode;
+}
+export interface WallyAssistantProps extends Omit<ChatProps, WallyAssistantReservedProps>, WallyAssistantOwnProps {
+}
+/**
+ * The closed Wally panel (Figma 2:42): data and callbacks in, the whole chat out. Built only from
+ * exported pieces — `ChatViewProvider`, `deriveChatState`, `Chat*`, `Conversation*`,
+ * `ChatMessageView`, `ChatPartView`, `ChatInput*` — so a custom layout can reuse every rule.
+ * Send stays blocked while the last message has a pending approval; a resolved card stays docked
+ * until the next message. Code blocks highlight with a lazy Prism adapter unless an outer
+ * `CodeSnippetAdapterProvider` supplies one (that one wins).
+ */
+export declare const WallyAssistant: FC<WallyAssistantProps>;

package/dist/components/WallyAssistant/WallyAssistant.js

@@ -0,0 +1,541 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { c } from "react/compiler-runtime";
+import { useEffect, useRef, useState } from "react";
+import { Quote } from "../../icons/index.js";
+import { TestIdProvider, useTestId } from "../../utils/testId.js";
+import { Badge } from "../Badge/index.js";
+import { Chat, ChatFooter, ChatHeader, ChatHeaderActions, ChatHeaderTitle, ChatSuggestion, ChatSuggestions } from "../Chat/index.js";
+import { ChatInput, ChatInputSubmit, ChatInputTextarea } from "../ChatInput/index.js";
+import { ChatPermissions, ChatPermissionsContent, ChatPermissionsItem, ChatPermissionsTrigger } from "../ChatPermissions/index.js";
+import { loadPrismAdapter, plainAdapter, useAdapter } from "../CodeSnippet/index.js";
+import { AdapterContext } from "../CodeSnippet/CodeSnippetContext.js";
+import { Conversation, ConversationContent, ConversationEmptyState, ConversationScrollButton } from "../Conversation/index.js";
+import { Separator } from "../Separator/index.js";
+import { TagClose } from "../Tag/index.js";
+import { deriveChatState } from "./model/deriveChatState.js";
+import { DEFAULT_CHAT_LABELS } from "./model/labels.js";
+import { ChatMessageView } from "./views/ChatMessageView.js";
+import { ChatPartView } from "./views/ChatPartView.js";
+import { ChatViewProvider } from "./views/ChatViewProvider.js";
+import { resolveIcon } from "./views/stepIcons.js";
+const Pill = (t0)=>{
+    const $ = c(5);
+    const { index, item, disabled, onSelect } = t0;
+    const t1 = useTestId(`suggestion-${index}`);
+    let t2;
+    if ($[0] !== disabled || $[1] !== item.label || $[2] !== onSelect || $[3] !== t1) {
+        t2 = /*#__PURE__*/ jsx(ChatSuggestion, {
+            "data-testid": t1,
+            disabled: disabled,
+            onClick: onSelect,
+            children: item.label
+        });
+        $[0] = disabled;
+        $[1] = item.label;
+        $[2] = onSelect;
+        $[3] = t1;
+        $[4] = t2;
+    } else t2 = $[4];
+    return t2;
+};
+const ContextChip = (t0)=>{
+    const $ = c(14);
+    const { index, item, icons, label, onRemove } = t0;
+    const chipId = useTestId(`context-${index}`);
+    let t1;
+    if ($[0] === Symbol.for("react.memo_cache_sentinel")) {
+        t1 = /*#__PURE__*/ jsx(Quote, {});
+        $[0] = t1;
+    } else t1 = $[0];
+    let t2;
+    if ($[1] !== icons || $[2] !== item.icon) {
+        t2 = resolveIcon(item.icon, icons, t1);
+        $[1] = icons;
+        $[2] = item.icon;
+        $[3] = t2;
+    } else t2 = $[3];
+    let t3;
+    if ($[4] !== chipId || $[5] !== item || $[6] !== label || $[7] !== onRemove) {
+        t3 = false !== item.removable && onRemove && /*#__PURE__*/ jsx(TestIdProvider, {
+            value: chipId,
+            children: /*#__PURE__*/ jsx(TagClose, {
+                "aria-label": label,
+                className: "rounded-4 focus-visible:ring-3 focus-visible:ring-focus-primary",
+                onClick: ()=>onRemove(item)
+            })
+        });
+        $[4] = chipId;
+        $[5] = item;
+        $[6] = label;
+        $[7] = onRemove;
+        $[8] = t3;
+    } else t3 = $[8];
+    let t4;
+    if ($[9] !== chipId || $[10] !== item.label || $[11] !== t2 || $[12] !== t3) {
+        t4 = /*#__PURE__*/ jsxs(Badge, {
+            type: "secondary",
+            color: "blue",
+            "data-testid": chipId,
+            children: [
+                t2,
+                item.label,
+                t3
+            ]
+        });
+        $[9] = chipId;
+        $[10] = item.label;
+        $[11] = t2;
+        $[12] = t3;
+        $[13] = t4;
+    } else t4 = $[13];
+    return t4;
+};
+const PermissionItem = (t0)=>{
+    const $ = c(10);
+    const { index, item, onChange } = t0;
+    const t1 = useTestId(`item-${index}`);
+    let t2;
+    if ($[0] !== item || $[1] !== onChange) {
+        t2 = (t3)=>{
+            const { checked } = t3;
+            return onChange(item, checked);
+        };
+        $[0] = item;
+        $[1] = onChange;
+        $[2] = t2;
+    } else t2 = $[2];
+    let t3;
+    if ($[3] !== item.allowed || $[4] !== item.description || $[5] !== item.id || $[6] !== item.title || $[7] !== t1 || $[8] !== t2) {
+        t3 = /*#__PURE__*/ jsx(ChatPermissionsItem, {
+            "data-testid": t1,
+            name: item.id,
+            title: item.title,
+            description: item.description,
+            checked: item.allowed,
+            onCheckedChange: t2
+        });
+        $[3] = item.allowed;
+        $[4] = item.description;
+        $[5] = item.id;
+        $[6] = item.title;
+        $[7] = t1;
+        $[8] = t2;
+        $[9] = t3;
+    } else t3 = $[9];
+    return t3;
+};
+const PermissionsMenu = (t0)=>{
+    const $ = c(26);
+    const { items, labels, onChange } = t0;
+    let t1;
+    if ($[0] !== items || $[1] !== onChange) {
+        t1 = (p)=>/*#__PURE__*/ jsx(PermissionItem, {
+                index: items.indexOf(p),
+                item: p,
+                onChange: onChange
+            }, p.id);
+        $[0] = items;
+        $[1] = onChange;
+        $[2] = t1;
+    } else t1 = $[2];
+    const row = t1;
+    let T0;
+    let T1;
+    let t2;
+    let t3;
+    let t4;
+    let t5;
+    let t6;
+    if ($[3] !== items || $[4] !== labels.permissions || $[5] !== labels.permissionsHeading || $[6] !== row) {
+        const allowed = items.filter(_temp);
+        const others = items.filter(_temp2);
+        T1 = ChatPermissions;
+        if ($[14] !== labels.permissions) {
+            t6 = /*#__PURE__*/ jsx(ChatPermissionsTrigger, {
+                "aria-label": labels.permissions
+            });
+            $[14] = labels.permissions;
+            $[15] = t6;
+        } else t6 = $[15];
+        T0 = ChatPermissionsContent;
+        t2 = labels.permissionsHeading;
+        t3 = allowed.map(row);
+        t4 = allowed.length > 0 && others.length > 0 && /*#__PURE__*/ jsx(Separator, {
+            spacing: 4
+        });
+        t5 = others.map(row);
+        $[3] = items;
+        $[4] = labels.permissions;
+        $[5] = labels.permissionsHeading;
+        $[6] = row;
+        $[7] = T0;
+        $[8] = T1;
+        $[9] = t2;
+        $[10] = t3;
+        $[11] = t4;
+        $[12] = t5;
+        $[13] = t6;
+    } else {
+        T0 = $[7];
+        T1 = $[8];
+        t2 = $[9];
+        t3 = $[10];
+        t4 = $[11];
+        t5 = $[12];
+        t6 = $[13];
+    }
+    let t7;
+    if ($[16] !== T0 || $[17] !== t2 || $[18] !== t3 || $[19] !== t4 || $[20] !== t5) {
+        t7 = /*#__PURE__*/ jsxs(T0, {
+            label: t2,
+            children: [
+                t3,
+                t4,
+                t5
+            ]
+        });
+        $[16] = T0;
+        $[17] = t2;
+        $[18] = t3;
+        $[19] = t4;
+        $[20] = t5;
+        $[21] = t7;
+    } else t7 = $[21];
+    let t8;
+    if ($[22] !== T1 || $[23] !== t6 || $[24] !== t7) {
+        t8 = /*#__PURE__*/ jsxs(T1, {
+            children: [
+                t6,
+                t7
+            ]
+        });
+        $[22] = T1;
+        $[23] = t6;
+        $[24] = t7;
+        $[25] = t8;
+    } else t8 = $[25];
+    return t8;
+};
+let prism;
+const LAZY_PRISM = {
+    adapter: {
+        name: "prism",
+        highlight: async (code, language)=>{
+            if ("text" === language) return plainAdapter.highlight(code, language);
+            prism ??= await loadPrismAdapter();
+            return prism.highlight(code, language);
+        },
+        getSupportedLanguages: ()=>prism?.getSupportedLanguages() ?? []
+    }
+};
+const WallyAssistant = (t0)=>{
+    const $ = c(50);
+    let background;
+    let context;
+    let disabled;
+    let emptyState;
+    let footerStart;
+    let formatTimestamp;
+    let header;
+    let headerActions;
+    let headerTitle;
+    let icons;
+    let input;
+    let inputTools;
+    let labelsProp;
+    let markdown;
+    let messages;
+    let onApprovalRespond;
+    let onContextRemove;
+    let onCopy;
+    let onFeedback;
+    let onPermissionChange;
+    let onRetry;
+    let onStop;
+    let onSubmit;
+    let onSuggestionSelect;
+    let onValueChange;
+    let permissions;
+    let renderMessageActions;
+    let renderPart;
+    let renderStepContent;
+    let rest;
+    let suggestions;
+    let t1;
+    let t2;
+    let textareaRef;
+    let value;
+    if ($[0] !== t0) {
+        ({ messages, status: t1, suggestions, permissions, context, value, onValueChange, disabled, textareaRef, onSubmit, onStop, onSuggestionSelect, onPermissionChange, onContextRemove, header, headerTitle, headerActions, emptyState, footerStart, inputTools, input, labels: labelsProp, icons, markdown, formatTimestamp, approvalPlacement: t2, renderPart, renderStepContent, renderMessageActions, onApprovalRespond, onFeedback, onCopy, onRetry, background, ...rest } = t0);
+        $[0] = t0;
+        $[1] = background;
+        $[2] = context;
+        $[3] = disabled;
+        $[4] = emptyState;
+        $[5] = footerStart;
+        $[6] = formatTimestamp;
+        $[7] = header;
+        $[8] = headerActions;
+        $[9] = headerTitle;
+        $[10] = icons;
+        $[11] = input;
+        $[12] = inputTools;
+        $[13] = labelsProp;
+        $[14] = markdown;
+        $[15] = messages;
+        $[16] = onApprovalRespond;
+        $[17] = onContextRemove;
+        $[18] = onCopy;
+        $[19] = onFeedback;
+        $[20] = onPermissionChange;
+        $[21] = onRetry;
+        $[22] = onStop;
+        $[23] = onSubmit;
+        $[24] = onSuggestionSelect;
+        $[25] = onValueChange;
+        $[26] = permissions;
+        $[27] = renderMessageActions;
+        $[28] = renderPart;
+        $[29] = renderStepContent;
+        $[30] = rest;
+        $[31] = suggestions;
+        $[32] = t1;
+        $[33] = t2;
+        $[34] = textareaRef;
+        $[35] = value;
+    } else {
+        background = $[1];
+        context = $[2];
+        disabled = $[3];
+        emptyState = $[4];
+        footerStart = $[5];
+        formatTimestamp = $[6];
+        header = $[7];
+        headerActions = $[8];
+        headerTitle = $[9];
+        icons = $[10];
+        input = $[11];
+        inputTools = $[12];
+        labelsProp = $[13];
+        markdown = $[14];
+        messages = $[15];
+        onApprovalRespond = $[16];
+        onContextRemove = $[17];
+        onCopy = $[18];
+        onFeedback = $[19];
+        onPermissionChange = $[20];
+        onRetry = $[21];
+        onStop = $[22];
+        onSubmit = $[23];
+        onSuggestionSelect = $[24];
+        onValueChange = $[25];
+        permissions = $[26];
+        renderMessageActions = $[27];
+        renderPart = $[28];
+        renderStepContent = $[29];
+        rest = $[30];
+        suggestions = $[31];
+        t1 = $[32];
+        t2 = $[33];
+        textareaRef = $[34];
+        value = $[35];
+    }
+    const status = void 0 === t1 ? "ready" : t1;
+    const approvalPlacement = void 0 === t2 ? "docked" : t2;
+    const [innerDraft, setInnerDraft] = useState("");
+    const labels = {
+        ...DEFAULT_CHAT_LABELS,
+        ...labelsProp
+    };
+    const state = deriveChatState(messages, status, approvalPlacement);
+    const lastRow = state.rows[state.rows.length - 1];
+    const draft = value ?? innerDraft;
+    const footerRef = useRef(null);
+    const outerAdapter = useAdapter();
+    const dockFocus = useRef(false);
+    let t3;
+    if ($[36] === Symbol.for("react.memo_cache_sentinel")) {
+        t3 = ()=>{
+            if (!dockFocus.current) return;
+            const active = document.activeElement;
+            if (active && active !== document.body) return;
+            dockFocus.current = false;
+            footerRef.current?.querySelector('[data-slot="approval-card"] button:not(:disabled)')?.focus({
+                preventScroll: true
+            });
+        };
+        $[36] = t3;
+    } else t3 = $[36];
+    useEffect(t3);
+    let t4;
+    if ($[37] !== onValueChange || $[38] !== value) {
+        t4 = (next)=>{
+            if (void 0 === value) setInnerDraft(next);
+            onValueChange?.(next);
+        };
+        $[37] = onValueChange;
+        $[38] = value;
+        $[39] = t4;
+    } else t4 = $[39];
+    const setDraft = t4;
+    const submit = (text)=>{
+        const trimmed = text.trim();
+        if (!trimmed || disabled || state.running || state.awaitingApproval) return;
+        onSubmit(trimmed);
+        if (void 0 === value) setInnerDraft("");
+    };
+    const pills = (placement)=>suggestions?.length ? /*#__PURE__*/ jsx(ChatSuggestions, {
+            placement: placement,
+            label: labels.suggestions,
+            children: suggestions.map((s, i)=>/*#__PURE__*/ jsx(Pill, {
+                    index: i,
+                    item: s,
+                    disabled: disabled,
+                    onSelect: ()=>onSuggestionSelect ? onSuggestionSelect(s) : submit(s.prompt ?? s.label)
+                }, s.id))
+        }) : null;
+    const T0 = ChatFooter;
+    let t5;
+    let t6;
+    if ($[40] === Symbol.for("react.memo_cache_sentinel")) {
+        t5 = (e)=>{
+            dockFocus.current = e.target instanceof Element && !!e.target.closest('[data-slot="approval-card"]');
+        };
+        t6 = (e_0)=>{
+            if (!e_0.currentTarget.contains(e_0.relatedTarget)) dockFocus.current = false;
+        };
+        $[40] = t5;
+        $[41] = t6;
+    } else {
+        t5 = $[40];
+        t6 = $[41];
+    }
+    const t7 = !state.empty && !state.running && !state.awaitingApproval && pills("footer");
+    const t8 = lastRow && state.dockedApprovals.map((a)=>/*#__PURE__*/ jsx(ChatPartView, {
+            part: a,
+            message: lastRow,
+            isLast: true,
+            placement: "docked"
+        }, a.id));
+    const t9 = void 0 !== input ? input : /*#__PURE__*/ jsxs(ChatInput, {
+        value: draft,
+        onValueChange: setDraft,
+        onSubmit: submit,
+        onStop: onStop,
+        isRunning: state.running,
+        disabled: disabled,
+        disclaimer: labels.disclaimer,
+        context: context?.length ? context.map((item, i_1)=>/*#__PURE__*/ jsx(ContextChip, {
+                index: i_1,
+                item: item,
+                icons: icons,
+                label: labels.removeContext(item.label),
+                onRemove: onContextRemove
+            }, item.id)) : void 0,
+        children: [
+            /*#__PURE__*/ jsx(ChatInputTextarea, {
+                ref: textareaRef,
+                placeholder: labels.placeholder,
+                "aria-label": labels.input
+            }),
+            permissions?.length && onPermissionChange ? /*#__PURE__*/ jsx(PermissionsMenu, {
+                items: permissions,
+                labels: labels,
+                onChange: onPermissionChange
+            }) : null,
+            inputTools,
+            /*#__PURE__*/ jsx(ChatInputSubmit, {
+                sendLabel: labels.send,
+                stopLabel: labels.stop,
+                disabled: state.awaitingApproval && !state.running
+            })
+        ]
+    });
+    let t10;
+    if ($[42] !== T0 || $[43] !== footerStart || $[44] !== t5 || $[45] !== t6 || $[46] !== t7 || $[47] !== t8 || $[48] !== t9) {
+        t10 = /*#__PURE__*/ jsxs(T0, {
+            ref: footerRef,
+            onFocus: t5,
+            onBlur: t6,
+            children: [
+                footerStart,
+                t7,
+                t8,
+                t9
+            ]
+        });
+        $[42] = T0;
+        $[43] = footerStart;
+        $[44] = t5;
+        $[45] = t6;
+        $[46] = t7;
+        $[47] = t8;
+        $[48] = t9;
+        $[49] = t10;
+    } else t10 = $[49];
+    return /*#__PURE__*/ jsx(ChatViewProvider, {
+        status: status,
+        labels: labelsProp,
+        icons: icons,
+        markdown: markdown,
+        formatTimestamp: formatTimestamp,
+        approvalPlacement: approvalPlacement,
+        renderPart: renderPart,
+        renderStepContent: renderStepContent,
+        renderMessageActions: renderMessageActions,
+        onApprovalRespond: onApprovalRespond,
+        onFeedback: onFeedback,
+        onCopy: onCopy,
+        onRetry: onRetry,
+        children: /*#__PURE__*/ jsx(AdapterContext, {
+            value: outerAdapter ?? LAZY_PRISM,
+            children: /*#__PURE__*/ jsxs(Chat, {
+                "aria-label": labels.region,
+                ...rest,
+                background: background ?? (state.empty ? "strong" : "subtle"),
+                children: [
+                    void 0 !== header ? header : /*#__PURE__*/ jsxs(ChatHeader, {
+                        children: [
+                            /*#__PURE__*/ jsx(ChatHeaderTitle, {
+                                label: labels.title,
+                                children: headerTitle
+                            }),
+                            null != headerActions && /*#__PURE__*/ jsx(ChatHeaderActions, {
+                                children: headerActions
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ jsxs(Conversation, {
+                        autoScrollKey: state.lastUserMessageId,
+                        children: [
+                            /*#__PURE__*/ jsx(ConversationContent, {
+                                "aria-label": labels.log,
+                                "aria-busy": state.busy,
+                                children: state.empty ? void 0 !== emptyState ? emptyState : /*#__PURE__*/ jsx(ConversationEmptyState, {
+                                    title: labels.greeting,
+                                    children: pills("greeting")
+                                }) : state.rows.map((m, i_0)=>/*#__PURE__*/ jsx(ChatMessageView, {
+                                        message: m,
+                                        index: i_0,
+                                        isLast: i_0 === state.rows.length - 1
+                                    }, m.id))
+                            }),
+                            /*#__PURE__*/ jsx(ConversationScrollButton, {
+                                label: labels.scrollToBottom
+                            })
+                        ]
+                    }),
+                    t10
+                ]
+            })
+        })
+    });
+};
+WallyAssistant.displayName = "WallyAssistant";
+function _temp(p_0) {
+    return p_0.allowed;
+}
+function _temp2(p_1) {
+    return !p_1.allowed;
+}
+export { WallyAssistant };

package/dist/components/WallyAssistant/index.d.ts

@@ -0,0 +1,10 @@
+export { type ChatViewState, copyTextOf, deriveChatState } from './model/deriveChatState.js';
+export { type ChatLabels, DEFAULT_CHAT_LABELS } from './model/labels.js';
+export type { ChatApprovalOption, ChatApprovalOptionKind, ChatApprovalPart, ChatApprovalResponse, ChatApprovalStatus, ChatAssistantMessage, ChatAssistantPart, ChatChainOfThoughtPart, ChatContextItem, ChatCustomPart, ChatErrorPart, ChatFeedback, ChatIconKey, ChatId, ChatMessage, ChatMeta, ChatOpen, ChatPart, ChatSnapshot, ChatStatus, ChatStep, ChatStepKind, ChatStepStatus, ChatSuggestionItem, ChatTextPart, ChatToolPermission, ChatUserMessage, ChatUserPart, } from './model/model.js';
+export { ApprovalCardView, type ApprovalCardViewProps } from './views/ApprovalCardView.js';
+export { ChainOfThoughtView, type ChainOfThoughtViewProps } from './views/ChainOfThoughtView.js';
+export { ChatMessageView, type ChatMessageViewProps } from './views/ChatMessageView.js';
+export { ChatPartView, type ChatPartViewProps } from './views/ChatPartView.js';
+export type { ChatMarkdownProps, ChatMessageActionNodes, ChatPartRenderContext, ChatStepRenderContext, ChatViewConfig, } from './views/ChatViewContext.js';
+export { ChatViewProvider, type ChatViewProviderProps } from './views/ChatViewProvider.js';
+export { WallyAssistant, type WallyAssistantProps } from './WallyAssistant.js';

package/dist/components/WallyAssistant/index.js

@@ -0,0 +1,8 @@
+export { copyTextOf, deriveChatState } from "./model/deriveChatState.js";
+export { DEFAULT_CHAT_LABELS } from "./model/labels.js";
+export { ApprovalCardView } from "./views/ApprovalCardView.js";
+export { ChainOfThoughtView } from "./views/ChainOfThoughtView.js";
+export { ChatMessageView } from "./views/ChatMessageView.js";
+export { ChatPartView } from "./views/ChatPartView.js";
+export { ChatViewProvider } from "./views/ChatViewProvider.js";
+export { WallyAssistant } from "./WallyAssistant.js";

package/dist/components/WallyAssistant/model/deriveChatState.d.ts

@@ -0,0 +1,33 @@
+import type { ChatApprovalPart, ChatId, ChatMessage, ChatStatus, ChatStep, ChatStepStatus } from './model.js';
+export interface ChatViewState {
+    /** `messages`, plus an empty reply `{ role: 'assistant', id: `${lastUserMessageId}:reply`, parts: [] }` while
+     *  running and the last message is the user's (the loading row; the same id as the recommended mapper reply). */
+    rows: readonly ChatMessage[];
+    /** `messages.length === 0`. */
+    empty: boolean;
+    /** `status` is 'submitted' or 'streaming'. */
+    running: boolean;
+    /** The last row has a pending approval part. */
+    awaitingApproval: boolean;
+    /** `running && !awaitingApproval` → `aria-busy`. */
+    busy: boolean;
+    /** → Conversation `autoScrollKey`. */
+    lastUserMessageId?: ChatId;
+    /** Placement 'docked' only (§7.5). Render each with
+     *  `<ChatPartView part message={rows.at(-1)} isLast placement='docked' />`. */
+    dockedApprovals: readonly ChatApprovalPart[];
+}
+/** 'submitted' | 'streaming'. Unknown statuses behave like 'ready'. */
+export declare const isRunningStatus: (status: ChatStatus | undefined) => boolean;
+/** The step's own status is pending, running or awaiting-approval. */
+export declare const isLiveStepStatus: (status: ChatStepStatus) => boolean;
+/** The step or any nested step is live (§7.3). */
+export declare const isLiveStep: (step: ChatStep) => boolean;
+export declare const hasPendingApproval: (message: ChatMessage | undefined) => boolean;
+/** The last row's pending approvals; when none is pending, its last approval (decision 11). */
+export declare const getDockedApprovals: (lastRow: ChatMessage | undefined) => readonly ChatApprovalPart[];
+/** What Copy copies: `copyText`, or the non-empty text parts joined by a blank line. */
+export declare const copyTextOf: (message: ChatMessage) => string;
+/** Every derived rule of the chat, in one pure function shared by WallyAssistant and custom layouts (§7.1).
+ *  `approvalPlacement` must match the `ChatViewProvider`'s, or a docked approval renders twice or never. */
+export declare function deriveChatState(messages: readonly ChatMessage[], status?: ChatStatus, approvalPlacement?: 'docked' | 'inline'): ChatViewState;