react-semaphor 0.1.459 → 0.1.461

package/dist/types/shared.d.ts

@@ -559,6 +559,51 @@ declare type DashboardAIContext = AIContext & {
 
 declare type DashboardAIContextMode = 'auto' | 'fixed';
 
+declare type DashboardFilterApplication = {
+    kind: 'cardMappings';
+    /**
+     * Sparse grounded bindings and explicit exclusions. A missing config card
+     * may reuse a proven Option Value target on an executable source; it is not
+     * an implicit exclusion, and source identity alone is not field evidence.
+     */
+    cards: DashboardFilterCardApplication[];
+};
+
+declare type DashboardFilterBoundCardApplication = {
+    kind: 'bound';
+    cardId: string;
+    bindingId: string;
+    target: DashboardFilterTarget;
+};
+
+declare type DashboardFilterCardApplication = DashboardFilterBoundCardApplication | DashboardFilterExcludedCardApplication;
+
+declare type DashboardFilterExcludedCardApplication = {
+    kind: 'excluded';
+    cardId: string;
+};
+
+/** Persisted label/value option definition for a mapped dashboard filter. */
+declare type DashboardFilterOptionSource = SemaphorInputOptionSource;
+
+declare type DashboardFilterTarget = {
+    kind: 'field';
+    field: DashboardFilterTargetField;
+};
+
+/** Persisted, source-qualified field that a mapped filter targets. */
+declare type DashboardFilterTargetField = {
+    name: string;
+    source: DashboardFilterTargetSource;
+    dataType: 'string' | 'number' | 'boolean' | 'date' | 'datetime';
+    /** Catalog-grounded physical column used when it differs from the semantic name. */
+    sourceField?: string;
+};
+
+declare type DashboardFilterTargetSource = Extract<SemaphorSourceRef, {
+    kind: 'semantic' | 'physical';
+}>;
+
 declare type DashboardInput = FilterDashboardInput | ControlDashboardInput;
 
 declare type DashboardInputBase = {
@@ -619,14 +664,14 @@ declare type DashboardInputScope = {
     sectionIds: string[];
 };
 
-declare type DashboardInputSlot = ({
+declare type DashboardInputSlot = {
     status: 'set';
     value: DashboardInputValue;
     comparisonSelection?: GlobalDateComparisonSelection;
-}) | ({
+} | {
     status: 'cleared';
     comparisonSelection?: GlobalDateComparisonSelection;
-}) | {
+} | {
     status?: never;
     value?: never;
     comparisonSelection: GlobalDateComparisonSelection;
@@ -723,11 +768,11 @@ declare type DateOptions = {
     options: Intl.DateTimeFormatOptions;
 };
 
-declare type DateSelectionMode = 'range' | 'months';
+declare type DateSelectionMode = 'range' | 'months' | 'day';
 
 declare type DateUnit = 'day' | 'week' | 'month' | 'quarter' | 'year';
 
-declare type DefaultDateFilter = RelativeDateFilter | FixedMonthDefaultDateFilter;
+declare type DefaultDateFilter = RelativeDateFilter | FixedMonthDefaultDateFilter | FixedDayDefaultDateFilter;
 
 /**
  * Field configuration for detail table columns.
@@ -1098,6 +1143,14 @@ declare type EmailSettings = {
     senderTitle: string;
 };
 
+declare type EmbeddedFilterDashboardInput = DashboardInputBase & {
+    kind: 'filter';
+    filter: TFilter;
+    filterReference?: never;
+    optionSource?: DashboardFilterOptionSource;
+    application?: DashboardFilterApplication;
+};
+
 declare type EntityType = 'table' | 'view' | 'materialized view' | 'model' | 'file' | 'dataset' | 'url' | 'upload';
 
 declare interface Field {
@@ -1201,10 +1254,7 @@ declare interface FilterCondition {
     temporalBucket?: TemporalBucketMetadata;
 }
 
-declare type FilterDashboardInput = DashboardInputBase & {
-    kind: 'filter';
-    filter: TFilter;
-};
+declare type FilterDashboardInput = EmbeddedFilterDashboardInput | ReferencedFilterDashboardInput;
 
 /**
  * Display mode for individual filters
@@ -1312,6 +1362,17 @@ declare type FilterSemanticContext = {
 
 declare type FilterValue = string | number | boolean | Date | null | [number, number] | [string, string] | string[] | number[];
 
+/**
+ * Absolute fixed calendar-day default used by Day Picker defaults.
+ * - `date` is a timezone-agnostic calendar day (`YYYY-MM-DD`); it resolves to
+ *   that day's start/end in the dashboard timezone at load time.
+ */
+declare type FixedDayDefaultDateFilter = {
+    mode: 'fixed';
+    unit: 'day';
+    date: string;
+};
+
 /**
  * Absolute fixed month/year default used by Month Picker defaults.
  * - `month` is 0-indexed (0=January, 11=December) to align with MonthPicker.
@@ -1700,6 +1761,17 @@ declare type RangeValue = {
     gt?: string | number;
 };
 
+declare type ReferencedFilterDashboardInput = DashboardInputBase & {
+    kind: 'filter';
+    filter?: never;
+    filterReference: {
+        kind: 'dashboardFilter';
+        filterId: string;
+    };
+    optionSource?: DashboardFilterOptionSource;
+    application?: DashboardFilterApplication;
+};
+
 declare type RelativeDateFilter = {
     mode: 'last';
     n: number;
@@ -1834,6 +1906,16 @@ declare type SemaphorInputBinding = {
 
 declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'between' | 'not_between' | '>' | '>=' | '<' | '<=';
 
+declare type SemaphorInputOptionSource = {
+    source: Extract<SemaphorSourceRef, {
+        kind: 'semantic' | 'physical';
+    }>;
+    labelField: SemaphorFieldRef;
+    valueField: SemaphorFieldRef;
+    searchField?: SemaphorFieldRef;
+    disambiguationFields?: SemaphorFieldRef[];
+};
+
 declare type SemaphorMatrixAxisExpansionOptions = {
     defaultDepth?: number;
     lazy?: boolean;
@@ -2766,7 +2848,7 @@ declare type TFilter = {
     type?: 'single' | 'multiple';
     uiType?: 'radio' | 'dropdown' | 'tabs';
     dateSelectionMode?: DateSelectionMode;
-    defaultValues?: (string | number)[];
+    defaultValues?: (string | number | boolean)[];
     defaultDateFilter?: DefaultDateFilter;
     sheetId?: string;
     location?: FilterLocation;
@@ -2927,11 +3009,11 @@ declare type TInlineFilter = {
     type?: 'single' | 'multiple';
     /** UI component for single-select filters */
     uiType?: 'radio' | 'dropdown' | 'tabs';
-    /** Date picker type: 'range' for full calendar, 'months' for month picker */
+    /** Date picker type: 'range' for full calendar, 'months' for month picker, 'day' for single-day picker */
     dateSelectionMode?: DateSelectionMode;
     /** Default values applied when the dashboard first loads */
-    defaultValues?: (string | number)[];
-    /** Default date filter applied on dashboard load (relative or fixed month/year) */
+    defaultValues?: (string | number | boolean)[];
+    /** Default date filter applied on dashboard load (relative, fixed month/year, or fixed day) */
     defaultDateFilter?: DefaultDateFilter;
     /** Search mode for numeric filters: 'text' treats as text, 'numeric' enables operators (>, <, =) */
     searchMode?: 'text' | 'numeric' | 'auto';

package/dist/types/surfboard.d.ts

@@ -702,6 +702,51 @@ export declare type DashboardEventHandlers = {
     onExportData?: (payload: ExportDataPayload) => void;
 };
 
+export declare type DashboardFilterApplication = {
+    kind: 'cardMappings';
+    /**
+     * Sparse grounded bindings and explicit exclusions. A missing config card
+     * may reuse a proven Option Value target on an executable source; it is not
+     * an implicit exclusion, and source identity alone is not field evidence.
+     */
+    cards: DashboardFilterCardApplication[];
+};
+
+export declare type DashboardFilterBoundCardApplication = {
+    kind: 'bound';
+    cardId: string;
+    bindingId: string;
+    target: DashboardFilterTarget;
+};
+
+export declare type DashboardFilterCardApplication = DashboardFilterBoundCardApplication | DashboardFilterExcludedCardApplication;
+
+export declare type DashboardFilterExcludedCardApplication = {
+    kind: 'excluded';
+    cardId: string;
+};
+
+/** Persisted label/value option definition for a mapped dashboard filter. */
+export declare type DashboardFilterOptionSource = SemaphorInputOptionSource;
+
+export declare type DashboardFilterTarget = {
+    kind: 'field';
+    field: DashboardFilterTargetField;
+};
+
+/** Persisted, source-qualified field that a mapped filter targets. */
+export declare type DashboardFilterTargetField = {
+    name: string;
+    source: DashboardFilterTargetSource;
+    dataType: 'string' | 'number' | 'boolean' | 'date' | 'datetime';
+    /** Catalog-grounded physical column used when it differs from the semantic name. */
+    sourceField?: string;
+};
+
+export declare type DashboardFilterTargetSource = Extract<SemaphorSourceRef, {
+    kind: 'semantic' | 'physical';
+}>;
+
 export declare type DashboardInput = FilterDashboardInput | ControlDashboardInput;
 
 export declare type DashboardInputBase = {
@@ -771,14 +816,14 @@ export declare type DashboardInputScope = {
     sectionIds: string[];
 };
 
-export declare type DashboardInputSlot = ({
+export declare type DashboardInputSlot = {
     status: 'set';
     value: DashboardInputValue;
     comparisonSelection?: GlobalDateComparisonSelection;
-}) | ({
+} | {
     status: 'cleared';
     comparisonSelection?: GlobalDateComparisonSelection;
-}) | {
+} | {
     status?: never;
     value?: never;
     comparisonSelection: GlobalDateComparisonSelection;
@@ -993,11 +1038,11 @@ export declare type DateOptions = {
     options: Intl.DateTimeFormatOptions;
 };
 
-declare type DateSelectionMode = 'range' | 'months';
+declare type DateSelectionMode = 'range' | 'months' | 'day';
 
 declare type DateUnit = 'day' | 'week' | 'month' | 'quarter' | 'year';
 
-declare type DefaultDateFilter = RelativeDateFilter | FixedMonthDefaultDateFilter;
+declare type DefaultDateFilter = RelativeDateFilter | FixedMonthDefaultDateFilter | FixedDayDefaultDateFilter;
 
 /**
  * Field configuration for detail table columns.
@@ -1457,6 +1502,14 @@ export declare type EmailSettings = {
     senderTitle: string;
 };
 
+export declare type EmbeddedFilterDashboardInput = DashboardInputBase & {
+    kind: 'filter';
+    filter: TFilter;
+    filterReference?: never;
+    optionSource?: DashboardFilterOptionSource;
+    application?: DashboardFilterApplication;
+};
+
 export declare const EMPTY_SELECTION: SelectionState;
 
 declare type EntityType = 'table' | 'view' | 'materialized view' | 'model' | 'file' | 'dataset' | 'url' | 'upload';
@@ -1573,10 +1626,7 @@ declare interface FilterCondition {
     temporalBucket?: TemporalBucketMetadata;
 }
 
-export declare type FilterDashboardInput = DashboardInputBase & {
-    kind: 'filter';
-    filter: TFilter;
-};
+export declare type FilterDashboardInput = EmbeddedFilterDashboardInput | ReferencedFilterDashboardInput;
 
 /**
  * Display mode for individual filters
@@ -1684,6 +1734,17 @@ declare type FilterSemanticContext = {
 
 declare type FilterValue = string | number | boolean | Date | null | [number, number] | [string, string] | string[] | number[];
 
+/**
+ * Absolute fixed calendar-day default used by Day Picker defaults.
+ * - `date` is a timezone-agnostic calendar day (`YYYY-MM-DD`); it resolves to
+ *   that day's start/end in the dashboard timezone at load time.
+ */
+declare type FixedDayDefaultDateFilter = {
+    mode: 'fixed';
+    unit: 'day';
+    date: string;
+};
+
 /**
  * Absolute fixed month/year default used by Month Picker defaults.
  * - `month` is 0-indexed (0=January, 11=December) to align with MonthPicker.
@@ -2080,6 +2141,17 @@ declare type MonthAlignedFiscalCalendar = {
 
 declare type NoneOptions = {};
 
+export declare type NormalizedDashboardInput = NormalizedFilterDashboardInput | ControlDashboardInput;
+
+/** Runtime form after dashboard-filter references are resolved once. */
+export declare type NormalizedFilterDashboardInput = DashboardInputBase & {
+    kind: 'filter';
+    filter: TFilter;
+    optionSource?: DashboardFilterOptionSource;
+    application?: DashboardFilterApplication;
+    definitionOrigin: 'embedded' | 'dashboardFilter';
+};
+
 export declare type NumberAxisFormat = {
     decimalPlaces?: number;
     minimumFractionDigits?: number;
@@ -2237,6 +2309,17 @@ declare type RawTemporalPresentationTarget = {
     columnKey: string;
 };
 
+export declare type ReferencedFilterDashboardInput = DashboardInputBase & {
+    kind: 'filter';
+    filter?: never;
+    filterReference: {
+        kind: 'dashboardFilter';
+        filterId: string;
+    };
+    optionSource?: DashboardFilterOptionSource;
+    application?: DashboardFilterApplication;
+};
+
 declare type RelativeDateFilter = {
     mode: 'last';
     n: number;
@@ -2316,6 +2399,8 @@ export declare type ResolvedDashboardInput = {
     exports: Partial<Record<DashboardInputExportKey, string | number | boolean | null>>;
     filter?: TFilter;
     filterValue?: TFilterValue;
+    /** Present when a set filter slot cannot be used with its current definition. */
+    invalidFilterSelection?: boolean;
     control?: ControlDefinition;
     controlValue?: unknown;
     missingRequiredValue?: boolean;
@@ -2323,7 +2408,7 @@ export declare type ResolvedDashboardInput = {
 };
 
 export declare type ResolvedDashboardInputContext = {
-    inputs: DashboardInput[];
+    inputs: NormalizedDashboardInput[];
     resolvedInputs: ResolvedDashboardInput[];
     activeFilters: TFilterValue[];
     controlDefinitions: ControlDefinition[];
@@ -2571,6 +2656,16 @@ declare type SemaphorInputBinding = {
 
 declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'between' | 'not_between' | '>' | '>=' | '<' | '<=';
 
+declare type SemaphorInputOptionSource = {
+    source: Extract<SemaphorSourceRef, {
+        kind: 'semantic' | 'physical';
+    }>;
+    labelField: SemaphorFieldRef;
+    valueField: SemaphorFieldRef;
+    searchField?: SemaphorFieldRef;
+    disambiguationFields?: SemaphorFieldRef[];
+};
+
 declare type SemaphorMatrixAxisExpansionOptions = {
     defaultDepth?: number;
     lazy?: boolean;
@@ -3606,7 +3701,7 @@ declare type TFilter = {
     type?: 'single' | 'multiple';
     uiType?: 'radio' | 'dropdown' | 'tabs';
     dateSelectionMode?: DateSelectionMode;
-    defaultValues?: (string | number)[];
+    defaultValues?: (string | number | boolean)[];
     defaultDateFilter?: DefaultDateFilter;
     sheetId?: string;
     location?: FilterLocation;
@@ -3775,11 +3870,11 @@ export declare type TInlineFilter = {
     type?: 'single' | 'multiple';
     /** UI component for single-select filters */
     uiType?: 'radio' | 'dropdown' | 'tabs';
-    /** Date picker type: 'range' for full calendar, 'months' for month picker */
+    /** Date picker type: 'range' for full calendar, 'months' for month picker, 'day' for single-day picker */
     dateSelectionMode?: DateSelectionMode;
     /** Default values applied when the dashboard first loads */
-    defaultValues?: (string | number)[];
-    /** Default date filter applied on dashboard load (relative or fixed month/year) */
+    defaultValues?: (string | number | boolean)[];
+    /** Default date filter applied on dashboard load (relative, fixed month/year, or fixed day) */
     defaultDateFilter?: DefaultDateFilter;
     /** Search mode for numeric filters: 'text' treats as text, 'numeric' enables operators (>, <, =) */
     searchMode?: 'text' | 'numeric' | 'auto';

package/dist/types/types.d.ts

@@ -1212,6 +1212,51 @@ export declare type DashboardEventHandlers = {
     onExportData?: (payload: ExportDataPayload) => void;
 };
 
+export declare type DashboardFilterApplication = {
+    kind: 'cardMappings';
+    /**
+     * Sparse grounded bindings and explicit exclusions. A missing config card
+     * may reuse a proven Option Value target on an executable source; it is not
+     * an implicit exclusion, and source identity alone is not field evidence.
+     */
+    cards: DashboardFilterCardApplication[];
+};
+
+export declare type DashboardFilterBoundCardApplication = {
+    kind: 'bound';
+    cardId: string;
+    bindingId: string;
+    target: DashboardFilterTarget;
+};
+
+export declare type DashboardFilterCardApplication = DashboardFilterBoundCardApplication | DashboardFilterExcludedCardApplication;
+
+export declare type DashboardFilterExcludedCardApplication = {
+    kind: 'excluded';
+    cardId: string;
+};
+
+/** Persisted label/value option definition for a mapped dashboard filter. */
+export declare type DashboardFilterOptionSource = SemaphorInputOptionSource;
+
+export declare type DashboardFilterTarget = {
+    kind: 'field';
+    field: DashboardFilterTargetField;
+};
+
+/** Persisted, source-qualified field that a mapped filter targets. */
+export declare type DashboardFilterTargetField = {
+    name: string;
+    source: DashboardFilterTargetSource;
+    dataType: 'string' | 'number' | 'boolean' | 'date' | 'datetime';
+    /** Catalog-grounded physical column used when it differs from the semantic name. */
+    sourceField?: string;
+};
+
+export declare type DashboardFilterTargetSource = Extract<SemaphorSourceRef, {
+    kind: 'semantic' | 'physical';
+}>;
+
 export declare type DashboardInput = FilterDashboardInput | ControlDashboardInput;
 
 export declare type DashboardInputBase = {
@@ -1281,14 +1326,14 @@ export declare type DashboardInputScope = {
     sectionIds: string[];
 };
 
-export declare type DashboardInputSlot = ({
+export declare type DashboardInputSlot = {
     status: 'set';
     value: DashboardInputValue;
     comparisonSelection?: GlobalDateComparisonSelection;
-}) | ({
+} | {
     status: 'cleared';
     comparisonSelection?: GlobalDateComparisonSelection;
-}) | {
+} | {
     status?: never;
     value?: never;
     comparisonSelection: GlobalDateComparisonSelection;
@@ -1518,7 +1563,7 @@ export declare type DateOptions = {
     options: Intl.DateTimeFormatOptions;
 };
 
-export declare type DateSelectionMode = 'range' | 'months';
+export declare type DateSelectionMode = 'range' | 'months' | 'day';
 
 export declare type DateUnit = 'day' | 'week' | 'month' | 'quarter' | 'year';
 
@@ -1526,7 +1571,7 @@ export declare const DEFAULT_CALENDAR_CONTEXT: CalendarContext;
 
 export declare const DEFAULT_SEMANTIC_DOMAIN_ACCESS: SemanticDomainAccess;
 
-declare type DefaultDateFilter = RelativeDateFilter | FixedMonthDefaultDateFilter;
+declare type DefaultDateFilter = RelativeDateFilter | FixedMonthDefaultDateFilter | FixedDayDefaultDateFilter;
 
 export declare type DeleteBriefingResponse = {
     success: boolean;
@@ -2029,6 +2074,14 @@ export declare type EmailSettings = {
     senderTitle: string;
 };
 
+export declare type EmbeddedFilterDashboardInput = DashboardInputBase & {
+    kind: 'filter';
+    filter: TFilter;
+    filterReference?: never;
+    optionSource?: DashboardFilterOptionSource;
+    application?: DashboardFilterApplication;
+};
+
 export declare const EMPTY_SELECTION: SelectionState;
 
 export declare type EntityColumnGroup = {
@@ -2155,10 +2208,7 @@ export declare interface FilterCondition {
     temporalBucket?: TemporalBucketMetadata;
 }
 
-export declare type FilterDashboardInput = DashboardInputBase & {
-    kind: 'filter';
-    filter: TFilter;
-};
+export declare type FilterDashboardInput = EmbeddedFilterDashboardInput | ReferencedFilterDashboardInput;
 
 /**
  * Display mode for individual filters
@@ -2266,6 +2316,17 @@ export declare type FilterSemanticContext = {
 
 export declare type FilterValue = string | number | boolean | Date | null | [number, number] | [string, string] | string[] | number[];
 
+/**
+ * Absolute fixed calendar-day default used by Day Picker defaults.
+ * - `date` is a timezone-agnostic calendar day (`YYYY-MM-DD`); it resolves to
+ *   that day's start/end in the dashboard timezone at load time.
+ */
+declare type FixedDayDefaultDateFilter = {
+    mode: 'fixed';
+    unit: 'day';
+    date: string;
+};
+
 /**
  * Absolute fixed month/year default used by Month Picker defaults.
  * - `month` is 0-indexed (0=January, 11=December) to align with MonthPicker.
@@ -2960,6 +3021,17 @@ declare type MonthAlignedFiscalCalendar = {
 
 declare type NoneOptions = {};
 
+export declare type NormalizedDashboardInput = NormalizedFilterDashboardInput | ControlDashboardInput;
+
+/** Runtime form after dashboard-filter references are resolved once. */
+export declare type NormalizedFilterDashboardInput = DashboardInputBase & {
+    kind: 'filter';
+    filter: TFilter;
+    optionSource?: DashboardFilterOptionSource;
+    application?: DashboardFilterApplication;
+    definitionOrigin: 'embedded' | 'dashboardFilter';
+};
+
 export declare type NumberAxisFormat = {
     decimalPlaces?: number;
     minimumFractionDigits?: number;
@@ -3256,6 +3328,17 @@ declare type RawTemporalValueMetadata = {
     valueKind: RawTemporalValueKind;
 };
 
+export declare type ReferencedFilterDashboardInput = DashboardInputBase & {
+    kind: 'filter';
+    filter?: never;
+    filterReference: {
+        kind: 'dashboardFilter';
+        filterId: string;
+    };
+    optionSource?: DashboardFilterOptionSource;
+    application?: DashboardFilterApplication;
+};
+
 export declare type RelativeDateFilter = {
     mode: 'last';
     n: number;
@@ -3330,6 +3413,8 @@ export declare type ResolvedDashboardInput = {
     exports: Partial<Record<DashboardInputExportKey, string | number | boolean | null>>;
     filter?: TFilter;
     filterValue?: TFilterValue;
+    /** Present when a set filter slot cannot be used with its current definition. */
+    invalidFilterSelection?: boolean;
     control?: ControlDefinition;
     controlValue?: unknown;
     missingRequiredValue?: boolean;
@@ -3337,7 +3422,7 @@ export declare type ResolvedDashboardInput = {
 };
 
 export declare type ResolvedDashboardInputContext = {
-    inputs: DashboardInput[];
+    inputs: NormalizedDashboardInput[];
     resolvedInputs: ResolvedDashboardInput[];
     activeFilters: TFilterValue[];
     controlDefinitions: ControlDefinition[];
@@ -3653,6 +3738,16 @@ declare type SemaphorInputBinding = {
 
 declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'between' | 'not_between' | '>' | '>=' | '<' | '<=';
 
+declare type SemaphorInputOptionSource = {
+    source: Extract<SemaphorSourceRef, {
+        kind: 'semantic' | 'physical';
+    }>;
+    labelField: SemaphorFieldRef;
+    valueField: SemaphorFieldRef;
+    searchField?: SemaphorFieldRef;
+    disambiguationFields?: SemaphorFieldRef[];
+};
+
 declare type SemaphorMatrixAxisExpansionOptions = {
     defaultDepth?: number;
     lazy?: boolean;
@@ -4789,7 +4884,7 @@ export declare type TFilter = {
     type?: 'single' | 'multiple';
     uiType?: 'radio' | 'dropdown' | 'tabs';
     dateSelectionMode?: DateSelectionMode;
-    defaultValues?: (string | number)[];
+    defaultValues?: (string | number | boolean)[];
     defaultDateFilter?: DefaultDateFilter;
     sheetId?: string;
     location?: FilterLocation;
@@ -4958,11 +5053,11 @@ export declare type TInlineFilter = {
     type?: 'single' | 'multiple';
     /** UI component for single-select filters */
     uiType?: 'radio' | 'dropdown' | 'tabs';
-    /** Date picker type: 'range' for full calendar, 'months' for month picker */
+    /** Date picker type: 'range' for full calendar, 'months' for month picker, 'day' for single-day picker */
     dateSelectionMode?: DateSelectionMode;
     /** Default values applied when the dashboard first loads */
-    defaultValues?: (string | number)[];
-    /** Default date filter applied on dashboard load (relative or fixed month/year) */
+    defaultValues?: (string | number | boolean)[];
+    /** Default date filter applied on dashboard load (relative, fixed month/year, or fixed day) */
     defaultDateFilter?: DefaultDateFilter;
     /** Search mode for numeric filters: 'text' treats as text, 'numeric' enables operators (>, <, =) */
     searchMode?: 'text' | 'numeric' | 'auto';

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.459",
+  "version": "0.1.461",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",

package/dist/chunks/canonical-result-keys-BA0HCP4e.cjs

@@ -1 +0,0 @@
-"use strict";require("./validators-BDYprKI9.cjs");require("./analyze-result-contract-LPDNldic.cjs");const E=require("./temporal-bucket-DHY1y9lq.cjs");require("../value-format-preferences/index.cjs");const _=new Set(["previous_period","same_period_last_year","start_vs_end","target"]),R=new Set([..._,"none",""]);function l(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function L(e){const o=l(e.preferences)?e.preferences:void 0,r=o&&l(o.kpiVisualOptions)?o.kpiVisualOptions:void 0,i=o&&l(o.tableVisualOptions)?o.tableVisualOptions:void 0;return{preferences:o,kpiOptions:r,kpiComparison:r&&l(r.metricComparison)?r.metricComparison:void 0,kpiComparisonPresent:!!r&&"metricComparison"in r,tableOptions:i,tableComparison:i&&l(i.metricComparison)?i.metricComparison:void 0,tableComparisonPresent:!!i&&"metricComparison"in i}}function O(e){const o=[],r=(i,a)=>{if(Array.isArray(i)){i.forEach((n,c)=>r(n,`${a}[${c}]`));return}if(!l(i))return;const m=i.config;if(l(m)){const n=L(i),c=!!(n.kpiComparisonPresent||n.tableComparisonPresent),g=m.metricColumns,p=Array.isArray(g)?g.flatMap((s,t)=>l(s)?[{index:t,metric:s}]:[]):[];if((p.some(({metric:s})=>"comparisonType"in s)||c)&&o.push({path:a,card:i,metrics:p,malformedMetricIndexes:Array.isArray(g)?g.flatMap((s,t)=>l(s)?[]:[t]):[],malformedMetricColumns:"metricColumns"in m&&!Array.isArray(g),hasLegacyPresentation:c}),"metricColumns"in m||c)return}Object.entries(i).forEach(([n,c])=>r(c,a?`${a}.${n}`:n))};return r(e,"$"),o}const I={difference:"difference",change:"percent_change",change_difference:"both",ratio:"ratio"};function w(e,o){if(!e)return;const r=Object.fromEntries(o.flatMap(i=>typeof e[i]=="string"?[[i,e[i]]]:[]));return Object.keys(r).length?r:void 0}function M(e,o,r){if(e!==void 0){if(!l(e)){r.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:o,message:"Legacy comparison formatOptions must be an object."});return}Object.entries(e).forEach(([i,a])=>{if(i==="decimalPlaces"){(typeof a!="number"||!Number.isInteger(a)||a<0||a>6)&&r.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${o}.decimalPlaces`,message:"Legacy comparison decimalPlaces must be an integer from 0 through 6."});return}i==="type"&&(a===void 0||a==="auto")||a!==void 0&&r.push({severity:"error",code:"unsupported_comparison_format",path:`${o}.${i}`,message:`Legacy comparison format option "${i}" has no canonical presentation mapping.`})})}}function v(e,o){const r=o==="kpi"?e.calculationType:e.calculatedAs,i=o==="table"&&r===void 0?"both":I[String(r)],a=l(e.formatOptions)?e.formatOptions:void 0,m=l(e.conditionalLabels)?e.conditionalLabels:void 0,n=l(o==="kpi"?e.colorConfig:e.colors)?o==="kpi"?e.colorConfig:e.colors:void 0,c={};if(i&&(c.displayMode=i),typeof(a==null?void 0:a.decimalPlaces)=="number"&&(c.precision=a.decimalPlaces),o==="kpi"){const s=e.showArrow!==!1,t=e.showColor!==!1;c.indicatorStyle=s?t?"arrow_badge":"arrow":t?"badge":"none",c.showColor=t,(e.position==="left"||e.position==="right"||e.position==="top")&&(c.position=e.position),typeof e.conditionalLabel=="boolean"&&(c.conditionalLabel=e.conditionalLabel),typeof e.labelName=="string"&&(c.labelName=e.labelName)}else(e.indicatorStyle==="arrow_badge"||e.indicatorStyle==="arrow"||e.indicatorStyle==="badge"||e.indicatorStyle==="none")&&(c.indicatorStyle=e.indicatorStyle);const g=m?{...w(m,["increase","decrease"]),...typeof m.noChange=="string"?{neutral:m.noChange}:typeof m.neutral=="string"?{neutral:m.neutral}:{}}:void 0;g&&Object.keys(g).length&&(c.conditionalLabels=g);const p=n?{...w(n,["increase","decrease"]),...typeof n.noChange=="string"?{neutral:n.noChange}:typeof n.neutral=="string"?{neutral:n.neutral}:{}}:void 0;return p&&Object.keys(p).length&&(c.colors=p),c}function $(e){return{...E.COMPARISON_PRESENTATION_DEFAULTS,...e}}function T(e){return e.some(({metric:o})=>o.comparisonType==="previous_period"||o.comparisonType==="same_period_last_year"||o.comparisonType==="target"?!0:l(o.comparison)&&o.comparison.mode==="explicit")}function C(e){const o=e.card.config;return e.metrics.length===2&&(o.groupByColumns===void 0||Array.isArray(o.groupByColumns)&&o.groupByColumns.length===0)}function P(e,o,r,i){const a=o==="kpi"?["enabled","calculationType","formatOptions","showArrow","showColor","conditionalLabel","labelName","position","conditionalLabels","colorConfig","lowerIsBetter"]:["calculatedAs","indicatorStyle","formatOptions","colors","lowerIsBetter"];Object.keys(e).forEach(s=>{a.includes(s)||i.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${r}.${s}`,message:`Unknown legacy comparison presentation field "${s}" cannot be dropped automatically.`})});const m=o==="kpi"?"calculationType":"calculatedAs";e[m]!==void 0&&!I[String(e[m])]&&i.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${r}.${m}`,message:`Legacy comparison ${m} is unsupported.`}),o==="kpi"&&e.position!==void 0&&!["left","right","top"].includes(String(e.position))&&i.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${r}.position`,message:"Legacy comparison position is unsupported."}),o==="kpi"&&e.labelName!==void 0&&typeof e.labelName!="string"&&i.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${r}.labelName`,message:"Legacy comparison labelName must be a string."}),(o==="kpi"?[["conditionalLabels",["increase","decrease","noChange"]],["colorConfig",["increase","decrease","noChange"]]]:[["colors",["increase","decrease","neutral"]]]).forEach(([s,t])=>{if(e[s]!==void 0){if(!l(e[s])){i.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${r}.${s}`,message:`Legacy comparison ${s} must be an object.`});return}Object.entries(e[s]).forEach(([f,u])=>{t.includes(f)?typeof u!="string"&&i.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${r}.${s}.${f}`,message:`Legacy comparison ${s}.${f} must be a string.`}):i.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${r}.${s}.${f}`,message:`Unknown legacy comparison ${s} field "${f}" cannot be dropped automatically.`})})}}),(o==="kpi"?["enabled","showArrow","showColor","conditionalLabel","lowerIsBetter"]:["lowerIsBetter"]).forEach(s=>{e[s]!==void 0&&typeof e[s]!="boolean"&&i.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${r}.${s}`,message:`Legacy comparison ${s} must be a boolean.`})}),o==="table"&&e.indicatorStyle!==void 0&&!["arrow_badge","arrow","badge","none"].includes(String(e.indicatorStyle))&&i.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${r}.indicatorStyle`,message:"Legacy comparison indicatorStyle is unsupported."}),M(e.formatOptions,`${r}.formatOptions`,i);const g=v(e,o);E.validateComparisonPresentationSpec(g,r).errors.forEach(s=>{i.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:s.path||r,message:s.message})})}function S(e){const o=L(e.card),r=o.kpiComparison?v(o.kpiComparison,"kpi"):void 0,i=o.tableComparison?v(o.tableComparison,"table"):void 0;return{namespaces:o,kpi:r,table:i,presentation:r||i}}function B(e){const o=l(e.preferences)?e.preferences:{},r=l(o.kpiVisualOptions)?o.kpiVisualOptions:{},i=l(r.metricComparison)?r.metricComparison:{},a=l(o.tableVisualOptions)?o.tableVisualOptions:{},m=l(a.metricComparison)?a.metricComparison:{};return r.lowerIsBetter===!0||i.lowerIsBetter===!0||m.lowerIsBetter===!0?"lower_is_better":"higher_is_better"}function D(e){switch(e.comparisonType){case"previous_period":return{mode:"explicit",spec:{kind:"previous_period"}};case"same_period_last_year":return{mode:"explicit",spec:{kind:"previous_year"}};case"target":return{mode:"explicit",spec:{kind:"target",targetValue:e.targetValue}};default:return}}function j(e){const o=l(e.preferences)?e.preferences:void 0;if(!o)return;const r=l(o.kpiVisualOptions)?o.kpiVisualOptions:void 0;r&&delete r.lowerIsBetter;const i=l(o.tableVisualOptions)?o.tableVisualOptions:void 0,a=i&&l(i.metricComparison)?i.metricComparison:void 0;a&&delete a.lowerIsBetter}function x(e){const o=O(e);if(!o.length)return{document:e,changed:!1,changes:[],diagnostics:[]};const r=[];if(o.forEach(n=>{var c,g,p,s;if(n.malformedMetricColumns&&r.push({severity:"error",code:"malformed_metric_columns",path:`${n.path}.config.metricColumns`,message:"Metric columns must be an array before comparison migration."}),n.malformedMetricIndexes.forEach(t=>{r.push({severity:"error",code:"malformed_metric_columns",path:`${n.path}.config.metricColumns[${t}]`,message:"Metric columns must contain objects before comparison migration."})}),n.metrics.forEach(({metric:t,index:f})=>{if(!("comparisonType"in t))return;const u=`${n.path}.config.metricColumns[${f}]`,d=String(t.comparisonType||"");"comparison"in t&&r.push({severity:"error",code:"conflicting_comparison_contracts",path:u,message:"Metric contains both legacy and canonical comparison configuration; resolve the conflict before migration."});const h=l(t.parameters)?t.parameters:void 0,b=h&&l(h.windowTransform)?h.windowTransform:void 0;_.has(d)&&(b==null?void 0:b.function)==="previous_period_delta"&&r.push({severity:"error",code:"conflicting_comparison_window_transform",path:u,message:"A metric cannot combine baseline comparison with previous_period_delta; resolve the authoring intent before migration."}),R.has(d)||r.push({severity:"error",code:"unsupported_comparison_type",path:`${u}.comparisonType`,message:`Unsupported legacy metric comparison type "${d}".`}),t.comparisonType==="target"&&(typeof t.targetValue!="number"||!Number.isFinite(t.targetValue))&&r.push({severity:"error",code:"invalid_target_value",path:`${u}.targetValue`,message:"Legacy target comparison requires a finite metric targetValue."}),t.comparisonType==="start_vs_end"&&r.push({severity:"error",code:"unsupported_start_vs_end",path:`${u}.comparisonType`,message:"start_vs_end is retired and cannot be migrated automatically."}),t.targetValue!==void 0&&t.comparisonType!=="target"&&r.push({severity:"warning",code:"stray_target_value",path:`${u}.targetValue`,message:"Dead non-target targetValue will be removed without changing the baseline."})}),n.hasLegacyPresentation){const{namespaces:t,kpi:f,table:u}=S(n),d=[(c=t.kpiOptions)==null?void 0:c.lowerIsBetter,(g=t.kpiComparison)==null?void 0:g.lowerIsBetter,(p=t.tableComparison)==null?void 0:p.lowerIsBetter].filter(h=>typeof h=="boolean");new Set(d).size>1&&r.push({severity:"error",code:"conflicting_legacy_polarity",path:`${n.path}.preferences`,message:"Legacy comparison polarity values disagree; resolve the conflict before migration."}),((s=t.kpiOptions)==null?void 0:s.lowerIsBetter)!==void 0&&typeof t.kpiOptions.lowerIsBetter!="boolean"&&r.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${n.path}.preferences.kpiVisualOptions.lowerIsBetter`,message:"Legacy comparison lowerIsBetter must be a boolean."}),t.kpiComparisonPresent&&!t.kpiComparison&&r.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${n.path}.preferences.kpiVisualOptions.metricComparison`,message:"Legacy KPI comparison presentation must be an object."}),t.tableComparisonPresent&&!t.tableComparison&&r.push({severity:"error",code:"invalid_legacy_comparison_presentation",path:`${n.path}.preferences.tableVisualOptions.metricComparison`,message:"Legacy table comparison presentation must be an object."}),"comparisonPresentation"in(t.preferences||{})&&r.push({severity:"error",code:"conflicting_comparison_presentation_contracts",path:`${n.path}.preferences.comparisonPresentation`,message:"Card contains both legacy and canonical comparison presentation; resolve the conflict before migration."}),t.kpiComparison&&typeof t.kpiComparison.enabled=="boolean"&&"metricPairComparisonEnabled"in(t.preferences||{})&&C(n)&&r.push({severity:"error",code:"conflicting_comparison_presentation_contracts",path:`${n.path}.preferences.metricPairComparisonEnabled`,message:"Card contains both legacy and canonical metric-pair enablement; resolve the conflict before migration."}),t.kpiComparison&&P(t.kpiComparison,"kpi",`${n.path}.preferences.kpiVisualOptions.metricComparison`,r),t.tableComparison&&P(t.tableComparison,"table",`${n.path}.preferences.tableVisualOptions.metricComparison`,r),f&&u&&JSON.stringify($(f))!==JSON.stringify($(u))&&r.push({severity:"error",code:"conflicting_legacy_presentation_namespaces",path:`${n.path}.preferences`,message:"KPI and table comparison presentation values disagree; resolve the conflict before migration."})}}),r.some(n=>n.severity==="error"))return{document:e,changed:!1,changes:[],diagnostics:r};const i=JSON.parse(JSON.stringify(e)),a=O(i),m=[];return a.forEach(n=>{var g;const c=B(n.card);if(n.metrics.forEach(({metric:p,index:s})=>{if(!("comparisonType"in p))return;const t=String(p.comparisonType||""),f=`${n.path}.config.metricColumns[${s}]`,u=D(p),d=["comparisonType"];delete p.comparisonType,"targetValue"in p&&(delete p.targetValue,d.push("targetValue")),"comparisonDisplay"in p&&(delete p.comparisonDisplay,d.push("comparisonDisplay")),u?p.comparison=u:delete p.comparison,_.has(t)&&(p.comparisonPolarity=c),m.push({kind:"metric",path:f,metricId:typeof p.id=="string"?p.id:void 0,legacyType:t,comparison:u,comparisonPolarity:_.has(t)?c:void 0,removedFields:d})}),j(n.card),n.hasLegacyPresentation){const{namespaces:p,presentation:s}=S(n),t=(g=p.kpiComparison)==null?void 0:g.enabled,f={...s};typeof t=="boolean"&&T(n.metrics)&&(f.showComparison=t);const u=typeof t=="boolean"&&C(n)?t:void 0,d=typeof t=="boolean"&&!T(n.metrics)&&!C(n)?["kpiVisualOptions.metricComparison.enabled"]:void 0,h=p.preferences,b=[];n.metrics.forEach(({metric:y})=>{"comparisonPolarity"in y||(y.comparisonPolarity=c,typeof y.id=="string"&&b.push(y.id))}),Object.keys(f).length&&(h.comparisonPresentation=f),u!==void 0&&(h.metricPairComparisonEnabled=u),p.kpiOptions&&delete p.kpiOptions.metricComparison,p.tableOptions&&delete p.tableOptions.metricComparison,m.push({kind:"presentation",path:`${n.path}.preferences`,comparisonPresentation:Object.keys(f).length?f:void 0,metricPairComparisonEnabled:u,comparisonPolarityMetricIds:b,intentionallyDiscardedFields:d,removedFields:[...p.kpiComparison?["kpiVisualOptions.metricComparison"]:[],...p.tableComparison?["tableVisualOptions.metricComparison"]:[]]})}}),{document:i,changed:!0,changes:m,diagnostics:r}}const k=["bar","horizontalBar","line","area","stackedArea","combo","stackedBar","stackedLine"],K=new Set(k);function V(e){return typeof e=="string"&&K.has(e)}function Y(e){return e==="detailTable"||e==="table"||e==="aggregateTable"||e==="pivotTable"||e==="custom"||V(e)}function A(e){return!!(e!=null&&e.trim())}function F(e){return A(e.sql)||A(e.normalizedPython)?"freeform":e.hasExecutableConfig?"config":"none"}const U="SEMAPHOR_CALCULATED_FIELD";function N(e,o,r){if(r&&(o==="groupby"||o==="pivotby"))return r;if(o==="metric"&&e.name==="*"&&!e.expression)return e.alias||"count";if(e.alias)return e.alias;const i=e.entityName&&e.entityName!==U?e.entityName:void 0;if(e.role==="metric"){let a=e.aggregate||"metric";if(e.expression){const m=e.expression.match(/^(COUNT|SUM|AVG|MIN|MAX|MEDIAN|DISTINCT)\s*\(/i);a=m?m[1].toLowerCase():"expr"}else a=a.toLowerCase();return i&&i!==e.name?`${i}_${e.name}_${a}`:`${e.name}_${a}`}return i&&i!==e.name?`${i}_${e.name}`:e.name}function H(e){return N(e,"detail")}function q(e){const o=e.label;return o&&e.labelCount===1&&(o===e.rawKey||!e.rawKeys.has(o))?o:e.rawKey}exports.SEMAPHOR_CARTESIAN_CHART_TYPES=k;exports.isSemaphorCartesianChartType=V;exports.resolveCanonicalDetailResultRawKey=H;exports.resolveCanonicalResultOutputKey=q;exports.resolveCanonicalResultRawKey=N;exports.resolveTemporalResultOwner=F;exports.supportsCanonicalDashboardTemporalResult=Y;exports.transformComparisonDocument=x;