react-semaphor 0.1.525 → 0.1.527

package/dist/surfboard/index.js

@@ -1,10 +1,9 @@
-import { b as a, a as o } from "../chunks/index-DYOaHuLS.js";
-import { C as f, E } from "../chunks/common-types-C6cAQgyh.js";
-import { R as t } from "../chunks/report-preferences-dialog-BLaFmlE2.js";
+import { a, R as s, D as o } from "../chunks/report-preferences-dialog-D3hxu4sE.js";
+import { C as f, E as D } from "../chunks/common-types-C6cAQgyh.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,
-  E as EMPTY_SELECTION,
-  t as ReportPreferencesDialog,
+  D as EMPTY_SELECTION,
+  s as ReportPreferencesDialog,
   o as Surfboard
 };

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/dashboard/dashboard-container.d.ts

@@ -1,5 +1,5 @@
 import { HTMLAttributes } from 'react';
-import { DashboardProps } from '../index.js';
+import { DashboardProps } from '../../lib/types/common-types.js';
 type ContainerProps = DashboardProps & HTMLAttributes<HTMLDivElement> & {
     type?: 'dashboard' | 'visual';
     cardId?: string;

package/dist/types/components/dashboard/sheet/layout-change-guard.d.ts

@@ -1,4 +1,4 @@
-import { TDashboard } from '../../index.js';
+import { TDashboard } from '../../../lib/types/common-types.js';
 type DashboardSheet = NonNullable<TDashboard['sheets']>[number];
 type SheetLayouts = NonNullable<DashboardSheet['layouts']>;
 export declare function shouldPersistLayouts(currentLayouts: SheetLayouts | undefined, nextLayouts: SheetLayouts | undefined): boolean;

package/dist/types/components/dashboard/sheet/sheet-layout.d.ts

@@ -1,5 +1,5 @@
 import { default as React } from 'react';
-import { TSheet } from '../../index.js';
+import { TSheet } from '../../../lib/types/common-types.js';
 export declare function Sheet({ sheet }: {
     sheet: TSheet;
 }): React.JSX.Element;

package/dist/types/components/editor/editor-main/text-card.d.ts

@@ -1,4 +1,4 @@
-import { TCard } from '../../index.js';
+import { TCard } from '../../../lib/types/common-types.js';
 import { default as React } from 'react';
 type TextCardProps = {
     isLoading: boolean;

package/dist/types/components/editor/editor.d.ts

@@ -1,4 +1,4 @@
-import { AuthToken, TFrame } from '../index.js';
+import { AuthToken, TFrame } from '../../lib/types/common-types.js';
 type EditorProps = {
     authToken?: AuthToken;
     onSave?: (frame: TFrame) => void;

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/providers/semaphor-context-provider.d.ts

@@ -1,4 +1,4 @@
-import { DashboardProps } from '../index.js';
+import { DashboardProps } from '../../lib/types/common-types.js';
 import { TokenProps } from '../../lib/types/token-types.js';
 type SemaphorContextType = DashboardProps & {
     tokenProps: TokenProps;

package/dist/types/components/providers/theme-provider-context.d.ts

@@ -1,4 +1,4 @@
-import { Theme } from '../index.js';
+import { Theme } from '../../lib/types/common-types.js';
 export type ThemeProviderState = {
     theme: Theme;
     setTheme: (theme: Theme) => void;

package/dist/types/components/providers/theme-provider.d.ts

@@ -1,4 +1,4 @@
-import { Theme } from '../index.js';
+import { Theme } from '../../lib/types/common-types.js';
 type ThemeProviderProps = {
     children: React.ReactNode;
     defaultTheme?: Theme;

package/dist/types/components/shared/unsaved-changes/use-pristine-snapshot-initializer.d.ts

@@ -1,4 +1,4 @@
-import { TDashboard } from '../../index.js';
+import { TDashboard } from '../../../lib/types/common-types.js';
 /**
  * Initialize a pristine dashboard snapshot whenever edit mode turns on.
  * Keeps logic centralized so programmatic entry points are covered.

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/dashboard-plus.d.ts

@@ -1,4 +1,4 @@
-import { DashboardProps } from '../index.js';
+import { DashboardProps } from '../../lib/types/common-types.js';
 type DashboardPlusProps = {
     showControls?: boolean;
     showFooter?: boolean;

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

@@ -1,2 +1,2 @@
-import { DateOptions } from '../index.js';
+import { DateOptions } from '../../lib/types/common-types.js';
 export declare function getDateOptions(locale: string, format: string): DateOptions;

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

@@ -1,4 +1,4 @@
-import { ColorRange } from '../../index.js';
+import { ColorRange } from '../../../lib/types/common-types.js';
 type FormatNumber = {
     number: number;
     decimalPlaces: number;

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/components/visual/settings/color-format.d.ts

@@ -1,5 +1,5 @@
 import { default as React } from 'react';
-import { ColorRange } from '../../index.js';
+import { ColorRange } from '../../../lib/types/common-types.js';
 type ColorFormatProps = {
     colorRanges: ColorRange[];
     setColorRanges: (ranges: ColorRange[]) => void;

package/dist/types/components/visual/visual-utils.d.ts

@@ -1,5 +1,5 @@
 import { Chart } from 'chart.js';
-import { TCard } from '../index.js';
+import { TCard } from '../../lib/types/common-types.js';
 import { BlurEffectProps, TChartConfiguration } from '../../lib/charts/types.js';
 import { ComparisonMetadataMap } from '../../lib/types/query-types.js';
 export declare function handleBlurEffect({ chart, elementIndex, datasetIndex, cardType, cfg, apply, }: BlurEffectProps): void;

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/actions/data-point-click-action.d.ts

@@ -1,4 +1,5 @@
-import { DashboardStore, TCard } from '../../components/index.js';
+import { DashboardStore } from '../stores/dashboard-store.js';
+import { TCard } from '../types/common-types.js';
 type dataPointActionProps = {
     get: () => DashboardStore;
     set: (nextStateOrUpdater: DashboardStore | Partial<DashboardStore>) => any;

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/normalize-dashboard-for-dirty-check.d.ts

@@ -1,4 +1,4 @@
-import { TDashboard } from '../../components/index.js';
+import { TDashboard } from '../types/common-types.js';
 type DashboardSheet = NonNullable<TDashboard['sheets']>[number];
 type SheetLayouts = NonNullable<DashboardSheet['layouts']>;
 /**

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>;