react-semaphor 0.1.459 → 0.1.460

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-DHF-2AqS.cjs"),r=require("../chunks/common-types-C57kJ59w.cjs"),o=require("../chunks/report-preferences-dialog-BK0yAJnQ.cjs");exports.DisplayFormatPreferencesFields=e.DisplayFormatPreferencesFields;exports.Surfboard=e.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=r.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;exports.ReportPreferencesDialog=o.ReportPreferencesDialog;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-B9c22LmC.cjs"),r=require("../chunks/common-types-BcV9PD9D.cjs"),o=require("../chunks/report-preferences-dialog-D_N6NXnq.cjs");exports.DisplayFormatPreferencesFields=e.DisplayFormatPreferencesFields;exports.Surfboard=e.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=r.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;exports.ReportPreferencesDialog=o.ReportPreferencesDialog;

package/dist/surfboard/index.js

@@ -1,6 +1,6 @@
-import { b as a, a as o } from "../chunks/index-BS2-ZZGf.js";
-import { C as f, E } from "../chunks/common-types-H51FLKB7.js";
-import { R as t } from "../chunks/report-preferences-dialog-BDpkcUtz.js";
+import { b as a, a as o } from "../chunks/index-DDoyXYWM.js";
+import { C as f, E } from "../chunks/common-types-BHVKgxRR.js";
+import { R as t } from "../chunks/report-preferences-dialog-CZiNX1Ri.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

package/dist/types/analytics-protocol.d.ts

@@ -2637,7 +2637,9 @@ export declare type SemaphorDataAppCodegenInputBinding = {
 export declare type SemaphorDataAppCodegenInputOptionQuery = {
     id?: string;
     builder: 'semaphor.inputOptions';
-    source?: SemaphorSourceRef;
+    source?: Extract<SemaphorSourceRef, {
+        kind: 'semantic' | 'physical';
+    }>;
     sourceKey?: string;
     valueFieldRef: SemaphorDataAppCodegenFieldRef;
     labelFieldRef: SemaphorDataAppCodegenFieldRef;
@@ -2648,7 +2650,8 @@ export declare type SemaphorDataAppCodegenInputOptionQuery = {
     spec?: SemaphorDataAppCodegenInputOptionsIntent;
 };
 
-export declare type SemaphorDataAppCodegenInputOptionsIntent = Omit<SemaphorInputOptionsIntent, 'kind' | 'labelField' | 'valueField' | 'searchField' | 'disambiguationFields'> & {
+export declare type SemaphorDataAppCodegenInputOptionsIntent = Omit<SemaphorInputOptionsIntent, 'kind' | 'source' | 'labelField' | 'valueField' | 'searchField' | 'disambiguationFields'> & {
+    source: SemaphorDataAppCodegenSource;
     labelField: SemaphorDataAppCodegenFieldRef;
     valueField: SemaphorDataAppCodegenFieldRef;
     searchField?: SemaphorDataAppCodegenFieldRef;
@@ -3113,17 +3116,12 @@ export declare type SemaphorInputBinding = {
 
 export declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'between' | 'not_between' | '>' | '>=' | '<' | '<=';
 
-export declare type SemaphorInputOptionsIntent = {
+export 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;
@@ -3132,6 +3130,16 @@ export 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 SemaphorInputOptionsResult = SemaphorAnalyticsResultBase & {
     kind: 'inputOptions';
     options: Array<{

package/dist/types/briefings.d.ts

@@ -1039,6 +1039,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 = {
@@ -1099,14 +1144,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;
@@ -1591,6 +1636,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 {
@@ -1694,10 +1747,7 @@ declare interface FilterCondition {
     temporalBucket?: TemporalBucketMetadata;
 }
 
-declare type FilterDashboardInput = DashboardInputBase & {
-    kind: 'filter';
-    filter: TFilter;
-};
+declare type FilterDashboardInput = EmbeddedFilterDashboardInput | ReferencedFilterDashboardInput;
 
 /**
  * Display mode for individual filters
@@ -2298,6 +2348,17 @@ declare type RawTemporalPresentationTarget = {
     columnKey: string;
 };
 
+declare type ReferencedFilterDashboardInput = DashboardInputBase & {
+    kind: 'filter';
+    filter?: never;
+    filterReference: {
+        kind: 'dashboardFilter';
+        filterId: string;
+    };
+    optionSource?: DashboardFilterOptionSource;
+    application?: DashboardFilterApplication;
+};
+
 declare type RelativeDateFilter = {
     mode: 'last';
     n: number;
@@ -2535,6 +2596,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;
@@ -3471,7 +3542,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;
@@ -3635,7 +3706,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/dashboard-assistant.d.ts

@@ -1240,17 +1240,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;
@@ -1259,6 +1254,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 SemaphorInputOptionsResult = SemaphorAnalyticsResultBase & {
     kind: 'inputOptions';
     options: Array<{

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;
@@ -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,12 @@ 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 month/year default used by Month Picker defaults.
  * - `month` is 0-indexed (0=January, 11=December) to align with MonthPicker.
@@ -1623,6 +1762,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 +1795,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 +1878,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 +2026,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 +2076,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 +2181,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 +2218,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 +2245,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 +2437,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 +2451,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 +3567,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;
@@ -3504,7 +3731,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 (>, <, =) */