react-semaphor 0.1.526 → 0.1.528

package/dist/types/lib/utils/inline-filter-utils.d.ts

@@ -1,5 +1,6 @@
 import { TDashboard } from '../types/common-types.js';
 import { TFilterValue } from '../../components/surfboard/filter/types.js';
+import { DefaultsCalendar } from './filter-default-value-utils.js';
 /**
  * Hydrate inline filter defaults for all cards in the dashboard.
  * Returns a map of cardId → TFilterValue[] for runtime-only storage.
@@ -9,7 +10,7 @@ import { TFilterValue } from '../../components/surfboard/filter/types.js';
  * function only owns traversal and card-scoped runtime storage.
  *
  * @param dashboard - The dashboard to extract inline filter defaults from
- * @param timezone - Optional timezone for date calculations (defaults to browser timezone)
+ * @param calendar - The report calendar (or its timezone) for date defaults (defaults to the browser timezone)
  * @returns Map of cardId to array of filter values
  */
-export declare function computeInlineFilterDefaults(dashboard: TDashboard, timezone?: string): Record<string, TFilterValue[]>;
+export declare function computeInlineFilterDefaults(dashboard: TDashboard, calendar?: DefaultsCalendar): Record<string, TFilterValue[]>;

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/aggregate-expression.d.ts

@@ -0,0 +1,89 @@
+/**
+ * The one aggregate vocabulary and expression scanner for measure
+ * expressions (analytics owners plan, owner A). Every consumer that asks
+ * "does this expression aggregate, with which functions, and how are they
+ * combined?" reads it here instead of keeping its own function list or
+ * regular expression.
+ *
+ * Expressions are Semaphor SQL templates: `{field_N}` tokens for inputs,
+ * SQL function calls, string literals in single or double quotes.
+ */
+/** What an aggregate function computes, for analytics decisions. */
+export type AggregationFunctionKind = 'count' | 'count_distinct' | 'sum' | 'avg' | 'min' | 'max' | 'median'
+/** Unchanged when input rows repeat: BOOL_AND, BIT_OR, ANY_VALUE, ... */
+ | 'repeat_safe_other' | 'other';
+/** Whether a SQL function name is an aggregate. */
+export declare function isAggregateFunctionName(name: string): boolean;
+/**
+ * What an aggregate call computes. A DISTINCT argument makes COUNT a
+ * distinct count; any other aggregate over DISTINCT values counts each
+ * value once, so it is unchanged by repeated rows.
+ */
+export declare function aggregationFunctionKind(name: string, distinct?: boolean): AggregationFunctionKind;
+/** One outermost aggregate call in an expression. */
+export type ScannedAggregateCall = {
+    name: string;
+    kind: AggregationFunctionKind;
+    distinct: boolean;
+    /** Followed by OVER (...): a window, not a group aggregate. */
+    windowed: boolean;
+    /** Input tokens inside the call (`field_N` names). */
+    tokens: string[];
+    /** Source offsets for compiler rewrites; end excludes FILTER/OVER suffixes. */
+    span: {
+        start: number;
+        end: number;
+        argumentStart: number;
+        argumentEnd: number;
+    };
+    argumentCount: number;
+    filtered: boolean;
+};
+export type ScannedAggregateExpression = {
+    calls: ScannedAggregateCall[];
+    /** An aggregate call inside another aggregate call. */
+    nestedAggregate: boolean;
+    windowed: boolean;
+    /** Input tokens that occur outside every aggregate call, in order. */
+    tokensOutsideAggregates: string[];
+    /** All data reads belong to recognized aggregate calls; the rest consists
+     * only of literals, operators and understood scalar composition. */
+    aggregateInputsComplete: boolean;
+    /**
+     * The expression with each outermost aggregate call replaced by `@N` (its
+     * index in `calls`) and each token outside a call by `#token`, for shape
+     * analysis.
+     */
+    skeleton: string;
+};
+/**
+ * Scans an expression's aggregate calls (outermost only), their DISTINCT,
+ * FILTER and OVER suffixes, and the input tokens outside them.
+ */
+export declare function scanAggregateExpression(expression: string, resolvedInputTokens?: ReadonlySet<string>): ScannedAggregateExpression;
+/** A unit of an expression skeleton: an aggregate call or an input token. */
+export type SkeletonUnit = {
+    kind: 'call';
+    index: number;
+} | {
+    kind: 'token';
+    token: string;
+};
+/**
+ * The shape of a skeleton: one unit (possibly in parentheses), a linear
+ * combination of units (sums and differences, scaled by numeric constants),
+ * or anything else (ratios, products of units, functions, CASE, constants
+ * added to units).
+ */
+export type SkeletonShape = {
+    kind: 'single';
+    unit: SkeletonUnit;
+} | {
+    kind: 'linear';
+    units: SkeletonUnit[];
+} | {
+    kind: 'other';
+    hasDivision: boolean;
+};
+/** Classifies a skeleton from `scanAggregateExpression`. */
+export declare function skeletonShape(skeleton: string): SkeletonShape;

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

@@ -0,0 +1,32 @@
+/**
+ * One typed refusal for governed analytics (analytics owners plan, owner C).
+ * Wherever a query is refused or fails, the refusal carries one code from
+ * this list, the structured details, and the next step, unchanged through
+ * every strategy to the tool that maps it once. Input validation keeps its
+ * own specific codes (`invalid_dimension`, `missing_measure`, ...); every
+ * other failure uses these.
+ */
+export declare const ANALYTICS_REFUSAL_CODES: readonly ["invalid_request", "missing_relationship", "ambiguous_relationship", "unsafe_join", "unsupported_capability", "capability_required", "forbidden", "not_found", "execution_failed", "timeout", "budget_exceeded", "cancelled"];
+export type AnalyticsRefusalCode = (typeof ANALYTICS_REFUSAL_CODES)[number];
+export type AnalyticsRefusal = {
+    code: AnalyticsRefusalCode;
+    message: string;
+    /** Structured specifics: planner code, datasets, path, field, SQL. */
+    details?: Record<string, unknown>;
+    /** What the caller can do next; absent when retrying is the only option. */
+    nextStep?: string;
+    /** Only warehouse failures and timeouts are worth retrying unchanged. */
+    retryable: boolean;
+    /** HTTP status for routes that answer with one. */
+    status: number;
+};
+export declare function isAnalyticsRefusalCode(value: unknown): value is AnalyticsRefusalCode;
+/** Builds a refusal with the code's status and retry rule. */
+export declare function analyticsRefusal(code: AnalyticsRefusalCode, message: string, extra?: {
+    details?: Record<string, unknown>;
+    nextStep?: string;
+    status?: number;
+}): AnalyticsRefusal;
+/** Reads a refusal carried on a value (an error, a result, a response). */
+export declare function readAnalyticsRefusal(value: unknown): AnalyticsRefusal | undefined;
+export declare function publicAnalyticsRefusal(refusal: Pick<AnalyticsRefusal, 'code'> & Partial<Pick<AnalyticsRefusal, 'status' | 'retryable'>>): AnalyticsRefusal;

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;
@@ -723,7 +732,45 @@ export type SemaphorRelationshipDiagnostics = {
     fanoutRisk?: {
         status: 'none' | 'warning' | 'error' | 'unknown';
         message?: string;
+        /** The planner's structured findings (analytics owners plan, owner B). */
+        findings?: SemaphorJoinFinding[];
     };
+    /** How queries ran their joins; mixed means component queries used different strategies. */
+    joinStrategy?: 'plain_join' | 'aggregate_then_join' | 'mixed' | 'unknown';
+};
+/** One join walked from a measure's dataset, with its cardinality that way. */
+export type SemaphorJoinStep = {
+    from: string;
+    to: string;
+    relationship?: string;
+    walked: 'to_one' | 'to_many' | 'many_to_many' | 'unknown';
+};
+/** What a join does to a measure's rows, as the planner classifies it. */
+export type SemaphorJoinFinding = 
+/** Rows repeat per member of a bridge or dimension many side: values per member are attributions. */
+{
+    kind: 'attribution';
+    measureDataset: string;
+    via: SemaphorJoinStep[];
+}
+/** Rows repeat per row of another fact (a chasm trap): values are inflated. */
+ | {
+    kind: 'inflation';
+    measureDataset: string;
+    otherFact: string;
+    via: SemaphorJoinStep[];
+}
+/** A step's cardinality isn't authored, so repeats can't be ruled out. */
+ | {
+    kind: 'unknown_cardinality';
+    measureDataset: string;
+    via: SemaphorJoinStep[];
+}
+/** Measures from facts with no direct relationship, combined at a shared grain. */
+ | {
+    kind: 'cross_fact';
+    datasets: string[];
+    sharedGrain?: string[];
 };
 export type SemaphorAnalyticsPopulation = {
     scope: 'filtered_query';
@@ -816,12 +863,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,21 @@ 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';
+export * from './aggregate-expression.js';
+export * from './measure-aggregation-profile.js';
+export * from './analytics-refusal.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;