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

package/dist/index.d.ts

@@ -1,248 +1,247 @@
-import { Compiler } from 'webpack';
-
+import 'buffer';
+import 'http';
+import 'https';
+import 'inspector';
+import 'net';
+import 'url';
+import 'vm';
 interface BaseDefinition {
-    components?: ComponentsObject;
-    externalDocs?: ExternalDocumentationObject;
-    info: InfoObject;
-    openapi: string;
-    paths?: PathsObject;
-    security?: SecurityRequirementObject[];
-    servers?: ServerObject[];
-    tags?: TagObject[];
+  components?: ComponentsObject;
+  externalDocs?: ExternalDocumentationObject;
+  info: InfoObject;
+  openapi: string;
+  paths?: PathsObject;
+  security?: SecurityRequirementObject[];
+  servers?: ServerObject[];
+  tags?: TagObject[];
 }
 interface OpenApiObject extends BaseDefinition {
-    paths?: PathsObject;
+  paths?: PathsObject;
 }
 interface InfoObject {
-    contact?: ContactObject;
-    description?: string;
-    license?: LicenseObject;
-    termsOfService?: string;
-    title: string;
-    version: string;
+  contact?: ContactObject;
+  description?: string;
+  license?: LicenseObject;
+  termsOfService?: string;
+  title: string;
+  version: string;
 }
 interface ContactObject {
-    email?: string;
-    name?: string;
-    url?: string;
+  email?: string;
+  name?: string;
+  url?: string;
 }
 interface LicenseObject {
-    name: string;
-    url?: string;
+  name: string;
+  url?: string;
 }
 interface ServerObject {
-    description?: string;
-    url: string;
-    variables?: Map<ServerVariable>;
+  description?: string;
+  url: string;
+  variables?: Map<ServerVariable>;
 }
 interface ServerVariable {
-    default: string;
-    description?: string;
-    enum?: string[];
+  default: string;
+  description?: string;
+  enum?: string[];
 }
 interface ComponentsObject {
-    callbacks?: Map<CallbackObject | ReferenceObject>;
-    examples?: Map<ExampleObject | ReferenceObject>;
-    headers?: Map<HeaderObject | ReferenceObject>;
-    links?: Map<LinkObject | ReferenceObject>;
-    parameters?: Map<ParameterObject | ReferenceObject>;
-    requestBodies?: Map<ReferenceObject | RequestBodyObject>;
-    responses?: Map<ReferenceObject | ResponseObject>;
-    schemas?: Map<ReferenceObject | SchemaObject>;
-    securitySchemes?: Map<ApiKeySecuritySchemeObject | HttpSecuritySchemeObject | Oauth2SecuritySchemeObject | OpenIdConnectSecuritySchemeObject | ReferenceObject>;
+  callbacks?: Map<CallbackObject | ReferenceObject>;
+  examples?: Map<ExampleObject | ReferenceObject>;
+  headers?: Map<HeaderObject | ReferenceObject>;
+  links?: Map<LinkObject | ReferenceObject>;
+  parameters?: Map<ParameterObject | ReferenceObject>;
+  requestBodies?: Map<ReferenceObject | RequestBodyObject>;
+  responses?: Map<ReferenceObject | ResponseObject>;
+  schemas?: Map<ReferenceObject | SchemaObject>;
+  securitySchemes?: Map<ApiKeySecuritySchemeObject | HttpSecuritySchemeObject | Oauth2SecuritySchemeObject | OpenIdConnectSecuritySchemeObject | ReferenceObject>;
 }
 type PathsObject = Record<string, PathItemObject>;
 interface PathItemObject {
-    $ref?: string;
-    delete?: OperationObject;
-    description?: string;
-    get?: OperationObject;
-    head?: OperationObject;
-    options?: OperationObject;
-    parameters?: (ParameterObject | ReferenceObject)[];
-    patch?: OperationObject;
-    post?: OperationObject;
-    put?: OperationObject;
-    servers?: ServerObject[];
-    summary?: string;
-    trace?: OperationObject;
+  $ref?: string;
+  delete?: OperationObject;
+  description?: string;
+  get?: OperationObject;
+  head?: OperationObject;
+  options?: OperationObject;
+  parameters?: (ParameterObject | ReferenceObject)[];
+  patch?: OperationObject;
+  post?: OperationObject;
+  put?: OperationObject;
+  servers?: ServerObject[];
+  summary?: string;
+  trace?: OperationObject;
 }
 interface OperationObject {
-    callbacks?: Map<CallbackObject | ReferenceObject>;
-    deprecated?: boolean;
-    description?: string;
-    externalDocs?: ExternalDocumentationObject;
-    operationId?: string;
-    parameters?: (ParameterObject | ReferenceObject)[];
-    requestBody?: ReferenceObject | RequestBodyObject;
-    responses: ResponsesObject;
-    security?: SecurityRequirementObject[];
-    servers?: ServerObject[];
-    summary?: string;
-    tags?: string[];
+  callbacks?: Map<CallbackObject | ReferenceObject>;
+  deprecated?: boolean;
+  description?: string;
+  externalDocs?: ExternalDocumentationObject;
+  operationId?: string;
+  parameters?: (ParameterObject | ReferenceObject)[];
+  requestBody?: ReferenceObject | RequestBodyObject;
+  responses: ResponsesObject;
+  security?: SecurityRequirementObject[];
+  servers?: ServerObject[];
+  summary?: string;
+  tags?: string[];
 }
 interface ExternalDocumentationObject {
-    description?: string;
-    url: string;
+  description?: string;
+  url: string;
 }
 interface ParameterObject {
-    allowEmptyValue?: boolean;
-    allowReserved?: boolean;
-    content?: Map<MediaTypeObject>;
-    deprecated?: boolean;
-    description?: string;
-    example?: any;
-    examples?: Map<ExampleObject | ReferenceObject>;
-    explode?: string;
-    in: string;
-    name: string;
-    required?: boolean;
-    schema?: ReferenceObject | SchemaObject;
-    style?: string;
+  allowEmptyValue?: boolean;
+  allowReserved?: boolean;
+  content?: Map<MediaTypeObject>;
+  deprecated?: boolean;
+  description?: string;
+  example?: any;
+  examples?: Map<ExampleObject | ReferenceObject>;
+  explode?: string;
+  in: string;
+  name: string;
+  required?: boolean;
+  schema?: ReferenceObject | SchemaObject;
+  style?: string;
 }
 interface RequestBodyObject {
-    content: Map<MediaTypeObject>;
-    description?: string;
-    required?: boolean;
+  content: Map<MediaTypeObject>;
+  description?: string;
+  required?: boolean;
 }
 interface MediaTypeObject {
-    encoding?: Map<EncodingObject>;
-    example?: any;
-    examples?: Map<ExampleObject | ReferenceObject>;
-    schema?: ReferenceObject | SchemaObject;
+  encoding?: Map<EncodingObject>;
+  example?: any;
+  examples?: Map<ExampleObject | ReferenceObject>;
+  schema?: ReferenceObject | SchemaObject;
 }
 interface EncodingObject {
-    allowReserved?: boolean;
-    contentType?: string;
-    explode?: boolean;
-    headers?: Map<HeaderObject | ReferenceObject>;
-    style?: string;
+  allowReserved?: boolean;
+  contentType?: string;
+  explode?: boolean;
+  headers?: Map<HeaderObject | ReferenceObject>;
+  style?: string;
 }
 type ResponsesObject = Record<string, ReferenceObject | ResponseObject>;
 interface ResponseObject {
-    content?: Map<MediaTypeObject>;
-    description: string;
-    headers?: Map<HeaderObject | ReferenceObject>;
-    links?: Map<LinkObject | ReferenceObject>;
+  content?: Map<MediaTypeObject>;
+  description: string;
+  headers?: Map<HeaderObject | ReferenceObject>;
+  links?: Map<LinkObject | ReferenceObject>;
 }
 type CallbackObject = Record<string, PathItemObject>;
 interface ExampleObject {
-    description?: string;
-    externalValue?: string;
-    summary?: string;
-    value?: any;
+  description?: string;
+  externalValue?: string;
+  summary?: string;
+  value?: any;
 }
 interface LinkObject {
-    description?: string;
-    operationId?: string;
-    operationRef?: string;
-    parameters?: Map<any>;
-    requestBody?: any;
-    server?: ServerObject;
+  description?: string;
+  operationId?: string;
+  operationRef?: string;
+  parameters?: Map<any>;
+  requestBody?: any;
+  server?: ServerObject;
 }
 interface HeaderObject {
-    allowEmptyValue?: boolean;
-    allowReserved?: boolean;
-    content?: Map<MediaTypeObject>;
-    deprecated?: boolean;
-    description?: string;
-    example?: any;
-    examples?: Map<ExampleObject | ReferenceObject>;
-    explode?: string;
-    required?: boolean;
-    schema?: ReferenceObject | SchemaObject;
-    style?: string;
+  allowEmptyValue?: boolean;
+  allowReserved?: boolean;
+  content?: Map<MediaTypeObject>;
+  deprecated?: boolean;
+  description?: string;
+  example?: any;
+  examples?: Map<ExampleObject | ReferenceObject>;
+  explode?: string;
+  required?: boolean;
+  schema?: ReferenceObject | SchemaObject;
+  style?: string;
 }
 interface TagObject {
-    description?: string;
-    externalDocs?: ExternalDocumentationObject;
-    name: string;
+  description?: string;
+  externalDocs?: ExternalDocumentationObject;
+  name: string;
 }
 interface ReferenceObject {
-    $ref: string;
+  $ref: string;
 }
 type SchemaObject = Record<string, any>;
 interface ApiKeySecuritySchemeObject {
-    description?: string;
-    in: string;
-    name: string;
-    type: string;
+  description?: string;
+  in: string;
+  name: string;
+  type: string;
 }
 interface HttpSecuritySchemeObject {
-    bearerFormat?: string;
-    description?: string;
-    scheme: string;
-    type: string;
+  bearerFormat?: string;
+  description?: string;
+  scheme: string;
+  type: string;
 }
 interface Oauth2SecuritySchemeObject {
-    description?: string;
-    flows: OAuthFlowsObject;
-    type: string;
+  description?: string;
+  flows: OAuthFlowsObject;
+  type: string;
 }
 interface OpenIdConnectSecuritySchemeObject {
-    description?: string;
-    openIdConnectUrl: string;
-    type: string;
+  description?: string;
+  openIdConnectUrl: string;
+  type: string;
 }
 interface OAuthFlowsObject {
-    authorizationCode?: OAuthFlowObject;
-    clientCredentials?: OAuthFlowObject;
-    implicit?: OAuthFlowObject;
-    password?: OAuthFlowObject;
+  authorizationCode?: OAuthFlowObject;
+  clientCredentials?: OAuthFlowObject;
+  implicit?: OAuthFlowObject;
+  password?: OAuthFlowObject;
 }
 interface OAuthFlowObject {
-    authorizationUrl?: string;
-    refreshUrl: string;
-    scopes: Map<string>;
-    tokenUrl?: string;
+  authorizationUrl?: string;
+  refreshUrl: string;
+  scopes: Map<string>;
+  tokenUrl?: string;
 }
 type SecurityRequirementObject = Record<string, string[]>;
 type Map<T> = Record<string, T>;
-
 declare const commentsToOpenApi$1: (fileContents: string, verbose?: boolean) => {
-    loc: number;
-    spec: OpenApiObject;
+  loc: number;
+  spec: OpenApiObject;
 }[];
-
 declare const parseFile: (file: string, commentsToOpenApi: (fileContent: string, verbose?: boolean) => {
-    loc: number;
-    spec: OpenApiObject;
+  loc: number;
+  spec: OpenApiObject;
 }[], verbose?: boolean) => {
-    loc: number;
-    spec: OpenApiObject;
+  loc: number;
+  spec: OpenApiObject;
 }[];
-
 declare class SpecBuilder implements OpenApiObject {
-    components?: ComponentsObject;
-    externalDocs?: ExternalDocumentationObject;
-    info: InfoObject;
-    openapi: string;
-    paths: PathsObject;
-    security?: SecurityRequirementObject[];
-    servers?: ServerObject[];
-    tags?: TagObject[];
-    constructor(baseDefinition: BaseDefinition);
-    addData(parsedFile: OpenApiObject[]): void;
-}
-
+  components?: ComponentsObject;
+  externalDocs?: ExternalDocumentationObject;
+  info: InfoObject;
+  openapi: string;
+  paths: PathsObject;
+  security?: SecurityRequirementObject[];
+  servers?: ServerObject[];
+  tags?: TagObject[];
+  constructor(baseDefinition: BaseDefinition);
+  addData(parsedFile: OpenApiObject[]): void;
+}
 declare const commentsToOpenApi: (fileContents: string, verbose?: boolean) => {
-    loc: number;
-    spec: OpenApiObject;
+  loc: number;
+  spec: OpenApiObject;
 }[];
-
 declare const yamlLoc: (string: string) => number;
-
+type WebpackCompiler = undefined;
 declare class SwaggerCompilerPlugin {
-    private readonly assetsPath;
-    private readonly ignore;
-    private readonly sources;
-    private readonly swaggerDefinition;
-    private readonly verbose;
-    constructor(assetsPath: string, sources: string[], swaggerDefinition: BaseDefinition, options: {
-        ignore?: (RegExp | string)[];
-        verbose?: boolean;
-    });
-    apply(compiler: Compiler): void;
-}
-
+  private readonly assetsPath;
+  private readonly ignore;
+  private readonly sources;
+  private readonly swaggerDefinition;
+  private readonly verbose;
+  constructor(assetsPath: string, sources: string[], swaggerDefinition: BaseDefinition, options: {
+    ignore?: (RegExp | string)[];
+    verbose?: boolean;
+  });
+  apply(compiler: WebpackCompiler): void;
+}
 export { type BaseDefinition, type OpenApiObject, SpecBuilder, SwaggerCompilerPlugin, commentsToOpenApi$1 as jsDocumentCommentsToOpenApi, parseFile, commentsToOpenApi as swaggerJsDocumentCommentsToOpenApi, yamlLoc };

package/dist/index.mjs

@@ -1,85 +1 @@
-import { DEFAULT_EXCLUDE, spec_builder_default, collect, parse_file_default, comments_to_open_api_default, comments_to_open_api_default2, validate_default } from './chunk-46IWFMQ2.mjs';
-export { spec_builder_default as SpecBuilder, comments_to_open_api_default as jsDocumentCommentsToOpenApi, parse_file_default as parseFile, comments_to_open_api_default2 as swaggerJsDocumentCommentsToOpenApi, yaml_loc_default as yamlLoc } from './chunk-46IWFMQ2.mjs';
-import { mkdir, writeFile } from 'fs';
-import { dirname } from 'path';
-import { exit } from 'process';
-
-var errorHandler = (error) => {
-  if (error) {
-    console.error(error);
-    exit(1);
-  }
-};
-var SwaggerCompilerPlugin = class {
-  assetsPath;
-  ignore;
-  sources;
-  swaggerDefinition;
-  verbose;
-  constructor(assetsPath, sources, swaggerDefinition, options) {
-    this.assetsPath = assetsPath;
-    this.swaggerDefinition = swaggerDefinition;
-    this.sources = sources;
-    this.verbose = options.verbose ?? false;
-    this.ignore = options.ignore ?? [];
-  }
-  apply(compiler) {
-    const skip = /* @__PURE__ */ new Set([...DEFAULT_EXCLUDE, ...this.ignore]);
-    compiler.hooks.make.tapAsync("SwaggerCompilerPlugin", async (_, callback) => {
-      console.log("Build paused, switching to swagger build");
-      const spec = new spec_builder_default(this.swaggerDefinition);
-      for await (const dir of this.sources) {
-        const files = await collect(dir, {
-          extensions: [".js", ".cjs", ".mjs", ".ts", ".tsx", ".jsx", ".yaml", ".yml"],
-          includeDirs: false,
-          skip: [...skip]
-        });
-        if (this.verbose) {
-          console.log(`Found ${String(files.length)} files in ${dir}`);
-          console.log(files);
-        }
-        files.forEach((file) => {
-          if (this.verbose) {
-            console.log(`Parsing file ${file}`);
-          }
-          try {
-            const parsedJsDocumentFile = parse_file_default(file, comments_to_open_api_default, this.verbose);
-            spec.addData(parsedJsDocumentFile.map((item) => item.spec));
-            const parsedSwaggerJsDocumentFile = parse_file_default(file, comments_to_open_api_default2, this.verbose);
-            spec.addData(parsedSwaggerJsDocumentFile.map((item) => item.spec));
-          } catch (error) {
-            console.error(error);
-            exit(1);
-          }
-        });
-      }
-      try {
-        if (this.verbose) {
-          console.log("Validating swagger spec");
-          console.log(JSON.stringify(spec, null, 2));
-        }
-        await validate_default(JSON.parse(JSON.stringify(spec)));
-      } catch (error) {
-        console.error(error.toJSON());
-        exit(1);
-      }
-      const { assetsPath } = this;
-      mkdir(dirname(assetsPath), { recursive: true }, (error) => {
-        if (error) {
-          errorHandler(error);
-        }
-        writeFile(assetsPath, JSON.stringify(spec, null, 2), errorHandler);
-      });
-      if (this.verbose) {
-        console.log(`Written swagger spec to "${this.assetsPath}" file`);
-      }
-      console.log("switching back to normal build");
-      callback();
-    });
-  }
-};
-var swagger_compiler_plugin_default = SwaggerCompilerPlugin;
-
-export { swagger_compiler_plugin_default as SwaggerCompilerPlugin };
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map
+import{default as r}from"./packem_shared/jsDocumentCommentsToOpenApi-Bvfi25DQ.mjs";import{default as t}from"./packem_shared/parseFile-CtAVjmPd.mjs";import{default as p}from"./packem_shared/SpecBuilder-DjnDJFpv.mjs";import{default as s}from"./packem_shared/swaggerJsDocumentCommentsToOpenApi-xKOqHvN2.mjs";import{default as u}from"./packem_shared/yamlLoc-C2tVIYaz.mjs";import{default as n}from"./packem_shared/SwaggerCompilerPlugin-CLoD91_H.mjs";export{p as SpecBuilder,n as SwaggerCompilerPlugin,r as jsDocumentCommentsToOpenApi,t as parseFile,s as swaggerJsDocumentCommentsToOpenApi,u as yamlLoc};

package/dist/packem_shared/SpecBuilder-CR4EZk93.cjs

@@ -0,0 +1 @@
+"use strict";var p=Object.defineProperty;var a=(s,e)=>p(s,"name",{value:e,configurable:!0});var h=Object.defineProperty,u=a((s,e)=>h(s,"name",{value:e,configurable:!0}),"s");const v=u((s,e)=>{Object.keys(e).forEach(r=>{s[r]===void 0?s[r]={...e[r]}:Object.keys(e[r]).forEach(t=>{s[r][t]={...s[r][t],...e[r][t]}})})},"objectMerge");var l=Object.defineProperty,f=a((s,e)=>l(s,"name",{value:e,configurable:!0}),"c");class b{static{a(this,"u")}static{f(this,"SpecBuilder")}components;externalDocs;info;openapi;paths;security;servers;tags;constructor(e){this.openapi=e.openapi,this.info=e.info,this.paths=e.paths??{},e.servers&&(this.servers=e.servers),e.components&&(this.components=e.components),e.security&&(this.security=e.security),e.tags&&(this.tags=e.tags),e.externalDocs&&(this.externalDocs=e.externalDocs)}addData(e){e.forEach(r=>{const{components:t,paths:c,...n}=r;v(this,{components:t??{},paths:c??{}}),Object.entries(n).forEach(([o,i])=>{this[o]=i})})}}module.exports=b;

package/dist/packem_shared/SpecBuilder-DjnDJFpv.mjs

@@ -0,0 +1 @@
+var p=Object.defineProperty;var t=(s,e)=>p(s,"name",{value:e,configurable:!0});var h=Object.defineProperty,u=t((s,e)=>h(s,"name",{value:e,configurable:!0}),"s");const l=u((s,e)=>{Object.keys(e).forEach(a=>{s[a]===void 0?s[a]={...e[a]}:Object.keys(e[a]).forEach(r=>{s[a][r]={...s[a][r],...e[a][r]}})})},"objectMerge");var v=Object.defineProperty,f=t((s,e)=>v(s,"name",{value:e,configurable:!0}),"c");class m{static{t(this,"u")}static{f(this,"SpecBuilder")}components;externalDocs;info;openapi;paths;security;servers;tags;constructor(e){this.openapi=e.openapi,this.info=e.info,this.paths=e.paths??{},e.servers&&(this.servers=e.servers),e.components&&(this.components=e.components),e.security&&(this.security=e.security),e.tags&&(this.tags=e.tags),e.externalDocs&&(this.externalDocs=e.externalDocs)}addData(e){e.forEach(a=>{const{components:r,paths:c,...n}=a;l(this,{components:r??{},paths:c??{}}),Object.entries(n).forEach(([o,i])=>{this[o]=i})})}}export{m as default};

package/dist/packem_shared/SwaggerCompilerPlugin-CLoD91_H.mjs

@@ -0,0 +1 @@
+var v=Object.defineProperty;var g=(s,o)=>v(s,"name",{value:o,configurable:!0});import{mkdir as w,writeFile as y}from"node:fs";import{dirname as D}from"node:path";import{exit as m}from"node:process";import{collect as P}from"@visulima/fs";import{r as S,D as $}from"./validate-_k84qawx.mjs";import j from"./jsDocumentCommentsToOpenApi-Bvfi25DQ.mjs";import p from"./parseFile-CtAVjmPd.mjs";import k from"./SpecBuilder-DjnDJFpv.mjs";import x from"./swaggerJsDocumentCommentsToOpenApi-xKOqHvN2.mjs";var E=Object.defineProperty,d=g((s,o)=>E(s,"name",{value:o,configurable:!0}),"g");const u=d(s=>{s&&(console.error(s),m(1))},"errorHandler");class T{static{g(this,"E")}static{d(this,"SwaggerCompilerPlugin")}assetsPath;ignore;sources;swaggerDefinition;verbose;constructor(o,i,h,r){this.assetsPath=o,this.swaggerDefinition=h,this.sources=i,this.verbose=r.verbose??!1,this.ignore=r.ignore??[]}apply(o){const i=new Set([...$,...this.ignore]);o.hooks.make.tapAsync("SwaggerCompilerPlugin",async(h,r)=>{console.log("Build paused, switching to swagger build");const t=new k(this.swaggerDefinition);for(const e of this.sources){const n=await P(e,{extensions:[".js",".cjs",".mjs",".ts",".tsx",".jsx",".yaml",".yml"],includeDirs:!1,skip:[...i]});this.verbose&&(console.log(`Found ${String(n.length)} files in ${e}`),console.log(n)),n.forEach(a=>{this.verbose&&console.log(`Parsing file ${a}`);try{const l=p(a,j,this.verbose);t.addData(l.map(c=>c.spec));const b=p(a,x,this.verbose);t.addData(b.map(c=>c.spec))}catch(l){console.error(l),m(1)}})}try{this.verbose&&(console.log("Validating swagger spec"),console.log(JSON.stringify(t,void 0,2))),await S(structuredClone(t))}catch(e){console.error(e.toJSON()),m(1)}const{assetsPath:f}=this;w(D(f),{recursive:!0},e=>{e&&u(e),y(f,JSON.stringify(t,void 0,2),u)}),this.verbose&&console.log(`Written swagger spec to "${this.assetsPath}" file`),console.log("switching back to normal build"),r()})}}export{T as default};

package/dist/packem_shared/SwaggerCompilerPlugin-lwIg0m84.cjs

@@ -0,0 +1 @@
+"use strict";var y=Object.defineProperty;var g=(e,s)=>y(e,"name",{value:s,configurable:!0});const p=require("node:fs"),q=require("node:path"),u=require("node:process"),D=require("@visulima/fs"),m=require("./validate-tZa-jyuN.cjs"),P=require("./jsDocumentCommentsToOpenApi-DBYlHL5i.cjs"),f=require("./parseFile-C7tyTcIn.cjs"),S=require("./SpecBuilder-CR4EZk93.cjs"),x=require("./swaggerJsDocumentCommentsToOpenApi-Bo1geBuG.cjs");var j=Object.defineProperty,w=g((e,s)=>j(e,"name",{value:s,configurable:!0}),"g");const v=w(e=>{e&&(console.error(e),u.exit(1))},"errorHandler");class O{static{g(this,"E")}static{w(this,"SwaggerCompilerPlugin")}assetsPath;ignore;sources;swaggerDefinition;verbose;constructor(s,t,h,i){this.assetsPath=s,this.swaggerDefinition=h,this.sources=t,this.verbose=i.verbose??!1,this.ignore=i.ignore??[]}apply(s){const t=new Set([...m.D,...this.ignore]);s.hooks.make.tapAsync("SwaggerCompilerPlugin",async(h,i)=>{console.log("Build paused, switching to swagger build");const r=new S(this.swaggerDefinition);for(const o of this.sources){const n=await D.collect(o,{extensions:[".js",".cjs",".mjs",".ts",".tsx",".jsx",".yaml",".yml"],includeDirs:!1,skip:[...t]});this.verbose&&(console.log(`Found ${String(n.length)} files in ${o}`),console.log(n)),n.forEach(a=>{this.verbose&&console.log(`Parsing file ${a}`);try{const c=f(a,P,this.verbose);r.addData(c.map(l=>l.spec));const b=f(a,x,this.verbose);r.addData(b.map(l=>l.spec))}catch(c){console.error(c),u.exit(1)}})}try{this.verbose&&(console.log("Validating swagger spec"),console.log(JSON.stringify(r,void 0,2))),await m.r(structuredClone(r))}catch(o){console.error(o.toJSON()),u.exit(1)}const{assetsPath:d}=this;p.mkdir(q.dirname(d),{recursive:!0},o=>{o&&v(o),p.writeFile(d,JSON.stringify(r,void 0,2),v)}),this.verbose&&console.log(`Written swagger spec to "${this.assetsPath}" file`),console.log("switching back to normal build"),i()})}}module.exports=O;

package/dist/packem_shared/customizer-COfd-Xr1.mjs

@@ -0,0 +1 @@
+var t=Object.defineProperty;var a=(r,e)=>t(r,"name",{value:e,configurable:!0});var o=Object.defineProperty,u=a((r,e)=>o(r,"name",{value:e,configurable:!0}),"u");const c=u((r,e)=>{if(Array.isArray(r))return[...r,...e]},"customizer");export{c as o};

package/dist/packem_shared/customizer-DUz3nxAJ.cjs

@@ -0,0 +1 @@
+"use strict";var a=Object.defineProperty;var t=(r,e)=>a(r,"name",{value:e,configurable:!0});var u=Object.defineProperty,i=t((r,e)=>u(r,"name",{value:e,configurable:!0}),"u");const o=i((r,e)=>{if(Array.isArray(r))return[...r,...e]},"customizer");exports.o=o;

package/dist/packem_shared/generateCommand-BQuj1FCe.cjs

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var t=(e,o)=>s(e,"name",{value:o,configurable:!0});const p=require("node:process"),c=require("./generateCommand-DPOEw62Z.cjs");var u=Object.defineProperty,g=t((e,o)=>u(e,"name",{value:o,configurable:!0}),"t");const m=g((e,o="generate",r=".openapirc.js")=>{e.command(o).description("Generates OpenAPI (Swagger) documentation from JSDoc's").usage("[options] <path ...>").argument("[path ...]","Paths to files or directories to parse").option("-c, --config [.openapirc.js]","@visulima/jsdoc-open-api config file path.").option("-o, --output [swaggerSpec.json]","Output swagger specification.").option("-v, --verbose","Verbose output.").option("-d, --very-verbose","Very verbose output.").action(async(a,n)=>{try{await c(r,a,n)}catch(i){console.error(i),p.exit(1)}})},"generateCommand");module.exports=m;

package/dist/packem_shared/generateCommand-Bn19mSDL.mjs

@@ -0,0 +1 @@
+var p=Object.defineProperty;var t=(e,o)=>p(e,"name",{value:o,configurable:!0});import{exit as s}from"node:process";import c from"./generateCommand-DLJ2Ac1D.mjs";var u=Object.defineProperty,g=t((e,o)=>u(e,"name",{value:o,configurable:!0}),"t");const v=g((e,o="generate",r=".openapirc.js")=>{e.command(o).description("Generates OpenAPI (Swagger) documentation from JSDoc's").usage("[options] <path ...>").argument("[path ...]","Paths to files or directories to parse").option("-c, --config [.openapirc.js]","@visulima/jsdoc-open-api config file path.").option("-o, --output [swaggerSpec.json]","Output swagger specification.").option("-v, --verbose","Verbose output.").option("-d, --very-verbose","Very verbose output.").action(async(a,i)=>{try{await c(r,a,i)}catch(n){console.error(n),s(1)}})},"generateCommand");export{v as default};

package/dist/packem_shared/generateCommand-DLJ2Ac1D.mjs

@@ -0,0 +1,4 @@
+var y=Object.defineProperty;var g=(t,i)=>y(t,"name",{value:i,configurable:!0});import{lstat as b,realpath as h,mkdir as $,writeFile as j}from"node:fs/promises";import{normalize as D,dirname as S}from"node:path";import{pathToFileURL as x}from"node:url";import{collect as k}from"@visulima/fs";import{MultiBar as C,Presets as E}from"cli-progress";import{r as F,D as O}from"./validate-_k84qawx.mjs";import P from"./jsDocumentCommentsToOpenApi-Bvfi25DQ.mjs";import p from"./parseFile-CtAVjmPd.mjs";import V from"./SpecBuilder-DjnDJFpv.mjs";import L from"./swaggerJsDocumentCommentsToOpenApi-xKOqHvN2.mjs";var N=Object.defineProperty,U=g((t,i)=>N(t,"name",{value:i,configurable:!0}),"g");const G=U(async(t,i,e)=>{let r;try{let o=await import(x(D(e.config??t)).href);o?.default&&(o=o.default),r=o}catch{throw new Error(`No config file found, on: ${e.config??".openapirc.js"}
+`)}const f=new C({clearOnComplete:!1,format:"{value}/{total} | {bar} | {filename}",hideCursor:!0},E.shades_grey),a=new V(r.swaggerDefinition),d=new Set([...O,...r.exclude]);for(const o of i){(await b(o)).isDirectory();const l=await h(o),n=await k(l,{extensions:r.extensions??[".js",".cjs",".mjs",".ts",".tsx",".jsx",".yaml",".yml"],followSymlinks:r.followSymlinks??!1,match:r.include,skip:[...d]});(e.verbose??e.veryVerbose)&&console.log(`
+Found ${String(n.length)} files in ${l}`),e.veryVerbose&&console.log(n);const u=f.create(n.length,0);n.forEach(c=>{e.verbose&&console.log(`Parsing file ${c}`),u.increment(1,{filename:l});const w=p(c,P,e.verbose);a.addData(w.map(m=>m.spec));const v=p(c,L,e.verbose);a.addData(v.map(m=>m.spec))})}e.verbose&&console.log("Validating swagger spec"),e.veryVerbose&&console.log(JSON.stringify(a,void 0,2)),await F(structuredClone(a));const s=e.output??"swagger.json";f.stop(),e.verbose&&console.log(`Written swagger spec to "${s}" file`),await $(S(s),{recursive:!0}),await j(s,JSON.stringify(a,void 0,2)),console.log(`
+Swagger specification is ready, check the "${s}" file.`)},"generateCommand");export{G as default};

package/dist/packem_shared/generateCommand-DPOEw62Z.cjs

@@ -0,0 +1,4 @@
+"use strict";var j=Object.defineProperty;var m=(s,t)=>j(s,"name",{value:t,configurable:!0});const l=require("node:fs/promises"),d=require("node:path"),S=require("node:url"),D=require("@visulima/fs"),p=require("cli-progress"),w=require("./validate-tZa-jyuN.cjs"),x=require("./jsDocumentCommentsToOpenApi-DBYlHL5i.cjs"),v=require("./parseFile-C7tyTcIn.cjs"),C=require("./SpecBuilder-CR4EZk93.cjs"),O=require("./swaggerJsDocumentCommentsToOpenApi-Bo1geBuG.cjs");var $=Object.defineProperty,k=m((s,t)=>$(s,"name",{value:t,configurable:!0}),"g");const F=k(async(s,t,e)=>{let o;try{let r=await import(S.pathToFileURL(d.normalize(e.config??s)).href);r?.default&&(r=r.default),o=r}catch{throw new Error(`No config file found, on: ${e.config??".openapirc.js"}
+`)}const f=new p.MultiBar({clearOnComplete:!1,format:"{value}/{total} | {bar} | {filename}",hideCursor:!0},p.Presets.shades_grey),i=new C(o.swaggerDefinition),y=new Set([...w.D,...o.exclude]);for(const r of t){(await l.lstat(r)).isDirectory();const c=await l.realpath(r),n=await D.collect(c,{extensions:o.extensions??[".js",".cjs",".mjs",".ts",".tsx",".jsx",".yaml",".yml"],followSymlinks:o.followSymlinks??!1,match:o.include,skip:[...y]});(e.verbose??e.veryVerbose)&&console.log(`
+Found ${String(n.length)} files in ${c}`),e.veryVerbose&&console.log(n);const b=f.create(n.length,0);n.forEach(u=>{e.verbose&&console.log(`Parsing file ${u}`),b.increment(1,{filename:c});const h=v(u,x,e.verbose);i.addData(h.map(g=>g.spec));const q=v(u,O,e.verbose);i.addData(q.map(g=>g.spec))})}e.verbose&&console.log("Validating swagger spec"),e.veryVerbose&&console.log(JSON.stringify(i,void 0,2)),await w.r(structuredClone(i));const a=e.output??"swagger.json";f.stop(),e.verbose&&console.log(`Written swagger spec to "${a}" file`),await l.mkdir(d.dirname(a),{recursive:!0}),await l.writeFile(a,JSON.stringify(i,void 0,2)),console.log(`
+Swagger specification is ready, check the "${a}" file.`)},"generateCommand");module.exports=F;

package/dist/packem_shared/initCommand-Bm4veOwd.mjs

@@ -0,0 +1 @@
+var a=Object.defineProperty;var o=(e,i)=>a(e,"name",{value:i,configurable:!0});import{exit as c}from"node:process";import m from"./initCommand-CwoPwelm.mjs";var p=Object.defineProperty,d=o((e,i)=>p(e,"name",{value:i,configurable:!0}),"m");const u=d((e,i="init",r="Inits a pre-configured @visulima/jsdoc-open-api config file.",t=".openapirc.js")=>{e.command(i).description(r).action(()=>{try{m(t)}catch(n){console.error(n),c(1)}})},"initCommand");export{u as default};

package/dist/packem_shared/initCommand-CiV7G3q4.cjs

@@ -0,0 +1,35 @@
+"use strict";var r=Object.defineProperty;var t=(e,s)=>r(e,"name",{value:s,configurable:!0});const n=require("node:fs"),c=require("@visulima/fs");var i=Object.defineProperty,m=t((e,s)=>i(e,"name",{value:s,configurable:!0}),"a");const p=m((e,s=process.cwd())=>{if(n.existsSync(e))throw new Error("Config file already exists");const o=c.findUpSync("package.json",{cwd:n.realpathSync(s)});let a="module.exports =";if(o){const l=c.readJsonSync(o);console.info(`Found package.json at "${o}"`),l.type==="module"&&(console.info("Found package.json with type: module, using ES6 as export for the config file"),a="export default")}else console.info("No package.json found");n.writeFileSync(e,`${a} {
+  exclude: [
+    'coverage/**',
+    '.github/**',
+    'packages/*/test{,s}/**',
+    '**/*.d.ts',
+    'test{,s}/**',
+    'test{,-*}.{js,cjs,mjs,ts,tsx,jsx,yaml,yml}',
+    '**/*{.,-}test.{js,cjs,mjs,ts,tsx,jsx,yaml,yml}',
+    '**/__tests__/**',
+    '**/{ava,babel,nyc}.config.{js,cjs,mjs}',
+    '**/jest.config.{js,cjs,mjs,ts}',
+    '**/{karma,rollup,webpack}.config.js',
+    '**/.{eslint,mocha}rc.{js,cjs}',
+    '**/.{travis,yarnrc}.yml',
+    '**/{docker-compose,docker}.yml',
+    '**/.yamllint.{yaml,yml}',
+    '**/node_modules/**',
+    '**/pnpm-lock.yaml',
+    '**/pnpm-workspace.yaml',
+    '**/{package,package-lock}.json',
+    '**/yarn.lock',
+    '**/package.json5',
+    '**/.next/**',
+  ],
+  followSymlinks: false,
+  swaggerDefinition: {
+    openapi: '3.0.0',
+    info: {
+      title: 'API',
+      version: '1.0.0',
+    },
+  },
+};
+`),console.log(`Created "${e}"`)},"initCommand");module.exports=p;

package/dist/packem_shared/initCommand-CwoPwelm.mjs

@@ -0,0 +1,35 @@
+var c=Object.defineProperty;var n=(e,o)=>c(e,"name",{value:o,configurable:!0});import{existsSync as l,realpathSync as r,writeFileSync as i}from"node:fs";import{findUpSync as m,readJsonSync as p}from"@visulima/fs";var j=Object.defineProperty,f=n((e,o)=>j(e,"name",{value:o,configurable:!0}),"a");const k=f((e,o=process.cwd())=>{if(l(e))throw new Error("Config file already exists");const s=m("package.json",{cwd:r(o)});let a="module.exports =";if(s){const t=p(s);console.info(`Found package.json at "${s}"`),t.type==="module"&&(console.info("Found package.json with type: module, using ES6 as export for the config file"),a="export default")}else console.info("No package.json found");i(e,`${a} {
+  exclude: [
+    'coverage/**',
+    '.github/**',
+    'packages/*/test{,s}/**',
+    '**/*.d.ts',
+    'test{,s}/**',
+    'test{,-*}.{js,cjs,mjs,ts,tsx,jsx,yaml,yml}',
+    '**/*{.,-}test.{js,cjs,mjs,ts,tsx,jsx,yaml,yml}',
+    '**/__tests__/**',
+    '**/{ava,babel,nyc}.config.{js,cjs,mjs}',
+    '**/jest.config.{js,cjs,mjs,ts}',
+    '**/{karma,rollup,webpack}.config.js',
+    '**/.{eslint,mocha}rc.{js,cjs}',
+    '**/.{travis,yarnrc}.yml',
+    '**/{docker-compose,docker}.yml',
+    '**/.yamllint.{yaml,yml}',
+    '**/node_modules/**',
+    '**/pnpm-lock.yaml',
+    '**/pnpm-workspace.yaml',
+    '**/{package,package-lock}.json',
+    '**/yarn.lock',
+    '**/package.json5',
+    '**/.next/**',
+  ],
+  followSymlinks: false,
+  swaggerDefinition: {
+    openapi: '3.0.0',
+    info: {
+      title: 'API',
+      version: '1.0.0',
+    },
+  },
+};
+`),console.log(`Created "${e}"`)},"initCommand");export{k as default};