extension 4.1.21 → 4.1.23

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

@@ -120,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-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/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/helpers/messages.d.ts

@@ -195,6 +195,7 @@ export declare const COMMANDS: readonly CommandSpec[];
 export declare function commandSpec(name: CommandName): CommandSpec;
 export declare const commandDescriptions: Record<CommandName, string>;
 export declare function availableCommandsBlock(): string;
+export declare function projectCliVersionMismatch(running: string, declared: string, range: string, installCommand: string): string;
 export declare function unhandledError(err: unknown): string;
 export declare function updateFailed(err: unknown): string;
 export declare function checkUpdates(packageJson: Record<string, unknown>, update: {

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/project-cli-version.d.ts

@@ -0,0 +1,26 @@
+export declare const CLI_PACKAGES: readonly ['extension', 'extension-develop'];
+export declare function installCommandFor(files: string[]): string;
+export interface ProjectManifest {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+}
+export interface DeclaredCli {
+    name: string;
+    range: string;
+}
+export interface VersionMismatch {
+    declared: string;
+    range: string;
+    running: string;
+}
+export declare function declaredCliDependency(manifest: ProjectManifest | null): DeclaredCli | null;
+export declare function isComparableRange(range: string): boolean;
+export declare function versionMismatch(input: {
+    manifest: ProjectManifest | null;
+    running: string;
+}): VersionMismatch | null;
+export declare function readProjectManifest(projectPath: string): ProjectManifest | null;
+export interface ProjectCliVersionCheck extends VersionMismatch {
+    command: string;
+}
+export declare function checkProjectCliVersion(projectPath: string, running: string): ProjectCliVersionCheck | 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/06d33e35894516a460409dca06d1614e291e6252/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 = "06d33e35894516a460409dca06d1614e291e6252";
+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.21",
+  "version": "4.1.23",
   "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",
@@ -105,9 +105,9 @@
     "vivaldi-location2": "2.1.1",
     "waterfox-location": "2.1.1",
     "yandex-location": "2.1.1",
-    "extension-create": "4.1.21",
-    "extension-develop": "4.1.21",
-    "extension-install": "4.1.21",
+    "extension-create": "4.1.23",
+    "extension-develop": "4.1.23",
+    "extension-install": "4.1.23",
     "commander": "^15.0.0",
     "pintor": "0.3.0",
     "semver": "^7.7.3",