extension 4.0.35 → 4.1.1

package/README.md

@@ -41,7 +41,7 @@ Browser extensions ship with the worst dev experience in modern web. Manifest V3
 
 ## Watch it work
 
-[60-second demo](https://github.com/cezaraugusto/extension/assets/4672033/7263d368-99c4-434f-a60a-72c489672586)
+[![Extension.js in 60 seconds: one command, a running extension](https://media.extension.land/video/extension-js/sixty-second-demo.gif)](https://extension.js.org/docs)
 
 Or skip the install and try a [live template](https://templates.extension.dev) in your browser.
 
@@ -155,7 +155,9 @@ npm install extension@latest --save-dev
 }
 ```
 
-Run `npm run dev` to develop, `npm run build` for production, and `npm run preview` to inspect the production output. [See it in action.](https://github.com/cezaraugusto/extension/assets/4672033/48694a23-b7f1-4098-9c5d-eff49983739c)
+Run `npm run dev` to develop, `npm run build` for production, and `npm run preview` to inspect the production output.
+
+[![extension dev: the browser opens with the extension loaded](https://media.extension.land/video/extension-js/dev-build-preview.gif)](https://extension.js.org/docs/commands/dev)
 
 ## Start from a Chrome sample
 
@@ -165,7 +167,7 @@ Pull any sample from [Chrome Extension Samples](https://github.com/GoogleChrome/
 npx extension@latest dev https://github.com/GoogleChrome/chrome-extensions-samples/tree/main/functional-samples/sample.page-redder --browser=edge
 ```
 
-[Watch demo](https://github.com/cezaraugusto/extension/assets/4672033/ee221a94-6ec7-4e04-8553-8812288927f1)
+[![Running a Chrome sample straight from its GitHub URL](https://media.extension.land/video/extension-js/run-chrome-sample.gif)](https://extension.js.org/docs/getting-started/immediately)
 
 ## Package managers
 

package/dist/browsers.cjs

@@ -237,10 +237,6 @@ var __webpack_modules__ = {
                             label: 'Browser',
                             value: provenanceNote ? `${browserLabel} ${provenanceNote}` : browserLabel
                         },
-                        {
-                            label: 'Binary',
-                            value: provenanceNote ? _messages__rspack_import_5.Yy(opts.binaryPath || '') : ''
-                        },
                         {
                             label: 'Output',
                             value: _messages__rspack_import_5.Yy(opts.outPath)
@@ -784,8 +780,6 @@ var __webpack_modules__ = {
         }
         function binaryProvenanceNote(provenance) {
             if ('pinned' === provenance) return '(pinned with --chromium-binary)';
-            if ('system' === provenance) return '(system, not the managed default)';
-            if ('snapshot' === provenance) return '(cached snapshot)';
             return '';
         }
         function runningInDevelopment(manifest, browser, message, browserVersionLine, updateSuffix, opts) {
@@ -824,7 +818,6 @@ var __webpack_modules__ = {
             }));
             const provenanceNote = binaryProvenanceNote(opts?.binaryProvenance);
             const browserLabel = provenanceNote ? `${baseBrowserLabel} ${provenanceNote}` : baseBrowserLabel;
-            const binaryRowValue = provenanceNote ? collapseHomeDirInCardValue(String(opts?.binaryPath || '').trim()) : '';
             const cleanId = String(id || '').trim();
             const includeExtensionId = opts?.includeExtensionId !== false;
             const updateNotice = updateSuffix ? ` ${updateSuffix}` : '';
@@ -838,18 +831,10 @@ var __webpack_modules__ = {
                         label: 'Browser',
                         value: browserLabel
                     },
-                    {
-                        label: 'Binary',
-                        value: binaryRowValue
-                    },
                     {
                         label: 'Extension',
                         value: displayVersion ? `${displayName} ${displayVersion}` : displayName
                     },
-                    {
-                        label: 'Extension ID',
-                        value: includeExtensionId ? cleanId : ''
-                    },
                     {
                         label: 'Profile',
                         value: collapseHomeDirInCardValue(String(opts?.profilePath || '').trim())
@@ -857,6 +842,10 @@ var __webpack_modules__ = {
                     {
                         label: 'Run ID',
                         value: opts?.runLabel || ''
+                    },
+                    {
+                        label: 'Extension ID',
+                        value: includeExtensionId ? cleanId : ''
                     }
                 ]
             });
@@ -1361,6 +1350,10 @@ var __webpack_modules__ = {
                 if ('number' == typeof details?.browserPid && Number.isFinite(details.browserPid)) ready.browserPid = details.browserPid;
                 const extensionId = String(details?.extensionId || '').trim();
                 if (extensionId) ready.extensionId = extensionId;
+                const binary = String(details?.binary || '').trim();
+                if (binary) ready.binary = binary;
+                const provenance = String(details?.binaryProvenance || '').trim();
+                if (provenance) ready.binaryProvenance = provenance;
                 node_fs__rspack_import_0.writeFileSync(readyPath, JSON.stringify(ready, null, 2));
             } catch  {}
         }
@@ -3244,6 +3237,8 @@ var __webpack_modules__ = {
                 (0, ready_stamp.M)(launchOutputPath, {
                     profilePath: chromiumConfig.find((flag)=>flag.startsWith('--user-data-dir='))?.slice('--user-data-dir='.length).replace(/^"|"$/g, ''),
                     browserPid: child?.pid,
+                    binary: browserBinaryLocation ?? void 0,
+                    binaryProvenance,
                     extensionId: launchOutputPath ? (0, banner.vy)(launchOutputPath) : void 0
                 });
                 const pipeStreams = usePipe && child?.stdio?.[3] && child?.stdio?.[4] ? {
@@ -5946,11 +5941,12 @@ var __webpack_modules__ = {
             console.error(...parts);
         }
         const CARD_LABEL_WIDTH = 15;
+        const MAX_CARD_ROWS = 3;
         function card(input = {}) {
             const version = String(input.version || '').trim();
             const suffix = String(input.suffix || '').trim();
-            const head = ` 🧩 ${pintor__rspack_import_0_default().brightBlue('Extension.js')}` + (version ? ` ${pintor__rspack_import_0_default().gray(version)}` : '') + (suffix ? ` ${suffix}` : '');
-            const body = (input.rows || []).filter((row)=>String(row.value || '').trim().length > 0).map((row)=>{
+            const head = ` 🧩 Extension.js` + (version ? ` ${pintor__rspack_import_0_default().gray(version)}` : '') + (suffix ? ` ${suffix}` : '');
+            const body = (input.rows || []).filter((row)=>String(row.value || '').trim().length > 0).slice(0, MAX_CARD_ROWS).map((row)=>{
                 const label = row.label.padEnd(CARD_LABEL_WIDTH);
                 return `    ${label}${pintor__rspack_import_0_default().gray(String(row.value).trim())}`;
             });

package/dist/cli.cjs

@@ -238,10 +238,6 @@ var __webpack_modules__ = {
                             label: 'Browser',
                             value: provenanceNote ? `${browserLabel} ${provenanceNote}` : browserLabel
                         },
-                        {
-                            label: 'Binary',
-                            value: provenanceNote ? _messages__rspack_import_5.Yy(opts.binaryPath || '') : ''
-                        },
                         {
                             label: 'Output',
                             value: _messages__rspack_import_5.Yy(opts.outPath)
@@ -785,8 +781,6 @@ var __webpack_modules__ = {
         }
         function binaryProvenanceNote(provenance) {
             if ('pinned' === provenance) return '(pinned with --chromium-binary)';
-            if ('system' === provenance) return '(system, not the managed default)';
-            if ('snapshot' === provenance) return '(cached snapshot)';
             return '';
         }
         function runningInDevelopment(manifest, browser, message, browserVersionLine, updateSuffix, opts) {
@@ -825,7 +819,6 @@ var __webpack_modules__ = {
             }));
             const provenanceNote = binaryProvenanceNote(opts?.binaryProvenance);
             const browserLabel = provenanceNote ? `${baseBrowserLabel} ${provenanceNote}` : baseBrowserLabel;
-            const binaryRowValue = provenanceNote ? collapseHomeDirInCardValue(String(opts?.binaryPath || '').trim()) : '';
             const cleanId = String(id || '').trim();
             const includeExtensionId = opts?.includeExtensionId !== false;
             const updateNotice = updateSuffix ? ` ${updateSuffix}` : '';
@@ -839,18 +832,10 @@ var __webpack_modules__ = {
                         label: 'Browser',
                         value: browserLabel
                     },
-                    {
-                        label: 'Binary',
-                        value: binaryRowValue
-                    },
                     {
                         label: 'Extension',
                         value: displayVersion ? `${displayName} ${displayVersion}` : displayName
                     },
-                    {
-                        label: 'Extension ID',
-                        value: includeExtensionId ? cleanId : ''
-                    },
                     {
                         label: 'Profile',
                         value: collapseHomeDirInCardValue(String(opts?.profilePath || '').trim())
@@ -858,6 +843,10 @@ var __webpack_modules__ = {
                     {
                         label: 'Run ID',
                         value: opts?.runLabel || ''
+                    },
+                    {
+                        label: 'Extension ID',
+                        value: includeExtensionId ? cleanId : ''
                     }
                 ]
             });
@@ -1362,6 +1351,10 @@ var __webpack_modules__ = {
                 if ('number' == typeof details?.browserPid && Number.isFinite(details.browserPid)) ready.browserPid = details.browserPid;
                 const extensionId = String(details?.extensionId || '').trim();
                 if (extensionId) ready.extensionId = extensionId;
+                const binary = String(details?.binary || '').trim();
+                if (binary) ready.binary = binary;
+                const provenance = String(details?.binaryProvenance || '').trim();
+                if (provenance) ready.binaryProvenance = provenance;
                 node_fs__rspack_import_0.writeFileSync(readyPath, JSON.stringify(ready, null, 2));
             } catch  {}
         }
@@ -3235,6 +3228,8 @@ var __webpack_modules__ = {
                 (0, ready_stamp.M)(launchOutputPath, {
                     profilePath: chromiumConfig.find((flag)=>flag.startsWith('--user-data-dir='))?.slice('--user-data-dir='.length).replace(/^"|"$/g, ''),
                     browserPid: child?.pid,
+                    binary: browserBinaryLocation ?? void 0,
+                    binaryProvenance,
                     extensionId: launchOutputPath ? (0, banner.vy)(launchOutputPath) : void 0
                 });
                 const pipeStreams = usePipe && child?.stdio?.[3] && child?.stdio?.[4] ? {
@@ -5959,11 +5954,12 @@ var __webpack_modules__ = {
             }
         };
         const CARD_LABEL_WIDTH = 15;
+        const MAX_CARD_ROWS = 3;
         function card(input = {}) {
             const version = String(input.version || '').trim();
             const suffix = String(input.suffix || '').trim();
-            const head = ` 🧩 ${pintor__rspack_import_0_default().brightBlue('Extension.js')}` + (version ? ` ${pintor__rspack_import_0_default().gray(version)}` : '') + (suffix ? ` ${suffix}` : '');
-            const body = (input.rows || []).filter((row)=>String(row.value || '').trim().length > 0).map((row)=>{
+            const head = ` 🧩 Extension.js` + (version ? ` ${pintor__rspack_import_0_default().gray(version)}` : '') + (suffix ? ` ${suffix}` : '');
+            const body = (input.rows || []).filter((row)=>String(row.value || '').trim().length > 0).slice(0, MAX_CARD_ROWS).map((row)=>{
                 const label = row.label.padEnd(CARD_LABEL_WIDTH);
                 return `    ${label}${pintor__rspack_import_0_default().gray(String(row.value).trim())}`;
             });
@@ -9111,6 +9107,14 @@ Cross-browser compatibility
                 }
             });
         }
+        function binaryDetailSuffix(ready) {
+            const binary = String(ready?.binary || '').trim();
+            if (!binary) return '';
+            const home = external_node_os_.homedir();
+            const shown = home && binary.startsWith(home + external_node_path_default().sep) ? `~${binary.slice(home.length)}` : binary;
+            const provenance = String(ready?.binaryProvenance || '').trim();
+            return provenance ? `, ${shown} (${provenance})` : `, ${shown}`;
+        }
         const CONNECT_TIMEOUT_MS = 5000;
         const PROBE_TIMEOUT_MS = 3000;
         const EXECUTOR_ATTACH_GRACE_MS = 10000;
@@ -9362,18 +9366,18 @@ Cross-browser compatibility
             if (ready.browserExitedAt) results.push({
                 check: 'browser',
                 status: 'fail',
-                detail: `browser exited at ${ready.browserExitedAt}${null != ready.browserExitCode ? ` (code ${ready.browserExitCode})` : ''} while the dev server kept running`,
+                detail: `browser exited at ${ready.browserExitedAt}${null != ready.browserExitCode ? ` (code ${ready.browserExitCode})` : ''} while the dev server kept running${binaryDetailSuffix(ready)}`,
                 remediation: 'Restart the dev session to relaunch the browser'
             });
             else if (null != ready.cdpPort) results.push({
                 check: 'browser',
                 status: 'pass',
-                detail: `browser running (cdpPort ${ready.cdpPort})`
+                detail: `browser running (cdpPort ${ready.cdpPort})${binaryDetailSuffix(ready)}`
             });
             else results.push({
                 check: 'browser',
                 status: 'skip',
-                detail: 'browser liveness unknown (no cdpPort stamped yet and no exit recorded)',
+                detail: `browser liveness unknown (no cdpPort stamped yet and no exit recorded)${binaryDetailSuffix(ready)}`,
                 remediation: 'If the browser should be up, wait for launch to finish or restart the dev session'
             });
             return results;

package/dist/extension/browsers/browsers-lib/ready-stamp.d.ts

@@ -3,6 +3,8 @@ export declare function stampReadyBrowserLaunch(extensionOutputPath: string | un
     profilePath?: string;
     browserPid?: number;
     extensionId?: string;
+    binary?: string;
+    binaryProvenance?: 'managed' | 'pinned' | 'system' | 'snapshot';
 }): void;
 export declare function stampReadyExtensionId(extensionOutputPath: string | undefined, extensionId: string | undefined): void;
 export declare function stampReadyExtensionLoadRefused(extensionOutputPath: string | undefined, reason: string): void;

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

@@ -23,6 +23,7 @@ export interface CardInput {
     suffix?: string;
     rows?: CardRow[];
 }
+export declare const MAX_CARD_ROWS = 3;
 export declare function card(input?: CardInput): string;
 export declare function browserRowValue(browser: string, versionLine?: string): string;
 export declare function isCardKeyClaimed(key: string): boolean;

package/package.json

@@ -38,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "4.0.35",
+  "version": "4.1.1",
   "description": "The cross-browser extension framework. Build Chrome, Edge, Firefox, and Safari extensions with no build configuration.",
   "homepage": "https://extension.js.org/",
   "bugs": {
@@ -106,9 +106,9 @@
     "vivaldi-location2": "2.1.1",
     "waterfox-location": "2.1.1",
     "yandex-location": "2.1.1",
-    "extension-create": "4.0.35",
-    "extension-develop": "4.0.35",
-    "extension-install": "4.0.35",
+    "extension-create": "4.1.1",
+    "extension-develop": "4.1.1",
+    "extension-install": "4.1.1",
     "commander": "^15.0.0",
     "pintor": "0.3.0",
     "semver": "^7.7.3",