@visulima/jsdoc-open-api 3.0.0-alpha.2 → 3.0.0-alpha.21

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 (59) hide show
  1. package/CHANGELOG.md +220 -0
  2. package/LICENSE.md +35 -1
  3. package/dist/cli/commander/index.cjs +1 -0
  4. package/dist/cli/commander/index.d.cts +1000 -0
  5. package/dist/cli/commander/index.d.mts +996 -3
  6. package/dist/cli/commander/index.d.ts +996 -3
  7. package/dist/cli/commander/index.mjs +1 -30
  8. package/dist/cli/index.cjs +1 -0
  9. package/dist/cli/index.d.cts +8 -0
  10. package/dist/cli/index.d.mts +4 -6
  11. package/dist/cli/index.d.ts +4 -6
  12. package/dist/cli/index.mjs +1 -4
  13. package/dist/index.cjs +1 -0
  14. package/dist/index.d.cts +247 -0
  15. package/dist/index.d.mts +176 -177
  16. package/dist/index.d.ts +176 -177
  17. package/dist/index.mjs +1 -85
  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 +66 -54
  43. package/dist/chunk-46IWFMQ2.mjs +0 -1205
  44. package/dist/chunk-46IWFMQ2.mjs.map +0 -1
  45. package/dist/chunk-KI63G47G.mjs +0 -142
  46. package/dist/chunk-KI63G47G.mjs.map +0 -1
  47. package/dist/chunk-QK4CXNUY.js +0 -149
  48. package/dist/chunk-QK4CXNUY.js.map +0 -1
  49. package/dist/chunk-WEX5DMNT.js +0 -1223
  50. package/dist/chunk-WEX5DMNT.js.map +0 -1
  51. package/dist/cli/commander/index.js +0 -33
  52. package/dist/cli/commander/index.js.map +0 -1
  53. package/dist/cli/commander/index.mjs.map +0 -1
  54. package/dist/cli/index.js +0 -17
  55. package/dist/cli/index.js.map +0 -1
  56. package/dist/cli/index.mjs.map +0 -1
  57. package/dist/index.js +0 -106
  58. package/dist/index.js.map +0 -1
  59. package/dist/index.mjs.map +0 -1
package/dist/index.d.mts CHANGED
@@ -1,248 +1,247 @@
1
- import { Compiler } from 'webpack';
2
-
1
+ import 'buffer';
2
+ import 'http';
3
+ import 'https';
4
+ import 'inspector';
5
+ import 'net';
6
+ import 'url';
7
+ import 'vm';
3
8
  interface BaseDefinition {
4
- components?: ComponentsObject;
5
- externalDocs?: ExternalDocumentationObject;
6
- info: InfoObject;
7
- openapi: string;
8
- paths?: PathsObject;
9
- security?: SecurityRequirementObject[];
10
- servers?: ServerObject[];
11
- tags?: TagObject[];
9
+ components?: ComponentsObject;
10
+ externalDocs?: ExternalDocumentationObject;
11
+ info: InfoObject;
12
+ openapi: string;
13
+ paths?: PathsObject;
14
+ security?: SecurityRequirementObject[];
15
+ servers?: ServerObject[];
16
+ tags?: TagObject[];
12
17
  }
13
18
  interface OpenApiObject extends BaseDefinition {
14
- paths?: PathsObject;
19
+ paths?: PathsObject;
15
20
  }
16
21
  interface InfoObject {
17
- contact?: ContactObject;
18
- description?: string;
19
- license?: LicenseObject;
20
- termsOfService?: string;
21
- title: string;
22
- version: string;
22
+ contact?: ContactObject;
23
+ description?: string;
24
+ license?: LicenseObject;
25
+ termsOfService?: string;
26
+ title: string;
27
+ version: string;
23
28
  }
24
29
  interface ContactObject {
25
- email?: string;
26
- name?: string;
27
- url?: string;
30
+ email?: string;
31
+ name?: string;
32
+ url?: string;
28
33
  }
29
34
  interface LicenseObject {
30
- name: string;
31
- url?: string;
35
+ name: string;
36
+ url?: string;
32
37
  }
33
38
  interface ServerObject {
34
- description?: string;
35
- url: string;
36
- variables?: Map<ServerVariable>;
39
+ description?: string;
40
+ url: string;
41
+ variables?: Map<ServerVariable>;
37
42
  }
38
43
  interface ServerVariable {
39
- default: string;
40
- description?: string;
41
- enum?: string[];
44
+ default: string;
45
+ description?: string;
46
+ enum?: string[];
42
47
  }
43
48
  interface ComponentsObject {
44
- callbacks?: Map<CallbackObject | ReferenceObject>;
45
- examples?: Map<ExampleObject | ReferenceObject>;
46
- headers?: Map<HeaderObject | ReferenceObject>;
47
- links?: Map<LinkObject | ReferenceObject>;
48
- parameters?: Map<ParameterObject | ReferenceObject>;
49
- requestBodies?: Map<ReferenceObject | RequestBodyObject>;
50
- responses?: Map<ReferenceObject | ResponseObject>;
51
- schemas?: Map<ReferenceObject | SchemaObject>;
52
- securitySchemes?: Map<ApiKeySecuritySchemeObject | HttpSecuritySchemeObject | Oauth2SecuritySchemeObject | OpenIdConnectSecuritySchemeObject | ReferenceObject>;
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>;
53
58
  }
54
59
  type PathsObject = Record<string, PathItemObject>;
55
60
  interface PathItemObject {
56
- $ref?: string;
57
- delete?: OperationObject;
58
- description?: string;
59
- get?: OperationObject;
60
- head?: OperationObject;
61
- options?: OperationObject;
62
- parameters?: (ParameterObject | ReferenceObject)[];
63
- patch?: OperationObject;
64
- post?: OperationObject;
65
- put?: OperationObject;
66
- servers?: ServerObject[];
67
- summary?: string;
68
- trace?: OperationObject;
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;
69
74
  }
70
75
  interface OperationObject {
71
- callbacks?: Map<CallbackObject | ReferenceObject>;
72
- deprecated?: boolean;
73
- description?: string;
74
- externalDocs?: ExternalDocumentationObject;
75
- operationId?: string;
76
- parameters?: (ParameterObject | ReferenceObject)[];
77
- requestBody?: ReferenceObject | RequestBodyObject;
78
- responses: ResponsesObject;
79
- security?: SecurityRequirementObject[];
80
- servers?: ServerObject[];
81
- summary?: string;
82
- tags?: string[];
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[];
83
88
  }
84
89
  interface ExternalDocumentationObject {
85
- description?: string;
86
- url: string;
90
+ description?: string;
91
+ url: string;
87
92
  }
88
93
  interface ParameterObject {
89
- allowEmptyValue?: boolean;
90
- allowReserved?: boolean;
91
- content?: Map<MediaTypeObject>;
92
- deprecated?: boolean;
93
- description?: string;
94
- example?: any;
95
- examples?: Map<ExampleObject | ReferenceObject>;
96
- explode?: string;
97
- in: string;
98
- name: string;
99
- required?: boolean;
100
- schema?: ReferenceObject | SchemaObject;
101
- style?: string;
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;
102
107
  }
103
108
  interface RequestBodyObject {
104
- content: Map<MediaTypeObject>;
105
- description?: string;
106
- required?: boolean;
109
+ content: Map<MediaTypeObject>;
110
+ description?: string;
111
+ required?: boolean;
107
112
  }
108
113
  interface MediaTypeObject {
109
- encoding?: Map<EncodingObject>;
110
- example?: any;
111
- examples?: Map<ExampleObject | ReferenceObject>;
112
- schema?: ReferenceObject | SchemaObject;
114
+ encoding?: Map<EncodingObject>;
115
+ example?: any;
116
+ examples?: Map<ExampleObject | ReferenceObject>;
117
+ schema?: ReferenceObject | SchemaObject;
113
118
  }
114
119
  interface EncodingObject {
115
- allowReserved?: boolean;
116
- contentType?: string;
117
- explode?: boolean;
118
- headers?: Map<HeaderObject | ReferenceObject>;
119
- style?: string;
120
+ allowReserved?: boolean;
121
+ contentType?: string;
122
+ explode?: boolean;
123
+ headers?: Map<HeaderObject | ReferenceObject>;
124
+ style?: string;
120
125
  }
121
126
  type ResponsesObject = Record<string, ReferenceObject | ResponseObject>;
122
127
  interface ResponseObject {
123
- content?: Map<MediaTypeObject>;
124
- description: string;
125
- headers?: Map<HeaderObject | ReferenceObject>;
126
- links?: Map<LinkObject | ReferenceObject>;
128
+ content?: Map<MediaTypeObject>;
129
+ description: string;
130
+ headers?: Map<HeaderObject | ReferenceObject>;
131
+ links?: Map<LinkObject | ReferenceObject>;
127
132
  }
128
133
  type CallbackObject = Record<string, PathItemObject>;
129
134
  interface ExampleObject {
130
- description?: string;
131
- externalValue?: string;
132
- summary?: string;
133
- value?: any;
135
+ description?: string;
136
+ externalValue?: string;
137
+ summary?: string;
138
+ value?: any;
134
139
  }
135
140
  interface LinkObject {
136
- description?: string;
137
- operationId?: string;
138
- operationRef?: string;
139
- parameters?: Map<any>;
140
- requestBody?: any;
141
- server?: ServerObject;
141
+ description?: string;
142
+ operationId?: string;
143
+ operationRef?: string;
144
+ parameters?: Map<any>;
145
+ requestBody?: any;
146
+ server?: ServerObject;
142
147
  }
143
148
  interface HeaderObject {
144
- allowEmptyValue?: boolean;
145
- allowReserved?: boolean;
146
- content?: Map<MediaTypeObject>;
147
- deprecated?: boolean;
148
- description?: string;
149
- example?: any;
150
- examples?: Map<ExampleObject | ReferenceObject>;
151
- explode?: string;
152
- required?: boolean;
153
- schema?: ReferenceObject | SchemaObject;
154
- style?: string;
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;
155
160
  }
156
161
  interface TagObject {
157
- description?: string;
158
- externalDocs?: ExternalDocumentationObject;
159
- name: string;
162
+ description?: string;
163
+ externalDocs?: ExternalDocumentationObject;
164
+ name: string;
160
165
  }
161
166
  interface ReferenceObject {
162
- $ref: string;
167
+ $ref: string;
163
168
  }
164
169
  type SchemaObject = Record<string, any>;
165
170
  interface ApiKeySecuritySchemeObject {
166
- description?: string;
167
- in: string;
168
- name: string;
169
- type: string;
171
+ description?: string;
172
+ in: string;
173
+ name: string;
174
+ type: string;
170
175
  }
171
176
  interface HttpSecuritySchemeObject {
172
- bearerFormat?: string;
173
- description?: string;
174
- scheme: string;
175
- type: string;
177
+ bearerFormat?: string;
178
+ description?: string;
179
+ scheme: string;
180
+ type: string;
176
181
  }
177
182
  interface Oauth2SecuritySchemeObject {
178
- description?: string;
179
- flows: OAuthFlowsObject;
180
- type: string;
183
+ description?: string;
184
+ flows: OAuthFlowsObject;
185
+ type: string;
181
186
  }
182
187
  interface OpenIdConnectSecuritySchemeObject {
183
- description?: string;
184
- openIdConnectUrl: string;
185
- type: string;
188
+ description?: string;
189
+ openIdConnectUrl: string;
190
+ type: string;
186
191
  }
187
192
  interface OAuthFlowsObject {
188
- authorizationCode?: OAuthFlowObject;
189
- clientCredentials?: OAuthFlowObject;
190
- implicit?: OAuthFlowObject;
191
- password?: OAuthFlowObject;
193
+ authorizationCode?: OAuthFlowObject;
194
+ clientCredentials?: OAuthFlowObject;
195
+ implicit?: OAuthFlowObject;
196
+ password?: OAuthFlowObject;
192
197
  }
193
198
  interface OAuthFlowObject {
194
- authorizationUrl?: string;
195
- refreshUrl: string;
196
- scopes: Map<string>;
197
- tokenUrl?: string;
199
+ authorizationUrl?: string;
200
+ refreshUrl: string;
201
+ scopes: Map<string>;
202
+ tokenUrl?: string;
198
203
  }
199
204
  type SecurityRequirementObject = Record<string, string[]>;
200
205
  type Map<T> = Record<string, T>;
201
-
202
206
  declare const commentsToOpenApi$1: (fileContents: string, verbose?: boolean) => {
203
- loc: number;
204
- spec: OpenApiObject;
207
+ loc: number;
208
+ spec: OpenApiObject;
205
209
  }[];
206
-
207
210
  declare const parseFile: (file: string, commentsToOpenApi: (fileContent: string, verbose?: boolean) => {
208
- loc: number;
209
- spec: OpenApiObject;
211
+ loc: number;
212
+ spec: OpenApiObject;
210
213
  }[], verbose?: boolean) => {
211
- loc: number;
212
- spec: OpenApiObject;
214
+ loc: number;
215
+ spec: OpenApiObject;
213
216
  }[];
214
-
215
217
  declare class SpecBuilder implements OpenApiObject {
216
- components?: ComponentsObject;
217
- externalDocs?: ExternalDocumentationObject;
218
- info: InfoObject;
219
- openapi: string;
220
- paths: PathsObject;
221
- security?: SecurityRequirementObject[];
222
- servers?: ServerObject[];
223
- tags?: TagObject[];
224
- constructor(baseDefinition: BaseDefinition);
225
- addData(parsedFile: OpenApiObject[]): void;
226
- }
227
-
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
+ }
228
229
  declare const commentsToOpenApi: (fileContents: string, verbose?: boolean) => {
229
- loc: number;
230
- spec: OpenApiObject;
230
+ loc: number;
231
+ spec: OpenApiObject;
231
232
  }[];
232
-
233
233
  declare const yamlLoc: (string: string) => number;
234
-
234
+ type WebpackCompiler = undefined;
235
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: Compiler): void;
246
- }
247
-
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
+ }
248
247
  export { type BaseDefinition, type OpenApiObject, SpecBuilder, SwaggerCompilerPlugin, commentsToOpenApi$1 as jsDocumentCommentsToOpenApi, parseFile, commentsToOpenApi as swaggerJsDocumentCommentsToOpenApi, yamlLoc };