extension 4.1.37 → 4.1.38

package/dist/browsers.cjs

@@ -3027,12 +3027,20 @@ var __webpack_modules__ = {
                 const report = await response.json();
                 return report && 'held' === report.hold ? 'held' : 'open';
             } catch  {
-                return 'unknown';
+                return 'unreachable';
             } finally{
                 clearTimeout(timer);
             }
         }
-        function engineOriginLine(verdict) {
+        function engineOriginName(viewerUrl) {
+            try {
+                return new URL(viewerUrl).origin;
+            } catch  {
+                return viewerUrl;
+            }
+        }
+        function engineOriginLine(verdict, viewerUrl) {
+            if ('unreachable' === verdict) return `${(0, messaging.Pl)('warn')} the emulated Chromium origin ${engineOriginName(viewerUrl)} did not answer, so there is no page to open. Check your connection, then run extension dev again, or run this project with --browser=chrome.`;
             if ('held' === verdict) return `${(0, messaging.Pl)('warn')} emulated Chromium is not open to the public yet, so this address answers 503 until it is. Run this project with --browser=chrome in the meantime.`;
             if ('throttled' === verdict) return `${(0, messaging.Pl)('warn')} the emulated Chromium origin is rate limiting this address (HTTP 429). Wait a minute, then run extension dev again, or run this project with --browser=chrome.`;
             return null;
@@ -3058,7 +3066,7 @@ var __webpack_modules__ = {
             console.log(emulatorViewerUrlLine(url));
             const willOpen = !opts.noOpen && !opts.dryRun;
             const verdict = willOpen ? await probe(url) : 'unknown';
-            const originLine = engineOriginLine(verdict);
+            const originLine = engineOriginLine(verdict, url);
             if (originLine) console.warn(originLine);
             if (willOpen && !originLine) opener(url);
             const logsRequested = Boolean(opts.logLevel && 'off' !== opts.logLevel);
@@ -10167,6 +10175,10 @@ function describeButton(b) {
         };
     },
     "./helpers/vendors.ts" () {
+        const EMULATOR_BROWSER_TARGET = 'chromium-emulator';
+        function isEmulatorVendor(value) {
+            return value === EMULATOR_BROWSER_TARGET;
+        }
         function isSafariVendor(value) {
             return 'safari' === value || 'webkit-based' === value;
         }
@@ -10187,11 +10199,12 @@ function describeButton(b) {
             'gecko-based',
             'firefox-based',
             'safari',
-            'webkit-based'
+            'webkit-based',
+            EMULATOR_BROWSER_TARGET
         ];
         SUPPORTED_BROWSER_TARGETS.join(' | ');
         "chrome | chromium | edge | firefox | safari";
-        SUPPORTED_BROWSER_TARGETS.filter((target)=>!isSafariVendor(target)).join(' | ');
+        SUPPORTED_BROWSER_TARGETS.filter((target)=>!isSafariVendor(target) && !isEmulatorVendor(target)).join(' | ');
         const MANAGED_INSTALL_TARGETS = [
             'chrome',
             'chromium',

package/dist/cli.cjs

@@ -3029,12 +3029,20 @@ var __webpack_modules__ = {
                 const report = await response.json();
                 return report && 'held' === report.hold ? 'held' : 'open';
             } catch  {
-                return 'unknown';
+                return 'unreachable';
             } finally{
                 clearTimeout(timer);
             }
         }
-        function engineOriginLine(verdict) {
+        function engineOriginName(viewerUrl) {
+            try {
+                return new URL(viewerUrl).origin;
+            } catch  {
+                return viewerUrl;
+            }
+        }
+        function engineOriginLine(verdict, viewerUrl) {
+            if ('unreachable' === verdict) return `${(0, messaging.Pl)('warn')} the emulated Chromium origin ${engineOriginName(viewerUrl)} did not answer, so there is no page to open. Check your connection, then run extension dev again, or run this project with --browser=chrome.`;
             if ('held' === verdict) return `${(0, messaging.Pl)('warn')} emulated Chromium is not open to the public yet, so this address answers 503 until it is. Run this project with --browser=chrome in the meantime.`;
             if ('throttled' === verdict) return `${(0, messaging.Pl)('warn')} the emulated Chromium origin is rate limiting this address (HTTP 429). Wait a minute, then run extension dev again, or run this project with --browser=chrome.`;
             return null;
@@ -3060,7 +3068,7 @@ var __webpack_modules__ = {
             console.log(emulatorViewerUrlLine(url));
             const willOpen = !opts.noOpen && !opts.dryRun;
             const verdict = willOpen ? await probe(url) : 'unknown';
-            const originLine = engineOriginLine(verdict);
+            const originLine = engineOriginLine(verdict, url);
             if (originLine) console.warn(originLine);
             if (willOpen && !originLine) opener(url);
             const logsRequested = Boolean(opts.logLevel && 'off' !== opts.logLevel);
@@ -10280,8 +10288,8 @@ function describeButton(b) {
             if ('logs' === command) return EMULATOR_LOGS_REFUSAL;
             return `emulated Chromium runs in a web page and speaks no debugging protocol, so extension ${command} cannot reach it. Work in the page the dev server printed, or run this project with --browser=chrome.`;
         }
-        function isEmulatorSession(bridge, projectPath, browser, env = process.env) {
-            if ((0, _vendors__rspack_import_0.CM)(browser) && (0, _vendors__rspack_import_0.hs)(env)) return true;
+        function isEmulatorSession(bridge, projectPath, browser) {
+            if ((0, _vendors__rspack_import_0.CM)(browser)) return true;
             const reader = bridge?.readReadyContractDocument;
             if ('function' != typeof reader) return false;
             try {
@@ -10290,8 +10298,8 @@ function describeButton(b) {
                 return false;
             }
         }
-        function emulatorSessionRefusal(bridge, projectPath, browser, command, env = process.env) {
-            return isEmulatorSession(bridge, projectPath, browser, env) ? emulatorRefusalFor(command) : null;
+        function emulatorSessionRefusal(bridge, projectPath, browser, command) {
+            return isEmulatorSession(bridge, projectPath, browser) ? emulatorRefusalFor(command) : null;
         }
         __webpack_require__.d(__webpack_exports__, {
             MC: ()=>emulatorSessionRefusal
@@ -10621,10 +10629,6 @@ function describeButton(b) {
     },
     "./helpers/vendors.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         const EMULATOR_BROWSER_TARGET = 'chromium-emulator';
-        function isEmulatorLaneEnabled(env = process.env) {
-            const value = String(env.EXTENSION_EXPERIMENTAL_EMULATOR || '').trim().toLowerCase();
-            return '1' === value || 'true' === value;
-        }
         function isEmulatorVendor(value) {
             return value === EMULATOR_BROWSER_TARGET;
         }
@@ -10648,19 +10652,12 @@ function describeButton(b) {
             'gecko-based',
             'firefox-based',
             'safari',
-            'webkit-based'
+            'webkit-based',
+            EMULATOR_BROWSER_TARGET
         ];
         const BROWSER_TARGETS_HELP = SUPPORTED_BROWSER_TARGETS.join(' | ');
-        function supportedBrowserTargets(env = process.env) {
-            return isEmulatorLaneEnabled(env) ? [
-                ...SUPPORTED_BROWSER_TARGETS,
-                EMULATOR_BROWSER_TARGET
-            ] : [
-                ...SUPPORTED_BROWSER_TARGETS
-            ];
-        }
         const SESSION_BROWSER_TARGETS_HELP = "chrome | chromium | edge | firefox | safari";
-        const NO_SAFARI_BROWSER_TARGETS_HELP = SUPPORTED_BROWSER_TARGETS.filter((target)=>!isSafariVendor(target)).join(' | ');
+        const NO_SAFARI_BROWSER_TARGETS_HELP = SUPPORTED_BROWSER_TARGETS.filter((target)=>!isSafariVendor(target) && !isEmulatorVendor(target)).join(' | ');
         function parseOptionalBoolean(value) {
             if (void 0 === value) return true;
             const normalized = String(value).trim().toLowerCase();
@@ -10702,9 +10699,9 @@ function describeButton(b) {
                 ...MANAGED_INSTALL_BINARIES
             ] : vendors(browser);
         function validateVendors(vendorsList, onInvalid, options = {}) {
-            const supported = false === options.allowEmulator ? [
+            const supported = false === options.allowEmulator ? SUPPORTED_BROWSER_TARGETS.filter((target)=>!isEmulatorVendor(target)) : [
                 ...SUPPORTED_BROWSER_TARGETS
-            ] : supportedBrowserTargets();
+            ];
             for (const v of vendorsList)if (!supported.includes(v)) {
                 onInvalid(v, supported);
                 return false;
@@ -10734,7 +10731,6 @@ function describeButton(b) {
             $q: ()=>isSafariVendor,
             CM: ()=>isEmulatorVendor,
             RY: ()=>firstNonManagedInstallTarget,
-            hs: ()=>isEmulatorLaneEnabled,
             sJ: ()=>parseOptionalBoolean,
             sS: ()=>validateVendors
         }, {
@@ -11466,7 +11462,7 @@ function describeButton(b) {
         }
         var messaging = __webpack_require__("./helpers/messaging.ts");
         const TEMPLATE_CORPUS_REPO = 'extension-js/examples';
-        const TEMPLATE_CORPUS_REF = '407ae8ba560605385a60cdf5eb24087a20f54f9c';
+        const TEMPLATE_CORPUS_REF = '4938dfdd46b37fb237ab19c4157d5a9d2f222ca8';
         const TEMPLATE_CORPUS_SLUGS = [
             'action',
             'action-locales',

package/dist/extension/browsers/run-emulator/index.d.ts

@@ -16,7 +16,7 @@ export declare function openCommandFor(url: string, platform?: NodeJS.Platform):
     command: string;
     args: string[];
 };
-export type EngineOriginVerdict = 'open' | 'held' | 'throttled' | 'unknown';
+export type EngineOriginVerdict = 'open' | 'held' | 'throttled' | 'unreachable' | 'unknown';
 export type OriginFetch = (url: string, init: {
     signal: AbortSignal;
 }) => Promise<{
@@ -25,6 +25,7 @@ export type OriginFetch = (url: string, init: {
 }>;
 export declare function engineVersionUrl(viewerUrl: string): string | null;
 export declare function probeEngineOrigin(viewerUrl: string, fetchImpl?: OriginFetch, timeoutMs?: number): Promise<EngineOriginVerdict>;
-export declare function engineOriginLine(verdict: EngineOriginVerdict): string | null;
+export declare function engineOriginName(viewerUrl: string): string;
+export declare function engineOriginLine(verdict: EngineOriginVerdict, viewerUrl: string): string | null;
 export declare function openInDefaultBrowser(url: string): void;
 export declare function launchEmulator(opts: EmulatorLaunchOptions, opener?: UrlOpener, probe?: (url: string) => Promise<EngineOriginVerdict>): Promise<EmulatorController>;

package/dist/extension/config-types.d.ts

@@ -72,16 +72,32 @@ export interface BrowserConfig extends BrowserLaunchConfig {
 /**
  * Asset categories the perf-budgets plugin recognizes. `shared` is the chunk
  * every page that imports a framework or a common module loads. `public` is
- * a file copied from the public folder as authored. `runtime` covers
- * root-level runtime helpers emitted outside a surface folder, and `wasm`
- * every WebAssembly file, which cannot be split and gets 32 MiB by default.
+ * a file copied from the public folder as authored. `wasm` is a WebAssembly
+ * file only extension pages and workers fetch when they run it, such as an
+ * onnxruntime or ffmpeg core, which cannot be split and gets 32 MiB by
+ * default. `runtime` covers a WebAssembly file a content script or the
+ * service worker reaches, and root-level runtime helpers emitted outside a
+ * surface folder, 1 MiB by default.
  */
 export type PerfBudgetCategory = 'content-script' | 'service-worker' | 'page' | 'shared' | 'public' | 'runtime' | 'wasm' | 'ignored';
 /**
- * Per-category asset size budgets (bytes) for compiling commands.
- * Set at the top level, or per command via `commands.dev|build.perfBudgets`.
+ * Per-category asset size budgets (bytes) for compiling commands, plus
+ * `ignore`, the output paths no budget applies to: exact paths as the
+ * warning prints them, or globs where `*` stays inside one folder and `**`
+ * spans folders. Set at the top level, or per command via
+ * `commands.dev|build.perfBudgets`.
+ *
+ * @example
+ * export default {
+ *   perfBudgets: {
+ *     wasm: 48 * 1024 * 1024,
+ *     ignore: ['assets/ort-wasm-simd-threaded.asyncify.wasm']
+ *   }
+ * }
  */
-export type PerfBudgetsConfig = Partial<Record<PerfBudgetCategory, number>>;
+export type PerfBudgetsConfig = Partial<Record<PerfBudgetCategory, number>> & {
+    ignore?: string[];
+};
 /** `commands.dev` overrides. */
 export interface DevCommandConfig extends BrowserLaunchConfig, UnifiedLoggerConfig {
     browser?: BrowserType;

package/dist/extension/helpers/emulator-session.d.ts

@@ -1,4 +1,4 @@
 export declare const EMULATOR_LOGS_REFUSAL = "emulated Chromium runs in a web page, so extension logs has nothing to attach to. Open your browser devtools on that page to read the console.";
 export declare function emulatorRefusalFor(command: string): string;
-export declare function isEmulatorSession(bridge: unknown, projectPath: string, browser: string, env?: NodeJS.ProcessEnv): boolean;
-export declare function emulatorSessionRefusal(bridge: unknown, projectPath: string, browser: string, command: string, env?: NodeJS.ProcessEnv): string | null;
+export declare function isEmulatorSession(bridge: unknown, projectPath: string, browser: string): boolean;
+export declare function emulatorSessionRefusal(bridge: unknown, projectPath: string, browser: string, command: string): string | null;

package/dist/extension/helpers/template-catalog.d.ts

@@ -1,6 +1,6 @@
 export declare const DEFAULT_TEMPLATE = "typescript";
 export declare const BUNDLED_TEMPLATES: readonly string[];
-export declare const TEMPLATE_CATALOG_URL = "https://github.com/extension-js/examples/tree/407ae8ba560605385a60cdf5eb24087a20f54f9c/examples";
+export declare const TEMPLATE_CATALOG_URL = "https://github.com/extension-js/examples/tree/4938dfdd46b37fb237ab19c4157d5a9d2f222ca8/examples";
 export interface TemplateGroup {
     title: string;
     summary: string;

package/dist/extension/helpers/template-corpus.generated.d.ts

@@ -1,3 +1,3 @@
 export declare const TEMPLATE_CORPUS_REPO = "extension-js/examples";
-export declare const TEMPLATE_CORPUS_REF = "407ae8ba560605385a60cdf5eb24087a20f54f9c";
+export declare const TEMPLATE_CORPUS_REF = "4938dfdd46b37fb237ab19c4157d5a9d2f222ca8";
 export declare const TEMPLATE_CORPUS_SLUGS: readonly string[];

package/dist/extension/helpers/vendors.d.ts

@@ -1,11 +1,9 @@
 export type Browser = 'chrome' | 'edge' | 'firefox' | 'chromium' | 'chromium-based' | 'gecko-based' | 'firefox-based' | 'safari' | 'webkit-based' | 'chromium-emulator';
 export declare const EMULATOR_BROWSER_TARGET = "chromium-emulator";
-export declare function isEmulatorLaneEnabled(env?: NodeJS.ProcessEnv): boolean;
 export declare function isEmulatorVendor(value: unknown): boolean;
 export declare function isSafariVendor(value: string): boolean;
 export declare const SUPPORTED_BROWSER_TARGETS: string[];
 export declare const BROWSER_TARGETS_HELP: string;
-export declare function supportedBrowserTargets(env?: NodeJS.ProcessEnv): string[];
 export declare const SESSION_BROWSER_TARGETS_HELP: string;
 export declare const NO_SAFARI_BROWSER_TARGETS_HELP: string;
 export declare function parseOptionalBoolean(value?: string): boolean;

package/package.json

@@ -38,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "4.1.37",
+  "version": "4.1.38",
   "description": "The cross-browser extension framework. Build Chrome, Edge, Firefox, and Safari extensions with no build configuration.",
   "homepage": "https://extension.js.org/",
   "funding": "https://github.com/sponsors/cezaraugusto",
@@ -104,9 +104,9 @@
     "chromium-location": "2.1.2",
     "commander": "^15.0.0",
     "edge-location": "2.3.1",
-    "extension-create": "4.1.37",
-    "extension-develop": "4.1.37",
-    "extension-install": "4.1.37",
+    "extension-create": "4.1.38",
+    "extension-develop": "4.1.38",
+    "extension-install": "4.1.38",
     "firefox-location2": "3.2.0",
     "floorp-location": "1.0.0",
     "librewolf-location": "1.2.1",