react-semaphor 0.1.459 → 0.1.461

package/dist/types/dashboard-authoring.d.ts

@@ -78,6 +78,13 @@ declare type BaseFilter = {
 
 declare type Breakpoint = 'lg' | 'md' | 'sm' | 'xs' | 'xxs';
 
+/**
+ * Inventories config sources proven executable by the card and SQL sources
+ * explicitly pinned for catalog authoring. It never infers SQL lineage,
+ * discovers a relationship, or adds a join.
+ */
+export declare function buildDashboardCardSourceIndex(card: Pick<TCard, 'id' | 'type' | 'sql' | 'config' | 'dataSource'>): DashboardCardFilterSourceInventory;
+
 declare type CacheConfig = {
     ttl: string;
     status: 'on' | 'on-refresh' | 'off';
@@ -601,6 +608,8 @@ declare type ControlSource = {
 
 declare type ControlType = 'enum' | 'multi_enum' | 'text' | 'number' | 'boolean' | 'date' | 'field_selector' | 'metric_selector' | 'aggregation_selector' | 'grain_selector';
 
+export declare function createDashboardFilterBindingId(createUuid?: () => string): string;
+
 declare type CurrencyPresentationBinding = {
     controlId: string;
     target: 'presentation_currency';
@@ -664,6 +673,21 @@ export declare type DashboardAuthoringValidationResult = {
     warnings: DashboardPlanWarning[];
 };
 
+export declare type DashboardCardFilterSourceInventory = {
+    cardId: string;
+    kind: 'config';
+    executableSources: DashboardFilterTargetSource[];
+} | {
+    cardId: string;
+    kind: 'sql';
+    pinnedCatalogSources: DashboardSqlPinnedCatalogSource[];
+} | {
+    cardId: string;
+    kind: 'unconfigured';
+};
+
+export declare function dashboardCardFilterSourceInventoryContains(inventory: DashboardCardFilterSourceInventory, source: DashboardFilterTargetSource): boolean;
+
 export declare type DashboardCardSizeIntent = 'kpi' | 'chart' | 'table' | 'text';
 
 export declare type DashboardChangeCompileResult = {
@@ -717,6 +741,89 @@ export declare type DashboardCompileResult = {
     skippedOperations: DashboardPlanWarning[];
 };
 
+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 DashboardFilterAutomaticTargetResolution = {
+    status: 'matched';
+    target: DashboardFilterTarget;
+} | {
+    status: 'ambiguous';
+} | {
+    status: 'notApplicable';
+};
+
+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;
+};
+
+export declare type DashboardFilterLogicalValueField = Pick<DashboardFilterTargetField, 'name' | 'sourceField'> & {
+    dataType: DashboardFilterTargetField['dataType'];
+};
+
+export declare class DashboardFilterMappingContractError extends Error {
+    readonly issues: DashboardFilterMappingContractIssue[];
+    constructor(issues: DashboardFilterMappingContractIssue[]);
+}
+
+export declare type DashboardFilterMappingContractIssue = {
+    code: DashboardFilterMappingContractIssueCode;
+    path: string;
+    message: string;
+    inputId?: string;
+    cardId?: string;
+    bindingId?: string;
+};
+
+export declare type DashboardFilterMappingContractIssueCode = 'invalid_input' | 'both_filter_definitions' | 'missing_filter_definition' | 'orphaned_filter_reference' | 'invalid_filter_reference' | 'duplicate_filter_reference' | 'global_date_reference' | 'unsupported_mapped_scope' | 'invalid_application' | 'duplicate_card_application' | 'unknown_card' | 'invalid_binding_id' | 'unsupported_target' | 'invalid_target_field' | 'unknown_target_data_type' | 'unavailable_card_source' | 'invalid_option_source';
+
+/** Persisted label/value option definition for a mapped dashboard filter. */
+export declare type DashboardFilterOptionSource = SemaphorInputOptionSource;
+
+export declare type DashboardFilterSubscriptionHint = {
+    helper: '{{ filters | where }}' | '{{ filters | and }}';
+    description: string;
+};
+
+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 function dashboardFilterTargetMatchesLogicalValue(target: DashboardFilterTarget, logicalValueField: DashboardFilterLogicalValueField): boolean;
+
+export declare type DashboardFilterTargetSource = Extract<SemaphorSourceRef, {
+    kind: 'semantic' | 'physical';
+}>;
+
+export declare function dashboardFilterValueTypeForDataType(dataType: unknown): keyof typeof OPERATIONS_BY_DATA_TYPE;
+
 declare type DashboardInput = FilterDashboardInput | ControlDashboardInput;
 
 declare type DashboardInputBase = {
@@ -777,14 +884,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;
@@ -901,6 +1008,27 @@ export declare type DashboardPlanWarning = {
     cardId?: string;
 };
 
+export declare type DashboardSqlExecutionTable = {
+    connectionId: string;
+    databaseName?: string;
+    schemaName?: string;
+    tableName: string;
+};
+
+export declare type DashboardSqlFilterTargetResolution = {
+    status: 'eligible';
+    source: DashboardFilterTargetSource;
+    executionIdentifier: string;
+} | {
+    status: 'ineligible';
+};
+
+export declare type DashboardSqlPinnedCatalogSource = {
+    source: DashboardFilterTargetSource;
+    /** Physical SQL coordinate declared by the pinned entity, when available. */
+    executionTable?: DashboardSqlExecutionTable;
+};
+
 export declare type DashboardSuggestion = {
     id: string;
     title: string;
@@ -973,11 +1101,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.
@@ -1348,6 +1476,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 {
@@ -1451,10 +1587,7 @@ declare interface FilterCondition {
     temporalBucket?: TemporalBucketMetadata;
 }
 
-declare type FilterDashboardInput = DashboardInputBase & {
-    kind: 'filter';
-    filter: TFilter;
-};
+declare type FilterDashboardInput = EmbeddedFilterDashboardInput | ReferencedFilterDashboardInput;
 
 /**
  * Display mode for individual filters
@@ -1564,6 +1697,23 @@ declare type FilterValue = string | number | boolean | Date | null | [number, nu
 
 export declare function findDashboardAuthoringDatasetForSource(datasets: readonly SemaphorSourceRef[], source: SemaphorSourceRef | undefined): SemaphorSourceRef | undefined;
 
+export declare function findDashboardCardExecutableSource(inventory: DashboardCardFilterSourceInventory, source: DashboardFilterTargetSource): DashboardFilterTargetSource | undefined;
+
+export declare function findDashboardCardPinnedCatalogSource(inventory: DashboardCardFilterSourceInventory, source: DashboardFilterTargetSource): DashboardFilterTargetSource | undefined;
+
+export declare function findDashboardSqlPinnedCatalogSource(inventory: DashboardCardFilterSourceInventory, source: DashboardFilterTargetSource): DashboardSqlPinnedCatalogSource | undefined;
+
+/**
+ * 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.
@@ -1623,6 +1773,8 @@ export declare type GeneratedDashboardCardArtifact = {
 
 export declare function getDashboardAuthoringCardSource(card: Pick<DashboardPlanCard, 'analyticsIntent'>): SemaphorSourceRef | undefined;
 
+export declare function getDashboardFilterSubscriptionHint(sql: string | null | undefined): DashboardFilterSubscriptionHint | null;
+
 export declare function getTemporalBucketAuthoringOptions(granularity: SemaphorTimeGrain, preservedFormat?: TemporalBucketFormat, preferences?: ResolvedTemporalValueFormatPreferences): readonly TemporalBucketAuthoringOption[];
 
 export declare function getTemporalBucketAuthoringSelection(format: TemporalBucketFormat, granularity: SemaphorTimeGrain): TemporalBucketAuthoringSelection;
@@ -1654,6 +1806,12 @@ declare interface GroupByField extends Field {
     calculatedFormula?: CalculatedFieldFormula;
 }
 
+/**
+ * Existing lightweight authoring hint for the exact plain collection helpers.
+ * It is not SQL validation, execution, security, persistence, or save policy.
+ */
+export declare function hasDashboardFilterSubscription(sql: string | null | undefined): boolean;
+
 declare type HtmlOptions = {
     html: string;
 };
@@ -1731,6 +1889,8 @@ declare interface InteractionTrigger {
     field: Field;
 }
 
+export declare function isDashboardFilterOperationCompatible(dataType: unknown, operation: unknown): boolean;
+
 export declare function isMaterializableDashboardAuthoringSource(value: unknown): value is MaterializableDashboardAuthoringSource;
 
 export declare function isSemaphorCartesianChartType(value: string | null | undefined): value is SemaphorCartesianChartType;
@@ -1877,6 +2037,34 @@ declare type MonthAlignedFiscalCalendar = {
 
 declare type NoneOptions = {};
 
+export declare function normalizeDashboardInputs({ inputs, dashboardFilters, cards, validateCardTargets, }: {
+    inputs: DashboardInput[] | unknown;
+    dashboardFilters: TFilter[] | undefined;
+    cards?: TCard[];
+    /** Save/validation boundary check. Runtime drift is owned per card by the compiler. */
+    validateCardTargets?: boolean;
+}): NormalizeDashboardInputsResult;
+
+export declare type NormalizeDashboardInputsResult = {
+    ok: true;
+    inputs: NormalizedDashboardInput[];
+} | {
+    ok: false;
+    inputs: NormalizedDashboardInput[];
+    issues: DashboardFilterMappingContractIssue[];
+};
+
+declare type NormalizedDashboardInput = NormalizedFilterDashboardInput | ControlDashboardInput;
+
+/** Runtime form after dashboard-filter references are resolved once. */
+declare type NormalizedFilterDashboardInput = DashboardInputBase & {
+    kind: 'filter';
+    filter: TFilter;
+    optionSource?: DashboardFilterOptionSource;
+    application?: DashboardFilterApplication;
+    definitionOrigin: 'embedded' | 'dashboardFilter';
+};
+
 declare type NumberAxisFormat = {
     decimalPlaces?: number;
     minimumFractionDigits?: number;
@@ -1899,6 +2087,13 @@ declare type OldFilterValue = string | number | null | (string | number)[] | Ran
 
 declare type Operation = '=' | '>' | '<' | '>=' | '<=' | '!=' | 'in' | 'not in' | 'like' | 'not like' | 'between' | 'not between' | 'is null' | 'is not null';
 
+declare const OPERATIONS_BY_DATA_TYPE: {
+    readonly date: Set<string>;
+    readonly number: Set<string>;
+    readonly string: Set<string>;
+    readonly boolean: Set<string>;
+};
+
 declare type Operator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'startsWith' | 'endsWith' | 'like' | 'not like' | 'in' | 'not in' | 'between' | 'not between' | 'isNull' | 'isNotNull';
 
 declare type OptionsMap = {
@@ -1997,6 +2192,17 @@ declare type RangeValue = {
 
 export declare function reconcileTemporalBucketAuthoringFormat(format: TemporalBucketFormat, granularity: SemaphorTimeGrain): TemporalBucketFormat;
 
+declare type ReferencedFilterDashboardInput = DashboardInputBase & {
+    kind: 'filter';
+    filter?: never;
+    filterReference: {
+        kind: 'dashboardFilter';
+        filterId: string;
+    };
+    optionSource?: DashboardFilterOptionSource;
+    application?: DashboardFilterApplication;
+};
+
 declare type RelativeDateFilter = {
     mode: 'last';
     n: number;
@@ -2023,6 +2229,8 @@ declare type RelativeDateFilter = {
     to: number;
 };
 
+export declare function requireNormalizedDashboardInputs(params: Parameters<typeof normalizeDashboardInputs>[0]): NormalizedDashboardInput[];
+
 /** Physical SQL/result alias used by config-owned detail projections. */
 export declare function resolveCanonicalDetailResultRawKey(field: CanonicalDetailResultFieldIdentity): string;
 
@@ -2048,6 +2256,31 @@ export declare function resolveDashboardAuthoringSource({ explicitSource, field,
     fallbackSources?: readonly SemaphorSourceRef[];
 }): MaterializableDashboardAuthoringSource | undefined;
 
+/**
+ * Resolves the default Option Value target from proven executable candidates.
+ * Authoring supplies catalog-grounded candidates. Runtime supplies only
+ * governed value fields or previously accepted same-key bindings whose source
+ * is executable by the card. The shared rule keeps UI suggestions and query
+ * behavior from becoming separate interpreters without inventing columns from
+ * source identity alone.
+ */
+export declare function resolveDashboardFilterAutomaticTarget(params: {
+    logicalValueField: DashboardFilterLogicalValueField;
+    candidates: DashboardFilterTarget[];
+}): DashboardFilterAutomaticTargetResolution;
+
+/**
+ * Resolves one accepted SQL-card target without inspecting authored SQL.
+ * Authoring may provide the grounded candidate set to reject an unqualified
+ * duplicate. Runtime can prove an unqualified identifier remains unique only
+ * while the card has one pinned source, so source drift fails closed.
+ */
+export declare function resolveDashboardSqlFilterTarget(params: {
+    inventory: DashboardCardFilterSourceInventory;
+    target: DashboardFilterTarget;
+    candidateTargets?: DashboardFilterTarget[];
+}): DashboardSqlFilterTargetResolution;
+
 /** Viewer preferences that affect temporal presentation without numeric currency policy. */
 declare type ResolvedTemporalValueFormatPreferences = Pick<ResolvedValueFormatPreferences, 'locale' | 'dateStyle' | 'dateTime'>;
 
@@ -2215,17 +2448,12 @@ declare type SemaphorInputBinding = {
 
 declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'between' | 'not_between' | '>' | '>=' | '<' | '<=';
 
-declare type SemaphorInputOptionsIntent = {
+declare type SemaphorInputOptionsIntent = SemaphorInputOptionSource & {
     kind: 'inputOptions';
     version?: SemaphorProtocolVersion;
     id?: string;
     label?: string;
     inputId: string;
-    source: SemaphorSourceRef;
-    labelField: SemaphorFieldRef;
-    valueField: SemaphorFieldRef;
-    searchField?: SemaphorFieldRef;
-    disambiguationFields?: SemaphorFieldRef[];
     population?: SemaphorOptionPopulation;
     dependencies?: SemaphorOptionDependencies;
     search?: string;
@@ -2234,6 +2462,16 @@ declare type SemaphorInputOptionsIntent = {
     derivedFields?: SemaphorDerivedFieldDefinition[];
 };
 
+declare type SemaphorInputOptionSource = {
+    source: Extract<SemaphorSourceRef, {
+        kind: 'semantic' | 'physical';
+    }>;
+    labelField: SemaphorFieldRef;
+    valueField: SemaphorFieldRef;
+    searchField?: SemaphorFieldRef;
+    disambiguationFields?: SemaphorFieldRef[];
+};
+
 declare type SemaphorInputScope = {
     level: 'dashboard';
     excludeViewIds?: string[];
@@ -3340,7 +3578,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;
@@ -3501,11 +3739,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/dashboard.d.ts

@@ -704,6 +704,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 = {
@@ -773,14 +818,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;
@@ -990,11 +1035,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.
@@ -1444,6 +1489,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';
@@ -1560,10 +1613,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
@@ -1671,6 +1721,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.
@@ -2067,6 +2128,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;
@@ -2224,6 +2296,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;
@@ -2296,6 +2379,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;
@@ -2303,7 +2388,7 @@ export declare type ResolvedDashboardInput = {
 };
 
 export declare type ResolvedDashboardInputContext = {
-    inputs: DashboardInput[];
+    inputs: NormalizedDashboardInput[];
     resolvedInputs: ResolvedDashboardInput[];
     activeFilters: TFilterValue[];
     controlDefinitions: ControlDefinition[];
@@ -2551,6 +2636,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;
@@ -3584,7 +3679,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;
@@ -3753,11 +3848,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/data-app-builder.d.ts

@@ -646,17 +646,12 @@ declare type SemaphorInputBinding = {
 
 declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'between' | 'not_between' | '>' | '>=' | '<' | '<=';
 
-declare type SemaphorInputOptionsIntent = {
+declare type SemaphorInputOptionsIntent = SemaphorInputOptionSource & {
     kind: 'inputOptions';
     version?: SemaphorProtocolVersion;
     id?: string;
     label?: string;
     inputId: string;
-    source: SemaphorSourceRef;
-    labelField: SemaphorFieldRef;
-    valueField: SemaphorFieldRef;
-    searchField?: SemaphorFieldRef;
-    disambiguationFields?: SemaphorFieldRef[];
     population?: SemaphorOptionPopulation;
     dependencies?: SemaphorOptionDependencies;
     search?: string;
@@ -665,6 +660,16 @@ declare type SemaphorInputOptionsIntent = {
     derivedFields?: SemaphorDerivedFieldDefinition[];
 };
 
+declare type SemaphorInputOptionSource = {
+    source: Extract<SemaphorSourceRef, {
+        kind: 'semantic' | 'physical';
+    }>;
+    labelField: SemaphorFieldRef;
+    valueField: SemaphorFieldRef;
+    searchField?: SemaphorFieldRef;
+    disambiguationFields?: SemaphorFieldRef[];
+};
+
 declare type SemaphorMatrixAxisExpansionOptions = {
     defaultDepth?: number;
     lazy?: boolean;