entasis 0.10.2 → 0.12.0

package/dist/components/AIAskUserQuestion/aiAskUserQuestion.theme.js

@@ -1,30 +1,38 @@
 import { cva, setComponentTheme, useComponentTheme } from '../../utils/cva/index.js';
-import { selectedSolid } from '../Theme/theme.recipes.js';
+// Like the composer it can stand in for, the card caps itself at `--ai-chat-content-width` when a
+// host sets it (AIChat docks it in place of the composer) and centres; elsewhere it spans its
+// container.
 const defaultRoot = cva({
-    base: 'raised grid min-w-0 gap-lg rounded-lg bg-surface-raised text-sm text-neutral'
+    base: 'raised mx-auto grid w-full min-w-0 max-w-[var(--ai-chat-content-width,none)] gap-lg rounded-lg bg-surface-raised text-sm text-neutral'
 });
 const defaultHeader = cva({ base: 'grid min-w-0 px-lg pt-lg' });
 const defaultHeaderTop = cva({ base: 'flex min-w-0 items-start justify-between gap-lg' });
 const defaultHeaderText = cva({ base: 'grid min-w-0 gap-xs' });
 const defaultRequester = cva({
-    base: 'sr-only'
+    base: 'truncate text-xs text-neutral/70'
 });
 const defaultProgressGroup = cva({
     base: 'flex shrink-0 items-center'
 });
-const defaultSteps = cva({ base: 'flex shrink-0 items-center gap-sm' });
+// The negative margins let the 24px hit areas overhang, so the dots line up with the header edge
+// and the row stays as tall as the progress text.
+const defaultSteps = cva({ base: '-my-xs -me-md flex shrink-0 items-center' });
+// A 24px pointer target (WCAG 2.5.8) drawing an 8px dot: the step dots are the way back to an
+// earlier question.
 const defaultStep = cva({
-    base: 'state-layer size-2 rounded-full bg-neutral/20 text-neutral transition-colors disabled:pointer-events-none disabled:opacity-50',
-    variants: { active: { true: selectedSolid, false: '' } }
+    base: "state-layer grid size-6 place-items-center rounded-full text-neutral transition-colors after:size-2 after:rounded-full after:bg-neutral/20 after:transition-colors after:content-[''] disabled:pointer-events-none disabled:opacity-50",
+    variants: { active: { true: 'after:bg-selected', false: '' } }
 });
 const defaultBody = cva({
     base: 'grid min-w-0 gap-lg'
 });
-const defaultStepContent = cva({ base: 'grid w-full min-w-0 gap-lg px-lg pb-xs' });
+const defaultStepContent = cva({ base: 'grid w-full min-w-0 gap-lg px-lg pb-xs outline-none' });
 const defaultQuestion = cva({ base: 'grid min-w-0 gap-xs' });
 const defaultQuestionTitle = cva({
     base: 'break-words text-sm font-medium leading-snug text-neutral [overflow-wrap:anywhere]'
 });
+const defaultRequiredMarker = cva({ base: 'ms-xs text-danger-readable' });
+const defaultOther = cva({ base: 'min-w-0' });
 const defaultQuestionDescription = cva({
     base: 'break-words text-xs leading-relaxed text-neutral/70 [overflow-wrap:anywhere]'
 });
@@ -32,15 +40,39 @@ const defaultTextArea = cva({ base: 'min-h-24 resize-none text-sm' });
 const defaultOptions = cva({ base: 'grid w-full min-w-0 gap-md' });
 const defaultFile = cva({ base: 'min-w-0' });
 const defaultEmpty = cva({ base: 'm-lg min-w-0' });
-const defaultError = cva({ base: 'mx-lg min-w-0 text-sm' });
-const defaultFooter = cva({ base: 'flex min-w-0 items-center justify-between gap-md px-lg pb-lg' });
+// One danger message under the question; the step already carries the horizontal padding.
+const defaultError = cva({ base: 'min-w-0 text-sm text-danger-readable' });
+const defaultAlert = cva({ base: 'mx-lg min-w-0' });
+const defaultFooter = cva({ base: 'flex min-w-0 items-center justify-end gap-md px-lg pb-lg' });
 const defaultProgress = cva({ base: 'sr-only' });
 const defaultTitle = cva({
-    base: 'break-words text-xs font-medium leading-snug text-neutral/70 [overflow-wrap:anywhere]'
+    base: 'break-words text-sm font-semibold leading-snug text-neutral [overflow-wrap:anywhere]'
 });
 const defaultDescription = cva({
     base: 'break-words text-xs leading-relaxed text-neutral/70 [overflow-wrap:anywhere]'
 });
+// The answered record a transcript keeps once the request is complete: question → chosen labels.
+const defaultSummary = cva({
+    base: 'group/ai-ask-summary-size grid min-w-0 gap-sm text-sm data-[size=small]:text-xs data-[size=large]:text-base text-neutral'
+});
+const defaultSummaryTitle = cva({
+    base: 'text-xs group-data-[size=large]/ai-ask-summary-size:text-sm font-medium text-neutral/70'
+});
+const defaultSummaryList = cva({ base: 'grid min-w-0 gap-sm' });
+const defaultSummaryItem = cva({ base: 'grid min-w-0 gap-micro' });
+const defaultSummaryQuestion = cva({
+    base: 'break-words text-neutral/70 [overflow-wrap:anywhere]'
+});
+const defaultSummaryAnswer = cva({
+    base: 'break-words font-medium text-neutral [overflow-wrap:anywhere]',
+    variants: {
+        answered: {
+            true: '',
+            false: 'font-normal text-neutral/70 italic'
+        }
+    },
+    defaultVariants: { answered: true }
+});
 export const aiAskUserQuestionTheme = {
     root: defaultRoot,
     header: defaultHeader,
@@ -63,7 +95,16 @@ export const aiAskUserQuestionTheme = {
     footer: defaultFooter,
     progress: defaultProgress,
     title: defaultTitle,
-    description: defaultDescription
+    description: defaultDescription,
+    requiredMarker: defaultRequiredMarker,
+    other: defaultOther,
+    alert: defaultAlert,
+    summary: defaultSummary,
+    summaryTitle: defaultSummaryTitle,
+    summaryList: defaultSummaryList,
+    summaryItem: defaultSummaryItem,
+    summaryQuestion: defaultSummaryQuestion,
+    summaryAnswer: defaultSummaryAnswer
 };
 export const setAIAskUserQuestionTheme = setComponentTheme('ai-ask-user-question');
-export const useAIAskUserQuestionTheme = useComponentTheme('aiAskUserQuestion', aiAskUserQuestionTheme);
+export const useAIAskUserQuestionTheme = useComponentTheme('ai-ask-user-question', aiAskUserQuestionTheme);

package/dist/components/AIAskUserQuestion/aiAskUserQuestionAnswers.d.ts

@@ -1,10 +1,26 @@
-import type { AIAskAnswer, AIAskAnswers, AIAskQuestion, AIAskUserQuestionAnswer, AIAskUserQuestionType } from './aiAskUserQuestion.props.js';
+import type { AIAskAnswer, AIAskAnswers, AIAskQuestion, AIAskUserQuestionAnswer, AIAskUserQuestionType, AIAskUserQuestionSummaryItem } from './aiAskUserQuestion.props.js';
+/** Internal option value of the "Other…" choice. Never part of an answer. */
+export declare const AI_ASK_OTHER_VALUE = "__entasis-ask-other__";
 export declare function getAIAskQuestionType(question: AIAskQuestion): AIAskUserQuestionType;
+/** Questions are optional unless they set `required: true`. */
 export declare function isAIAskQuestionRequired(question: AIAskQuestion): boolean;
 export declare function getAIAskStringAnswer(answer: AIAskAnswer | undefined): string;
 export declare function getAIAskStringArrayAnswer(answer: AIAskAnswer | undefined): string[];
 export declare function getAIAskFileAnswer(answer: AIAskAnswer | undefined): File[];
 export declare function hasSameAIAskAnswer(question: AIAskQuestion, currentAnswer: AIAskAnswer | undefined, nextAnswer: AIAskAnswer): boolean;
+/** Whether the question already holds an answer, required or not. */
+export declare function hasAIAskAnswer(question: AIAskQuestion, values: AIAskAnswers): boolean;
+/** Whether the question lets the flow continue: answered, or optional. */
 export declare function isAIAskQuestionAnswered(question: AIAskQuestion, values: AIAskAnswers): boolean;
+/** The free-text "Other…" answer of a choice question: an answer that is no option id. */
+export declare function getAIAskCustomAnswer(question: AIAskQuestion, answer: AIAskAnswer | undefined): string | undefined;
+/** The option ids of a multiple-choice answer, without its free-text entry. */
+export declare function getAIAskOptionAnswers(question: AIAskQuestion, answer: AIAskAnswer | undefined): string[];
+/**
+ * A compact, display-ready record of a completed request: each question with the labels the user
+ * chose. Option ids become their labels, free-text "Other…" answers and text answers are shown as
+ * typed (trimmed), files by name. Unanswered questions have no labels and `answered: false`.
+ */
+export declare function summarizeAIAskAnswers(questions: readonly AIAskQuestion[], values: AIAskAnswers): AIAskUserQuestionSummaryItem[];
 export declare function getFirstMissingAIAskQuestionIndex(questions: readonly AIAskQuestion[], values: AIAskAnswers): number;
 export declare function toAIAskAnswerList(questions: readonly AIAskQuestion[], values: AIAskAnswers): AIAskUserQuestionAnswer[];

package/dist/components/AIAskUserQuestion/aiAskUserQuestionAnswers.js

@@ -1,8 +1,11 @@
+/** Internal option value of the "Other…" choice. Never part of an answer. */
+export const AI_ASK_OTHER_VALUE = '__entasis-ask-other__';
 export function getAIAskQuestionType(question) {
     return question.type ?? 'text';
 }
+/** Questions are optional unless they set `required: true`. */
 export function isAIAskQuestionRequired(question) {
-    return question.required ?? true;
+    return question.required ?? false;
 }
 export function getAIAskStringAnswer(answer) {
     return typeof answer === 'string' ? answer : '';
@@ -27,18 +30,63 @@ export function hasSameAIAskAnswer(question, currentAnswer, nextAnswer) {
     return (currentValues.length === nextValues.length &&
         currentValues.every((value, index) => value === nextValues[index]));
 }
-export function isAIAskQuestionAnswered(question, values) {
-    if (!isAIAskQuestionRequired(question))
-        return true;
+/** Whether the question already holds an answer, required or not. */
+export function hasAIAskAnswer(question, values) {
     const answer = values[question.id];
     const type = getAIAskQuestionType(question);
-    if (type === 'text')
+    if (type === 'text' || type === 'single')
         return getAIAskStringAnswer(answer).trim().length > 0;
-    if (type === 'single')
-        return getAIAskStringAnswer(answer).length > 0;
     if (type === 'file')
         return getAIAskFileAnswer(answer).length > 0;
-    return getAIAskStringArrayAnswer(answer).length > 0;
+    return getAIAskStringArrayAnswer(answer).some((entry) => entry.trim().length > 0);
+}
+/** Whether the question lets the flow continue: answered, or optional. */
+export function isAIAskQuestionAnswered(question, values) {
+    return !isAIAskQuestionRequired(question) || hasAIAskAnswer(question, values);
+}
+/** The free-text "Other…" answer of a choice question: an answer that is no option id. */
+export function getAIAskCustomAnswer(question, answer) {
+    if (question.type !== 'single' && question.type !== 'multiple')
+        return undefined;
+    const ids = new Set(question.options.map((option) => option.id));
+    if (question.type === 'single') {
+        const text = getAIAskStringAnswer(answer);
+        return text && !ids.has(text) ? text : undefined;
+    }
+    return getAIAskStringArrayAnswer(answer).find((entry) => !ids.has(entry));
+}
+/** The option ids of a multiple-choice answer, without its free-text entry. */
+export function getAIAskOptionAnswers(question, answer) {
+    if (question.type !== 'multiple')
+        return [];
+    const ids = new Set(question.options.map((option) => option.id));
+    return getAIAskStringArrayAnswer(answer).filter((entry) => ids.has(entry));
+}
+/**
+ * A compact, display-ready record of a completed request: each question with the labels the user
+ * chose. Option ids become their labels, free-text "Other…" answers and text answers are shown as
+ * typed (trimmed), files by name. Unanswered questions have no labels and `answered: false`.
+ */
+export function summarizeAIAskAnswers(questions, values) {
+    return questions.map((question) => {
+        const answer = values[question.id];
+        const labels = answerLabels(question, answer)
+            .map((label) => label.trim())
+            .filter(Boolean);
+        return { question, questionId: question.id, labels, answered: labels.length > 0 };
+    });
+}
+function answerLabels(question, answer) {
+    if (question.type === 'file')
+        return getAIAskFileAnswer(answer).map((file) => file.name);
+    if (question.type === 'single' || question.type === 'multiple') {
+        const labels = new Map(question.options.map((option) => [option.id, option.label]));
+        const entries = question.type === 'single'
+            ? [getAIAskStringAnswer(answer)]
+            : getAIAskStringArrayAnswer(answer);
+        return entries.map((entry) => labels.get(entry) ?? entry);
+    }
+    return [getAIAskStringAnswer(answer)];
 }
 export function getFirstMissingAIAskQuestionIndex(questions, values) {
     return questions.findIndex((question) => !isAIAskQuestionAnswered(question, values));

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

@@ -1,5 +1,7 @@
 export { default as AIAskUserQuestion } from './AIAskUserQuestion.svelte';
-export type { AIAskAnswer, AIAskAnswers, AIAskQuestion, AIAskUserQuestionAnswer, AIAskUserQuestionChoiceQuestion, AIAskUserQuestionFileQuestion, AIAskUserQuestionOption, AIAskUserQuestionProps, AIAskUserQuestionQuestion, AIAskUserQuestionQuestionState, AIAskUserQuestionState, AIAskUserQuestionSubmitPayload, AIAskUserQuestionTextQuestion, AIAskUserQuestionType, AIAskUserQuestionValue, AIAskUserQuestionValues, AIFileQuestion, AIMultipleQuestion, AIQuestionOption, AISingleQuestion, AITextQuestion } from './aiAskUserQuestion.props.js';
+export { default as AIAskUserQuestionSummary } from './AIAskUserQuestionSummary.svelte';
+export { summarizeAIAskAnswers } from './aiAskUserQuestionAnswers.js';
+export type { AIAskAnswer, AIAskAnswers, AIAskQuestion, AIAskUserQuestionAnswer, AIAskUserQuestionChoiceQuestion, AIAskUserQuestionFileQuestion, AIAskUserQuestionOption, AIAskUserQuestionProps, AIAskUserQuestionQuestion, AIAskUserQuestionQuestionState, AIAskUserQuestionState, AIAskUserQuestionSubmitPayload, AIAskUserQuestionSummaryItem, AIAskUserQuestionSummaryProps, AIAskUserQuestionTextQuestion, AIAskUserQuestionType, AIAskUserQuestionValue, AIAskUserQuestionValues, AIFileQuestion, AIMultipleQuestion, AIQuestionOption, AISingleQuestion, AITextQuestion } from './aiAskUserQuestion.props.js';
 export { aiAskAnswerSchema, aiAskAnswersSchema, aiAskQuestionSchema, aiAskQuestionsSchema, aiAskUserQuestionChoiceQuestionSchema, aiAskUserQuestionFileQuestionSchema, aiAskUserQuestionOptionSchema, aiAskUserQuestionQuestionSchema, aiAskUserQuestionTextQuestionSchema, aiAskUserQuestionToolInputSchema, aiAskUserQuestionToolPayloadSchema, aiAskUserQuestionToolStateSchema, aiAskUserQuestionValueMapSchema, aiFileQuestionSchema, aiMultipleQuestionSchema, aiQuestionOptionSchema, aiSingleQuestionSchema, aiTextQuestionSchema } from './schemas.js';
 export type { AIAskUserQuestionToolPayload } from './schemas.js';
 export { aiAskUserQuestionTheme, setAIAskUserQuestionTheme, useAIAskUserQuestionTheme, type AIAskUserQuestionTheme, type AIAskUserQuestionThemeProps } from './aiAskUserQuestion.theme.js';

package/dist/components/AIAskUserQuestion/index.js

@@ -1,3 +1,5 @@
 export { default as AIAskUserQuestion } from './AIAskUserQuestion.svelte';
+export { default as AIAskUserQuestionSummary } from './AIAskUserQuestionSummary.svelte';
+export { summarizeAIAskAnswers } from './aiAskUserQuestionAnswers.js';
 export { aiAskAnswerSchema, aiAskAnswersSchema, aiAskQuestionSchema, aiAskQuestionsSchema, aiAskUserQuestionChoiceQuestionSchema, aiAskUserQuestionFileQuestionSchema, aiAskUserQuestionOptionSchema, aiAskUserQuestionQuestionSchema, aiAskUserQuestionTextQuestionSchema, aiAskUserQuestionToolInputSchema, aiAskUserQuestionToolPayloadSchema, aiAskUserQuestionToolStateSchema, aiAskUserQuestionValueMapSchema, aiFileQuestionSchema, aiMultipleQuestionSchema, aiQuestionOptionSchema, aiSingleQuestionSchema, aiTextQuestionSchema } from './schemas.js';
 export { aiAskUserQuestionTheme, setAIAskUserQuestionTheme, useAIAskUserQuestionTheme } from './aiAskUserQuestion.theme.js';

package/dist/components/AIAskUserQuestion/schemas.d.ts

@@ -23,6 +23,9 @@ export declare const aiSingleQuestionSchema: v.LooseObjectSchema<{
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly disabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     }, undefined>, undefined>;
+    readonly showOther: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly otherLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly otherPlaceholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -36,6 +39,9 @@ export declare const aiMultipleQuestionSchema: v.LooseObjectSchema<{
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly disabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     }, undefined>, undefined>;
+    readonly showOther: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly otherLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly otherPlaceholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -68,6 +74,9 @@ export declare const aiAskQuestionSchema: v.UnionSchema<[v.LooseObjectSchema<{
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly disabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     }, undefined>, undefined>;
+    readonly showOther: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly otherLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly otherPlaceholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -80,6 +89,9 @@ export declare const aiAskQuestionSchema: v.UnionSchema<[v.LooseObjectSchema<{
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly disabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     }, undefined>, undefined>;
+    readonly showOther: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly otherLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly otherPlaceholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -111,6 +123,9 @@ export declare const aiAskQuestionsSchema: v.ArraySchema<v.UnionSchema<[v.LooseO
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly disabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     }, undefined>, undefined>;
+    readonly showOther: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly otherLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly otherPlaceholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -123,6 +138,9 @@ export declare const aiAskQuestionsSchema: v.ArraySchema<v.UnionSchema<[v.LooseO
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly disabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     }, undefined>, undefined>;
+    readonly showOther: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly otherLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly otherPlaceholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -160,6 +178,9 @@ export declare const aiAskUserQuestionToolPayloadSchema: v.LooseObjectSchema<{
             readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly disabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
         }, undefined>, undefined>;
+        readonly showOther: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly otherLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly otherPlaceholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
         readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -172,6 +193,9 @@ export declare const aiAskUserQuestionToolPayloadSchema: v.LooseObjectSchema<{
             readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly disabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
         }, undefined>, undefined>;
+        readonly showOther: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly otherLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly otherPlaceholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
         readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -197,6 +221,7 @@ export declare const aiAskUserQuestionToolPayloadSchema: v.LooseObjectSchema<{
     readonly nextLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly previousLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly discardLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly showOther: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
 }, undefined>;
 export declare const aiAskUserQuestionToolInputSchema: v.LooseObjectSchema<{
     readonly state: v.OptionalSchema<v.PicklistSchema<["pending", "completed", "complete", "success", "submitted", "discarded", "discard", "cancelled", "canceled"], undefined>, undefined>;
@@ -217,6 +242,9 @@ export declare const aiAskUserQuestionToolInputSchema: v.LooseObjectSchema<{
             readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly disabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
         }, undefined>, undefined>;
+        readonly showOther: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly otherLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly otherPlaceholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
         readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -229,6 +257,9 @@ export declare const aiAskUserQuestionToolInputSchema: v.LooseObjectSchema<{
             readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly disabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
         }, undefined>, undefined>;
+        readonly showOther: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly otherLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly otherPlaceholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
         readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -254,6 +285,7 @@ export declare const aiAskUserQuestionToolInputSchema: v.LooseObjectSchema<{
     readonly nextLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly previousLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly discardLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly showOther: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
 }, undefined>;
 export type AIAskUserQuestionToolPayload = v.InferOutput<typeof aiAskUserQuestionToolPayloadSchema>;
 export declare const aiAskUserQuestionOptionSchema: v.LooseObjectSchema<{
@@ -279,6 +311,9 @@ export declare const aiAskUserQuestionChoiceQuestionSchema: v.UnionSchema<[v.Loo
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly disabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     }, undefined>, undefined>;
+    readonly showOther: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly otherLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly otherPlaceholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -291,6 +326,9 @@ export declare const aiAskUserQuestionChoiceQuestionSchema: v.UnionSchema<[v.Loo
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly disabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     }, undefined>, undefined>;
+    readonly showOther: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly otherLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly otherPlaceholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -323,6 +361,9 @@ export declare const aiAskUserQuestionQuestionSchema: v.UnionSchema<[v.LooseObje
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly disabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     }, undefined>, undefined>;
+    readonly showOther: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly otherLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly otherPlaceholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -335,6 +376,9 @@ export declare const aiAskUserQuestionQuestionSchema: v.UnionSchema<[v.LooseObje
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly disabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     }, undefined>, undefined>;
+    readonly showOther: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly otherLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly otherPlaceholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;

package/dist/components/AIAskUserQuestion/schemas.js

@@ -33,12 +33,18 @@ export const aiTextQuestionSchema = v.looseObject({
 export const aiSingleQuestionSchema = v.looseObject({
     ...aiQuestionBaseEntries,
     type: v.literal('single'),
-    options: v.array(aiQuestionOptionSchema)
+    options: v.array(aiQuestionOptionSchema),
+    showOther: v.optional(v.boolean()),
+    otherLabel: v.optional(v.string()),
+    otherPlaceholder: v.optional(v.string())
 });
 export const aiMultipleQuestionSchema = v.looseObject({
     ...aiQuestionBaseEntries,
     type: v.literal('multiple'),
-    options: v.array(aiQuestionOptionSchema)
+    options: v.array(aiQuestionOptionSchema),
+    showOther: v.optional(v.boolean()),
+    otherLabel: v.optional(v.string()),
+    otherPlaceholder: v.optional(v.string())
 });
 export const aiFileQuestionSchema = v.looseObject({
     ...aiQuestionBaseEntries,
@@ -74,7 +80,8 @@ export const aiAskUserQuestionToolPayloadSchema = v.looseObject({
     submittingLabel: v.optional(v.string()),
     nextLabel: v.optional(v.string()),
     previousLabel: v.optional(v.string()),
-    discardLabel: v.optional(v.string())
+    discardLabel: v.optional(v.string()),
+    showOther: v.optional(v.boolean())
 });
 export const aiAskUserQuestionToolInputSchema = aiAskUserQuestionToolPayloadSchema;
 export const aiAskUserQuestionOptionSchema = aiQuestionOptionSchema;

package/dist/components/AIChat/AIChat.svelte

@@ -40,6 +40,9 @@
 		density,
 		messageSize,
 		messageVariant,
+		messageColor,
+		contentWidth,
+		showFollowUps,
 		messageActions,
 		messageActionsVisibility,
 		messageCopyable,
@@ -73,6 +76,8 @@
 		onQueuedMessageEditCancel,
 		onQueuedMessageReorder,
 		onSteer,
+		submitShortcut,
+		toolbar,
 		onStatusChange,
 		onSubmit,
 		onStop,
@@ -174,6 +179,9 @@
 			{density}
 			{messageSize}
 			{messageVariant}
+			{messageColor}
+			{contentWidth}
+			{showFollowUps}
 			{messageActions}
 			{messageActionsVisibility}
 			{messageCopyable}
@@ -207,6 +215,8 @@
 			{onQueuedMessageEditCancel}
 			{onQueuedMessageReorder}
 			{onSteer}
+			{submitShortcut}
+			{toolbar}
 			{header}
 			{beforeThread}
 			{controls}

package/dist/components/AIChat/AIChat.svelte.d.ts

@@ -3,7 +3,7 @@ import type { AIChatProps } from './aiChat.props.js';
 declare function $$render<TMessage extends AIThreadItem = AIThreadItem>(): {
     props: AIChatProps<TMessage>;
     exports: {};
-    bindings: "error" | "attachments" | "ref" | "files" | "suggestions" | "status" | "api" | "messages" | "streaming" | "queue" | "queuedMessage" | "currentInput" | "liveText" | "contextUsage" | "selectedModel" | "activeAskUserQuestion";
+    bindings: "error" | "attachments" | "ref" | "files" | "messages" | "suggestions" | "status" | "api" | "streaming" | "queue" | "queuedMessage" | "currentInput" | "liveText" | "contextUsage" | "selectedModel" | "activeAskUserQuestion";
     slots: {};
     events: {};
 };
@@ -11,7 +11,7 @@ declare class __sveltets_Render<TMessage extends AIThreadItem = AIThreadItem> {
     props(): ReturnType<typeof $$render<TMessage>>['props'];
     events(): ReturnType<typeof $$render<TMessage>>['events'];
     slots(): ReturnType<typeof $$render<TMessage>>['slots'];
-    bindings(): "error" | "attachments" | "ref" | "files" | "suggestions" | "status" | "api" | "messages" | "streaming" | "queue" | "queuedMessage" | "currentInput" | "liveText" | "contextUsage" | "selectedModel" | "activeAskUserQuestion";
+    bindings(): "error" | "attachments" | "ref" | "files" | "messages" | "suggestions" | "status" | "api" | "streaming" | "queue" | "queuedMessage" | "currentInput" | "liveText" | "contextUsage" | "selectedModel" | "activeAskUserQuestion";
     exports(): {};
 }
 interface $$IsomorphicComponent {

package/dist/components/AIChat/AIChatComposerSurface.svelte

@@ -7,6 +7,7 @@
 	import AIComposer from '../AIComposer/AIComposer.svelte';
 	import type {
 		AIComposerHandle,
+		AIComposerProps,
 		AIComposerQueuedMessage
 	} from '../AIComposer/aiComposer.props.js';
 	import AIContext from '../AIContext/AIContext.svelte';
@@ -55,7 +56,13 @@
 		| 'onQueuedMessageReorder'
 		| 'onSteer'
 		| 'theme'
-	> & { conversation: AIConversationState<TMessage> };
+	> & {
+		conversation: AIConversationState<TMessage>;
+		/** Composer submit shortcut; AIComposer's default (`'enter'`) when omitted. */
+		submitShortcut?: AIComposerProps['submitShortcut'];
+		/** Composer formatting toolbar; AIComposer's default (`'none'`) when omitted. */
+		toolbar?: AIComposerProps['toolbar'];
+	};
 
 	let {
 		conversation,
@@ -66,7 +73,7 @@
 		composer,
 		models = [],
 		modelGroups = [],
-		maxTokens = 128_000,
+		maxTokens,
 		showContext = true,
 		showModelSelector = true,
 		disabled = false,
@@ -93,13 +100,21 @@
 		onQueuedMessageEditCancel,
 		onQueuedMessageReorder,
 		onSteer,
+		submitShortcut,
+		toolbar,
 		theme
 	}: Props<TMessage> = $props();
 	const t = $derived(useI18n());
+	const DEFAULT_MAX_TOKENS = 128_000;
 
 	let composerHandle = $state<AIComposerHandle>();
 	let askUserQuestionValues = $state<Record<string, AIAskAnswers | undefined>>({});
 	const hasModels = $derived(models.length > 0 || modelGroups.length > 0);
+	// The default indicator only appears once there is something to measure: a context-window
+	// limit from the app or usage reported by the conversation. An empty ring reads as a spinner.
+	const hasContextData = $derived(
+		maxTokens !== undefined || conversation.contextUsage !== undefined
+	);
 	const classes = $derived(useAIChatTheme(theme));
 
 	export function focus(): void {
@@ -137,8 +152,8 @@
 		<div class={classes.controls()}>
 			{#if context}
 				<Slot render={context} payload={conversation} />
-			{:else if showContext}
-				<AIContext {maxTokens} compact />
+			{:else if showContext && hasContextData}
+				<AIContext maxTokens={maxTokens ?? DEFAULT_MAX_TOKENS} compact />
 			{/if}
 			{#if modelSelector}
 				<Slot render={modelSelector} payload={conversation} />
@@ -167,6 +182,7 @@
 			nextLabel={request.nextLabel}
 			previousLabel={request.previousLabel}
 			discardLabel={request.discardLabel}
+			showOther={request.showOther}
 			onValueChange={(value) => updateAskUserQuestionValue(request, value)}
 			onSubmit={(detail) => resolveAskUserQuestion(request, 'completed', detail)}
 			onDiscard={() => resolveAskUserQuestion(request, 'discarded')}
@@ -201,7 +217,9 @@
 			{onQueuedMessageEditCancel}
 			{onQueuedMessageReorder}
 			{onSteer}
-			footerStart={defaultControls}
+			{submitShortcut}
+			{toolbar}
+			modelSelector={defaultControls}
 		/>
 	{/if}
 </div>

package/dist/components/AIChat/AIChatComposerSurface.svelte.d.ts

@@ -1,8 +1,13 @@
+import type { AIComposerProps } from '../AIComposer/aiComposer.props.js';
 import type { AIConversationState } from '../AIConversation/aiConversation.state.svelte.js';
 import type { AIThreadItem } from '../AIThread/aiThread.props.js';
 import type { AIChatProps } from './aiChat.props.js';
 type Props<TMessage extends AIThreadItem> = Pick<AIChatProps<TMessage>, 'queue' | 'controls' | 'context' | 'modelSelector' | 'composer' | 'models' | 'modelGroups' | 'maxTokens' | 'showContext' | 'showModelSelector' | 'disabled' | 'queueWhileBusy' | 'fileDropzone' | 'fileMultiple' | 'accept' | 'maxFiles' | 'maxFileSize' | 'commands' | 'mentions' | 'references' | 'skills' | 'onFilesRejected' | 'onFileReject' | 'onAttachmentAdd' | 'onAttachmentRetry' | 'onAttachmentRemove' | 'onQueueChange' | 'onQueuedMessageAdd' | 'onQueuedMessageCancel' | 'onQueuedMessageEditStart' | 'onQueuedMessageEditCommit' | 'onQueuedMessageEditCancel' | 'onQueuedMessageReorder' | 'onSteer' | 'theme'> & {
     conversation: AIConversationState<TMessage>;
+    /** Composer submit shortcut; AIComposer's default (`'enter'`) when omitted. */
+    submitShortcut?: AIComposerProps['submitShortcut'];
+    /** Composer formatting toolbar; AIComposer's default (`'none'`) when omitted. */
+    toolbar?: AIComposerProps['toolbar'];
 };
 declare function $$render<TMessage extends AIThreadItem = AIThreadItem>(): {
     props: Props<TMessage>;