@accurix/centrinfo-widget 5.1.1 → 5.1.2

package/dist/{types-k3nQBQjf.d.mts → types-3zpBBhPI.d.mts}

@@ -1,4 +1,4 @@
-import * as preact3 from "preact";
+import * as preact1 from "preact";
 import { JSX } from "preact";
 
 //#region ../centrinfo-results/src/analytics-chart-catalog.d.ts
@@ -83,6 +83,8 @@ interface AnalyticsExplanationFreshnessInput {
 }
 /** Structural explanation shape every surface's DTO satisfies. */
 interface AnalyticsExplanationInput {
+  /** Set only when the backend verified every requested fact. */
+  answerComplete?: boolean;
   explanationId?: string;
   conversationalPreface?: string;
   headline?: string;
@@ -113,6 +115,7 @@ interface AnalyticsExplanationInput {
     action: string;
     why: string;
     successMetric?: string;
+    segment?: string;
     evidenceIds?: string[];
   }>;
   forecast?: {
@@ -128,24 +131,63 @@ interface AnalyticsExplanationInput {
   level?: 'basic' | 'detailed' | string;
   /** The detailed AI explanation that loads separately (poll by explanationId). */
   aiExplanation?: AnalyticsAIExplanationInput | null;
+  /** Ranked measured drivers (association, never proof of cause). */
+  drivers?: Array<{
+    text: string;
+    basis?: string;
+    evidenceIds?: string[];
+  }>;
+  /** Cited unusual values. */
+  anomalies?: Array<{
+    text: string;
+    evidenceIds?: string[];
+  }>;
+  /** General business guidance, NOT from the customer's data (label "guidance"). */
+  frameworks?: Array<{
+    name: string;
+    label?: string;
+    guidance: string;
+    fieldMapping?: Array<{
+      concept: string;
+      field?: string;
+      status: string;
+    }>;
+    evidenceIds?: string[];
+  }>;
+  /** Business concepts the answer needed that the data does not hold. */
+  dataGaps?: Array<{
+    concept: string;
+    text: string;
+  }>;
+  /** Governed facts the AI wording did not cover, added beside it. */
+  supplementaryFindings?: string[];
 }
-/** State of the detailed AI explanation, as returned by every surface. */
+/**
+ * State of the detailed AI explanation, as returned by every surface. The
+ * backend may also send "governed" (the checked governed explanation is
+ * final); it is read as `not_requested` — not a failure.
+ */
 type AnalyticsAIExplanationStatus = 'pending' | 'ready' | 'failed' | 'not_requested';
 interface AnalyticsAIExplanationInput {
   status: AnalyticsAIExplanationStatus | string;
   explanationId?: string;
   retryAvailable?: boolean;
+  /** Pending only: when the backend job's budget ends (ISO time). */
+  deadlineAt?: string;
+  /** Pending only: seconds left in the job's budget at response time (clock-skew safe). */
+  waitSeconds?: number;
 }
 declare const ANALYTICS_EXPLANATION_COPY: {
   readonly eyebrow: "Answer from your data";
   readonly provenanceAI: "AI-assisted · evidence checked";
+  readonly provenanceCalculated: "Calculated results";
   readonly provenanceGoverned: "Based on current values";
   readonly comparison: "Comparison";
   readonly conclusions: "What we can conclude";
   readonly whyItMatters: "Why it matters";
   readonly limits: "Important limits";
   readonly investigate: "Investigate further";
-  readonly evidenceList: "Evidence checked";
+  readonly evidenceList: "Supporting evidence";
   readonly causes: "Possible causes";
   readonly causesHint: "Not proven causes";
   readonly howToCheck: "How to check:";
@@ -154,6 +196,7 @@ declare const ANALYTICS_EXPLANATION_COPY: {
   readonly outlook: "Outlook";
   readonly followUps: "Ask a follow-up";
   readonly sourceNoteAI: "AI-assisted wording, checked against the live values shown here.";
+  readonly sourceNoteCalculated: "AI-assisted wording based on calculated results.";
   readonly sourceNoteGoverned: "Based only on the live values shown here.";
   readonly evidence: "Evidence";
   readonly evidenceMetric: "Metric";
@@ -181,10 +224,19 @@ declare const ANALYTICS_EXPLANATION_COPY: {
   readonly notComparable: "Not comparable yet";
   readonly basicExplanation: "Basic explanation";
   readonly preparingDetailed: "Preparing a detailed explanation…";
+  readonly stillWorkingDetailed: "Still working on the detailed explanation…";
   readonly detailedReady: "Detailed explanation ready.";
   readonly detailedUnavailable: "A detailed explanation is not available right now.";
   readonly detailedRetry: "Try again";
   readonly region: "Explanation";
+  readonly drivers: "What is driving it";
+  readonly driversHint: "Measured association, not proof of cause";
+  readonly anomalies: "Unusual values";
+  readonly supplementaryFindings: "Also in the data";
+  readonly frameworks: "General guidance, not from your data";
+  readonly dataGaps: "Missing data";
+  readonly segment: "Segment:";
+  readonly tasks: "Tasks";
   readonly inProgress: "in progress";
   readonly expand: "Expand explanation";
   readonly collapse: "Collapse explanation";
@@ -264,6 +316,9 @@ interface AnalyticsAIExplanationJob<E extends AnalyticsExplanationInput> {
   status: AnalyticsAIExplanationStatus | string;
   explanationId?: string;
   retryAvailable?: boolean;
+  /** Pending only: the job's deadline (ISO) and seconds left (see AnalyticsAIExplanationInput). */
+  deadlineAt?: string;
+  waitSeconds?: number;
   explanation?: E | null;
   /**
    * The free basic explanation as updated by the background job (it gains the
@@ -479,6 +534,7 @@ interface ResultColumn {
   currencyCode?: string;
   formatPattern?: string;
   grain?: ResultGrain;
+  semanticRole?: AnalyticsVisualizationColumn$1['semanticRole'];
 }
 interface ResultTableClassNames {
   wrap?: string;
@@ -529,7 +585,7 @@ declare const WidgetAnalyticsChart: ({
   expanded?: boolean;
   /** Class prefix of the surface (`cf` widget, `ca` chat app). */
   classPrefix?: string;
-}) => preact3.JSX.Element;
+}) => preact1.JSX.Element;
 //#endregion
 //#region ../centrinfo-results/src/result.d.ts
 declare const formatResultCell: (value: unknown, locale?: string, column?: ResultColumn, context?: ResultFormatContext) => string;
@@ -556,7 +612,7 @@ declare const ResultTable: ({
   expanded,
   classNames,
   emptyLabel
-}: ResultTableProps) => preact3.JSX.Element;
+}: ResultTableProps) => preact1.JSX.Element;
 //#endregion
 //#region ../centrinfo-results/src/result-details.d.ts
 interface AnalyticsResultDetail {
@@ -779,7 +835,7 @@ interface WidgetStrings {
   previewActionNote: string;
   previewBanner: string;
 }
-declare const StringsProvider: preact3.Provider<WidgetStrings>;
+declare const StringsProvider: preact1.Provider<WidgetStrings>;
 //#endregion
 //#region src/api/types.d.ts
 /** The result metadata that arrives with (or after) an answer. */
@@ -949,6 +1005,7 @@ interface AnalyticsValueProvenance {
   reason?: string;
 }
 interface AnalyticsVisualizationExplanation {
+  answerComplete?: boolean;
   /** Stable opaque id; used only for "Was this helpful?" feedback. */
   explanationId?: string;
   conversationalPreface?: string;

package/dist/{types-D0VIOagk.d.cts → types-BuoTcoZu.d.cts}

@@ -80,6 +80,8 @@ interface AnalyticsExplanationFreshnessInput {
 }
 /** Structural explanation shape every surface's DTO satisfies. */
 interface AnalyticsExplanationInput {
+  /** Set only when the backend verified every requested fact. */
+  answerComplete?: boolean;
   explanationId?: string;
   conversationalPreface?: string;
   headline?: string;
@@ -110,6 +112,7 @@ interface AnalyticsExplanationInput {
     action: string;
     why: string;
     successMetric?: string;
+    segment?: string;
     evidenceIds?: string[];
   }>;
   forecast?: {
@@ -125,24 +128,63 @@ interface AnalyticsExplanationInput {
   level?: 'basic' | 'detailed' | string;
   /** The detailed AI explanation that loads separately (poll by explanationId). */
   aiExplanation?: AnalyticsAIExplanationInput | null;
+  /** Ranked measured drivers (association, never proof of cause). */
+  drivers?: Array<{
+    text: string;
+    basis?: string;
+    evidenceIds?: string[];
+  }>;
+  /** Cited unusual values. */
+  anomalies?: Array<{
+    text: string;
+    evidenceIds?: string[];
+  }>;
+  /** General business guidance, NOT from the customer's data (label "guidance"). */
+  frameworks?: Array<{
+    name: string;
+    label?: string;
+    guidance: string;
+    fieldMapping?: Array<{
+      concept: string;
+      field?: string;
+      status: string;
+    }>;
+    evidenceIds?: string[];
+  }>;
+  /** Business concepts the answer needed that the data does not hold. */
+  dataGaps?: Array<{
+    concept: string;
+    text: string;
+  }>;
+  /** Governed facts the AI wording did not cover, added beside it. */
+  supplementaryFindings?: string[];
 }
-/** State of the detailed AI explanation, as returned by every surface. */
+/**
+ * State of the detailed AI explanation, as returned by every surface. The
+ * backend may also send "governed" (the checked governed explanation is
+ * final); it is read as `not_requested` — not a failure.
+ */
 type AnalyticsAIExplanationStatus = 'pending' | 'ready' | 'failed' | 'not_requested';
 interface AnalyticsAIExplanationInput {
   status: AnalyticsAIExplanationStatus | string;
   explanationId?: string;
   retryAvailable?: boolean;
+  /** Pending only: when the backend job's budget ends (ISO time). */
+  deadlineAt?: string;
+  /** Pending only: seconds left in the job's budget at response time (clock-skew safe). */
+  waitSeconds?: number;
 }
 declare const ANALYTICS_EXPLANATION_COPY: {
   readonly eyebrow: "Answer from your data";
   readonly provenanceAI: "AI-assisted · evidence checked";
+  readonly provenanceCalculated: "Calculated results";
   readonly provenanceGoverned: "Based on current values";
   readonly comparison: "Comparison";
   readonly conclusions: "What we can conclude";
   readonly whyItMatters: "Why it matters";
   readonly limits: "Important limits";
   readonly investigate: "Investigate further";
-  readonly evidenceList: "Evidence checked";
+  readonly evidenceList: "Supporting evidence";
   readonly causes: "Possible causes";
   readonly causesHint: "Not proven causes";
   readonly howToCheck: "How to check:";
@@ -151,6 +193,7 @@ declare const ANALYTICS_EXPLANATION_COPY: {
   readonly outlook: "Outlook";
   readonly followUps: "Ask a follow-up";
   readonly sourceNoteAI: "AI-assisted wording, checked against the live values shown here.";
+  readonly sourceNoteCalculated: "AI-assisted wording based on calculated results.";
   readonly sourceNoteGoverned: "Based only on the live values shown here.";
   readonly evidence: "Evidence";
   readonly evidenceMetric: "Metric";
@@ -178,10 +221,19 @@ declare const ANALYTICS_EXPLANATION_COPY: {
   readonly notComparable: "Not comparable yet";
   readonly basicExplanation: "Basic explanation";
   readonly preparingDetailed: "Preparing a detailed explanation…";
+  readonly stillWorkingDetailed: "Still working on the detailed explanation…";
   readonly detailedReady: "Detailed explanation ready.";
   readonly detailedUnavailable: "A detailed explanation is not available right now.";
   readonly detailedRetry: "Try again";
   readonly region: "Explanation";
+  readonly drivers: "What is driving it";
+  readonly driversHint: "Measured association, not proof of cause";
+  readonly anomalies: "Unusual values";
+  readonly supplementaryFindings: "Also in the data";
+  readonly frameworks: "General guidance, not from your data";
+  readonly dataGaps: "Missing data";
+  readonly segment: "Segment:";
+  readonly tasks: "Tasks";
   readonly inProgress: "in progress";
   readonly expand: "Expand explanation";
   readonly collapse: "Collapse explanation";
@@ -261,6 +313,9 @@ interface AnalyticsAIExplanationJob<E extends AnalyticsExplanationInput> {
   status: AnalyticsAIExplanationStatus | string;
   explanationId?: string;
   retryAvailable?: boolean;
+  /** Pending only: the job's deadline (ISO) and seconds left (see AnalyticsAIExplanationInput). */
+  deadlineAt?: string;
+  waitSeconds?: number;
   explanation?: E | null;
   /**
    * The free basic explanation as updated by the background job (it gains the
@@ -741,6 +796,7 @@ interface AnalyticsValueProvenance {
   reason?: string;
 }
 interface AnalyticsVisualizationExplanation {
+  answerComplete?: boolean;
   /** Stable opaque id; used only for "Was this helpful?" feedback. */
   explanationId?: string;
   conversationalPreface?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@accurix/centrinfo-widget",
-  "version": "5.1.1",
+  "version": "5.1.2",
   "private": false,
   "type": "module",
   "sideEffects": [
@@ -44,7 +44,7 @@
     "preact": "^10.27.0"
   },
   "devDependencies": {
-    "@playwright/test": "^1.50.0",
+    "@playwright/test": "^1.61.0",
     "@types/node": "^22.0.0",
     "@vitest/coverage-v8": "^3.2.0",
     "eslint": "^9.27.0",