react-semaphor 0.1.457 → 0.1.460

package/dist/types/main.d.ts

@@ -43,6 +43,15 @@ declare type Actions_2 = {
     setDefaultControlValues: (controlValues: Record<string, unknown> | undefined) => void;
     setDashboardInputs: (inputs: DashboardInput[]) => void;
     upsertDashboardInput: (input: DashboardInput) => void;
+    updateFilterDashboardInputDefinition: (inputId: string, filter: TFilter, metadata?: {
+        variableName?: string;
+        label?: string;
+    }) => void;
+    acceptDashboardFilterOptionSource: (updatedFilter: TFilter, optionSource: DashboardFilterOptionSource, settings?: DashboardFilterAuthoringSettingsUpdate, inputMetadata?: {
+        variableName?: string;
+    }) => DashboardFilterOptionSourceAcceptanceResult;
+    acceptDashboardFilterMapping: (request: DashboardFilterMappingAuthoringRequest, updatedFilter?: TFilter, settings?: DashboardFilterAuthoringSettingsUpdate) => DashboardFilterMappingAcceptanceResult;
+    disableDashboardFilterMapping: (filterId: string, updatedFilter?: TFilter, settings?: DashboardFilterAuthoringSettingsUpdate) => DashboardFilterMappingDisableResult;
     removeDashboardInput: (inputId: string) => void;
     setDefaultDashboardInputValues: (values: DashboardInputValues | undefined) => void;
     setDefaultDashboardInputComparisonSelection: (input: Pick<DashboardInput, 'id' | 'runtimeScope'>, target: DashboardInputRuntimeTarget, selection: GlobalDateComparisonSelection | undefined) => void;
@@ -2041,6 +2050,37 @@ declare interface DashboardExportDialogProps {
     onOpenChange: (open: boolean) => 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[];
+};
+
+declare type DashboardFilterAuthoringSettingsUpdate = {
+    defaultValueChanged: boolean;
+    defaultFilterValue?: TFilterValue;
+    defaultComparisonChanged: boolean;
+    defaultComparisonSelection?: GlobalDateComparisonSelection;
+    target: DashboardInputRuntimeTarget;
+    optionSourceChanged?: boolean;
+    optionSource?: DashboardFilterOptionSource;
+    /** Raw selection identity changed; the previous runtime value is invalid. */
+    selectionIdentityChanged?: boolean;
+};
+
+export declare type DashboardFilterBoundCardApplication = {
+    kind: 'bound';
+    cardId: string;
+    bindingId: string;
+    target: DashboardFilterTarget;
+};
+
+export declare type DashboardFilterCardApplication = DashboardFilterBoundCardApplication | DashboardFilterExcludedCardApplication;
+
 export declare function DashboardFilterControlsButton({ showFilters, onShowFiltersChange, pickerContent, settingsContent, size, className, primaryButtonClassName, secondaryButtonClassName, pickerContentClassName, settingsContentClassName, }: DashboardFilterControlsButtonProps): JSX.Element;
 
 /**
@@ -2102,6 +2142,126 @@ declare type DashboardFilterControlsLauncherProps = {
     settingsContentClassName?: string;
 };
 
+export declare type DashboardFilterExcludedCardApplication = {
+    kind: 'excluded';
+    cardId: string;
+};
+
+declare type DashboardFilterMappingAcceptanceResult = {
+    ok: true;
+    draft: DashboardFilterMappingDraft;
+    input: ReferencedFilterDashboardInput;
+} | {
+    ok: false;
+    draft?: DashboardFilterMappingDraft;
+    issues: DashboardFilterMappingAuthoringIssue[];
+};
+
+declare type DashboardFilterMappingAuthoringIssue = {
+    code: DashboardFilterMappingAuthoringIssueCode;
+    message: string;
+    filterId: string;
+    cardId?: string;
+};
+
+declare type DashboardFilterMappingAuthoringIssueCode = 'filterNotFound' | 'mappingNotFound' | 'globalDateUnsupported' | 'conflictingDashboardInput' | 'unsupportedOuterScope' | 'unsupportedRuntimeScope' | 'missingDecision' | 'invalidTarget' | 'metadataUnavailable';
+
+declare type DashboardFilterMappingAuthoringRequest = {
+    filterId: string;
+    candidatesByCardId: Record<string, DashboardFilterMappingCandidateCatalog | undefined>;
+    /** Grounded field that supplies the current filter value. */
+    selectionField?: Pick<DashboardFilterTargetField, 'name' | 'sourceField'> & Partial<Pick<DashboardFilterTargetField, 'source'>>;
+    /** Datatype of the raw selection value, which may differ from the label. */
+    selectionDataType?: string;
+    /**
+     * Re-check saved targets against selectionField after the author changes
+     * the raw Option Value identity. Explicit draft decisions still win.
+     */
+    revalidatePersistedTargets?: boolean;
+    decisionsByCardId?: Record<string, DashboardFilterMappingDraftDecision | undefined>;
+    /** Staged outer sheet scope. Omit when the author did not edit Scope. */
+    outerScope?: DashboardFilterMappingDraft['outerScope'];
+    /** Test seam; production callers use opaque random UUIDs. */
+    createId?: () => string;
+};
+
+declare type DashboardFilterMappingCandidateCatalog = {
+    status: 'ready';
+    targets: DashboardFilterTarget[];
+} | {
+    status: 'metadataUnavailable';
+    message?: string;
+};
+
+declare type DashboardFilterMappingDisableResult = {
+    ok: true;
+    inputId: string;
+} | {
+    ok: false;
+    issues: DashboardFilterMappingAuthoringIssue[];
+};
+
+declare type DashboardFilterMappingDraft = {
+    filterId: string;
+    existingInputId?: string;
+    outerScope: Extract<DashboardInputScope, {
+        kind: 'allSheets' | 'sheets';
+    }>;
+    rows: DashboardFilterMappingDraftRow[];
+};
+
+declare type DashboardFilterMappingDraftDecision = {
+    kind: 'bound';
+    target: DashboardFilterTarget;
+} | {
+    kind: 'excluded';
+};
+
+declare type DashboardFilterMappingDraftRow = {
+    cardId: string;
+    sheetId: string;
+    executionKind: 'config' | 'sql' | 'unconfigured';
+    status: DashboardFilterMappingDraftStatus;
+    candidates: DashboardFilterTarget[];
+    selectedTarget?: DashboardFilterTarget;
+    persistedApplication?: DashboardFilterCardApplication;
+    metadataMessage?: string;
+    guidanceMessage?: string;
+    automaticFieldName?: string;
+};
+
+declare type DashboardFilterMappingDraftStatus = 'pendingSource' | 'suggested' | 'needsMapping' | 'mapped' | 'notApplicable' | 'excluded' | 'invalidMapping' | 'metadataUnavailable';
+
+/** Persisted label/value option definition for a mapped dashboard filter. */
+export declare type DashboardFilterOptionSource = SemaphorInputOptionSource;
+
+declare type DashboardFilterOptionSourceAcceptanceResult = {
+    ok: true;
+    input: ReferencedFilterDashboardInput;
+    created: boolean;
+} | {
+    ok: false;
+    issues: DashboardFilterMappingAuthoringIssue[];
+};
+
+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 = {
@@ -2177,14 +2337,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;
@@ -3282,6 +3442,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 emitDashboardLoad: () => void;
 
 export declare const emitDashboardUnload: () => void;
@@ -3571,10 +3739,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
@@ -4726,6 +4891,17 @@ declare type NoneOptions = {};
  */
 export declare function normalizeDashboardForDirtyCheck(dashboard: TDashboard | null): TDashboard | null;
 
+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';
+};
+
 /**
  * Notification bell icon with badge.
  *
@@ -5052,6 +5228,17 @@ declare type RawTemporalValueMetadata = {
     valueKind: RawTemporalValueKind;
 };
 
+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;
@@ -5066,6 +5253,8 @@ declare type RelativeDateFilter = {
     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;
@@ -5138,6 +5327,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;
@@ -5145,7 +5336,7 @@ export declare type ResolvedDashboardInput = {
 };
 
 export declare type ResolvedDashboardInputContext = {
-    inputs: DashboardInput[];
+    inputs: NormalizedDashboardInput[];
     resolvedInputs: ResolvedDashboardInput[];
     activeFilters: TFilterValue[];
     controlDefinitions: ControlDefinition[];
@@ -5544,17 +5735,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;
@@ -5563,6 +5749,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;
@@ -6945,7 +7141,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;
@@ -7117,7 +7313,7 @@ export declare type TInlineFilter = {
     /** Date picker type: 'range' for full calendar, 'months' for month picker */
     dateSelectionMode?: DateSelectionMode;
     /** Default values applied when the dashboard first loads */
-    defaultValues?: (string | number)[];
+    defaultValues?: (string | number | boolean)[];
     /** Default date filter applied on dashboard load (relative or fixed month/year) */
     defaultDateFilter?: DefaultDateFilter;
     /** Search mode for numeric filters: 'text' treats as text, 'numeric' enables operators (>, <, =) */

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;
@@ -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
@@ -1700,6 +1750,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;
@@ -1714,6 +1775,8 @@ declare type RelativeDateFilter = {
     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;
@@ -1832,6 +1895,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;
@@ -2764,7 +2837,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;
@@ -2928,7 +3001,7 @@ declare type TInlineFilter = {
     /** Date picker type: 'range' for full calendar, 'months' for month picker */
     dateSelectionMode?: DateSelectionMode;
     /** Default values applied when the dashboard first loads */
-    defaultValues?: (string | number)[];
+    defaultValues?: (string | number | boolean)[];
     /** Default date filter applied on dashboard load (relative or fixed month/year) */
     defaultDateFilter?: DefaultDateFilter;
     /** Search mode for numeric filters: 'text' treats as text, 'numeric' enables operators (>, <, =) */

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;
@@ -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
@@ -2080,6 +2130,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 +2298,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;
@@ -2251,6 +2323,8 @@ declare type RelativeDateFilter = {
     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;
@@ -2314,6 +2388,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;
@@ -2321,7 +2397,7 @@ export declare type ResolvedDashboardInput = {
 };
 
 export declare type ResolvedDashboardInputContext = {
-    inputs: DashboardInput[];
+    inputs: NormalizedDashboardInput[];
     resolvedInputs: ResolvedDashboardInput[];
     activeFilters: TFilterValue[];
     controlDefinitions: ControlDefinition[];
@@ -2569,6 +2645,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;
@@ -3604,7 +3690,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;
@@ -3776,7 +3862,7 @@ export declare type TInlineFilter = {
     /** Date picker type: 'range' for full calendar, 'months' for month picker */
     dateSelectionMode?: DateSelectionMode;
     /** Default values applied when the dashboard first loads */
-    defaultValues?: (string | number)[];
+    defaultValues?: (string | number | boolean)[];
     /** Default date filter applied on dashboard load (relative or fixed month/year) */
     defaultDateFilter?: DefaultDateFilter;
     /** Search mode for numeric filters: 'text' treats as text, 'numeric' enables operators (>, <, =) */