react-semaphor 0.1.496 → 0.1.498

package/dist/types/types.d.ts

@@ -27,7 +27,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";
@@ -51,7 +51,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, {
@@ -59,7 +59,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";
@@ -133,7 +133,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";
@@ -157,7 +157,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, {
@@ -165,7 +165,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";
@@ -1121,7 +1121,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";
@@ -1144,7 +1144,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";
@@ -1171,7 +1171,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";
@@ -1198,7 +1198,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";
@@ -1226,7 +1226,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, {
@@ -1234,7 +1234,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";
@@ -1304,7 +1304,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, {
@@ -1312,7 +1312,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";
@@ -1382,7 +1382,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, {
@@ -1390,7 +1390,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";
@@ -1460,7 +1460,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, {
@@ -1468,7 +1468,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";
@@ -1542,7 +1542,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, {
@@ -1550,7 +1550,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";
@@ -1624,7 +1624,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, {
@@ -1632,7 +1632,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";
@@ -1897,6 +1897,16 @@ declare interface ClickFilterInteraction {
     label?: string;
 }
 
+export declare function collectDatasetNamesFromExplorerField(field: ExplorerField | null | undefined, datasets: Set<string>, visitedFields?: Set<string>, visitedGroups?: Set<string>, options?: DatasetCollectionOptions): void;
+
+export declare function collectDatasetNamesFromFilterGroup(filters: FilterGroup | null | undefined, datasets: Set<string>, visitedFields?: Set<string>, visitedGroups?: Set<string>, options?: DatasetCollectionOptions): void;
+
+export declare function collectExecutionDatasetNamesFromExplorerField(field: ExplorerField | null | undefined, datasets: Set<string>, visitedFields?: Set<string>, visitedGroups?: Set<string>): void;
+
+export declare function collectPreferredDatasetNamesFromExplorerField(field: ExplorerField | null | undefined, datasets: Set<string>): void;
+
+export declare function collectQualifiedDatasetNamesFromExplorerField(field: ExplorerField | null | undefined, datasets: Set<string>, visitedFields?: Set<string>, visitedGroups?: Set<string>): void;
+
 export declare type ColorConfig = {
     segments: Record<string, string>;
 };
@@ -2353,7 +2363,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";
@@ -2376,7 +2386,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";
@@ -2403,7 +2413,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";
@@ -2430,7 +2440,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";
@@ -2458,7 +2468,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, {
@@ -2466,7 +2476,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";
@@ -2536,7 +2546,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, {
@@ -2544,7 +2554,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";
@@ -2614,7 +2624,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, {
@@ -2622,7 +2632,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";
@@ -2692,7 +2702,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, {
@@ -2700,7 +2710,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";
@@ -2769,7 +2779,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";
@@ -2794,7 +2804,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, {
@@ -2802,7 +2812,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";
@@ -2871,7 +2881,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";
@@ -2896,7 +2906,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, {
@@ -2904,7 +2914,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";
@@ -3222,7 +3232,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";
@@ -3246,7 +3256,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, {
@@ -3254,7 +3264,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";
@@ -3330,7 +3340,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";
@@ -3354,7 +3364,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, {
@@ -3362,7 +3372,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";
@@ -3437,7 +3447,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, {
@@ -3445,7 +3455,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";
@@ -3517,7 +3527,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";
@@ -3541,7 +3551,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, {
@@ -3549,7 +3559,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";
@@ -3979,7 +3989,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";
@@ -4003,7 +4013,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, {
@@ -4011,7 +4021,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";
@@ -4087,7 +4097,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";
@@ -4111,7 +4121,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, {
@@ -4119,7 +4129,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";
@@ -4194,7 +4204,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, {
@@ -4202,7 +4212,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";
@@ -4274,7 +4284,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";
@@ -4298,7 +4308,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, {
@@ -4306,7 +4316,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";
@@ -4946,6 +4956,13 @@ export declare interface DataModelEntityReference extends DatabaseEntityReferenc
     description: string;
 }
 
+export declare type DatasetCollectionOptions = {
+    /** Include datasets referenced by metric filter conditions. Default true. */
+    includeMetricFilterDatasets?: boolean;
+    /** Emit `qualifiedEntityName` when it is dotted, otherwise `entityName`. Default false. */
+    preferQualifiedIdentity?: boolean;
+};
+
 export declare interface DatasetEntityReference extends DatabaseEntityReference {
     type: 'dataset';
     datasetType: 'physical' | 'virtual';
@@ -4959,6 +4976,14 @@ export declare interface DatasetEntityReference extends DatabaseEntityReference
     description?: string;
 }
 
+/**
+ * The dataset a shared analytics `source` ref names. Semantic sources are
+ * the dataset name; physical sources keep database/schema/table so distinct
+ * tables stay distinct. The single mapping for both the walker and the
+ * calculator's identity resolver.
+ */
+export declare function datasetRefFromSource(source: Field['source'] | undefined): FieldDatasetDependency | undefined;
+
 export declare interface DataSource {
     connectionId: string;
     semanticDomainId?: string;
@@ -5026,6 +5051,9 @@ export declare type DeleteBriefingRunResponse = {
     deletedRunId: string;
 };
 
+/** Best available identity for a dependency: name, else qualified name. */
+export declare function dependencyDisplayIdentity(dep: FieldDatasetDependency): string;
+
 /**
  * Field configuration for detail table columns.
  * Unlike GroupByField, DetailField does not support aggregation or granularity.
@@ -5725,6 +5753,41 @@ declare const expansionShape: z.ZodObject<{
     }[];
 }>;
 
+/**
+ * Field dependency resolution (shared by server planning and client UX)
+ * =====================================================================
+ *
+ * One question, answered in one place for every field representation:
+ *
+ *   "Which datasets does this field read from?"
+ *
+ * Consumers:
+ *   - semaphor-app query planning (join resolution, filter applicability,
+ *     fan-out analysis) via the `collect*` functions, which keep the
+ *     original server API and semantics.
+ *   - react-semaphor field availability ("usable in this chart") via
+ *     `resolveFieldDatasetDependencies`, which returns full dependency
+ *     objects with qualified identity.
+ *
+ * Representations handled, in order, by ONE walker:
+ *   1. A field owned by a real dataset is a leaf on that dataset, even when
+ *      it carries an expression (inline domain expressions, query-local
+ *      aliases). Synthetic owners (the calculated-field markers, the
+ *      `calculated_fields` group, or no owner) are never leaves.
+ *   2. `calculatedFormula.inputFields`: full Field objects, walked
+ *      recursively.
+ *   3. `derivedField.inputs[*].field.source`: the shared analytics contract,
+ *      used only when there are no formula inputs (both encode the same
+ *      inputs). Semantic sources resolve to the dataset name; physical
+ *      sources keep database/schema/table so `public.orders` and
+ *      `archive.orders` stay distinct. This is the only representation
+ *      Matrix-authored calculations may carry.
+ *   4. Metric filter conditions (`parameters.filters`), when requested.
+ *
+ * Adding a representation means adding it here, once.
+ */
+declare type ExplorerField = Field | GroupByField | MetricField;
+
 export declare type ExportDataPayload = {
     cardId: string;
     title: string;
@@ -5803,6 +5866,30 @@ export declare interface Field {
     fieldScope?: FieldScope;
 }
 
+export declare type FieldDatasetDependency = {
+    /**
+     * Dataset name as the catalog knows it (entityName / datasetName / table).
+     * Empty string when the source carried only a qualified name.
+     */
+    entityName: string;
+    entityId?: string;
+    /** Qualified identity when known (`schema.table`, `db.schema.table`, or the field's qualifiedEntityName). */
+    qualifiedEntityName?: string;
+    /** Human label when the source carried one. */
+    label?: string;
+};
+
+export declare type FieldDependencyResolution = {
+    /** Unique datasets, in first-seen order. */
+    datasets: FieldDatasetDependency[];
+    /**
+     * False when at least one input could not be traced to a dataset (for
+     * example a metric-to-metric reference that was not expanded into input
+     * fields). Callers must not claim the field is available in that case.
+     */
+    complete: boolean;
+};
+
 export declare type FieldScope = 'card' | 'sheet' | 'dashboard' | 'domain';
 
 declare type FileAttachment = {
@@ -6117,6 +6204,9 @@ export declare type HtmlOptions = {
     html: string;
 };
 
+/** Humanize a catalog dataset name for customer-facing copy. */
+export declare function humanizeDatasetName(name: string, labels?: Record<string, string>): string;
+
 declare interface InlineDrillEvent extends BaseInteractionEvent {
     interactionMode: 'inlineDrill';
     fetchMode?: 'lazy' | 'preloaded';
@@ -6295,6 +6385,15 @@ export declare function isCalculatedMetric(field: Field): field is MetricField &
     expression: string;
 };
 
+/**
+ * True for every representation of a derived (calculated) field:
+ * an expression, formula inputs, the shared-contract `derivedField`
+ * (the only shape Matrix-authored calculations may carry), or a synthetic
+ * calculated-field owner. Use this, not `isCalculatedField`, wherever the
+ * question is "is this computed rather than stored".
+ */
+export declare function isDerivedField(field: Field | null | undefined): boolean;
+
 export declare interface Join {
     id: string;
     source: DatabaseEntityReference;
@@ -8729,6 +8828,14 @@ declare type ResolvedValueFormatPreferenceSources = {
     defaultCurrency: ReportPreferenceSource;
 };
 
+/**
+ * Resolve the datasets a field reads from, with qualified identity.
+ * Base fields resolve to their own dataset; calculated fields resolve
+ * through their inputs. Metric filter datasets are not included: they do
+ * not affect whether the field itself can be added.
+ */
+export declare function resolveFieldDatasetDependencies(field: Field): FieldDependencyResolution;
+
 export declare function resolveQueryColumnKeyMapEntry(columnKeyMap: QueryColumnKeyMap_2 | undefined, fieldId: string, role: QueryColumnKeyRole): QueryColumnKeyMapEntry | undefined;
 
 export declare function resolveUniqueQueryColumnKeyMapEntry(columnKeyMap: QueryColumnKeyMap_2 | undefined, fieldId: string): QueryColumnKeyMapEntry | undefined;
@@ -9637,7 +9744,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";
@@ -9661,7 +9768,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, {
@@ -9669,7 +9776,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";
@@ -9745,7 +9852,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";
@@ -9769,7 +9876,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, {
@@ -9777,7 +9884,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";
@@ -9852,7 +9959,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, {
@@ -9860,7 +9967,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";
@@ -9932,7 +10039,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";
@@ -9956,7 +10063,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, {
@@ -9964,7 +10071,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";
@@ -10129,7 +10236,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";
@@ -10153,7 +10260,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, {
@@ -10161,7 +10268,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";
@@ -10237,7 +10344,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";
@@ -10261,7 +10368,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, {
@@ -10269,7 +10376,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";
@@ -10344,7 +10451,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, {
@@ -10352,7 +10459,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";
@@ -10424,7 +10531,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";
@@ -10448,7 +10555,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, {
@@ -10456,7 +10563,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";