@hestjs/scalar 0.1.0

package/README.md

@@ -0,0 +1,115 @@
+# @hestjs/scalar
+
+HestJS Scalar API Reference Integration - Beautiful API documentation for HestJS applications
+
+## Installation
+
+```bash
+npm install @hestjs/scalar
+```
+
+## Quick Start
+
+```typescript
+import { HestFactory } from '@hestjs/core';
+import { ScalarModule } from '@hestjs/scalar';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await HestFactory.create(AppModule);
+  
+  // Configure Scalar API Reference
+  app.useScalar({
+    path: '/docs',           // Documentation path
+    spec: '/openapi.json',   // OpenAPI spec endpoint
+    theme: 'hest',          // Custom HestJS theme
+    title: 'My API Documentation'
+  });
+
+  // Start server
+  Bun.serve({
+    port: 3000,
+    fetch: app.hono().fetch,
+  });
+}
+
+bootstrap();
+```
+
+## Features
+
+- 🎨 Beautiful API documentation with multiple themes
+- 📱 Responsive design for mobile and desktop
+- 🔍 Interactive API explorer
+- 📋 Copy-paste code examples
+- 🌙 Dark/light mode support
+- 📄 Markdown export for LLMs
+- 🎯 HestJS-specific theme and branding
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `path` | `string` | `'/docs'` | Path where documentation will be served |
+| `spec` | `string \| object` | - | OpenAPI specification (URL or object) |
+| `theme` | `string` | `'hest'` | UI theme (`hest`, `default`, `purple`, `moon`, etc.) |
+| `title` | `string` | `'API Documentation'` | Page title |
+| `cdn` | `string` | - | Custom CDN URL for Scalar assets |
+| `proxyUrl` | `string` | - | Proxy URL for CORS issues in development |
+
+## Usage with OpenAPI Generation
+
+```typescript
+// Coming soon: Integration with OpenAPI generation from decorators
+import { ApiProperty, ApiResponse } from '@hestjs/scalar';
+
+@Controller('/users')
+export class UserController {
+  @Get('/')
+  @ApiResponse({ status: 200, description: 'List of users' })
+  async getUsers() {
+    // ...
+  }
+}
+```
+
+## Themes
+
+HestJS Scalar comes with a custom HestJS theme by default. You can also use:
+
+- `hest` - Custom HestJS theme (default)
+- `default` - Scalar default theme
+- `purple` - Purple theme
+- `moon` - Dark theme
+- `solarized` - Solarized theme
+- `none` - No theme (custom styling)
+
+## Advanced Configuration
+
+```typescript
+app.useScalar({
+  path: '/docs',
+  spec: {
+    openapi: '3.0.0',
+    info: {
+      title: 'My API',
+      version: '1.0.0',
+    },
+    // ... your OpenAPI spec
+  },
+  theme: 'hest',
+  customCss: `
+    .scalar-app {
+      --scalar-color-1: #your-brand-color;
+    }
+  `,
+  servers: [
+    { url: 'https://api.example.com', description: 'Production' },
+    { url: 'http://localhost:3000', description: 'Development' }
+  ]
+});
+```
+
+## License
+
+MIT

package/dist/decorators/openapi.decorators.d.ts

@@ -0,0 +1,266 @@
+import 'reflect-metadata';
+export type OpenAPIV3 = {
+    openapi: string;
+    info: OpenAPIV3.InfoObject;
+    servers?: OpenAPIV3.ServerObject[];
+    paths: OpenAPIV3.PathsObject;
+    components?: OpenAPIV3.ComponentsObject;
+    security?: OpenAPIV3.SecurityRequirementObject[];
+    tags?: OpenAPIV3.TagObject[];
+    externalDocs?: OpenAPIV3.ExternalDocumentationObject;
+};
+export declare namespace OpenAPIV3 {
+    interface InfoObject {
+        title: string;
+        description?: string;
+        termsOfService?: string;
+        contact?: ContactObject;
+        license?: LicenseObject;
+        version: string;
+    }
+    interface ContactObject {
+        name?: string;
+        url?: string;
+        email?: string;
+    }
+    interface LicenseObject {
+        name: string;
+        url?: string;
+    }
+    interface ServerObject {
+        url: string;
+        description?: string;
+        variables?: Record<string, ServerVariableObject>;
+    }
+    interface ServerVariableObject {
+        enum?: string[];
+        default: string;
+        description?: string;
+    }
+    interface PathsObject {
+        [pattern: string]: PathItemObject | undefined;
+    }
+    interface PathItemObject {
+        $ref?: string;
+        summary?: string;
+        description?: string;
+        get?: OperationObject;
+        put?: OperationObject;
+        post?: OperationObject;
+        delete?: OperationObject;
+        options?: OperationObject;
+        head?: OperationObject;
+        patch?: OperationObject;
+        trace?: OperationObject;
+        servers?: ServerObject[];
+        parameters?: (ReferenceObject | ParameterObject)[];
+    }
+    interface OperationObject {
+        tags?: string[];
+        summary?: string;
+        description?: string;
+        externalDocs?: ExternalDocumentationObject;
+        operationId?: string;
+        parameters?: (ReferenceObject | ParameterObject)[];
+        requestBody?: ReferenceObject | RequestBodyObject;
+        responses: ResponsesObject;
+        callbacks?: Record<string, ReferenceObject | CallbackObject>;
+        deprecated?: boolean;
+        security?: SecurityRequirementObject[];
+        servers?: ServerObject[];
+    }
+    interface ParameterObject {
+        name: string;
+        in: 'query' | 'header' | 'path' | 'cookie';
+        description?: string;
+        required?: boolean;
+        deprecated?: boolean;
+        allowEmptyValue?: boolean;
+        style?: string;
+        explode?: boolean;
+        allowReserved?: boolean;
+        schema?: ReferenceObject | SchemaObject;
+        example?: any;
+        examples?: Record<string, ReferenceObject | ExampleObject>;
+        content?: Record<string, MediaTypeObject>;
+    }
+    interface RequestBodyObject {
+        description?: string;
+        content: Record<string, MediaTypeObject>;
+        required?: boolean;
+    }
+    interface ResponsesObject {
+        [code: string]: ReferenceObject | ResponseObject;
+    }
+    interface ResponseObject {
+        description: string;
+        headers?: Record<string, ReferenceObject | HeaderObject>;
+        content?: Record<string, MediaTypeObject>;
+        links?: Record<string, ReferenceObject | LinkObject>;
+    }
+    interface MediaTypeObject {
+        schema?: ReferenceObject | SchemaObject;
+        example?: any;
+        examples?: Record<string, ReferenceObject | ExampleObject>;
+        encoding?: Record<string, EncodingObject>;
+    }
+    interface SchemaObject {
+        title?: string;
+        multipleOf?: number;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+        maxProperties?: number;
+        minProperties?: number;
+        required?: string[];
+        enum?: any[];
+        type?: string;
+        allOf?: (ReferenceObject | SchemaObject)[];
+        oneOf?: (ReferenceObject | SchemaObject)[];
+        anyOf?: (ReferenceObject | SchemaObject)[];
+        not?: ReferenceObject | SchemaObject;
+        items?: ReferenceObject | SchemaObject;
+        properties?: Record<string, ReferenceObject | SchemaObject>;
+        additionalProperties?: boolean | ReferenceObject | SchemaObject;
+        description?: string;
+        format?: string;
+        default?: any;
+        nullable?: boolean;
+        discriminator?: DiscriminatorObject;
+        readOnly?: boolean;
+        writeOnly?: boolean;
+        xml?: XMLObject;
+        externalDocs?: ExternalDocumentationObject;
+        example?: any;
+        deprecated?: boolean;
+    }
+    interface ComponentsObject {
+        schemas?: Record<string, ReferenceObject | SchemaObject>;
+        responses?: Record<string, ReferenceObject | ResponseObject>;
+        parameters?: Record<string, ReferenceObject | ParameterObject>;
+        examples?: Record<string, ReferenceObject | ExampleObject>;
+        requestBodies?: Record<string, ReferenceObject | RequestBodyObject>;
+        headers?: Record<string, ReferenceObject | HeaderObject>;
+        securitySchemes?: Record<string, ReferenceObject | SecuritySchemeObject>;
+        links?: Record<string, ReferenceObject | LinkObject>;
+        callbacks?: Record<string, ReferenceObject | CallbackObject>;
+    }
+    interface ReferenceObject {
+        $ref: string;
+    }
+    interface ExampleObject {
+        summary?: string;
+        description?: string;
+        value?: any;
+        externalValue?: string;
+    }
+    interface HeaderObject extends Omit<ParameterObject, 'name' | 'in'> {
+    }
+    interface TagObject {
+        name: string;
+        description?: string;
+        externalDocs?: ExternalDocumentationObject;
+    }
+    interface ExternalDocumentationObject {
+        description?: string;
+        url: string;
+    }
+    interface SecurityRequirementObject {
+        [name: string]: string[];
+    }
+    interface SecuritySchemeObject {
+        type: string;
+        description?: string;
+        name?: string;
+        in?: string;
+        scheme?: string;
+        bearerFormat?: string;
+        flows?: OAuthFlowsObject;
+        openIdConnectUrl?: string;
+    }
+    interface OAuthFlowsObject {
+        implicit?: OAuthFlowObject;
+        password?: OAuthFlowObject;
+        clientCredentials?: OAuthFlowObject;
+        authorizationCode?: OAuthFlowObject;
+    }
+    interface OAuthFlowObject {
+        authorizationUrl?: string;
+        tokenUrl?: string;
+        refreshUrl?: string;
+        scopes: Record<string, string>;
+    }
+    interface DiscriminatorObject {
+        propertyName: string;
+        mapping?: Record<string, string>;
+    }
+    interface XMLObject {
+        name?: string;
+        namespace?: string;
+        prefix?: string;
+        attribute?: boolean;
+        wrapped?: boolean;
+    }
+    interface EncodingObject {
+        contentType?: string;
+        headers?: Record<string, ReferenceObject | HeaderObject>;
+        style?: string;
+        explode?: boolean;
+        allowReserved?: boolean;
+    }
+    interface LinkObject {
+        operationRef?: string;
+        operationId?: string;
+        parameters?: Record<string, any>;
+        requestBody?: any;
+        description?: string;
+        server?: ServerObject;
+    }
+    interface CallbackObject {
+        [expression: string]: PathItemObject;
+    }
+}
+/**
+ * OpenAPI Tags 装饰器 - OpenAPI 标准
+ */
+export declare function ApiTags(...tags: string[]): ClassDecorator;
+/**
+ * OpenAPI Operation 装饰器 - OpenAPI 标准
+ */
+export declare function ApiOperation(operation: Partial<OpenAPIV3.OperationObject>): MethodDecorator;
+/**
+ * OpenAPI Response 装饰器 - OpenAPI 标准
+ */
+export declare function ApiResponse(status: string | number, response: OpenAPIV3.ResponseObject): MethodDecorator;
+/**
+ * OpenAPI Parameter 装饰器 - OpenAPI 标准
+ */
+export declare function ApiParameter(param: OpenAPIV3.ParameterObject): MethodDecorator;
+/**
+ * OpenAPI Request Body 装饰器 - OpenAPI 标准
+ */
+export declare function ApiRequestBody(requestBody: OpenAPIV3.RequestBodyObject): MethodDecorator;
+/**
+ * OpenAPI Security 装饰器 - OpenAPI 标准
+ */
+export declare function ApiSecurity(security: OpenAPIV3.SecurityRequirementObject[]): MethodDecorator;
+/**
+ * OpenAPI Schema 装饰器 - OpenAPI 标准
+ */
+export declare function ApiSchema(schema: OpenAPIV3.SchemaObject): ClassDecorator;
+/**
+ * OpenAPI Property 装饰器 - OpenAPI 标准
+ */
+export declare function ApiProperty(property: OpenAPIV3.SchemaObject): PropertyDecorator;
+export declare function ApiQuery(name: string, options?: Partial<Omit<OpenAPIV3.ParameterObject, 'name' | 'in'>>): MethodDecorator;
+export declare function ApiParam(name: string, options?: Partial<Omit<OpenAPIV3.ParameterObject, 'name' | 'in'>>): MethodDecorator;
+export declare function ApiHeader(name: string, options?: Partial<Omit<OpenAPIV3.ParameterObject, 'name' | 'in'>>): MethodDecorator;
+export declare function ApiBody(content: Record<string, OpenAPIV3.MediaTypeObject>, options?: Partial<Omit<OpenAPIV3.RequestBodyObject, 'content'>>): MethodDecorator;
+//# sourceMappingURL=openapi.decorators.d.ts.map

package/dist/decorators/openapi.decorators.d.ts.map

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

package/dist/decorators/openapi.decorators.js

@@ -0,0 +1,113 @@
+import 'reflect-metadata';
+/**
+ * OpenAPI Tags 装饰器 - OpenAPI 标准
+ */
+export function ApiTags(...tags) {
+    return (target) => {
+        Reflect.defineMetadata('openapi:tags', tags, target);
+    };
+}
+/**
+ * OpenAPI Operation 装饰器 - OpenAPI 标准
+ */
+export function ApiOperation(operation) {
+    return (target, propertyKey) => {
+        if (!propertyKey)
+            return;
+        Reflect.defineMetadata('openapi:operation', operation, target, propertyKey);
+    };
+}
+/**
+ * OpenAPI Response 装饰器 - OpenAPI 标准
+ */
+export function ApiResponse(status, response) {
+    return (target, propertyKey) => {
+        if (!propertyKey)
+            return;
+        const existingResponses = Reflect.getMetadata('openapi:responses', target, propertyKey) || {};
+        existingResponses[status] = response;
+        Reflect.defineMetadata('openapi:responses', existingResponses, target, propertyKey);
+    };
+}
+/**
+ * OpenAPI Parameter 装饰器 - OpenAPI 标准
+ */
+export function ApiParameter(param) {
+    return (target, propertyKey) => {
+        if (!propertyKey)
+            return;
+        const existingParams = Reflect.getMetadata('openapi:parameters', target, propertyKey) || [];
+        existingParams.push(param);
+        Reflect.defineMetadata('openapi:parameters', existingParams, target, propertyKey);
+    };
+}
+/**
+ * OpenAPI Request Body 装饰器 - OpenAPI 标准
+ */
+export function ApiRequestBody(requestBody) {
+    return (target, propertyKey) => {
+        if (!propertyKey)
+            return;
+        Reflect.defineMetadata('openapi:requestBody', requestBody, target, propertyKey);
+    };
+}
+/**
+ * OpenAPI Security 装饰器 - OpenAPI 标准
+ */
+export function ApiSecurity(security) {
+    return (target, propertyKey) => {
+        if (!propertyKey)
+            return;
+        Reflect.defineMetadata('openapi:security', security, target, propertyKey);
+    };
+}
+/**
+ * OpenAPI Schema 装饰器 - OpenAPI 标准
+ */
+export function ApiSchema(schema) {
+    return (target) => {
+        Reflect.defineMetadata('openapi:schema', schema, target);
+    };
+}
+/**
+ * OpenAPI Property 装饰器 - OpenAPI 标准
+ */
+export function ApiProperty(property) {
+    return (target, propertyKey) => {
+        if (!propertyKey)
+            return;
+        const existingProperties = Reflect.getMetadata('openapi:properties', target.constructor) || {};
+        existingProperties[propertyKey] = property;
+        Reflect.defineMetadata('openapi:properties', existingProperties, target.constructor);
+    };
+}
+// 便捷装饰器 - 基于 OpenAPI 标准的常用场景
+export function ApiQuery(name, options = {}) {
+    return ApiParameter({
+        name,
+        in: 'query',
+        ...options
+    });
+}
+export function ApiParam(name, options = {}) {
+    return ApiParameter({
+        name,
+        in: 'path',
+        required: true,
+        ...options
+    });
+}
+export function ApiHeader(name, options = {}) {
+    return ApiParameter({
+        name,
+        in: 'header',
+        ...options
+    });
+}
+export function ApiBody(content, options = {}) {
+    return ApiRequestBody({
+        content,
+        ...options
+    });
+}
+//# sourceMappingURL=openapi.decorators.js.map

package/dist/decorators/openapi.decorators.js.map

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

package/dist/extensions.d.ts

@@ -0,0 +1,22 @@
+import type { ScalarConfig } from "./scalar-config.interface";
+import type { OpenAPIGeneratorConfig } from './openapi-generator';
+/**
+ * 扩展 HestApplicationInstance 以支持 Scalar
+ */
+declare module "@hestjs/core" {
+    interface HestApplicationInstance {
+        /**
+         * 配置 Scalar API 文档
+         */
+        useScalar(config: ScalarConfig): void;
+        /**
+         * 从控制器自动生成 OpenAPI 并配置 Scalar
+         */
+        useScalarWithControllers(controllers: any[], generatorConfig: OpenAPIGeneratorConfig, scalarConfig?: Omit<ScalarConfig, 'spec'>): void;
+    }
+}
+/**
+ * 为 HestApplicationInstance 添加 Scalar 方法
+ */
+export declare function extendWithScalar(): void;
+//# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE;;GAEG;AACH,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,uBAAuB;QAC/B;;WAEG;QACH,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;QAEtC;;WAEG;QACH,wBAAwB,CACtB,WAAW,EAAE,GAAG,EAAE,EAClB,eAAe,EAAE,sBAAsB,EACvC,YAAY,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GACxC,IAAI,CAAC;KACT;CACF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,SA0B/B"}

package/dist/extensions.js

@@ -0,0 +1,27 @@
+import { setupScalar, setupScalarWithControllers } from "./scalar.middleware";
+/**
+ * 为 HestApplicationInstance 添加 Scalar 方法
+ */
+export function extendWithScalar() {
+    const HestApplicationInstancePrototype = require("@hestjs/core").HestApplicationInstance.prototype;
+    HestApplicationInstancePrototype.useScalar = function (config) {
+        setupScalar(this.hono(), config);
+    };
+    HestApplicationInstancePrototype.useScalarWithControllers = function (controllers, generatorConfig, scalarConfig = {}) {
+        // 如果没有传入控制器，尝试从容器中获取
+        if (controllers.length === 0) {
+            try {
+                // 这里可以尝试从容器中获取所有控制器
+                // 暂时使用一个简单的实现
+                console.warn('Auto-discovery of controllers not yet implemented. Please pass controllers explicitly.');
+            }
+            catch (error) {
+                console.warn('Failed to auto-discover controllers:', error);
+            }
+        }
+        setupScalarWithControllers(this.hono(), controllers, generatorConfig, scalarConfig);
+    };
+}
+// 自动扩展
+extendWithScalar();
+//# sourceMappingURL=extensions.js.map

package/dist/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAwB9E;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,gCAAgC,GACpC,OAAO,CAAC,cAAc,CAAC,CAAC,uBAAuB,CAAC,SAAS,CAAC;IAE5D,gCAAgC,CAAC,SAAS,GAAG,UAAU,MAAoB;QACzE,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC;IAEF,gCAAgC,CAAC,wBAAwB,GAAG,UAC1D,WAAkB,EAClB,eAAuC,EACvC,eAA2C,EAAE;QAE7C,qBAAqB;QACrB,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,oBAAoB;gBACpB,cAAc;gBACd,OAAO,CAAC,IAAI,CAAC,wFAAwF,CAAC,CAAC;YACzG,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAED,0BAA0B,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,CAAC,CAAC;IACtF,CAAC,CAAC;AACJ,CAAC;AAED,OAAO;AACP,gBAAgB,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import "./extensions";
+export * from "./decorators/openapi.decorators";
+export * from "./scalar-config.interface";
+export * from "./scalar.middleware";
+export * from "./scalar.module";
+export * from "./openapi-generator";
+export * from "./utils";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,cAAc,CAAC;AAEtB,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// 首先应用扩展
+import "./extensions";
+export * from "./decorators/openapi.decorators";
+export * from "./scalar-config.interface";
+export * from "./scalar.middleware";
+export * from "./scalar.module";
+export * from "./openapi-generator";
+export * from "./utils";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,cAAc,CAAC;AAEtB,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}

package/dist/openapi-generator.d.ts

@@ -0,0 +1,61 @@
+import 'reflect-metadata';
+import type { OpenAPIV3 } from './decorators/openapi.decorators';
+/**
+ * OpenAPI 生成器配置
+ */
+export interface OpenAPIGeneratorConfig {
+    /** 基础文档信息 */
+    info: OpenAPIV3.InfoObject;
+    /** 服务器配置 */
+    servers?: OpenAPIV3.ServerObject[];
+    /** 安全方案 */
+    security?: OpenAPIV3.SecurityRequirementObject[];
+    /** 全局标签 */
+    tags?: OpenAPIV3.TagObject[];
+    /** 外部文档 */
+    externalDocs?: OpenAPIV3.ExternalDocumentationObject;
+    /** 全局组件 */
+    components?: OpenAPIV3.ComponentsObject;
+}
+/**
+ * OpenAPI 文档生成器
+ */
+export declare class OpenAPIGenerator {
+    private config;
+    private paths;
+    private components;
+    constructor(config: OpenAPIGeneratorConfig);
+    /**
+     * 从控制器类生成 OpenAPI 路径
+     */
+    addController(controller: any, basePath?: string): void;
+    /**
+     * 生成操作对象
+     */
+    private generateOperation;
+    /**
+     * 从类添加 Schema
+     */
+    private addSchemaFromClass;
+    /**
+     * 标准化路径
+     */
+    private normalizePath;
+    /**
+     * 拼接路径
+     */
+    private joinPaths;
+    /**
+     * 添加全局组件
+     */
+    addComponent(type: keyof OpenAPIV3.ComponentsObject, name: string, component: any): void;
+    /**
+     * 生成完整的 OpenAPI 文档
+     */
+    generateDocument(): OpenAPIV3;
+    /**
+     * 重置生成器
+     */
+    reset(): void;
+}
+//# sourceMappingURL=openapi-generator.d.ts.map

package/dist/openapi-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-generator.d.ts","sourceRoot":"","sources":["../src/openapi-generator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,aAAa;IACb,IAAI,EAAE,SAAS,CAAC,UAAU,CAAC;IAC3B,YAAY;IACZ,OAAO,CAAC,EAAE,SAAS,CAAC,YAAY,EAAE,CAAC;IACnC,WAAW;IACX,QAAQ,CAAC,EAAE,SAAS,CAAC,yBAAyB,EAAE,CAAC;IACjD,WAAW;IACX,IAAI,CAAC,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC;IAC7B,WAAW;IACX,YAAY,CAAC,EAAE,SAAS,CAAC,2BAA2B,CAAC;IACrD,WAAW;IACX,UAAU,CAAC,EAAE,SAAS,CAAC,gBAAgB,CAAC;CACzC;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,UAAU,CAUhB;gBAEU,MAAM,EAAE,sBAAsB;IAO1C;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,GAAG,EAAE,QAAQ,GAAE,MAAW,GAAG,IAAI;IA6B3D;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqDzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwC1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,SAAS;IAiBjB;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,SAAS,CAAC,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,IAAI;IAOxF;;OAEG;IACH,gBAAgB,IAAI,SAAS;IAqB7B;;OAEG;IACH,KAAK,IAAI,IAAI;CAiBd"}