import { type ControllerSide } from './metadata';
/**
 * OpenAPI 操作 tag（全局唯一）
 * 侧栏展示名靠 x-displayName = admin | app，勿用 `/`（Scalar 会显示成整串）
 */
export declare function openApiTag(module: string, side: ControllerSide): string;
/**
 * 侧栏结构：
 *   base          ← x-tagGroups（一级：模块名）
 *     admin       ← tag + x-displayName（二级）
 *     app
 */
export declare function buildOpenApiTagDocs(): {
    tags: {
        name: string;
        description: string;
        'x-displayName': string;
    }[];
    tagGroups: {
        name: string;
        tags: string[];
    }[];
};
