react-semaphor 0.1.526 → 0.1.527

package/dist/types/lib/utils/relative-date-description.d.ts

@@ -0,0 +1,38 @@
+import { RelativeDateFilter } from '../../shared/analytics-protocol/relative-date-filter.js';
+import { CalendarContext } from '../../shared/report-runtime-context/index.js';
+import { ResolvedTemporalValueFormatPreferences } from '../../shared/value-format-preferences/index.js';
+export type RelativeDateDescription = {
+    label: string;
+    /** The window as of the calendar's anchor, or null when the browser can't know it. */
+    range: {
+        start: Date;
+        end: Date;
+    } | null;
+};
+export type RelativeDateCalendar = Pick<CalendarContext, 'tz' | 'weekStart' | 'anchor'>;
+export declare const RELATIVE_DATES_FOLLOW_CALENDAR = "Dates follow your calendar each time the card runs.";
+/** A window that counts back from the latest data has no dates the browser can know. */
+export declare const RELATIVE_DATES_FOLLOW_DATA = "Dates count back from the latest data each time the card runs.";
+/** What a latest-value condition reads as (analytics kernel K13). */
+export declare const LATEST_VALUE_LABEL = "Latest value";
+/** Display-only description of a relative date; the server resolves the real window. */
+export declare function describeRelativeDate(relative: RelativeDateFilter, calendar: RelativeDateCalendar): RelativeDateDescription;
+/** What a relative date reads as: its label, and its dates when known. */
+export type RelativeDateSummary = {
+    label: string;
+    /** The current window as the shared date-input presenter writes it. */
+    dates: string | null;
+    /** The current window itself, when `dates` is known. */
+    range: {
+        start: Date;
+        end: Date;
+    } | null;
+};
+/**
+ * The label and today's dates of a relative date, written in the viewer's
+ * date preferences: the same text a text card shows for a date filter.
+ */
+export declare function summarizeRelativeDate(relative: RelativeDateFilter, context: {
+    calendar: RelativeDateCalendar;
+    preferences: ResolvedTemporalValueFormatPreferences;
+}): RelativeDateSummary;

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

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { matrixAnalyticalIntentSchema } from './matrix-definition-contract.js';
 import { matrixResultSchema } from './matrix-window-contract.js';
 import { CalendarContext } from '../report-runtime-context/index.js';
+import { DateUnit } from './relative-date-filter.js';
 export type SemaphorProtocolVersion = 1;
 export type SemaphorDialect = 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 export type SemaphorSourceLevel = 'database' | 'schema' | 'table';
@@ -351,12 +352,20 @@ export type SemaphorRelativeTimeWindow = {
     anchor?: 'now' | 'latest_available';
     completeness?: 'include_partial' | 'complete_periods';
 };
+/** A whole calendar period, such as this month or the previous quarter. */
+export type SemaphorCalendarTimeWindow = {
+    kind: 'calendar';
+    unit: DateUnit;
+    period: 'this' | 'previous';
+    /** Only with period "this": the period so far, ending at the anchor. */
+    toDate?: boolean;
+};
 export type SemaphorAbsoluteTimeWindow = {
     kind: 'absolute';
     start: string;
     end: string;
 };
-export type SemaphorTimeWindow = SemaphorRelativeTimeWindow | SemaphorAbsoluteTimeWindow;
+export type SemaphorTimeWindow = SemaphorRelativeTimeWindow | SemaphorCalendarTimeWindow | SemaphorAbsoluteTimeWindow;
 export type SemaphorPaginationRequest = {
     page: number;
     pageSize: number;
@@ -816,12 +825,6 @@ export type SemaphorOperationIntent = {
     targetDashboardId?: string;
     analyticsIntent?: SemaphorAnalyticsIntent;
     context?: Record<string, unknown>;
-} | {
-    version: SemaphorProtocolVersion;
-    kind: 'data_app_change';
-    instruction: string;
-    analyticsIntent?: SemaphorAnalyticsIntent;
-    context?: Record<string, unknown>;
 };
 export type SemaphorRecoveryToolCall = {
     name: 'semaphor_get_dataset_schema' | 'semaphor_analyze' | 'semaphor_query_sql_advanced' | string;

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

@@ -5,7 +5,6 @@ export * from './option-relevance.js';
 export * from './validators.js';
 export * from './analyze-result-contract.js';
 export * from './catalog-field-grounding.js';
-export * from './data-app-codegen-summary.js';
 export * from './runtime-schemas.js';
 export * from './source-capabilities.js';
 export * from './catalog-source-address.js';
@@ -21,6 +20,18 @@ export * from './selection-filter-compiler.js';
 export * from './temporal-context.js';
 export * from './temporal-bucket-contract.js';
 export * from './raw-temporal-contract.js';
+export * from './relative-date-filter.js';
+export * from './relative-date-label.js';
+export * from './operation-temporal-state.js';
+/**
+ * The saved filter contract, strict: a key outside it (an execution-only
+ * field the server adds while it runs a filter) fails to parse, so a save
+ * point can prove it saves no run state (temporal predicate contract E2).
+ */
+export { filterGroupSchema as savedFilterGroupSchema } from './explorer-input-schemas.js';
+export * from '../temporal/index.js';
+export * from './time-window.js';
+export * from './time-window-schema.js';
 export * from './scalar-value.js';
 export * from './matrix-window-contract.js';
 export * from './matrix-member-presentation.js';

package/dist/types/shared/analytics-protocol/matrix-definition-contract.d.ts

@@ -300,7 +300,7 @@ declare const specShape: z.ZodObject<{
         levelId: string;
         axis: "columns" | "rows";
         direction: "asc" | "desc";
-        nulls: "first" | "last";
+        nulls: "last" | "first";
     }[];
     rankings: readonly MatrixRanking[];
     filters?: FilterGroup | undefined;
@@ -367,7 +367,7 @@ declare const specShape: z.ZodObject<{
         levelId: string;
         axis: "columns" | "rows";
         direction: "asc" | "desc";
-        nulls: "first" | "last";
+        nulls: "last" | "first";
     }[];
     rankings: readonly MatrixRanking[];
     filters?: FilterGroup | undefined;
@@ -507,7 +507,7 @@ declare const authoringSpecShape: z.ZodObject<{
         levelId: string;
         axis: "columns" | "rows";
         direction: "asc" | "desc";
-        nulls: "first" | "last";
+        nulls: "last" | "first";
     }[];
     rankings: readonly MatrixRanking[];
     filters?: FilterGroup | undefined;
@@ -574,7 +574,7 @@ declare const authoringSpecShape: z.ZodObject<{
         levelId: string;
         axis: "columns" | "rows";
         direction: "asc" | "desc";
-        nulls: "first" | "last";
+        nulls: "last" | "first";
     }[];
     rankings: readonly MatrixRanking[];
     filters?: FilterGroup | undefined;
@@ -714,7 +714,7 @@ declare const analyticalIntentShape: z.ZodObject<{
         levelId: string;
         axis: "columns" | "rows";
         direction: "asc" | "desc";
-        nulls: "first" | "last";
+        nulls: "last" | "first";
     }[];
     rankings: readonly MatrixRanking[];
     filters?: FilterGroup | undefined;
@@ -782,7 +782,7 @@ declare const analyticalIntentShape: z.ZodObject<{
         levelId: string;
         axis: "columns" | "rows";
         direction: "asc" | "desc";
-        nulls: "first" | "last";
+        nulls: "last" | "first";
     }[];
     rankings: readonly MatrixRanking[];
     filters?: FilterGroup | undefined;
@@ -3837,7 +3837,7 @@ declare const viewStateShape: z.ZodObject<{
         levelId: string;
         axis: "columns" | "rows";
         direction: "asc" | "desc";
-        nulls: "first" | "last";
+        nulls: "last" | "first";
     }[];
 }, {
     columns: {
@@ -3904,7 +3904,7 @@ declare const viewStateShape: z.ZodObject<{
         levelId: string;
         axis: "columns" | "rows";
         direction: "asc" | "desc";
-        nulls: "first" | "last";
+        nulls: "last" | "first";
     }[];
 }>;
 type MatrixViewStateSchema = z.ZodEffects<typeof viewStateShape>;
@@ -4200,7 +4200,7 @@ declare const definitionInputShape: z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly MatrixRanking[];
         filters?: FilterGroup | undefined;
@@ -4316,7 +4316,7 @@ declare const definitionInputShape: z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
     } | undefined;
 }, {
@@ -4601,7 +4601,7 @@ declare const definitionInputShape: z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly MatrixRanking[];
         filters?: FilterGroup | undefined;
@@ -4717,7 +4717,7 @@ declare const definitionInputShape: z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
     } | undefined;
 }>;
@@ -5012,7 +5012,7 @@ declare const configShape: z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly MatrixRanking[];
         filters?: FilterGroup | undefined;
@@ -5346,7 +5346,7 @@ declare const configShape: z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly MatrixRanking[];
         filters?: FilterGroup | undefined;
@@ -5690,7 +5690,7 @@ declare const authoringConfigShape: z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly MatrixRanking[];
         filters?: FilterGroup | undefined;
@@ -6024,7 +6024,7 @@ declare const authoringConfigShape: z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly MatrixRanking[];
         filters?: FilterGroup | undefined;
@@ -6464,7 +6464,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly MatrixRanking[];
         filters?: FilterGroup | undefined;
@@ -6802,7 +6802,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly MatrixRanking[];
         filters?: FilterGroup | undefined;
@@ -7146,7 +7146,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly MatrixRanking[];
         filters?: FilterGroup | undefined;
@@ -7439,7 +7439,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly MatrixRanking[];
         filters?: FilterGroup | undefined;

package/dist/types/shared/analytics-protocol/matrix-operation-contract.d.ts

@@ -77,7 +77,7 @@ export declare const matrixRuntimeInputsSchema: z.ZodObject<{
         levelId: string;
         axis: "columns" | "rows";
         direction: "asc" | "desc";
-        nulls: "first" | "last";
+        nulls: "last" | "first";
     }, {
         target: import('./matrix-definition-contract.js').MatrixSortTarget;
         scope: {
@@ -102,7 +102,7 @@ export declare const matrixRuntimeInputsSchema: z.ZodObject<{
         levelId: string;
         axis: "columns" | "rows";
         direction: "asc" | "desc";
-        nulls: "first" | "last";
+        nulls: "last" | "first";
     }>, "many">>>;
 }, "strip", z.ZodTypeAny, {
     runtimeSorts?: readonly {
@@ -129,7 +129,7 @@ export declare const matrixRuntimeInputsSchema: z.ZodObject<{
         levelId: string;
         axis: "columns" | "rows";
         direction: "asc" | "desc";
-        nulls: "first" | "last";
+        nulls: "last" | "first";
     }[] | undefined;
     runtimeFilters?: import('../../components/index.js').FilterGroup | undefined;
 }, {
@@ -157,7 +157,7 @@ export declare const matrixRuntimeInputsSchema: z.ZodObject<{
         levelId: string;
         axis: "columns" | "rows";
         direction: "asc" | "desc";
-        nulls: "first" | "last";
+        nulls: "last" | "first";
     }[] | undefined;
     runtimeFilters?: import('../../components/index.js').FilterGroup | undefined;
 }>;
@@ -375,7 +375,7 @@ declare const matrixExecutionShape: {
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }, {
             target: import('./matrix-definition-contract.js').MatrixSortTarget;
             scope: {
@@ -400,7 +400,7 @@ declare const matrixExecutionShape: {
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }>, "many">>;
         rankings: z.ZodReadonly<z.ZodArray<z.ZodType<import('./matrix-definition-contract.js').MatrixRanking, z.ZodTypeDef, import('./matrix-definition-contract.js').MatrixRanking>, "many">>;
     } & {
@@ -479,7 +479,7 @@ declare const matrixExecutionShape: {
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly import('./matrix-definition-contract.js').MatrixRanking[];
         filters?: import('../../components/index.js').FilterGroup | undefined;
@@ -561,7 +561,7 @@ declare const matrixExecutionShape: {
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly import('./matrix-definition-contract.js').MatrixRanking[];
         filters?: import('../../components/index.js').FilterGroup | undefined;
@@ -643,7 +643,7 @@ declare const matrixExecutionShape: {
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly import('./matrix-definition-contract.js').MatrixRanking[];
         filters?: import('../../components/index.js').FilterGroup | undefined;
@@ -725,7 +725,7 @@ declare const matrixExecutionShape: {
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly import('./matrix-definition-contract.js').MatrixRanking[];
         filters?: import('../../components/index.js').FilterGroup | undefined;

package/dist/types/shared/analytics-protocol/matrix-operation-request.d.ts

@@ -209,7 +209,7 @@ export declare const matrixOperationRequestSchema: z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }, {
             target: import('./matrix-definition-contract.js').MatrixSortTarget;
             scope: {
@@ -234,7 +234,7 @@ export declare const matrixOperationRequestSchema: z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }>, "many">>;
         rankings: z.ZodReadonly<z.ZodArray<z.ZodType<import('./matrix-definition-contract.js').MatrixRanking, z.ZodTypeDef, import('./matrix-definition-contract.js').MatrixRanking>, "many">>;
     } & {
@@ -313,7 +313,7 @@ export declare const matrixOperationRequestSchema: z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly import('./matrix-definition-contract.js').MatrixRanking[];
         filters?: import('../../components/index.js').FilterGroup | undefined;
@@ -395,7 +395,7 @@ export declare const matrixOperationRequestSchema: z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly import('./matrix-definition-contract.js').MatrixRanking[];
         filters?: import('../../components/index.js').FilterGroup | undefined;
@@ -477,7 +477,7 @@ export declare const matrixOperationRequestSchema: z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly import('./matrix-definition-contract.js').MatrixRanking[];
         filters?: import('../../components/index.js').FilterGroup | undefined;
@@ -559,7 +559,7 @@ export declare const matrixOperationRequestSchema: z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly import('./matrix-definition-contract.js').MatrixRanking[];
         filters?: import('../../components/index.js').FilterGroup | undefined;
@@ -644,7 +644,7 @@ export declare const matrixOperationRequestSchema: z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly import('./matrix-definition-contract.js').MatrixRanking[];
         filters?: import('../../components/index.js').FilterGroup | undefined;
@@ -729,7 +729,7 @@ export declare const matrixOperationRequestSchema: z.ZodObject<{
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly import('./matrix-definition-contract.js').MatrixRanking[];
         filters?: import('../../components/index.js').FilterGroup | undefined;

package/dist/types/shared/analytics-protocol/matrix-window-contract.d.ts

@@ -90,6 +90,33 @@ export type MatrixWindowOutcome = {
     status: 'failed';
     failure: MatrixFailure;
 };
+/**
+ * One present intersection of an indexed block: positions into the block's
+ * own coverage lists, then the value. Absent means no data at that
+ * intersection; `null` is a present aggregate null.
+ */
+export type MatrixIndexedCell = readonly [
+    row: number,
+    column: number,
+    measure: number,
+    value: SemaphorScalarValue
+];
+/** The dashboard's wire form of a cell block: each path is sent once, in coverage. */
+export type MatrixIndexedCellBlock = {
+    requestId: string;
+    coverage: MatrixCellBlock['coverage'];
+    values: readonly MatrixIndexedCell[];
+};
+export type MatrixIndexedWindow = Omit<MatrixWindow, 'blocks'> & {
+    blocks: readonly MatrixIndexedCellBlock[];
+};
+export type MatrixIndexedWindowOutcome = {
+    status: 'success' | 'partial';
+    window: MatrixIndexedWindow;
+} | {
+    status: 'failed';
+    failure: MatrixFailure;
+};
 type MatrixWindowInput = {
     spec: MatrixSpec;
     request: MatrixWindowRequest;
@@ -98,9 +125,14 @@ type MatrixResult = {
     kind: 'matrix';
     window: MatrixWindow;
 };
-/** Shared request ceiling used by client tile sizing and server enforcement. */
+/**
+ * Shared ceilings: request coordinates (client tile sizing and server
+ * enforcement), and the serialized size of one acquired window at its
+ * indexed size, which is what the dashboard receives.
+ */
 export declare const MATRIX_WINDOW_LIMITS: Readonly<{
     coordinates: 20000;
+    responseBytes: number;
 }>;
 export declare const matrixPageRequestSchema: z.ZodType<MatrixPageRequest>;
 export declare const matrixPathSelectionSchema: z.ZodType<MatrixPathSelection>;
@@ -109,6 +141,8 @@ export declare const matrixWindowRequestSchema: z.ZodType<MatrixWindowRequest>;
 export declare const matrixWindowInputSchema: z.ZodType<MatrixWindowInput>;
 export declare const matrixAxisPageSchema: z.ZodType<MatrixAxisPage>;
 export declare const matrixCellBlockSchema: z.ZodType<MatrixCellBlock>;
+/** Positions are checked against coverage; no per-cell path keys are built. */
+export declare const matrixIndexedCellBlockSchema: z.ZodType<MatrixIndexedCellBlock>;
 export declare const matrixDescriptorSchema: z.ZodObject<{
     id: z.ZodString;
     column: z.ZodType<SemaphorResultColumn, z.ZodTypeDef, SemaphorResultColumn>;
@@ -327,8 +361,20 @@ export declare const matrixDescriptorSchema: z.ZodObject<{
 }>;
 export declare const matrixFailureSchema: z.ZodType<MatrixFailure>;
 export declare const matrixCapabilitiesSchema: z.ZodType<MatrixCapabilities>;
-export declare const matrixWindowSchema: z.ZodType<MatrixWindow>;
+export declare const matrixWindowSchema: z.ZodType<MatrixWindow, z.ZodTypeDef, MatrixWindow>;
+export declare const matrixIndexedWindowSchema: z.ZodType<MatrixIndexedWindow, z.ZodTypeDef, MatrixIndexedWindow>;
 export declare const matrixWindowOutcomeSchema: z.ZodType<MatrixWindowOutcome>;
+export declare const matrixIndexedWindowOutcomeSchema: z.ZodType<MatrixIndexedWindowOutcome>;
+/**
+ * The indexed wire form of a block. Every cell must be inside coverage (the
+ * block schema guarantees it for parsed blocks).
+ */
+export declare function encodeMatrixCellBlock(block: MatrixCellBlock): MatrixIndexedCellBlock;
+/** Cells again; their paths are the coverage path objects, not copies. */
+export declare function decodeMatrixCellBlock(block: MatrixIndexedCellBlock): MatrixCellBlock;
+export declare function encodeMatrixWindow(window: MatrixWindow): MatrixIndexedWindow;
+export declare function decodeMatrixWindow(window: MatrixIndexedWindow): MatrixWindow;
+export declare function encodeMatrixWindowOutcome(outcome: MatrixWindowOutcome): MatrixIndexedWindowOutcome;
 export declare const matrixResultSchema: z.ZodType<MatrixResult>;
 export type MatrixExportColumn = {
     kind: 'hierarchy';
@@ -371,15 +417,15 @@ export type MatrixExportRow = {
     columnPath: MatrixPath;
     values: readonly MatrixExportValue[];
 };
-type MatrixExportRowInput = Omit<Extract<MatrixExportRow, {
+type MatrixExportRowInput = (Omit<Extract<MatrixExportRow, {
     kind: 'layout';
 }>, 'values'> & {
     values: readonly MatrixExportValueInput[];
-} | Omit<Extract<MatrixExportRow, {
+}) | (Omit<Extract<MatrixExportRow, {
     kind: 'flat';
 }>, 'values'> & {
     values: readonly MatrixExportValueInput[];
-};
+});
 export type MatrixExportBatch = {
     kind: 'layout';
     layout: MatrixExportLayout;

package/dist/types/shared/analytics-protocol/metric-comparison.d.ts

@@ -74,8 +74,6 @@ export type GlobalDateComparisonContext = {
     selection: GlobalDateComparisonSelection;
     inheritGlobalComparison?: false;
     owner?: DashboardDateComparisonOwner;
-    /** Fixed execution clock carried by authoritative dashboard replay snapshots. */
-    referenceTime?: string;
 };
 export type ResolvedMetricComparisonRequest = {
     source: 'explicit';
@@ -95,7 +93,9 @@ export type ResolvedDateWindow = {
     endExclusive: string;
     timezone: string;
 };
-export type ComparisonUnavailableReason = 'finite_current_window_required' | 'current_window_not_started' | 'temporal_binding_missing' | 'temporal_binding_ambiguous' | 'temporal_binding_invalid' | 'unsupported_output_shape' | 'unsupported_raw_sql' | 'insufficient_history' | 'invalid_comparison_spec' | 'comparison_execution_failed';
+export type ComparisonUnavailableReason = 'finite_current_window_required' | 'current_window_not_started'
+/** The date ranges the run applies to the field have no instant in common. */
+ | 'current_window_empty' | 'temporal_binding_missing' | 'temporal_binding_ambiguous' | 'temporal_binding_invalid' | 'unsupported_output_shape' | 'unsupported_raw_sql' | 'insufficient_history' | 'invalid_comparison_spec' | 'comparison_execution_failed';
 export type ComparisonAvailability = {
     status: 'available';
 } | {
@@ -174,6 +174,12 @@ export declare function validateMetricComparisonSpec(value: unknown, path?: stri
 export declare function validateMetricComparisonConfig(value: unknown, path?: string): SemaphorValidationResult;
 export declare function validateGlobalDateComparisonSelection(value: unknown, path?: string): SemaphorValidationResult;
 export declare function validateGlobalDateComparisonContext(value: unknown, path?: string): SemaphorValidationResult;
+/**
+ * A validated comparison context without the legacy `referenceTime`, so no
+ * request replays the clock a stored rule or an old client stamped: every
+ * operation pins its own instant (analytics kernel K5).
+ */
+export declare function withoutLegacyComparisonClock(context: GlobalDateComparisonContext): GlobalDateComparisonContext;
 export declare function validateMetricComparisonPolarity(value: unknown, path?: string): SemaphorValidationResult;
 export declare function validateComparisonPresentationSpec(value: unknown, path?: string): SemaphorValidationResult;
 export declare function evaluateMetricComparison(input: {

package/dist/types/shared/analytics-protocol/operation-temporal-state.d.ts

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+/**
+ * The latest value of a field within a lookup scope, as the database wrote it
+ * (never a value passed through a JavaScript `Date`), or `null` when the scope
+ * has no rows. It carries no type: the server takes the native type from the
+ * field's governed metadata.
+ */
+export type DataAnchor = {
+    key: string;
+    nativeText: string | null;
+};
+/**
+ * What one operation fixed: the instant every relative date resolves on, and
+ * the data anchors it read. Governed responses report it; requests that
+ * continue the operation (a Matrix page or expansion) send it back.
+ */
+export type OperationTemporalState = {
+    executionInstant: string;
+    dataAnchors: DataAnchor[];
+};
+/**
+ * Strict. A request may send only `{ executionInstant }`; `dataAnchors`
+ * defaults to none. The instant must be a full ISO instant, and anchor keys
+ * are unique.
+ */
+export declare const operationTemporalStateSchema: z.ZodEffects<z.ZodObject<{
+    executionInstant: z.ZodEffects<z.ZodString, string, string>;
+    dataAnchors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        nativeText: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        key: string;
+        nativeText: string | null;
+    }, {
+        key: string;
+        nativeText: string | null;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    executionInstant: string;
+    dataAnchors: {
+        key: string;
+        nativeText: string | null;
+    }[];
+}, {
+    executionInstant: string;
+    dataAnchors?: {
+        key: string;
+        nativeText: string | null;
+    }[] | undefined;
+}>, {
+    executionInstant: string;
+    dataAnchors: {
+        key: string;
+        nativeText: string | null;
+    }[];
+}, {
+    executionInstant: string;
+    dataAnchors?: {
+        key: string;
+        nativeText: string | null;
+    }[] | undefined;
+}>;
+/** The state as parsed, or `undefined` when absent or invalid. */
+export declare function readOperationTemporalState(value: unknown): OperationTemporalState | undefined;