ee-core 4.1.5 → 5.0.0-beta.5

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/port/index.ts"],"names":[],"mappings":"AA4JA,+BAA+B;AAC/B,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAkDvE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAOvC"}

package/dist/cjs/utils/port/index.js

@@ -0,0 +1,235 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPort = getPort;
+exports.releasePortLocks = releasePortLocks;
+/**
+ * @module utils/port
+ * @description Port allocation utility. Provides getPort() function to find available TCP ports
+ * within a specified range, with a locking mechanism to prevent concurrent port conflicts
+ * within the same process.
+ *
+ * Port allocation strategy:
+ * 1. Create a temporary TCP server listening on the target port to verify availability
+ * 2. Check if the port is in the locked set (prevents concurrent allocation of the same port)
+ * 3. If the port is unavailable or locked, automatically increment the port number and retry
+ * 4. Port 0 means let the OS automatically assign a random available port
+ *
+ * Locking mechanism:
+ * - Uses old and young Sets to maintain allocated ports
+ * - Rotates every 15 seconds: young -> old, old is cleared and released
+ * - Two-level locking ensures ports are not re-allocated shortly after being assigned
+ * - Call releasePortLocks() to manually clear all locks
+ */
+const net_1 = __importDefault(require("net"));
+const os_1 = __importDefault(require("os"));
+/**
+ * Port locked error
+ *
+ * Thrown when the specified port is locked (in use).
+ */
+class Locked extends Error {
+    constructor(port) {
+        super(`${port} is locked`);
+    }
+}
+/** Locked port sets, split into old and young levels */
+const lockedPorts = {
+    /** Previously locked ports, about to be released */
+    old: new Set(),
+    /** Currently locked ports */
+    young: new Set(),
+};
+/**
+ * Port lock rotation interval (ms)
+ *
+ * Every this interval, the old set is discarded (ports released),
+ * the young set moves into old, and a new young set is created.
+ * Two-level rotation ensures ports are locked for at least 15 seconds.
+ */
+const releaseOldLockedPortsIntervalMs = 1000 * 15;
+/** Rotation timer reference, lazily created to avoid resource usage when idle */
+let interval;
+/**
+ * Get all local network interface addresses
+ *
+ * Collects IP addresses of all network interfaces, and adds undefined (represents using default host)
+ * and '0.0.0.0' (represents listening on all IPv4 interfaces).
+ * When host is not specified, port availability needs to be verified on all interfaces.
+ *
+ * @returns Set of host addresses
+ */
+const getLocalHosts = () => {
+    const interfaces = os_1.default.networkInterfaces();
+    // undefined lets createServer use default host;
+    // '0.0.0.0' is IPv4 wildcard address, prevents createServer defaulting to IPv6
+    const results = new Set([undefined, '0.0.0.0']);
+    for (const _interface of Object.values(interfaces)) {
+        if (!_interface)
+            continue;
+        for (const config of _interface) {
+            results.add(config.address);
+        }
+    }
+    return results;
+};
+/**
+ * Check if a single port is available on the specified host
+ *
+ * Creates a temporary TCP server to attempt listening; if successful, the port is available;
+ * if failed, the port is occupied. Uses server.unref() to ensure the temporary server
+ * doesn't prevent process exit.
+ *
+ * @param options - net.ListenOptions, containing port and host
+ * @returns Available port number
+ */
+const checkAvailablePort = (options) => new Promise((resolve, reject) => {
+    const server = net_1.default.createServer();
+    // Don't prevent process exit
+    server.unref();
+    server.on('error', reject);
+    server.listen(options, () => {
+        const address = server.address();
+        const port = typeof address === 'string' ? 0 : address?.port || 0;
+        server.close(() => {
+            resolve(port);
+        });
+    });
+});
+/**
+ * Verify port availability across multiple hosts
+ *
+ * When host is not specified, port availability must be verified on each local network interface
+ * individually, ensuring the port is not occupied on any interface.
+ * EADDRNOTAVAIL and EINVAL errors indicate the interface doesn't support this port and can be skipped.
+ *
+ * @param options - Listen options
+ * @param hosts - Host address set
+ * @returns Available port number
+ */
+const getAvailablePort = async (options, hosts) => {
+    // When host is specified or port is 0 (OS auto-assign), only need to check once
+    if (options.host || options.port === 0) {
+        return checkAvailablePort(options);
+    }
+    // When host is not specified, verify on all interfaces individually
+    for (const host of hosts) {
+        try {
+            await checkAvailablePort({ port: options.port, host });
+        }
+        catch (error) {
+            const err = error;
+            // Address unavailable or invalid: this interface doesn't support this port, skip and continue checking
+            if (!['EADDRNOTAVAIL', 'EINVAL'].includes(err.code || '')) {
+                throw error;
+            }
+        }
+    }
+    return options.port || 0;
+};
+/**
+ * Generate port check sequence
+ *
+ * Tries user-specified port list in order; if all are unavailable, falls back to port 0
+ * (OS auto-assigns a random available port).
+ *
+ * @param ports - User-specified port list
+ * @yields Port number to check
+ */
+function* portCheckSequence(ports) {
+    if (ports) {
+        for (const port of ports) {
+            yield port;
+        }
+    }
+    // When all specified ports are unavailable, fall back to OS auto-assign
+    yield 0;
+}
+/**
+ * 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] });
+ * ```
+ */
+async function getPort(options) {
+    let ports;
+    if (options) {
+        ports = typeof options.port === 'number' ? [options.port] : options.port;
+    }
+    // Lazily create rotation timer, initialize on first call
+    if (interval === undefined) {
+        interval = setInterval(() => {
+            // Rotate locked sets: young -> old, old is cleared and released
+            lockedPorts.old = lockedPorts.young;
+            lockedPorts.young = new Set();
+        }, releaseOldLockedPortsIntervalMs);
+        // unref ensures the timer doesn't prevent process exit (Electron/Jest environments may not have unref)
+        if (interval.unref) {
+            interval.unref();
+        }
+    }
+    const hosts = getLocalHosts();
+    for (const port of portCheckSequence(ports)) {
+        try {
+            let availablePort = await getAvailablePort({ ...options, port }, hosts);
+            // Check if port is in locked set, preventing concurrent allocation of the same port
+            while (lockedPorts.old.has(availablePort) || lockedPorts.young.has(availablePort)) {
+                // Specified port number is locked -> throw exception to let caller know
+                if (port !== 0) {
+                    throw new Locked(port);
+                }
+                // OS auto-assigned port is locked -> request a new one
+                availablePort = await getAvailablePort({ ...options, port: 0 }, hosts);
+            }
+            // Found available port, add to young locked set
+            lockedPorts.young.add(availablePort);
+            return availablePort;
+        }
+        catch (error) {
+            const err = error;
+            // EADDRINUSE (port occupied) and EACCES (insufficient permissions) are expected errors, try next port
+            if (!['EADDRINUSE', 'EACCES'].includes(err.code || '') && !(error instanceof Locked)) {
+                throw error;
+            }
+        }
+    }
+    throw new Error('No available ports found');
+}
+/**
+ * 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.
+ */
+function releasePortLocks() {
+    if (interval !== undefined) {
+        clearInterval(interval);
+        interval = undefined;
+    }
+    lockedPorts.old.clear();
+    lockedPorts.young.clear();
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/utils/port/index.js.map

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

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

@@ -0,0 +1,88 @@
+/**
+ * @module utils/type_check
+ * @description Runtime type checking utility. Provides a set of Type Guard functions
+ * for determining value types at runtime, used with TypeScript's type narrowing.
+ *
+ * Difference from utils/is.ts: is.ts detects Electron runtime environment (process type, OS),
+ * while this module detects JavaScript value types (functions, classes, objects, etc.).
+ */
+/**
+ * Determine if a value is a function
+ *
+ * Covers all callable types including regular functions, arrow functions, class constructors, and async functions.
+ *
+ * @param val - Value to check
+ * @returns true if the value is a function type, TypeScript will also narrow val to function type
+ */
+export declare function isFunction(val: unknown): val is (...args: unknown[]) => unknown;
+/**
+ * Determine if a value is an ES6 class
+ *
+ * Primary check is structural: an ES6 class has a non-writable `prototype`
+ * (writable: false), whereas a regular function's prototype is writable, and
+ * arrow/async functions have no prototype at all. This reads the runtime object
+ * shape rather than source text, so it survives minify and bytecode (.jsc) compilation.
+ *
+ * Fallback check keeps the previous behavior: sniff the toString() output for a
+ * leading `class` keyword, covering any edge case the structural check misses.
+ * Note: constructor functions declared with function are not recognized as classes.
+ *
+ * @param val - Value to check
+ * @returns true if the value is a class declared with class
+ */
+export declare function isClass(val: unknown): val is new (...args: unknown[]) => unknown;
+/**
+ * Determine if a value is a string
+ *
+ * @param val - Value to check
+ * @returns true if the value is of type string
+ */
+export declare function isString(val: unknown): val is string;
+/**
+ * Determine if a value is a plain object
+ *
+ * A plain object is one created via {} or new Object().
+ * Excludes null, arrays, and class instances.
+ *
+ * @param val - Value to check
+ * @returns true if the value is a non-null, non-array ordinary object
+ */
+export declare function isObject(val: unknown): val is Record<string, unknown>;
+/**
+ * Determine if a value is an array
+ *
+ * @param val - Value to check
+ * @returns true if the value is an Array instance
+ */
+export declare function isArray(val: unknown): val is unknown[];
+/**
+ * Determine if a value is a primitive type
+ *
+ * Primitive types include: null, undefined, string, number, boolean, symbol, bigint.
+ * That is, values that are neither objects nor functions.
+ *
+ * @param val - Value to check
+ * @returns true if the value is a primitive type
+ */
+export declare function isPrimitive(val: unknown): boolean;
+/**
+ * Determine if a value is a generator function (function*)
+ *
+ * Determines by checking if the function constructor's name is 'GeneratorFunction'.
+ * Generator functions are declared with function* and return Generator objects.
+ *
+ * @param val - Value to check
+ * @returns true if the value is a generator function
+ */
+export declare function isGeneratorFunction(val: unknown): boolean;
+/**
+ * Determine if a value is an async function (async function)
+ *
+ * Determines by checking if the function constructor's name is 'AsyncFunction'.
+ * Async functions are declared with the async keyword and return Promises.
+ *
+ * @param val - Value to check
+ * @returns true if the value is an async function
+ */
+export declare function isAsyncFunction(val: unknown): boolean;
+//# sourceMappingURL=type_check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"type_check.d.ts","sourceRoot":"","sources":["../../../src/utils/type_check.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAE/E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAOhF;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAEpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,OAAO,EAAE,CAEtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAErD"}

package/dist/cjs/utils/type_check.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * @module utils/type_check
+ * @description Runtime type checking utility. Provides a set of Type Guard functions
+ * for determining value types at runtime, used with TypeScript's type narrowing.
+ *
+ * Difference from utils/is.ts: is.ts detects Electron runtime environment (process type, OS),
+ * while this module detects JavaScript value types (functions, classes, objects, etc.).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isFunction = isFunction;
+exports.isClass = isClass;
+exports.isString = isString;
+exports.isObject = isObject;
+exports.isArray = isArray;
+exports.isPrimitive = isPrimitive;
+exports.isGeneratorFunction = isGeneratorFunction;
+exports.isAsyncFunction = isAsyncFunction;
+/**
+ * Determine if a value is a function
+ *
+ * Covers all callable types including regular functions, arrow functions, class constructors, and async functions.
+ *
+ * @param val - Value to check
+ * @returns true if the value is a function type, TypeScript will also narrow val to function type
+ */
+function isFunction(val) {
+    return typeof val === 'function';
+}
+/**
+ * Determine if a value is an ES6 class
+ *
+ * Primary check is structural: an ES6 class has a non-writable `prototype`
+ * (writable: false), whereas a regular function's prototype is writable, and
+ * arrow/async functions have no prototype at all. This reads the runtime object
+ * shape rather than source text, so it survives minify and bytecode (.jsc) compilation.
+ *
+ * Fallback check keeps the previous behavior: sniff the toString() output for a
+ * leading `class` keyword, covering any edge case the structural check misses.
+ * Note: constructor functions declared with function are not recognized as classes.
+ *
+ * @param val - Value to check
+ * @returns true if the value is a class declared with class
+ */
+function isClass(val) {
+    if (typeof val !== 'function')
+        return false;
+    // Primary: structural check (immune to minify / bytecode compilation)
+    const desc = Object.getOwnPropertyDescriptor(val, 'prototype');
+    if (desc && desc.writable === false)
+        return true;
+    // Fallback: source-string sniffing (preserves prior behavior)
+    return /^\s*class\b/.test(val.toString());
+}
+/**
+ * Determine if a value is a string
+ *
+ * @param val - Value to check
+ * @returns true if the value is of type string
+ */
+function isString(val) {
+    return typeof val === 'string';
+}
+/**
+ * Determine if a value is a plain object
+ *
+ * A plain object is one created via {} or new Object().
+ * Excludes null, arrays, and class instances.
+ *
+ * @param val - Value to check
+ * @returns true if the value is a non-null, non-array ordinary object
+ */
+function isObject(val) {
+    return typeof val === 'object' && val !== null && !Array.isArray(val);
+}
+/**
+ * Determine if a value is an array
+ *
+ * @param val - Value to check
+ * @returns true if the value is an Array instance
+ */
+function isArray(val) {
+    return Array.isArray(val);
+}
+/**
+ * Determine if a value is a primitive type
+ *
+ * Primitive types include: null, undefined, string, number, boolean, symbol, bigint.
+ * That is, values that are neither objects nor functions.
+ *
+ * @param val - Value to check
+ * @returns true if the value is a primitive type
+ */
+function isPrimitive(val) {
+    return val === null || (typeof val !== 'object' && typeof val !== 'function');
+}
+/**
+ * Determine if a value is a generator function (function*)
+ *
+ * Determines by checking if the function constructor's name is 'GeneratorFunction'.
+ * Generator functions are declared with function* and return Generator objects.
+ *
+ * @param val - Value to check
+ * @returns true if the value is a generator function
+ */
+function isGeneratorFunction(val) {
+    return typeof val === 'function' && val.constructor?.name === 'GeneratorFunction';
+}
+/**
+ * Determine if a value is an async function (async function)
+ *
+ * Determines by checking if the function constructor's name is 'AsyncFunction'.
+ * Async functions are declared with the async keyword and return Promises.
+ *
+ * @param val - Value to check
+ * @returns true if the value is an async function
+ */
+function isAsyncFunction(val) {
+    return typeof val === 'function' && val.constructor?.name === 'AsyncFunction';
+}
+//# sourceMappingURL=type_check.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"type_check.js","sourceRoot":"","sources":["../../../src/utils/type_check.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAUH,gCAEC;AAiBD,0BAOC;AAQD,4BAEC;AAWD,4BAEC;AAQD,0BAEC;AAWD,kCAEC;AAWD,kDAEC;AAWD,0CAEC;AA1GD;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAC,GAAY;IACrC,OAAO,OAAO,GAAG,KAAK,UAAU,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,OAAO,CAAC,GAAY;IAClC,IAAI,OAAO,GAAG,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAC5C,sEAAsE;IACtE,MAAM,IAAI,GAAG,MAAM,CAAC,wBAAwB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC/D,IAAI,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACjD,8DAA8D;IAC9D,OAAO,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CAAC,GAAY;IACnC,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,QAAQ,CAAC,GAAY;IACnC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,OAAO,CAAC,GAAY;IAClC,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,WAAW,CAAC,GAAY;IACtC,OAAO,GAAG,KAAK,IAAI,IAAI,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,UAAU,CAAC,CAAC;AAChF,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CAAC,GAAY;IAC9C,OAAO,OAAO,GAAG,KAAK,UAAU,IAAI,GAAG,CAAC,WAAW,EAAE,IAAI,KAAK,mBAAmB,CAAC;AACpF,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,eAAe,CAAC,GAAY;IAC1C,OAAO,OAAO,GAAG,KAAK,UAAU,IAAI,GAAG,CAAC,WAAW,EAAE,IAAI,KAAK,eAAe,CAAC;AAChF,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Convert file path to property path array
+ *
+ * Determines property name naming style based on caseStyle configuration.
+ * Supports preset styles (lower/upper/camel) and fully custom conversion functions.
+ *
+ * @param filepath - Relative file path (e.g. 'a/b/c.js')
+ * @param options - Conversion options
+ * @param options.caseStyle - Naming style: 'lower' (first letter lowercase), 'upper' (first letter uppercase),
+ *   'camel' (camelCase, default) or custom conversion function
+ * @returns Property path array (e.g. ['a', 'b', 'c'])
+ * @throws Error - Throws when caseStyle is a function but return value is not an array
+ */
+export declare function getProperties(filepath: string, { caseStyle }: {
+    caseStyle: string | ((filepath: string) => string[]);
+}): string[];
+/**
+ * Default camelCase conversion implementation
+ *
+ * Processing flow:
+ * 1. Remove file extension, split by '/' into path segments
+ * 2. For each path segment: capitalize letters after underscores/hyphens (e.g. foo_bar -> fooBar)
+ * 3. Adjust first letter case based on caseStyle
+ *
+ * @param filepath - Relative file path
+ * @param caseStyle - Naming style
+ * @returns Property path array
+ * @throws Error - Throws when path segment contains illegal characters (not a-z0-9_-)
+ */
+export declare function defaultCamelize(filepath: string, caseStyle: string): string[];
+//# sourceMappingURL=wrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../../src/utils/wrap.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC,CAAA;CAAE,GAAG,MAAM,EAAE,CAWjI;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAgC7E"}

package/dist/cjs/utils/wrap.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProperties = getProperties;
+exports.defaultCamelize = defaultCamelize;
+/**
+ * @module utils/wrap
+ * @description File path to property path conversion utility. Converts directory/file paths
+ * to nested property name arrays for use by FileLoader to build nested object structures.
+ *
+ * Conversion examples:
+ * ```
+ * 'a/b/c.js' -> ['a', 'b', 'c']
+ * 'user_info.js' -> ['userInfo'] (caseStyle='camel')
+ * 'UserInfo.js' -> ['userInfo'] (caseStyle='lower')
+ * ```
+ */
+const type_check_js_1 = require("./type_check.js");
+/**
+ * Convert file path to property path array
+ *
+ * Determines property name naming style based on caseStyle configuration.
+ * Supports preset styles (lower/upper/camel) and fully custom conversion functions.
+ *
+ * @param filepath - Relative file path (e.g. 'a/b/c.js')
+ * @param options - Conversion options
+ * @param options.caseStyle - Naming style: 'lower' (first letter lowercase), 'upper' (first letter uppercase),
+ *   'camel' (camelCase, default) or custom conversion function
+ * @returns Property path array (e.g. ['a', 'b', 'c'])
+ * @throws Error - Throws when caseStyle is a function but return value is not an array
+ */
+function getProperties(filepath, { caseStyle }) {
+    // When caseStyle is a function, delegate entirely to the caller's custom conversion logic
+    if ((0, type_check_js_1.isFunction)(caseStyle)) {
+        const result = caseStyle(filepath);
+        if (!Array.isArray(result)) {
+            throw new Error(`caseStyle expect an array, but got ${result}`);
+        }
+        return result;
+    }
+    // Use built-in camelCase conversion rules
+    return defaultCamelize(filepath, caseStyle);
+}
+/**
+ * Default camelCase conversion implementation
+ *
+ * Processing flow:
+ * 1. Remove file extension, split by '/' into path segments
+ * 2. For each path segment: capitalize letters after underscores/hyphens (e.g. foo_bar -> fooBar)
+ * 3. Adjust first letter case based on caseStyle
+ *
+ * @param filepath - Relative file path
+ * @param caseStyle - Naming style
+ * @returns Property path array
+ * @throws Error - Throws when path segment contains illegal characters (not a-z0-9_-)
+ */
+function defaultCamelize(filepath, caseStyle) {
+    // Remove extension, split by path separator
+    const properties = filepath.substring(0, filepath.lastIndexOf('.')).split('/');
+    return properties.map((property) => {
+        // Validate path segment only contains legal characters
+        if (!/^[a-z][a-z0-9_-]*$/i.test(property)) {
+            throw new Error(`${property} is not match 'a-z0-9_-' in ${filepath}`);
+        }
+        // Underscore/hyphen to camelCase: foo_bar -> fooBar, foo-bar -> fooBar
+        const normalized = property.replace(/[_-][a-z]/gi, (s) => s.substring(1).toUpperCase());
+        const first = normalized[0];
+        if (!first)
+            return normalized;
+        // Adjust first letter based on caseStyle
+        let firstChar = first;
+        switch (caseStyle) {
+            case 'lower':
+                // First letter lowercase: FooBar -> fooBar (controllers use this style)
+                firstChar = first.toLowerCase();
+                break;
+            case 'upper':
+                // First letter uppercase: fooBar -> FooBar
+                firstChar = first.toUpperCase();
+                break;
+            case 'camel':
+            default:
+                // Keep as-is (camelCase)
+                break;
+        }
+        return firstChar + normalized.substring(1);
+    });
+}
+//# sourceMappingURL=wrap.js.map