import type { MetaObject } from "@metaobjectsdev/metadata";
import type { GeneratorFactory } from "../generator.js";
export interface ApiDocsFileOpts {
    filter?: (entity: MetaObject) => boolean;
    target?: string;
    /** Output prefix for all api-docs artifacts. Default `docs/api`. */
    subDir?: string;
    /** When true, the model surface is emitted alongside the api surface (at the
     *  docs root), so each api entity page cross-links back to its model page. The
     *  href is computed via the shared `surfaceCrossHref` so it resolves in BOTH
     *  layouts. ABSENT/false ⇒ default api output byte-identical. */
    modelSurface?: boolean;
}
/**
 * @deprecated ADR-0025: `meta docs` is the single door for ALL docs. `apiDocsFile()`
 * stays as the INTERNAL engine of the docs door's api surface — do NOT add it to a
 * `meta gen` config / the generators array. Use `meta docs` (it emits the api surface
 * alongside the model surface). A `meta gen` config that lists it is warned + skipped.
 */
export declare const apiDocsFile: GeneratorFactory<ApiDocsFileOpts>;
//# sourceMappingURL=api-docs-file.d.ts.map