import type { SanityPlugin } from '../plugins/types.js';
export interface ShortcutConfig {
    readonly key: string;
    readonly label: string;
    readonly message: string;
}
export interface SanityConfig {
    readonly enabled?: boolean;
    readonly maxFileSizeWarn?: number;
    readonly maxFileSizeError?: number;
    readonly blockEnvFiles?: boolean;
    readonly envFileAllowlist?: ReadonlyArray<string>;
    readonly detectSecrets?: boolean;
    readonly blockPrivateKeys?: boolean;
    readonly skipPaths?: ReadonlyArray<string>;
    /**
     * Explicit plugin list. When set, overrides the default plugin set
     * derived from the legacy boolean flags. Use {@link defaultPlugins}
     * (re-exported from `@super-repo/czar`) plus any custom plugins to
     * compose your own set:
     *
     * ```ts
     * import { defineConfig, defaultPlugins, envxAuditPlugin } from '@super-repo/czar'
     *
     * export default defineConfig({
     *   sanity: {
     *     plugins: [
     *       ...defaultPlugins(),
     *       envxAuditPlugin({ scope: 'staged' }),
     *     ],
     *   },
     * })
     * ```
     */
    readonly plugins?: ReadonlyArray<SanityPlugin>;
}
export interface AiConfig {
    readonly enabled?: boolean;
    readonly provider?: 'anthropic' | 'openai';
    readonly model?: string;
    readonly apiKeyEnv?: string;
    readonly baseUrl?: string;
    readonly headers?: Readonly<Record<string, string>>;
    readonly requireApiKey?: boolean;
    readonly logLines?: number;
    readonly maxDiffBytes?: number;
}
export interface CzarConfig {
    readonly extends?: string | ReadonlyArray<string>;
    readonly body?: boolean;
    readonly strict?: boolean;
    readonly shortcuts?: ReadonlyArray<ShortcutConfig>;
    /**
     * Sanity (commit-gate) configuration. Three accepted shapes:
     *
     *   - `true`           — run the default plugin set (large-file,
     *                        env-file, private-key-file, secret-scan,
     *                        standard-env-audit). Identical to omitting
     *                        the field.
     *   - `false`          — disable every sanity check.
     *   - `SanityConfig`   — full object with optional `plugins:`. The
     *                        legacy flag fields (maxFileSize*, blockEnvFiles,
     *                        detectSecrets, blockPrivateKeys, …) keep working
     *                        as defaults for the built-in plugin set.
     */
    readonly sanity?: SanityConfig | boolean;
    readonly ai?: AiConfig;
}
export declare function defineConfig(config: CzarConfig): CzarConfig;
export declare const DEFAULT_ENV_ALLOWLIST: ReadonlyArray<string>;
export declare const DEFAULT_SKIP_PATHS: ReadonlyArray<string>;
export declare const DEFAULT_BUILTIN_SHORTCUTS: ReadonlyArray<ShortcutConfig>;
export declare const DEFAULT_SANITY: Required<Omit<SanityConfig, 'envFileAllowlist' | 'skipPaths' | 'plugins'>> & {
    readonly envFileAllowlist: ReadonlyArray<string>;
    readonly skipPaths: ReadonlyArray<string>;
};
export declare const DEFAULT_AI: Required<Omit<AiConfig, 'baseUrl' | 'headers'>> & {
    readonly baseUrl: string | undefined;
    readonly headers: Readonly<Record<string, string>>;
};
export declare class CzarConfigError extends Error {
    readonly field?: string | undefined;
    constructor(message: string, field?: string | undefined);
}
export declare function parseConfig(raw: unknown): CzarConfig;
//# sourceMappingURL=schema.d.ts.map