react-semaphor 0.1.494 → 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;
 };
 
@@ -8455,6 +8516,15 @@ declare interface Field {
      * Human-friendly, localizable display name for the UI (table headers, chart axes, etc.).
      */
     label: string;
+    /**
+     * Set only when `label` was synthesized from `name` because the source
+     * provided no authored label (raw database objects). Field pickers follow
+     * the naming rule in `@/lib/fields/field-display`: an authored semantic
+     * label is shown as is, otherwise the physical column name. A field whose
+     * `label` still equals `derivedLabel` has no authored label; any later
+     * edit to `label` makes it authored without touching this marker.
+     */
+    derivedLabel?: string;
     /**
      * Unique, stable, machine-friendly reference name for SQL (AS alias), exports, and scripting.
      * If not provided, should be auto-generated from label or name.
@@ -9564,6 +9634,8 @@ declare type NormalizedFilterDashboardInput = FilterDashboardInputBase & {
     kind: 'filter';
     filter: TFilter;
     optionSource?: DashboardFilterOptionSource;
+    optionDependencies?: DashboardFilterOptionDependencies;
+    optionPopulation?: DashboardFilterOptionPopulation;
     application?: DashboardFilterApplication;
     definitionOrigin: 'embedded' | 'dashboardFilter';
 };
@@ -11294,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;
@@ -11310,6 +11390,8 @@ declare type ReferencedFilterDashboardInput = FilterDashboardInputBase & {
         filterId: string;
     };
     optionSource?: DashboardFilterOptionSource;
+    optionDependencies?: DashboardFilterOptionDependencies;
+    optionPopulation?: DashboardFilterOptionPopulation;
     application?: DashboardFilterApplication;
 };
 
@@ -11400,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
@@ -11482,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;
@@ -11627,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[];
 };
@@ -11702,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;
@@ -15094,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;
 };
 
@@ -5137,6 +5149,15 @@ declare interface Field {
      * Human-friendly, localizable display name for the UI (table headers, chart axes, etc.).
      */
     label: string;
+    /**
+     * Set only when `label` was synthesized from `name` because the source
+     * provided no authored label (raw database objects). Field pickers follow
+     * the naming rule in `@/lib/fields/field-display`: an authored semantic
+     * label is shown as is, otherwise the physical column name. A field whose
+     * `label` still equals `derivedLabel` has no authored label; any later
+     * edit to `label` makes it authored without touching this marker.
+     */
+    derivedLabel?: string;
     /**
      * Unique, stable, machine-friendly reference name for SQL (AS alias), exports, and scripting.
      * If not provided, should be auto-generated from label or name.
@@ -5900,6 +5921,8 @@ export declare type NormalizedFilterDashboardInput = FilterDashboardInputBase &
     kind: 'filter';
     filter: TFilter;
     optionSource?: DashboardFilterOptionSource;
+    optionDependencies?: DashboardFilterOptionDependencies;
+    optionPopulation?: DashboardFilterOptionPopulation;
     application?: DashboardFilterApplication;
     definitionOrigin: 'embedded' | 'dashboardFilter';
 };
@@ -7667,6 +7690,8 @@ export declare type ReferencedFilterDashboardInput = FilterDashboardInputBase &
         filterId: string;
     };
     optionSource?: DashboardFilterOptionSource;
+    optionDependencies?: DashboardFilterOptionDependencies;
+    optionPopulation?: DashboardFilterOptionPopulation;
     application?: DashboardFilterApplication;
 };
 
@@ -7957,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

@@ -4111,6 +4111,15 @@ declare interface Field {
      * Human-friendly, localizable display name for the UI (table headers, chart axes, etc.).
      */
     label: string;
+    /**
+     * Set only when `label` was synthesized from `name` because the source
+     * provided no authored label (raw database objects). Field pickers follow
+     * the naming rule in `@/lib/fields/field-display`: an authored semantic
+     * label is shown as is, otherwise the physical column name. A field whose
+     * `label` still equals `derivedLabel` has no authored label; any later
+     * edit to `label` makes it authored without touching this marker.
+     */
+    derivedLabel?: string;
     /**
      * Unique, stable, machine-friendly reference name for SQL (AS alias), exports, and scripting.
      * If not provided, should be auto-generated from label or name.
@@ -4491,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[];
 };
@@ -4543,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

@@ -3620,6 +3620,15 @@ declare interface Field {
      * Human-friendly, localizable display name for the UI (table headers, chart axes, etc.).
      */
     label: string;
+    /**
+     * Set only when `label` was synthesized from `name` because the source
+     * provided no authored label (raw database objects). Field pickers follow
+     * the naming rule in `@/lib/fields/field-display`: an authored semantic
+     * label is shown as is, otherwise the physical column name. A field whose
+     * `label` still equals `derivedLabel` has no authored label; any later
+     * edit to `label` makes it authored without touching this marker.
+     */
+    derivedLabel?: string;
     /**
      * Unique, stable, machine-friendly reference name for SQL (AS alias), exports, and scripting.
      * If not provided, should be auto-generated from label or name.
@@ -5359,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[];
 };
@@ -5413,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

@@ -3618,6 +3618,15 @@ declare interface Field {
      * Human-friendly, localizable display name for the UI (table headers, chart axes, etc.).
      */
     label: string;
+    /**
+     * Set only when `label` was synthesized from `name` because the source
+     * provided no authored label (raw database objects). Field pickers follow
+     * the naming rule in `@/lib/fields/field-display`: an authored semantic
+     * label is shown as is, otherwise the physical column name. A field whose
+     * `label` still equals `derivedLabel` has no authored label; any later
+     * edit to `label` makes it authored without touching this marker.
+     */
+    derivedLabel?: string;
     /**
      * Unique, stable, machine-friendly reference name for SQL (AS alias), exports, and scripting.
      * If not provided, should be auto-generated from label or name.
@@ -5331,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[];
 };
@@ -5385,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

@@ -3586,6 +3586,15 @@ declare interface Field {
      * Human-friendly, localizable display name for the UI (table headers, chart axes, etc.).
      */
     label: string;
+    /**
+     * Set only when `label` was synthesized from `name` because the source
+     * provided no authored label (raw database objects). Field pickers follow
+     * the naming rule in `@/lib/fields/field-display`: an authored semantic
+     * label is shown as is, otherwise the physical column name. A field whose
+     * `label` still equals `derivedLabel` has no authored label; any later
+     * edit to `label` makes it authored without touching this marker.
+     */
+    derivedLabel?: string;
     /**
      * Unique, stable, machine-friendly reference name for SQL (AS alias), exports, and scripting.
      * If not provided, should be auto-generated from label or name.
@@ -4836,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[];
 };
@@ -4940,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

@@ -3586,6 +3586,15 @@ declare interface Field {
      * Human-friendly, localizable display name for the UI (table headers, chart axes, etc.).
      */
     label: string;
+    /**
+     * Set only when `label` was synthesized from `name` because the source
+     * provided no authored label (raw database objects). Field pickers follow
+     * the naming rule in `@/lib/fields/field-display`: an authored semantic
+     * label is shown as is, otherwise the physical column name. A field whose
+     * `label` still equals `derivedLabel` has no authored label; any later
+     * edit to `label` makes it authored without touching this marker.
+     */
+    derivedLabel?: string;
     /**
      * Unique, stable, machine-friendly reference name for SQL (AS alias), exports, and scripting.
      * If not provided, should be auto-generated from label or name.
@@ -8208,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[];
 };
@@ -8244,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;
@@ -8348,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 = {