@revolist/ui 4.0.3-rc → 4.0.3

package/_shared/data-query/load-options.d.ts

@@ -5,9 +5,9 @@ import type { QueryObserverOptions } from '@tanstack/query-core';
 /** Read policy only: identity, transport, acceptance framing and projection stay engine-owned. */
 export declare const nativeReadOptionKeys: readonly ["enabled", "staleTime", "gcTime", "refetchInterval", "refetchIntervalInBackground", "refetchOnMount", "refetchOnWindowFocus", "refetchOnReconnect", "retry", "retryDelay", "retryOnMount", "networkMode", "meta"];
 /** Native callbacks receive the native Query; its cached data is engine-owned/opaque. */
-export type NativeReadOptions = Pick<QueryObserverOptions<unknown, unknown>, typeof nativeReadOptionKeys[number]>;
+export type NativeReadOptions = Pick<QueryObserverOptions<unknown, unknown>, (typeof nativeReadOptionKeys)[number]>;
 /** Also protects JavaScript callers from overriding keys, queryFn or acceptance framing. */
-export declare function nativeReadOptions<FnData, Data = FnData>(options?: NativeReadOptions): Pick<QueryObserverOptions<FnData, unknown, Data, Data>, typeof nativeReadOptionKeys[number]>;
+export declare function nativeReadOptions<FnData, Data = FnData>(options?: NativeReadOptions): Pick<QueryObserverOptions<FnData, unknown, Data, Data>, (typeof nativeReadOptionKeys)[number]>;
 /**
  * Optional native read policies plus shared scope, consistency and product reconciliation.
  * Native options: enabled, staleTime, gcTime, refetchInterval, refetchIntervalInBackground,

package/_variables.scss

@@ -1,3 +1,4 @@
+@use 'styles/built-in-palettes' as palettes;
 @use './styles/palette';
 /**
 * Variables
@@ -5,47 +6,48 @@
 
 $rv-font-weight-medium: 500 !default;
 
-$primary-color-light: palette.$legacy-007bff;
-$primary-color-dark: palette.$legacy-0d63e8;
+$primary-color-light: palettes.color('common', 'hex007bff');
+$primary-color-dark: palettes.color('common', 'hex0d63e8');
 
-$text-color-light: palette.$legacy-000;
-$text-color-light-secondary: palette.$legacy-757575;
+$text-color-light: palettes.color('common', 'hex000');
+$text-color-light-secondary: palettes.color('common', 'hex757575');
 $text-color-dark: palette.$white;
-$text-color-dark-secondary: palette.$legacy-999;
-$background-color-light: palette.$legacy-f6f6f7;
+$text-color-dark-secondary: palettes.color('common', 'hex999');
+$background-color-light: palettes.color('common', 'hexf6f6f7');
 
-$button-alt-bg-light: palette.$legacy-ebebef;
-$button-alt-bg-light-hover: palette.$legacy-e4e4e9;
+$button-alt-bg-light: palettes.color('common', 'hexebebef');
+$button-alt-bg-light-hover: palettes.color('common', 'hexe4e4e9');
 
-$background-color-dark: palette.$legacy-333333;
+$background-color-dark: palettes.color('common', 'hex333333');
 
-$border-color-light: palette.$legacy-ebebef;
-$border-color-dark: palette.$legacy-ebebef;
+$border-color-light: palettes.color('common', 'hexebebef');
+$border-color-dark: palettes.color('common', 'hexebebef');
 
-$rv-badge-bg-color: palette.$legacy-f0f0f0;
-$rv-badge-bg-color-dark: palette.$legacy-2d2d2d;
+$rv-badge-bg-color: palettes.color('common', 'hexf0f0f0');
+$rv-badge-bg-color-dark: palettes.color('common', 'hex2d2d2d');
 
 $rv-popup-bg-color: palette.$white;
-$rv-popup-border-color: palette.$legacy-d4d4d4;
+$rv-popup-border-color: palettes.color('common', 'hexd4d4d4');
 $rv-popup-border-opacity: 0.5;
-$rv-popup-shadow-color: palette.$legacy-shadow-54;
-$rv-popup-hover-bg-color: palette.$legacy-f6f6f7;
+$rv-popup-shadow-color: palettes.color('common', 'rgba_0_0_0_0_15');
+$rv-popup-hover-bg-color: palettes.color('common', 'hexf6f6f7');
 $rv-popup-border-radius: 8px;
 $rv-popup-padding: 10px;
-$rv-popup-box-shadow: 0 4px 12px #{palette.$legacy-shadow-54};
-$rv-popup-bg-color-dark: palette.$legacy-1c1c1c;
-$rv-popup-border-color-dark: palette.$legacy-686868;
+$rv-popup-box-shadow: 0 4px 12px #{palettes.color('common', 'rgba_0_0_0_0_15')};
+$rv-popup-bg-color-dark: palettes.color('common', 'hex1c1c1c');
+$rv-popup-border-color-dark: palettes.color('common', 'hex686868');
 $rv-popup-border-opacity-dark: 0;
-$rv-popup-shadow-color-dark: palette.$legacy-shadow-57;
-$rv-popup-hover-bg-color-dark: palette.$legacy-2c2c2c;
-$rv-popup-box-shadow-dark: 0 4px 12px #{palette.$legacy-shadow-57};
-
-$rv-low-color: palette.$legacy-fa2057;
-$rv-medium-color: palette.$legacy-f7c605;
-$rv-high-color: palette.$legacy-01c26e;
-$rv-critical-color: palette.$legacy-a8183c;
-$rv-info-color: palette.$legacy-5555fc;
-$rv-neutral-color: palette.$legacy-161a42;
-
-$rv-progress-bg-color: palette.$legacy-f0f0f0;
-$rv-progress-bg-color-dark: palette.$legacy-252525;
+$rv-popup-shadow-color-dark: palettes.color('common', 'rgba_0_0_0_0_5');
+$rv-popup-hover-bg-color-dark: palettes.color('common', 'hex2c2c2c');
+$rv-popup-box-shadow-dark: 0 4px 12px
+  #{palettes.color('common', 'rgba_0_0_0_0_5')};
+
+$rv-low-color: palettes.color('common', 'hexfa2057');
+$rv-medium-color: palettes.color('common', 'hexf7c605');
+$rv-high-color: palettes.color('common', 'hex01c26e');
+$rv-critical-color: palettes.color('common', 'hexa8183c');
+$rv-info-color: palettes.color('common', 'hex5555fc');
+$rv-neutral-color: palettes.color('common', 'hex161a42');
+
+$rv-progress-bg-color: palettes.color('common', 'hexf0f0f0');
+$rv-progress-bg-color-dark: palettes.color('common', 'hex252525');

package/_view-switcher.scss

@@ -0,0 +1,6 @@
+.rv-view-switcher-controls {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+}

package/activity-message.d.ts

@@ -9,4 +9,4 @@ export interface ActivityMessageProps {
     details?: ComponentChildren;
 }
 /** A compact, composable message with an avatar, timestamp and optional actions. */
-export declare function ActivityMessage({ className, avatar, timestamp, header, children, actions, details }: ActivityMessageProps): h.JSX.Element;
+export declare function ActivityMessage({ className, avatar, timestamp, header, children, actions, details, }: ActivityMessageProps): h.JSX.Element;

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%;
@@ -193,3 +218,10 @@
   white-space: pre-wrap;
   overflow-wrap: anywhere;
 }
+
+.rv-ai-chat-actions {
+  display: flex;
+  justify-content: flex-end;
+  align-items: center;
+  gap: 0.25rem;
+}

package/ai/_style.scss

@@ -1,4 +1,5 @@
 @use './chat';
+@use './results/style';
 .rv-ai-assistant {
   box-sizing: border-box;
   width: 100%;
@@ -86,21 +87,6 @@
 .rv-ai-request-trail {
   min-width: 0;
 }
-.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 {
-    color: var(--rv-ui-accent-text);
-    background: var(--rv-ui-selected-bg);
-  }
-}
-.rv-ai-trail-trigger .rv-svg-icon {
-  transition: transform var(--rv-ui-motion-fast, 120ms)
-    var(--rv-ui-motion-ease, ease);
-}
-.rv-ai-trail-trigger[aria-expanded='true'] .rv-svg-icon {
-  transform: rotate(180deg);
-}
 .rv-popover.rv-ai-trail-popover {
   box-sizing: border-box;
   width: 22rem;
@@ -161,7 +147,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 +311,73 @@
   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;
+  }
+}
+
+// Keep the trigger compact while giving long requests room in the shared popup.
+.rv-ai-examples-menu {
+  box-sizing: border-box;
+  width: min(420px, calc(100vw - 16px));
+  max-width: calc(100vw - 16px);
+
+  .dropdown-option {
+    min-height: 36px;
+    white-space: normal;
+  }
+}

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

@@ -32,13 +32,15 @@ export interface AiSuggestionChoice {
     prompt: string;
 }
 export interface AiSuggestionsProps {
+    /** Number of inline choices; remaining choices are available under More. Default: 2. */
+    maxVisible?: number;
     translations?: AiUiTranslations;
     items: readonly (string | AiSuggestionChoice)[];
     onSelect(value: string): void;
     disabled?: boolean;
     label?: string;
 }
-export declare function AiSuggestions({ translations, items, onSelect, disabled, label, }: AiSuggestionsProps): h.JSX.Element | null;
+export declare function AiSuggestions({ translations, items, onSelect, disabled, label, maxVisible, }: AiSuggestionsProps): h.JSX.Element | null;
 export interface AiActionStatusProps {
     translations?: AiUiTranslations;
     phase: AiActionPhase;
@@ -55,6 +57,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 +66,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-BRdcG60g.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-DrhdpWiH.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;
@@ -26,10 +31,30 @@ export interface AiAssistantMountState {
     choices?: readonly AiSuggestionChoice[];
     steps?: readonly AiRequestTrailItem[];
     canEditSteps?: boolean;
+    /** Host-owned chart view can return to the record grid. */
+    canClearChart?: boolean;
+    viewSwitching?: 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;
+    /** Show the separate New conversation icon. Defaults to true. */
+    showNewConversation?: boolean;
+    /** @deprecated Use showNewConversation. */
+    showClearChat?: boolean;
+    /** Request-history popup: hidden by default in chat, visible in toolbar mode. */
+    showRequestHistory?: boolean;
+    /** Hide native data Undo/Redo controls. Workspace reset belongs to the application. */
+    showHistoryControls?: boolean;
+    /** Optional welcome content shown only while the local chat transcript is empty. */
+    emptyState?: AiChatEmptyStateProps | false;
     onClearChat?(): void;
+    /** Return to the grid while retaining the chart configuration. */
+    onClearChart?(): void;
     /** Local input recall and optional host persistence; never sent to the model automatically. */
     promptHistory?: AiPromptHistoryOptions;
     /** Auto-dismiss settled activity messages; disabled unless configured. */
@@ -41,16 +66,15 @@ export interface AiAssistantMountOptions {
     onRedoData?(): void;
     onSubmit(prompt: string): void;
     onStop(): void;
-    onRestore(): void;
-    onReset(): void;
     onRemoveStep?(id: string): void;
     suggestions?: readonly string[];
+    /** Inline choice count; additional choices remain under More. Default: 2. */
+    maxVisibleSuggestions?: number;
     label?: string;
     footer?: string;
-    restoreLabel?: string;
-    resetLabel?: string;
+    /** Format the matched-row count in command activity, independently of request history. */
     countLabel?: (count: number) => string;
-    trail?: Pick<AiRequestTrailProps, 'label' | 'triggerLabel' | 'clearLabel' | 'clearDescription' | 'removeLabel' | 'countLabel' | 'changedMessage'>;
+    trail?: Pick<AiRequestTrailProps, 'label' | 'triggerLabel' | 'removeLabel' | 'countLabel' | 'changedMessage'>;
     prompt?: Pick<AiPromptInputProps, 'label' | 'placeholder' | 'submitLabel' | 'stopLabel' | 'hint' | 'textareaProps'>;
 }
 /** Framework-independent mount of the same TSX used by the public components. */

package/ai/request-trail.d.ts

@@ -1,7 +1,9 @@
 import { AiUiTranslations } from './translations';
-import { h } from '../_vendor/preact/src/index';
+import { h, ComponentChildren } from '../_vendor/preact/src/index';
 export interface AiRequestTrailItem {
     id: string;
+    /** Hide removal when the host cannot safely undo this individual request. */
+    removable?: boolean;
     label: string;
     /** Number of earlier requests represented by a grouped step. */
     count?: number;
@@ -10,8 +12,12 @@ export interface AiRequestTrailProps {
     translations?: AiUiTranslations;
     items: readonly AiRequestTrailItem[];
     onRemove(id: string): void;
-    onClear(): void;
+    onClear?(): void;
     onEmpty?(): void;
+    /** Additional host-owned actions in the steps popup. */
+    footer?: ComponentChildren;
+    /** Optional application-owned clear action for standalone history presentation. */
+    showClear?: boolean;
     disabled?: boolean;
     removalsDisabled?: boolean;
     label?: string;
@@ -23,4 +29,4 @@ export interface AiRequestTrailProps {
     changedMessage?: string;
 }
 /** Applied context only. The host owns replay, persistence and view mutations. */
-export declare function AiRequestTrail({ translations, items, onRemove, onClear, onEmpty, disabled, removalsDisabled, label, triggerLabel, clearLabel, clearDescription, removeLabel, countLabel, changedMessage, }: AiRequestTrailProps): h.JSX.Element | null;
+export declare function AiRequestTrail({ translations, items, onRemove, onClear, onEmpty, footer, showClear, disabled, removalsDisabled, label, triggerLabel, clearLabel, clearDescription, removeLabel, countLabel, changedMessage, }: AiRequestTrailProps): h.JSX.Element | null;

package/ai/results/_style.scss

@@ -0,0 +1,83 @@
+.rv-ai-result-content {
+  box-sizing: border-box;
+  width: 100%;
+  max-width: 100%;
+  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 {};

package/ai/transcript.d.ts

@@ -1,4 +1,5 @@
 import { AiAssistantMountState } from './mount';
+import { AiResultContent } from './results';
 export interface AiTranscriptMessage {
     id: string;
     group: string;
@@ -6,6 +7,7 @@ export interface AiTranscriptMessage {
     text: string;
     phase?: AiAssistantMountState['phase'];
     details?: string;
+    result?: AiResultContent;
     pending?: boolean;
 }
 /** Local presentation state only. Never supplies model context or persists values. */

package/ai/translations.d.ts

@@ -1,4 +1,4 @@
 /** English message IDs and fallbacks; hosts supply translated values. */
-export declare const AI_UI_MESSAGES: readonly ["AI chat", "Clear chat", "Conversation messages", "Jump to latest", "You", "Assistant", "System", "Message actions", "Start a conversation", "Ask a question to get started.", "Message", "Type a message…", "Working…", "Reasoning summary", "Pending", "Running", "Completed", "Failed", "Cancelled", "{seconds}s", "Data history", "Review changes", "Apply changes", "Cancel changes", "Undo data change", "Redo data change", "Ask AI to change this view", "Filter or sort your data…", "Send", "Stop", "Enter to send · Shift+Enter for a new line", "Suggested requests", "More", "Activity", "Collapse activity", "Expand activity", "AI view assistant", "View steps", "Clear all", "Restore the starting view", "Restore previous view", "Reset view", "The view changed manually. Start a new request to continue.", "Remove request: {label}", "{count} step", "{count} steps", "{count} applied request", "{count} applied requests", "{count} matching rows"];
+export declare const AI_UI_MESSAGES: readonly ["AI chat", "No results", "Clear chat", "Restart conversation", "New conversation", "Request history", "Clear chart", "Conversation messages", "Jump to latest", "You", "Assistant", "System", "Message actions", "Start a conversation", "Ask a question to get started.", "Message", "Type a message…", "Working…", "Reasoning summary", "Pending", "Running", "Completed", "Failed", "Cancelled", "{seconds}s", "Data history", "Review changes", "Proposed changes", "Change", "Current", "Proposed", "Apply changes", "Cancel changes", "Undo data change", "Redo data change", "Ask AI to change this view", "Filter or sort your data…", "Send", "Stop", "Enter to send · Shift+Enter for a new line", "Suggested requests", "More", "Search requests", "Activity", "Collapse activity", "Expand activity", "AI view assistant", "View steps", "Clear all", "Restore the starting view", "Restore previous view", "Reset view", "The view changed manually. Start a new request to continue.", "Remove request: {label}", "{count} step", "{count} steps", "{count} applied request", "{count} applied requests", "{count} matching rows"];
 export type AiUiTranslations = Partial<Record<(typeof AI_UI_MESSAGES)[number], string>>;
 export declare function translateAiText(text: string, translations?: Readonly<Record<string, string | undefined>>, values?: Readonly<Record<string, string | number>>): string;