extension-develop 2.0.1 → 2.0.4

package/README.md

@@ -150,6 +150,32 @@ Options accepted by each command. Values shown are typical types or enumerations
   - browser.chrome | .firefox | .edge | .chromium-based | .gecko-based: launch flags, excluded flags, preferences, binaries, and profile reuse.
 - When detected, a one‑time notice is printed to indicate config is active.
 
+### Environment variables in `extension.config.*`
+
+- `extension.config.*` runs in a Node context during command startup.
+  - Use `process.env.*` to read environment variables inside the config file.
+  - `import.meta.env.*` is available in your extension code at bundle time (via the Env plugin), not in the Node config.
+- During config loading, develop preloads environment files from the project directory into `process.env` using the following order (first match wins):
+  1. `.env.defaults` (always merged first when present)
+  2. `.env.development`
+  3. `.env.local`
+  4. `.env`
+- Only variables you read explicitly in the config are used there; client-side injection still requires the `EXTENSION_PUBLIC_*` prefix.
+- Example:
+
+```js
+// extension.config.js (Node-based)
+export default {
+  browser: {
+    chrome: {
+      startingUrl:
+        process.env.EXTENSION_PUBLIC_START_URL || 'https://example.com'
+    }
+  },
+  config: (config) => config
+}
+```
+
 ## Safety and ergonomics
 
 - Managed dependency guard: If your `extension.config.*` references dependencies that are managed by Extension.js itself, the command aborts with a detailed message to prevent version conflicts.

package/dist/extensions/chrome-manager-extension/define-initial-tab.js

@@ -60,7 +60,17 @@ export async function handleFirstRun() {
       return
     }
 
-    chrome.tabs.create({url: 'pages/welcome.html'})
+    // Guard against opening multiple welcome pages
+    chrome.tabs.query(
+      {url: chrome.runtime.getURL('pages/welcome.html')},
+      (tabs) => {
+        if (Array.isArray(tabs) && tabs.length > 0) {
+          // Already open; do not create another
+          return
+        }
+        chrome.tabs.create({url: 'pages/welcome.html'})
+      }
+    )
     // Ensure the welcome page shows only once per extension installation
     chrome.storage.local.set({[devExtension.id]: {didRun: true}})
   })

package/dist/extensions/chromium-based-manager-extension/define-initial-tab.js

@@ -60,7 +60,17 @@ export async function handleFirstRun() {
       return
     }
 
-    chrome.tabs.create({url: 'pages/welcome.html'})
+    // Guard against opening multiple welcome pages
+    chrome.tabs.query(
+      {url: chrome.runtime.getURL('pages/welcome.html')},
+      (tabs) => {
+        if (Array.isArray(tabs) && tabs.length > 0) {
+          // Already open; do not create another
+          return
+        }
+        chrome.tabs.create({url: 'pages/welcome.html'})
+      }
+    )
     // Ensure the welcome page shows only once per extension installation
     chrome.storage.local.set({[devExtension.id]: {didRun: true}})
   })

package/dist/extensions/edge-manager-extension/define-initial-tab.js

@@ -60,7 +60,17 @@ export async function handleFirstRun() {
       return
     }
 
-    chrome.tabs.create({url: 'pages/welcome.html'})
+    // Guard against opening multiple welcome pages
+    chrome.tabs.query(
+      {url: chrome.runtime.getURL('pages/welcome.html')},
+      (tabs) => {
+        if (Array.isArray(tabs) && tabs.length > 0) {
+          // Already open; do not create another
+          return
+        }
+        chrome.tabs.create({url: 'pages/welcome.html'})
+      }
+    )
     // Ensure the welcome page shows only once per extension installation
     chrome.storage.local.set({[devExtension.id]: {didRun: true}})
   })

package/dist/extensions/firefox-manager-extension/define-initial-tab.js

@@ -49,8 +49,12 @@ async function handleFirstRun() {
       return
     }
 
-    // Open the welcome page
-    await browser.tabs.create({url: './pages/welcome.html'})
+    // Open the welcome page only if not already open
+    const welcomeUrl = browser.runtime.getURL('./pages/welcome.html')
+    const existingWelcome = await browser.tabs.query({url: welcomeUrl})
+    if (!existingWelcome || existingWelcome.length === 0) {
+      await browser.tabs.create({url: './pages/welcome.html'})
+    }
 
     // Ensure the welcome page shows only once per extension installation
     await browser.storage.local.set({[devExtension.id]: {didRun: true}})

package/dist/extensions/gecko-based-manager-extension/define-initial-tab.js

@@ -51,8 +51,12 @@ export async function handleFirstRun() {
       return
     }
 
-    // Open the welcome page
-    await browser.tabs.create({url: './pages/welcome.html'})
+    // Open the welcome page only if not already open
+    const welcomeUrl = browser.runtime.getURL('./pages/welcome.html')
+    const existingWelcome = await browser.tabs.query({url: welcomeUrl})
+    if (!existingWelcome || existingWelcome.length === 0) {
+      await browser.tabs.create({url: './pages/welcome.html'})
+    }
 
     // Ensure the welcome page shows only once per extension installation
     await browser.storage.local.set({[devExtension.id]: {didRun: true}})

package/dist/inject-chromium-client-loader.js

@@ -30,6 +30,8 @@ const external_path_namespaceObject = require("path");
 const external_fs_namespaceObject = require("fs");
 const external_loader_utils_namespaceObject = require("loader-utils");
 const external_schema_utils_namespaceObject = require("schema-utils");
+require("os");
+require("crypto");
 require("child_process");
 require("package-manager-detector");
 require("pintor");

package/dist/inject-firefox-client-loader.js

@@ -30,6 +30,8 @@ const external_path_namespaceObject = require("path");
 const external_fs_namespaceObject = require("fs");
 const external_loader_utils_namespaceObject = require("loader-utils");
 const external_schema_utils_namespaceObject = require("schema-utils");
+require("os");
+require("crypto");
 require("child_process");
 require("package-manager-detector");
 require("pintor");

package/dist/module.js

@@ -1,4 +1,7 @@
 "use strict";
+const __rslib_import_meta_url__ = /*#__PURE__*/ function() {
+    return 'undefined' == typeof document ? new (require('url'.replace('', ''))).URL('file:' + __filename).href : document.currentScript && document.currentScript.src || new URL('main.js', document.baseURI).href;
+}();
 var __webpack_modules__ = {
     "./webpack/plugin-browsers/browsers-lib/add-progress-bar.ts": function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
         __webpack_require__.d(__webpack_exports__, {
@@ -29,9 +32,10 @@ var __webpack_modules__ = {
             f: ()=>DynamicExtensionManager
         });
         var fs_promises__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__("fs/promises");
-        var path__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__("path");
-        var crypto__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__("crypto");
-        var _webpack_lib_messages__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__("./webpack/webpack-lib/messages.ts");
+        var fs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__("fs");
+        var path__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__("path");
+        var crypto__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__("crypto");
+        var _webpack_lib_messages__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__("./webpack/webpack-lib/messages.ts");
         function _define_property(obj, key, value) {
             if (key in obj) Object.defineProperty(obj, key, {
                 value: value,
@@ -44,7 +48,7 @@ var __webpack_modules__ = {
         }
         class DynamicExtensionManager {
             generateExtensionKey() {
-                const keyData = crypto__WEBPACK_IMPORTED_MODULE_2__.randomBytes(128);
+                const keyData = crypto__WEBPACK_IMPORTED_MODULE_3__.randomBytes(128);
                 return keyData.toString('base64');
             }
             getBaseExtensionPath(browser) {
@@ -56,17 +60,17 @@ var __webpack_modules__ = {
                     'gecko-based': 'gecko-based-manager-extension'
                 };
                 const extensionName = browserMap[browser] || 'chrome-manager-extension';
-                return path__WEBPACK_IMPORTED_MODULE_1__.join(this.baseExtensionPath, extensionName);
+                return path__WEBPACK_IMPORTED_MODULE_2__.join(this.baseExtensionPath, extensionName);
             }
             async readBaseManifest(browser) {
                 const basePath = this.getBaseExtensionPath(browser);
-                const manifestPath = path__WEBPACK_IMPORTED_MODULE_1__.join(basePath, 'manifest.json');
+                const manifestPath = path__WEBPACK_IMPORTED_MODULE_2__.join(basePath, 'manifest.json');
                 const manifestContent = await fs_promises__WEBPACK_IMPORTED_MODULE_0__.readFile(manifestPath, 'utf-8');
                 return JSON.parse(manifestContent);
             }
             async readBaseServiceWorker(browser) {
                 const basePath = this.getBaseExtensionPath(browser);
-                const serviceWorkerPath = path__WEBPACK_IMPORTED_MODULE_1__.join(basePath, 'reload-service.js');
+                const serviceWorkerPath = path__WEBPACK_IMPORTED_MODULE_2__.join(basePath, 'reload-service.js');
                 return await fs_promises__WEBPACK_IMPORTED_MODULE_0__.readFile(serviceWorkerPath, 'utf-8');
             }
             async generateExtension(instance) {
@@ -84,14 +88,14 @@ var __webpack_modules__ = {
                 };
                 const serviceWorkerContent = baseServiceWorker.replace(/const\s+port\s*=\s*['"](__RELOAD_PORT__|\d+)['"]/, `const port = '${instance.webSocketPort}'`).replace(/const\s+instanceId\s*=\s*['"](__INSTANCE_ID__|\w+)['"]/, `const instanceId = '${instance.instanceId}'`);
                 const enhancedServiceWorker = `// Instance: ${instanceId}\n// Generated: ${new Date().toISOString()}\n// Cache-buster: ${Date.now()}\n\n${serviceWorkerContent}\n\n// Instance-specific logging\n${'development' === process.env.EXTENSION_ENV ? `console.log('[Extension.js DevTools] Instance ${instanceId} initialized on port ${instance.webSocketPort}');` : ''}\n`;
-                const extensionPath = path__WEBPACK_IMPORTED_MODULE_1__.join(this.userExtensionsPath, `${instance.browser}-manager-${instance.port}`);
+                const extensionPath = path__WEBPACK_IMPORTED_MODULE_2__.join(this.userExtensionsPath, `${instance.browser}-manager-${instance.port}`);
                 await fs_promises__WEBPACK_IMPORTED_MODULE_0__.mkdir(extensionPath, {
                     recursive: true
                 });
-                const manifestPath = path__WEBPACK_IMPORTED_MODULE_1__.join(extensionPath, 'manifest.json');
+                const manifestPath = path__WEBPACK_IMPORTED_MODULE_2__.join(extensionPath, 'manifest.json');
                 const manifestContent = JSON.stringify(manifest, null, 2).replace(/__INSTANCE_ID__/g, instance.instanceId);
                 await fs_promises__WEBPACK_IMPORTED_MODULE_0__.writeFile(manifestPath, manifestContent);
-                const serviceWorkerPath = path__WEBPACK_IMPORTED_MODULE_1__.join(extensionPath, 'reload-service.js');
+                const serviceWorkerPath = path__WEBPACK_IMPORTED_MODULE_2__.join(extensionPath, 'reload-service.js');
                 await fs_promises__WEBPACK_IMPORTED_MODULE_0__.writeFile(serviceWorkerPath, enhancedServiceWorker);
                 await this.copyExtensionFiles(instance.browser, extensionPath);
                 return {
@@ -108,8 +112,8 @@ var __webpack_modules__ = {
                         withFileTypes: true
                     });
                     for (const entry of entries)if (entry.isDirectory() && 'images' === entry.name) {
-                        const sourceImagesPath = path__WEBPACK_IMPORTED_MODULE_1__.join(basePath, 'images');
-                        const targetImagesPath = path__WEBPACK_IMPORTED_MODULE_1__.join(targetPath, 'images');
+                        const sourceImagesPath = path__WEBPACK_IMPORTED_MODULE_2__.join(basePath, 'images');
+                        const targetImagesPath = path__WEBPACK_IMPORTED_MODULE_2__.join(targetPath, 'images');
                         await fs_promises__WEBPACK_IMPORTED_MODULE_0__.mkdir(targetImagesPath, {
                             recursive: true
                         });
@@ -117,13 +121,13 @@ var __webpack_modules__ = {
                             withFileTypes: true
                         });
                         for (const imageEntry of imageEntries)if (imageEntry.isFile()) {
-                            const sourceImagePath = path__WEBPACK_IMPORTED_MODULE_1__.join(sourceImagesPath, imageEntry.name);
-                            const targetImagePath = path__WEBPACK_IMPORTED_MODULE_1__.join(targetImagesPath, imageEntry.name);
+                            const sourceImagePath = path__WEBPACK_IMPORTED_MODULE_2__.join(sourceImagesPath, imageEntry.name);
+                            const targetImagePath = path__WEBPACK_IMPORTED_MODULE_2__.join(targetImagesPath, imageEntry.name);
                             await fs_promises__WEBPACK_IMPORTED_MODULE_0__.copyFile(sourceImagePath, targetImagePath);
                         }
                     } else if (entry.isDirectory() && 'pages' === entry.name) {
-                        const sourcePagesPath = path__WEBPACK_IMPORTED_MODULE_1__.join(basePath, 'pages');
-                        const targetPagesPath = path__WEBPACK_IMPORTED_MODULE_1__.join(targetPath, 'pages');
+                        const sourcePagesPath = path__WEBPACK_IMPORTED_MODULE_2__.join(basePath, 'pages');
+                        const targetPagesPath = path__WEBPACK_IMPORTED_MODULE_2__.join(targetPath, 'pages');
                         await fs_promises__WEBPACK_IMPORTED_MODULE_0__.mkdir(targetPagesPath, {
                             recursive: true
                         });
@@ -131,17 +135,17 @@ var __webpack_modules__ = {
                             withFileTypes: true
                         });
                         for (const pageEntry of pageEntries)if (pageEntry.isFile()) {
-                            const sourcePagePath = path__WEBPACK_IMPORTED_MODULE_1__.join(sourcePagesPath, pageEntry.name);
-                            const targetPagePath = path__WEBPACK_IMPORTED_MODULE_1__.join(targetPagesPath, pageEntry.name);
+                            const sourcePagePath = path__WEBPACK_IMPORTED_MODULE_2__.join(sourcePagesPath, pageEntry.name);
+                            const targetPagePath = path__WEBPACK_IMPORTED_MODULE_2__.join(targetPagesPath, pageEntry.name);
                             await fs_promises__WEBPACK_IMPORTED_MODULE_0__.copyFile(sourcePagePath, targetPagePath);
                         }
                     } else if (entry.isFile() && 'manifest.json' !== entry.name && 'reload-service.js' !== entry.name) {
-                        const sourceFilePath = path__WEBPACK_IMPORTED_MODULE_1__.join(basePath, entry.name);
-                        const targetFilePath = path__WEBPACK_IMPORTED_MODULE_1__.join(targetPath, entry.name);
+                        const sourceFilePath = path__WEBPACK_IMPORTED_MODULE_2__.join(basePath, entry.name);
+                        const targetFilePath = path__WEBPACK_IMPORTED_MODULE_2__.join(targetPath, entry.name);
                         await fs_promises__WEBPACK_IMPORTED_MODULE_0__.copyFile(sourceFilePath, targetFilePath);
                     }
                 } catch (error) {
-                    if ('development' === process.env.EXTENSION_ENV) console.warn(_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_3__.O3(error));
+                    if ('development' === process.env.EXTENSION_ENV) console.warn(_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_4__.O3(error));
                 }
             }
             async cleanupExtension(instanceId) {
@@ -149,10 +153,10 @@ var __webpack_modules__ = {
                 const instanceManager = new InstanceManager(this.projectPath);
                 const instance = await instanceManager.getInstance(instanceId);
                 if (!instance) {
-                    if ('development' === process.env.EXTENSION_ENV) console.warn(_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_3__.ej(instanceId));
+                    if ('development' === process.env.EXTENSION_ENV) console.warn(_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_4__.ej(instanceId));
                     return;
                 }
-                const extensionPath = path__WEBPACK_IMPORTED_MODULE_1__.join(this.userExtensionsPath, `${instance.browser}-manager-${instance.port}`);
+                const extensionPath = path__WEBPACK_IMPORTED_MODULE_2__.join(this.userExtensionsPath, `${instance.browser}-manager-${instance.port}`);
                 try {
                     await fs_promises__WEBPACK_IMPORTED_MODULE_0__.rm(extensionPath, {
                         recursive: true,
@@ -169,18 +173,18 @@ var __webpack_modules__ = {
                         force: true
                     });
                 } catch (error) {
-                    if ('development' === process.env.EXTENSION_ENV) console.warn(_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_3__.rH(error));
+                    if ('development' === process.env.EXTENSION_ENV) console.warn(_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_4__.rH(error));
                 }
             }
             getExtensionPath(instanceId) {
-                return path__WEBPACK_IMPORTED_MODULE_1__.join(this.userExtensionsPath, `manager-port-${instanceId}`);
+                return path__WEBPACK_IMPORTED_MODULE_2__.join(this.userExtensionsPath, `manager-port-${instanceId}`);
             }
             async extensionExists(instanceId) {
                 const { InstanceManager } = await Promise.resolve().then(__webpack_require__.bind(__webpack_require__, "./webpack/plugin-browsers/browsers-lib/instance-manager.ts"));
                 const instanceManager = new InstanceManager(this.projectPath);
                 const instance = await instanceManager.getInstance(instanceId);
                 if (!instance) return false;
-                const extensionPath = path__WEBPACK_IMPORTED_MODULE_1__.join(this.userExtensionsPath, `${instance.browser}-manager-${instance.port}`);
+                const extensionPath = path__WEBPACK_IMPORTED_MODULE_2__.join(this.userExtensionsPath, `${instance.browser}-manager-${instance.port}`);
                 try {
                     await fs_promises__WEBPACK_IMPORTED_MODULE_0__.access(extensionPath);
                     return true;
@@ -192,7 +196,7 @@ var __webpack_modules__ = {
                 const exists = await this.extensionExists(instance.instanceId);
                 if (!exists) return await this.generateExtension(instance);
                 const extensionPath = this.getExtensionPath(instance.instanceId);
-                const serviceWorkerPath = path__WEBPACK_IMPORTED_MODULE_1__.join(extensionPath, 'reload-service.js');
+                const serviceWorkerPath = path__WEBPACK_IMPORTED_MODULE_2__.join(extensionPath, 'reload-service.js');
                 try {
                     const content = await fs_promises__WEBPACK_IMPORTED_MODULE_0__.readFile(serviceWorkerPath, 'utf-8');
                     const portMatch = content.match(/const\s+port\s*=\s*['"](\d+)['"]/);
@@ -208,7 +212,7 @@ var __webpack_modules__ = {
                 return {
                     extensionId: instance.managerExtensionId,
                     manifest,
-                    serviceWorkerPath: path__WEBPACK_IMPORTED_MODULE_1__.join(extensionPath, 'reload-service.js'),
+                    serviceWorkerPath: path__WEBPACK_IMPORTED_MODULE_2__.join(extensionPath, 'reload-service.js'),
                     extensionPath
                 };
             }
@@ -216,9 +220,27 @@ var __webpack_modules__ = {
                 _define_property(this, "baseExtensionPath", void 0);
                 _define_property(this, "projectPath", void 0);
                 _define_property(this, "userExtensionsPath", void 0);
-                this.baseExtensionPath = path__WEBPACK_IMPORTED_MODULE_1__.join(__dirname, '../webpack/plugin-reload/extensions');
+                const candidateBasePaths = [];
+                try {
+                    const entryPath = require.resolve('extension-develop');
+                    const distDir = path__WEBPACK_IMPORTED_MODULE_2__.dirname(entryPath);
+                    candidateBasePaths.push(path__WEBPACK_IMPORTED_MODULE_2__.join(distDir, 'extensions'));
+                } catch  {}
+                candidateBasePaths.push(path__WEBPACK_IMPORTED_MODULE_2__.join(__dirname, 'extensions'));
+                candidateBasePaths.push(path__WEBPACK_IMPORTED_MODULE_2__.join(__dirname, 'dist', 'extensions'));
+                candidateBasePaths.push(path__WEBPACK_IMPORTED_MODULE_2__.join(__dirname, 'programs', 'develop', 'dist', 'extensions'));
+                candidateBasePaths.push(path__WEBPACK_IMPORTED_MODULE_2__.join(process.cwd(), 'node_modules', 'extension-develop', 'dist', 'extensions'));
+                candidateBasePaths.push(path__WEBPACK_IMPORTED_MODULE_2__.join(__dirname, '..', '..', 'plugin-reload', 'extensions'));
+                let resolvedBasePath = candidateBasePaths[0];
+                for (const candidate of candidateBasePaths)try {
+                    if (fs__WEBPACK_IMPORTED_MODULE_1__.existsSync(candidate)) {
+                        resolvedBasePath = candidate;
+                        break;
+                    }
+                } catch  {}
+                this.baseExtensionPath = resolvedBasePath;
                 this.projectPath = projectPath || process.cwd();
-                this.userExtensionsPath = path__WEBPACK_IMPORTED_MODULE_1__.join(this.projectPath, 'dist', 'extension-js', 'extensions');
+                this.userExtensionsPath = path__WEBPACK_IMPORTED_MODULE_2__.join(this.projectPath, 'dist', 'extension-js', 'extensions');
             }
         }
     },
@@ -226,12 +248,12 @@ var __webpack_modules__ = {
         __webpack_require__.d(__webpack_exports__, {
             InstanceManager: ()=>InstanceManager
         });
-        var promises_ = __webpack_require__("fs/promises");
-        var external_path_ = __webpack_require__("path");
-        const external_os_namespaceObject = require("os");
-        var external_crypto_ = __webpack_require__("crypto");
-        var external_net_ = __webpack_require__("net");
-        var messages = __webpack_require__("./webpack/webpack-lib/messages.ts");
+        var fs_promises__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__("fs/promises");
+        var path__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__("path");
+        var os__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__("os");
+        var crypto__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__("crypto");
+        var net__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__("net");
+        var _webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__("./webpack/webpack-lib/messages.ts");
         function _define_property(obj, key, value) {
             if (key in obj) Object.defineProperty(obj, key, {
                 value: value,
@@ -248,21 +270,21 @@ var __webpack_modules__ = {
                 const isWSL = process.env.WSL_DISTRO_NAME || process.env.WSLENV;
                 switch(platform){
                     case 'darwin':
-                        return external_path_.join(external_os_namespaceObject.homedir(), 'Library', 'Application Support', 'extension-js');
+                        return path__WEBPACK_IMPORTED_MODULE_1__.join(os__WEBPACK_IMPORTED_MODULE_2__.homedir(), 'Library', 'Application Support', 'extension-js');
                     case 'win32':
-                        return external_path_.join(process.env.APPDATA || '', 'extension-js');
+                        return path__WEBPACK_IMPORTED_MODULE_1__.join(process.env.APPDATA || '', 'extension-js');
                     case 'linux':
                         if (isWSL) {
                             const windowsAppData = process.env.APPDATA;
-                            if (windowsAppData) return external_path_.join(windowsAppData, 'extension-js');
+                            if (windowsAppData) return path__WEBPACK_IMPORTED_MODULE_1__.join(windowsAppData, 'extension-js');
                         }
-                        return external_path_.join(external_os_namespaceObject.homedir(), '.config', 'extension-js');
+                        return path__WEBPACK_IMPORTED_MODULE_1__.join(os__WEBPACK_IMPORTED_MODULE_2__.homedir(), '.config', 'extension-js');
                     default:
-                        return external_path_.join(external_os_namespaceObject.homedir(), '.extension-js');
+                        return path__WEBPACK_IMPORTED_MODULE_1__.join(os__WEBPACK_IMPORTED_MODULE_2__.homedir(), '.extension-js');
                 }
             }
             generateInstanceId() {
-                return external_crypto_.randomBytes(8).toString('hex');
+                return crypto__WEBPACK_IMPORTED_MODULE_3__.randomBytes(8).toString('hex');
             }
             generateManagerExtensionId() {
                 const chars = 'abcdefghijklmnopqrstuvwxyz';
@@ -271,11 +293,11 @@ var __webpack_modules__ = {
                 return result;
             }
             async ensureRegistryDir() {
-                const dir = external_path_.dirname(this.registryPath);
+                const dir = path__WEBPACK_IMPORTED_MODULE_1__.dirname(this.registryPath);
                 try {
-                    await promises_.access(dir);
+                    await fs_promises__WEBPACK_IMPORTED_MODULE_0__.access(dir);
                 } catch  {
-                    await promises_.mkdir(dir, {
+                    await fs_promises__WEBPACK_IMPORTED_MODULE_0__.mkdir(dir, {
                         recursive: true
                     });
                 }
@@ -283,7 +305,7 @@ var __webpack_modules__ = {
             async loadRegistry() {
                 try {
                     await this.ensureRegistryDir();
-                    const data = await promises_.readFile(this.registryPath, 'utf-8');
+                    const data = await fs_promises__WEBPACK_IMPORTED_MODULE_0__.readFile(this.registryPath, 'utf-8');
                     return JSON.parse(data);
                 } catch  {
                     return {
@@ -296,16 +318,16 @@ var __webpack_modules__ = {
                 try {
                     await this.ensureRegistryDir();
                     const data = JSON.stringify(registry, null, 2);
-                    await promises_.writeFile(this.registryPath, data);
-                    if ('development' === process.env.EXTENSION_ENV) console.log(messages.xc(this.registryPath));
+                    await fs_promises__WEBPACK_IMPORTED_MODULE_0__.writeFile(this.registryPath, data);
+                    if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.xc(this.registryPath));
                 } catch (error) {
-                    if ('development' === process.env.EXTENSION_ENV) console.error(messages.b9(error));
+                    if ('development' === process.env.EXTENSION_ENV) console.error(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.b9(error));
                     throw error;
                 }
             }
             async isPortAvailable(port) {
                 const check = (host)=>new Promise((resolve)=>{
-                        const server = external_net_.createServer();
+                        const server = net__WEBPACK_IMPORTED_MODULE_4__.createServer();
                         const complete = (result)=>{
                             try {
                                 server.close(()=>resolve(result));
@@ -345,25 +367,25 @@ var __webpack_modules__ = {
                 const usedPorts = existingInstances.filter((instance)=>'running' === instance.status).map((instance)=>instance.port);
                 const usedWebSocketPorts = existingInstances.filter((instance)=>'running' === instance.status).map((instance)=>instance.webSocketPort);
                 if ('development' === process.env.EXTENSION_ENV) {
-                    console.log(messages.EP(usedPorts));
-                    console.log(messages.Hh(usedWebSocketPorts));
+                    console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.EP(usedPorts));
+                    console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.Hh(usedWebSocketPorts));
                 }
                 if (requestedPort) {
                     const isPortAvailable = await this.isPortAvailable(requestedPort);
                     if (isPortAvailable && !usedPorts.includes(requestedPort)) {
                         const webSocketPort = await this.findAvailableWebSocketPort(usedWebSocketPorts);
-                        if ('development' === process.env.EXTENSION_ENV) console.log(messages.G(requestedPort, webSocketPort));
+                        if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.G(requestedPort, webSocketPort));
                         return {
                             port: requestedPort,
                             webSocketPort
                         };
                     }
-                    if ('development' === process.env.EXTENSION_ENV) console.log(messages.S8(requestedPort));
+                    if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.S8(requestedPort));
                 }
                 let port = this.basePort;
                 while(usedPorts.includes(port) || !await this.isPortAvailable(port))port++;
                 const webSocketPort = await this.findAvailableWebSocketPort(usedWebSocketPorts);
-                if ('development' === process.env.EXTENSION_ENV) console.log(messages._Z(port, webSocketPort));
+                if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__._Z(port, webSocketPort));
                 return {
                     port,
                     webSocketPort
@@ -383,18 +405,18 @@ var __webpack_modules__ = {
                     if ('terminated' === instance.status || 'error' === instance.status || now - instance.startTime > maxAge) shouldRemove = true;
                     else if (await this.isProcessRunning(instance.processId)) {
                         if (await this.isPortAvailable(instance.port) && await this.isPortAvailable(instance.webSocketPort)) {
-                            if ('development' === process.env.EXTENSION_ENV) console.log(messages.Y_(instanceId, instance.port, instance.webSocketPort));
+                            if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.Y_(instanceId, instance.port, instance.webSocketPort));
                             shouldRemove = true;
                         }
                     } else {
-                        if ('development' === process.env.EXTENSION_ENV) console.log(messages.jQ(instanceId, instance.processId));
+                        if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.jQ(instanceId, instance.processId));
                         shouldRemove = true;
                     }
                     if (shouldRemove) instancesToRemove.push(instanceId);
                 }
                 for (const instanceId of instancesToRemove){
                     delete registry.instances[instanceId];
-                    if ('development' === process.env.EXTENSION_ENV) console.log(messages.Hl(instanceId));
+                    if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.Hl(instanceId));
                 }
                 registry.lastCleanup = now;
             }
@@ -409,7 +431,7 @@ var __webpack_modules__ = {
             async monitorProcessHealth(instanceId) {
                 const instance = await this.getInstance(instanceId);
                 if (!instance) return;
-                if ('development' === process.env.EXTENSION_ENV) console.log(messages.oN(instanceId));
+                if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.oN(instanceId));
                 const healthCheck = setInterval(async ()=>{
                     try {
                         const isHealthy = await this.isProcessRunning(instance.processId);
@@ -417,13 +439,13 @@ var __webpack_modules__ = {
                         const isCurrentProcess = instance.processId === process.pid;
                         const definitelyOrphaned = !isCurrentProcess && !isHealthy && !portsInUse;
                         if (definitelyOrphaned) {
-                            console.log(messages.zd(instanceId));
+                            console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.zd(instanceId));
                             await this.terminateInstance(instanceId);
                             clearInterval(healthCheck);
                             this.healthChecks.delete(instanceId);
-                        } else if ('development' === process.env.EXTENSION_ENV) console.log(messages.IV(instanceId));
+                        } else if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.IV(instanceId));
                     } catch (error) {
-                        console.error(messages.Es(instanceId, error));
+                        console.error(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.Es(instanceId, error));
                         clearInterval(healthCheck);
                         this.healthChecks.delete(instanceId);
                     }
@@ -436,32 +458,32 @@ var __webpack_modules__ = {
                 return portInUse || webSocketPortInUse;
             }
             async forceCleanupProjectProcesses(projectPath) {
-                if ('development' === process.env.EXTENSION_ENV) console.log(messages.r6(projectPath));
+                if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.r6(projectPath));
                 const registry = await this.loadRegistry();
                 const projectInstances = Object.values(registry.instances).filter((instance)=>instance.projectPath === projectPath);
-                if ('development' === process.env.EXTENSION_ENV) console.log(messages.dQ(projectInstances.length));
+                if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.dQ(projectInstances.length));
                 for (const instance of projectInstances)try {
-                    if ('development' === process.env.EXTENSION_ENV) console.log(messages.j4(instance.instanceId));
+                    if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.j4(instance.instanceId));
                     if (await this.isProcessRunning(instance.processId)) {
-                        if ('development' === process.env.EXTENSION_ENV) console.log(messages.qb(instance.processId));
+                        if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.qb(instance.processId));
                         process.kill(instance.processId, 'SIGTERM');
                         setTimeout(()=>{
                             try {
                                 process.kill(instance.processId, 'SIGKILL');
-                                if ('development' === process.env.EXTENSION_ENV) console.log(messages.o2(instance.processId));
+                                if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.o2(instance.processId));
                             } catch (error) {}
                         }, 3000);
                     }
                     instance.status = 'terminated';
-                    if ('development' === process.env.EXTENSION_ENV) console.log(messages.J9(instance.instanceId));
+                    if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.J9(instance.instanceId));
                 } catch (error) {
-                    if ('development' === process.env.EXTENSION_ENV) console.error(messages.Wc(instance.instanceId, error));
+                    if ('development' === process.env.EXTENSION_ENV) console.error(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.Wc(instance.instanceId, error));
                 }
                 await this.saveRegistry(registry);
-                if ('development' === process.env.EXTENSION_ENV) console.log(messages.JJ());
+                if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.JJ());
             }
             async createInstance(browser, projectPath, requestedPort) {
-                if ('development' === process.env.EXTENSION_ENV) console.log(messages.jE({
+                if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.jE({
                     browser,
                     projectPath,
                     requestedPort
@@ -481,12 +503,12 @@ var __webpack_modules__ = {
                     startTime: Date.now(),
                     status: 'running',
                     processId: process.pid,
-                    profilePath: external_path_.join(external_os_namespaceObject.tmpdir(), `extension-js-${instanceId}`)
+                    profilePath: path__WEBPACK_IMPORTED_MODULE_1__.join(os__WEBPACK_IMPORTED_MODULE_2__.tmpdir(), `extension-js-${instanceId}`)
                 };
                 registry.instances[instanceId] = instance;
                 await this.saveRegistry(registry);
                 await this.monitorProcessHealth(instanceId);
-                if ('development' === process.env.EXTENSION_ENV) console.log(messages.pU(registry));
+                if ('development' === process.env.EXTENSION_ENV) console.log(_webpack_webpack_lib_messages__WEBPACK_IMPORTED_MODULE_5__.pU(registry));
                 return instance;
             }
             async updateInstance(instanceId, updates) {
@@ -569,7 +591,7 @@ var __webpack_modules__ = {
                 _define_property(this, "healthChecks", new Map());
                 this.basePort = basePort;
                 this.baseWebSocketPort = baseWebSocketPort;
-                this.registryPath = external_path_.join(this.getDataDirectory(), 'instances.json');
+                this.registryPath = path__WEBPACK_IMPORTED_MODULE_1__.join(this.getDataDirectory(), 'instances.json');
             }
         }
     },
@@ -3309,6 +3331,9 @@ var __webpack_modules__ = {
     net: function(module) {
         module.exports = require("net");
     },
+    os: function(module) {
+        module.exports = require("os");
+    },
     path: function(module) {
         module.exports = require("path");
     },
@@ -3319,7 +3344,7 @@ var __webpack_modules__ = {
         module.exports = require("util");
     },
     "./package.json": function(module) {
-        module.exports = JSON.parse('{"i8":"2.0.1","HO":{"@rspack/core":"^1.4.8","@rspack/dev-server":"^1.1.3","@swc/helpers":"^0.5.15","@types/webextension-polyfill":"0.12.3","@vue/compiler-sfc":"^3.5.13","adm-zip":"^0.5.16","axios":"^1.9.0","case-sensitive-paths-webpack-plugin":"^2.4.0","chokidar":"^4.0.1","chrome-location2":"2.0.0","content-security-policy-parser":"^0.6.0","cross-spawn":"^7.0.6","dotenv":"^16.4.7","dotenv-webpack":"^8.1.0","edge-location":"^1.1.1","firefox-location2":"1.0.0","firefox-profile":"^4.7.0","go-git-it":"^5.0.0","ignore":"^6.0.2","loader-utils":"^3.3.1","locate-path":"^7.2.0","micromatch":"^4.0.8","package-manager-detector":"^0.2.7","parse5":"^7.2.1","parse5-utilities":"^1.0.0","pintor":"0.3.0","postcss":"^8.4.49","preact":"^10.22.0","progress":"^2.0.3","schema-utils":"^4.2.0","slugify":"^1.6.6","tiny-glob":"^0.2.9","webextension-polyfill":"^0.12.0","webpack-merge":"^6.0.1","webpack-target-webextension":"^2.1.3","ws":"^8.18.0"},"Lq":{"@prefresh/core":"^1.5.2","@prefresh/utils":"^1.2.0","@prefresh/webpack":"^4.0.1","@rspack/plugin-preact-refresh":"^1.1.2","@rspack/plugin-react-refresh":"^1.0.1","babel-loader":"^9.2.1","less-loader":"^12.2.0","postcss-loader":"^8.1.1","postcss-preset-env":"^10.1.1","react-refresh":"^0.14.2","sass-loader":"^16.0.4","svelte-loader":"^3.2.4","vue-loader":"^17.4.2","vue-style-loader":"^4.1.3"}}');
+        module.exports = JSON.parse('{"i8":"2.0.4","HO":{"@rspack/core":"^1.4.8","@rspack/dev-server":"^1.1.3","@swc/helpers":"^0.5.15","@types/webextension-polyfill":"0.12.3","@vue/compiler-sfc":"^3.5.13","adm-zip":"^0.5.16","axios":"^1.9.0","case-sensitive-paths-webpack-plugin":"^2.4.0","chokidar":"^4.0.1","chrome-location2":"2.0.0","content-security-policy-parser":"^0.6.0","cross-spawn":"^7.0.6","dotenv":"^16.4.7","dotenv-webpack":"^8.1.0","edge-location":"^1.1.1","firefox-location2":"1.0.0","firefox-profile":"^4.7.0","go-git-it":"^5.0.0","ignore":"^6.0.2","loader-utils":"^3.3.1","locate-path":"^7.2.0","micromatch":"^4.0.8","package-manager-detector":"^0.2.7","parse5":"^7.2.1","parse5-utilities":"^1.0.0","pintor":"0.3.0","postcss":"^8.4.49","preact":"^10.22.0","progress":"^2.0.3","schema-utils":"^4.2.0","slugify":"^1.6.6","tiny-glob":"^0.2.9","webextension-polyfill":"^0.12.0","webpack-merge":"^6.0.1","webpack-target-webextension":"^2.1.3","ws":"^8.18.0"},"Lq":{"@prefresh/core":"^1.5.2","@prefresh/utils":"^1.2.0","@prefresh/webpack":"^4.0.1","@rspack/plugin-preact-refresh":"^1.1.2","@rspack/plugin-react-refresh":"^1.0.1","babel-loader":"^9.2.1","less-loader":"^12.2.0","postcss-loader":"^8.1.1","postcss-preset-env":"^10.1.1","react-refresh":"^0.14.2","sass-loader":"^16.0.4","svelte-loader":"^3.2.4","vue-loader":"^17.4.2","vue-style-loader":"^4.1.3"}}');
     }
 };
 var __webpack_module_cache__ = {};
@@ -3383,6 +3408,7 @@ var __webpack_exports__ = {};
     const external_case_sensitive_paths_webpack_plugin_namespaceObject = require("case-sensitive-paths-webpack-plugin");
     var external_case_sensitive_paths_webpack_plugin_default = /*#__PURE__*/ __webpack_require__.n(external_case_sensitive_paths_webpack_plugin_namespaceObject);
     const external_dotenv_namespaceObject = require("dotenv");
+    var external_dotenv_default = /*#__PURE__*/ __webpack_require__.n(external_dotenv_namespaceObject);
     function _define_property(obj, key, value) {
         if (key in obj) Object.defineProperty(obj, key, {
             value: value,
@@ -3562,6 +3588,8 @@ var __webpack_exports__ = {};
         }
     }
     plugin_compilation_define_property(CompilationPlugin, "name", 'plugin-compilation');
+    var external_os_ = __webpack_require__("os");
+    var external_crypto_ = __webpack_require__("crypto");
     var external_child_process_ = __webpack_require__("child_process");
     const external_package_manager_detector_namespaceObject = require("package-manager-detector");
     var constants = __webpack_require__("./webpack/webpack-lib/constants.ts");
@@ -3682,6 +3710,62 @@ var __webpack_exports__ = {};
         const distPath = external_path_.dirname(outputPath);
         return !external_fs_.existsSync(external_path_.resolve(distPath, 'extension-js', 'profiles', `${browser}-profile`));
     }
+    function getDataDirectory() {
+        const platform = process.platform;
+        const isWSL = process.env.WSL_DISTRO_NAME || process.env.WSLENV;
+        switch(platform){
+            case 'darwin':
+                return external_path_.join(external_os_.homedir(), 'Library', 'Application Support', 'extension-js');
+            case 'win32':
+                return external_path_.join(process.env.APPDATA || '', 'extension-js');
+            case 'linux':
+                if (isWSL) {
+                    const windowsAppData = process.env.APPDATA;
+                    if (windowsAppData) return external_path_.join(windowsAppData, 'extension-js');
+                }
+                return external_path_.join(external_os_.homedir(), '.config', 'extension-js');
+            default:
+                return external_path_.join(external_os_.homedir(), '.extension-js');
+        }
+    }
+    function getFirstRunFlagsDir() {
+        return external_path_.join(getDataDirectory(), 'first-run');
+    }
+    function hashProject(projectPath) {
+        try {
+            return external_crypto_.createHash('sha1').update(projectPath).digest('hex').slice(0, 12);
+        } catch  {
+            return Buffer.from(projectPath).toString('hex').slice(0, 12);
+        }
+    }
+    function getFirstRunFlagPath(projectPath, browser) {
+        const dir = getFirstRunFlagsDir();
+        const key = `${hashProject(projectPath)}-${browser}.flag`;
+        return external_path_.join(dir, key);
+    }
+    function hasShownFirstRunMessage(projectPath, browser) {
+        try {
+            const flagPath = getFirstRunFlagPath(projectPath, browser);
+            return external_fs_.existsSync(flagPath);
+        } catch  {
+            return false;
+        }
+    }
+    function markFirstRunMessageShown(projectPath, browser) {
+        try {
+            const dir = getFirstRunFlagsDir();
+            if (!external_fs_.existsSync(dir)) external_fs_.mkdirSync(dir, {
+                recursive: true
+            });
+            const flagPath = getFirstRunFlagPath(projectPath, browser);
+            external_fs_.writeFileSync(flagPath, '1', 'utf8');
+        } catch  {}
+    }
+    function shouldShowFirstRun(outputPath, browser, projectPath) {
+        const firstByProfile = isFirstRun(outputPath, browser);
+        if (!firstByProfile) return false;
+        return !hasShownFirstRunMessage(projectPath, browser);
+    }
     function filterKeysForThisBrowser(manifest, browser) {
         const patchedManifest = JSON.parse(JSON.stringify(manifest), function(key, value) {
             const indexOfColon = key.indexOf(':');
@@ -7815,9 +7899,12 @@ var __webpack_exports__ = {};
                     });
                     console.log(emptyLine());
                     console.log(runningInDevelopment(manifest, options.browser, message));
-                    if (isFirstRun(compiler.options.output.path, options.browser)) {
+                    const projectPath = compiler.options.context || process.cwd();
+                    const outPath = compiler.options.output.path;
+                    if (shouldShowFirstRun(outPath, options.browser, projectPath)) {
                         console.log(emptyLine());
                         console.log(messages_isFirstRun(options.browser));
+                        markFirstRunMessageShown(projectPath, options.browser);
                     }
                     console.log(emptyLine());
                 }
@@ -9948,13 +10035,77 @@ var __webpack_exports__ = {};
             throw error;
         }
     }
+    function preloadEnvFiles(projectDir) {
+        try {
+            const defaultsPath = external_path_.join(projectDir, '.env.defaults');
+            if (external_fs_.existsSync(defaultsPath)) external_dotenv_default().config({
+                path: defaultsPath
+            });
+            const envCandidates = [
+                '.env.development',
+                '.env.local',
+                '.env'
+            ];
+            for (const filename of envCandidates){
+                const filePath = external_path_.join(projectDir, filename);
+                if (external_fs_.existsSync(filePath)) {
+                    external_dotenv_default().config({
+                        path: filePath
+                    });
+                    break;
+                }
+            }
+        } catch  {}
+    }
     async function loadConfigFile(configPath) {
         const absolutePath = external_path_.resolve(configPath);
+        const projectDir = external_path_.dirname(absolutePath);
+        preloadEnvFiles(projectDir);
         try {
-            const module = await import((0, external_url_namespaceObject.pathToFileURL)(absolutePath).href);
+            if (absolutePath.endsWith('.cjs')) {
+                const requireFn = (0, external_module_namespaceObject.createRequire)(__rslib_import_meta_url__);
+                const required = requireFn(absolutePath);
+                return (null == required ? void 0 : required.default) || required;
+            }
+            let esmImportPath = absolutePath;
+            try {
+                const originalContent = external_fs_.readFileSync(absolutePath, 'utf-8');
+                if (originalContent.includes('import.meta.env')) {
+                    const tmpDir = external_fs_.mkdtempSync(external_path_.join(external_os_.tmpdir(), 'extension-config-esm-'));
+                    const tmpPath = external_path_.join(tmpDir, external_path_.basename(absolutePath));
+                    const envObjectLiteral = JSON.stringify(Object.fromEntries(Object.entries(process.env).map(([k, v])=>[
+                            k,
+                            v
+                        ])), null, 0);
+                    const shimHeader = `const __IMPORT_META_ENV__ = Object.freeze(${envObjectLiteral});\n`;
+                    const replaced = originalContent.replace(/import\.meta\.env/g, '__IMPORT_META_ENV__');
+                    external_fs_.writeFileSync(tmpPath, `${shimHeader}${replaced}`, 'utf-8');
+                    esmImportPath = tmpPath;
+                }
+            } catch  {}
+            const module = await import((0, external_url_namespaceObject.pathToFileURL)(esmImportPath).href);
             return module.default || module;
         } catch (err) {
             const error = err;
+            try {
+                if (!absolutePath.endsWith('.mjs')) {
+                    const requireFn = (0, external_module_namespaceObject.createRequire)(__rslib_import_meta_url__);
+                    let required;
+                    try {
+                        required = requireFn(absolutePath);
+                    } catch (requireErr) {
+                        const message = String((null == error ? void 0 : error.message) || '') + ' ' + String((null == requireErr ? void 0 : requireErr.message) || '');
+                        const looksLikeCommonJsInEsm = message.includes('require is not defined in ES module scope') || message.includes('Cannot use import statement outside a module') || message.includes('ERR_REQUIRE_ESM');
+                        if (looksLikeCommonJsInEsm) {
+                            const tmpDir = external_fs_.mkdtempSync(external_path_.join(external_os_.tmpdir(), 'extension-config-'));
+                            const tmpCjsPath = external_path_.join(tmpDir, external_path_.basename(absolutePath, external_path_.extname(absolutePath)) + '.cjs');
+                            external_fs_.copyFileSync(absolutePath, tmpCjsPath);
+                            required = requireFn(tmpCjsPath);
+                        } else throw requireErr;
+                    }
+                    return (null == required ? void 0 : required.default) || required;
+                }
+            } catch  {}
             try {
                 const content = external_fs_.readFileSync(absolutePath, 'utf-8');
                 return JSON.parse(content);
@@ -9966,14 +10117,20 @@ var __webpack_exports__ = {};
     async function loadCustomWebpackConfig(projectPath) {
         const userConfigPath = external_path_.join(projectPath, 'extension.config.js');
         const moduleUserConfigPath = external_path_.join(projectPath, 'extension.config.mjs');
-        if (external_fs_.existsSync(userConfigPath) || external_fs_.existsSync(moduleUserConfigPath)) {
-            const configPath = external_fs_.existsSync(userConfigPath) ? userConfigPath : moduleUserConfigPath;
+        const commonJsUserConfigPath = external_path_.join(projectPath, 'extension.config.cjs');
+        const candidates = [
+            userConfigPath,
+            moduleUserConfigPath,
+            commonJsUserConfigPath
+        ];
+        const configPath = candidates.find((p)=>external_fs_.existsSync(p));
+        if (configPath) {
             if (await get_extension_config_isUsingExperimentalConfig(projectPath)) try {
                 const userConfig = await loadConfigFile(configPath);
                 if (userConfig && 'function' == typeof userConfig.config) return userConfig.config;
             } catch (err) {
                 const error = err;
-                console.error(configLoadingError('extension.config.js', error));
+                console.error(configLoadingError(configPath, error));
                 throw err;
             }
         }
@@ -9982,14 +10139,20 @@ var __webpack_exports__ = {};
     async function loadCommandConfig(projectPath, command) {
         const userConfigPath = external_path_.join(projectPath, 'extension.config.js');
         const moduleUserConfigPath = external_path_.join(projectPath, 'extension.config.mjs');
-        const configPath = external_fs_.existsSync(userConfigPath) ? userConfigPath : moduleUserConfigPath;
-        if (external_fs_.existsSync(userConfigPath) || external_fs_.existsSync(moduleUserConfigPath)) {
+        const commonJsUserConfigPath = external_path_.join(projectPath, 'extension.config.cjs');
+        const candidates = [
+            userConfigPath,
+            moduleUserConfigPath,
+            commonJsUserConfigPath
+        ];
+        const configPath = candidates.find((p)=>external_fs_.existsSync(p));
+        if (configPath) {
             if (await get_extension_config_isUsingExperimentalConfig(projectPath)) try {
                 const userConfig = await loadConfigFile(configPath);
                 if (userConfig && userConfig.commands && userConfig.commands[command]) return userConfig.commands[command];
             } catch (err) {
                 const error = err;
-                console.error(configLoadingError('command config', error));
+                console.error(configLoadingError(configPath, error));
                 throw err;
             }
         }
@@ -9998,14 +10161,20 @@ var __webpack_exports__ = {};
     async function loadBrowserConfig(projectPath, browser = 'chrome') {
         const userConfigPath = external_path_.join(projectPath, 'extension.config.js');
         const moduleUserConfigPath = external_path_.join(projectPath, 'extension.config.mjs');
-        const configPath = external_fs_.existsSync(userConfigPath) ? userConfigPath : moduleUserConfigPath;
-        if (external_fs_.existsSync(userConfigPath) || external_fs_.existsSync(moduleUserConfigPath)) {
+        const commonJsUserConfigPath = external_path_.join(projectPath, 'extension.config.cjs');
+        const candidates = [
+            userConfigPath,
+            moduleUserConfigPath,
+            commonJsUserConfigPath
+        ];
+        const configPath = candidates.find((p)=>external_fs_.existsSync(p));
+        if (configPath) {
             if (await get_extension_config_isUsingExperimentalConfig(projectPath)) try {
                 const userConfig = await loadConfigFile(configPath);
                 if (userConfig && userConfig.browser && userConfig.browser[browser]) return userConfig.browser[browser];
             } catch (err) {
                 const error = err;
-                console.error(configLoadingError('browser config', error));
+                console.error(configLoadingError(configPath, error));
                 throw err;
             }
         }
@@ -10017,8 +10186,14 @@ var __webpack_exports__ = {};
     async function get_extension_config_isUsingExperimentalConfig(projectPath) {
         const userConfigPath = external_path_.join(projectPath, 'extension.config.js');
         const moduleUserConfigPath = external_path_.join(projectPath, 'extension.config.mjs');
-        const configPath = external_fs_.existsSync(userConfigPath) ? userConfigPath : moduleUserConfigPath;
-        if (external_fs_.existsSync(configPath) || external_fs_.existsSync(moduleUserConfigPath)) {
+        const commonJsUserConfigPath = external_path_.join(projectPath, 'extension.config.cjs');
+        const candidates = [
+            userConfigPath,
+            moduleUserConfigPath,
+            commonJsUserConfigPath
+        ];
+        const configPath = candidates.find((p)=>external_fs_.existsSync(p));
+        if (configPath) {
             if (!get_extension_config_userMessageDelivered) {
                 console.log(isUsingExperimentalConfig('extension.config.js'));
                 get_extension_config_userMessageDelivered = true;
@@ -10314,7 +10489,11 @@ var __webpack_exports__ = {};
         });
         const customWebpackConfig = await loadCustomWebpackConfig(manifestDir);
         const finalConfig = customWebpackConfig(baseConfig);
-        const compilerConfig = (0, external_webpack_merge_namespaceObject.merge)(finalConfig);
+        const compilerConfig = (0, external_webpack_merge_namespaceObject.merge)(finalConfig, {
+            infrastructureLogging: {
+                level: 'error'
+            }
+        });
         const compiler = (0, core_namespaceObject.rspack)(compilerConfig);
         const port = portAllocation.port;
         if (void 0 !== devOptions.port && devOptions.port !== port) {
@@ -10343,7 +10522,7 @@ var __webpack_exports__ = {};
                 }
             },
             client: {
-                logging: 'development' === process.env.EXTENSION_ENV ? 'error' : 'none',
+                logging: 'none',
                 progress: false,
                 overlay: false
             },

package/dist/webpack/webpack-lib/utils.d.ts

@@ -16,5 +16,8 @@ export declare function isFromNpx(): false | "npm";
 export declare function installOptionalDependencies(integration: string, dependencies: string[]): Promise<void>;
 export declare function isUsingJSFramework(projectPath: string): boolean;
 export declare function isFirstRun(outputPath: string, browser: DevOptions['browser']): boolean;
+export declare function hasShownFirstRunMessage(projectPath: string, browser: DevOptions['browser']): boolean;
+export declare function markFirstRunMessageShown(projectPath: string, browser: DevOptions['browser']): void;
+export declare function shouldShowFirstRun(outputPath: string, browser: DevOptions['browser'], projectPath: string): boolean;
 export declare function filterKeysForThisBrowser(manifest: Manifest, browser: DevOptions['browser']): any;
 export declare function hasDependency(projectPath: string, dependency: string): boolean;

package/package.json

@@ -21,7 +21,7 @@
     "dist"
   ],
   "name": "extension-develop",
-  "version": "2.0.1",
+  "version": "2.0.4",
   "description": "The develop step of Extension.js",
   "author": {
     "name": "Cezar Augusto",