extension-develop 4.1.19 → 4.1.21

package/dist/950~0.mjs

@@ -84,10 +84,11 @@ function buildAssetsTree(stats) {
     const assets = statsJson?.assets || [];
     return getAssetsTree(assets);
 }
-function buildComplete(browser, distDisplayPath, totalBytes) {
+function buildComplete(browser, distDisplayPath, totalBytes, mode) {
     const noun = artifactNoun(String(browser));
+    const builtFor = 'development' === mode ? 'built for development in' : 'none' === mode ? 'built in' : 'built for production in';
     const size = 'number' == typeof totalBytes && totalBytes > 0 ? ` (${getHumanSize(totalBytes)})` : '';
-    return `${getLoggingPrefix('success')} ${noun} built for production in ${pintor.underline(distDisplayPath)}${size}.`;
+    return `${getLoggingPrefix('success')} ${noun} ${builtFor} ${pintor.underline(distDisplayPath)}${size}.`;
 }
 function platformDocsUrl() {
     return String(process.env.EXTENSION_DEV_DOCS_URL || '').trim().replace(/\/+$/, '');
@@ -101,10 +102,17 @@ function addonLintSummary(errorCount, warningCount, distDisplay) {
     if (warningCount > 0) parts.push(pluralize(warningCount, 'warning'));
     return `${getLoggingPrefix('warn')} Store check for addons.mozilla.org: addons-linter found ${parts.join(' and ')} in ${pintor.underline(distDisplay)}`;
 }
-function addonLintFinding(level, code, message, location) {
+function addonLintFinding(level, code, message, location, attribution) {
     const glyph = getLoggingPrefix('error' === level ? 'warn' : 'info');
     const where = location ? ` ${pintor.gray(`(${location})`)}` : '';
-    return `${glyph} AMO ${level} ${pintor.yellow(code)}: ${message}${where}`;
+    const from = attribution ? ` ${pintor.gray(attribution)}` : '';
+    return `${glyph} AMO ${level} ${pintor.yellow(code)}: ${message}${where}${from}`;
+}
+function addonLintDependencyAttribution(packages, onlyDependencies) {
+    if (0 === packages.length) return '';
+    const named = packages.slice(0, 3).join(', ');
+    const rest = packages.length > 3 ? `, +${packages.length - 3} more` : '';
+    return onlyDependencies ? `- this file is bundled dependency code (${named}${rest}), not yours` : `- this file also bundles ${named}${rest}, so the finding may be theirs`;
 }
 function addonLintMore(hiddenCount, distDisplay) {
     return `${getLoggingPrefix('info')} ${pluralize(hiddenCount, 'more finding')} not shown. Run ${pintor.blue(`npx addons-linter ${distDisplay}`)} for the full report.`;
@@ -197,17 +205,9 @@ function buildWarningsDetails(warnings) {
     });
     return blocks.join('\n\n');
 }
-function fetchingProjectPath(owner, project) {
-    return fmt.block('Fetching project', [
-        [
-            'URL',
-            fmt.val(`https://github.com/${owner}/${project}`)
-        ]
-    ]);
-}
-function downloadingProjectPath(projectName) {
+function downloadingProjectPath(projectName, url) {
     const formatted = isPathLike(projectName) ? pintor.underline(projectName) : projectName;
-    return `${getLoggingPrefix('info')} Downloading ${formatted}…`;
+    return `${getLoggingPrefix('info')} Downloading ${formatted}…\n${pintor.gray('URL')} ${fmt.val(url)}`;
 }
 function creatingProjectPath() {
     return `${getLoggingPrefix('info')} Creating a new browser extension…`;
@@ -240,12 +240,7 @@ function writingTypeDefinitionsError(error) {
     return `${getLoggingPrefix('error')} Couldn't write the extension type definitions.\n${pintor.gray('REASON')} ${pintor.red(String(error))}\nCheck the file permissions, then try again.`;
 }
 function downloadingText(url) {
-    return fmt.block('Downloading extension', [
-        [
-            'URL',
-            fmt.val(url)
-        ]
-    ]);
+    return `${getLoggingPrefix('info')} Downloading the browser extension…\n${pintor.gray('URL')} ${fmt.val(url)}`;
 }
 function unpackagingExtension(zipFilePath) {
     return `${getLoggingPrefix('info')} Unpackaging the browser extension…\n${pintor.gray('PATH')} ${pintor.underline(zipFilePath)}`;
@@ -590,12 +585,9 @@ async function getProjectPath(pathOrRemoteUrl) {
                 const urlSource = await importUrlSourceFromZip(pathOrRemoteUrl);
                 return urlSource;
             }
-            const urlData = url.pathname.split('/');
-            const owner = urlData.slice(1, 3)[0];
-            const project = urlData.slice(1, 3)[1];
-            console.log(fetchingProjectPath(owner, project));
+            const [owner, project] = url.pathname.split('/').slice(1, 3);
             const projectName = __rspack_external_node_path_806ed179.basename(url.pathname);
-            const urlSource = await importUrlSourceFromGithub(pathOrRemoteUrl, downloadingProjectPath(projectName));
+            const urlSource = await importUrlSourceFromGithub(pathOrRemoteUrl, downloadingProjectPath(projectName, `https://github.com/${owner}/${project}`));
             console.log(creatingProjectPath());
             return urlSource;
         }
@@ -978,4 +970,4 @@ function actionsPath(projectPath, browser) {
 function buildSummaryPath(projectPath, browser) {
     return __rspack_external_node_path_806ed179.join(browserArtifactsDir(projectPath, browser), 'build-summary.json');
 }
-export { actionsPath, addonLintFailed, addonLintFinding, addonLintMore, addonLintNotInstalled, addonLintSummary, anotherDevSessionActive, asAbsolute, authorInstallNotice, browserArtifactsDir, browserDistDir, browserLaunchFailed, browserProfileRootDir, buildAssetsTree, buildCommandFailed, buildComplete, buildFailed, buildShareHint, buildSummaryPath, buildWarningsDetails, computePreviewOutputPath, configBrowserOrThrow, configLoadingError, controlPortFilePath, controlTokenPath, debugBrowser, debugContextPath, debugDirs, debugExtensionsToLoad, debugOutputPath, debugPreviewOutput, debugSplitChunksNarrowed, devCommandFailed, devtoolsEngineFor, downloadingText, ensureSessionArtifactsIgnoreFile, ensureSessionStateInProjectGitignore, eventsPath, extensionLoadRecovered, extensionLoadStillRefused, failedToDownloadOrExtractZIPFileError, getDirs, getDistPath, getProjectStructure, invalidRemoteZip, isUsingExperimentalConfig, legacyControlPortFilePath, legacyControlTokenPath, localZipNotFound, logsPath, managedDependencyConflict, manifestInvalidJson, needsInstall, noCompanionExtensionsResolved, normalizeBrowser, notAZipArchive, packagingDistributionFiles, packagingSourceFiles, previewing, previewingCustomOutput, previewingSourceFallback, projectInstallFallbackToNpm, projectInstallInWorkspaceRoot, projectInstallScriptsDisabled, readyContractPath, resolveProjectStructureSync, sessionArtifactsRootDir, sessionStateDir, starting, toPosixPath, treeWithDistFilesBrowser, treeWithSourceAndDistFiles, treeWithSourceFiles, unpackagedSuccessfully, unpackagingExtension, writingTypeDefinitions, writingTypeDefinitionsError, zipArtifactReady };
+export { actionsPath, addonLintDependencyAttribution, addonLintFailed, addonLintFinding, addonLintMore, addonLintNotInstalled, addonLintSummary, anotherDevSessionActive, asAbsolute, authorInstallNotice, browserArtifactsDir, browserDistDir, browserLaunchFailed, browserProfileRootDir, buildAssetsTree, buildCommandFailed, buildComplete, buildFailed, buildShareHint, buildSummaryPath, buildWarningsDetails, computePreviewOutputPath, configBrowserOrThrow, configLoadingError, controlPortFilePath, controlTokenPath, debugBrowser, debugContextPath, debugDirs, debugExtensionsToLoad, debugOutputPath, debugPreviewOutput, debugSplitChunksNarrowed, devCommandFailed, devtoolsEngineFor, downloadingText, ensureSessionArtifactsIgnoreFile, ensureSessionStateInProjectGitignore, eventsPath, extensionLoadRecovered, extensionLoadStillRefused, failedToDownloadOrExtractZIPFileError, getDirs, getDistPath, getProjectStructure, invalidRemoteZip, isUsingExperimentalConfig, legacyControlPortFilePath, legacyControlTokenPath, localZipNotFound, logsPath, managedDependencyConflict, manifestInvalidJson, needsInstall, noCompanionExtensionsResolved, normalizeBrowser, notAZipArchive, packagingDistributionFiles, packagingSourceFiles, previewing, previewingCustomOutput, previewingSourceFallback, projectInstallFallbackToNpm, projectInstallInWorkspaceRoot, projectInstallScriptsDisabled, readyContractPath, resolveProjectStructureSync, sessionArtifactsRootDir, sessionStateDir, starting, toPosixPath, treeWithDistFilesBrowser, treeWithSourceAndDistFiles, treeWithSourceFiles, unpackagedSuccessfully, unpackagingExtension, writingTypeDefinitions, writingTypeDefinitionsError, zipArtifactReady };

package/dist/dev-server/control-bridge/actions-file.d.ts

@@ -28,7 +28,6 @@ export declare class ActionsFileWriter implements ActionsSink {
     private lines;
     private started;
     constructor(options: ActionsFileOptions);
-    /** Rotate any prior file so a new run starts clean. No header is written. */
     start(): void;
     write(record: ActionRecord): void;
     close(): void;

package/dist/dev-server/control-bridge/broker.d.ts

@@ -10,7 +10,7 @@ export interface BridgeConnection {
 export interface BridgeBrokerOptions {
     instanceId: string;
     runId: string;
-    engine?: 'chromium' | 'firefox';
+    engine?: 'chromium' | 'firefox' | 'webkit';
     ring?: LogRingBuffer;
     file?: LogsFileWriter;
     allowControl?: boolean;
@@ -22,6 +22,7 @@ export interface BridgeBrokerOptions {
     setTimer?: (fn: () => void, ms: number) => ReturnType<typeof setTimeout>;
     clearTimer?: (handle: ReturnType<typeof setTimeout>) => void;
     onExecutorAttached?: () => void;
+    onExecutorDetached?: () => void;
 }
 export { CLOSE_BAD_HELLO, CLOSE_BAD_INSTANCE, CLOSE_CONTROL_UNAVAILABLE, CLOSE_SLOW_CONSUMER } from './contracts.js';
 export declare const DEFAULT_CMD_TIMEOUT_MS = 5000;
@@ -47,8 +48,8 @@ export declare class BridgeBroker {
     private producerEverConnected;
     private readonly sessionStartedAt;
     private lastUndeliveredWarnKind;
-    /** Fired once, on the first producer hello, to stamp ready.json. */
     private readonly onExecutorAttached?;
+    private readonly onExecutorDetached?;
     private lastProducerDisconnectedAt;
     private lastStaleHelloAt;
     private pendingReload?;
@@ -66,10 +67,11 @@ export declare class BridgeBroker {
         changedFiles?: string[];
         changedScriptFiles?: string[];
     }): number;
-    undeliveredReloadWarning(): string | null;
+    undeliveredReloadWarning(options?: {
+        producerRestartExpected?: boolean;
+    }): string | null;
     pingProducers(): number;
     ingestLog(incoming: IncomingLogEvent): void;
-    /** At most 3 stale-producer resync reloads per rolling minute. */
     private allowStaleProducerResync;
     private onHello;
     private diagnoseExecutorAbsence;

package/dist/dev-server/control-bridge/contracts.d.ts

@@ -68,7 +68,7 @@ export interface ReadyFrame {
     type: 'ready';
     runId: string;
     bufferedFrom?: number;
-    engine?: 'chromium' | 'firefox';
+    engine?: 'chromium' | 'firefox' | 'webkit';
     capabilities?: {
         eval?: boolean;
         storage?: boolean;

package/dist/dev-server/control-bridge/logs-file.d.ts

@@ -25,6 +25,5 @@ export declare class LogsFileWriter {
     private maybeNoteDrops;
     private writeHeader;
     private rotatedName;
-    /** Shift generations: drop the oldest, age each, move current → .1 */
     private rotate;
 }

package/dist/dev-server/control-bridge/producer-runtime.d.ts

@@ -1,5 +1,5 @@
 export declare const CONTROL_PORT_ASSET_NAME = "extension-js-control.json";
-export declare const BRIDGE_PRODUCER_SOURCE = ";(function () {\n  try {\n    var g = (typeof globalThis === \"object\" && globalThis) ? globalThis : this;\n    if (!g || g.__extjsBridgeProducerInstalled) return;\n\n    var PORT = parseInt(\"__EXTJS_CONTROL_PORT__\", 10);\n    var INSTANCE_ID = \"__EXTJS_INSTANCE_ID__\";\n    var CONTEXT = \"__EXTJS_CONTEXT__\";\n    // Connectable host of the dev-server control WS. Baked from the resolved\n    // connectable host (loopback locally; the public host for remote/devcontainer).\n    var HOST = \"__EXTJS_CONTROL_HOST__\";\n    if (!HOST || HOST.indexOf(\"__EXTJS\") === 0) HOST = \"127.0.0.1\";\n    if (!PORT || PORT < 1) return;\n\n    var WS = g.WebSocket;\n    if (typeof WS !== \"function\") return;\n\n    var consoleRef = g.console || {};\n    g.__extjsBridgeProducerInstalled = true;\n\n    // Capture extension event listeners at install time: these wraps run\n    // BEFORE user code, and no platform API exists to dispatch these events.\n    function captureEvent(event, sink) {\n      try {\n        if (!event || typeof event.addListener !== \"function\") return;\n        var origAdd = event.addListener.bind(event);\n        event.addListener = function (cb) {\n          if (typeof cb === \"function\" && sink.indexOf(cb) === -1) sink.push(cb);\n          return origAdd(cb);\n        };\n        if (typeof event.removeListener === \"function\") {\n          var origRemove = event.removeListener.bind(event);\n          event.removeListener = function (cb) {\n            var i = sink.indexOf(cb);\n            if (i !== -1) sink.splice(i, 1);\n            return origRemove(cb);\n          };\n        }\n      } catch (e) { /* non-fatal: trigger falls back to its no-listener reply */ }\n    }\n\n    // Use the raw globals (not the hoisted chrome var below). This runs first.\n    // On Gecko browser.* is a DISTINCT wrapper object: hook BOTH namespaces.\n    var actionClickedListeners = [];\n    var commandListeners = [];\n    var capturedEvents = [];\n    function captureEventOnce(event, sink) {\n      // Polyfilled extensions expose ONE event object on both namespaces:\n      // wrap it once, and the sink dedupes callbacks shared across wrappers.\n      if (!event || capturedEvents.indexOf(event) !== -1) return;\n      capturedEvents.push(event);\n      captureEvent(event, sink);\n    }\n    var captureNamespaces = [g.chrome, g.browser];\n    for (var cn = 0; cn < captureNamespaces.length; cn++) {\n      var capNS = captureNamespaces[cn];\n      if (!capNS) continue;\n      captureEventOnce(capNS.action && capNS.action.onClicked, actionClickedListeners);\n      captureEventOnce(capNS.commands && capNS.commands.onCommand, commandListeners);\n    }\n\n    var LEVELS = [\"log\", \"info\", \"warn\", \"error\", \"debug\", \"trace\"];\n    var socket = null;\n    var open = false;\n    var queue = [];\n    var backoff = 250;\n    var MAX_BACKOFF = 5000;\n    var connectFailures = 0;\n    var MAX_QUEUE = 1000;\n    var MAX_RESULT_BYTES = 256 * 1024;\n\n    function nowId() {\n      return Date.now().toString(36) + Math.random().toString(36).slice(2, 8);\n    }\n\n    function engineName() {\n      try {\n        return (typeof navigator !== \"undefined\" && /firefox/i.test(navigator.userAgent)) ? \"firefox\" : \"chromium\";\n      } catch (e) { return \"chromium\"; }\n    }\n\n    function safeValue(v) {\n      try {\n        var s = JSON.stringify(v);\n        if (s === undefined) return {value: undefined, truncated: false};\n        if (s.length > MAX_RESULT_BYTES) {\n          return {value: {__type: \"truncated\", preview: s.slice(0, 1024)}, truncated: true};\n        }\n        return {value: JSON.parse(s), truncated: false};\n      } catch (e) {\n        return {value: {__type: \"unserializable\", preview: String(v).slice(0, 512)}, truncated: false};\n      }\n    }\n\n    function replyOk(cmdId, value) {\n      var s = safeValue(value);\n      var frame = {type: \"result\", cmdId: cmdId, ok: true, value: s.value};\n      if (s.truncated) frame.truncated = true;\n      try { socket && socket.send(JSON.stringify(frame)); } catch (e) {\n        // Ignore\n      }\n    }\n\n    function replyErr(cmdId, name, message, code) {\n      var frame = {type: \"result\", cmdId: cmdId, ok: false, error: {name: name, message: String(message), engine: engineName()}};\n      if (code) frame.error.code = code;\n      try { socket && socket.send(JSON.stringify(frame)); } catch (e) {\n        // Ignore\n      }\n    }\n\n    // Name the refusal the browser wrote as prose, so a consumer branches on\n    // error.code instead of matching the engine's sentence.\n    function openRefusalCode(message) {\n      var m = String(message == null ? \"\" : message);\n      if (/user gesture|user input|user interaction|user action/i.test(m)) return \"needs_user_gesture\";\n      if (/browser window|active window/i.test(m)) return \"needs_headed_window\";\n      return undefined;\n    }\n\n    // Resolve a numeric tab id when the caller did not pass one: match\n    // target.url against open tabs, else default to the active tab. (#51)\n    function resolveTargetTab(target, cb) {\n      var chrome = g.chrome;\n      if (!chrome || !chrome.tabs) { cb(null, \"chrome.tabs is not available\"); return; }\n      var url = target && target.url;\n      if (url) {\n        var substringMatch = function () {\n          try {\n            chrome.tabs.query({}, function (all) {\n              var hit = (all || []).filter(function (t) { return t.url && String(t.url).indexOf(url) !== -1; })[0];\n              if (hit && typeof hit.id === \"number\") { cb(hit.id, null); return; }\n              cb(null, \"no open tab matches url: \" + url);\n            });\n          } catch (e2) { cb(null, \"tab query failed\"); }\n        };\n        try {\n          // chrome.tabs.query accepts URL match patterns; a bare url/glob may\n          // not be a valid pattern, so fall back to a substring scan.\n          chrome.tabs.query({url: url}, function (tabs) {\n            if (chrome.runtime && chrome.runtime.lastError) { substringMatch(); return; }\n            if (tabs && tabs.length && typeof tabs[0].id === \"number\") { cb(tabs[0].id, null); return; }\n            substringMatch();\n          });\n        } catch (e) { substringMatch(); }\n        return;\n      }\n      try {\n        chrome.tabs.query({active: true, lastFocusedWindow: true}, function (tabs) {\n          var t = tabs && tabs[0];\n          if (t && typeof t.id === \"number\") { cb(t.id, null); return; }\n          cb(null, \"no active tab to target\");\n        });\n      } catch (e3) { cb(null, \"tab query failed\"); }\n    }\n\n    // chrome.* async APIs are callback-only on Gecko. Prefer promisified\n    // browser.* when present, else the chrome.* callback form. cb(err, result).\n    function nsCall(nsName, method, callArgs, cb) {\n      var chromeG = g.chrome;\n      var done = false;\n      var once = function (err, r) { if (!done) { done = true; cb(err, r); } };\n      var viaPromise = function (ns) {\n        try {\n          var ret = ns[method].apply(ns, callArgs);\n          if (ret && typeof ret.then === \"function\") {\n            ret.then(function (r) { once(null, r); }, function (e) { once(e); });\n            return true;\n          }\n        } catch (e) { once(e); return true; }\n        return false;\n      };\n      var bNS = g.browser && g.browser[nsName];\n      if (bNS && typeof bNS[method] === \"function\" && viaPromise(bNS)) return;\n      var cNS = chromeG && chromeG[nsName];\n      if (!cNS || typeof cNS[method] !== \"function\") {\n        once(new Error(\"chrome.\" + nsName + \".\" + method + \" is not available (engine: \" + engineName() + \")\"));\n        return;\n      }\n      try {\n        var ret2 = cNS[method].apply(cNS, callArgs.concat([function (r) {\n          var le = chromeG.runtime && chromeG.runtime.lastError;\n          if (le) once(le); else once(null, r);\n        }]));\n        // A promise-only implementation ignores the trailing callback and\n        // returns a thenable instead; resolve through it (once() dedupes).\n        if (ret2 && typeof ret2.then === \"function\") {\n          ret2.then(function (r) { once(null, r); }, function (e) { once(e); });\n        }\n      } catch (e2) {\n        if (!viaPromise(cNS)) once(e2);\n      }\n    }\n\n    function executeCommand(cmd) {\n      var op = cmd.op, target = cmd.target || {}, args = cmd.args || {};\n      var ctx = target.context || \"background\";\n      var chrome = g.chrome;\n      var cmdId = cmd.cmdId;\n      // content/page eval & inspect need a numeric tab id: resolve --url (or\n      // nothing) to a tab and re-dispatch with target.tabId filled in. (#51)\n      if ((op === \"eval\" || op === \"inspect\") && (ctx === \"content\" || ctx === \"page\") && target.tabId == null) {\n        resolveTargetTab(target, function (tabId, err) {\n          if (tabId == null) {\n            replyErr(cmdId, \"Unsupported\", err || (\"eval/inspect in context \" + ctx + \" needs a --tab id, a --url to match, or an active tab\"));\n            return;\n          }\n          var next = {};\n          for (var k in cmd) { if (Object.prototype.hasOwnProperty.call(cmd, k)) next[k] = cmd[k]; }\n          next.target = {};\n          for (var tk in target) { if (Object.prototype.hasOwnProperty.call(target, tk)) next.target[tk] = target[tk]; }\n          next.target.tabId = tabId;\n          executeCommand(next);\n        });\n        return;\n      }\n      try {\n        if (!chrome) { replyErr(cmdId, \"Unsupported\", \"chrome.* not available in this context\"); return; }\n        if (op === \"eval\") {\n          if (ctx === \"background\") {\n            Promise.resolve().then(function () { return (0, eval)(args.expression); })\n              .then(function (r) { replyOk(cmdId, r); }, function (e) {\n                var msg = (e && e.message) || String(e);\n                // MV3 forbids eval of strings in the SW/extension pages and\n                // rejects 'unsafe-eval'. Surface it honestly with an alternative.\n                if (/Content Security Policy|unsafe-eval/i.test(msg)) {\n                  replyErr(cmdId, \"Unsupported\", \"eval is blocked in the MV3 service worker by CSP. Use --context page --tab <id> (eval runs in the page's MAIN world), or run on an MV2/Firefox build. Engine: \" + engineName());\n                } else {\n                  replyErr(cmdId, (e && e.name) || \"EvalError\", msg);\n                }\n              });\n          } else if ((ctx === \"content\" || ctx === \"page\") && target.tabId && chrome.scripting) {\n            // Wrap the eval so a throw INSIDE the tab comes back as data:\n            // Chrome swallows an injected function's exception (null result).\n            nsCall(\"scripting\", \"executeScript\", [{\n              target: {tabId: target.tabId},\n              world: ctx === \"page\" ? \"MAIN\" : \"ISOLATED\",\n              func: function (src) {\n                try { return {__extjsEval: 1, ok: true, value: eval(src)}; }\n                catch (e) { return {__extjsEval: 1, ok: false, name: (e && e.name) || \"EvalError\", message: (e && e.message) || String(e)}; }\n              },\n              args: [String(args.expression)]\n            }], function (err, res) {\n              if (err) { replyErr(cmdId, \"TargetNotFound\", (err && err.message) || err); return; }\n              var frame = res && res[0] ? res[0].result : undefined;\n              if (!frame || frame.__extjsEval !== 1) {\n                replyErr(cmdId, \"TargetNotFound\", \"the expression never executed in tab \" + target.tabId + \": no injectable frame returned a result (restricted page, or outside host_permissions)\");\n                return;\n              }\n              if (frame.ok) { replyOk(cmdId, frame.value); return; }\n              if (ctx === \"content\" && /Content Security Policy|unsafe-eval|EvalError/i.test(String(frame.name) + \" \" + String(frame.message))) {\n                replyErr(cmdId, \"Unsupported\", \"eval of a string is blocked in the ISOLATED (content) world by the extension CSP. Use --context page (runs in the page's MAIN world). Original: \" + frame.message);\n                return;\n              }\n              replyErr(cmdId, frame.name || \"EvalError\", frame.message);\n            });\n          } else if (ctx === \"popup\" || ctx === \"options\" || ctx === \"sidebar\" || ctx === \"devtools\" || ctx === \"newtab\" || ctx === \"history\" || ctx === \"bookmarks\") {\n            // The SW can't eval in another extension page; ask the surface's\n            // own in-bundle relay (only the open, matching-context page responds).\n            chrome.runtime.sendMessage(\n              {__extjsEvalRequest: true, target: target, args: {expression: String(args.expression)}},\n              function (resp) {\n                if ((chrome.runtime && chrome.runtime.lastError) || !resp) {\n                  replyErr(cmdId, \"Unsupported\", \"surface '\" + ctx + \"' is not open (open it first: extension open \" + ctx + \")\", \"surface_not_open\");\n                } else if (resp.ok) {\n                  replyOk(cmdId, resp.value);\n                } else {\n                  replyErr(cmdId, (resp.error && resp.error.name) || \"EvalError\", (resp.error && resp.error.message) || \"eval failed\");\n                }\n              }\n            );\n          } else if (ctx === \"content\" || ctx === \"page\") {\n            replyErr(cmdId, \"Unsupported\", target.tabId\n              ? \"chrome.scripting is not available on this engine (MV2 has no scripting API); use --context background\"\n              : \"eval in context \" + ctx + \" requires a tabId\");\n          } else {\n            replyErr(cmdId, \"BadRequest\", \"unknown eval context: \" + ctx);\n          }\n          return;\n        }\n        if (op === \"storage.get\" || op === \"storage.set\") {\n          // chrome.* storage is callback-only on Gecko and older Chromium.\n          // Prefer promisified browser.*, then fall back to the callback shape.\n          var storageNS = (g.browser && g.browser.storage) ? g.browser.storage : chrome.storage;\n          var storageArea = storageNS && storageNS[args.area || \"local\"];\n          if (!storageArea) { replyErr(cmdId, \"StorageError\", \"storage.\" + (args.area || \"local\") + \" unavailable\"); return; }\n          var isSet = op === \"storage.set\";\n          var callArgs = isSet ? [args.items || {}] : [args.key != null ? args.key : null];\n          var onStorageOk = function (r) { replyOk(cmdId, isSet ? {set: Object.keys(args.items || {})} : r); };\n          var onStorageErr = function (e) { replyErr(cmdId, \"StorageError\", (e && e.message) || String(e)); };\n          var storageFn = isSet ? storageArea.set : storageArea.get;\n          try {\n            var storageRet = storageFn.apply(storageArea, callArgs);\n            if (storageRet && typeof storageRet.then === \"function\") {\n              storageRet.then(onStorageOk, onStorageErr);\n              return;\n            }\n          } catch (e) { /* not thenable / threw synchronously: fall back to callback */ }\n          try {\n            storageFn.apply(storageArea, callArgs.concat([function (r) {\n              var le = chrome.runtime && chrome.runtime.lastError;\n              if (le) onStorageErr(le); else onStorageOk(r);\n            }]));\n          } catch (e) { onStorageErr(e); }\n          return;\n        }\n        if (op === \"reload\") {\n          if (ctx === \"background\") {\n            replyOk(cmdId, {reloading: true});\n            setTimeout(function () { try { chrome.runtime.reload(); } catch (e) {\n              // Ignore\n            } }, 50);\n          } else if (target.tabId) {\n            nsCall(\"tabs\", \"reload\", [target.tabId], function (err) {\n              if (err) replyErr(cmdId, \"ReloadError\", (err && err.message) || err);\n              else replyOk(cmdId, {reloaded: target.tabId});\n            });\n          } else {\n            replyErr(cmdId, \"Unsupported\", \"reload needs background or a tabId\");\n          }\n          return;\n        }\n        if (op === \"open\") {\n          var surface = args.surface || ctx;\n          // getPopup is promise-style on Gecko and (MV3) Chromium; fall back to\n          // callback-style for older Chromium. Always resolves to a string.\n          var getActionPopup = function (cb) {\n            try {\n              var r = chrome.action && chrome.action.getPopup && chrome.action.getPopup({});\n              if (r && typeof r.then === \"function\") {\n                r.then(function (p) { cb(p || \"\"); }, function () { cb(\"\"); });\n                return;\n              }\n            } catch (e) {\n              // Ignore\n            }\n            try { chrome.action.getPopup({}, function (p) { cb(p || \"\"); }); }\n            catch (e) { cb(\"\"); }\n          };\n          var resolveActiveTab = function (a, cb) {\n            if (a && typeof a.tabId === \"number\") {\n              try { chrome.tabs.get(a.tabId, function (t) { cb(t || {id: a.tabId}); }); return; }\n              catch (e) {\n                // Ignore\n              }\n            }\n            try { chrome.tabs.query({active: true, lastFocusedWindow: true}, function (tabs) { cb((tabs && tabs[0]) || undefined); }); }\n            catch (e) { cb(undefined); }\n          };\n          // Replaying a listener carries no user gesture, so activeTab is never\n          // granted. Warn when the manifest declares it.\n          var activeTabWarning = function () {\n            try {\n              var m = chrome.runtime.getManifest();\n              var perms = (m && m.permissions) || [];\n              if (perms.indexOf(\"activeTab\") !== -1) {\n                return \"replayed without a user gesture: activeTab is NOT granted, so APIs that depend on it (scripting on the active tab, captureVisibleTab) behave differently than a real click\";\n              }\n            } catch (e) {\n              // Ignore\n            }\n            return null;\n          };\n          if (surface === \"popup\") {\n            if (chrome.action && chrome.action.openPopup) {\n              nsCall(\"action\", \"openPopup\", [], function (err) {\n                if (err) {\n                  var openMsg = (err && err.message) || err;\n                  replyErr(cmdId, \"Unsupported\", \"openPopup: \" + openMsg, openRefusalCode(openMsg));\n                } else replyOk(cmdId, {opened: \"popup\"});\n              });\n            } else { replyErr(cmdId, \"Unsupported\", \"action.openPopup not available\", \"api_unavailable\"); }\n          } else if (surface === \"options\") {\n            try { chrome.runtime.openOptionsPage(function () { replyOk(cmdId, {opened: \"options\"}); }); }\n            catch (e) { replyErr(cmdId, \"Unsupported\", \"openOptionsPage: \" + e); }\n          } else if (surface === \"sidebar\") {\n            if (chrome.sidePanel && chrome.sidePanel.open && chrome.windows) {\n              chrome.windows.getCurrent(function (w) {\n                nsCall(\"sidePanel\", \"open\", [{windowId: w.id}], function (err) {\n                  if (err) {\n                    var sideMsg = (err && err.message) || err;\n                    replyErr(cmdId, \"Unsupported\", \"sidePanel.open: \" + sideMsg, openRefusalCode(sideMsg));\n                  } else replyOk(cmdId, {opened: \"sidebar\"});\n                });\n              });\n            } else { replyErr(cmdId, \"Unsupported\", \"sidePanel not available (engine: \" + engineName() + \")\", \"api_unavailable\"); }\n          } else if (surface === \"action\") {\n            // With a default_popup the click opens it; without one, replay the\n            // onClicked listeners captured at install time.\n            if (chrome.action) {\n              getActionPopup(function (popup) {\n                if (popup) {\n                  nsCall(\"action\", \"openPopup\", [], function (err) {\n                    if (err) {\n                      var actMsg = (err && err.message) || err;\n                      replyErr(cmdId, \"Unsupported\", \"openPopup: \" + actMsg, openRefusalCode(actMsg));\n                    } else replyOk(cmdId, {triggered: \"popup\"});\n                  });\n                } else if (actionClickedListeners.length) {\n                  resolveActiveTab(args, function (tab) {\n                    var fired = 0;\n                    for (var i = 0; i < actionClickedListeners.length; i++) {\n                      try { actionClickedListeners[i](tab); fired++; } catch (e) {\n                        // Ignore\n                      }\n                    }\n                    var reply = {triggered: \"onClicked\", listeners: fired, gesture: false};\n                    var warning = activeTabWarning();\n                    if (warning) reply.warning = warning;\n                    replyOk(cmdId, reply);\n                  });\n                } else {\n                  replyErr(cmdId, \"Unsupported\", \"action has no popup and no onClicked listener registered\");\n                }\n              });\n            } else { replyErr(cmdId, \"Unsupported\", \"chrome.action not available (engine: \" + engineName() + \")\", \"api_unavailable\"); }\n          } else if (surface === \"command\") {\n            var commandName = (args && args.name) || undefined;\n            if (!commandListeners.length) {\n              replyErr(cmdId, \"Unsupported\", \"no chrome.commands.onCommand listener registered\");\n            } else {\n              resolveActiveTab(args, function (tab) {\n                var fired = 0;\n                for (var i = 0; i < commandListeners.length; i++) {\n                  try { commandListeners[i](commandName, tab); fired++; } catch (e) {\n                    // Ignore\n                  }\n                }\n                replyOk(cmdId, {triggered: \"command\", command: commandName || null, listeners: fired, gesture: false});\n              });\n            }\n          } else { replyErr(cmdId, \"BadRequest\", \"unknown surface: \" + surface); }\n          return;\n        }\n        if (op === \"tabs.query\") {\n          nsCall(\"tabs\", \"query\", [args || {}], function (err, tabs) {\n            if (err) { replyErr(cmdId, \"TabsError\", (err && err.message) || err); return; }\n            replyOk(cmdId, (tabs || []).map(function (t) { return {id: t.id, url: t.url, title: t.title, active: t.active, windowId: t.windowId}; }));\n          });\n          return;\n        }\n        if (op === \"inspect\") {\n          // Extract a DOM snapshot from the target page via chrome.scripting\n          // (CDP-free). Closed shadow roots need CDP; here we read open ones.\n          if ((ctx === \"content\" || ctx === \"page\") && target.tabId && chrome.scripting) {\n            var maxBytes = (args && args.maxBytes) || 262144;\n            var includeHtml = !args || !args.include || args.include.indexOf(\"html\") !== -1;\n            nsCall(\"scripting\", \"executeScript\", [{\n              target: {tabId: target.tabId},\n              world: ctx === \"page\" ? \"MAIN\" : \"ISOLATED\",\n              func: function (wantHtml, cap) {\n                function countShadow(root) {\n                  var n = 0, els = root.querySelectorAll(\"*\");\n                  for (var i = 0; i < els.length; i++) { if (els[i].shadowRoot) { n++; n += countShadow(els[i].shadowRoot); } }\n                  return n;\n                }\n                var doc = document;\n                var roots = doc.querySelectorAll('#extension-root,[data-extension-root]');\n                var out = {\n                  url: location.href,\n                  title: doc.title,\n                  summary: {\n                    htmlLength: doc.documentElement.outerHTML.length,\n                    scriptCount: doc.querySelectorAll(\"script\").length,\n                    styleCount: doc.querySelectorAll(\"style,link[rel=stylesheet]\").length,\n                    extensionRootCount: roots.length,\n                    openShadowRoots: countShadow(doc),\n                    bodyChildCount: doc.body ? doc.body.children.length : 0\n                  }\n                };\n                if (wantHtml) {\n                  var html = doc.documentElement.outerHTML;\n                  if (cap > 0 && html.length > cap) { out.html = html.slice(0, cap); out.htmlTruncated = true; }\n                  else { out.html = html; }\n                }\n                return out;\n              },\n              args: [includeHtml, maxBytes]\n            }], function (err, res) {\n              if (err) { replyErr(cmdId, \"TargetNotFound\", (err && err.message) || err); return; }\n              var snap = res && res[0] ? res[0].result : undefined;\n              if (snap == null) { replyErr(cmdId, \"TargetNotFound\", \"no injectable frame returned a snapshot for tab \" + target.tabId + \" (restricted page, or outside host_permissions)\"); return; }\n              replyOk(cmdId, snap);\n            });\n          } else if (ctx === \"popup\" || ctx === \"options\" || ctx === \"sidebar\" || ctx === \"devtools\" || ctx === \"newtab\" || ctx === \"history\" || ctx === \"bookmarks\") {\n            // The SW can't read a surface page's DOM; ask the surface's own\n            // in-bundle relay (only the open, matching-context page responds).\n            chrome.runtime.sendMessage(\n              {__extjsInspectRequest: true, target: target, args: args},\n              function (resp) {\n                if (chrome.runtime.lastError || !resp) {\n                  replyErr(cmdId, \"Unsupported\", \"surface '\" + ctx + \"' is not open (open it first: extension open \" + ctx + \")\", \"surface_not_open\");\n                } else if (resp.ok) {\n                  replyOk(cmdId, resp.value);\n                } else {\n                  replyErr(cmdId, (resp.error && resp.error.name) || \"InspectError\", (resp.error && resp.error.message) || \"inspect failed\");\n                }\n              }\n            );\n          } else if (ctx === \"background\") {\n            replyErr(cmdId, \"Unsupported\", \"the service worker has no DOM; inspect a content/page (with --tab) or an open surface\");\n          } else {\n            replyErr(cmdId, \"Unsupported\", \"inspect of \" + ctx + \" requires a tabId (content/page) or an open surface\");\n          }\n          return;\n        }\n        replyErr(cmdId, \"BadRequest\", \"unknown op: \" + op);\n      } catch (e) {\n        replyErr(cmdId, \"ExecutorError\", e);\n      }\n    }\n\n    function noopLastError() { try { void g.chrome.runtime.lastError; } catch (e) {\n      // Ignore\n    } }\n\n    // Only http(s)/file/ftp tabs can run a content script; skip chrome://, the\n    // extension's own pages, about:blank, etc.\n    function isInjectableUrl(url) {\n      return typeof url === \"string\" && /^(https?|file|ftp):/i.test(url);\n    }\n\n    // Re-inject one declared entry's fresh files into every matching open tab.\n    // exclude_matches MUST be honored: query the excludes and subtract them.\n    function reinjectContentScriptEntry(entry) {\n      var chrome = g.chrome;\n      var matches = (entry && entry.matches) || [];\n      if (!Array.isArray(matches) || !matches.length) return;\n      var excludeMatches = (entry && entry.exclude_matches) || [];\n      var jsFiles = ((entry && entry.js) || []).filter(function (f) { return typeof f === \"string\"; });\n      var cssFiles = ((entry && entry.css) || []).filter(function (f) { return typeof f === \"string\"; });\n      if (!jsFiles.length && !cssFiles.length) return;\n      var world = entry.world === \"MAIN\" ? \"MAIN\" : \"ISOLATED\";\n      var allFrames = !!entry.all_frames;\n      function injectInto(excludedTabIds) {\n        try {\n          chrome.tabs.query({url: matches}, function (tabs) {\n            var err = null;\n            try { err = chrome.runtime.lastError; } catch (e) {\n              // Ignore\n            }\n            if (err || !tabs) return;\n            for (var i = 0; i < tabs.length; i++) {\n              (function (tab) {\n                if (!tab || tab.id == null || !isInjectableUrl(tab.url)) return;\n                if (excludedTabIds[tab.id]) return;\n                var target = {tabId: tab.id, allFrames: allFrames};\n                if (cssFiles.length && chrome.scripting.insertCSS) {\n                  try { chrome.scripting.insertCSS({target: target, files: cssFiles}, noopLastError); } catch (e) {\n                    // Ignore\n                  }\n                }\n                if (jsFiles.length && chrome.scripting.executeScript) {\n                  try {\n                    chrome.scripting.executeScript(\n                      {target: target, files: jsFiles, world: world, injectImmediately: true},\n                      noopLastError\n                    );\n                  } catch (e) {\n                    // Ignore\n                  }\n                }\n              })(tabs[i]);\n            }\n          });\n        } catch (e) {\n          // Ignore\n        }\n      }\n      if (Array.isArray(excludeMatches) && excludeMatches.length) {\n        try {\n          chrome.tabs.query({url: excludeMatches}, function (excludedTabs) {\n            try { void chrome.runtime.lastError; } catch (e) {\n              // Ignore\n            }\n            var excluded = {};\n            if (excludedTabs) {\n              for (var i = 0; i < excludedTabs.length; i++) {\n                if (excludedTabs[i] && excludedTabs[i].id != null) excluded[excludedTabs[i].id] = true;\n              }\n            }\n            injectInto(excluded);\n          });\n          return;\n        } catch (e) {\n          // Ignore\n        }\n      }\n      injectInto({});\n    }\n\n    // Re-inject all content scripts into their open tabs. Reads the manifest\n    // FROM DISK: getManifest() is frozen and dev filenames are content-hashed.\n    function reinjectContentScripts(onDone) {\n      var chrome = g.chrome;\n      try {\n        if (typeof g.fetch !== \"function\" || !chrome.scripting) return false;\n        g.fetch(chrome.runtime.getURL(\"manifest.json\"), {cache: \"no-store\"})\n          .then(function (r) { return r.json(); })\n          .then(function (manifest) {\n            var entries = (manifest && manifest.content_scripts) || [];\n            for (var i = 0; i < entries.length; i++) reinjectContentScriptEntry(entries[i]);\n            reregisterForFutureNavigations(entries);\n            if (onDone) { try { onDone(); } catch (e) {\n              // Ignore\n            } }\n          })\n          .catch(function () {\n            // Ignore\n          });\n        return true;\n      } catch (e) { return false; }\n    }\n\n    function mapRunAt(runAt) {\n      if (runAt === \"document_start\") return \"document_start\";\n      if (runAt === \"document_end\") return \"document_end\";\n      return \"document_idle\";\n    }\n\n    // Re-register content scripts dynamically at the fresh files, so tabs\n    // opened AFTER an edit also get the new build. Idempotent per entry id.\n    function reregisterForFutureNavigations(entries) {\n      var chrome = g.chrome;\n      if (\n        !chrome.scripting ||\n        !chrome.scripting.registerContentScripts ||\n        !chrome.scripting.getRegisteredContentScripts\n      ) return;\n\n      var scripts = [];\n      for (var i = 0; i < entries.length; i++) {\n        var e = entries[i] || {};\n        if (!Array.isArray(e.matches) || !e.matches.length) continue;\n        var js = (e.js || []).filter(function (f) { return typeof f === \"string\"; });\n        var css = (e.css || []).filter(function (f) { return typeof f === \"string\"; });\n        if (!js.length && !css.length) continue;\n        var s = {\n          id: \"extjs-dev-cs-\" + i,\n          matches: e.matches,\n          runAt: mapRunAt(e.run_at),\n          allFrames: !!e.all_frames,\n          world: e.world === \"MAIN\" ? \"MAIN\" : \"ISOLATED\"\n        };\n        // Dev registration must not be BROADER than the static one: dropping\n        // exclude_matches injects into pages the browser itself would skip.\n        if (Array.isArray(e.exclude_matches) && e.exclude_matches.length) {\n          s.excludeMatches = e.exclude_matches;\n        }\n        if (js.length) s.js = js;\n        if (css.length) s.css = css;\n        scripts.push(s);\n      }\n      if (!scripts.length) return;\n\n      try {\n        chrome.scripting.getRegisteredContentScripts(function (existing) {\n          try { void chrome.runtime.lastError; } catch (e) {\n            // Ignore\n          }\n          var have = {};\n          if (existing) for (var k = 0; k < existing.length; k++) have[existing[k].id] = true;\n          var toRegister = [], toUpdate = [];\n          for (var j = 0; j < scripts.length; j++) {\n            (have[scripts[j].id] ? toUpdate : toRegister).push(scripts[j]);\n          }\n          if (toRegister.length) {\n            try { chrome.scripting.registerContentScripts(toRegister, noopLastError); } catch (e) {\n              // Ignore\n            }\n          }\n          if (toUpdate.length) {\n            try { chrome.scripting.updateContentScripts(toUpdate, noopLastError); } catch (e) {\n              // Ignore\n            }\n          }\n        });\n      } catch (e) {\n        // Ignore\n      }\n    }\n\n    // Dev-loop reload without the CDP controller: content-scripts re-inject in\n    // place into open tabs; service-worker/full/manifest restart the extension.\n    function performDevReload(type, onDone) {\n      var chrome = g.chrome;\n      if (!chrome) return;\n\n      var fullReload = function () {\n        // Flag a pending reinject for the NEXT producer generation: the\n        // boot-time heal is what converges open tabs after a SW/full reload.\n        try {\n          if (chrome.storage && chrome.storage.local) {\n            chrome.storage.local.set({__extjsDevPendingReinject: Date.now()}, noopLastError);\n          }\n        } catch (e) {\n          // Ignore\n        }\n        // Deferred so in-flight frames and the tab console announcement flush\n        // before the SW dies; the devtools companion confirms completion.\n        try { setTimeout(function () { try { chrome.runtime.reload(); } catch (e) {\n          // Ignore\n        } }, 150); } catch (e) {}\n      };\n\n      if (type === \"content-scripts\" && chrome.scripting && chrome.tabs && chrome.tabs.query) {\n        if (reinjectContentScripts(onDone)) return;\n      }\n\n      fullReload();\n    }\n\n    // One server-built label travels the ReloadFrame; the announcement\n    // fires HERE, next to the actual reload action, so it stays true.\n\n    // console.log the reload line into every open injectable tab; the patched\n    // ISOLATED-world console also lands it in the dev-server log stream.\n    function announceReloadInTabs(text) {\n      var chrome = g.chrome;\n      if (!chrome || !chrome.tabs || !chrome.tabs.query) return;\n      try {\n        chrome.tabs.query({}, function (tabs) {\n          noopLastError();\n          if (!tabs) return;\n          for (var i = 0; i < tabs.length; i++) {\n            (function (tab) {\n              if (!tab || tab.id == null || !isInjectableUrl(tab.url)) return;\n              if (chrome.scripting && chrome.scripting.executeScript) {\n                try {\n                  chrome.scripting.executeScript(\n                    {target: {tabId: tab.id}, func: function (t) { console.log(t); }, args: [text]},\n                    noopLastError\n                  );\n                  return;\n                } catch (e) {\n                  // Ignore\n                }\n              }\n              // MV2 fallback (Firefox without the scripting API).\n              if (chrome.tabs.executeScript) {\n                try {\n                  chrome.tabs.executeScript(tab.id, {code: \"console.log(\" + JSON.stringify(text) + \");\"}, noopLastError);\n                } catch (e) {\n                  // Ignore\n                }\n              }\n            })(tabs[i]);\n          }\n        });\n      } catch (e) {\n        // Ignore\n      }\n    }\n\n    // The scripts-replay shim (plugin-reload) keeps the SW's own\n    // executeScript registry; the replay is fire-and-forget by design.\n    function replayProgrammaticScripts(changedScriptFiles) {\n      if (!Array.isArray(changedScriptFiles) || changedScriptFiles.length === 0) return;\n      var replay = g.__extjsScriptsReplay;\n      if (typeof replay !== \"function\") return;\n      try {\n        var outcome = replay(changedScriptFiles);\n        if (outcome && typeof outcome.then === \"function\") {\n          outcome.then(null, function () {});\n        }\n      } catch (e) {\n        // Ignore\n      }\n    }\n\n    function handleDevReloadFrame(frame) {\n      var kind = frame.reloadType || \"full\";\n      var label = typeof frame.label === \"string\" ? frame.label : \"\";\n      // The server always builds the label; the kind-derived fallback only\n      // covers a malformed frame so the announcement stays truthful.\n      var fallback = kind === \"content-scripts\" ? \"content_script\"\n        : kind === \"service-worker\" ? \"service_worker\"\n        : \"extension\";\n      var announced = \"[Extension.js] Reloading \" + (label || fallback) + \"\u2026\";\n\n      // A scripts/ bundle edit: re-run the executeScript calls that named it\n      // on their recorded tabs, before any reload decision below.\n      replayProgrammaticScripts(frame.changedScriptFiles);\n\n      if (kind === \"page\") {\n        // Notify-only: rspack-dev-server's livereload refreshes the open\n        // surface; reloading the extension here would race it.\n        return;\n      }\n\n      // Delivery ack for the broker: proves this SW's message pump processed\n      // the frame (a socket write proves nothing). Sent on receipt, by design.\n      send({type: \"reload-ack\", reloadType: kind, label: label});\n\n      announceReloadInTabs(announced);\n      performDevReload(kind, function () {});\n    }\n\n    function sanitize(args) {\n      var out = [];\n      for (var i = 0; i < args.length; i++) {\n        var p = args[i];\n        try {\n          if (typeof p === \"string\") out.push(p.length > 2048 ? p.slice(0, 2048) + \"...\" : p);\n          else if (p instanceof Error) out.push(p.name + \": \" + p.message);\n          else out.push(JSON.stringify(p));\n        } catch (e) {\n          out.push(String(p));\n        }\n        if (out.join(\" \").length > 8192) break;\n      }\n      return out;\n    }\n\n    function flush() {\n      while (queue.length && open && socket) {\n        var f = queue.shift();\n        try { socket.send(JSON.stringify(f)); } catch (e) { break; }\n      }\n    }\n\n    function send(frame) {\n      if (open && socket) {\n        try { socket.send(JSON.stringify(frame)); return; } catch (e) {\n          // Ignore\n        }\n      }\n      if (queue.length < MAX_QUEUE) queue.push(frame);\n    }\n\n    // The baked PORT is a snapshot of an ephemeral port. After a dev-server\n    // restart, the port file shipped in the unpacked extension names the\n    // live one, and unpacked resources are read from disk on every fetch.\n    function refreshControlPort(done) {\n      try {\n        var runtime = (g.chrome && g.chrome.runtime) || (g.browser && g.browser.runtime);\n        if (!runtime || typeof runtime.getURL !== \"function\" || typeof g.fetch !== \"function\") { done(); return; }\n        g.fetch(runtime.getURL(\"extension-js-control.json\"), {cache: \"no-store\"})\n          .then(function (res) { return res.json(); })\n          .then(function (data) {\n            var next = data && parseInt(data.port, 10);\n            if (next && next > 0 && next < 65536 && next !== PORT) PORT = next;\n            done();\n          })\n          .catch(function () { done(); });\n      } catch (e) { done(); }\n    }\n\n    function schedule() {\n      var delay = backoff;\n      backoff = Math.min(backoff * 2, MAX_BACKOFF);\n      connectFailures++;\n      try {\n        setTimeout(function () {\n          // Two straight failures make the baked port suspect (a restarted\n          // server dials out on a new port): re-resolve before re-dialing.\n          if (connectFailures >= 2) refreshControlPort(connect);\n          else connect();\n        }, delay);\n      } catch (e) {\n        // Ignore\n      }\n    }\n\n    function connect() {\n      try {\n        socket = new WS(\"ws://\" + HOST + \":\" + PORT + \"/extjs-control\");\n      } catch (e) {\n        schedule();\n        return;\n      }\n      socket.onopen = function () {\n        open = true;\n        backoff = 250;\n        connectFailures = 0;\n        try {\n          socket.send(JSON.stringify({type: \"hello\", v: 1, role: \"producer\", instanceId: INSTANCE_ID}));\n        } catch (e) {\n          // Ignore\n        }\n        flush();\n      };\n      socket.onmessage = function (ev) {\n        var frame;\n        try { frame = JSON.parse(typeof ev.data === \"string\" ? ev.data : \"\"); } catch (e) { return; }\n        if (frame && frame.type === \"command\") {\n          try { executeCommand(frame); } catch (e) { replyErr(frame.cmdId, \"ExecutorError\", e); }\n        } else if (frame && frame.type === \"reload\") {\n          // Dev-loop reload broadcast (see broker.broadcastReload).\n          // Fire-and-forget: no result frame is expected.\n          try { handleDevReloadFrame(frame); } catch (e) {\n            // Ignore\n          }\n        } else if (frame && frame.type === \"ping\") {\n          // Server keepalive: merely RECEIVING this resets the MV3 SW's ~30s\n          // idle timer (Chrome 116+), keeping it reachable. Nothing to do.\n        }\n      };\n      socket.onclose = function () {\n        open = false;\n        socket = null;\n        schedule();\n      };\n      socket.onerror = function () {\n        try { socket && socket.close(); } catch (e) {\n          // Ignore\n        }\n      };\n    }\n\n    // Uncaught errors don't route through the patched console; the handlers\n    // below forward them, using these signatures to skip already-logged throws.\n    var recentErrorSigs = [];\n    function errorSig(message, stack) {\n      return String(message == null ? \"\" : message) + \"::\" + String(stack == null ? \"\" : stack).slice(0, 200);\n    }\n    function noteErrorSig(sig) {\n      recentErrorSigs.push({sig: sig, t: Date.now()});\n      if (recentErrorSigs.length > 50) recentErrorSigs.shift();\n    }\n    function errorSigSeenRecently(sig) {\n      var now = Date.now();\n      for (var i = recentErrorSigs.length - 1; i >= 0; i--) {\n        if (now - recentErrorSigs[i].t > 3000) { recentErrorSigs.splice(i, 1); continue; }\n        if (recentErrorSigs[i].sig === sig) return true;\n      }\n      return false;\n    }\n\n    LEVELS.forEach(function (level) {\n      var orig = typeof consoleRef[level] === \"function\"\n        ? consoleRef[level].bind(consoleRef)\n        : function () {};\n      consoleRef[level] = function () {\n        try {\n          if (level === \"error\") {\n            for (var ai = 0; ai < arguments.length; ai++) {\n              if (arguments[ai] instanceof Error) noteErrorSig(errorSig(arguments[ai].message, arguments[ai].stack));\n            }\n          }\n          send({\n            type: \"log\",\n            event: {\n              v: 1,\n              id: nowId(),\n              timestamp: Date.now(),\n              level: level,\n              context: CONTEXT,\n              messageParts: sanitize([].slice.call(arguments)),\n              runId: INSTANCE_ID\n            }\n          });\n        } catch (e) {\n          // Ignore\n        }\n        return orig.apply(consoleRef, arguments);\n      };\n    });\n\n    // Forward uncaught throws / unhandled rejections as level:\"error\", deduped\n    // so a logged-then-rethrown Error emits once.\n    function shipUncaughtError(message, stack, url) {\n      try {\n        var sig = errorSig(message, stack);\n        if (errorSigSeenRecently(sig)) return;\n        noteErrorSig(sig);\n        send({\n          type: \"log\",\n          event: {\n            v: 1,\n            id: nowId(),\n            timestamp: Date.now(),\n            level: \"error\",\n            context: CONTEXT,\n            messageParts: sanitize([String(message) + (stack ? \"\\n\" + stack : \"\")]),\n            url: url,\n            runId: INSTANCE_ID\n          }\n        });\n      } catch (e) {\n        // Ignore\n      }\n    }\n    try {\n      if (typeof g.addEventListener === \"function\") {\n        g.addEventListener(\"error\", function (ev) {\n          var err = ev && ev.error;\n          var message = (err && err.message) || (ev && ev.message) || \"Uncaught error\";\n          shipUncaughtError(message, err && err.stack, ev && ev.filename);\n        });\n        g.addEventListener(\"unhandledrejection\", function (ev) {\n          var reason = ev && ev.reason;\n          var message = (reason && reason.message) || (reason != null ? String(reason) : \"Unhandled rejection\");\n          shipUncaughtError(\"Unhandled promise rejection: \" + message, reason && reason.stack, undefined);\n        });\n      }\n    } catch (e) {\n      // Ignore\n    }\n\n    // Other contexts relay console logs to this SW over a NAMED runtime.Port:\n    // they can't open the WS under page CSP, and sendMessage can echo-loop.\n    function shipRelayedLog(ev, sender) {\n      try {\n        send({\n          type: \"log\",\n          event: {\n            v: 1,\n            id: nowId(),\n            timestamp: Date.now(),\n            level: ev.level || \"log\",\n            context: ev.context || \"content\",\n            messageParts: Array.isArray(ev.messageParts) ? ev.messageParts : [],\n            url: ev.url || (sender ? sender.url : undefined),\n            tabId: sender && sender.tab ? sender.tab.id : undefined,\n            frameId: sender ? sender.frameId : undefined,\n            runId: INSTANCE_ID\n          }\n        });\n      } catch (e) {\n        // Ignore\n      }\n    }\n    try {\n      var rtPort = g.chrome;\n      if (rtPort && rtPort.runtime && rtPort.runtime.onConnect) {\n        rtPort.runtime.onConnect.addListener(function (port) {\n          if (!port || port.name !== \"__extjs-bridge-log__\") return;\n          try {\n            port.onMessage.addListener(function (msg) {\n              if (!msg || !msg.__extjsBridgeLog) return;\n              shipRelayedLog(msg.__extjsBridgeLog, port.sender);\n            });\n          } catch (e) {\n            // Ignore\n          }\n        });\n      }\n    } catch (e) {\n      // Ignore\n    }\n    // Legacy sendMessage path: kept for any surface still relaying the old way\n    // (harmless one-predicate listener; new relays never use it).\n    try {\n      var rt = g.chrome;\n      if (rt && rt.runtime && rt.runtime.onMessage) {\n        rt.runtime.onMessage.addListener(function (msg, sender) {\n          if (!msg || !msg.__extjsBridgeLog) return;\n          shipRelayedLog(msg.__extjsBridgeLog, sender);\n        });\n      }\n    } catch (e) {\n      // Ignore\n    }\n\n    // Chrome never injects manifest content scripts into already-open tabs, so\n    // fire one reinject on onInstalled (which skips idle-stop SW wakes).\n    try {\n      var rtBoot = g.chrome;\n      if (rtBoot && rtBoot.runtime && rtBoot.runtime.onInstalled) {\n        rtBoot.runtime.onInstalled.addListener(function () {\n          try {\n            setTimeout(function () {\n              try { reinjectContentScripts(); } catch (e) {\n                // Ignore\n              }\n            }, 250);\n          } catch (e) {\n            // Ignore\n          }\n        });\n      }\n    } catch (e) {\n      // Ignore\n    }\n\n    // runtime.reload() does NOT fire onInstalled (verified Chromium 146), so\n    // consume the pre-reload storage flag here (fresh only) to heal open tabs.\n    try {\n      var stBoot = g.chrome;\n      if (stBoot && stBoot.storage && stBoot.storage.local) {\n        stBoot.storage.local.get(\"__extjsDevPendingReinject\", function (res) {\n          noopLastError();\n          var ts = res && res.__extjsDevPendingReinject;\n          if (ts == null) return;\n          try { stBoot.storage.local.remove(\"__extjsDevPendingReinject\", noopLastError); } catch (e) {\n            // Ignore\n          }\n          if (typeof ts !== \"number\" || Date.now() - ts > 30000) return;\n          setTimeout(function () {\n            try { reinjectContentScripts(); } catch (e) {\n              // Ignore\n            }\n          }, 250);\n        });\n      }\n    } catch (e) {\n      // Ignore\n    }\n\n    connect();\n  } catch (e) {\n    // Ignore\n  }\n})();\n";
+export declare const BRIDGE_PRODUCER_SOURCE = ";(function () {\n  try {\n    var g = (typeof globalThis === \"object\" && globalThis) ? globalThis : this;\n    if (!g || g.__extjsBridgeProducerInstalled) return;\n\n    var PORT = parseInt(\"__EXTJS_CONTROL_PORT__\", 10);\n    var INSTANCE_ID = \"__EXTJS_INSTANCE_ID__\";\n    var CONTEXT = \"__EXTJS_CONTEXT__\";\n    // Connectable host of the dev-server control WS. Baked from the resolved\n    // connectable host (loopback locally; the public host for remote/devcontainer).\n    var HOST = \"__EXTJS_CONTROL_HOST__\";\n    if (!HOST || HOST.indexOf(\"__EXTJS\") === 0) HOST = \"127.0.0.1\";\n    if (!PORT || PORT < 1) return;\n\n    var WS = g.WebSocket;\n    if (typeof WS !== \"function\") return;\n\n    var consoleRef = g.console || {};\n    g.__extjsBridgeProducerInstalled = true;\n\n    // Capture extension event listeners at install time: these wraps run\n    // BEFORE user code, and no platform API exists to dispatch these events.\n    function captureEvent(event, sink) {\n      try {\n        if (!event || typeof event.addListener !== \"function\") return;\n        var origAdd = event.addListener.bind(event);\n        event.addListener = function (cb) {\n          if (typeof cb === \"function\" && sink.indexOf(cb) === -1) sink.push(cb);\n          return origAdd(cb);\n        };\n        if (typeof event.removeListener === \"function\") {\n          var origRemove = event.removeListener.bind(event);\n          event.removeListener = function (cb) {\n            var i = sink.indexOf(cb);\n            if (i !== -1) sink.splice(i, 1);\n            return origRemove(cb);\n          };\n        }\n      } catch (e) { /* non-fatal: trigger falls back to its no-listener reply */ }\n    }\n\n    // Use the raw globals (not the hoisted chrome var below). This runs first.\n    // On Gecko browser.* is a DISTINCT wrapper object: hook BOTH namespaces.\n    var actionClickedListeners = [];\n    var commandListeners = [];\n    var capturedEvents = [];\n    function captureEventOnce(event, sink) {\n      // Polyfilled extensions expose ONE event object on both namespaces:\n      // wrap it once, and the sink dedupes callbacks shared across wrappers.\n      if (!event || capturedEvents.indexOf(event) !== -1) return;\n      capturedEvents.push(event);\n      captureEvent(event, sink);\n    }\n    var captureNamespaces = [g.chrome, g.browser];\n    for (var cn = 0; cn < captureNamespaces.length; cn++) {\n      var capNS = captureNamespaces[cn];\n      if (!capNS) continue;\n      captureEventOnce(capNS.action && capNS.action.onClicked, actionClickedListeners);\n      captureEventOnce(capNS.commands && capNS.commands.onCommand, commandListeners);\n    }\n\n    var LEVELS = [\"log\", \"info\", \"warn\", \"error\", \"debug\", \"trace\"];\n    var socket = null;\n    var open = false;\n    var queue = [];\n    var backoff = 250;\n    var MAX_BACKOFF = 5000;\n    var connectFailures = 0;\n    var MAX_QUEUE = 1000;\n    var MAX_RESULT_BYTES = 256 * 1024;\n    // Where error frames are parked so a context that dies before its socket\n    // opens does not take them along. Capped, and old entries are dropped.\n    var PENDING_ERRORS_KEY = \"__extjsPendingErrors\";\n    var MAX_PENDING_ERRORS = 20;\n    var PENDING_ERROR_TTL = 300000;\n\n    function nowId() {\n      return Date.now().toString(36) + Math.random().toString(36).slice(2, 8);\n    }\n\n    // The extension's own URL scheme names the engine outright, which beats a\n    // user agent where Chrome and Safari both say \"Safari\".\n    function engineName() {\n      try {\n        var scheme = (typeof location !== \"undefined\" && location.protocol) || \"\";\n        if (scheme.indexOf(\"safari-web-extension\") === 0) return \"webkit\";\n        if (scheme.indexOf(\"moz-extension\") === 0) return \"firefox\";\n        if (scheme.indexOf(\"chrome-extension\") === 0) return \"chromium\";\n        var ua = (typeof navigator !== \"undefined\" && navigator.userAgent) || \"\";\n        if (/firefox/i.test(ua)) return \"firefox\";\n        if (/safari/i.test(ua) && !/chrome|chromium|edg/i.test(ua)) return \"webkit\";\n        return \"chromium\";\n      } catch (e) { return \"chromium\"; }\n    }\n\n    function safeValue(v) {\n      try {\n        var s = JSON.stringify(v);\n        if (s === undefined) return {value: undefined, truncated: false};\n        if (s.length > MAX_RESULT_BYTES) {\n          return {value: {__type: \"truncated\", preview: s.slice(0, 1024)}, truncated: true};\n        }\n        return {value: JSON.parse(s), truncated: false};\n      } catch (e) {\n        return {value: {__type: \"unserializable\", preview: String(v).slice(0, 512)}, truncated: false};\n      }\n    }\n\n    function replyOk(cmdId, value) {\n      var s = safeValue(value);\n      var frame = {type: \"result\", cmdId: cmdId, ok: true, value: s.value};\n      if (s.truncated) frame.truncated = true;\n      try { socket && socket.send(JSON.stringify(frame)); } catch (e) {\n        // Ignore\n      }\n    }\n\n    function replyErr(cmdId, name, message, code) {\n      var frame = {type: \"result\", cmdId: cmdId, ok: false, error: {name: name, message: String(message), engine: engineName()}};\n      if (code) frame.error.code = code;\n      try { socket && socket.send(JSON.stringify(frame)); } catch (e) {\n        // Ignore\n      }\n    }\n\n    // Name the refusal the browser wrote as prose, so a consumer branches on\n    // error.code instead of matching the engine's sentence.\n    function openRefusalCode(message) {\n      var m = String(message == null ? \"\" : message);\n      if (/user gesture|user input|user interaction|user action/i.test(m)) return \"needs_user_gesture\";\n      if (/browser window|active window/i.test(m)) return \"needs_headed_window\";\n      return undefined;\n    }\n\n    // Resolve a numeric tab id when the caller did not pass one: match\n    // target.url against open tabs, else default to the active tab. (#51)\n    function resolveTargetTab(target, cb) {\n      var chrome = g.chrome;\n      if (!chrome || !chrome.tabs) { cb(null, \"chrome.tabs is not available\"); return; }\n      var url = target && target.url;\n      if (url) {\n        var substringMatch = function () {\n          try {\n            chrome.tabs.query({}, function (all) {\n              var hit = (all || []).filter(function (t) { return t.url && String(t.url).indexOf(url) !== -1; })[0];\n              if (hit && typeof hit.id === \"number\") { cb(hit.id, null); return; }\n              cb(null, \"no open tab matches url: \" + url);\n            });\n          } catch (e2) { cb(null, \"tab query failed\"); }\n        };\n        try {\n          // chrome.tabs.query accepts URL match patterns; a bare url/glob may\n          // not be a valid pattern, so fall back to a substring scan.\n          chrome.tabs.query({url: url}, function (tabs) {\n            if (chrome.runtime && chrome.runtime.lastError) { substringMatch(); return; }\n            if (tabs && tabs.length && typeof tabs[0].id === \"number\") { cb(tabs[0].id, null); return; }\n            substringMatch();\n          });\n        } catch (e) { substringMatch(); }\n        return;\n      }\n      try {\n        chrome.tabs.query({active: true, lastFocusedWindow: true}, function (tabs) {\n          var t = tabs && tabs[0];\n          if (t && typeof t.id === \"number\") { cb(t.id, null); return; }\n          cb(null, \"no active tab to target\");\n        });\n      } catch (e3) { cb(null, \"tab query failed\"); }\n    }\n\n    // chrome.* async APIs are callback-only on Gecko. Prefer promisified\n    // browser.* when present, else the chrome.* callback form. cb(err, result).\n    function nsCall(nsName, method, callArgs, cb) {\n      var chromeG = g.chrome;\n      var done = false;\n      var once = function (err, r) { if (!done) { done = true; cb(err, r); } };\n      var viaPromise = function (ns) {\n        try {\n          var ret = ns[method].apply(ns, callArgs);\n          if (ret && typeof ret.then === \"function\") {\n            ret.then(function (r) { once(null, r); }, function (e) { once(e); });\n            return true;\n          }\n        } catch (e) { once(e); return true; }\n        return false;\n      };\n      var bNS = g.browser && g.browser[nsName];\n      if (bNS && typeof bNS[method] === \"function\" && viaPromise(bNS)) return;\n      var cNS = chromeG && chromeG[nsName];\n      if (!cNS || typeof cNS[method] !== \"function\") {\n        once(new Error(\"chrome.\" + nsName + \".\" + method + \" is not available (engine: \" + engineName() + \")\"));\n        return;\n      }\n      try {\n        var ret2 = cNS[method].apply(cNS, callArgs.concat([function (r) {\n          var le = chromeG.runtime && chromeG.runtime.lastError;\n          if (le) once(le); else once(null, r);\n        }]));\n        // A promise-only implementation ignores the trailing callback and\n        // returns a thenable instead; resolve through it (once() dedupes).\n        if (ret2 && typeof ret2.then === \"function\") {\n          ret2.then(function (r) { once(null, r); }, function (e) { once(e); });\n        }\n      } catch (e2) {\n        if (!viaPromise(cNS)) once(e2);\n      }\n    }\n\n    function executeCommand(cmd) {\n      var op = cmd.op, target = cmd.target || {}, args = cmd.args || {};\n      var ctx = target.context || \"background\";\n      var chrome = g.chrome;\n      var cmdId = cmd.cmdId;\n      // content/page eval & inspect need a numeric tab id: resolve --url (or\n      // nothing) to a tab and re-dispatch with target.tabId filled in. (#51)\n      if ((op === \"eval\" || op === \"inspect\") && (ctx === \"content\" || ctx === \"page\") && target.tabId == null) {\n        resolveTargetTab(target, function (tabId, err) {\n          if (tabId == null) {\n            replyErr(cmdId, \"Unsupported\", err || (\"eval/inspect in context \" + ctx + \" needs a --tab id, a --url to match, or an active tab\"));\n            return;\n          }\n          var next = {};\n          for (var k in cmd) { if (Object.prototype.hasOwnProperty.call(cmd, k)) next[k] = cmd[k]; }\n          next.target = {};\n          for (var tk in target) { if (Object.prototype.hasOwnProperty.call(target, tk)) next.target[tk] = target[tk]; }\n          next.target.tabId = tabId;\n          executeCommand(next);\n        });\n        return;\n      }\n      try {\n        if (!chrome) { replyErr(cmdId, \"Unsupported\", \"chrome.* not available in this context\"); return; }\n        if (op === \"eval\") {\n          if (ctx === \"background\") {\n            Promise.resolve().then(function () { return (0, eval)(args.expression); })\n              .then(function (r) { replyOk(cmdId, r); }, function (e) {\n                var msg = (e && e.message) || String(e);\n                // MV3 forbids eval of strings in the SW/extension pages and\n                // rejects 'unsafe-eval'. Surface it honestly with an alternative.\n                if (/Content Security Policy|unsafe-eval/i.test(msg)) {\n                  replyErr(cmdId, \"Unsupported\", \"eval is blocked in the extension background by CSP, which allows no unsafe-eval. Use --context page --tab <id> (eval runs in the page's MAIN world), or run on a build whose CSP permits it. Engine: \" + engineName());\n                } else {\n                  replyErr(cmdId, (e && e.name) || \"EvalError\", msg);\n                }\n              });\n          } else if ((ctx === \"content\" || ctx === \"page\") && target.tabId && chrome.scripting) {\n            // Wrap the eval so a throw INSIDE the tab comes back as data:\n            // Chrome swallows an injected function's exception (null result).\n            nsCall(\"scripting\", \"executeScript\", [{\n              target: {tabId: target.tabId},\n              world: ctx === \"page\" ? \"MAIN\" : \"ISOLATED\",\n              func: function (src) {\n                try { return {__extjsEval: 1, ok: true, value: eval(src)}; }\n                catch (e) { return {__extjsEval: 1, ok: false, name: (e && e.name) || \"EvalError\", message: (e && e.message) || String(e)}; }\n              },\n              args: [String(args.expression)]\n            }], function (err, res) {\n              if (err) { replyErr(cmdId, \"TargetNotFound\", (err && err.message) || err); return; }\n              var frame = res && res[0] ? res[0].result : undefined;\n              if (!frame || frame.__extjsEval !== 1) {\n                replyErr(cmdId, \"TargetNotFound\", \"the expression never executed in tab \" + target.tabId + \": no injectable frame returned a result (restricted page, or outside host_permissions)\");\n                return;\n              }\n              if (frame.ok) { replyOk(cmdId, frame.value); return; }\n              if (ctx === \"content\" && /Content Security Policy|unsafe-eval|EvalError/i.test(String(frame.name) + \" \" + String(frame.message))) {\n                replyErr(cmdId, \"Unsupported\", \"eval of a string is blocked in the ISOLATED (content) world by the extension CSP. Use --context page (runs in the page's MAIN world). Original: \" + frame.message);\n                return;\n              }\n              replyErr(cmdId, frame.name || \"EvalError\", frame.message);\n            });\n          } else if (ctx === \"popup\" || ctx === \"options\" || ctx === \"sidebar\" || ctx === \"devtools\" || ctx === \"newtab\" || ctx === \"history\" || ctx === \"bookmarks\") {\n            // The SW can't eval in another extension page; ask the surface's\n            // own in-bundle relay (only the open, matching-context page responds).\n            chrome.runtime.sendMessage(\n              {__extjsEvalRequest: true, target: target, args: {expression: String(args.expression)}},\n              function (resp) {\n                if ((chrome.runtime && chrome.runtime.lastError) || !resp) {\n                  replyErr(cmdId, \"Unsupported\", \"surface '\" + ctx + \"' is not open (open it first: extension open \" + ctx + \")\", \"surface_not_open\");\n                } else if (resp.ok) {\n                  replyOk(cmdId, resp.value);\n                } else {\n                  replyErr(cmdId, (resp.error && resp.error.name) || \"EvalError\", (resp.error && resp.error.message) || \"eval failed\");\n                }\n              }\n            );\n          } else if (ctx === \"content\" || ctx === \"page\") {\n            replyErr(cmdId, \"Unsupported\", target.tabId\n              ? \"chrome.scripting is not available on this engine (MV2 has no scripting API); use --context background\"\n              : \"eval in context \" + ctx + \" requires a tabId\");\n          } else {\n            replyErr(cmdId, \"BadRequest\", \"unknown eval context: \" + ctx);\n          }\n          return;\n        }\n        if (op === \"storage.get\" || op === \"storage.set\") {\n          // chrome.* storage is callback-only on Gecko and older Chromium.\n          // Prefer promisified browser.*, then fall back to the callback shape.\n          var storageNS = (g.browser && g.browser.storage) ? g.browser.storage : chrome.storage;\n          var storageArea = storageNS && storageNS[args.area || \"local\"];\n          if (!storageArea) { replyErr(cmdId, \"StorageError\", \"storage.\" + (args.area || \"local\") + \" unavailable\"); return; }\n          var isSet = op === \"storage.set\";\n          var callArgs = isSet ? [args.items || {}] : [args.key != null ? args.key : null];\n          var onStorageOk = function (r) { replyOk(cmdId, isSet ? {set: Object.keys(args.items || {})} : r); };\n          var onStorageErr = function (e) { replyErr(cmdId, \"StorageError\", (e && e.message) || String(e)); };\n          var storageFn = isSet ? storageArea.set : storageArea.get;\n          try {\n            var storageRet = storageFn.apply(storageArea, callArgs);\n            if (storageRet && typeof storageRet.then === \"function\") {\n              storageRet.then(onStorageOk, onStorageErr);\n              return;\n            }\n          } catch (e) { /* not thenable / threw synchronously: fall back to callback */ }\n          try {\n            storageFn.apply(storageArea, callArgs.concat([function (r) {\n              var le = chrome.runtime && chrome.runtime.lastError;\n              if (le) onStorageErr(le); else onStorageOk(r);\n            }]));\n          } catch (e) { onStorageErr(e); }\n          return;\n        }\n        if (op === \"reload\") {\n          if (ctx === \"background\") {\n            replyOk(cmdId, {reloading: true});\n            setTimeout(function () { try { chrome.runtime.reload(); } catch (e) {\n              // Ignore\n            } }, 50);\n          } else if (target.tabId) {\n            nsCall(\"tabs\", \"reload\", [target.tabId], function (err) {\n              if (err) replyErr(cmdId, \"ReloadError\", (err && err.message) || err);\n              else replyOk(cmdId, {reloaded: target.tabId});\n            });\n          } else {\n            replyErr(cmdId, \"Unsupported\", \"reload needs background or a tabId\");\n          }\n          return;\n        }\n        if (op === \"open\") {\n          var surface = args.surface || ctx;\n          // getPopup is promise-style on Gecko and (MV3) Chromium; fall back to\n          // callback-style for older Chromium. Always resolves to a string.\n          var getActionPopup = function (cb) {\n            try {\n              var r = chrome.action && chrome.action.getPopup && chrome.action.getPopup({});\n              if (r && typeof r.then === \"function\") {\n                r.then(function (p) { cb(p || \"\"); }, function () { cb(\"\"); });\n                return;\n              }\n            } catch (e) {\n              // Ignore\n            }\n            try { chrome.action.getPopup({}, function (p) { cb(p || \"\"); }); }\n            catch (e) { cb(\"\"); }\n          };\n          var resolveActiveTab = function (a, cb) {\n            if (a && typeof a.tabId === \"number\") {\n              try { chrome.tabs.get(a.tabId, function (t) { cb(t || {id: a.tabId}); }); return; }\n              catch (e) {\n                // Ignore\n              }\n            }\n            try { chrome.tabs.query({active: true, lastFocusedWindow: true}, function (tabs) { cb((tabs && tabs[0]) || undefined); }); }\n            catch (e) { cb(undefined); }\n          };\n          // Replaying a listener carries no user gesture, so activeTab is never\n          // granted. Warn when the manifest declares it.\n          var activeTabWarning = function () {\n            try {\n              var m = chrome.runtime.getManifest();\n              var perms = (m && m.permissions) || [];\n              if (perms.indexOf(\"activeTab\") !== -1) {\n                return \"replayed without a user gesture: activeTab is NOT granted, so APIs that depend on it (scripting on the active tab, captureVisibleTab) behave differently than a real click\";\n              }\n            } catch (e) {\n              // Ignore\n            }\n            return null;\n          };\n          if (surface === \"popup\") {\n            if (chrome.action && chrome.action.openPopup) {\n              nsCall(\"action\", \"openPopup\", [], function (err) {\n                if (err) {\n                  var openMsg = (err && err.message) || err;\n                  replyErr(cmdId, \"Unsupported\", \"openPopup: \" + openMsg, openRefusalCode(openMsg));\n                } else replyOk(cmdId, {opened: \"popup\"});\n              });\n            } else { replyErr(cmdId, \"Unsupported\", \"action.openPopup not available\", \"api_unavailable\"); }\n          } else if (surface === \"options\") {\n            try { chrome.runtime.openOptionsPage(function () { replyOk(cmdId, {opened: \"options\"}); }); }\n            catch (e) { replyErr(cmdId, \"Unsupported\", \"openOptionsPage: \" + e); }\n          } else if (surface === \"sidebar\") {\n            // The two member reads below are exactly what the Safari\n            // unsupported-API scan looks for, and this runtime is prepended to\n            // the background asset at PROCESS_ASSETS_STAGE_REPORT + 101, after\n            // that scan runs at SUMMARIZE + 1. Move the injection earlier and\n            // every Safari dev session warns about this line.\n            if (chrome.sidePanel && chrome.sidePanel.open && chrome.windows) {\n              chrome.windows.getCurrent(function (w) {\n                nsCall(\"sidePanel\", \"open\", [{windowId: w.id}], function (err) {\n                  if (err) {\n                    var sideMsg = (err && err.message) || err;\n                    replyErr(cmdId, \"Unsupported\", \"sidePanel.open: \" + sideMsg, openRefusalCode(sideMsg));\n                  } else replyOk(cmdId, {opened: \"sidebar\"});\n                });\n              });\n            } else { replyErr(cmdId, \"Unsupported\", \"sidePanel not available (engine: \" + engineName() + \")\", \"api_unavailable\"); }\n          } else if (surface === \"action\") {\n            // With a default_popup the click opens it; without one, replay the\n            // onClicked listeners captured at install time.\n            if (chrome.action) {\n              getActionPopup(function (popup) {\n                if (popup) {\n                  nsCall(\"action\", \"openPopup\", [], function (err) {\n                    if (err) {\n                      var actMsg = (err && err.message) || err;\n                      replyErr(cmdId, \"Unsupported\", \"openPopup: \" + actMsg, openRefusalCode(actMsg));\n                    } else replyOk(cmdId, {triggered: \"popup\"});\n                  });\n                } else if (actionClickedListeners.length) {\n                  resolveActiveTab(args, function (tab) {\n                    var fired = 0;\n                    for (var i = 0; i < actionClickedListeners.length; i++) {\n                      try { actionClickedListeners[i](tab); fired++; } catch (e) {\n                        // Ignore\n                      }\n                    }\n                    var reply = {triggered: \"onClicked\", listeners: fired, gesture: false};\n                    var warning = activeTabWarning();\n                    if (warning) reply.warning = warning;\n                    replyOk(cmdId, reply);\n                  });\n                } else {\n                  replyErr(cmdId, \"Unsupported\", \"action has no popup and no onClicked listener registered\");\n                }\n              });\n            } else { replyErr(cmdId, \"Unsupported\", \"chrome.action not available (engine: \" + engineName() + \")\", \"api_unavailable\"); }\n          } else if (surface === \"command\") {\n            var commandName = (args && args.name) || undefined;\n            if (!commandListeners.length) {\n              replyErr(cmdId, \"Unsupported\", \"no chrome.commands.onCommand listener registered\");\n            } else {\n              resolveActiveTab(args, function (tab) {\n                var fired = 0;\n                for (var i = 0; i < commandListeners.length; i++) {\n                  try { commandListeners[i](commandName, tab); fired++; } catch (e) {\n                    // Ignore\n                  }\n                }\n                replyOk(cmdId, {triggered: \"command\", command: commandName || null, listeners: fired, gesture: false});\n              });\n            }\n          } else { replyErr(cmdId, \"BadRequest\", \"unknown surface: \" + surface); }\n          return;\n        }\n        if (op === \"tabs.query\") {\n          nsCall(\"tabs\", \"query\", [args || {}], function (err, tabs) {\n            if (err) { replyErr(cmdId, \"TabsError\", (err && err.message) || err); return; }\n            replyOk(cmdId, (tabs || []).map(function (t) { return {id: t.id, url: t.url, title: t.title, active: t.active, windowId: t.windowId}; }));\n          });\n          return;\n        }\n        if (op === \"inspect\") {\n          // Extract a DOM snapshot from the target page via chrome.scripting\n          // (CDP-free). Closed shadow roots need CDP; here we read open ones.\n          if ((ctx === \"content\" || ctx === \"page\") && target.tabId && chrome.scripting) {\n            var maxBytes = (args && args.maxBytes) || 262144;\n            var includeHtml = !args || !args.include || args.include.indexOf(\"html\") !== -1;\n            nsCall(\"scripting\", \"executeScript\", [{\n              target: {tabId: target.tabId},\n              world: ctx === \"page\" ? \"MAIN\" : \"ISOLATED\",\n              func: function (wantHtml, cap) {\n                function countShadow(root) {\n                  var n = 0, els = root.querySelectorAll(\"*\");\n                  for (var i = 0; i < els.length; i++) { if (els[i].shadowRoot) { n++; n += countShadow(els[i].shadowRoot); } }\n                  return n;\n                }\n                var doc = document;\n                var roots = doc.querySelectorAll('#extension-root,[data-extension-root]');\n                var out = {\n                  url: location.href,\n                  title: doc.title,\n                  summary: {\n                    htmlLength: doc.documentElement.outerHTML.length,\n                    scriptCount: doc.querySelectorAll(\"script\").length,\n                    styleCount: doc.querySelectorAll(\"style,link[rel=stylesheet]\").length,\n                    extensionRootCount: roots.length,\n                    openShadowRoots: countShadow(doc),\n                    bodyChildCount: doc.body ? doc.body.children.length : 0\n                  }\n                };\n                if (wantHtml) {\n                  var html = doc.documentElement.outerHTML;\n                  if (cap > 0 && html.length > cap) { out.html = html.slice(0, cap); out.htmlTruncated = true; }\n                  else { out.html = html; }\n                }\n                return out;\n              },\n              args: [includeHtml, maxBytes]\n            }], function (err, res) {\n              if (err) { replyErr(cmdId, \"TargetNotFound\", (err && err.message) || err); return; }\n              var snap = res && res[0] ? res[0].result : undefined;\n              if (snap == null) { replyErr(cmdId, \"TargetNotFound\", \"no injectable frame returned a snapshot for tab \" + target.tabId + \" (restricted page, or outside host_permissions)\"); return; }\n              replyOk(cmdId, snap);\n            });\n          } else if (ctx === \"popup\" || ctx === \"options\" || ctx === \"sidebar\" || ctx === \"devtools\" || ctx === \"newtab\" || ctx === \"history\" || ctx === \"bookmarks\") {\n            // The SW can't read a surface page's DOM; ask the surface's own\n            // in-bundle relay (only the open, matching-context page responds).\n            chrome.runtime.sendMessage(\n              {__extjsInspectRequest: true, target: target, args: args},\n              function (resp) {\n                if (chrome.runtime.lastError || !resp) {\n                  replyErr(cmdId, \"Unsupported\", \"surface '\" + ctx + \"' is not open (open it first: extension open \" + ctx + \")\", \"surface_not_open\");\n                } else if (resp.ok) {\n                  replyOk(cmdId, resp.value);\n                } else {\n                  replyErr(cmdId, (resp.error && resp.error.name) || \"InspectError\", (resp.error && resp.error.message) || \"inspect failed\");\n                }\n              }\n            );\n          } else if (ctx === \"background\") {\n            replyErr(cmdId, \"Unsupported\", \"the service worker has no DOM; inspect a content/page (with --tab) or an open surface\");\n          } else {\n            replyErr(cmdId, \"Unsupported\", \"inspect of \" + ctx + \" requires a tabId (content/page) or an open surface\");\n          }\n          return;\n        }\n        replyErr(cmdId, \"BadRequest\", \"unknown op: \" + op);\n      } catch (e) {\n        replyErr(cmdId, \"ExecutorError\", e);\n      }\n    }\n\n    function noopLastError() { try { void g.chrome.runtime.lastError; } catch (e) {\n      // Ignore\n    } }\n\n    // Only http(s)/file/ftp tabs can run a content script; skip chrome://, the\n    // extension's own pages, about:blank, etc.\n    function isInjectableUrl(url) {\n      return typeof url === \"string\" && /^(https?|file|ftp):/i.test(url);\n    }\n\n    // Re-inject one declared entry's fresh files into every matching open tab.\n    // exclude_matches MUST be honored: query the excludes and subtract them.\n    function reinjectContentScriptEntry(entry) {\n      var chrome = g.chrome;\n      var matches = (entry && entry.matches) || [];\n      if (!Array.isArray(matches) || !matches.length) return;\n      var excludeMatches = (entry && entry.exclude_matches) || [];\n      var jsFiles = ((entry && entry.js) || []).filter(function (f) { return typeof f === \"string\"; });\n      var cssFiles = ((entry && entry.css) || []).filter(function (f) { return typeof f === \"string\"; });\n      if (!jsFiles.length && !cssFiles.length) return;\n      var world = entry.world === \"MAIN\" ? \"MAIN\" : \"ISOLATED\";\n      var allFrames = !!entry.all_frames;\n      function injectInto(excludedTabIds) {\n        try {\n          chrome.tabs.query({url: matches}, function (tabs) {\n            var err = null;\n            try { err = chrome.runtime.lastError; } catch (e) {\n              // Ignore\n            }\n            if (err || !tabs) return;\n            for (var i = 0; i < tabs.length; i++) {\n              (function (tab) {\n                if (!tab || tab.id == null || !isInjectableUrl(tab.url)) return;\n                if (excludedTabIds[tab.id]) return;\n                var target = {tabId: tab.id, allFrames: allFrames};\n                if (cssFiles.length && chrome.scripting.insertCSS) {\n                  try { chrome.scripting.insertCSS({target: target, files: cssFiles}, noopLastError); } catch (e) {\n                    // Ignore\n                  }\n                }\n                if (jsFiles.length && chrome.scripting.executeScript) {\n                  try {\n                    chrome.scripting.executeScript(\n                      {target: target, files: jsFiles, world: world, injectImmediately: true},\n                      noopLastError\n                    );\n                  } catch (e) {\n                    // Ignore\n                  }\n                }\n              })(tabs[i]);\n            }\n          });\n        } catch (e) {\n          // Ignore\n        }\n      }\n      if (Array.isArray(excludeMatches) && excludeMatches.length) {\n        try {\n          chrome.tabs.query({url: excludeMatches}, function (excludedTabs) {\n            try { void chrome.runtime.lastError; } catch (e) {\n              // Ignore\n            }\n            var excluded = {};\n            if (excludedTabs) {\n              for (var i = 0; i < excludedTabs.length; i++) {\n                if (excludedTabs[i] && excludedTabs[i].id != null) excluded[excludedTabs[i].id] = true;\n              }\n            }\n            injectInto(excluded);\n          });\n          return;\n        } catch (e) {\n          // Ignore\n        }\n      }\n      injectInto({});\n    }\n\n    // Re-inject all content scripts into their open tabs. Reads the manifest\n    // FROM DISK: getManifest() is frozen and dev filenames are content-hashed.\n    function reinjectContentScripts(onDone) {\n      var chrome = g.chrome;\n      try {\n        if (typeof g.fetch !== \"function\" || !chrome.scripting) return false;\n        g.fetch(chrome.runtime.getURL(\"manifest.json\"), {cache: \"no-store\"})\n          .then(function (r) { return r.json(); })\n          .then(function (manifest) {\n            var entries = (manifest && manifest.content_scripts) || [];\n            for (var i = 0; i < entries.length; i++) reinjectContentScriptEntry(entries[i]);\n            reregisterForFutureNavigations(entries);\n            if (onDone) { try { onDone(); } catch (e) {\n              // Ignore\n            } }\n          })\n          .catch(function () {\n            // Ignore\n          });\n        return true;\n      } catch (e) { return false; }\n    }\n\n    function mapRunAt(runAt) {\n      if (runAt === \"document_start\") return \"document_start\";\n      if (runAt === \"document_end\") return \"document_end\";\n      return \"document_idle\";\n    }\n\n    // Re-register content scripts dynamically at the fresh files, so tabs\n    // opened AFTER an edit also get the new build. Idempotent per entry id.\n    function reregisterForFutureNavigations(entries) {\n      var chrome = g.chrome;\n      if (\n        !chrome.scripting ||\n        !chrome.scripting.registerContentScripts ||\n        !chrome.scripting.getRegisteredContentScripts\n      ) return;\n\n      var scripts = [];\n      for (var i = 0; i < entries.length; i++) {\n        var e = entries[i] || {};\n        if (!Array.isArray(e.matches) || !e.matches.length) continue;\n        var js = (e.js || []).filter(function (f) { return typeof f === \"string\"; });\n        var css = (e.css || []).filter(function (f) { return typeof f === \"string\"; });\n        if (!js.length && !css.length) continue;\n        var s = {\n          id: \"extjs-dev-cs-\" + i,\n          matches: e.matches,\n          runAt: mapRunAt(e.run_at),\n          allFrames: !!e.all_frames,\n          world: e.world === \"MAIN\" ? \"MAIN\" : \"ISOLATED\"\n        };\n        // Dev registration must not be BROADER than the static one: dropping\n        // exclude_matches injects into pages the browser itself would skip.\n        if (Array.isArray(e.exclude_matches) && e.exclude_matches.length) {\n          s.excludeMatches = e.exclude_matches;\n        }\n        if (js.length) s.js = js;\n        if (css.length) s.css = css;\n        scripts.push(s);\n      }\n      if (!scripts.length) return;\n\n      try {\n        chrome.scripting.getRegisteredContentScripts(function (existing) {\n          try { void chrome.runtime.lastError; } catch (e) {\n            // Ignore\n          }\n          var have = {};\n          if (existing) for (var k = 0; k < existing.length; k++) have[existing[k].id] = true;\n          var toRegister = [], toUpdate = [];\n          for (var j = 0; j < scripts.length; j++) {\n            (have[scripts[j].id] ? toUpdate : toRegister).push(scripts[j]);\n          }\n          if (toRegister.length) {\n            try { chrome.scripting.registerContentScripts(toRegister, noopLastError); } catch (e) {\n              // Ignore\n            }\n          }\n          if (toUpdate.length) {\n            try { chrome.scripting.updateContentScripts(toUpdate, noopLastError); } catch (e) {\n              // Ignore\n            }\n          }\n        });\n      } catch (e) {\n        // Ignore\n      }\n    }\n\n    // Dev-loop reload without the CDP controller: content-scripts re-inject in\n    // place into open tabs; service-worker/full/manifest restart the extension.\n    function performDevReload(type, onDone) {\n      var chrome = g.chrome;\n      if (!chrome) return;\n\n      var fullReload = function () {\n        // Flag a pending reinject for the NEXT producer generation: the\n        // boot-time heal is what converges open tabs after a SW/full reload.\n        try {\n          if (chrome.storage && chrome.storage.local) {\n            chrome.storage.local.set({__extjsDevPendingReinject: Date.now()}, noopLastError);\n          }\n        } catch (e) {\n          // Ignore\n        }\n        // Deferred so in-flight frames and the tab console announcement flush\n        // before the SW dies; the devtools companion confirms completion.\n        try { setTimeout(function () { try { chrome.runtime.reload(); } catch (e) {\n          // Ignore\n        } }, 150); } catch (e) {}\n      };\n\n      if (type === \"content-scripts\" && chrome.scripting && chrome.tabs && chrome.tabs.query) {\n        if (reinjectContentScripts(onDone)) return;\n      }\n\n      fullReload();\n    }\n\n    // One server-built label travels the ReloadFrame; the announcement\n    // fires HERE, next to the actual reload action, so it stays true.\n\n    // console.log the reload line into every open injectable tab; the patched\n    // ISOLATED-world console also lands it in the dev-server log stream.\n    function announceReloadInTabs(text) {\n      var chrome = g.chrome;\n      if (!chrome || !chrome.tabs || !chrome.tabs.query) return;\n      try {\n        chrome.tabs.query({}, function (tabs) {\n          noopLastError();\n          if (!tabs) return;\n          for (var i = 0; i < tabs.length; i++) {\n            (function (tab) {\n              if (!tab || tab.id == null || !isInjectableUrl(tab.url)) return;\n              if (chrome.scripting && chrome.scripting.executeScript) {\n                try {\n                  chrome.scripting.executeScript(\n                    {target: {tabId: tab.id}, func: function (t) { console.log(t); }, args: [text]},\n                    noopLastError\n                  );\n                  return;\n                } catch (e) {\n                  // Ignore\n                }\n              }\n              // MV2 fallback (Firefox without the scripting API).\n              if (chrome.tabs.executeScript) {\n                try {\n                  chrome.tabs.executeScript(tab.id, {code: \"console.log(\" + JSON.stringify(text) + \");\"}, noopLastError);\n                } catch (e) {\n                  // Ignore\n                }\n              }\n            })(tabs[i]);\n          }\n        });\n      } catch (e) {\n        // Ignore\n      }\n    }\n\n    // The scripts-replay shim (plugin-reload) keeps the SW's own\n    // executeScript registry; the replay is fire-and-forget by design.\n    function replayProgrammaticScripts(changedScriptFiles) {\n      if (!Array.isArray(changedScriptFiles) || changedScriptFiles.length === 0) return;\n      var replay = g.__extjsScriptsReplay;\n      if (typeof replay !== \"function\") return;\n      try {\n        var outcome = replay(changedScriptFiles);\n        if (outcome && typeof outcome.then === \"function\") {\n          outcome.then(null, function () {});\n        }\n      } catch (e) {\n        // Ignore\n      }\n    }\n\n    function handleDevReloadFrame(frame) {\n      var kind = frame.reloadType || \"full\";\n      var label = typeof frame.label === \"string\" ? frame.label : \"\";\n      // The server always builds the label; the kind-derived fallback only\n      // covers a malformed frame so the announcement stays truthful.\n      var fallback = kind === \"content-scripts\" ? \"content_script\"\n        : kind === \"service-worker\" ? \"service_worker\"\n        : \"extension\";\n      var announced = \"[Extension.js] Reloading \" + (label || fallback) + \"\u2026\";\n\n      // A scripts/ bundle edit: re-run the executeScript calls that named it\n      // on their recorded tabs, before any reload decision below.\n      replayProgrammaticScripts(frame.changedScriptFiles);\n\n      if (kind === \"page\") {\n        // Notify-only: rspack-dev-server's livereload refreshes the open\n        // surface; reloading the extension here would race it.\n        return;\n      }\n\n      // Delivery ack for the broker: proves this SW's message pump processed\n      // the frame (a socket write proves nothing). Sent on receipt, by design.\n      send({type: \"reload-ack\", reloadType: kind, label: label});\n\n      announceReloadInTabs(announced);\n      performDevReload(kind, function () {});\n    }\n\n    function sanitize(args) {\n      var out = [];\n      for (var i = 0; i < args.length; i++) {\n        var p = args[i];\n        try {\n          if (typeof p === \"string\") out.push(p.length > 2048 ? p.slice(0, 2048) + \"...\" : p);\n          else if (p instanceof Error) out.push(p.name + \": \" + p.message);\n          else out.push(JSON.stringify(p));\n        } catch (e) {\n          out.push(String(p));\n        }\n        if (out.join(\" \").length > 8192) break;\n      }\n      return out;\n    }\n\n    function flush() {\n      while (queue.length && open && socket) {\n        var f = queue.shift();\n        try { socket.send(JSON.stringify(f)); } catch (e) { break; }\n      }\n    }\n\n    function send(frame) {\n      if (open && socket) {\n        try { socket.send(JSON.stringify(frame)); return; } catch (e) {\n          // Ignore\n        }\n      }\n      if (queue.length < MAX_QUEUE) queue.push(frame);\n      parkPendingError(frame);\n    }\n\n    // The queue above lives in this context's memory only, so a background\n    // that throws while it evaluates dies with the error still queued: the\n    // socket has not finished its handshake yet. Park error frames in\n    // extension storage too, where the NEXT context to connect can ship them.\n    // Best effort by construction: the write is asynchronous, so a teardown\n    // can cut it before the browser records anything.\n    var parkedErrors = [];\n    function storageLocalArea() {\n      try {\n        var ns = (g.chrome && g.chrome.storage) || (g.browser && g.browser.storage);\n        var area = ns && ns.local;\n        if (!area || typeof area.get !== \"function\" || typeof area.set !== \"function\") return null;\n        return area;\n      } catch (e) { return null; }\n    }\n    function parkPendingError(frame) {\n      if (open) return;\n      if (!frame || frame.type !== \"log\" || !frame.event || frame.event.level !== \"error\") return;\n      var area = storageLocalArea();\n      if (!area) return;\n      // The whole list is rewritten on every park, so two errors in one turn\n      // cannot lose each other to a read-modify-write, and the cap holds.\n      parkedErrors.push(frame);\n      while (parkedErrors.length > MAX_PENDING_ERRORS) parkedErrors.shift();\n      var items = {};\n      items[PENDING_ERRORS_KEY] = parkedErrors;\n      try { area.set(items, noopLastError); } catch (e) {\n        // Ignore\n      }\n    }\n    function parkedHere(id) {\n      for (var i = 0; i < parkedErrors.length; i++) {\n        var ev = parkedErrors[i] && parkedErrors[i].event;\n        if (ev && ev.id === id) return true;\n      }\n      return false;\n    }\n    // Ship what an earlier context parked and never got to send. Entries from\n    // another build (a different instance id) or from an older run are dropped,\n    // and the key is cleared on read so one failure is reported once.\n    function flushPendingErrors() {\n      var area = storageLocalArea();\n      if (!area) return;\n      var read = false;\n      function onRead(res) {\n        if (read) return;\n        read = true;\n        var list = res && res[PENDING_ERRORS_KEY];\n        if (!list || !list.length) return;\n        try {\n          if (typeof area.remove === \"function\") area.remove(PENDING_ERRORS_KEY, noopLastError);\n        } catch (e) {\n          // Ignore\n        }\n        var now = Date.now();\n        for (var i = 0; i < list.length; i++) {\n          var frame = list[i];\n          var ev = frame && frame.event;\n          if (!ev || ev.runId !== INSTANCE_ID) continue;\n          // This context parked it, so the queue flush above already has it.\n          if (parkedHere(ev.id)) continue;\n          if (typeof ev.timestamp !== \"number\" || now - ev.timestamp > PENDING_ERROR_TTL) continue;\n          send(frame);\n        }\n      }\n      try {\n        var ret = area.get(PENDING_ERRORS_KEY, function (res) { noopLastError(); onRead(res); });\n        if (ret && typeof ret.then === \"function\") ret.then(onRead, function () {});\n      } catch (e) {\n        // Ignore\n      }\n    }\n\n    // The baked PORT is a snapshot of an ephemeral port. After a dev-server\n    // restart, the port file shipped in the unpacked extension names the\n    // live one, and unpacked resources are read from disk on every fetch.\n    function refreshControlPort(done) {\n      try {\n        var runtime = (g.chrome && g.chrome.runtime) || (g.browser && g.browser.runtime);\n        if (!runtime || typeof runtime.getURL !== \"function\" || typeof g.fetch !== \"function\") { done(); return; }\n        g.fetch(runtime.getURL(\"extension-js-control.json\"), {cache: \"no-store\"})\n          .then(function (res) { return res.json(); })\n          .then(function (data) {\n            var next = data && parseInt(data.port, 10);\n            if (next && next > 0 && next < 65536 && next !== PORT) PORT = next;\n            done();\n          })\n          .catch(function () { done(); });\n      } catch (e) { done(); }\n    }\n\n    function schedule() {\n      var delay = backoff;\n      backoff = Math.min(backoff * 2, MAX_BACKOFF);\n      connectFailures++;\n      try {\n        setTimeout(function () {\n          // Two straight failures make the baked port suspect (a restarted\n          // server dials out on a new port): re-resolve before re-dialing.\n          if (connectFailures >= 2) refreshControlPort(connect);\n          else connect();\n        }, delay);\n      } catch (e) {\n        // Ignore\n      }\n    }\n\n    function connect() {\n      try {\n        socket = new WS(\"ws://\" + HOST + \":\" + PORT + \"/extjs-control\");\n      } catch (e) {\n        schedule();\n        return;\n      }\n      socket.onopen = function () {\n        open = true;\n        backoff = 250;\n        connectFailures = 0;\n        try {\n          socket.send(JSON.stringify({type: \"hello\", v: 1, role: \"producer\", instanceId: INSTANCE_ID}));\n        } catch (e) {\n          // Ignore\n        }\n        flush();\n        // Hello went first and this context's own queue is out; now replay any\n        // error a previous context parked before it died.\n        flushPendingErrors();\n      };\n      socket.onmessage = function (ev) {\n        var frame;\n        try { frame = JSON.parse(typeof ev.data === \"string\" ? ev.data : \"\"); } catch (e) { return; }\n        if (frame && frame.type === \"command\") {\n          try { executeCommand(frame); } catch (e) { replyErr(frame.cmdId, \"ExecutorError\", e); }\n        } else if (frame && frame.type === \"reload\") {\n          // Dev-loop reload broadcast (see broker.broadcastReload).\n          // Fire-and-forget: no result frame is expected.\n          try { handleDevReloadFrame(frame); } catch (e) {\n            // Ignore\n          }\n        } else if (frame && frame.type === \"ping\") {\n          // Server keepalive: merely RECEIVING this resets the MV3 SW's ~30s\n          // idle timer (Chrome 116+), keeping it reachable. Nothing to do.\n        }\n      };\n      socket.onclose = function () {\n        open = false;\n        socket = null;\n        schedule();\n      };\n      socket.onerror = function () {\n        try { socket && socket.close(); } catch (e) {\n          // Ignore\n        }\n      };\n    }\n\n    // Uncaught errors don't route through the patched console; the handlers\n    // below forward them, using these signatures to skip already-logged throws.\n    var recentErrorSigs = [];\n    function errorSig(message, stack) {\n      return String(message == null ? \"\" : message) + \"::\" + String(stack == null ? \"\" : stack).slice(0, 200);\n    }\n    function noteErrorSig(sig) {\n      recentErrorSigs.push({sig: sig, t: Date.now()});\n      if (recentErrorSigs.length > 50) recentErrorSigs.shift();\n    }\n    function errorSigSeenRecently(sig) {\n      var now = Date.now();\n      for (var i = recentErrorSigs.length - 1; i >= 0; i--) {\n        if (now - recentErrorSigs[i].t > 3000) { recentErrorSigs.splice(i, 1); continue; }\n        if (recentErrorSigs[i].sig === sig) return true;\n      }\n      return false;\n    }\n\n    LEVELS.forEach(function (level) {\n      var orig = typeof consoleRef[level] === \"function\"\n        ? consoleRef[level].bind(consoleRef)\n        : function () {};\n      consoleRef[level] = function () {\n        try {\n          if (level === \"error\") {\n            for (var ai = 0; ai < arguments.length; ai++) {\n              if (arguments[ai] instanceof Error) noteErrorSig(errorSig(arguments[ai].message, arguments[ai].stack));\n            }\n          }\n          send({\n            type: \"log\",\n            event: {\n              v: 1,\n              id: nowId(),\n              timestamp: Date.now(),\n              level: level,\n              context: CONTEXT,\n              messageParts: sanitize([].slice.call(arguments)),\n              runId: INSTANCE_ID\n            }\n          });\n        } catch (e) {\n          // Ignore\n        }\n        return orig.apply(consoleRef, arguments);\n      };\n    });\n\n    // Forward uncaught throws / unhandled rejections as level:\"error\", deduped\n    // so a logged-then-rethrown Error emits once.\n    function shipUncaughtError(message, stack, url) {\n      try {\n        var sig = errorSig(message, stack);\n        if (errorSigSeenRecently(sig)) return;\n        noteErrorSig(sig);\n        send({\n          type: \"log\",\n          event: {\n            v: 1,\n            id: nowId(),\n            timestamp: Date.now(),\n            level: \"error\",\n            context: CONTEXT,\n            messageParts: sanitize([String(message) + (stack ? \"\\n\" + stack : \"\")]),\n            url: url,\n            runId: INSTANCE_ID\n          }\n        });\n      } catch (e) {\n        // Ignore\n      }\n    }\n    try {\n      if (typeof g.addEventListener === \"function\") {\n        g.addEventListener(\"error\", function (ev) {\n          var err = ev && ev.error;\n          var message = (err && err.message) || (ev && ev.message) || \"Uncaught error\";\n          shipUncaughtError(message, err && err.stack, ev && ev.filename);\n        });\n        g.addEventListener(\"unhandledrejection\", function (ev) {\n          var reason = ev && ev.reason;\n          var message = (reason && reason.message) || (reason != null ? String(reason) : \"Unhandled rejection\");\n          shipUncaughtError(\"Unhandled promise rejection: \" + message, reason && reason.stack, undefined);\n        });\n      }\n    } catch (e) {\n      // Ignore\n    }\n\n    // Other contexts relay console logs to this SW over a NAMED runtime.Port:\n    // they can't open the WS under page CSP, and sendMessage can echo-loop.\n    function shipRelayedLog(ev, sender) {\n      try {\n        send({\n          type: \"log\",\n          event: {\n            v: 1,\n            id: nowId(),\n            timestamp: Date.now(),\n            level: ev.level || \"log\",\n            context: ev.context || \"content\",\n            messageParts: Array.isArray(ev.messageParts) ? ev.messageParts : [],\n            url: ev.url || (sender ? sender.url : undefined),\n            tabId: sender && sender.tab ? sender.tab.id : undefined,\n            frameId: sender ? sender.frameId : undefined,\n            runId: INSTANCE_ID\n          }\n        });\n      } catch (e) {\n        // Ignore\n      }\n    }\n    try {\n      var rtPort = g.chrome;\n      if (rtPort && rtPort.runtime && rtPort.runtime.onConnect) {\n        rtPort.runtime.onConnect.addListener(function (port) {\n          if (!port || port.name !== \"__extjs-bridge-log__\") return;\n          try {\n            port.onMessage.addListener(function (msg) {\n              if (!msg || !msg.__extjsBridgeLog) return;\n              shipRelayedLog(msg.__extjsBridgeLog, port.sender);\n            });\n          } catch (e) {\n            // Ignore\n          }\n        });\n      }\n    } catch (e) {\n      // Ignore\n    }\n    // Legacy sendMessage path: kept for any surface still relaying the old way\n    // (harmless one-predicate listener; new relays never use it).\n    try {\n      var rt = g.chrome;\n      if (rt && rt.runtime && rt.runtime.onMessage) {\n        rt.runtime.onMessage.addListener(function (msg, sender) {\n          if (!msg || !msg.__extjsBridgeLog) return;\n          shipRelayedLog(msg.__extjsBridgeLog, sender);\n        });\n      }\n    } catch (e) {\n      // Ignore\n    }\n\n    // Chrome never injects manifest content scripts into already-open tabs, so\n    // fire one reinject on onInstalled (which skips idle-stop SW wakes).\n    try {\n      var rtBoot = g.chrome;\n      if (rtBoot && rtBoot.runtime && rtBoot.runtime.onInstalled) {\n        rtBoot.runtime.onInstalled.addListener(function () {\n          try {\n            setTimeout(function () {\n              try { reinjectContentScripts(); } catch (e) {\n                // Ignore\n              }\n            }, 250);\n          } catch (e) {\n            // Ignore\n          }\n        });\n      }\n    } catch (e) {\n      // Ignore\n    }\n\n    // runtime.reload() does NOT fire onInstalled (verified Chromium 146), so\n    // consume the pre-reload storage flag here (fresh only) to heal open tabs.\n    try {\n      var stBoot = g.chrome;\n      if (stBoot && stBoot.storage && stBoot.storage.local) {\n        stBoot.storage.local.get(\"__extjsDevPendingReinject\", function (res) {\n          noopLastError();\n          var ts = res && res.__extjsDevPendingReinject;\n          if (ts == null) return;\n          try { stBoot.storage.local.remove(\"__extjsDevPendingReinject\", noopLastError); } catch (e) {\n            // Ignore\n          }\n          if (typeof ts !== \"number\" || Date.now() - ts > 30000) return;\n          setTimeout(function () {\n            try { reinjectContentScripts(); } catch (e) {\n              // Ignore\n            }\n          }, 250);\n        });\n      }\n    } catch (e) {\n      // Ignore\n    }\n\n    connect();\n  } catch (e) {\n    // Ignore\n  }\n})();\n";
 export declare const BRIDGE_RELAY_SOURCE = ";(function () {\n  try {\n    var g = (typeof globalThis === \"object\" && globalThis) ? globalThis : this;\n    if (!g || g.__extjsBridgeRelayInstalled) return;\n\n    var CONTEXT = \"__EXTJS_CONTEXT__\";\n    var chrome = g.chrome;\n    if (!chrome || !chrome.runtime) return;\n    var canRelay = typeof chrome.runtime.connect === \"function\";\n\n    g.__extjsBridgeRelayInstalled = true;\n    var consoleRef = g.console || {};\n    var LEVELS = [\"log\", \"info\", \"warn\", \"error\", \"debug\", \"trace\"];\n\n    function sanitize(args) {\n      var out = [];\n      for (var i = 0; i < args.length; i++) {\n        var p = args[i];\n        try {\n          if (typeof p === \"string\") out.push(p.length > 2048 ? p.slice(0, 2048) + \"...\" : p);\n          else if (p instanceof Error) out.push(p.name + \": \" + p.message);\n          else out.push(JSON.stringify(p));\n        } catch (e) { out.push(String(p)); }\n        if (out.join(\" \").length > 8192) break;\n      }\n      return out;\n    }\n\n    function here() { try { return g.location ? g.location.href : undefined; } catch (e) { return undefined; } }\n\n    // Lazy named port to the SW producer: connecting wakes an idle SW, but\n    // port frames never reach the extension's own onMessage listeners.\n    var logPort = null;\n    function getLogPort() {\n      if (!canRelay) return null;\n      if (logPort) return logPort;\n      try {\n        logPort = chrome.runtime.connect({name: \"__extjs-bridge-log__\"});\n        logPort.onDisconnect.addListener(function () {\n          try { void chrome.runtime.lastError; } catch (e) {\n            // Ignore\n          }\n          logPort = null;\n        });\n      } catch (e) { logPort = null; }\n      return logPort;\n    }\n\n    // Relay one log payload to the SW producer over the named port, redialing\n    // once if the port went stale (SW restarted).\n    function postLog(payload) {\n      var p = getLogPort();\n      if (!p) return;\n      try {\n        p.postMessage({__extjsBridgeLog: payload});\n      } catch (e) {\n        logPort = null;\n        var p2 = getLogPort();\n        if (p2) { try { p2.postMessage({__extjsBridgeLog: payload}); } catch (e2) {\n          // Ignore\n        } }\n      }\n    }\n\n    // Uncaught throws / unhandled rejections never route through the patched\n    // console; forward them, deduped against console.error Error signatures.\n    var recentErrorSigs = [];\n    function errorSig(message, stack) {\n      return String(message == null ? \"\" : message) + \"::\" + String(stack == null ? \"\" : stack).slice(0, 200);\n    }\n    function noteErrorSig(sig) {\n      recentErrorSigs.push({sig: sig, t: Date.now()});\n      if (recentErrorSigs.length > 50) recentErrorSigs.shift();\n    }\n    function errorSigSeenRecently(sig) {\n      var now = Date.now();\n      for (var i = recentErrorSigs.length - 1; i >= 0; i--) {\n        if (now - recentErrorSigs[i].t > 3000) { recentErrorSigs.splice(i, 1); continue; }\n        if (recentErrorSigs[i].sig === sig) return true;\n      }\n      return false;\n    }\n\n    LEVELS.forEach(function (level) {\n      var orig = typeof consoleRef[level] === \"function\" ? consoleRef[level].bind(consoleRef) : function () {};\n      consoleRef[level] = function () {\n        try {\n          if (level === \"error\") {\n            for (var ai = 0; ai < arguments.length; ai++) {\n              if (arguments[ai] instanceof Error) noteErrorSig(errorSig(arguments[ai].message, arguments[ai].stack));\n            }\n          }\n          postLog({level: level, context: CONTEXT, messageParts: sanitize([].slice.call(arguments)), url: here()});\n        } catch (e) {\n          // Ignore\n        }\n        return orig.apply(consoleRef, arguments);\n      };\n    });\n\n    function shipUncaughtError(message, stack, url) {\n      try {\n        var sig = errorSig(message, stack);\n        if (errorSigSeenRecently(sig)) return;\n        noteErrorSig(sig);\n        postLog({level: \"error\", context: CONTEXT, messageParts: sanitize([String(message) + (stack ? \"\\n\" + stack : \"\")]), url: url || here()});\n      } catch (e) {\n        // Ignore\n      }\n    }\n    try {\n      if (typeof g.addEventListener === \"function\") {\n        g.addEventListener(\"error\", function (ev) {\n          var err = ev && ev.error;\n          var message = (err && err.message) || (ev && ev.message) || \"Uncaught error\";\n          shipUncaughtError(message, err && err.stack, (ev && ev.filename) || undefined);\n        });\n        g.addEventListener(\"unhandledrejection\", function (ev) {\n          var reason = ev && ev.reason;\n          var message = (reason && reason.message) || (reason != null ? String(reason) : \"Unhandled rejection\");\n          shipUncaughtError(\"Unhandled promise rejection: \" + message, reason && reason.stack, undefined);\n        });\n      }\n    } catch (e) {\n      // Ignore\n    }\n\n    // The SW executor can't reach another extension page's DOM or eval there,\n    // so THIS surface answers inspect/eval requests for its own context.\n    try {\n      if (chrome.runtime && chrome.runtime.onMessage) {\n        chrome.runtime.onMessage.addListener(function (msg, _sender, sendResponse) {\n          if (!msg || !msg.__extjsEvalRequest) return;\n          if (!msg.target || msg.target.context !== CONTEXT) return; // not for me\n          try {\n            var value = (0, eval)(String((msg.args && msg.args.expression) || \"\"));\n            try { sendResponse({ok: true, value: value}); }\n            catch (eSend) { sendResponse({ok: true, value: String(value)}); }\n          } catch (e) {\n            var emsg = (e && e.message) || String(e);\n            if (/Content Security Policy|unsafe-eval|call to eval/i.test(emsg)) {\n              sendResponse({ok: false, error: {name: \"Unsupported\", message: \"eval of a string is blocked in the \" + CONTEXT + \" page by the MV3 extension CSP. Use extension inspect \" + CONTEXT + \" to read its DOM, or --context background on an MV2/Firefox build. Original: \" + emsg}});\n            } else {\n              sendResponse({ok: false, error: {name: (e && e.name) || \"EvalError\", message: emsg}});\n            }\n          }\n          return true; // responded\n        });\n      }\n    } catch (e) {\n      // Ignore\n    }\n\n    try {\n      if (chrome.runtime && chrome.runtime.onMessage) {\n        chrome.runtime.onMessage.addListener(function (msg, _sender, sendResponse) {\n          if (!msg || !msg.__extjsInspectRequest) return;\n          if (!msg.target || msg.target.context !== CONTEXT) return; // not for me\n          try {\n            var args = msg.args || {};\n            var wantHtml = !args.include || args.include.indexOf(\"html\") !== -1;\n            var cap = args.maxBytes || 262144;\n            function countShadow(root) {\n              var n = 0, els = root.querySelectorAll(\"*\");\n              for (var i = 0; i < els.length; i++) { if (els[i].shadowRoot) { n++; n += countShadow(els[i].shadowRoot); } }\n              return n;\n            }\n            var doc = g.document;\n            var roots = doc.querySelectorAll('#extension-root,[data-extension-root]');\n            var snap = {\n              context: CONTEXT,\n              url: here(),\n              title: doc.title,\n              summary: {\n                htmlLength: doc.documentElement.outerHTML.length,\n                scriptCount: doc.querySelectorAll(\"script\").length,\n                styleCount: doc.querySelectorAll(\"style,link[rel=stylesheet]\").length,\n                extensionRootCount: roots.length,\n                openShadowRoots: countShadow(doc),\n                bodyChildCount: doc.body ? doc.body.children.length : 0\n              }\n            };\n            if (wantHtml) {\n              var html = doc.documentElement.outerHTML;\n              if (cap > 0 && html.length > cap) { snap.html = html.slice(0, cap); snap.htmlTruncated = true; }\n              else { snap.html = html; }\n            }\n            sendResponse({ok: true, value: snap});\n          } catch (e) {\n            sendResponse({ok: false, error: {name: \"InspectError\", message: String(e)}});\n          }\n          return true; // responded\n        });\n      }\n    } catch (e) {\n      // Ignore\n    }\n  } catch (e) {\n    // Ignore\n  }\n})();\n";
 export interface BuildRelayOptions {
     context: string;
@@ -9,7 +9,6 @@ export interface BuildProducerOptions {
     controlPort: number | null | undefined;
     instanceId: string;
     context?: string;
-    /** Connectable host of the control WS. Defaults to 127.0.0.1 (local). */
     host?: string;
 }
 export declare function buildBridgeProducerSource(opts: BuildProducerOptions): string;

package/dist/dev-server~0.mjs

@@ -14,7 +14,7 @@ import { publicFolderOrDefault } from "./105~0.mjs";
 import { setupNoBrowserBannerOnFirstDone, DevSessionRestartScheduler, resolveConnectableHost, default as webpackConfig, bindDevSessionRestart, unbindDevSessionRestart, setupCompilerLifecycleHooks } from "./rspack-config~0.mjs";
 import { logsPath, controlPortFilePath, legacyControlPortFilePath, asAbsolute, getDistPath, ensureSessionStateInProjectGitignore, actionsPath, ensureSessionArtifactsIgnoreFile } from "./950~0.mjs";
 import { isDebug } from "./852~0.mjs";
-import { isGeckoBasedBrowser } from "./331~0.mjs";
+import { isGeckoBasedBrowser, isWebkitBasedBrowser } from "./331~0.mjs";
 import * as __rspack_external_node_os_4f3c9d58 from "node:os";
 import * as __rspack_external_node_path_806ed179 from "node:path";
 import * as __rspack_external_node_fs_1b05aee1 from "node:fs";
@@ -262,6 +262,7 @@ const UNDELIVERED_RELOAD_WARN = {
     'never-connected': "SW not attached, your edit compiled but no page received it. The extension's service worker has not connected to the dev server this session (a heavy ad/bot-laden page, an auth wall, or a profile-cached worker can prevent it). Reloads resume automatically once it connects.",
     'recently-disconnected': "SW not attached, your edit compiled but no page received it. The extension's service worker disconnected (MV3 workers idle out, or the browser may have exited). Reloads resume automatically once it reconnects."
 };
+const UNDELIVERED_RELOAD_WARN_WEBKIT_NEVER_CONNECTED = "Extension not connected, your edit compiled but no page received it. The extension has not connected to the dev server this session. Open Safari > Settings > Extensions and turn it on. Safari restarts the extension itself once it is enabled, and reloads resume automatically.";
 class BridgeBroker {
     instanceId;
     runId;
@@ -284,6 +285,7 @@ class BridgeBroker {
     sessionStartedAt;
     lastUndeliveredWarnKind = null;
     onExecutorAttached;
+    onExecutorDetached;
     lastProducerDisconnectedAt = null;
     lastStaleHelloAt = null;
     pendingReload;
@@ -299,6 +301,7 @@ class BridgeBroker {
         this.actions = options.actions;
         this.authorMode = options.authorMode ?? false;
         this.onExecutorAttached = options.onExecutorAttached;
+        this.onExecutorDetached = options.onExecutorDetached;
         this.now = options.now ?? (()=>Date.now());
         this.setTimer = options.setTimer ?? ((fn, ms)=>setTimeout(fn, ms));
         this.clearTimer = options.clearTimer ?? ((h)=>clearTimeout(h));
@@ -341,7 +344,13 @@ class BridgeBroker {
         const role = this.roles.get(conn);
         this.roles.delete(conn);
         this.evalGate.delete(conn);
-        if ('producer' === role) this.lastProducerDisconnectedAt = this.now();
+        if ('producer' === role) {
+            this.lastProducerDisconnectedAt = this.now();
+            const stillConnected = [
+                ...this.roles.values()
+            ].some((r)=>'producer' === r);
+            if (!stillConnected) this.onExecutorDetached?.();
+        }
         for (const [cmdId, p] of this.pending)if (p.controller === conn) {
             this.clearTimer(p.timer);
             this.pending.delete(cmdId);
@@ -366,13 +375,15 @@ class BridgeBroker {
         this.pendingReload = 0 === notified || "content-scripts" === frame.reloadType ? frame : void 0;
         return notified;
     }
-    undeliveredReloadWarning() {
+    undeliveredReloadWarning(options) {
         const now = this.now();
         if (now - this.sessionStartedAt < UNDELIVERED_RELOAD_GRACE_MS) return null;
         if (null != this.lastStaleHelloAt && now - this.lastStaleHelloAt < STALE_RESYNC_HINT_MS) return null;
         const kind = this.producerEverConnected ? 'recently-disconnected' : 'never-connected';
+        if (options?.producerRestartExpected && 'recently-disconnected' === kind) return null;
         if (this.lastUndeliveredWarnKind === kind) return null;
         this.lastUndeliveredWarnKind = kind;
+        if ('never-connected' === kind && 'webkit' === this.engine) return UNDELIVERED_RELOAD_WARN_WEBKIT_NEVER_CONNECTED;
         return UNDELIVERED_RELOAD_WARN[kind];
     }
     pingProducers() {
@@ -1131,10 +1142,11 @@ async function dev_server_devServer(projectStructure, devOptions) {
     }) : void 0;
     const bridgeControlToken = allowControl && allowEval ? writeControlToken(packageJsonDir, browserName) : void 0;
     let stampExecutorAttached;
+    let stampExecutorDetached;
     const bridgeBroker = new BridgeBroker({
         instanceId: currentInstance.instanceId,
         runId: sessionRunId,
-        engine: isGeckoBasedBrowser(browserName) ? 'firefox' : 'chromium',
+        engine: isGeckoBasedBrowser(browserName) ? 'firefox' : isWebkitBasedBrowser(browserName) ? 'webkit' : 'chromium',
         ring: new LogRingBuffer(),
         file: bridgeLogFile,
         allowControl,
@@ -1142,7 +1154,8 @@ async function dev_server_devServer(projectStructure, devOptions) {
         controlToken: bridgeControlToken,
         actions: bridgeActionsFile,
         authorMode,
-        onExecutorAttached: ()=>stampExecutorAttached?.()
+        onExecutorAttached: ()=>stampExecutorAttached?.(),
+        onExecutorDetached: ()=>stampExecutorDetached?.()
     });
     const launchedPlugin = extendedOptions.browsersPlugin;
     if (launchedPlugin && 'function' == typeof launchedPlugin.setReloadBroker) launchedPlugin.setReloadBroker(bridgeBroker);
@@ -1255,6 +1268,7 @@ async function dev_server_devServer(projectStructure, devOptions) {
         logsPath: bridgeLogsRelPath
     });
     stampExecutorAttached = ()=>metadata.stampExecutorAttached();
+    stampExecutorDetached = ()=>metadata.stampExecutorDetached();
     const lifecycle = createLifecycleStream({
         command: 'dev',
         browser: browserName,

package/dist/extension-js-devtools/edge/manifest.json

@@ -13,7 +13,6 @@
   "background": {
     "service_worker": "background/service_worker.js"
   },
-  "key": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAllbZJQG6Sfby1qyGr2pyR5JktAOh44tJMD1fm4Svk0JF/8TYwTTugJaFTPZoCepdgNU8gwc+jixaleQHOKNxmm2g1aV0eW8XSv4Mk+QM3//l9ftwvyoE/Z7vcwI1KT+OxUAoq6RUuQVjm007c4/mE3TiH83Atubrhp6eFVX7BfLAD49SNlpSvaK+Y8QgsJcmjQmLiUpkd4w9kWT3pk0Gn2Ytjz9spPurhdnFatwMuATQggazmS+lq0chGLzlznWN64lZER3iQ/gv30Z1DHGAPyOlf1w4YgVortWnbqrkIKzpCnymW2z8sj1BQMknaBW3katl20gg2DnpX4acsCzwYQIDAQAB",
   "permissions": [
     "management",
     "tabs",

package/dist/lib/addon-lint.d.ts

@@ -1,3 +1,4 @@
+import type { ChunkProvenance } from './chunk-dependency-provenance.js';
 export declare const ADDON_LINT_DEFAULT = true;
 export declare const ADDON_LINT_TIMEOUT_MS = 10000;
 export declare const ADDON_LINT_MAX_PRINTED = 20;
@@ -54,6 +55,7 @@ export interface RunAddonLintInput {
     enabled?: boolean;
     loadLinter?: LoadAddonLinter;
     timeoutMs?: number;
+    chunkProvenance?: () => Map<string, ChunkProvenance>;
 }
 export declare function shouldRunAddonLint(input: {
     browser: string;
@@ -63,7 +65,8 @@ export declare function shouldRunAddonLint(input: {
     status: 'skipped';
 }> | null;
 export declare function collectAddonLintLines(output: AddonLintOutput | null | undefined): AddonLintLine[];
-export declare function formatAddonLintFindings(output: AddonLintOutput | null | undefined, distDisplay: string, maxPrinted?: number): {
+export declare function attributionFor(location: string, chunkProvenance?: Map<string, ChunkProvenance>): string;
+export declare function formatAddonLintFindings(output: AddonLintOutput | null | undefined, distDisplay: string, maxPrinted?: number, chunkProvenance?: Map<string, ChunkProvenance>): {
     findings: number;
     lines: string[];
 };

package/dist/lib/chunk-dependency-provenance.d.ts

@@ -0,0 +1,14 @@
+export interface ChunkProvenance {
+    packages: string[];
+    onlyDependencies: boolean;
+}
+interface ChunkGraphLike {
+    getChunkModulesIterable: (chunk: never) => Iterable<unknown>;
+}
+export interface CompilationLike {
+    chunks?: Iterable<unknown>;
+    chunkGraph?: ChunkGraphLike;
+}
+export declare function packageNameFromPath(candidate: string): string | null;
+export declare function collectChunkDependencyProvenance(compilation: CompilationLike | null | undefined): Map<string, ChunkProvenance>;
+export {};

package/dist/lib/constants.d.ts

@@ -6,6 +6,7 @@ export declare const CHROMIUM_FAMILY_ALIASES: string[];
 export declare const GECKO_FAMILY_ALIASES: string[];
 export declare const SUPPORTED_BROWSERS: string[];
 export declare const SUPPORTED_PACKAGE_MANAGERS: readonly ['npm', 'pnpm', 'yarn', 'bun', 'deno'];
+export declare const SUPPORTED_RUNTIMES: readonly ['node', 'deno', 'bun'];
 export declare const SUPPORTED_UI_FRAMEWORKS: readonly ['react', 'preact', 'vue', 'svelte'];
 export declare const SUPPORTED_CSS_TECH: readonly ['css', 'css-modules', 'sass', 'less', 'postcss', 'tailwind'];
 export declare function isChromiumBasedBrowser(browser: string): boolean;