extension-develop 3.8.10 → 3.8.11-canary.216.a962702

package/README.md

@@ -95,7 +95,7 @@ Options accepted by each command. Values shown are typical types or enumerations
 | profile        | string or false                                    | Profile path or disable profile persistence                     |
 | startingUrl    | string                                             | Initial URL to open                                             |
 | open           | boolean                                            | Focus/open the browser window (CLI: use `--no-open` to disable) |
-| --no-runner    | boolean                                            | Skip launching the browser runner                               |
+| --no-browser   | boolean                                            | Skip launching the browser                                      |
 | chromiumBinary | string                                             | Custom Chromium-based executable path                           |
 | geckoBinary    | string                                             | Custom Gecko-based executable path                              |
 

package/dist/535.cjs

@@ -422,11 +422,13 @@ exports.modules = {
                 }
                 if ('true' === process.env.EXTENSION_AUTHOR_MODE) console.log(envSelectedFile(envPath));
                 const envVars = envPath ? external_dotenv_.config({
-                    path: envPath
+                    path: envPath,
+                    quiet: true
                 }).parsed || {} : {};
                 const defaultsPath = external_path_.join(projectPath, '.env.defaults');
                 const defaultsVars = external_fs_.existsSync(defaultsPath) ? external_dotenv_.config({
-                    path: defaultsPath
+                    path: defaultsPath,
+                    quiet: true
                 }).parsed || {} : {};
                 const combinedVars = {
                     ...defaultsVars,
@@ -689,7 +691,7 @@ exports.modules = {
                 compiler.hooks.done.tap('develop:brand', (stats)=>{
                     const hasErrors = Boolean(stats?.hasErrors?.());
                     const hasWarnings = Boolean(stats?.hasWarnings?.());
-                    const runnerEnabled = '0' !== String(process.env.EXTENSION_BROWSER_RUNNER_ENABLED || '1');
+                    const browserLaunchEnabled = '0' !== String(process.env.EXTENSION_BROWSER_LAUNCH_ENABLED || '1');
                     stats.compilation.name = void 0;
                     const duration = stats.compilation.endTime - stats.compilation.startTime;
                     const manifestName = boring_readJsonFileSafe(this.manifestPath).name;
@@ -705,12 +707,12 @@ exports.modules = {
                             });
                             if (hasUserFileChange) this.sawUserInvalidation = true;
                         }
-                        if (runnerEnabled && !(0, shared_state.TC)() && !hasErrors && !hasWarnings) {
+                        if (browserLaunchEnabled && !(0, shared_state.TC)() && !hasErrors && !hasWarnings) {
                             this.printedPostBannerStartupSuccess = true;
                             (0, shared_state.FF)(line);
                             return;
                         }
-                        if (runnerEnabled && !hasErrors && !hasWarnings) {
+                        if (browserLaunchEnabled && !hasErrors && !hasWarnings) {
                             if (!this.sawUserInvalidation) if (this.printedPostBannerStartupSuccess) return;
                             else this.printedPostBannerStartupSuccess = true;
                         }
@@ -10133,6 +10135,7 @@ Set background.noDynamicEntryWarning to true to disable this warning.
             }
         }
         plugin_browsers_define_property(BrowsersPlugin, "name", 'plugin-browsers');
+        var plugin_playwright = __webpack_require__("./webpack/plugin-playwright/index.ts");
         function plugin_wasm_define_property(obj, key, value) {
             if (key in obj) Object.defineProperty(obj, key, {
                 value: value,
@@ -10262,7 +10265,15 @@ Set background.noDynamicEntryWarning to true to disable this warning.
                     manifestPath
                 })
             ];
-            if (!devOptions.noRunner) plugins.push(new BrowsersPlugin({
+            if (devOptions.noBrowser) plugins.push(new plugin_playwright.Tb({
+                packageJsonDir,
+                browser: devOptions.browser,
+                mode: devOptions.mode,
+                outputPath: primaryExtensionOutputDir,
+                manifestPath,
+                port: devOptions.port
+            }));
+            if (!devOptions.noBrowser) plugins.push(new BrowsersPlugin({
                 extension: unpackedExtensionDirsToLoad,
                 browser: devOptions.browser,
                 noOpen: devOptions.noOpen,

package/dist/928.cjs

@@ -11,6 +11,7 @@ exports.modules = {
         var core_ = __webpack_require__("@rspack/core");
         var dev_server_ = __webpack_require__("@rspack/dev-server");
         var external_webpack_merge_ = __webpack_require__("webpack-merge");
+        var external_fs_ = __webpack_require__("fs");
         var external_pintor_ = __webpack_require__("pintor");
         var external_pintor_default = /*#__PURE__*/ __webpack_require__.n(external_pintor_);
         function getLoggingPrefix(type) {
@@ -24,15 +25,39 @@ exports.modules = {
             if ('info' === type) return external_pintor_default().gray('►►►');
             return external_pintor_default().green('►►►');
         }
-        function ready(mode, browser) {
+        function messages_ready(mode, browser) {
             const extensionOutput = 'firefox' === browser || 'gecko-based' === browser || 'edge' === browser ? 'Add-on' : 'Extension';
             const b = String(browser || '');
             const cap = b.charAt(0).toUpperCase() + b.slice(1);
             const pretty = external_pintor_default().green('ready for ' + mode);
             return `${getLoggingPrefix('info')} ${cap} ${extensionOutput} ${pretty}.`;
         }
-        function browserRunnerDisabled() {
-            return `${getLoggingPrefix('info')} Browser runner disabled (no-runner).`;
+        function readJsonRecord(filePath) {
+            try {
+                return JSON.parse(external_fs_.readFileSync(filePath, 'utf8'));
+            } catch  {
+                return null;
+            }
+        }
+        function capitalizeToken(value) {
+            return value.split('-').filter(Boolean).map((token)=>token.charAt(0).toUpperCase() + token.slice(1)).join('-');
+        }
+        function browserRunnerDisabled(args) {
+            const manifest = readJsonRecord(args.manifestPath);
+            const ready = readJsonRecord(args.readyPath);
+            const browserLabel = capitalizeToken(String(args.browser || 'unknown'));
+            const runId = String(ready?.runId || '').trim();
+            const pid = Number.isInteger(ready?.pid) ? String(ready?.pid) : '';
+            const runLine = runId ? ` · ${external_pintor_default().gray('Run')} ${external_pintor_default().gray(runId)}${pid ? ` · ${external_pintor_default().gray(`pid ${pid}`)}` : ''}` : '';
+            const extensionName = String(manifest?.name || 'Extension');
+            const extensionVersion = String(manifest?.version || '').trim();
+            const extensionLabel = extensionVersion ? `${extensionName} ${extensionVersion}` : extensionName;
+            return [
+                ` 🧩 ${external_pintor_default().brightBlue('Extension.js')}`,
+                `    Browser        ${external_pintor_default().gray(browserLabel)}${runLine}`,
+                `    Extension      ${external_pintor_default().gray(extensionLabel)}`,
+                `    Contract       ${external_pintor_default().gray(args.readyPath)}`
+            ].join('\n');
         }
         function portInUse(requestedPort, newPort) {
             return `Port: Requested port ${external_pintor_default().brightBlue(requestedPort.toString())} is in use; using ${external_pintor_default().brightBlue(newPort.toString())} instead.`;
@@ -150,7 +175,6 @@ exports.modules = {
                 this.basePort = basePort;
             }
         }
-        var external_fs_ = __webpack_require__("fs");
         function hasDependency(projectPath, dependency) {
             const findNearestPackageJsonDirectory = (startPath)=>{
                 let currentDirectory = startPath;
@@ -323,9 +347,10 @@ exports.modules = {
             process.on('SIGHUP', cancelAndCleanup);
             return cancelAutoExit;
         }
+        var plugin_playwright = __webpack_require__("./webpack/plugin-playwright/index.ts");
         var webpack_config = __webpack_require__("./webpack/webpack-config.ts");
         async function dev_server_devServer(projectStructure, devOptions) {
-            process.env.EXTENSION_BROWSER_RUNNER_ENABLED = devOptions.noRunner ? '0' : '1';
+            process.env.EXTENSION_BROWSER_LAUNCH_ENABLED = devOptions.noBrowser ? '0' : '1';
             const { manifestPath, packageJsonPath } = projectStructure;
             const manifestDir = external_path_.dirname(manifestPath);
             const packageJsonDir = external_path_.dirname(packageJsonPath);
@@ -383,6 +408,14 @@ exports.modules = {
                 }
             };
             const compiler = (0, core_.rspack)(compilerConfig);
+            const metadata = (0, plugin_playwright.Ih)({
+                packageJsonDir,
+                browser: String(devOptions.browser || 'chromium'),
+                command: 'dev',
+                distPath: external_path_.join(packageJsonDir, 'dist', String(devOptions.browser || 'chromium')),
+                manifestPath,
+                port
+            });
             setupCompilerHooks(compiler, portAllocation.port);
             if (void 0 !== devOptions.port && devOptions.port !== port) console.log(portInUse(devOptions.port, port));
             const serverConfig = {
@@ -435,10 +468,15 @@ exports.modules = {
                 }, START_TIMEOUT_MS);
                 await devServer.start();
                 if (startTimeout) clearTimeout(startTimeout);
-                console.log(ready('development', devOptions.browser));
-                if (devOptions.noRunner) console.log(browserRunnerDisabled());
+                console.log(messages_ready('development', devOptions.browser));
+                if (devOptions.noBrowser) console.log(browserRunnerDisabled({
+                    browser: String(devOptions.browser || 'chromium'),
+                    manifestPath,
+                    readyPath: metadata.readyPath
+                }));
             } catch (error) {
                 if (startTimeout) clearTimeout(startTimeout);
+                metadata.writeError('dev_server_start_failed', error instanceof Error ? error.message : String(error));
                 console.log(extensionJsRunnerError(error));
                 process.exit(1);
             }

package/dist/module.cjs

@@ -133062,6 +133062,193 @@ var __webpack_modules__ = {
             };
         }
     },
+    "./webpack/plugin-playwright/index.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        "use strict";
+        __webpack_require__.d(__webpack_exports__, {
+            Ih: ()=>createPlaywrightMetadataWriter,
+            Tb: ()=>PlaywrightPlugin
+        });
+        var fs__rspack_import_0 = __webpack_require__("fs");
+        var path__rspack_import_1 = __webpack_require__("path");
+        var _webpack_lib_paths__rspack_import_2 = __webpack_require__("./webpack/webpack-lib/paths.ts");
+        function _define_property(obj, key, value) {
+            if (key in obj) Object.defineProperty(obj, key, {
+                value: value,
+                enumerable: true,
+                configurable: true,
+                writable: true
+            });
+            else obj[key] = value;
+            return obj;
+        }
+        function nowISO() {
+            return new Date().toISOString();
+        }
+        function createRunId() {
+            return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+        }
+        function ensureDirSync(dirPath) {
+            try {
+                fs__rspack_import_0.mkdirSync(dirPath, {
+                    recursive: true
+                });
+            } catch  {}
+        }
+        function writeJsonAtomic(filePath, value) {
+            try {
+                const tmpPath = `${filePath}.tmp-${process.pid}`;
+                fs__rspack_import_0.writeFileSync(tmpPath, JSON.stringify(value, null, 2) + '\n', 'utf-8');
+                fs__rspack_import_0.renameSync(tmpPath, filePath);
+            } catch  {}
+        }
+        function getPlaywrightMetadataDir(packageJsonDir, browser) {
+            return (0, _webpack_lib_paths__rspack_import_2.G6)(path__rspack_import_1.join(packageJsonDir, 'dist', 'extension-js', browser));
+        }
+        function createPlaywrightMetadataWriter(options) {
+            const metadataDir = getPlaywrightMetadataDir(options.packageJsonDir, options.browser);
+            const readyPath = (0, _webpack_lib_paths__rspack_import_2.G6)(path__rspack_import_1.join(metadataDir, 'ready.json'));
+            const eventsPath = (0, _webpack_lib_paths__rspack_import_2.G6)(path__rspack_import_1.join(metadataDir, 'events.ndjson'));
+            const base = {
+                command: options.command,
+                browser: options.browser,
+                runId: createRunId(),
+                startedAt: nowISO(),
+                distPath: options.distPath,
+                manifestPath: options.manifestPath,
+                port: (()=>{
+                    if ('number' == typeof options.port && Number.isFinite(options.port)) return options.port;
+                    if ('string' == typeof options.port) {
+                        const parsed = parseInt(options.port, 10);
+                        return Number.isFinite(parsed) ? parsed : null;
+                    }
+                    return null;
+                })()
+            };
+            function writeReady(status, extra) {
+                ensureDirSync(metadataDir);
+                const payload = {
+                    ...base,
+                    status,
+                    pid: process.pid,
+                    ts: nowISO(),
+                    compiledAt: extra?.compiledAt ?? null,
+                    errors: Array.isArray(extra?.errors) ? extra.errors : []
+                };
+                if (extra?.code) payload.code = extra.code;
+                if (extra?.message) payload.message = extra.message;
+                writeJsonAtomic(readyPath, payload);
+            }
+            function appendEvent(event) {
+                ensureDirSync(metadataDir);
+                try {
+                    fs__rspack_import_0.appendFileSync(eventsPath, `${JSON.stringify(event)}\n`, 'utf-8');
+                } catch  {}
+            }
+            return {
+                metadataDir,
+                readyPath,
+                eventsPath,
+                writeStarting () {
+                    writeReady('starting');
+                },
+                writeReady (compiledAt) {
+                    writeReady('ready', {
+                        compiledAt: compiledAt || nowISO()
+                    });
+                },
+                writeError (code, message, errors) {
+                    writeReady('error', {
+                        code,
+                        message,
+                        errors: Array.isArray(errors) ? errors : [],
+                        compiledAt: null
+                    });
+                },
+                appendEvent
+            };
+        }
+        class PlaywrightPlugin {
+            apply(compiler) {
+                this.writer.writeStarting();
+                compiler.hooks.compile.tap(PlaywrightPlugin.name, ()=>{
+                    this.writer.appendEvent({
+                        type: 'compile_start',
+                        ts: nowISO(),
+                        command: this.command,
+                        browser: this.browser
+                    });
+                });
+                compiler.hooks.done.tap(PlaywrightPlugin.name, (stats)=>{
+                    const durationMs = Number((stats?.compilation?.endTime || 0) - (stats?.compilation?.startTime || 0));
+                    const hasErrors = Boolean(stats?.hasErrors?.());
+                    const errorsCount = Number(Array.isArray(stats?.toJson?.({
+                        all: false,
+                        errors: true
+                    })?.errors) ? stats.toJson({
+                        all: false,
+                        errors: true
+                    }).errors.length : 0);
+                    if (hasErrors) {
+                        this.writer.appendEvent({
+                            type: 'compile_error',
+                            ts: nowISO(),
+                            command: this.command,
+                            browser: this.browser,
+                            durationMs: Number.isFinite(durationMs) ? durationMs : void 0,
+                            errorCount: Number.isFinite(errorsCount) ? errorsCount : 1
+                        });
+                        this.writer.writeError('compile_error', 'Compilation failed', [
+                            `errors: ${String(errorsCount || 1)}`
+                        ]);
+                        return;
+                    }
+                    this.writer.appendEvent({
+                        type: 'compile_success',
+                        ts: nowISO(),
+                        command: this.command,
+                        browser: this.browser,
+                        durationMs: Number.isFinite(durationMs) ? durationMs : void 0,
+                        errorCount: 0
+                    });
+                    this.writer.writeReady(nowISO());
+                });
+                compiler.hooks.failed.tap(PlaywrightPlugin.name, (error)=>{
+                    this.writer.appendEvent({
+                        type: 'compile_error',
+                        ts: nowISO(),
+                        command: this.command,
+                        browser: this.browser,
+                        errorCount: 1
+                    });
+                    this.writer.writeError('compile_failed', error instanceof Error ? error.message : String(error));
+                });
+                compiler.hooks.watchClose.tap(PlaywrightPlugin.name, ()=>{
+                    this.writer.appendEvent({
+                        type: 'shutdown',
+                        ts: nowISO(),
+                        command: this.command,
+                        browser: this.browser
+                    });
+                });
+            }
+            constructor(options){
+                _define_property(this, "writer", void 0);
+                _define_property(this, "command", void 0);
+                _define_property(this, "browser", void 0);
+                this.browser = String(options.browser || 'chromium');
+                this.command = options.command || ('development' === options.mode ? 'dev' : 'start');
+                this.writer = createPlaywrightMetadataWriter({
+                    packageJsonDir: options.packageJsonDir,
+                    browser: this.browser,
+                    command: this.command,
+                    distPath: options.outputPath,
+                    manifestPath: options.manifestPath,
+                    port: options.port
+                });
+            }
+        }
+        _define_property(PlaywrightPlugin, "name", 'plugin-playwright');
+    },
     "./webpack/webpack-lib/check-build-dependencies.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         "use strict";
         __webpack_require__.d(__webpack_exports__, {
@@ -133165,7 +133352,8 @@ var __webpack_modules__ = {
                 if (external_fs_.existsSync(defaultsPath)) {
                     external_dotenv_default().config({
                         path: defaultsPath,
-                        override: Boolean(options?.override)
+                        override: Boolean(options?.override),
+                        quiet: true
                     });
                     loadedAny = true;
                 }
@@ -133179,7 +133367,8 @@ var __webpack_modules__ = {
                     if (external_fs_.existsSync(filePath)) {
                         external_dotenv_default().config({
                             path: filePath,
-                            override: Boolean(options?.override)
+                            override: Boolean(options?.override),
+                            quiet: true
                         });
                         loadedAny = true;
                         break;
@@ -133637,12 +133826,12 @@ var __webpack_modules__ = {
             gC: ()=>unpackagingExtension,
             jM: ()=>debugExtensionsToLoad,
             jV: ()=>debugPreviewOutput,
+            k4: ()=>previewSkippedNoBrowser,
             ng: ()=>writingTypeDefinitions,
             tQ: ()=>fetchingProjectPath,
             tc: ()=>invalidRemoteZip,
             v_: ()=>writingTypeDefinitionsError,
             vo: ()=>buildDependenciesManualInstall,
-            wH: ()=>previewSkippedNoRunner,
             xK: ()=>installingBuildDependencies,
             yp: ()=>noCompanionExtensionsResolved,
             zM: ()=>unpackagedSuccessfully
@@ -133703,8 +133892,8 @@ var __webpack_modules__ = {
         function previewing(browser) {
             return `${getLoggingPrefix('info')} Previewing the extension on ${capitalizedBrowserName(browser)}...`;
         }
-        function previewSkippedNoRunner(browser) {
-            return `${getLoggingPrefix('info')} Skipping browser runner for ${capitalizedBrowserName(browser)} (no-runner).`;
+        function previewSkippedNoBrowser(browser) {
+            return `${getLoggingPrefix('info')} Skipping browser launch for ${capitalizedBrowserName(browser)} (no-browser).`;
         }
         function installingRequiredDependencies() {
             const suffix = 'true' === process.env.EXTENSION_ONE_TIME_INSTALL_HINT ? ' (this is a one time operation)' : '';
@@ -134830,7 +135019,7 @@ var __webpack_modules__ = {
     },
     "./package.json" (module) {
         "use strict";
-        module.exports = JSON.parse('{"rE":"3.8.10","El":{"@rspack/core":"^1.7.5","@rspack/dev-server":"^1.1.5","@swc/core":"^1.15.8","@swc/helpers":"^0.5.18","adm-zip":"^0.5.16","browser-extension-manifest-fields":"^2.2.1","case-sensitive-paths-webpack-plugin":"^2.4.0","chrome-location2":"4.0.0","chromium-location":"2.0.0","content-security-policy-parser":"^0.6.0","cross-spawn":"^7.0.6","dotenv":"^17.2.3","edge-location":"2.2.0","extension-from-store":"^0.1.1","firefox-location2":"3.0.0","go-git-it":"^5.1.1","ignore":"^7.0.5","loader-utils":"^3.3.1","magic-string":"^0.30.21","parse5":"^8.0.0","parse5-utilities":"^1.0.0","pintor":"0.3.0","schema-utils":"^4.3.3","tiny-glob":"^0.2.9","unique-names-generator":"^4.7.1","webextension-polyfill":"^0.12.0","webpack-merge":"^6.0.1","webpack-target-webextension":"^2.1.3","ws":"^8.19.0"}}');
+        module.exports = JSON.parse('{"rE":"3.8.11-canary.216.a962702","El":{"@rspack/core":"^1.7.5","@rspack/dev-server":"^1.1.5","@swc/core":"^1.15.8","@swc/helpers":"^0.5.18","adm-zip":"^0.5.16","browser-extension-manifest-fields":"^2.2.1","case-sensitive-paths-webpack-plugin":"^2.4.0","chrome-location2":"4.0.0","chromium-location":"2.0.0","content-security-policy-parser":"^0.6.0","cross-spawn":"^7.0.6","dotenv":"^17.2.3","edge-location":"2.2.0","extension-from-store":"^0.1.1","firefox-location2":"3.0.0","go-git-it":"^5.1.1","ignore":"^7.0.5","loader-utils":"^3.3.1","magic-string":"^0.30.21","parse5":"^8.0.0","parse5-utilities":"^1.0.0","pintor":"0.3.0","schema-utils":"^4.3.3","tiny-glob":"^0.2.9","unique-names-generator":"^4.7.1","webextension-polyfill":"^0.12.0","webpack-merge":"^6.0.1","webpack-target-webextension":"^2.1.3","ws":"^8.19.0"}}');
     }
 };
 var __webpack_module_cache__ = {};
@@ -135401,9 +135590,13 @@ var __webpack_exports__ = {};
         return external_path_.join(cacheDir, 'version.json');
     }
     function getProjectDepsHash(projectPath) {
+        const lockfileSignature = getNearestLockfileSignature(projectPath);
         try {
             const packageJsonPath = external_path_.join(projectPath, 'package.json');
-            if (!external_fs_.existsSync(packageJsonPath)) return 'no-package-json';
+            if (!external_fs_.existsSync(packageJsonPath)) return (0, external_crypto_.createHash)('sha1').update(JSON.stringify({
+                packageJson: 'no-package-json',
+                lockfile: lockfileSignature
+            })).digest('hex');
             const raw = external_fs_.readFileSync(packageJsonPath, 'utf8');
             const parsed = JSON.parse(raw || '{}');
             const deps = parsed?.dependencies || {};
@@ -135416,12 +135609,42 @@ var __webpack_exports__ = {};
             };
             const stable = JSON.stringify({
                 dependencies: normalize(deps),
-                devDependencies: normalize(devDeps)
+                devDependencies: normalize(devDeps),
+                lockfile: lockfileSignature
             });
             return (0, external_crypto_.createHash)('sha1').update(stable).digest('hex');
         } catch  {
-            return 'invalid-package-json';
+            return (0, external_crypto_.createHash)('sha1').update(JSON.stringify({
+                packageJson: 'invalid-package-json',
+                lockfile: lockfileSignature
+            })).digest('hex');
+        }
+    }
+    function getNearestLockfileSignature(projectPath) {
+        const lockfileNames = [
+            'pnpm-lock.yaml',
+            'package-lock.json',
+            'yarn.lock',
+            'bun.lock',
+            'bun.lockb'
+        ];
+        let current = external_path_.resolve(projectPath);
+        while(true){
+            for (const lockfileName of lockfileNames){
+                const lockfilePath = external_path_.join(current, lockfileName);
+                if (external_fs_.existsSync(lockfilePath)) try {
+                    const content = external_fs_.readFileSync(lockfilePath);
+                    const digest = (0, external_crypto_.createHash)('sha1').update(content).digest('hex');
+                    return `${lockfileName}:${digest}`;
+                } catch  {
+                    return `${lockfileName}:unreadable`;
+                }
+            }
+            const parent = external_path_.dirname(current);
+            if (parent === current) break;
+            current = parent;
         }
+        return 'none';
     }
     function ensureCacheVersion(cacheDir) {
         const versionPath = getCacheVersionPath(cacheDir);
@@ -135851,6 +136074,7 @@ var __webpack_exports__ = {};
             process.exit(1);
         }
     }
+    var plugin_playwright = __webpack_require__("./webpack/plugin-playwright/index.ts");
     var sanitize = __webpack_require__("./webpack/webpack-lib/sanitize.ts");
     var utils = __webpack_require__("./webpack/feature-special-folders/folder-extensions/utils.ts");
     function resolveCompanionExtensionDirs(opts) {
@@ -135995,17 +136219,33 @@ var __webpack_exports__ = {};
         const browser = (0, webpack_lib_paths.YN)(previewOptions.browser || 'chrome', previewOptions.chromiumBinary, previewOptions.geckoBinary || previewOptions.firefoxBinary);
         const outputPath = (0, webpack_lib_paths.u2)(projectStructure, browser, previewOptions.outputPath);
         const distPath = (0, webpack_lib_paths.q4)(packageJsonDir, browser);
+        const metadata = (0, plugin_playwright.Ih)({
+            packageJsonDir,
+            browser: String(browser),
+            command: 'preview',
+            distPath,
+            manifestPath: projectStructure.manifestPath,
+            port: 'number' == typeof previewOptions.port ? previewOptions.port : 'string' == typeof previewOptions.port ? parseInt(previewOptions.port, 10) : null
+        });
+        metadata.writeStarting();
         if (debug) {
             console.log(messages.SG(manifestDir, packageJsonDir));
             console.log(messages._A(browser, previewOptions.chromiumBinary, previewOptions.geckoBinary || previewOptions.firefoxBinary));
             console.log(messages.jV(outputPath, distPath));
         }
         const manifestAtOutput = external_path_.join(outputPath, 'manifest.json');
-        if (!external_fs_.existsSync(manifestAtOutput)) throw new Error(`Preview is run-only and does not compile.\nExpected an unpacked extension at:\n  ${manifestAtOutput}\n\nRun \`extension build\` or \`extension dev\` first, or pass --output-path to an existing unpacked extension directory.`);
+        if (!external_fs_.existsSync(manifestAtOutput)) {
+            metadata.writeError('preview_manifest_missing', `Expected manifest at ${manifestAtOutput}`);
+            throw new Error(`Preview is run-only and does not compile.\nExpected an unpacked extension at:\n  ${manifestAtOutput}\n\nRun \`extension build\` or \`extension dev\` first, or pass --output-path to an existing unpacked extension directory.`);
+        }
         const commandConfig = await (0, config_loader.eY)(packageJsonDir, 'preview');
         const browserConfig = await (0, config_loader.xY)(packageJsonDir, browser);
         console.log(messages.V_(browser));
-        if (previewOptions.noRunner) return void console.log(messages.wH(browser));
+        if (previewOptions.noBrowser) {
+            console.log(messages.k4(browser));
+            metadata.writeReady();
+            return;
+        }
         const safeBrowserConfig = (0, sanitize.a)(browserConfig);
         const safeCommandConfig = (0, sanitize.a)(commandConfig);
         const safePreviewOptions = (0, sanitize.a)(previewOptions);
@@ -136054,6 +136294,7 @@ var __webpack_exports__ = {};
             port: merged.port,
             dryRun: merged.dryRun
         });
+        metadata.writeReady();
     }
     async function extensionStart(pathOrRemoteUrl, startOptions) {
         const projectStructure = await getProjectStructure(pathOrRemoteUrl);

package/package.json

@@ -24,7 +24,7 @@
     "webpack/webpack-lib/build-dependencies.json"
   ],
   "name": "extension-develop",
-  "version": "3.8.10",
+  "version": "3.8.11-canary.216.a962702",
   "description": "Develop, build, preview, and package Extension.js projects.",
   "author": {
     "name": "Cezar Augusto",