@adea-ai/ui 0.139.0 → 0.142.0

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

@@ -0,0 +1,311 @@
+import { cn } from "../../../lib/utils.js";
+import { Button } from "../../ui/button/button.js";
+import { Attachment, AttachmentList } from "../../ui/attachment/attachment.js";
+import { ScrollArea } from "../../ui/scroll-area/scroll-area.js";
+import { TraceLine } from "../../ui/trace/trace.js";
+import { className, createComponent, effect, insert, memo, mergeProps, setAttribute, spread, template } from "solid-js/web";
+import { Check, CircleAlert, CircleDashed, CircleSlash, ListChecks, LoaderCircle } from "lucide-solid";
+import { For, Index, Show, createMemo, createSignal, splitProps } from "solid-js";
+//#region src/components/composites/task/task.tsx
+var _tmpl$ = /*#__PURE__*/ template(`<span aria-hidden=true data-slot=task-item-mark>`);
+var _tmpl$2 = /*#__PURE__*/ template(`<span class="size-1 rounded-full bg-muted-foreground/60">`);
+var _tmpl$3 = /*#__PURE__*/ template(`<li class="flex items-center">`);
+var _tmpl$4 = /*#__PURE__*/ template(`<li data-slot=task-item><div class="flex min-w-0 flex-1 flex-col gap-1"><p>`);
+var _tmpl$5 = /*#__PURE__*/ template(`<span class=sr-only> `);
+var _tmpl$6 = /*#__PURE__*/ template(`<p class="m-0 line-clamp-3 text-xs [overflow-wrap:anywhere] text-muted-foreground/80">`);
+var _tmpl$7 = /*#__PURE__*/ template(`<li class="min-w-0 max-w-full">`);
+var _tmpl$8 = /*#__PURE__*/ template(`<ul role=list class="m-0 flex list-none flex-col gap-0.5 p-0">`);
+var deferred = (render) => render;
+/** The words spoken for each item status. */
+var TASK_ITEM_STATUS_LABELS = {
+	complete: "Completed",
+	active: "In progress",
+	pending: "Pending",
+	failed: "Failed",
+	skipped: "Skipped"
+};
+/** Visible files per item before the rest go behind a toggle. */
+var VISIBLE_FILES = 6;
+/** Characters of item text kept; the rest of a pasted wall is not a todo. */
+var MAX_TEXT = 1e3;
+function bound(text, max) {
+	return text.length > max ? `${text.slice(0, max)}…` : text;
+}
+/**
+* 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.
+*/
+function taskProgress(items) {
+	if (!items.some((item) => item.status !== void 0)) return void 0;
+	return {
+		done: items.filter((item) => item.status === "complete").length,
+		total: items.length
+	};
+}
+/** `2 of 4 done`, in words. */
+function taskProgressLabel(progress) {
+	return `${progress.done} of ${progress.total} done`;
+}
+function ItemMark(props) {
+	return (() => {
+		var _el$ = _tmpl$();
+		insert(_el$, createComponent(Show, {
+			get when() {
+				return props.status;
+			},
+			get fallback() {
+				return _tmpl$2();
+			},
+			children: (status) => [
+				createComponent(Show, {
+					get when() {
+						return status() === "complete";
+					},
+					get children() {
+						return createComponent(Check, {});
+					}
+				}),
+				createComponent(Show, {
+					get when() {
+						return status() === "active";
+					},
+					get children() {
+						return createComponent(LoaderCircle, { "class": "motion-safe:animate-spin" });
+					}
+				}),
+				createComponent(Show, {
+					get when() {
+						return status() === "pending";
+					},
+					get children() {
+						return createComponent(CircleDashed, {});
+					}
+				}),
+				createComponent(Show, {
+					get when() {
+						return status() === "failed";
+					},
+					get children() {
+						return createComponent(CircleAlert, {});
+					}
+				}),
+				createComponent(Show, {
+					get when() {
+						return status() === "skipped";
+					},
+					get children() {
+						return createComponent(CircleSlash, {});
+					}
+				})
+			]
+		}));
+		effect(() => className(_el$, cn("mt-0.5 grid size-4 shrink-0 place-items-center [&_svg]:size-3.5", {
+			"text-muted-foreground": props.status !== "active" && props.status !== "failed",
+			"text-info": props.status === "active",
+			"text-destructive": props.status === "failed"
+		})));
+		return _el$;
+	})();
+}
+function TaskItemRow(props) {
+	const [local, rest] = splitProps(props, [
+		"class",
+		"text",
+		"description",
+		"status",
+		"files",
+		"statusLabel"
+	]);
+	const [showAllFiles, setShowAllFiles] = createSignal(false);
+	const files = () => local.files ?? [];
+	const shownFiles = () => showAllFiles() ? files() : files().slice(0, VISIBLE_FILES);
+	const hiddenFiles = () => files().length - VISIBLE_FILES;
+	const text = () => bound(local.text, MAX_TEXT);
+	return (() => {
+		var _el$3 = _tmpl$4(), _el$4 = _el$3.firstChild, _el$5 = _el$4.firstChild;
+		spread(_el$3, mergeProps({
+			get ["data-status"]() {
+				return local.status;
+			},
+			get ["class"]() {
+				return cn("flex min-w-0 gap-2 rounded-md px-1.5 py-0.5", local.class);
+			}
+		}, rest), false, true);
+		insert(_el$3, createComponent(ItemMark, { get status() {
+			return local.status;
+		} }), _el$4);
+		insert(_el$5, text, null);
+		insert(_el$5, createComponent(Show, {
+			get when() {
+				return local.status;
+			},
+			children: (status) => (() => {
+				var _el$7 = _tmpl$5();
+				_el$7.firstChild;
+				insert(_el$7, () => local.statusLabel ?? TASK_ITEM_STATUS_LABELS[status()], null);
+				return _el$7;
+			})()
+		}), null);
+		insert(_el$4, createComponent(Show, {
+			get when() {
+				return local.description;
+			},
+			children: (description) => (() => {
+				var _el$9 = _tmpl$6();
+				insert(_el$9, () => bound(description(), MAX_TEXT));
+				return _el$9;
+			})()
+		}), null);
+		insert(_el$4, createComponent(Show, {
+			get when() {
+				return files().length > 0;
+			},
+			get children() {
+				return createComponent(AttachmentList, {
+					"aria-label": "Files",
+					"class": "gap-1",
+					get children() {
+						return [createComponent(For, {
+							get each() {
+								return shownFiles();
+							},
+							children: (file) => (() => {
+								var _el$0 = _tmpl$7();
+								insert(_el$0, createComponent(Attachment, {
+									variant: "chip",
+									get name() {
+										return file.name;
+									},
+									get kind() {
+										return file.kind;
+									},
+									get size() {
+										return file.size;
+									}
+								}));
+								return _el$0;
+							})()
+						}), createComponent(Show, {
+							get when() {
+								return hiddenFiles() > 0;
+							},
+							get children() {
+								var _el$6 = _tmpl$3();
+								insert(_el$6, createComponent(Button, {
+									type: "button",
+									variant: "ghost",
+									size: "2xs",
+									get ["aria-expanded"]() {
+										return showAllFiles();
+									},
+									onClick: () => setShowAllFiles((value) => !value),
+									get children() {
+										return memo(() => !!showAllFiles())() ? "Show fewer files" : `Show ${hiddenFiles()} more files`;
+									}
+								}));
+								return _el$6;
+							}
+						})];
+					}
+				});
+			}
+		}), null);
+		effect((_p$) => {
+			var _v$ = text(), _v$2 = cn("m-0 line-clamp-3 text-sm [overflow-wrap:anywhere] whitespace-pre-wrap text-foreground", {
+				"text-muted-foreground": local.status === "complete" || local.status === "skipped",
+				"text-destructive": local.status === "failed"
+			});
+			_v$ !== _p$.e && setAttribute(_el$5, "title", _p$.e = _v$);
+			_v$2 !== _p$.t && className(_el$5, _p$.t = _v$2);
+			return _p$;
+		}, {
+			e: void 0,
+			t: void 0
+		});
+		return _el$3;
+	})();
+}
+/**
+* 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.
+*/
+function TaskItemList(props) {
+	const [local, rest] = splitProps(props, [
+		"class",
+		"label",
+		"children"
+	]);
+	return createComponent(ScrollArea, mergeProps({
+		role: "region",
+		get ["aria-label"]() {
+			return local.label;
+		},
+		get ["class"]() {
+			return cn("max-h-72", local.class);
+		}
+	}, rest, { get children() {
+		var _el$1 = _tmpl$8();
+		insert(_el$1, () => local.children);
+		return _el$1;
+	} }));
+}
+function Task(props) {
+	const [local, rest] = splitProps(props, [
+		"items",
+		"itemsLabel",
+		"icon",
+		"meta",
+		"title"
+	]);
+	const progress = createMemo(() => taskProgress(local.items));
+	const derivedMeta = () => {
+		const value = progress();
+		return value ? taskProgressLabel(value) : void 0;
+	};
+	const label = () => local.itemsLabel ?? (typeof local.title === "string" ? `${local.title} items` : "Task items");
+	const list = () => createComponent(TaskItemList, {
+		get label() {
+			return label();
+		},
+		get children() {
+			return createComponent(Index, {
+				get each() {
+					return local.items;
+				},
+				children: (item) => createComponent(TaskItemRow, {
+					get text() {
+						return item().text;
+					},
+					get description() {
+						return item().description;
+					},
+					get status() {
+						return item().status;
+					},
+					get files() {
+						return item().files;
+					}
+				})
+			});
+		}
+	});
+	return createComponent(TraceLine, mergeProps({
+		get icon() {
+			return local.icon ?? createComponent(ListChecks, {});
+		},
+		get title() {
+			return local.title;
+		},
+		get meta() {
+			return local.meta ?? derivedMeta();
+		}
+	}, rest, { get children() {
+		return memo(() => local.items.length > 0)() ? deferred(list) : void 0;
+	} }));
+}
+//#endregion
+export { TASK_ITEM_STATUS_LABELS, Task, TaskItemList, TaskItemRow, taskProgress, taskProgressLabel };
+
+//# sourceMappingURL=task.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","names":["Check","CircleAlert","CircleDashed","CircleSlash","ListChecks","LoaderCircle","createMemo","createSignal","For","Index","Show","splitProps","ComponentProps","JSX","cn","Attachment","AttachmentList","AttachmentKind","Button","ScrollArea","TraceLine","TraceLineProps","deferred","render","Element","TaskItemStatus","TaskFile","Readonly","name","kind","size","TaskItem","id","text","description","status","files","TASK_ITEM_STATUS_LABELS","Record","complete","active","pending","failed","skipped","VISIBLE_FILES","MAX_TEXT","bound","max","length","slice","taskProgress","items","Pick","done","total","some","item","undefined","filter","taskProgressLabel","progress","ItemMark","props","_el$","_tmpl$","_$insert","_$createComponent","when","fallback","_tmpl$2","children","_$effect","_$className","TaskItemRowProps","Omit","statusLabel","TaskItemRow","local","rest","showAllFiles","setShowAllFiles","shownFiles","hiddenFiles","_el$3","_tmpl$4","_el$4","firstChild","_el$5","_$spread","_$mergeProps","data-status","class","_el$7","_tmpl$5","_el$8","_el$9","_tmpl$6","each","file","_el$0","_tmpl$7","variant","_el$6","_tmpl$3","type","aria-expanded","onClick","value","_$memo","_p$","_v$","_v$2","e","_$setAttribute","t","TaskItemListProps","label","TaskItemList","role","aria-label","_el$1","_tmpl$8","TaskProps","itemsLabel","Task","derivedMeta","title","list","icon","meta","_$createComponent","_$className","_$mergeProps","_$memo","_$setAttribute"],"sources":["../../../../src/components/composites/task/task.tsx"],"sourcesContent":["import {\n  Check,\n  CircleAlert,\n  CircleDashed,\n  CircleSlash,\n  ListChecks,\n  LoaderCircle,\n} from 'lucide-solid'\nimport {\n  createMemo,\n  createSignal,\n  For,\n  Index,\n  Show,\n  splitProps,\n  type ComponentProps,\n  type JSX,\n} from 'solid-js'\nimport { cn } from '#lib/utils'\nimport { Attachment, AttachmentList, type AttachmentKind } from '../../ui/attachment'\nimport { Button } from '../../ui/button'\nimport { ScrollArea } from '../../ui/scroll-area'\nimport { TraceLine, type TraceLineProps } from '../../ui/trace'\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 * Task.\n *\n * One piece of work the agent is doing, as a `TraceLine` that opens onto its\n * items: a title, then a list in which each item is a sentence, optionally a\n * status, and optionally the files it touched. Reach for `Plan` when the list is\n * a proposal the person approves, for `Queue` when it is the agent's running\n * todo list, and for a `Trace` of tool calls when the items are things that\n * *ran* — a Task item is a statement about work, not a record of a call.\n *\n * ## Items wrap; lines do not\n *\n * A `TraceLine` truncates its title to one row, which is right for \"Read\n * src/app.tsx\" and wrong for \"Backfill locale from profile.language, falling\n * back to en\". Items are therefore their own rows with the same mark and colour\n * vocabulary as a Trace line but wrapping text, clamped to three lines so a\n * pasted paragraph cannot take the column. `TaskItemRow` and `TaskItemList` are\n * exported because `Plan` and `Queue` are built from them.\n *\n * ## Status is a claim\n *\n * An item shows a mark and speaks a word only when the host supplied `status`.\n * The \"2 of 4 done\" in the header is derived from those statuses and appears\n * only if at least one item has one; items without a status are counted in the\n * total and not in \"done\" (see `taskProgress`). A task with no items is a plain\n * line: there is nothing to open, and an empty disclosure is a control that\n * does nothing.\n *\n * ## Files are untrusted metadata\n *\n * File chips are `Attachment` chips with no handlers, so they are text: a name\n * is never a link or a path. Past six, the rest sit behind one toggle button\n * whose label changes in place, so keyboard focus survives opening and closing\n * it.\n */\nexport type TaskItemStatus = 'complete' | 'active' | 'pending' | 'failed' | 'skipped'\n\nexport type TaskFile = Readonly<{\n  name: string\n  kind?: AttachmentKind\n  /** Bytes. */\n  size?: number\n}>\n\nexport type TaskItem = Readonly<{\n  /** Only needed for the host's own bookkeeping; rows are kept by position. */\n  id?: string\n  text: string\n  description?: string\n  status?: TaskItemStatus\n  files?: readonly TaskFile[]\n}>\n\n/** The words spoken for each item status. */\nexport const TASK_ITEM_STATUS_LABELS: Readonly<Record<TaskItemStatus, string>> = {\n  complete: 'Completed',\n  active: 'In progress',\n  pending: 'Pending',\n  failed: 'Failed',\n  skipped: 'Skipped',\n}\n\n/** Visible files per item before the rest go behind a toggle. */\nconst VISIBLE_FILES = 6\n/** Characters of item text kept; the rest of a pasted wall is not a todo. */\nconst MAX_TEXT = 1_000\n\nfunction bound(text: string, max: number): string {\n  return text.length > max ? `${text.slice(0, max)}…` : text\n}\n\n/**\n * How many items are done, or nothing at all when no item carries a status.\n * Items without a status count toward the total: the host did not say they were\n * finished, so they are not.\n */\nexport function taskProgress(\n  items: readonly Pick<TaskItem, 'status'>[]\n): Readonly<{ done: number; total: number }> | undefined {\n  if (!items.some((item) => item.status !== undefined)) return undefined\n  return {\n    done: items.filter((item) => item.status === 'complete').length,\n    total: items.length,\n  }\n}\n\n/** `2 of 4 done`, in words. */\nexport function taskProgressLabel(progress: { done: number; total: number }): string {\n  return `${progress.done} of ${progress.total} done`\n}\n\nfunction ItemMark(props: { status?: TaskItemStatus }) {\n  return (\n    <span\n      aria-hidden=\"true\"\n      data-slot=\"task-item-mark\"\n      class={cn('mt-0.5 grid size-4 shrink-0 place-items-center [&_svg]:size-3.5', {\n        'text-muted-foreground': props.status !== 'active' && props.status !== 'failed',\n        'text-info': props.status === 'active',\n        'text-destructive': props.status === 'failed',\n      })}\n    >\n      <Show\n        when={props.status}\n        fallback={<span class=\"size-1 rounded-full bg-muted-foreground/60\" />}\n      >\n        {(status) => (\n          <>\n            <Show when={status() === 'complete'}>\n              <Check />\n            </Show>\n            <Show when={status() === 'active'}>\n              <LoaderCircle class=\"motion-safe:animate-spin\" />\n            </Show>\n            <Show when={status() === 'pending'}>\n              <CircleDashed />\n            </Show>\n            <Show when={status() === 'failed'}>\n              <CircleAlert />\n            </Show>\n            <Show when={status() === 'skipped'}>\n              <CircleSlash />\n            </Show>\n          </>\n        )}\n      </Show>\n    </span>\n  )\n}\n\nexport type TaskItemRowProps = Omit<ComponentProps<'li'>, 'children'> & {\n  text: string\n  description?: string\n  status?: TaskItemStatus\n  files?: readonly TaskFile[]\n  /** Spoken in place of the default status word. */\n  statusLabel?: string\n}\n\nexport function TaskItemRow(props: TaskItemRowProps) {\n  const [local, rest] = splitProps(props, [\n    'class',\n    'text',\n    'description',\n    'status',\n    'files',\n    'statusLabel',\n  ])\n  const [showAllFiles, setShowAllFiles] = createSignal(false)\n  const files = () => local.files ?? []\n  const shownFiles = () => (showAllFiles() ? files() : files().slice(0, VISIBLE_FILES))\n  const hiddenFiles = () => files().length - VISIBLE_FILES\n  const text = () => bound(local.text, MAX_TEXT)\n\n  return (\n    <li\n      data-slot=\"task-item\"\n      data-status={local.status}\n      class={cn('flex min-w-0 gap-2 rounded-md px-1.5 py-0.5', local.class)}\n      {...rest}\n    >\n      <ItemMark status={local.status} />\n      <div class=\"flex min-w-0 flex-1 flex-col gap-1\">\n        <p\n          title={text()}\n          class={cn(\n            'm-0 line-clamp-3 text-sm [overflow-wrap:anywhere] whitespace-pre-wrap text-foreground',\n            {\n              'text-muted-foreground': local.status === 'complete' || local.status === 'skipped',\n              'text-destructive': local.status === 'failed',\n            }\n          )}\n        >\n          {text()}\n          <Show when={local.status}>\n            {(status) => (\n              <span class=\"sr-only\"> {local.statusLabel ?? TASK_ITEM_STATUS_LABELS[status()]}</span>\n            )}\n          </Show>\n        </p>\n        <Show when={local.description}>\n          {(description) => (\n            <p class=\"m-0 line-clamp-3 text-xs [overflow-wrap:anywhere] text-muted-foreground/80\">\n              {bound(description(), MAX_TEXT)}\n            </p>\n          )}\n        </Show>\n        <Show when={files().length > 0}>\n          <AttachmentList aria-label=\"Files\" class=\"gap-1\">\n            <For each={shownFiles()}>\n              {(file) => (\n                <li class=\"min-w-0 max-w-full\">\n                  <Attachment variant=\"chip\" name={file.name} kind={file.kind} size={file.size} />\n                </li>\n              )}\n            </For>\n            <Show when={hiddenFiles() > 0}>\n              <li class=\"flex items-center\">\n                <Button\n                  type=\"button\"\n                  variant=\"ghost\"\n                  size=\"2xs\"\n                  aria-expanded={showAllFiles()}\n                  onClick={() => setShowAllFiles((value) => !value)}\n                >\n                  {showAllFiles() ? 'Show fewer files' : `Show ${hiddenFiles()} more files`}\n                </Button>\n              </li>\n            </Show>\n          </AttachmentList>\n        </Show>\n      </div>\n    </li>\n  )\n}\n\nexport type TaskItemListProps = Omit<ComponentProps<'div'>, 'children'> & {\n  /** The list's accessible name. A scrolling region without one is an unlabelled tab stop. */\n  label: string\n  children?: JSX.Element\n}\n\n/**\n * The items, bounded. Two hundred todo items must scroll inside their line and\n * not push the answer out of view; the region is keyboard-focusable and named,\n * which is what makes the overflow reachable without a pointer.\n */\nexport function TaskItemList(props: TaskItemListProps) {\n  const [local, rest] = splitProps(props, ['class', 'label', 'children'])\n  return (\n    <ScrollArea\n      role=\"region\"\n      aria-label={local.label}\n      class={cn('max-h-72', local.class)}\n      {...rest}\n    >\n      <ul role=\"list\" class=\"m-0 flex list-none flex-col gap-0.5 p-0\">\n        {local.children}\n      </ul>\n    </ScrollArea>\n  )\n}\n\nexport type TaskProps = Omit<\n  TraceLineProps,\n  'description' | 'href' | 'onSelect' | 'selectHaspopup' | 'children'\n> & {\n  items: readonly TaskItem[]\n  /** The item list's accessible name. Defaults to the title when it is a string. */\n  itemsLabel?: string\n}\n\nexport function Task(props: TaskProps) {\n  const [local, rest] = splitProps(props, ['items', 'itemsLabel', 'icon', 'meta', 'title'])\n  const progress = createMemo(() => taskProgress(local.items))\n  const derivedMeta = () => {\n    const value = progress()\n    return value ? taskProgressLabel(value) : undefined\n  }\n  const label = () =>\n    local.itemsLabel ?? (typeof local.title === 'string' ? `${local.title} items` : 'Task items')\n\n  // A function child is only run when the content mounts, so a collapsed task\n  // with hundreds of items renders none of them.\n  const list = () => (\n    <TaskItemList label={label()}>\n      <Index each={local.items}>\n        {(item) => (\n          <TaskItemRow\n            text={item().text}\n            description={item().description}\n            status={item().status}\n            files={item().files}\n          />\n        )}\n      </Index>\n    </TaskItemList>\n  )\n\n  return (\n    <TraceLine\n      icon={local.icon ?? <ListChecks />}\n      title={local.title}\n      meta={local.meta ?? derivedMeta()}\n      {...rest}\n    >\n      {local.items.length > 0 ? deferred(list) : undefined}\n    </TraceLine>\n  )\n}\n"],"mappings":"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"}

package/dist/components/composites/terminal/ansi.d.ts

@@ -0,0 +1,101 @@
+/**
+ * A terminal's text, read safely.
+ *
+ * Command output is untrusted bytes, not text: it carries colour for the human
+ * who ran the command, cursor control for a screen that is not here, and — from
+ * a hostile program — sequences that ask a terminal emulator to rewrite its
+ * title, write to the clipboard (OSC 52) or hide what it printed. This parser
+ * accepts exactly the part a transcript can honour and drops the rest:
+ *
+ * - **Kept:** printable text, `\n`, `\r` (the cursor returns to column 0 and
+ *   later text overwrites, which is how a progress bar redraws itself), `\b`
+ *   (the cursor steps back one column), tab, `ESC[…K` (erase in line, which
+ *   progress bars pair with `\r`), and SGR `ESC[…m` for the sixteen theme
+ *   colours, bold, dim, italic, underline, strike-through and reverse video.
+ * - **Mapped:** 256-colour and truecolour SGR become the nearest of the sixteen,
+ *   so the output keeps the theme's palette and its contrast guarantees instead
+ *   of a program's idea of "dark blue" on a light terminal.
+ * - **Dropped, never echoed:** every other CSI (cursor movement, scrolling,
+ *   private modes), OSC, DCS/SOS/PM/APC strings, charset designations, the 8-bit
+ *   C1 forms of all of these, every other control character, and the Unicode
+ *   bidirectional overrides that make text read differently from how it is
+ *   stored. A malformed or truncated sequence is dropped with its payload, so a
+ *   half-received `ESC[3` never shows up as the text "3".
+ *
+ * Nothing here produces markup. The result is plain strings with a style object,
+ * and the renderer decides what a style looks like.
+ *
+ * ## Why a stateful parser
+ *
+ * Output arrives in chunks that split anywhere — inside an escape sequence, in
+ * the middle of a line. `createAnsiParser` keeps the half-read sequence, the
+ * current style and the line being written between `write` calls, so a chunk
+ * boundary changes nothing about the result. Finished lines are immutable and
+ * never touched again, which is what lets a renderer keep their DOM while the
+ * last line keeps growing. `parseAnsi` is the same thing run once.
+ */
+/** An index into the sixteen-colour palette: 0–7 normal, 8–15 bright. */
+export type AnsiColor = number;
+export type AnsiStyle = Readonly<{
+    fg?: AnsiColor;
+    bg?: AnsiColor;
+    bold?: true;
+    dim?: true;
+    italic?: true;
+    underline?: true;
+    strike?: true;
+    inverse?: true;
+}>;
+export type AnsiSegment = Readonly<{
+    text: string;
+    style: AnsiStyle;
+}>;
+export type AnsiLine = Readonly<{
+    segments: readonly AnsiSegment[];
+    /** Characters past `maxLineLength` that were not kept. Zero for most lines. */
+    truncated: number;
+}>;
+export type AnsiParserOptions = {
+    /** Characters kept per line; the rest are counted in `truncated`. Default 10 000. */
+    maxLineLength?: number;
+    /**
+     * Finished lines kept. The oldest are discarded (and counted in `droppedLines`)
+     * past this, so a command that prints for an hour cannot grow the parser
+     * without bound. Default 200 000.
+     */
+    retainLines?: number;
+};
+export type AnsiParser = {
+    /** Feed the next chunk. Chunks may split anywhere, including inside an escape. */
+    write(chunk: string): void;
+    /** Finished lines, oldest first. The array is mutated in place as lines arrive. */
+    readonly lines: readonly AnsiLine[];
+    /** The line still being written, or `undefined` while it is empty. */
+    openLine(): AnsiLine | undefined;
+    /** Finished lines discarded because of `retainLines`. */
+    readonly droppedLines: number;
+};
+export declare const ANSI_MAX_LINE_LENGTH = 10000;
+export declare const ANSI_RETAIN_LINES = 200000;
+/** Whether a style paints nothing, so the renderer can emit a bare text node. */
+export declare function isPlainStyle(style: AnsiStyle): boolean;
+/**
+ * The colours a style actually paints. Reverse video swaps them; a swapped side
+ * with no colour of its own resolves to the terminal's default foreground or
+ * background (`'default-fg'`, `'default-bg'`), which are themselves theme tokens.
+ */
+export type ResolvedColors = Readonly<{
+    fg: AnsiColor | 'default-bg' | undefined;
+    bg: AnsiColor | 'default-fg' | undefined;
+}>;
+export declare function resolveColors(style: AnsiStyle): ResolvedColors;
+/** The palette index (0–15) nearest to an RGB colour. Channels are clamped to 0–255. */
+export declare function nearestAnsiColor(r: number, g: number, b: number): AnsiColor;
+/** Map a 256-colour index to the sixteen. Out-of-range indices give `undefined`. */
+export declare function ansi256ToColor(index: number): AnsiColor | undefined;
+export declare function createAnsiParser(options?: AnsiParserOptions): AnsiParser;
+/** Parse a whole output at once: finished lines plus the open one, if any. */
+export declare function parseAnsi(text: string, options?: AnsiParserOptions): AnsiLine[];
+/** A line's text with styling removed, for tests and for accessible names. */
+export declare function ansiLineText(line: AnsiLine): string;
+//# sourceMappingURL=ansi.d.ts.map

package/dist/components/composites/terminal/ansi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.d.ts","sourceRoot":"","sources":["../../../../src/components/composites/terminal/ansi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,yEAAyE;AACzE,MAAM,MAAM,SAAS,GAAG,MAAM,CAAA;AAE9B,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC;IAC/B,EAAE,CAAC,EAAE,SAAS,CAAA;IACd,EAAE,CAAC,EAAE,SAAS,CAAA;IACd,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,GAAG,CAAC,EAAE,IAAI,CAAA;IACV,MAAM,CAAC,EAAE,IAAI,CAAA;IACb,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,MAAM,CAAC,EAAE,IAAI,CAAA;IACb,OAAO,CAAC,EAAE,IAAI,CAAA;CACf,CAAC,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC,CAAA;AAEtE,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAC9B,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;IAChC,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAA;CAClB,CAAC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,kFAAkF;IAClF,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;IACnC,sEAAsE;IACtE,QAAQ,IAAI,QAAQ,GAAG,SAAS,CAAA;IAChC,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED,eAAO,MAAM,oBAAoB,QAAS,CAAA;AAC1C,eAAO,MAAM,iBAAiB,SAAU,CAAA;AAmDxC,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAWtD;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,EAAE,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAA;IACxC,EAAE,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAA;CACzC,CAAC,CAAA;AAEF,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,CAG9D;AA0BD,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAsB3E;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAanE;AA2RD,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAwJ5E;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,QAAQ,EAAE,CAK/E;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEnD"}