extension 4.1.0 → 4.1.2

package/README.md

@@ -41,7 +41,7 @@ Browser extensions ship with the worst dev experience in modern web. Manifest V3
 
 ## Watch it work
 
-[![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)
+[![One command, and the extension is running in a real browser](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,10 +155,12 @@ 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.
+Run `npm run dev` to develop, and watch the browser open with your extension already loaded:
 
 [![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)
 
+Use `npm run build` for production, and `npm run preview` to inspect the production output.
+
 ## Start from a Chrome sample
 
 Pull any sample from [Chrome Extension Samples](https://github.com/GoogleChrome/chrome-extensions-samples) and run it directly:

package/dist/browsers.cjs

@@ -706,8 +706,10 @@ var __webpack_modules__ = {
         function safariDefaultBundleIdNote(bundleId) {
             return `${getLoggingPrefix('warn')} The bundle id ${pintor__rspack_import_8_default().gray(bundleId)} is generated from the app name.\nEvery project built from the same source shares this id, and the first team to register it takes it.\nSet your own with ${pintor__rspack_import_8_default().blue('--bundle-id')} before your first submission.\nAfter a submission, a new id is a new extension with none of your users.`;
         }
-        function safariOpenHint(appPath, appName) {
-            return `${getLoggingPrefix('info')} Launch it once to register with Safari: ${pintor__rspack_import_8_default().blue('open')} ${pintor__rspack_import_8_default().underline(`"${appPath}"`)}\nThen enable ${pintor__rspack_import_8_default().yellow(appName)} via Safari ▸ Develop ▸ ${pintor__rspack_import_8_default().yellow('Allow Unsigned Extensions')} and Safari ▸ Settings ▸ Extensions.`;
+        function safariOpenHint(appPath, appName, signed) {
+            const launch = `${getLoggingPrefix('info')} Launch it once to register with Safari: ${pintor__rspack_import_8_default().blue('open')} ${pintor__rspack_import_8_default().underline(`"${appPath}"`)}\n`;
+            if (signed) return launch + `Then turn on ${pintor__rspack_import_8_default().yellow(appName)} in Safari ▸ Settings ▸ Extensions.`;
+            return launch + `Then enable ${pintor__rspack_import_8_default().yellow(appName)} via Safari ▸ Develop ▸ ` + `${pintor__rspack_import_8_default().yellow('Allow Unsigned Extensions')} and Safari ▸ Settings ▸ Extensions.`;
         }
         function safariDryRunNotBuilding() {
             return `${getLoggingPrefix('info')} Dry run: skip the Safari app build.`;
@@ -718,7 +720,8 @@ var __webpack_modules__ = {
         function safariDryRunXcodebuild(cmd) {
             return `${getLoggingPrefix('info')} xcodebuild: ${pintor__rspack_import_8_default().gray(cmd)}.`;
         }
-        function safariNextSteps(appName) {
+        function safariNextSteps(appName, signed) {
+            if (signed) return `${getLoggingPrefix('info')} One-time setup to load ${pintor__rspack_import_8_default().yellow(appName)} in Safari:\n  ${pintor__rspack_import_8_default().gray('1.')} Safari ▸ Settings ▸ Extensions ▸ turn on ${pintor__rspack_import_8_default().yellow(appName)}\n  ${pintor__rspack_import_8_default().gray('→')} Signed with your team id, so this survives a restart.`;
             return `${getLoggingPrefix('info')} One-time setup to load ${pintor__rspack_import_8_default().yellow(appName)} in Safari:\n  ${pintor__rspack_import_8_default().gray('1.')} Safari ▸ Settings ▸ Advanced ▸ check ${pintor__rspack_import_8_default().yellow('“Show features for web developers”')}\n  ${pintor__rspack_import_8_default().gray('2.')} Safari ▸ Develop ▸ ${pintor__rspack_import_8_default().yellow('Allow Unsigned Extensions')} ${pintor__rspack_import_8_default().gray('(resets each launch)')}\n  ${pintor__rspack_import_8_default().gray('3.')} Safari ▸ Settings ▸ Extensions ▸ turn on ${pintor__rspack_import_8_default().yellow(appName)}\n  ${pintor__rspack_import_8_default().gray('→')} The app window that just opened can also take you there.`;
         }
         function safariRegistered(appName) {
@@ -780,8 +783,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) {
@@ -820,7 +821,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}` : '';
@@ -834,10 +834,6 @@ var __webpack_modules__ = {
                         label: 'Browser',
                         value: browserLabel
                     },
-                    {
-                        label: 'Binary',
-                        value: binaryRowValue
-                    },
                     {
                         label: 'Extension',
                         value: displayVersion ? `${displayName} ${displayVersion}` : displayName
@@ -1357,6 +1353,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  {}
         }
@@ -3240,6 +3240,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] ? {
@@ -5403,6 +5405,7 @@ var __webpack_modules__ = {
         var banner = __webpack_require__("./browsers/browsers-lib/banner.ts");
         var messages = __webpack_require__("./browsers/browsers-lib/messages.ts");
         var ready_message = __webpack_require__("./browsers/browsers-lib/ready-message.ts");
+        var ready_stamp = __webpack_require__("./browsers/browsers-lib/ready-stamp.ts");
         function logSafariDryRun(converterCmd, xcodebuildCmd) {
             if ((0, messaging._o)()) (0, messaging._w)(messages.KP());
             (0, messaging._w)(messages.yc());
@@ -5568,6 +5571,26 @@ var __webpack_modules__ = {
                 severity: 'ok'
             };
         }
+        async function resolvePidForBundle(bundleId) {
+            for(let attempt = 0; attempt < 10; attempt += 1){
+                const pid = await new Promise((resolve)=>{
+                    const child = (0, external_node_child_process_.spawn)("osascript", [
+                        '-e',
+                        `tell application "System Events" to get unix id of first process whose bundle identifier is "${bundleId}"`
+                    ]);
+                    let out = '';
+                    child.stdout.on('data', (d)=>out += String(d));
+                    child.on('error', ()=>resolve(null));
+                    child.on('close', ()=>{
+                        const n = Number(String(out).trim());
+                        resolve(Number.isFinite(n) && n > 0 ? n : null);
+                    });
+                });
+                if (pid) return pid;
+                await new Promise((r)=>setTimeout(r, 500));
+            }
+            return null;
+        }
         async function announceSafariDevSession(host, config, appPath) {
             try {
                 await (0, banner.ai)({
@@ -5586,6 +5609,7 @@ var __webpack_modules__ = {
             const config = (0, safari_config.F7)(compilation, host);
             const converterArgs = (0, safari_config.w7)(config);
             const xcodebuildArgs = (0, safari_config.vx)(config);
+            const isSigned = Boolean(config.developmentTeam);
             if ('full' === mode && config.bundleIdDerived) logger.warn?.(messages.$q(config.bundleIdentifier));
             if (host.dryRun || isTestEnv()) {
                 logSafariDryRun(`xcrun ${converterArgs.join(' ')}`, `xcodebuild ${xcodebuildArgs.join(' ')}`);
@@ -5645,7 +5669,7 @@ var __webpack_modules__ = {
             }
             logger.info?.(messages.Rl(appPath));
             if (!config.open) {
-                logger.info?.(messages.aO(appPath, config.appName));
+                logger.info?.(messages.aO(appPath, config.appName, isSigned));
                 if (host.announceDevReady) await announceSafariDevSession(host, config, appPath);
                 return describePackage(config);
             }
@@ -5658,7 +5682,15 @@ var __webpack_modules__ = {
                 '-a',
                 config.safariBinary
             ]);
-            logger.info?.(messages.fO(config.appName));
+            const raisedBundleId = config.safariBinary ? 'com.apple.Safari' : config.bundleIdentifier;
+            const browserPid = await resolvePidForBundle(raisedBundleId);
+            if (browserPid) (0, ready_stamp.M)(config.extensionDir, {
+                browserPid,
+                binary: config.safariBinary || appPath,
+                binaryProvenance: config.safariBinary ? 'pinned' : 'system',
+                extensionId: `${config.bundleIdentifier}.Extension`
+            });
+            logger.info?.(messages.fO(config.appName, isSigned));
             if (await confirmRegisteredWithSafari(config.bundleIdentifier)) logger.info?.(messages.fd(config.appName));
             else logger.info?.(messages.qY(config.appName));
             if (host.announceDevReady) await announceSafariDevSession(host, config, appPath);
@@ -5718,7 +5750,8 @@ var __webpack_modules__ = {
                 macOsOnly: false !== host.macOsOnly,
                 language: 'swift',
                 open: !host.noOpen,
-                safariBinary: host.safariBinary
+                safariBinary: host.safariBinary,
+                developmentTeam: String(host.developmentTeam || '').trim() || void 0
             };
         }
         function composeConverterArgs(config) {
@@ -5752,7 +5785,7 @@ var __webpack_modules__ = {
             return node_path__rspack_import_1.join(derivedDataPath(config), 'Build', 'Products', 'Release', `${config.appName}.app`);
         }
         function composeXcodebuildArgs(config) {
-            return [
+            const base = [
                 '-project',
                 xcodeProjectPath(config),
                 '-scheme',
@@ -5760,7 +5793,18 @@ var __webpack_modules__ = {
                 '-configuration',
                 'Release',
                 '-derivedDataPath',
-                derivedDataPath(config),
+                derivedDataPath(config)
+            ];
+            const team = String(config.developmentTeam || '').trim();
+            if (team) return [
+                ...base,
+                `DEVELOPMENT_TEAM=${team}`,
+                'CODE_SIGN_STYLE=Automatic',
+                '-allowProvisioningUpdates',
+                'build'
+            ];
+            return [
+                ...base,
                 'CODE_SIGN_IDENTITY=-',
                 'CODE_SIGNING_REQUIRED=NO',
                 'CODE_SIGNING_ALLOWED=YES',

package/dist/cli.cjs

@@ -707,8 +707,10 @@ var __webpack_modules__ = {
         function safariDefaultBundleIdNote(bundleId) {
             return `${getLoggingPrefix('warn')} The bundle id ${pintor__rspack_import_8_default().gray(bundleId)} is generated from the app name.\nEvery project built from the same source shares this id, and the first team to register it takes it.\nSet your own with ${pintor__rspack_import_8_default().blue('--bundle-id')} before your first submission.\nAfter a submission, a new id is a new extension with none of your users.`;
         }
-        function safariOpenHint(appPath, appName) {
-            return `${getLoggingPrefix('info')} Launch it once to register with Safari: ${pintor__rspack_import_8_default().blue('open')} ${pintor__rspack_import_8_default().underline(`"${appPath}"`)}\nThen enable ${pintor__rspack_import_8_default().yellow(appName)} via Safari ▸ Develop ▸ ${pintor__rspack_import_8_default().yellow('Allow Unsigned Extensions')} and Safari ▸ Settings ▸ Extensions.`;
+        function safariOpenHint(appPath, appName, signed) {
+            const launch = `${getLoggingPrefix('info')} Launch it once to register with Safari: ${pintor__rspack_import_8_default().blue('open')} ${pintor__rspack_import_8_default().underline(`"${appPath}"`)}\n`;
+            if (signed) return launch + `Then turn on ${pintor__rspack_import_8_default().yellow(appName)} in Safari ▸ Settings ▸ Extensions.`;
+            return launch + `Then enable ${pintor__rspack_import_8_default().yellow(appName)} via Safari ▸ Develop ▸ ` + `${pintor__rspack_import_8_default().yellow('Allow Unsigned Extensions')} and Safari ▸ Settings ▸ Extensions.`;
         }
         function safariDryRunNotBuilding() {
             return `${getLoggingPrefix('info')} Dry run: skip the Safari app build.`;
@@ -719,7 +721,8 @@ var __webpack_modules__ = {
         function safariDryRunXcodebuild(cmd) {
             return `${getLoggingPrefix('info')} xcodebuild: ${pintor__rspack_import_8_default().gray(cmd)}.`;
         }
-        function safariNextSteps(appName) {
+        function safariNextSteps(appName, signed) {
+            if (signed) return `${getLoggingPrefix('info')} One-time setup to load ${pintor__rspack_import_8_default().yellow(appName)} in Safari:\n  ${pintor__rspack_import_8_default().gray('1.')} Safari ▸ Settings ▸ Extensions ▸ turn on ${pintor__rspack_import_8_default().yellow(appName)}\n  ${pintor__rspack_import_8_default().gray('→')} Signed with your team id, so this survives a restart.`;
             return `${getLoggingPrefix('info')} One-time setup to load ${pintor__rspack_import_8_default().yellow(appName)} in Safari:\n  ${pintor__rspack_import_8_default().gray('1.')} Safari ▸ Settings ▸ Advanced ▸ check ${pintor__rspack_import_8_default().yellow('“Show features for web developers”')}\n  ${pintor__rspack_import_8_default().gray('2.')} Safari ▸ Develop ▸ ${pintor__rspack_import_8_default().yellow('Allow Unsigned Extensions')} ${pintor__rspack_import_8_default().gray('(resets each launch)')}\n  ${pintor__rspack_import_8_default().gray('3.')} Safari ▸ Settings ▸ Extensions ▸ turn on ${pintor__rspack_import_8_default().yellow(appName)}\n  ${pintor__rspack_import_8_default().gray('→')} The app window that just opened can also take you there.`;
         }
         function safariRegistered(appName) {
@@ -781,8 +784,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) {
@@ -821,7 +822,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}` : '';
@@ -835,10 +835,6 @@ var __webpack_modules__ = {
                         label: 'Browser',
                         value: browserLabel
                     },
-                    {
-                        label: 'Binary',
-                        value: binaryRowValue
-                    },
                     {
                         label: 'Extension',
                         value: displayVersion ? `${displayName} ${displayVersion}` : displayName
@@ -1358,6 +1354,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  {}
         }
@@ -3231,6 +3231,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] ? {
@@ -5394,6 +5396,7 @@ var __webpack_modules__ = {
         var banner = __webpack_require__("./browsers/browsers-lib/banner.ts");
         var messages = __webpack_require__("./browsers/browsers-lib/messages.ts");
         var ready_message = __webpack_require__("./browsers/browsers-lib/ready-message.ts");
+        var ready_stamp = __webpack_require__("./browsers/browsers-lib/ready-stamp.ts");
         function logSafariDryRun(converterCmd, xcodebuildCmd) {
             if ((0, messaging._o)()) (0, messaging._w)(messages.KP());
             (0, messaging._w)(messages.yc());
@@ -5559,6 +5562,26 @@ var __webpack_modules__ = {
                 severity: 'ok'
             };
         }
+        async function resolvePidForBundle(bundleId) {
+            for(let attempt = 0; attempt < 10; attempt += 1){
+                const pid = await new Promise((resolve)=>{
+                    const child = (0, external_node_child_process_.spawn)("osascript", [
+                        '-e',
+                        `tell application "System Events" to get unix id of first process whose bundle identifier is "${bundleId}"`
+                    ]);
+                    let out = '';
+                    child.stdout.on('data', (d)=>out += String(d));
+                    child.on('error', ()=>resolve(null));
+                    child.on('close', ()=>{
+                        const n = Number(String(out).trim());
+                        resolve(Number.isFinite(n) && n > 0 ? n : null);
+                    });
+                });
+                if (pid) return pid;
+                await new Promise((r)=>setTimeout(r, 500));
+            }
+            return null;
+        }
         async function announceSafariDevSession(host, config, appPath) {
             try {
                 await (0, banner.ai)({
@@ -5577,6 +5600,7 @@ var __webpack_modules__ = {
             const config = (0, safari_config.F7)(compilation, host);
             const converterArgs = (0, safari_config.w7)(config);
             const xcodebuildArgs = (0, safari_config.vx)(config);
+            const isSigned = Boolean(config.developmentTeam);
             if ('full' === mode && config.bundleIdDerived) logger.warn?.(messages.$q(config.bundleIdentifier));
             if (host.dryRun || isTestEnv()) {
                 logSafariDryRun(`xcrun ${converterArgs.join(' ')}`, `xcodebuild ${xcodebuildArgs.join(' ')}`);
@@ -5636,7 +5660,7 @@ var __webpack_modules__ = {
             }
             logger.info?.(messages.Rl(appPath));
             if (!config.open) {
-                logger.info?.(messages.aO(appPath, config.appName));
+                logger.info?.(messages.aO(appPath, config.appName, isSigned));
                 if (host.announceDevReady) await announceSafariDevSession(host, config, appPath);
                 return describePackage(config);
             }
@@ -5649,7 +5673,15 @@ var __webpack_modules__ = {
                 '-a',
                 config.safariBinary
             ]);
-            logger.info?.(messages.fO(config.appName));
+            const raisedBundleId = config.safariBinary ? 'com.apple.Safari' : config.bundleIdentifier;
+            const browserPid = await resolvePidForBundle(raisedBundleId);
+            if (browserPid) (0, ready_stamp.M)(config.extensionDir, {
+                browserPid,
+                binary: config.safariBinary || appPath,
+                binaryProvenance: config.safariBinary ? 'pinned' : 'system',
+                extensionId: `${config.bundleIdentifier}.Extension`
+            });
+            logger.info?.(messages.fO(config.appName, isSigned));
             if (await confirmRegisteredWithSafari(config.bundleIdentifier)) logger.info?.(messages.fd(config.appName));
             else logger.info?.(messages.qY(config.appName));
             if (host.announceDevReady) await announceSafariDevSession(host, config, appPath);
@@ -5709,7 +5741,8 @@ var __webpack_modules__ = {
                 macOsOnly: false !== host.macOsOnly,
                 language: 'swift',
                 open: !host.noOpen,
-                safariBinary: host.safariBinary
+                safariBinary: host.safariBinary,
+                developmentTeam: String(host.developmentTeam || '').trim() || void 0
             };
         }
         function composeConverterArgs(config) {
@@ -5743,7 +5776,7 @@ var __webpack_modules__ = {
             return node_path__rspack_import_1.join(derivedDataPath(config), 'Build', 'Products', 'Release', `${config.appName}.app`);
         }
         function composeXcodebuildArgs(config) {
-            return [
+            const base = [
                 '-project',
                 xcodeProjectPath(config),
                 '-scheme',
@@ -5751,7 +5784,18 @@ var __webpack_modules__ = {
                 '-configuration',
                 'Release',
                 '-derivedDataPath',
-                derivedDataPath(config),
+                derivedDataPath(config)
+            ];
+            const team = String(config.developmentTeam || '').trim();
+            if (team) return [
+                ...base,
+                `DEVELOPMENT_TEAM=${team}`,
+                'CODE_SIGN_STYLE=Automatic',
+                '-allowProvisioningUpdates',
+                'build'
+            ];
+            return [
+                ...base,
                 'CODE_SIGN_IDENTITY=-',
                 'CODE_SIGNING_REQUIRED=NO',
                 'CODE_SIGNING_ALLOWED=YES',
@@ -8354,7 +8398,7 @@ Cross-browser compatibility
             return null;
         }
         function registerBuildCommand(program) {
-            program.command('build').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.build).option(`--browser <${BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds a Safari app via Xcode (macOS only)').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `false`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--zip [boolean]', 'whether or not to compress the extension into a ZIP file. Defaults to `false`', parseOptionalBoolean).option('--zip-source [boolean]', 'whether or not to include the source files in the ZIP file. Defaults to `false`', parseOptionalBoolean).option('--zip-filename <string>', 'specify the name of the ZIP file. Defaults to the extension name and version').option('--silent [boolean]', 'suppress the build summary output. Defaults to `false`', parseOptionalBoolean).option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--mode <development|production|none>', 'bundler mode override (also sets NODE_ENV). Defaults to `production`').option('--open [boolean]', 'open the built Safari app after packaging (safari targets only). Defaults to `false`', parseOptionalBoolean).option('--app-name <name>', 'override the Safari app name (safari targets only). Defaults to the manifest `name`').option('--bundle-id <reverse.dns>', 'set a user-owned Safari bundle identifier (safari targets only). Defaults to a generated dev.extensionjs.* id').option('--macos-only [boolean]', 'generate a macOS-only Safari Xcode project (safari targets only). Pass `false` for a universal macOS + iOS project. Defaults to `true`', parseOptionalBoolean).option('--force-regenerate', 'regenerate the Safari Xcode project even when up to date (safari targets only)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, { browser = 'chromium', ...buildOptions })=>{
+            program.command('build').arguments('[project-name]').usage('[path-to-remote-extension] [options]').description(commandDescriptions.build).option(`--browser <${BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds a Safari app via Xcode (macOS only)').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `false`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--zip [boolean]', 'whether or not to compress the extension into a ZIP file. Defaults to `false`', parseOptionalBoolean).option('--zip-source [boolean]', 'whether or not to include the source files in the ZIP file. Defaults to `false`', parseOptionalBoolean).option('--zip-filename <string>', 'specify the name of the ZIP file. Defaults to the extension name and version').option('--silent [boolean]', 'suppress the build summary output. Defaults to `false`', parseOptionalBoolean).option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--mode <development|production|none>', 'bundler mode override (also sets NODE_ENV). Defaults to `production`').option('--open [boolean]', 'open the built Safari app after packaging (safari targets only). Defaults to `false`', parseOptionalBoolean).option('--app-name <name>', 'override the Safari app name (safari targets only). Defaults to the manifest `name`').option('--bundle-id <reverse.dns>', 'set a user-owned Safari bundle identifier (safari targets only). Defaults to a generated dev.extensionjs.* id').option('--development-team <id>', 'sign the Safari app with an Apple Developer team id (safari targets only). Without it the build is ad-hoc signed, which Safari treats as unsigned: the extension then needs Develop \u25b8 Allow Unsigned Extensions re-ticked on every launch. A signed build is listed and stays enabled across restarts').option('--macos-only [boolean]', 'generate a macOS-only Safari Xcode project (safari targets only). Pass `false` for a universal macOS + iOS project. Defaults to `true`', parseOptionalBoolean).option('--force-regenerate', 'regenerate the Safari Xcode project even when up to date (safari targets only)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).action(async (pathOrRemoteUrl, { browser = 'chromium', ...buildOptions })=>{
                 if (buildOptions.debug || buildOptions.author || buildOptions.authorMode) {
                     process.env.EXTENSION_DEBUG = '1';
                     process.env.EXTENSION_AUTHOR_MODE = 'true';
@@ -8387,6 +8431,10 @@ Cross-browser compatibility
                         '--bundle-id',
                         buildOptions.bundleId
                     ],
+                    [
+                        '--development-team',
+                        buildOptions.developmentTeam
+                    ],
                     [
                         '--force-regenerate',
                         buildOptions.forceRegenerate
@@ -8432,6 +8480,7 @@ Cross-browser compatibility
                         mode,
                         appName: buildOptions.appName,
                         bundleId: buildOptions.bundleId,
+                        developmentTeam: buildOptions.developmentTeam,
                         macOsOnly: buildOptions.macosOnly,
                         forceRegenerate: buildOptions.forceRegenerate,
                         safariPackager: safariPackagingEnabled ? (0, safari_packager.P)({
@@ -8941,7 +8990,7 @@ Cross-browser compatibility
             return Number.isFinite(parsed) && parsed >= 0 ? Math.floor(parsed) : 8080;
         }
         function registerDevCommand(program) {
-            program.command('dev').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.dev).addHelpText('after', "\nAdditional options:\n  --no-browser    do not launch the browser (dev server still starts)\n  --no-reload     emit a dev-mode dist without the content-script reload runtime; tabs need manual reload to see changes\n  --wait          wait for ready contract and exit; pair with --output json for machine output\n").option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option(`-b, --browser <${BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds and opens a Safari app via Xcode (macOS only; no live reload)').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').option('--gecko-binary, --firefox-binary <path-to-binary>', 'specify a path to the Gecko binary. This option overrides the --browser setting. Defaults to the system default').option('--safari-binary <path-to-binary>', 'specify the Safari binary to open after packaging (safari targets only)').option('--app-name <name>', 'override the Safari app name (safari targets only). Defaults to the manifest `name`').option('--bundle-id <reverse.dns>', 'set a user-owned Safari bundle identifier (safari targets only). Defaults to a generated dev.extensionjs.* id').option('--macos-only [boolean]', 'generate a macOS-only Safari Xcode project (safari targets only). Pass `false` for a universal macOS + iOS project. Defaults to `true`', parseOptionalBoolean).option('--force-regenerate', 'regenerate the Safari Xcode project even when up to date (safari targets only)').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--no-open', 'do not open the browser automatically (default: open)').option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--public-host <host>', 'connectable host the browser (HMR + reload bridge) dials when it differs from the bind host (e.g. a remote/devcontainer). Defaults to the bind host, or 127.0.0.1 when bound to 0.0.0.0').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', parseOptionalBoolean).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--wait-format <pretty|json>').hideHelp()).addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).option('--allow-control', 'enable the agent-bridge control channel for bounded act (storage/reload/open): see `extension reload|storage|open`').option('--allow-eval', 'additionally enable `extension eval` (implies --allow-control, runs arbitrary code in a context, writes a 0600 session token)').option('--parent-pid <pid>', 'exit when the given process dies. For wrappers that spawn `extension dev`, so a leaked dev server can never outlive its owner').action(async (pathOrRemoteUrl, options, command)=>{
+            program.command('dev').arguments('[project-path|remote-url]').usage('[project-path|remote-url] [options]').description(commandDescriptions.dev).addHelpText('after', "\nAdditional options:\n  --no-browser    do not launch the browser (dev server still starts)\n  --no-reload     emit a dev-mode dist without the content-script reload runtime; tabs need manual reload to see changes\n  --wait          wait for ready contract and exit; pair with --output json for machine output\n").option('--profile <path-to-file | boolean>', 'what path to use for the browser profile. A boolean value of false sets the profile to the default user profile. Defaults to a fresh profile').option(`-b, --browser <${BROWSER_TARGETS_HELP}>`, 'specify a browser/engine to run. Defaults to `chromium`. `safari` builds and opens a Safari app via Xcode (macOS only; no live reload)').option('--chromium-binary <path-to-binary>', 'specify a path to the Chromium binary. This option overrides the --browser setting. Defaults to the system default').option('--gecko-binary, --firefox-binary <path-to-binary>', 'specify a path to the Gecko binary. This option overrides the --browser setting. Defaults to the system default').option('--safari-binary <path-to-binary>', 'specify the Safari binary to open after packaging (safari targets only)').option('--app-name <name>', 'override the Safari app name (safari targets only). Defaults to the manifest `name`').option('--bundle-id <reverse.dns>', 'set a user-owned Safari bundle identifier (safari targets only). Defaults to a generated dev.extensionjs.* id').option('--development-team <id>', 'sign the Safari app with an Apple Developer team id (safari targets only). Without it the build is ad-hoc signed, which Safari treats as unsigned: the extension then needs Develop \u25b8 Allow Unsigned Extensions re-ticked on every launch. A signed build is listed and stays enabled across restarts').option('--macos-only [boolean]', 'generate a macOS-only Safari Xcode project (safari targets only). Pass `false` for a universal macOS + iOS project. Defaults to `true`', parseOptionalBoolean).option('--force-regenerate', 'regenerate the Safari Xcode project even when up to date (safari targets only)').option('--polyfill [boolean]', 'whether or not to apply the cross-browser polyfill. Defaults to `true`', parseOptionalBoolean).option('--no-polyfill', 'disable the cross-browser polyfill').option('--no-open', 'do not open the browser automatically (default: open)').option('--starting-url <url>', 'specify the starting URL for the browser. Defaults to `undefined`').option('--port <port>', 'specify the port to use for the development server. Defaults to `8080`').option('--host <host>', 'specify the host to bind the dev server to. Use 0.0.0.0 for Docker/devcontainers. Defaults to `127.0.0.1`').option('--public-host <host>', 'connectable host the browser (HMR + reload bridge) dials when it differs from the bind host (e.g. a remote/devcontainer). Defaults to the bind host, or 127.0.0.1 when bound to 0.0.0.0').option('--log-context <list>', '[experimental] comma-separated contexts to include (background,content,page,sidebar,popup,options,devtools). Use `all` to include all contexts (default)').option('--logs <off|error|warn|info|debug|trace|all>', '[experimental] minimum centralized logger level to display in terminal (default: off)').option('--log-format <pretty|json|ndjson>', '[experimental] output format for logger events. Defaults to `pretty`').option('--no-log-timestamps', 'disable ISO timestamps in pretty output').option('--no-log-color', 'disable color in pretty output').option('--log-url <pattern>', '[experimental] only show logs where event.url matches this substring or regex (/re/i)').option('--log-tab <id>', 'only show logs for a specific tabId (number)').option('--extensions <list>', 'comma-separated list of companion extensions or store URLs to load').option('--install [boolean]', '[internal] install project dependencies when missing', parseOptionalBoolean).option('--wait [boolean]', 'wait for dist/extension-js/<browser>/ready.json and exit', parseOptionalBoolean).option('--wait-timeout <ms>', 'timeout in milliseconds when using --wait (default: 60000)').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').addOption(new external_commander_namespaceObject.Option('--wait-format <pretty|json>').hideHelp()).addOption(new external_commander_namespaceObject.Option('--debug', 'print maintainer diagnostics alongside normal output')).addOption(new external_commander_namespaceObject.Option('--author, --author-mode', 'deprecated alias for --debug').hideHelp()).option('--allow-control', 'enable the agent-bridge control channel for bounded act (storage/reload/open): see `extension reload|storage|open`').option('--allow-eval', 'additionally enable `extension eval` (implies --allow-control, runs arbitrary code in a context, writes a 0600 session token)').option('--parent-pid <pid>', 'exit when the given process dies. For wrappers that spawn `extension dev`, so a leaked dev server can never outlive its owner').action(async (pathOrRemoteUrl, options, command)=>{
                 const { browser = 'chromium', ...devOptions } = options;
                 if (devOptions.debug || devOptions.author || devOptions.authorMode) {
                     process.env.EXTENSION_DEBUG = '1';
@@ -8985,6 +9034,10 @@ Cross-browser compatibility
                         '--bundle-id',
                         opts.bundleId
                     ],
+                    [
+                        '--development-team',
+                        opts.developmentTeam
+                    ],
                     [
                         '--force-regenerate',
                         opts.forceRegenerate
@@ -9108,6 +9161,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;
@@ -9359,18 +9420,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/messages.d.ts

@@ -72,11 +72,11 @@ export declare function safariOpening(target: string): string;
 export declare function safariToolFailed(tool: string, exitCode: number | null, outputTail: string): string;
 export declare function safariConverterWarnings(warnings: string[]): string;
 export declare function safariDefaultBundleIdNote(bundleId: string): string;
-export declare function safariOpenHint(appPath: string, appName: string): string;
+export declare function safariOpenHint(appPath: string, appName: string, signed?: boolean): string;
 export declare function safariDryRunNotBuilding(): string;
 export declare function safariDryRunConverter(cmd: string): string;
 export declare function safariDryRunXcodebuild(cmd: string): string;
-export declare function safariNextSteps(appName: string): string;
+export declare function safariNextSteps(appName: string, signed?: boolean): string;
 export declare function safariRegistered(appName: string): string;
 export declare function safariNotYetRegistered(appName: string): string;
 export declare function safariRebuilt(appName: string): string;

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/browsers/run-safari/safari-types.d.ts

@@ -2,6 +2,7 @@ import type { PluginInterface } from '../browsers-types';
 export type SafariPluginLike = Pick<PluginInterface, 'extension' | 'noOpen' | 'instanceId' | 'dryRun'> & {
     browser: PluginInterface['browser'];
     safariBinary?: string;
+    developmentTeam?: string;
     appName?: string;
     bundleId?: string;
     macOsOnly?: boolean;
@@ -19,4 +20,5 @@ export interface SafariBuildConfig {
     language: 'swift' | 'objc';
     open: boolean;
     safariBinary?: string;
+    developmentTeam?: string;
 }

package/package.json

@@ -38,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "4.1.0",
+  "version": "4.1.2",
   "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.1.0",
-    "extension-develop": "4.1.0",
-    "extension-install": "4.1.0",
+    "extension-create": "4.1.2",
+    "extension-develop": "4.1.2",
+    "extension-install": "4.1.2",
     "commander": "^15.0.0",
     "pintor": "0.3.0",
     "semver": "^7.7.3",