import type { MetaObject } from "@metaobjectsdev/metadata";
import type { GeneratorFactory } from "../generator.js";
export interface DocsFileOpts {
    filter?: (entity: MetaObject) => boolean;
    target?: string;
    /** When set, one or more api surfaces are emitted alongside the model surface,
     *  each under its own sub-directory (e.g. `"api/ts"`) with a per-language label.
     *  docsFile then cross-links each model entity page to ALL its api pages and
     *  adds an "API reference" section to the index, every href computed via the
     *  shared `apiSurfaceHref` so it resolves relative in BOTH layouts (or absolute
     *  when a `baseUrl` is given). ABSENT/empty ⇒ model-only output (byte-identical
     *  to historical behaviour). */
    apiSurfaces?: Array<{
        label: string;
        subDir: string;
        baseUrl?: string;
    }>;
}
/**
 * @deprecated ADR-0021 D1: `meta docs` is the single door for documentation.
 * `docsFile()` stays as the INTERNAL engine that `meta docs` calls — do NOT add
 * it to a `meta gen` config / the public generator surface. It is flagged
 * neutral in the generator registry (`--list`) and is not part of the
 * recommended native `meta gen` suite. Use `meta docs` instead.
 */
export declare const docsFile: GeneratorFactory<DocsFileOpts>;
//# sourceMappingURL=docs-file.d.ts.map