/**
 * Visibility gating for the `/docs` route.
 *
 * Docs declare `visibility: public | internal` in frontmatter (or inherit it
 * from `FOLDER_DEFAULTS`). At request time, internal docs 404 unless the
 * environment opts in via `NEOTOMA_DOCS_SHOW_INTERNAL=true`.
 *
 * Default: internal docs are hidden unless the operator explicitly opts in.
 * This fails closed for staging, previews, sandboxes, and any deployment that
 * forgets to set `NODE_ENV=production`.
 */
import type { DocFrontmatter } from "./doc_frontmatter.js";
export interface VisibilityEnv {
    NODE_ENV?: string;
    NEOTOMA_DOCS_SHOW_INTERNAL?: string;
}
/** True when internal-visibility docs should be exposed for the given env. */
export declare function shouldShowInternal(env: VisibilityEnv): boolean;
/** True when the doc should be visible to the requester. */
export declare function isVisible(fm: Pick<DocFrontmatter, "visibility">, env: VisibilityEnv): boolean;
//# sourceMappingURL=visibility.d.ts.map