@adea-ai/ui 0.140.0 → 0.142.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","names":["CircleAlert","Info","TriangleAlert","Show","splitProps","ComponentProps","JSX","Dynamic","cn","cva","VariantProps","ChatProps","header","Element","notices","composer","Chat","props","local","rest","_el$","_tmpl$","_el$2","firstChild","_el$3","nextSibling","_el$4","_el$5","_$spread","_$mergeProps","class","_$insert","children","ChatHeaderProps","Omit","title","subtitle","status","actions","ChatHeader","_el$6","_tmpl$4","_el$7","_el$8","_$createComponent","when","_el$9","_tmpl$2","_el$0","_tmpl$3","chatNoticeVariants","variants","tone","info","warning","danger","defaultVariants","ChatNoticeProps","description","action","live","ChatNotice","Glyph","_el$1","_tmpl$7","_el$10","_el$11","_el$12","role","_$memo","undefined","component","_el$13","_tmpl$5","_el$14","_tmpl$6","_$effect","_$className","ChatEmptyProps","suggestions","ChatEmpty","_el$15","_tmpl$9","_el$16","_el$17","_el$18","_tmpl$8","_$mergeProps","_$createComponent","_$memo","_$className"],"sources":["../../../../src/components/composites/chat/chat.tsx"],"sourcesContent":["import { CircleAlert, Info, TriangleAlert } from 'lucide-solid'\nimport { Show, splitProps, type ComponentProps, type JSX } from 'solid-js'\nimport { Dynamic } from 'solid-js/web'\nimport { cn } from '#lib/utils'\nimport { cva, type VariantProps } from '#lib/variants'\n\n/**\n * Chat.\n *\n * The frame a conversation lives in: a header, a strip for things the reader\n * must know before reading anything else, the thread, and the composer. It is a\n * layout and nothing more — the thread is a `MessageScroller`, the input is a\n * composer, and what happens in between is the host's — which is why it takes\n * slots instead of data.\n *\n * ## Why notices have their own row\n *\n * \"The connection dropped\", \"this transcript has a gap\", \"this session is\n * read-only\" are about the whole conversation, not about a turn, and they must\n * not scroll away with the turns. They sit between the header and the thread in\n * their own grid track, so a notice appearing never steals the thread's row and\n * collapses to zero height when there are none. Each notice states its cause in\n * words and carries its own remedy (`action`); one that reports a *change*\n * (`live`) is announced, one that describes a standing condition is not.\n *\n * ## Layout\n *\n * `h-full min-h-0`, so the thread scrolls inside the frame rather than the page\n * growing, and a `min-w-0` track, so a long unbroken token in a turn cannot widen\n * the whole conversation. Nothing here sets a width: the reading column is the\n * turn's, and the composer sets its own measure.\n */\nexport type ChatProps = ComponentProps<'section'> & {\n  header?: JSX.Element\n  /** `ChatNotice`s. The row collapses when this is empty. */\n  notices?: JSX.Element\n  /** The composer. */\n  composer?: JSX.Element\n}\n\nexport function Chat(props: ChatProps) {\n  const [local, rest] = splitProps(props, ['class', 'header', 'notices', 'composer', 'children'])\n  return (\n    <section\n      data-slot=\"chat\"\n      class={cn(\n        'grid h-full min-h-0 min-w-0 grid-cols-[minmax(0,1fr)] grid-rows-[auto_auto_minmax(0,1fr)_auto] bg-background text-foreground',\n        local.class\n      )}\n      {...rest}\n    >\n      <div class=\"row-start-1 min-w-0\">{local.header}</div>\n      <div class=\"row-start-2 flex min-w-0 flex-col\">{local.notices}</div>\n      <div class=\"row-start-3 flex min-h-0 min-w-0 flex-col\">{local.children}</div>\n      <div class=\"row-start-4 min-w-0\">{local.composer}</div>\n    </section>\n  )\n}\n\nexport type ChatHeaderProps = Omit<ComponentProps<'header'>, 'title'> & {\n  title: JSX.Element\n  /** One line under the title: identity, scope, generation. */\n  subtitle?: JSX.Element\n  /** The conversation's state in words (a `StatusChip`). */\n  status?: JSX.Element\n  /** Host actions: rename, archive, hand off. */\n  actions?: JSX.Element\n}\n\nexport function ChatHeader(props: ChatHeaderProps) {\n  const [local, rest] = splitProps(props, ['class', 'title', 'subtitle', 'status', 'actions'])\n  return (\n    <header\n      data-slot=\"chat-header\"\n      class={cn(\n        'flex min-h-topbar min-w-0 items-center gap-3 border-b border-border px-4 py-2',\n        local.class\n      )}\n      {...rest}\n    >\n      <div class=\"flex min-w-0 flex-1 flex-col\">\n        <h2 class=\"m-0 truncate text-sm font-semibold tracking-tight\">{local.title}</h2>\n        <Show when={local.subtitle}>\n          <p class=\"m-0 truncate text-xs text-muted-foreground\">{local.subtitle}</p>\n        </Show>\n      </div>\n      <Show when={local.status}>{local.status}</Show>\n      <Show when={local.actions}>\n        <div class=\"flex shrink-0 items-center gap-1\">{local.actions}</div>\n      </Show>\n    </header>\n  )\n}\n\nexport const chatNoticeVariants = cva(\n  'flex min-w-0 items-start gap-2.5 border-b px-4 py-2 text-sm',\n  {\n    variants: {\n      tone: {\n        info: 'border-border bg-muted/40',\n        warning: 'border-warning/30 bg-warning-subtle',\n        danger: 'border-destructive/30 bg-destructive-subtle',\n      },\n    },\n    defaultVariants: { tone: 'info' },\n  }\n)\n\nexport type ChatNoticeProps = Omit<ComponentProps<'div'>, 'title'> &\n  VariantProps<typeof chatNoticeVariants> & {\n    title: JSX.Element\n    description?: JSX.Element\n    /** The remedy: Reconnect, Jump to terminal. */\n    action?: JSX.Element\n    /** Announce it. Use for a change (connection lost), not a standing condition. */\n    live?: 'polite' | 'assertive'\n  }\n\nexport function ChatNotice(props: ChatNoticeProps) {\n  const [local, rest] = splitProps(props, [\n    'class',\n    'tone',\n    'title',\n    'description',\n    'action',\n    'live',\n  ])\n  const Glyph = () =>\n    local.tone === 'danger' ? CircleAlert : local.tone === 'warning' ? TriangleAlert : Info\n  return (\n    <div\n      data-slot=\"chat-notice\"\n      role={local.live === 'assertive' ? 'alert' : local.live === 'polite' ? 'status' : undefined}\n      class={cn(chatNoticeVariants({ tone: local.tone }), local.class)}\n      {...rest}\n    >\n      <span\n        aria-hidden=\"true\"\n        class={cn('mt-0.5 shrink-0 [&_svg]:size-4', {\n          'text-muted-foreground': (local.tone ?? 'info') === 'info',\n          'text-warning': local.tone === 'warning',\n          'text-destructive': local.tone === 'danger',\n        })}\n      >\n        <Dynamic component={Glyph()} />\n      </span>\n      <div class=\"min-w-0 flex-1\">\n        <p class=\"m-0 font-medium [overflow-wrap:anywhere]\">{local.title}</p>\n        <Show when={local.description}>\n          <p class=\"m-0 text-xs text-muted-foreground [overflow-wrap:anywhere]\">\n            {local.description}\n          </p>\n        </Show>\n      </div>\n      <Show when={local.action}>\n        <div class=\"flex shrink-0 items-center gap-1.5\">{local.action}</div>\n      </Show>\n    </div>\n  )\n}\n\nexport type ChatEmptyProps = Omit<ComponentProps<'div'>, 'title'> & {\n  title: JSX.Element\n  description?: JSX.Element\n  /** Prompt chips (`Suggestions`), shown only when the host has real ones. */\n  suggestions?: JSX.Element\n}\n\n/** A conversation with no turns yet. Centred in the thread, never in a card. */\nexport function ChatEmpty(props: ChatEmptyProps) {\n  const [local, rest] = splitProps(props, ['class', 'title', 'description', 'suggestions'])\n  return (\n    <div\n      data-slot=\"chat-empty\"\n      class={cn(\n        'mx-auto flex min-h-full w-full max-w-xl flex-col items-center justify-center gap-4 px-6 py-10 text-center',\n        local.class\n      )}\n      {...rest}\n    >\n      <div class=\"flex flex-col gap-1\">\n        <h3 class=\"m-0 text-base font-semibold tracking-tight text-balance\">{local.title}</h3>\n        <Show when={local.description}>\n          <p class=\"m-0 text-sm text-muted-foreground text-balance\">{local.description}</p>\n        </Show>\n      </div>\n      <Show when={local.suggestions}>{local.suggestions}</Show>\n    </div>\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;;AAwCA,SAAgBgB,KAAKC,OAAkB;CACrC,MAAM,CAACC,OAAOC,QAAQf,WAAWa,OAAO;EAAC;EAAS;EAAU;EAAW;EAAY;CAAU,CAAC;CAC9F,cAAA;EAAA,IAAAG,OAAAC,OAAA,GAAAC,QAAAF,KAAAG,YAAAC,QAAAF,MAAAG,aAAAC,QAAAF,MAAAC,aAAAE,QAAAD,MAAAD;EAAAG,OAAAR,MAAAS,WAAA,EAAA,KAAA,WAAA;GAAA,OAGWrB,GACL,gIACAU,MAAMY,KACR;EAAC,EAAA,GACGX,IAAI,GAAA,OAAA,IAAA;EAAAY,OAAAT,aAE0BJ,MAAMN,MAAM;EAAAmB,OAAAP,aACEN,MAAMJ,OAAO;EAAAiB,OAAAL,aACLR,MAAMc,QAAQ;EAAAD,OAAAJ,aACpCT,MAAMH,QAAQ;EAAA,OAAAK;CAAA,EAAA,CAAA;AAGtD;AAYA,SAAgBmB,WAAWtB,OAAwB;CACjD,MAAM,CAACC,OAAOC,QAAQf,WAAWa,OAAO;EAAC;EAAS;EAAS;EAAY;EAAU;CAAS,CAAC;CAC3F,cAAA;EAAA,IAAAuB,QAAAC,QAAA,GAAAC,QAAAF,MAAAjB,YAAAoB,QAAAD,MAAAnB;EAAAK,OAAAY,OAAAX,WAAA,EAAA,KAAA,WAAA;GAAA,OAGWrB,GACL,iFACAU,MAAMY,KACR;EAAC,EAAA,GACGX,IAAI,GAAA,OAAA,IAAA;EAAAY,OAAAY,aAGyDzB,MAAMiB,KAAK;EAAAJ,OAAAW,OAAAE,gBACzEzC,MAAI;GAAA,IAAC0C,OAAI;IAAA,OAAE3B,MAAMkB;GAAQ;GAAA,IAAAJ,WAAA;IAAA,IAAAc,QAAAC,QAAA;IAAAhB,OAAAe,aAC+B5B,MAAMkB,QAAQ;IAAA,OAAAU;GAAA;EAAA,CAAA,GAAA,IAAA;EAAAf,OAAAS,OAAAI,gBAGxEzC,MAAI;GAAA,IAAC0C,OAAI;IAAA,OAAE3B,MAAMmB;GAAM;GAAA,IAAAL,WAAA;IAAA,OAAGd,MAAMmB;GAAM;EAAA,CAAA,GAAA,IAAA;EAAAN,OAAAS,OAAAI,gBACtCzC,MAAI;GAAA,IAAC0C,OAAI;IAAA,OAAE3B,MAAMoB;GAAO;GAAA,IAAAN,WAAA;IAAA,IAAAgB,QAAAC,QAAA;IAAAlB,OAAAiB,aACwB9B,MAAMoB,OAAO;IAAA,OAAAU;GAAA;EAAA,CAAA,GAAA,IAAA;EAAA,OAAAR;CAAA,EAAA,CAAA;AAIpE;AAEA,IAAaU,qBAAqBzC,IAChC,+DACA;CACE0C,UAAU,EACRC,MAAM;EACJC,MAAM;EACNC,SAAS;EACTC,QAAQ;CACV,EACF;CACAC,iBAAiB,EAAEJ,MAAM,OAAO;AAClC,CACF;AAYA,SAAgBS,WAAW5C,OAAwB;CACjD,MAAM,CAACC,OAAOC,QAAQf,WAAWa,OAAO;EACtC;EACA;EACA;EACA;EACA;EACA;CAAM,CACP;CACD,MAAM6C,cACJ5C,MAAMkC,SAAS,WAAWpD,cAAckB,MAAMkC,SAAS,YAAYlD,gBAAgBD;CACrF,cAAA;EAAA,IAAA8D,QAAAC,QAAA,GAAAC,SAAAF,MAAAxC,YAAA2C,SAAAD,OAAAxC,aAAA0C,SAAAD,OAAA3C;EAAAK,OAAAmC,OAAAlC,WAAA;GAAA,IAGIuC,OAAI;IAAA,OAAEC,WAAAnD,MAAM0C,SAAS,WAAW,CAAA,CAAA,IAAG,UAAU1C,MAAM0C,SAAS,WAAW,WAAWU,KAAAA;GAAS;GAAA,KAAA,WAAA;IAAA,OACpF9D,GAAG0C,mBAAmB,EAAEE,MAAMlC,MAAMkC,KAAK,CAAC,GAAGlC,MAAMY,KAAK;GAAC;EAAA,GAC5DX,IAAI,GAAA,OAAA,IAAA;EAAAY,OAAAkC,QAAArB,gBAULrC,SAAO,EAAA,IAACgE,YAAS;GAAA,OAAET,MAAM;EAAC,EAAA,CAAA,CAAA;EAAA/B,OAAAoC,cAG0BjD,MAAMiB,KAAK;EAAAJ,OAAAmC,QAAAtB,gBAC/DzC,MAAI;GAAA,IAAC0C,OAAI;IAAA,OAAE3B,MAAMwC;GAAW;GAAA,IAAA1B,WAAA;IAAA,IAAAwC,SAAAC,QAAA;IAAA1C,OAAAyC,cAExBtD,MAAMwC,WAAW;IAAA,OAAAc;GAAA;EAAA,CAAA,GAAA,IAAA;EAAAzC,OAAAgC,OAAAnB,gBAIvBzC,MAAI;GAAA,IAAC0C,OAAI;IAAA,OAAE3B,MAAMyC;GAAM;GAAA,IAAA3B,WAAA;IAAA,IAAA0C,SAAAC,QAAA;IAAA5C,OAAA2C,cAC2BxD,MAAMyC,MAAM;IAAA,OAAAe;GAAA;EAAA,CAAA,GAAA,IAAA;EAAAE,aAAAC,UAAAZ,QAjBtDzD,GAAG,kCAAkC;GAC1C,0BAA0BU,MAAMkC,QAAQ,YAAY;GACpD,gBAAgBlC,MAAMkC,SAAS;GAC/B,oBAAoBlC,MAAMkC,SAAS;EACrC,CAAC,CAAC,CAAA;EAAA,OAAAW;CAAA,EAAA,CAAA;AAiBV;;AAUA,SAAgBiB,UAAU/D,OAAuB;CAC/C,MAAM,CAACC,OAAOC,QAAQf,WAAWa,OAAO;EAAC;EAAS;EAAS;EAAe;CAAa,CAAC;CACxF,cAAA;EAAA,IAAAgE,SAAAC,QAAA,GAAAC,SAAAF,OAAA1D,YAAA6D,SAAAD,OAAA5D;EAAAK,OAAAqD,QAAApD,WAAA,EAAA,KAAA,WAAA;GAAA,OAGWrB,GACL,6GACAU,MAAMY,KACR;EAAC,EAAA,GACGX,IAAI,GAAA,OAAA,IAAA;EAAAY,OAAAqD,cAG+DlE,MAAMiB,KAAK;EAAAJ,OAAAoD,QAAAvC,gBAC/EzC,MAAI;GAAA,IAAC0C,OAAI;IAAA,OAAE3B,MAAMwC;GAAW;GAAA,IAAA1B,WAAA;IAAA,IAAAqD,SAAAC,QAAA;IAAAvD,OAAAsD,cACgCnE,MAAMwC,WAAW;IAAA,OAAA2B;GAAA;EAAA,CAAA,GAAA,IAAA;EAAAtD,OAAAkD,QAAArC,gBAG/EzC,MAAI;GAAA,IAAC0C,OAAI;IAAA,OAAE3B,MAAM6D;GAAW;GAAA,IAAA/C,WAAA;IAAA,OAAGd,MAAM6D;GAAW;EAAA,CAAA,GAAA,IAAA;EAAA,OAAAE;CAAA,EAAA,CAAA;AAGvD"}

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

@@ -0,0 +1,2 @@
+export { Chat, ChatEmpty, ChatHeader, ChatNotice, chatNoticeVariants, type ChatEmptyProps, type ChatHeaderProps, type ChatNoticeProps, type ChatProps, } from './chat';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/composites/chat/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,SAAS,EACT,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,SAAS,GACf,MAAM,QAAQ,CAAA"}

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

@@ -0,0 +1,2 @@
+import { Chat, ChatEmpty, ChatHeader, ChatNotice, chatNoticeVariants } from "./chat.js";
+export { Chat, ChatEmpty, ChatHeader, ChatNotice, chatNoticeVariants };

package/dist/components/composites/checkpoint/checkpoint-model.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Where a restore stands. `idle` is the resting state of a checkpoint that has
+ * not been restored from; the other three are only ever set because something
+ * happened — the host passes them, or the component sets them from the promise
+ * `onRestore` returned.
+ */
+export type CheckpointState = 'idle' | 'restoring' | 'restored' | 'failed';
+/** The checkpoint's name as drawn; a blank label is the honest generic word. */
+export declare function checkpointLabel(label: string | undefined): string;
+/**
+ * The sentence for the status region. `idle` says nothing, because a
+ * checkpoint that has not been touched makes no statement. A failure carries the
+ * host's text when there is one.
+ */
+export declare function checkpointStatus(state: CheckpointState, error?: string, disabledReason?: string): string | undefined;
+/**
+ * The confirmation dialog's words. The host's `consequence` is what actually
+ * names what will change, so it is used verbatim (bounded); without one the dialog
+ * says only what a restore always means and does not guess at the rest.
+ */
+export declare function restoreDialogCopy(label: string | undefined, consequence: string | undefined): {
+    title: string;
+    description: string;
+};
+/**
+ * Whether the Restore control exists, and whether it can be used. It exists only
+ * when the host passed a handler — a checkpoint that cannot be restored must not
+ * look as if it can — and goes once the restore has succeeded.
+ */
+export declare function restoreControl(hasHandler: boolean, state: CheckpointState, disabledReason: string | undefined): {
+    visible: boolean;
+    disabled: boolean;
+};
+//# sourceMappingURL=checkpoint-model.d.ts.map

package/dist/components/composites/checkpoint/checkpoint-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-model.d.ts","sourceRoot":"","sources":["../../../../src/components/composites/checkpoint/checkpoint-model.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAA;AAE1E,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,KAAK,CAAC,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,GAAG,SAAS,CAapB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAOxC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,OAAO,EACnB,KAAK,EAAE,eAAe,EACtB,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAKzC"}

package/dist/components/composites/checkpoint/checkpoint-model.js

@@ -0,0 +1,48 @@
+import { boundText } from "../sources/source.js";
+//#region src/components/composites/checkpoint/checkpoint-model.ts
+/** The checkpoint's name as drawn; a blank label is the honest generic word. */
+function checkpointLabel(label) {
+	return (label ? boundText(label, 80) : "") || "Checkpoint";
+}
+/**
+* The sentence for the status region. `idle` says nothing, because a
+* checkpoint that has not been touched makes no statement. A failure carries the
+* host's text when there is one.
+*/
+function checkpointStatus(state, error, disabledReason) {
+	switch (state) {
+		case "restoring": return "Restoring…";
+		case "restored": return "Restored";
+		case "failed": {
+			const detail = error ? boundText(error, 240) : "";
+			return detail ? `Restore failed: ${detail}` : "Restore failed";
+		}
+		case "idle": return disabledReason ? boundText(disabledReason, 240) : void 0;
+	}
+}
+/**
+* The confirmation dialog's words. The host's `consequence` is what actually
+* names what will change, so it is used verbatim (bounded); without one the dialog
+* says only what a restore always means and does not guess at the rest.
+*/
+function restoreDialogCopy(label, consequence) {
+	return {
+		title: `Restore to “${checkpointLabel(label)}”?`,
+		description: consequence ? boundText(consequence, 400) : "Restoring returns to this checkpoint."
+	};
+}
+/**
+* Whether the Restore control exists, and whether it can be used. It exists only
+* when the host passed a handler — a checkpoint that cannot be restored must not
+* look as if it can — and goes once the restore has succeeded.
+*/
+function restoreControl(hasHandler, state, disabledReason) {
+	return {
+		visible: hasHandler && state !== "restored",
+		disabled: state === "restoring" || disabledReason !== void 0
+	};
+}
+//#endregion
+export { checkpointLabel, checkpointStatus, restoreControl, restoreDialogCopy };
+
+//# sourceMappingURL=checkpoint-model.js.map

package/dist/components/composites/checkpoint/checkpoint-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-model.js","names":[],"sources":["../../../../src/components/composites/checkpoint/checkpoint-model.ts"],"sourcesContent":["import { boundText } from '../sources/source'\n\n/**\n * Where a restore stands. `idle` is the resting state of a checkpoint that has\n * not been restored from; the other three are only ever set because something\n * happened — the host passes them, or the component sets them from the promise\n * `onRestore` returned.\n */\nexport type CheckpointState = 'idle' | 'restoring' | 'restored' | 'failed'\n\n/** The checkpoint's name as drawn; a blank label is the honest generic word. */\nexport function checkpointLabel(label: string | undefined): string {\n  return (label ? boundText(label, 80) : '') || 'Checkpoint'\n}\n\n/**\n * The sentence for the status region. `idle` says nothing, because a\n * checkpoint that has not been touched makes no statement. A failure carries the\n * host's text when there is one.\n */\nexport function checkpointStatus(\n  state: CheckpointState,\n  error?: string,\n  disabledReason?: string\n): string | undefined {\n  switch (state) {\n    case 'restoring':\n      return 'Restoring…'\n    case 'restored':\n      return 'Restored'\n    case 'failed': {\n      const detail = error ? boundText(error, 240) : ''\n      return detail ? `Restore failed: ${detail}` : 'Restore failed'\n    }\n    case 'idle':\n      return disabledReason ? boundText(disabledReason, 240) : undefined\n  }\n}\n\n/**\n * The confirmation dialog's words. The host's `consequence` is what actually\n * names what will change, so it is used verbatim (bounded); without one the dialog\n * says only what a restore always means and does not guess at the rest.\n */\nexport function restoreDialogCopy(\n  label: string | undefined,\n  consequence: string | undefined\n): { title: string; description: string } {\n  return {\n    title: `Restore to “${checkpointLabel(label)}”?`,\n    description: consequence\n      ? boundText(consequence, 400)\n      : 'Restoring returns to this checkpoint.',\n  }\n}\n\n/**\n * Whether the Restore control exists, and whether it can be used. It exists only\n * when the host passed a handler — a checkpoint that cannot be restored must not\n * look as if it can — and goes once the restore has succeeded.\n */\nexport function restoreControl(\n  hasHandler: boolean,\n  state: CheckpointState,\n  disabledReason: string | undefined\n): { visible: boolean; disabled: boolean } {\n  return {\n    visible: hasHandler && state !== 'restored',\n    disabled: state === 'restoring' || disabledReason !== undefined,\n  }\n}\n"],"mappings":";;;AAWA,SAAgB,gBAAgB,OAAmC;CACjE,QAAQ,QAAQ,UAAU,OAAO,EAAE,IAAI,OAAO;AAChD;;;;;;AAOA,SAAgB,iBACd,OACA,OACA,gBACoB;CACpB,QAAQ,OAAR;EACE,KAAK,aACH,OAAO;EACT,KAAK,YACH,OAAO;EACT,KAAK,UAAU;GACb,MAAM,SAAS,QAAQ,UAAU,OAAO,GAAG,IAAI;GAC/C,OAAO,SAAS,mBAAmB,WAAW;EAChD;EACA,KAAK,QACH,OAAO,iBAAiB,UAAU,gBAAgB,GAAG,IAAI,KAAA;CAC7D;AACF;;;;;;AAOA,SAAgB,kBACd,OACA,aACwC;CACxC,OAAO;EACL,OAAO,eAAe,gBAAgB,KAAK,EAAE;EAC7C,aAAa,cACT,UAAU,aAAa,GAAG,IAC1B;CACN;AACF;;;;;;AAOA,SAAgB,eACd,YACA,OACA,gBACyC;CACzC,OAAO;EACL,SAAS,cAAc,UAAU;EACjC,UAAU,UAAU,eAAe,mBAAmB,KAAA;CACxD;AACF"}

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

@@ -0,0 +1,48 @@
+import { type ComponentProps } from 'solid-js';
+import { type CheckpointState } from './checkpoint-model';
+/**
+ * Checkpoint.
+ *
+ * A point in the conversation the host can name: a divider in the transcript with
+ * a label and a time. It always renders — as a `Marker`, the quietest thing in the
+ * column — and it is honest about what it is:
+ *
+ * - **Without `onRestore` it is only a marker.** Not a disabled button, not a
+ *   greyed-out "Restore": nothing. Whether a checkpoint can be returned to is a
+ *   fact about the host's storage and permissions, and a control that implies it
+ *   can would be a claim nobody made.
+ * - **With `onRestore` it offers Restore, and Restore asks first.** An
+ *   `AlertDialog` (Escape and the scrim do nothing; every exit is a named choice)
+ *   states what will change in the host's own words (`consequence`) before the
+ *   handler is called. A restore throws work away; the confirmation is the point.
+ *
+ * ## States
+ *
+ * `idle` → `restoring` → `restored`, or `failed` with `error`. Pass `state` to
+ * drive it from the host; omit it and the component follows the promise
+ * `onRestore` returns. The status sentence is a live region that exists from the
+ * start, so a change is announced. While restoring, the control stays focusable
+ * (`aria-disabled`, not `disabled`) so focus is not dropped when the dialog hands
+ * it back; once restored the control goes and focus moves to the status line.
+ *
+ * A restore that cannot happen now takes `disabledReason`, shown in words under
+ * the divider; the host decides, the component explains.
+ */
+export type CheckpointProps = Omit<ComponentProps<'div'>, 'children' | 'onError'> & {
+    /** The checkpoint's name. Defaults to "Checkpoint". */
+    label?: string;
+    /** When it was taken, already formatted for the reader. */
+    time?: string;
+    state?: CheckpointState;
+    /** Supplying this is what makes the checkpoint restorable. */
+    onRestore?: () => void | Promise<void>;
+    /** What restoring will change, in the host's words. Shown in the confirmation. */
+    consequence?: string;
+    restoreLabel?: string;
+    /** Why Restore cannot be used right now. */
+    disabledReason?: string;
+    /** Why a restore failed. */
+    error?: string;
+};
+export declare function Checkpoint(props: CheckpointProps): import("solid-js").JSX.Element;
+//# sourceMappingURL=checkpoint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../../../src/components/composites/checkpoint/checkpoint.tsx"],"names":[],"mappings":"AACA,OAAO,EAQL,KAAK,cAAc,EACpB,MAAM,UAAU,CAAA;AAkBjB,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAA;AAE3B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,GAAG;IAClF,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,kCAoIhD"}

package/dist/components/composites/checkpoint/checkpoint.js

@@ -0,0 +1,160 @@
+import { cn } from "../../../lib/utils.js";
+import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger } from "../../ui/alert-dialog/alert-dialog.js";
+import { Button } from "../../ui/button/button.js";
+import { Spinner } from "../../ui/spinner/spinner.js";
+import { Marker } from "../../ui/marker/marker.js";
+import { boundText } from "../sources/source.js";
+import { settleDecision } from "../confirmation/confirmation-model.js";
+import { checkpointLabel, checkpointStatus, restoreControl, restoreDialogCopy } from "./checkpoint-model.js";
+import { className, createComponent, effect, insert, memo, mergeProps, setAttribute, spread, template, use } from "solid-js/web";
+import { Flag } from "lucide-solid";
+import { Show, createEffect, createMemo, createSignal, createUniqueId, on, splitProps } from "solid-js";
+//#region src/components/composites/checkpoint/checkpoint.tsx
+var _tmpl$ = /*#__PURE__*/ template(`<div data-slot=checkpoint><p role=status tabindex=-1>`);
+function Checkpoint(props) {
+	const [local, rest] = splitProps(props, [
+		"class",
+		"label",
+		"time",
+		"state",
+		"onRestore",
+		"consequence",
+		"restoreLabel",
+		"disabledReason",
+		"error"
+	]);
+	const reasonId = `${createUniqueId()}-status`;
+	const [followed, setFollowed] = createSignal("idle");
+	const [failure, setFailure] = createSignal(void 0);
+	const [confirming, setConfirming] = createSignal(false);
+	let inflight = false;
+	let root;
+	let status;
+	const state = () => local.state ?? followed();
+	const error = () => local.error ?? failure();
+	const control = () => restoreControl(local.onRestore !== void 0, state(), local.disabledReason);
+	const copy = () => restoreDialogCopy(local.label, local.consequence);
+	const statusText = () => checkpointStatus(state(), error(), local.disabledReason);
+	const restore = async () => {
+		if (inflight || control().disabled) return;
+		inflight = true;
+		setFailure(void 0);
+		setFollowed("restoring");
+		const result = await settleDecision(local.onRestore);
+		inflight = false;
+		if (result.ok) setFollowed("restored");
+		else {
+			setFailure(result.message);
+			setFollowed("failed");
+		}
+	};
+	createEffect(on(() => state() === "restored", (restored) => {
+		if (!restored) return;
+		const active = document.activeElement;
+		if (active === null || active === document.body || root?.contains(active)) status?.focus();
+	}, { defer: true }));
+	const restoreAction = createMemo(() => createComponent(Show, {
+		get when() {
+			return control().visible;
+		},
+		get children() {
+			return createComponent(AlertDialog, {
+				get open() {
+					return confirming();
+				},
+				onOpenChange: (open) => setConfirming(open && !control().disabled),
+				get children() {
+					return [createComponent(AlertDialogTrigger, {
+						as: Button,
+						variant: "ghost",
+						size: "2xs",
+						get ["aria-disabled"]() {
+							return control().disabled || void 0;
+						},
+						get ["aria-describedby"]() {
+							return statusText() ? reasonId : void 0;
+						},
+						get children() {
+							return [createComponent(Show, {
+								get when() {
+									return state() === "restoring";
+								},
+								get children() {
+									return createComponent(Spinner, {
+										size: "xs",
+										label: false
+									});
+								}
+							}), memo(() => memo(() => state() === "restoring")() ? "Restoring…" : local.restoreLabel ?? (state() === "failed" ? "Try again" : "Restore"))];
+						}
+					}), createComponent(AlertDialogContent, { get children() {
+						return [createComponent(AlertDialogHeader, { get children() {
+							return [createComponent(AlertDialogTitle, { get children() {
+								return copy().title;
+							} }), createComponent(AlertDialogDescription, {
+								"class": "[overflow-wrap:anywhere]",
+								get children() {
+									return copy().description;
+								}
+							})];
+						} }), createComponent(AlertDialogFooter, { get children() {
+							return [createComponent(AlertDialogCancel, {
+								as: Button,
+								variant: "ghost",
+								children: "Do not restore"
+							}), createComponent(AlertDialogAction, {
+								as: Button,
+								onClick: () => void restore(),
+								get children() {
+									return local.restoreLabel ?? "Restore";
+								}
+							})];
+						} })];
+					} })];
+				}
+			});
+		}
+	}));
+	return (() => {
+		var _el$ = _tmpl$(), _el$2 = _el$.firstChild;
+		use((element) => root = element, _el$);
+		spread(_el$, mergeProps({
+			get ["data-state"]() {
+				return state();
+			},
+			get ["class"]() {
+				return local.class;
+			}
+		}, rest), false, true);
+		insert(_el$, createComponent(Marker, {
+			variant: "rule",
+			get icon() {
+				return createComponent(Flag, {});
+			},
+			get tone() {
+				return state() === "failed" ? "danger" : "neutral";
+			},
+			get label() {
+				return checkpointLabel(local.label);
+			},
+			get description() {
+				return memo(() => !!local.time)() ? boundText(local.time, 60) : void 0;
+			},
+			get action() {
+				return restoreAction();
+			}
+		}), _el$2);
+		use((element) => status = element, _el$2);
+		setAttribute(_el$2, "id", reasonId);
+		insert(_el$2, statusText);
+		effect(() => className(_el$2, cn("m-0 text-center text-xs outline-none [overflow-wrap:anywhere]", {
+			"text-destructive": state() === "failed",
+			"text-muted-foreground": state() !== "failed"
+		})));
+		return _el$;
+	})();
+}
+//#endregion
+export { Checkpoint };
+
+//# sourceMappingURL=checkpoint.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","names":["Flag","createEffect","createMemo","createSignal","createUniqueId","on","Show","splitProps","ComponentProps","cn","Button","AlertDialog","AlertDialogAction","AlertDialogCancel","AlertDialogContent","AlertDialogDescription","AlertDialogFooter","AlertDialogHeader","AlertDialogTitle","AlertDialogTrigger","Marker","Spinner","settleDecision","boundText","checkpointLabel","checkpointStatus","restoreControl","restoreDialogCopy","CheckpointState","CheckpointProps","Omit","label","time","state","onRestore","Promise","consequence","restoreLabel","disabledReason","error","Checkpoint","props","local","rest","uid","reasonId","followed","setFollowed","failure","setFailure","undefined","confirming","setConfirming","inflight","root","HTMLDivElement","status","HTMLParagraphElement","control","copy","statusText","restore","disabled","result","ok","message","restored","active","document","activeElement","body","contains","focus","defer","restoreAction","_$createComponent","when","visible","children","open","onOpenChange","as","variant","size","aria-disabled","aria-describedby","_$memo","title","description","onClick","_el$","_tmpl$","_el$2","firstChild","_$use","element","_$spread","_$mergeProps","data-state","class","_$insert","icon","tone","action","_$setAttribute","_$effect","_$className","_$createComponent","_$memo","_$mergeProps","_$className"],"sources":["../../../../src/components/composites/checkpoint/checkpoint.tsx"],"sourcesContent":["import { Flag } from 'lucide-solid'\nimport {\n  createEffect,\n  createMemo,\n  createSignal,\n  createUniqueId,\n  on,\n  Show,\n  splitProps,\n  type ComponentProps,\n} from 'solid-js'\nimport { cn } from '#lib/utils'\nimport { Button } from '../../ui/button'\nimport {\n  AlertDialog,\n  AlertDialogAction,\n  AlertDialogCancel,\n  AlertDialogContent,\n  AlertDialogDescription,\n  AlertDialogFooter,\n  AlertDialogHeader,\n  AlertDialogTitle,\n  AlertDialogTrigger,\n} from '../../ui/alert-dialog'\nimport { Marker } from '../../ui/marker'\nimport { Spinner } from '../../ui/spinner'\nimport { settleDecision } from '../confirmation/confirmation-model'\nimport { boundText } from '../sources/source'\nimport {\n  checkpointLabel,\n  checkpointStatus,\n  restoreControl,\n  restoreDialogCopy,\n  type CheckpointState,\n} from './checkpoint-model'\n\n/**\n * Checkpoint.\n *\n * A point in the conversation the host can name: a divider in the transcript with\n * a label and a time. It always renders — as a `Marker`, the quietest thing in the\n * column — and it is honest about what it is:\n *\n * - **Without `onRestore` it is only a marker.** Not a disabled button, not a\n *   greyed-out \"Restore\": nothing. Whether a checkpoint can be returned to is a\n *   fact about the host's storage and permissions, and a control that implies it\n *   can would be a claim nobody made.\n * - **With `onRestore` it offers Restore, and Restore asks first.** An\n *   `AlertDialog` (Escape and the scrim do nothing; every exit is a named choice)\n *   states what will change in the host's own words (`consequence`) before the\n *   handler is called. A restore throws work away; the confirmation is the point.\n *\n * ## States\n *\n * `idle` → `restoring` → `restored`, or `failed` with `error`. Pass `state` to\n * drive it from the host; omit it and the component follows the promise\n * `onRestore` returns. The status sentence is a live region that exists from the\n * start, so a change is announced. While restoring, the control stays focusable\n * (`aria-disabled`, not `disabled`) so focus is not dropped when the dialog hands\n * it back; once restored the control goes and focus moves to the status line.\n *\n * A restore that cannot happen now takes `disabledReason`, shown in words under\n * the divider; the host decides, the component explains.\n */\nexport type CheckpointProps = Omit<ComponentProps<'div'>, 'children' | 'onError'> & {\n  /** The checkpoint's name. Defaults to \"Checkpoint\". */\n  label?: string\n  /** When it was taken, already formatted for the reader. */\n  time?: string\n  state?: CheckpointState\n  /** Supplying this is what makes the checkpoint restorable. */\n  onRestore?: () => void | Promise<void>\n  /** What restoring will change, in the host's words. Shown in the confirmation. */\n  consequence?: string\n  restoreLabel?: string\n  /** Why Restore cannot be used right now. */\n  disabledReason?: string\n  /** Why a restore failed. */\n  error?: string\n}\n\nexport function Checkpoint(props: CheckpointProps) {\n  const [local, rest] = splitProps(props, [\n    'class',\n    'label',\n    'time',\n    'state',\n    'onRestore',\n    'consequence',\n    'restoreLabel',\n    'disabledReason',\n    'error',\n  ])\n  const uid = createUniqueId()\n  const reasonId = `${uid}-status`\n  const [followed, setFollowed] = createSignal<CheckpointState>('idle')\n  const [failure, setFailure] = createSignal<string | undefined>(undefined)\n  const [confirming, setConfirming] = createSignal(false)\n  let inflight = false\n  let root: HTMLDivElement | undefined\n  let status: HTMLParagraphElement | undefined\n\n  const state = (): CheckpointState => local.state ?? followed()\n  const error = () => local.error ?? failure()\n  const control = () => restoreControl(local.onRestore !== undefined, state(), local.disabledReason)\n  const copy = () => restoreDialogCopy(local.label, local.consequence)\n  const statusText = () => checkpointStatus(state(), error(), local.disabledReason)\n\n  const restore = async () => {\n    if (inflight || control().disabled) return\n    inflight = true\n    setFailure(undefined)\n    setFollowed('restoring')\n    const result = await settleDecision(local.onRestore)\n    inflight = false\n    if (result.ok) {\n      setFollowed('restored')\n    } else {\n      setFailure(result.message)\n      setFollowed('failed')\n    }\n  }\n\n  // The control is replaced by the status line on success; do not strand focus.\n  createEffect(\n    on(\n      () => state() === 'restored',\n      (restored) => {\n        if (!restored) return\n        const active = document.activeElement\n        if (active === null || active === document.body || root?.contains(active)) {\n          status?.focus()\n        }\n      },\n      { defer: true }\n    )\n  )\n\n  // Built once. `Marker` reads `action` twice (to test it, then to draw it), and a\n  // JSX prop re-creates its component on every read: a second AlertDialog root\n  // would portal a second, invisible-to-the-tree dialog when this one opens.\n  const restoreAction = createMemo(() => (\n    <Show when={control().visible}>\n      <AlertDialog\n        open={confirming()}\n        onOpenChange={(open) => setConfirming(open && !control().disabled)}\n      >\n        <AlertDialogTrigger\n          as={Button}\n          variant=\"ghost\"\n          size=\"2xs\"\n          aria-disabled={control().disabled || undefined}\n          aria-describedby={statusText() ? reasonId : undefined}\n        >\n          <Show when={state() === 'restoring'}>\n            <Spinner size=\"xs\" label={false} />\n          </Show>\n          {state() === 'restoring'\n            ? 'Restoring…'\n            : (local.restoreLabel ?? (state() === 'failed' ? 'Try again' : 'Restore'))}\n        </AlertDialogTrigger>\n        <AlertDialogContent>\n          <AlertDialogHeader>\n            <AlertDialogTitle>{copy().title}</AlertDialogTitle>\n            <AlertDialogDescription class=\"[overflow-wrap:anywhere]\">\n              {copy().description}\n            </AlertDialogDescription>\n          </AlertDialogHeader>\n          <AlertDialogFooter>\n            <AlertDialogCancel as={Button} variant=\"ghost\">\n              Do not restore\n            </AlertDialogCancel>\n            <AlertDialogAction as={Button} onClick={() => void restore()}>\n              {local.restoreLabel ?? 'Restore'}\n            </AlertDialogAction>\n          </AlertDialogFooter>\n        </AlertDialogContent>\n      </AlertDialog>\n    </Show>\n  ))\n\n  return (\n    <div\n      ref={(element) => (root = element)}\n      data-slot=\"checkpoint\"\n      data-state={state()}\n      class={local.class}\n      {...rest}\n    >\n      <Marker\n        variant=\"rule\"\n        icon={<Flag />}\n        tone={state() === 'failed' ? 'danger' : 'neutral'}\n        label={checkpointLabel(local.label)}\n        description={local.time ? boundText(local.time, 60) : undefined}\n        action={restoreAction()}\n      />\n      {/* Always present, so a state change is a change to a live region rather than\n          the arrival of one. Empty while idle, which takes no space. */}\n      <p\n        id={reasonId}\n        ref={(element) => (status = element)}\n        role=\"status\"\n        tabindex=\"-1\"\n        class={cn('m-0 text-center text-xs outline-none [overflow-wrap:anywhere]', {\n          'text-destructive': state() === 'failed',\n          'text-muted-foreground': state() !== 'failed',\n        })}\n      >\n        {statusText()}\n      </p>\n    </div>\n  )\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,3 @@
+export { Checkpoint, type CheckpointProps } from './checkpoint';
+export { checkpointLabel, checkpointStatus, restoreControl, restoreDialogCopy, type CheckpointState, } from './checkpoint-model';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/composites/checkpoint/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAC/D,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAA"}

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

@@ -0,0 +1,3 @@
+import { checkpointLabel, checkpointStatus, restoreControl, restoreDialogCopy } from "./checkpoint-model.js";
+import { Checkpoint } from "./checkpoint.js";
+export { Checkpoint, checkpointLabel, checkpointStatus, restoreControl, restoreDialogCopy };

package/dist/components/composites/confirmation/confirmation-model.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Where a request for approval stands.
+ *
+ * - `requested`: waiting on the reader. The only state with live buttons.
+ * - `approved` / `denied`: settled; the record of the answer.
+ * - `expired`: nobody can answer it any more (the run moved on, a timeout).
+ * - `unavailable`: it is still open, but this client cannot answer it right now
+ *   (offline, no authority, another client holds it). The buttons stay visible and
+ *   disabled so the reader can see what was asked and why they cannot answer.
+ */
+export type ConfirmationState = 'requested' | 'approved' | 'denied' | 'expired' | 'unavailable';
+/** Whether the choice is still open, which is exactly when the buttons are drawn. */
+export declare function isAwaitingAnswer(state: ConfirmationState): boolean;
+/**
+ * The one line that replaces the buttons once the request settles. Who and when
+ * appear only if the host supplied them: "Approved" is a fact the state gives,
+ * "by Ana" is a fact only the host knows.
+ */
+export declare function confirmationOutcome(state: ConfirmationState, by?: string, at?: string): string | undefined;
+export type DecisionResult = {
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * Run a host handler that may be synchronous, asynchronous, or throw, and report
+ * the outcome as data. A rejection's own message is shown (bounded) because the
+ * host usually knows why; a non-Error rejection gets a plain sentence instead of
+ * "[object Object]".
+ */
+export declare function settleDecision(handler: (() => void | Promise<void>) | undefined): Promise<DecisionResult>;
+/**
+ * Why a choice is not available, in words. A host `disabledReason` outranks the
+ * built-in sentence for a missing handler, and a request that is `unavailable`
+ * without a reason still says so rather than showing dead buttons.
+ */
+export declare function decisionReason(options: {
+    state: ConfirmationState;
+    disabledReason?: string;
+    hasHandler: boolean;
+    unavailableFallback: string;
+    missingFallback: string;
+}): string | undefined;
+//# sourceMappingURL=confirmation-model.d.ts.map

package/dist/components/composites/confirmation/confirmation-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation-model.d.ts","sourceRoot":"","sources":["../../../../src/components/composites/confirmation/confirmation-model.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAA;AAE/F,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAElE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,iBAAiB,EACxB,EAAE,CAAC,EAAE,MAAM,EACX,EAAE,CAAC,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAapB;AAED,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAI1E;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,GAChD,OAAO,CAAC,cAAc,CAAC,CAQzB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACtC,KAAK,EAAE,iBAAiB,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,OAAO,CAAA;IACnB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,eAAe,EAAE,MAAM,CAAA;CACxB,GAAG,MAAM,GAAG,SAAS,CAMrB"}

package/dist/components/composites/confirmation/confirmation-model.js

@@ -0,0 +1,51 @@
+import { boundText } from "../sources/source.js";
+//#region src/components/composites/confirmation/confirmation-model.ts
+/** Whether the choice is still open, which is exactly when the buttons are drawn. */
+function isAwaitingAnswer(state) {
+	return state === "requested" || state === "unavailable";
+}
+/**
+* The one line that replaces the buttons once the request settles. Who and when
+* appear only if the host supplied them: "Approved" is a fact the state gives,
+* "by Ana" is a fact only the host knows.
+*/
+function confirmationOutcome(state, by, at) {
+	const base = state === "approved" ? "Approved" : state === "denied" ? "Denied" : state === "expired" ? "Expired without an answer" : void 0;
+	if (base === void 0) return void 0;
+	const who = by ? boundText(by, 60) : "";
+	const when = at ? boundText(at, 40) : "";
+	return `${base}${who ? ` by ${who}` : ""}${when ? ` at ${when}` : ""}`;
+}
+var DEFAULT_FAILURE = "Your answer could not be sent. Try again.";
+/**
+* Run a host handler that may be synchronous, asynchronous, or throw, and report
+* the outcome as data. A rejection's own message is shown (bounded) because the
+* host usually knows why; a non-Error rejection gets a plain sentence instead of
+* "[object Object]".
+*/
+async function settleDecision(handler) {
+	try {
+		await handler?.();
+		return { ok: true };
+	} catch (error) {
+		return {
+			ok: false,
+			message: (error instanceof Error ? boundText(error.message, 200) : "") || DEFAULT_FAILURE
+		};
+	}
+}
+/**
+* Why a choice is not available, in words. A host `disabledReason` outranks the
+* built-in sentence for a missing handler, and a request that is `unavailable`
+* without a reason still says so rather than showing dead buttons.
+*/
+function decisionReason(options) {
+	const hostReason = options.disabledReason ? boundText(options.disabledReason, 240) : "";
+	if (hostReason) return hostReason;
+	if (options.state === "unavailable") return options.unavailableFallback;
+	if (!options.hasHandler) return options.missingFallback;
+}
+//#endregion
+export { confirmationOutcome, decisionReason, isAwaitingAnswer, settleDecision };
+
+//# sourceMappingURL=confirmation-model.js.map

package/dist/components/composites/confirmation/confirmation-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation-model.js","names":[],"sources":["../../../../src/components/composites/confirmation/confirmation-model.ts"],"sourcesContent":["import { boundText } from '../sources/source'\n\n/**\n * Where a request for approval stands.\n *\n * - `requested`: waiting on the reader. The only state with live buttons.\n * - `approved` / `denied`: settled; the record of the answer.\n * - `expired`: nobody can answer it any more (the run moved on, a timeout).\n * - `unavailable`: it is still open, but this client cannot answer it right now\n *   (offline, no authority, another client holds it). The buttons stay visible and\n *   disabled so the reader can see what was asked and why they cannot answer.\n */\nexport type ConfirmationState = 'requested' | 'approved' | 'denied' | 'expired' | 'unavailable'\n\n/** Whether the choice is still open, which is exactly when the buttons are drawn. */\nexport function isAwaitingAnswer(state: ConfirmationState): boolean {\n  return state === 'requested' || state === 'unavailable'\n}\n\n/**\n * The one line that replaces the buttons once the request settles. Who and when\n * appear only if the host supplied them: \"Approved\" is a fact the state gives,\n * \"by Ana\" is a fact only the host knows.\n */\nexport function confirmationOutcome(\n  state: ConfirmationState,\n  by?: string,\n  at?: string\n): string | undefined {\n  const base =\n    state === 'approved'\n      ? 'Approved'\n      : state === 'denied'\n        ? 'Denied'\n        : state === 'expired'\n          ? 'Expired without an answer'\n          : undefined\n  if (base === undefined) return undefined\n  const who = by ? boundText(by, 60) : ''\n  const when = at ? boundText(at, 40) : ''\n  return `${base}${who ? ` by ${who}` : ''}${when ? ` at ${when}` : ''}`\n}\n\nexport type DecisionResult = { ok: true } | { ok: false; message: string }\n\nconst DEFAULT_FAILURE = 'Your answer could not be sent. Try again.'\n\n/**\n * Run a host handler that may be synchronous, asynchronous, or throw, and report\n * the outcome as data. A rejection's own message is shown (bounded) because the\n * host usually knows why; a non-Error rejection gets a plain sentence instead of\n * \"[object Object]\".\n */\nexport async function settleDecision(\n  handler: (() => void | Promise<void>) | undefined\n): Promise<DecisionResult> {\n  try {\n    await handler?.()\n    return { ok: true }\n  } catch (error) {\n    const message = error instanceof Error ? boundText(error.message, 200) : ''\n    return { ok: false, message: message || DEFAULT_FAILURE }\n  }\n}\n\n/**\n * Why a choice is not available, in words. A host `disabledReason` outranks the\n * built-in sentence for a missing handler, and a request that is `unavailable`\n * without a reason still says so rather than showing dead buttons.\n */\nexport function decisionReason(options: {\n  state: ConfirmationState\n  disabledReason?: string\n  hasHandler: boolean\n  unavailableFallback: string\n  missingFallback: string\n}): string | undefined {\n  const hostReason = options.disabledReason ? boundText(options.disabledReason, 240) : ''\n  if (hostReason) return hostReason\n  if (options.state === 'unavailable') return options.unavailableFallback\n  if (!options.hasHandler) return options.missingFallback\n  return undefined\n}\n"],"mappings":";;;AAeA,SAAgB,iBAAiB,OAAmC;CAClE,OAAO,UAAU,eAAe,UAAU;AAC5C;;;;;;AAOA,SAAgB,oBACd,OACA,IACA,IACoB;CACpB,MAAM,OACJ,UAAU,aACN,aACA,UAAU,WACR,WACA,UAAU,YACR,8BACA,KAAA;CACV,IAAI,SAAS,KAAA,GAAW,OAAO,KAAA;CAC/B,MAAM,MAAM,KAAK,UAAU,IAAI,EAAE,IAAI;CACrC,MAAM,OAAO,KAAK,UAAU,IAAI,EAAE,IAAI;CACtC,OAAO,GAAG,OAAO,MAAM,OAAO,QAAQ,KAAK,OAAO,OAAO,SAAS;AACpE;AAIA,IAAM,kBAAkB;;;;;;;AAQxB,eAAsB,eACpB,SACyB;CACzB,IAAI;EACF,MAAM,UAAU;EAChB,OAAO,EAAE,IAAI,KAAK;CACpB,SAAS,OAAO;EAEd,OAAO;GAAE,IAAI;GAAO,UADJ,iBAAiB,QAAQ,UAAU,MAAM,SAAS,GAAG,IAAI,OACjC;EAAgB;CAC1D;AACF;;;;;;AAOA,SAAgB,eAAe,SAMR;CACrB,MAAM,aAAa,QAAQ,iBAAiB,UAAU,QAAQ,gBAAgB,GAAG,IAAI;CACrF,IAAI,YAAY,OAAO;CACvB,IAAI,QAAQ,UAAU,eAAe,OAAO,QAAQ;CACpD,IAAI,CAAC,QAAQ,YAAY,OAAO,QAAQ;AAE1C"}

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

@@ -0,0 +1,72 @@
+import { type ComponentProps, type JSX } from 'solid-js';
+import { type ConfirmationState } from './confirmation-model';
+/**
+ * Confirmation.
+ *
+ * The agent has stopped a tool and will not continue until the person approves or
+ * denies it. Like `Questionnaire`, this is one of the two elements in a transcript
+ * the reader *must* act on, so it is allowed a card surface — and the border is
+ * the focus ring's colour only while it is waiting. Once answered it drops to a
+ * hairline and a one-line record, because a settled decision should read as
+ * history, not as something still asking.
+ *
+ * ## It shows what is being approved, and nothing else
+ *
+ * `title` and `description` say what the tool wants to do; `details` is the
+ * evidence, rendered as `CodeBlock size="sm"` (a command, a request) or
+ * `DiffBlock` (a patch). Details are text: never interpreted, and a long one
+ * scrolls inside its block. Approve and Deny exist only while the request is
+ * open; afterwards they are replaced by the outcome, with *who* and *when* only if
+ * the host supplied them.
+ *
+ * ## The host owns authority
+ *
+ * Whether this client may answer is not decided here. No handler, or a host
+ * `disabledReason`, or the `unavailable` state, leaves the buttons visible and
+ * disabled with the reason beside them in words — never hidden, because a reader
+ * who cannot see the choice cannot tell whether the agent is waiting on them.
+ *
+ * ## Answering is a round trip
+ *
+ * `onApprove` / `onDeny` may return a promise. While one is pending both buttons
+ * refuse input (a synchronous guard as well as the signal, so a double click in
+ * one tick cannot submit twice) and the pressed one shows a spinner. A failure
+ * shows `error` (or the rejection's own message) and re-enables the buttons. The
+ * buttons use `aria-disabled` rather than `disabled`: a native disabled button
+ * drops focus, and the reader's place would be lost mid-decision. When the state
+ * settles, focus moves to the outcome line if it was in the card, so a keyboard
+ * user is not stranded on a control that no longer exists.
+ */
+export type ConfirmationDetails = Readonly<{
+    kind: 'code';
+    code: string;
+    language?: string;
+    title?: string;
+}> | Readonly<{
+    kind: 'diff';
+    patch: string;
+    title?: string;
+}>;
+export type ConfirmationProps = Omit<ComponentProps<'section'>, 'title' | 'onError'> & {
+    state?: ConfirmationState;
+    /** What the tool wants to do, as a short sentence. */
+    title: string;
+    description?: string;
+    details?: ConfirmationDetails;
+    onApprove?: () => void | Promise<void>;
+    onDeny?: () => void | Promise<void>;
+    approveLabel?: string;
+    denyLabel?: string;
+    /** Why the choice cannot be made right now; shown in words beside the buttons. */
+    disabledReason?: string;
+    /** A failed answer, in words. Overrides the rejection's own message. */
+    error?: string;
+    /** Who answered, once settled. Omit if unknown; nothing is assumed. */
+    resolvedBy?: string;
+    /** When it was answered, already formatted for the reader. Omit if unknown. */
+    resolvedAt?: string;
+    /** Extra content between the details and the buttons. */
+    children?: JSX.Element;
+};
+export declare function Confirmation(props: ConfirmationProps): JSX.Element;
+//# sourceMappingURL=confirmation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation.d.ts","sourceRoot":"","sources":["../../../../src/components/composites/confirmation/confirmation.tsx"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,cAAc,EACnB,KAAK,GAAG,EACT,MAAM,UAAU,CAAA;AAOjB,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAA;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,MAAM,mBAAmB,GAC3B,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC3E,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAE7D,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC,GAAG;IACrF,KAAK,CAAC,EAAE,iBAAiB,CAAA;IACzB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,mBAAmB,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,MAAM,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;CACvB,CAAA;AAID,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,eAiLpD"}