import { Hono } from 'hono';
import type { Handler as vocs_Handler } from 'vocs/server';
import type * as App from '../../App.js';
/**
 * The docs route group: the Vocs API reference served at the app root.
 *
 * ```ts
 * import { docs } from 'tapimo/docs'
 * App.create(options).route('/', data()).route('/', management()).route('/', docs())
 * ```
 *
 * The group registers no routes itself: it carries a reference factory (via
 * {@link Metadata}) that `App.create` mounts on finalize, after every group and
 * the OpenAPI/OpenRPC documents — so the reference always renders the full
 * composed surface and its catch-all stays behind API routes, wherever the
 * group sits in the composition chain.
 *
 * Lives in the `tapimo/docs` subpath (never re-exported from `tapimo/apps`) so
 * the Vocs renderer and its multi-MB icon/font data are bundled only by
 * deployments that actually serve docs. Even then the renderer loads lazily on
 * the first docs request (see `reference.ts`), so API traffic and isolate
 * startup never pay for it.
 */
export declare function docs(options?: docs.Options): Hono<App.Environment, import("hono/types").BlankSchema, "/">;
export declare namespace docs {
    /** Vocs API reference options (theme, top navigation, logo, socials, …). */
    type Options = NonNullable<Parameters<typeof vocs_Handler.openApi>[0]['vocs']>;
}
//# sourceMappingURL=App.d.ts.map