@visulima/jsdoc-open-api 3.0.0-alpha.11 → 3.0.0-alpha.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (117) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/LICENSE.md +34 -0
  3. package/dist/cli/commander/index.cjs +1 -11
  4. package/dist/cli/commander/index.d.cts +1000 -2
  5. package/dist/cli/commander/index.d.mts +1000 -2
  6. package/dist/cli/commander/index.d.ts +1000 -2
  7. package/dist/cli/commander/index.mjs +1 -2
  8. package/dist/cli/index.cjs +1 -11
  9. package/dist/cli/index.d.cts +8 -2
  10. package/dist/cli/index.d.mts +8 -2
  11. package/dist/cli/index.d.ts +8 -2
  12. package/dist/cli/index.mjs +1 -2
  13. package/dist/index.cjs +1 -19
  14. package/dist/index.d.cts +247 -7
  15. package/dist/index.d.mts +247 -7
  16. package/dist/index.d.ts +247 -7
  17. package/dist/index.mjs +1 -6
  18. package/dist/packem_shared/SpecBuilder-CR4EZk93.cjs +1 -0
  19. package/dist/packem_shared/SpecBuilder-DjnDJFpv.mjs +1 -0
  20. package/dist/packem_shared/SwaggerCompilerPlugin-CLoD91_H.mjs +1 -0
  21. package/dist/packem_shared/SwaggerCompilerPlugin-lwIg0m84.cjs +1 -0
  22. package/dist/packem_shared/customizer-COfd-Xr1.mjs +1 -0
  23. package/dist/packem_shared/customizer-DUz3nxAJ.cjs +1 -0
  24. package/dist/packem_shared/generateCommand-BQuj1FCe.cjs +1 -0
  25. package/dist/packem_shared/generateCommand-Bn19mSDL.mjs +1 -0
  26. package/dist/packem_shared/generateCommand-DLJ2Ac1D.mjs +4 -0
  27. package/dist/packem_shared/generateCommand-DPOEw62Z.cjs +4 -0
  28. package/dist/packem_shared/initCommand-Bm4veOwd.mjs +1 -0
  29. package/dist/packem_shared/initCommand-CiV7G3q4.cjs +35 -0
  30. package/dist/packem_shared/initCommand-CwoPwelm.mjs +35 -0
  31. package/dist/packem_shared/initCommand-DAcI_ilX.cjs +1 -0
  32. package/dist/packem_shared/jsDocumentCommentsToOpenApi-Bvfi25DQ.mjs +1 -0
  33. package/dist/packem_shared/jsDocumentCommentsToOpenApi-DBYlHL5i.cjs +1 -0
  34. package/dist/packem_shared/parseFile-C7tyTcIn.cjs +1 -0
  35. package/dist/packem_shared/parseFile-CtAVjmPd.mjs +1 -0
  36. package/dist/packem_shared/swaggerJsDocumentCommentsToOpenApi-Bo1geBuG.cjs +10 -0
  37. package/dist/packem_shared/swaggerJsDocumentCommentsToOpenApi-xKOqHvN2.mjs +10 -0
  38. package/dist/packem_shared/validate-_k84qawx.mjs +1 -0
  39. package/dist/packem_shared/validate-tZa-jyuN.cjs +1 -0
  40. package/dist/packem_shared/yamlLoc-C2tVIYaz.mjs +1 -0
  41. package/dist/packem_shared/yamlLoc-DyGcp8YC.cjs +1 -0
  42. package/package.json +49 -49
  43. package/dist/cli/command/generate-command.d.cts +0 -7
  44. package/dist/cli/command/generate-command.d.mts +0 -7
  45. package/dist/cli/command/generate-command.d.ts +0 -7
  46. package/dist/cli/command/init-command.d.cts +0 -2
  47. package/dist/cli/command/init-command.d.mts +0 -2
  48. package/dist/cli/command/init-command.d.ts +0 -2
  49. package/dist/cli/commander/command/generate-command.d.cts +0 -3
  50. package/dist/cli/commander/command/generate-command.d.mts +0 -3
  51. package/dist/cli/commander/command/generate-command.d.ts +0 -3
  52. package/dist/cli/commander/command/init-command.d.cts +0 -3
  53. package/dist/cli/commander/command/init-command.d.mts +0 -3
  54. package/dist/cli/commander/command/init-command.d.ts +0 -3
  55. package/dist/constants.d.cts +0 -1
  56. package/dist/constants.d.mts +0 -1
  57. package/dist/constants.d.ts +0 -1
  58. package/dist/exported.d.cts +0 -198
  59. package/dist/exported.d.mts +0 -198
  60. package/dist/exported.d.ts +0 -198
  61. package/dist/jsdoc/comments-to-open-api.d.cts +0 -6
  62. package/dist/jsdoc/comments-to-open-api.d.mts +0 -6
  63. package/dist/jsdoc/comments-to-open-api.d.ts +0 -6
  64. package/dist/packem_shared/SpecBuilder-B7YiF7zR.mjs +0 -61
  65. package/dist/packem_shared/SpecBuilder-CCESkmm5.cjs +0 -63
  66. package/dist/packem_shared/SwaggerCompilerPlugin-BkYJzU4f.cjs +0 -88
  67. package/dist/packem_shared/SwaggerCompilerPlugin-DZ7tIJ8x.mjs +0 -86
  68. package/dist/packem_shared/customizer-CoMXMU7a.mjs +0 -8
  69. package/dist/packem_shared/customizer-DDFwFqJl.cjs +0 -10
  70. package/dist/packem_shared/generateCommand-DRMkfIle.mjs +0 -15
  71. package/dist/packem_shared/generateCommand-MwnCNgEE.cjs +0 -82
  72. package/dist/packem_shared/generateCommand-RY4QFtm7.cjs +0 -17
  73. package/dist/packem_shared/generateCommand-a9_RAbug.mjs +0 -80
  74. package/dist/packem_shared/initCommand-B6Z9EXHP.mjs +0 -15
  75. package/dist/packem_shared/initCommand-Ch-72dKZ.cjs +0 -65
  76. package/dist/packem_shared/initCommand-D3yVEMwO.cjs +0 -17
  77. package/dist/packem_shared/initCommand-zE4VRDGW.mjs +0 -63
  78. package/dist/packem_shared/jsDocumentCommentsToOpenApi-C7yMeXJ5.cjs +0 -337
  79. package/dist/packem_shared/jsDocumentCommentsToOpenApi-DtrIZ2lK.mjs +0 -331
  80. package/dist/packem_shared/parseFile-BE-sKiRK.mjs +0 -35
  81. package/dist/packem_shared/parseFile-Dk7Bw7lt.cjs +0 -42
  82. package/dist/packem_shared/swaggerJsDocumentCommentsToOpenApi-B7g9rVr5.mjs +0 -131
  83. package/dist/packem_shared/swaggerJsDocumentCommentsToOpenApi-BuB7eE94.cjs +0 -138
  84. package/dist/packem_shared/validate-DZHaKH07.mjs +0 -30
  85. package/dist/packem_shared/validate-FKieC3ln.cjs +0 -37
  86. package/dist/packem_shared/yamlLoc-C7iHWvdq.mjs +0 -14
  87. package/dist/packem_shared/yamlLoc-CEvBiR4K.cjs +0 -16
  88. package/dist/parse-file.d.cts +0 -9
  89. package/dist/parse-file.d.mts +0 -9
  90. package/dist/parse-file.d.ts +0 -9
  91. package/dist/spec-builder.d.cts +0 -14
  92. package/dist/spec-builder.d.mts +0 -14
  93. package/dist/spec-builder.d.ts +0 -14
  94. package/dist/swagger-jsdoc/comments-to-open-api.d.cts +0 -6
  95. package/dist/swagger-jsdoc/comments-to-open-api.d.mts +0 -6
  96. package/dist/swagger-jsdoc/comments-to-open-api.d.ts +0 -6
  97. package/dist/swagger-jsdoc/organize-swagger-object.d.cts +0 -7
  98. package/dist/swagger-jsdoc/organize-swagger-object.d.mts +0 -7
  99. package/dist/swagger-jsdoc/organize-swagger-object.d.ts +0 -7
  100. package/dist/swagger-jsdoc/utils.d.cts +0 -22
  101. package/dist/swagger-jsdoc/utils.d.mts +0 -22
  102. package/dist/swagger-jsdoc/utils.d.ts +0 -22
  103. package/dist/util/customizer.d.cts +0 -2
  104. package/dist/util/customizer.d.mts +0 -2
  105. package/dist/util/customizer.d.ts +0 -2
  106. package/dist/util/object-merge.d.cts +0 -2
  107. package/dist/util/object-merge.d.mts +0 -2
  108. package/dist/util/object-merge.d.ts +0 -2
  109. package/dist/util/yaml-loc.d.cts +0 -2
  110. package/dist/util/yaml-loc.d.mts +0 -2
  111. package/dist/util/yaml-loc.d.ts +0 -2
  112. package/dist/validate.d.cts +0 -2
  113. package/dist/validate.d.mts +0 -2
  114. package/dist/validate.d.ts +0 -2
  115. package/dist/webpack/swagger-compiler-plugin.d.cts +0 -15
  116. package/dist/webpack/swagger-compiler-plugin.d.mts +0 -15
  117. package/dist/webpack/swagger-compiler-plugin.d.ts +0 -15
@@ -1,2 +1 @@
1
- export { default as generateCommand } from '../../packem_shared/generateCommand-DRMkfIle.mjs';
2
- export { default as initCommand } from '../../packem_shared/initCommand-B6Z9EXHP.mjs';
1
+ import{default as m}from"../../packem_shared/generateCommand-Bn19mSDL.mjs";import{default as t}from"../../packem_shared/initCommand-Bm4veOwd.mjs";export{m as generateCommand,t as initCommand};
@@ -1,11 +1 @@
1
- 'use strict';
2
-
3
- Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
4
-
5
- const generateCommand = require('../packem_shared/generateCommand-MwnCNgEE.cjs');
6
- const initCommand = require('../packem_shared/initCommand-Ch-72dKZ.cjs');
7
-
8
-
9
-
10
- exports.generateCommand = generateCommand;
11
- exports.initCommand = initCommand;
1
+ "use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../packem_shared/generateCommand-DPOEw62Z.cjs"),t=require("../packem_shared/initCommand-CiV7G3q4.cjs");exports.generateCommand=e;exports.initCommand=t;
@@ -1,2 +1,8 @@
1
- export { default as generateCommand } from "./command/generate-command.d.cts";
2
- export { default as initCommand } from "./command/init-command.d.cts";
1
+ declare const generateCommand: (configName: string, paths: string[], options: {
2
+ config?: string;
3
+ output?: string;
4
+ verbose?: boolean;
5
+ veryVerbose?: boolean;
6
+ }) => Promise<void>;
7
+ declare const initCommand: (configName: string, packageJsonPath?: string) => void;
8
+ export { generateCommand, initCommand };
@@ -1,2 +1,8 @@
1
- export { default as generateCommand } from "./command/generate-command.d.mts";
2
- export { default as initCommand } from "./command/init-command.d.mts";
1
+ declare const generateCommand: (configName: string, paths: string[], options: {
2
+ config?: string;
3
+ output?: string;
4
+ verbose?: boolean;
5
+ veryVerbose?: boolean;
6
+ }) => Promise<void>;
7
+ declare const initCommand: (configName: string, packageJsonPath?: string) => void;
8
+ export { generateCommand, initCommand };
@@ -1,2 +1,8 @@
1
- export { default as generateCommand } from "./command/generate-command.d.ts";
2
- export { default as initCommand } from "./command/init-command.d.ts";
1
+ declare const generateCommand: (configName: string, paths: string[], options: {
2
+ config?: string;
3
+ output?: string;
4
+ verbose?: boolean;
5
+ veryVerbose?: boolean;
6
+ }) => Promise<void>;
7
+ declare const initCommand: (configName: string, packageJsonPath?: string) => void;
8
+ export { generateCommand, initCommand };
@@ -1,2 +1 @@
1
- export { default as generateCommand } from '../packem_shared/generateCommand-a9_RAbug.mjs';
2
- export { default as initCommand } from '../packem_shared/initCommand-zE4VRDGW.mjs';
1
+ import{default as m}from"../packem_shared/generateCommand-DLJ2Ac1D.mjs";import{default as t}from"../packem_shared/initCommand-CwoPwelm.mjs";export{m as generateCommand,t as initCommand};
package/dist/index.cjs CHANGED
@@ -1,19 +1 @@
1
- 'use strict';
2
-
3
- Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
4
-
5
- const jsDocumentCommentsToOpenApi = require('./packem_shared/jsDocumentCommentsToOpenApi-C7yMeXJ5.cjs');
6
- const parseFile = require('./packem_shared/parseFile-Dk7Bw7lt.cjs');
7
- const SpecBuilder = require('./packem_shared/SpecBuilder-CCESkmm5.cjs');
8
- const swaggerJsDocumentCommentsToOpenApi = require('./packem_shared/swaggerJsDocumentCommentsToOpenApi-BuB7eE94.cjs');
9
- const yamlLoc = require('./packem_shared/yamlLoc-CEvBiR4K.cjs');
10
- const SwaggerCompilerPlugin = require('./packem_shared/SwaggerCompilerPlugin-BkYJzU4f.cjs');
11
-
12
-
13
-
14
- exports.jsDocumentCommentsToOpenApi = jsDocumentCommentsToOpenApi;
15
- exports.parseFile = parseFile;
16
- exports.SpecBuilder = SpecBuilder;
17
- exports.swaggerJsDocumentCommentsToOpenApi = swaggerJsDocumentCommentsToOpenApi;
18
- exports.yamlLoc = yamlLoc;
19
- exports.SwaggerCompilerPlugin = SwaggerCompilerPlugin;
1
+ "use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("./packem_shared/jsDocumentCommentsToOpenApi-DBYlHL5i.cjs"),r=require("./packem_shared/parseFile-C7tyTcIn.cjs"),i=require("./packem_shared/SpecBuilder-CR4EZk93.cjs"),o=require("./packem_shared/swaggerJsDocumentCommentsToOpenApi-Bo1geBuG.cjs"),u=require("./packem_shared/yamlLoc-DyGcp8YC.cjs"),m=require("./packem_shared/SwaggerCompilerPlugin-lwIg0m84.cjs");exports.jsDocumentCommentsToOpenApi=e;exports.parseFile=r;exports.SpecBuilder=i;exports.swaggerJsDocumentCommentsToOpenApi=o;exports.yamlLoc=u;exports.SwaggerCompilerPlugin=m;
package/dist/index.d.cts CHANGED
@@ -1,7 +1,247 @@
1
- export type { BaseDefinition, OpenApiObject } from "./exported.d.cts";
2
- export { default as jsDocumentCommentsToOpenApi } from "./jsdoc/comments-to-open-api.d.cts";
3
- export { default as parseFile } from "./parse-file.d.cts";
4
- export { default as SpecBuilder } from "./spec-builder.d.cts";
5
- export { default as swaggerJsDocumentCommentsToOpenApi } from "./swagger-jsdoc/comments-to-open-api.d.cts";
6
- export { default as yamlLoc } from "./util/yaml-loc.d.cts";
7
- export { default as SwaggerCompilerPlugin } from "./webpack/swagger-compiler-plugin.d.cts";
1
+ import 'buffer';
2
+ import 'http';
3
+ import 'https';
4
+ import 'inspector';
5
+ import 'net';
6
+ import 'url';
7
+ import 'vm';
8
+ interface BaseDefinition {
9
+ components?: ComponentsObject;
10
+ externalDocs?: ExternalDocumentationObject;
11
+ info: InfoObject;
12
+ openapi: string;
13
+ paths?: PathsObject;
14
+ security?: SecurityRequirementObject[];
15
+ servers?: ServerObject[];
16
+ tags?: TagObject[];
17
+ }
18
+ interface OpenApiObject extends BaseDefinition {
19
+ paths?: PathsObject;
20
+ }
21
+ interface InfoObject {
22
+ contact?: ContactObject;
23
+ description?: string;
24
+ license?: LicenseObject;
25
+ termsOfService?: string;
26
+ title: string;
27
+ version: string;
28
+ }
29
+ interface ContactObject {
30
+ email?: string;
31
+ name?: string;
32
+ url?: string;
33
+ }
34
+ interface LicenseObject {
35
+ name: string;
36
+ url?: string;
37
+ }
38
+ interface ServerObject {
39
+ description?: string;
40
+ url: string;
41
+ variables?: Map<ServerVariable>;
42
+ }
43
+ interface ServerVariable {
44
+ default: string;
45
+ description?: string;
46
+ enum?: string[];
47
+ }
48
+ interface ComponentsObject {
49
+ callbacks?: Map<CallbackObject | ReferenceObject>;
50
+ examples?: Map<ExampleObject | ReferenceObject>;
51
+ headers?: Map<HeaderObject | ReferenceObject>;
52
+ links?: Map<LinkObject | ReferenceObject>;
53
+ parameters?: Map<ParameterObject | ReferenceObject>;
54
+ requestBodies?: Map<ReferenceObject | RequestBodyObject>;
55
+ responses?: Map<ReferenceObject | ResponseObject>;
56
+ schemas?: Map<ReferenceObject | SchemaObject>;
57
+ securitySchemes?: Map<ApiKeySecuritySchemeObject | HttpSecuritySchemeObject | Oauth2SecuritySchemeObject | OpenIdConnectSecuritySchemeObject | ReferenceObject>;
58
+ }
59
+ type PathsObject = Record<string, PathItemObject>;
60
+ interface PathItemObject {
61
+ $ref?: string;
62
+ delete?: OperationObject;
63
+ description?: string;
64
+ get?: OperationObject;
65
+ head?: OperationObject;
66
+ options?: OperationObject;
67
+ parameters?: (ParameterObject | ReferenceObject)[];
68
+ patch?: OperationObject;
69
+ post?: OperationObject;
70
+ put?: OperationObject;
71
+ servers?: ServerObject[];
72
+ summary?: string;
73
+ trace?: OperationObject;
74
+ }
75
+ interface OperationObject {
76
+ callbacks?: Map<CallbackObject | ReferenceObject>;
77
+ deprecated?: boolean;
78
+ description?: string;
79
+ externalDocs?: ExternalDocumentationObject;
80
+ operationId?: string;
81
+ parameters?: (ParameterObject | ReferenceObject)[];
82
+ requestBody?: ReferenceObject | RequestBodyObject;
83
+ responses: ResponsesObject;
84
+ security?: SecurityRequirementObject[];
85
+ servers?: ServerObject[];
86
+ summary?: string;
87
+ tags?: string[];
88
+ }
89
+ interface ExternalDocumentationObject {
90
+ description?: string;
91
+ url: string;
92
+ }
93
+ interface ParameterObject {
94
+ allowEmptyValue?: boolean;
95
+ allowReserved?: boolean;
96
+ content?: Map<MediaTypeObject>;
97
+ deprecated?: boolean;
98
+ description?: string;
99
+ example?: any;
100
+ examples?: Map<ExampleObject | ReferenceObject>;
101
+ explode?: string;
102
+ in: string;
103
+ name: string;
104
+ required?: boolean;
105
+ schema?: ReferenceObject | SchemaObject;
106
+ style?: string;
107
+ }
108
+ interface RequestBodyObject {
109
+ content: Map<MediaTypeObject>;
110
+ description?: string;
111
+ required?: boolean;
112
+ }
113
+ interface MediaTypeObject {
114
+ encoding?: Map<EncodingObject>;
115
+ example?: any;
116
+ examples?: Map<ExampleObject | ReferenceObject>;
117
+ schema?: ReferenceObject | SchemaObject;
118
+ }
119
+ interface EncodingObject {
120
+ allowReserved?: boolean;
121
+ contentType?: string;
122
+ explode?: boolean;
123
+ headers?: Map<HeaderObject | ReferenceObject>;
124
+ style?: string;
125
+ }
126
+ type ResponsesObject = Record<string, ReferenceObject | ResponseObject>;
127
+ interface ResponseObject {
128
+ content?: Map<MediaTypeObject>;
129
+ description: string;
130
+ headers?: Map<HeaderObject | ReferenceObject>;
131
+ links?: Map<LinkObject | ReferenceObject>;
132
+ }
133
+ type CallbackObject = Record<string, PathItemObject>;
134
+ interface ExampleObject {
135
+ description?: string;
136
+ externalValue?: string;
137
+ summary?: string;
138
+ value?: any;
139
+ }
140
+ interface LinkObject {
141
+ description?: string;
142
+ operationId?: string;
143
+ operationRef?: string;
144
+ parameters?: Map<any>;
145
+ requestBody?: any;
146
+ server?: ServerObject;
147
+ }
148
+ interface HeaderObject {
149
+ allowEmptyValue?: boolean;
150
+ allowReserved?: boolean;
151
+ content?: Map<MediaTypeObject>;
152
+ deprecated?: boolean;
153
+ description?: string;
154
+ example?: any;
155
+ examples?: Map<ExampleObject | ReferenceObject>;
156
+ explode?: string;
157
+ required?: boolean;
158
+ schema?: ReferenceObject | SchemaObject;
159
+ style?: string;
160
+ }
161
+ interface TagObject {
162
+ description?: string;
163
+ externalDocs?: ExternalDocumentationObject;
164
+ name: string;
165
+ }
166
+ interface ReferenceObject {
167
+ $ref: string;
168
+ }
169
+ type SchemaObject = Record<string, any>;
170
+ interface ApiKeySecuritySchemeObject {
171
+ description?: string;
172
+ in: string;
173
+ name: string;
174
+ type: string;
175
+ }
176
+ interface HttpSecuritySchemeObject {
177
+ bearerFormat?: string;
178
+ description?: string;
179
+ scheme: string;
180
+ type: string;
181
+ }
182
+ interface Oauth2SecuritySchemeObject {
183
+ description?: string;
184
+ flows: OAuthFlowsObject;
185
+ type: string;
186
+ }
187
+ interface OpenIdConnectSecuritySchemeObject {
188
+ description?: string;
189
+ openIdConnectUrl: string;
190
+ type: string;
191
+ }
192
+ interface OAuthFlowsObject {
193
+ authorizationCode?: OAuthFlowObject;
194
+ clientCredentials?: OAuthFlowObject;
195
+ implicit?: OAuthFlowObject;
196
+ password?: OAuthFlowObject;
197
+ }
198
+ interface OAuthFlowObject {
199
+ authorizationUrl?: string;
200
+ refreshUrl: string;
201
+ scopes: Map<string>;
202
+ tokenUrl?: string;
203
+ }
204
+ type SecurityRequirementObject = Record<string, string[]>;
205
+ type Map<T> = Record<string, T>;
206
+ declare const commentsToOpenApi$1: (fileContents: string, verbose?: boolean) => {
207
+ loc: number;
208
+ spec: OpenApiObject;
209
+ }[];
210
+ declare const parseFile: (file: string, commentsToOpenApi: (fileContent: string, verbose?: boolean) => {
211
+ loc: number;
212
+ spec: OpenApiObject;
213
+ }[], verbose?: boolean) => {
214
+ loc: number;
215
+ spec: OpenApiObject;
216
+ }[];
217
+ declare class SpecBuilder implements OpenApiObject {
218
+ components?: ComponentsObject;
219
+ externalDocs?: ExternalDocumentationObject;
220
+ info: InfoObject;
221
+ openapi: string;
222
+ paths: PathsObject;
223
+ security?: SecurityRequirementObject[];
224
+ servers?: ServerObject[];
225
+ tags?: TagObject[];
226
+ constructor(baseDefinition: BaseDefinition);
227
+ addData(parsedFile: OpenApiObject[]): void;
228
+ }
229
+ declare const commentsToOpenApi: (fileContents: string, verbose?: boolean) => {
230
+ loc: number;
231
+ spec: OpenApiObject;
232
+ }[];
233
+ declare const yamlLoc: (string: string) => number;
234
+ type WebpackCompiler = undefined;
235
+ declare class SwaggerCompilerPlugin {
236
+ private readonly assetsPath;
237
+ private readonly ignore;
238
+ private readonly sources;
239
+ private readonly swaggerDefinition;
240
+ private readonly verbose;
241
+ constructor(assetsPath: string, sources: string[], swaggerDefinition: BaseDefinition, options: {
242
+ ignore?: (RegExp | string)[];
243
+ verbose?: boolean;
244
+ });
245
+ apply(compiler: WebpackCompiler): void;
246
+ }
247
+ export { type BaseDefinition, type OpenApiObject, SpecBuilder, SwaggerCompilerPlugin, commentsToOpenApi$1 as jsDocumentCommentsToOpenApi, parseFile, commentsToOpenApi as swaggerJsDocumentCommentsToOpenApi, yamlLoc };
package/dist/index.d.mts CHANGED
@@ -1,7 +1,247 @@
1
- export type { BaseDefinition, OpenApiObject } from "./exported.d.mts";
2
- export { default as jsDocumentCommentsToOpenApi } from "./jsdoc/comments-to-open-api.d.mts";
3
- export { default as parseFile } from "./parse-file.d.mts";
4
- export { default as SpecBuilder } from "./spec-builder.d.mts";
5
- export { default as swaggerJsDocumentCommentsToOpenApi } from "./swagger-jsdoc/comments-to-open-api.d.mts";
6
- export { default as yamlLoc } from "./util/yaml-loc.d.mts";
7
- export { default as SwaggerCompilerPlugin } from "./webpack/swagger-compiler-plugin.d.mts";
1
+ import 'buffer';
2
+ import 'http';
3
+ import 'https';
4
+ import 'inspector';
5
+ import 'net';
6
+ import 'url';
7
+ import 'vm';
8
+ interface BaseDefinition {
9
+ components?: ComponentsObject;
10
+ externalDocs?: ExternalDocumentationObject;
11
+ info: InfoObject;
12
+ openapi: string;
13
+ paths?: PathsObject;
14
+ security?: SecurityRequirementObject[];
15
+ servers?: ServerObject[];
16
+ tags?: TagObject[];
17
+ }
18
+ interface OpenApiObject extends BaseDefinition {
19
+ paths?: PathsObject;
20
+ }
21
+ interface InfoObject {
22
+ contact?: ContactObject;
23
+ description?: string;
24
+ license?: LicenseObject;
25
+ termsOfService?: string;
26
+ title: string;
27
+ version: string;
28
+ }
29
+ interface ContactObject {
30
+ email?: string;
31
+ name?: string;
32
+ url?: string;
33
+ }
34
+ interface LicenseObject {
35
+ name: string;
36
+ url?: string;
37
+ }
38
+ interface ServerObject {
39
+ description?: string;
40
+ url: string;
41
+ variables?: Map<ServerVariable>;
42
+ }
43
+ interface ServerVariable {
44
+ default: string;
45
+ description?: string;
46
+ enum?: string[];
47
+ }
48
+ interface ComponentsObject {
49
+ callbacks?: Map<CallbackObject | ReferenceObject>;
50
+ examples?: Map<ExampleObject | ReferenceObject>;
51
+ headers?: Map<HeaderObject | ReferenceObject>;
52
+ links?: Map<LinkObject | ReferenceObject>;
53
+ parameters?: Map<ParameterObject | ReferenceObject>;
54
+ requestBodies?: Map<ReferenceObject | RequestBodyObject>;
55
+ responses?: Map<ReferenceObject | ResponseObject>;
56
+ schemas?: Map<ReferenceObject | SchemaObject>;
57
+ securitySchemes?: Map<ApiKeySecuritySchemeObject | HttpSecuritySchemeObject | Oauth2SecuritySchemeObject | OpenIdConnectSecuritySchemeObject | ReferenceObject>;
58
+ }
59
+ type PathsObject = Record<string, PathItemObject>;
60
+ interface PathItemObject {
61
+ $ref?: string;
62
+ delete?: OperationObject;
63
+ description?: string;
64
+ get?: OperationObject;
65
+ head?: OperationObject;
66
+ options?: OperationObject;
67
+ parameters?: (ParameterObject | ReferenceObject)[];
68
+ patch?: OperationObject;
69
+ post?: OperationObject;
70
+ put?: OperationObject;
71
+ servers?: ServerObject[];
72
+ summary?: string;
73
+ trace?: OperationObject;
74
+ }
75
+ interface OperationObject {
76
+ callbacks?: Map<CallbackObject | ReferenceObject>;
77
+ deprecated?: boolean;
78
+ description?: string;
79
+ externalDocs?: ExternalDocumentationObject;
80
+ operationId?: string;
81
+ parameters?: (ParameterObject | ReferenceObject)[];
82
+ requestBody?: ReferenceObject | RequestBodyObject;
83
+ responses: ResponsesObject;
84
+ security?: SecurityRequirementObject[];
85
+ servers?: ServerObject[];
86
+ summary?: string;
87
+ tags?: string[];
88
+ }
89
+ interface ExternalDocumentationObject {
90
+ description?: string;
91
+ url: string;
92
+ }
93
+ interface ParameterObject {
94
+ allowEmptyValue?: boolean;
95
+ allowReserved?: boolean;
96
+ content?: Map<MediaTypeObject>;
97
+ deprecated?: boolean;
98
+ description?: string;
99
+ example?: any;
100
+ examples?: Map<ExampleObject | ReferenceObject>;
101
+ explode?: string;
102
+ in: string;
103
+ name: string;
104
+ required?: boolean;
105
+ schema?: ReferenceObject | SchemaObject;
106
+ style?: string;
107
+ }
108
+ interface RequestBodyObject {
109
+ content: Map<MediaTypeObject>;
110
+ description?: string;
111
+ required?: boolean;
112
+ }
113
+ interface MediaTypeObject {
114
+ encoding?: Map<EncodingObject>;
115
+ example?: any;
116
+ examples?: Map<ExampleObject | ReferenceObject>;
117
+ schema?: ReferenceObject | SchemaObject;
118
+ }
119
+ interface EncodingObject {
120
+ allowReserved?: boolean;
121
+ contentType?: string;
122
+ explode?: boolean;
123
+ headers?: Map<HeaderObject | ReferenceObject>;
124
+ style?: string;
125
+ }
126
+ type ResponsesObject = Record<string, ReferenceObject | ResponseObject>;
127
+ interface ResponseObject {
128
+ content?: Map<MediaTypeObject>;
129
+ description: string;
130
+ headers?: Map<HeaderObject | ReferenceObject>;
131
+ links?: Map<LinkObject | ReferenceObject>;
132
+ }
133
+ type CallbackObject = Record<string, PathItemObject>;
134
+ interface ExampleObject {
135
+ description?: string;
136
+ externalValue?: string;
137
+ summary?: string;
138
+ value?: any;
139
+ }
140
+ interface LinkObject {
141
+ description?: string;
142
+ operationId?: string;
143
+ operationRef?: string;
144
+ parameters?: Map<any>;
145
+ requestBody?: any;
146
+ server?: ServerObject;
147
+ }
148
+ interface HeaderObject {
149
+ allowEmptyValue?: boolean;
150
+ allowReserved?: boolean;
151
+ content?: Map<MediaTypeObject>;
152
+ deprecated?: boolean;
153
+ description?: string;
154
+ example?: any;
155
+ examples?: Map<ExampleObject | ReferenceObject>;
156
+ explode?: string;
157
+ required?: boolean;
158
+ schema?: ReferenceObject | SchemaObject;
159
+ style?: string;
160
+ }
161
+ interface TagObject {
162
+ description?: string;
163
+ externalDocs?: ExternalDocumentationObject;
164
+ name: string;
165
+ }
166
+ interface ReferenceObject {
167
+ $ref: string;
168
+ }
169
+ type SchemaObject = Record<string, any>;
170
+ interface ApiKeySecuritySchemeObject {
171
+ description?: string;
172
+ in: string;
173
+ name: string;
174
+ type: string;
175
+ }
176
+ interface HttpSecuritySchemeObject {
177
+ bearerFormat?: string;
178
+ description?: string;
179
+ scheme: string;
180
+ type: string;
181
+ }
182
+ interface Oauth2SecuritySchemeObject {
183
+ description?: string;
184
+ flows: OAuthFlowsObject;
185
+ type: string;
186
+ }
187
+ interface OpenIdConnectSecuritySchemeObject {
188
+ description?: string;
189
+ openIdConnectUrl: string;
190
+ type: string;
191
+ }
192
+ interface OAuthFlowsObject {
193
+ authorizationCode?: OAuthFlowObject;
194
+ clientCredentials?: OAuthFlowObject;
195
+ implicit?: OAuthFlowObject;
196
+ password?: OAuthFlowObject;
197
+ }
198
+ interface OAuthFlowObject {
199
+ authorizationUrl?: string;
200
+ refreshUrl: string;
201
+ scopes: Map<string>;
202
+ tokenUrl?: string;
203
+ }
204
+ type SecurityRequirementObject = Record<string, string[]>;
205
+ type Map<T> = Record<string, T>;
206
+ declare const commentsToOpenApi$1: (fileContents: string, verbose?: boolean) => {
207
+ loc: number;
208
+ spec: OpenApiObject;
209
+ }[];
210
+ declare const parseFile: (file: string, commentsToOpenApi: (fileContent: string, verbose?: boolean) => {
211
+ loc: number;
212
+ spec: OpenApiObject;
213
+ }[], verbose?: boolean) => {
214
+ loc: number;
215
+ spec: OpenApiObject;
216
+ }[];
217
+ declare class SpecBuilder implements OpenApiObject {
218
+ components?: ComponentsObject;
219
+ externalDocs?: ExternalDocumentationObject;
220
+ info: InfoObject;
221
+ openapi: string;
222
+ paths: PathsObject;
223
+ security?: SecurityRequirementObject[];
224
+ servers?: ServerObject[];
225
+ tags?: TagObject[];
226
+ constructor(baseDefinition: BaseDefinition);
227
+ addData(parsedFile: OpenApiObject[]): void;
228
+ }
229
+ declare const commentsToOpenApi: (fileContents: string, verbose?: boolean) => {
230
+ loc: number;
231
+ spec: OpenApiObject;
232
+ }[];
233
+ declare const yamlLoc: (string: string) => number;
234
+ type WebpackCompiler = undefined;
235
+ declare class SwaggerCompilerPlugin {
236
+ private readonly assetsPath;
237
+ private readonly ignore;
238
+ private readonly sources;
239
+ private readonly swaggerDefinition;
240
+ private readonly verbose;
241
+ constructor(assetsPath: string, sources: string[], swaggerDefinition: BaseDefinition, options: {
242
+ ignore?: (RegExp | string)[];
243
+ verbose?: boolean;
244
+ });
245
+ apply(compiler: WebpackCompiler): void;
246
+ }
247
+ export { type BaseDefinition, type OpenApiObject, SpecBuilder, SwaggerCompilerPlugin, commentsToOpenApi$1 as jsDocumentCommentsToOpenApi, parseFile, commentsToOpenApi as swaggerJsDocumentCommentsToOpenApi, yamlLoc };