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

package/dist/cjs/lib/helpers.js

@@ -1,6 +1,15 @@
 "use strict";
 /**
- * Local helpers replacing unnecessary npm dependencies.
+ * Local Helper Utilities — replaces unnecessary npm dependencies
+ *
+ * This module provides lightweight local implementations as alternatives to four npm packages,
+ * reducing dependency size and security risk:
+ *   - is-type-of → is.function / is.class (only two checks needed)
+ *   - chalk → ANSI escape code-based colored output (8 colors suffice)
+ *   - fs-extra → copyDirSync recursive directory copy (only this one method needed)
+ *   - debug → createDebug environment variable-based debug logging (with cache optimization)
+ *
+ * Also provides formatCmds for comma-separated command string parsing.
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -12,26 +21,29 @@ exports.createDebug = createDebug;
 exports.formatCmds = formatCmds;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-// ─── type checks (replacing is-type-of) ────────────────────
+// ─── Type checking (replaces is-type-of) ──────────────────────────
 exports.is = {
+    /** Check whether a value is a function (including async functions and generators) */
     function(val) {
         return typeof val === 'function';
     },
+    /**
+     * Check whether a value is an ES6 class.
+     * Uses toString() to check if the source code starts with 'class ', and verifies
+     * the prototype property exists. This double-check prevents false positives for
+     * regular functions (arrow functions and bound functions have no prototype).
+     */
     class(val) {
-        return typeof val === 'function' && val.toString().startsWith('class ');
-    },
-    string(val) {
-        return typeof val === 'string';
-    },
-    array(val) {
-        return Array.isArray(val);
+        return typeof val === 'function' && val.toString().startsWith('class ') && !!val.prototype;
     },
 };
-// ─── chalk (ANSI escape codes) ─────────────────────────────
+// ─── Colored output (replaces chalk, based on ANSI escape codes) ──
 const RESET = '\x1b[0m';
+/** Wrap text with ANSI escape codes: prefix color code + content + reset code */
 function ansi(code, text) {
     return code + text + RESET;
 }
+/** Minimal chalk replacement, providing the 8 colors needed for ee-bin logging */
 exports.chalk = {
     blue: (text) => ansi('\x1b[34m', text),
     green: (text) => ansi('\x1b[32m', text),
@@ -42,7 +54,11 @@ exports.chalk = {
     bgRed: (text) => ansi('\x1b[41m', text),
     bgYellow: (text) => ansi('\x1b[43m', text),
 };
-// ─── fs-extra ──────────────────────────────────────────────
+// ─── Recursive directory copy (replaces fs-extra) ─────────────────
+/**
+ * Synchronously copy a file or directory.
+ * Automatically determines src type: files are copied directly, directories are copied recursively.
+ */
 function copyDirSync(src, dest) {
     if (fs_1.default.statSync(src).isFile()) {
         fs_1.default.mkdirSync(path_1.default.dirname(dest), { recursive: true });
@@ -51,6 +67,7 @@ function copyDirSync(src, dest) {
     }
     _copyDirRecursive(src, dest);
 }
+/** Recursively copy directory contents (internal implementation) */
 function _copyDirRecursive(src, dest) {
     fs_1.default.mkdirSync(dest, { recursive: true });
     const entries = fs_1.default.readdirSync(src, { withFileTypes: true });
@@ -65,27 +82,59 @@ function _copyDirRecursive(src, dest) {
         }
     }
 }
-// ─── debug ─────────────────────────────────────────────────
+// ─── Debug logging (replaces debug npm package) ───────────────────
+/**
+ * Create a namespace-scoped debug log function
+ *
+ * Controlled by the process.env.DEBUG environment variable:
+ *   - DEBUG=*        → enable all namespaces
+ *   - DEBUG=ee-bin:* → enable all ee-bin sub-namespaces
+ *   - DEBUG=ee-bin:serve → enable only the serve namespace
+ *
+ * Includes cache optimization: the enabled state is only recalculated when
+ * the DEBUG environment variable changes, avoiding re-parsing the env string
+ * on every log call.
+ */
 function createDebug(namespace) {
-    const enabled = () => {
-        const dbg = process.env.DEBUG || '';
-        return dbg === '*' || dbg.split(',').some((ns) => {
-            if (ns.endsWith(':*'))
-                return namespace.startsWith(ns.slice(0, -1));
-            return ns === namespace;
-        });
+    let cachedDebugEnv;
+    let cachedEnabled = false;
+    /** Check whether the current DEBUG env enables this namespace (with caching) */
+    const checkEnabled = () => {
+        const currentEnv = process.env.DEBUG;
+        if (currentEnv !== cachedDebugEnv) {
+            cachedDebugEnv = currentEnv;
+            const dbg = currentEnv || '';
+            cachedEnabled = dbg === '*' || dbg.split(',').some((ns) => {
+                if (ns.endsWith(':*'))
+                    return namespace.startsWith(ns.slice(0, -1));
+                return ns === namespace;
+            });
+        }
+        return cachedEnabled;
     };
     return (...args) => {
-        if (enabled()) {
+        if (checkEnabled()) {
             console.log(namespace, ...args);
         }
     };
 }
-// ─── formatCmds ────────────────────────────────────────────
+// ─── Command string parsing ───────────────────────────────────────
+/**
+ * Parse a comma-separated command string into an array of commands
+ *
+ * Processing rules:
+ *   - Empty string → []
+ *   - No comma → single-element array
+ *   - With comma → split, trim each item, and filter out empty values
+ *     Example: "frontend, electron" → ["frontend", "electron"]
+ *     Example: "frontend,,electron" → ["frontend", "electron"]
+ */
 function formatCmds(command) {
     const cmdString = command.trim();
+    if (cmdString === '')
+        return [];
     if (cmdString.includes(',')) {
-        return cmdString.split(',');
+        return cmdString.split(',').map(s => s.trim()).filter(s => s.length > 0);
     }
     return [cmdString];
 }

package/dist/cjs/lib/helpers.js.map

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

package/dist/cjs/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/cjs/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/cjs/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/cjs/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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"}