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

package/dist/esm/lib/utils.d.ts

@@ -1,11 +1,65 @@
-export declare function loadConfig(binFile?: string): Record<string, unknown>;
+/**
+ * Core Utility Functions — config loading, file I/O, path handling
+ *
+ * This module is the heart of the ee-bin configuration system. It implements the
+ * full configuration loading pipeline:
+ *   loadConfig(binFile) → loads user ./cmd/bin.js
+ *     → loadFile(binFile) → parses .js/.json/.json5 config files
+ *     → extend(true, defaultConfig, userConfig) → deep merges with default config
+ *
+ * Also provides basic I/O utilities: JSON file read/write, directory deletion,
+ * and array normalization.
+ */
+import type { BinConfig } from '../types/config.js';
+/**
+ * Load and merge ee-bin configuration
+ *
+ * Two-phase merge strategy:
+ *   1. Load user config from ./cmd/bin.js (supports .js/.json/.json5 formats)
+ *   2. Deep merge user config on top of default config (user values override defaults)
+ *
+ * @param binFile - Custom config file path (defaults to './cmd/bin.js')
+ * @returns Fully merged BinConfig
+ */
+export declare function loadConfig(binFile?: string): BinConfig;
+/**
+ * Load a configuration file — supports .json5/.json/.js/.cjs formats
+ *
+ * Format-specific handling:
+ *   - .json5/.json: Read text content and parse with the json5 parser
+ *     (JSON5 supports comments, trailing commas, and other extended syntax)
+ *   - .js/.cjs: Load the module via require() and extract the export value
+ *     - If the export is a plain function (not a class), treat it as a config
+ *       factory function and call it to obtain the config object
+ *     - If the export is a class, use the class directly as config (do not call it)
+ *     - If the export is an ESModule (has a default property), extract the .default value
+ *
+ * @param filepath - Config file path (relative to project root)
+ * @returns Config object (Record<string, unknown>)
+ * @throws Error with path hint if the file does not exist
+ */
 export declare function loadFile(filepath: string): Record<string, unknown>;
+/** Recursively force-delete a directory or file (similar to rm -rf) */
 export declare function rm(name: string): void;
+/**
+ * Synchronously read a JSON file and parse it into an object
+ * @throws Error if the file does not exist
+ */
 export declare function readJsonSync(filepath: string, encoding?: BufferEncoding): Record<string, unknown>;
+/**
+ * Synchronously write a JSON file with auto-created directories and formatted output
+ *
+ * @param filepath - Target file path
+ * @param str - Data to write (objects are auto JSON.stringify'd; other types are converted to string)
+ * @param options - Optional parameters: space controls indentation (default 2), replacer controls serialization filtering
+ */
 export declare function writeJsonSync(filepath: string, str: unknown, options?: {
     space?: number;
     replacer?: (key: string, value: unknown) => unknown;
 }): void;
-export declare function getArgumentByName(name: string, args?: string[]): string | undefined;
-export declare function getPlatform(delimiter?: string, isDiffArch?: boolean): string;
+/**
+ * Normalize string | string[] | undefined to string[]
+ * Used to handle the "args" config field which accepts different input formats
+ */
+export declare function toArray(value?: string[] | string): string[];
 //# sourceMappingURL=utils.d.ts.map

package/dist/esm/lib/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils.ts"],"names":[],"mappings":"AAaA,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOpE;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBlE;AAED,wBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKrC;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzG;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;CAAE,GAAG,IAAI,CAerJ;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAanF;AAED,wBAAgB,WAAW,CAAC,SAAS,SAAM,EAAE,UAAU,UAAQ,GAAG,MAAM,CAavE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAMpD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAOtD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BlE;AAED,uEAAuE;AACvE,wBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKrC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzG;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;CAAE,GAAG,IAAI,CAgBrJ;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,EAAE,CAI3D"}

package/dist/esm/lib/utils.js

@@ -1,4 +1,16 @@
 "use strict";
+/**
+ * Core Utility Functions — config loading, file I/O, path handling
+ *
+ * This module is the heart of the ee-bin configuration system. It implements the
+ * full configuration loading pipeline:
+ *   loadConfig(binFile) → loads user ./cmd/bin.js
+ *     → loadFile(binFile) → parses .js/.json/.json5 config files
+ *     → extend(true, defaultConfig, userConfig) → deep merges with default config
+ *
+ * Also provides basic I/O utilities: JSON file read/write, directory deletion,
+ * and array normalization.
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -8,8 +20,7 @@ exports.loadFile = loadFile;
 exports.rm = rm;
 exports.readJsonSync = readJsonSync;
 exports.writeJsonSync = writeJsonSync;
-exports.getArgumentByName = getArgumentByName;
-exports.getPlatform = getPlatform;
+exports.toArray = toArray;
 const helpers_js_1 = require("./helpers.js");
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
@@ -21,6 +32,16 @@ const extend_js_1 = require("./extend.js");
 const log = (0, helpers_js_1.createDebug)('ee-bin:lib:utils');
 const _basePath = process.cwd();
 const userBin = './cmd/bin.js';
+/**
+ * Load and merge ee-bin configuration
+ *
+ * Two-phase merge strategy:
+ *   1. Load user config from ./cmd/bin.js (supports .js/.json/.json5 formats)
+ *   2. Deep merge user config on top of default config (user values override defaults)
+ *
+ * @param binFile - Custom config file path (defaults to './cmd/bin.js')
+ * @returns Fully merged BinConfig
+ */
 function loadConfig(binFile) {
     const binPath = binFile || userBin;
     const userConfig = loadFile(binPath);
@@ -28,6 +49,22 @@ function loadConfig(binFile) {
     log('[loadConfig] bin:%j', result);
     return result;
 }
+/**
+ * Load a configuration file — supports .json5/.json/.js/.cjs formats
+ *
+ * Format-specific handling:
+ *   - .json5/.json: Read text content and parse with the json5 parser
+ *     (JSON5 supports comments, trailing commas, and other extended syntax)
+ *   - .js/.cjs: Load the module via require() and extract the export value
+ *     - If the export is a plain function (not a class), treat it as a config
+ *       factory function and call it to obtain the config object
+ *     - If the export is a class, use the class directly as config (do not call it)
+ *     - If the export is an ESModule (has a default property), extract the .default value
+ *
+ * @param filepath - Config file path (relative to project root)
+ * @returns Config object (Record<string, unknown>)
+ * @throws Error with path hint if the file does not exist
+ */
 function loadFile(filepath) {
     const configFile = path_1.default.join(_basePath, filepath);
     if (!fs_1.default.existsSync(configFile)) {
@@ -42,30 +79,52 @@ function loadFile(filepath) {
     if (configFile.endsWith('.js') || configFile.endsWith('.cjs')) {
         // eslint-disable-next-line @typescript-eslint/no-require-imports -- dynamic user config loading
         const mod = require(configFile);
+        // Handle ESM default export: require() on an ESM module returns { default: ... }
         result = mod.default != null ? mod.default : mod;
     }
+    // Config factory pattern: if the export is a plain function (not a class),
+    // call it to obtain the config object. Classes are used directly because
+    // a class export is itself the config class, not a factory function.
     if (helpers_js_3.is.function(result) && !helpers_js_3.is.class(result)) {
         result = result();
     }
+    // Warn if the config file exports an unrecognized value (null, undefined, primitive)
+    // that will be treated as empty config — the user's config is effectively ignored.
+    if (result === null || result === undefined) {
+        console.log(helpers_js_2.chalk.yellow('[ee-bin] [loadFile] ') + `Warning: ${configFile} exports ${result}, treating as empty config`);
+    }
     return result || {};
 }
+/** Recursively force-delete a directory or file (similar to rm -rf) */
 function rm(name) {
     if (!fs_1.default.existsSync(name)) {
         return;
     }
     fs_1.default.rmSync(name, { recursive: true, force: true });
 }
+/**
+ * Synchronously read a JSON file and parse it into an object
+ * @throws Error if the file does not exist
+ */
 function readJsonSync(filepath, encoding = 'utf8') {
     if (!fs_1.default.existsSync(filepath)) {
         throw new Error(filepath + ' is not found');
     }
     return JSON.parse(fs_1.default.readFileSync(filepath, { encoding }));
 }
+/**
+ * Synchronously write a JSON file with auto-created directories and formatted output
+ *
+ * @param filepath - Target file path
+ * @param str - Data to write (objects are auto JSON.stringify'd; other types are converted to string)
+ * @param options - Optional parameters: space controls indentation (default 2), replacer controls serialization filtering
+ */
 function writeJsonSync(filepath, str, options) {
     const opt = options || {};
     if (!('space' in opt)) {
         opt.space = 2;
     }
+    // Auto-create target directory (prevents write failure from missing directory)
     fs_1.default.mkdirSync(path_1.default.dirname(filepath), { recursive: true });
     let data;
     if (typeof str === 'object') {
@@ -76,33 +135,15 @@ function writeJsonSync(filepath, str, options) {
     }
     fs_1.default.writeFileSync(filepath, data);
 }
-function getArgumentByName(name, args) {
-    if (!args) {
-        args = process.argv;
-    }
-    for (let i = 0; i < args.length; i++) {
-        const item = args[i];
-        if (!item)
-            continue;
-        const prefixKey = `--${name}=`;
-        if (item.indexOf(prefixKey) !== -1) {
-            return item.substring(prefixKey.length);
-        }
-    }
-    return undefined;
-}
-function getPlatform(delimiter = '_', isDiffArch = false) {
-    if (process.platform === 'win32') {
-        let os = 'windows';
-        if (isDiffArch) {
-            os += delimiter + (process.arch === 'x64' ? '64' : '32');
-        }
-        return os;
-    }
-    if (process.platform === 'darwin') {
-        const core = process.arch === 'arm64' ? 'apple' : 'intel';
-        return 'macos' + delimiter + core;
-    }
-    return 'linux';
+/**
+ * Normalize string | string[] | undefined to string[]
+ * Used to handle the "args" config field which accepts different input formats
+ */
+function toArray(value) {
+    if (typeof value === 'string')
+        return [value];
+    if (Array.isArray(value))
+        return value;
+    return [];
 }
 //# sourceMappingURL=utils.js.map

package/dist/esm/lib/utils.js.map

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

package/dist/esm/plugins/bundle_registry_plugin.d.ts

@@ -0,0 +1,33 @@
+/**
+ * esbuild Bundle-Registry Plugin — generates controller and config registries at build time
+ *
+ * This plugin is the core mechanism for Electron main process bundling. It scans the
+ * electron/controller/ and electron/config/ directories at build time and generates
+ * virtual modules that register all controllers and config modules, ensuring the bundled
+ * code can correctly locate them. The lazy getter design avoids initialization order issues.
+ *
+ * Three virtual modules are generated:
+ *   1. app:controller-registry → Scans electron/controller/, generates global.__EE_CONTROLLER_REGISTRY__
+ *   2. app:config-registry     → Scans electron/config/, generates global.__EE_CONFIG_REGISTRY__
+ *   3. app:bundle-entry        → Virtual entry point that loads in order: config registry → controller registry → main.js
+ *
+ * Why config loads before controller:
+ *   ee-core's ConfigLoader._loadConfig() needs __EE_CONFIG_REGISTRY__ to load configuration,
+ *   and ControllerLoader.load() needs __EE_CONTROLLER_REGISTRY__ to load controllers.
+ *   Config loading happens before controller loading (ElectronEgg lifecycle: loadConfig → loadController),
+ *   so registries must be injected in this order as well.
+ *
+ * How it works with ee-core:
+ *   - Bundle mode (global.__EE_CONTROLLER_REGISTRY__ exists) → FileLoader.parseFromRegistry() reads from the registry
+ *   - Dev mode (registry absent) → FileLoader falls back to globby filesystem scanning + require()
+ */
+import { Plugin } from 'esbuild';
+/**
+ * Create the esbuild bundle-registry plugin
+ *
+ * @param controllerDir - Absolute path to the electron/controller/ directory
+ * @param mainJsPath    - Absolute path to electron/main.js or main.ts (entry file)
+ * @param configDir     - Absolute path to the electron/config/ directory
+ */
+export declare function bundleRegistryPlugin(controllerDir: string, mainJsPath: string, configDir: string): Plugin;
+//# sourceMappingURL=bundle_registry_plugin.d.ts.map

package/dist/esm/plugins/bundle_registry_plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle_registry_plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/bundle_registry_plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,MAAM,EAAe,MAAM,SAAS,CAAC;AAgD9C;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,MAAM,CAwGR"}

package/dist/esm/plugins/bundle_registry_plugin.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * esbuild Bundle-Registry Plugin — generates controller and config registries at build time
+ *
+ * This plugin is the core mechanism for Electron main process bundling. It scans the
+ * electron/controller/ and electron/config/ directories at build time and generates
+ * virtual modules that register all controllers and config modules, ensuring the bundled
+ * code can correctly locate them. The lazy getter design avoids initialization order issues.
+ *
+ * Three virtual modules are generated:
+ *   1. app:controller-registry → Scans electron/controller/, generates global.__EE_CONTROLLER_REGISTRY__
+ *   2. app:config-registry     → Scans electron/config/, generates global.__EE_CONFIG_REGISTRY__
+ *   3. app:bundle-entry        → Virtual entry point that loads in order: config registry → controller registry → main.js
+ *
+ * Why config loads before controller:
+ *   ee-core's ConfigLoader._loadConfig() needs __EE_CONFIG_REGISTRY__ to load configuration,
+ *   and ControllerLoader.load() needs __EE_CONTROLLER_REGISTRY__ to load controllers.
+ *   Config loading happens before controller loading (ElectronEgg lifecycle: loadConfig → loadController),
+ *   so registries must be injected in this order as well.
+ *
+ * How it works with ee-core:
+ *   - Bundle mode (global.__EE_CONTROLLER_REGISTRY__ exists) → FileLoader.parseFromRegistry() reads from the registry
+ *   - Dev mode (registry absent) → FileLoader falls back to globby filesystem scanning + require()
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bundleRegistryPlugin = bundleRegistryPlugin;
+const globby_1 = require("globby");
+const path_1 = __importDefault(require("path"));
+/**
+ * Compute property paths from a file path, replicating ee-core's getProperties() + defaultCamelize(caseStyle: 'lower')
+ *
+ * Camelize rules (caseStyle: 'lower' means first character lowercase):
+ *   - Remove file extension: 'foo/bar.js' → 'foo/bar'
+ *   - Split by '/': 'foo/bar' → ['foo', 'bar']
+ *   - Apply camelCase conversion per segment: letter after underscore/hyphen is uppercased ('foo-bar' → 'fooBar')
+ *   - First character lowercase: 'FooBar' → 'fooBar'
+ *
+ * Example: 'foo_bar/my-controller.js' => ['fooBar', 'myController']
+ */
+function computeProperties(filepath) {
+    const properties = filepath.substring(0, filepath.lastIndexOf('.')).split('/');
+    return properties.map((property) => {
+        if (!/^[a-z][a-z0-9_-]*$/i.test(property)) {
+            throw new Error(`${property} is not match 'a-z0-9_-' in ${filepath}`);
+        }
+        // Convert underscore/hyphen separators to camelCase
+        const normalized = property.replace(/[_-][a-z]/gi, (s) => s.substring(1).toUpperCase());
+        const first = normalized[0];
+        if (!first)
+            return normalized;
+        // Ensure first character is lowercase (caseStyle: 'lower')
+        return first.toLowerCase() + normalized.substring(1);
+    });
+}
+/**
+ * Create the esbuild bundle-registry plugin
+ *
+ * @param controllerDir - Absolute path to the electron/controller/ directory
+ * @param mainJsPath    - Absolute path to electron/main.js or main.ts (entry file)
+ * @param configDir     - Absolute path to the electron/config/ directory
+ */
+function bundleRegistryPlugin(controllerDir, mainJsPath, configDir) {
+    return {
+        name: 'bundle-registry',
+        setup(build) {
+            let registryEntries = [];
+            let configEntries = [];
+            // Re-scan directories at the start of each build (supports file additions/deletions in rebuild/watch mode)
+            build.onStart(() => {
+                const controllerFiles = (0, globby_1.globbySync)(['**/*.js', '**/*.jsc', '**/*.ts'], { cwd: controllerDir });
+                registryEntries = controllerFiles.map((filepath) => ({
+                    fullpath: 'controller/' + filepath.replace(/\\/g, '/'),
+                    properties: computeProperties(filepath),
+                    relPath: filepath,
+                }));
+                const configFiles = (0, globby_1.globbySync)(['**/*.js', '**/*.jsc', '**/*.ts'], { cwd: configDir });
+                configEntries = configFiles.map((filepath) => ({
+                    // Remove extension from filename to match ee-core ConfigLoader's lookup logic:
+                    // ConfigLoader finds config by name (e.g. 'default'), not including the '.js' extension
+                    filename: filepath.replace(/\\/g, '/').substring(0, filepath.lastIndexOf('.')),
+                    relPath: filepath,
+                }));
+            });
+            // ─── Virtual module: controller registry ──────────────────────
+            build.onResolve({ filter: /^app:controller-registry$/ }, (args) => {
+                return { path: args.path, namespace: 'controller-registry' };
+            });
+            build.onLoad({ filter: /.*/, namespace: 'controller-registry' }, () => {
+                const lines = ['// Auto-generated controller registry - do not edit'];
+                lines.push('global.__EE_CONTROLLER_REGISTRY__ = [');
+                for (const [i, entry] of registryEntries.entries()) {
+                    const requirePath = JSON.stringify('./' + entry.relPath.replace(/\\/g, '/'));
+                    const comma = i < registryEntries.length - 1 ? ',' : '';
+                    // Use lazy getter (get module() { return require(...) }) instead of direct require()
+                    // to avoid executing all controller modules at registry load time, which could cause
+                    // initialization order issues. ee-core's FileLoader.parseFromRegistry() invokes the
+                    // getter only when the module is actually needed.
+                    lines.push(`  { fullpath: ${JSON.stringify(entry.fullpath)}, properties: ${JSON.stringify(entry.properties)}, get module() { return require(${requirePath}); } }${comma}`);
+                }
+                lines.push('];');
+                return {
+                    contents: lines.join('\n'),
+                    loader: 'js',
+                    // Set resolveDir to controllerDir so require() paths resolve relative to the controller directory
+                    resolveDir: controllerDir,
+                };
+            });
+            // ─── Virtual module: config registry ──────────────────────────
+            build.onResolve({ filter: /^app:config-registry$/ }, (args) => {
+                return { path: args.path, namespace: 'config-registry' };
+            });
+            build.onLoad({ filter: /.*/, namespace: 'config-registry' }, () => {
+                const lines = ['// Auto-generated config registry - do not edit'];
+                lines.push('global.__EE_CONFIG_REGISTRY__ = [');
+                for (const [i, entry] of configEntries.entries()) {
+                    const requirePath = JSON.stringify('./' + entry.relPath.replace(/\\/g, '/'));
+                    const comma = i < configEntries.length - 1 ? ',' : '';
+                    // Same as controller registry: use lazy getter to avoid loading config modules immediately
+                    lines.push(`  { filename: ${JSON.stringify(entry.filename)}, get module() { return require(${requirePath}); } }${comma}`);
+                }
+                lines.push('];');
+                return {
+                    contents: lines.join('\n'),
+                    loader: 'js',
+                    resolveDir: configDir,
+                };
+            });
+            // ─── Virtual module: bundle entry point ───────────────────────
+            build.onResolve({ filter: /^app:bundle-entry$/ }, (args) => {
+                return { path: args.path, namespace: 'bundle-entry' };
+            });
+            build.onLoad({ filter: /.*/, namespace: 'bundle-entry' }, () => {
+                const mainRelative = JSON.stringify('./' + path_1.default.basename(mainJsPath));
+                // Load order is critical: config registry → controller registry → main.js
+                // Because ee-core's lifecycle is loadConfig → loadController → loadElectron,
+                // registries must be injected onto global before main.js executes
+                const contents = [
+                    '// Auto-generated bundle entry - do not edit',
+                    `require('app:config-registry');`,
+                    `require('app:controller-registry');`,
+                    `require(${mainRelative});`,
+                ].join('\n');
+                return {
+                    contents,
+                    loader: 'js',
+                    // Set resolveDir to the directory containing main.js so require(main.js) resolves correctly
+                    resolveDir: path_1.default.dirname(mainJsPath),
+                };
+            });
+        },
+    };
+}
+//# sourceMappingURL=bundle_registry_plugin.js.map

package/dist/esm/plugins/bundle_registry_plugin.js.map

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

package/dist/esm/tools/encrypt.d.ts

@@ -1,9 +1,45 @@
+/**
+ * Code Encryption Module — bytecode compilation + JS obfuscation
+ *
+ * Supports three encryption modes:
+ *   - confusion: Obfuscation only (javascript-obfuscator), works for both frontend and Electron
+ *   - bytecode:  Bytecode only (bytenode), only for Electron (frontend renderer V8 version
+ *                differs from compile-time V8, making bytecode incompatible)
+ *   - strict:    Obfuscation + bytecode combined; obfuscate first, then compile to bytecode
+ *                for the strongest protection
+ *   - none:      No encryption (all processing skipped)
+ *
+ * Encryption flow:
+ *   1. Load config, determine encryption type and target file list (via globby scan)
+ *   2. Iterate target files; specificFiles entries are forced to use confusion
+ *      (even when global config is bytecode)
+ *   3. Call generateJSConfuseFile or generateBytecodeFile based on encryption type
+ *
+ * Bytecode compilation safety mechanism:
+ *   - After compilation, verify the .jsc file exists before deleting the source .js file
+ *   - If .jsc was not generated, throw an error and keep the source file to prevent
+ *     code loss from failed compilation
+ */
+/** Encryption CLI options */
 interface EncryptOptions {
     config?: string;
     out?: string;
     target?: string;
 }
-export declare function encrypt(options?: EncryptOptions): void;
+/**
+ * Encryption entry function — processes both electron and frontend targets
+ *
+ * Creates separate Encrypt instances for electron and frontend.
+ * Each instance independently determines whether to encrypt and which method to use,
+ * based on its own configuration.
+ */
+export declare function encrypt(options?: EncryptOptions): Promise<void>;
+/**
+ * Clean encrypted output — delete encryption artifacts from specified directories
+ *
+ * @param options.dir - Directory path(s) to clean (defaults to './public/electron').
+ *                      Accepts a string or string array for multiple directories.
+ */
 export declare function cleanEncrypt(options?: {
     dir?: string | string[];
 }): void;

package/dist/esm/tools/encrypt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"encrypt.d.ts","sourceRoot":"","sources":["../../../src/tools/encrypt.ts"],"names":[],"mappings":"AAqBA,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAoHD,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,IAAI,CAgB1D;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAO,GAAG,IAAI,CAY5E"}
+{"version":3,"file":"encrypt.d.ts","sourceRoot":"","sources":["../../../src/tools/encrypt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAgBH,6BAA6B;AAC7B,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA+PD;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAO,GAAG,IAAI,CAY5E"}