extension 4.1.20 → 4.1.22

package/dist/extension/browsers/__spec__/safari-fake-tools.d.ts

@@ -0,0 +1,27 @@
+import type { SafariPipelineTools } from '../run-safari/safari-launch/index.js';
+export interface FakeSafariToolsOptions {
+    platformOk?: boolean;
+    toolchainOk?: boolean;
+    converter?: {
+        code?: number;
+        output?: string;
+    };
+    xcodebuild?: {
+        code?: number;
+        output?: string;
+    };
+    pid?: number | null;
+    registered?: boolean;
+}
+export interface FakeSafariTools extends SafariPipelineTools {
+    calls: {
+        converter: string[][];
+        xcodebuild: string[][];
+        openApp: string[];
+        openSafari: string[];
+        resolvePid: string[];
+        pluginkit: number;
+    };
+    events: string[];
+}
+export declare function fakeSafariTools(options?: FakeSafariToolsOptions): FakeSafariTools;

package/dist/extension/browsers/browsers-lib/messages.d.ts

@@ -78,6 +78,7 @@ export declare function safariDryRunConverter(cmd: string): string;
 export declare function safariDryRunXcodebuild(cmd: string): string;
 export declare function safariNextSteps(appName: string, signed?: boolean): string;
 export declare function safariRegistered(appName: string): string;
+export declare function safariPidUnresolved(appName: string): string;
 export declare function safariNotYetRegistered(appName: string): string;
 export declare function safariRebuilt(appName: string): string;
 export declare function safariProjectStale(): string;
@@ -119,7 +120,7 @@ export interface DevClientMessage {
     };
 }
 export declare function collapseHomeDirInCardValue(value: string): string;
-export declare function binaryProvenanceNote(provenance?: 'managed' | 'pinned' | 'system' | 'snapshot'): string;
+export declare function binaryProvenanceNote(provenance?: 'managed' | 'pinned' | 'system' | 'snapshot', browser?: BrowserType | string): string;
 export declare function runningInDevelopment(manifest: DevManifestInfo, browser: BrowserType, message: DevClientMessage, browserVersionLine?: string, updateSuffix?: string, opts?: {
     includeExtensionId?: boolean;
     runLabel?: string;

package/dist/extension/browsers/browsers-lib/process-teardown.d.ts

@@ -2,6 +2,9 @@ import { type ChildProcess } from 'node:child_process';
 import type { BrowserType } from '../browsers-types.js';
 export declare const FORCE_KILL_GRACE_MS = 5000;
 export declare function wasTerminatedByUs(child: ChildProcess | null): boolean;
+export declare function wasPidTerminatedByUs(pid: number | null | undefined): boolean;
+export declare function gracefulTerminatePid(pid: number | null | undefined, browser: BrowserType): void;
+export declare function forceKillPidOnExit(pid: number | null | undefined, browser: BrowserType): void;
 export declare function gracefulTerminateChild(child: ChildProcess | null, browser: BrowserType): void;
 export declare function forceKillChildOnExit(child: ChildProcess | null, browser: BrowserType): void;
 export declare function isBenignSocketTeardown(value: unknown): boolean;

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

@@ -2,6 +2,7 @@ export declare function stampReadyRdpPort(extensionOutputPath: string | undefine
 export declare function stampReadyBrowserLaunch(extensionOutputPath: string | undefined, details: {
     profilePath?: string;
     browserPid?: number;
+    launcherPid?: number;
     extensionId?: string;
     binary?: string;
     binaryProvenance?: 'managed' | 'pinned' | 'system' | 'snapshot';

package/dist/extension/browsers/browsers-lib/resolve-live-pid.d.ts

@@ -0,0 +1,25 @@
+export interface ProcessRow {
+    pid: number;
+    ppid: number;
+    command: string;
+}
+export type ProcessLister = () => ProcessRow[];
+export declare function parseProcessRows(output: string): ProcessRow[];
+export declare function listProcesses(platform?: NodeJS.Platform): ProcessRow[];
+export declare function executableOf(command: string): string;
+export declare function findLiveBrowserPid(input: {
+    profilePath: string;
+    binary: string;
+    launcherPid?: number;
+    rows: ProcessRow[];
+}): number | null;
+export declare function isPidAlive(pid: number | null | undefined): boolean;
+export declare function resolveLiveBrowserPid(input: {
+    profilePath: string;
+    binary: string;
+    launcherPid?: number;
+    list?: ProcessLister;
+    attempts?: number;
+    intervalMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+}): Promise<number | null>;

package/dist/extension/browsers/browsers-lib/write-json-atomic.d.ts

@@ -0,0 +1 @@
+export declare function writeJsonAtomic(filePath: string, value: unknown): boolean;

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

@@ -29,7 +29,7 @@ export interface BrowserConfig {
     browserFlags: string[];
     startingUrl: string | undefined;
 }
-export type DefaultBrowserFlags = '--no-first-run' | '--disable-client-side-phishing-detection' | '--disable-component-extensions-with-background-pages' | '--disable-default-apps' | '--disable-features=InterestFeedContentSuggestions' | '--disable-features=Translate' | '--hide-scrollbars' | '--mute-audio' | '--no-default-browser-check' | '--ash-no-nudges' | '--disable-search-engine-choice-screen' | '--disable-features=MediaRoute' | '--use-mock-keychain' | '--disable-background-networking' | '--disable-breakpad' | '--disable-component-update' | '--disable-domain-reliability' | '--disable-features=AutofillServerCommunicatio' | '--disable-features=CertificateTransparencyComponentUpdate' | '--disable-sync' | '--disable-features=OptimizationHints' | '--disable-features=DialMediaRouteProvider' | '--no-pings' | '--enable-features=SidePanelUpdates' | '--disable-features=DisableLoadExtensionCommandLineSwitch' | '--disable-features=ExtensionDisableUnsupportedDeveloper' | '--enable-unsafe-extension-debugging' | '--silent-debugger-extension-api';
+export type DefaultBrowserFlags = '--no-first-run' | '--disable-client-side-phishing-detection' | '--disable-component-extensions-with-background-pages' | '--disable-default-apps' | '--disable-features=InterestFeedContentSuggestions' | '--disable-features=Translate' | '--hide-scrollbars' | '--mute-audio' | '--no-default-browser-check' | '--ash-no-nudges' | '--disable-search-engine-choice-screen' | '--disable-features=MediaRoute' | '--use-mock-keychain' | '--disable-background-networking' | '--disable-breakpad' | '--disable-component-update' | '--disable-domain-reliability' | '--disable-features=AutofillServerCommunicatio' | '--disable-features=CertificateTransparencyComponentUpdate' | '--disable-sync' | '--disable-features=OptimizationHints' | '--disable-features=DialMediaRouteProvider' | '--no-pings' | '--enable-features=SidePanelUpdates' | '--disable-features=DisableLoadExtensionCommandLineSwitch' | '--disable-features=ExtensionDisableUnsupportedDeveloper' | '--disable-features=SafetyHubExtensionsOffStoreTrigger' | '--enable-unsafe-extension-debugging' | '--silent-debugger-extension-api';
 export interface PluginOptions {
     /**
      * @default false

package/dist/extension/browsers/index.d.ts

@@ -46,7 +46,7 @@ export interface BrowserController {
 }
 export declare function launchBrowser(opts: BrowserLaunchOptions): Promise<BrowserController>;
 export { runOnlyPreviewBrowser } from './run-only.js';
-export { packageSafariExtension, type SafariBuildPreflight, type SafariPackageResult, type SafariPipelineMode, safariBuildPreflight, safariPreflightError } from './run-safari/safari-launch/index.js';
+export { packageSafariExtension, type SafariBuildPreflight, type SafariPackageResult, type SafariPipelineMode, type SafariPipelineTools, type SafariToolResult, safariBuildPreflight, safariPreflightError } from './run-safari/safari-launch/index.js';
 export { builtAppPath, isValidBundleId, macOsSchemeName, resolveSafariBuildConfig, xcodeProjectPath } from './run-safari/safari-launch/safari-config.js';
 export { createSafariPackager, type SafariPackagerFn, type SafariPackagerOptions, type SafariPackagerOverrides } from './run-safari/safari-packager.js';
 export type { SafariBuildConfig, SafariPluginLike } from './run-safari/safari-types.js';

package/dist/extension/browsers/run-chromium/cdp/cdp-extension-controller/index.d.ts

@@ -1,6 +1,7 @@
 import type { Readable, Writable } from 'node:stream';
 import type { BrowserLogSink } from '../../../browsers-types.js';
 import type { CdpProtocolMessage } from '../../chromium-types.js';
+import { type DeveloperModeOutcome } from '../ensure-developer-mode.js';
 import { type LoadUnpackedOutcome } from './ensure.js';
 interface ExtensionInfoResult {
     extensionId: string;
@@ -29,6 +30,7 @@ export declare class CDPExtensionController {
         logSink?: BrowserLogSink;
     });
     connect(): Promise<void>;
+    ensureDeveloperMode(): Promise<DeveloperModeOutcome>;
     openTab(url: string): Promise<void>;
     closeSelfOpenedTabs(): Promise<number>;
     verifyGuestLoaded(): Promise<LoadUnpackedOutcome>;

package/dist/extension/browsers/run-chromium/cdp/ensure-developer-mode.d.ts

@@ -0,0 +1,12 @@
+export type DeveloperModeOutcome = 'already-on' | 'enabled' | 'skipped' | 'unavailable';
+export interface DeveloperModeTransport {
+    sendCommand(method: string, params?: Record<string, unknown>, sessionId?: string): Promise<unknown>;
+}
+export declare function developerModeFromProfile(profilePath: string): boolean;
+export declare function developerModeFlipIsSafe(browserArgs: string[]): boolean;
+export declare function ensureDeveloperMode(options: {
+    transport: DeveloperModeTransport;
+    attempts?: number;
+    delayMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+}): Promise<DeveloperModeOutcome>;

package/dist/extension/browsers/run-firefox/firefox-launch/index.d.ts

@@ -18,6 +18,10 @@ export declare class FirefoxLaunchPlugin {
     private child;
     private watchTimeout?;
     private extensionOutputPath?;
+    private livePid;
+    private liveExitWatcher?;
+    private browserGone;
+    private disposeProcessHandlers?;
     constructor(host: FirefoxPluginRuntime, ctx: FirefoxContext);
     runOnce(compilation: CompilationLike, options: LaunchOptions): Promise<void>;
     apply(compiler: unknown): void;
@@ -27,6 +31,11 @@ export declare class FirefoxLaunchPlugin {
     private spawnFirefoxChild;
     private pipeChildOutput;
     private wireChildLifecycle;
+    private onBrowserGone;
+    private trackLiveBrowserPid;
+    private adoptHandedOffBrowser;
+    private adoptLivePid;
+    private watchLivePidExit;
     private retryAddonInstall;
     private reportAddonLoadRefused;
     private cleanupInstance;

package/dist/extension/browsers/run-firefox/firefox-launch/process-handlers.d.ts

@@ -2,4 +2,4 @@ import type { ChildProcess } from 'node:child_process';
 export type FirefoxBrowserKind = 'firefox' | 'chrome' | 'edge' | 'chromium-based';
 export declare function __activeFirefoxInstanceCount(): number;
 export declare function __resetFirefoxProcessHandlersForTest(): void;
-export declare function setupFirefoxProcessHandlers(browser: FirefoxBrowserKind, childRef: () => ChildProcess | null, cleanupInstance: () => Promise<void>): () => void;
+export declare function setupFirefoxProcessHandlers(browser: FirefoxBrowserKind, childRef: () => ChildProcess | null, cleanupInstance: () => Promise<void>, livePidRef?: () => number | null): () => void;

package/dist/extension/browsers/run-safari/safari-launch/index.d.ts

@@ -1,6 +1,6 @@
 import type { BrowserLogger } from '../../browsers-types.js';
 import type { SafariPluginLike } from '../safari-types.js';
-export declare function toolOutputTail(output: string): string;
+export { type SafariPipelineTools, type SafariToolResult, toolOutputTail } from './tools.js';
 export declare function converterWarnings(output: string): string[];
 export type SafariPipelineMode = 'full' | 'resync';
 export interface SafariPackageResult {

package/dist/extension/browsers/run-safari/safari-launch/tools.d.ts

@@ -0,0 +1,17 @@
+import { type SafariToolchain } from './toolchain.js';
+export declare function toolOutputTail(output: string): string;
+export interface SafariToolResult {
+    ok: boolean;
+    code: number | null;
+    output: string;
+}
+export interface SafariPipelineTools {
+    detectToolchain(): SafariToolchain;
+    runConverter(args: string[]): Promise<SafariToolResult>;
+    runXcodebuild(args: string[]): Promise<SafariToolResult>;
+    openApp(target: string): Promise<SafariToolResult>;
+    openSafari(binary: string): Promise<SafariToolResult>;
+    resolvePid(bundleId: string): Promise<number | null>;
+    pluginkitList(): Promise<string>;
+}
+export declare function createSafariTools(): SafariPipelineTools;

package/dist/extension/browsers/run-safari/safari-packager.d.ts

@@ -1,5 +1,5 @@
 import type { BrowserLogger } from '../browsers-types.js';
-import { type SafariPackageResult, type SafariPipelineMode } from './safari-launch/index.js';
+import { type SafariPackageResult, type SafariPipelineMode, type SafariPipelineTools } from './safari-launch/index.js';
 export interface SafariPackagerOverrides {
     appName?: string;
     bundleId?: string;
@@ -14,6 +14,7 @@ export interface SafariPackagerOptions extends SafariPackagerOverrides {
     noOpen?: boolean;
     dryRun?: boolean;
     logger?: BrowserLogger;
+    tools?: SafariPipelineTools;
 }
 export type SafariPackagerFn = (distPath: string, mode?: SafariPipelineMode, overrides?: SafariPackagerOverrides) => Promise<SafariPackageResult>;
 export declare function createSafariPackager(options?: SafariPackagerOptions): SafariPackagerFn;

package/dist/extension/browsers/run-safari/safari-types.d.ts

@@ -1,4 +1,5 @@
 import type { PluginInterface } from '../browsers-types.js';
+import type { SafariPipelineTools } from './safari-launch/tools.js';
 export type SafariPluginLike = Pick<PluginInterface, 'extension' | 'noOpen' | 'instanceId' | 'dryRun'> & {
     browser: PluginInterface['browser'];
     safariBinary?: string;
@@ -8,6 +9,7 @@ export type SafariPluginLike = Pick<PluginInterface, 'extension' | 'noOpen' | 'i
     macOsOnly?: boolean;
     forceRegenerate?: boolean;
     announceDevReady?: boolean;
+    tools?: SafariPipelineTools;
 };
 export interface SafariBuildConfig {
     extensionDir: string;

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

@@ -50,8 +50,11 @@ export interface BrowserConfig extends BrowserLaunchConfig {
     geckoBinary?: string;
     firefoxBinary?: string;
 }
-/** Asset categories the perf-budgets plugin recognizes. */
-export type PerfBudgetCategory = 'content-script' | 'service-worker' | 'page' | 'ignored';
+/**
+ * Asset categories the perf-budgets plugin recognizes. `runtime` covers
+ * wasm cores and root-level runtime helpers emitted outside a surface folder.
+ */
+export type PerfBudgetCategory = 'content-script' | 'service-worker' | 'page' | 'runtime' | 'ignored';
 /**
  * Per-category asset size budgets (bytes) for compiling commands.
  * Set at the top level, or per command via `commands.dev|build.perfBudgets`.

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

@@ -280,9 +280,16 @@ export declare function programAIHelpJSON(version: string): ProgramAIHelpJSON;
 export declare function invalidAIHelpFormat(value: string): string;
 export declare function removedNoRunnerFlag(): string;
 export declare function deprecatedOutputAlias(flag: string): string;
+export declare function openedSurface(surface: string): string;
+export declare function replayedActionClick(listeners: number): string;
+export declare function replayedCommand(listeners: number, command?: string): string;
+export declare function openSurfaceWarning(warning: string): string;
+export declare function openSurfaceFailed(surface: string, reason: string, engine?: string, remedy?: string): string;
 export declare function openSurfaceGestureStep(surface: string): string;
 export declare function openSurfaceNeedsGesturePlain(surface: string): string;
 export declare function openSurfaceNeedsGesture(surface: string): string;
+export declare function doctorHeader(browser: string, passes: number, total: number): string;
+export declare function doctorRemedy(check: string, remediation: string): string;
 export declare function controlDisabledInSessionPlain(browser: string, port: number | undefined, flag: string): string;
 export declare function controlDisabledInSession(browser: string, port: number | undefined, flag: string): string;
 export declare function noBrowserNotSupportedForCommand(command?: string): string;

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

@@ -1,6 +1,7 @@
 export type Channel = 'info' | 'success' | 'warn' | 'error' | 'debug';
 export declare function isDebug(): boolean;
 export declare function prefix(type: Channel): string;
+export declare function hasChannelPrefix(text: string): boolean;
 export declare function isMachineOutput(): boolean;
 export declare function humanLine(...parts: unknown[]): void;
 export declare function humanWarn(...parts: unknown[]): void;

package/dist/extension/helpers/node-version-guard.d.ts

@@ -1,7 +1,9 @@
 export declare function isSupportedNodeVersion(version: string): boolean;
 export declare function isSupportedDenoVersion(version: string): boolean;
+export declare function isSupportedBunVersion(version: string): boolean;
 export declare function detectBunVersion(versions?: NodeJS.ProcessVersions): string | undefined;
 export declare function detectDenoVersion(versions?: NodeJS.ProcessVersions): string | undefined;
 export declare function unsupportedDenoVersionMessage(version: string): string;
-export declare function unsupportedNodeVersionMessage(version: string, bunVersion?: string): string;
+export declare function unsupportedBunVersionMessage(version: string): string;
+export declare function unsupportedNodeVersionMessage(version: string): string;
 export declare function enforceSupportedNodeVersion(version?: string, bunVersion?: string | undefined, denoVersion?: string | undefined): void;

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/39448a235ea1b02516e6d555bcae409db2258b7f/examples";
+export declare const TEMPLATE_CATALOG_URL = "https://github.com/extension-js/examples/tree/f8087f012cf195cba9aa2e3c32fd5a6729da33f0/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 = "39448a235ea1b02516e6d555bcae409db2258b7f";
+export declare const TEMPLATE_CORPUS_REF = "f8087f012cf195cba9aa2e3c32fd5a6729da33f0";
 export declare const TEMPLATE_CORPUS_SLUGS: readonly string[];

package/package.json

@@ -38,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "4.1.20",
+  "version": "4.1.22",
   "description": "The cross-browser extension framework. Build Chrome, Edge, Firefox, and Safari extensions with no build configuration.",
   "homepage": "https://extension.js.org/",
   "bugs": {
@@ -54,7 +54,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "scripts": {
-    "pretest": "pnpm run compile",
+    "pretest": "node ../../scripts/ensure-workspace-deps.mjs && pnpm run compile",
     "prepublishOnly": "pnpm run compile",
     "compile": "rslib build",
     "watch": "rslib build --watch",
@@ -98,7 +98,6 @@
     "brave-location": "3.1.1",
     "chrome-location2": "4.1.1",
     "chromium-location": "2.1.2",
-    "cross-spawn": "^7.0.6",
     "edge-location": "2.3.1",
     "firefox-location2": "3.1.1",
     "librewolf-location": "1.2.1",
@@ -106,9 +105,9 @@
     "vivaldi-location2": "2.1.1",
     "waterfox-location": "2.1.1",
     "yandex-location": "2.1.1",
-    "extension-create": "4.1.20",
-    "extension-develop": "4.1.20",
-    "extension-install": "4.1.20",
+    "extension-create": "4.1.22",
+    "extension-develop": "4.1.22",
+    "extension-install": "4.1.22",
     "commander": "^15.0.0",
     "pintor": "0.3.0",
     "semver": "^7.7.3",
@@ -122,7 +121,6 @@
   },
   "devDependencies": {
     "@rslib/core": "^1.0.0",
-    "@types/cross-spawn": "^6.0.6",
     "@types/semver": "^7.7.1",
     "@types/ws": "^8.18.1",
     "webextension-polyfill": "^0.12.0",