@accurix/centrinfo-widget 5.3.1 → 5.4.0

package/dist/{types-CSrYnsOp.d.mts → types-M-juCXr7.d.mts}

@@ -1,4 +1,4 @@
-import * as preact2 from "preact";
+import * as preact3 from "preact";
 import { JSX } from "preact";
 
 //#region ../centrinfo-results/src/answer.d.ts
@@ -19,6 +19,19 @@ interface CentrinfoAnswer<Visualization = unknown, Source$1 = unknown, Artifact
 //#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';
+type AnalyticsChartCatalogMode = 'number' | 'threshold_gauge' | 'records' | 'basic' | 'sparkline' | 'smooth' | 'step' | 'area' | 'stacked' | 'vertical' | 'horizontal' | 'grouped' | 'pie' | 'donut' | 'rose' | 'scatter' | 'effect_scatter' | 'bubble' | 'points' | 'timeline' | 'candlestick' | 'boxplot' | 'force' | 'network' | 'path' | 'hierarchy' | 'packed' | 'coordinates' | 'flow' | 'funnel' | 'calendar' | 'radar' | 'gauge' | 'symbol' | 'river' | 'matrix' | 'chord' | 'custom' | 'dataset' | 'data_zoom' | 'graphic' | 'rich_text' | 'globe' | 'bar3d' | 'scatter3d' | 'surface' | 'map3d' | 'lines3d' | 'line3d' | 'scatter_gl' | 'lines_gl' | 'flow_gl' | 'graph_gl' | 'polygons3d';
+type AnalyticsChartReleaseKey = `${AnalyticsChartCatalogType}:${AnalyticsChartCatalogMode}`;
+type AnalyticsChartAvailability = 'ready' | 'adapter_required' | 'component' | 'extension_required' | 'engine_upgrade';
+type AnalyticsChartCatalogItem = {
+  type: AnalyticsChartCatalogType;
+  mode: AnalyticsChartCatalogMode;
+  label: string;
+  description: string;
+  defaultReleased?: boolean;
+  availability?: AnalyticsChartAvailability;
+  requirement?: string;
+};
+type AnalyticsChartCatalogCopy = Partial<Record<AnalyticsChartReleaseKey, Partial<Pick<AnalyticsChartCatalogItem, 'label' | 'description' | 'requirement'>>>>;
 //#endregion
 //#region ../centrinfo-results/src/analytics-explanation.d.ts
 /**
@@ -177,6 +190,18 @@ interface AnalyticsExplanationInput {
   }>;
   /** Governed facts the AI wording did not cover, added beside it. */
   supplementaryFindings?: string[];
+  /**
+   * Tied highest / lowest groups, presented by the product from the evidence
+   * (the AI wording may not state them). Labels are data, shown as given.
+   */
+  ties?: AnalyticsExplanationTieInput[];
+}
+interface AnalyticsExplanationTieInput {
+  evidenceId?: string;
+  /** "leader" (tied for highest) or "lowest" (tied for lowest). */
+  position?: string;
+  labels?: string[];
+  value?: number;
 }
 /**
  * State of the detailed AI explanation, as returned by every surface. The
@@ -252,6 +277,9 @@ declare const ANALYTICS_EXPLANATION_COPY: {
   readonly driversHint: "Measured association, not proof of cause";
   readonly anomalies: "Unusual values";
   readonly supplementaryFindings: "Also in the data";
+  readonly ties: "Tied results";
+  readonly tiedHighest: "Tied for highest";
+  readonly tiedLowest: "Tied for lowest";
   readonly frameworks: "General guidance, not from your data";
   readonly dataGaps: "Missing data";
   readonly segment: "Segment:";
@@ -263,6 +291,99 @@ declare const ANALYTICS_EXPLANATION_COPY: {
   readonly reasonMissingComparison: "Missing comparison";
   readonly reasonUnclear: "Unclear";
   readonly reasonTooLong: "Too long";
+  /** Investigation task list heading; `{label}` is `tasks`. */
+  readonly tasksProgress: "{label} ({done} of {total})";
+  readonly taskPlanned: "Planned";
+  readonly taskRunning: "Running";
+  readonly taskDone: "Done";
+  readonly taskFailed: "Failed";
+  readonly taskSkipped: "Skipped";
+  /** Value-status chips. */
+  readonly statusConfirmedZero: "confirmed 0";
+  readonly statusNoRecords: "no records yet";
+  readonly statusMissing: "missing";
+  readonly statusObserved: "observed";
+  readonly forecastLow: "Low-confidence forecast";
+  readonly forecastDirectional: "Directional forecast";
+  readonly forecastValidated: "Validated forecast";
+  readonly forecastEstimate: "Forecast estimate";
+  readonly checkedTimesIn: "Times in {timezone}";
+  readonly checkedAt: "Checked {time}";
+  readonly periodRange: "{start} – {end} (end not included)";
+  readonly periodFrom: "From {start}";
+  readonly periodBefore: "Before {end}";
+  /** Query-run freshness. */
+  readonly liveData: "Live data";
+  readonly updatedAt: "Updated {time}";
+  /** Source-data freshness. */
+  readonly freshnessUpdated: "Updated";
+  readonly freshnessUnknown: "Source freshness is unavailable.";
+  readonly freshnessFresh: "Fresh";
+  readonly freshnessCurrent: "Source data is current.";
+  readonly freshnessNoData: "No source data";
+  readonly freshnessNoDataBody: "No source data is available for this period or an earlier period.";
+  readonly freshnessChecked: "Checked {date}";
+  readonly freshnessLatestRecord: "Latest record";
+  readonly freshnessLatestRecordOn: "Latest record {date}";
+  readonly freshnessLatestBody: "Latest matching record: {date}. An older record alone does not prove a source delay.";
+  readonly freshnessLatestUnknownBody: "Latest matching record date is unavailable. An older record alone does not prove a source delay.";
+  /** Period comparison. */
+  readonly currentPeriod: "Current period";
+  readonly previousPeriod: "Previous period";
+  readonly periodNoRecords: "{period}: no records yet";
+  readonly noChangeFromZero: "No change (0)";
+  readonly upFromZero: "Up from 0";
+  readonly downFromZero: "Down from 0";
+  readonly notComparableShort: "Not comparable";
+  readonly comparePointDay: "vs yesterday at this time";
+  readonly comparePointWeek: "vs same point last week";
+  readonly comparePointMonth: "vs same point last month";
+  readonly comparePointQuarter: "vs same point last quarter";
+  readonly comparePointYear: "vs same point last year";
+  readonly comparePointPeriod: "vs same point last period";
+  readonly previousPointDay: "Yesterday at this time";
+  readonly previousPointWeek: "Same point last week";
+  readonly previousPointMonth: "Same point last month";
+  readonly previousPointQuarter: "Same point last quarter";
+  readonly previousPointYear: "Same point last year";
+  readonly previousPointPeriod: "Same point last period";
+  readonly fullDay: "full day";
+  readonly fullWeek: "full week";
+  readonly fullMonth: "full month";
+  readonly fullQuarter: "full quarter";
+  readonly fullYear: "full year";
+  readonly fullPeriod: "full period";
+  readonly fullDayTitle: "Full day";
+  readonly fullWeekTitle: "Full week";
+  readonly fullMonthTitle: "Full month";
+  readonly fullQuarterTitle: "Full quarter";
+  readonly fullYearTitle: "Full year";
+  readonly fullPeriodTitle: "Full period";
+  readonly cutoffDay: "Compared up to {time} on both days";
+  readonly cutoffWeek: "Compared up to {time} in both weeks";
+  readonly cutoffMonth: "Compared up to {time} in both months";
+  readonly cutoffQuarter: "Compared up to {time} in both quarters";
+  readonly cutoffYear: "Compared up to {time} in both years";
+  readonly cutoffPeriod: "Compared up to {time} in both periods";
+  readonly cutoffLatestRecord: "{cutoff}, the time of the latest record";
+  readonly previousFullLine: "{period} {full}: {value}";
+  readonly compactFullLine: "{full}: {value}";
+  readonly periodSoFar: "{period} so far: {value}";
+  readonly periodInProgress: "{period}: in progress";
+  readonly previousFullValue: "{period}: {value} ({full})";
+  readonly groupNoteLikeForLike: "{period} so far, compared with {previous}";
+  readonly groupNoteFull: "{period} so far; the previous period is shown in full, so the bars are not like for like";
+  readonly previousToDate: "Previous to date";
+  /** Limits derived from value statuses. */
+  readonly limitInProgress: "{period} is still in progress, so its total can still change.";
+  readonly limitNoRecords: "{period} has no records yet. This is not a confirmed 0.";
+  readonly limitNoRecordsReason: "{period} has no records yet. This is not a confirmed 0: {reason}.";
+  readonly limitMissing: "{period} is missing.";
+  readonly limitMissingReason: "{period} is missing: {reason}.";
+  readonly limitCurrentInProgress: "The current period is still in progress, so its total can still change.";
+  readonly missingStatement: "{label} could not be established: {reason}";
+  readonly today: "Today";
+  readonly yesterday: "Yesterday";
 };
 /** The explanation panel's copy with a host's overrides on top. */
 type AnalyticsExplanationCopyOverrides = Partial<{ -readonly [K in keyof typeof ANALYTICS_EXPLANATION_COPY]: string }>;
@@ -356,6 +477,170 @@ interface AnalyticsAIExplanationTransport<E extends AnalyticsExplanationInput> {
   settled?: (explanationId: string, status: 'ready' | 'failed' | 'not_requested', explanation?: E) => void;
 }
 //#endregion
+//#region ../centrinfo-results/src/labels.d.ts
+type AnalyticsExplanationCopy = Required<AnalyticsExplanationCopyOverrides>;
+/** Every string the shared result renderer shows. Hosts override any subset. */
+interface ResultLabels {
+  analysisUnavailable: string;
+  resultDetails: string;
+  liveMetric: string;
+  currentValue: string;
+  noMatchTitle: string;
+  noMatchBody: string;
+  chartType: string;
+  chooseChartType: string;
+  aggregate: string;
+  aggregateTitle: string;
+  aggregateCharge: string;
+  chartFallback: string;
+  chartLine: string;
+  chartArea: string;
+  chartCombo: string;
+  chartAreaHint: string;
+  chartComboHint: string;
+  chartBar: string;
+  chartStackedBar: string;
+  chartLineHint: string;
+  chartBarHint: string;
+  chartStackedBarHint: string;
+  aggregationSum: string;
+  aggregationAvg: string;
+  aggregationMin: string;
+  aggregationMax: string;
+  aggregationCount: string;
+  aggregationCountDistinct: string;
+  download: string;
+  downloadData: string;
+  expandTable: string;
+  /** Heading of the rank column in a ranked answer table. */
+  rankColumn: string;
+  expandChart: string;
+  restoreView: string;
+  aboutResult: string;
+  aboutPeriod: string;
+  aboutResults: string;
+  aboutChecked: string;
+  aboutTimezone: string;
+  aboutSourceData: string;
+  aboutFilters: string;
+  /** `{count}` placeholder. */
+  rowOne: string;
+  rowMany: string;
+  filtersOne: string;
+  filtersMany: string;
+  filtersApplied: string;
+  notSet: string;
+  noValue: string;
+  yes: string;
+  no: string;
+  other: string;
+  unknown: string;
+  rowLabel: string;
+  chartCategory: string;
+  chartActivity: string;
+  chartTarget: string;
+  mapApproximateLocation: string;
+  mapApproximateDescription: string;
+  previousChart: string;
+  aggregationQuestion: string;
+  chartCatalog?: AnalyticsChartCatalogCopy;
+  viewerMessages?: Record<string, Record<string, string>>;
+  chartValues: string;
+  /** `{measure}`, `{dimension}`. */
+  chartTitle: string;
+  viewerTitle: string;
+  viewerUnavailable: string;
+  retryViewer: string;
+  viewerUpdateAvailable: string;
+  updateViewer: string;
+  seriesLimited: string;
+  partialChart: string;
+  summaryLatest: string;
+  summaryNoTrend: string;
+  summaryHighest: string;
+  summaryNoComparison: string;
+  zoomControls: string;
+  zoomIn: string;
+  zoomOut: string;
+  zoomReset: string;
+  zoomResetShort: string;
+  zoomNone: string;
+  zoomAllOne: string;
+  zoomAllMany: string;
+  zoomRange: string;
+  inProgress: string;
+  newContent: string;
+  updatedAt: string;
+  liveData: string;
+  viewData: string;
+  hideData: string;
+  inProgressLegend: string;
+  /** Overrides for the explanation panel copy. */
+  explanation?: Partial<AnalyticsExplanationCopy>;
+  governedResult: string;
+  /** Source-data freshness values in "About this result". */
+  /** Quarter axis/cell label; `{quarter}` 1–4, `{year}`. */
+  quarterLabel: string;
+  sourceCurrent: string;
+  sourceDelayed: string;
+  sourceNoData: string;
+  comboDescription: string;
+  comboSeriesLeft: string;
+  comboSeriesRight: string;
+  comboOmitted: string;
+  tableEmpty: string;
+  tableCaptionOne: string;
+  tableCaptionMany: string;
+  tableShowing: string;
+  tableFields: string;
+  tableSearch: string;
+  tableSearchPlaceholder: string;
+  tableDisplayMode: string;
+  tableModeTable: string;
+  tableModeMatrix: string;
+  tableColumns: string;
+  tableMoveLeft: string;
+  tableMoveRight: string;
+  tableComfortableRows: string;
+  tableCompactRows: string;
+  tableResetView: string;
+  tableClearFilter: string;
+  tableScrollable: string;
+  tableSelectAll: string;
+  tableSortBy: string;
+  tableColumnActions: string;
+  tableSortAscending: string;
+  tableSortDescending: string;
+  tableFilterValues: string;
+  tableFilterOperator: string;
+  tableOpContains: string;
+  tableOpEquals: string;
+  tableOpNotEquals: string;
+  tableOpGt: string;
+  tableOpGte: string;
+  tableOpLt: string;
+  tableOpLte: string;
+  tableFilterValue: string;
+  tableFilterPlaceholder: string;
+  tableApplyFilter: string;
+  tablePinColumn: string;
+  tableUnpinColumn: string;
+  tableWrapText: string;
+  tableNoWrapText: string;
+  tableDisplayName: string;
+  tableApplyDisplayName: string;
+  tableSelectRow: string;
+  tablePageRange: string;
+  tablePageEmpty: string;
+  tablePagination: string;
+  tableRows: string;
+  tableRowsPerPage: string;
+  tablePreviousPage: string;
+  tableNextPage: string;
+  tableFirstRows: string;
+  tableAllRows: string;
+}
+//#endregion
 //#region ../centrinfo-results/src/format.d.ts
 /**
  * The one place numbers, currency, percentages and dates are formatted, so the
@@ -382,6 +667,8 @@ interface ResultFormatContext {
   currencyCode?: string;
   yes?: string;
   no?: string;
+  /** Quarter label template, `{quarter}` and `{year}` (default `Q{quarter} {year}`). */
+  quarter?: string;
 }
 //#endregion
 //#region ../centrinfo-results/src/types.d.ts
@@ -485,6 +772,8 @@ interface AnalyticsVisualization$1 {
     isMixed: boolean;
   };
   chartRecommendation?: AnalyticsVisualizationRecommendation$1;
+  /** Structured two-level ranking; see `parseRankedAnswer`. */
+  rankedAnswer?: unknown;
 }
 interface ResultColumn {
   key: string;
@@ -538,95 +827,6 @@ interface AnalyticsComboModel {
   locale?: string;
 }
 //#endregion
-//#region ../centrinfo-results/src/labels.d.ts
-type AnalyticsExplanationCopy = Required<AnalyticsExplanationCopyOverrides>;
-/** Every string the shared result renderer shows. Hosts override any subset. */
-interface ResultLabels {
-  analysisUnavailable: string;
-  resultDetails: string;
-  liveMetric: string;
-  currentValue: string;
-  noMatchTitle: string;
-  noMatchBody: string;
-  chartType: string;
-  chooseChartType: string;
-  aggregate: string;
-  aggregateTitle: string;
-  aggregateCharge: string;
-  chartFallback: string;
-  chartLine: string;
-  chartArea: string;
-  chartCombo: string;
-  chartAreaHint: string;
-  chartComboHint: string;
-  chartBar: string;
-  chartStackedBar: string;
-  chartLineHint: string;
-  chartBarHint: string;
-  chartStackedBarHint: string;
-  aggregationSum: string;
-  aggregationAvg: string;
-  aggregationMin: string;
-  aggregationMax: string;
-  aggregationCount: string;
-  aggregationCountDistinct: string;
-  download: string;
-  downloadData: string;
-  expandTable: string;
-  expandChart: string;
-  restoreView: string;
-  aboutResult: string;
-  aboutPeriod: string;
-  aboutResults: string;
-  aboutChecked: string;
-  aboutTimezone: string;
-  aboutSourceData: string;
-  aboutFilters: string;
-  /** `{count}` placeholder. */
-  rowOne: string;
-  rowMany: string;
-  filtersOne: string;
-  filtersMany: string;
-  filtersApplied: string;
-  notSet: string;
-  noValue: string;
-  yes: string;
-  no: string;
-  chartValues: string;
-  /** `{measure}`, `{dimension}`. */
-  chartTitle: string;
-  viewerTitle: string;
-  viewerUnavailable: string;
-  retryViewer: string;
-  viewerUpdateAvailable: string;
-  updateViewer: string;
-  seriesLimited: string;
-  partialChart: string;
-  summaryLatest: string;
-  summaryNoTrend: string;
-  summaryHighest: string;
-  summaryNoComparison: string;
-  zoomControls: string;
-  zoomIn: string;
-  zoomOut: string;
-  zoomReset: string;
-  zoomResetShort: string;
-  zoomNone: string;
-  zoomAllOne: string;
-  zoomAllMany: string;
-  zoomRange: string;
-  inProgress: string;
-  newContent: string;
-  updatedAt: string;
-  liveData: string;
-  viewData: string;
-  hideData: string;
-  inProgressLegend: string;
-  /** Overrides for the explanation panel copy. */
-  explanation?: Partial<AnalyticsExplanationCopy>;
-  governedResult: string;
-}
-//#endregion
 //#region ../centrinfo-results/src/chart.d.ts
 type WidgetAnalyticsSeries = {
   field: string;
@@ -672,7 +872,7 @@ declare const WidgetAnalyticsChart: ({
   expanded?: boolean;
   /** Class prefix of the surface (`cf` widget, `ca` chat app). */
   classPrefix?: string;
-}) => preact2.JSX.Element;
+}) => preact3.JSX.Element;
 //#endregion
 //#region ../centrinfo-results/src/result.d.ts
 declare const formatResultCell: (value: unknown, locale?: string, column?: ResultColumn, context?: ResultFormatContext) => string;
@@ -689,6 +889,8 @@ interface ResultTableProps {
   expanded?: boolean;
   classNames?: ResultTableClassNames;
   emptyLabel?: string;
+  /** Any subset of the result labels; English fills the rest. */
+  labels?: Partial<ResultLabels>;
 }
 declare const ResultTable: ({
   rows,
@@ -698,8 +900,9 @@ declare const ResultTable: ({
   format,
   expanded,
   classNames,
-  emptyLabel
-}: ResultTableProps) => preact2.JSX.Element;
+  emptyLabel,
+  labels: labelOverrides
+}: ResultTableProps) => preact3.JSX.Element;
 //#endregion
 //#region ../centrinfo-results/src/result-details.d.ts
 interface AnalyticsResultDetail {
@@ -707,6 +910,24 @@ interface AnalyticsResultDetail {
   value: string;
 }
 //#endregion
+//#region ../centrinfo-results/src/locale.d.ts
+/**
+ * Shared locale plumbing for every Centrinfo SDK (widget, chat app, voice,
+ * analytics, results). One place for: the bundled language list, locale and
+ * text-direction resolution, `{placeholder}` templates, plurals, Intl
+ * formatting, catalog merging/lazy loading, and the catalog parity check the
+ * per-package tests use.
+ *
+ * Contract for a package catalog:
+ * - English defaults live in code (always bundled, the fallback for any key).
+ * - Each bundled language is `src/locales/<lang>.ts` with a default export of
+ *   `Partial<Strings>`; Yoruba, Hausa and Igbo are empty slots (English).
+ * - Precedence: English < bundled catalog < host `strings` overrides.
+ */
+/** Languages with a catalog slot. `yo`, `ha`, `ig` are empty (English). */
+declare const SDK_LANGUAGES: readonly ["en", "fr", "es", "pt", "de", "it", "ar", "sw", "yo", "ha", "ig"];
+type SdkLanguage = (typeof SDK_LANGUAGES)[number];
+//#endregion
 //#region src/i18n.d.ts
 /**
  * Every user-visible chrome string in one place. The widget ships English
@@ -775,6 +996,8 @@ interface WidgetStrings {
   exitExpandedView: string;
   minimizeVoiceChat: string;
   endVoiceChat: string;
+  /** Start-call button; `{name}` is the agent's name. Hosts can override. */
+  speakWithAgent: string;
   restoreVoiceChat: string;
   reopenVoiceChat: string;
   voiceConnecting: string;
@@ -786,6 +1009,28 @@ interface WidgetStrings {
   voiceNoise: string;
   voiceMisunderstood: string;
   voiceDenied: string;
+  voiceMuted: string;
+  voiceTimeout: string;
+  /** Status lines of a voice call (Speak with AI). */
+  callConnecting: string;
+  callListening: string;
+  callHearing: string;
+  callUnavailable: string;
+  callSpeaking: string;
+  callProcessing: string;
+  callNoise: string;
+  callMisunderstood: string;
+  callDenied: string;
+  /** The visitor asked the assistant to wait; it listens quietly. */
+  callWaiting: string;
+  /** A slow answer: progress is being given. */
+  callStillWorking: string;
+  /** Control that resumes a waiting call. */
+  resumeVoiceChat: string;
+  /** The visitor talks while an earlier answer is still being prepared. */
+  voiceAnswerStillComing: string;
+  /** Spoken when an answer is only display data (tables, charts). */
+  voiceDetailsInChat: string;
   composerPlaceholder: string;
   send: string;
   emoji: string;
@@ -835,6 +1080,13 @@ interface WidgetStrings {
   emptyReply: string;
   errorGeneric: string;
   errorRateLimit: string;
+  errorTimeout?: string;
+  errorUnavailable?: string;
+  errorAccess?: string;
+  errorAnalysis?: string;
+  errorAnalyticsSetup?: string;
+  errorCredits?: string;
+  errorSubscription?: string;
   /** Shown in place of an analytics result that is not kept in local storage. */
   resultExpired: string;
   attaching: string;
@@ -867,6 +1119,17 @@ interface WidgetStrings {
   /** Generic action-form success fallback + error. */
   formThanks: string;
   formError: string;
+  voiceFormAsk: string;
+  voiceFormReview: string;
+  voiceFormCancelled: string;
+  voiceFormUnavailable: string;
+  voiceFormNoSlots: string;
+  voiceFormLoading: string;
+  voiceFormAt: string;
+  voiceFormDot: string;
+  voiceFormAppointmentTime: string;
+  voiceFormTimeUnavailable: string;
+  voiceFormExternal: string;
   /** Case number appended to a confirmation. `{reference}` is the case number. */
   caseReference: string;
   /** Public action drawer chrome. Action-specific copy remains descriptor data. */
@@ -923,12 +1186,121 @@ interface WidgetStrings {
   bookingCheckingDetails: string;
   bookingDetailsUnavailable: string;
   bookingRetryDetails: string;
+  /** Assistant card while a voice call connects. */
+  callConnectingWithAi: string;
+  /** Assistant card privacy note when the org set a privacy link but no text. */
+  disclaimerDefault: string;
+  /** Fallback action descriptions (only for backends that send no descriptors). */
+  actionContactSupportDescription: string;
+  actionLeaveMessageDescription: string;
+  actionBookDemoDescription: string;
+  actionRequestCallbackDescription: string;
+  actionScheduleCallbackDescription: string;
+  actionSubscribeDescription: string;
+  /** Fallback form titles, submit buttons, field labels and placeholders. */
+  formContactSupportTitle: string;
+  formRequestSupport: string;
+  formLeaveMessageTitle: string;
+  formSendMessage: string;
+  formShareDetailsTitle: string;
+  formSave: string;
+  formBookDemoTitle: string;
+  formRequestDemo: string;
+  formRequestCallbackTitle: string;
+  formRequestCallback: string;
+  formScheduleCallbackTitle: string;
+  formScheduleCallback: string;
+  formSubscribe: string;
+  fieldFullName: string;
+  fieldEmail: string;
+  fieldSubject: string;
+  fieldMessage: string;
+  fieldPhone: string;
+  fieldPhoneNumber: string;
+  fieldPreferredTime: string;
+  fieldNotes: string;
+  fieldTopic: string;
+  placeholderSupportMessage: string;
+  placeholderInquiryMessage: string;
+  placeholderPreferredTime: string;
+  placeholderNotes: string;
+  placeholderTopic: string;
+  /** Phone field country picker. `{country}`, `{dial}`. */
+  phoneChooseCountry: string;
+  phoneSearchPlaceholder: string;
+  phoneSearchLabel: string;
+  phoneCountries: string;
+  phoneNoCountries: string;
+  /** Pre-filled message of the handoff card. */
+  handoffDefaultMessage: string;
+  /** Handoff card when the team already has the visitor's email. */
+  handoffAlerted: string;
+  gifAlt: string;
+  toolResultAlt: string;
+  openResult: string;
+  /** Unnamed microphone in the device list. `{number}`. */
+  microphoneNumbered: string;
+  /** Speech bubble while the visitor starts talking in a call. */
+  voiceDraftListening: string;
+  /** Emoji picker group headings. */
+  emojiSmileys: string;
+  emojiGestures: string;
+  emojiHearts: string;
+  emojiAnimals: string;
+  emojiFood: string;
+  emojiObjects: string;
+  /** Receipt when an action returned no message of its own. */
+  actionCompleted: string;
+  /** Copied text of a result table. `{count}`, `{total}`. */
+  copyResultData: string;
+  copyRowsReturned: string;
+  copyRowsReturnedOf: string;
+  copyTruncated: string;
+  copyTotals: string;
   /** Preview mode (data-preview): canned reply, action note, top banner. */
   previewReply: string;
   previewActionNote: string;
   previewBanner: string;
 }
-declare const StringsProvider: preact2.Provider<WidgetStrings>;
+declare const DEFAULT_STRINGS: WidgetStrings;
+/**
+ * English defaults, then the bundled catalog for the locale (`catalog`), then
+ * the host's overrides. Undefined values never erase a lower layer.
+ */
+declare const mergeStrings: (overrides?: Partial<WidgetStrings>, catalog?: Partial<WidgetStrings>) => WidgetStrings;
+declare const StringsProvider: preact3.Provider<WidgetStrings>;
+//#endregion
+//#region ../centrinfo-voice/src/voice-control.d.ts
+/** Spoken call controls. The assistant's answer to a voice turn says, as a
+ * structured field next to its reply, whether the person asked to control the
+ * call ("mute", "end", ... in any language). No words are matched here: the
+ * answering model decides from what was meant, and the client only executes
+ * an action it allows. */
+declare const VOICE_CONTROL_ACTIONS: readonly ["mute", "end", "minimize", "expand", "shrink", "wait", "resume"];
+type VoiceControlAction = (typeof VOICE_CONTROL_ACTIONS)[number];
+/** An answer to a voice turn: the words, and the call control it asked for. */
+interface VoiceAnswer {
+  text: string | null;
+  voiceControl?: VoiceControlAction | null;
+  /** The conversation's language, when the answer reports it. */
+  language?: string;
+  /** Progress lines in that language for a later slow answer. */
+  progressLines?: readonly string[];
+}
+//#endregion
+//#region ../centrinfo-voice/src/live-voice.d.ts
+interface LiveVoiceRequest {
+  action: 'capabilities' | 'connect' | 'heartbeat' | 'close' | 'interrupt';
+  sdp?: string;
+  callId?: string;
+}
+interface LiveVoiceResponse {
+  enabled: boolean;
+  callId?: string;
+  sdp?: string;
+  maxDurationSeconds?: number;
+}
+type LiveVoiceTransport = (request: LiveVoiceRequest, signal?: AbortSignal) => Promise<LiveVoiceResponse>;
 //#endregion
 //#region src/api/types.d.ts
 /** The result metadata that arrives with (or after) an answer. */
@@ -985,11 +1357,36 @@ interface LiveAudioSegment {
   /** The piece as spoken (no links or markdown). */
   text?: string;
 }
+interface VoiceFormField extends Omit<PublicChatActionField, 'kind'> {
+  kind: PublicChatActionField['kind'] | 'choice' | 'datetime';
+  options?: {
+    value: string;
+    label: string;
+  }[];
+}
+interface VoiceFormRequest {
+  sessionId: string;
+  clientMessageId: string;
+  actionId: string;
+  fields: VoiceFormField[];
+  values: Record<string, string>;
+  transcript: string;
+  reviewing: boolean;
+  language?: string;
+  timeZone?: string;
+}
+interface VoiceFormResult {
+  intent: 'provide' | 'confirm' | 'cancel' | 'question';
+  values: Record<string, string>;
+  clarification?: string;
+}
 interface TurnResult {
   answerResult?: CentrinfoAnswer<AnalyticsVisualization, Source, ChatArtifact>;
   /** True when the reply was spoken in live pieces (onAudioSegment). */
   liveAudio?: boolean;
   answer: string;
+  errorCode?: string;
+  retryable?: boolean;
   sources: Source[];
   suggestedReplies: string[];
   /** Legacy: raw tool ids. Prefer `actions`. */
@@ -999,10 +1396,15 @@ interface TurnResult {
   /** Action the backend resolved for this turn — open its form directly. */
   selectedAction?: string;
   handoffOffered: boolean;
+  /** True only after the backend confirms an issue was saved. */
+  issueRaised?: boolean;
   /** Contact fields the backend wants inline before handoff, e.g. ["email"]. */
   requestedContactFields?: string[];
   /** True when the backend closed the session (visitor ended it, or 24h idle). */
   conversationEnded?: boolean;
+  /** Voice turns only: the call control the answer asked for (decided by the
+   *  answering model; the call only carries out controls it allows). */
+  voiceControl?: string;
   /** Current live handoff state for the session. */
   liveMode?: 'ai' | 'queued' | 'human';
   /** Human currently assigned to the chat, when liveMode is human. */
@@ -1274,6 +1676,8 @@ interface AnalyticsVisualization {
     isMixed: boolean;
   };
   chartRecommendation?: AnalyticsVisualizationRecommendation;
+  /** Structured two-level ranking (validated by `parseRankedAnswer`). */
+  rankedAnswer?: unknown;
   analysis?: AnalyticsVisualizationAnalysis;
   businessAnalysis?: AnalyticsVisualizationBusinessAnalysis;
   analysisIntent?: AnalyticsVisualizationAnalysisIntent;
@@ -1328,6 +1732,7 @@ interface AuthenticatedHistoryMessage {
   visualization?: AnalyticsVisualization;
   artifacts?: ChatArtifact[];
   createdAt: string;
+  expiresAt?: string;
 }
 interface AuthenticatedHistoryConversation {
   sessionId: string;
@@ -1341,6 +1746,7 @@ interface AuthenticatedHistoryResult {
   conversations: AuthenticatedHistoryConversation[];
 }
 interface StreamCallbacks {
+  voiceFormEntry?: boolean;
   analyticsModelId?: string;
   /** Called with each incremental text chunk. */
   onChunk: (text: string) => void;
@@ -1354,15 +1760,23 @@ interface StreamCallbacks {
   signal?: AbortSignal;
   /** True only for turns sent from the active Speak-with-AI call. */
   voicePlaybackRequested?: boolean;
+  /** The turn was spoken in a voice call (also realtime voice, which plays
+   *  its own audio): the answer may carry a call control (`voiceControl`). */
+  voiceCall?: boolean;
+  /** The voice call is waiting (the visitor asked the assistant to hold). */
+  voiceWaiting?: boolean;
   /** Stable id of the visitor's message. A retry sends the same id, so the
    *  backend answers and bills the turn once. */
   clientMessageId?: string;
+  retryOfMessageId?: string;
   attachmentId?: string;
   /** Every stored file sent with this message. */
   attachmentIds?: string[];
 }
 interface ActionResult {
   ok: boolean;
+  /** True only after a staff issue or handoff inquiry was saved. */
+  issueRaised?: boolean;
   note?: string;
   /** Saved conversation message for this completed action. */
   receipt?: {
@@ -1471,6 +1885,12 @@ interface GifResult {
  * backend (`ApiClient`) or the in-memory demo (`MockTransport`).
  */
 interface Transport {
+  /** Static UI catalogs; absent for demo, preview and older custom transports. */
+  loadUITranslations?(namespace: string, locale: string, version?: string, signal?: AbortSignal): Promise<unknown>;
+  prepareVoiceForm?: (request: VoiceFormRequest, signal?: AbortSignal) => Promise<VoiceFormResult>;
+  liveVoice?(request: LiveVoiceRequest & {
+    sessionId: string;
+  }, signal?: AbortSignal): Promise<LiveVoiceResponse>;
   analyticsModels?(): Promise<AnalyticsModelOption[]>;
   bootstrap(): Promise<BootstrapInfo>;
   /** Server-backed history for the verified SDK customer. Anonymous returns empty. */
@@ -1621,8 +2041,20 @@ interface WidgetConfig {
    * chat answers themselves are already multilingual server-side.
    */
   labels?: Partial<WidgetStrings>;
-  /** Locale used to select a translation bundle. Defaults to browser locale. */
+  /**
+   * Override any UI text (same keys as `labels`; `strings` wins when both are
+   * set). Unset keys use automatic/bundled catalogs for `locale`, then English.
+   */
+  strings?: Partial<WidgetStrings>;
+  /**
+   * BCP-47 locale (`fr`, `pt-BR`, `ar-EG`, …). Loads bundled UI text and,
+   * by default, missing automatic translations. Formats dates, times and
+   * numbers with the runtime's Intl support. Defaults to the browser language.
+   */
   locale?: string;
+  /** Load missing static UI translations from the authenticated backend. Default true.
+   * Set false to use only bundled catalogs and your own strings. */
+  autoTranslate?: boolean;
   /**
    * Text direction. `auto` (default) follows the locale: Arabic, Hebrew,
    * Persian, Urdu and similar scripts render right-to-left.
@@ -1831,8 +2263,19 @@ interface WidgetHandle {
    */
   shutdown: () => void;
   logout: () => void;
+  /**
+   * Change the language, text overrides or direction at runtime. `strings`
+   * merge over earlier overrides. Resolves once the new text is shown.
+   */
+  setLocale: (update: WidgetLocaleUpdate) => Promise<void>;
   destroy: () => void;
 }
+/** Runtime language change for `handle.setLocale`. */
+interface WidgetLocaleUpdate {
+  locale?: string;
+  strings?: Partial<WidgetStrings>;
+  dir?: 'ltr' | 'rtl' | 'auto';
+}
 /** A rendered chat message. */
 interface ChatArtifact {
   type: 'image' | 'video' | 'resource_link' | 'visualization';
@@ -1855,6 +2298,9 @@ interface MessageAttachment {
 }
 interface ChatMessage {
   id: string;
+  /** A voice-call control turn (wait, mute, end, ...): shown during the call
+   * but never kept in the saved transcript, matching the server. */
+  callOnly?: boolean;
   role: 'user' | 'assistant' | 'system';
   content: string;
   /** Human name for live agent replies or system join/leave events. */
@@ -1865,8 +2311,10 @@ interface ChatMessage {
   offerReconnect?: boolean;
   /** Local assistant message opened by "Reconnect to support". */
   reconnectOffer?: boolean;
-  /** ISO timestamp for server-originated live events. */
+  /** Original message time used for transcript retention. */
   createdAt?: string;
+  /** Original retention deadline; cache writes must not renew it. */
+  expiresAt?: string;
   /** Inline image (e.g. a GIF the visitor sent). Rendered in the bubble. */
   imageUrl?: string;
   /** Name of a file the visitor attached (rendered as a chip on their bubble). */
@@ -1884,6 +2332,8 @@ interface ChatMessage {
   /** Action the backend resolved for this turn — its form opens directly. */
   selectedAction?: string;
   handoffOffered?: boolean;
+  /** A persisted staff issue was confirmed for this turn. */
+  issueRaised?: boolean;
   /** Contact fields requested by final API metadata before handoff. */
   requestedContactFields?: string[];
   /** Assistant message awaiting its first token (shows the typing dots). */
@@ -1892,6 +2342,8 @@ interface ChatMessage {
   streaming?: boolean;
   /** Something went wrong producing this turn. */
   error?: boolean;
+  errorCode?: string;
+  retryable?: boolean;
   /** On an errored turn, the question to re-send when the visitor taps Retry. */
   retryText?: string;
   /** Visitor's 👍/👎 on this assistant reply (persisted so it survives reloads). */
@@ -1925,8 +2377,9 @@ interface BootstrapInfo {
   greeting: string;
   /** Public module selected on the token: classic chat or assistant card. */
   widgetModule?: 'chat' | 'assistant';
-  /** Assistant-card hero media. Video is rendered muted/looping. */
+  /** @deprecated Welcome media is retired; the assistant uses its avatar. */
   assistantMediaUrl?: string;
+  /** @deprecated Retained for compatibility; renderers ignore welcome media. */
   assistantMediaKind?: 'image' | 'video';
   assistantPrivacyUrl?: string;
   /** Org-token default for widget sounds. Visitors can still mute locally. */
@@ -1991,4 +2444,4 @@ interface SchedulerInfo {
   };
 }
 //#endregion
-export { WidgetAnalyticsChart as A, Transport as C, ResultTable as D, AnalyticsResultDetail as E, ResultLabels as M, AnalyticsAIExplanationTransport as N, formatResultCell as O, AnalyticsExplanationInput as P, PublicChatActionField as S, WidgetStrings as T, DemoBooking as _, MessageAttachment as a, GifResult as b, Visitor as c, WidgetHandle as d, WidgetThemeTokens as f, AnalyticsVisualization as g, AnalyticsModelOption as h, FeaturedLink as i, buildWidgetAnalyticsChartModel as j, serializeResultCsv as k, WidgetActionTranslation as l, ActionResult as m, ChatArtifact as n, SchedulerInfo as o, WidgetUser as p, ChatMessage as r, Source as s, BootstrapInfo as t, WidgetConfig as u, DemoSlotsResult as v, StringsProvider as w, PublicChatAction as x, ExplanationFeedbackInput as y };
+export { WidgetStrings as A, ResultLabels as B, PublicChatActionField as C, VoiceAnswer as D, LiveVoiceTransport as E, ResultTable as F, AnalyticsExplanationInput as H, formatResultCell as I, serializeResultCsv as L, SDK_LANGUAGES as M, SdkLanguage as N, DEFAULT_STRINGS as O, AnalyticsResultDetail as P, WidgetAnalyticsChart as R, PublicChatAction as S, VoiceFormField as T, AnalyticsAIExplanationTransport as V, AnalyticsVisualization as _, MessageAttachment as a, ExplanationFeedbackInput as b, Visitor as c, WidgetHandle as d, WidgetLocaleUpdate as f, AnalyticsModelOption as g, ActionResult as h, FeaturedLink as i, mergeStrings as j, StringsProvider as k, WidgetActionTranslation as l, WidgetUser as m, ChatArtifact as n, SchedulerInfo as o, WidgetThemeTokens as p, ChatMessage as r, Source as s, BootstrapInfo as t, WidgetConfig as u, DemoBooking as v, Transport as w, GifResult as x, DemoSlotsResult as y, buildWidgetAnalyticsChartModel as z };