@hestjs/scalar 0.1.0

package/dist/openapi-generator.js

@@ -0,0 +1,215 @@
+import 'reflect-metadata';
+/**
+ * OpenAPI 文档生成器
+ */
+export class OpenAPIGenerator {
+    config;
+    paths = {};
+    components = {
+        schemas: {},
+        responses: {},
+        parameters: {},
+        examples: {},
+        requestBodies: {},
+        headers: {},
+        securitySchemes: {},
+        links: {},
+        callbacks: {},
+    };
+    constructor(config) {
+        this.config = config;
+        if (config.components) {
+            this.components = { ...this.components, ...config.components };
+        }
+    }
+    /**
+     * 从控制器类生成 OpenAPI 路径
+     */
+    addController(controller, basePath = '') {
+        console.log(`Processing controller: ${controller.name}, basePath: ${basePath}`);
+        const controllerTags = Reflect.getMetadata('openapi:tags', controller) || [];
+        console.log(`Controller tags:`, controllerTags);
+        // 获取HestJS的路由元数据（存储在控制器类上）
+        const HEST_ROUTE_KEY = Symbol.for('hest:route');
+        const routes = Reflect.getMetadata(HEST_ROUTE_KEY, controller) || [];
+        console.log(`Found routes:`, routes);
+        for (const route of routes) {
+            const { method, path, methodName } = route;
+            const fullPath = this.joinPaths(basePath, path);
+            console.log(`Adding route: ${method.toUpperCase()} ${fullPath} (method: ${methodName})`);
+            // 确保路径存在
+            if (!this.paths[fullPath]) {
+                this.paths[fullPath] = {};
+            }
+            // 生成操作对象
+            const operation = this.generateOperation(controller, methodName, controllerTags);
+            this.paths[fullPath][method.toLowerCase()] = operation;
+        }
+        // 处理类级别的schema
+        this.addSchemaFromClass(controller);
+    }
+    /**
+     * 生成操作对象
+     */
+    generateOperation(controller, methodName, defaultTags) {
+        const prototype = controller.prototype;
+        // 基础操作信息
+        const operationMetadata = Reflect.getMetadata('openapi:operation', prototype, methodName) || {};
+        const operation = {
+            tags: operationMetadata.tags || defaultTags,
+            summary: operationMetadata.summary,
+            description: operationMetadata.description,
+            operationId: operationMetadata.operationId || `${controller.name}_${methodName}`,
+            responses: {},
+            ...operationMetadata
+        };
+        // 参数
+        const parameters = Reflect.getMetadata('openapi:parameters', prototype, methodName);
+        if (parameters && parameters.length > 0) {
+            operation.parameters = parameters;
+        }
+        // 请求体
+        const requestBody = Reflect.getMetadata('openapi:requestBody', prototype, methodName);
+        if (requestBody) {
+            operation.requestBody = requestBody;
+        }
+        // 响应
+        const responses = Reflect.getMetadata('openapi:responses', prototype, methodName);
+        if (responses && Object.keys(responses).length > 0) {
+            operation.responses = responses;
+        }
+        else {
+            // 默认响应
+            operation.responses = {
+                '200': {
+                    description: 'Success'
+                }
+            };
+        }
+        // 安全
+        const security = Reflect.getMetadata('openapi:security', prototype, methodName);
+        if (security) {
+            operation.security = security;
+        }
+        return operation;
+    }
+    /**
+     * 从类添加 Schema
+     */
+    addSchemaFromClass(target) {
+        const schema = Reflect.getMetadata('openapi:schema', target);
+        if (schema) {
+            const schemaName = target.name;
+            this.components.schemas[schemaName] = schema;
+        }
+        // 处理属性级别的schema
+        const properties = Reflect.getMetadata('openapi:properties', target);
+        if (properties && Object.keys(properties).length > 0) {
+            const schemaName = target.name;
+            if (!this.components.schemas[schemaName]) {
+                this.components.schemas[schemaName] = {
+                    type: 'object',
+                    properties: {},
+                };
+            }
+            const existingSchema = this.components.schemas[schemaName];
+            if (!existingSchema.properties) {
+                existingSchema.properties = {};
+            }
+            // 合并属性
+            Object.assign(existingSchema.properties, properties);
+            // 收集required字段
+            const required = [];
+            for (const [propName, propSchema] of Object.entries(properties)) {
+                if (propSchema.required === true) {
+                    required.push(propName);
+                }
+            }
+            if (required.length > 0) {
+                existingSchema.required = [...(existingSchema.required || []), ...required];
+            }
+        }
+    }
+    /**
+     * 标准化路径
+     */
+    normalizePath(path) {
+        // 将 :id 格式转换为 {id} 格式
+        let normalized = path.replace(/:([^/]+)/g, '{$1}');
+        // 移除末尾的斜杠（除非是根路径）
+        if (normalized !== '/' && normalized.endsWith('/')) {
+            normalized = normalized.slice(0, -1);
+        }
+        return normalized;
+    }
+    /**
+     * 拼接路径
+     */
+    joinPaths(basePath, path) {
+        // 规范化基础路径
+        basePath = basePath.replace(/\/$/, ''); // 移除末尾斜杠
+        // 规范化路径
+        if (path === '/') {
+            // 如果路径是根路径，直接使用基础路径
+            return basePath || '/';
+        }
+        else if (!path.startsWith('/')) {
+            // 如果路径不以斜杠开头，添加斜杠
+            path = '/' + path;
+        }
+        const fullPath = basePath + path;
+        return this.normalizePath(fullPath);
+    }
+    /**
+     * 添加全局组件
+     */
+    addComponent(type, name, component) {
+        if (!this.components[type]) {
+            this.components[type] = {};
+        }
+        this.components[type][name] = component;
+    }
+    /**
+     * 生成完整的 OpenAPI 文档
+     */
+    generateDocument() {
+        // 清理空的组件
+        const cleanComponents = {};
+        for (const [key, value] of Object.entries(this.components)) {
+            if (value && Object.keys(value).length > 0) {
+                cleanComponents[key] = value;
+            }
+        }
+        return {
+            openapi: '3.0.0',
+            info: this.config.info,
+            servers: this.config.servers,
+            paths: this.paths,
+            components: Object.keys(cleanComponents).length > 0 ? cleanComponents : undefined,
+            security: this.config.security,
+            tags: this.config.tags,
+            externalDocs: this.config.externalDocs,
+        };
+    }
+    /**
+     * 重置生成器
+     */
+    reset() {
+        this.paths = {};
+        this.components = {
+            schemas: {},
+            responses: {},
+            parameters: {},
+            examples: {},
+            requestBodies: {},
+            headers: {},
+            securitySchemes: {},
+            links: {},
+            callbacks: {},
+        };
+        if (this.config.components) {
+            this.components = { ...this.components, ...this.config.components };
+        }
+    }
+}
+//# sourceMappingURL=openapi-generator.js.map

package/dist/openapi-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-generator.js","sourceRoot":"","sources":["../src/openapi-generator.ts"],"names":[],"mappings":"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"}

package/dist/scalar-config.interface.d.ts

@@ -0,0 +1,73 @@
+import type { Context } from 'hono';
+/**
+ * Scalar 配置选项
+ */
+export interface ScalarConfig {
+    /**
+     * 是否启用 Scalar
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * 文档服务路径
+     * @default '/docs'
+     */
+    path?: string;
+    /**
+     * OpenAPI 规范（URL 或对象）
+     */
+    spec?: string | object | ((c: Context) => string | object | Promise<string | object>);
+    /**
+     * 页面标题
+     * @default 'API Documentation'
+     */
+    title?: string;
+    /**
+     * UI 主题
+     * @default 'elysia'
+     */
+    theme?: 'elysia' | 'default' | 'alternate' | 'moon' | 'purple' | 'solarized' | 'none';
+    /**
+     * 自定义 CDN 地址
+     */
+    cdn?: string;
+    /**
+     * 代理 URL（用于开发环境解决 CORS 问题）
+     */
+    proxyUrl?: string;
+    /**
+     * 服务器配置
+     */
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    /**
+     * 自定义 CSS
+     */
+    customCss?: string;
+    /**
+     * 是否启用 Markdown 导出（供 LLM 使用）
+     * @default false
+     */
+    enableMarkdown?: boolean;
+    /**
+     * Markdown 导出路径
+     * @default '/llms.txt'
+     */
+    markdownPath?: string;
+}
+/**
+ * Scalar 中间件配置
+ */
+export interface ScalarMiddlewareConfig extends Omit<ScalarConfig, 'path'> {
+    /**
+     * OpenAPI 规范 URL
+     */
+    url?: string;
+    /**
+     * OpenAPI 规范内容
+     */
+    content?: object;
+}
+//# sourceMappingURL=scalar-config.interface.d.ts.map

package/dist/scalar-config.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalar-config.interface.d.ts","sourceRoot":"","sources":["../src/scalar-config.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAEtF;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;IAEtF;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IAEH;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;IACxE;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/scalar-config.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scalar-config.interface.js.map

package/dist/scalar-config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalar-config.interface.js","sourceRoot":"","sources":["../src/scalar-config.interface.ts"],"names":[],"mappings":""}

package/dist/scalar.middleware.d.ts

@@ -0,0 +1,20 @@
+import type { Hono, MiddlewareHandler } from "hono";
+import type { ScalarConfig, ScalarMiddlewareConfig } from "./scalar-config.interface";
+import { type OpenAPIGeneratorConfig } from './openapi-generator';
+/**
+ * 创建 Scalar 中间件
+ */
+export declare function createScalarMiddleware(config: ScalarMiddlewareConfig): MiddlewareHandler;
+/**
+ * 创建 Markdown 中间件（供 LLM 使用）
+ */
+export declare function createMarkdownMiddleware(spec: string | object): MiddlewareHandler;
+/**
+ * 在 Hono 应用上设置 Scalar
+ */
+export declare function setupScalar(app: Hono, config: ScalarConfig): void;
+/**
+ * 从控制器生成 OpenAPI 并设置 Scalar
+ */
+export declare function setupScalarWithControllers(app: Hono, controllers: any[], generatorConfig: OpenAPIGeneratorConfig, scalarConfig?: Omit<ScalarConfig, 'spec'>): void;
+//# sourceMappingURL=scalar.middleware.d.ts.map

package/dist/scalar.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalar.middleware.d.ts","sourceRoot":"","sources":["../src/scalar.middleware.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,IAAI,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAC7D,OAAO,KAAK,EACV,YAAY,EACZ,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAoB,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAGpF;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,iBAAiB,CA6DnB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,GAAG,MAAM,GACpB,iBAAiB,CA6BnB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAsBjE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,IAAI,EACT,WAAW,EAAE,GAAG,EAAE,EAClB,eAAe,EAAE,sBAAsB,EACvC,YAAY,GAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAM,GAC5C,IAAI,CA8CN"}

package/dist/scalar.middleware.js

@@ -0,0 +1,149 @@
+import { Scalar } from "@scalar/hono-api-reference";
+import { createMarkdownFromOpenApi } from "@scalar/openapi-to-markdown";
+import { OpenAPIGenerator } from './openapi-generator';
+import { elysiajsTheme } from '@scalar/themes';
+/**
+ * 创建 Scalar 中间件
+ */
+export function createScalarMiddleware(config) {
+    const { spec, url, content, theme = "hestjs", title = "API Documentation", cdn, proxyUrl, servers, customCss, } = config;
+    // 构建 Scalar 配置
+    const scalarConfig = {};
+    // 选择主题CSS
+    let themeCSS = '';
+    if (theme === 'elysia') {
+        themeCSS = elysiajsTheme;
+    }
+    // 设置自定义CSS（主题CSS + 用户自定义CSS）
+    if (themeCSS || customCss) {
+        scalarConfig.customCss = `${themeCSS}
+${customCss || ''}`;
+    }
+    // 设置规范来源
+    if (url) {
+        scalarConfig.url = url;
+    }
+    else if (content) {
+        scalarConfig.content = content;
+    }
+    else if (spec) {
+        if (typeof spec === "string") {
+            scalarConfig.url = spec;
+        }
+        else if (typeof spec === "function") {
+            // 动态配置，需要在中间件中处理
+            return async (c, next) => {
+                const resolvedSpec = await spec(c);
+                const dynamicConfig = {
+                    ...scalarConfig,
+                    ...(typeof resolvedSpec === "string"
+                        ? { url: resolvedSpec }
+                        : { content: resolvedSpec }),
+                };
+                return Scalar(dynamicConfig)(c, next);
+            };
+        }
+        else {
+            scalarConfig.content = spec;
+        }
+    }
+    // 设置其他选项
+    if (title)
+        scalarConfig.pageTitle = title;
+    if (cdn)
+        scalarConfig.cdn = cdn;
+    if (proxyUrl)
+        scalarConfig.proxyUrl = proxyUrl;
+    if (servers)
+        scalarConfig.servers = servers;
+    return Scalar(scalarConfig);
+}
+/**
+ * 创建 Markdown 中间件（供 LLM 使用）
+ */
+export function createMarkdownMiddleware(spec) {
+    return async (c) => {
+        try {
+            let specContent;
+            if (typeof spec === "string") {
+                // 如果是 URL，需要获取内容
+                if (spec.startsWith("http")) {
+                    const response = await fetch(spec);
+                    specContent = await response.text();
+                }
+                else {
+                    // 假设是相对路径，从当前应用获取
+                    const baseUrl = new URL(c.req.url).origin;
+                    const response = await fetch(`${baseUrl}${spec}`);
+                    specContent = await response.text();
+                }
+            }
+            else {
+                specContent = JSON.stringify(spec);
+            }
+            const markdown = await createMarkdownFromOpenApi(specContent);
+            return c.text(markdown, 200, {
+                "Content-Type": "text/plain; charset=utf-8",
+            });
+        }
+        catch (error) {
+            console.error("Failed to generate markdown:", error);
+            return c.text("Failed to generate API documentation markdown", 500);
+        }
+    };
+}
+/**
+ * 在 Hono 应用上设置 Scalar
+ */
+export function setupScalar(app, config) {
+    const { path = "/docs", enableMarkdown = false, markdownPath = "/llms.txt", spec, ...middlewareConfig } = config;
+    // 设置主文档路径
+    const scalarMiddleware = createScalarMiddleware({
+        ...middlewareConfig,
+        spec,
+    });
+    app.get(path, scalarMiddleware);
+    // 如果启用了 Markdown 导出
+    if (enableMarkdown && spec) {
+        const markdownMiddleware = createMarkdownMiddleware(spec);
+        app.get(markdownPath, markdownMiddleware);
+    }
+}
+/**
+ * 从控制器生成 OpenAPI 并设置 Scalar
+ */
+export function setupScalarWithControllers(app, controllers, generatorConfig, scalarConfig = {}) {
+    const generator = new OpenAPIGenerator(generatorConfig);
+    // 从控制器生成路径
+    for (const controller of controllers) {
+        // 获取控制器的基础路径（从 @Controller 装饰器）
+        const HEST_CONTROLLER_KEY = Symbol.for('hest:controller');
+        const controllerMetadata = Reflect.getMetadata(HEST_CONTROLLER_KEY, controller);
+        const controllerPath = controllerMetadata?.path || '';
+        console.log(`Controller ${controller.name} path:`, controllerPath);
+        generator.addController(controller, controllerPath);
+    }
+    // 生成 OpenAPI 文档
+    const openApiDoc = generator.generateDocument();
+    // 调试：打印生成的文档
+    console.log('Generated OpenAPI Document:', JSON.stringify(openApiDoc, null, 2));
+    // 首先设置 OpenAPI JSON 端点
+    const openApiPath = '/openapi.json';
+    app.get(openApiPath, (c) => {
+        return c.json(openApiDoc);
+    });
+    // 然后设置 Scalar，指向 OpenAPI JSON 端点
+    const { path = '/docs', enableMarkdown = false, markdownPath = '/llms.txt', ...middlewareConfig } = scalarConfig;
+    // 设置 Scalar 中间件，使用 URL 而不是直接传递对象
+    const scalarMiddleware = createScalarMiddleware({
+        ...middlewareConfig,
+        url: openApiPath, // 使用 URL 而不是 content
+    });
+    app.get(path, scalarMiddleware);
+    // 如果启用了 Markdown 导出
+    if (enableMarkdown) {
+        const markdownMiddleware = createMarkdownMiddleware(openApiDoc);
+        app.get(markdownPath, markdownMiddleware);
+    }
+}
+//# sourceMappingURL=scalar.middleware.js.map

package/dist/scalar.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalar.middleware.js","sourceRoot":"","sources":["../src/scalar.middleware.ts"],"names":[],"mappings":"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"}

package/dist/scalar.module.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Scalar 模块
+ *
+ * 这个模块可以在 HestJS 应用中导入，提供 Scalar API 文档功能
+ */
+export declare class ScalarModule {
+    /**
+     * 静态方法：配置 Scalar 模块
+     *
+     * @param config Scalar 配置选项
+     * @returns 配置后的模块
+     */
+    static forRoot(config: any): any;
+}
+//# sourceMappingURL=scalar.module.d.ts.map

package/dist/scalar.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalar.module.d.ts","sourceRoot":"","sources":["../src/scalar.module.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,qBAIa,YAAY;IACvB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG;CAajC"}

package/dist/scalar.module.js

@@ -0,0 +1,42 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var ScalarModule_1;
+import { Module } from '@hestjs/core';
+/**
+ * Scalar 模块
+ *
+ * 这个模块可以在 HestJS 应用中导入，提供 Scalar API 文档功能
+ */
+let ScalarModule = ScalarModule_1 = class ScalarModule {
+    /**
+     * 静态方法：配置 Scalar 模块
+     *
+     * @param config Scalar 配置选项
+     * @returns 配置后的模块
+     */
+    static forRoot(config) {
+        // 这里可以根据需要扩展，目前主要通过中间件使用
+        return {
+            module: ScalarModule_1,
+            providers: [
+                {
+                    provide: 'SCALAR_CONFIG',
+                    useValue: config,
+                },
+            ],
+            exports: ['SCALAR_CONFIG'],
+        };
+    }
+};
+ScalarModule = ScalarModule_1 = __decorate([
+    Module({
+        providers: [],
+        exports: [],
+    })
+], ScalarModule);
+export { ScalarModule };
+//# sourceMappingURL=scalar.module.js.map

package/dist/scalar.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalar.module.js","sourceRoot":"","sources":["../src/scalar.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;GAIG;AAKI,IAAM,YAAY,oBAAlB,MAAM,YAAY;IACvB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,MAAW;QACxB,yBAAyB;QACzB,OAAO;YACL,MAAM,EAAE,cAAY;YACpB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,eAAe;oBACxB,QAAQ,EAAE,MAAM;iBACjB;aACF;YACD,OAAO,EAAE,CAAC,eAAe,CAAC;SAC3B,CAAC;IACJ,CAAC;CACF,CAAA;AApBY,YAAY;IAJxB,MAAM,CAAC;QACN,SAAS,EAAE,EAAE;QACb,OAAO,EAAE,EAAE;KACZ,CAAC;GACW,YAAY,CAoBxB"}

package/dist/utils/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 生成基础 OpenAPI 文档结构
+ */
+export declare function generateBaseOpenApiSpec(config: {
+    title: string;
+    version: string;
+    description?: string;
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+}): object;
+/**
+ * 从类元数据生成 OpenAPI schema
+ */
+export declare function generateSchemaFromClass(target: any): object;
+/**
+ * 从控制器生成 OpenAPI 路径
+ */
+export declare function generatePathsFromController(controller: any, basePath?: string): object;
+/**
+ * 合并多个 OpenAPI 文档
+ */
+export declare function mergeOpenApiSpecs(...specs: object[]): object;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD,GAAG,MAAM,CAsBT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CA+B3D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,GAAG,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM,CA0B1F;AAyFD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAkD5D"}