react-semaphor 0.1.526 → 0.1.528

package/dist/surfboard/index.js

@@ -1,4 +1,4 @@
-import { a, R as s, D as o } from "../chunks/report-preferences-dialog-BcH-0lR-.js";
+import { a, R as s, D as o } from "../chunks/report-preferences-dialog-VV0-Ro6F.js";
 import { C as f, E as D } from "../chunks/common-types-C6cAQgyh.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,

package/dist/types/briefings/index.d.ts

@@ -1,6 +1,7 @@
 import { NumericCanonicalFormat, NumericPresentationTarget, PresentationExecutionSnapshot } from '../shared/format-utils/index.js';
 import { BriefingAppearanceSpec, BriefingFragments, BriefingThemeOverrides } from './presentation-contract.js';
 import { MatrixConfig } from '../shared/analytics-protocol/index.js';
+import { CsvEncoding } from '../shared/format-utils/exporters/csv-utils.js';
 export { captureMatrixExport, buildMatrixDeliveryEnvelope, matrixDeliveryPayloadSchema, matrixDeliveryQuerySchema, type MatrixLayoutReadResult } from '../shared/dashboard-authoring/matrix-delivery.js';
 export declare const BRIEFING_KIND: "BRIEFING";
 export { DEFAULT_BRIEFING_SCHEDULE, briefingScheduleMonths, briefingScheduleDayOccurs, briefingScheduleShortMonths, buildBriefingScheduleExpr, canonicalBriefingMonthDays, describeBriefingSchedule, isValidBriefingTimezone, nextBriefingScheduleDates, parseBriefingScheduleExpr, type BriefingScheduleFrequency, type BriefingScheduleMonthDay, type BriefingScheduleMonthInterval, type BriefingScheduleMonthlyOn, type BriefingScheduleOrdinal, type BriefingScheduleViewModel, } from './schedule.js';
@@ -181,6 +182,8 @@ export type BriefingAttachmentSettings = {
     includeFilters?: boolean;
     includeTimestamp?: boolean;
     delimiter?: BriefingCsvDelimiter;
+    /** Absent means the dashboard's download setting decides. */
+    csvEncoding?: CsvEncoding;
     includeHeaders?: boolean;
     useFormattedValues?: boolean;
     sheetSelection?: BriefingSheetSelection;

package/dist/types/components/explorer/filters/card-date-filter.d.ts

@@ -1,12 +1,20 @@
+import { FilterValue } from '../../../lib/types/explorer-types.js';
+import { RelativeDateFilter } from '../../../shared/analytics-protocol/relative-date-filter.js';
+import { CardDateSelection } from './card-date-selection.js';
 interface CardDateFilterProps {
-    value: any;
+    value: FilterValue;
     operator: string;
-    onChange: (value: any) => void;
+    /** The saved relative choice, for range operators. */
+    relativeMeta?: RelativeDateFilter;
+    /** The condition selects the latest value of its field (`=` only). */
+    latestValue?: boolean;
+    onChange: (selection: CardDateSelection) => void;
     className?: string;
 }
 /**
- * Wrapper component that adapts DateRangePicker for card filter usage
- * Handles different operators and value formats
+ * Wrapper component that adapts DateRangePicker for card filter usage.
+ * Range operators can save a relative choice ("This month"), which the
+ * server resolves on every run; Static picks save fixed dates.
  */
-export declare function CardDateFilter({ value, operator, onChange, className, }: CardDateFilterProps): import("react").JSX.Element;
+export declare function CardDateFilter({ value, operator, relativeMeta, latestValue, onChange, className, }: CardDateFilterProps): import("react").JSX.Element;
 export {};

package/dist/types/components/explorer/filters/card-date-selection.d.ts

@@ -0,0 +1,28 @@
+import { Field, FilterCondition, FilterValue, Operator } from '../../../lib/types/explorer-types.js';
+import { RelativeDateFilter } from '../../../shared/analytics-protocol/relative-date-filter.js';
+/** What the card date picker emits: dates, plus the relative choice when there is one. */
+export type CardDateSelection = {
+    value: FilterValue;
+    relativeMeta?: RelativeDateFilter;
+};
+/**
+ * The condition without the markers the server resolves on every run: a
+ * relative window (`relativeMeta`) and a latest-value predicate
+ * (`latestValue`). Every edit of a condition's value, operator or field goes
+ * through it, so a new marker can't survive an edit that no longer means it
+ * (analytics kernel K13; linked D7).
+ */
+export declare function withoutRunTimeMarkers(condition: FilterCondition): FilterCondition;
+/**
+ * The next condition for a selection. A selection without `relativeMeta`
+ * removes the key, so a fixed pick never keeps an old relative window or a
+ * latest-value predicate.
+ */
+export declare function applyCardDateSelection(condition: FilterCondition, selection: CardDateSelection): FilterCondition;
+/** The condition after its operator changes: an empty value and no relative window. */
+export declare function resetConditionForOperator(condition: FilterCondition, operator: Operator): FilterCondition;
+/**
+ * The condition after its field changes: an empty value, the field type's
+ * default operator (`between` for dates) and no relative window.
+ */
+export declare function resetConditionForField(condition: FilterCondition, field: Field): FilterCondition;

package/dist/types/components/sharing-and-management/dashboard-actions-menu.d.ts

@@ -7,7 +7,7 @@ interface DashboardActionsMenuProps {
     showInlineEditButton?: boolean;
     showEditInMenu?: boolean;
     menuButtonClassName?: string;
-    /** When provided (and kind !== 'data_app'), renders a "Set/Clear as default" item. */
+    /** When provided, renders a "Set/Clear as default" item. */
     isDefault?: boolean;
     onEditDetails?: (dashboard: ResourceListItem) => void;
     onDeleteClick?: (dashboard: ResourceListItem) => void;

package/dist/types/components/sharing-and-management/hooks/use-resource-management.d.ts

@@ -9,7 +9,6 @@ export interface ResourceListItem {
     isPrivate: boolean;
     isPublic: boolean;
     version: string;
-    currentDataAppVersionId?: string | null;
     createdBy: string | null;
     createdByTenantUser: string;
     tenantId: string;

package/dist/types/components/surfboard/download-settings-dialog.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Dashboard-wide download settings, edited while the dashboard is in edit
+ * mode. A change joins the edit session and is saved with the dashboard.
+ */
+export declare function DownloadSettingsDialog({ open, onOpenChange, }: {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+}): import("react").JSX.Element;

package/dist/types/components/surfboard/filter/types.d.ts

@@ -2,6 +2,7 @@ import { DashboardInputTargetContext } from '../../../lib/dashboard-inputs/dashb
 import { NormalizedDashboardInput } from '../../../lib/types/common-types.js';
 import { CalculatedFieldFormula, Field } from '../../../lib/types/explorer-types.js';
 import { TemporalBucketMetadata } from '../../../shared/analytics-protocol/contracts.js';
+import { DateUnit, RelativeDateFilter, RelativeDateUnit, SubDayDateUnit } from '../../../shared/analytics-protocol/relative-date-filter.js';
 export type DateSelectionMode = 'range' | 'months' | 'day';
 export type DateComparisonOperation = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'between' | 'not between' | 'is null' | 'is not null';
 export type FilterLocation = 'dashboard' | 'frame' | 'sheet' | undefined;
@@ -12,35 +13,8 @@ export type ComboBoxOption = {
     [key: string]: FilterOptionValue;
 };
 export type TSelectedRecord = ComboBoxOption;
-export type DateUnit = 'day' | 'week' | 'month' | 'quarter' | 'year';
-export type SubDayDateUnit = 'minute' | 'hour';
-export type RelativeDateUnit = DateUnit | SubDayDateUnit;
+export type { DateUnit, RelativeDateFilter, RelativeDateUnit, SubDayDateUnit, };
 export type TemporalPrecision = 'minute';
-export type RelativeDateFilter = {
-    mode: 'last';
-    n: number;
-    unit: SubDayDateUnit;
-    complete?: false;
-} | {
-    mode: 'last';
-    n: number;
-    unit: DateUnit;
-    complete?: boolean;
-} | {
-    mode: 'this';
-    unit: DateUnit;
-    toDate?: boolean;
-    /** Only used with unit=month for single-day month-boundary presets. */
-    boundary?: 'first_day' | 'last_day';
-} | {
-    mode: 'previous';
-    unit: DateUnit;
-} | {
-    mode: 'between';
-    unit: DateUnit;
-    from: number;
-    to: number;
-};
 /**
  * Absolute fixed month/year default used by Month Picker defaults.
  * - `month` is 0-indexed (0=January, 11=December) to align with MonthPicker.
@@ -167,6 +141,12 @@ type BaseFilter = {
     semanticContext?: FilterSemanticContext;
     /** Governed meaning for canonical grouped-temporal filter values. */
     temporalBucket?: TemporalBucketMetadata;
+    /**
+     * Set on the Global Date value bound to a card's date field. On that field
+     * it replaces the card's own date range for the run; any other date filter
+     * intersects with it (analytics kernel P2a-01).
+     */
+    dateOwner?: 'global_date';
 };
 type FilterForString = BaseFilter & {
     operation: 'like' | 'not like';
@@ -242,4 +222,3 @@ export type FilterStorageOptions = {
      */
     inputContext?: DashboardInputTargetContext;
 };
-export {};

package/dist/types/components/surfboard/filter/use-dashboard-filter-mapping-popover.d.ts

@@ -1,5 +1,6 @@
 import { TFilter } from './types.js';
 import { DashboardFilterMappingAuthoringIssue, DashboardFilterMappingDraftDecision } from '../../../lib/dashboard-inputs/dashboard-filter-mapping-authoring.js';
+import { DefaultsCalendar } from '../../../lib/utils/filter-default-value-utils.js';
 import { DashboardInputRuntimeTarget } from '../../../lib/dashboard-inputs/dashboard-input-values.js';
 import { GlobalDateComparisonSelection } from '../../../shared/analytics-protocol/index.js';
 import { DashboardFilterOptionDependencies, DashboardFilterOptionPopulation, DashboardFilterOptionSource } from '../../../shared/dashboard-authoring/index.js';
@@ -19,7 +20,7 @@ type DashboardFilterSettingsAcceptOptions = {
 export declare function useDashboardFilterMappingPopover(params: {
     filter: TFilter;
     stagedFilter: TFilter;
-    dashboardTimezone?: string;
+    dashboardCalendar?: DefaultsCalendar;
     open: boolean;
     attentionEnabled?: boolean;
     capable: boolean;
@@ -39,6 +40,9 @@ export declare function useDashboardFilterMappingPopover(params: {
         interactionDefaults?: {
             clickToFilter: "on" | "off";
         };
+        exportDefaults?: {
+            csvEncoding?: import('../../../shared/format-utils/index.js').CsvEncoding;
+        };
         aiContext?: import('../../../lib/types/assistant-types.js').DashboardAIContext;
         summary?: {
             enabled?: boolean;

package/dist/types/components/ui-custom/date-range-picker.d.ts

@@ -1,8 +1,10 @@
 import { DateRange } from 'react-day-picker';
 import { RelativeDateFilter, DateComparisonOperation, TemporalPrecision } from '../surfboard/filter/types.js';
+import { RelativeDateSummary } from '../../lib/utils/relative-date-description.js';
+import { WeekStart } from '../../shared/report-runtime-context/index.js';
 export type PresetOption = {
     label: string;
-    value: (timezone: string) => DateRange;
+    value: (timezone: string, weekStart: WeekStart, now: Date) => DateRange;
     category: 'time' | 'year' | 'quarter' | 'month' | 'week' | 'day';
 };
 export type TemporalPrecisionChangeOptions = {
@@ -36,6 +38,20 @@ export interface DateRangePickerProps {
     buttonClassName?: string;
     /** Optional context appended to the closed picker label. */
     buttonLabelSuffix?: string;
+    /**
+     * Card filters: what the trigger shows for an applied relative value, for
+     * example "This month" and its current dates. The caller describes it; the
+     * picker only renders it.
+     */
+    relativeSummary?: Pick<RelativeDateSummary, 'label' | 'dates'> & {
+        /** Shown on hover, typically when there are no dates to show. */
+        tooltip?: string;
+    };
+    /**
+     * Single mode: what the trigger shows for an applied value that has no date
+     * of its own (a card's "Latest value"). A pick replaces it.
+     */
+    singleValueLabel?: string;
     contentClassName?: string;
     overlayContentClassName?: string;
     targetColumns?: Array<{
@@ -54,4 +70,4 @@ export interface DateRangePickerProps {
     /** Notifies nested-popover owners when this picker opens or closes. */
     onOpenChange?: (open: boolean) => void;
 }
-export declare function DateRangePicker({ value, onChange, selectionMode, singleValue, onSingleChange, comparisonOptions, comparisonValue, onComparisonChange, comparisonLabel, hideDateInputs, onRelativeSelect, relativeValue, placeholder, className, timezone, showRelativeTab, hideCalendar, disabled, enableTimePrecision, temporalPrecision, buttonClassName, buttonLabelSuffix, contentClassName, overlayContentClassName, targetColumns, selectedColumn, onColumnChange, inline, onApplied, supplementalFooter, onOpenChange, }: DateRangePickerProps): import("react").JSX.Element;
+export declare function DateRangePicker({ value, onChange, selectionMode, singleValue, onSingleChange, comparisonOptions, comparisonValue, onComparisonChange, comparisonLabel, hideDateInputs, onRelativeSelect, relativeValue, placeholder, className, timezone, showRelativeTab, hideCalendar, disabled, enableTimePrecision, temporalPrecision, buttonClassName, buttonLabelSuffix, relativeSummary, singleValueLabel, contentClassName, overlayContentClassName, targetColumns, selectedColumn, onColumnChange, inline, onApplied, supplementalFooter, onOpenChange, }: DateRangePickerProps): import("react").JSX.Element;

package/dist/types/components/ui-custom/date-range-presets.d.ts

@@ -19,29 +19,16 @@ export declare function resolveCalendarDayRange(date: string, timezone: string):
 export declare const isSingleDayDefaultDateFilter: (value: DefaultDateFilter | undefined) => boolean;
 export declare function resolveDefaultDateFilterForDefaults(meta: DefaultDateFilter, timezone: string, weekStart?: WeekStart): [Date, Date] | undefined;
 /**
- * Resolves a relative date filter to concrete start/end dates in the specified timezone.
- * This is a simplified frontend version - backend will re-resolve for query execution.
- *
- * Anchors "now" in the target timezone so date-fns period functions operate on
- * the correct calendar (not browser's calendar).
+ * The window a relative date names at `now` in the timezone, from the shared
+ * date module (analytics kernel Phase 3), so a preview matches what the server
+ * runs. Callers here have no fiscal calendar, so quarters and years are
+ * calendar periods; previews show those as labels only (K8).
  *
  * @param meta - The relative date filter metadata
  * @param timezone - IANA timezone string (e.g., "America/New_York", "UTC")
  * @param weekStart - Day the week starts on (0=Sunday, 1=Monday). Defaults to 1 (Monday/ISO).
- * @returns Tuple of [start, end] dates in the specified timezone
- */
-export declare function resolveRelativeDateForDefaults(meta: RelativeDateFilter, timezone: string, weekStart?: WeekStart): [Date, Date];
-/**
- * Format a `RelativeDateFilter` meta into a human-readable label.
- *
- * 1. First tries to reverse-match against `presetMetadata` so canonical
- *    presets (Today, Last 7 days, This week, …) round-trip back to the
- *    same wording the user originally clicked.
- * 2. Falls back to a generated label for ad-hoc relative ranges that
- *    aren't in the preset list (e.g., from the Relative tab's custom
- *    From/To dropdowns).
- *
- * Returns null if the meta can't be sensibly labelled.
+ * @param now - The anchor instant; a pinned calendar anchor passes its own.
+ * @returns `[start, inclusive end]`
  */
-export declare function getRelativeDateLabel(meta: RelativeDateFilter | undefined): string | null;
-export declare const presetMetadata: Record<string, RelativeDateFilter>;
+export declare function resolveRelativeDateForDefaults(meta: RelativeDateFilter, timezone: string, weekStart?: WeekStart, now?: Date): [Date, Date];
+export { findPresetLabel, getRelativeDateLabel, getRelativeOffsetLabel, presetMetadata, relativeMetaEquals, } from '../../shared/analytics-protocol/relative-date-label.js';

package/dist/types/components/ui-custom/report-calendar.d.ts

@@ -0,0 +1,18 @@
+type ReportCalendarProps = {
+    /** The report's IANA time zone. */
+    timezone: string;
+    /** Any instant within the selected day. */
+    selected?: Date;
+    /** The picked day's first instant in `timezone`; undefined when unselected. */
+    onSelect: (day: Date | undefined) => void;
+    className?: string;
+};
+/**
+ * A one-day calendar on the report calendar (temporal predicate contract,
+ * Phase B): its days, "today" and first weekday column are the report time
+ * zone's and week start's, so a viewer in any time zone picks the report's
+ * day. Days come back as plain instants, never the calendar's zoned dates,
+ * which serialize with an offset and read the host's clock in date-fns.
+ */
+export declare function ReportCalendar({ timezone, selected, onSelect, className, }: ReportCalendarProps): import("react").JSX.Element;
+export {};

package/dist/types/components/visual/aggregated-table/utils/export-utils.d.ts

@@ -3,6 +3,7 @@ import { GroupByField, QueryColumnKeyMap } from '../../../../lib/types/explorer-
 import { PivotColumnSchema } from '../../pivot-table/types.js';
 import { ColumnSettingsMap } from '../../data-table/types/data-table.js';
 import { CardNumericPresentationContext } from '../../../../lib/formatters/numeric-presentation.js';
+import { CsvDelimiter, CsvEncoding } from '../../../../shared/format-utils/exporters/csv-utils.js';
 import { AggregateTemporalPresentation } from './temporal-presentation.js';
 interface RowData extends Record<string, any> {
     isSubtotal?: boolean;
@@ -18,14 +19,11 @@ interface RowData extends Record<string, any> {
  * This preserves the formatted display including subtotals and grand totals
  */
 export declare function formatAggregatedTableForExport(organizedData: RowData[], grandTotalRow: RowData | undefined, groupByColumns: GroupByField[], pivotSchema: PivotColumnSchema[], card: TCard, columnSettings?: ColumnSettingsMap, options?: {
-    delimiter?: string;
+    delimiter?: CsvDelimiter;
+    encoding?: CsvEncoding;
     includeHeaders?: boolean;
     numericPresentation?: CardNumericPresentationContext;
     temporalPresentation?: AggregateTemporalPresentation;
     columnKeyMap?: QueryColumnKeyMap;
 }): string;
-/**
- * Download CSV file
- */
-export declare function downloadCSV(csvContent: string, fileName: string): void;
 export {};

package/dist/types/components/visual/data-table/data-table-toolbar.d.ts

@@ -1,2 +1,2 @@
 import { DataTableToolbarProps } from './types/data-table.js';
-export declare function DataTableToolbar({ globalFilter, onGlobalFilterChange, totalRows, columns, selectColumnVisible, onToggleSelectColumn, onColumnVisibilityChange, card, data, exportFileName, }: DataTableToolbarProps): import("react").JSX.Element | null;
+export declare function DataTableToolbar({ globalFilter, onGlobalFilterChange, totalRows, columns, selectColumnVisible, onToggleSelectColumn, onColumnVisibilityChange, }: DataTableToolbarProps): import("react").JSX.Element | null;

package/dist/types/components/visual/pivot-table/utils/pivot-table-export-utils.d.ts

@@ -1,11 +1,13 @@
 import { PivotTableData } from '../pivot-table.js';
 import { TCard } from '../../../../lib/types/common-types.js';
+import { CsvDelimiter, CsvEncoding } from '../../../../shared/format-utils/index.js';
 import { CardNumericPresentationContext } from '../../../../lib/formatters/numeric-presentation.js';
 type PivotTableCsvOptions = {
     includeHeaders?: boolean;
     includeSubtotals?: boolean;
     includeGrandTotal?: boolean;
-    delimiter?: string;
+    delimiter?: CsvDelimiter;
+    encoding?: CsvEncoding;
     showRowTotals?: boolean;
     numericPresentation?: CardNumericPresentationContext;
 };

package/dist/types/index.js

@@ -1,9 +1,9 @@
 import { C as r, E as s } from "../chunks/common-types-C6cAQgyh.js";
-import { C as o, D as i, L as n, P as c, f as d, g as m, k as u, j as E, l as p, e as C, c as D, b as F, d as A, n as f, h as _ } from "../chunks/validators-CsdOtZI6.js";
-import { c as T, g as h, f as x, b as N, e as y, d as I, a as M, h as R, r as b } from "../chunks/field-dependencies-v-lJNzC7.js";
-import { D as S } from "../chunks/token-types-BC6RcUY8.js";
-import { r as O, a as v } from "../chunks/pivot-result-identity-BzUQiCEV.js";
-import { D as w } from "../chunks/report-runtime-context-CxIoGyNM.js";
+import { C as o, D as i, L as n, P as c, f as d, g as m, k as u, j as E, l as p, e as C, c as D, b as F, d as A, n as f, h as _ } from "../chunks/validators-CQcG0EPN.js";
+import { c as T, g as h, f as x, b as N, e as y, d as I, a as M, h as R, r as b } from "../chunks/field-dependencies-CGYic38w.js";
+import { D as S } from "../chunks/token-types-UjyNz95-.js";
+import { r as O, a as v } from "../chunks/pivot-result-identity-CY__BuwI.js";
+import { D as w } from "../chunks/report-runtime-context-CtaGGlit.js";
 const e = [
   "concatenate",
   "conditional-category",

package/dist/types/lib/api/exports-api.d.ts

@@ -1,4 +1,5 @@
 import { TFilterValue } from '../../components/surfboard/filter/types.js';
+import { CsvEncoding } from '../../shared/format-utils/exporters/csv-utils.js';
 import { CardConfig, DataSource, TableTotalsRequest } from '../types/explorer-types.js';
 import { ControlBinding, ControlDefinition } from '../types/common-types.js';
 import { ResolvedPrimaryDateField } from '../types/semantic-runtime-types.js';
@@ -16,6 +17,8 @@ export interface ExportFormattingConfig {
     browserTimezone?: string;
     isSqlCard?: boolean;
     delimiter: ',' | ';' | '\t';
+    /** Resolved by the dialog: the person's choice, else the dashboard's setting. */
+    csvEncoding: CsvEncoding;
     includeHeaders: boolean;
     columnSettings?: Record<string, unknown>;
     visibleColumns?: string[];

package/dist/types/lib/csv-download.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Save a CSV file in the browser. This is the only place react-semaphor
+ * creates a CSV Blob; `content` comes from the CSV file contract
+ * (`encodeCsvFile`), which owns the BOM, quoting and record separators.
+ */
+export declare function downloadCsvFile({ content, fileName, }: {
+    content: string;
+    fileName: string;
+}): void;

package/dist/types/lib/csv-encoding-options.d.ts

@@ -0,0 +1,6 @@
+import { CsvEncoding } from '../shared/format-utils/index.js';
+/** The two CSV encodings as people see them, in every place that offers the choice. */
+export declare const CSV_ENCODING_OPTIONS: ReadonlyArray<{
+    value: CsvEncoding;
+    label: string;
+}>;

package/dist/types/lib/dashboard-inputs/dashboard-filter-mapping-storage-transition.d.ts

@@ -1,6 +1,7 @@
 import { TFilter, TFilterValue } from '../../components/surfboard/filter/types.js';
 import { DashboardInput, DashboardInputValues } from '../types/common-types.js';
 import { DashboardInputRuntimeTarget } from './dashboard-input-values.js';
+import { DefaultsCalendar } from '../utils/filter-default-value-utils.js';
 import { GlobalDateComparisonSelection } from '../../shared/analytics-protocol/index.js';
 import { DashboardFilterOptionDependencies, DashboardFilterOptionPopulation, DashboardFilterOptionSource } from '../../shared/dashboard-authoring/index.js';
 export type DashboardFilterStorageState = {
@@ -36,7 +37,7 @@ export type DashboardFilterOptionPolicy = {
 export declare function resolveFilterOptionPolicy(current: DashboardFilterOptionPolicy | undefined, settings: DashboardFilterAuthoringSettingsUpdate | undefined): DashboardFilterOptionPolicy;
 export declare function hasFilterOptionPolicy(policy: DashboardFilterOptionPolicy | undefined): boolean;
 /** Callers submit edits; the owner decides whether defaults must be reseeded. */
-export declare function resolveFilterAuthoringSettings(previous: TFilter | undefined, filter: TFilter, settings: DashboardFilterAuthoringSettingsUpdate | undefined, target: DashboardInputRuntimeTarget, timezone?: string): {
+export declare function resolveFilterAuthoringSettings(previous: TFilter | undefined, filter: TFilter, settings: DashboardFilterAuthoringSettingsUpdate | undefined, target: DashboardInputRuntimeTarget, calendar?: DefaultsCalendar): {
     target: DashboardInputRuntimeTarget;
     defaultValueChanged: boolean;
     defaultFilterValue: TFilterValue | undefined;

package/dist/types/lib/dashboard-navigation/build-carried-click-context.d.ts

@@ -39,7 +39,6 @@ export type BuildCarriedClickContextParams = {
     destinationCardIds: string[];
     semanticExecutionPayload?: SemanticExecutionPayload;
     calendarContext?: CalendarContext | null;
-    dashboardInputReferenceTime?: string;
     resolveRelativeDateWindow?: ResolveRelativeDateWindow;
 };
 export type CarriedClickContext = {

package/dist/types/lib/document/document-input-runtime.d.ts

@@ -1,9 +1,10 @@
 import { TFilterValue } from '../../components/surfboard/filter/types.js';
+import { DefaultsCalendar } from '../utils/filter-default-value-utils.js';
 import { DocumentControlInputDefinition, DocumentFilterInputDefinition, DocumentInputDefinition } from '../types/common-types.js';
 export type DocumentFilterMode = 'include' | 'exclude';
 export declare function isFilterDocumentInput(input: DocumentInputDefinition): input is DocumentFilterInputDefinition;
 export declare function isControlDocumentInput(input: DocumentInputDefinition): input is DocumentControlInputDefinition;
-export declare function buildDefaultDocumentInputFilterValuesById(inputs: DocumentInputDefinition[], timezone?: string): Record<string, TFilterValue | undefined>;
+export declare function buildDefaultDocumentInputFilterValuesById(inputs: DocumentInputDefinition[], calendar?: DefaultsCalendar): Record<string, TFilterValue | undefined>;
 export declare function buildDefaultDocumentInputControlValuesById(inputs: DocumentInputDefinition[]): Record<string, unknown>;
 export declare function getDocumentInputSignature(inputs: DocumentInputDefinition[]): string;
 export declare function getDocumentInputDefinitionSignaturesById(inputs: DocumentInputDefinition[]): Record<string, string>;

package/dist/types/lib/export-utils.d.ts

@@ -1,6 +1,7 @@
 import { TablePreferences } from '../components/visual/data-table/types/data-table.js';
 import { TCard } from './types/common-types.js';
 import { SemaphorResultColumn } from '../shared/analytics-protocol/index.js';
+import { CsvDelimiter, CsvEncoding } from '../shared/format-utils/index.js';
 import { CardNumericPresentationContext } from './formatters/numeric-presentation.js';
 import { ComparisonMetadataMap } from './types/query-types.js';
 import { CardConfig, QueryColumnKeyMap } from './types/explorer-types.js';
@@ -8,7 +9,8 @@ import { FlatTableTotalsByColumnId } from './table-formatting/table-totals-setti
 import { RegularTableTemporalPresentation } from './formatters/regular-table-temporal-presentation.js';
 import { RawTemporalPresentation } from './formatters/raw-temporal-presentation.js';
 type ExportTableOptions = {
-    delimiter?: string;
+    delimiter?: CsvDelimiter;
+    encoding?: CsvEncoding;
     includeHeaders?: boolean;
     useFormattedValues?: boolean;
     comparisonMetadata?: ComparisonMetadataMap;
@@ -23,23 +25,23 @@ type ExportTableOptions = {
 /** Build a filesystem-safe CSV filename with the export time in UTC. */
 export declare function buildCsvExportFilename(title: string | null | undefined, generatedAt?: Date): string;
 /**
- * Export table data as CSV with column preferences
+ * The CSV file for plain records (charts and other non-table cards, and the
+ * editor's raw download). Columns are the union of record keys in first-seen
+ * order, so a record missing a key gets an empty cell.
  */
-export declare function exportTableAsCSV(data: any[], fileName: string, tablePreferences?: TablePreferences, card?: TCard, options?: ExportTableOptions): void;
+export declare function buildRecordsCsv({ records, includeHeaders, delimiter, encoding, }: {
+    records: readonly Record<string, unknown>[];
+    includeHeaders?: boolean;
+    delimiter?: CsvDelimiter;
+    encoding?: CsvEncoding;
+}): string;
 /**
- * Export table data with aggregations (for aggregated tables)
+ * Export table data as CSV with column preferences
  */
-export declare function exportAggregatedTableAsCSV(data: any[], fileName: string, groupByColumns?: string[], metricColumns?: string[], options?: {
-    delimiter?: string;
-    includeHeaders?: boolean;
-    includeSubtotals?: boolean;
-    includeGrandTotal?: boolean;
-}): void;
+export declare function exportTableAsCSV(data: any[], fileName: string, tablePreferences?: TablePreferences, card?: TCard, options?: ExportTableOptions): void;
 /**
- * Export pivot table as CSV
+ * The CSV file for a Table or Detail Table, or undefined when there is
+ * nothing exportable.
  */
-export declare function exportPivotTableAsCSV(data: any[], fileName: string, rowHeaders?: string[], columnHeaders?: string[], options?: {
-    delimiter?: string;
-    includeHeaders?: boolean;
-}): void;
+export declare function buildTableCsv(data: any[], tablePreferences?: TablePreferences, card?: TCard, options?: ExportTableOptions): string | undefined;
 export {};

package/dist/types/lib/hooks/explorer/use-filter-builder.d.ts

@@ -1,4 +1,4 @@
-import { FilterGroup, FilterCondition, LogicalOperator, Field, FilterValue } from '../../types/explorer-types.js';
+import { FilterGroup, FilterCondition, LogicalOperator, Field } from '../../types/explorer-types.js';
 interface UseFilterBuilderProps {
     initialFilters?: FilterGroup | null;
     availableFields?: Field[];
@@ -12,8 +12,8 @@ export declare function useFilterBuilder({ initialFilters, availableFields: prop
     addGroup: (parentGroupId: string) => void;
     removeCondition: (groupId: string, conditionId: string) => void;
     removeGroup: (parentGroupId: string, groupId: string) => void;
-    updateCondition: (groupId: string, conditionId: string, field: keyof FilterCondition, value: FilterValue) => void;
     updateConditionFields: (groupId: string, conditionId: string, updates: Partial<FilterCondition>) => void;
+    replaceCondition: (groupId: string, conditionId: string, next: FilterCondition) => void;
     updateGroupOperator: (groupId: string, operator: LogicalOperator) => void;
     updateGroupNegate: (groupId: string, negate: boolean) => void;
     reorderConditions: (groupId: string, oldIndex: number, newIndex: number) => void;

package/dist/types/lib/hooks/use-relative-date-summarizer.d.ts

@@ -0,0 +1,7 @@
+import { RelativeDateSummary } from '../utils/relative-date-description.js';
+import { RelativeDateFilter } from '../../shared/analytics-protocol/relative-date-filter.js';
+/**
+ * Summarizes relative dates in the dashboard calendar and the viewer's date
+ * preferences (plan D8).
+ */
+export declare function useRelativeDateSummarizer(): (relative: RelativeDateFilter) => RelativeDateSummary;

package/dist/types/lib/matrix-table/matrix-application-adapter.d.ts

@@ -4,10 +4,11 @@ import { Field } from '../types/explorer-types.js';
 import { MatrixCardCatalog } from './matrix-card-adapter.js';
 /** Staged transport input. Auth and catalog grounding remain server-owned. */
 type ExecutionInput = Parameters<MatrixExecutionEnvironment['execute']>[0];
-export declare function buildMatrixCardQueryPayload(input: Pick<ExecutionInput, 'spec' | 'window' | 'cardId' | 'runtimeSorts'> & {
+export declare function buildMatrixCardQueryPayload(input: Pick<ExecutionInput, 'spec' | 'window' | 'cardId' | 'runtimeSorts' | 'temporalState'> & {
     queryContext: Pick<ExecutionInput['queryContext'], 'cardFilterValues' | 'controlDefinitions' | 'cardControlDefinitions' | 'controlBindings' | 'controlValues'> & Partial<Pick<ExecutionInput['queryContext'], 'resolvedFilters'>>;
     reportContext: Pick<ExecutionInput['reportContext'], 'calendar'>;
 }): {
+    temporalState?: import('../../shared/analytics-protocol/index.js').OperationTemporalState | undefined;
     active_filters: import('../types/index.js').TFilterValue[];
     calendarContext: import('../types/index.js').CalendarContext;
     controlDefinitions: import('../types/index.js').ControlDefinition[];
@@ -38,7 +39,7 @@ export declare function buildMatrixCardQueryPayload(input: Pick<ExecutionInput,
         levelId: string;
         axis: "columns" | "rows";
         direction: "asc" | "desc";
-        nulls: "first" | "last";
+        nulls: "last" | "first";
     }[] | undefined;
     runtimeFilters?: import('../types/explorer-types.js').FilterGroup | undefined;
     cardId: string;

package/dist/types/lib/matrix-table/matrix-card-adapter.d.ts

@@ -318,7 +318,7 @@ export declare function prepareMatrixCard(card: TCard, catalog: MatrixCardCatalo
                 levelId: string;
                 axis: "columns" | "rows";
                 direction: "asc" | "desc";
-                nulls: "first" | "last";
+                nulls: "last" | "first";
             }[];
             rankings: readonly import('../../shared/analytics-protocol/index.js').MatrixRanking[];
             filters?: import('../types/explorer-types.js').FilterGroup | undefined;

package/dist/types/lib/matrix-table/matrix-card-draft.d.ts

@@ -298,7 +298,7 @@ export declare function initializeMatrixCardDraft(card: Pick<TCard, 'config' | '
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly import('../../shared/analytics-protocol/index.js').MatrixRanking[];
         filters?: import('../types/index.js').FilterGroup | undefined;

package/dist/types/lib/matrix-table/matrix-dataset-history.d.ts

@@ -0,0 +1,47 @@
+import { MatrixDatasetRetention } from './matrix-runtime-types.js';
+/** Matrix fetching plan MF-D3 and MF-D4. */
+export declare const MATRIX_HISTORY_LIMITS: Readonly<{
+    /** Restorable while the oldest piece is younger than this. */
+    freshMs: number;
+    entriesPerCard: 3;
+    entries: 12;
+    bytes: number;
+}>;
+/**
+ * Dashboard-scoped store of inactive Matrix datasets (plan INV-2 to INV-8).
+ *
+ * History holds only datasets no runtime is showing. A newly mounted runtime
+ * may also start from a copy of another runtime's live dataset (efficiency
+ * plan E-D1); the two then own their copies separately. History never limits
+ * or evicts live data: per card it holds at most what is left of the runtime
+ * allowance after the usage of the card's mounted runtimes, oldest saved first
+ * out. Entries are written only by `save` and never mutated afterwards.
+ */
+export declare class MatrixDatasetHistory {
+    private readonly now;
+    private entries;
+    private generations;
+    private live;
+    /** Copies of live datasets handed out by `peek`, so `adopt` can recognize them. */
+    private seeds;
+    private scope?;
+    constructor(now?: () => number);
+    /** A new auth or host scope drops everything saved under the previous one. */
+    setScope(scope: string): void;
+    /** The retention one runtime uses, bound to its card and query identity. */
+    port(binding: {
+        scope: string;
+        card: string;
+        dataset: string;
+    }): MatrixDatasetRetention;
+    private generation;
+    /**
+     * A copy of another mounted runtime's dataset for the same card, query
+     * identity and sorts, when it is current and fresh (plan E-D1). Reading it
+     * changes no runtime; History only remembers the copy it handed out.
+     */
+    private seed;
+    private usable;
+    /** Oldest saved first out: expired, then over the card's remainder, then over the dashboard ceilings. */
+    private fit;
+}