react-semaphor 0.1.453 → 0.1.455

package/dist/types/data-app-codegen.d.ts

@@ -303,7 +303,7 @@ declare type SemaphorDataAppCodegenMatrixIntent = {
 
 declare type SemaphorDataAppCodegenMatrixSortRule = Omit<SemaphorMatrixSortRule, 'by'> & {
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorDataAppCodegenFieldRef;
@@ -797,6 +797,8 @@ declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -805,7 +807,7 @@ declare type SemaphorMatrixAxisLevel = {
 declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -860,12 +862,17 @@ declare type SemaphorMatrixMemberPathSegment = {
     value: unknown;
 };
 
+declare type SemaphorMatrixSemanticTemporalPresentation = {
+    granularity: SemaphorMatrixTimeGrain;
+    format: TemporalBucketFormat;
+};
+
 declare type SemaphorMatrixSortRule = {
     axis: 'row' | 'column';
     targetId?: string;
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -1114,6 +1121,25 @@ declare type SemaphorTimeGrain = (typeof SEMAPHOR_TIME_GRAINS)[number];
 
 declare type SemaphorTimeWindow = SemaphorRelativeTimeWindow | SemaphorAbsoluteTimeWindow;
 
+declare const TEMPORAL_BUCKET_PRESETS: readonly ["week_of_short", "week_of_long", "quarter_short", "quarter_long", "fiscal_quarter_short", "fiscal_year"];
+
+declare type TemporalBucketFormat = {
+    type: 'temporal_bucket';
+    presentation: TemporalBucketPresentation;
+};
+
+declare type TemporalBucketPresentation = {
+    mode: 'auto';
+} | {
+    mode: 'preset';
+    preset: TemporalBucketPreset;
+} | {
+    mode: 'pattern';
+    pattern: string;
+};
+
+declare type TemporalBucketPreset = (typeof TEMPORAL_BUCKET_PRESETS)[number];
+
 export declare function validateCodegenSummary(value: unknown): string[];
 
 export declare function validateSemaphorDataAppCodegenSummary(value: unknown): {

package/dist/types/data-app-sdk-adapters.d.ts

@@ -264,6 +264,8 @@ declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -274,7 +276,7 @@ declare type SemaphorMatrixAxisLevelInput = SemaphorQueryField | SemaphorMatrixA
 declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -342,12 +344,17 @@ declare type SemaphorMatrixQuerySpec = Omit<SemaphorMatrixIntent, 'kind' | 'vers
     displayLimits?: SemaphorMatrixDisplayLimitOptions;
 };
 
+declare type SemaphorMatrixSemanticTemporalPresentation = {
+    granularity: SemaphorMatrixTimeGrain;
+    format: TemporalBucketFormat;
+};
+
 declare type SemaphorMatrixSortRule = {
     axis: 'row' | 'column';
     targetId?: string;
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -682,6 +689,25 @@ declare type SemaphorTimeGrain = (typeof SEMAPHOR_TIME_GRAINS)[number];
 
 declare type SemaphorTimeWindow = SemaphorRelativeTimeWindow | SemaphorAbsoluteTimeWindow;
 
+declare const TEMPORAL_BUCKET_PRESETS: readonly ["week_of_short", "week_of_long", "quarter_short", "quarter_long", "fiscal_quarter_short", "fiscal_year"];
+
+declare type TemporalBucketFormat = {
+    type: 'temporal_bucket';
+    presentation: TemporalBucketPresentation;
+};
+
+declare type TemporalBucketPresentation = {
+    mode: 'auto';
+} | {
+    mode: 'preset';
+    preset: TemporalBucketPreset;
+} | {
+    mode: 'pattern';
+    pattern: string;
+};
+
+declare type TemporalBucketPreset = (typeof TEMPORAL_BUCKET_PRESETS)[number];
+
 export declare function toSemaphorActiveInputSnapshots(inputs: SemaphorInputReference[] | undefined): SemaphorActiveInput[];
 
 export declare function toSemaphorAnalysisIntent(spec: SemaphorAnalysisQuerySpec): SemaphorMetricIntent;

package/dist/types/data-app-sdk-validation.d.ts

@@ -21,6 +21,7 @@ declare type MatrixAxisLevelDescriptor = {
     label: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    temporalBucket?: TemporalBucketMetadata;
     subtotal?: SemaphorMatrixSubtotalOptions;
 };
 
@@ -95,7 +96,8 @@ declare type MatrixFormattingContext = {
 
 declare type MatrixGridColumn = {
     id: string;
-    label: string;
+    /** Present only for measure and explicit total headings. */
+    label?: string;
     columnNodeId?: string;
     columnPath: MatrixMemberPathSegment[];
     measureInstanceId: string;
@@ -104,7 +106,8 @@ declare type MatrixGridColumn = {
 
 declare type MatrixGridHeaderCell = {
     id: string;
-    label: string;
+    /** Present only for non-member headings and explicit total labels. */
+    label?: string;
     role: 'rowHeader' | 'columnHeader' | 'measureHeader' | 'subtotal' | 'grandTotal';
     colSpan: number;
     rowSpan: number;
@@ -166,7 +169,8 @@ declare type MatrixMemberPathSegment = {
     instanceId: string;
     fieldKey: string;
     value: unknown;
-    label: string;
+    /** Display-only source label for non-temporal members. */
+    label?: string;
 };
 
 declare type MatrixNode = {
@@ -174,7 +178,8 @@ declare type MatrixNode = {
     axis: 'row' | 'column';
     path: MatrixMemberPathSegment[];
     level: number;
-    label: string;
+    /** Present only for non-temporal members and explicit total labels. */
+    label?: string;
     value: unknown;
     parentId?: string;
     hasChildren: boolean;
@@ -717,6 +722,8 @@ declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -727,7 +734,7 @@ declare type SemaphorMatrixAxisLevelInput = SemaphorQueryField | SemaphorMatrixA
 declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -801,7 +808,7 @@ declare type SemaphorMatrixQuerySpec = Omit<SemaphorMatrixIntent, 'kind' | 'vers
 
 declare type SemaphorMatrixResult = SemaphorAnalyticsResultBase & {
     kind: 'matrix';
-    schemaVersion: 1;
+    schemaVersion: 2;
     intent?: SemaphorMatrixIntent;
     shape: MatrixShape;
     capabilities: MatrixCapability[];
@@ -823,12 +830,17 @@ declare type SemaphorMatrixResult = SemaphorAnalyticsResultBase & {
     expansion?: MatrixExpansionResponseHints;
 };
 
+declare type SemaphorMatrixSemanticTemporalPresentation = {
+    granularity: SemaphorMatrixTimeGrain;
+    format: TemporalBucketFormat;
+};
+
 declare type SemaphorMatrixSortRule = {
     axis: 'row' | 'column';
     targetId?: string;
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -1309,12 +1321,31 @@ declare type SemaphorTimeGrain = (typeof SEMAPHOR_TIME_GRAINS)[number];
 
 declare type SemaphorTimeWindow = SemaphorRelativeTimeWindow | SemaphorAbsoluteTimeWindow;
 
+declare const TEMPORAL_BUCKET_PRESETS: readonly ["week_of_short", "week_of_long", "quarter_short", "quarter_long", "fiscal_quarter_short", "fiscal_year"];
+
+declare type TemporalBucketFormat = {
+    type: 'temporal_bucket';
+    presentation: TemporalBucketPresentation;
+};
+
 declare type TemporalBucketMetadata = {
     kind: 'temporal_bucket';
     granularity: SemaphorTimeGrain;
     calendar: Pick<CalendarContext, 'tz' | 'weekStart' | 'fiscalCalendar'>;
 };
 
+declare type TemporalBucketPresentation = {
+    mode: 'auto';
+} | {
+    mode: 'preset';
+    preset: TemporalBucketPreset;
+} | {
+    mode: 'pattern';
+    pattern: string;
+};
+
+declare type TemporalBucketPreset = (typeof TEMPORAL_BUCKET_PRESETS)[number];
+
 export declare function validateSemaphorDataAppQuerySpecs(input: {
     queries: SemaphorDataAppQuerySpecEnvelope[];
     fieldCatalogs?: SemaphorDataAppFieldCatalog[];

package/dist/types/data-app-sdk.d.ts

@@ -26,6 +26,7 @@ declare type MatrixAxisLevelDescriptor = {
     label: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    temporalBucket?: TemporalBucketMetadata;
     subtotal?: SemaphorMatrixSubtotalOptions;
 };
 
@@ -146,7 +147,8 @@ declare type MatrixGridCell = {
 
 declare type MatrixGridColumn = {
     id: string;
-    label: string;
+    /** Present only for measure and explicit total headings. */
+    label?: string;
     columnNodeId?: string;
     columnPath: MatrixMemberPathSegment[];
     measureInstanceId: string;
@@ -155,7 +157,8 @@ declare type MatrixGridColumn = {
 
 declare type MatrixGridHeaderCell = {
     id: string;
-    label: string;
+    /** Present only for non-member headings and explicit total labels. */
+    label?: string;
     role: 'rowHeader' | 'columnHeader' | 'measureHeader' | 'subtotal' | 'grandTotal';
     colSpan: number;
     rowSpan: number;
@@ -169,7 +172,7 @@ declare type MatrixGridHeaderRow = {
 };
 
 export declare type MatrixGridProjection = {
-    schemaVersion: 1;
+    schemaVersion: 2;
     shape: MatrixShape;
     rowHeaderLevels: MatrixGridRowHeaderLevel[];
     columnHeaderRows: MatrixGridHeaderRow[];
@@ -182,7 +185,8 @@ declare type MatrixGridRow = {
     rowNodeId: string;
     rowPath: MatrixMemberPathSegment[];
     depth: number;
-    label: string;
+    /** Present only for non-temporal members and explicit total labels. */
+    label?: string;
     role: 'value' | 'rowSubtotal' | 'rowGrandTotal';
     isExpanded?: boolean;
     hasChildren?: boolean;
@@ -238,7 +242,8 @@ declare type MatrixMemberPathSegment = {
     instanceId: string;
     fieldKey: string;
     value: unknown;
-    label: string;
+    /** Display-only source label for non-temporal members. */
+    label?: string;
 };
 
 declare type MatrixNode = {
@@ -246,7 +251,8 @@ declare type MatrixNode = {
     axis: 'row' | 'column';
     path: MatrixMemberPathSegment[];
     level: number;
-    label: string;
+    /** Present only for non-temporal members and explicit total labels. */
+    label?: string;
     value: unknown;
     parentId?: string;
     hasChildren: boolean;
@@ -275,7 +281,7 @@ declare type MatrixPageInfo = {
 
 export declare type MatrixPayload = {
     kind: 'matrixPayload';
-    schemaVersion: 1;
+    schemaVersion: 2;
     shape: MatrixShape;
     capabilities: MatrixCapability[];
     executionMetadata: MatrixExecutionMetadata;
@@ -1071,6 +1077,8 @@ export declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -1081,7 +1089,7 @@ export declare type SemaphorMatrixAxisLevelInput = SemaphorQueryField | Semaphor
 declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -1171,7 +1179,7 @@ export declare type SemaphorMatrixQuerySpec = Omit<SemaphorMatrixIntent, 'kind'
 
 declare type SemaphorMatrixResult = SemaphorAnalyticsResultBase & {
     kind: 'matrix';
-    schemaVersion: 1;
+    schemaVersion: 2;
     intent?: SemaphorMatrixIntent;
     shape: MatrixShape;
     capabilities: MatrixCapability[];
@@ -1193,12 +1201,17 @@ declare type SemaphorMatrixResult = SemaphorAnalyticsResultBase & {
     expansion?: MatrixExpansionResponseHints;
 };
 
+declare type SemaphorMatrixSemanticTemporalPresentation = {
+    granularity: SemaphorMatrixTimeGrain;
+    format: TemporalBucketFormat;
+};
+
 export declare type SemaphorMatrixSortRule = {
     axis: 'row' | 'column';
     targetId?: string;
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -1803,12 +1816,31 @@ export declare function SemaphorViewBoundary({ id, title, children, }: {
     children: ReactNode;
 }): ReactElement;
 
+declare const TEMPORAL_BUCKET_PRESETS: readonly ["week_of_short", "week_of_long", "quarter_short", "quarter_long", "fiscal_quarter_short", "fiscal_year"];
+
+declare type TemporalBucketFormat = {
+    type: 'temporal_bucket';
+    presentation: TemporalBucketPresentation;
+};
+
 declare type TemporalBucketMetadata = {
     kind: 'temporal_bucket';
     granularity: SemaphorTimeGrain;
     calendar: Pick<CalendarContext, 'tz' | 'weekStart' | 'fiscalCalendar'>;
 };
 
+declare type TemporalBucketPresentation = {
+    mode: 'auto';
+} | {
+    mode: 'preset';
+    preset: TemporalBucketPreset;
+} | {
+    mode: 'pattern';
+    pattern: string;
+};
+
+declare type TemporalBucketPreset = (typeof TEMPORAL_BUCKET_PRESETS)[number];
+
 export declare function useClearInvalidSemaphorInputValue(input: SemaphorInputHandle, optionsResult: Pick<SemaphorInputOptionsQueryResult, 'options' | 'status'> | undefined): void;
 
 export declare function useSemaphorDevtools(): SemaphorDataAppDevtoolsState;

package/dist/types/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/common-types-Ci66eflG.cjs"),l=require("../chunks/token-types-D0i0IUX3.cjs"),t=require("../chunks/pivot-result-identity-CRUokNgm.cjs"),E=require("../chunks/report-runtime-context-DjYqLV-c.cjs");exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.PivotMarkerEnum=e.PivotMarkerEnum;exports.getFieldRuntimeColumnName=e.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=e.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=e.hasCalculatedFormulaInputs;exports.isCalculatedDimension=e.isCalculatedDimension;exports.isCalculatedField=e.isCalculatedField;exports.isCalculatedMetric=e.isCalculatedMetric;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=l.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.resolveQueryColumnKeyMapEntry=t.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=t.resolveUniqueQueryColumnKeyMapEntry;exports.DEFAULT_CALENDAR_CONTEXT=E.DEFAULT_CALENDAR_CONTEXT;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/common-types-C57kJ59w.cjs"),l=require("../chunks/token-types-D7CaaI80.cjs"),t=require("../chunks/pivot-result-identity-Bb4EixVN.cjs"),E=require("../chunks/report-runtime-context-DqxS4wbi.cjs");exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.PivotMarkerEnum=e.PivotMarkerEnum;exports.getFieldRuntimeColumnName=e.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=e.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=e.hasCalculatedFormulaInputs;exports.isCalculatedDimension=e.isCalculatedDimension;exports.isCalculatedField=e.isCalculatedField;exports.isCalculatedMetric=e.isCalculatedMetric;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=l.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.resolveQueryColumnKeyMapEntry=t.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=t.resolveUniqueQueryColumnKeyMapEntry;exports.DEFAULT_CALENDAR_CONTEXT=E.DEFAULT_CALENDAR_CONTEXT;

package/dist/types/index.js

@@ -1,7 +1,7 @@
-import { a as s, C as r, D as E, E as l, P as C, g as o, d as t, h as A, b as u, c as T, i as _ } from "../chunks/common-types-F6qk6PPS.js";
-import { D } from "../chunks/token-types-CRpQJ4kv.js";
-import { r as n, a as L } from "../chunks/pivot-result-identity-C43Ai5Kr.js";
-import { D as d } from "../chunks/report-runtime-context-BJQDu2fV.js";
+import { a as s, C as r, D as E, E as l, P as C, g as o, d as t, h as A, b as u, c as T, i as _ } from "../chunks/common-types-H51FLKB7.js";
+import { D } from "../chunks/token-types-GbxRUozo.js";
+import { r as n, a as L } from "../chunks/pivot-result-identity-DU1v-5Xk.js";
+import { D as d } from "../chunks/report-runtime-context-SM6YO61_.js";
 export {
   s as CALCULATED_FIELD_ENTITY_MARKER,
   r as CONTROL_CARD_DEFAULT_VALUE,

package/dist/types/main.d.ts

@@ -2633,11 +2633,6 @@ export declare type DeleteBriefingRunResponse = {
  */
 export declare interface DetailField extends Omit<Field, 'role' | 'granularity'> {
     role: 'detail';
-    /**
-     * Query transport policy for ungrouped temporal values. This marker is
-     * projected into executable config and is never persisted authoring state.
-     */
-    dateValueMode?: 'canonical' | 'formatted';
     dateFormat?: DateFormatValue;
     customFormat?: string;
     /**
@@ -3863,11 +3858,6 @@ export declare interface GroupByColumn extends BaseColumn {
 export declare interface GroupByField extends Field {
     role: 'groupby';
     granularity?: TimeGranularity;
-    /**
-     * Query transport policy for grouped temporal values. This is projected
-     * into executable card config and is not persisted authoring state.
-     */
-    dateValueMode?: 'canonical' | 'formatted';
     /**
      * Optional SQL expression for grouping (e.g., DATE_TRUNC('month', order_date)).
      * If present, used in SELECT and GROUP BY instead of just the column name.
@@ -4202,6 +4192,7 @@ declare type MatrixAxisLevelDescriptor = {
     label: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    temporalBucket?: TemporalBucketMetadata;
     subtotal?: SemaphorMatrixSubtotalOptions;
 };
 
@@ -4352,7 +4343,8 @@ declare type MatrixGridCell = {
 
 declare type MatrixGridColumn = {
     id: string;
-    label: string;
+    /** Present only for measure and explicit total headings. */
+    label?: string;
     columnNodeId?: string;
     columnPath: MatrixMemberPathSegment[];
     measureInstanceId: string;
@@ -4361,7 +4353,8 @@ declare type MatrixGridColumn = {
 
 declare type MatrixGridHeaderCell = {
     id: string;
-    label: string;
+    /** Present only for non-member headings and explicit total labels. */
+    label?: string;
     role: 'rowHeader' | 'columnHeader' | 'measureHeader' | 'subtotal' | 'grandTotal';
     colSpan: number;
     rowSpan: number;
@@ -4375,7 +4368,7 @@ declare type MatrixGridHeaderRow = {
 };
 
 declare type MatrixGridProjection = {
-    schemaVersion: 1;
+    schemaVersion: 2;
     shape: MatrixShape;
     rowHeaderLevels: MatrixGridRowHeaderLevel[];
     columnHeaderRows: MatrixGridHeaderRow[];
@@ -4388,7 +4381,8 @@ declare type MatrixGridRow = {
     rowNodeId: string;
     rowPath: MatrixMemberPathSegment[];
     depth: number;
-    label: string;
+    /** Present only for non-temporal members and explicit total labels. */
+    label?: string;
     role: 'value' | 'rowSubtotal' | 'rowGrandTotal';
     isExpanded?: boolean;
     hasChildren?: boolean;
@@ -4444,7 +4438,8 @@ declare type MatrixMemberPathSegment = {
     instanceId: string;
     fieldKey: string;
     value: unknown;
-    label: string;
+    /** Display-only source label for non-temporal members. */
+    label?: string;
 };
 
 declare type MatrixNode = {
@@ -4452,7 +4447,8 @@ declare type MatrixNode = {
     axis: 'row' | 'column';
     path: MatrixMemberPathSegment[];
     level: number;
-    label: string;
+    /** Present only for non-temporal members and explicit total labels. */
+    label?: string;
     value: unknown;
     parentId?: string;
     hasChildren: boolean;
@@ -4481,7 +4477,7 @@ declare type MatrixPageInfo = {
 
 declare type MatrixPayload = {
     kind: 'matrixPayload';
-    schemaVersion: 1;
+    schemaVersion: 2;
     shape: MatrixShape;
     capabilities: MatrixCapability[];
     executionMetadata: MatrixExecutionMetadata;
@@ -4526,7 +4522,7 @@ declare type MatrixResultCell = {
 
 declare type MatrixShape = 'hierarchical' | 'pivot';
 
-export declare function MatrixTableVisual({ card, result, grid, payload, isLoading, expansionState, onExpansionChange, loadingRowPathKeys, onSortChange, onLoadMoreRows, }: MatrixTableVisualProps): JSX.Element;
+export declare function MatrixTableVisual({ card, result, grid, payload, isLoading, expansionState, onExpansionChange, loadingRowPathKeys, branchError, onSortChange, onLoadMoreRows, }: MatrixTableVisualProps): JSX.Element;
 
 export declare type MatrixTableVisualProps = {
     card?: TCard;
@@ -4537,6 +4533,7 @@ export declare type MatrixTableVisualProps = {
     expansionState?: MatrixExpansionState;
     onExpansionChange?: (update: MatrixExpansionStateUpdate | MatrixColumnExpansionStateUpdate | MatrixBulkColumnExpansionStateUpdate | MatrixBulkRowExpansionStateUpdate) => void;
     loadingRowPathKeys?: Set<string>;
+    branchError?: string;
     onSortChange?: (sortRules: SemaphorMatrixSortRule[]) => void;
     onLoadMoreRows?: (rowPath: MatrixMemberPathSegment[]) => void;
 };
@@ -4850,11 +4847,6 @@ export declare interface PivotByField extends Field {
      * so existing cards need no migration.
      */
     memberOrder?: PivotMemberOrder;
-    /**
-     * Query transport policy for grouped temporal pivot members. This is
-     * projected into executable config and is never persisted authoring state.
-     */
-    dateValueMode?: 'canonical' | 'formatted';
 }
 
 export declare interface PivotColumnSchema {
@@ -5581,6 +5573,8 @@ declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -5589,7 +5583,7 @@ declare type SemaphorMatrixAxisLevel = {
 declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -5646,7 +5640,7 @@ declare type SemaphorMatrixMemberPathSegment = {
 
 declare type SemaphorMatrixResult = SemaphorAnalyticsResultBase & {
     kind: 'matrix';
-    schemaVersion: 1;
+    schemaVersion: 2;
     intent?: SemaphorMatrixIntent;
     shape: MatrixShape;
     capabilities: MatrixCapability[];
@@ -5668,12 +5662,17 @@ declare type SemaphorMatrixResult = SemaphorAnalyticsResultBase & {
     expansion?: MatrixExpansionResponseHints;
 };
 
+declare type SemaphorMatrixSemanticTemporalPresentation = {
+    granularity: SemaphorMatrixTimeGrain;
+    format: TemporalBucketFormat;
+};
+
 declare type SemaphorMatrixSortRule = {
     axis: 'row' | 'column';
     targetId?: string;
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;

package/dist/types/shared.d.ts

@@ -736,11 +736,6 @@ declare type DefaultDateFilter = RelativeDateFilter | FixedMonthDefaultDateFilte
  */
 declare interface DetailField extends Omit<Field, 'role' | 'granularity'> {
     role: 'detail';
-    /**
-     * Query transport policy for ungrouped temporal values. This marker is
-     * projected into executable config and is never persisted authoring state.
-     */
-    dateValueMode?: 'canonical' | 'formatted';
     dateFormat?: DateFormatValue;
     customFormat?: string;
     /**
@@ -1384,11 +1379,6 @@ declare interface GroupByColumn extends BaseColumn {
 declare interface GroupByField extends Field {
     role: 'groupby';
     granularity?: TimeGranularity;
-    /**
-     * Query transport policy for grouped temporal values. This is projected
-     * into executable card config and is not persisted authoring state.
-     */
-    dateValueMode?: 'canonical' | 'formatted';
     /**
      * Optional SQL expression for grouping (e.g., DATE_TRUNC('month', order_date)).
      * If present, used in SELECT and GROUP BY instead of just the column name.
@@ -1677,11 +1667,6 @@ declare interface PivotByField extends Field {
      * so existing cards need no migration.
      */
     memberOrder?: PivotMemberOrder;
-    /**
-     * Query transport policy for grouped temporal pivot members. This is
-     * projected into executable config and is never persisted authoring state.
-     */
-    dateValueMode?: 'canonical' | 'formatted';
 }
 
 /**
@@ -1857,6 +1842,8 @@ declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -1865,7 +1852,7 @@ declare type SemaphorMatrixAxisLevel = {
 declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -1920,12 +1907,17 @@ declare type SemaphorMatrixMemberPathSegment = {
     value: unknown;
 };
 
+declare type SemaphorMatrixSemanticTemporalPresentation = {
+    granularity: SemaphorMatrixTimeGrain;
+    format: TemporalBucketFormat;
+};
+
 declare type SemaphorMatrixSortRule = {
     axis: 'row' | 'column';
     targetId?: string;
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;