import type { EnvField } from "../introspect.js";
export interface JsonSchemaOptions {
    /** `title` field. Default: `"Environment Variables"`. */
    title?: string;
    /** Optional `$id` URL identifying this schema. */
    $id?: string;
    /** `description` field. */
    description?: string;
    /**
     * Override the `$schema` URL. Default: Draft 2020-12.
     */
    $schema?: string;
    /**
     * When true (default), include the non-standard `x-secret: true`
     * extension on secret fields in addition to `format: "password"`.
     * Some validators only look at one or the other.
     */
    includeXSecret?: boolean;
}
/**
 * Generate a JSON Schema document describing the env contract.
 *
 * Useful for:
 *   - **IDE / editor integration** — schema-aware completion in JSON
 *     env config files, validation in CI tooling.
 *   - **AI assistants** — a standard machine-readable description of
 *     what env vars the app expects.
 *   - **OpenAPI bridging** — fold the env contract into a wider API
 *     spec.
 *
 * Returns a pretty-printed JSON string (always ends in a newline).
 */
export declare function generateJsonSchema(fields: readonly EnvField[], options?: JsonSchemaOptions): string;
//# sourceMappingURL=json-schema.d.ts.map