@accurix/centrinfo-widget 5.0.0 → 5.1.0

package/dist/runtime.d.cts

@@ -1,42 +1,38 @@
-import { C as WidgetStrings, S as StringsProvider, _ as DemoSlotsResult, a as MessageAttachment, b as PublicChatActionField, c as Visitor, f as WidgetThemeTokens, g as DemoBooking, h as AnalyticsVisualization, i as FeaturedLink, l as WidgetActionTranslation, m as ActionResult, n as ChatArtifact, o as SchedulerInfo, p as WidgetUser, r as ChatMessage, s as Source, t as BootstrapInfo, u as WidgetConfig, v as GifResult, x as Transport, y as PublicChatAction } from "./types-BGKFxmKB.cjs";
-import * as preact0 from "preact";
+import { C as StringsProvider, D as AnalyticsExplanationInput, E as AnalyticsAIExplanationTransport, O as AnalyticsGroupComparisonPoint, S as Transport, T as ResultLabels, _ as DemoSlotsResult, a as MessageAttachment, b as PublicChatAction, c as Visitor, f as WidgetThemeTokens, g as DemoBooking, h as AnalyticsVisualization, i as FeaturedLink, k as AnalyticsPeriodComparison, l as WidgetActionTranslation, m as ActionResult, n as ChatArtifact, o as SchedulerInfo, p as WidgetUser, r as ChatMessage, s as Source, t as BootstrapInfo, u as WidgetConfig, v as ExplanationFeedbackInput, w as WidgetStrings, x as PublicChatActionField, y as GifResult } from "./types-CYFMH8yg.cjs";
+import * as preact1 from "preact";
 import { JSX } from "preact";
 
-//#region src/config.d.ts
-interface ResolvedConfig extends Required<Omit<WidgetConfig, 'accentColor' | 'agentName' | 'agentAvatarUrl' | 'launcherIcon' | 'themeTokens' | 'gifApiKey' | 'labels' | 'locale' | 'translations' | 'user' | 'analyticsContextToken' | 'identityToken' | 'getIdentityToken' | 'customLauncherSelector' | 'proactiveMessage' | 'proactiveOnPaths' | 'onOpen' | 'onClose' | 'onShow' | 'onHide' | 'onUnreadChange' | 'onMessage' | 'onAction' | 'onHandoff'>> {
-  accentColor?: string;
-  agentName?: string;
-  agentAvatarUrl?: string;
-  launcherIcon?: string;
-  themeTokens?: WidgetConfig['themeTokens'];
-  gifApiKey?: string;
-  /** Resolved string table (English defaults + host `labels` overrides). */
-  strings: WidgetStrings;
-  locale: string;
-  actionTranslations: Record<string, WidgetActionTranslation>;
-  /** Host-app SSO passthrough (see WidgetConfig.user). Optional. */
-  user?: WidgetConfig['user'];
-  /** Short-lived signed context for governed customer analytics. */
-  analyticsContextToken?: WidgetConfig['analyticsContextToken'];
-  identityToken?: WidgetConfig['identityToken'];
-  getIdentityToken?: WidgetConfig['getIdentityToken'];
-  customLauncherSelector?: string;
-  proactiveMessage?: string;
-  proactiveOnPaths?: string[];
-  onOpen?: WidgetConfig['onOpen'];
-  onClose?: WidgetConfig['onClose'];
-  onShow?: WidgetConfig['onShow'];
-  onHide?: WidgetConfig['onHide'];
-  onUnreadChange?: WidgetConfig['onUnreadChange'];
-  onMessage?: WidgetConfig['onMessage'];
-  onAction?: WidgetConfig['onAction'];
-  onHandoff?: WidgetConfig['onHandoff'];
-}
-declare const resolveConfig: (cfg: WidgetConfig) => ResolvedConfig;
-//#endregion
 //#region ../centrinfo-results/src/analytics-chart-catalog.d.ts
 type AnalyticsChartCatalogType = 'kpi' | 'table' | 'line' | 'bar' | 'pie' | 'scatter' | 'effectScatter' | 'map' | 'candlestick' | 'boxplot' | 'graph' | 'lines' | 'tree' | 'treemap' | 'sunburst' | 'parallel' | 'sankey' | 'funnel' | 'heatmap' | 'radar' | 'gauge' | 'pictorialBar' | 'themeRiver' | 'matrix' | 'chord' | 'custom' | 'dataset' | 'dataZoom' | 'graphic' | 'richText' | 'globe' | 'bar3D' | 'scatter3D' | 'surface' | 'map3D' | 'lines3D' | 'line3D' | 'scatterGL' | 'linesGL' | 'flowGL' | 'graphGL' | 'polygons3D';
 //#endregion
+//#region ../centrinfo-results/src/format.d.ts
+/**
+ * The one place numbers, currency, percentages and dates are formatted, so the
+ * chart axis, tooltip, table and KPI show the same value the same way.
+ *
+ * Rules:
+ * - Currency comes from column metadata (`currencyCode`) or the result's fixed
+ *   currency. With no known code the amount is shown as a plain number.
+ * - A `percent` column is read as percentage points (0.5 is "0.5%") unless its
+ *   `formatPattern` contains `%` (Excel style), which marks a fraction (0.5 is
+ *   "50%"). Magnitude is never used to guess.
+ * - Date-only values (`2024-03-05`) are calendar dates: they are formatted in
+ *   UTC so they never shift a day. Instants are formatted in the result
+ *   timezone. Granularity follows column metadata, the result's comparison
+ *   grain, or the shape of the values — a daily series is never "Mar 2024".
+ */
+type ResultGrain = 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
+interface ResultFormatContext {
+  locale?: string;
+  /** IANA zone of the result; used for instants, never for date-only values. */
+  timezone?: string;
+  grain?: ResultGrain;
+  /** Result-level fixed currency, used when the column has none. */
+  currencyCode?: string;
+  yes?: string;
+  no?: string;
+}
+//#endregion
 //#region ../centrinfo-results/src/types.d.ts
 interface AnalyticsVisualizationColumn {
   key: string;
@@ -44,8 +40,11 @@ interface AnalyticsVisualizationColumn {
   dataType: 'text' | 'number' | 'currency' | 'percent' | 'boolean' | 'date' | 'datetime';
   semanticRole: 'identifier' | 'dimension' | 'measure' | 'date' | 'geography' | 'boolean';
   aggregation?: 'none' | 'sum' | 'avg' | 'count' | 'count_distinct' | 'min' | 'max';
+  allowedAggregations?: Array<'none' | 'sum' | 'avg' | 'count' | 'count_distinct' | 'min' | 'max'>;
   formatPattern?: string;
   currencyCode?: string;
+  /** Time granularity of a date column; drives how its values are labelled. */
+  grain?: ResultGrain;
   description?: string;
   priority?: 'primary' | 'secondary' | 'detail';
   sortable?: boolean;
@@ -65,6 +64,10 @@ interface AnalyticsVisualizationRecommendation {
   confidence?: number;
 }
 interface AnalyticsVisualization$1 {
+  /** The latest time bucket is still in progress (drawn dashed). */
+  lastPeriodInProgress?: boolean;
+  /** Like-for-like comparison basis (reader-safe). */
+  periodComparison?: AnalyticsPeriodComparison;
   version?: number;
   presentation?: 'kpi' | 'chart' | 'table';
   type: AnalyticsChartCatalogType | 'area' | 'stacked_bar';
@@ -81,6 +84,31 @@ interface AnalyticsVisualization$1 {
   rows?: Array<Record<string, unknown>>;
   rowCount?: number;
   timezone?: string;
+  freshness?: {
+    status?: string;
+    answeredAt?: string;
+  };
+  reportingPeriod?: {
+    label?: string;
+    start?: string;
+    end?: string;
+    timezone?: string;
+  };
+  appliedFilters?: Array<{
+    field: string;
+    operator: string;
+    value: unknown;
+  }>;
+  explanation?: {
+    checkedAt?: string;
+    timezone?: string;
+    dataFreshness?: {
+      status?: string;
+    };
+  };
+  expandable?: boolean;
+  tableAvailable?: boolean;
+  downloadAvailable?: boolean;
   columnMetadata?: AnalyticsVisualizationColumn[];
   currency?: {
     code?: string;
@@ -95,6 +123,8 @@ interface ResultColumn {
   label?: string;
   dataType?: AnalyticsVisualizationColumn['dataType'];
   currencyCode?: string;
+  formatPattern?: string;
+  grain?: ResultGrain;
 }
 interface ResultTableClassNames {
   wrap?: string;
@@ -108,6 +138,8 @@ type WidgetAnalyticsSeries = {
   name: string;
   values: Array<number | null>;
   valueColumn?: AnalyticsVisualizationColumn;
+  /** Like-for-like breakdown: per-point comparison (tooltip detail). */
+  points?: Array<AnalyticsGroupComparisonPoint | undefined>;
 };
 type WidgetAnalyticsChartType = 'line' | 'bar' | 'stacked_bar';
 type WidgetAnalyticsChartModel = {
@@ -119,18 +151,34 @@ type WidgetAnalyticsChartModel = {
   series: WidgetAnalyticsSeries[];
   summary: string;
   omittedSeriesCount: number;
+  /** Index of the in-progress (latest) time bucket, drawn dashed / faded. */
+  inProgressIndex?: number;
+  /** Like-for-like breakdown: the comparison drawn (previous-to-date bars). */
+  comparison?: AnalyticsPeriodComparison;
+  /** "Today so far, compared with yesterday at this time". */
+  comparisonNote?: string;
+  locale?: string;
+  /** Resolved copy used by the chart's tooltips, summary and zoom controls. */
+  labels: ResultLabels;
+};
+type WidgetAnalyticsChartOptions = {
+  locale?: string;
+  labels?: Partial<ResultLabels>;
 };
-declare const buildWidgetAnalyticsChartModel: (visualization: AnalyticsVisualization$1, overrideType?: WidgetAnalyticsChartType) => WidgetAnalyticsChartModel | null;
+declare const buildWidgetAnalyticsChartModel: (visualization: AnalyticsVisualization$1, overrideType?: WidgetAnalyticsChartType, options?: WidgetAnalyticsChartOptions) => WidgetAnalyticsChartModel | null;
 declare const WidgetAnalyticsChart: ({
   model,
-  expanded
+  expanded,
+  classPrefix: p
 }: {
   model: WidgetAnalyticsChartModel;
   expanded?: boolean;
-}) => preact0.JSX.Element;
+  /** Class prefix of the surface (`cf` widget, `ca` chat app). */
+  classPrefix?: string;
+}) => preact1.JSX.Element;
 //#endregion
 //#region ../centrinfo-results/src/result.d.ts
-declare const formatResultCell: (value: unknown, locale?: string, column?: ResultColumn) => string;
+declare const formatResultCell: (value: unknown, locale?: string, column?: ResultColumn, context?: ResultFormatContext) => string;
 declare const serializeResultCsv: (rows: Array<Record<string, unknown>>, columns?: Array<string | ResultColumn>) => string;
 //#endregion
 //#region ../centrinfo-results/src/table.d.ts
@@ -139,6 +187,8 @@ interface ResultTableProps {
   columns?: Array<string | ResultColumn>;
   maxRows?: number;
   locale?: string;
+  /** Timezone / grain / currency context so cells format like the chart. */
+  format?: ResultFormatContext;
   expanded?: boolean;
   classNames?: ResultTableClassNames;
   emptyLabel?: string;
@@ -148,14 +198,67 @@ declare const ResultTable: ({
   columns,
   maxRows,
   locale,
+  format,
   expanded,
   classNames,
   emptyLabel
-}: ResultTableProps) => preact0.JSX.Element;
+}: ResultTableProps) => preact1.JSX.Element;
+//#endregion
+//#region ../centrinfo-results/src/result-details.d.ts
+interface AnalyticsResultDetail {
+  label: string;
+  value: string;
+}
+//#endregion
+//#region src/config.d.ts
+interface ResolvedConfig extends Required<Omit<WidgetConfig, 'accentColor' | 'agentName' | 'agentAvatarUrl' | 'launcherIcon' | 'themeTokens' | 'gifApiKey' | 'labels' | 'locale' | 'dir' | 'translations' | 'user' | 'analyticsContextToken' | 'identityToken' | 'getIdentityToken' | 'customLauncherSelector' | 'proactiveMessage' | 'proactiveOnPaths' | 'onOpen' | 'onClose' | 'onShow' | 'onHide' | 'onUnreadChange' | 'onMessage' | 'onOpenAnalyticsSource' | 'onAction' | 'onHandoff'>> {
+  accentColor?: string;
+  agentName?: string;
+  agentAvatarUrl?: string;
+  launcherIcon?: string;
+  themeTokens?: WidgetConfig['themeTokens'];
+  gifApiKey?: string;
+  /** Resolved string table (English defaults + host `labels` overrides). */
+  strings: WidgetStrings;
+  locale: string;
+  /** Resolved text direction (from `dir`, else the locale). */
+  dir: 'ltr' | 'rtl';
+  actionTranslations: Record<string, WidgetActionTranslation>;
+  /** Host-app SSO passthrough (see WidgetConfig.user). Optional. */
+  user?: WidgetConfig['user'];
+  /** Short-lived signed context for governed customer analytics. */
+  analyticsContextToken?: WidgetConfig['analyticsContextToken'];
+  identityToken?: WidgetConfig['identityToken'];
+  getIdentityToken?: WidgetConfig['getIdentityToken'];
+  customLauncherSelector?: string;
+  proactiveMessage?: string;
+  proactiveOnPaths?: string[];
+  onOpen?: WidgetConfig['onOpen'];
+  onClose?: WidgetConfig['onClose'];
+  onShow?: WidgetConfig['onShow'];
+  onHide?: WidgetConfig['onHide'];
+  onUnreadChange?: WidgetConfig['onUnreadChange'];
+  onMessage?: WidgetConfig['onMessage'];
+  onOpenAnalyticsSource?: WidgetConfig['onOpenAnalyticsSource'];
+  onAction?: WidgetConfig['onAction'];
+  onHandoff?: WidgetConfig['onHandoff'];
+}
+declare const resolveConfig: (cfg: WidgetConfig) => ResolvedConfig;
+//#endregion
+//#region src/api/factory.d.ts
+/**
+ * The real client is bundled; the demo and preview transports are fetched the
+ * first time they are used, so production widgets never download them.
+ */
+declare const createChatTransport: (config: ResolvedConfig) => Transport;
 //#endregion
 //#region src/rich.d.ts
 declare const renderRich: (text: string) => JSX.Element[];
 //#endregion
+//#region src/result-details.d.ts
+/** Reader-safe result context shared by the floating widget and chat app. */
+declare const analyticsResultDetails: (result: AnalyticsVisualization, labels?: Partial<ResultLabels>, locale?: string) => AnalyticsResultDetail[];
+//#endregion
 //#region src/useChat.d.ts
 /** One past conversation, for the in-widget history list. */
 interface HistoryEntry {
@@ -252,6 +355,12 @@ interface ChatApi {
   retry: (agentId: string, question: string, opts?: Pick<SendOpts, 'forceVoicePlayback'>) => void;
   /** Record a 👍/👎 on an assistant reply (optional comment on 👎). Optimistic. */
   rateMessage: (messageId: string, rating: 'up' | 'down', comment?: string) => void;
+  /** Record a vote on an analytics explanation. Rejects when it could not be
+   *  saved (or the transport has no explanation feedback) so the UI can retry. */
+  rateExplanation: (input: Omit<ExplanationFeedbackInput, 'sessionId' | 'surface'>, surface?: ExplanationFeedbackInput['surface']) => Promise<void>;
+  /** Poll / retry the detailed AI explanation of an analytics answer for this
+   *  session; undefined when the transport cannot. */
+  explanationTransport: (surface?: ExplanationFeedbackInput['surface']) => AnalyticsAIExplanationTransport<AnalyticsExplanationInput> | undefined;
   /** Append a proactive assistant message (auto-engagement). No-op duplicate-guarded. */
   injectAssistant: (content: string) => void;
   /** After a teammate handed the chat back to the AI: offer the live-support
@@ -421,6 +530,5 @@ declare const stopRecorderWithFlush: (recorder: MediaRecorder | null | undefined
  * surface maps onto its own theme.
  */
 declare const WIDGET_ACTION_STYLES: string;
-declare const createChatTransport: (config: ResolvedConfig) => Transport;
 //#endregion
-export { type ActionResult, ActionsArea, type AnalyticsVisualization, type BootstrapInfo, type ChatApi, type ChatArtifact, type ChatMessage, type DemoSlotsResult, type HistoryEntry, type MessageAttachment, type PublicChatAction, type PublicChatActionField, type ResolvedConfig, ResultTable, type Source, StringsProvider, type Transport, type VoiceReply, WIDGET_ACTION_STYLES, WidgetAnalyticsChart, type WidgetConfig, type WidgetThemeTokens, type WidgetUser, buildWidgetAnalyticsChartModel, createAdaptiveVoiceActivityDetector, createChatTransport, createPreferredAudioRecorder, createVoiceAudioConstraints, findLiveSupportAction, formatResultCell, looksLikeEcho, reconnectableHandbackId, renderRich, resolveConfig, selectStyleRules, serializeResultCsv, stopRecorderWithFlush, usableTranscript, useChat };
+export { type ActionResult, ActionsArea, type AnalyticsVisualization, type BootstrapInfo, type ChatApi, type ChatArtifact, type ChatMessage, type DemoSlotsResult, type HistoryEntry, type MessageAttachment, type PublicChatAction, type PublicChatActionField, type ResolvedConfig, ResultTable, type Source, StringsProvider, type Transport, type VoiceReply, WIDGET_ACTION_STYLES, WidgetAnalyticsChart, type WidgetConfig, type WidgetThemeTokens, type WidgetUser, analyticsResultDetails, buildWidgetAnalyticsChartModel, createAdaptiveVoiceActivityDetector, createChatTransport, createPreferredAudioRecorder, createVoiceAudioConstraints, findLiveSupportAction, formatResultCell, looksLikeEcho, reconnectableHandbackId, renderRich, resolveConfig, selectStyleRules, serializeResultCsv, stopRecorderWithFlush, usableTranscript, useChat };

package/dist/runtime.d.mts

@@ -1,9 +1,8 @@
-import { C as WidgetStrings, S as StringsProvider, _ as DemoSlotsResult, a as MessageAttachment, b as PublicChatActionField, c as Visitor, f as WidgetThemeTokens, g as DemoBooking, h as AnalyticsVisualization, i as FeaturedLink, l as WidgetActionTranslation, m as ActionResult, n as ChatArtifact, o as SchedulerInfo, p as WidgetUser, r as ChatMessage, s as Source, t as BootstrapInfo, u as WidgetConfig, v as GifResult, x as Transport, y as PublicChatAction } from "./types-DhmmWqaj.mjs";
-import * as preact0 from "preact";
+import { A as buildWidgetAnalyticsChartModel, C as StringsProvider, D as formatResultCell, E as ResultTable, M as AnalyticsAIExplanationTransport, N as AnalyticsExplanationInput, O as serializeResultCsv, S as Transport, T as AnalyticsResultDetail, _ as DemoSlotsResult, a as MessageAttachment, b as PublicChatAction, c as Visitor, f as WidgetThemeTokens, g as DemoBooking, h as AnalyticsVisualization, i as FeaturedLink, j as ResultLabels, k as WidgetAnalyticsChart, l as WidgetActionTranslation, m as ActionResult, n as ChatArtifact, o as SchedulerInfo, p as WidgetUser, r as ChatMessage, s as Source, t as BootstrapInfo, u as WidgetConfig, v as ExplanationFeedbackInput, w as WidgetStrings, x as PublicChatActionField, y as GifResult } from "./types-D82dr33R.mjs";
 import { JSX } from "preact";
 
 //#region src/config.d.ts
-interface ResolvedConfig extends Required<Omit<WidgetConfig, 'accentColor' | 'agentName' | 'agentAvatarUrl' | 'launcherIcon' | 'themeTokens' | 'gifApiKey' | 'labels' | 'locale' | 'translations' | 'user' | 'analyticsContextToken' | 'identityToken' | 'getIdentityToken' | 'customLauncherSelector' | 'proactiveMessage' | 'proactiveOnPaths' | 'onOpen' | 'onClose' | 'onShow' | 'onHide' | 'onUnreadChange' | 'onMessage' | 'onAction' | 'onHandoff'>> {
+interface ResolvedConfig extends Required<Omit<WidgetConfig, 'accentColor' | 'agentName' | 'agentAvatarUrl' | 'launcherIcon' | 'themeTokens' | 'gifApiKey' | 'labels' | 'locale' | 'dir' | 'translations' | 'user' | 'analyticsContextToken' | 'identityToken' | 'getIdentityToken' | 'customLauncherSelector' | 'proactiveMessage' | 'proactiveOnPaths' | 'onOpen' | 'onClose' | 'onShow' | 'onHide' | 'onUnreadChange' | 'onMessage' | 'onOpenAnalyticsSource' | 'onAction' | 'onHandoff'>> {
   accentColor?: string;
   agentName?: string;
   agentAvatarUrl?: string;
@@ -13,6 +12,8 @@ interface ResolvedConfig extends Required<Omit<WidgetConfig, 'accentColor' | 'ag
   /** Resolved string table (English defaults + host `labels` overrides). */
   strings: WidgetStrings;
   locale: string;
+  /** Resolved text direction (from `dir`, else the locale). */
+  dir: 'ltr' | 'rtl';
   actionTranslations: Record<string, WidgetActionTranslation>;
   /** Host-app SSO passthrough (see WidgetConfig.user). Optional. */
   user?: WidgetConfig['user'];
@@ -29,133 +30,26 @@ interface ResolvedConfig extends Required<Omit<WidgetConfig, 'accentColor' | 'ag
   onHide?: WidgetConfig['onHide'];
   onUnreadChange?: WidgetConfig['onUnreadChange'];
   onMessage?: WidgetConfig['onMessage'];
+  onOpenAnalyticsSource?: WidgetConfig['onOpenAnalyticsSource'];
   onAction?: WidgetConfig['onAction'];
   onHandoff?: WidgetConfig['onHandoff'];
 }
 declare const resolveConfig: (cfg: WidgetConfig) => ResolvedConfig;
 //#endregion
-//#region ../centrinfo-results/src/analytics-chart-catalog.d.ts
-type AnalyticsChartCatalogType = 'kpi' | 'table' | 'line' | 'bar' | 'pie' | 'scatter' | 'effectScatter' | 'map' | 'candlestick' | 'boxplot' | 'graph' | 'lines' | 'tree' | 'treemap' | 'sunburst' | 'parallel' | 'sankey' | 'funnel' | 'heatmap' | 'radar' | 'gauge' | 'pictorialBar' | 'themeRiver' | 'matrix' | 'chord' | 'custom' | 'dataset' | 'dataZoom' | 'graphic' | 'richText' | 'globe' | 'bar3D' | 'scatter3D' | 'surface' | 'map3D' | 'lines3D' | 'line3D' | 'scatterGL' | 'linesGL' | 'flowGL' | 'graphGL' | 'polygons3D';
-//#endregion
-//#region ../centrinfo-results/src/types.d.ts
-interface AnalyticsVisualizationColumn {
-  key: string;
-  label: string;
-  dataType: 'text' | 'number' | 'currency' | 'percent' | 'boolean' | 'date' | 'datetime';
-  semanticRole: 'identifier' | 'dimension' | 'measure' | 'date' | 'geography' | 'boolean';
-  aggregation?: 'none' | 'sum' | 'avg' | 'count' | 'count_distinct' | 'min' | 'max';
-  formatPattern?: string;
-  currencyCode?: string;
-  description?: string;
-  priority?: 'primary' | 'secondary' | 'detail';
-  sortable?: boolean;
-  filterable?: boolean;
-  groupable?: boolean;
-}
-interface AnalyticsVisualizationRecommendation {
-  type: AnalyticsChartCatalogType | 'area' | 'stacked_bar';
-  mode: string;
-  categoryField?: string;
-  latitudeField?: string;
-  longitudeField?: string;
-  geometryField?: string;
-  valueFields?: string[];
-  seriesField?: string;
-  reason?: string;
-  confidence?: number;
-}
-interface AnalyticsVisualization$1 {
-  version?: number;
-  presentation?: 'kpi' | 'chart' | 'table';
-  type: AnalyticsChartCatalogType | 'area' | 'stacked_bar';
-  title?: string;
-  label?: string;
-  value?: string;
-  latitudeField?: string;
-  longitudeField?: string;
-  geometryField?: string;
-  valueFields?: string[];
-  series?: string;
-  seriesField?: string;
-  columns?: string[];
-  rows?: Array<Record<string, unknown>>;
-  rowCount?: number;
-  timezone?: string;
-  columnMetadata?: AnalyticsVisualizationColumn[];
-  currency?: {
-    code?: string;
-    field?: string;
-    source?: 'fixed_metadata' | 'source_field';
-    isMixed: boolean;
-  };
-  chartRecommendation?: AnalyticsVisualizationRecommendation;
-}
-interface ResultColumn {
-  key: string;
-  label?: string;
-  dataType?: AnalyticsVisualizationColumn['dataType'];
-  currencyCode?: string;
-}
-interface ResultTableClassNames {
-  wrap?: string;
-  table?: string;
-  note?: string;
-}
-//#endregion
-//#region ../centrinfo-results/src/chart.d.ts
-type WidgetAnalyticsSeries = {
-  field: string;
-  name: string;
-  values: Array<number | null>;
-  valueColumn?: AnalyticsVisualizationColumn;
-};
-type WidgetAnalyticsChartType = 'line' | 'bar' | 'stacked_bar';
-type WidgetAnalyticsChartModel = {
-  type: WidgetAnalyticsChartType;
-  title: string;
-  xAxisTitle: string;
-  yAxisTitle: string;
-  categories: string[];
-  series: WidgetAnalyticsSeries[];
-  summary: string;
-  omittedSeriesCount: number;
-};
-declare const buildWidgetAnalyticsChartModel: (visualization: AnalyticsVisualization$1, overrideType?: WidgetAnalyticsChartType) => WidgetAnalyticsChartModel | null;
-declare const WidgetAnalyticsChart: ({
-  model,
-  expanded
-}: {
-  model: WidgetAnalyticsChartModel;
-  expanded?: boolean;
-}) => preact0.JSX.Element;
-//#endregion
-//#region ../centrinfo-results/src/result.d.ts
-declare const formatResultCell: (value: unknown, locale?: string, column?: ResultColumn) => string;
-declare const serializeResultCsv: (rows: Array<Record<string, unknown>>, columns?: Array<string | ResultColumn>) => string;
-//#endregion
-//#region ../centrinfo-results/src/table.d.ts
-interface ResultTableProps {
-  rows: Array<Record<string, unknown>>;
-  columns?: Array<string | ResultColumn>;
-  maxRows?: number;
-  locale?: string;
-  expanded?: boolean;
-  classNames?: ResultTableClassNames;
-  emptyLabel?: string;
-}
-declare const ResultTable: ({
-  rows,
-  columns,
-  maxRows,
-  locale,
-  expanded,
-  classNames,
-  emptyLabel
-}: ResultTableProps) => preact0.JSX.Element;
+//#region src/api/factory.d.ts
+/**
+ * The real client is bundled; the demo and preview transports are fetched the
+ * first time they are used, so production widgets never download them.
+ */
+declare const createChatTransport: (config: ResolvedConfig) => Transport;
 //#endregion
 //#region src/rich.d.ts
 declare const renderRich: (text: string) => JSX.Element[];
 //#endregion
+//#region src/result-details.d.ts
+/** Reader-safe result context shared by the floating widget and chat app. */
+declare const analyticsResultDetails: (result: AnalyticsVisualization, labels?: Partial<ResultLabels>, locale?: string) => AnalyticsResultDetail[];
+//#endregion
 //#region src/useChat.d.ts
 /** One past conversation, for the in-widget history list. */
 interface HistoryEntry {
@@ -252,6 +146,12 @@ interface ChatApi {
   retry: (agentId: string, question: string, opts?: Pick<SendOpts, 'forceVoicePlayback'>) => void;
   /** Record a 👍/👎 on an assistant reply (optional comment on 👎). Optimistic. */
   rateMessage: (messageId: string, rating: 'up' | 'down', comment?: string) => void;
+  /** Record a vote on an analytics explanation. Rejects when it could not be
+   *  saved (or the transport has no explanation feedback) so the UI can retry. */
+  rateExplanation: (input: Omit<ExplanationFeedbackInput, 'sessionId' | 'surface'>, surface?: ExplanationFeedbackInput['surface']) => Promise<void>;
+  /** Poll / retry the detailed AI explanation of an analytics answer for this
+   *  session; undefined when the transport cannot. */
+  explanationTransport: (surface?: ExplanationFeedbackInput['surface']) => AnalyticsAIExplanationTransport<AnalyticsExplanationInput> | undefined;
   /** Append a proactive assistant message (auto-engagement). No-op duplicate-guarded. */
   injectAssistant: (content: string) => void;
   /** After a teammate handed the chat back to the AI: offer the live-support
@@ -421,6 +321,5 @@ declare const stopRecorderWithFlush: (recorder: MediaRecorder | null | undefined
  * surface maps onto its own theme.
  */
 declare const WIDGET_ACTION_STYLES: string;
-declare const createChatTransport: (config: ResolvedConfig) => Transport;
 //#endregion
-export { type ActionResult, ActionsArea, type AnalyticsVisualization, type BootstrapInfo, type ChatApi, type ChatArtifact, type ChatMessage, type DemoSlotsResult, type HistoryEntry, type MessageAttachment, type PublicChatAction, type PublicChatActionField, type ResolvedConfig, ResultTable, type Source, StringsProvider, type Transport, type VoiceReply, WIDGET_ACTION_STYLES, WidgetAnalyticsChart, type WidgetConfig, type WidgetThemeTokens, type WidgetUser, buildWidgetAnalyticsChartModel, createAdaptiveVoiceActivityDetector, createChatTransport, createPreferredAudioRecorder, createVoiceAudioConstraints, findLiveSupportAction, formatResultCell, looksLikeEcho, reconnectableHandbackId, renderRich, resolveConfig, selectStyleRules, serializeResultCsv, stopRecorderWithFlush, usableTranscript, useChat };
+export { type ActionResult, ActionsArea, type AnalyticsVisualization, type BootstrapInfo, type ChatApi, type ChatArtifact, type ChatMessage, type DemoSlotsResult, type HistoryEntry, type MessageAttachment, type PublicChatAction, type PublicChatActionField, type ResolvedConfig, ResultTable, type Source, StringsProvider, type Transport, type VoiceReply, WIDGET_ACTION_STYLES, WidgetAnalyticsChart, type WidgetConfig, type WidgetThemeTokens, type WidgetUser, analyticsResultDetails, buildWidgetAnalyticsChartModel, createAdaptiveVoiceActivityDetector, createChatTransport, createPreferredAudioRecorder, createVoiceAudioConstraints, findLiveSupportAction, formatResultCell, looksLikeEcho, reconnectableHandbackId, renderRich, resolveConfig, selectStyleRules, serializeResultCsv, stopRecorderWithFlush, usableTranscript, useChat };

package/dist/runtime.mjs

@@ -1,2 +1,2 @@
-import{E as e,G as t,J as n,K as r,L as i,U as a,W as o,X as s,Y as c,_ as l,a as u,c as d,f,g as p,i as m,l as h,n as g,o as _,q as v,r as y,s as b,t as x}from"./styles-CIJFMOKa.mjs";const S=(e,t)=>{let n=e.replace(/\/\*[\s\S]*?\*\//g,``),r=e=>t.some(t=>e.includes(t)),i=[],a=0;for(;a<n.length;){let e=n.indexOf(`{`,a);if(e<0)break;let o=n.slice(a,e).trim(),s=1,c=e+1;for(;c<n.length&&s>0;)n[c]===`{`?s++:n[c]===`}`&&s--,c++;let l=n.slice(e+1,c-1);if(o.startsWith(`@`))if(/^@(media|supports|container)\b/.test(o)){let e=S(l,t);e&&i.push(`${o} {\n${e}\n}`)}else /^@keyframes\b/.test(o)&&r(o)&&i.push(`${o} {${l}}`);else r(o)&&i.push(`${o} {${l}}`);a=c}return i.join(`
-`)},C=S(x,[`.cf-action`,`.cf-form`,`.cf-booking`]),w=e=>e.demo?new c:e.preview?new n(new s(e.apiBaseUrl,e.token,e.gifApiKey,e.analyticsContextToken,{agentName:e.agentName,agentAvatarUrl:e.agentAvatarUrl},e.identityToken,e.getIdentityToken,e.chatSurface),e.strings):new s(e.apiBaseUrl,e.token,e.gifApiKey,e.analyticsContextToken,{agentName:e.agentName,agentAvatarUrl:e.agentAvatarUrl},e.identityToken,e.getIdentityToken,e.chatSurface);export{l as ActionsArea,a as ResultTable,i as StringsProvider,C as WIDGET_ACTION_STYLES,r as WidgetAnalyticsChart,v as buildWidgetAnalyticsChartModel,_ as createAdaptiveVoiceActivityDetector,w as createChatTransport,b as createPreferredAudioRecorder,d as createVoiceAudioConstraints,y as findLiveSupportAction,o as formatResultCell,f as looksLikeEcho,m as reconnectableHandbackId,e as renderRich,g as resolveConfig,S as selectStyleRules,t as serializeResultCsv,h as stopRecorderWithFlush,p as usableTranscript,u as useChat};
+import{D as e,G as t,J as n,K as r,W as i,X as a,Y as o,_ as s,a as c,c as l,f as u,g as d,i as f,l as p,n as m,o as h,q as g,r as _,s as v,t as y,z as b}from"./styles-DwSTSmZb.mjs";const x=(e,t)=>{let n=e.replace(/\/\*[\s\S]*?\*\//g,``),r=e=>t.some(t=>e.includes(t)),i=[],a=0;for(;a<n.length;){let e=n.indexOf(`{`,a);if(e<0)break;let o=n.slice(a,e).trim(),s=1,c=e+1;for(;c<n.length&&s>0;)n[c]===`{`?s++:n[c]===`}`&&s--,c++;let l=n.slice(e+1,c-1);if(o.startsWith(`@`))if(/^@(media|supports|container)\b/.test(o)){let e=x(l,t);e&&i.push(`${o} {\n${e}\n}`)}else /^@keyframes\b/.test(o)&&r(o)&&i.push(`${o} {${l}}`);else r(o)&&i.push(`${o} {${l}}`);a=c}return i.join(`
+`)},S=(e,t,n)=>i(e,t,n),C=x(y,[`.cf-action`,`.cf-form`,`.cf-booking`]);export{s as ActionsArea,t as ResultTable,b as StringsProvider,C as WIDGET_ACTION_STYLES,n as WidgetAnalyticsChart,S as analyticsResultDetails,o as buildWidgetAnalyticsChartModel,h as createAdaptiveVoiceActivityDetector,a as createChatTransport,v as createPreferredAudioRecorder,l as createVoiceAudioConstraints,_ as findLiveSupportAction,r as formatResultCell,u as looksLikeEcho,f as reconnectableHandbackId,e as renderRich,m as resolveConfig,x as selectStyleRules,g as serializeResultCsv,p as stopRecorderWithFlush,d as usableTranscript,c as useChat};