react-semaphor 0.1.525 → 0.1.527

package/dist/types/lib/stores/dashboard-store.d.ts

@@ -101,8 +101,12 @@ export type DashboardStore = {
     cardViewState: CardViewStateMap;
     /** Session-only server pagination, attached to the query identity that owns each page. */
     dashboardCardPagination: Record<string, DashboardCardPaginationState>;
-    /** Fixed execution clock from a strict dashboard input replay snapshot. */
-    dashboardInputReferenceTime?: string;
+    /**
+     * When the replayed input snapshot was generated, for a document's
+     * "Generated at" text only. Queries never read it: a print render's
+     * instant comes from its pinned calendar (analytics kernel K15).
+     */
+    dashboardInputGeneratedAt?: string;
     /**
      * Set when a PDF render's sheet has applicable inputs that were never
      * captured. The sheet must not print; DashboardTabs renders the reason.
@@ -205,14 +209,14 @@ type Actions = {
     setDashboard: (dashboard: TDashboard, options?: {
         semanticExecutionPayload?: SemanticExecutionPayload;
         dashboardInputValues?: DashboardInputValues;
-        dashboardInputReferenceTime?: string;
+        dashboardInputGeneratedAt?: string;
         reportContext?: ReportRuntimeContext;
     }) => void;
     setDashboardWithFilterValues: (dashboard: TDashboard, filterValues: TFilterValue[], runtimeOverrides?: Record<string, unknown>, options?: {
         selectedSheetId?: string | null;
         semanticExecutionPayload?: SemanticExecutionPayload;
         dashboardInputValues?: DashboardInputValues;
-        dashboardInputReferenceTime?: string;
+        dashboardInputGeneratedAt?: string;
         /** Drill paths replayed from an execution snapshot. */
         cardViewState?: CardViewStateMap;
         transientContexts?: TransientInputContext[];
@@ -226,6 +230,7 @@ type Actions = {
     setDashboardTheme: (theme: 'light' | 'dark' | 'system') => void;
     setDashboardTitle: (title: string) => void;
     setDashboardDescription: (description: string) => void;
+    setDashboardExportDefaults: (exportDefaults: TDashboard['exportDefaults']) => void;
     setSheets: (sheets: TSheet[]) => void;
     addSheet: (sheet: TSheet) => void;
     duplicateSheet: (sheetId: string) => string | null;

package/dist/types/lib/stores/editor-store.d.ts

@@ -1,7 +1,6 @@
-import { ColorRange, TCard, TCardPreferences, TCustomCardPreferences, TFrame, TLegendOptions, AggregateCalc, SqlGen, ControlDefinition } from '../types/common-types.js';
+import { ColorRange, TCard, TCardPreferences, TCustomCardPreferences, TFrame, TLegendOptions, AIScopeTable, AggregateCalc, SqlGen, ControlDefinition } from '../types/common-types.js';
 import { TFilterValue } from '../../components/surfboard/filter/types.js';
 import { TChartType } from '../charts/types.js';
-import { AIScopeTable } from '../../components/index.js';
 import { FilterByColumn, OldFilterValue, GroupByColumn, MetricColumn, OrderBy, QueryConfig } from '../types/query-types.js';
 import { TableActions } from './table-actions.js';
 import { CardConfig, QueryColumnKeyMap } from '../types/explorer-types.js';

package/dist/types/lib/stores/table-actions.d.ts

@@ -1,6 +1,7 @@
 import { PersistedColumnSettingsMap } from '../../components/visual/data-table/types/data-table.js';
 import { ColumnSizingState } from '@tanstack/react-table';
-import { EditorStore, TCard } from '../../components/index.js';
+import { EditorStore } from './editor-store.js';
+import { TCard } from '../types/common-types.js';
 import { TableBaseFormatting, TableConditionalFormatting } from '../table-formatting/index.js';
 export declare const EMPTY_COLUMN_SETTINGS: PersistedColumnSettingsMap;
 export declare const EMPTY_COLUMN_VISIBILITY: Record<string, boolean>;

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

@@ -31,11 +31,18 @@ export declare function formatTimeInTimezone(date: Date, timezone: string): stri
 export declare function composeDateTimeInTimezone(date: Date, time: string, timezone: string, options?: {
     boundary?: 'start' | 'end';
 }): Date | null;
-export declare function normalizeDateFilterRange(date: DateRange, options?: {
+/**
+ * The range a date filter stores. At day precision, a single day (a start
+ * with no end, or an end equal to the start) becomes that whole calendar day
+ * in the report timezone, ending its last millisecond: 23 or 25 hours on a
+ * daylight-saving day, and never the next day's midnight, which an inclusive
+ * range would count (on a date column, as the whole next day).
+ */
+export declare function normalizeDateFilterRange(date: DateRange, options: {
     temporalPrecision?: TemporalPrecision;
+    timezone: string;
 }): {
     from?: Date;
     to?: Date;
     values: [Date | string, Date | string] | [Date | string];
 };
-export declare function resolveSubDayRelativeDateRange(meta: RelativeDateFilter, anchor?: Date): [Date, Date] | null;

package/dist/types/lib/types/common-types.d.ts

@@ -15,6 +15,7 @@ import { DashboardAIContext } from './assistant-types.js';
 import { CardInteractionConfig, InteractionTargetOverride } from './interaction-types.js';
 import { SemanticExecutionPayload } from './semantic-runtime-types.js';
 import { ReportRuntimeContext } from '../../shared/report-runtime-context/index.js';
+import { CsvEncoding } from '../../shared/format-utils/exporters/csv-utils.js';
 import { PresentationExecutionSnapshot, TemporalInputPresentation } from '../../shared/format-utils/index.js';
 import { JSX } from 'react';
 export type { DashboardFilterApplication, DashboardFilterBoundCardApplication, DashboardFilterCardApplication, DashboardFilterExcludedCardApplication, DashboardFilterTarget, DashboardFilterTargetField, DashboardFilterTargetSource, DashboardFilterOptionSource, } from '../../shared/dashboard-authoring/dashboard-filter-mapping-types.js';
@@ -1573,6 +1574,10 @@ export type TDashboard = {
         /** Dashboard creation sets 'on'. Absent resolves to 'off', so existing dashboards do not change. */
         clickToFilter: 'on' | 'off';
     };
+    exportDefaults?: {
+        /** Absent resolves to DEFAULT_CSV_ENCODING, so existing dashboards do not change. */
+        csvEncoding?: CsvEncoding;
+    };
     aiContext?: DashboardAIContext;
     summary?: {
         enabled?: boolean;

package/dist/types/lib/types/explorer-types.d.ts

@@ -2,6 +2,7 @@ import { TimeDrillStep } from './interaction-types.js';
 import { SemaphorDerivedFieldDefinition, MatrixConfig, SemaphorSourceRef, SemaphorResultColumn, SemaphorPivotValue, SemaphorTimeGrain, SemanticGroupedTemporalInput, TemporalBucketMetadata, TemporalBucketFormat, MetricComparisonConfig, MetricComparisonPolarity } from '../../shared/analytics-protocol/index.js';
 import { CanonicalPivotResultContract, CanonicalPivotResultState, FlatTableExportTotalsBehavior, FlatTableExportTotalsRequest, QueryColumnKeyMap as SharedQueryColumnKeyMap } from '../../shared/format-utils/index.js';
 import { TemporalResultOwner } from '../../shared/dashboard-authoring/index.js';
+import { RelativeDateFilter } from '../../shared/analytics-protocol/relative-date-filter.js';
 /**
  * Special entity name marker for calculated fields.
  *
@@ -464,6 +465,19 @@ export interface FilterCondition {
     label?: string;
     /** Governed meaning for a canonical grouped-temporal scalar. */
     temporalBucket?: TemporalBucketMetadata;
+    /**
+     * Relative date window ("This month"). When present it is authoritative:
+     * the server resolves it on every run and `value` only keeps the range seen
+     * when it was saved. Valid only with `between` and `not between`.
+     */
+    relativeMeta?: RelativeDateFilter;
+    /**
+     * "Equals the latest value of this field" (analytics kernel K13). With `=`
+     * on a date or timestamp field only. The server resolves it on every run
+     * through the field's data anchor; `value` only keeps the value seen when
+     * it was saved.
+     */
+    latestValue?: true;
 }
 export interface FilterGroup {
     id: string;

package/dist/types/lib/types/token-types.d.ts

@@ -67,10 +67,6 @@ export type TokenSecurityPolicy = {
  * UI and behavior configuration for the embedded dashboard.
  */
 export type UIConfig = {
-    /**
-     * Enables self-service editing by the end user. Legacy field. Use config.allowEdit instead.
-     */
-    allowEdit?: boolean;
     /**
      * Enables advanced mode features in the dashboard.
      * Defaults to true unless explicitly disabled.
@@ -121,7 +117,6 @@ export type UIConfig = {
         features: {
             dashboardAssistant: boolean;
             dashboardAiAuthoring: boolean;
-            dataAppBuilder: boolean;
             analyticalBriefings: boolean;
             aiWritingHelpers: boolean;
         };
@@ -202,10 +197,6 @@ export type TokenRequest = {
      * Display name of the end user.
      */
     displayName?: string;
-    /**
-     * Enables self-service editing by the end user.
-     */
-    allowEdit?: boolean;
     /**
      * Schema level security policy. The schema name for the tenant.
      */
@@ -274,10 +265,6 @@ export type TokenProps = {
      * Display name of the end user.
      */
     displayName?: string;
-    /**
-     * Enables self-service editing by the end user.
-     */
-    allowEdit?: boolean;
     /**
      * Schema level security policy. The schema name for the tenant.
      */

package/dist/types/lib/utils/card-definition.d.ts

@@ -326,7 +326,7 @@ export declare function getCardDefinition(card: DefinitionCard, catalog?: Matrix
                 levelId: string;
                 axis: "columns" | "rows";
                 direction: "asc" | "desc";
-                nulls: "first" | "last";
+                nulls: "last" | "first";
             }[];
             rankings: readonly import('../../shared/analytics-protocol/matrix-definition-contract.js').MatrixRanking[];
             filters?: import('../types/explorer-types.js').FilterGroup | undefined;

package/dist/types/lib/utils/date-timezone-utils.d.ts

@@ -1,4 +1,4 @@
-import { CalendarContext, WeekStart } from '../types/token-types.js';
+import { CalendarContext } from '../types/token-types.js';
 /**
  * Gets the start of day (00:00:00.000) for a date in the specified timezone.
  * This ensures that when the Date is serialized to UTC, it represents the correct day boundary.
@@ -18,7 +18,9 @@ import { CalendarContext, WeekStart } from '../types/token-types.js';
  */
 export declare const startOfDayInTimezone: (date: Date, timezone: string) => Date;
 /**
- * Gets the end of day (23:59:59.999) for a date in the specified timezone.
+ * Gets the last millisecond of the day for a date in the specified timezone:
+ * 23:59:59.999, or the instant before the next day starts on a day that
+ * ends inside a daylight-saving change.
  * This ensures that when the Date is serialized to UTC, it represents the correct day boundary.
  *
  * @param date - The date to get end of day for
@@ -49,42 +51,6 @@ export declare const endOfDayInTimezone: (date: Date, timezone: string) => Date;
  * `getEffectiveTimezone` does.
  */
 export declare const parseFilterDateValue: (value: unknown, timezone: string | null | undefined, bound?: "start" | "end") => Date | undefined;
-/**
- * Gets the start of week (midnight) for a date in the specified timezone.
- *
- * @param date - The date to get start of week for
- * @param timezone - The timezone to use (e.g., 'America/Los_Angeles')
- * @param weekStartsOn - Day the week starts on (0=Sunday, 1=Monday). Can also pass CalendarContext.
- * @returns A Date object representing midnight on the first day of the week
- *
- * @example
- * // With weekStartsOn number
- * startOfWeekInTimezone(new Date(), 'America/Chicago', 0) // Sunday start
- *
- * // With CalendarContext
- * startOfWeekInTimezone(new Date(), 'America/Chicago', { tz: 'America/Chicago', weekStart: 0, anchor: 'now' })
- */
-export declare const startOfWeekInTimezone: (date: Date, timezone: string, weekStartsOn?: WeekStart | CalendarContext) => Date;
-/**
- * Gets the end of week (23:59:59.999) for a date in the specified timezone.
- *
- * @param date - The date to get end of week for
- * @param timezone - The timezone to use (e.g., 'America/Los_Angeles')
- * @param weekStartsOn - Day the week starts on (0=Sunday, 1=Monday). Can also pass CalendarContext.
- * @returns A Date object representing the last moment of the last day of the week
- */
-export declare const endOfWeekInTimezone: (date: Date, timezone: string, weekStartsOn?: WeekStart | CalendarContext) => Date;
-export declare const startOfMonthInTimezone: (date: Date, timezone: string) => Date;
-export declare const endOfMonthInTimezone: (date: Date, timezone: string) => Date;
-export declare const startOfQuarterInTimezone: (date: Date, timezone: string) => Date;
-export declare const endOfQuarterInTimezone: (date: Date, timezone: string) => Date;
-export declare const startOfYearInTimezone: (date: Date, timezone: string) => Date;
-export declare const endOfYearInTimezone: (date: Date, timezone: string) => Date;
-export declare const shiftDateByDaysInTimezone: (date: Date, timezone: string, days: number) => Date;
-export declare const shiftDateByWeeksInTimezone: (date: Date, timezone: string, weeks: number) => Date;
-export declare const shiftDateByMonthsInTimezone: (date: Date, timezone: string, months: number) => Date;
-export declare const shiftDateByQuartersInTimezone: (date: Date, timezone: string, quarters: number) => Date;
-export declare const shiftDateByYearsInTimezone: (date: Date, timezone: string, years: number) => Date;
 /**
  * Resolves the effective timezone.
  *
@@ -111,11 +77,3 @@ export declare const shiftDateByYearsInTimezone: (date: Date, timezone: string,
  * getEffectiveTimezone() // Returns browser's timezone (e.g., 'America/Los_Angeles')
  */
 export declare const getEffectiveTimezone: (timezoneOrContext?: string | CalendarContext | null) => string;
-/**
- * Resolves the effective weekStart from CalendarContext.
- *
- * @param calendarContext - Optional CalendarContext
- * @returns The week start day (0=Sunday, 1=Monday)
- * @default 1 (Monday) for backward compatibility with ISO standard
- */
-export declare const getEffectiveWeekStart: (calendarContext?: CalendarContext | null) => WeekStart;

package/dist/types/lib/utils/filter-default-value-utils.d.ts

@@ -1,12 +1,18 @@
 import { TFilter, TFilterValue } from '../../components/surfboard/filter/types.js';
 import { TInlineFilter } from '../types/common-types.js';
+import { CalendarContext } from '../../shared/report-runtime-context/index.js';
+/**
+ * The report calendar defaults resolve in: its timezone, or the calendar
+ * with its week start too, so a week default matches the server's week.
+ */
+export type DefaultsCalendar = string | Pick<CalendarContext, 'tz' | 'weekStart'>;
 type DefaultBackedFilter = Pick<TFilter, 'id' | 'column' | 'operation' | 'dataType' | 'nativeDataType' | 'dateSelectionMode' | 'defaultValues' | 'defaultDateFilter' | 'fieldMeta' | 'semanticContext'> & Partial<Pick<TInlineFilter, 'id' | 'column' | 'operation' | 'dataType' | 'nativeDataType' | 'dateSelectionMode' | 'defaultValues' | 'defaultDateFilter' | 'fieldMeta' | 'semanticContext'>>;
 /**
  * Converts a filter's default configuration into an active runtime filter value.
  * Returns undefined when no defaults are configured.
  */
-export declare function buildFilterValueFromDefaults(filter: DefaultBackedFilter, timezone?: string): TFilterValue | undefined;
-export declare function buildFilterValuesFromDefaults(filters: DefaultBackedFilter[] | undefined, timezone?: string): TFilterValue[];
+export declare function buildFilterValueFromDefaults(filter: DefaultBackedFilter, calendar?: DefaultsCalendar | null): TFilterValue | undefined;
+export declare function buildFilterValuesFromDefaults(filters: DefaultBackedFilter[] | undefined, calendar?: DefaultsCalendar): TFilterValue[];
 export declare function isCompatibleFilterValue(filter: Pick<TFilter, 'id' | 'operation' | 'dataType'>, filterValue: TFilterValue): boolean;
 export declare function filterCompatibleFilterValues(filters: TFilter[] | undefined, filterValues: TFilterValue[] | undefined): TFilterValue[];
 export declare function mergeFilterValueLayers(baseValues: TFilterValue[], overrideValues: TFilterValue[]): TFilterValue[];

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/lib/utils.d.ts

@@ -24,9 +24,7 @@ export declare function getRequestErrorSql(error: unknown): string | undefined;
 export declare function getRequestErrorFromResponse(response: Response): Promise<RequestError>;
 export declare function requestJsonRegular(url: string, authToken: string, method?: string, data?: unknown, signal?: AbortSignal): Promise<any>;
 export declare function getRequest(url: string, authToken: string, params?: {}, signal?: AbortSignal): Promise<any>;
-export declare function postRequestEncrypted(url: string, authToken: string, data?: {}, method?: string): Promise<any>;
 export declare function postRequestRegular(url: string, authToken: string, data?: {}, method?: string): Promise<any>;
-export declare const postRequest: typeof postRequestRegular;
 export declare function getTenantAndEndUserId(accessToken: string | undefined): {
     tenantId: string;
     endUserId: string;

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;