@doccov/sdk 0.30.7 → 0.31.0

package/dist/index.d.ts

@@ -1,4 +1,195 @@
-import { DocCovSpec, TypeReferenceLocation } from "@doccov/spec";
+import { DocCovSpec, ExportAnalysis, TypeReferenceLocation } from "@doccov/spec";
+/**
+* Configuration types for DocCov.
+* These types are shared between CLI and API.
+*/
+/**
+* Documentation configuration options.
+*/
+interface DocsConfig {
+	/** Glob patterns for markdown docs to include */
+	include?: string[];
+	/** Glob patterns for markdown docs to exclude */
+	exclude?: string[];
+}
+/**
+* Example validation modes.
+*/
+type ExampleValidationMode = "presence" | "typecheck" | "run";
+/**
+* Documentation style presets.
+*
+* - 'minimal': Only description required (default)
+* - 'verbose': Description, params, returns all required
+* - 'types-only': No documentation required (rely on TypeScript types)
+*/
+type StylePreset = "minimal" | "verbose" | "types-only";
+/**
+* Fine-grained documentation requirements.
+* Use with `require` config to override preset defaults.
+*/
+interface DocRequirements {
+	/** Require description/summary */
+	description?: boolean;
+	/** Require @param tags for function parameters */
+	params?: boolean;
+	/** Require @returns tag for functions */
+	returns?: boolean;
+	/** Require @example blocks */
+	examples?: boolean;
+	/** Require @since tag */
+	since?: boolean;
+}
+/**
+* Schema extraction modes for validation libraries (Zod, Valibot, TypeBox, ArkType).
+*
+* - 'static': TypeScript Compiler API only (no runtime, always safe)
+* - 'runtime': Standard Schema runtime extraction (requires built package)
+* - 'hybrid': Try runtime first, fall back to static
+*/
+type SchemaExtractionMode = "static" | "runtime" | "hybrid";
+/**
+* API surface configuration options.
+*/
+interface ApiSurfaceConfig {
+	/** Minimum completeness percentage to pass (0-100) */
+	minCompleteness?: number;
+	/** Warning threshold - warn when below this (0-100) */
+	warnBelow?: number;
+	/** Type names to ignore (won't be flagged as forgotten exports) */
+	ignore?: string[];
+}
+/**
+* Check command configuration options.
+*/
+interface CheckConfig {
+	/**
+	* Example validation modes to run.
+	* Can be a single mode, array of modes, or comma-separated string.
+	* - 'presence': Check that @example blocks exist on exports
+	* - 'typecheck': Compile examples with TypeScript
+	* - 'run': Execute examples and validate assertions
+	*/
+	examples?: ExampleValidationMode | ExampleValidationMode[] | string;
+	/** Minimum health score required (0-100). Unified metric combining coverage + accuracy. */
+	minHealth?: number;
+	/** @deprecated Use minHealth instead */
+	minCoverage?: number;
+	/** @deprecated Use minHealth instead */
+	maxDrift?: number;
+	/** API surface configuration */
+	apiSurface?: ApiSurfaceConfig;
+	/**
+	* Documentation style preset.
+	* - 'minimal': Only description required (default)
+	* - 'verbose': Description, params, returns all required
+	* - 'types-only': No documentation required
+	*/
+	style?: StylePreset;
+	/**
+	* Fine-grained documentation requirements.
+	* Overrides preset defaults for specific rules.
+	*/
+	require?: DocRequirements;
+}
+/**
+* Normalized DocCov configuration.
+* This is the parsed/normalized form used by commands.
+*/
+interface DocCovConfig {
+	/** Export include patterns */
+	include?: string[];
+	/** Export exclude patterns */
+	exclude?: string[];
+	/** Plugins (future) */
+	plugins?: unknown[];
+	/** Documentation configuration */
+	docs?: DocsConfig;
+	/** Check command configuration */
+	check?: CheckConfig;
+	/**
+	* Schema extraction mode for validation libraries.
+	*
+	* - 'static' (default): Safe, uses TypeScript Compiler API
+	* - 'runtime': Uses Standard Schema (requires built package)
+	* - 'hybrid': Tries runtime first, falls back to static
+	*
+	* Runtime extraction provides richer JSON Schema output (formats, patterns)
+	* but requires the package to be built first.
+	*/
+	schemaExtraction?: SchemaExtractionMode;
+}
+/**
+* Define a DocCov configuration.
+* Helper function for type-safe configuration in doccov.config.ts.
+*
+* @param config - Configuration object
+* @returns The configuration object (for type inference)
+*
+* @example
+* ```typescript
+* // doccov.config.ts
+* import { defineConfig } from '@doccov/sdk';
+*
+* defineConfig({
+*   include: ['MyClass', 'myFunction'],
+*   exclude: ['internal*'],
+*   check: {
+*     minHealth: 80,
+*   },
+* });
+* ```
+*/
+declare function defineConfig(config: DocCovConfig): DocCovConfig;
+/**
+* Documentation style presets for DocCov.
+*
+* Presets define expected documentation patterns that vary by project.
+* Some projects require verbose docs with @param/@returns for every function,
+* while others rely on TypeScript types and only need descriptions.
+*/
+/**
+* Documentation requirements - what must be present for an to be considered documented.
+*/
+interface DocRequirements2 {
+	/** Require description/summary */
+	description: boolean;
+	/** Require @param tags for function parameters */
+	params: boolean;
+	/** Require @returns tag for functions */
+	returns: boolean;
+	/** Require @example blocks */
+	examples: boolean;
+	/** Require @since tag */
+	since: boolean;
+}
+/**
+* Style preset names.
+*/
+type StylePreset2 = "minimal" | "verbose" | "types-only";
+/**
+* Default requirements (when no preset/custom config provided).
+* Same as 'minimal' - just description required.
+*/
+declare const DEFAULT_REQUIREMENTS: DocRequirements2;
+/**
+* Preset definitions.
+*
+* | Preset     | description | params   | returns  | examples |
+* |------------|-------------|----------|----------|----------|
+* | minimal    | required    | optional | optional | optional |
+* | verbose    | required    | required | required | optional |
+* | types-only | optional    | optional | optional | optional |
+*/
+declare const PRESETS: Record<StylePreset2, DocRequirements2>;
+/**
+* Resolve documentation requirements from config.
+*
+* @param style - Style preset name
+* @param require - Custom requirements (overrides preset)
+* @returns Resolved requirements
+*/
+declare function resolveRequirements(style?: StylePreset2, require?: Partial<DocRequirements2>): DocRequirements2;
 import { OpenPkg } from "@openpkg-ts/spec";
 type OpenPkgSpec = OpenPkg;
 /** Forgotten from extract package (different shape than spec type) */
@@ -22,6 +213,23 @@ interface BuildDocCovOptions {
 	forgottenExports?: ExtractForgottenExport[];
 	/** Type names to ignore in API surface calculation */
 	apiSurfaceIgnore?: string[];
+	/**
+	* Export names from the package entry point.
+	* When analyzing a sub-file, provide this to filter out false positive
+	* "forgotten" exports that are actually exported from the main entry.
+	*/
+	entryExportNames?: string[];
+	/** Progress callback for long-running analysis */
+	onProgress?: (current: number, total: number, item: string) => void;
+	/**
+	* Callback invoked after each is analyzed.
+	* Can be used for incremental persistence (crash recovery).
+	*/
+	onExportAnalyzed?: (id: string, name: string, analysis: ExportAnalysis, index: number, total: number) => void | Promise<void>;
+	/** Documentation style preset */
+	style?: StylePreset;
+	/** Custom documentation requirements (overrides preset) */
+	require?: Partial<DocRequirements2>;
 }
 /**
 * Build a DocCov spec from an OpenPkg spec.
@@ -29,7 +237,7 @@ interface BuildDocCovOptions {
 * @param options - Build options
 * @returns DocCov specification with coverage analysis
 */
-declare function buildDocCovSpec(options: BuildDocCovOptions): DocCovSpec;
+declare function buildDocCovSpec(options: BuildDocCovOptions): Promise<DocCovSpec>;
 /**
 * All possible drift type identifiers.
 */
@@ -38,6 +246,11 @@ type SpecDocDrift = {
 	type: DriftType;
 	target?: string;
 	issue: string;
+	/** Expected value from JSDoc/documentation */
+	expected?: string;
+	/** Actual value from TypeScript signature/code */
+	actual?: string;
+	/** Actionable suggestion for fixing the drift */
 	suggestion?: string;
 };
 /**
@@ -171,6 +384,93 @@ declare function getDriftSummary(drifts: SpecDocDrift[]): DriftSummary;
 */
 declare function formatDriftSummaryLine(summary: DriftSummary): string;
 import { SpecExport } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg2 } from "@openpkg-ts/spec";
+/**
+* Information about a module in the graph.
+*/
+interface ModuleInfo {
+	/**
+	* Module name (package name).
+	*/
+	name: string;
+	/**
+	* Set of exported symbol names from this module.
+	*/
+	exports: Set<string>;
+	/**
+	* Set of type names exported from this module.
+	*/
+	types: Set<string>;
+}
+/**
+* Graph of modules and their exported symbols for cross-module validation.
+*/
+interface ModuleGraph {
+	/**
+	* Map of module names to their info.
+	*/
+	modules: Map<string, ModuleInfo>;
+	/**
+	* Map of symbol names to the module that exports them.
+	* For symbols exported from multiple modules, contains the first found.
+	*/
+	exports: Map<string, string>;
+	/**
+	* Map of type names to the module that exports them.
+	*/
+	types: Map<string, string>;
+	/**
+	* Combined set of all exported symbol and type names across all modules.
+	*/
+	all: Set<string>;
+}
+/**
+* Build a module graph from multiple OpenPkg specs.
+*
+* Used for cross-module @link validation in batch mode.
+*
+* @param specs - Array of OpenPkg specs to build graph from
+* @returns ModuleGraph for cross-module symbol lookup
+*
+* @example
+* ```ts
+* import { buildModuleGraph } from '@doccov/sdk';
+*
+* const graph = buildModuleGraph([pkg1Spec, pkg2Spec]);
+*
+* // Check if symbol exists in any module
+* if (graph.all.has('Schedule')) {
+*   console.log(`Schedule is exported from: ${graph.exports.get('Schedule')}`);
+* }
+* ```
+*/
+declare function buildModuleGraph(specs: OpenPkg2[]): ModuleGraph;
+/**
+* Check if a symbol exists in the module graph.
+*
+* @param graph - Module graph to search
+* @param symbol - Symbol name to find
+* @returns Module name if found, undefined otherwise
+*/
+declare function findSymbolModule(graph: ModuleGraph, symbol: string): string | undefined;
+/**
+* Check if a symbol exists anywhere in the module graph.
+*
+* @param graph - Module graph to search
+* @param symbol - Symbol name to check
+* @returns true if symbol exists in any module
+*/
+declare function symbolExistsInGraph(graph: ModuleGraph, symbol: string): boolean;
+/**
+* Options for computing drift.
+*/
+interface ComputeDriftOptions {
+	/**
+	* Module graph for cross-module @link validation.
+	* When provided, @link targets are validated across all modules.
+	*/
+	moduleGraph?: ModuleGraph;
+}
 /**
 * Build a registry of all export/type names for cross-reference validation.
 */
@@ -179,16 +479,18 @@ declare function buildExportRegistry(spec: OpenPkgSpec): ExportRegistry;
 * Compute drift for all exports in a spec.
 *
 * @param spec - The OpenPkg spec to analyze
+* @param options - Optional config including moduleGraph for cross-module validation
 * @returns Drift results per */
-declare function computeDrift(spec: OpenPkgSpec): DriftResult;
+declare function computeDrift(spec: OpenPkgSpec, options?: ComputeDriftOptions): DriftResult;
 /**
 * Compute drift for a single export.
 *
 * @param entry - The to analyze
 * @param registry - Registry of known exports and types for validation
+* @param options - Optional config including moduleGraph for cross-module validation
 * @returns Array of drift issues detected
 */
-declare function computeExportDrift(entry: SpecExport, registry?: ExportRegistry): SpecDocDrift[];
+declare function computeExportDrift(entry: SpecExport, registry?: ExportRegistry, options?: ComputeDriftOptions): SpecDocDrift[];
 /**
 * Calculate aggregate coverage score from a spec's exports.
 *
@@ -307,6 +609,15 @@ declare function hasNonAssertionComments(code: string): boolean;
 */
 declare function detectExampleAssertionFailures(entry: SpecExport2, runtimeResults: Map<number, ExampleRunResult>): SpecDocDrift[];
 import { DocumentationHealth, DriftCategory as DriftCategory2, MissingDocRule } from "@doccov/spec";
+import { SpecExport as SpecExport7 } from "@openpkg-ts/spec";
+/**
+* Check if an has meaningful documentation.
+* An is considered documented if it has:
+* - A description
+* - Meaningful JSDoc tags
+* - For namespaces: description counts as documented (no examples required)
+*/
+declare function isExportDocumented(exp: SpecExport7): boolean;
 /**
 * Input data for computing documentation health score.
 */
@@ -342,8 +653,8 @@ interface HealthInput {
 * Score thresholds: green 80+, yellow 60-79, red <60
 */
 declare function computeHealth(input: HealthInput): DocumentationHealth;
-import { DocCovDrift, DocCovSpec as DocCovSpec2, ExportAnalysis, MissingDocRule as MissingDocRule2 } from "@doccov/spec";
-import { SpecExport as SpecExport7 } from "@openpkg-ts/spec";
+import { DocCovDrift, DocCovSpec as DocCovSpec2, ExportAnalysis as ExportAnalysis2, MissingDocRule as MissingDocRule2 } from "@doccov/spec";
+import { SpecExport as SpecExport8 } from "@openpkg-ts/spec";
 /**
 * Get the full analysis data for an export.
 *
@@ -351,7 +662,7 @@ import { SpecExport as SpecExport7 } from "@openpkg-ts/spec";
 * @param doccov - The DocCov spec containing analysis data
 * @returns Export analysis or undefined if not found
 */
-declare function getExportAnalysis(exp: SpecExport7, doccov: DocCovSpec2): ExportAnalysis | undefined;
+declare function getExportAnalysis(exp: SpecExport8, doccov: DocCovSpec2): ExportAnalysis2 | undefined;
 /**
 * Get the coverage score for an export.
 *
@@ -359,7 +670,7 @@ declare function getExportAnalysis(exp: SpecExport7, doccov: DocCovSpec2): Expor
 * @param doccov - The DocCov spec containing analysis data
 * @returns Coverage score (0-100) or 100 if not found
 */
-declare function getExportScore(exp: SpecExport7, doccov: DocCovSpec2): number;
+declare function getExportScore(exp: SpecExport8, doccov: DocCovSpec2): number;
 /**
 * Get drift issues for an export.
 *
@@ -367,7 +678,7 @@ declare function getExportScore(exp: SpecExport7, doccov: DocCovSpec2): number;
 * @param doccov - The DocCov spec containing analysis data
 * @returns Array of drift issues or empty array if none
 */
-declare function getExportDrift(exp: SpecExport7, doccov: DocCovSpec2): DocCovDrift[];
+declare function getExportDrift(exp: SpecExport8, doccov: DocCovSpec2): DocCovDrift[];
 /**
 * Get missing documentation rules for an export.
 *
@@ -375,7 +686,7 @@ declare function getExportDrift(exp: SpecExport7, doccov: DocCovSpec2): DocCovDr
 * @param doccov - The DocCov spec containing analysis data
 * @returns Array of missing rule IDs or empty array if none
 */
-declare function getExportMissing(exp: SpecExport7, doccov: DocCovSpec2): MissingDocRule2[];
+declare function getExportMissing(exp: SpecExport8, doccov: DocCovSpec2): MissingDocRule2[];
 /**
 * Check if an has complete documentation.
 *
@@ -383,9 +694,9 @@ declare function getExportMissing(exp: SpecExport7, doccov: DocCovSpec2): Missin
 * @param doccov - The DocCov spec containing analysis data
 * @returns True if has 100% coverage and no drift
 */
-declare function isExportFullyDocumented(exp: SpecExport7, doccov: DocCovSpec2): boolean;
+declare function isExportFullyDocumented(exp: SpecExport8, doccov: DocCovSpec2): boolean;
 import { DocCovSpec as DocCovSpec3 } from "@doccov/spec";
-import { OpenPkg as OpenPkg2 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg3 } from "@openpkg-ts/spec";
 import { ApiSurfaceResult, DocumentationHealth as DocumentationHealth2 } from "@doccov/spec";
 /**
 * DocCov report schema version.
@@ -527,6 +838,10 @@ interface ExportCoverageData {
 	* Drift issues for this export.
 	*/
 	drift?: SpecDocDrift[];
+	/**
+	* Number of overloads if > 1 (for overloaded functions).
+	*/
+	overloadCount?: number;
 }
 /**
 * DocCov report - a persistable coverage analysis result.
@@ -589,7 +904,7 @@ interface DocCovReport {
 * console.log(`Coverage: ${report.coverage.score}%`);
 * ```
 */
-declare function generateReport(spec: OpenPkg2, openpkgPath?: string): DocCovReport;
+declare function generateReport(spec: OpenPkg3, openpkgPath?: string): Promise<DocCovReport>;
 /**
 * Generate a DocCov report from OpenPkg spec + DocCov spec composition.
 *
@@ -600,7 +915,7 @@ declare function generateReport(spec: OpenPkg2, openpkgPath?: string): DocCovRep
 * @param doccov - The DocCov spec with analysis data
 * @returns A DocCov report with coverage analysis
 */
-declare function generateReportFromDocCov(openpkg: OpenPkg2, doccov: DocCovSpec3): DocCovReport;
+declare function generateReportFromDocCov(openpkg: OpenPkg3, doccov: DocCovSpec3): DocCovReport;
 /**
 * Load a cached DocCov report from disk.
 *
@@ -635,7 +950,247 @@ declare function saveReport(report: DocCovReport, reportPath?: string): void;
 * fs.writeFileSync('api-surface.md', apiSurface);
 * ```
 */
-declare function renderApiSurface(spec: OpenPkg2): string;
+declare function renderApiSurface(spec: OpenPkg3): string;
+import { DocCovSpec as DocCovSpec4 } from "@doccov/spec";
+import { OpenPkg as OpenPkg4 } from "@openpkg-ts/spec";
+/**
+* Result from analyzing a single package in batch mode.
+*/
+interface PackageResult {
+	/**
+	* Package name (from openpkg.meta.name).
+	*/
+	name: string;
+	/**
+	* Package version (from openpkg.meta.version).
+	*/
+	version?: string;
+	/**
+	* Entry point path that was analyzed.
+	*/
+	entryPath: string;
+	/**
+	* Total number of exports.
+	*/
+	totalExports: number;
+	/**
+	* Number of documented exports.
+	*/
+	documented: number;
+	/**
+	* Health score (0-100).
+	*/
+	health: number;
+	/**
+	* Number of drift issues.
+	*/
+	driftCount: number;
+	/**
+	* Coverage score (0-100).
+	*/
+	coverageScore: number;
+	/**
+	* The full OpenPkg spec (for detailed reporting).
+	*/
+	openpkg: OpenPkg4;
+	/**
+	* The full DocCov spec (for detailed reporting).
+	*/
+	doccov: DocCovSpec4;
+}
+/**
+* Aggregated result from batch analysis.
+*/
+interface BatchResult {
+	/**
+	* Individual package results.
+	*/
+	packages: PackageResult[];
+	/**
+	* Aggregated metrics across all packages.
+	*/
+	aggregate: {
+		/**
+		* Total exports across all packages.
+		*/
+		totalExports: number;
+		/**
+		* Total documented exports across all packages.
+		*/
+		documented: number;
+		/**
+		* Weighted average health score.
+		*/
+		health: number;
+		/**
+		* Total drift issues across all packages.
+		*/
+		driftCount: number;
+		/**
+		* Weighted average coverage score.
+		*/
+		coverageScore: number;
+	};
+}
+/**
+* Create a PackageResult from analyzed specs.
+*
+* @param openpkg - The OpenPkg spec
+* @param doccov - The DocCov spec with coverage analysis
+* @param entryPath - Path to the entry point that was analyzed
+* @returns PackageResult for batch aggregation
+*/
+declare function createPackageResult(openpkg: OpenPkg4, doccov: DocCovSpec4, entryPath: string): PackageResult;
+/**
+* Aggregate results from multiple package analyses.
+*
+* Health and coverage scores are weighted by count so packages
+* with more exports have more influence on the aggregate.
+*
+* @param packages - Individual package results to aggregate
+* @returns BatchResult with aggregate metrics
+*
+* @example
+* ```ts
+* import { aggregateResults, createPackageResult } from '@doccov/sdk';
+*
+* const results = [
+*   createPackageResult(pkg1Openpkg, pkg1Doccov, 'packages/a/src/index.ts'),
+*   createPackageResult(pkg2Openpkg, pkg2Doccov, 'packages/b/src/index.ts'),
+* ];
+*
+* const batch = aggregateResults(results);
+* console.log(`Total health: ${batch.aggregate.health}%`);
+* ```
+*/
+declare function aggregateResults(packages: PackageResult[]): BatchResult;
+import { DocCovDrift as DocCovDrift2, ExportAnalysis as ExportAnalysis3, MissingDocRule as MissingDocRule3 } from "@doccov/spec";
+/**
+* Result from analyzing a single incrementally.
+*/
+interface IncrementalExportResult {
+	/** Export ID (usually name) */
+	id: string;
+	/** Export name */
+	name: string;
+	/** Coverage score (0-100) */
+	coverageScore: number;
+	/** Missing documentation rules */
+	missing?: MissingDocRule3[];
+	/** Drift issues detected */
+	drift?: DocCovDrift2[];
+	/** Number of overloads (if > 1) */
+	overloadCount?: number;
+	/** Timestamp when this result was written */
+	timestamp: number;
+}
+/**
+* Partial analysis state recovered from temp file.
+*/
+interface PartialAnalysisState {
+	/** Results collected before interruption */
+	results: IncrementalExportResult[];
+	/** Total exports that were expected */
+	totalExpected?: number;
+	/** Whether analysis was interrupted */
+	interrupted: boolean;
+}
+/**
+* Options for IncrementalAnalyzer.
+*/
+interface IncrementalAnalyzerOptions {
+	/** Custom temp directory (defaults to os.tmpdir()) */
+	tempDir?: string;
+	/** Prefix for temp file name */
+	prefix?: string;
+}
+/**
+* Analyzer that persists results incrementally for crash recovery.
+*
+* Usage:
+* ```ts
+* const analyzer = new IncrementalAnalyzer();
+* analyzer.setTotal(exports.length);
+*
+* for (const exp of exports) {
+*   const result = analyzeExport(exp);
+*   await analyzer.writeResult(result);
+* }
+*
+* // On success, clean up
+* analyzer.cleanup();
+*
+* // On crash, recover partial results:
+* const partial = await analyzer.getPartialResults();
+* ```
+*/
+declare class IncrementalAnalyzer {
+	private tempPath;
+	private totalExpected?;
+	private resultCount;
+	private fileHandle?;
+	constructor(options?: IncrementalAnalyzerOptions);
+	/**
+	* Get the temp file path (for debugging/logging).
+	*/
+	get path(): string;
+	/**
+	* Get count of results written so far.
+	*/
+	get count(): number;
+	/**
+	* Set total expected exports (for progress reporting).
+	*/
+	setTotal(total: number): void;
+	/**
+	* Initialize the file handle for writing.
+	* Called automatically on first writeResult, but can be called
+	* explicitly for eager initialization.
+	*/
+	init(): Promise<void>;
+	/**
+	* Write a single result to the temp file.
+	*/
+	writeResult(result: IncrementalExportResult): Promise<void>;
+	/**
+	* Write an analysis result (converts from ExportAnalysis format).
+	*/
+	writeExportAnalysis(id: string, name: string, analysis: ExportAnalysis3): Promise<void>;
+	/**
+	* Read partial results from the temp file.
+	* Returns empty array if file doesn't exist.
+	*/
+	getPartialResults(): Promise<PartialAnalysisState>;
+	/**
+	* Clean up the temp file. Call this on successful completion.
+	*/
+	cleanup(): Promise<void>;
+	/**
+	* Synchronous cleanup for use in signal handlers.
+	* Note: May lose last few writes that haven't been flushed.
+	*/
+	cleanupSync(): void;
+	/**
+	* Check if temp file exists (for recovery detection).
+	*/
+	exists(): boolean;
+	/**
+	* Get partial results synchronously (for signal handlers).
+	* May miss most recent writes.
+	*/
+	getPartialResultsSync(): PartialAnalysisState;
+}
+/**
+* Find any orphaned temp files from previous crashed runs.
+* Returns paths to .ndjson files that match the doccov pattern.
+*/
+declare function findOrphanedTempFiles(tempDir?: string, prefix?: string): string[];
+/**
+* Clean up orphaned temp files older than maxAge.
+*
+* @param maxAge - Maximum age in milliseconds (default: 1 hour)
+*/
+declare function cleanupOrphanedTempFiles(tempDir?: string, prefix?: string, maxAge?: number): number;
 /**
 * Compute a hash of file contents.
 * Uses truncated SHA-256 for balance of speed and collision resistance.
@@ -667,7 +1222,7 @@ declare function hashFiles(filePaths: string[], cwd: string): Record<string, str
 * @returns Array of file paths that changed, were added, or were removed
 */
 declare function diffHashes(cached: Record<string, string>, current: Record<string, string>): string[];
-import { OpenPkg as OpenPkg3 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg5 } from "@openpkg-ts/spec";
 /** Current cache format version - bump when spec extraction logic changes */
 declare const CACHE_VERSION = "1.3.0";
 /** Default cache file path */
@@ -731,7 +1286,7 @@ interface SpecCache {
 	/** Analysis configuration that affects output */
 	config: SpecCacheConfig;
 	/** The cached OpenPkg spec */
-	spec: OpenPkg3;
+	spec: OpenPkg5;
 	/** Cached spec-level diagnostics (info/warning messages from extraction) */
 	specDiagnostics?: CachedDiagnostic[];
 	/** Cached forgotten exports */
@@ -786,7 +1341,7 @@ declare function loadSpecCache(cwd: string): SpecCache | null;
 * @param spec - OpenPkg spec to cache
 * @param context - Cache context with file paths and config
 */
-declare function saveSpecCache(spec: OpenPkg3, context: CacheContext): void;
+declare function saveSpecCache(spec: OpenPkg5, context: CacheContext): void;
 /**
 * Validate if cached spec is still valid.
 *
@@ -835,112 +1390,6 @@ interface FilterOptions {
 	visibility?: ReleaseTag[];
 }
 import { z } from "zod";
-/**
-* Configuration types for DocCov.
-* These types are shared between CLI and API.
-*/
-/**
-* Documentation configuration options.
-*/
-interface DocsConfig {
-	/** Glob patterns for markdown docs to include */
-	include?: string[];
-	/** Glob patterns for markdown docs to exclude */
-	exclude?: string[];
-}
-/**
-* Example validation modes.
-*/
-type ExampleValidationMode = "presence" | "typecheck" | "run";
-/**
-* Schema extraction modes for validation libraries (Zod, Valibot, TypeBox, ArkType).
-*
-* - 'static': TypeScript Compiler API only (no runtime, always safe)
-* - 'runtime': Standard Schema runtime extraction (requires built package)
-* - 'hybrid': Try runtime first, fall back to static
-*/
-type SchemaExtractionMode = "static" | "runtime" | "hybrid";
-/**
-* API surface configuration options.
-*/
-interface ApiSurfaceConfig {
-	/** Minimum completeness percentage to pass (0-100) */
-	minCompleteness?: number;
-	/** Warning threshold - warn when below this (0-100) */
-	warnBelow?: number;
-	/** Type names to ignore (won't be flagged as forgotten exports) */
-	ignore?: string[];
-}
-/**
-* Check command configuration options.
-*/
-interface CheckConfig {
-	/**
-	* Example validation modes to run.
-	* Can be a single mode, array of modes, or comma-separated string.
-	* - 'presence': Check that @example blocks exist on exports
-	* - 'typecheck': Compile examples with TypeScript
-	* - 'run': Execute examples and validate assertions
-	*/
-	examples?: ExampleValidationMode | ExampleValidationMode[] | string;
-	/** Minimum health score required (0-100). Unified metric combining coverage + accuracy. */
-	minHealth?: number;
-	/** @deprecated Use minHealth instead */
-	minCoverage?: number;
-	/** @deprecated Use minHealth instead */
-	maxDrift?: number;
-	/** API surface configuration */
-	apiSurface?: ApiSurfaceConfig;
-}
-/**
-* Normalized DocCov configuration.
-* This is the parsed/normalized form used by commands.
-*/
-interface DocCovConfig {
-	/** Export include patterns */
-	include?: string[];
-	/** Export exclude patterns */
-	exclude?: string[];
-	/** Plugins (future) */
-	plugins?: unknown[];
-	/** Documentation configuration */
-	docs?: DocsConfig;
-	/** Check command configuration */
-	check?: CheckConfig;
-	/**
-	* Schema extraction mode for validation libraries.
-	*
-	* - 'static' (default): Safe, uses TypeScript Compiler API
-	* - 'runtime': Uses Standard Schema (requires built package)
-	* - 'hybrid': Tries runtime first, falls back to static
-	*
-	* Runtime extraction provides richer JSON Schema output (formats, patterns)
-	* but requires the package to be built first.
-	*/
-	schemaExtraction?: SchemaExtractionMode;
-}
-/**
-* Define a DocCov configuration.
-* Helper function for type-safe configuration in doccov.config.ts.
-*
-* @param config - Configuration object
-* @returns The configuration object (for type inference)
-*
-* @example
-* ```typescript
-* // doccov.config.ts
-* import { defineConfig } from '@doccov/sdk';
-*
-* defineConfig({
-*   include: ['MyClass', 'myFunction'],
-*   exclude: ['internal*'],
-*   check: {
-*     minHealth: 80,
-*   },
-* });
-* ```
-*/
-declare function defineConfig(config: DocCovConfig): DocCovConfig;
 declare const stringList: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
 /**
 * Docs configuration schema
@@ -961,6 +1410,16 @@ declare const apiSurfaceConfigSchema: z.ZodObject<{
 	warnBelow: z.ZodOptional<z.ZodNumber>;
 	ignore: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }>;
+/** Documentation style preset */
+declare const stylePresetSchema: z.ZodEnum<["minimal", "verbose", "types-only"]>;
+/** Fine-grained documentation requirements */
+declare const docRequirementsSchema: z.ZodObject<{
+	description: z.ZodOptional<z.ZodBoolean>;
+	params: z.ZodOptional<z.ZodBoolean>;
+	returns: z.ZodOptional<z.ZodBoolean>;
+	examples: z.ZodOptional<z.ZodBoolean>;
+	since: z.ZodOptional<z.ZodBoolean>;
+}>;
 /**
 * Check command configuration schema.
 */
@@ -970,6 +1429,8 @@ declare const checkConfigSchema: z.ZodObject<{
 	minCoverage: z.ZodOptional<z.ZodNumber>;
 	maxDrift: z.ZodOptional<z.ZodNumber>;
 	apiSurface: z.ZodOptional<typeof apiSurfaceConfigSchema>;
+	style: z.ZodOptional<typeof stylePresetSchema>;
+	require: z.ZodOptional<typeof docRequirementsSchema>;
 }>;
 declare const docCovConfigSchema: z.ZodObject<{
 	include: z.ZodOptional<typeof stringList>;
@@ -1212,6 +1673,26 @@ declare function getPrimaryBuildScript(buildInfo: BuildInfo): string | null;
 * @throws Error if no entry point can be found
 */
 declare function detectEntryPoint(fs: FileSystem, packagePath?: string): Promise<EntryPointInfo>;
+/**
+* Find the package entry point for a given source file.
+* Walks up directories to find package.json and detects entry point.
+*
+* @param fs - FileSystem implementation
+* @param filePath - Absolute or relative path to the source file
+* @returns Entry point info and package path, or null if not found
+*/
+declare function findEntryPointForFile(fs: FileSystem, filePath: string): Promise<{
+	entryPoint: EntryPointInfo;
+	packagePath: string;
+} | null>;
+/**
+* Check if a file is the package entry point.
+*
+* @param fs - FileSystem implementation
+* @param filePath - Path to check
+* @returns True if the file is the package entry point
+*/
+declare function isPackageEntryPoint(fs: FileSystem, filePath: string): Promise<boolean>;
 import { Sandbox } from "@vercel/sandbox";
 /**
 * Node.js filesystem implementation for CLI usage.
@@ -1429,7 +1910,7 @@ declare function parseExamplesFlag(value: boolean | string | undefined): Example
 * Check if a specific validation is enabled.
 */
 declare function shouldValidate(validations: ExampleValidation[], check: ExampleValidation): boolean;
-import { SpecExport as SpecExport8 } from "@openpkg-ts/spec";
+import { SpecExport as SpecExport9 } from "@openpkg-ts/spec";
 interface ExampleTypeError {
 	/** Index of the example in the examples array */
 	exampleIndex: number;
@@ -1552,8 +2033,8 @@ interface ExampleValidationResult {
 * - `typecheck`: type-checks examples (doesn't require presence or run)
 * - `run`: executes examples (doesn't require presence or typecheck)
 */
-declare function validateExamples(exports: SpecExport8[], options: ExampleValidationOptions): Promise<ExampleValidationResult>;
-import { SpecExport as SpecExport9 } from "@openpkg-ts/spec";
+declare function validateExamples(exports: SpecExport9[], options: ExampleValidationOptions): Promise<ExampleValidationResult>;
+import { SpecExport as SpecExport10 } from "@openpkg-ts/spec";
 import * as TS from "typescript";
 /**
 * Represents a single parameter in a JSDoc patch
@@ -1680,7 +2161,7 @@ declare function isFixableDrift(drift: SpecDocDrift): boolean;
 /**
 * Generate a fix for a single drift issue
 */
-declare function generateFix(drift: SpecDocDrift, exportEntry: SpecExport9, existingPatch?: JSDocPatch): FixSuggestion | null;
+declare function generateFix(drift: SpecDocDrift, exportEntry: SpecExport10, existingPatch?: JSDocPatch): FixSuggestion | null;
 /**
 * Generate all fixes for an export's drift issues.
 *
@@ -1688,7 +2169,7 @@ declare function generateFix(drift: SpecDocDrift, exportEntry: SpecExport9, exis
 * @param existingPatch - Optional existing JSDoc patch to merge with
 * @param driftList - Optional drift list from DocCovSpec (if not provided, reads from exportEntry.docs?.drift for backward compat)
 */
-declare function generateFixesForExport(exportEntry: SpecExport9, existingPatch?: JSDocPatch, driftList?: SpecDocDrift[]): FixSuggestion[];
+declare function generateFixesForExport(exportEntry: SpecExport10, existingPatch?: JSDocPatch, driftList?: SpecDocDrift[]): FixSuggestion[];
 /**
 * Merge multiple fix patches into a single patch
 */
@@ -1918,7 +2399,7 @@ declare function extractImports(code: string): Array<{
 * @deprecated Use extractCallsAST for more detailed info.
 */
 declare function extractFunctionCalls(code: string): string[];
-import { CategorizedBreaking, OpenPkg as OpenPkg5, SpecDiff as SpecDiff2 } from "@openpkg-ts/spec";
+import { CategorizedBreaking, OpenPkg as OpenPkg7, SpecDiff as SpecDiff2 } from "@openpkg-ts/spec";
 /**
 * Extended spec diff result with docs impact
 */
@@ -1980,7 +2461,7 @@ interface DiffWithDocsOptions {
 * }
 * ```
 */
-declare function diffSpecWithDocs(oldSpec: OpenPkg5, newSpec: OpenPkg5, options?: DiffWithDocsOptions): SpecDiffWithDocs;
+declare function diffSpecWithDocs(oldSpec: OpenPkg7, newSpec: OpenPkg7, options?: DiffWithDocsOptions): SpecDiffWithDocs;
 /**
 * Check if a diff has any docs impact
 */
@@ -2038,7 +2519,7 @@ interface DetectedSchemaEntry {
 	schema: Record<string, unknown>;
 	vendor: string;
 }
-import { OpenPkg as OpenPkg6 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg8 } from "@openpkg-ts/spec";
 /** Directory for storing history snapshots (relative to .doccov) */
 declare const HISTORY_DIR = ".doccov/history";
 /**
@@ -2125,7 +2606,7 @@ interface ExtendedTrendAnalysis {
 /**
 * Compute a coverage snapshot from an OpenPkg spec.
 */
-declare function computeSnapshot(spec: OpenPkg6, options?: {
+declare function computeSnapshot(spec: OpenPkg8, options?: {
 	commit?: string;
 	branch?: string;
 }): CoverageSnapshot;
@@ -2155,7 +2636,7 @@ declare function loadSnapshots(cwd: string): CoverageSnapshot[];
 * @param options - Optional git metadata
 * @returns Trend data with history and delta
 */
-declare function getTrend(spec: OpenPkg6, cwd: string, options?: {
+declare function getTrend(spec: OpenPkg8, cwd: string, options?: {
 	commit?: string;
 	branch?: string;
 }): CoverageTrend;
@@ -2191,7 +2672,7 @@ declare function pruneHistory(cwd: string, keepCount?: number): number;
 * @param options - Optional git metadata
 * @returns Extended trend analysis
 */
-declare function getExtendedTrend(spec: OpenPkg6, cwd: string, options?: {
+declare function getExtendedTrend(spec: OpenPkg8, cwd: string, options?: {
 	commit?: string;
 	branch?: string;
 }): ExtendedTrendAnalysis;
@@ -2281,7 +2762,7 @@ declare function parseListFlag(value?: string | string[]): string[] | undefined;
 * ```
 */
 declare function mergeFilters(config: DocCovConfig | null, overrides: FilterOptions): ResolvedFilters;
-import { OpenPkg as OpenPkg7 } from "@openpkg-ts/spec";
+import { OpenPkg as OpenPkg9 } from "@openpkg-ts/spec";
 /**
 * Parsed components of a GitHub URL.
 */
@@ -2374,7 +2855,7 @@ declare function buildRawUrl(parsed: ParsedGitHubUrl, filePath: string): string;
 * }
 * ```
 */
-declare function fetchSpecFromGitHub(parsed: ParsedGitHubUrl): Promise<OpenPkg7 | null>;
+declare function fetchSpecFromGitHub(parsed: ParsedGitHubUrl): Promise<OpenPkg9 | null>;
 /**
 * Options for fetching a spec from GitHub.
 */
@@ -2394,7 +2875,7 @@ interface FetchSpecOptions {
 * @param branchOrOptions - Branch name (default: 'main') or options object
 * @returns The OpenPkg spec, or null if not found
 */
-declare function fetchSpec(owner: string, repo: string, branchOrOptions?: string | FetchSpecOptions): Promise<OpenPkg7 | null>;
+declare function fetchSpec(owner: string, repo: string, branchOrOptions?: string | FetchSpecOptions): Promise<OpenPkg9 | null>;
 /**
 * Progress event for installation status updates.
 */
@@ -2581,8 +3062,8 @@ declare function fetchGitHubContext(repoUrl: string, refOrOptions?: string | Fet
 * List packages in a monorepo workspace.
 */
 declare function listWorkspacePackages(owner: string, repo: string, ref: string, patterns: string[], authToken?: string): Promise<string[]>;
-import { DocCovSpec as DocCovSpec4 } from "@doccov/spec";
-import { OpenPkg as OpenPkg8 } from "@openpkg-ts/spec";
+import { DocCovSpec as DocCovSpec5 } from "@doccov/spec";
+import { OpenPkg as OpenPkg10 } from "@openpkg-ts/spec";
 /**
 * A documentation drift issue in a spec summary.
 */
@@ -2636,8 +3117,8 @@ interface SpecSummary {
 * console.log(`Undocumented: ${summary.undocumented.length}`);
 * ```
 */
-declare function extractSpecSummary(openpkg: OpenPkg8, doccov: DocCovSpec4): SpecSummary;
-import { OpenPkg as OpenPkg_lwtdjapvef } from "@openpkg-ts/spec";
+declare function extractSpecSummary(openpkg: OpenPkg10, doccov: DocCovSpec5): SpecSummary;
+import { OpenPkg as OpenPkg_xvdmlnuyqi } from "@openpkg-ts/spec";
 /**
 * Build Plan types for AI-powered repository scanning.
 */
@@ -2734,7 +3215,7 @@ interface BuildPlanExecutionResult {
 	/** Whether all required steps succeeded */
 	success: boolean;
 	/** Generated OpenPkg spec (if successful) */
-	spec?: OpenPkg_lwtdjapvef;
+	spec?: OpenPkg_xvdmlnuyqi;
 	/** Results for each step */
 	stepResults: BuildPlanStepResult[];
 	/** Total execution time in milliseconds */
@@ -2766,4 +3247,4 @@ declare function findProjectRoot(startDir: string): string;
 * @returns Absolute path to the .doccov directory
 */
 declare function getDoccovDir(cwd: string): string;
-export { validateSpecCache, validateExamples, typecheckExamples, typecheckExample, shouldValidate, serializeJSDoc, saveSpecCache, saveSnapshot, saveReport, safeParseJson, runExamplesWithPackage, runExamples, runExample, resolveTarget, resolveCompiledPath, renderSparkline, renderApiSurface, readPackageJson, pruneHistory, previewForgottenExportFixes, parseGitHubUrl2 as parseScanGitHubUrl, parseMarkdownFiles, parseMarkdownFile, parseListFlag, parseJSDocToPatch, parseGitHubUrl, parseExamplesFlag, parseAssertions, normalizeConfig, mergeFixes, mergeFilters, loadSpecCache, loadSnapshots, loadCachedReport, listWorkspacePackages, isStandardJSONSchema, isSchemaType, isFixableDrift, isExportFullyDocumented, isExecutableLang, installDependencies, hashString, hashFiles, hashFile, hasNonAssertionComments, hasDocsImpact, hasDocsForExport, groupFixesByFile, groupDriftsByCategory, getUndocumentedExports, getTrend, getSupportedLibraries, getSpecCachePath, getRunCommand, getReportPath, getRegisteredAdapters, getPrimaryBuildScript, getInstallCommand, getExtendedTrend, getExportScore, getExportMissing, getExportDrift, getExportAnalysis, getDriftSummary, getDocumentedExports, getDocsImpactSummary, getDoccovDir, getDiffReportPath, generateReportFromDocCov, generateReport, generateForgottenExportFixes, generateFixesForExport, generateFix, formatPackageList, formatDriftSummaryLine, formatDelta, findRemovedReferences, findProjectRoot, findPackageByName, findJSDocLocation, findExportReferences, findDeprecatedReferences, findAdapter, fetchSpecFromGitHub, fetchSpec, fetchGitHubContext, extractStandardSchemasFromProject, extractStandardSchemas, extractSpecSummary, extractSchemaType, extractSchemaOutputType, extractPackageSpec, extractImports, extractFunctionCalls, ensureSpecCoverage, docCovConfigSchema, diffSpecWithDocs, diffHashes, detectRuntimeSchemas, detectPackageManager, detectMonorepo, detectExampleRuntimeErrors, detectExampleAssertionFailures, detectEntryPoint, detectBuildInfo, defineConfig, createSourceFile, createNodeCommandRunner, computeSnapshot, computeHealth, computeExportDrift, computeDrift, clearSpecCache, categorizeDrifts, categorizeDrift, calculateAggregateCoverage, buildRawUrl, buildExportRegistry, buildDocCovSpec, buildDisplayUrl, buildCloneUrl, blockReferencesExport, applyPatchToJSDoc, applyForgottenExportFixes, applyEdits, analyzeProject2 as analyzeProject, analyzeFile, analyzeDocsImpact, analyze, WorkspacePackage, WorkspaceConfig, VALIDATION_INFO, TypecheckValidationResult, TypecheckResult, TypecheckOptions, SummaryDriftIssue, StandardSchemaExtractionResult, StandardSchemaExtractionOutput, StandardJSONSchemaV1, SpecSummary, SpecDocDrift, SpecDiffWithDocs, SpecCacheConfig, SpecCache, SchemaExtractionResult, SchemaExtractionMode, SchemaDetectionResult, SchemaDetectionContext, SchemaAdapter, SandboxFileSystem, SPEC_CACHE_FILE, RuntimeDrift, RunValidationResult, RunExamplesWithPackageResult, RunExamplesWithPackageOptions, RunExampleOptions, ResolvedTarget, ResolvedFilters, ResolveTargetOptions, ReleaseTag, REPORT_VERSION, REPORT_EXTENSIONS, ProjectInfo, PresenceResult, ParsedGitHubUrl, PackageManagerInfo, PackageManager, PackageJson, PackageExports, OpenPkgSpec, NodeFileSystem, MonorepoType, MonorepoInfo, MemberChange, MarkdownDocFile, MarkdownCodeBlock, LLMAssertion, JSDocTag, JSDocReturn, JSDocPatch, JSDocParam, JSDocEdit, InstallResult, InstallOptions, HealthInput, HISTORY_DIR, GitHubRepoMetadata, GitHubProjectContext, GenerateForgottenExportFixesOptions, ForgottenExportResult, ForgottenExportFix, FixType, FixSuggestion, FilterSource, FilterOptions, FileSystem, FetchGitHubContextOptions, ExtractStandardSchemasOptions, ExtendedTrendAnalysis, ExportReference, ExportDriftResult, ExportCoverageData, ExampleValidationTypeError, ExampleValidationResult, ExampleValidationOptions, ExampleValidationMode, ExampleValidation, ExampleTypeError, ExampleRunResult, EntryPointSource, EntryPointInfo, DriftType, DriftSummary, DriftResult, DriftReportSummary, DriftReport, DriftCategory, DocsImpactResult, DocsImpactReference, DocsImpact, DocsConfig, DocsChangeType, DocCovReport, DocCovOptions, DocCovConfigInput, DocCovConfig, DocCov, DiffWithDocsOptions, Diagnostic, DetectedSchemaEntry, DetectedPackageManager, DRIFT_CATEGORY_LABELS, DRIFT_CATEGORY_DESCRIPTIONS, DRIFT_CATEGORIES, DEFAULT_REPORT_PATH, DEFAULT_REPORT_DIR, CoverageTrend, CoverageSummary, CoverageSnapshot, CommandRunner, CommandResult, CheckConfig, CategorizedDrift, CacheValidationResult, CacheContext, CACHE_VERSION, BuildPlanTarget, BuildPlanStepResult, BuildPlanStep, BuildPlanExecutionResult, BuildPlanEnvironment, BuildPlan, BuildInfo, BuildHints, BuildDocCovOptions, ApplyForgottenExportResult, ApplyEditsResult, AnalyzeProjectOptions, AnalyzeOptions, AnalysisResult, ALL_VALIDATIONS };
+export { validateSpecCache, validateExamples, typecheckExamples, typecheckExample, symbolExistsInGraph, shouldValidate, serializeJSDoc, saveSpecCache, saveSnapshot, saveReport, safeParseJson, runExamplesWithPackage, runExamples, runExample, resolveTarget, resolveRequirements, resolveCompiledPath, renderSparkline, renderApiSurface, readPackageJson, pruneHistory, previewForgottenExportFixes, parseGitHubUrl2 as parseScanGitHubUrl, parseMarkdownFiles, parseMarkdownFile, parseListFlag, parseJSDocToPatch, parseGitHubUrl, parseExamplesFlag, parseAssertions, normalizeConfig, mergeFixes, mergeFilters, loadSpecCache, loadSnapshots, loadCachedReport, listWorkspacePackages, isStandardJSONSchema, isSchemaType, isPackageEntryPoint, isFixableDrift, isExportFullyDocumented, isExportDocumented, isExecutableLang, installDependencies, hashString, hashFiles, hashFile, hasNonAssertionComments, hasDocsImpact, hasDocsForExport, groupFixesByFile, groupDriftsByCategory, getUndocumentedExports, getTrend, getSupportedLibraries, getSpecCachePath, getRunCommand, getReportPath, getRegisteredAdapters, getPrimaryBuildScript, getInstallCommand, getExtendedTrend, getExportScore, getExportMissing, getExportDrift, getExportAnalysis, getDriftSummary, getDocumentedExports, getDocsImpactSummary, getDoccovDir, getDiffReportPath, generateReportFromDocCov, generateReport, generateForgottenExportFixes, generateFixesForExport, generateFix, formatPackageList, formatDriftSummaryLine, formatDelta, findSymbolModule, findRemovedReferences, findProjectRoot, findPackageByName, findOrphanedTempFiles, findJSDocLocation, findExportReferences, findEntryPointForFile, findDeprecatedReferences, findAdapter, fetchSpecFromGitHub, fetchSpec, fetchGitHubContext, extractStandardSchemasFromProject, extractStandardSchemas, extractSpecSummary, extractSchemaType, extractSchemaOutputType, extractPackageSpec, extractImports, extractFunctionCalls, ensureSpecCoverage, docCovConfigSchema, diffSpecWithDocs, diffHashes, detectRuntimeSchemas, detectPackageManager, detectMonorepo, detectExampleRuntimeErrors, detectExampleAssertionFailures, detectEntryPoint, detectBuildInfo, defineConfig, createSourceFile, createPackageResult, createNodeCommandRunner, computeSnapshot, computeHealth, computeExportDrift, computeDrift, clearSpecCache, cleanupOrphanedTempFiles, categorizeDrifts, categorizeDrift, calculateAggregateCoverage, buildRawUrl, buildModuleGraph, buildExportRegistry, buildDocCovSpec, buildDisplayUrl, buildCloneUrl, blockReferencesExport, applyPatchToJSDoc, applyForgottenExportFixes, applyEdits, analyzeProject2 as analyzeProject, analyzeFile, analyzeDocsImpact, analyze, aggregateResults, WorkspacePackage, WorkspaceConfig, VALIDATION_INFO, TypecheckValidationResult, TypecheckResult, TypecheckOptions, SummaryDriftIssue, StylePreset, StandardSchemaExtractionResult, StandardSchemaExtractionOutput, StandardJSONSchemaV1, SpecSummary, SpecDocDrift, SpecDiffWithDocs, SpecCacheConfig, SpecCache, SchemaExtractionResult, SchemaExtractionMode, SchemaDetectionResult, SchemaDetectionContext, SchemaAdapter, SandboxFileSystem, SPEC_CACHE_FILE, RuntimeDrift, RunValidationResult, RunExamplesWithPackageResult, RunExamplesWithPackageOptions, RunExampleOptions, ResolvedTarget, ResolvedFilters, DocRequirements2 as ResolvedDocRequirements, ResolveTargetOptions, ReleaseTag, REPORT_VERSION, REPORT_EXTENSIONS, ProjectInfo, PresenceResult, PartialAnalysisState, ParsedGitHubUrl, PackageResult, PackageManagerInfo, PackageManager, PackageJson, PackageExports, PRESETS, OpenPkgSpec, NodeFileSystem, MonorepoType, MonorepoInfo, ModuleInfo, ModuleGraph, MemberChange, MarkdownDocFile, MarkdownCodeBlock, LLMAssertion, JSDocTag, JSDocReturn, JSDocPatch, JSDocParam, JSDocEdit, InstallResult, InstallOptions, IncrementalExportResult, IncrementalAnalyzerOptions, IncrementalAnalyzer, HealthInput, HISTORY_DIR, GitHubRepoMetadata, GitHubProjectContext, GenerateForgottenExportFixesOptions, ForgottenExportResult, ForgottenExportFix, FixType, FixSuggestion, FilterSource, FilterOptions, FileSystem, FetchGitHubContextOptions, ExtractStandardSchemasOptions, ExtendedTrendAnalysis, ExportReference, ExportDriftResult, ExportCoverageData, ExampleValidationTypeError, ExampleValidationResult, ExampleValidationOptions, ExampleValidationMode, ExampleValidation, ExampleTypeError, ExampleRunResult, EntryPointSource, EntryPointInfo, DriftType, DriftSummary, DriftResult, DriftReportSummary, DriftReport, DriftCategory, DocsImpactResult, DocsImpactReference, DocsImpact, DocsConfig, DocsChangeType, DocRequirements, DocCovReport, DocCovOptions, DocCovConfigInput, DocCovConfig, DocCov, DiffWithDocsOptions, Diagnostic, DetectedSchemaEntry, DetectedPackageManager, DRIFT_CATEGORY_LABELS, DRIFT_CATEGORY_DESCRIPTIONS, DRIFT_CATEGORIES, DEFAULT_REQUIREMENTS, DEFAULT_REPORT_PATH, DEFAULT_REPORT_DIR, CoverageTrend, CoverageSummary, CoverageSnapshot, ComputeDriftOptions, CommandRunner, CommandResult, CheckConfig, CategorizedDrift, CacheValidationResult, CacheContext, CACHE_VERSION, BuildPlanTarget, BuildPlanStepResult, BuildPlanStep, BuildPlanExecutionResult, BuildPlanEnvironment, BuildPlan, BuildInfo, BuildHints, BuildDocCovOptions, BatchResult, ApplyForgottenExportResult, ApplyEditsResult, AnalyzeProjectOptions, AnalyzeOptions, AnalysisResult, ALL_VALIDATIONS };