@visulima/jsdoc-open-api 3.0.0-alpha.8 → 3.0.0

package/dist/cli/commander/index.js

@@ -0,0 +1 @@
+import{default as m}from"../../packem_shared/generateCommand-ClL9Mnc3.js";import{default as t}from"../../packem_shared/initCommand-TixxsVQU.js";export{m as generateCommand,t as initCommand};

package/dist/cli/index.d.ts

@@ -1,2 +1,9 @@
-export { default as generateCommand } from "./command/generate-command.d.ts";
-export { default as initCommand } from "./command/init-command.d.ts";
+declare const generateCommand: (configName: string, paths: string[], options: {
+  config?: string;
+  definition?: string;
+  output?: string;
+  verbose?: boolean;
+  veryVerbose?: boolean;
+}) => Promise<void>;
+declare const initCommand: (configName: string, packageJsonPath?: string) => void;
+export { generateCommand, initCommand };

package/dist/cli/index.js

@@ -0,0 +1 @@
+import{default as m}from"../packem_shared/generateCommand-C_XPsbS6.js";import{default as t}from"../packem_shared/initCommand-Ca1hGdYS.js";export{m as generateCommand,t as initCommand};

package/dist/index.d.ts

@@ -1,7 +1,266 @@
-export type { BaseDefinition, OpenApiObject } from "./exported.d.ts";
-export { default as jsDocumentCommentsToOpenApi } from "./jsdoc/comments-to-open-api.d.ts";
-export { default as parseFile } from "./parse-file.d.ts";
-export { default as SpecBuilder } from "./spec-builder.d.ts";
-export { default as swaggerJsDocumentCommentsToOpenApi } from "./swagger-jsdoc/comments-to-open-api.d.ts";
-export { default as yamlLoc } from "./util/yaml-loc.d.ts";
-export { default as SwaggerCompilerPlugin } from "./webpack/swagger-compiler-plugin.d.ts";
+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[];
+}
+interface OpenApiObject extends BaseDefinition {
+  paths?: PathsObject;
+}
+interface InfoObject {
+  contact?: ContactObject;
+  description?: string;
+  license?: LicenseObject;
+  termsOfService?: string;
+  title: string;
+  version: string;
+}
+interface ContactObject {
+  email?: string;
+  name?: string;
+  url?: string;
+}
+interface LicenseObject {
+  name: string;
+  url?: string;
+}
+interface ServerObject {
+  description?: string;
+  url: string;
+  variables?: Map<ServerVariable>;
+}
+interface ServerVariable {
+  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>;
+}
+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;
+}
+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[];
+}
+interface ExternalDocumentationObject {
+  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;
+}
+interface RequestBodyObject {
+  content: Map<MediaTypeObject>;
+  description?: string;
+  required?: boolean;
+}
+interface MediaTypeObject {
+  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;
+}
+type ResponsesObject = Record<string, ReferenceObject | ResponseObject>;
+interface ResponseObject {
+  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;
+}
+interface LinkObject {
+  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;
+}
+interface TagObject {
+  description?: string;
+  externalDocs?: ExternalDocumentationObject;
+  name: string;
+}
+interface ReferenceObject {
+  $ref: string;
+}
+type SchemaObject = Record<string, any>;
+interface ApiKeySecuritySchemeObject {
+  description?: string;
+  in: string;
+  name: string;
+  type: string;
+}
+interface HttpSecuritySchemeObject {
+  bearerFormat?: string;
+  description?: string;
+  scheme: string;
+  type: string;
+}
+interface Oauth2SecuritySchemeObject {
+  description?: string;
+  flows: OAuthFlowsObject;
+  type: string;
+}
+interface OpenIdConnectSecuritySchemeObject {
+  description?: string;
+  openIdConnectUrl: string;
+  type: string;
+}
+interface OAuthFlowsObject {
+  authorizationCode?: OAuthFlowObject;
+  clientCredentials?: OAuthFlowObject;
+  implicit?: OAuthFlowObject;
+  password?: OAuthFlowObject;
+}
+interface OAuthFlowObject {
+  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, comments?: Block[]) => {
+  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, 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 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.js

@@ -0,0 +1 @@
+import{default as a}from"./packem_shared/jsDocumentCommentsToOpenApi-TjPhUj5G.js";import{default as r}from"./packem_shared/DEFAULT_OPTIONS-C7o6qjwP.js";import{default as l,parseFileMulti as m}from"./packem_shared/parseFile-RDlR4tEF.js";import{default as s}from"./packem_shared/SpecBuilder-Vbq42UbW.js";import{default as d}from"./packem_shared/swaggerJsDocumentCommentsToOpenApi-Bm9R1BnW.js";import{default as n}from"./packem_shared/loadDefinition-7r9qpfuE.js";import{default as g}from"./packem_shared/yamlLoc-DPq-xUM4.js";import{default as D}from"./packem_shared/validate-9Rwe2A3r.js";import{default as T}from"./packem_shared/SwaggerCompilerPlugin-PUOALp2i.js";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.js

@@ -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/SpecBuilder-Vbq42UbW.js

@@ -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-PUOALp2i.js

@@ -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.js";import w from"./jsDocumentCommentsToOpenApi-TjPhUj5G.js";import{parseFileMulti as d}from"./parseFile-RDlR4tEF.js";import b from"./SpecBuilder-Vbq42UbW.js";import v from"./swaggerJsDocumentCommentsToOpenApi-Bm9R1BnW.js";import y from"./validate-9Rwe2A3r.js";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.js

@@ -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/customizer-BXFVpImq.js

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

package/dist/packem_shared/generateCommand-C_XPsbS6.js

@@ -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.js";import C from"./jsDocumentCommentsToOpenApi-TjPhUj5G.js";import{parseFileMulti as g}from"./parseFile-RDlR4tEF.js";import M from"./SpecBuilder-Vbq42UbW.js";import V from"./swaggerJsDocumentCommentsToOpenApi-Bm9R1BnW.js";import P from"./loadDefinition-7r9qpfuE.js";import T from"./validate-9Rwe2A3r.js";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-ClL9Mnc3.js

@@ -0,0 +1 @@
+import{watch as u}from"node:fs";import s,{exit as p}from"node:process";import f from"./generateCommand-C_XPsbS6.js";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-Ca1hGdYS.js

@@ -0,0 +1,35 @@
+import{existsSync as t,realpathSync as c,writeFileSync as l}from"node:fs";import{findUpSync as i,readJsonSync as r}from"@visulima/fs";const j=(e,a=process.cwd())=>{if(t(e))throw new Error("Config file already exists");const o=i("package.json",{cwd:c(a)});let s="module.exports =";if(o){const n=r(o);console.info(`Found package.json at "${o}"`),n.type==="module"&&(console.info("Found package.json with type: module, using ES6 as export for the config file"),s="export default")}else console.info("No package.json found");l(e,`${s} {
+  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}"`)};export{j as default};

package/dist/packem_shared/initCommand-TixxsVQU.js

@@ -0,0 +1 @@
+import{exit as c}from"node:process";import e from"./initCommand-Ca1hGdYS.js";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/jsDocumentCommentsToOpenApi-TjPhUj5G.js

@@ -0,0 +1 @@
+import{parse as d}from"comment-parser";import{mergeWith as l}from"es-toolkit";import{u as y}from"./customizer-BXFVpImq.js";const f=/\[\]$/,b=/^- /u,$=/Param$/u,g=/^(GET|PUT|POST|DELETE|OPTIONS|HEAD|PATCH|TRACE) \/.*$/,h=t=>{t.security&&(t.security=Object.keys(t.security).map(o=>({[o]:t.security[o]})))},T=new Set(["array","boolean","integer","number","object","string"]),m={binary:"string",byte:"string",date:"string","date-time":"string",double:"number",float:"number",int32:"integer",int64:"integer",password:"string"},w=t=>{const o=t.type,c=o.endsWith("[]"),e=o.replace(f,""),n=T.has(e),r=Object.keys(m).includes(e);let s;if(t.default)switch(e){case"double":case"float":case"number":{s=Number.parseFloat(t.default);break}case"int32":case"int64":case"integer":{s=Number.parseInt(t.default,10);break}default:{s=t.default;break}}let a;n?a={default:s,type:e}:r?a={default:s,format:e,type:m[e]}:a={$ref:`#/components/schemas/${e}`};let p=c?{items:{...a},type:"array"}:{...a};e===""&&(p=void 0);let i=t.description.trim().replace(b,"");return i===""&&(i=void 0),{description:i,name:t.name,rawType:o,required:!t.optional,schema:p}},k=(t,o)=>t.map(c=>{const e=w(c);let n="";switch(e.name&&(n+=e.name),e.description&&(n+=` ${e.description.trim()}`),c.tag){case"bodyComponent":return{requestBody:{$ref:`#/components/requestBodies/${e.rawType}`}};case"bodyContent":return{requestBody:{content:{[e.name.replaceAll(String.raw`*\/*`,"*/*")]:{schema:e.schema}}}};case"bodyDescription":return{requestBody:{description:n}};case"bodyExample":{const[r,s]=e.name.split(".");return{requestBody:{content:{[r]:{examples:{[s]:{$ref:`#/components/examples/${e.rawType}`}}}}}}}case"bodyRequired":return{requestBody:{required:!0}};case"callback":return{callbacks:{[e.name]:{$ref:`#/components/callbacks/${e.rawType}`}}};case"cookieParam":case"headerParam":case"pathParam":case"queryParam":return{parameters:[{description:e.description,in:c.tag.replace($,""),name:e.name,required:e.required,schema:e.schema}]};case"deprecated":return{deprecated:!0};case"description":case"operationId":case"summary":return{[c.tag]:n};case"externalDocs":return{externalDocs:{description:e.description,url:e.name}};case"paramComponent":return{parameters:[{$ref:`#/components/parameters/${e.rawType}`}]};case"response":return{responses:{[e.name]:{description:e.description}}};case"responseComponent":return{responses:{[e.name]:{$ref:`#/components/responses/${e.rawType}`}}};case"responseContent":{const[r,s]=e.name.split(".");return{responses:{[r]:{content:{[s]:{schema:e.schema}}}}}}case"responseExample":{const[r,s,a]=e.name.split(".");return{responses:{[r]:{content:{[s]:{examples:{[a]:{$ref:`#/components/examples/${e.rawType}`}}}}}}}}case"responseHeader":{const[r,s]=e.name.split(".");return{responses:{[r]:{headers:{[s]:{description:e.description,schema:e.schema}}}}}}case"responseHeaderComponent":{const[r,s]=e.name.split(".");return{responses:{[r]:{headers:{[s]:{$ref:`#/components/headers/${e.rawType}`}}}}}}case"responseLink":{const[r,s]=e.name.split(".");return{responses:{[r]:{links:{[s]:{$ref:`#/components/links/${e.rawType}`}}}}}}case"security":{const[r,s]=e.name.split(".");let a=[];return s&&(a=[s]),{security:{[r]:a}}}case"server":return{servers:[{description:e.description,url:e.name}]};case"tag":return{tags:[n]};default:return{}}}),C=(t,o,c)=>(c??d(t,{spacing:"preserve"})).filter(e=>g.test(e.description.trim())).map(e=>{const n=e.tags.length+1,r={};for(const u of k(e.tags))l(r,u,y);h(r);const[s,a]=e.description.split(" "),p={[a.trim()]:{[s.toLowerCase().trim()]:{...r}}},i=JSON.parse(JSON.stringify({paths:p}));return{loc:n,spec:i}});export{C as default};

package/dist/packem_shared/loadDefinition-7r9qpfuE.js

@@ -0,0 +1 @@
+import{readFileSync as n}from"node:fs";import t from"node:path";import m from"yaml";const s=o=>{const r=t.extname(o);if(r!==".yaml"&&r!==".yml"&&r!==".json")throw new Error("OpenAPI definition path must be YAML or JSON.");const e=n(o,{encoding:"utf8"});return r===".yaml"||r===".yml"?m.parse(e):JSON.parse(e)};export{s as default};

package/dist/packem_shared/parseFile-RDlR4tEF.js

@@ -0,0 +1 @@
+import{readFileSync as f}from"node:fs";import p from"node:path";import{parse as u}from"comment-parser";import y from"yaml";import d from"./yamlLoc-DPq-xUM4.js";const i=new Set(["components","externalDocs","info","openapi","paths","security","servers","tags"]);class g extends Error{filePath}const l=new Set([".yaml",".yml"]),h=(t,o)=>{const r=y.parse(o);if(r===null||typeof r!="object")return[];const n=Object.keys(r).filter(e=>!i.has(e));if(n.length>0){const e=new g(`Unexpected keys: ${n.join(", ")}`);throw e.filePath=t,e}return Object.keys(r).some(e=>i.has(e))?[{loc:d(o),spec:r}]:[]},k=(t,o,r)=>{const n=f(t,{encoding:"utf8"}),e=p.extname(t);if(l.has(e))return h(t,n);try{return o(n,r)}catch(s){throw s.filePath=t,s}},O=(t,o,r)=>{const n=f(t,{encoding:"utf8"}),e=p.extname(t);if(l.has(e))return h(t,n);const s=u(n,{spacing:"preserve"}),c=[];for(const m of o)try{c.push(...m(n,r,s))}catch(a){throw a.filePath=t,a}return c};export{k as default,O as parseFileMulti};

package/dist/packem_shared/swaggerJsDocumentCommentsToOpenApi-Bm9R1BnW.js

@@ -0,0 +1,10 @@
+import{parse as f}from"comment-parser";import{mergeWith as m}from"es-toolkit";import y from"yaml";import{u as l}from"./customizer-BXFVpImq.js";const g=(s,t)=>{if(t===null)return s},h=(s,t)=>{const e=m({},s??{},g);return m(e,t??{},g)},d=s=>Object.keys(s).map(t=>s[t]).every(t=>typeof t=="object"&&Object.keys(t).every(e=>!(e in t))),u=(s,t)=>t.some(e=>s.name===e.name),v=s=>{switch(s.tag){case"asyncapi":return"v4";case"openapi":return"v3";case"swagger":return"v2";default:return"v2"}},w=(s,t,e)=>{if(e==="x-webhooks"&&(s[e]=t[e]),!e.startsWith("x-"))if(["components","consumes","produces","paths","schemas","securityDefinitions","responses","parameters","definitions","channels"].includes(e))Object.keys(t[e]).forEach(r=>{s[e][r]=h(s[e][r],t[e][r])});else if(e==="tags"){const{tags:r}=t;Array.isArray(r)?r.forEach(n=>{u(n,s.tags)||s.tags.push(n)}):u(r,s.tags)||s.tags.push(r)}else if(e==="security"){const{security:r}=t;s.security=r}else e.startsWith("/")&&(s.paths[e]=h(s.paths[e],t[e]))},E={v2:["paths","definitions","responses","parameters","securityDefinitions"],v3:["paths","definitions","responses","parameters","securityDefinitions","components"],v4:["components","channels"]},S=(s,t)=>s.map(e=>{const r=e.description!==""||e.name.startsWith("/")||e.name.endsWith(":");if((e.tag==="openapi"||e.tag==="swagger"||e.tag==="asyncapi")&&r){let n=e.description;(e.name.startsWith("/")||e.name.endsWith(":"))&&(n=n.trim()===""?e.name:`${e.name}
+${n}`);const a=y.parseDocument(n);if(a.errors.length>0){a.errors.forEach(p=>{p.annotation=n});let i="Error parsing YAML in @openapi spec:";throw i+=t?a.errors.map(p=>`${p.toString()}
+Imbedded within:
+\`\`\`
+  ${p.annotation?.replaceAll(`
+`,`
+  `)}
+\`\`\``).join(`
+`):a.errors.map(p=>p.toString()).join(`
+`),new Error(i)}const c=a.toJSON(),o={tags:[]};return E[v(e)].forEach(i=>{o[i]=o[i]??{}}),Object.keys(c).forEach(i=>{w(o,c,i)}),o}return{}}),O=new Set(["asyncapi","openapi","swagger"]),k=(s,t,e)=>(e??f(s,{spacing:"preserve"})).filter(r=>r.tags.some(n=>O.has(n.tag))).map(r=>{const n=r.tags.length+1,a={};for(const o of S(r.tags,t))m(a,o,l);["definitions","responses","parameters","securityDefinitions","components","tags"].forEach(o=>{a[o]!==void 0&&d(a[o])&&delete a[o]});const c=JSON.parse(JSON.stringify(a));return{loc:n,spec:c}});export{k as default};

package/dist/packem_shared/validate-9Rwe2A3r.js

@@ -0,0 +1 @@
+import t from"@apidevtools/swagger-parser";const e=async a=>{await t.validate(a)};export{e as default};

package/dist/packem_shared/yamlLoc-DPq-xUM4.js

@@ -0,0 +1 @@
+const s=/\r\n|\r|\n/u,l=/^\s*(#\s*(?:\S.*)?)?$/u,n=e=>e.split(s).filter(t=>l.test(t)?!1:t.trim().length>0).length;export{n as default};

package/package.json

@@ -1,23 +1,21 @@
 {
   "name": "@visulima/jsdoc-open-api",
-  "version": "3.0.0-alpha.8",
+  "version": "3.0.0",
   "description": "Generates swagger doc based on JSDoc.",
   "keywords": [
-    "visulima",
+    "api",
+    "cli",
+    "command",
+    "comment",
     "javascript",
+    "jsdoc",
     "openapi",
     "swagger",
-    "jsdoc",
-    "comment",
-    "api",
-    "webpack",
-    "cli",
-    "command"
+    "visulima",
+    "webpack"
   ],
   "homepage": "https://visulima.com/packages/jsdoc-open-api/",
-  "bugs": {
-    "url": "https://github.com/visulima/visulima/issues"
-  },
+  "bugs": "https://github.com/visulima/visulima/issues",
   "repository": {
     "type": "git",
     "url": "https://github.com/visulima/visulima.git",
@@ -39,41 +37,23 @@
     "email": "d.bannert@anolilab.de"
   },
   "sideEffects": false,
+  "type": "module",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.mts",
-        "default": "./dist/index.mjs"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     },
     "./cli": {
-      "import": {
-        "types": "./dist/cli/index.d.mts",
-        "default": "./dist/cli/index.mjs"
-      },
-      "require": {
-        "types": "./dist/cli/index.d.cts",
-        "default": "./dist/cli/index.cjs"
-      }
+      "types": "./dist/cli/index.d.ts",
+      "default": "./dist/cli/index.js"
     },
     "./cli/commander": {
-      "import": {
-        "types": "./dist/cli/commander/index.d.mts",
-        "default": "./dist/cli/commander/index.mjs"
-      },
-      "require": {
-        "types": "./dist/cli/commander/index.d.cts",
-        "default": "./dist/cli/commander/index.cjs"
-      }
+      "types": "./dist/cli/commander/index.d.ts",
+      "default": "./dist/cli/commander/index.js"
     },
     "./package.json": "./package.json"
   },
-  "main": "dist/index.cjs",
-  "module": "dist/index.mjs",
+  "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "typesVersions": {
     ">=5.0": {
@@ -101,15 +81,15 @@
   ],
   "dependencies": {
     "@apidevtools/swagger-parser": "^12.1.0",
-    "@visulima/fs": "5.0.0-alpha.9",
-    "comment-parser": "1.4.6",
-    "lodash.mergewith": "^4.6.2",
-    "yaml": "2.8.3"
+    "@visulima/fs": "5.0.0",
+    "comment-parser": "1.4.7",
+    "es-toolkit": "^1.47.1",
+    "yaml": "2.9.0"
   },
   "optionalDependencies": {
     "cli-progress": "^3.12.0",
-    "commander": "^14.0.3",
-    "webpack": "^5.106.2"
+    "commander": "^15.0.0",
+    "webpack": "^5.107.2"
   },
   "engines": {
     "node": "^22.14.0 || >=24.10.0"

package/dist/cli/command/generate-command.d.cts

@@ -1,7 +0,0 @@
-declare const generateCommand: (configName: string, paths: string[], options: {
-    config?: string;
-    output?: string;
-    verbose?: boolean;
-    veryVerbose?: boolean;
-}) => Promise<void>;
-export = generateCommand;

package/dist/cli/command/generate-command.d.mts

@@ -1,7 +0,0 @@
-declare const generateCommand: (configName: string, paths: string[], options: {
-    config?: string;
-    output?: string;
-    verbose?: boolean;
-    veryVerbose?: boolean;
-}) => Promise<void>;
-export default generateCommand;

package/dist/cli/command/generate-command.d.ts

@@ -1,7 +0,0 @@
-declare const generateCommand: (configName: string, paths: string[], options: {
-    config?: string;
-    output?: string;
-    verbose?: boolean;
-    veryVerbose?: boolean;
-}) => Promise<void>;
-export = generateCommand;

package/dist/cli/command/init-command.d.cts

@@ -1,2 +0,0 @@
-declare const initCommand: (configName: string, packageJsonPath?: string) => void;
-export = initCommand;

package/dist/cli/command/init-command.d.mts

@@ -1,2 +0,0 @@
-declare const initCommand: (configName: string, packageJsonPath?: string) => void;
-export default initCommand;

package/dist/cli/command/init-command.d.ts

@@ -1,2 +0,0 @@
-declare const initCommand: (configName: string, packageJsonPath?: string) => void;
-export = initCommand;

package/dist/cli/commander/command/generate-command.d.cts

@@ -1,3 +0,0 @@
-import type { Command } from "commander";
-declare const generateCommand: (program: Command, commandName?: string, configName?: string) => void;
-export = generateCommand;

package/dist/cli/commander/command/generate-command.d.mts

@@ -1,3 +0,0 @@
-import type { Command } from "commander";
-declare const generateCommand: (program: Command, commandName?: string, configName?: string) => void;
-export default generateCommand;

package/dist/cli/commander/command/generate-command.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "commander";
-declare const generateCommand: (program: Command, commandName?: string, configName?: string) => void;
-export = generateCommand;

package/dist/cli/commander/command/init-command.d.cts

@@ -1,3 +0,0 @@
-import type { Command } from "commander";
-declare const initCommand: (program: Command, commandName?: string, description?: string, configName?: string) => void;
-export = initCommand;

package/dist/cli/commander/command/init-command.d.mts

@@ -1,3 +0,0 @@
-import type { Command } from "commander";
-declare const initCommand: (program: Command, commandName?: string, description?: string, configName?: string) => void;
-export default initCommand;

package/dist/cli/commander/command/init-command.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "commander";
-declare const initCommand: (program: Command, commandName?: string, description?: string, configName?: string) => void;
-export = initCommand;

package/dist/cli/commander/index.cjs

@@ -1,11 +0,0 @@
-'use strict';
-
-Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
-
-const generateCommand = require('../../packem_shared/generateCommand-RY4QFtm7.cjs');
-const initCommand = require('../../packem_shared/initCommand-D3yVEMwO.cjs');
-
-
-
-exports.generateCommand = generateCommand;
-exports.initCommand = initCommand;

package/dist/cli/commander/index.d.cts

@@ -1,2 +0,0 @@
-export { default as generateCommand } from "./command/generate-command.d.cts";
-export { default as initCommand } from "./command/init-command.d.cts";

package/dist/cli/commander/index.d.mts

@@ -1,2 +0,0 @@
-export { default as generateCommand } from "./command/generate-command.d.mts";
-export { default as initCommand } from "./command/init-command.d.mts";

package/dist/cli/commander/index.mjs

@@ -1,2 +0,0 @@
-export { default as generateCommand } from '../../packem_shared/generateCommand-DRMkfIle.mjs';
-export { default as initCommand } from '../../packem_shared/initCommand-B6Z9EXHP.mjs';

package/dist/cli/index.cjs

@@ -1,11 +0,0 @@
-'use strict';
-
-Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
-
-const generateCommand = require('../packem_shared/generateCommand-MwnCNgEE.cjs');
-const initCommand = require('../packem_shared/initCommand-Ch-72dKZ.cjs');
-
-
-
-exports.generateCommand = generateCommand;
-exports.initCommand = initCommand;

package/dist/cli/index.d.cts

@@ -1,2 +0,0 @@
-export { default as generateCommand } from "./command/generate-command.d.cts";
-export { default as initCommand } from "./command/init-command.d.cts";

package/dist/cli/index.d.mts

@@ -1,2 +0,0 @@
-export { default as generateCommand } from "./command/generate-command.d.mts";
-export { default as initCommand } from "./command/init-command.d.mts";