npm - react-semaphor - Versions diffs - 0.1.495 → 0.1.497 - Mend

react-semaphor 0.1.495 → 0.1.497

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (127) hide show

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

@@ -16,7 +16,7 @@ declare const aggregateMeasureSchema: z.ZodObject<{
     field: {
         name: string;
         label?: string | undefined;
-        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
         source?: {
             kind: "semantic";
@@ -40,7 +40,7 @@ declare const aggregateMeasureSchema: z.ZodObject<{
             label: string;
             name: string;
             dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-            resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+            resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
             computeStage: "aggregate" | "row";
             expression: string;
             inputs: Record<string, {
@@ -48,7 +48,7 @@ declare const aggregateMeasureSchema: z.ZodObject<{
                 field: {
                     name: string;
                     label?: string | undefined;
-                    role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                    role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                     dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                     source?: {
                         kind: "semantic";
@@ -122,7 +122,7 @@ declare const aggregateMeasureSchema: z.ZodObject<{
     field: {
         name: string;
         label?: string | undefined;
-        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
         source?: {
             kind: "semantic";
@@ -146,7 +146,7 @@ declare const aggregateMeasureSchema: z.ZodObject<{
             label: string;
             name: string;
             dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-            resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+            resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
             computeStage: "aggregate" | "row";
             expression: string;
             inputs: Record<string, {
@@ -154,7 +154,7 @@ declare const aggregateMeasureSchema: z.ZodObject<{
                 field: {
                     name: string;
                     label?: string | undefined;
-                    role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                    role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                     dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                     source?: {
                         kind: "semantic";
@@ -866,7 +866,7 @@ declare const analyticalIntentShape: z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -890,7 +890,7 @@ declare const analyticalIntentShape: z.ZodObject<{
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -898,7 +898,7 @@ declare const analyticalIntentShape: z.ZodObject<{
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -974,7 +974,7 @@ declare const analyticalIntentShape: z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -998,7 +998,7 @@ declare const analyticalIntentShape: z.ZodObject<{
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -1006,7 +1006,7 @@ declare const analyticalIntentShape: z.ZodObject<{
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -1081,7 +1081,7 @@ declare const analyticalIntentShape: z.ZodObject<{
             label: string;
             name: string;
             dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-            resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+            resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
             computeStage: "aggregate" | "row";
             expression: string;
             inputs: Record<string, {
@@ -1089,7 +1089,7 @@ declare const analyticalIntentShape: z.ZodObject<{
                 field: {
                     name: string;
                     label?: string | undefined;
-                    role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                    role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                     dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                     source?: {
                         kind: "semantic";
@@ -1161,7 +1161,7 @@ declare const analyticalIntentShape: z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -1185,7 +1185,7 @@ declare const analyticalIntentShape: z.ZodObject<{
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -1193,7 +1193,7 @@ declare const analyticalIntentShape: z.ZodObject<{
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -1359,7 +1359,7 @@ declare const analyticalIntentShape: z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -1383,7 +1383,7 @@ declare const analyticalIntentShape: z.ZodObject<{
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -1391,7 +1391,7 @@ declare const analyticalIntentShape: z.ZodObject<{
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -1467,7 +1467,7 @@ declare const analyticalIntentShape: z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -1491,7 +1491,7 @@ declare const analyticalIntentShape: z.ZodObject<{
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -1499,7 +1499,7 @@ declare const analyticalIntentShape: z.ZodObject<{
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -1574,7 +1574,7 @@ declare const analyticalIntentShape: z.ZodObject<{
             label: string;
             name: string;
             dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-            resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+            resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
             computeStage: "aggregate" | "row";
             expression: string;
             inputs: Record<string, {
@@ -1582,7 +1582,7 @@ declare const analyticalIntentShape: z.ZodObject<{
                 field: {
                     name: string;
                     label?: string | undefined;
-                    role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                    role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                     dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                     source?: {
                         kind: "semantic";
@@ -1654,7 +1654,7 @@ declare const analyticalIntentShape: z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -1678,7 +1678,7 @@ declare const analyticalIntentShape: z.ZodObject<{
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -1686,7 +1686,7 @@ declare const analyticalIntentShape: z.ZodObject<{
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -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 = {
@@ -2176,7 +2183,7 @@ declare const calculatedMeasureSchema: z.ZodObject<{
             }, "strict", z.ZodTypeAny, {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -2199,7 +2206,7 @@ declare const calculatedMeasureSchema: z.ZodObject<{
             }, {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -2226,7 +2233,7 @@ declare const calculatedMeasureSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -2253,7 +2260,7 @@ declare const calculatedMeasureSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -2281,7 +2288,7 @@ declare const calculatedMeasureSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -2289,7 +2296,7 @@ declare const calculatedMeasureSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -2359,7 +2366,7 @@ declare const calculatedMeasureSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -2367,7 +2374,7 @@ declare const calculatedMeasureSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -2437,7 +2444,7 @@ declare const calculatedMeasureSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -2445,7 +2452,7 @@ declare const calculatedMeasureSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -2515,7 +2522,7 @@ declare const calculatedMeasureSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -2523,7 +2530,7 @@ declare const calculatedMeasureSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -2597,7 +2604,7 @@ declare const calculatedMeasureSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -2605,7 +2612,7 @@ declare const calculatedMeasureSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -2679,7 +2686,7 @@ declare const calculatedMeasureSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -2687,7 +2694,7 @@ declare const calculatedMeasureSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -3402,7 +3409,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
             }, "strict", z.ZodTypeAny, {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -3425,7 +3432,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
             }, {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -3452,7 +3459,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -3479,7 +3486,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -3507,7 +3514,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -3515,7 +3522,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -3585,7 +3592,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -3593,7 +3600,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -3663,7 +3670,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -3671,7 +3678,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -3741,7 +3748,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -3749,7 +3756,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -3818,7 +3825,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     name: string;
     label?: string | undefined;
-    role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+    role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
     dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
     source?: {
         kind: "semantic";
@@ -3843,7 +3850,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -3851,7 +3858,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -3920,7 +3927,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
 }, {
     name: string;
     label?: string | undefined;
-    role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+    role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
     dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
     source?: {
         kind: "semantic";
@@ -3945,7 +3952,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -3953,7 +3960,7 @@ declare const configExecutionFieldSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -4271,7 +4278,7 @@ declare const configShape: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -4295,7 +4302,7 @@ declare const configShape: z.ZodObject<{
                     label: string;
                     name: string;
                     dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                    resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                    resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                     computeStage: "aggregate" | "row";
                     expression: string;
                     inputs: Record<string, {
@@ -4303,7 +4310,7 @@ declare const configShape: z.ZodObject<{
                         field: {
                             name: string;
                             label?: string | undefined;
-                            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                             source?: {
                                 kind: "semantic";
@@ -4379,7 +4386,7 @@ declare const configShape: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -4403,7 +4410,7 @@ declare const configShape: z.ZodObject<{
                     label: string;
                     name: string;
                     dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                    resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                    resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                     computeStage: "aggregate" | "row";
                     expression: string;
                     inputs: Record<string, {
@@ -4411,7 +4418,7 @@ declare const configShape: z.ZodObject<{
                         field: {
                             name: string;
                             label?: string | undefined;
-                            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                             source?: {
                                 kind: "semantic";
@@ -4486,7 +4493,7 @@ declare const configShape: z.ZodObject<{
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -4494,7 +4501,7 @@ declare const configShape: z.ZodObject<{
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -4566,7 +4573,7 @@ declare const configShape: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -4590,7 +4597,7 @@ declare const configShape: z.ZodObject<{
                     label: string;
                     name: string;
                     dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                    resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                    resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                     computeStage: "aggregate" | "row";
                     expression: string;
                     inputs: Record<string, {
@@ -4598,7 +4605,7 @@ declare const configShape: z.ZodObject<{
                         field: {
                             name: string;
                             label?: string | undefined;
-                            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                             source?: {
                                 kind: "semantic";
@@ -5028,7 +5035,7 @@ declare const configShape: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -5052,7 +5059,7 @@ declare const configShape: z.ZodObject<{
                     label: string;
                     name: string;
                     dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                    resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                    resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                     computeStage: "aggregate" | "row";
                     expression: string;
                     inputs: Record<string, {
@@ -5060,7 +5067,7 @@ declare const configShape: z.ZodObject<{
                         field: {
                             name: string;
                             label?: string | undefined;
-                            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                             source?: {
                                 kind: "semantic";
@@ -5136,7 +5143,7 @@ declare const configShape: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -5160,7 +5167,7 @@ declare const configShape: z.ZodObject<{
                     label: string;
                     name: string;
                     dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                    resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                    resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                     computeStage: "aggregate" | "row";
                     expression: string;
                     inputs: Record<string, {
@@ -5168,7 +5175,7 @@ declare const configShape: z.ZodObject<{
                         field: {
                             name: string;
                             label?: string | undefined;
-                            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                             source?: {
                                 kind: "semantic";
@@ -5243,7 +5250,7 @@ declare const configShape: z.ZodObject<{
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -5251,7 +5258,7 @@ declare const configShape: z.ZodObject<{
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -5323,7 +5330,7 @@ declare const configShape: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -5347,7 +5354,7 @@ declare const configShape: z.ZodObject<{
                     label: string;
                     name: string;
                     dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                    resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                    resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                     computeStage: "aggregate" | "row";
                     expression: string;
                     inputs: Record<string, {
@@ -5355,7 +5362,7 @@ declare const configShape: z.ZodObject<{
                         field: {
                             name: string;
                             label?: string | undefined;
-                            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                             source?: {
                                 kind: "semantic";
@@ -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;
@@ -6436,7 +6495,7 @@ declare const definitionInputShape: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -6460,7 +6519,7 @@ declare const definitionInputShape: z.ZodObject<{
                     label: string;
                     name: string;
                     dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                    resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                    resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                     computeStage: "aggregate" | "row";
                     expression: string;
                     inputs: Record<string, {
@@ -6468,7 +6527,7 @@ declare const definitionInputShape: z.ZodObject<{
                         field: {
                             name: string;
                             label?: string | undefined;
-                            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                             source?: {
                                 kind: "semantic";
@@ -6544,7 +6603,7 @@ declare const definitionInputShape: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -6568,7 +6627,7 @@ declare const definitionInputShape: z.ZodObject<{
                     label: string;
                     name: string;
                     dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                    resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                    resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                     computeStage: "aggregate" | "row";
                     expression: string;
                     inputs: Record<string, {
@@ -6576,7 +6635,7 @@ declare const definitionInputShape: z.ZodObject<{
                         field: {
                             name: string;
                             label?: string | undefined;
-                            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                             source?: {
                                 kind: "semantic";
@@ -6651,7 +6710,7 @@ declare const definitionInputShape: z.ZodObject<{
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -6659,7 +6718,7 @@ declare const definitionInputShape: z.ZodObject<{
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -6731,7 +6790,7 @@ declare const definitionInputShape: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -6755,7 +6814,7 @@ declare const definitionInputShape: z.ZodObject<{
                     label: string;
                     name: string;
                     dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                    resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                    resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                     computeStage: "aggregate" | "row";
                     expression: string;
                     inputs: Record<string, {
@@ -6763,7 +6822,7 @@ declare const definitionInputShape: z.ZodObject<{
                         field: {
                             name: string;
                             label?: string | undefined;
-                            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                             source?: {
                                 kind: "semantic";
@@ -7279,7 +7338,7 @@ declare const definitionInputShape: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -7303,7 +7362,7 @@ declare const definitionInputShape: z.ZodObject<{
                     label: string;
                     name: string;
                     dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                    resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                    resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                     computeStage: "aggregate" | "row";
                     expression: string;
                     inputs: Record<string, {
@@ -7311,7 +7370,7 @@ declare const definitionInputShape: z.ZodObject<{
                         field: {
                             name: string;
                             label?: string | undefined;
-                            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                             source?: {
                                 kind: "semantic";
@@ -7387,7 +7446,7 @@ declare const definitionInputShape: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -7411,7 +7470,7 @@ declare const definitionInputShape: z.ZodObject<{
                     label: string;
                     name: string;
                     dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                    resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                    resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                     computeStage: "aggregate" | "row";
                     expression: string;
                     inputs: Record<string, {
@@ -7419,7 +7478,7 @@ declare const definitionInputShape: z.ZodObject<{
                         field: {
                             name: string;
                             label?: string | undefined;
-                            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                             source?: {
                                 kind: "semantic";
@@ -7494,7 +7553,7 @@ declare const definitionInputShape: z.ZodObject<{
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -7502,7 +7561,7 @@ declare const definitionInputShape: z.ZodObject<{
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -7574,7 +7633,7 @@ declare const definitionInputShape: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -7598,7 +7657,7 @@ declare const definitionInputShape: z.ZodObject<{
                     label: string;
                     name: string;
                     dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                    resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                    resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                     computeStage: "aggregate" | "row";
                     expression: string;
                     inputs: Record<string, {
@@ -7606,7 +7665,7 @@ declare const definitionInputShape: z.ZodObject<{
                         field: {
                             name: string;
                             label?: string | undefined;
-                            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                             source?: {
                                 kind: "semantic";
@@ -8254,6 +8313,8 @@ declare type EmbeddedFilterDashboardInput = FilterDashboardInputBase & {
     filter: TFilter;
     filterReference?: never;
     optionSource?: DashboardFilterOptionSource;
+    optionDependencies?: DashboardFilterOptionDependencies;
+    optionPopulation?: DashboardFilterOptionPopulation;
     application?: DashboardFilterApplication;
 };
@@ -8797,7 +8858,7 @@ export declare function getMatrixBindingTargets(spec: MatrixSpec, target: Contro
         field: {
             name: string;
             label?: string | undefined;
-            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -8821,7 +8882,7 @@ export declare function getMatrixBindingTargets(spec: MatrixSpec, target: Contro
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -8829,7 +8890,7 @@ export declare function getMatrixBindingTargets(spec: MatrixSpec, target: Contro
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -8906,7 +8967,7 @@ export declare function getMatrixBindingTargets(spec: MatrixSpec, target: Contro
         field: {
             name: string;
             label?: string | undefined;
-            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -8930,7 +8991,7 @@ export declare function getMatrixBindingTargets(spec: MatrixSpec, target: Contro
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -8938,7 +8999,7 @@ export declare function getMatrixBindingTargets(spec: MatrixSpec, target: Contro
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -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;
@@ -12501,7 +12622,7 @@ declare const specShape: z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -12525,7 +12646,7 @@ declare const specShape: z.ZodObject<{
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -12533,7 +12654,7 @@ declare const specShape: z.ZodObject<{
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -12609,7 +12730,7 @@ declare const specShape: z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -12633,7 +12754,7 @@ declare const specShape: z.ZodObject<{
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -12641,7 +12762,7 @@ declare const specShape: z.ZodObject<{
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -12716,7 +12837,7 @@ declare const specShape: z.ZodObject<{
             label: string;
             name: string;
             dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-            resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+            resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
             computeStage: "aggregate" | "row";
             expression: string;
             inputs: Record<string, {
@@ -12724,7 +12845,7 @@ declare const specShape: z.ZodObject<{
                 field: {
                     name: string;
                     label?: string | undefined;
-                    role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                    role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                     dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                     source?: {
                         kind: "semantic";
@@ -12796,7 +12917,7 @@ declare const specShape: z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -12820,7 +12941,7 @@ declare const specShape: z.ZodObject<{
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -12828,7 +12949,7 @@ declare const specShape: z.ZodObject<{
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -12993,7 +13114,7 @@ declare const specShape: z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -13017,7 +13138,7 @@ declare const specShape: z.ZodObject<{
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -13025,7 +13146,7 @@ declare const specShape: z.ZodObject<{
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -13101,7 +13222,7 @@ declare const specShape: z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -13125,7 +13246,7 @@ declare const specShape: z.ZodObject<{
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -13133,7 +13254,7 @@ declare const specShape: z.ZodObject<{
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -13208,7 +13329,7 @@ declare const specShape: z.ZodObject<{
             label: string;
             name: string;
             dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-            resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+            resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
             computeStage: "aggregate" | "row";
             expression: string;
             inputs: Record<string, {
@@ -13216,7 +13337,7 @@ declare const specShape: z.ZodObject<{
                 field: {
                     name: string;
                     label?: string | undefined;
-                    role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                    role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                     dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                     source?: {
                         kind: "semantic";
@@ -13288,7 +13409,7 @@ declare const specShape: z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -13312,7 +13433,7 @@ declare const specShape: z.ZodObject<{
                 label: string;
                 name: string;
                 dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-                resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
+                resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
                 computeStage: "aggregate" | "row";
                 expression: string;
                 inputs: Record<string, {
@@ -13320,7 +13441,7 @@ declare const specShape: z.ZodObject<{
                     field: {
                         name: string;
                         label?: string | undefined;
-                        role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
+                        role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
                         dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                         source?: {
                             kind: "semantic";
@@ -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 { }