@visulima/jsdoc-open-api 3.0.9 → 3.0.11

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## @visulima/jsdoc-open-api [3.0.11](https://github.com/visulima/visulima/compare/%40visulima%2Fjsdoc-open-api%403.0.10...%40visulima%2Fjsdoc-open-api%403.0.11) (2026-08-02)
+
+
+### Dependencies
+
+* **@visulima/fs:** upgraded to 5.1.0
+
+## @visulima/jsdoc-open-api [3.0.10](https://github.com/visulima/visulima/compare/%40visulima%2Fjsdoc-open-api%403.0.9...%40visulima%2Fjsdoc-open-api%403.0.10) (2026-07-27)
+
+
+### Dependencies
+
+* **@visulima/fs:** upgraded to 5.0.11
+
 ## @visulima/jsdoc-open-api [3.0.9](https://github.com/visulima/visulima/compare/%40visulima%2Fjsdoc-open-api%403.0.8...%40visulima%2Fjsdoc-open-api%403.0.9) (2026-07-27)
 
 

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

@@ -21,7 +21,6 @@ declare class CommanderError extends Error {
    */
   constructor(exitCode: number, code: string, message: string);
 }
-// deprecated old name
 interface ErrorOptions {
   // optional parameter for error()
   /** an id string representing the error */
@@ -43,32 +42,26 @@ declare class Argument {
    * indicate this with <> around the name. Put [] around the name for an optional argument.
    */
   constructor(arg: string, description?: string);
-
   /**
    * Return argument name.
    */
   name(): string;
-
   /**
    * Set the default value, and optionally supply the description to be displayed in the help.
    */
   default(value: unknown, description?: string): this;
-
   /**
    * Set the custom handler for processing CLI command arguments into argument values.
    */
   argParser<T>(fn: (value: string, previous: T) => T): this;
-
   /**
    * Only allow argument value to be one of choices.
    */
   choices(values: readonly string[]): this;
-
   /**
    * Make argument required.
    */
   argRequired(): this;
-
   /**
    * Make argument optional.
    */
@@ -97,7 +90,6 @@ declare class Option {
    * Set the default value, and optionally supply the description to be displayed in the help.
    */
   default(value: unknown, description?: string): this;
-
   /**
    * Preset to use when option used without option-argument, especially optional but also boolean and negated.
    * The custom processing (parseArg) is called.
@@ -109,7 +101,6 @@ declare class Option {
    * ```
    */
   preset(arg: unknown): this;
-
   /**
    * Add option name(s) that conflict with this option.
    * An error will be displayed if conflicting options are found during parsing.
@@ -121,7 +112,6 @@ declare class Option {
    * ```
    */
   conflicts(names: string | string[]): this;
-
   /**
    * Specify implied option values for when this option is set and the implied options are not.
    *
@@ -133,7 +123,6 @@ declare class Option {
    *   .addOption(new Option('--trace', 'log extra details').implies({ log: 'trace.txt' }));
    */
   implies(optionValues: OptionValues): this;
-
   /**
    * Set environment variable to check for option value.
    *
@@ -141,43 +130,35 @@ declare class Option {
    * undefined, or the source of the current value is 'default' or 'config' or 'env'.
    */
   env(name: string): this;
-
   /**
    * Set the custom handler for processing CLI option arguments into option values.
    */
   argParser<T>(fn: (value: string, previous: T) => T): this;
-
   /**
    * Whether the option is mandatory and must have a value after parsing.
    */
   makeOptionMandatory(mandatory?: boolean): this;
-
   /**
    * Hide option in help.
    */
   hideHelp(hide?: boolean): this;
-
   /**
    * Only allow option value to be one of choices.
    */
   choices(values: readonly string[]): this;
-
   /**
    * Return option name.
    */
   name(): string;
-
   /**
    * Return option name, in a camelcase format that can be used
    * as an object attribute key.
    */
   attributeName(): string;
-
   /**
    * Set the help group heading.
    */
   helpGroup(heading: string): this;
-
   /**
    * Return whether a boolean option.
    *
@@ -204,7 +185,6 @@ declare class Help {
     helpWidth?: number;
     outputHasColors?: boolean;
   }): void;
-
   /** Get the command term to show in the list of subcommands. */
   subcommandTerm(cmd: Command): string;
   /** Get the command summary to show in the list of subcommands. */
@@ -217,12 +197,10 @@ declare class Help {
   argumentTerm(argument: Argument): string;
   /** Get the argument description to show in the list of arguments. */
   argumentDescription(argument: Argument): string;
-
   /** Get the command usage to be displayed at the top of the built-in help. */
   commandUsage(cmd: Command): string;
   /** Get the description for the command. */
   commandDescription(cmd: Command): string;
-
   /** Get an array of the visible subcommands. Includes a placeholder for the implicit help command, if there is one. */
   visibleCommands(cmd: Command): Command[];
   /** Get an array of the visible options. Includes a placeholder for the implicit help option, if there is one. */
@@ -231,7 +209,6 @@ declare class Help {
   visibleGlobalOptions(cmd: Command): Option[];
   /** Get an array of the arguments which have descriptions. */
   visibleArguments(cmd: Command): Argument[];
-
   /** Get the longest command term length. */
   longestSubcommandTermLength(cmd: Command, helper: Help): number;
   /** Get the longest option term length. */
@@ -240,13 +217,10 @@ declare class Help {
   longestGlobalOptionTermLength(cmd: Command, helper: Help): number;
   /** Get the longest argument term length. */
   longestArgumentTermLength(cmd: Command, helper: Help): number;
-
   /** Return display width of string, ignoring ANSI escape sequences. Used in padding and wrapping calculations. */
   displayWidth(str: string): number;
-
   /** Style the titles. Called with 'Usage:', 'Options:', etc. */
   styleTitle(title: string): string;
-
   /** Usage: <str> */
   styleUsage(str: string): string;
   /** Style for command name in usage string.  */
@@ -266,19 +240,15 @@ declare class Help {
   styleSubcommandText(str: string): string;
   /** Base style used in terms and usage for arguments. */
   styleArgumentText(str: string): string;
-
   /** Calculate the pad width from the maximum term length. */
   padWidth(cmd: Command, helper: Help): number;
-
   /**
    * Wrap a string at whitespace, preserving existing line breaks.
    * Wrapping is skipped if the width is less than `minWidthToWrap`.
    */
   boxWrap(str: string, width: number): string;
-
   /** Detect manually wrapped and indented strings by checking for line break followed by whitespace. */
   preformatted(str: string): boolean;
-
   /**
    * Format the "item", which consists of a term and description. Pad the term and wrap the description, indenting the following lines.
    *
@@ -287,17 +257,14 @@ declare class Help {
    *          DD DDD
    */
   formatItem(term: string, termWidth: number, description: string, helper: Help): string;
-
   /**
    * Format a list of items, given a heading and an array of formatted items.
    */
   formatItemList(heading: string, items: string[], helper: Help): string[];
-
   /**
    * Group items by their help group heading.
    */
   groupItems<T extends Command | Option>(unsortedItems: T[], visibleItems: T[], getGroup: (item: T) => string): Map<string, T[]>;
-
   /** Generate the built-in help text. */
   formatHelp(cmd: Command, helper: Help): string;
 }
@@ -350,7 +317,6 @@ declare class Command {
    * Get the program version.
    */
   version(): string | undefined;
-
   /**
    * Define a command, implemented using an action handler.
    *
@@ -391,7 +357,6 @@ declare class Command {
    * @returns `this` command for chaining
    */
   command(nameAndArgs: string, description: string, opts?: ExecutableCommandOptions): this;
-
   /**
    * Factory routine to create a new unattached command.
    *
@@ -399,7 +364,6 @@ declare class Command {
    * create the command. You can override createCommand to customise subcommands.
    */
   createCommand(name?: string): Command;
-
   /**
    * Add a prepared subcommand.
    *
@@ -408,7 +372,6 @@ declare class Command {
    * @returns `this` command for chaining
    */
   addCommand(cmd: Command, opts?: CommandOptions): this;
-
   /**
    * Factory routine to create a new unattached argument.
    *
@@ -416,7 +379,6 @@ declare class Command {
    * create the argument. You can override createArgument to return a custom argument.
    */
   createArgument(name: string, description?: string): Argument;
-
   /**
    * Define argument syntax for command.
    *
@@ -439,7 +401,6 @@ declare class Command {
    * @returns `this` command for chaining
    */
   addArgument(arg: Argument): this;
-
   /**
    * Define argument syntax for command, adding multiple at once (without descriptions).
    *
@@ -453,7 +414,6 @@ declare class Command {
    * @returns `this` command for chaining
    */
   arguments(names: string): this;
-
   /**
    * Customise or override default help command. By default a help command is automatically added if your command has subcommands.
    *
@@ -475,28 +435,23 @@ declare class Command {
   addHelpCommand(nameAndArgs: string, description?: string): this;
   /** @deprecated since v12, instead use helpCommand */
   addHelpCommand(enable?: boolean): this;
-
   /**
    * Add hook for life cycle event.
    */
   hook(event: HookEvent, listener: (thisCommand: Command, actionCommand: Command) => void | Promise<void>): this;
-
   /**
    * Register callback to use as replacement for calling process.exit.
    */
   exitOverride(callback?: (err: CommanderError) => never | void): this;
-
   /**
    * Display error message and exit (or call exitOverride).
    */
   error(message: string, errorOptions?: ErrorOptions): never;
-
   /**
    * You can customise the help with a subclass of Help by overriding createHelp,
    * or by overriding Help properties using configureHelp().
    */
   createHelp(): Help;
-
   /**
    * You can customise the help by overriding Help properties using configureHelp(),
    * or with a subclass of Help by overriding createHelp().
@@ -504,7 +459,6 @@ declare class Command {
   configureHelp(configuration: HelpConfiguration): this;
   /** Get configuration */
   configureHelp(): HelpConfiguration;
-
   /**
    * The default output goes to stdout and stderr. You can customise this for special
    * applications. You can also customise the display of errors by overriding outputError.
@@ -524,24 +478,20 @@ declare class Command {
   configureOutput(configuration: OutputConfiguration): this;
   /** Get configuration */
   configureOutput(): OutputConfiguration;
-
   /**
    * Copy settings that are useful to have in common across root command and subcommands.
    *
    * (Used internally when adding a command using `.command()` so subcommands inherit parent settings.)
    */
   copyInheritedSettings(sourceCommand: Command): this;
-
   /**
    * Display the help or a custom message after an error occurs.
    */
   showHelpAfterError(displayHelp?: boolean | string): this;
-
   /**
    * Display suggestion of similar commands for unknown commands, or options for unknown options.
    */
   showSuggestionAfterError(displaySuggestion?: boolean): this;
-
   /**
    * Register callback `fn` for the command.
    *
@@ -558,7 +508,6 @@ declare class Command {
    * @returns `this` command for chaining
    */
   action(fn: (this: this, ...args: any[]) => void | Promise<void>): this;
-
   /**
    * Define option with `flags`, `description`, and optional argument parsing function or `defaultValue` or both.
    *
@@ -583,7 +532,6 @@ declare class Command {
   option<T>(flags: string, description: string, parseArg: (value: string, previous: T) => T, defaultValue?: T): this;
   /** @deprecated since v7, instead use choices or a custom function */
   option(flags: string, description: string, regexp: RegExp, defaultValue?: string | boolean | string[]): this;
-
   /**
    * Define a required option, which must have a value after parsing. This usually means
    * the option must be specified on the command line. (Otherwise the same as .option().)
@@ -594,23 +542,19 @@ declare class Command {
   requiredOption<T>(flags: string, description: string, parseArg: (value: string, previous: T) => T, defaultValue?: T): this;
   /** @deprecated since v7, instead use choices or a custom function */
   requiredOption(flags: string, description: string, regexp: RegExp, defaultValue?: string | boolean | string[]): this;
-
   /**
    * Factory routine to create a new unattached option.
    *
    * See .option() for creating an attached option, which uses this routine to
    * create the option. You can override createOption to return a custom option.
    */
-
   createOption(flags: string, description?: string): Option;
-
   /**
    * Add a prepared Option.
    *
    * See .option() and .requiredOption() for creating and attaching an option in a single call.
    */
   addOption(option: Option): this;
-
   /**
    * Whether to store option values as properties on command object,
    * or store separately (specify false). In both cases the option values can be accessed using .opts().
@@ -624,27 +568,22 @@ declare class Command {
    * Retrieve option value.
    */
   getOptionValue(key: string): any;
-
   /**
    * Store option value.
    */
   setOptionValue(key: string, value: unknown): this;
-
   /**
    * Store option value and where the value came from.
    */
   setOptionValueWithSource(key: string, value: unknown, source: OptionValueSource): this;
-
   /**
    * Get source of option value.
    */
   getOptionValueSource(key: string): OptionValueSource | undefined;
-
   /**
    * Get source of option value. See also .optsWithGlobals().
    */
   getOptionValueSourceWithGlobals(key: string): OptionValueSource | undefined;
-
   /**
    * Alter parsing of short flags with optional values.
    *
@@ -658,21 +597,18 @@ declare class Command {
    * @returns `this` command for chaining
    */
   combineFlagAndOptionalValue(combine?: boolean): this;
-
   /**
    * Allow unknown options on the command line.
    *
    * @returns `this` command for chaining
    */
   allowUnknownOption(allowUnknown?: boolean): this;
-
   /**
    * Allow excess command-arguments on the command line. Pass false to make excess arguments an error.
    *
    * @returns `this` command for chaining
    */
   allowExcessArguments(allowExcess?: boolean): this;
-
   /**
    * Enable positional options. Positional means global options are specified before subcommands which lets
    * subcommands reuse the same option names, and also enables subcommands to turn on passThroughOptions.
@@ -682,7 +618,6 @@ declare class Command {
    * @returns `this` command for chaining
    */
   enablePositionalOptions(positional?: boolean): this;
-
   /**
    * Pass through options that come after command-arguments rather than treat them as command-options,
    * so actual command-options come before command-arguments. Turning this on for a subcommand requires
@@ -693,7 +628,6 @@ declare class Command {
    * @returns `this` command for chaining
    */
   passThroughOptions(passThrough?: boolean): this;
-
   /**
    * Parse `argv`, setting options and invoking commands when defined.
    *
@@ -716,7 +650,6 @@ declare class Command {
    * @returns `this` command for chaining
    */
   parse(argv?: readonly string[], parseOptions?: ParseOptions): this;
-
   /**
    * Parse `argv`, setting options and invoking commands when defined.
    *
@@ -737,7 +670,6 @@ declare class Command {
    * @returns Promise
    */
   parseAsync(argv?: readonly string[], parseOptions?: ParseOptions): Promise<this>;
-
   /**
    * Called the first time parse is called to save state and allow a restore before subsequent calls to parse.
    * Not usually called directly, but available for subclasses to save their custom state.
@@ -745,7 +677,6 @@ declare class Command {
    * This is called in a lazy way. Only commands used in parsing chain will have state saved.
    */
   saveStateBeforeParse(): void;
-
   /**
    * Restore state before parse for calls after the first.
    * Not usually called directly, but available for subclasses to save their custom state.
@@ -753,7 +684,6 @@ declare class Command {
    * This is called in a lazy way. Only commands used in parsing chain will have state restored.
    */
   restoreStateBeforeParse(): void;
-
   /**
    * Parse options from `argv` removing known options,
    * and return argv split into operands and unknown arguments.
@@ -767,23 +697,19 @@ declare class Command {
    *     sub -- --unknown uuu op => [sub --unknown uuu op], []
    */
   parseOptions(argv: string[]): ParseOptionsResult;
-
   /**
    * Return an object containing local option values as key-value pairs
    */
   opts<T extends OptionValues>(): T;
-
   /**
    * Return an object containing merged local and global option values as key-value pairs.
    */
   optsWithGlobals<T extends OptionValues>(): T;
-
   /**
    * Set the description.
    *
    * @returns `this` command for chaining
    */
-
   description(str: string): this;
   /** @deprecated since v8, instead use .argument to add command argument with description */
   description(str: string, argsDescription: Record<string, string>): this;
@@ -791,19 +717,16 @@ declare class Command {
    * Get the description.
    */
   description(): string;
-
   /**
    * Set the summary. Used when listed as subcommand of parent.
    *
    * @returns `this` command for chaining
    */
-
   summary(str: string): this;
   /**
    * Get the summary.
    */
   summary(): string;
-
   /**
    * Set an alias for the command.
    *
@@ -816,7 +739,6 @@ declare class Command {
    * Get alias for the command.
    */
   alias(): string;
-
   /**
    * Set aliases for the command.
    *
@@ -829,7 +751,6 @@ declare class Command {
    * Get aliases for the command.
    */
   aliases(): string[];
-
   /**
    * Set the command usage.
    *
@@ -840,7 +761,6 @@ declare class Command {
    * Get the command usage.
    */
   usage(): string;
-
   /**
    * Set the name of the command.
    *
@@ -851,7 +771,6 @@ declare class Command {
    * Get the name of the command.
    */
   name(): string;
-
   /**
    * Set the name of the command from script filename, such as process.argv[1],
    * or import.meta.filename.
@@ -866,7 +785,6 @@ declare class Command {
    * @returns `this` command for chaining
    */
   nameFromFilename(filename: string): this;
-
   /**
    * Set the directory for searching for executable subcommands of this command.
    *
@@ -884,7 +802,6 @@ declare class Command {
    * Get the executable search directory.
    */
   executableDir(): string | null;
-
   /**
    * Set the help group heading for this subcommand in parent command's help.
    *
@@ -895,7 +812,6 @@ declare class Command {
    * Get the help group heading for this subcommand in parent command's help.
    */
   helpGroup(): string;
-
   /**
    * Set the default help group heading for subcommands added to this command.
    * (This does not override a group set directly on the subcommand using .helpGroup().)
@@ -913,7 +829,6 @@ declare class Command {
    * Get the default help group heading for subcommands added to this command.
    */
   commandsGroup(): string;
-
   /**
    * Set the default help group heading for options added to this command.
    * (This does not override a group set directly on the option using .helpGroup().)
@@ -931,7 +846,6 @@ declare class Command {
    * Get the default help group heading for options added to this command.
    */
   optionsGroup(): string;
-
   /**
    * Output help information for this command.
    *
@@ -941,25 +855,21 @@ declare class Command {
   outputHelp(context?: HelpContext): void;
   /** @deprecated since v7 */
   outputHelp(cb: (str: string) => string): void;
-
   /**
    * Return command help documentation.
    */
   helpInformation(context?: HelpContext): string;
-
   /**
    * You can pass in flags and a description to override the help
    * flags and help description for your command. Pass in false
    * to disable the built-in help option.
    */
   helpOption(flags?: string | boolean, description?: string): this;
-
   /**
    * Supply your own option to use for the built-in help option.
    * This is an alternative to using helpOption() to customise the flags and description etc.
    */
   addHelpOption(option: Option): this;
-
   /**
    * Output help information and exit.
    *
@@ -968,7 +878,6 @@ declare class Command {
   help(context?: HelpContext): never;
   /** @deprecated since v7 */
   help(cb: (str: string) => string): never;
-
   /**
    * Add additional text to be displayed with the built-in help.
    *

package/dist/cli/commander/index.js

@@ -1 +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};
+import{default as m}from"../../packem_shared/generateCommand-D0Veh_ij.js";import{default as t}from"../../packem_shared/initCommand-TixxsVQU.js";export{m as generateCommand,t as initCommand};

package/dist/cli/index.js

@@ -1 +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};
+import{default as m}from"../packem_shared/generateCommand-BWWxeINy.js";import{default as t}from"../packem_shared/initCommand-Ca1hGdYS.js";export{m as generateCommand,t as initCommand};

package/dist/index.js

@@ -1 +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};
+import{default as a}from"./packem_shared/jsDocumentCommentsToOpenApi-CuIbZppP.js";import{default as r}from"./packem_shared/DEFAULT_OPTIONS-QnOdktWv.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-DOyTa91M.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-CdaguiSi.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-QnOdktWv.js

@@ -0,0 +1 @@
+import{D as e}from"./constants-CdEv9ZcD.js";const o={cwd:void 0,exclude:[...e],excludeNodeModules:!0,extension:[".js",".cjs",".mjs",".ts",".tsx",".jsx",".yaml",".yml"],include:["**"],verbose:!0};export{o as default};

package/dist/packem_shared/{SwaggerCompilerPlugin-PUOALp2i.js → SwaggerCompilerPlugin-CdaguiSi.js}

@@ -1 +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};
+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-CuIbZppP.js";import{parseFileMulti as d}from"./parseFile-RDlR4tEF.js";import b from"./SpecBuilder-Vbq42UbW.js";import v from"./swaggerJsDocumentCommentsToOpenApi-DOyTa91M.js";import y from"./validate-9Rwe2A3r.js";const D=[w,v],S=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=S(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/generateCommand-BWWxeINy.js

@@ -0,0 +1,5 @@
+import{mkdir as b,writeFile as D,stat as E,realpath as O}from"node:fs/promises";import{dirname as S,extname as $,normalize as _}from"node:path";import{stdout as j}from"node:process";import{pathToFileURL as F}from"node:url";import{collect as U}from"@visulima/fs";import{MultiBar as x,Presets as L}from"cli-progress";import N from"yaml";import{D as R}from"./constants-CdEv9ZcD.js";import k from"./jsDocumentCommentsToOpenApi-CuIbZppP.js";import{parseFileMulti as g}from"./parseFile-RDlR4tEF.js";import C from"./SpecBuilder-Vbq42UbW.js";import M from"./swaggerJsDocumentCommentsToOpenApi-DOyTa91M.js";import T from"./loadDefinition-7r9qpfuE.js";import V from"./validate-9Rwe2A3r.js";const A=new Set([".yaml",".yml"]),u="-",d=[k,M],J=async t=>{try{let e=await import(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})}},P=async(t,e,o)=>{const r=await J(o.config??t),i=o.definition??r.definition;let{swaggerDefinition:n}=r;if(i&&(n={...T(i),...n}),n===null||typeof n!="object")throw new TypeError(`Invalid config "${o.config??t}": missing "swaggerDefinition" object. Provide it in the config or pass a base definition file via -d/--definition.`);const f=o.output===u?void 0:new x({clearOnComplete:!1,format:"{value}/{total} | {bar} | {filename}",hideCursor:!0},L.shades_grey),s=new C(n),w=new Set([...R,...r.exclude??[]]);try{for(const m of e){const y=(await E(m)).isDirectory(),a=await O(m);if(!y){s.addData(g(a,d,o.verbose).map(c=>c.spec));continue}const l=await U(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(l.length)} files in ${a}`),o.veryVerbose&&console.log(l);const h=f?.create(l.length,0);l.forEach(c=>{o.verbose&&console.log(`Parsing file ${c}`),h?.increment(1,{filename:a}),s.addData(g(c,d,o.verbose).map(v=>v.spec))})}o.verbose&&console.log("Validating swagger spec"),o.veryVerbose&&console.log(JSON.stringify(s,void 0,2)),await V(structuredClone(s))}finally{f?.stop()}return s},p=(t,e)=>A.has($(e))?N.stringify(structuredClone(t)):JSON.stringify(t,void 0,2),te=async(t,e,o)=>{const r=await P(t,e,o),i=o.output??"swagger.json";if(i===u){j.write(`${p(r,"swagger.json")}
+`);return}o.verbose&&console.log(`Written swagger spec to "${i}" file`),await b(S(i),{recursive:!0}),await D(i,p(r,i)),console.log(`
+Swagger specification is ready, check the "${i}" file.`)};export{te as default};

package/dist/packem_shared/generateCommand-D0Veh_ij.js

@@ -0,0 +1 @@
+import{watch as y}from"node:fs";import{resolve as f}from"node:path";import l,{exit as h}from"node:process";import m from"./generateCommand-BWWxeINy.js";const v=200,c=i=>{console.error(i)},S=async(i,s,r)=>{let t=!1,e=!1;const n=async()=>{if(t){e=!0;return}t=!0;try{await m(i,s,r)}catch(a){c(a)}finally{t=!1,e&&(e=!1,n().catch(c))}},g=f(r.output??"swagger.json");let o;const w=()=>{o&&clearTimeout(o),o=setTimeout(()=>{o=void 0,n().catch(c)},v)},d=s.map(a=>y(a,{recursive:!0},(b,u)=>{u!==null&&f(a,u)===g||w()})),p=()=>{o&&clearTimeout(o),d.forEach(a=>{a.close()}),h(0)};l.once("SIGINT",p),l.once("SIGTERM",p),await n(),console.log("Watching for changes... (press Ctrl+C to exit)")},G=(i,s="generate",r=".openapirc.js")=>{i.command(s).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,e)=>{try{if(e.watch){await S(r,t,e);return}await m(r,t,e)}catch(n){c(n),h(1)}})};export{G as default};

package/dist/packem_shared/jsDocumentCommentsToOpenApi-CuIbZppP.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,""),a=T.has(e),s=Object.keys(m).includes(e);let r;if(t.default)switch(e){case"double":case"float":case"number":{r=Number.parseFloat(t.default);break}case"int32":case"int64":case"integer":{r=Number.parseInt(t.default,10);break}default:{r=t.default;break}}let n;a?n={default:r,type:e}:s?n={default:r,format:e,type:m[e]}:n={$ref:`#/components/schemas/${e}`};let i=c?{items:{...n},type:"array"}:{...n};e===""&&(i=void 0);let p=t.description.trim().replace(b,"");return p===""&&(p=void 0),{description:p,name:t.name,rawType:o,required:!t.optional,schema:i}},k=(t,o)=>t.map(c=>{const e=w(c);let a="";switch(e.name&&(a+=e.name),e.description&&(a+=` ${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:a}};case"bodyExample":{const s=e.name.split("."),r=s.at(-1);return{requestBody:{content:{[s.slice(0,-1).join(".")]:{examples:{[r]:{$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]:a};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 s=e.name.split("."),r=s[0],n=s.slice(1).join(".");return{responses:{[r]:{content:{[n]:{schema:e.schema}}}}}}case"responseExample":{const s=e.name.split("."),r=s[0],n=s.at(-1),i=s.slice(1,-1).join(".");return{responses:{[r]:{content:{[i]:{examples:{[n]:{$ref:`#/components/examples/${e.rawType}`}}}}}}}}case"responseHeader":{const[s,r]=e.name.split(".");return{responses:{[s]:{headers:{[r]:{description:e.description,schema:e.schema}}}}}}case"responseHeaderComponent":{const[s,r]=e.name.split(".");return{responses:{[s]:{headers:{[r]:{$ref:`#/components/headers/${e.rawType}`}}}}}}case"responseLink":{const[s,r]=e.name.split(".");return{responses:{[s]:{links:{[r]:{$ref:`#/components/links/${e.rawType}`}}}}}}case"security":{const[s,r]=e.name.split(".");let n=[];return r&&(n=[r]),{security:{[s]:n}}}case"server":return{servers:[{description:e.description,url:e.name}]};case"tag":return{tags:[a]};default:return{}}}),E=(t,o,c)=>(c??d(t,{spacing:"preserve"})).filter(e=>g.test(e.description.trim())).map(e=>{const a=e.tags.length+1,s={};for(const u of k(e.tags))l(s,u,y);h(s);const[r,n]=e.description.split(" "),i={[n.trim()]:{[r.toLowerCase().trim()]:{...s}}},p=JSON.parse(JSON.stringify({paths:i}));return{loc:a,spec:p}});export{E as default};

package/dist/packem_shared/{swaggerJsDocumentCommentsToOpenApi-Bm9R1BnW.js → swaggerJsDocumentCommentsToOpenApi-DOyTa91M.js}

@@ -1,4 +1,4 @@
-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}
+import{parse as u}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},f=(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))),h=(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)){const r=t[e];r!=null&&(s[e]??={},Object.keys(r).forEach(n=>{s[e][n]=f(s[e][n],r[n])}))}else if(e==="tags"){const{tags:r}=t;Array.isArray(r)?r.forEach(n=>{h(n,s.tags)||s.tags.push(n)}):h(r,s.tags)||s.tags.push(r)}else if(e==="security"){const{security:r}=t;s.security=r}else e.startsWith("/")&&(s.paths[e]=f(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:
 \`\`\`
@@ -7,4 +7,4 @@ Imbedded within:
   `)}
 \`\`\``).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};
+`),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??u(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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/jsdoc-open-api",
-  "version": "3.0.9",
+  "version": "3.0.11",
   "description": "Generates swagger doc based on JSDoc.",
   "keywords": [
     "api",
@@ -90,7 +90,7 @@
   },
   "dependencies": {
     "@apidevtools/swagger-parser": "^12.1.0",
-    "@visulima/fs": "5.0.10",
+    "@visulima/fs": "5.1.0",
     "comment-parser": "1.4.7",
     "es-toolkit": "^1.49.0",
     "yaml": "2.9.0"

package/dist/packem_shared/DEFAULT_OPTIONS-C7o6qjwP.js

@@ -1 +0,0 @@
-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/generateCommand-C_XPsbS6.js

@@ -1,5 +0,0 @@
-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

@@ -1 +0,0 @@
-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/jsDocumentCommentsToOpenApi-TjPhUj5G.js

@@ -1 +0,0 @@
-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};