react-semaphor 0.1.453 → 0.1.454

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

@@ -235,6 +235,7 @@ export declare type MatrixAxisLevelDescriptor = {
     label: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    temporalBucket?: TemporalBucketMetadata;
     subtotal?: SemaphorMatrixSubtotalOptions;
 };
 
@@ -355,7 +356,8 @@ export declare type MatrixGridCell = {
 
 export declare type MatrixGridColumn = {
     id: string;
-    label: string;
+    /** Present only for measure and explicit total headings. */
+    label?: string;
     columnNodeId?: string;
     columnPath: MatrixMemberPathSegment[];
     measureInstanceId: string;
@@ -364,7 +366,8 @@ export declare type MatrixGridColumn = {
 
 export 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;
@@ -378,7 +381,7 @@ export declare type MatrixGridHeaderRow = {
 };
 
 export declare type MatrixGridProjection = {
-    schemaVersion: 1;
+    schemaVersion: 2;
     shape: MatrixShape;
     rowHeaderLevels: MatrixGridRowHeaderLevel[];
     columnHeaderRows: MatrixGridHeaderRow[];
@@ -391,7 +394,8 @@ export 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;
@@ -447,7 +451,8 @@ export declare type MatrixMemberPathSegment = {
     instanceId: string;
     fieldKey: string;
     value: unknown;
-    label: string;
+    /** Display-only source label for non-temporal members. */
+    label?: string;
 };
 
 export declare type MatrixNode = {
@@ -455,7 +460,8 @@ export 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;
@@ -484,7 +490,7 @@ export declare type MatrixPageInfo = {
 
 export declare type MatrixPayload = {
     kind: 'matrixPayload';
-    schemaVersion: 1;
+    schemaVersion: 2;
     shape: MatrixShape;
     capabilities: MatrixCapability[];
     executionMetadata: MatrixExecutionMetadata;
@@ -527,6 +533,18 @@ export declare type MatrixResultCell = {
     calculationId?: string;
 };
 
+export declare class MatrixResultContractError extends Error {
+    readonly code: MatrixResultContractErrorCode;
+    readonly path?: string;
+    constructor(input: {
+        code: MatrixResultContractErrorCode;
+        message: string;
+        path?: string;
+    });
+}
+
+export declare type MatrixResultContractErrorCode = 'invalid_matrix_result_contract' | 'unsupported_matrix_result_version';
+
 export declare type MatrixShape = 'hierarchical' | 'pivot';
 
 export declare type MatrixTotals = {
@@ -669,6 +687,14 @@ export declare function normalizeSemaphorDialect(input: string | undefined): Sem
 
 export declare function normalizeSemaphorInputOperator(value: SemaphorInputOperator | string | null | undefined): SemaphorInputOperator | undefined;
 
+/**
+ * The only serialized Matrix result boundary. It validates the structural
+ * schema and the cross-field identity invariants that a shape-only schema
+ * cannot express. Callers pass the returned object to downstream consumers;
+ * they do not inspect or reconstruct unparsed Matrix envelopes.
+ */
+export declare function parseCanonicalMatrixResult(input: unknown): SemaphorMatrixResult;
+
 /** Strictly parses one raw temporal descriptor at a result boundary. */
 export declare function parseRawTemporalValueMetadata(input: unknown): RawTemporalValueMetadata;
 
@@ -2677,7 +2703,7 @@ export declare type SemaphorDataAppCodegenMatrixIntent = {
 
 export declare type SemaphorDataAppCodegenMatrixSortRule = Omit<SemaphorMatrixSortRule, 'by'> & {
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorDataAppCodegenFieldRef;
@@ -3244,6 +3270,8 @@ export declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -3252,7 +3280,7 @@ export declare type SemaphorMatrixAxisLevel = {
 export declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -3309,7 +3337,7 @@ export declare type SemaphorMatrixMemberPathSegment = {
 
 export declare type SemaphorMatrixResult = SemaphorAnalyticsResultBase & {
     kind: 'matrix';
-    schemaVersion: 1;
+    schemaVersion: 2;
     intent?: SemaphorMatrixIntent;
     shape: MatrixShape;
     capabilities: MatrixCapability[];
@@ -3333,12 +3361,17 @@ export declare type SemaphorMatrixResult = SemaphorAnalyticsResultBase & {
 
 export declare const semaphorMatrixResultSchema: z.ZodType<SemaphorMatrixResult>;
 
+export 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;

package/dist/types/briefings.d.ts

@@ -1917,11 +1917,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.
@@ -2256,11 +2251,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';
 }
 
 /**
@@ -2558,6 +2548,8 @@ declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -2566,7 +2558,7 @@ declare type SemaphorMatrixAxisLevel = {
 declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -2621,12 +2613,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;

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

@@ -538,11 +538,6 @@ declare type FormatSpec = {
 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.
@@ -629,6 +624,7 @@ declare type MatrixAxisLevelDescriptor = {
     label: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    temporalBucket?: TemporalBucketMetadata;
     subtotal?: SemaphorMatrixSubtotalOptions;
 };
 
@@ -703,7 +699,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;
@@ -712,7 +709,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;
@@ -774,7 +772,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 = {
@@ -782,7 +781,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;
@@ -934,11 +934,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';
 }
 
 /**
@@ -1289,6 +1284,8 @@ declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -1297,7 +1294,7 @@ declare type SemaphorMatrixAxisLevel = {
 declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -1354,7 +1351,7 @@ declare type SemaphorMatrixMemberPathSegment = {
 
 declare type SemaphorMatrixResult = SemaphorAnalyticsResultBase & {
     kind: 'matrix';
-    schemaVersion: 1;
+    schemaVersion: 2;
     intent?: SemaphorMatrixIntent;
     shape: MatrixShape;
     capabilities: MatrixCapability[];
@@ -1376,12 +1373,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/dashboard-authoring.d.ts

@@ -1650,11 +1650,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.
@@ -1966,11 +1961,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';
 }
 
 /**
@@ -2280,6 +2270,8 @@ declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -2288,7 +2280,7 @@ declare type SemaphorMatrixAxisLevel = {
 declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -2343,12 +2335,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;

package/dist/types/dashboard.d.ts

@@ -1763,11 +1763,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.
@@ -2169,11 +2164,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';
 }
 
 /**
@@ -2574,6 +2564,8 @@ declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -2582,7 +2574,7 @@ declare type SemaphorMatrixAxisLevel = {
 declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -2637,12 +2629,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;

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

@@ -675,6 +675,8 @@ declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -683,7 +685,7 @@ declare type SemaphorMatrixAxisLevel = {
 declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -738,12 +740,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;
@@ -990,6 +997,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 type WorkspaceContext = {
     projectRoot?: string;
     framework?: string;

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

@@ -307,7 +307,7 @@ declare type SemaphorDataAppCodegenMatrixIntent = {
 
 declare type SemaphorDataAppCodegenMatrixSortRule = Omit<SemaphorMatrixSortRule, 'by'> & {
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorDataAppCodegenFieldRef;
@@ -825,6 +825,8 @@ declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -833,7 +835,7 @@ declare type SemaphorMatrixAxisLevel = {
 declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -888,12 +890,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;
@@ -1142,6 +1149,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-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): {