react-semaphor 0.1.495 → 0.1.496

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

@@ -1839,6 +1839,13 @@ export declare function applyDashboardChangePlan(input: {
     cardArtifacts: GeneratedDashboardCardArtifact[];
 }): DashboardChangeCompileResult;
 
+/**
+ * The only way an override enters a dependency policy: explicit mode, unique
+ * ids, restricted to what the policy includes. Returns the same object when
+ * nothing applies so callers can cheaply detect "no override".
+ */
+export declare function applyOptionDependencyOverride(dependencies: SemaphorOptionDependencies, omitInputIds: readonly string[] | undefined): SemaphorOptionDependencies;
+
 export declare const AUTOMATIC_TEMPORAL_BUCKET_FORMAT: TemporalBucketFormat;
 
 declare type AxisConfig = {
@@ -5697,6 +5704,14 @@ export declare const DASHBOARD_AUTHORING_BREAKPOINTS: readonly ["lg", "md", "sm"
 
 export declare const DASHBOARD_AUTHORING_MAX_GENERATED_CARDS = 15;
 
+/**
+ * Dashboard filters narrow their option lists by every applicable peer
+ * selection unless the author chose otherwise. This differs from the SDK
+ * protocol, where an omitted policy means independent; dashboard adapters
+ * therefore resolve the policy here and always send it explicitly.
+ */
+export declare const DASHBOARD_DEFAULT_OPTION_DEPENDENCIES: SemaphorOptionDependencies;
+
 declare type DashboardAIContext = AIContext & {
     mode?: DashboardAIContextMode;
 };
@@ -5866,7 +5881,17 @@ export declare type DashboardFilterMappingContractIssue = {
     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';
+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' | 'invalid_option_dependencies' | 'invalid_option_population';
+
+/**
+ * Persisted policy for which peer selections narrow a filter's option list.
+ * Omitted means All applicable for dashboards; see
+ * `resolveDashboardOptionDependencies`.
+ */
+export declare type DashboardFilterOptionDependencies = SemaphorOptionDependencies;
+
+/** Persisted population that fixes relevance for fact-bridged cascades. */
+export declare type DashboardFilterOptionPopulation = SemaphorOptionPopulation;
 
 /** Persisted label/value option definition for a mapped dashboard filter. */
 export declare type DashboardFilterOptionSource = SemaphorInputOptionSource;
@@ -6015,6 +6040,40 @@ export declare type DashboardLayoutCompileInput = {
 
 export declare type DashboardLayoutCompileResult = PersistedFrameLayouts;
 
+/**
+ * Structured option context sent with standard filter-values requests. The
+ * policy is always explicit here; the server never infers a dashboard default.
+ */
+export declare type DashboardOptionContext = {
+    inputId: string;
+    dependencies: SemaphorOptionDependencies;
+    population?: SemaphorOptionPopulation;
+    inputs: DashboardOptionContextBinding[];
+};
+
+/** One peer filter input the option request may reference. */
+export declare type DashboardOptionContextBinding = Pick<SemaphorInputBinding, 'inputId' | 'kind' | 'relationshipHint'> & {
+    /** Backing dashboard filter id; the server maps active_filters through it. */
+    filterId: string;
+};
+
+export declare type DashboardOptionDependenciesResolution = {
+    ok: true;
+    dependencies: SemaphorOptionDependencies;
+} | {
+    ok: false;
+    error: string;
+    issues: string[];
+};
+
+export declare type DashboardOptionPopulationResolution = {
+    ok: true;
+    population: SemaphorOptionPopulation | undefined;
+} | {
+    ok: false;
+    error: string;
+};
+
 export declare type DashboardPlan = {
     version: 1;
     id: string;
@@ -8254,6 +8313,8 @@ declare type EmbeddedFilterDashboardInput = FilterDashboardInputBase & {
     filter: TFilter;
     filterReference?: never;
     optionSource?: DashboardFilterOptionSource;
+    optionDependencies?: DashboardFilterOptionDependencies;
+    optionPopulation?: DashboardFilterOptionPopulation;
     application?: DashboardFilterApplication;
 };
 
@@ -9573,6 +9634,8 @@ declare type NormalizedFilterDashboardInput = FilterDashboardInputBase & {
     kind: 'filter';
     filter: TFilter;
     optionSource?: DashboardFilterOptionSource;
+    optionDependencies?: DashboardFilterOptionDependencies;
+    optionPopulation?: DashboardFilterOptionPopulation;
     application?: DashboardFilterApplication;
     definitionOrigin: 'embedded' | 'dashboardFilter';
 };
@@ -11303,6 +11366,14 @@ declare type RangeValue = {
 /** Strict consumer boundary, not an upcaster for the old matrixIntent. */
 export declare function readMatrixCardConfig(card: MatrixCardInput): MatrixConfig | undefined;
 
+/**
+ * Rewrites explicit dependency references when an input's stable identity
+ * changes, for example when a plain filter is promoted to a reference-backed
+ * input or demoted back. Returns the same array when nothing referenced the
+ * old id.
+ */
+export declare function rebindDashboardOptionDependencyInputId<TInput extends object>(inputs: TInput[], fromInputId: string, toInputId: string): TInput[];
+
 /** Reconcile effective structural bindings without inventing presentation or saved defaults. */
 export declare function reconcileMatrixSpecStructure(beforeSpec: MatrixSpec, afterSpec: MatrixSpec, authoringDraft?: boolean): {
     spec: MatrixSpec;
@@ -11319,6 +11390,8 @@ declare type ReferencedFilterDashboardInput = FilterDashboardInputBase & {
         filterId: string;
     };
     optionSource?: DashboardFilterOptionSource;
+    optionDependencies?: DashboardFilterOptionDependencies;
+    optionPopulation?: DashboardFilterOptionPopulation;
     application?: DashboardFilterApplication;
 };
 
@@ -11409,6 +11482,21 @@ export declare function resolveDashboardFilterInheritedTarget(params: {
     acceptedTargets: DashboardFilterTarget[];
 }): DashboardFilterAutomaticTargetResolution;
 
+/**
+ * Resolves an authored dashboard option dependency policy to the explicit
+ * policy sent to the server. Omission means All applicable. Present values are
+ * validated with the dashboard profile and returned in canonical shape; nothing
+ * here mutates saved definitions.
+ */
+export declare function resolveDashboardOptionDependencies(value: unknown): DashboardOptionDependenciesResolution;
+
+/**
+ * Validates an authored option population. Omission means the option source
+ * itself. A related population must name a complete semantic source; physical
+ * relationship discovery is not part of this feature.
+ */
+export declare function resolveDashboardOptionPopulation(value: unknown): DashboardOptionPopulationResolution;
+
 /**
  * Resolves one accepted SQL-card target without inspecting authored SQL.
  * Authoring may provide the grounded candidate set to reject an unqualified
@@ -11491,6 +11579,17 @@ export declare function resolveTemporalResultOwner(input: TemporalResultOwnerInp
 /** Saved and unsaved rules share structural reference cleanup; never broaden a stale scope. */
 export declare function retainMatrixConditionalFormatting<T extends TableConditionalFormatting | undefined>(before: MatrixSpec, spec: MatrixSpec, formatting: T, notices: MatrixAuthoringNotice[]): T;
 
+/**
+ * Which peer inputs a policy considers. Mirrors the server resolver's
+ * membership rule so clients can scope request payloads and cache identity;
+ * applicability and relationship proof remain server-owned.
+ */
+export declare function selectDashboardOptionDependencyInputIds(params: {
+    targetInputId: string;
+    dependencies: SemaphorOptionDependencies;
+    peerInputIds: readonly string[];
+}): string[];
+
 declare type SelectedEntities = SelectedEntity[];
 
 declare type SelectedEntity = DatabaseEntityReference | DataModelEntityReference | DatasetEntityReference | FileEntityReference;
@@ -11636,6 +11735,15 @@ declare type SemaphorInputOptionsIntent = SemaphorInputOptionSource & {
     dependencies?: SemaphorOptionDependencies;
     search?: string;
     limit?: number;
+    /**
+     * Authoritative selected-value relevance check: return only options whose
+     * value is one of these exact raw values, under the same dependency and
+     * population context, with no search or paging. Bounded by
+     * `MAX_OPTION_MATCH_VALUES`. The result's `match.complete` says whether
+     * absence from the returned options proves no match. Scalars only; see
+     * `parseOptionMatchValues`.
+     */
+    matchValues?: Array<string | number | boolean>;
     inputs?: SemaphorInputBinding[];
     derivedFields?: SemaphorDerivedFieldDefinition[];
 };
@@ -11711,11 +11819,24 @@ declare type SemaphorMetricIntent = {
 };
 
 declare type SemaphorOptionDependencies = {
-    mode?: 'independent' | 'explicit';
+    /** Omitted mode means independent for protocol callers. Dashboard authoring
+     * normalizes omission separately through `resolveDashboardOptionDependencies`. */
+    mode?: SemaphorOptionDependencyMode;
     includeInputIds?: string[];
     excludeInputIds?: string[];
+    /**
+     * Ephemeral browse override: explicit dependencies the viewer asked to
+     * browse without. Only valid in explicit mode, only for ids in
+     * `includeInputIds`, and only honored by the server when that dependency
+     * would otherwise fail with an overridable reason (see
+     * `OVERRIDABLE_OPTION_DEPENDENCY_REASONS`). Never persisted, never applied
+     * to card predicates; it lives in one browse request and its cache identity.
+     */
+    omitInputIds?: string[];
 };
 
+declare type SemaphorOptionDependencyMode = 'independent' | 'explicit' | 'all_applicable';
+
 declare type SemaphorOptionPopulation = {
     kind: 'option_source';
     baseSource?: never;
@@ -15103,4 +15224,12 @@ declare interface WindowTransform {
     };
 }
 
+/**
+ * Applies an ephemeral browse override to a resolved option context. Only an
+ * explicit policy can be overridden, and only for ids it includes; anything
+ * else returns the context unchanged. The override rides the request and its
+ * cache identity and is never written back to the dashboard.
+ */
+export declare function withDashboardOptionDependencyOverride(context: DashboardOptionContext, omitInputIds: readonly string[] | undefined): DashboardOptionContext;
+
 export { }

package/dist/types/dashboard.d.ts

@@ -4151,6 +4151,16 @@ export declare type DashboardFilterExcludedCardApplication = {
     cardId: string;
 };
 
+/**
+ * Persisted policy for which peer selections narrow a filter's option list.
+ * Omitted means All applicable for dashboards; see
+ * `resolveDashboardOptionDependencies`.
+ */
+declare type DashboardFilterOptionDependencies = SemaphorOptionDependencies;
+
+/** Persisted population that fixes relevance for fact-bridged cascades. */
+declare type DashboardFilterOptionPopulation = SemaphorOptionPopulation;
+
 /** Persisted label/value option definition for a mapped dashboard filter. */
 export declare type DashboardFilterOptionSource = SemaphorInputOptionSource;
 
@@ -4923,6 +4933,8 @@ export declare type EmbeddedFilterDashboardInput = FilterDashboardInputBase & {
     filter: TFilter;
     filterReference?: never;
     optionSource?: DashboardFilterOptionSource;
+    optionDependencies?: DashboardFilterOptionDependencies;
+    optionPopulation?: DashboardFilterOptionPopulation;
     application?: DashboardFilterApplication;
 };
 
@@ -5909,6 +5921,8 @@ export declare type NormalizedFilterDashboardInput = FilterDashboardInputBase &
     kind: 'filter';
     filter: TFilter;
     optionSource?: DashboardFilterOptionSource;
+    optionDependencies?: DashboardFilterOptionDependencies;
+    optionPopulation?: DashboardFilterOptionPopulation;
     application?: DashboardFilterApplication;
     definitionOrigin: 'embedded' | 'dashboardFilter';
 };
@@ -7676,6 +7690,8 @@ export declare type ReferencedFilterDashboardInput = FilterDashboardInputBase &
         filterId: string;
     };
     optionSource?: DashboardFilterOptionSource;
+    optionDependencies?: DashboardFilterOptionDependencies;
+    optionPopulation?: DashboardFilterOptionPopulation;
     application?: DashboardFilterApplication;
 };
 
@@ -7966,6 +7982,38 @@ declare type SemaphorInputOptionSource = {
     disambiguationFields?: SemaphorFieldRef[];
 };
 
+declare type SemaphorOptionDependencies = {
+    /** Omitted mode means independent for protocol callers. Dashboard authoring
+     * normalizes omission separately through `resolveDashboardOptionDependencies`. */
+    mode?: SemaphorOptionDependencyMode;
+    includeInputIds?: string[];
+    excludeInputIds?: string[];
+    /**
+     * Ephemeral browse override: explicit dependencies the viewer asked to
+     * browse without. Only valid in explicit mode, only for ids in
+     * `includeInputIds`, and only honored by the server when that dependency
+     * would otherwise fail with an overridable reason (see
+     * `OVERRIDABLE_OPTION_DEPENDENCY_REASONS`). Never persisted, never applied
+     * to card predicates; it lives in one browse request and its cache identity.
+     */
+    omitInputIds?: string[];
+};
+
+declare type SemaphorOptionDependencyMode = 'independent' | 'explicit' | 'all_applicable';
+
+declare type SemaphorOptionPopulation = {
+    kind: 'option_source';
+    baseSource?: never;
+} | {
+    kind: 'related_population';
+    baseSource: SemaphorSourceRef;
+    relationshipHint?: SemaphorRelationshipHint;
+};
+
+declare type SemaphorRelationshipHint = {
+    relationshipIds?: string[];
+};
+
 declare type SemaphorScalarValueFormat = {
     type: 'number' | 'currency' | 'percent' | 'percentage' | 'scientific';
     minimumFractionDigits?: number;

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

@@ -4500,6 +4500,15 @@ declare type SemaphorInputOptionsIntent = SemaphorInputOptionSource & {
     dependencies?: SemaphorOptionDependencies;
     search?: string;
     limit?: number;
+    /**
+     * Authoritative selected-value relevance check: return only options whose
+     * value is one of these exact raw values, under the same dependency and
+     * population context, with no search or paging. Bounded by
+     * `MAX_OPTION_MATCH_VALUES`. The result's `match.complete` says whether
+     * absence from the returned options proves no match. Scalars only; see
+     * `parseOptionMatchValues`.
+     */
+    matchValues?: Array<string | number | boolean>;
     inputs?: SemaphorInputBinding[];
     derivedFields?: SemaphorDerivedFieldDefinition[];
 };
@@ -4552,11 +4561,24 @@ declare type SemaphorMetricIntent = {
 };
 
 declare type SemaphorOptionDependencies = {
-    mode?: 'independent' | 'explicit';
+    /** Omitted mode means independent for protocol callers. Dashboard authoring
+     * normalizes omission separately through `resolveDashboardOptionDependencies`. */
+    mode?: SemaphorOptionDependencyMode;
     includeInputIds?: string[];
     excludeInputIds?: string[];
+    /**
+     * Ephemeral browse override: explicit dependencies the viewer asked to
+     * browse without. Only valid in explicit mode, only for ids in
+     * `includeInputIds`, and only honored by the server when that dependency
+     * would otherwise fail with an overridable reason (see
+     * `OVERRIDABLE_OPTION_DEPENDENCY_REASONS`). Never persisted, never applied
+     * to card predicates; it lives in one browse request and its cache identity.
+     */
+    omitInputIds?: string[];
 };
 
+declare type SemaphorOptionDependencyMode = 'independent' | 'explicit' | 'all_applicable';
+
 declare type SemaphorOptionPopulation = {
     kind: 'option_source';
     baseSource?: never;

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

@@ -5368,6 +5368,15 @@ declare type SemaphorInputOptionsIntent = SemaphorInputOptionSource & {
     dependencies?: SemaphorOptionDependencies;
     search?: string;
     limit?: number;
+    /**
+     * Authoritative selected-value relevance check: return only options whose
+     * value is one of these exact raw values, under the same dependency and
+     * population context, with no search or paging. Bounded by
+     * `MAX_OPTION_MATCH_VALUES`. The result's `match.complete` says whether
+     * absence from the returned options proves no match. Scalars only; see
+     * `parseOptionMatchValues`.
+     */
+    matchValues?: Array<string | number | boolean>;
     inputs?: SemaphorInputBinding[];
     derivedFields?: SemaphorDerivedFieldDefinition[];
 };
@@ -5422,11 +5431,24 @@ declare type SemaphorMetricIntent = {
 };
 
 declare type SemaphorOptionDependencies = {
-    mode?: 'independent' | 'explicit';
+    /** Omitted mode means independent for protocol callers. Dashboard authoring
+     * normalizes omission separately through `resolveDashboardOptionDependencies`. */
+    mode?: SemaphorOptionDependencyMode;
     includeInputIds?: string[];
     excludeInputIds?: string[];
+    /**
+     * Ephemeral browse override: explicit dependencies the viewer asked to
+     * browse without. Only valid in explicit mode, only for ids in
+     * `includeInputIds`, and only honored by the server when that dependency
+     * would otherwise fail with an overridable reason (see
+     * `OVERRIDABLE_OPTION_DEPENDENCY_REASONS`). Never persisted, never applied
+     * to card predicates; it lives in one browse request and its cache identity.
+     */
+    omitInputIds?: string[];
 };
 
+declare type SemaphorOptionDependencyMode = 'independent' | 'explicit' | 'all_applicable';
+
 declare type SemaphorOptionPopulation = {
     kind: 'option_source';
     baseSource?: never;

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

@@ -5340,6 +5340,15 @@ declare type SemaphorInputOptionsIntent = SemaphorInputOptionSource & {
     dependencies?: SemaphorOptionDependencies;
     search?: string;
     limit?: number;
+    /**
+     * Authoritative selected-value relevance check: return only options whose
+     * value is one of these exact raw values, under the same dependency and
+     * population context, with no search or paging. Bounded by
+     * `MAX_OPTION_MATCH_VALUES`. The result's `match.complete` says whether
+     * absence from the returned options proves no match. Scalars only; see
+     * `parseOptionMatchValues`.
+     */
+    matchValues?: Array<string | number | boolean>;
     inputs?: SemaphorInputBinding[];
     derivedFields?: SemaphorDerivedFieldDefinition[];
 };
@@ -5394,11 +5403,24 @@ declare type SemaphorMetricIntent = {
 };
 
 declare type SemaphorOptionDependencies = {
-    mode?: 'independent' | 'explicit';
+    /** Omitted mode means independent for protocol callers. Dashboard authoring
+     * normalizes omission separately through `resolveDashboardOptionDependencies`. */
+    mode?: SemaphorOptionDependencyMode;
     includeInputIds?: string[];
     excludeInputIds?: string[];
+    /**
+     * Ephemeral browse override: explicit dependencies the viewer asked to
+     * browse without. Only valid in explicit mode, only for ids in
+     * `includeInputIds`, and only honored by the server when that dependency
+     * would otherwise fail with an overridable reason (see
+     * `OVERRIDABLE_OPTION_DEPENDENCY_REASONS`). Never persisted, never applied
+     * to card predicates; it lives in one browse request and its cache identity.
+     */
+    omitInputIds?: string[];
 };
 
+declare type SemaphorOptionDependencyMode = 'independent' | 'explicit' | 'all_applicable';
+
 declare type SemaphorOptionPopulation = {
     kind: 'option_source';
     baseSource?: never;

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

@@ -4845,6 +4845,15 @@ declare type SemaphorInputOptionsIntent = SemaphorInputOptionSource & {
     dependencies?: SemaphorOptionDependencies;
     search?: string;
     limit?: number;
+    /**
+     * Authoritative selected-value relevance check: return only options whose
+     * value is one of these exact raw values, under the same dependency and
+     * population context, with no search or paging. Bounded by
+     * `MAX_OPTION_MATCH_VALUES`. The result's `match.complete` says whether
+     * absence from the returned options proves no match. Scalars only; see
+     * `parseOptionMatchValues`.
+     */
+    matchValues?: Array<string | number | boolean>;
     inputs?: SemaphorInputBinding[];
     derivedFields?: SemaphorDerivedFieldDefinition[];
 };
@@ -4949,11 +4958,24 @@ declare type SemaphorMetricQuerySpec = SemaphorQuerySourceSpec & SemaphorAppDeri
 declare type SemaphorNonEmptyArray<T> = [T, ...T[]];
 
 declare type SemaphorOptionDependencies = {
-    mode?: 'independent' | 'explicit';
+    /** Omitted mode means independent for protocol callers. Dashboard authoring
+     * normalizes omission separately through `resolveDashboardOptionDependencies`. */
+    mode?: SemaphorOptionDependencyMode;
     includeInputIds?: string[];
     excludeInputIds?: string[];
+    /**
+     * Ephemeral browse override: explicit dependencies the viewer asked to
+     * browse without. Only valid in explicit mode, only for ids in
+     * `includeInputIds`, and only honored by the server when that dependency
+     * would otherwise fail with an overridable reason (see
+     * `OVERRIDABLE_OPTION_DEPENDENCY_REASONS`). Never persisted, never applied
+     * to card predicates; it lives in one browse request and its cache identity.
+     */
+    omitInputIds?: string[];
 };
 
+declare type SemaphorOptionDependencyMode = 'independent' | 'explicit' | 'all_applicable';
+
 declare type SemaphorOptionPopulation = {
     kind: 'option_source';
     baseSource?: never;

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

@@ -8217,6 +8217,15 @@ declare type SemaphorInputOptionsIntent = SemaphorInputOptionSource & {
     dependencies?: SemaphorOptionDependencies;
     search?: string;
     limit?: number;
+    /**
+     * Authoritative selected-value relevance check: return only options whose
+     * value is one of these exact raw values, under the same dependency and
+     * population context, with no search or paging. Bounded by
+     * `MAX_OPTION_MATCH_VALUES`. The result's `match.complete` says whether
+     * absence from the returned options proves no match. Scalars only; see
+     * `parseOptionMatchValues`.
+     */
+    matchValues?: Array<string | number | boolean>;
     inputs?: SemaphorInputBinding[];
     derivedFields?: SemaphorDerivedFieldDefinition[];
 };
@@ -8253,6 +8262,9 @@ declare type SemaphorInputOptionsQuerySpec = Omit<SemaphorQuerySourceSpec, 'sour
 
 declare type SemaphorInputOptionsResult = SemaphorAnalyticsResultBase & {
     kind: 'inputOptions';
+    dependencyOutcomes?: SemaphorOptionDependencyOutcome[];
+    /** Present when the intent carried `matchValues`. */
+    match?: SemaphorOptionMatchResult;
     options: Array<{
         label: string;
         value: unknown;
@@ -8357,9 +8369,42 @@ declare type SemaphorMetricResult = SemaphorAnalyticsResultBase & {
 declare type SemaphorNonEmptyArray<T> = [T, ...T[]];
 
 declare type SemaphorOptionDependencies = {
-    mode?: 'independent' | 'explicit';
+    /** Omitted mode means independent for protocol callers. Dashboard authoring
+     * normalizes omission separately through `resolveDashboardOptionDependencies`. */
+    mode?: SemaphorOptionDependencyMode;
     includeInputIds?: string[];
     excludeInputIds?: string[];
+    /**
+     * Ephemeral browse override: explicit dependencies the viewer asked to
+     * browse without. Only valid in explicit mode, only for ids in
+     * `includeInputIds`, and only honored by the server when that dependency
+     * would otherwise fail with an overridable reason (see
+     * `OVERRIDABLE_OPTION_DEPENDENCY_REASONS`). Never persisted, never applied
+     * to card predicates; it lives in one browse request and its cache identity.
+     */
+    omitInputIds?: string[];
+};
+
+declare type SemaphorOptionDependencyMode = 'independent' | 'explicit' | 'all_applicable';
+
+/** Per-candidate classification of an option query's dependencies. Describes
+ * which viewer selections constrained the option list; it never substitutes
+ * for execution success or failure. */
+declare type SemaphorOptionDependencyOutcome = {
+    inputId: string;
+    status: SemaphorOptionDependencyOutcomeStatus;
+    reason?: SemaphorOptionDependencyOutcomeReason;
+};
+
+declare type SemaphorOptionDependencyOutcomeReason = 'unrelated' | 'population_required' | 'missing_dependency' | 'missing_relationship' | 'ambiguous_relationship' | 'invalid_metadata' | 'unsupported_dependency' | 'override_not_eligible';
+
+declare type SemaphorOptionDependencyOutcomeStatus = 'applied' | 'inactive' | 'skipped' | 'overridden' | 'error';
+
+declare type SemaphorOptionMatchResult = {
+    /** True only when every submitted value was evaluated by a complete exact
+     * check; only then may absence be read as `no_match`. */
+    complete: boolean;
+    reason?: 'unsupported' | 'truncated';
 };
 
 declare type SemaphorOptionPopulation = {

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

@@ -32781,6 +32781,15 @@ declare type SemaphorInputOptionsIntent = SemaphorInputOptionSource & {
     dependencies?: SemaphorOptionDependencies;
     search?: string;
     limit?: number;
+    /**
+     * Authoritative selected-value relevance check: return only options whose
+     * value is one of these exact raw values, under the same dependency and
+     * population context, with no search or paging. Bounded by
+     * `MAX_OPTION_MATCH_VALUES`. The result's `match.complete` says whether
+     * absence from the returned options proves no match. Scalars only; see
+     * `parseOptionMatchValues`.
+     */
+    matchValues?: Array<string | number | boolean>;
     inputs?: SemaphorInputBinding[];
     derivedFields?: SemaphorDerivedFieldDefinition[];
 };
@@ -32797,6 +32806,11 @@ export declare type SemaphorInputOptionSource = {
 
 export declare type SemaphorInputOptionsPayload = {
     options: SemaphorInputOption[];
+    /** Per-dependency classification for the option query; see
+     * `SemaphorOptionDependencyOutcome`. Absent when no dependencies applied. */
+    dependencyOutcomes?: SemaphorOptionDependencyOutcome[];
+    /** Authoritative exact-value relevance result when the request asked for it. */
+    match?: SemaphorOptionMatchResult;
     executionResult?: SemaphorAnalyticsExecutionResult;
 };
 
@@ -32829,6 +32843,9 @@ export declare type SemaphorInputOptionsQuerySpec = Omit<SemaphorQuerySourceSpec
 
 declare type SemaphorInputOptionsResult = SemaphorAnalyticsResultBase & {
     kind: 'inputOptions';
+    dependencyOutcomes?: SemaphorOptionDependencyOutcome[];
+    /** Present when the intent carried `matchValues`. */
+    match?: SemaphorOptionMatchResult;
     options: Array<{
         label: string;
         value: unknown;
@@ -32965,9 +32982,42 @@ declare type SemaphorMetricResult = SemaphorAnalyticsResultBase & {
 export declare type SemaphorNonEmptyArray<T> = [T, ...T[]];
 
 export declare type SemaphorOptionDependencies = {
-    mode?: 'independent' | 'explicit';
+    /** Omitted mode means independent for protocol callers. Dashboard authoring
+     * normalizes omission separately through `resolveDashboardOptionDependencies`. */
+    mode?: SemaphorOptionDependencyMode;
     includeInputIds?: string[];
     excludeInputIds?: string[];
+    /**
+     * Ephemeral browse override: explicit dependencies the viewer asked to
+     * browse without. Only valid in explicit mode, only for ids in
+     * `includeInputIds`, and only honored by the server when that dependency
+     * would otherwise fail with an overridable reason (see
+     * `OVERRIDABLE_OPTION_DEPENDENCY_REASONS`). Never persisted, never applied
+     * to card predicates; it lives in one browse request and its cache identity.
+     */
+    omitInputIds?: string[];
+};
+
+declare type SemaphorOptionDependencyMode = 'independent' | 'explicit' | 'all_applicable';
+
+/** Per-candidate classification of an option query's dependencies. Describes
+ * which viewer selections constrained the option list; it never substitutes
+ * for execution success or failure. */
+declare type SemaphorOptionDependencyOutcome = {
+    inputId: string;
+    status: SemaphorOptionDependencyOutcomeStatus;
+    reason?: SemaphorOptionDependencyOutcomeReason;
+};
+
+declare type SemaphorOptionDependencyOutcomeReason = 'unrelated' | 'population_required' | 'missing_dependency' | 'missing_relationship' | 'ambiguous_relationship' | 'invalid_metadata' | 'unsupported_dependency' | 'override_not_eligible';
+
+declare type SemaphorOptionDependencyOutcomeStatus = 'applied' | 'inactive' | 'skipped' | 'overridden' | 'error';
+
+declare type SemaphorOptionMatchResult = {
+    /** True only when every submitted value was evaluated by a complete exact
+     * check; only then may absence be read as `no_match`. */
+    complete: boolean;
+    reason?: 'unsupported' | 'truncated';
 };
 
 export declare type SemaphorOptionPopulation = {

package/dist/types/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("../chunks/common-types-nBuCd3u2.cjs"),e=require("../chunks/validators-CueUwVE4.cjs"),l=require("../chunks/token-types-CsKRtJp0.cjs"),E=require("../chunks/pivot-result-identity-Hm1sO9KE.cjs"),a=require("../chunks/report-runtime-context-C-As8sq_.cjs");exports.CONTROL_CARD_DEFAULT_VALUE=t.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=t.EMPTY_SELECTION;exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;exports.LEGACY_CALCULATED_FIELD_ENTITY_MARKER=e.LEGACY_CALCULATED_FIELD_ENTITY_MARKER;exports.PivotMarkerEnum=e.PivotMarkerEnum;exports.getFieldRuntimeColumnName=e.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=e.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=e.hasCalculatedFormulaInputs;exports.hasSyntheticCalculatedFieldOwner=e.hasSyntheticCalculatedFieldOwner;exports.isCalculatedDimension=e.isCalculatedDimension;exports.isCalculatedField=e.isCalculatedField;exports.isCalculatedMetric=e.isCalculatedMetric;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=l.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.resolveQueryColumnKeyMapEntry=E.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=E.resolveUniqueQueryColumnKeyMapEntry;exports.DEFAULT_CALENDAR_CONTEXT=a.DEFAULT_CALENDAR_CONTEXT;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("../chunks/common-types-nBuCd3u2.cjs"),e=require("../chunks/validators-ux2obZB9.cjs"),l=require("../chunks/token-types-CkAGFhiW.cjs"),E=require("../chunks/pivot-result-identity-DEenUrMj.cjs"),a=require("../chunks/report-runtime-context-lSIvyKm2.cjs");exports.CONTROL_CARD_DEFAULT_VALUE=t.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=t.EMPTY_SELECTION;exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;exports.LEGACY_CALCULATED_FIELD_ENTITY_MARKER=e.LEGACY_CALCULATED_FIELD_ENTITY_MARKER;exports.PivotMarkerEnum=e.PivotMarkerEnum;exports.getFieldRuntimeColumnName=e.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=e.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=e.hasCalculatedFormulaInputs;exports.hasSyntheticCalculatedFieldOwner=e.hasSyntheticCalculatedFieldOwner;exports.isCalculatedDimension=e.isCalculatedDimension;exports.isCalculatedField=e.isCalculatedField;exports.isCalculatedMetric=e.isCalculatedMetric;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=l.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.resolveQueryColumnKeyMapEntry=E.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=E.resolveUniqueQueryColumnKeyMapEntry;exports.DEFAULT_CALENDAR_CONTEXT=a.DEFAULT_CALENDAR_CONTEXT;

package/dist/types/index.js

@@ -1,8 +1,8 @@
 import { C as s, E } from "../chunks/common-types-C6cAQgyh.js";
-import { C, D as l, L as t, P as A, g as o, c as _, h as T, d as u, a as L, b as i, i as D } from "../chunks/validators-DgmJaRF4.js";
-import { D as n } from "../chunks/token-types-DpYncMPp.js";
-import { r as F, a as M } from "../chunks/pivot-result-identity-BDntll93.js";
-import { D as N } from "../chunks/report-runtime-context-DTxVBKqP.js";
+import { C, D as l, L as t, P as A, g as o, c as _, h as T, d as u, a as L, b as i, i as D } from "../chunks/validators-D-_IT-Xw.js";
+import { D as n } from "../chunks/token-types-BIYFAsGq.js";
+import { r as F, a as M } from "../chunks/pivot-result-identity-sZc1RaIz.js";
+import { D as N } from "../chunks/report-runtime-context-BlDpc-F-.js";
 export {
   C as CALCULATED_FIELD_ENTITY_MARKER,
   s as CONTROL_CARD_DEFAULT_VALUE,