export declare const STYLEPROOF_CONFIG_FILE = "styleproof.config.json"; /** `styleproof-affected` inputs a consumer can pin once instead of per-invocation. */ export type AffectedConfig = { /** Capture key → surface entry module path (repo-relative, as in the graph). */ surfaces?: Record; /** Path to a dependency-cruiser JSON for the source tree. */ graph?: string; /** Default git base ref for changed-file derivation (e.g. "origin/main"). */ base?: string; }; /** Pre-map / crawl adoption knobs a consumer can pin once in styleproof.config.json. */ export type CrawlConfig = { /** Running app origin for pre-map crawl / one-shot crawl (e.g. http://127.0.0.1:3000). */ baseUrl?: string; /** Route paths or key=path entries for the crawl. */ routes?: string[]; /** JSON setup steps file (env-interpolated). Never put secrets here — use ${ENV}. */ setup?: string; /** JSON auth-boundary exclusion file (key → reason). Limited evidence only. */ authBoundaryExclude?: string; /** Fail when live-state fixtures or skipped candidates remain. */ strict?: boolean; /** Variant crawl manifest output path. */ out?: string; /** Max attempted actions per route. */ maxActions?: number; /** Crawl viewport width. */ width?: number; /** Crawl viewport height. */ height?: number; }; export type StyleProofConfig = { /** Review-gate failures block the Action unless explicitly false. */ blocking?: boolean; /** Unacknowledged inventory removals block unless explicitly false. */ gateInventoryRemovals?: boolean; /** Capture spec path (default e2e/styleproof.spec.ts). */ spec?: string; /** Tracked files/dirs whose changes never mark a capture dirty. */ dirtyAllow?: string[]; /** Map store branch (default styleproof-maps). */ cacheBranch?: string; /** Git remote for the map store (default origin). */ remote?: string; affected?: AffectedConfig; /** Closed-world crawl / auth-boundary adoption block. */ crawl?: CrawlConfig; }; export declare class StyleProofConfigError extends Error { } /** Load and validate the repo's styleproof.config.json. Missing file → `{}`; * unreadable/malformed file or a wrongly-typed known key → {@link StyleProofConfigError}; * unknown keys → a loud stderr warning (never silently dropped). */ export declare function loadStyleProofConfig(cwd?: string): StyleProofConfig;