react-semaphor 0.1.459 → 0.1.461

package/dist/types/data-app-codegen-node.d.ts

@@ -241,7 +241,9 @@ declare type SemaphorDataAppCodegenInputBinding = {
 declare type SemaphorDataAppCodegenInputOptionQuery = {
     id?: string;
     builder: 'semaphor.inputOptions';
-    source?: SemaphorSourceRef;
+    source?: Extract<SemaphorSourceRef, {
+        kind: 'semantic' | 'physical';
+    }>;
     sourceKey?: string;
     valueFieldRef: SemaphorDataAppCodegenFieldRef;
     labelFieldRef: SemaphorDataAppCodegenFieldRef;
@@ -252,7 +254,8 @@ declare type SemaphorDataAppCodegenInputOptionQuery = {
     spec?: SemaphorDataAppCodegenInputOptionsIntent;
 };
 
-declare type SemaphorDataAppCodegenInputOptionsIntent = Omit<SemaphorInputOptionsIntent, 'kind' | 'labelField' | 'valueField' | 'searchField' | 'disambiguationFields'> & {
+declare type SemaphorDataAppCodegenInputOptionsIntent = Omit<SemaphorInputOptionsIntent, 'kind' | 'source' | 'labelField' | 'valueField' | 'searchField' | 'disambiguationFields'> & {
+    source: SemaphorDataAppCodegenSource;
     labelField: SemaphorDataAppCodegenFieldRef;
     valueField: SemaphorDataAppCodegenFieldRef;
     searchField?: SemaphorDataAppCodegenFieldRef;
@@ -794,17 +797,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;
@@ -813,6 +811,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 SemaphorInputValue = SemaphorScalar | SemaphorScalar[];
 
 declare type SemaphorMatrixAxisExpansionOptions = {

package/dist/types/data-app-codegen.d.ts

@@ -237,7 +237,9 @@ declare type SemaphorDataAppCodegenInputBinding = {
 declare type SemaphorDataAppCodegenInputOptionQuery = {
     id?: string;
     builder: 'semaphor.inputOptions';
-    source?: SemaphorSourceRef;
+    source?: Extract<SemaphorSourceRef, {
+        kind: 'semantic' | 'physical';
+    }>;
     sourceKey?: string;
     valueFieldRef: SemaphorDataAppCodegenFieldRef;
     labelFieldRef: SemaphorDataAppCodegenFieldRef;
@@ -248,7 +250,8 @@ declare type SemaphorDataAppCodegenInputOptionQuery = {
     spec?: SemaphorDataAppCodegenInputOptionsIntent;
 };
 
-declare type SemaphorDataAppCodegenInputOptionsIntent = Omit<SemaphorInputOptionsIntent, 'kind' | 'labelField' | 'valueField' | 'searchField' | 'disambiguationFields'> & {
+declare type SemaphorDataAppCodegenInputOptionsIntent = Omit<SemaphorInputOptionsIntent, 'kind' | 'source' | 'labelField' | 'valueField' | 'searchField' | 'disambiguationFields'> & {
+    source: SemaphorDataAppCodegenSource;
     labelField: SemaphorDataAppCodegenFieldRef;
     valueField: SemaphorDataAppCodegenFieldRef;
     searchField?: SemaphorDataAppCodegenFieldRef;
@@ -766,17 +769,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;
@@ -785,6 +783,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 SemaphorInputValue = SemaphorScalar | SemaphorScalar[];
 
 declare type SemaphorMatrixAxisExpansionOptions = {

package/dist/types/data-app-sdk-adapters.d.ts

@@ -214,17 +214,12 @@ declare type SemaphorInputOption = {
     disambiguation?: string[];
 };
 
-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;
@@ -233,14 +228,25 @@ declare type SemaphorInputOptionsIntent = {
     derivedFields?: SemaphorDerivedFieldDefinition[];
 };
 
-declare type SemaphorInputOptionsQuerySpec = SemaphorQuerySourceSpec & SemaphorAppDerivedFieldsSpec & {
+declare type SemaphorInputOptionSource = {
+    source: Extract<SemaphorSourceRef, {
+        kind: 'semantic' | 'physical';
+    }>;
+    labelField: SemaphorFieldRef;
+    valueField: SemaphorFieldRef;
+    searchField?: SemaphorFieldRef;
+    disambiguationFields?: SemaphorFieldRef[];
+};
+
+declare type SemaphorInputOptionsQuerySpec = Omit<SemaphorQuerySourceSpec, 'source'> & {
+    /** Option lists are governed from semantic or physical sources only. */
+    source: Extract<SemaphorSourceRef, {
+        kind: 'semantic' | 'physical';
+    }>;
+} & Omit<SemaphorInputOptionSource, 'source'> & SemaphorAppDerivedFieldsSpec & {
     id?: string;
     label?: string;
     inputId: string;
-    labelField: SemaphorQueryField;
-    valueField: SemaphorQueryField;
-    searchField?: SemaphorQueryField;
-    disambiguationFields?: SemaphorQueryField[];
     population?: SemaphorOptionPopulation;
     dependencies?: SemaphorOptionDependencies;
     inputs?: SemaphorInputReference[];

package/dist/types/data-app-sdk-validation.d.ts

@@ -658,17 +658,12 @@ declare type SemaphorInputOption = {
     disambiguation?: string[];
 };
 
-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;
@@ -677,18 +672,29 @@ declare type SemaphorInputOptionsIntent = {
     derivedFields?: SemaphorDerivedFieldDefinition[];
 };
 
+declare type SemaphorInputOptionSource = {
+    source: Extract<SemaphorSourceRef, {
+        kind: 'semantic' | 'physical';
+    }>;
+    labelField: SemaphorFieldRef;
+    valueField: SemaphorFieldRef;
+    searchField?: SemaphorFieldRef;
+    disambiguationFields?: SemaphorFieldRef[];
+};
+
 declare type SemaphorInputOptionsQueryDefinition = SemaphorInputOptionsQuerySpec & {
     queryKind: 'inputOptions';
 };
 
-declare type SemaphorInputOptionsQuerySpec = SemaphorQuerySourceSpec & SemaphorAppDerivedFieldsSpec & {
+declare type SemaphorInputOptionsQuerySpec = Omit<SemaphorQuerySourceSpec, 'source'> & {
+    /** Option lists are governed from semantic or physical sources only. */
+    source: Extract<SemaphorSourceRef, {
+        kind: 'semantic' | 'physical';
+    }>;
+} & Omit<SemaphorInputOptionSource, 'source'> & SemaphorAppDerivedFieldsSpec & {
     id?: string;
     label?: string;
     inputId: string;
-    labelField: SemaphorQueryField;
-    valueField: SemaphorQueryField;
-    searchField?: SemaphorQueryField;
-    disambiguationFields?: SemaphorQueryField[];
     population?: SemaphorOptionPopulation;
     dependencies?: SemaphorOptionDependencies;
     inputs?: SemaphorInputReference[];

package/dist/types/data-app-sdk.d.ts

@@ -1001,17 +1001,12 @@ export declare type SemaphorInputOption = {
     disambiguation?: string[];
 };
 
-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;
@@ -1020,6 +1015,16 @@ declare type SemaphorInputOptionsIntent = {
     derivedFields?: SemaphorDerivedFieldDefinition[];
 };
 
+export declare type SemaphorInputOptionSource = {
+    source: Extract<SemaphorSourceRef, {
+        kind: 'semantic' | 'physical';
+    }>;
+    labelField: SemaphorFieldRef;
+    valueField: SemaphorFieldRef;
+    searchField?: SemaphorFieldRef;
+    disambiguationFields?: SemaphorFieldRef[];
+};
+
 export declare type SemaphorInputOptionsPayload = {
     options: SemaphorInputOption[];
     executionResult?: SemaphorAnalyticsExecutionResult;
@@ -1036,14 +1041,15 @@ export declare type SemaphorInputOptionsQueryResult = SemaphorQueryState & Semap
     }>;
 };
 
-export declare type SemaphorInputOptionsQuerySpec = SemaphorQuerySourceSpec & SemaphorAppDerivedFieldsSpec & {
+export declare type SemaphorInputOptionsQuerySpec = Omit<SemaphorQuerySourceSpec, 'source'> & {
+    /** Option lists are governed from semantic or physical sources only. */
+    source: Extract<SemaphorSourceRef, {
+        kind: 'semantic' | 'physical';
+    }>;
+} & Omit<SemaphorInputOptionSource, 'source'> & SemaphorAppDerivedFieldsSpec & {
     id?: string;
     label?: string;
     inputId: string;
-    labelField: SemaphorQueryField;
-    valueField: SemaphorQueryField;
-    searchField?: SemaphorQueryField;
-    disambiguationFields?: SemaphorQueryField[];
     population?: SemaphorOptionPopulation;
     dependencies?: SemaphorOptionDependencies;
     inputs?: SemaphorInputReference[];

package/dist/types/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/common-types-C57kJ59w.cjs"),l=require("../chunks/token-types-D7CaaI80.cjs"),t=require("../chunks/pivot-result-identity-Bb4EixVN.cjs"),E=require("../chunks/report-runtime-context-DqxS4wbi.cjs");exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.PivotMarkerEnum=e.PivotMarkerEnum;exports.getFieldRuntimeColumnName=e.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=e.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=e.hasCalculatedFormulaInputs;exports.isCalculatedDimension=e.isCalculatedDimension;exports.isCalculatedField=e.isCalculatedField;exports.isCalculatedMetric=e.isCalculatedMetric;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=l.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.resolveQueryColumnKeyMapEntry=t.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=t.resolveUniqueQueryColumnKeyMapEntry;exports.DEFAULT_CALENDAR_CONTEXT=E.DEFAULT_CALENDAR_CONTEXT;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/common-types-BcV9PD9D.cjs"),l=require("../chunks/token-types-BYYO109W.cjs"),t=require("../chunks/pivot-result-identity-DxHtiKVj.cjs"),E=require("../chunks/report-runtime-context-C0NfLPfc.cjs");exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.PivotMarkerEnum=e.PivotMarkerEnum;exports.getFieldRuntimeColumnName=e.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=e.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=e.hasCalculatedFormulaInputs;exports.isCalculatedDimension=e.isCalculatedDimension;exports.isCalculatedField=e.isCalculatedField;exports.isCalculatedMetric=e.isCalculatedMetric;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=l.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.resolveQueryColumnKeyMapEntry=t.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=t.resolveUniqueQueryColumnKeyMapEntry;exports.DEFAULT_CALENDAR_CONTEXT=E.DEFAULT_CALENDAR_CONTEXT;

package/dist/types/index.js

@@ -1,7 +1,7 @@
-import { a as s, C as r, D as E, E as l, P as C, g as o, d as t, h as A, b as u, c as T, i as _ } from "../chunks/common-types-H51FLKB7.js";
-import { D } from "../chunks/token-types-GbxRUozo.js";
-import { r as n, a as L } from "../chunks/pivot-result-identity-DU1v-5Xk.js";
-import { D as d } from "../chunks/report-runtime-context-SM6YO61_.js";
+import { a as s, C as r, D as E, E as l, P as C, g as o, d as t, h as A, b as u, c as T, i as _ } from "../chunks/common-types-BHVKgxRR.js";
+import { D } from "../chunks/token-types-BLxc7UwR.js";
+import { r as n, a as L } from "../chunks/pivot-result-identity-Z9tN2tEV.js";
+import { D as d } from "../chunks/report-runtime-context-CNncA3VD.js";
 export {
   s as CALCULATED_FIELD_ENTITY_MARKER,
   r as CONTROL_CARD_DEFAULT_VALUE,

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;
@@ -2603,7 +2763,7 @@ export declare type DateOptions = {
 
 export { DateRange }
 
-declare type DateSelectionMode = 'range' | 'months';
+declare type DateSelectionMode = 'range' | 'months' | 'day';
 
 declare type DateUnit = 'day' | 'week' | 'month' | 'quarter' | 'year';
 
@@ -2611,7 +2771,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 function deleteBriefing(apiServiceUrl: string, token: string, briefingId: string): Promise<DeleteBriefingResponse>;
 
@@ -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
@@ -3682,6 +3847,17 @@ 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.
@@ -4726,6 +4902,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 +5239,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;
@@ -5140,6 +5338,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;
@@ -5147,7 +5347,7 @@ export declare type ResolvedDashboardInput = {
 };
 
 export declare type ResolvedDashboardInputContext = {
-    inputs: DashboardInput[];
+    inputs: NormalizedDashboardInput[];
     resolvedInputs: ResolvedDashboardInput[];
     activeFilters: TFilterValue[];
     controlDefinitions: ControlDefinition[];
@@ -5546,17 +5746,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;
@@ -5565,6 +5760,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;
@@ -6947,7 +7152,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;
@@ -7116,11 +7321,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';