import type { SafetyOptions } from '../types/safety';
/**
 * Configuration interface for the Prisma Zod Generator
 */
export interface GeneratorConfig {
    /** Generation mode: full (default), minimal, or custom */
    mode?: 'full' | 'minimal' | 'custom';
    /** Output directory for generated schemas */
    output?: string;
    /**
     * Control file output mode.
     * When true (default), generate multiple files (current behavior).
     * When false, generate a single bundled file with all schemas.
     */
    useMultipleFiles?: boolean;
    /**
     * Name of the single bundled file when useMultipleFiles is false.
     * Default: "schemas.ts"
     */
    singleFileName?: string;
    /**
     * When useMultipleFiles is false, place the single bundled file at the generator output root
     * instead of inside the schemas/ subdirectory. Default: true (root).
     */
    placeSingleFileAtRoot?: boolean;
    /** Whether to generate pure model schemas */
    pureModels?: boolean;
    /** When generating pure model schemas, emit a lean version without JSDoc/stats/comments. Default: true */
    pureModelsLean?: boolean;
    /** When pureModels are enabled, include relation fields in generated model objects. Default: false (relations omitted). */
    pureModelsIncludeRelations?: boolean;
    /** When pureModelsIncludeRelations is true, exclude relation fields that would create circular references. Default: false */
    pureModelsExcludeCircularRelations?: boolean;
    /** Strategy for DateTime scalar mapping in pure models and variants. Default: 'date' */
    dateTimeStrategy?: 'date' | 'coerce' | 'isoString';
    /**
     * When true, apply a split strategy by default when no dateTimeStrategy is set:
     * - Inputs: coerce (z.coerce.date()) to accept ISO strings from JSON clients
     * - Pure models and result schemas: date (z.date())
     * Default: true. Note: Explicit dateTimeStrategy overrides this behavior.
     */
    dateTimeSplitStrategy?: boolean;
    /**
     * Generate schemas compatible with z.toJSONSchema() for API documentation.
     * When enabled, overrides dateTimeStrategy and removes transforms.
     * Trade-off: No runtime type conversion (strings instead of Date objects).
     * Default: false
     */
    jsonSchemaCompatible?: boolean;
    /** Options for JSON Schema compatibility mode */
    jsonSchemaOptions?: {
        /** Format for DateTime fields. Default: 'isoString' */
        dateTimeFormat?: 'isoString' | 'isoDate';
        /** Format for BigInt fields. Default: 'string' */
        bigIntFormat?: 'string' | 'number';
        /** Format for Bytes fields. Default: 'base64String' */
        bytesFormat?: 'base64String' | 'hexString';
        /** JSON Schema conversion options to use with z.toJSONSchema() */
        conversionOptions?: {
            /** How to handle unrepresentable types. Default: 'any' */
            unrepresentable?: 'throw' | 'any';
            /** How to handle circular references. Default: 'throw' */
            cycles?: 'ref' | 'throw';
            /** How to handle reused schemas. Default: 'inline' */
            reused?: 'inline' | 'ref';
        };
    };
    /** How to handle optional fields in Zod schemas. Default: 'nullish' */
    optionalFieldBehavior?: 'optional' | 'nullable' | 'nullish';
    /**
     * Strategy for Decimal scalar mapping.
     * - 'number': Map to z.number() (legacy behavior, may lose precision)
     * - 'string': Map to z.string() with decimal regex validation
     * - 'decimal': Full Decimal.js support with Prisma.Decimal and optional Decimal.js instances (matches zod-prisma-types)
     * Default: 'decimal'
     */
    decimalMode?: 'number' | 'string' | 'decimal';
    /** Global field exclusions */
    globalExclusions?: {
        input?: string[];
        result?: string[];
        pure?: string[];
        operations?: string[];
    };
    /** Variant configuration */
    variants?: {
        pure?: VariantConfig;
        input?: VariantConfig;
        result?: VariantConfig;
    };
    /** Per-model configuration */
    models?: Record<string, ModelConfig>;
    /** Legacy options for backward compatibility */
    addSelectType?: boolean;
    addIncludeType?: boolean;
    /**
     * When true (default), Create-like input schemas bypass exclusions and strictly
     * match Prisma types. When false, exclusions may apply to Create-like inputs.
     */
    strictCreateInputs?: boolean;
    /**
     * When strictCreateInputs is false, preserve required non-auto scalar fields
     * (e.g., required id without default) in Create-like inputs even if excluded.
     * Default: true.
     */
    preserveRequiredScalarsOnCreate?: boolean;
    /**
     * When true, operation Args that accept Create-like inputs should be typed
     * from the generated Zod schema (or its inferred type) instead of Prisma.*.
     * Default: false. Note: current generator primarily types object schemas; this
     * flag is reserved for Args typing alignment where applicable.
     */
    inferCreateArgsFromSchemas?: boolean;
    /**
     * When using array-based variants, place generated variant files at schemas root.
     * If false, place them under a variants/ directory with an index.ts. Default: true (root).
     */
    placeArrayVariantsAtRoot?: boolean;
    /**
     * Whether to run formatter on generated schemas. Skipping formatting improves performance.
     * Default: false (do not format schemas).
     */
    formatGeneratedSchemas?: boolean;
    /** Naming customization (experimental) */
    naming?: {
        /** Apply a preset for quick migration */
        preset?: 'default' | 'zod-prisma' | 'zod-prisma-types' | 'legacy-model-suffix';
        /** Pure model naming overrides */
        pureModel?: {
            /** File name pattern, tokens: {Model} {model} {camel} {kebab}; must end with .ts */
            filePattern?: string;
            /** Suffix appended to schema const (default Schema) */
            schemaSuffix?: string;
            /** Suffix appended to inferred type export (default Type) */
            typeSuffix?: string;
            /** Pattern for export variable name. Tokens: {Model} {SchemaSuffix} */
            exportNamePattern?: string;
            /** Emit legacy alias exports (e.g. UserModel) */
            legacyAliases?: boolean;
        };
        /** CRUD operation schema naming overrides */
        schema?: {
            /** File name pattern, tokens: {Model} {model} {camel} {kebab}; must end with .ts */
            filePattern?: string;
            /** Pattern for export variable name. Tokens: {Model} {model} {Operation} */
            exportNamePattern?: string;
        };
        /** Input object naming overrides */
        input?: {
            /** File name pattern, tokens: {Model} {model} {camel} {kebab} {InputType}; must end with .ts */
            filePattern?: string;
            /** Pattern for export variable name. Tokens: {Model} {model} {InputType} */
            exportNamePattern?: string;
        };
        /** Enum naming overrides */
        enum?: {
            /** File name pattern, tokens: {Enum} {enum} {camel} {kebab}; must end with .ts */
            filePattern?: string;
            /** Pattern for export variable name. Tokens: {Enum} {enum} */
            exportNamePattern?: string;
        };
    };
    /**
     * Controls how Zod is imported in generated files.
     * - auto (default): import from 'zod' (compatible with Zod v3 and v4)
     * - v3: force import from 'zod'
     * - v4: import from 'zod/v4'
     */
    zodImportTarget?: 'auto' | 'v3' | 'v4';
    /**
     * Custom module path to import `z` from instead of 'zod' (issue #370).
     * Lets users point `z` at their own re-export configured with an i18n error
     * map, etc. The binding style still follows {@link zodImportTarget}, so the
     * custom module must export `z` to match ('import * as z' for auto/v4,
     * 'import { z }' for v3).
     */
    zodImportPath?: string;
    /** Global strict mode configuration for generated Zod schemas */
    strictMode?: {
        /** Global default for strict mode on all schemas (backward compatibility). Default: true */
        enabled?: boolean;
        /** Apply strict mode to operation schemas (findMany, create, etc.). Default: true */
        operations?: boolean;
        /** Apply strict mode to object schemas (WhereInput, CreateInput, etc.). Default: true */
        objects?: boolean;
        /** Apply strict mode to variant schemas (pure, input, result). Default: true */
        variants?: boolean;
    };
    /**
     * Explicit emission controls. When provided, these booleans override heuristic
     * behaviors (minimal mode, pure-variant-only, etc.) for the respective groups.
     * Omitting a key preserves legacy behavior for that group.
     */
    emit?: {
        /** Generate enum schemas (referenced by inputs / crud). Default true */
        enums?: boolean;
        /** Generate object/input schemas (objects/ directory). Default true unless heuristics suppress. */
        objects?: boolean;
        /** Generate CRUD operation argument schemas (findUnique, createOne, ...). Default true unless heuristics suppress. */
        crud?: boolean;
        /** Generate result schemas (results/ directory). Default legacy gating (disabled by minimal mode or variants.result.enabled === false). */
        results?: boolean;
        /** Generate pure model schemas (mirrors pureModels flag if unspecified). */
        pureModels?: boolean;
        /** Generate variant wrapper schemas (variants/ directory & index). Default true if any variant enabled. */
        variants?: boolean;
    };
    /**
     * Safety system configuration to protect user code from accidental deletion.
     * Controls how the generator handles potentially dangerous output paths.
     */
    safety?: SafetyOptions;
    /**
     * Validation: add an opt-in check to WhereUniqueInput schemas requiring
     * at least one top-level unique selector to be present. Default: false.
     *
     * Notes:
     * - This does NOT enforce "exactly one" and does NOT inspect nested
     *   composite fields; it only checks top-level selector keys.
     * - Prisma still enforces selector correctness at runtime.
     */
    validateWhereUniqueAtLeastOne?: boolean;
}
/**
 * Variant configuration interface
 */
export interface VariantConfig {
    /** Whether this variant is enabled */
    enabled?: boolean;
    /** File suffix for this variant */
    suffix?: string;
    /** Fields to exclude from this variant */
    excludeFields?: string[];
    /** Apply .partial() to the generated schema, making all fields optional */
    partial?: boolean;
    /** Override strict mode for this variant (null uses global/parent setting) */
    strictMode?: boolean | null;
}
/**
 * Model-specific configuration interface
 */
export interface ModelConfig {
    /** Whether this model should be generated */
    enabled?: boolean;
    /** Which operations to generate for this model */
    operations?: string[];
    /** Strict mode configuration for this model */
    strictMode?: {
        /** Override global strict mode for this model (null uses global setting) */
        enabled?: boolean | null;
        /** Control strict mode for specific operations (boolean for all, array for specific, null for global) */
        operations?: boolean | string[] | null;
        /** Operations to exclude from strict mode */
        exclude?: string[];
        /** Override strict mode for object schemas of this model (null uses global setting) */
        objects?: boolean | null;
        /** Per-variant strict mode overrides for this model */
        variants?: {
            pure?: boolean | null;
            input?: boolean | null;
            result?: boolean | null;
        };
    };
    /** Variant-specific configuration for this model */
    variants?: {
        pure?: VariantConfig;
        input?: VariantConfig;
        result?: VariantConfig;
    };
}
/**
 * Configuration parsing result
 */
export interface ParseResult {
    /** The parsed configuration */
    config: GeneratorConfig;
    /** Path to the configuration file that was loaded */
    configPath?: string;
    /** Whether this is using default configuration */
    isDefault: boolean;
}
/**
 * Configuration parsing error
 */
export declare class ConfigParseError extends Error {
    readonly cause?: Error | undefined;
    readonly filePath?: string | undefined;
    constructor(message: string, cause?: Error | undefined, filePath?: string | undefined);
}
/**
 * Discover configuration file in standard locations
 */
export declare function discoverConfigFile(baseDir?: string): Promise<string | null>;
/**
 * Validate that a file exists and is readable
 */
export declare function validateFileExists(filePath: string): Promise<void>;
/**
 * Read configuration file content from disk
 */
export declare function readConfigFile(filePath: string): Promise<string>;
/**
 * Parse JSON configuration content
 */
export declare function parseJsonConfig(content: string, filePath?: string): GeneratorConfig;
/**
 * Resolve configuration file path (handle relative paths)
 */
export declare function resolveConfigPath(configPath: string, baseDir?: string): string;
/**
 * Parse configuration from file path
 */
export declare function parseConfigFromFile(configPath: string, baseDir?: string): Promise<ParseResult>;
/**
 * Auto-discover and parse configuration file
 */
export declare function parseConfigFromDiscovery(baseDir?: string): Promise<ParseResult>;
/**
 * Main configuration parser function
 *
 * @param configPath - Optional path to configuration file
 * @param baseDir - Base directory for resolving relative paths
 * @returns Parsed configuration result
 */
export declare function parseConfiguration(configPath?: string, baseDir?: string): Promise<ParseResult>;
/**
 * Create a detailed error message for configuration parsing failures
 */
export declare function createConfigErrorMessage(error: ConfigParseError): string;