@adea-ai/ui 0.140.0 → 0.142.0

package/dist/components/composites/subagent/subagent.d.ts

@@ -0,0 +1,55 @@
+import { type JSX } from 'solid-js';
+import { type TraceLineProps, type TraceStatus } from '../../ui/trace';
+/**
+ * Subagent.
+ *
+ * Another agent the main one handed work to, as a `TraceLine`: its name, the task
+ * it was given, its status, and — folded away — everything it did. The body is a
+ * nested `Trace`, so a subagent's tool calls, reasoning and own subagents are the
+ * same lines as the parent's, one level in; nothing about "a run inside a run"
+ * needs a new visual. Reach for `Tool` when the call has an input and an output
+ * and no steps of its own, and for `Task` when the items are a statement of work
+ * rather than a record of what ran.
+ *
+ * ## The collapsed line is the summary
+ *
+ * Folded, the line carries what a reader scanning the turn needs: the name, the
+ * task, the status, and — in the trailing text — the model, the number of steps
+ * and how long it took. Each of those appears only when known: `model` and
+ * `duration` are the host's, and the step count is the number of lines passed as
+ * `children` unless the host knows better (`stepCount`, for a run whose earlier
+ * steps are not loaded). No count is shown for a run with no steps.
+ *
+ * ## Result and failure
+ *
+ * `result` is a slot for the answer the subagent returned — usually prose or a
+ * `CodeBlock` — below its steps, labelled "Result". `errorText` is a failure as
+ * text. Neither is invented: a subagent that finished without a result shows
+ * none, and one with no steps, result or error yet is a plain line (there is
+ * nothing to open; the line becomes a disclosure when its first step arrives).
+ *
+ * A `Subagent` is a line: place it inside a `Trace`, and its `children` are
+ * `TraceLine`s.
+ */
+export type SubagentProps = Omit<TraceLineProps, 'title' | 'description' | 'href' | 'onSelect' | 'selectHaspopup' | 'meta'> & {
+    /** The subagent's name. Rendered as text. */
+    name: string;
+    /** The task it was given, on the line. */
+    task?: JSX.Element;
+    status?: TraceStatus;
+    /** A model label, e.g. `sonnet-5`. Rendered as text. */
+    model?: string;
+    /** Seconds the run took, if the host measured it. */
+    duration?: number;
+    /** Overrides the count taken from `children`. */
+    stepCount?: number;
+    /** What the subagent returned. */
+    result?: JSX.Element;
+    errorText?: string;
+    /** Trailing text appended after the derived summary. */
+    meta?: JSX.Element;
+};
+/** `3 steps`, `1 step`. */
+export declare function stepCountLabel(count: number): string;
+export declare function Subagent(props: SubagentProps): JSX.Element;
+//# sourceMappingURL=subagent.d.ts.map

package/dist/components/composites/subagent/subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../../../src/components/composites/subagent/subagent.tsx"],"names":[],"mappings":"AACA,OAAO,EAAiD,KAAK,GAAG,EAAE,MAAM,UAAU,CAAA;AAGlF,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAA;AAMvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,cAAc,EACd,OAAO,GAAG,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,gBAAgB,GAAG,MAAM,CAC1E,GAAG;IACF,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAA;IACZ,0CAA0C;IAC1C,IAAI,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,MAAM,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wDAAwD;IACxD,IAAI,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;CACnB,CAAA;AAED,2BAA2B;AAC3B,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,eAoF5C"}

package/dist/components/composites/subagent/subagent.js

@@ -0,0 +1,138 @@
+import { CodeBlock } from "../../ui/code-block/code-block.js";
+import { ScrollArea } from "../../ui/scroll-area/scroll-area.js";
+import { Trace, TraceDetail, TraceLine } from "../../ui/trace/trace.js";
+import { formatDuration } from "../reasoning/reasoning.js";
+import { createComponent, insert, memo, mergeProps, template } from "solid-js/web";
+import { Bot } from "lucide-solid";
+import { Show, children, splitProps } from "solid-js";
+//#region src/components/composites/subagent/subagent.tsx
+var _tmpl$ = /*#__PURE__*/ template(`<span class="inline-block max-w-72 truncate align-bottom">`);
+var _tmpl$2 = /*#__PURE__*/ template(`<div class="flex min-w-0 flex-col gap-1"><p class="m-0 font-medium text-foreground">Result`);
+var deferred = (render) => render;
+/** `3 steps`, `1 step`. */
+function stepCountLabel(count) {
+	return `${count} ${count === 1 ? "step" : "steps"}`;
+}
+function Subagent(props) {
+	const [local, rest] = splitProps(props, [
+		"name",
+		"task",
+		"status",
+		"model",
+		"duration",
+		"stepCount",
+		"result",
+		"errorText",
+		"icon",
+		"meta",
+		"children"
+	]);
+	const steps = children(() => local.children);
+	const count = () => local.stepCount ?? steps.toArray().length;
+	const hasError = () => local.errorText !== void 0 && local.errorText !== "";
+	const hasResult = () => local.result !== void 0 && local.result !== null;
+	const hasDetail = () => steps.toArray().length > 0 || hasResult() || hasError();
+	const summary = () => {
+		const parts = [
+			local.model,
+			count() > 0 ? stepCountLabel(count()) : void 0,
+			formatDuration(local.duration)
+		].filter((part) => part !== void 0 && part !== "");
+		return parts.length > 0 ? parts.join(" · ") : void 0;
+	};
+	const meta = () => summary() || local.meta ? [createComponent(Show, {
+		get when() {
+			return summary();
+		},
+		get children() {
+			var _el$ = _tmpl$();
+			insert(_el$, summary);
+			return _el$;
+		}
+	}), memo(() => local.meta)] : void 0;
+	const detail = () => createComponent(TraceDetail, {
+		"class": "flex flex-col gap-2",
+		get children() {
+			return [
+				createComponent(Show, {
+					get when() {
+						return steps.toArray().length > 0;
+					},
+					get children() {
+						return createComponent(Trace, {
+							size: "sm",
+							get ["aria-label"]() {
+								return `${local.name} steps`;
+							},
+							get children() {
+								return steps();
+							}
+						});
+					}
+				}),
+				createComponent(Show, {
+					get when() {
+						return hasError();
+					},
+					get children() {
+						return createComponent(CodeBlock, {
+							size: "sm",
+							title: "Error",
+							language: "error",
+							get code() {
+								return local.errorText ?? "";
+							},
+							lineMarks: { 1: "error" },
+							complete: true,
+							maxHeight: "12rem",
+							wrap: true
+						});
+					}
+				}),
+				createComponent(Show, {
+					get when() {
+						return hasResult();
+					},
+					get children() {
+						var _el$2 = _tmpl$2();
+						_el$2.firstChild;
+						insert(_el$2, createComponent(ScrollArea, {
+							role: "region",
+							get ["aria-label"]() {
+								return `${local.name} result`;
+							},
+							"class": "max-h-72",
+							get children() {
+								return local.result;
+							}
+						}), null);
+						return _el$2;
+					}
+				})
+			];
+		}
+	});
+	return createComponent(TraceLine, mergeProps({
+		get icon() {
+			return local.icon ?? createComponent(Bot, {});
+		},
+		get title() {
+			return local.name;
+		},
+		get description() {
+			return local.task;
+		},
+		get status() {
+			return local.status;
+		},
+		get meta() {
+			return meta();
+		}
+	}, rest, { get children() {
+		return memo(() => !!hasDetail())() ? deferred(detail) : void 0;
+	} }));
+}
+//#endregion
+export { Subagent, stepCountLabel };
+
+//# sourceMappingURL=subagent.js.map

package/dist/components/composites/subagent/subagent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.js","names":["Bot","children","resolveChildren","Show","splitProps","JSX","CodeBlock","ScrollArea","Trace","TraceDetail","TraceLine","TraceLineProps","TraceStatus","formatDuration","deferred","render","Element","SubagentProps","Omit","name","task","status","model","duration","stepCount","result","errorText","meta","stepCountLabel","count","Subagent","props","local","rest","steps","toArray","length","hasError","undefined","hasResult","hasDetail","summary","parts","filter","part","join","_$createComponent","when","_el$","_tmpl$","_$insert","_$memo","detail","size","aria-label","title","language","code","lineMarks","complete","maxHeight","wrap","_el$2","_tmpl$2","_el$3","firstChild","role","_$mergeProps","icon","description","resolveChildren","_$createComponent","_$memo","_$mergeProps"],"sources":["../../../../src/components/composites/subagent/subagent.tsx"],"sourcesContent":["import { Bot } from 'lucide-solid'\nimport { children as resolveChildren, Show, splitProps, type JSX } from 'solid-js'\nimport { CodeBlock } from '../../ui/code-block'\nimport { ScrollArea } from '../../ui/scroll-area'\nimport {\n  Trace,\n  TraceDetail,\n  TraceLine,\n  type TraceLineProps,\n  type TraceStatus,\n} from '../../ui/trace'\nimport { formatDuration } from '../reasoning'\n\n// A function child runs once, when the content mounts (see `deferred` in `tool.tsx`).\nconst deferred = (render: () => JSX.Element) => render as unknown as JSX.Element\n\n/**\n * Subagent.\n *\n * Another agent the main one handed work to, as a `TraceLine`: its name, the task\n * it was given, its status, and — folded away — everything it did. The body is a\n * nested `Trace`, so a subagent's tool calls, reasoning and own subagents are the\n * same lines as the parent's, one level in; nothing about \"a run inside a run\"\n * needs a new visual. Reach for `Tool` when the call has an input and an output\n * and no steps of its own, and for `Task` when the items are a statement of work\n * rather than a record of what ran.\n *\n * ## The collapsed line is the summary\n *\n * Folded, the line carries what a reader scanning the turn needs: the name, the\n * task, the status, and — in the trailing text — the model, the number of steps\n * and how long it took. Each of those appears only when known: `model` and\n * `duration` are the host's, and the step count is the number of lines passed as\n * `children` unless the host knows better (`stepCount`, for a run whose earlier\n * steps are not loaded). No count is shown for a run with no steps.\n *\n * ## Result and failure\n *\n * `result` is a slot for the answer the subagent returned — usually prose or a\n * `CodeBlock` — below its steps, labelled \"Result\". `errorText` is a failure as\n * text. Neither is invented: a subagent that finished without a result shows\n * none, and one with no steps, result or error yet is a plain line (there is\n * nothing to open; the line becomes a disclosure when its first step arrives).\n *\n * A `Subagent` is a line: place it inside a `Trace`, and its `children` are\n * `TraceLine`s.\n */\nexport type SubagentProps = Omit<\n  TraceLineProps,\n  'title' | 'description' | 'href' | 'onSelect' | 'selectHaspopup' | 'meta'\n> & {\n  /** The subagent's name. Rendered as text. */\n  name: string\n  /** The task it was given, on the line. */\n  task?: JSX.Element\n  status?: TraceStatus\n  /** A model label, e.g. `sonnet-5`. Rendered as text. */\n  model?: string\n  /** Seconds the run took, if the host measured it. */\n  duration?: number\n  /** Overrides the count taken from `children`. */\n  stepCount?: number\n  /** What the subagent returned. */\n  result?: JSX.Element\n  errorText?: string\n  /** Trailing text appended after the derived summary. */\n  meta?: JSX.Element\n}\n\n/** `3 steps`, `1 step`. */\nexport function stepCountLabel(count: number): string {\n  return `${count} ${count === 1 ? 'step' : 'steps'}`\n}\n\nexport function Subagent(props: SubagentProps) {\n  const [local, rest] = splitProps(props, [\n    'name',\n    'task',\n    'status',\n    'model',\n    'duration',\n    'stepCount',\n    'result',\n    'errorText',\n    'icon',\n    'meta',\n    'children',\n  ])\n  // Resolved once: the steps are created once and keep their own state (an open\n  // tool call, a scrolled output) while the run is folded and unfolded.\n  const steps = resolveChildren(() => local.children)\n  const count = () => local.stepCount ?? steps.toArray().length\n  const hasError = () => local.errorText !== undefined && local.errorText !== ''\n  const hasResult = () => local.result !== undefined && local.result !== null\n  const hasDetail = () => steps.toArray().length > 0 || hasResult() || hasError()\n\n  const summary = () => {\n    const parts = [\n      local.model,\n      count() > 0 ? stepCountLabel(count()) : undefined,\n      formatDuration(local.duration),\n    ].filter((part): part is string => part !== undefined && part !== '')\n    return parts.length > 0 ? parts.join(' · ') : undefined\n  }\n\n  // A model label is host text and may be long; it must not widen the line.\n  const meta = () =>\n    summary() || local.meta ? (\n      <>\n        <Show when={summary()}>\n          <span class=\"inline-block max-w-72 truncate align-bottom\">{summary()}</span>\n        </Show>\n        {local.meta}\n      </>\n    ) : undefined\n\n  const detail = () => (\n    <TraceDetail class=\"flex flex-col gap-2\">\n      <Show when={steps.toArray().length > 0}>\n        <Trace size=\"sm\" aria-label={`${local.name} steps`}>\n          {steps()}\n        </Trace>\n      </Show>\n      <Show when={hasError()}>\n        <CodeBlock\n          size=\"sm\"\n          title=\"Error\"\n          language=\"error\"\n          code={local.errorText ?? ''}\n          lineMarks={{ 1: 'error' }}\n          complete\n          maxHeight=\"12rem\"\n          wrap\n        />\n      </Show>\n      <Show when={hasResult()}>\n        <div class=\"flex min-w-0 flex-col gap-1\">\n          <p class=\"m-0 font-medium text-foreground\">Result</p>\n          <ScrollArea role=\"region\" aria-label={`${local.name} result`} class=\"max-h-72\">\n            {local.result}\n          </ScrollArea>\n        </div>\n      </Show>\n    </TraceDetail>\n  )\n\n  return (\n    <TraceLine\n      icon={local.icon ?? <Bot />}\n      title={local.name}\n      description={local.task}\n      status={local.status}\n      meta={meta()}\n      {...rest}\n    >\n      {hasDetail() ? deferred(detail) : undefined}\n    </TraceLine>\n  )\n}\n"],"mappings":"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"}

package/dist/components/composites/suggestion/index.d.ts

@@ -0,0 +1,2 @@
+export { Suggestion, Suggestions, type SuggestionProps, type SuggestionsProps } from './suggestion';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/composites/suggestion/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/composites/suggestion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAA"}

package/dist/components/composites/suggestion/index.js

@@ -0,0 +1,2 @@
+import { Suggestion, Suggestions } from "./suggestion.js";
+export { Suggestion, Suggestions };

package/dist/components/composites/suggestion/suggestion.d.ts

@@ -0,0 +1,37 @@
+import { type ComponentProps } from 'solid-js';
+/**
+ * Suggestions.
+ *
+ * A row of one-click prompts: each chip is the text that will be sent, so choosing
+ * one is a single decision and never "fill the composer, then still have to press
+ * send". What a chip *does* with its text — send it, drop it in the composer —
+ * is the host's `onSelect`; this component only reports which one was chosen.
+ *
+ * - **Layout.** `wrap` (default) lets chips flow onto further lines, which is the
+ *   right behaviour at a narrow width. `scroll` keeps a single line that scrolls
+ *   sideways, for a bar above a composer that must not grow; the chips are real
+ *   buttons, so keyboard focus scrolls them into view and nothing depends on a
+ *   pointer to reach the overflow.
+ * - **Long text is clipped, not hidden.** A chip is one line and truncates; the
+ *   full text is the button's accessible name and its `title`.
+ * - **The host owns authority.** No `onSelect`, or a `disabledReason`, disables
+ *   every chip and says why in words under the row. Chips use `aria-disabled`
+ *   rather than `disabled`, so a keyboard or screen-reader user can still reach
+ *   them and hear the reason instead of finding a row that is silently skipped.
+ */
+export type SuggestionsProps = Omit<ComponentProps<'div'>, 'onSelect'> & {
+    /** The row's accessible name. */
+    label?: string;
+    layout?: 'wrap' | 'scroll';
+    /** Called with the chosen chip's text. Without it every chip is disabled. */
+    onSelect?: (text: string) => void;
+    /** Why the chips cannot be used right now. Implies disabled. */
+    disabledReason?: string;
+};
+export declare function Suggestions(props: SuggestionsProps): import("solid-js").JSX.Element;
+export type SuggestionProps = Omit<ComponentProps<'button'>, 'onSelect' | 'children'> & {
+    /** The text that is sent when the chip is chosen. Also the chip's name. */
+    text: string;
+};
+export declare function Suggestion(props: SuggestionProps): import("solid-js").JSX.Element;
+//# sourceMappingURL=suggestion.d.ts.map

package/dist/components/composites/suggestion/suggestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion.d.ts","sourceRoot":"","sources":["../../../../src/components/composites/suggestion/suggestion.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,UAAU,CAAA;AAKjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;IACvE,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAUD,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,kCAmDlD;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC,GAAG;IACtF,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,kCA+BhD"}

package/dist/components/composites/suggestion/suggestion.js

@@ -0,0 +1,100 @@
+import { cn } from "../../../lib/utils.js";
+import { Button } from "../../ui/button/button.js";
+import { boundText } from "../sources/source.js";
+import { createComponent, insert, memo, mergeProps, setAttribute, spread, template } from "solid-js/web";
+import { Show, createContext, createUniqueId, splitProps, useContext } from "solid-js";
+//#region src/components/composites/suggestion/suggestion.tsx
+var _tmpl$ = /*#__PURE__*/ template(`<p role=status class="m-0 text-xs text-muted-foreground">`);
+var _tmpl$2 = /*#__PURE__*/ template(`<div data-slot=suggestions class="flex min-w-0 flex-col gap-1.5"><div role=group>`);
+var _tmpl$3 = /*#__PURE__*/ template(`<span class=truncate>`);
+var SuggestionsContext = createContext();
+function Suggestions(props) {
+	const [local, rest] = splitProps(props, [
+		"class",
+		"label",
+		"layout",
+		"onSelect",
+		"disabledReason",
+		"children"
+	]);
+	const reasonId = `${createUniqueId()}-reason`;
+	const reason = () => local.disabledReason ? boundText(local.disabledReason, 240) : local.onSelect === void 0 ? "Suggestions are not available here." : void 0;
+	return createComponent(SuggestionsContext.Provider, {
+		value: {
+			select: (text) => local.onSelect?.(text),
+			blocked: () => reason() !== void 0,
+			reasonId: () => reason() ? reasonId : void 0
+		},
+		get children() {
+			var _el$ = _tmpl$2(), _el$2 = _el$.firstChild;
+			spread(_el$2, mergeProps({
+				get ["aria-label"]() {
+					return local.label ?? "Suggested prompts";
+				},
+				get ["class"]() {
+					return cn("flex min-w-0 gap-2", {
+						"flex-wrap": local.layout !== "scroll",
+						"flex-nowrap overflow-x-auto p-1 [&>*]:shrink-0": local.layout === "scroll"
+					}, local.class);
+				}
+			}, rest), false, true);
+			insert(_el$2, () => local.children);
+			insert(_el$, createComponent(Show, {
+				get when() {
+					return reason();
+				},
+				get children() {
+					var _el$3 = _tmpl$();
+					setAttribute(_el$3, "id", reasonId);
+					insert(_el$3, reason);
+					return _el$3;
+				}
+			}), null);
+			return _el$;
+		}
+	});
+}
+function Suggestion(props) {
+	const [local, rest] = splitProps(props, [
+		"class",
+		"text",
+		"onClick"
+	]);
+	const context = useContext(SuggestionsContext);
+	const blocked = () => context === void 0 || context.blocked();
+	const text = () => boundText(local.text, 400);
+	return createComponent(Button, mergeProps({
+		type: "button",
+		variant: "outline",
+		size: "sm",
+		"data-slot": "suggestion",
+		get title() {
+			return memo(() => text().length > 40)() ? text() : void 0;
+		},
+		get ["aria-disabled"]() {
+			return blocked() || void 0;
+		},
+		get ["aria-describedby"]() {
+			return context?.reasonId();
+		},
+		get ["class"]() {
+			return cn("max-w-full", local.class);
+		},
+		onClick: (event) => {
+			if (blocked()) {
+				event.preventDefault();
+				return;
+			}
+			if (typeof local.onClick === "function") local.onClick(event);
+			context?.select(local.text);
+		}
+	}, rest, { get children() {
+		var _el$4 = _tmpl$3();
+		insert(_el$4, text);
+		return _el$4;
+	} }));
+}
+//#endregion
+export { Suggestion, Suggestions };
+
+//# sourceMappingURL=suggestion.js.map

package/dist/components/composites/suggestion/suggestion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion.js","names":["createContext","createUniqueId","Show","splitProps","useContext","ComponentProps","cn","Button","boundText","SuggestionsProps","Omit","label","layout","onSelect","text","disabledReason","SuggestionsContext","select","blocked","reasonId","Suggestions","props","local","rest","uid","reason","undefined","_$createComponent","Provider","value","children","_el$","_tmpl$2","_el$2","firstChild","_$spread","_$mergeProps","aria-label","class","_$insert","when","_el$3","_tmpl$","_$setAttribute","SuggestionProps","Suggestion","context","type","variant","size","title","_$memo","length","aria-disabled","aria-describedby","onClick","event","preventDefault","_el$4","_tmpl$3","_$createComponent","_$mergeProps","_$memo"],"sources":["../../../../src/components/composites/suggestion/suggestion.tsx"],"sourcesContent":["import {\n  createContext,\n  createUniqueId,\n  Show,\n  splitProps,\n  useContext,\n  type ComponentProps,\n} from 'solid-js'\nimport { cn } from '#lib/utils'\nimport { Button } from '../../ui/button'\nimport { boundText } from '../sources/source'\n\n/**\n * Suggestions.\n *\n * A row of one-click prompts: each chip is the text that will be sent, so choosing\n * one is a single decision and never \"fill the composer, then still have to press\n * send\". What a chip *does* with its text — send it, drop it in the composer —\n * is the host's `onSelect`; this component only reports which one was chosen.\n *\n * - **Layout.** `wrap` (default) lets chips flow onto further lines, which is the\n *   right behaviour at a narrow width. `scroll` keeps a single line that scrolls\n *   sideways, for a bar above a composer that must not grow; the chips are real\n *   buttons, so keyboard focus scrolls them into view and nothing depends on a\n *   pointer to reach the overflow.\n * - **Long text is clipped, not hidden.** A chip is one line and truncates; the\n *   full text is the button's accessible name and its `title`.\n * - **The host owns authority.** No `onSelect`, or a `disabledReason`, disables\n *   every chip and says why in words under the row. Chips use `aria-disabled`\n *   rather than `disabled`, so a keyboard or screen-reader user can still reach\n *   them and hear the reason instead of finding a row that is silently skipped.\n */\nexport type SuggestionsProps = Omit<ComponentProps<'div'>, 'onSelect'> & {\n  /** The row's accessible name. */\n  label?: string\n  layout?: 'wrap' | 'scroll'\n  /** Called with the chosen chip's text. Without it every chip is disabled. */\n  onSelect?: (text: string) => void\n  /** Why the chips cannot be used right now. Implies disabled. */\n  disabledReason?: string\n}\n\ntype SuggestionsContext = {\n  select: (text: string) => void\n  blocked: () => boolean\n  reasonId: () => string | undefined\n}\n\nconst SuggestionsContext = createContext<SuggestionsContext>()\n\nexport function Suggestions(props: SuggestionsProps) {\n  const [local, rest] = splitProps(props, [\n    'class',\n    'label',\n    'layout',\n    'onSelect',\n    'disabledReason',\n    'children',\n  ])\n  const uid = createUniqueId()\n  const reasonId = `${uid}-reason`\n  const reason = () =>\n    local.disabledReason\n      ? boundText(local.disabledReason, 240)\n      : local.onSelect === undefined\n        ? 'Suggestions are not available here.'\n        : undefined\n\n  return (\n    <SuggestionsContext.Provider\n      value={{\n        select: (text) => local.onSelect?.(text),\n        blocked: () => reason() !== undefined,\n        reasonId: () => (reason() ? reasonId : undefined),\n      }}\n    >\n      <div data-slot=\"suggestions\" class=\"flex min-w-0 flex-col gap-1.5\">\n        <div\n          role=\"group\"\n          aria-label={local.label ?? 'Suggested prompts'}\n          class={cn(\n            'flex min-w-0 gap-2',\n            {\n              'flex-wrap': local.layout !== 'scroll',\n              // Padding below keeps the focus ring of a chip from being clipped by the scroller.\n              'flex-nowrap overflow-x-auto p-1 [&>*]:shrink-0': local.layout === 'scroll',\n            },\n            local.class\n          )}\n          {...rest}\n        >\n          {local.children}\n        </div>\n        <Show when={reason()}>\n          <p id={reasonId} role=\"status\" class=\"m-0 text-xs text-muted-foreground\">\n            {reason()}\n          </p>\n        </Show>\n      </div>\n    </SuggestionsContext.Provider>\n  )\n}\n\nexport type SuggestionProps = Omit<ComponentProps<'button'>, 'onSelect' | 'children'> & {\n  /** The text that is sent when the chip is chosen. Also the chip's name. */\n  text: string\n}\n\nexport function Suggestion(props: SuggestionProps) {\n  const [local, rest] = splitProps(props, ['class', 'text', 'onClick'])\n  const context = useContext(SuggestionsContext)\n  // A chip outside a `Suggestions` row has no handler to call: inert and honest.\n  const blocked = () => context === undefined || context.blocked()\n  const text = () => boundText(local.text, 400)\n\n  return (\n    <Button\n      type=\"button\"\n      variant=\"outline\"\n      size=\"sm\"\n      data-slot=\"suggestion\"\n      title={text().length > 40 ? text() : undefined}\n      aria-disabled={blocked() || undefined}\n      aria-describedby={context?.reasonId()}\n      class={cn('max-w-full', local.class)}\n      onClick={(event) => {\n        if (blocked()) {\n          event.preventDefault()\n          return\n        }\n        if (typeof local.onClick === 'function') local.onClick(event)\n        // The host's own string, untouched: only the label is clipped, never what is sent.\n        context?.select(local.text)\n      }}\n      {...rest}\n    >\n      <span class=\"truncate\">{text()}</span>\n    </Button>\n  )\n}\n"],"mappings":";;;;;;;;;AAgDA,IAAMgB,qBAAqBhB,cAAkC;AAE7D,SAAgBoB,YAAYC,OAAyB;CACnD,MAAM,CAACC,OAAOC,QAAQpB,WAAWkB,OAAO;EACtC;EACA;EACA;EACA;EACA;EACA;CAAU,CACX;CAED,MAAMF,WAAW,GADLlB,eACQuB,EAAG;CACvB,MAAMC,eACJH,MAAMP,iBACFP,UAAUc,MAAMP,gBAAgB,GAAG,IACnCO,MAAMT,aAAaa,KAAAA,IACjB,wCACAA,KAAAA;CAER,OAAAC,gBACGX,mBAAmBY,UAAQ;EAC1BC,OAAO;GACLZ,SAASH,SAASQ,MAAMT,WAAWC,IAAI;GACvCI,eAAeO,OAAO,MAAMC,KAAAA;GAC5BP,gBAAiBM,OAAO,IAAIN,WAAWO,KAAAA;EACzC;EAAC,IAAAI,WAAA;GAAA,IAAAC,OAAAC,QAAA,GAAAC,QAAAF,KAAAG;GAAAC,OAAAF,OAAAG,WAAA;IAAA,KAAA,gBAAA;KAAA,OAKed,MAAMX,SAAS;IAAmB;IAAA,KAAA,WAAA;KAAA,OACvCL,GACL,sBACA;MACE,aAAagB,MAAMV,WAAW;MAE9B,kDAAkDU,MAAMV,WAAW;KACrE,GACAU,MAAMgB,KACR;IAAC;GAAA,GACGf,IAAI,GAAA,OAAA,IAAA;GAAAgB,OAAAN,aAEPX,MAAMQ,QAAQ;GAAAS,OAAAR,MAAAJ,gBAEhBzB,MAAI;IAAA,IAACsC,OAAI;KAAA,OAAEf,OAAO;IAAC;IAAA,IAAAK,WAAA;KAAA,IAAAW,QAAAC,OAAA;KAAAC,aAAAF,OAAA,MACXtB,QAAQ;KAAAoB,OAAAE,OACZhB,MAAM;KAAA,OAAAgB;IAAA;GAAA,CAAA,GAAA,IAAA;GAAA,OAAAV;EAAA;CAAA,CAAA;AAMnB;AAOA,SAAgBc,WAAWxB,OAAwB;CACjD,MAAM,CAACC,OAAOC,QAAQpB,WAAWkB,OAAO;EAAC;EAAS;EAAQ;CAAS,CAAC;CACpE,MAAMyB,UAAU1C,WAAWY,kBAAkB;CAE7C,MAAME,gBAAgB4B,YAAYpB,KAAAA,KAAaoB,QAAQ5B,QAAQ;CAC/D,MAAMJ,aAAaN,UAAUc,MAAMR,MAAM,GAAG;CAE5C,OAAAa,gBACGpB,QAAM6B,WAAA;EACLW,MAAI;EACJC,SAAO;EACPC,MAAI;EAAA,aAAA;EAAA,IAEJC,QAAK;GAAA,OAAEC,WAAArC,KAAK,CAAC,CAACsC,SAAS,EAAE,CAAA,CAAA,IAAGtC,KAAK,IAAIY,KAAAA;EAAS;EAAA,KAAA,mBAAA;GAAA,OAC/BR,QAAQ,KAAKQ,KAAAA;EAAS;EAAA,KAAA,sBAAA;GAAA,OACnBoB,SAAS3B,SAAS;EAAC;EAAA,KAAA,WAAA;GAAA,OAC9Bb,GAAG,cAAcgB,MAAMgB,KAAK;EAAC;EACpCiB,UAAUC,UAAU;GAClB,IAAItC,QAAQ,GAAG;IACbsC,MAAMC,eAAe;IACrB;GACF;GACA,IAAI,OAAOnC,MAAMiC,YAAY,YAAYjC,MAAMiC,QAAQC,KAAK;GAE5DV,SAAS7B,OAAOK,MAAMR,IAAI;EAC5B;CAAC,GACGS,MAAI,EAAA,IAAAO,WAAA;EAAA,IAAA4B,QAAAC,QAAA;EAAApB,OAAAmB,OAEgB5C,IAAI;EAAA,OAAA4C;CAAA,EAAA,CAAA,CAAA;AAGlC"}

package/dist/components/composites/task/index.d.ts

@@ -0,0 +1,2 @@
+export { Task, TaskItemList, TaskItemRow, TASK_ITEM_STATUS_LABELS, taskProgress, taskProgressLabel, type TaskFile, type TaskItem, type TaskItemListProps, type TaskItemRowProps, type TaskItemStatus, type TaskProps, } from './task';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/composites/task/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/composites/task/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,WAAW,EACX,uBAAuB,EACvB,YAAY,EACZ,iBAAiB,EACjB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,SAAS,GACf,MAAM,QAAQ,CAAA"}

package/dist/components/composites/task/index.js

@@ -0,0 +1,2 @@
+import { TASK_ITEM_STATUS_LABELS, Task, TaskItemList, TaskItemRow, taskProgress, taskProgressLabel } from "./task.js";
+export { TASK_ITEM_STATUS_LABELS, Task, TaskItemList, TaskItemRow, taskProgress, taskProgressLabel };

package/dist/components/composites/task/task.d.ts

@@ -0,0 +1,96 @@
+import { type ComponentProps, type JSX } from 'solid-js';
+import { type AttachmentKind } from '../../ui/attachment';
+import { type TraceLineProps } from '../../ui/trace';
+/**
+ * Task.
+ *
+ * One piece of work the agent is doing, as a `TraceLine` that opens onto its
+ * items: a title, then a list in which each item is a sentence, optionally a
+ * status, and optionally the files it touched. Reach for `Plan` when the list is
+ * a proposal the person approves, for `Queue` when it is the agent's running
+ * todo list, and for a `Trace` of tool calls when the items are things that
+ * *ran* — a Task item is a statement about work, not a record of a call.
+ *
+ * ## Items wrap; lines do not
+ *
+ * A `TraceLine` truncates its title to one row, which is right for "Read
+ * src/app.tsx" and wrong for "Backfill locale from profile.language, falling
+ * back to en". Items are therefore their own rows with the same mark and colour
+ * vocabulary as a Trace line but wrapping text, clamped to three lines so a
+ * pasted paragraph cannot take the column. `TaskItemRow` and `TaskItemList` are
+ * exported because `Plan` and `Queue` are built from them.
+ *
+ * ## Status is a claim
+ *
+ * An item shows a mark and speaks a word only when the host supplied `status`.
+ * The "2 of 4 done" in the header is derived from those statuses and appears
+ * only if at least one item has one; items without a status are counted in the
+ * total and not in "done" (see `taskProgress`). A task with no items is a plain
+ * line: there is nothing to open, and an empty disclosure is a control that
+ * does nothing.
+ *
+ * ## Files are untrusted metadata
+ *
+ * File chips are `Attachment` chips with no handlers, so they are text: a name
+ * is never a link or a path. Past six, the rest sit behind one toggle button
+ * whose label changes in place, so keyboard focus survives opening and closing
+ * it.
+ */
+export type TaskItemStatus = 'complete' | 'active' | 'pending' | 'failed' | 'skipped';
+export type TaskFile = Readonly<{
+    name: string;
+    kind?: AttachmentKind;
+    /** Bytes. */
+    size?: number;
+}>;
+export type TaskItem = Readonly<{
+    /** Only needed for the host's own bookkeeping; rows are kept by position. */
+    id?: string;
+    text: string;
+    description?: string;
+    status?: TaskItemStatus;
+    files?: readonly TaskFile[];
+}>;
+/** The words spoken for each item status. */
+export declare const TASK_ITEM_STATUS_LABELS: Readonly<Record<TaskItemStatus, string>>;
+/**
+ * How many items are done, or nothing at all when no item carries a status.
+ * Items without a status count toward the total: the host did not say they were
+ * finished, so they are not.
+ */
+export declare function taskProgress(items: readonly Pick<TaskItem, 'status'>[]): Readonly<{
+    done: number;
+    total: number;
+}> | undefined;
+/** `2 of 4 done`, in words. */
+export declare function taskProgressLabel(progress: {
+    done: number;
+    total: number;
+}): string;
+export type TaskItemRowProps = Omit<ComponentProps<'li'>, 'children'> & {
+    text: string;
+    description?: string;
+    status?: TaskItemStatus;
+    files?: readonly TaskFile[];
+    /** Spoken in place of the default status word. */
+    statusLabel?: string;
+};
+export declare function TaskItemRow(props: TaskItemRowProps): JSX.Element;
+export type TaskItemListProps = Omit<ComponentProps<'div'>, 'children'> & {
+    /** The list's accessible name. A scrolling region without one is an unlabelled tab stop. */
+    label: string;
+    children?: JSX.Element;
+};
+/**
+ * The items, bounded. Two hundred todo items must scroll inside their line and
+ * not push the answer out of view; the region is keyboard-focusable and named,
+ * which is what makes the overflow reachable without a pointer.
+ */
+export declare function TaskItemList(props: TaskItemListProps): JSX.Element;
+export type TaskProps = Omit<TraceLineProps, 'description' | 'href' | 'onSelect' | 'selectHaspopup' | 'children'> & {
+    items: readonly TaskItem[];
+    /** The item list's accessible name. Defaults to the title when it is a string. */
+    itemsLabel?: string;
+};
+export declare function Task(props: TaskProps): JSX.Element;
+//# sourceMappingURL=task.d.ts.map

package/dist/components/composites/task/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../../src/components/composites/task/task.tsx"],"names":[],"mappings":"AAQA,OAAO,EAOL,KAAK,cAAc,EACnB,KAAK,GAAG,EACT,MAAM,UAAU,CAAA;AAEjB,OAAO,EAA8B,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAGrF,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAK/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;AAErF,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,aAAa;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAC,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAC9B,6EAA6E;IAC7E,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAA;CAC5B,CAAC,CAAA;AAEF,6CAA6C;AAC7C,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAM5E,CAAA;AAWD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,GACzC,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAMvD;AAED,+BAA+B;AAC/B,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEnF;AAyCD,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,GAAG;IACtE,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC3B,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,eA2ElD;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;IACxE,4FAA4F;IAC5F,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;CACvB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,eAcpD;AAED,MAAM,MAAM,SAAS,GAAG,IAAI,CAC1B,cAAc,EACd,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,gBAAgB,GAAG,UAAU,CACpE,GAAG;IACF,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC1B,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,eAqCpC"}