@pattern-stack/codegen 0.2.0

package/dist/src/index.d.ts

@@ -0,0 +1,2384 @@
+import { z } from 'zod';
+
+/**
+ * Domain Analyzer Types
+ *
+ * Core type definitions for the domain analysis tool.
+ */
+type Severity = 'error' | 'warning' | 'info';
+interface ParsedField {
+    name: string;
+    type: string;
+    required: boolean;
+    nullable: boolean;
+    unique: boolean;
+    index: boolean;
+    foreignKey?: {
+        table: string;
+        column: string;
+    };
+    choices?: string[];
+    constraints: {
+        minLength?: number;
+        maxLength?: number;
+        min?: number;
+        max?: number;
+    };
+    ui: {
+        label?: string;
+        type?: string;
+        importance?: string;
+        group?: string;
+        sortable?: boolean;
+        filterable?: boolean;
+        visible?: boolean;
+    };
+}
+interface ParsedRelationship {
+    name: string;
+    type: 'belongs_to' | 'has_many' | 'has_one';
+    target: string;
+    foreignKey: string;
+    inverse?: string;
+    through?: string;
+    resolved: boolean;
+}
+type EntityFamily = 'crm-synced' | 'activity' | 'knowledge' | 'metadata';
+interface ParsedQuery {
+    by: string[];
+    unique?: boolean;
+    select?: string[];
+    order?: string;
+    limit?: boolean;
+    via?: string;
+}
+interface ParsedProviderSync {
+    remoteEntity: string;
+    direction: 'inbound' | 'outbound' | 'bidirectional';
+    cdc: boolean;
+    fieldMapping?: Record<string, string>;
+    readOnlyFields?: string[];
+}
+interface ParsedSync {
+    electric: boolean;
+    providers?: Record<string, ParsedProviderSync>;
+}
+interface ParsedEvent {
+    name: string;
+    queue: string;
+    body: Record<string, string>;
+    generateHandler: boolean;
+}
+interface ParsedEntity {
+    name: string;
+    plural: string;
+    table: string;
+    family?: EntityFamily;
+    folderStructure: 'nested' | 'flat';
+    fields: Map<string, ParsedField>;
+    relationships: Map<string, ParsedRelationship>;
+    behaviors: string[];
+    queries?: ParsedQuery[];
+    sync?: ParsedSync;
+    events?: ParsedEvent[];
+    sourcePath: string;
+}
+/**
+ * Direction metadata for a single relationship type.
+ * Resolved from the YAML types: block (simple list or object map).
+ */
+interface ParsedTypeDirection {
+    name: string;
+    inverse?: string;
+    bidirectional: boolean;
+    directed: boolean;
+}
+/**
+ * A parsed relationship definition — a first-class junction entity
+ * between two core entities. Loaded from relationship YAML files.
+ *
+ * This is NOT the same as ParsedRelationship (which is an inline
+ * belongs_to/has_many/has_one on an entity). This represents a full
+ * junction table with its own fields, types, temporal/sourced flags.
+ */
+interface ParsedRelationshipDefinition {
+    name: string;
+    table: string;
+    from: string;
+    to: string;
+    selfReferential: boolean;
+    fromColumn: string;
+    toColumn: string;
+    types: ParsedTypeDirection[];
+    hasTypes: boolean;
+    temporal: boolean;
+    sourced: boolean;
+    onDeleteFrom: 'restrict' | 'cascade' | 'set_null' | 'no_action';
+    onDeleteTo: 'restrict' | 'cascade' | 'set_null' | 'no_action';
+    uniqueOn: string[];
+    fields: Map<string, ParsedField>;
+    queries?: ParsedQuery[];
+    sourcePath: string;
+}
+interface EntityNode {
+    id: string;
+    name: string;
+    entity: ParsedEntity;
+}
+interface RelationshipEdge {
+    from: string;
+    to: string;
+    relationship: ParsedRelationship;
+    cardinality: '1:1' | '1:N' | 'N:1' | 'N:M';
+    bidirectional: boolean;
+}
+interface DomainGraph {
+    entities: Map<string, ParsedEntity>;
+    relationshipDefinitions: Map<string, ParsedRelationshipDefinition>;
+    edges: RelationshipEdge[];
+}
+interface AnalysisIssue {
+    severity: Severity;
+    type: string;
+    entity?: string;
+    field?: string;
+    message: string;
+    path?: string;
+    suggestion?: string;
+}
+interface DomainStatistics {
+    totalEntities: number;
+    totalFields: number;
+    totalRelationships: number;
+    fieldsByType: Record<string, number>;
+    relationshipsByType: Record<string, number>;
+    entitiesWithBehaviors: number;
+    averageFieldsPerEntity: number;
+}
+interface AnalysisResult {
+    isValid: boolean;
+    entities: ParsedEntity[];
+    relationshipDefinitions: ParsedRelationshipDefinition[];
+    graph: DomainGraph;
+    issues: AnalysisIssue[];
+    statistics: DomainStatistics;
+}
+type OutputFormat = 'console' | 'json' | 'markdown';
+interface PathHop {
+    via: string;
+    relationship: string;
+    foreignKey: string;
+}
+interface TransitivePath {
+    source: string;
+    target: string;
+    hops: PathHop[];
+    suggestedName: string;
+    throughPath: string;
+    yamlSnippet: string;
+}
+interface TransitiveSuggestion extends Omit<AnalysisIssue, 'path'> {
+    type: 'transitive_suggestion';
+    path: TransitivePath;
+}
+interface ManifestField {
+    name: string;
+    type: string;
+    required: boolean;
+    nullable: boolean;
+    unique: boolean;
+    index: boolean;
+    foreignKey?: {
+        table: string;
+        column: string;
+    };
+    choices?: string[];
+}
+interface ManifestRelationship {
+    type: 'belongs_to' | 'has_many' | 'has_one';
+    target: string;
+    foreignKey: string;
+    through?: string;
+    inverse?: string;
+}
+interface ManifestEntity {
+    sourcePath: string;
+    table: string;
+    plural: string;
+    fields: Record<string, ManifestField>;
+    relationships: Record<string, ManifestRelationship>;
+    behaviors: string[];
+}
+interface ManifestSuggestion {
+    id: string;
+    source: string;
+    target: string;
+    throughPath: string;
+    suggestedName: string;
+    yamlSnippet: string;
+    status: 'pending' | 'accepted' | 'skipped';
+    detectedAt: string;
+    resolvedAt?: string;
+}
+interface CodegenManifest {
+    version: 1;
+    generatedAt: string;
+    entityFilesHash: string;
+    entities: Record<string, ManifestEntity>;
+    graph: {
+        edges: Array<{
+            from: string;
+            to: string;
+            relationship: string;
+            cardinality: '1:1' | '1:N' | 'N:1';
+            bidirectional: boolean;
+        }>;
+        orphans: string[];
+        cycles: string[][];
+    };
+    suggestions: {
+        transitive: ManifestSuggestion[];
+    };
+    statistics: {
+        totalEntities: number;
+        totalFields: number;
+        totalRelationships: number;
+        transitivePathsDetected: number;
+    };
+}
+
+declare const EntityDefinitionSchema: z.ZodObject<{
+    entity: z.ZodObject<{
+        name: z.ZodString;
+        plural: z.ZodString;
+        table: z.ZodString;
+        folder_structure: z.ZodOptional<z.ZodDefault<z.ZodEnum<["nested", "flat"]>>>;
+        file_grouping: z.ZodOptional<z.ZodDefault<z.ZodEnum<["separate", "grouped"]>>>;
+        behavior_strategy: z.ZodOptional<z.ZodEnum<["base_class", "inline"]>>;
+        expose: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<["repository", "rest", "trpc", "electric"]>, "many">>>;
+        family: z.ZodOptional<z.ZodEnum<["base", "synced", "activity", "knowledge", "metadata"]>>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        plural: string;
+        table: string;
+        expose: ("repository" | "rest" | "trpc" | "electric")[];
+        folder_structure?: "flat" | "nested" | undefined;
+        file_grouping?: "separate" | "grouped" | undefined;
+        behavior_strategy?: "base_class" | "inline" | undefined;
+        family?: "base" | "synced" | "activity" | "knowledge" | "metadata" | undefined;
+    }, {
+        name: string;
+        plural: string;
+        table: string;
+        folder_structure?: "flat" | "nested" | undefined;
+        file_grouping?: "separate" | "grouped" | undefined;
+        behavior_strategy?: "base_class" | "inline" | undefined;
+        expose?: ("repository" | "rest" | "trpc" | "electric")[] | undefined;
+        family?: "base" | "synced" | "activity" | "knowledge" | "metadata" | undefined;
+    }>;
+    fields: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
+        type: z.ZodEnum<["string", "integer", "decimal", "boolean", "uuid", "date", "datetime", "json", "entity_ref", "string_array", "enum"]>;
+        required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        nullable: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        max_length: z.ZodOptional<z.ZodNumber>;
+        min_length: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        choices: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        choices_from: z.ZodOptional<z.ZodString>;
+        allowed_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        default: z.ZodOptional<z.ZodUnknown>;
+        index: z.ZodOptional<z.ZodBoolean>;
+        unique: z.ZodOptional<z.ZodBoolean>;
+        foreign_key: z.ZodOptional<z.ZodString>;
+    } & {
+        ui_label: z.ZodOptional<z.ZodString>;
+        ui_type: z.ZodOptional<z.ZodEnum<["text", "textarea", "number", "money", "percentage", "email", "url", "date", "datetime", "boolean", "enum", "reference", "json", "badge", "password"]>>;
+        ui_importance: z.ZodOptional<z.ZodEnum<["primary", "secondary", "tertiary"]>>;
+        ui_group: z.ZodOptional<z.ZodString>;
+        ui_sortable: z.ZodOptional<z.ZodBoolean>;
+        ui_filterable: z.ZodOptional<z.ZodBoolean>;
+        ui_visible: z.ZodOptional<z.ZodBoolean>;
+        ui_placeholder: z.ZodOptional<z.ZodString>;
+        ui_help: z.ZodOptional<z.ZodString>;
+        ui_format: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    } & {
+        measure: z.ZodOptional<z.ZodBoolean>;
+        analytics_aggregation: z.ZodOptional<z.ZodEnum<["sum", "min", "max", "count", "count_distinct", "average", "median", "percentile", "sum_boolean"]>>;
+        agg_time_dimension: z.ZodOptional<z.ZodString>;
+        non_additive_dimension: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            name: z.ZodString;
+            window_choice: z.ZodOptional<z.ZodString>;
+            window_groupings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        }, {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        }>]>>;
+        dimension: z.ZodOptional<z.ZodBoolean>;
+        dimension_type: z.ZodOptional<z.ZodEnum<["categorical", "time"]>>;
+        time_granularity: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year"]>>;
+        is_partition: z.ZodOptional<z.ZodBoolean>;
+        entity: z.ZodOptional<z.ZodBoolean>;
+        entity_type: z.ZodOptional<z.ZodEnum<["primary", "unique", "foreign", "natural"]>>;
+        entity_role: z.ZodOptional<z.ZodString>;
+        analytics_visibility: z.ZodOptional<z.ZodEnum<["internal", "agent", "public"]>>;
+        semantic_expr: z.ZodOptional<z.ZodString>;
+        semantic_label: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        required: boolean;
+        nullable: boolean;
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        required?: boolean | undefined;
+        nullable?: boolean | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }>, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        required: boolean;
+        nullable: boolean;
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        required?: boolean | undefined;
+        nullable?: boolean | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }>, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        required: boolean;
+        nullable: boolean;
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        required?: boolean | undefined;
+        nullable?: boolean | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }>, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        required: boolean;
+        nullable: boolean;
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        required?: boolean | undefined;
+        nullable?: boolean | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }>, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        required: boolean;
+        nullable: boolean;
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        required?: boolean | undefined;
+        nullable?: boolean | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }>, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        required: boolean;
+        nullable: boolean;
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        required?: boolean | undefined;
+        nullable?: boolean | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }>, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        required: boolean;
+        nullable: boolean;
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        required?: boolean | undefined;
+        nullable?: boolean | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }>, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        required: boolean;
+        nullable: boolean;
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        required?: boolean | undefined;
+        nullable?: boolean | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }>, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        required: boolean;
+        nullable: boolean;
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        required?: boolean | undefined;
+        nullable?: boolean | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }>, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        required: boolean;
+        nullable: boolean;
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        required?: boolean | undefined;
+        nullable?: boolean | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }>, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        required: boolean;
+        nullable: boolean;
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        required?: boolean | undefined;
+        nullable?: boolean | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }>>;
+    relationships: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<["belongs_to", "has_many", "has_one"]>;
+        target: z.ZodString;
+        foreign_key: z.ZodString;
+        through: z.ZodOptional<z.ZodString>;
+        inverse: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        type: "belongs_to" | "has_many" | "has_one";
+        foreign_key: string;
+        target: string;
+        through?: string | undefined;
+        inverse?: string | undefined;
+    }, {
+        type: "belongs_to" | "has_many" | "has_one";
+        foreign_key: string;
+        target: string;
+        through?: string | undefined;
+        inverse?: string | undefined;
+    }>>>;
+    behaviors: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        options?: Record<string, unknown> | undefined;
+    }, {
+        name: string;
+        options?: Record<string, unknown> | undefined;
+    }>]>, "many">>>;
+    queries: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        by: z.ZodArray<z.ZodString, "many">;
+        unique: z.ZodOptional<z.ZodBoolean>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        order: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodBoolean>;
+        via: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        by: string[];
+        unique?: boolean | undefined;
+        select?: string[] | undefined;
+        order?: string | undefined;
+        limit?: boolean | undefined;
+        via?: string | undefined;
+    }, {
+        by: string[];
+        unique?: boolean | undefined;
+        select?: string[] | undefined;
+        order?: string | undefined;
+        limit?: boolean | undefined;
+        via?: string | undefined;
+    }>, "many">>;
+    sync: z.ZodOptional<z.ZodObject<{
+        electric: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        providers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            remote_entity: z.ZodString;
+            direction: z.ZodEnum<["inbound", "outbound", "bidirectional"]>;
+            cdc: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            field_mapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            read_only_fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            remote_entity: string;
+            direction: "inbound" | "outbound" | "bidirectional";
+            cdc: boolean;
+            field_mapping?: Record<string, string> | undefined;
+            read_only_fields?: string[] | undefined;
+        }, {
+            remote_entity: string;
+            direction: "inbound" | "outbound" | "bidirectional";
+            cdc?: boolean | undefined;
+            field_mapping?: Record<string, string> | undefined;
+            read_only_fields?: string[] | undefined;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        electric: boolean;
+        providers?: Record<string, {
+            remote_entity: string;
+            direction: "inbound" | "outbound" | "bidirectional";
+            cdc: boolean;
+            field_mapping?: Record<string, string> | undefined;
+            read_only_fields?: string[] | undefined;
+        }> | undefined;
+    }, {
+        electric?: boolean | undefined;
+        providers?: Record<string, {
+            remote_entity: string;
+            direction: "inbound" | "outbound" | "bidirectional";
+            cdc?: boolean | undefined;
+            field_mapping?: Record<string, string> | undefined;
+            read_only_fields?: string[] | undefined;
+        }> | undefined;
+    }>>;
+    events: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        queue: z.ZodString;
+        body: z.ZodRecord<z.ZodString, z.ZodString>;
+        generate_handler: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        queue: string;
+        body: Record<string, string>;
+        generate_handler: boolean;
+    }, {
+        name: string;
+        queue: string;
+        body: Record<string, string>;
+        generate_handler?: boolean | undefined;
+    }>, "many">>;
+    analytics: z.ZodOptional<z.ZodObject<{
+        measure_packs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        cube_name: z.ZodOptional<z.ZodString>;
+        metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"simple">;
+            measure: z.ZodString;
+            agg: z.ZodOptional<z.ZodEnum<["sum", "min", "max", "count", "count_distinct", "average", "median", "percentile", "sum_boolean"]>>;
+            filter: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "simple";
+            measure: string;
+            filter?: string | undefined;
+            agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+            description?: string | undefined;
+            label?: string | undefined;
+        }, {
+            type: "simple";
+            measure: string;
+            filter?: string | undefined;
+            agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+            description?: string | undefined;
+            label?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"derived">;
+            expr: z.ZodString;
+            metrics: z.ZodArray<z.ZodString, "many">;
+            description: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "derived";
+            expr: string;
+            metrics: string[];
+            description?: string | undefined;
+            label?: string | undefined;
+        }, {
+            type: "derived";
+            expr: string;
+            metrics: string[];
+            description?: string | undefined;
+            label?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"ratio">;
+            numerator: z.ZodUnion<[z.ZodString, z.ZodObject<{
+                type: z.ZodLiteral<"simple">;
+                measure: z.ZodString;
+                agg: z.ZodOptional<z.ZodEnum<["sum", "min", "max", "count", "count_distinct", "average", "median", "percentile", "sum_boolean"]>>;
+                filter: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                label: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                description?: string | undefined;
+                label?: string | undefined;
+            }, {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                description?: string | undefined;
+                label?: string | undefined;
+            }>]>;
+            denominator: z.ZodUnion<[z.ZodString, z.ZodObject<{
+                type: z.ZodLiteral<"simple">;
+                measure: z.ZodString;
+                agg: z.ZodOptional<z.ZodEnum<["sum", "min", "max", "count", "count_distinct", "average", "median", "percentile", "sum_boolean"]>>;
+                filter: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                label: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                description?: string | undefined;
+                label?: string | undefined;
+            }, {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                description?: string | undefined;
+                label?: string | undefined;
+            }>]>;
+            filter: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "ratio";
+            numerator: string | {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                description?: string | undefined;
+                label?: string | undefined;
+            };
+            denominator: string | {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                description?: string | undefined;
+                label?: string | undefined;
+            };
+            filter?: string | undefined;
+            description?: string | undefined;
+            label?: string | undefined;
+        }, {
+            type: "ratio";
+            numerator: string | {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                description?: string | undefined;
+                label?: string | undefined;
+            };
+            denominator: string | {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                description?: string | undefined;
+                label?: string | undefined;
+            };
+            filter?: string | undefined;
+            description?: string | undefined;
+            label?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"cumulative">;
+            measure: z.ZodString;
+            window: z.ZodOptional<z.ZodString>;
+            grain_to_date: z.ZodOptional<z.ZodEnum<["day", "week", "month", "quarter", "year"]>>;
+            description: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "cumulative";
+            measure: string;
+            description?: string | undefined;
+            label?: string | undefined;
+            window?: string | undefined;
+            grain_to_date?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        }, {
+            type: "cumulative";
+            measure: string;
+            description?: string | undefined;
+            label?: string | undefined;
+            window?: string | undefined;
+            grain_to_date?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        }>]>>>;
+    }, "strip", z.ZodTypeAny, {
+        metrics?: Record<string, {
+            type: "simple";
+            measure: string;
+            filter?: string | undefined;
+            agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+            description?: string | undefined;
+            label?: string | undefined;
+        } | {
+            type: "derived";
+            expr: string;
+            metrics: string[];
+            description?: string | undefined;
+            label?: string | undefined;
+        } | {
+            type: "ratio";
+            numerator: string | {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                description?: string | undefined;
+                label?: string | undefined;
+            };
+            denominator: string | {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                description?: string | undefined;
+                label?: string | undefined;
+            };
+            filter?: string | undefined;
+            description?: string | undefined;
+            label?: string | undefined;
+        } | {
+            type: "cumulative";
+            measure: string;
+            description?: string | undefined;
+            label?: string | undefined;
+            window?: string | undefined;
+            grain_to_date?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        }> | undefined;
+        measure_packs?: string[] | undefined;
+        cube_name?: string | undefined;
+    }, {
+        metrics?: Record<string, {
+            type: "simple";
+            measure: string;
+            filter?: string | undefined;
+            agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+            description?: string | undefined;
+            label?: string | undefined;
+        } | {
+            type: "derived";
+            expr: string;
+            metrics: string[];
+            description?: string | undefined;
+            label?: string | undefined;
+        } | {
+            type: "ratio";
+            numerator: string | {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                description?: string | undefined;
+                label?: string | undefined;
+            };
+            denominator: string | {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                description?: string | undefined;
+                label?: string | undefined;
+            };
+            filter?: string | undefined;
+            description?: string | undefined;
+            label?: string | undefined;
+        } | {
+            type: "cumulative";
+            measure: string;
+            description?: string | undefined;
+            label?: string | undefined;
+            window?: string | undefined;
+            grain_to_date?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        }> | undefined;
+        measure_packs?: string[] | undefined;
+        cube_name?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    entity: {
+        name: string;
+        plural: string;
+        table: string;
+        expose: ("repository" | "rest" | "trpc" | "electric")[];
+        folder_structure?: "flat" | "nested" | undefined;
+        file_grouping?: "separate" | "grouped" | undefined;
+        behavior_strategy?: "base_class" | "inline" | undefined;
+        family?: "base" | "synced" | "activity" | "knowledge" | "metadata" | undefined;
+    };
+    fields: Record<string, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        required: boolean;
+        nullable: boolean;
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }>;
+    behaviors: (string | {
+        name: string;
+        options?: Record<string, unknown> | undefined;
+    })[];
+    relationships?: Record<string, {
+        type: "belongs_to" | "has_many" | "has_one";
+        foreign_key: string;
+        target: string;
+        through?: string | undefined;
+        inverse?: string | undefined;
+    }> | undefined;
+    queries?: {
+        by: string[];
+        unique?: boolean | undefined;
+        select?: string[] | undefined;
+        order?: string | undefined;
+        limit?: boolean | undefined;
+        via?: string | undefined;
+    }[] | undefined;
+    sync?: {
+        electric: boolean;
+        providers?: Record<string, {
+            remote_entity: string;
+            direction: "inbound" | "outbound" | "bidirectional";
+            cdc: boolean;
+            field_mapping?: Record<string, string> | undefined;
+            read_only_fields?: string[] | undefined;
+        }> | undefined;
+    } | undefined;
+    events?: {
+        name: string;
+        queue: string;
+        body: Record<string, string>;
+        generate_handler: boolean;
+    }[] | undefined;
+    analytics?: {
+        metrics?: Record<string, {
+            type: "simple";
+            measure: string;
+            filter?: string | undefined;
+            agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+            description?: string | undefined;
+            label?: string | undefined;
+        } | {
+            type: "derived";
+            expr: string;
+            metrics: string[];
+            description?: string | undefined;
+            label?: string | undefined;
+        } | {
+            type: "ratio";
+            numerator: string | {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                description?: string | undefined;
+                label?: string | undefined;
+            };
+            denominator: string | {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                description?: string | undefined;
+                label?: string | undefined;
+            };
+            filter?: string | undefined;
+            description?: string | undefined;
+            label?: string | undefined;
+        } | {
+            type: "cumulative";
+            measure: string;
+            description?: string | undefined;
+            label?: string | undefined;
+            window?: string | undefined;
+            grain_to_date?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        }> | undefined;
+        measure_packs?: string[] | undefined;
+        cube_name?: string | undefined;
+    } | undefined;
+}, {
+    entity: {
+        name: string;
+        plural: string;
+        table: string;
+        folder_structure?: "flat" | "nested" | undefined;
+        file_grouping?: "separate" | "grouped" | undefined;
+        behavior_strategy?: "base_class" | "inline" | undefined;
+        expose?: ("repository" | "rest" | "trpc" | "electric")[] | undefined;
+        family?: "base" | "synced" | "activity" | "knowledge" | "metadata" | undefined;
+    };
+    fields: Record<string, {
+        type: "string" | "boolean" | "integer" | "decimal" | "uuid" | "date" | "datetime" | "json" | "entity_ref" | "string_array" | "enum";
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "datetime" | "json" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        required?: boolean | undefined;
+        nullable?: boolean | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        default?: unknown;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }>;
+    relationships?: Record<string, {
+        type: "belongs_to" | "has_many" | "has_one";
+        foreign_key: string;
+        target: string;
+        through?: string | undefined;
+        inverse?: string | undefined;
+    }> | undefined;
+    behaviors?: (string | {
+        name: string;
+        options?: Record<string, unknown> | undefined;
+    })[] | undefined;
+    queries?: {
+        by: string[];
+        unique?: boolean | undefined;
+        select?: string[] | undefined;
+        order?: string | undefined;
+        limit?: boolean | undefined;
+        via?: string | undefined;
+    }[] | undefined;
+    sync?: {
+        electric?: boolean | undefined;
+        providers?: Record<string, {
+            remote_entity: string;
+            direction: "inbound" | "outbound" | "bidirectional";
+            cdc?: boolean | undefined;
+            field_mapping?: Record<string, string> | undefined;
+            read_only_fields?: string[] | undefined;
+        }> | undefined;
+    } | undefined;
+    events?: {
+        name: string;
+        queue: string;
+        body: Record<string, string>;
+        generate_handler?: boolean | undefined;
+    }[] | undefined;
+    analytics?: {
+        metrics?: Record<string, {
+            type: "simple";
+            measure: string;
+            filter?: string | undefined;
+            agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+            description?: string | undefined;
+            label?: string | undefined;
+        } | {
+            type: "derived";
+            expr: string;
+            metrics: string[];
+            description?: string | undefined;
+            label?: string | undefined;
+        } | {
+            type: "ratio";
+            numerator: string | {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                description?: string | undefined;
+                label?: string | undefined;
+            };
+            denominator: string | {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                description?: string | undefined;
+                label?: string | undefined;
+            };
+            filter?: string | undefined;
+            description?: string | undefined;
+            label?: string | undefined;
+        } | {
+            type: "cumulative";
+            measure: string;
+            description?: string | undefined;
+            label?: string | undefined;
+            window?: string | undefined;
+            grain_to_date?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        }> | undefined;
+        measure_packs?: string[] | undefined;
+        cube_name?: string | undefined;
+    } | undefined;
+}>;
+type EntityDefinition = z.infer<typeof EntityDefinitionSchema>;
+
+/**
+ * Complete relationship definition — the top-level shape of a relationship YAML file.
+ *
+ * Example (minimal):
+ *   relationship:
+ *     name: engagement_opportunity
+ *     from: engagement
+ *     to: opportunity
+ *
+ * Example (full):
+ *   relationship:
+ *     name: person_organization
+ *     table: person_organizations
+ *     from: person
+ *     to: organization
+ *     types: [employed_by, advises, board_member]
+ *     temporal: true
+ *     sourced: true
+ *   fields:
+ *     role_title:
+ *       type: string
+ *       nullable: true
+ *   queries:
+ *     - by: [person_id]
+ */
+declare const RelationshipDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    /** Relationship configuration block */
+    relationship: z.ZodObject<{
+        /** Relationship name (snake_case). Used for class/file naming. */
+        name: z.ZodString;
+        /** Database table name. Defaults to {name}s if not specified. */
+        table: z.ZodOptional<z.ZodString>;
+        /** The "from" entity — generates {entity}_id FK column (subject). */
+        from: z.ZodString;
+        /** The "to" entity — generates {entity}_id FK column (object). */
+        to: z.ZodString;
+        /**
+         * Relationship subtypes. Optional — omit for untyped junctions.
+         * When present, generates a `type` enum column on the junction table.
+         *
+         * Simple list: all types are directed (from→to). Use for cross-type
+         * relationships where entity asymmetry makes direction obvious.
+         *
+         * Object map: each type declares its own direction metadata.
+         * Required for self-referential relationships (from === to).
+         */
+        types: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
+            /** Name of the inverse type when viewed from the other direction */
+            inverse: z.ZodOptional<z.ZodString>;
+            /** Both directions are equivalent — queries should check both FK columns */
+            bidirectional: z.ZodOptional<z.ZodBoolean>;
+            /** Explicitly directed, no named inverse (default behavior) */
+            directed: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            inverse?: string | undefined;
+            bidirectional?: boolean | undefined;
+            directed?: boolean | undefined;
+        }, {
+            inverse?: string | undefined;
+            bidirectional?: boolean | undefined;
+            directed?: boolean | undefined;
+        }>, {
+            inverse?: string | undefined;
+            bidirectional?: boolean | undefined;
+            directed?: boolean | undefined;
+        }, {
+            inverse?: string | undefined;
+            bidirectional?: boolean | undefined;
+            directed?: boolean | undefined;
+        }>>]>>;
+        /**
+         * Generate temporal validity fields: valid_from (date), valid_to (date?),
+         * is_current (boolean, denormalized for query performance).
+         * Default: true
+         */
+        temporal: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * Generate source tracking fields: source (enum), confidence (decimal 0-1).
+         * Default: true
+         */
+        sourced: z.ZodDefault<z.ZodBoolean>;
+        /** on_delete action for the "from" endpoint FK. Default: restrict */
+        on_delete_from: z.ZodOptional<z.ZodDefault<z.ZodEnum<["restrict", "cascade", "set_null", "no_action"]>>>;
+        /** on_delete action for the "to" endpoint FK. Default: restrict */
+        on_delete_to: z.ZodOptional<z.ZodDefault<z.ZodEnum<["restrict", "cascade", "set_null", "no_action"]>>>;
+        /**
+         * Override the default unique constraint columns.
+         *
+         * Defaults:
+         * - Typed: [from_id, to_id, type]
+         * - Typed + temporal: [from_id, to_id, type, valid_from]
+         * - Untyped: [from_id, to_id]
+         *
+         * Use this when the default doesn't fit — e.g., allowing multiple
+         * relationships of the same type between the same entities at different times.
+         */
+        unique_on: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        from: string;
+        to: string;
+        temporal: boolean;
+        sourced: boolean;
+        table?: string | undefined;
+        types?: string[] | Record<string, {
+            inverse?: string | undefined;
+            bidirectional?: boolean | undefined;
+            directed?: boolean | undefined;
+        }> | undefined;
+        on_delete_from?: "restrict" | "cascade" | "set_null" | "no_action" | undefined;
+        on_delete_to?: "restrict" | "cascade" | "set_null" | "no_action" | undefined;
+        unique_on?: string[] | undefined;
+    }, {
+        name: string;
+        from: string;
+        to: string;
+        table?: string | undefined;
+        types?: string[] | Record<string, {
+            inverse?: string | undefined;
+            bidirectional?: boolean | undefined;
+            directed?: boolean | undefined;
+        }> | undefined;
+        temporal?: boolean | undefined;
+        sourced?: boolean | undefined;
+        on_delete_from?: "restrict" | "cascade" | "set_null" | "no_action" | undefined;
+        on_delete_to?: "restrict" | "cascade" | "set_null" | "no_action" | undefined;
+        unique_on?: string[] | undefined;
+    }>;
+    /**
+     * Additional fields beyond auto-generated ones.
+     * These describe the relationship, not either endpoint entity.
+     * Uses the same field definition schema as entity fields.
+     */
+    fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    /** Declarative queries — same syntax as entity queries. */
+    queries: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        by: z.ZodArray<z.ZodString, "many">;
+        unique: z.ZodOptional<z.ZodBoolean>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        order: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        by: string[];
+        unique?: boolean | undefined;
+        select?: string[] | undefined;
+        order?: string | undefined;
+        limit?: boolean | undefined;
+    }, {
+        by: string[];
+        unique?: boolean | undefined;
+        select?: string[] | undefined;
+        order?: string | undefined;
+        limit?: boolean | undefined;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    relationship: {
+        name: string;
+        from: string;
+        to: string;
+        temporal: boolean;
+        sourced: boolean;
+        table?: string | undefined;
+        types?: string[] | Record<string, {
+            inverse?: string | undefined;
+            bidirectional?: boolean | undefined;
+            directed?: boolean | undefined;
+        }> | undefined;
+        on_delete_from?: "restrict" | "cascade" | "set_null" | "no_action" | undefined;
+        on_delete_to?: "restrict" | "cascade" | "set_null" | "no_action" | undefined;
+        unique_on?: string[] | undefined;
+    };
+    fields?: Record<string, any> | undefined;
+    queries?: {
+        by: string[];
+        unique?: boolean | undefined;
+        select?: string[] | undefined;
+        order?: string | undefined;
+        limit?: boolean | undefined;
+    }[] | undefined;
+}, {
+    relationship: {
+        name: string;
+        from: string;
+        to: string;
+        table?: string | undefined;
+        types?: string[] | Record<string, {
+            inverse?: string | undefined;
+            bidirectional?: boolean | undefined;
+            directed?: boolean | undefined;
+        }> | undefined;
+        temporal?: boolean | undefined;
+        sourced?: boolean | undefined;
+        on_delete_from?: "restrict" | "cascade" | "set_null" | "no_action" | undefined;
+        on_delete_to?: "restrict" | "cascade" | "set_null" | "no_action" | undefined;
+        unique_on?: string[] | undefined;
+    };
+    fields?: Record<string, any> | undefined;
+    queries?: {
+        by: string[];
+        unique?: boolean | undefined;
+        select?: string[] | undefined;
+        order?: string | undefined;
+        limit?: boolean | undefined;
+    }[] | undefined;
+}>, {
+    relationship: {
+        name: string;
+        from: string;
+        to: string;
+        temporal: boolean;
+        sourced: boolean;
+        table?: string | undefined;
+        types?: string[] | Record<string, {
+            inverse?: string | undefined;
+            bidirectional?: boolean | undefined;
+            directed?: boolean | undefined;
+        }> | undefined;
+        on_delete_from?: "restrict" | "cascade" | "set_null" | "no_action" | undefined;
+        on_delete_to?: "restrict" | "cascade" | "set_null" | "no_action" | undefined;
+        unique_on?: string[] | undefined;
+    };
+    fields?: Record<string, any> | undefined;
+    queries?: {
+        by: string[];
+        unique?: boolean | undefined;
+        select?: string[] | undefined;
+        order?: string | undefined;
+        limit?: boolean | undefined;
+    }[] | undefined;
+}, {
+    relationship: {
+        name: string;
+        from: string;
+        to: string;
+        table?: string | undefined;
+        types?: string[] | Record<string, {
+            inverse?: string | undefined;
+            bidirectional?: boolean | undefined;
+            directed?: boolean | undefined;
+        }> | undefined;
+        temporal?: boolean | undefined;
+        sourced?: boolean | undefined;
+        on_delete_from?: "restrict" | "cascade" | "set_null" | "no_action" | undefined;
+        on_delete_to?: "restrict" | "cascade" | "set_null" | "no_action" | undefined;
+        unique_on?: string[] | undefined;
+    };
+    fields?: Record<string, any> | undefined;
+    queries?: {
+        by: string[];
+        unique?: boolean | undefined;
+        select?: string[] | undefined;
+        order?: string | undefined;
+        limit?: boolean | undefined;
+    }[] | undefined;
+}>, {
+    relationship: {
+        name: string;
+        from: string;
+        to: string;
+        temporal: boolean;
+        sourced: boolean;
+        table?: string | undefined;
+        types?: string[] | Record<string, {
+            inverse?: string | undefined;
+            bidirectional?: boolean | undefined;
+            directed?: boolean | undefined;
+        }> | undefined;
+        on_delete_from?: "restrict" | "cascade" | "set_null" | "no_action" | undefined;
+        on_delete_to?: "restrict" | "cascade" | "set_null" | "no_action" | undefined;
+        unique_on?: string[] | undefined;
+    };
+    fields?: Record<string, any> | undefined;
+    queries?: {
+        by: string[];
+        unique?: boolean | undefined;
+        select?: string[] | undefined;
+        order?: string | undefined;
+        limit?: boolean | undefined;
+    }[] | undefined;
+}, {
+    relationship: {
+        name: string;
+        from: string;
+        to: string;
+        table?: string | undefined;
+        types?: string[] | Record<string, {
+            inverse?: string | undefined;
+            bidirectional?: boolean | undefined;
+            directed?: boolean | undefined;
+        }> | undefined;
+        temporal?: boolean | undefined;
+        sourced?: boolean | undefined;
+        on_delete_from?: "restrict" | "cascade" | "set_null" | "no_action" | undefined;
+        on_delete_to?: "restrict" | "cascade" | "set_null" | "no_action" | undefined;
+        unique_on?: string[] | undefined;
+    };
+    fields?: Record<string, any> | undefined;
+    queries?: {
+        by: string[];
+        unique?: boolean | undefined;
+        select?: string[] | undefined;
+        order?: string | undefined;
+        limit?: boolean | undefined;
+    }[] | undefined;
+}>;
+type RelationshipDefinition = z.infer<typeof RelationshipDefinitionSchema>;
+
+interface LoadResult {
+    success: true;
+    definition: EntityDefinition;
+    filePath: string;
+}
+interface LoadError {
+    success: false;
+    error: string;
+    details?: string[];
+    filePath: string;
+}
+type LoadEntityResult = LoadResult | LoadError;
+/**
+ * Load and validate an entity definition from a YAML file
+ */
+declare function loadEntityFromYaml(filePath: string): LoadEntityResult;
+interface RelationshipLoadResult {
+    success: true;
+    definition: RelationshipDefinition;
+    filePath: string;
+}
+interface RelationshipLoadError {
+    success: false;
+    error: string;
+    details?: string[];
+    filePath: string;
+}
+type LoadRelationshipResult = RelationshipLoadResult | RelationshipLoadError;
+/**
+ * Load and validate a relationship definition from a YAML file
+ */
+declare function loadRelationshipFromYaml(filePath: string): LoadRelationshipResult;
+
+/**
+ * Entity Loader
+ *
+ * Loads and parses all YAML entity files from a directory.
+ * Reuses existing yaml-loader and entity-definition schema from codegen.
+ */
+
+interface LoadEntitiesResult {
+    entities: ParsedEntity[];
+    issues: AnalysisIssue[];
+}
+/**
+ * Load all entity YAML files from a directory
+ */
+declare function loadEntities(entitiesDir: string): LoadEntitiesResult;
+interface LoadRelationshipsResult {
+    relationships: ParsedRelationshipDefinition[];
+    issues: AnalysisIssue[];
+}
+/**
+ * Load all relationship YAML files from a directory
+ */
+declare function loadRelationships(relationshipsDir: string): LoadRelationshipsResult;
+
+/**
+ * Graph Builder
+ *
+ * Builds a domain graph from parsed entities, including nodes and edges.
+ * Tracks bidirectional connections between entities.
+ */
+
+/**
+ * Build a domain graph from parsed entities
+ */
+declare function buildDomainGraph(entities: ParsedEntity[], relationshipDefinitions?: ParsedRelationshipDefinition[]): DomainGraph;
+/**
+ * Get all entities related to a given entity within a specified depth
+ */
+declare function getRelatedEntities(graph: DomainGraph, entityName: string, depth?: number): Set<string>;
+/**
+ * Find entities with no relationships (orphans)
+ */
+declare function findOrphanEntities(graph: DomainGraph): string[];
+/**
+ * Find circular dependencies in the graph
+ */
+declare function findCircularDependencies(graph: DomainGraph): string[][];
+
+/**
+ * Consistency Checker
+ *
+ * Performs various consistency checks on the domain model:
+ * - Missing relationship targets
+ * - Missing inverse relationships
+ * - Missing indexes on filterable fields
+ * - Orphan entities (no relationships)
+ * - Circular dependencies
+ * - Naming conventions
+ * - Missing UI metadata
+ */
+
+/**
+ * Run all consistency checks on the domain graph
+ */
+declare function checkConsistency(graph: DomainGraph): AnalysisIssue[];
+
+/**
+ * Statistics
+ *
+ * Computes statistics about the domain model:
+ * - Entity counts
+ * - Field counts and type distribution
+ * - Relationship counts and type distribution
+ */
+
+/**
+ * Compute domain statistics from the graph
+ */
+declare function computeStatistics(graph: DomainGraph): DomainStatistics;
+
+/**
+ * Console Formatter
+ *
+ * Pretty terminal output with colors for the domain analysis results.
+ */
+
+/**
+ * Format analysis result for console output
+ */
+declare function formatConsole(result: AnalysisResult): string;
+
+/**
+ * JSON Formatter
+ *
+ * Machine-readable JSON output for the domain analysis results.
+ */
+
+/**
+ * Format analysis result as JSON string
+ */
+declare function formatJson(result: AnalysisResult, pretty?: boolean): string;
+
+/**
+ * Markdown Formatter
+ *
+ * Documentation output with Mermaid diagrams for the domain analysis results.
+ */
+
+/**
+ * Format analysis result as Markdown documentation
+ */
+declare function formatMarkdown(result: AnalysisResult): string;
+/**
+ * Generate a simple relationship graph in Mermaid
+ */
+declare function formatMermaidGraph(result: AnalysisResult): string;
+
+/**
+ * Entity Codegen & Domain Analyzer
+ *
+ * A validation and analysis tool for entity YAML definitions.
+ * Parses entities, builds a relationship graph, and detects issues.
+ */
+
+/**
+ * Analyze a domain from entity and relationship YAML files
+ */
+declare function analyzeDomain(entitiesDir: string, relationshipsDir?: string): Promise<AnalysisResult>;
+/**
+ * Validate entity files without full analysis
+ * Returns true if all files parse successfully
+ */
+declare function validateEntities(entitiesDir: string): {
+    valid: boolean;
+    errors: string[];
+};
+
+export { type AnalysisIssue, type AnalysisResult, type CodegenManifest, type DomainGraph, type DomainStatistics, type EntityFamily, type EntityNode, type ManifestEntity, type ManifestField, type ManifestRelationship, type ManifestSuggestion, type OutputFormat, type ParsedEntity, type ParsedEvent, type ParsedField, type ParsedProviderSync, type ParsedQuery, type ParsedRelationship, type ParsedRelationshipDefinition, type ParsedSync, type ParsedTypeDirection, type PathHop, type RelationshipEdge, type Severity, type TransitivePath, type TransitiveSuggestion, analyzeDomain, buildDomainGraph, checkConsistency, computeStatistics, findCircularDependencies, findOrphanEntities, formatConsole, formatJson, formatMarkdown, formatMermaidGraph, getRelatedEntities, loadEntities, loadEntityFromYaml, loadRelationshipFromYaml, loadRelationships, validateEntities };