@revolist/ui 4.0.3-rc → 4.0.5-rc

package/_chunks/rotate-left-BF6G883o.js

@@ -0,0 +1,4 @@
+//#region ../../node_modules/.pnpm/@fortawesome+fontawesome-free@7.3.1/node_modules/@fortawesome/fontawesome-free/svgs/solid/rotate-left.svg?raw
+var e = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 512 512\"><!--! Font Awesome Free 7.3.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2026 Fonticons, Inc. --><path fill=\"currentColor\" d=\"M24 192l144 0c9.7 0 18.5-5.8 22.2-14.8s1.7-19.3-5.2-26.2l-46.7-46.7c75.3-58.6 184.3-53.3 253.5 15.9 75 75 75 196.5 0 271.5s-196.5 75-271.5 0c-10.2-10.2-19-21.3-26.4-33-9.5-14.9-29.3-19.3-44.2-9.8s-19.3 29.3-9.8 44.2C49.7 408.7 61.4 423.5 75 437 175 537 337 537 437 437S537 175 437 75C342.8-19.3 193.3-24.7 92.7 58.8L41 7C34.1 .2 23.8-1.9 14.8 1.8S0 14.3 0 24L0 168c0 13.3 10.7 24 24 24z\"/></svg>";
+//#endregion
+export { e as t };

package/_chunks/title-tooltip-Cw6LOZhb.js

@@ -0,0 +1,11 @@
+import { r as e, t } from "./hooks.module-CG3gN83z.js";
+import { n } from "./popover-controller-D-AvKQ7B.js";
+//#region src/core/title-tooltip.ts
+function r(r, i) {
+	let a = t(null), o = t(i);
+	return o.current = i, e(() => {
+		if (a.current && r) return new n().bind(a.current, r, { onEscape: () => o.current?.() });
+	}, [r]), a;
+}
+//#endregion
+export { r as t };

package/_chunks/tooltip-D4xkio5G.js

@@ -0,0 +1,54 @@
+import { i as e, o as t, r as n } from "./hooks.module-CG3gN83z.js";
+import { t as r } from "./jsxRuntime.module-F6UFnpT-.js";
+import { t as i } from "./tooltip-session-B6X6x8G_.js";
+import { createControlId as a } from "../core/control-id.js";
+//#region src/core/tooltip.tsx
+function o(o, s = !0, c) {
+	let [l] = e(() => a("rv-format-control-tooltip")), [u] = e(() => new i());
+	u.delay = c?.delay ?? 0;
+	let d = t(() => u.hide(), [u]), f = t((e) => {
+		e || u.hide(), u.setSurface(e);
+	}, [u]);
+	return n(() => {
+		u.hide();
+	}, [o, c?.delay]), n(() => () => u.destroy(), [u]), {
+		id: l,
+		hide: d,
+		triggerProps: {
+			"aria-describedby": l,
+			onFocus: (e) => u.focus(e.currentTarget),
+			onBlur: () => u.blur(),
+			onMouseEnter: (e) => u.show(e.currentTarget),
+			onMouseLeave: (e) => u.leave(e?.currentTarget),
+			onPointerDown: (e) => u.pointerDown(),
+			onPointerCancel: () => u.hide(),
+			onKeyDown: (e) => u.keyDown(e)
+		},
+		tooltip: /* @__PURE__ */ r("span", {
+			ref: f,
+			id: l,
+			class: `rv-tooltip ${c?.className ?? "rv-format-control-tooltip"}`,
+			role: "tooltip",
+			"data-visible": "false",
+			hidden: !0,
+			children: c?.content ?? o
+		})
+	};
+}
+function s({ id: a, text: o, content: s, visible: c, anchor: l = null, className: u = "rv-format-control-tooltip" }) {
+	let [d] = e(() => new i()), f = t((e) => {
+		e || d.hide(), d.setSurface(e);
+	}, [d]);
+	return n(() => (c && l ? d.show(l) : d.hide(), () => d.hide()), [c, l]), n(() => () => d.destroy(), [d]), /* @__PURE__ */ r("span", {
+		ref: f,
+		id: a,
+		class: `rv-tooltip ${u}`,
+		role: "tooltip",
+		"data-visible": c,
+		hidden: !c,
+		children: s ?? o
+	});
+}
+var c = o;
+//#endregion
+export { o as n, c as r, s as t };

package/_chunks/tooltip-owner-DjdvqKzz.js

@@ -0,0 +1,19 @@
+//#region ../chart-utils/src/tooltip-owner.ts
+var e = Symbol.for("@revolist/tooltip-owner");
+function t(t, n, r) {
+	let i = t, a = i[e];
+	a?.owner !== n && (Object.defineProperty(i, e, {
+		configurable: !0,
+		writable: !0,
+		value: {
+			owner: n,
+			dismiss: r
+		}
+	}), a?.dismiss());
+}
+function n(t, n) {
+	let r = t;
+	r[e]?.owner === n && delete r[e];
+}
+//#endregion
+export { n, t };

package/_chunks/tooltip-session-B6X6x8G_.js

@@ -0,0 +1,110 @@
+import { c as e, o as t, r as n, t as r } from "./top-layer-popup-CNSDdfJV.js";
+import { n as i, t as a } from "./tooltip-owner-DjdvqKzz.js";
+//#region src/core/tooltip-session.ts
+var o = class {
+	anchor;
+	surface;
+	timer;
+	mode;
+	cleanup;
+	mounted = !1;
+	pointerFocus = !1;
+	open = !1;
+	addedDescription = !1;
+	onHide;
+	onEscape;
+	delay = 0;
+	get isOpen() {
+		return this.open;
+	}
+	get isPending() {
+		return this.timer !== void 0;
+	}
+	setSurface(e) {
+		this.surface = e ?? void 0;
+	}
+	show(e) {
+		this.anchor === e && this.open || (this.hide(), this.anchor = e, this.listen(e), this.delay > 0 ? this.timer = setTimeout(() => {
+			this.timer = void 0, this.present();
+		}, this.delay) : this.present());
+	}
+	present() {
+		let r = this.anchor, i = this.surface;
+		if (!r || !i || !r.isConnected) {
+			this.hide();
+			return;
+		}
+		a(r.ownerDocument, this, () => this.hide()), e(i), this.mounted = !i.isConnected, this.mounted && r.ownerDocument.body.append(i), i.hidden = !1, i.dataset.visible = "true", Object.assign(i.style, {
+			position: "fixed",
+			inset: "auto",
+			margin: "0",
+			transform: "none",
+			visibility: "visible",
+			positionAnchor: "auto",
+			positionArea: "none"
+		}), this.mode = n(i, "block");
+		let o = r.ownerDocument.defaultView, s = t(r.getBoundingClientRect(), i.getBoundingClientRect(), {
+			width: o?.innerWidth ?? 0,
+			height: o?.innerHeight ?? 0
+		});
+		Object.assign(i.style, {
+			left: `${s.left}px`,
+			top: `${s.top}px`
+		});
+		let c = new Set((r.getAttribute("aria-describedby") ?? "").split(/\s+/).filter(Boolean));
+		this.addedDescription = !c.has(i.id), c.add(i.id), r.setAttribute("aria-describedby", [...c].join(" ")), this.open = !0;
+	}
+	hide() {
+		clearTimeout(this.timer), this.timer = void 0, this.cleanup?.(), this.cleanup = void 0;
+		let e = this.anchor, t = this.surface;
+		if (e && i(e.ownerDocument, this), t && this.open) {
+			if (r(t, this.mode), t.hidden = !0, t.dataset.visible = "false", e && this.addedDescription) {
+				let n = (e.getAttribute("aria-describedby") ?? "").split(/\s+/).filter((e) => e && e !== t.id);
+				n.length ? e.setAttribute("aria-describedby", n.join(" ")) : e.removeAttribute("aria-describedby");
+			}
+			this.mounted && t.remove();
+		}
+		let n = this.open;
+		this.open = !1, n && this.onHide?.(), this.mode = void 0, this.mounted = !1;
+	}
+	focus(e) {
+		this.show(e);
+	}
+	blur() {
+		this.pointerFocus = !1, this.hide();
+	}
+	pointerDown() {
+		this.pointerFocus = !0;
+	}
+	leave(e) {
+		(!e || this.pointerFocus || e.ownerDocument.activeElement !== e) && this.hide();
+	}
+	keyDown(e) {
+		e.key === "Escape" && (this.open || this.isPending) && !e.defaultPrevented ? (e.preventDefault(), e.stopPropagation(), this.hide(), this.onEscape?.()) : (e.key === "Enter" || e.key === " ") && this.hide();
+	}
+	destroy() {
+		this.hide(), this.surface = void 0, this.anchor = void 0;
+	}
+	listen(e) {
+		let t = e.ownerDocument, n = t.defaultView, r = e.closest("[popover]"), i = () => this.hide(), a = (t) => {
+			t.composedPath().includes(e) || this.hide();
+		}, o = (n) => {
+			let r = n.target;
+			(r === t || r?.contains?.(e)) && this.hide();
+		}, s = () => {
+			r?.matches(":popover-open") || this.hide();
+		}, c = (e) => {
+			e.key === "Escape" && this.keyDown(e);
+		}, l = n?.MutationObserver, u = l ? new l(() => {
+			e.isConnected || this.hide();
+		}) : void 0;
+		u?.observe(t, {
+			childList: !0,
+			subtree: !0
+		}), t.addEventListener("keydown", c, !0), t.addEventListener("pointerdown", a, !0), t.addEventListener("scroll", o, !0), t.addEventListener("visibilitychange", i), n?.addEventListener("resize", i), n?.addEventListener("blur", i), r?.addEventListener("toggle", s), this.cleanup = () => {
+			u?.disconnect(), t.removeEventListener("keydown", c, !0), t.removeEventListener("pointerdown", a, !0), t.removeEventListener("scroll", o, !0), t.removeEventListener("visibilitychange", i), n?.removeEventListener("resize", i), n?.removeEventListener("blur", i), r?.removeEventListener("toggle", s);
+		};
+	}
+};
+//#endregion
+export { o as t };

package/_chunks/tooltip-text-BXsUEmBH.js

@@ -0,0 +1,12 @@
+import { c as e } from "./preact.module-BBM36DnO.js";
+import { t } from "./title-tooltip-Cw6LOZhb.js";
+//#region src/core/tooltip-text.tsx
+function n({ as: n = "span", title: r, children: i, ...a }) {
+	let o = t(r);
+	return e(n, {
+		...a,
+		ref: o
+	}, i);
+}
+//#endregion
+export { n as t };

package/_chunks/top-layer-popup-CNSDdfJV.js

@@ -0,0 +1,59 @@
+import { calculateAnchoredPopoverPosition as e } from "../core/anchored-popover.js";
+import { c as t } from "./preact.module-BBM36DnO.js";
+import { createPreactElement as n } from "../preact-mount.js";
+//#region src/core/tooltip-surface.ts
+var r = "\n.rv-tooltip.rv-tooltip {\n  box-sizing: border-box;\n  position: fixed;\n  z-index: 100000;\n  margin: 0;\n  inset: auto;\n  transform: none;\n  opacity: 1;\n  visibility: visible;\n  padding: 6px 10px;\n  border: 0;\n  border-radius: 6px;\n  background: var(--rv-tooltip-bg, #191919);\n  color: var(--rv-tooltip-fg, #fff);\n  box-shadow: 0 4px 14px var(--rv-ui-shadow, rgb(0 0 0 / 18%));\n  font: 12px/1.4 var(--rv-ui-font-family, Inter, ui-sans-serif, system-ui, sans-serif);\n  font-weight: 400;\n  text-align: start;\n  white-space: pre-wrap;\n  overflow-wrap: anywhere;\n  max-width: min(360px, calc(100vw - 16px));\n  max-height: calc(100dvh - 16px);\n  overflow: auto;\n  pointer-events: none;\n}\n.rv-tooltip[hidden], .rv-tooltip[data-visible=\"false\"] { display: none; }\n.rv-tooltip[data-overflow] { pointer-events: auto; }\n@media (forced-colors: active) {\n  .rv-tooltip.rv-tooltip { color: CanvasText; background: Canvas; border: 1px solid CanvasText; }\n}\n";
+function i(e) {
+	if (e.querySelector("style[data-rv-tooltip-styles]")) return;
+	let i = e.nodeType === 9 ? e : e.ownerDocument, a = n(i, t("style", { "data-rv-tooltip-styles": "" }, r));
+	e.nodeType === 9 ? i.head.append(a) : e.append(a);
+}
+function a(e) {
+	e.classList.add("rv-tooltip"), e.setAttribute("role", "tooltip");
+	let t = e.getRootNode();
+	i(t.nodeType === 11 && "host" in t ? t : e.ownerDocument);
+}
+function o(t, n, r) {
+	let i = e(t, n, r), a = t.top - n.height - 8;
+	return a >= 8 ? {
+		left: Math.max(8, Math.min(t.left + (t.width - n.width) / 2, r.width - n.width - 8)),
+		top: a
+	} : i;
+}
+//#endregion
+//#region src/core/popup-ownership.ts
+function s(e, t) {
+	if (!e || !t) return !1;
+	let n = /* @__PURE__ */ new Set(), r = (e) => !n.has(e) && (n.add(e), e.contains(t) ? !0 : [...e.querySelectorAll("[aria-controls]")].some((t) => (t.getAttribute("aria-controls") ?? "").split(/\s+/).some((t) => {
+		let n = e.ownerDocument.getElementById(t);
+		return !!n && r(n);
+	})));
+	return r(e);
+}
+//#endregion
+//#region src/core/top-layer-popup.ts
+var c = /* @__PURE__ */ new WeakMap();
+function l(e, t = "flex") {
+	if (c.has(e) || c.set(e, e.getAttribute("data-rv-ui-surface")), e.setAttribute("data-rv-ui-surface", ""), e.style.display = t, typeof e.showPopover == "function") {
+		e.setAttribute("popover", "manual");
+		try {
+			return e.showPopover(), "popover";
+		} catch {
+			e.removeAttribute("popover");
+		}
+	}
+	return e.style.display = t, "fallback";
+}
+function u(e, t) {
+	let n = c.get(e);
+	if (n !== void 0 && (n === null ? e.removeAttribute("data-rv-ui-surface") : e.setAttribute("data-rv-ui-surface", n), c.delete(e)), t === "popover" && typeof e.hidePopover == "function") try {
+		e.hidePopover(), e.style.removeProperty("display");
+		return;
+	} catch {}
+	e.style.display = "none";
+}
+function d(e, t) {
+	return t ? e.contains(t) ? !0 : [...e.querySelectorAll("[aria-controls]")].some((n) => n.getAttribute("aria-controls")?.split(/\s+/).some((n) => e.ownerDocument.getElementById(n)?.contains(t))) : !1;
+}
+//#endregion
+export { r as a, a as c, s as i, d as n, o, l as r, i as s, u as t };

package/ai/_chat.scss

@@ -45,13 +45,31 @@
   color: var(--rv-ui-text-muted);
   margin-block: 0.5rem;
 }
+.rv-ai-chat-empty > strong {
+  font-size: calc(1em + 2px);
+}
+.rv-ai-chat-empty img {
+  max-width: 100%;
+  height: auto;
+}
+.rv-ai-mounted-chat .rv-ai-chat-content:has(> .rv-ai-chat-empty:only-child) {
+  box-sizing: border-box;
+  min-height: 100%;
+}
 .rv-ai-chat-jump.rv-btn {
   position: absolute;
   inset-block-end: 0.75rem;
   inset-inline-start: 50%;
   transform: translateX(-50%);
-  box-shadow: 0 2px 12px var(--rv-ui-focus-ring);
-  white-space: nowrap;
+  width: 2rem;
+  min-width: 2rem;
+  height: 2rem;
+  padding: 0.375rem;
+  border: 1px solid var(--rv-ui-border);
+  border-radius: 50%;
+  background: var(--rv-ui-surface);
+  color: var(--rv-ui-text);
+  box-shadow: none;
 }
 .rv-ai-chat-composer {
   flex: none;
@@ -65,6 +83,10 @@
   max-width: 100%;
   align-self: flex-start;
 }
+.rv-ai-message--assistant {
+  align-self: stretch;
+  width: 100%;
+}
 .rv-ai-message-content {
   white-space: pre-wrap;
   overflow-wrap: anywhere;
@@ -127,7 +149,7 @@
 }
 .rv-ai-task-icon {
   display: inline-flex;
-  width: 1rem;
+  width: 1.25rem;
   height: 1.25rem;
   flex: none;
   align-items: center;
@@ -182,6 +204,9 @@
   .rv-ai-chat-composer {
     padding: 0.75rem 0 0;
   }
+  .rv-ai-result-actions {
+    margin-block-start: 0.75rem;
+  }
 }
 .rv-ai-chat-result {
   max-width: 100%;

package/ai/_style.scss

@@ -1,4 +1,5 @@
 @use './chat';
+@use './results/style';
 .rv-ai-assistant {
   box-sizing: border-box;
   width: 100%;
@@ -89,7 +90,8 @@
 .rv-ai-request-trail .rv-ai-trail-trigger {
   color: var(--rv-ui-accent-text);
   background: var(--rv-ui-selected-bg);
-  &:hover:not(:disabled), &:focus-visible {
+  &:hover:not(:disabled),
+  &:focus-visible {
     color: var(--rv-ui-accent-text);
     background: var(--rv-ui-selected-bg);
   }
@@ -161,7 +163,11 @@
   background: var(--rv-ui-surface-hover);
 }
 .rv-ai-step[data-current] .rv-ai-step-chip {
-  background: color-mix(in srgb, var(--rv-ui-selected-bg) 55%, var(--rv-ui-surface));
+  background: color-mix(
+    in srgb,
+    var(--rv-ui-selected-bg) 55%,
+    var(--rv-ui-surface)
+  );
 }
 .rv-ai-step-number {
   position: relative;
@@ -321,3 +327,50 @@
   overflow-wrap: anywhere;
   font-size: 0.875em;
 }
+.rv-ai-preview-changes {
+  max-width: 100%;
+  overflow-x: auto;
+  table {
+    width: 100%;
+    border-collapse: collapse;
+    font-size: 0.875rem;
+  }
+  th,
+  td {
+    padding: 0.5rem 0.625rem;
+    border-bottom: 1px solid var(--rv-ui-border);
+    text-align: start;
+    vertical-align: top;
+    overflow-wrap: anywhere;
+  }
+  th {
+    font-weight: 500;
+  }
+  thead th {
+    color: var(--rv-ui-text-muted);
+  }
+  td {
+    min-width: 4rem;
+  }
+}
+.rv-ai-preview-item {
+  display: block;
+  font-weight: 600;
+  margin-bottom: 0.125rem;
+}
+.rv-ai-preview-notice {
+  margin: 0;
+  color: var(--rv-ui-text-muted);
+}
+
+// Opt-in bounded chat surfaces; toolbar mounts keep their natural height.
+.rv-ai-assistant--fill {
+  padding: 0;
+  flex: 1;
+  min-height: 0;
+  height: 100%;
+  > .rv-ai-mounted-chat { flex: 1; min-height: 0; }
+  .rv-ai-chat-viewport { max-height: none; }
+  .rv-ai-result-actions, .rv-ai-assistant-footer { flex: none; }
+  .rv-ai-chat-content { min-height: 100%; box-sizing: border-box; }
+}

package/ai/chat.d.ts

@@ -24,8 +24,10 @@ export declare function AiChatContent({ children, className, autoScroll, busy, l
 export interface AiChatEmptyStateProps extends AiChatPartProps {
     title?: string;
     description?: string;
+    /** Framework-owned image/text content. Return cleanup for listeners or mounted views. */
+    renderContent?(host: HTMLElement): void | (() => void);
 }
-export declare function AiChatEmptyState({ title, description, children, className, translations, }: AiChatEmptyStateProps): h.JSX.Element;
+export declare function AiChatEmptyState({ title, description, children, className, translations, renderContent, }: AiChatEmptyStateProps): h.JSX.Element;
 /** Existing composer behavior, with chat-specific defaults. */
 export declare function AiChatComposer(props: AiPromptInputProps): h.JSX.Element;
 export interface AiMessageProps extends AiChatPartProps {

package/ai/components.d.ts

@@ -55,6 +55,8 @@ export interface AiResultProps {
 }
 export declare function AiResult({ translations, summary, matchedRows, countLabel, actions, children, }: AiResultProps): h.JSX.Element;
 export interface AiAssistantProps {
+    /** Fill a bounded parent, with messages scrolling above the composer. */
+    layout?: 'flow' | 'fill';
     translations?: AiUiTranslations;
     label?: string;
     children?: ComponentChildren;
@@ -62,14 +64,23 @@ export interface AiAssistantProps {
     busy?: boolean;
 }
 /** Neutral composition; grid/model/query policy remains in the consuming product. */
-export declare function AiAssistant({ translations, label, children, footer, busy, }: AiAssistantProps): h.JSX.Element;
+export declare function AiAssistant({ layout, translations, label, children, footer, busy, }: AiAssistantProps): h.JSX.Element;
+export interface AiPreviewChange {
+    /** User-facing record, task or chart name. */
+    item?: string;
+    label: string;
+    before?: string;
+    after?: string;
+}
 export interface AiChangePreviewProps {
     translations?: AiUiTranslations;
     summary: string;
     details?: string;
+    changes?: readonly AiPreviewChange[];
+    notice?: string;
     disabled?: boolean;
     onApply(): void;
     onCancel(): void;
 }
 /** Generic approval surface; the host retains the prepared command and its mutation policy. */
-export declare function AiChangePreview({ translations, summary, details, disabled, onApply, onCancel, }: AiChangePreviewProps): h.JSX.Element;
+export declare function AiChangePreview({ translations, summary, details, changes, notice, disabled, onApply, onCancel, }: AiChangePreviewProps): h.JSX.Element;

package/ai/index.d.ts

@@ -5,3 +5,4 @@ export * from './translations';
 export type { AiPromptHistoryOptions } from './prompt-history';
 export { AiTranslationProvider } from './translation-context';
 export * from './chat';
+export * from './results';

package/ai/index.js

@@ -1,3 +1,3 @@
-import { t as e } from "../_chunks/mount-DQ1cpppK.js";
-import { _ as t, a as n, b as r, c as i, d as a, f as o, g as s, h as c, i as l, l as u, m as d, n as f, o as p, p as m, r as h, s as g, t as _, u as v, x as y, y as b } from "../_chunks/request-trail-DSlFix6i.js";
-export { r as AI_UI_MESSAGES, o as AiActionStatus, m as AiAssistant, d as AiChangePreview, f as AiChat, h as AiChatComposer, l as AiChatContent, n as AiChatEmptyState, p as AiMessage, g as AiMessageActions, i as AiMessageContent, c as AiPromptInput, u as AiReasoning, _ as AiRequestTrail, s as AiResult, t as AiSuggestions, v as AiTask, a as AiTaskItem, b as AiTranslationProvider, e as mountAiAssistant, y as translateAiText };
+import { t as e } from "../_chunks/mount-D1i5DLRn.js";
+import { C as t, E as n, S as r, T as i, _ as a, a as o, b as s, c, d as l, f as u, g as d, h as f, i as p, l as m, m as h, n as g, o as _, p as v, r as y, s as b, t as x, u as S, w as C, x as w, y as T } from "../_chunks/request-trail-DCOfa5zw.js";
+export { i as AI_UI_MESSAGES, u as AiActionStatus, v as AiAssistant, h as AiChangePreview, g as AiChat, y as AiChatComposer, p as AiChatContent, o as AiChatEmptyState, _ as AiMessage, b as AiMessageActions, c as AiMessageContent, f as AiPromptInput, m as AiReasoning, x as AiRequestTrail, d as AiResult, w as AiResultMetrics, r as AiResultTable, s as AiResultText, T as AiResultView, a as AiSuggestions, S as AiTask, l as AiTaskItem, C as AiTranslationProvider, t as formatAiResultValue, e as mountAiAssistant, n as translateAiText };

package/ai/mount.d.ts

@@ -1,5 +1,7 @@
+import { AiResultContent, AiTableRenderer } from './results';
+import { AiChatEmptyStateProps } from './chat';
 import { AiUiTranslations } from './translations';
-import { AiActionPhase, AiPromptInputProps, AiSuggestionChoice } from './components';
+import { AiActionPhase, AiPromptInputProps, AiPreviewChange, AiSuggestionChoice } from './components';
 import { AiRequestTrailItem, AiRequestTrailProps } from './request-trail';
 import { AiPromptHistoryOptions } from './prompt-history';
 export interface AiAssistantMountState {
@@ -14,9 +16,12 @@ export interface AiAssistantMountState {
     message: string;
     /** Plain text from a bounded host-owned action result. */
     resultDetails?: string;
+    result?: AiResultContent;
     pendingAction?: {
         summary: string;
         details?: string;
+        changes?: readonly AiPreviewChange[];
+        notice?: string;
     };
     canUndoData?: boolean;
     canRedoData?: boolean;
@@ -28,7 +33,18 @@ export interface AiAssistantMountState {
     canEditSteps?: boolean;
 }
 export interface AiAssistantMountOptions {
+    /** Trusted host renderer for tabular results; never supplied by model output. */
+    renderTable?: AiTableRenderer;
     mode?: 'toolbar' | 'chat';
+    layout?: 'flow' | 'fill';
+    /** Optional host for reactive undo/redo and view controls. Cleaned up on destroy. */
+    controlsMountTo?: HTMLElement;
+    /** Hide the chat-clearing control while preserving the transcript. Defaults to true. */
+    showClearChat?: boolean;
+    /** Hide Restore/Reset, Clear chat and data history controls without disabling their controller methods. */
+    showHistoryControls?: boolean;
+    /** Optional welcome content shown only while the local chat transcript is empty. */
+    emptyState?: AiChatEmptyStateProps | false;
     onClearChat?(): void;
     /** Local input recall and optional host persistence; never sent to the model automatically. */
     promptHistory?: AiPromptHistoryOptions;

package/ai/results/_style.scss

@@ -0,0 +1,80 @@
+.rv-ai-result-content {
+  min-width: 0;
+  border: 1px solid var(--rv-ui-border);
+  border-radius: 0.75rem;
+  padding: 1rem;
+  background: var(--rv-ui-surface);
+  overflow-wrap: anywhere;
+}
+.rv-ai-result-table-scroll {
+  max-width: 100%;
+  overflow: auto;
+}
+.rv-ai-result-content--grid {
+  border: 0;
+  border-radius: 0;
+  padding: 0;
+  background: transparent;
+}
+.rv-ai-result-table {
+  width: 100%;
+  white-space: nowrap;
+  overflow-wrap: normal;
+  border-collapse: collapse;
+  font: inherit;
+  caption {
+    text-align: start;
+    padding-block-end: 0.75rem;
+  }
+  caption span {
+    display: block;
+    color: var(--rv-ui-text-muted);
+    font-size: 0.8125rem;
+    margin-block-start: 0.25rem;
+  }
+  th,
+  td {
+    min-width: 6rem;
+    padding: 0.625rem;
+    text-align: start;
+    border-block-end: 1px solid var(--rv-ui-border);
+  }
+  th {
+    color: var(--rv-ui-text-muted);
+    font-weight: 500;
+  }
+  tbody tr:last-child td {
+    border: 0;
+  }
+  .rv-ai-result-number {
+    min-width: 4rem;
+    text-align: end;
+    font-variant-numeric: tabular-nums;
+    white-space: nowrap;
+  }
+}
+.rv-ai-result-description,
+.rv-ai-result-empty {
+  color: var(--rv-ui-text-muted);
+  margin-block: 0.25rem 0;
+}
+.rv-ai-result-metrics {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(min(100%, 8rem), 1fr));
+  gap: 1rem;
+  margin-block: 1rem 0;
+  dt {
+    color: var(--rv-ui-text-muted);
+    font-size: 0.8125rem;
+  }
+  dd {
+    margin: 0.25rem 0 0;
+    font-size: 1.25rem;
+    font-weight: 600;
+    font-variant-numeric: tabular-nums;
+  }
+}
+.rv-ai-result-text {
+  margin-block-end: 0;
+  white-space: pre-wrap;
+}

package/ai/results/index.d.ts

@@ -0,0 +1,11 @@
+import { ComponentChildren } from '../../_vendor/preact/src/index';
+import { AiResultContent, AiTableResult } from './types';
+export type AiTableRenderer = (result: AiTableResult) => ComponentChildren;
+export * from './types';
+export * from './table';
+export * from './metrics';
+export * from './text';
+export declare function AiResultView({ result, renderTable }: {
+    result: AiResultContent;
+    renderTable?: AiTableRenderer;
+}): ComponentChildren;

package/ai/results/metrics.d.ts

@@ -0,0 +1,5 @@
+import { h } from '../../_vendor/preact/src/index';
+import { AiMetricsResult } from './types';
+export declare function AiResultMetrics({ result }: {
+    result: AiMetricsResult;
+}): h.JSX.Element;

package/ai/results/table.d.ts

@@ -0,0 +1,5 @@
+import { h } from '../../_vendor/preact/src/index';
+import { AiTableResult } from './types';
+export declare function AiResultTable({ result }: {
+    result: AiTableResult;
+}): h.JSX.Element;

package/ai/results/text.d.ts

@@ -0,0 +1,5 @@
+import { h } from '../../_vendor/preact/src/index';
+import { AiTextResult } from './types';
+export declare function AiResultText({ result }: {
+    result: AiTextResult;
+}): h.JSX.Element;

package/ai/results/types.d.ts

@@ -0,0 +1,29 @@
+/** Presentation-only values. No HTML, grid records or executable render callbacks. */
+export type AiResultValue = string | number | boolean | null;
+interface ResultBase {
+    title: string;
+    description?: string;
+}
+export interface AiTableResult extends ResultBase {
+    kind: 'table';
+    columns: readonly {
+        label: string;
+        numeric?: boolean;
+    }[];
+    rows: readonly (readonly AiResultValue[])[];
+}
+export interface AiMetricsResult extends ResultBase {
+    kind: 'metrics';
+    items: readonly {
+        label: string;
+        value: AiResultValue;
+    }[];
+}
+export interface AiTextResult extends ResultBase {
+    kind: 'text';
+    text: string;
+}
+/** Add new result kinds here and their renderer in AiResultView. */
+export type AiResultContent = AiTableResult | AiMetricsResult | AiTextResult;
+export declare function formatAiResultValue(value: AiResultValue): string;
+export {};