ee-core 5.0.0-beta.2 → 5.0.0-beta.5

package/dist/cjs/utils/json.js

@@ -8,37 +8,86 @@ exports.readSync = readSync;
 exports.writeSync = writeSync;
 exports.read = read;
 exports.write = write;
+/**
+ * @module utils/json
+ * @description JSON file read/write utility. Provides synchronous and asynchronous JSON file
+ * read/write functions, automatically handling directory creation, object serialization, and
+ * file path checking, simplifying JSON file operations in framework and business code.
+ */
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+/**
+ * Strictly parse a JSON string
+ *
+ * Unlike JSON.parse, additionally validates that the parsed result must be an object type,
+ * preventing primitive type values (such as strings, numbers) from being parsed.
+ *
+ * @param str - JSON string
+ * @returns Parsed object
+ * @throws Error - Throws when parse result is not an object
+ */
 function strictParse(str) {
     const obj = JSON.parse(str);
+    // Ensure parse result is an object, excluding null, primitive values, and arrays
     if (!obj || typeof obj !== 'object') {
         throw new Error('JSON string is not object');
     }
     return obj;
 }
+/**
+ * Synchronously read a JSON file
+ *
+ * Reads file content and parses it as an object; throws if file does not exist.
+ *
+ * @param filepath - JSON file path
+ * @returns Parsed object
+ * @throws Error - Throws when file does not exist
+ */
 function readSync(filepath) {
     if (!fs_1.default.existsSync(filepath)) {
         throw new Error(filepath + ' is not found');
     }
     return JSON.parse(fs_1.default.readFileSync(filepath, 'utf8'));
 }
+/**
+ * Synchronously write a JSON file
+ *
+ * Automatically creates the target directory, objects are automatically serialized to JSON string,
+ * non-object values are converted to string for writing. Default uses 2-space indentation.
+ *
+ * @param filepath - Target file path
+ * @param str - Content to write, objects will be serialized by JSON.stringify
+ * @param options - Write options (indentation, replacer)
+ */
 function writeSync(filepath, str, options = {}) {
     const opts = { space: 2, ...options };
+    // Ensure target directory exists, avoiding write errors due to missing directory
     fs_1.default.mkdirSync(path_1.default.dirname(filepath), { recursive: true });
     let content;
     if (typeof str === 'object') {
         content = JSON.stringify(str, opts.replacer, opts.space) + '\n';
     }
     else {
+        // Non-object values are converted to string directly for writing
         content = String(str);
     }
     fs_1.default.writeFileSync(filepath, content);
 }
+/**
+ * Asynchronously read a JSON file
+ *
+ * First checks if the file exists and is a regular file, then reads and parses it.
+ * Uses fs.promises async API, does not block the event loop.
+ *
+ * @param filepath - JSON file path
+ * @returns Promise of the parsed object
+ * @throws Error - Throws when file does not exist or is not a file
+ */
 function read(filepath) {
     return fs_1.default.promises
         .stat(filepath)
         .then((stats) => {
+        // Ensure path points to a regular file, not a directory
         if (!stats.isFile()) {
             throw new Error(filepath + ' is not found');
         }
@@ -46,6 +95,18 @@ function read(filepath) {
     })
         .then((buf) => JSON.parse(buf));
 }
+/**
+ * Asynchronously write a JSON file
+ *
+ * Automatically creates the target directory, objects are automatically serialized to JSON string,
+ * non-object values are converted to string for writing. Default uses 2-space indentation.
+ * Uses fs.promises async API, does not block the event loop.
+ *
+ * @param filepath - Target file path
+ * @param str - Content to write, objects will be serialized by JSON.stringify
+ * @param options - Write options (indentation, replacer)
+ * @returns Promise that resolves when writing is complete
+ */
 function write(filepath, str, options = {}) {
     const opts = { space: 2, ...options };
     let content;
@@ -55,6 +116,7 @@ function write(filepath, str, options = {}) {
     else {
         content = String(str);
     }
+    // First ensure directory exists, then write the file
     return fs_1.default.promises.mkdir(path_1.default.dirname(filepath), { recursive: true }).then(() => fs_1.default.promises.writeFile(filepath, content));
 }
 //# sourceMappingURL=json.js.map

package/dist/cjs/utils/json.js.map

@@ -1 +1 @@
-{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/utils/json.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/utils/json.ts"],"names":[],"mappings":"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"}

package/dist/cjs/utils/pargv.d.ts

@@ -1,16 +1,67 @@
+/**
+ * @module utils/pargv
+ * @description Lightweight command line argument parser. Provides parseArgv() function that
+ * parses a string array into a structured key-value object, supporting short options,
+ * long options, aliases, boolean flags, nested properties, and more.
+ *
+ * Parsing steps:
+ * 1. Initialization phase: process boolean/string/alias/default configuration, build flag mappings
+ * 2. Split phase: separate arguments into options and non-options parts using '--' as delimiter
+ * 3. Item-by-item parsing phase:
+ *    - `--key=value`: long option with equals sign assignment
+ *    - `--no-key`: long option negation form (boolean false)
+ *    - `--key value`: long option followed by value
+ *    - `-abc`: short option combination (each letter is a separate option)
+ *    - Bare values: stored in argv._ array
+ * 4. Default value filling: fill default values for keys that did not appear
+ * 5. Non-option argument handling: based on '--' option, store in argv['--'] or argv._
+ *
+ * Security: automatically skips __proto__ and constructor properties, preventing prototype chain pollution.
+ */
+/** Command line parsing options */
 export interface ParseArgvOptions {
+    /** Declare boolean-type parameters. When true, all --flags are treated as boolean; or specify a list of parameter names */
     boolean?: boolean | string[];
+    /** Parameter alias mapping, e.g. { h: 'help', v: 'version' } */
     alias?: Record<string, string | string[]>;
+    /** Declare string-type parameters; these parameters will not be auto-converted to numbers */
     string?: string | string[];
+    /** Parameter default value mapping */
     default?: Record<string, unknown>;
+    /** Unknown argument handler function; returning false prevents the argument from being parsed */
     unknown?: (arg: string) => boolean | void;
+    /** Stop parsing when the first non-option argument is encountered; remaining arguments go into _ array */
     stopEarly?: boolean;
+    /** Whether to put arguments after '--' into argv['--'] array instead of argv._ */
     '--'?: boolean;
 }
+/** Parsed result object */
 export interface ParsedArgv {
+    /** Non-option argument list (bare values and positional arguments) */
     _: (string | number)[];
+    /** Argument list after '--' separator (only present when opts['--'] is true) */
     '--'?: string[];
+    /** Parsed key-value pairs; key names support dot notation nesting (e.g. 'a.b' -> { a: { b: ... } }) */
     [key: string]: unknown;
 }
+/**
+ * Parse command line argument array
+ *
+ * Parses a process.argv-style string array into a structured key-value object.
+ *
+ * @param args - Argument array (typically process.argv.slice(2))
+ * @param opts - Parsing options
+ * @returns Parsed result object
+ *
+ * @example
+ * ```ts
+ * parseArgv(['--name=foo', '-p', '8080', '--verbose', 'file.txt'], {
+ *   boolean: ['verbose'],
+ *   alias: { p: 'port' },
+ *   string: ['name'],
+ * })
+ * // => { _: ['file.txt'], name: 'foo', port: 8080, verbose: true }
+ * ```
+ */
 export declare function parseArgv(args: string[], opts?: ParseArgvOptions): ParsedArgv;
 //# sourceMappingURL=pargv.d.ts.map

package/dist/cjs/utils/pargv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pargv.d.ts","sourceRoot":"","sources":["../../../src/utils/pargv.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAiQ7E"}
+{"version":3,"file":"pargv.d.ts","sourceRoot":"","sources":["../../../src/utils/pargv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAiDH,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,2HAA2H;IAC3H,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IAC7B,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,iGAAiG;IACjG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC;IAC1C,0GAA0G;IAC1G,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kFAAkF;IAClF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,2BAA2B;AAC3B,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACvB,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,uGAAuG;IACvG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,UAAU,CA0U7E"}

package/dist/cjs/utils/pargv.js

@@ -1,8 +1,38 @@
 "use strict";
+/**
+ * @module utils/pargv
+ * @description Lightweight command line argument parser. Provides parseArgv() function that
+ * parses a string array into a structured key-value object, supporting short options,
+ * long options, aliases, boolean flags, nested properties, and more.
+ *
+ * Parsing steps:
+ * 1. Initialization phase: process boolean/string/alias/default configuration, build flag mappings
+ * 2. Split phase: separate arguments into options and non-options parts using '--' as delimiter
+ * 3. Item-by-item parsing phase:
+ *    - `--key=value`: long option with equals sign assignment
+ *    - `--no-key`: long option negation form (boolean false)
+ *    - `--key value`: long option followed by value
+ *    - `-abc`: short option combination (each letter is a separate option)
+ *    - Bare values: stored in argv._ array
+ * 4. Default value filling: fill default values for keys that did not appear
+ * 5. Non-option argument handling: based on '--' option, store in argv['--'] or argv._
+ *
+ * Security: automatically skips __proto__ and constructor properties, preventing prototype chain pollution.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseArgv = parseArgv;
+/**
+ * Check if an object has the specified nested key path
+ *
+ * Traverses down the key path, only checking key existence at the last level (not retrieving value).
+ *
+ * @param obj - Target object
+ * @param keys - Key path array (e.g. ['a', 'b', 'c'])
+ * @returns true if the key path exists
+ */
 function hasKey(obj, keys) {
     let o = obj;
+    // Traverse to second-to-last level, retrieving values
     keys.slice(0, -1).forEach(function (key) {
         o = o[key] || {};
     });
@@ -11,19 +41,54 @@ function hasKey(obj, keys) {
         return false;
     return key in o;
 }
+/**
+ * Determine if a string is in numeric format
+ *
+ * Supports hexadecimal (0x prefix), decimal integers and decimals, scientific notation.
+ *
+ * @param x - String to check
+ * @returns true if the string is a valid numeric format
+ */
 function isNumber(x) {
-    if (typeof x === 'number')
-        return true;
     if (/^0x[0-9a-f]+$/i.test(x))
         return true;
     return /^[-+]?(?:\d+(?:\.\d*)?|\.\d+)(e[-+]?\d+)?$/.test(x);
 }
+/**
+ * Detect if a key name is constructor or __proto__
+ *
+ * Used to prevent prototype chain pollution attacks; these special properties should not be set.
+ *
+ * @param obj - Target object
+ * @param key - Key name
+ * @returns true if the key is a dangerous property
+ */
 function isConstructorOrProto(obj, key) {
     return (key === 'constructor' && typeof obj[key] === 'function') || key === '__proto__';
 }
+/**
+ * Parse command line argument array
+ *
+ * Parses a process.argv-style string array into a structured key-value object.
+ *
+ * @param args - Argument array (typically process.argv.slice(2))
+ * @param opts - Parsing options
+ * @returns Parsed result object
+ *
+ * @example
+ * ```ts
+ * parseArgv(['--name=foo', '-p', '8080', '--verbose', 'file.txt'], {
+ *   boolean: ['verbose'],
+ *   alias: { p: 'port' },
+ *   string: ['name'],
+ * })
+ * // => { _: ['file.txt'], name: 'foo', port: 8080, verbose: true }
+ * ```
+ */
 function parseArgv(args, opts) {
     if (!opts)
         opts = {};
+    // Step 1: Build flag mapping, recording which parameters are boolean or string type
     const flags = {
         bools: {},
         strings: {},
@@ -32,20 +97,30 @@ function parseArgv(args, opts) {
     if (typeof opts.unknown === 'function') {
         flags.unknownFn = opts.unknown;
     }
+    // When boolean option is true, all --flag form arguments are treated as boolean
     if (typeof opts.boolean === 'boolean' && opts.boolean) {
         flags.allBools = true;
     }
     else {
+        // Otherwise only mark specified parameter names as boolean
         [].concat(opts.boolean || []).filter(Boolean).forEach(function (key) {
             flags.bools[key] = true;
         });
     }
+    // Step 2: Build bidirectional alias mapping
     const aliases = {};
+    /**
+     * Check if any alias of the specified key is boolean
+     *
+     * @param key - Parameter key name
+     * @returns true if any alias of the key is boolean
+     */
     function aliasIsBoolean(key) {
         return aliases[key]?.some(function (x) {
             return flags.bools[x];
         }) ?? false;
     }
+    // Build bidirectional alias mapping: each alias can map to all other aliases and the original key
     const aliasOpts = opts.alias || {};
     Object.keys(aliasOpts).forEach(function (key) {
         const aliasValue = aliasOpts[key];
@@ -54,12 +129,14 @@ function parseArgv(args, opts) {
         const aliasList = [].concat(aliasValue);
         aliases[key] = aliasList;
         aliasList.forEach(function (x) {
+            // Each alias maps to the original key + other aliases (excluding itself)
             const filtered = aliasList.filter(function (y) {
                 return x !== y;
             });
             aliases[x] = [key].concat(filtered);
         });
     });
+    // Step 3: Mark string options in the flag mapping (aliases also need to be synced)
     const stringOpts = opts.string || [];
     const stringList = [].concat(stringOpts).filter(Boolean);
     stringList.forEach(function (key) {
@@ -70,23 +147,47 @@ function parseArgv(args, opts) {
             });
         }
     });
+    // Step 4: Extract default values, fill after parsing is complete
     const defaults = opts.default || {};
+    // Initialize result object
     const argv = { _: [] };
+    /**
+     * Determine if a parameter key has been defined (via flags or aliases)
+     *
+     * @param key - Parameter key name
+     * @param arg - Original argument string
+     * @returns true if the key has been declared
+     */
     function argDefined(key, arg) {
-        return ((!!flags.allBools && /^--[^=]+$/.test(arg)) ||
+        return (
+        // In allBools mode, --flag form arguments are all considered defined
+        (!!flags.allBools && /^--[^=]+$/.test(arg)) ||
             !!flags.strings[key] ||
             !!flags.bools[key] ||
             !!aliases[key]);
     }
+    /**
+     * Set a value along a nested key path
+     *
+     * Supports dot-separated nested properties, e.g. 'a.b.c' -> obj.a.b.c = value.
+     * If the value already exists, repeated arguments with the same key are collected as an array.
+     *
+     * @param obj - Target object
+     * @param keys - Key path array
+     * @param value - Value to set
+     */
     function setKey(obj, keys, value) {
         let o = obj;
         for (let i = 0; i < keys.length - 1; i++) {
             const key = keys[i];
+            // Skip dangerous properties, preventing prototype chain pollution
             if (!key || isConstructorOrProto(o, key))
                 return;
+            // Auto-create object if intermediate level doesn't exist
             if (o[key] === undefined)
                 o[key] = {};
             const oValue = o[key];
+            // Prevent overwriting built-in prototype objects
             if (oValue === Object.prototype ||
                 oValue === Number.prototype ||
                 oValue === String.prototype) {
@@ -97,6 +198,7 @@ function parseArgv(args, opts) {
             o = o[key];
         }
         const lastKey = keys[keys.length - 1];
+        // Last level also checks for dangerous properties
         if (!lastKey || isConstructorOrProto(o, lastKey))
             return;
         if (o === Object.prototype || o === Number.prototype || o === String.prototype) {
@@ -105,40 +207,58 @@ function parseArgv(args, opts) {
         if (o === Array.prototype)
             o = {};
         if (o[lastKey] === undefined || flags.bools[lastKey] || typeof o[lastKey] === 'boolean') {
+            // First assignment or boolean parameter: set directly
             o[lastKey] = value;
         }
         else if (Array.isArray(o[lastKey])) {
+            // Existing array: append value
             o[lastKey].push(value);
         }
         else {
+            // Existing single value: convert to array
             o[lastKey] = [o[lastKey], value];
         }
     }
+    /**
+     * Set parameter value and sync to all aliases
+     *
+     * @param key - Parameter key name
+     * @param val - Parameter value
+     * @param arg - Original argument string (for unknown check)
+     */
     function setArg(key, val, arg) {
+        // Unknown argument check: if argument is undeclared and unknown function returns false, skip it
         if (arg && flags.unknownFn && !argDefined(key, arg)) {
             if (flags.unknownFn(arg) === false)
                 return;
         }
+        // Non-string-type parameters with numeric format values are auto-converted to numbers
         const value = !flags.strings[key] && isNumber(val) ? Number(val) : val;
         setKey(argv, key.split('.'), value);
+        // Sync value to all aliases
         (aliases[key] || []).forEach(function (x) {
             setKey(argv, x.split('.'), value);
         });
     }
+    // Step 5: Pre-set default values for boolean parameters (false when unspecified)
     Object.keys(flags.bools).forEach(function (key) {
         setArg(key, defaults[key] === undefined ? false : defaults[key]);
     });
     let notFlags = [];
+    // Step 6: Split arguments before and after '--'
     const dashIndex = args.indexOf('--');
     if (dashIndex !== -1) {
+        // All arguments after '--' are treated as non-option arguments
         notFlags = args.slice(dashIndex + 1);
         args = args.slice(0, dashIndex);
     }
+    // Step 7: Parse arguments item by item
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
         if (!arg)
             continue;
         let next;
+        // Case 1: --key=value long option with equals sign assignment
         if (/^--.+?=/.test(arg)) {
             const m = arg.match(/^--([^=]+)=([\s\S]*)$/);
             if (!m)
@@ -147,12 +267,14 @@ function parseArgv(args, opts) {
             if (!argKey)
                 continue;
             let value = m[2];
+            // Boolean parameter values only recognize true/false
             if (flags.bools[argKey]) {
                 value = value !== 'false' ? 'true' : 'false';
             }
             setArg(argKey, value, arg);
         }
         else if (/^--no-.+/.test(arg)) {
+            // Case 2: --no-key negation form, equivalent to --key=false
             const m = arg.match(/^--no-(.+)$/);
             if (!m)
                 continue;
@@ -162,6 +284,7 @@ function parseArgv(args, opts) {
             setArg(argKey, false, arg);
         }
         else if (/^--.+/.test(arg)) {
+            // Case 3: --key [value] long option followed by optional value
             const m = arg.match(/^--(.+)$/);
             if (!m)
                 continue;
@@ -174,18 +297,22 @@ function parseArgv(args, opts) {
                 !flags.bools[argKey] &&
                 !flags.allBools &&
                 (aliases[argKey] ? !aliasIsBoolean(argKey) : true)) {
+                // Next argument is a value, not a new option
                 setArg(argKey, next, arg);
                 i += 1;
             }
             else if (next && /^(true|false)$/.test(next)) {
+                // Explicit boolean value
                 setArg(argKey, next === 'true', arg);
                 i += 1;
             }
             else {
+                // No value: string type set to empty string, boolean type set to true
                 setArg(argKey, flags.strings[argKey] ? '' : true, arg);
             }
         }
         else if (/^-[^-]+/.test(arg)) {
+            // Case 4: -abc short option combination
             const letters = arg.slice(1, -1).split('');
             let broken = false;
             for (let j = 0; j < letters.length; j++) {
@@ -197,11 +324,13 @@ function parseArgv(args, opts) {
                     setArg(letter, next, arg);
                     continue;
                 }
+                // -a=value form
                 if (/[A-Za-z]/.test(letter) && next && next[0] === '=') {
                     setArg(letter, next.slice(1), arg);
                     broken = true;
                     break;
                 }
+                // -a123 form (letter followed by digits)
                 if (/[A-Za-z]/.test(letter) && next && /-?\d+(\.\d*)?(e-?\d+)?$/.test(next)) {
                     setArg(letter, next, arg);
                     broken = true;
@@ -209,14 +338,17 @@ function parseArgv(args, opts) {
                 }
                 const nextLetter = letters[j + 1];
                 if (nextLetter && nextLetter.match(/\W/)) {
+                    // Non-alphanumeric character treated as start of value
                     setArg(letter, arg.slice(j + 2), arg);
                     broken = true;
                     break;
                 }
                 else {
+                    // Regular short option flag
                     setArg(letter, flags.strings[letter] ? '' : true, arg);
                 }
             }
+            // Handle the last character of a short option combination, which may need the next argument as value
             const lastChar = arg.slice(-1);
             const shortKey = lastChar;
             if (!broken && shortKey !== '-') {
@@ -238,15 +370,18 @@ function parseArgv(args, opts) {
             }
         }
         else {
+            // Case 5: bare value argument, store in _ array
             if (!flags.unknownFn || flags.unknownFn(arg) !== false) {
                 argv._.push((flags.strings._ || !isNumber(arg) ? arg : Number(arg)));
             }
+            // In stopEarly mode, all subsequent arguments go into _ array
             if (opts.stopEarly) {
                 argv._.push.apply(argv._, args.slice(i + 1));
                 break;
             }
         }
     }
+    // Step 8: Fill default values (only for keys not present in parsing)
     Object.keys(defaults).forEach(function (k) {
         if (!hasKey(argv, k.split('.'))) {
             setKey(argv, k.split('.'), defaults[k]);
@@ -255,10 +390,13 @@ function parseArgv(args, opts) {
             });
         }
     });
+    // Step 9: Handle non-option arguments after '--' separator
     if (opts['--']) {
+        // Store in dedicated argv['--'] array
         argv['--'] = notFlags.slice();
     }
     else {
+        // Append to _ array
         notFlags.forEach(function (k) {
             argv._.push(k);
         });

package/dist/cjs/utils/pargv.js.map

@@ -1 +1 @@
-{"version":3,"file":"pargv.js","sourceRoot":"","sources":["../../../src/utils/pargv.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pargv.js","sourceRoot":"","sources":["../../../src/utils/pargv.ts"],"names":[],"mappings":"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"}

package/dist/cjs/utils/port/index.d.ts

@@ -1,6 +1,48 @@
+/** getPort function options */
 export interface GetPortOptions {
+    /**
+     * Preferred port number or port range array.
+     * - Number: try specified port, increment if unavailable
+     * - Array: try in order, OS auto-assigns if all unavailable
+     * - Unspecified: OS auto-assigns a random available port
+     */
     port?: number | number[];
+    /** Bound host address; if unspecified, checks all interfaces */
     host?: string;
 }
+/**
+ * Get an available TCP port
+ *
+ * Finds an available port within the specified range, with a two-level locking mechanism
+ * to prevent concurrent allocation conflicts.
+ * Search flow:
+ * 1. Try binding one by one according to the port check sequence
+ * 2. Check if the port is in the locked set (old or young)
+ * 3. On lock conflict: if a specific port was requested, throw Locked; otherwise auto-get a new port
+ * 4. After finding an available port, add it to the young locked set and return
+ *
+ * @param options - Port search options
+ * @returns Available port number
+ * @throws Error - Throws when all ports are unavailable
+ *
+ * @example
+ * ```ts
+ * // Get a system auto-assigned random port
+ * const port = await getPort();
+ *
+ * // Try a specific port, auto-find next if unavailable
+ * const port = await getPort({ port: 3000 });
+ *
+ * // Try multiple candidate ports
+ * const port = await getPort({ port: [3000, 3001, 3002] });
+ * ```
+ */
 export declare function getPort(options?: GetPortOptions): Promise<number>;
+/**
+ * Clean up port lock resources
+ *
+ * Clears the rotation timer and releases all locked ports.
+ * Call during application shutdown to ensure resources are cleaned up, preventing timer leaks.
+ */
+export declare function releasePortLocks(): void;
 //# sourceMappingURL=index.d.ts.map