react-semaphor 0.1.372 → 0.1.374

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../chunks/index-DlLvzmJF.js"),e=require("../chunks/common-types-C73-Ud1-.js"),a=require("../chunks/calendar-preferences-dialog-Dn6o2r2Y.js");exports.Surfboard=r.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.CalendarPreferencesDialog=a.CalendarPreferencesDialog;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../chunks/index-BJ971AL_.js"),e=require("../chunks/common-types-C73-Ud1-.js"),a=require("../chunks/calendar-preferences-dialog-94DoRSW_.js");exports.Surfboard=r.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.CalendarPreferencesDialog=a.CalendarPreferencesDialog;

package/dist/surfboard/index.js

@@ -1,6 +1,6 @@
-import { a as e } from "../chunks/index-C0Qnfr_7.js";
+import { a as e } from "../chunks/index-BiDFY4Gr.js";
 import { C, E } from "../chunks/common-types-4bjoIgvm.js";
-import { C as s } from "../chunks/calendar-preferences-dialog-ClBAkMmF.js";
+import { C as s } from "../chunks/calendar-preferences-dialog-DmBRXOH6.js";
 export {
   C as CONTROL_CARD_DEFAULT_VALUE,
   s as CalendarPreferencesDialog,

package/dist/types/analytics-protocol.d.ts

@@ -91,6 +91,26 @@ export declare type MatrixAxisPayload = {
     nodes: MatrixNode[];
 };
 
+export declare type MatrixAxisResultPayload = {
+    id: 'rows' | 'columns';
+    levels: MatrixAxisLevelDescriptor[];
+    nodeIds: string[];
+};
+
+export declare type MatrixCalculationDescriptor = {
+    id: string;
+    measureId: string;
+    aggregate?: SemaphorAggregateFunction;
+    label?: string;
+    source: 'measureDefault' | 'rowSubtotal' | 'columnSubtotal' | 'subtotalIntersection' | 'rowGrandTotal' | 'columnGrandTotal' | 'matrixGrandTotal' | 'custom';
+    scope?: {
+        rowLevelId?: string;
+        columnLevelId?: string;
+        rowNodeId?: string;
+        columnNodeId?: string;
+    };
+};
+
 export declare type MatrixCapability = 'rowHierarchy' | 'columnHierarchy' | 'rowSubtotals' | 'columnSubtotals' | 'grandTotals' | 'lazyRows' | 'lazyColumns' | 'conditionalFormatting' | 'visualExport' | (string & {});
 
 export declare type MatrixCell = {
@@ -98,8 +118,6 @@ export declare type MatrixCell = {
     rowNodeId: string;
     columnNodeId?: string;
     measureInstanceId: string;
-    rowPath: MatrixMemberPathSegment[];
-    columnPath: MatrixMemberPathSegment[];
     rawValue: unknown;
     presence: MatrixCellPresence;
     formattedValue?: string;
@@ -120,8 +138,6 @@ export declare type MatrixCellFormattingScope = {
     columnNodeId?: string;
     measureInstanceId: string;
     role: MatrixCellRole;
-    rowPath: MatrixMemberPathSegment[];
-    columnPath: MatrixMemberPathSegment[];
 };
 
 export declare type MatrixCellPresence = 'present' | 'presentNull' | 'missing' | 'densified';
@@ -184,8 +200,6 @@ export declare type MatrixGridCell = {
     presence: MatrixCellPresence;
     role: MatrixCellRole;
     measureInstanceId: string;
-    rowPath: MatrixMemberPathSegment[];
-    columnPath: MatrixMemberPathSegment[];
 };
 
 export declare type MatrixGridColumn = {
@@ -239,15 +253,26 @@ export declare type MatrixGridRowHeaderLevel = {
     fieldInstanceId: string;
 };
 
+export declare type MatrixLayoutProjection = {
+    rowHeaderLevels: MatrixGridRowHeaderLevel[];
+    columnHeaderRows: MatrixGridHeaderRow[];
+    columns: MatrixGridColumn[];
+};
+
 export declare type MatrixMeasureDescriptor = {
     instanceId: string;
     fieldKey: string;
     label: string;
     field: SemaphorFieldRef;
     aggregate?: SemaphorAggregateFunction;
+    format?: SemaphorValueFormat;
     totalBehavior?: SemaphorMatrixTotalCalculation;
 };
 
+export declare type MatrixMeasureResultDescriptor = MatrixMeasureDescriptor & {
+    semantics: MatrixMeasureSemantics;
+};
+
 export declare type MatrixMeasureSemantics = {
     kind: 'additive';
     aggregate?: SemaphorAggregateFunction;
@@ -341,6 +366,17 @@ export declare type MatrixResolvedSort = {
     by: SemaphorMatrixSortRule['by'];
 };
 
+export declare type MatrixResultCell = {
+    rowId: string;
+    columnId?: string;
+    measureId: string;
+    value: unknown;
+    formattedValue?: string;
+    presence: MatrixCellPresence;
+    role: MatrixCellRole;
+    calculationId?: string;
+};
+
 export declare type MatrixShape = 'hierarchical' | 'pivot';
 
 export declare type MatrixTotals = {
@@ -809,7 +845,7 @@ export declare type SemaphorDerivedFieldDefinition = {
     defaultAggregate?: SemaphorAggregateFunction;
     aggregationBehavior?: SemaphorDerivedFieldAggregationBehavior;
     aggregationStrategy?: SemaphorDerivedFieldAggregationStrategy;
-    format?: unknown;
+    format?: SemaphorValueFormat;
     tags?: string[];
 };
 
@@ -994,9 +1030,25 @@ export declare type SemaphorMatrixMemberPathSegment = {
 
 export declare type SemaphorMatrixResult = SemaphorAnalyticsResultBase & {
     kind: 'matrix';
-    intent: SemaphorMatrixIntent;
-    payload: MatrixPayload;
-    grid: MatrixGridProjection;
+    schemaVersion: 1;
+    intent?: SemaphorMatrixIntent;
+    shape: MatrixShape;
+    capabilities: MatrixCapability[];
+    executionMetadata: MatrixExecutionMetadata;
+    fieldsById: Record<string, MatrixFieldDescriptor>;
+    measuresById: Record<string, MatrixMeasureResultDescriptor>;
+    calculationsById?: Record<string, MatrixCalculationDescriptor>;
+    axes: {
+        rows: MatrixAxisResultPayload;
+        columns: MatrixAxisResultPayload;
+    };
+    nodesById: Record<string, MatrixNode>;
+    layout: MatrixLayoutProjection;
+    cells: MatrixResultCell[];
+    totals: MatrixTotals;
+    sort: MatrixResolvedSort[];
+    formattingContext: MatrixFormattingContext;
+    pageInfo?: MatrixPageInfo;
     expansion?: MatrixExpansionResponseHints;
 };
 
@@ -1063,6 +1115,7 @@ export declare type SemaphorMatrixValueField = {
     field: SemaphorFieldRef;
     aggregate?: SemaphorAggregateFunction;
     label?: string;
+    format?: SemaphorValueFormat;
     totalBehavior?: SemaphorMatrixTotalCalculation;
 };
 
@@ -1257,7 +1310,7 @@ export declare type SemaphorResultCalculationOutput = {
     key: string;
     label?: string;
     dataType?: SemaphorFieldRef['dataType'];
-    format?: unknown;
+    format?: SemaphorValueFormat;
 };
 
 export declare type SemaphorResultColumn = {
@@ -1370,6 +1423,44 @@ export declare type SemaphorValidationResult = {
     warnings: SemaphorProtocolIssue[];
 };
 
+export declare type SemaphorValueFormat = {
+    type: 'number' | 'currency' | 'percent' | 'percentage' | 'scientific';
+    locale?: string;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+    useGrouping?: boolean;
+    prefix?: string;
+    suffix?: string;
+    negativeStyle?: 'minus' | 'parentheses';
+    compact?: boolean;
+    scale?: number;
+    currency?: string;
+    percentValueMode?: 'fraction' | 'whole';
+} | {
+    type: 'date' | 'datetime';
+    locale?: string;
+    pattern?: string;
+    relative?: boolean;
+    timezone?: string;
+    sourceTimezone?: string;
+    prefix?: string;
+    suffix?: string;
+} | {
+    type: 'duration';
+    inputUnit?: 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+    outputStyle?: 'compact' | 'digital' | 'long';
+    largestUnit?: 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+    smallestUnit?: 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+    maxUnits?: number;
+    prefix?: string;
+    suffix?: string;
+    negativeStyle?: 'minus' | 'parentheses';
+} | {
+    type: 'string';
+    prefix?: string;
+    suffix?: string;
+};
+
 export declare type SemaphorViewPresentation = {
     kind: 'kpi';
     format?: 'number' | 'currency' | 'percent' | 'duration';

package/dist/types/dashboard-assistant.d.ts

@@ -49,6 +49,28 @@ declare interface CalculatedFieldFormula {
 declare type CalculatedFieldOperation = 'sum' | 'difference' | 'product' | 'ratio' | 'change' | 'percentage' | 'scale' | 'custom';
 
 declare interface CardConfig {
+    /**
+     * Matrix table is the shared analytics-spine successor for pivot and
+     * hierarchical aggregate tables. Dashboard cards store the public matrix
+     * intent shape so Data Apps, MCP, and dashboard runtime consume one contract.
+     */
+    matrixIntent?: SemaphorMatrixIntent;
+    /**
+     * Deprecated compatibility fields for older matrix table drafts. New
+     * dashboard-authored matrix cards should use `matrixIntent` so normal
+     * `filters` can remain the explorer/card-level `FilterGroup`.
+     */
+    version?: SemaphorMatrixIntent['version'];
+    source?: SemaphorMatrixIntent['source'];
+    rows?: SemaphorMatrixIntent['rows'];
+    columns?: SemaphorMatrixIntent['columns'];
+    values?: SemaphorMatrixIntent['values'];
+    inputs?: SemaphorMatrixIntent['inputs'];
+    totals?: SemaphorMatrixIntent['totals'];
+    sort?: SemaphorMatrixIntent['sort'];
+    expansion?: SemaphorMatrixIntent['expansion'];
+    layout?: SemaphorMatrixIntent['layout'];
+    displayLimits?: SemaphorMatrixIntent['displayLimits'];
     groupByColumns?: GroupByField[];
     metricColumns?: MetricField[];
     pivotByColumns?: PivotByField[];
@@ -558,44 +580,27 @@ declare type MatrixAxisLevelDescriptor = {
     subtotal?: SemaphorMatrixSubtotalOptions;
 };
 
-declare type MatrixAxisPayload = {
+declare type MatrixAxisResultPayload = {
     id: 'rows' | 'columns';
     levels: MatrixAxisLevelDescriptor[];
-    nodes: MatrixNode[];
+    nodeIds: string[];
 };
 
-declare type MatrixCapability = 'rowHierarchy' | 'columnHierarchy' | 'rowSubtotals' | 'columnSubtotals' | 'grandTotals' | 'lazyRows' | 'lazyColumns' | 'conditionalFormatting' | 'visualExport' | (string & {});
-
-declare type MatrixCell = {
+declare type MatrixCalculationDescriptor = {
     id: string;
-    rowNodeId: string;
-    columnNodeId?: string;
-    measureInstanceId: string;
-    rowPath: MatrixMemberPathSegment[];
-    columnPath: MatrixMemberPathSegment[];
-    rawValue: unknown;
-    presence: MatrixCellPresence;
-    formattedValue?: string;
-    role: MatrixCellRole;
-    aggregateFunction?: SemaphorAggregateFunction;
-    formattingScope: MatrixCellFormattingScope;
-    actions?: MatrixCellAction[];
-};
-
-declare type MatrixCellAction = {
-    kind: 'requestSubgoal' | 'filter' | 'copyValue' | 'explainCalculation' | 'inspectContributingRows' | 'drillThrough' | (string & {});
+    measureId: string;
+    aggregate?: SemaphorAggregateFunction;
     label?: string;
-    payload?: Record<string, unknown>;
+    source: 'measureDefault' | 'rowSubtotal' | 'columnSubtotal' | 'subtotalIntersection' | 'rowGrandTotal' | 'columnGrandTotal' | 'matrixGrandTotal' | 'custom';
+    scope?: {
+        rowLevelId?: string;
+        columnLevelId?: string;
+        rowNodeId?: string;
+        columnNodeId?: string;
+    };
 };
 
-declare type MatrixCellFormattingScope = {
-    rowNodeId: string;
-    columnNodeId?: string;
-    measureInstanceId: string;
-    role: MatrixCellRole;
-    rowPath: MatrixMemberPathSegment[];
-    columnPath: MatrixMemberPathSegment[];
-};
+declare type MatrixCapability = 'rowHierarchy' | 'columnHierarchy' | 'rowSubtotals' | 'columnSubtotals' | 'grandTotals' | 'lazyRows' | 'lazyColumns' | 'conditionalFormatting' | 'visualExport' | (string & {});
 
 declare type MatrixCellPresence = 'present' | 'presentNull' | 'missing' | 'densified';
 
@@ -636,10 +641,6 @@ declare type MatrixFieldDescriptor = {
     label?: string;
 };
 
-declare type MatrixFieldDirectory = {
-    fieldsByInstanceId: Record<string, MatrixFieldDescriptor>;
-};
-
 declare type MatrixFormattingContext = {
     domains?: Record<string, {
         min?: number;
@@ -648,19 +649,6 @@ declare type MatrixFormattingContext = {
     rules?: Array<Record<string, unknown>>;
 };
 
-declare type MatrixGridCell = {
-    id: string;
-    columnId: string;
-    cellId?: string;
-    rawValue: unknown;
-    formattedValue?: string;
-    presence: MatrixCellPresence;
-    role: MatrixCellRole;
-    measureInstanceId: string;
-    rowPath: MatrixMemberPathSegment[];
-    columnPath: MatrixMemberPathSegment[];
-};
-
 declare type MatrixGridColumn = {
     id: string;
     label: string;
@@ -685,42 +673,32 @@ declare type MatrixGridHeaderRow = {
     cells: MatrixGridHeaderCell[];
 };
 
-declare type MatrixGridProjection = {
-    schemaVersion: 1;
-    shape: MatrixShape;
-    rowHeaderLevels: MatrixGridRowHeaderLevel[];
-    columnHeaderRows: MatrixGridHeaderRow[];
-    columns: MatrixGridColumn[];
-    rows: MatrixGridRow[];
-};
-
-declare type MatrixGridRow = {
-    id: string;
-    rowNodeId: string;
-    rowPath: MatrixMemberPathSegment[];
-    depth: number;
-    label: string;
-    role: 'value' | 'rowSubtotal' | 'rowGrandTotal';
-    isExpanded?: boolean;
-    hasChildren?: boolean;
-    cells: MatrixGridCell[];
-};
-
 declare type MatrixGridRowHeaderLevel = {
     id: string;
     label: string;
     fieldInstanceId: string;
 };
 
+declare type MatrixLayoutProjection = {
+    rowHeaderLevels: MatrixGridRowHeaderLevel[];
+    columnHeaderRows: MatrixGridHeaderRow[];
+    columns: MatrixGridColumn[];
+};
+
 declare type MatrixMeasureDescriptor = {
     instanceId: string;
     fieldKey: string;
     label: string;
     field: SemaphorFieldRef;
     aggregate?: SemaphorAggregateFunction;
+    format?: SemaphorValueFormat;
     totalBehavior?: SemaphorMatrixTotalCalculation;
 };
 
+declare type MatrixMeasureResultDescriptor = MatrixMeasureDescriptor & {
+    semantics: MatrixMeasureSemantics;
+};
+
 declare type MatrixMeasureSemantics = {
     kind: 'additive';
     aggregate?: SemaphorAggregateFunction;
@@ -779,29 +757,6 @@ declare type MatrixPageInfo = {
     hasMoreColumns?: boolean;
 };
 
-declare type MatrixPayload = {
-    kind: 'matrixPayload';
-    schemaVersion: 1;
-    shape: MatrixShape;
-    capabilities: MatrixCapability[];
-    executionMetadata: MatrixExecutionMetadata;
-    axes: {
-        rows: MatrixAxisPayload;
-        columns: MatrixAxisPayload;
-    };
-    measures: MatrixMeasureDescriptor[];
-    measureSemantics: Record<string, MatrixMeasureSemantics>;
-    fieldDirectory: MatrixFieldDirectory;
-    rowNodes: MatrixNode[];
-    columnNodes: MatrixNode[];
-    cells: MatrixCell[];
-    totals: MatrixTotals;
-    sort: MatrixResolvedSort[];
-    formattingContext: MatrixFormattingContext;
-    pageInfo?: MatrixPageInfo;
-    warnings?: MatrixWarning[];
-};
-
 declare type MatrixQueryStrategy = 'tall' | 'wide' | 'lazy' | 'export';
 
 declare type MatrixResolvedSort = {
@@ -814,6 +769,17 @@ declare type MatrixResolvedSort = {
     by: SemaphorMatrixSortRule['by'];
 };
 
+declare type MatrixResultCell = {
+    rowId: string;
+    columnId?: string;
+    measureId: string;
+    value: unknown;
+    formattedValue?: string;
+    presence: MatrixCellPresence;
+    role: MatrixCellRole;
+    calculationId?: string;
+};
+
 declare type MatrixShape = 'hierarchical' | 'pivot';
 
 declare type MatrixTotals = {
@@ -825,13 +791,6 @@ declare type MatrixTotals = {
     };
 };
 
-declare type MatrixWarning = {
-    code: string;
-    message: string;
-    path?: string;
-    severity?: 'info' | 'warning' | 'error';
-};
-
 declare interface MetricField extends Field {
     role: 'metric';
     aggregate?: AggregateFunction;
@@ -1052,7 +1011,7 @@ declare type SemaphorDerivedFieldDefinition = {
     defaultAggregate?: SemaphorAggregateFunction;
     aggregationBehavior?: SemaphorDerivedFieldAggregationBehavior;
     aggregationStrategy?: SemaphorDerivedFieldAggregationStrategy;
-    format?: unknown;
+    format?: SemaphorValueFormat;
     tags?: string[];
 };
 
@@ -1206,9 +1165,25 @@ declare type SemaphorMatrixMemberPathSegment = {
 
 declare type SemaphorMatrixResult = SemaphorAnalyticsResultBase & {
     kind: 'matrix';
-    intent: SemaphorMatrixIntent;
-    payload: MatrixPayload;
-    grid: MatrixGridProjection;
+    schemaVersion: 1;
+    intent?: SemaphorMatrixIntent;
+    shape: MatrixShape;
+    capabilities: MatrixCapability[];
+    executionMetadata: MatrixExecutionMetadata;
+    fieldsById: Record<string, MatrixFieldDescriptor>;
+    measuresById: Record<string, MatrixMeasureResultDescriptor>;
+    calculationsById?: Record<string, MatrixCalculationDescriptor>;
+    axes: {
+        rows: MatrixAxisResultPayload;
+        columns: MatrixAxisResultPayload;
+    };
+    nodesById: Record<string, MatrixNode>;
+    layout: MatrixLayoutProjection;
+    cells: MatrixResultCell[];
+    totals: MatrixTotals;
+    sort: MatrixResolvedSort[];
+    formattingContext: MatrixFormattingContext;
+    pageInfo?: MatrixPageInfo;
     expansion?: MatrixExpansionResponseHints;
 };
 
@@ -1275,6 +1250,7 @@ declare type SemaphorMatrixValueField = {
     field: SemaphorFieldRef;
     aggregate?: SemaphorAggregateFunction;
     label?: string;
+    format?: SemaphorValueFormat;
     totalBehavior?: SemaphorMatrixTotalCalculation;
 };
 
@@ -1486,12 +1462,50 @@ declare type SemaphorTimeGrain = 'hour' | 'day' | 'week' | 'month' | 'quarter' |
 
 declare type SemaphorTimeWindow = SemaphorRelativeTimeWindow | SemaphorAbsoluteTimeWindow;
 
+declare type SemaphorValueFormat = {
+    type: 'number' | 'currency' | 'percent' | 'percentage' | 'scientific';
+    locale?: string;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+    useGrouping?: boolean;
+    prefix?: string;
+    suffix?: string;
+    negativeStyle?: 'minus' | 'parentheses';
+    compact?: boolean;
+    scale?: number;
+    currency?: string;
+    percentValueMode?: 'fraction' | 'whole';
+} | {
+    type: 'date' | 'datetime';
+    locale?: string;
+    pattern?: string;
+    relative?: boolean;
+    timezone?: string;
+    sourceTimezone?: string;
+    prefix?: string;
+    suffix?: string;
+} | {
+    type: 'duration';
+    inputUnit?: 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+    outputStyle?: 'compact' | 'digital' | 'long';
+    largestUnit?: 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+    smallestUnit?: 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+    maxUnits?: number;
+    prefix?: string;
+    suffix?: string;
+    negativeStyle?: 'minus' | 'parentheses';
+} | {
+    type: 'string';
+    prefix?: string;
+    suffix?: string;
+};
+
 declare interface SortByField extends Field {
     role: 'sortby';
     direction: 'asc' | 'desc';
 }
 
-declare type TChartType = 'bar' | 'horizontalBar' | 'line' | 'area' | 'stackedArea' | 'combo' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'stackedLine' | 'table' | 'pivotTable' | 'aggregateTable' | 'detailTable' | 'tableBuilder' | 'kpi' | 'pyramid' | 'tornado' | 'range' | 'text' | 'map' | 'funnel' | 'bullet' | 'heatmap' | 'treemap' | 'custom';
+declare type TChartType = 'bar' | 'horizontalBar' | 'line' | 'area' | 'stackedArea' | 'combo' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'stackedLine' | 'table' | 'pivotTable' | 'aggregateTable' | 'matrixTable' | 'detailTable' | 'tableBuilder' | 'kpi' | 'pyramid' | 'tornado' | 'range' | 'text' | 'map' | 'funnel' | 'bullet' | 'heatmap' | 'treemap' | 'custom';
 
 declare type TDynamicCardPreferences = {
     renderer: 'dynamic-visual';

package/dist/types/dashboard-authoring.d.ts

@@ -128,6 +128,28 @@ declare interface CalculatedFieldFormula {
 declare type CalculatedFieldOperation = 'sum' | 'difference' | 'product' | 'ratio' | 'change' | 'percentage' | 'scale' | 'custom';
 
 declare interface CardConfig {
+    /**
+     * Matrix table is the shared analytics-spine successor for pivot and
+     * hierarchical aggregate tables. Dashboard cards store the public matrix
+     * intent shape so Data Apps, MCP, and dashboard runtime consume one contract.
+     */
+    matrixIntent?: SemaphorMatrixIntent;
+    /**
+     * Deprecated compatibility fields for older matrix table drafts. New
+     * dashboard-authored matrix cards should use `matrixIntent` so normal
+     * `filters` can remain the explorer/card-level `FilterGroup`.
+     */
+    version?: SemaphorMatrixIntent['version'];
+    source?: SemaphorMatrixIntent['source'];
+    rows?: SemaphorMatrixIntent['rows'];
+    columns?: SemaphorMatrixIntent['columns'];
+    values?: SemaphorMatrixIntent['values'];
+    inputs?: SemaphorMatrixIntent['inputs'];
+    totals?: SemaphorMatrixIntent['totals'];
+    sort?: SemaphorMatrixIntent['sort'];
+    expansion?: SemaphorMatrixIntent['expansion'];
+    layout?: SemaphorMatrixIntent['layout'];
+    displayLimits?: SemaphorMatrixIntent['displayLimits'];
     groupByColumns?: GroupByField[];
     metricColumns?: MetricField[];
     pivotByColumns?: PivotByField[];
@@ -1904,7 +1926,7 @@ declare type SemaphorDerivedFieldDefinition = {
     defaultAggregate?: SemaphorAggregateFunction;
     aggregationBehavior?: SemaphorDerivedFieldAggregationBehavior;
     aggregationStrategy?: SemaphorDerivedFieldAggregationStrategy;
-    format?: unknown;
+    format?: SemaphorValueFormat;
     tags?: string[];
 };
 
@@ -2130,6 +2152,7 @@ declare type SemaphorMatrixValueField = {
     field: SemaphorFieldRef;
     aggregate?: SemaphorAggregateFunction;
     label?: string;
+    format?: SemaphorValueFormat;
     totalBehavior?: SemaphorMatrixTotalCalculation;
 };
 
@@ -2252,6 +2275,44 @@ declare type SemaphorTimeGrain = 'hour' | 'day' | 'week' | 'month' | 'quarter' |
 
 declare type SemaphorTimeWindow = SemaphorRelativeTimeWindow | SemaphorAbsoluteTimeWindow;
 
+declare type SemaphorValueFormat = {
+    type: 'number' | 'currency' | 'percent' | 'percentage' | 'scientific';
+    locale?: string;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+    useGrouping?: boolean;
+    prefix?: string;
+    suffix?: string;
+    negativeStyle?: 'minus' | 'parentheses';
+    compact?: boolean;
+    scale?: number;
+    currency?: string;
+    percentValueMode?: 'fraction' | 'whole';
+} | {
+    type: 'date' | 'datetime';
+    locale?: string;
+    pattern?: string;
+    relative?: boolean;
+    timezone?: string;
+    sourceTimezone?: string;
+    prefix?: string;
+    suffix?: string;
+} | {
+    type: 'duration';
+    inputUnit?: 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+    outputStyle?: 'compact' | 'digital' | 'long';
+    largestUnit?: 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+    smallestUnit?: 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+    maxUnits?: number;
+    prefix?: string;
+    suffix?: string;
+    negativeStyle?: 'minus' | 'parentheses';
+} | {
+    type: 'string';
+    prefix?: string;
+    suffix?: string;
+};
+
 declare type SemaphorViewPresentation = {
     kind: 'kpi';
     format?: 'number' | 'currency' | 'percent' | 'duration';
@@ -2759,7 +2820,7 @@ declare type TChartOptions = {
     treemapColorMode?: 'branch' | 'category';
 };
 
-declare type TChartType = 'bar' | 'horizontalBar' | 'line' | 'area' | 'stackedArea' | 'combo' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'stackedLine' | 'table' | 'pivotTable' | 'aggregateTable' | 'detailTable' | 'tableBuilder' | 'kpi' | 'pyramid' | 'tornado' | 'range' | 'text' | 'map' | 'funnel' | 'bullet' | 'heatmap' | 'treemap' | 'custom';
+declare type TChartType = 'bar' | 'horizontalBar' | 'line' | 'area' | 'stackedArea' | 'combo' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'stackedLine' | 'table' | 'pivotTable' | 'aggregateTable' | 'matrixTable' | 'detailTable' | 'tableBuilder' | 'kpi' | 'pyramid' | 'tornado' | 'range' | 'text' | 'map' | 'funnel' | 'bullet' | 'heatmap' | 'treemap' | 'custom';
 
 declare type TColumnSetting<T extends DisplayDataType> = {
     columnIdx: number;