@visulima/jsdoc-open-api 3.0.0-alpha.3 → 3.0.0-alpha.30

package/dist/index.d.ts

@@ -1,248 +1,266 @@
-import { Compiler } from 'webpack';
-
+import { Block } from 'comment-parser';
+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;
+declare const commentsToOpenApi$1: (fileContents: string, verbose?: boolean, comments?: Block[]) => {
+  loc: number;
+  spec: OpenApiObject;
 }[];
-
-declare const parseFile: (file: string, commentsToOpenApi: (fileContent: string, verbose?: boolean) => {
-    loc: number;
-    spec: OpenApiObject;
-}[], verbose?: boolean) => {
-    loc: number;
-    spec: OpenApiObject;
+declare const DEFAULT_OPTIONS: {
+  cwd: undefined;
+  exclude: string[];
+  excludeNodeModules: boolean;
+  extension: string[];
+  include: string[];
+  verbose: boolean;
+};
+type CommentsToOpenApi = (fileContent: string, verbose?: boolean, comments?: Block[]) => {
+  loc: number;
+  spec: OpenApiObject;
+}[];
+declare const parseFile$1: (file: string, commentsToOpenApi: CommentsToOpenApi, verbose?: boolean) => {
+  loc: number;
+  spec: OpenApiObject;
+}[];
+declare const parseFileMulti: (file: string, translators: CommentsToOpenApi[], verbose?: boolean) => {
+  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;
-}
-
-declare const commentsToOpenApi: (fileContents: string, verbose?: boolean) => {
-    loc: number;
-    spec: OpenApiObject;
+  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, comments?: Block[]) => {
+  loc: number;
+  spec: OpenApiObject;
 }[];
-
+declare const parseFile: (file: string) => BaseDefinition;
 declare const yamlLoc: (string: string) => number;
-
+declare const validate: (spec: Record<string, unknown>) => Promise<void>;
+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;
-}
-
-export { type BaseDefinition, type OpenApiObject, SpecBuilder, SwaggerCompilerPlugin, commentsToOpenApi$1 as jsDocumentCommentsToOpenApi, parseFile, commentsToOpenApi as swaggerJsDocumentCommentsToOpenApi, yamlLoc };
+  private readonly assetsPath;
+  private readonly ignore;
+  private readonly silent;
+  private readonly sources;
+  private readonly swaggerDefinition;
+  private readonly verbose;
+  constructor(assetsPath: string, sources: string[], swaggerDefinition: BaseDefinition, options: {
+    ignore?: (RegExp | string)[];
+    silent?: boolean;
+    verbose?: boolean;
+  });
+  apply(compiler: WebpackCompiler): void;
+  private log;
+}
+export { type BaseDefinition, type CommentsToOpenApi, DEFAULT_OPTIONS, type OpenApiObject, SpecBuilder, SwaggerCompilerPlugin, commentsToOpenApi$1 as jsDocumentCommentsToOpenApi, parseFile as loadDefinition, parseFile$1 as parseFile, parseFileMulti, commentsToOpenApi as swaggerJsDocumentCommentsToOpenApi, validate, 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 a}from"./packem_shared/jsDocumentCommentsToOpenApi-BEQrWgpQ.mjs";import{default as r}from"./packem_shared/DEFAULT_OPTIONS-C7o6qjwP.mjs";import{default as l,parseFileMulti as m}from"./packem_shared/parseFile-Wxs3O0wy.mjs";import{default as s}from"./packem_shared/SpecBuilder-Vbq42UbW.mjs";import{default as d}from"./packem_shared/swaggerJsDocumentCommentsToOpenApi-BnPWbZoe.mjs";import{default as n}from"./packem_shared/loadDefinition-7r9qpfuE.mjs";import{default as g}from"./packem_shared/yamlLoc-DPq-xUM4.mjs";import{default as D}from"./packem_shared/validate-9Rwe2A3r.mjs";import{default as T}from"./packem_shared/SwaggerCompilerPlugin-wRdVpHJS.mjs";export{r as DEFAULT_OPTIONS,s as SpecBuilder,T as SwaggerCompilerPlugin,a as jsDocumentCommentsToOpenApi,n as loadDefinition,l as parseFile,m as parseFileMulti,d as swaggerJsDocumentCommentsToOpenApi,D as validate,g as yamlLoc};

package/dist/packem_shared/DEFAULT_OPTIONS-C7o6qjwP.mjs

@@ -0,0 +1 @@
+const s={cwd:void 0,exclude:["coverage/**","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}.yml"],excludeNodeModules:!0,extension:[".js",".cjs",".mjs",".ts",".tsx",".jsx",".yaml",".yml"],include:["**"],verbose:!0};export{s as default};

package/dist/packem_shared/DEFAULT_OPTIONS-CP1lNs-k.cjs

@@ -0,0 +1 @@
+"use strict";const s={cwd:void 0,exclude:["coverage/**","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}.yml"],excludeNodeModules:!0,extension:[".js",".cjs",".mjs",".ts",".tsx",".jsx",".yaml",".yml"],include:["**"],verbose:!0};module.exports=s;

package/dist/packem_shared/SpecBuilder-C_KcIxW-.cjs

@@ -0,0 +1 @@
+"use strict";const c=new Set(["__proto__","constructor","prototype"]),i=(o,s)=>{Object.keys(s).forEach(t=>{c.has(t)||(o[t]===void 0?o[t]={...s[t]}:Object.keys(s[t]).forEach(e=>{c.has(e)||(o[t][e]={...o[t][e],...s[t][e]})}))})},h=new Set(["__proto__","constructor","prototype"]);class u{components;externalDocs;info;openapi;paths;security;servers;tags;constructor(s){this.openapi=s.openapi,this.info=s.info,this.paths=s.paths??{},s.servers&&(this.servers=s.servers),s.components&&(this.components=s.components),s.security&&(this.security=s.security),s.tags&&(this.tags=s.tags),s.externalDocs&&(this.externalDocs=s.externalDocs)}addData(s){s.forEach(t=>{const{components:e,paths:n,...a}=t;i(this,{components:e??{},paths:n??{}}),Object.entries(a).forEach(([r,p])=>{h.has(r)||(this[r]=p)})})}}module.exports=u;

package/dist/packem_shared/SpecBuilder-Vbq42UbW.mjs

@@ -0,0 +1 @@
+const c=new Set(["__proto__","constructor","prototype"]),h=(o,s)=>{Object.keys(s).forEach(t=>{c.has(t)||(o[t]===void 0?o[t]={...s[t]}:Object.keys(s[t]).forEach(e=>{c.has(e)||(o[t][e]={...o[t][e],...s[t][e]})}))})},i=new Set(["__proto__","constructor","prototype"]);class u{components;externalDocs;info;openapi;paths;security;servers;tags;constructor(s){this.openapi=s.openapi,this.info=s.info,this.paths=s.paths??{},s.servers&&(this.servers=s.servers),s.components&&(this.components=s.components),s.security&&(this.security=s.security),s.tags&&(this.tags=s.tags),s.externalDocs&&(this.externalDocs=s.externalDocs)}addData(s){s.forEach(t=>{const{components:e,paths:n,...a}=t;h(this,{components:e??{},paths:n??{}}),Object.entries(a).forEach(([r,p])=>{i.has(r)||(this[r]=p)})})}}export{u as default};

package/dist/packem_shared/SwaggerCompilerPlugin-Bd9L4Djt.cjs

@@ -0,0 +1 @@
+"use strict";const c=require("node:fs/promises"),u=require("node:path"),p=require("@visulima/fs"),w=require("./constants-DnbfJ7Id.cjs"),f=require("./jsDocumentCommentsToOpenApi-CMbdb0uR.cjs"),m=require("./parseFile-CPb-Kglh.cjs"),d=require("./SpecBuilder-C_KcIxW-.cjs"),v=require("./swaggerJsDocumentCommentsToOpenApi-rMEaS4lg.cjs"),b=require("./validate-DLmCjOPl.cjs"),y=[f,v],q=t=>t instanceof Error?t:new Error(String(t));class D{assetsPath;ignore;silent;sources;swaggerDefinition;verbose;constructor(e,a,r,s){this.assetsPath=e,this.swaggerDefinition=r,this.sources=a,this.verbose=s.verbose??!1,this.silent=s.silent??!1,this.ignore=s.ignore??[]}apply(e){const a=new Set([...w.D,...this.ignore]);e.hooks.make.tapAsync("SwaggerCompilerPlugin",async(r,s)=>{this.log("Build paused, switching to swagger build");const o=new d(this.swaggerDefinition);try{for(const i of this.sources){const l=await p.collect(i,{extensions:[".js",".cjs",".mjs",".ts",".tsx",".jsx",".yaml",".yml"],includeDirs:!1,skip:[...a]});this.verbose&&(this.log(`Found ${String(l.length)} files in ${i}`),this.log(JSON.stringify(l))),l.forEach(g=>{this.verbose&&this.log(`Parsing file ${g}`),o.addData(m.parseFileMulti(g,y,this.verbose).map(h=>h.spec))})}this.verbose&&(this.log("Validating swagger spec"),this.log(JSON.stringify(o,void 0,2))),await b(structuredClone(o));const{assetsPath:n}=this;await c.mkdir(u.dirname(n),{recursive:!0}),await c.writeFile(n,JSON.stringify(o,void 0,2)),this.verbose&&this.log(`Written swagger spec to "${this.assetsPath}" file`)}catch(n){const i=q(n);Array.isArray(r.errors)&&r.errors.push(i),s(i);return}this.log("switching back to normal build"),s()})}log(e){this.silent||console.log(e)}}module.exports=D;

package/dist/packem_shared/SwaggerCompilerPlugin-wRdVpHJS.mjs

@@ -0,0 +1 @@
+import{mkdir as c,writeFile as m}from"node:fs/promises";import{dirname as f}from"node:path";import{collect as p}from"@visulima/fs";import{D as u}from"./constants-CdEv9ZcD.mjs";import w from"./jsDocumentCommentsToOpenApi-BEQrWgpQ.mjs";import{parseFileMulti as d}from"./parseFile-Wxs3O0wy.mjs";import b from"./SpecBuilder-Vbq42UbW.mjs";import v from"./swaggerJsDocumentCommentsToOpenApi-BnPWbZoe.mjs";import y from"./validate-9Rwe2A3r.mjs";const D=[w,v],E=r=>r instanceof Error?r:new Error(String(r));class J{assetsPath;ignore;silent;sources;swaggerDefinition;verbose;constructor(t,n,o,s){this.assetsPath=t,this.swaggerDefinition=o,this.sources=n,this.verbose=s.verbose??!1,this.silent=s.silent??!1,this.ignore=s.ignore??[]}apply(t){const n=new Set([...u,...this.ignore]);t.hooks.make.tapAsync("SwaggerCompilerPlugin",async(o,s)=>{this.log("Build paused, switching to swagger build");const e=new b(this.swaggerDefinition);try{for(const i of this.sources){const l=await p(i,{extensions:[".js",".cjs",".mjs",".ts",".tsx",".jsx",".yaml",".yml"],includeDirs:!1,skip:[...n]});this.verbose&&(this.log(`Found ${String(l.length)} files in ${i}`),this.log(JSON.stringify(l))),l.forEach(g=>{this.verbose&&this.log(`Parsing file ${g}`),e.addData(d(g,D,this.verbose).map(h=>h.spec))})}this.verbose&&(this.log("Validating swagger spec"),this.log(JSON.stringify(e,void 0,2))),await y(structuredClone(e));const{assetsPath:a}=this;await c(f(a),{recursive:!0}),await m(a,JSON.stringify(e,void 0,2)),this.verbose&&this.log(`Written swagger spec to "${this.assetsPath}" file`)}catch(a){const i=E(a);Array.isArray(o.errors)&&o.errors.push(i),s(i);return}this.log("switching back to normal build"),s()})}log(t){this.silent||console.log(t)}}export{J as default};

package/dist/packem_shared/constants-CdEv9ZcD.mjs

@@ -0,0 +1 @@
+const s=["coverage/**",".github/**","**/*.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-workspace,pnpm-lock}.yaml","**/{package,package-lock}.json","**/yarn.lock","**/package.json5","**/.next/**"];export{s as D};

package/dist/packem_shared/constants-DnbfJ7Id.cjs

@@ -0,0 +1 @@
+"use strict";const s=["coverage/**",".github/**","**/*.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-workspace,pnpm-lock}.yaml","**/{package,package-lock}.json","**/yarn.lock","**/package.json5","**/.next/**"];exports.D=s;

package/dist/packem_shared/customizer-BXFVpImq.mjs

@@ -0,0 +1 @@
+const a=(r,t)=>{if(Array.isArray(r))return[...r,...t]};export{a as u};

package/dist/packem_shared/customizer-Bo8QD_ti.cjs

@@ -0,0 +1 @@
+"use strict";const t=(r,s)=>{if(Array.isArray(r))return[...r,...s]};exports.u=t;

package/dist/packem_shared/generateCommand-CEP0sWth.cjs

@@ -0,0 +1,5 @@
+"use strict";const c=require("node:fs/promises"),f=require("node:path"),b=require("node:process"),_=require("node:url"),S=require("@visulima/fs"),m=require("cli-progress"),F=require("yaml"),$=require("./constants-DnbfJ7Id.cjs"),j=require("./jsDocumentCommentsToOpenApi-CMbdb0uR.cjs"),p=require("./parseFile-CPb-Kglh.cjs"),E=require("./SpecBuilder-C_KcIxW-.cjs"),x=require("./swaggerJsDocumentCommentsToOpenApi-rMEaS4lg.cjs"),C=require("./loadDefinition-ah20Zy-G.cjs"),N=require("./validate-DLmCjOPl.cjs"),M=t=>t&&typeof t=="object"&&"default"in t?t.default:t,R=M(F),U=new Set([".yaml",".yml"]),h="-",w=[j,x],k=async t=>{try{let e=await import(_.pathToFileURL(f.normalize(t)).href);return e?.default&&(e=e.default),e}catch(e){if(e?.code==="ERR_MODULE_NOT_FOUND"||e?.code==="MODULE_NOT_FOUND"||e?.code==="ERR_LOAD_URL")throw new Error(`No config file found, on: ${t}
+`,{cause:e});const r=e instanceof Error?e.message:String(e);throw new Error(`Failed to load config file "${t}": ${r}`,{cause:e})}},L=async(t,e,r)=>{const i=await k(r.config??t),o=r.definition??i.definition;let{swaggerDefinition:u}=i;o&&(u={...C(o),...u});const d=r.output===h?void 0:new m.MultiBar({clearOnComplete:!1,format:"{value}/{total} | {bar} | {filename}",hideCursor:!0},m.Presets.shades_grey),s=new E(u),v=new Set([...$.D,...i.exclude]);for(const g of e){const q=(await c.lstat(g)).isDirectory(),n=await c.realpath(g);if(!q){s.addData(p.parseFileMulti(n,w,r.verbose).map(l=>l.spec));continue}const a=await S.collect(n,{extensions:i.extensions??[".js",".cjs",".mjs",".ts",".tsx",".jsx",".yaml",".yml"],followSymlinks:i.followSymlinks??!1,match:i.include,skip:[...v]});(r.verbose??r.veryVerbose)&&console.log(`
+Found ${String(a.length)} files in ${n}`),r.veryVerbose&&console.log(a);const D=d?.create(a.length,0);a.forEach(l=>{r.verbose&&console.log(`Parsing file ${l}`),D?.increment(1,{filename:n}),s.addData(p.parseFileMulti(l,w,r.verbose).map(O=>O.spec))})}return r.verbose&&console.log("Validating swagger spec"),r.veryVerbose&&console.log(JSON.stringify(s,void 0,2)),await N(structuredClone(s)),d?.stop(),s},y=(t,e)=>U.has(f.extname(e))?R.stringify(structuredClone(t)):JSON.stringify(t,void 0,2),T=async(t,e,r)=>{const i=await L(t,e,r),o=r.output??"swagger.json";if(o===h){b.stdout.write(`${y(i,"swagger.json")}
+`);return}r.verbose&&console.log(`Written swagger spec to "${o}" file`),await c.mkdir(f.dirname(o),{recursive:!0}),await c.writeFile(o,y(i,o)),console.log(`
+Swagger specification is ready, check the "${o}" file.`)};module.exports=T;

package/dist/packem_shared/generateCommand-CkcShFNr.mjs

@@ -0,0 +1,5 @@
+import{mkdir as D,writeFile as b,lstat as E,realpath as O}from"node:fs/promises";import{dirname as S,extname as _,normalize as F}from"node:path";import{stdout as U}from"node:process";import{pathToFileURL as x}from"node:url";import{collect as L}from"@visulima/fs";import{MultiBar as N,Presets as j}from"cli-progress";import R from"yaml";import{D as k}from"./constants-CdEv9ZcD.mjs";import C from"./jsDocumentCommentsToOpenApi-BEQrWgpQ.mjs";import{parseFileMulti as g}from"./parseFile-Wxs3O0wy.mjs";import M from"./SpecBuilder-Vbq42UbW.mjs";import V from"./swaggerJsDocumentCommentsToOpenApi-BnPWbZoe.mjs";import P from"./loadDefinition-7r9qpfuE.mjs";import T from"./validate-9Rwe2A3r.mjs";const A=new Set([".yaml",".yml"]),u="-",p=[C,V],J=async t=>{try{let e=await import(x(F(t)).href);return e?.default&&(e=e.default),e}catch(e){if(e?.code==="ERR_MODULE_NOT_FOUND"||e?.code==="MODULE_NOT_FOUND"||e?.code==="ERR_LOAD_URL")throw new Error(`No config file found, on: ${t}
+`,{cause:e});const o=e instanceof Error?e.message:String(e);throw new Error(`Failed to load config file "${t}": ${o}`,{cause:e})}},z=async(t,e,o)=>{const r=await J(o.config??t),i=o.definition??r.definition;let{swaggerDefinition:c}=r;i&&(c={...P(i),...c});const f=o.output===u?void 0:new N({clearOnComplete:!1,format:"{value}/{total} | {bar} | {filename}",hideCursor:!0},j.shades_grey),s=new M(c),w=new Set([...k,...r.exclude]);for(const m of e){const y=(await E(m)).isDirectory(),a=await O(m);if(!y){s.addData(g(a,p,o.verbose).map(l=>l.spec));continue}const n=await L(a,{extensions:r.extensions??[".js",".cjs",".mjs",".ts",".tsx",".jsx",".yaml",".yml"],followSymlinks:r.followSymlinks??!1,match:r.include,skip:[...w]});(o.verbose??o.veryVerbose)&&console.log(`
+Found ${String(n.length)} files in ${a}`),o.veryVerbose&&console.log(n);const h=f?.create(n.length,0);n.forEach(l=>{o.verbose&&console.log(`Parsing file ${l}`),h?.increment(1,{filename:a}),s.addData(g(l,p,o.verbose).map(v=>v.spec))})}return o.verbose&&console.log("Validating swagger spec"),o.veryVerbose&&console.log(JSON.stringify(s,void 0,2)),await T(structuredClone(s)),f?.stop(),s},d=(t,e)=>A.has(_(e))?R.stringify(structuredClone(t)):JSON.stringify(t,void 0,2),te=async(t,e,o)=>{const r=await z(t,e,o),i=o.output??"swagger.json";if(i===u){U.write(`${d(r,"swagger.json")}
+`);return}o.verbose&&console.log(`Written swagger spec to "${i}" file`),await D(S(i),{recursive:!0}),await b(i,d(r,i)),console.log(`
+Swagger specification is ready, check the "${i}" file.`)};export{te as default};

package/dist/packem_shared/generateCommand-CmoN8jyY.cjs

@@ -0,0 +1 @@
+"use strict";const f=require("node:fs"),s=require("node:process"),u=require("./generateCommand-CEP0sWth.cjs"),h=e=>e&&typeof e=="object"&&"default"in e?e.default:e,p=h(s),c=e=>{console.error(e)},d=async(e,i,n)=>{const t=async()=>{await u(e,i,n)},o=i.map(a=>f.watch(a,{recursive:!0},()=>{t().catch(c)})),r=()=>{o.forEach(a=>{a.close()}),s.exit(0)};p.once("SIGINT",r),p.once("SIGTERM",r);try{await t()}catch(a){c(a)}console.log("Watching for changes... (press Ctrl+C to exit)")},g=(e,i="generate",n=".openapirc.js")=>{e.command(i).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("-d, --definition [definition.yaml]","Base OpenAPI definition file (YAML/JSON) to seed info/servers/components.").option("-o, --output [swaggerSpec.json]",'Output swagger specification. Use "-" to write to stdout, or a .yaml/.yml path for YAML output.').option("-w, --watch","Re-generate the specification whenever a watched path changes.").option("-v, --verbose","Verbose output.").option("--very-verbose","Very verbose output.").action(async(t,o)=>{if(o.watch){await d(n,t,o);return}try{await u(n,t,o)}catch(r){c(r),s.exit(1)}})};module.exports=g;

package/dist/packem_shared/generateCommand-DEhmHbRZ.mjs

@@ -0,0 +1 @@
+import{watch as u}from"node:fs";import s,{exit as p}from"node:process";import f from"./generateCommand-CkcShFNr.mjs";const c=o=>{console.error(o)},h=async(o,a,r)=>{const e=async()=>{await f(o,a,r)},t=a.map(i=>u(i,{recursive:!0},()=>{e().catch(c)})),n=()=>{t.forEach(i=>{i.close()}),p(0)};s.once("SIGINT",n),s.once("SIGTERM",n);try{await e()}catch(i){c(i)}console.log("Watching for changes... (press Ctrl+C to exit)")},d=(o,a="generate",r=".openapirc.js")=>{o.command(a).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("-d, --definition [definition.yaml]","Base OpenAPI definition file (YAML/JSON) to seed info/servers/components.").option("-o, --output [swaggerSpec.json]",'Output swagger specification. Use "-" to write to stdout, or a .yaml/.yml path for YAML output.').option("-w, --watch","Re-generate the specification whenever a watched path changes.").option("-v, --verbose","Verbose output.").option("--very-verbose","Very verbose output.").action(async(e,t)=>{if(t.watch){await h(r,e,t);return}try{await f(r,e,t)}catch(n){c(n),p(1)}})};export{d as default};

package/dist/packem_shared/initCommand-1O6IuWJv.mjs

@@ -0,0 +1 @@
+import{exit as c}from"node:process";import e from"./initCommand-Ca1hGdYS.mjs";const s=(o,i="init",r="Inits a pre-configured @visulima/jsdoc-open-api config file.",n=".openapirc.js")=>{o.command(i).description(r).action(()=>{try{e(n)}catch(t){console.error(t),c(1)}})};export{s as default};

package/dist/packem_shared/initCommand-C8s0kkim.cjs

@@ -0,0 +1 @@
+"use strict";const r=require("node:process"),t=require("./initCommand-DvNH61Z4.cjs"),s=(i,e="init",n="Inits a pre-configured @visulima/jsdoc-open-api config file.",o=".openapirc.js")=>{i.command(e).description(n).action(()=>{try{t(o)}catch(c){console.error(c),r.exit(1)}})};module.exports=s;