react-semaphor 0.1.537 → 0.1.539

package/dist/types/shared/dashboard-authoring/control-execution-contract.d.ts

@@ -0,0 +1,1794 @@
+import { z } from 'zod';
+import { ControlBinding, ControlDefinition } from '../../lib/types/common-types.js';
+/**
+ * The execution contract of a card's controls: the definitions, bindings and
+ * values a query request carries, checked before the query runs. One owner
+ * for every reader: the query route and executor, CSV export, Matrix, the
+ * analytics agent's card replay (analytics agent Plan 1, ledger P3-78, P3-79).
+ * Typed by the package's own `ControlDefinition` and `ControlBinding`, so a
+ * binding the package authors is a binding the server accepts.
+ */
+/** A binding that only changes how values are shown: the control picks a currency. */
+export declare function isPresentationCurrencyBinding(binding: ControlBinding): binding is Extract<ControlBinding, {
+    target: 'presentation_currency';
+}>;
+/** A binding that changes the query's structure (fields, metrics, aggregation, grain). */
+export declare function isStructuralControlBinding(binding: ControlBinding): binding is Exclude<ControlBinding, {
+    target: 'sql_param' | 'presentation_currency';
+}>;
+export declare function isValidControlOptionPresentation(value: unknown): boolean;
+export declare const controlDefinitionExecutionSchema: z.ZodEffects<z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    scope: z.ZodEnum<["dashboard", "card"]>;
+    type: z.ZodEnum<["enum", "multi_enum", "text", "number", "boolean", "date", "field_selector", "metric_selector", "aggregation_selector", "grain_selector"]>;
+    source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"manual">;
+        options: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+            presentation: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+                granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+                format: z.ZodOptional<z.ZodType<import('../analytics-protocol/index.js').TemporalBucketFormat, z.ZodTypeDef, import('../analytics-protocol/index.js').TemporalBucketFormat>>;
+                dateFormat: z.ZodOptional<z.ZodString>;
+                customFormat: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                granularity?: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year" | undefined;
+                format?: import('../analytics-protocol/index.js').TemporalBucketFormat | undefined;
+                dateFormat?: string | undefined;
+                customFormat?: string | undefined;
+            }, {
+                granularity?: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year" | undefined;
+                format?: import('../analytics-protocol/index.js').TemporalBucketFormat | undefined;
+                dateFormat?: string | undefined;
+                customFormat?: string | undefined;
+            }>, {
+                granularity?: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year" | undefined;
+                format?: import('../analytics-protocol/index.js').TemporalBucketFormat | undefined;
+                dateFormat?: string | undefined;
+                customFormat?: string | undefined;
+            }, {
+                granularity?: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year" | undefined;
+                format?: import('../analytics-protocol/index.js').TemporalBucketFormat | undefined;
+                dateFormat?: string | undefined;
+                customFormat?: string | undefined;
+            }>>;
+        }, "strict", z.ZodTypeAny, {
+            value: string;
+            label: string;
+            presentation?: {
+                granularity?: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year" | undefined;
+                format?: import('../analytics-protocol/index.js').TemporalBucketFormat | undefined;
+                dateFormat?: string | undefined;
+                customFormat?: string | undefined;
+            } | undefined;
+        }, {
+            value: string;
+            label: string;
+            presentation?: {
+                granularity?: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year" | undefined;
+                format?: import('../analytics-protocol/index.js').TemporalBucketFormat | undefined;
+                dateFormat?: string | undefined;
+                customFormat?: string | undefined;
+            } | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        options: {
+            value: string;
+            label: string;
+            presentation?: {
+                granularity?: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year" | undefined;
+                format?: import('../analytics-protocol/index.js').TemporalBucketFormat | undefined;
+                dateFormat?: string | undefined;
+                customFormat?: string | undefined;
+            } | undefined;
+        }[];
+        kind: "manual";
+    }, {
+        options: {
+            value: string;
+            label: string;
+            presentation?: {
+                granularity?: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year" | undefined;
+                format?: import('../analytics-protocol/index.js').TemporalBucketFormat | undefined;
+                dateFormat?: string | undefined;
+                customFormat?: string | undefined;
+            } | undefined;
+        }[];
+        kind: "manual";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"dataset_values">;
+        fieldId: z.ZodString;
+        connectionId: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "dataset_values";
+        fieldId: string;
+        connectionId?: string | undefined;
+    }, {
+        kind: "dataset_values";
+        fieldId: string;
+        connectionId?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"field_allowlist">;
+        fieldIds: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "field_allowlist";
+        fieldIds: string[];
+    }, {
+        kind: "field_allowlist";
+        fieldIds: string[];
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"metric_allowlist">;
+        metricIds: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "metric_allowlist";
+        metricIds: string[];
+    }, {
+        kind: "metric_allowlist";
+        metricIds: string[];
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"sql_query">;
+        connectionId: z.ZodString;
+        sql: z.ZodString;
+        valueColumn: z.ZodString;
+        labelColumn: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "sql_query";
+        connectionId: string;
+        sql: string;
+        valueColumn: string;
+        labelColumn?: string | undefined;
+    }, {
+        kind: "sql_query";
+        connectionId: string;
+        sql: string;
+        valueColumn: string;
+        labelColumn?: string | undefined;
+    }>]>;
+    initialValueStrategy: z.ZodEnum<["saved_default", "builtin", "embed_required", "schedule_snapshot"]>;
+    defaultValue: z.ZodOptional<z.ZodUnknown>;
+    requiredAtExecution: z.ZodBoolean;
+    hidden: z.ZodOptional<z.ZodBoolean>;
+    locked: z.ZodOptional<z.ZodBoolean>;
+    helpText: z.ZodOptional<z.ZodString>;
+    placement: z.ZodOptional<z.ZodEnum<["toolbar", "card_header", "advanced"]>>;
+    showLabel: z.ZodOptional<z.ZodBoolean>;
+    toolbarWidth: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    type: "number" | "boolean" | "date" | "text" | "enum" | "multi_enum" | "field_selector" | "metric_selector" | "aggregation_selector" | "grain_selector";
+    id: string;
+    label: string;
+    source: {
+        options: {
+            value: string;
+            label: string;
+            presentation?: {
+                granularity?: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year" | undefined;
+                format?: import('../analytics-protocol/index.js').TemporalBucketFormat | undefined;
+                dateFormat?: string | undefined;
+                customFormat?: string | undefined;
+            } | undefined;
+        }[];
+        kind: "manual";
+    } | {
+        kind: "dataset_values";
+        fieldId: string;
+        connectionId?: string | undefined;
+    } | {
+        kind: "field_allowlist";
+        fieldIds: string[];
+    } | {
+        kind: "metric_allowlist";
+        metricIds: string[];
+    } | {
+        kind: "sql_query";
+        connectionId: string;
+        sql: string;
+        valueColumn: string;
+        labelColumn?: string | undefined;
+    };
+    scope: "card" | "dashboard";
+    requiredAtExecution: boolean;
+    initialValueStrategy: "saved_default" | "builtin" | "embed_required" | "schedule_snapshot";
+    defaultValue?: unknown;
+    showLabel?: boolean | undefined;
+    toolbarWidth?: number | undefined;
+    placement?: "toolbar" | "card_header" | "advanced" | undefined;
+    hidden?: boolean | undefined;
+    locked?: boolean | undefined;
+    helpText?: string | undefined;
+}, {
+    type: "number" | "boolean" | "date" | "text" | "enum" | "multi_enum" | "field_selector" | "metric_selector" | "aggregation_selector" | "grain_selector";
+    id: string;
+    label: string;
+    source: {
+        options: {
+            value: string;
+            label: string;
+            presentation?: {
+                granularity?: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year" | undefined;
+                format?: import('../analytics-protocol/index.js').TemporalBucketFormat | undefined;
+                dateFormat?: string | undefined;
+                customFormat?: string | undefined;
+            } | undefined;
+        }[];
+        kind: "manual";
+    } | {
+        kind: "dataset_values";
+        fieldId: string;
+        connectionId?: string | undefined;
+    } | {
+        kind: "field_allowlist";
+        fieldIds: string[];
+    } | {
+        kind: "metric_allowlist";
+        metricIds: string[];
+    } | {
+        kind: "sql_query";
+        connectionId: string;
+        sql: string;
+        valueColumn: string;
+        labelColumn?: string | undefined;
+    };
+    scope: "card" | "dashboard";
+    requiredAtExecution: boolean;
+    initialValueStrategy: "saved_default" | "builtin" | "embed_required" | "schedule_snapshot";
+    defaultValue?: unknown;
+    showLabel?: boolean | undefined;
+    toolbarWidth?: number | undefined;
+    placement?: "toolbar" | "card_header" | "advanced" | undefined;
+    hidden?: boolean | undefined;
+    locked?: boolean | undefined;
+    helpText?: string | undefined;
+}>, {
+    type: "number" | "boolean" | "date" | "text" | "enum" | "multi_enum" | "field_selector" | "metric_selector" | "aggregation_selector" | "grain_selector";
+    id: string;
+    label: string;
+    source: {
+        options: {
+            value: string;
+            label: string;
+            presentation?: {
+                granularity?: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year" | undefined;
+                format?: import('../analytics-protocol/index.js').TemporalBucketFormat | undefined;
+                dateFormat?: string | undefined;
+                customFormat?: string | undefined;
+            } | undefined;
+        }[];
+        kind: "manual";
+    } | {
+        kind: "dataset_values";
+        fieldId: string;
+        connectionId?: string | undefined;
+    } | {
+        kind: "field_allowlist";
+        fieldIds: string[];
+    } | {
+        kind: "metric_allowlist";
+        metricIds: string[];
+    } | {
+        kind: "sql_query";
+        connectionId: string;
+        sql: string;
+        valueColumn: string;
+        labelColumn?: string | undefined;
+    };
+    scope: "card" | "dashboard";
+    requiredAtExecution: boolean;
+    initialValueStrategy: "saved_default" | "builtin" | "embed_required" | "schedule_snapshot";
+    defaultValue?: unknown;
+    showLabel?: boolean | undefined;
+    toolbarWidth?: number | undefined;
+    placement?: "toolbar" | "card_header" | "advanced" | undefined;
+    hidden?: boolean | undefined;
+    locked?: boolean | undefined;
+    helpText?: string | undefined;
+}, {
+    type: "number" | "boolean" | "date" | "text" | "enum" | "multi_enum" | "field_selector" | "metric_selector" | "aggregation_selector" | "grain_selector";
+    id: string;
+    label: string;
+    source: {
+        options: {
+            value: string;
+            label: string;
+            presentation?: {
+                granularity?: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year" | undefined;
+                format?: import('../analytics-protocol/index.js').TemporalBucketFormat | undefined;
+                dateFormat?: string | undefined;
+                customFormat?: string | undefined;
+            } | undefined;
+        }[];
+        kind: "manual";
+    } | {
+        kind: "dataset_values";
+        fieldId: string;
+        connectionId?: string | undefined;
+    } | {
+        kind: "field_allowlist";
+        fieldIds: string[];
+    } | {
+        kind: "metric_allowlist";
+        metricIds: string[];
+    } | {
+        kind: "sql_query";
+        connectionId: string;
+        sql: string;
+        valueColumn: string;
+        labelColumn?: string | undefined;
+    };
+    scope: "card" | "dashboard";
+    requiredAtExecution: boolean;
+    initialValueStrategy: "saved_default" | "builtin" | "embed_required" | "schedule_snapshot";
+    defaultValue?: unknown;
+    showLabel?: boolean | undefined;
+    toolbarWidth?: number | undefined;
+    placement?: "toolbar" | "card_header" | "advanced" | undefined;
+    hidden?: boolean | undefined;
+    locked?: boolean | undefined;
+    helpText?: string | undefined;
+}>;
+export declare const controlBindingExecutionSchema: z.ZodDiscriminatedUnion<"target", [z.ZodObject<{
+    controlId: z.ZodString;
+    target: z.ZodLiteral<"sql_param">;
+    paramId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    target: "sql_param";
+    paramId: string;
+    controlId: string;
+}, {
+    target: "sql_param";
+    paramId: string;
+    controlId: string;
+}>, z.ZodObject<{
+    controlId: z.ZodString;
+    target: z.ZodLiteral<"config_metric_selector">;
+    matrixTargetId: z.ZodOptional<z.ZodString>;
+    mapping: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"matrix_instance">;
+        id: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        kind: "matrix_instance";
+    }, {
+        id: string;
+        kind: "matrix_instance";
+    }>, z.ZodEffects<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"metric">;
+        aggregate: z.ZodOptional<z.ZodEnum<["COUNT", "SUM", "AVG", "MIN", "MAX", "MEDIAN", "DISTINCT"]>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"metric">;
+        aggregate: z.ZodOptional<z.ZodEnum<["COUNT", "SUM", "AVG", "MIN", "MAX", "MEDIAN", "DISTINCT"]>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"metric">;
+        aggregate: z.ZodOptional<z.ZodEnum<["COUNT", "SUM", "AVG", "MIN", "MAX", "MEDIAN", "DISTINCT"]>>;
+    }, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"metric">;
+        aggregate: z.ZodOptional<z.ZodEnum<["COUNT", "SUM", "AVG", "MIN", "MAX", "MEDIAN", "DISTINCT"]>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"metric">;
+        aggregate: z.ZodOptional<z.ZodEnum<["COUNT", "SUM", "AVG", "MIN", "MAX", "MEDIAN", "DISTINCT"]>>;
+    }, z.ZodTypeAny, "passthrough">>]>>, Record<string, z.objectOutputType<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"metric">;
+        aggregate: z.ZodOptional<z.ZodEnum<["COUNT", "SUM", "AVG", "MIN", "MAX", "MEDIAN", "DISTINCT"]>>;
+    }, z.ZodTypeAny, "passthrough"> | {
+        id: string;
+        kind: "matrix_instance";
+    }>, Record<string, z.objectInputType<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"metric">;
+        aggregate: z.ZodOptional<z.ZodEnum<["COUNT", "SUM", "AVG", "MIN", "MAX", "MEDIAN", "DISTINCT"]>>;
+    }, z.ZodTypeAny, "passthrough"> | {
+        id: string;
+        kind: "matrix_instance";
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    target: "config_metric_selector";
+    controlId: string;
+    mapping: Record<string, z.objectOutputType<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"metric">;
+        aggregate: z.ZodOptional<z.ZodEnum<["COUNT", "SUM", "AVG", "MIN", "MAX", "MEDIAN", "DISTINCT"]>>;
+    }, z.ZodTypeAny, "passthrough"> | {
+        id: string;
+        kind: "matrix_instance";
+    }>;
+    matrixTargetId?: string | undefined;
+}, {
+    target: "config_metric_selector";
+    controlId: string;
+    mapping: Record<string, z.objectInputType<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"metric">;
+        aggregate: z.ZodOptional<z.ZodEnum<["COUNT", "SUM", "AVG", "MIN", "MAX", "MEDIAN", "DISTINCT"]>>;
+    }, z.ZodTypeAny, "passthrough"> | {
+        id: string;
+        kind: "matrix_instance";
+    }>;
+    matrixTargetId?: string | undefined;
+}>, z.ZodObject<{
+    controlId: z.ZodString;
+    target: z.ZodLiteral<"config_field_selector">;
+    matrixTargetId: z.ZodOptional<z.ZodString>;
+    mapping: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"matrix_instance">;
+        id: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        kind: "matrix_instance";
+    }, {
+        id: string;
+        kind: "matrix_instance";
+    }>, z.ZodEffects<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"groupby">;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"groupby">;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"groupby">;
+    }, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"groupby">;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"groupby">;
+    }, z.ZodTypeAny, "passthrough">>]>>, Record<string, z.objectOutputType<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"groupby">;
+    }, z.ZodTypeAny, "passthrough"> | {
+        id: string;
+        kind: "matrix_instance";
+    }>, Record<string, z.objectInputType<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"groupby">;
+    }, z.ZodTypeAny, "passthrough"> | {
+        id: string;
+        kind: "matrix_instance";
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    target: "config_field_selector";
+    controlId: string;
+    mapping: Record<string, z.objectOutputType<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"groupby">;
+    }, z.ZodTypeAny, "passthrough"> | {
+        id: string;
+        kind: "matrix_instance";
+    }>;
+    matrixTargetId?: string | undefined;
+}, {
+    target: "config_field_selector";
+    controlId: string;
+    mapping: Record<string, z.objectInputType<{
+        id: z.ZodString;
+        name: z.ZodString;
+        label: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        qualifiedFieldName: z.ZodString;
+        dataType: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        qualifiedEntityName: z.ZodOptional<z.ZodString>;
+        dateFormat: z.ZodOptional<z.ZodString>;
+        customFormat: z.ZodOptional<z.ZodString>;
+        granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year", "hour", "minute", "second"]>>;
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+        source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"semantic">;
+            datasetId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            connectionId: z.ZodOptional<z.ZodString>;
+        } & {
+            domainId: z.ZodEffects<z.ZodString, string, string>;
+            datasetName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }, {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"physical">;
+            connectionType: z.ZodOptional<z.ZodString>;
+            databaseName: z.ZodOptional<z.ZodString>;
+            schemaName: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
+        } & {
+            connectionId: z.ZodEffects<z.ZodString, string, string>;
+            tableName: z.ZodEffects<z.ZodString, string, string>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }, {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        }>]>>;
+        expression: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodUnknown>;
+    } & {
+        role: z.ZodLiteral<"groupby">;
+    }, z.ZodTypeAny, "passthrough"> | {
+        id: string;
+        kind: "matrix_instance";
+    }>;
+    matrixTargetId?: string | undefined;
+}>, z.ZodObject<{
+    controlId: z.ZodString;
+    target: z.ZodLiteral<"config_aggregation">;
+    matrixTargetId: z.ZodOptional<z.ZodString>;
+    mapping: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>;
+}, "strict", z.ZodTypeAny, {
+    target: "config_aggregation";
+    controlId: string;
+    mapping: Record<string, string>;
+    matrixTargetId?: string | undefined;
+}, {
+    target: "config_aggregation";
+    controlId: string;
+    mapping: Record<string, string>;
+    matrixTargetId?: string | undefined;
+}>, z.ZodObject<{
+    controlId: z.ZodString;
+    target: z.ZodLiteral<"config_grain">;
+    matrixTargetId: z.ZodOptional<z.ZodString>;
+    mapping: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>;
+}, "strict", z.ZodTypeAny, {
+    target: "config_grain";
+    controlId: string;
+    mapping: Record<string, string>;
+    matrixTargetId?: string | undefined;
+}, {
+    target: "config_grain";
+    controlId: string;
+    mapping: Record<string, string>;
+    matrixTargetId?: string | undefined;
+}>, z.ZodObject<{
+    controlId: z.ZodString;
+    target: z.ZodLiteral<"presentation_currency">;
+    presentationTarget: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"metric">;
+        metricId: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "metric";
+        metricId: string;
+    }, {
+        kind: "metric";
+        metricId: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"column">;
+        columnKey: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "column";
+        columnKey: string;
+    }, {
+        kind: "column";
+        columnKey: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"matrix_measure">;
+        measureId: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "matrix_measure";
+        measureId: string;
+    }, {
+        kind: "matrix_measure";
+        measureId: string;
+    }>]>;
+}, "strict", z.ZodTypeAny, {
+    target: "presentation_currency";
+    controlId: string;
+    presentationTarget: {
+        kind: "metric";
+        metricId: string;
+    } | {
+        kind: "column";
+        columnKey: string;
+    } | {
+        kind: "matrix_measure";
+        measureId: string;
+    };
+}, {
+    target: "presentation_currency";
+    controlId: string;
+    presentationTarget: {
+        kind: "metric";
+        metricId: string;
+    } | {
+        kind: "column";
+        columnKey: string;
+    } | {
+        kind: "matrix_measure";
+        measureId: string;
+    };
+}>]>;
+export declare class ExecutionControlContractError extends Error {
+    constructor(message: string);
+}
+export declare function parseExecutionControlBindingsShallow(input: unknown): ControlBinding[];
+export declare function parseExecutionControlContract(input: {
+    controlDefinitions?: unknown;
+    cardControlDefinitions?: unknown;
+    controlBindings?: unknown;
+}): {
+    controlDefinitions: ControlDefinition[];
+    cardControlDefinitions: ControlDefinition[];
+    controlBindings: ControlBinding[];
+};
+export declare function parseExecutionControlContext(input: {
+    controlValues?: unknown;
+    controlDefinitions?: unknown;
+    cardControlDefinitions?: unknown;
+    controlBindings?: unknown;
+}): {
+    controlValues: Record<string, unknown>;
+    controlDefinitions: ControlDefinition[];
+    cardControlDefinitions: ControlDefinition[];
+    controlBindings: ControlBinding[];
+};