react-semaphor 0.1.449 → 0.1.454

package/dist/types/main.d.ts

@@ -471,7 +471,7 @@ declare type AsyncMutation<TInput, TOutput> = {
 
 export declare type AuthoritativeExportFormattingConfig = ExportFormattingConfig & {
     comparisonPresentation: ComparisonPresentationSpec;
-    resolvedFormats: ResolvedPresentationEntry[];
+    presentationExecutionSnapshot: PresentationExecutionSnapshot;
 };
 
 export declare type AuthToken = {
@@ -851,9 +851,9 @@ export declare type BriefingFormDraft = {
     limits: BriefingLimits;
 };
 
-export declare function briefingFormDraftToCreateRequest(draft: BriefingFormDraft, resolvedFormats?: ResolvedPresentationEntry[]): CreateBriefingRequest;
+export declare function briefingFormDraftToCreateRequest(draft: BriefingFormDraft): CreateBriefingRequest;
 
-export declare function briefingFormDraftToUpdateRequest(draft: BriefingFormDraft, resolvedFormats?: ResolvedPresentationEntry[]): UpdateBriefingRequest;
+export declare function briefingFormDraftToUpdateRequest(draft: BriefingFormDraft): UpdateBriefingRequest;
 
 export declare type BriefingFormOutputDraft = {
     artifactFormats: BriefingArtifactFormat[];
@@ -899,8 +899,7 @@ declare type BriefingFragments = {
 
 export declare type BriefingJobConfig = {
     kind: BriefingKind;
-    reportContext: ReportRuntimeContext;
-    resolvedFormats?: ResolvedPresentationEntry[];
+    presentationExecutionSnapshot: PresentationExecutionSnapshot;
     source: BriefingSource;
     body: BriefingBody;
     attachments: BriefingAttachment[];
@@ -1302,7 +1301,7 @@ export declare function cancelExport(apiServiceUrl: string, token: string, expor
 
 declare type CanonicalDurationUnit = 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
 
-export declare type CanonicalFormatSpec = NumericCanonicalFormat | DateCanonicalFormat | DurationCanonicalFormat | StringCanonicalFormat | TemporalBucketFormat;
+export declare type CanonicalFormatSpec = NumericCanonicalFormat | DateCanonicalFormat | RawTemporalFormat | DurationCanonicalFormat | StringCanonicalFormat | TemporalBucketFormat;
 
 declare type CanonicalPivotResultContract = {
     version: 1;
@@ -1845,7 +1844,6 @@ export declare type CreateBriefingRequest = {
     presentation: BriefingPresentation;
     limits?: BriefingLimits;
     deliveryConfig: BriefingDeliveryConfig | null;
-    resolvedFormats?: ResolvedPresentationEntry[];
 };
 
 /**
@@ -1881,7 +1879,6 @@ export declare interface CreateExportRequest {
     controlBindings?: ControlBinding[];
     resolvedPrimaryDateField?: ResolvedPrimaryDateField;
     globalDateComparison?: GlobalDateComparisonContext;
-    reportContext: ReportRuntimeContext;
     tableTotalsRequest?: TableTotalsRequest;
     totalRows: number;
     format: ExportFormat;
@@ -2379,6 +2376,8 @@ export declare type DashboardProps = {
      * points. Ordinary dashboard consumers should leave this unset.
      */
     interactionExecutionSnapshot?: Record<string, InteractionState>;
+    /** Server-resolved immutable presentation snapshot for internal print views. */
+    presentationExecutionSnapshot?: PresentationExecutionSnapshot;
     /**
      * Render target for print entry points. Generic dashboard PDF exports also
      * use cardDisplay.mode="print"; document-specific print handling must only
@@ -2634,6 +2633,11 @@ 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;
     /**
@@ -2679,7 +2683,7 @@ export declare function DisplayFormatPreferencesFields({ value, inherited, inher
 export declare type DisplayFormatPreferencesFieldsProps = {
     value: ValueFormatPreferences;
     inherited: ResolvedValueFormatPreferences;
-    inheritedSources: Pick<ResolvedValueFormatPreferenceSources, 'locale' | 'defaultCurrency'>;
+    inheritedSources: Pick<ResolvedValueFormatPreferenceSources, 'locale' | 'dateStyle' | 'dateTime' | 'defaultCurrency'>;
     onChange: (value: ValueFormatPreferences) => void;
     disabled?: boolean;
 };
@@ -3381,7 +3385,7 @@ export declare interface ExportFormattingConfig {
     visibleColumns?: string[];
     columnLabels?: Record<string, string>;
     tableTotalsLabelColumnKey?: string;
-    resolvedFormats?: ResolvedPresentationEntry[];
+    presentationExecutionSnapshot?: PresentationExecutionSnapshot;
     comparisonPresentation?: ComparisonPresentationSpec;
 }
 
@@ -3859,11 +3863,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.
@@ -4198,6 +4197,7 @@ declare type MatrixAxisLevelDescriptor = {
     label: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    temporalBucket?: TemporalBucketMetadata;
     subtotal?: SemaphorMatrixSubtotalOptions;
 };
 
@@ -4348,7 +4348,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;
@@ -4357,7 +4358,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;
@@ -4371,7 +4373,7 @@ declare type MatrixGridHeaderRow = {
 };
 
 declare type MatrixGridProjection = {
-    schemaVersion: 1;
+    schemaVersion: 2;
     shape: MatrixShape;
     rowHeaderLevels: MatrixGridRowHeaderLevel[];
     columnHeaderRows: MatrixGridHeaderRow[];
@@ -4384,7 +4386,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;
@@ -4440,7 +4443,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 = {
@@ -4448,7 +4452,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;
@@ -4477,7 +4482,7 @@ declare type MatrixPageInfo = {
 
 declare type MatrixPayload = {
     kind: 'matrixPayload';
-    schemaVersion: 1;
+    schemaVersion: 2;
     shape: MatrixShape;
     capabilities: MatrixCapability[];
     executionMetadata: MatrixExecutionMetadata;
@@ -4522,7 +4527,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;
@@ -4533,6 +4538,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;
 };
@@ -4846,11 +4852,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 {
@@ -4927,6 +4928,12 @@ export declare type PluginType = 'custom' | 'standard';
 
 export declare function polishBriefingText(apiServiceUrl: string, token: string, text: string): Promise<string>;
 
+declare type PresentationExecutionSnapshot = {
+    version: 1;
+    reportContext: ReportRuntimeContext;
+    resolvedFormats: ResolvedPresentationEntry[];
+};
+
 declare type PresentationScope = {
     dashboardId: string;
     cardId?: string;
@@ -5015,6 +5022,41 @@ export declare type RangeValue = {
     gt?: string | number;
 };
 
+/** Normalized authored input for an ungrouped temporal result column. */
+declare type RawTemporalFormat = {
+    type: 'raw_temporal';
+    /** Authored display timezone; `auto` uses the resolved calendar timezone. */
+    timezone?: string;
+    /** Authored source timezone; `auto` means UTC for timezone-less values. */
+    sourceTimezone?: string;
+    presentation: {
+        mode: 'auto';
+    } | {
+        mode: 'pattern';
+        dialect: RawTemporalPatternDialect;
+        pattern: string;
+    };
+};
+
+declare type RawTemporalPatternDialect = 'semaphor_tokens' | 'date_fns';
+
+declare type RawTemporalPresentationTarget = {
+    kind: 'column';
+    columnKey: string;
+};
+
+/** Authoritative meaning of one ungrouped temporal result column. */
+declare type RawTemporalValueKind = 'date' | 'wall_datetime' | 'instant';
+
+/**
+ * Result-column metadata for an ungrouped temporal value. This descriptor is
+ * mutually exclusive with grouped `temporalBucket` metadata.
+ */
+declare type RawTemporalValueMetadata = {
+    kind: 'raw_temporal';
+    valueKind: RawTemporalValueKind;
+};
+
 declare type RelativeDateFilter = {
     mode: 'last';
     n: number;
@@ -5153,7 +5195,7 @@ declare type ResolvedNumericPresentationEntry = {
     format: NumericCanonicalFormat;
 };
 
-declare type ResolvedPresentationEntry = ResolvedNumericPresentationEntry | ResolvedTemporalBucketPresentationEntry;
+declare type ResolvedPresentationEntry = ResolvedNumericPresentationEntry | ResolvedTemporalBucketPresentationEntry | ResolvedRawTemporalPresentationEntry;
 
 declare type ResolvedPrimaryDateField = (ResolvedPrimaryDateFieldBase & ({
     defaultGranularity?: SemaphorTimeGrain;
@@ -5178,8 +5220,45 @@ declare type ResolvedPrimaryDateFieldBase = {
     supportedGranularities?: SemaphorTimeGrain[];
 };
 
-declare type ResolvedTemporalBucketFormat = TemporalBucketFormat & {
+declare type ResolvedRawTemporalFormat = {
+    type: 'raw_temporal';
+    locale: string;
+    calendarTimezone: string;
+    /** Resolved source timezone for timezone-less wall datetimes, when authored. */
+    sourceTimezone?: string;
+    presentation: {
+        mode: 'auto';
+        styles: ResolvedTemporalStyleSet;
+    } | {
+        mode: 'pattern';
+        dialect: RawTemporalPatternDialect;
+        pattern: string;
+    };
+};
+
+declare type ResolvedRawTemporalPresentationEntry = {
+    scope: PresentationScope;
+    target: RawTemporalPresentationTarget;
+    format: ResolvedRawTemporalFormat;
+};
+
+declare type ResolvedTemporalBucketFormat = {
+    type: 'temporal_bucket';
+    locale: string;
+    presentation: {
+        mode: 'auto';
+        styles: ResolvedTemporalStyleSet;
+    };
+} | {
+    type: 'temporal_bucket';
     locale: string;
+    presentation: {
+        mode: 'preset';
+        preset: TemporalBucketPreset;
+    } | {
+        mode: 'pattern';
+        pattern: string;
+    };
 };
 
 declare type ResolvedTemporalBucketPresentationEntry = {
@@ -5188,6 +5267,14 @@ declare type ResolvedTemporalBucketPresentationEntry = {
     format: ResolvedTemporalBucketFormat;
 };
 
+declare type ResolvedTemporalStyleSet = {
+    dateStyle: LocaleStyle;
+    dateTime: {
+        dateStyle: LocaleStyle;
+        timeStyle: LocaleStyle;
+    };
+};
+
 declare type ResolvedValueFormatPreferences = {
     locale: string;
     dateStyle: LocaleStyle;
@@ -5491,6 +5578,8 @@ declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -5499,7 +5588,7 @@ declare type SemaphorMatrixAxisLevel = {
 declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -5556,7 +5645,7 @@ declare type SemaphorMatrixMemberPathSegment = {
 
 declare type SemaphorMatrixResult = SemaphorAnalyticsResultBase & {
     kind: 'matrix';
-    schemaVersion: 1;
+    schemaVersion: 2;
     intent?: SemaphorMatrixIntent;
     shape: MatrixShape;
     capabilities: MatrixCapability[];
@@ -5578,12 +5667,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;
@@ -5805,6 +5899,7 @@ declare type SemaphorResultColumn = {
     source?: SemaphorFieldRef['source'];
     derivedField?: SemaphorDerivedFieldDefinition;
     temporalBucket?: TemporalBucketMetadata;
+    rawTemporal?: RawTemporalValueMetadata;
     pivotIdentity?: SemaphorPivotResultColumnIdentity;
 };
 

package/dist/types/shared.d.ts

@@ -736,6 +736,11 @@ 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;
     /**
@@ -1379,11 +1384,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.
@@ -1672,11 +1672,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';
 }
 
 /**
@@ -1852,6 +1847,8 @@ declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -1860,7 +1857,7 @@ declare type SemaphorMatrixAxisLevel = {
 declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -1915,12 +1912,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/surfboard.d.ts

@@ -901,6 +901,8 @@ export declare type DashboardProps = {
      * points. Ordinary dashboard consumers should leave this unset.
      */
     interactionExecutionSnapshot?: Record<string, InteractionState>;
+    /** Server-resolved immutable presentation snapshot for internal print views. */
+    presentationExecutionSnapshot?: PresentationExecutionSnapshot;
     /**
      * Render target for print entry points. Generic dashboard PDF exports also
      * use cardDisplay.mode="print"; document-specific print handling must only
@@ -1004,6 +1006,11 @@ 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;
     /**
@@ -1042,7 +1049,7 @@ export declare function DisplayFormatPreferencesFields({ value, inherited, inher
 export declare type DisplayFormatPreferencesFieldsProps = {
     value: ValueFormatPreferences;
     inherited: ResolvedValueFormatPreferences;
-    inheritedSources: Pick<ResolvedValueFormatPreferenceSources, 'locale' | 'defaultCurrency'>;
+    inheritedSources: Pick<ResolvedValueFormatPreferenceSources, 'locale' | 'dateStyle' | 'dateTime' | 'defaultCurrency'>;
     onChange: (value: ValueFormatPreferences) => void;
     disabled?: boolean;
 };
@@ -1769,11 +1776,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.
@@ -2101,6 +2103,32 @@ export declare type NumberOptions = {
     colorRanges?: ColorRange[];
 };
 
+declare type NumericCanonicalFormat = {
+    type: 'number' | 'currency' | 'percent' | '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';
+};
+
+declare type NumericPresentationTarget = {
+    kind: 'metric';
+    metricId: string;
+} | {
+    kind: 'column';
+    columnKey: string;
+} | {
+    kind: 'matrix_measure';
+    measureId: string;
+};
+
 declare type OldFilterValue = string | number | null | (string | number)[] | RangeValue;
 
 declare type Operation = '=' | '>' | '<' | '>=' | '<=' | '!=' | 'in' | 'not in' | 'like' | 'not like' | 'between' | 'not between' | 'is null' | 'is not null';
@@ -2149,11 +2177,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';
 }
 
 /**
@@ -2178,6 +2201,18 @@ export declare type Placeholders = {
 
 export declare type PluginType = 'custom' | 'standard';
 
+declare type PresentationExecutionSnapshot = {
+    version: 1;
+    reportContext: ReportRuntimeContext;
+    resolvedFormats: ResolvedPresentationEntry[];
+};
+
+declare type PresentationScope = {
+    dashboardId: string;
+    cardId?: string;
+    attachmentIndex?: number;
+};
+
 declare interface QueryConfig {
     groupByColumns?: GroupByColumn[];
     pivotColumns?: GroupByColumn[];
@@ -2200,6 +2235,13 @@ declare type RangeValue = {
     gt?: string | number;
 };
 
+declare type RawTemporalPatternDialect = 'semaphor_tokens' | 'date_fns';
+
+declare type RawTemporalPresentationTarget = {
+    kind: 'column';
+    columnKey: string;
+};
+
 declare type RelativeDateFilter = {
     mode: 'last';
     n: number;
@@ -2308,6 +2350,14 @@ export declare type ResolvedDocumentInput = {
     exports: Record<string, string | number | boolean | null>;
 };
 
+declare type ResolvedNumericPresentationEntry = {
+    scope: PresentationScope;
+    target: NumericPresentationTarget;
+    format: NumericCanonicalFormat;
+};
+
+declare type ResolvedPresentationEntry = ResolvedNumericPresentationEntry | ResolvedTemporalBucketPresentationEntry | ResolvedRawTemporalPresentationEntry;
+
 declare type ResolvedPrimaryDateField = (ResolvedPrimaryDateFieldBase & ({
     defaultGranularity?: SemaphorTimeGrain;
     format?: undefined;
@@ -2331,6 +2381,61 @@ declare type ResolvedPrimaryDateFieldBase = {
     supportedGranularities?: SemaphorTimeGrain[];
 };
 
+declare type ResolvedRawTemporalFormat = {
+    type: 'raw_temporal';
+    locale: string;
+    calendarTimezone: string;
+    /** Resolved source timezone for timezone-less wall datetimes, when authored. */
+    sourceTimezone?: string;
+    presentation: {
+        mode: 'auto';
+        styles: ResolvedTemporalStyleSet;
+    } | {
+        mode: 'pattern';
+        dialect: RawTemporalPatternDialect;
+        pattern: string;
+    };
+};
+
+declare type ResolvedRawTemporalPresentationEntry = {
+    scope: PresentationScope;
+    target: RawTemporalPresentationTarget;
+    format: ResolvedRawTemporalFormat;
+};
+
+declare type ResolvedTemporalBucketFormat = {
+    type: 'temporal_bucket';
+    locale: string;
+    presentation: {
+        mode: 'auto';
+        styles: ResolvedTemporalStyleSet;
+    };
+} | {
+    type: 'temporal_bucket';
+    locale: string;
+    presentation: {
+        mode: 'preset';
+        preset: TemporalBucketPreset;
+    } | {
+        mode: 'pattern';
+        pattern: string;
+    };
+};
+
+declare type ResolvedTemporalBucketPresentationEntry = {
+    scope: PresentationScope;
+    target: TemporalBucketPresentationTarget;
+    format: ResolvedTemporalBucketFormat;
+};
+
+declare type ResolvedTemporalStyleSet = {
+    dateStyle: LocaleStyle;
+    dateTime: {
+        dateStyle: LocaleStyle;
+        timeStyle: LocaleStyle;
+    };
+};
+
 declare type ResolvedValueFormatPreferences = {
     locale: string;
     dateStyle: LocaleStyle;
@@ -2479,6 +2584,8 @@ declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -2487,7 +2594,7 @@ declare type SemaphorMatrixAxisLevel = {
 declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -2542,12 +2649,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;
@@ -3425,6 +3537,19 @@ declare type TemporalBucketPresentation = {
     pattern: string;
 };
 
+declare type TemporalBucketPresentationTarget = {
+    kind: 'field';
+    fieldId: string;
+    /** Distinguishes one semantic field used on both pivot axes. */
+    role?: 'groupby' | 'pivotby';
+} | {
+    kind: 'column';
+    columnKey: string;
+} | {
+    kind: 'matrix_axis';
+    axisInstanceId: string;
+};
+
 declare type TemporalBucketPreset = (typeof TEMPORAL_BUCKET_PRESETS)[number];
 
 declare type TemporalPrecision = 'minute';