extension 4.1.31 → 4.1.33

package/dist/extension/__spec__/exec/gecko-system-profile.d.ts

@@ -0,0 +1,3 @@
+type Command = 'dev' | 'start' | 'preview';
+export declare function geckoSystemProfileSpecs(command: Command): void;
+export {};

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

@@ -1,4 +1,4 @@
-import type { SafariPipelineTools } from '../run-safari/safari-launch/index.js';
+import { type SafariPipelineTools, type SafariWebDriverProcess } from '../run-safari/safari-launch/index.js';
 export interface FakeSafariToolsOptions {
     platformOk?: boolean;
     toolchainOk?: boolean;
@@ -12,6 +12,14 @@ export interface FakeSafariToolsOptions {
     };
     pid?: number | null;
     registered?: boolean;
+    webdriver?: {
+        command: string;
+        args: string[];
+    } | {
+        spawnError: string;
+    };
+    automationMatch?: string;
+    appMatch?: string;
 }
 export interface FakeSafariTools extends SafariPipelineTools {
     calls: {
@@ -21,7 +29,9 @@ export interface FakeSafariTools extends SafariPipelineTools {
         openSafari: string[];
         resolvePid: string[];
         pluginkit: number;
+        webdriver: number[];
     };
+    webdriverProcesses: SafariWebDriverProcess[];
     events: string[];
 }
 export declare function fakeSafariTools(options?: FakeSafariToolsOptions): FakeSafariTools;

package/dist/extension/browsers/browsers-lib/instance-registry.d.ts

@@ -4,6 +4,7 @@ export type InstanceRecord = {
 };
 export type DebugProtocol = 'cdp' | 'rdp';
 export declare class AmbiguousInstanceError extends Error {
+    readonly code: "E_INSTANCE_AMBIGUOUS";
     readonly protocol: DebugProtocol;
     readonly instanceId: string | undefined;
     constructor(protocol: DebugProtocol, instanceId?: string);

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

@@ -60,6 +60,16 @@ export declare function messageWithoutSenderError(browser: Browser, message: {
 }): string;
 export declare function chromeProcessExited(code: number): string;
 export declare function browserExitedUnasked(browser: Browser, code: number | null, signal: string | null, command: 'dev' | 'preview' | 'start'): string;
+export type SystemProfileSource = {
+    kind: 'flag';
+} | {
+    kind: 'config';
+} | {
+    kind: 'env';
+    name: string;
+};
+export declare function geckoSystemProfileRefused(browser: Browser, sources: SystemProfileSource[]): string;
+export declare function browserStderrTail(browser: Browser, lines: string[]): string;
 export declare function browserGoneBeforeReady(browser: Browser): string;
 export declare function chromeProcessError(error: unknown): string;
 export declare function chromeFailedToSpawn(error: unknown): string;
@@ -99,6 +109,8 @@ export declare function safariNextSteps(appName: string, signed?: boolean): stri
 export declare function safariRegistered(appName: string): string;
 export declare function safariPidUnresolved(appName: string): string;
 export declare function safariNotYetRegistered(appName: string): string;
+export declare function safariWebDriverSession(port: number, sessionId: string): string;
+export declare function safariWebDriverUnavailable(reason: string): string;
 export declare function safariRebuilt(appName: string): string;
 export declare function safariProjectStale(): string;
 export declare function safariForcedRegeneration(): string;

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

@@ -2,6 +2,11 @@ export declare function claimReadyPath(extensionOutputPath: string | undefined,
 export declare function readyPathFor(extensionOutputPath: string): string;
 export declare function readReadyRunId(extensionOutputPath: string | undefined): string | undefined;
 export declare function stampReadyRdpPort(extensionOutputPath: string | undefined, rdpPort: number): void;
+export declare function stampReadyWebDriver(extensionOutputPath: string | undefined, details: {
+    port?: number;
+    sessionId?: string;
+    unavailableReason?: string;
+}, runId?: string): void;
 export declare function stampReadyBrowserLaunch(extensionOutputPath: string | undefined, details: {
     profilePath?: string;
     browserPid?: number;
@@ -13,6 +18,7 @@ export declare function stampReadyBrowserLaunch(extensionOutputPath: string | un
 export declare function describeLaunchFailure(error: unknown): string;
 export declare function stampReadyBrowserLaunchFailed(extensionOutputPath: string | undefined, reason: string, runId?: string, errorCode?: string): void;
 export declare function launchFailureCode(error: unknown): string | undefined;
+export declare function stampReadyCdpFault(extensionOutputPath: string | undefined, code: string, detail: string, runId?: string): void;
 export declare function stampReadyExtensionId(extensionOutputPath: string | undefined, extensionId: string | undefined): void;
 export declare function stampReadyExtensionLoadRefused(extensionOutputPath: string | undefined, reason: string, runId?: string): void;
 export declare function stampReadyProfileLocked(extensionOutputPath: string | undefined, details: {

package/dist/extension/browsers/browsers-lib/resolve-profile.d.ts

@@ -15,6 +15,7 @@ export interface ResolvedProfile {
     persisted: boolean;
     seededFrom?: string;
 }
+export declare function systemProfileEnvName(env?: NodeJS.ProcessEnv): string | undefined;
 export declare function normalizeProfileOption(value: string | boolean | undefined): string | false | undefined;
 export declare function isSessionArtifactsRoot(candidate: string): boolean;
 export declare function ensureProfileRootIgnoreFile(managedBaseDir: string): void;

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

@@ -39,6 +39,7 @@ export interface PluginOptions {
     browserFlags?: string[];
     excludeBrowserFlags?: Array<DefaultBrowserFlags | string>;
     profile?: string | false;
+    profileSource?: 'flag' | 'config';
     persistProfile?: boolean;
     preferences?: Record<string, unknown>;
     keepProfileChanges?: boolean;

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

@@ -9,6 +9,7 @@ export interface BrowserLaunchOptions {
     enableDevtools?: boolean;
     noOpen?: boolean;
     profile?: string | false;
+    profileSource?: 'flag' | 'config';
     persistProfile?: boolean;
     keepProfileChanges?: boolean;
     copyFromProfile?: string;

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

@@ -26,6 +26,7 @@ export declare class CDPClient {
     connect(): Promise<void>;
     connectViaPipe(input: Readable, output: Writable): Promise<void>;
     private markTransportGone;
+    reportPipeGone(error: Error): void;
     isTransportGone(): boolean;
     private rejectAllPending;
     disconnect(): void;

package/dist/extension/browsers/run-chromium/cdp/coded-error.d.ts

@@ -0,0 +1,6 @@
+import { type ErrorCode } from '../../../helpers/messaging.js';
+export interface CodedError extends Error {
+    code: ErrorCode;
+}
+export declare function codedError(code: ErrorCode, message: string): CodedError;
+export declare function declaredCode(error: unknown): ErrorCode | undefined;

package/dist/extension/browsers/run-chromium/cdp/pipe-guard.d.ts

@@ -0,0 +1,8 @@
+import type { Readable, Writable } from 'node:stream';
+type PipeStream = Readable | Writable;
+interface PipeOwner {
+    reportPipeGone(error: Error): void;
+}
+export declare function guardCdpPipe(stream: PipeStream | null | undefined): void;
+export declare function claimCdpPipe(stream: PipeStream, owner: PipeOwner): void;
+export {};

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

@@ -25,6 +25,7 @@ export declare class ChromiumLaunchPlugin {
     get spawnedBrowser(): boolean;
     runOnce(compilation: CompilationLike, opts?: ChromiumRunOptions): Promise<void>;
     private stampLaunchFailed;
+    private stampCdpFault;
     apply(compiler: unknown): void;
     private launchChromium;
     private waitForBrowserGone;

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

@@ -1,6 +1,6 @@
 import type { BrowserLogSink, ExtensionLoadRetryResult, PluginInterface } from '../browsers-types.js';
 import type { FirefoxRDPController } from './rdp/rdp-extension-controller/index.js';
-export type FirefoxPluginLike = Pick<PluginInterface, 'extension' | 'browserFlags' | 'profile' | 'persistProfile' | 'keepProfileChanges' | 'copyFromProfile' | 'preferences' | 'startingUrl' | 'noOpen' | 'geckoBinary' | 'instanceId' | 'port' | 'logLevel' | 'logContexts' | 'logFormat' | 'logTimestamps' | 'logColor' | 'logUrl' | 'logTab' | 'dryRun'> & {
+export type FirefoxPluginLike = Pick<PluginInterface, 'extension' | 'browserFlags' | 'profile' | 'profileSource' | 'persistProfile' | 'keepProfileChanges' | 'copyFromProfile' | 'preferences' | 'startingUrl' | 'noOpen' | 'geckoBinary' | 'instanceId' | 'port' | 'logLevel' | 'logContexts' | 'logFormat' | 'logTimestamps' | 'logColor' | 'logUrl' | 'logTab' | 'dryRun'> & {
     browser: PluginInterface['browser'];
 };
 export interface FirefoxPluginRuntime extends FirefoxPluginLike {

package/dist/extension/browsers/run-firefox/rdp/evaluate-extension-document.d.ts

@@ -6,9 +6,14 @@ export interface RdpDocumentFrame {
     consoleActor?: unknown;
     isFallbackExtensionDocument?: unknown;
 }
+export interface RdpTabDescriptor {
+    actor?: unknown;
+    url?: unknown;
+}
 export type RdpEvalOutcome = {
     ok: true;
     value: unknown;
+    truncated?: true;
 } | {
     ok: false;
     error: {
@@ -19,7 +24,7 @@ export type RdpEvalOutcome = {
 };
 interface EvaluatingClient {
     request: (payload: Record<string, unknown>) => Promise<unknown>;
-    evaluate: (consoleActor: string, expression: string) => Promise<unknown>;
+    evaluate: (consoleActor: string, expression: string, extra?: Record<string, unknown>) => Promise<unknown>;
     on: (event: string, listener: (message: unknown) => void) => unknown;
     off?: (event: string, listener: (message: unknown) => void) => unknown;
     removeListener?: (event: string, listener: (message: unknown) => void) => unknown;
@@ -28,7 +33,19 @@ export declare function extensionDocumentPagePath(manifest: Record<string, unkno
 export declare function pickDocumentFrame(frames: readonly RdpDocumentFrame[], context: string, pagePath?: string): string | undefined;
 export declare function startExpression(expression: string): string;
 export declare const POLL_EXPRESSION = "(function () {\n  var slot = globalThis.__extjsRdpEval || null;\n  if (slot && slot.state !== \"pending\") { try { delete globalThis.__extjsRdpEval; } catch (error) {} }\n  return JSON.stringify(slot);\n})()";
+export declare function statementBlock(source: string): string;
 export declare function readSettledSlot(raw: unknown): RdpEvalOutcome | undefined;
+export declare function readWholeString(client: Pick<EvaluatingClient, 'request'>, value: unknown, limit?: number): Promise<unknown>;
+export declare function readCompletionValue(grip: unknown): RdpEvalOutcome | {
+    objectActor: string;
+};
+export declare function evaluateInConsole(options: {
+    client: EvaluatingClient;
+    consoleActor: string;
+    expression: string;
+    timeoutMs: number;
+    where: string;
+}): Promise<RdpEvalOutcome>;
 export declare function evaluateThroughWatcher(options: {
     client: EvaluatingClient;
     extensionId: string;
@@ -45,4 +62,17 @@ export declare function evaluateExtensionDocument(options: {
     expression: string;
     timeoutMs: number;
 }): Promise<RdpEvalOutcome>;
+export declare function pickTabDescriptor(tabs: readonly RdpTabDescriptor[], url: string): string | undefined;
+export declare function evaluateThroughTab(options: {
+    client: EvaluatingClient;
+    url: string;
+    expression: string;
+    timeoutMs: number;
+}): Promise<RdpEvalOutcome | undefined>;
+export declare function evaluateTabDocument(options: {
+    rdpPort: number;
+    url: string;
+    expression: string;
+    timeoutMs: number;
+}): Promise<RdpEvalOutcome | undefined>;
 export {};

package/dist/extension/browsers/run-firefox/rdp/remote-firefox/evaluate.d.ts

@@ -5,5 +5,8 @@ interface RdpClientLike {
     off?: (event: string, listener: (message: unknown) => void) => unknown;
     removeListener?: (event: string, listener: (message: unknown) => void) => unknown;
 }
-export declare function evaluate(client: RdpClientLike, tabId: string, expression: string): Promise<{} | null>;
+export declare class PageThrewError extends Error {
+    constructor(message: string);
+}
+export declare function evaluate(client: RdpClientLike, tabId: string, expression: string, extra?: Record<string, unknown>): Promise<{} | null>;
 export {};

package/dist/extension/browsers/run-firefox/rdp/remote-firefox/messaging-client.d.ts

@@ -15,5 +15,5 @@ export declare class MessagingClient extends EventEmitter {
         targetActor?: string;
         consoleActor?: string;
     }>;
-    evaluate(tabId: string, expression: string): Promise<{} | null>;
+    evaluate(tabId: string, expression: string, extra?: Record<string, unknown>): Promise<{} | null>;
 }

package/dist/extension/browsers/run-only.d.ts

@@ -6,6 +6,7 @@ type PreviewRunOptions = {
     extensionsToLoad: string[];
     noOpen?: boolean;
     profile?: string | false;
+    profileSource?: 'flag' | 'config';
     persistProfile?: boolean;
     preferences?: Record<string, unknown>;
     browserFlags?: string[];

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

@@ -0,0 +1,3 @@
+import type { SafariPipelineTools } from './tools.js';
+export declare function rememberRaisedContainerApp(tools: SafariPipelineTools, appPath: string, before: Set<number>): Promise<number[]>;
+export declare function closeSafariContainerApps(): Promise<void>;

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

@@ -1,6 +1,8 @@
 import type { BrowserLogger } from '../../browsers-types.js';
 import type { SafariPluginLike } from '../safari-types.js';
-export { type SafariPipelineTools, type SafariToolResult, toolOutputTail } from './tools.js';
+export { closeSafariContainerApps } from './container-app.js';
+export { isAutomationSafariArgs, isContainerAppArgs, listPidsWhere, openAppArgs, type SafariPipelineTools, type SafariToolResult, type SafariWebDriverProcess, spawnWebDriverProcess, toolOutputTail } from './tools.js';
+export { closeSafariWebDriverSessions } from './webdriver.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

@@ -5,6 +5,12 @@ export interface SafariToolResult {
     code: number | null;
     output: string;
 }
+export interface SafariWebDriverProcess {
+    ok: boolean;
+    pid?: number;
+    output: string;
+    stop(): void;
+}
 export interface SafariPipelineTools {
     detectToolchain(): SafariToolchain;
     runConverter(args: string[]): Promise<SafariToolResult>;
@@ -13,5 +19,13 @@ export interface SafariPipelineTools {
     openSafari(binary: string): Promise<SafariToolResult>;
     resolvePid(bundleId: string): Promise<number | null>;
     pluginkitList(): Promise<string>;
+    startWebDriver(port: number): Promise<SafariWebDriverProcess>;
+    listAutomationPids(): Promise<number[]>;
+    listAppPids(appPath: string): Promise<number[]>;
 }
+export declare function isAutomationSafariArgs(args: string): boolean;
+export declare function isContainerAppArgs(appPath: string, args: string): boolean;
+export declare function openAppArgs(target: string): string[];
+export declare function listPidsWhere(matches: (args: string) => boolean): Promise<number[]>;
+export declare function spawnWebDriverProcess(bin: string, args: string[]): Promise<SafariWebDriverProcess>;
 export declare function createSafariTools(): SafariPipelineTools;

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

@@ -0,0 +1,15 @@
+import type { SafariPipelineTools } from './tools.js';
+export interface SafariWebDriverSession {
+    port: number;
+    sessionId: string;
+    close(): Promise<void>;
+}
+export type SafariWebDriverOutcome = {
+    session: SafariWebDriverSession;
+    reason?: undefined;
+} | {
+    session?: undefined;
+    reason: string;
+};
+export declare function closeSafariWebDriverSessions(): Promise<void>;
+export declare function openSafariWebDriverSession(tools: SafariPipelineTools): Promise<SafariWebDriverOutcome>;

package/dist/extension/commands/act.d.ts

@@ -14,8 +14,18 @@ interface ActResultLike {
         code?: unknown;
     };
 }
+export declare function cspBlocksEvalHint(context: string, browser: string): string;
 export declare function buildActEnvelope(command: string, result: ActResultLike): Record<string, unknown>;
 export declare function bridgeBlamedTheExtensionCsp(result: ActResultLike): boolean;
 export declare function bridgeHadNoExecutor(result: ActResultLike): boolean;
+interface BridgeTab {
+    id?: unknown;
+    url?: unknown;
+    active?: unknown;
+}
+export declare function pickTargetTabUrl(tabs: readonly BridgeTab[], target: {
+    tabId?: number;
+    url?: string;
+}): string | undefined;
 export declare function registerActCommands(program: Command): void;
 export {};

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

@@ -1,5 +1,5 @@
 /** A browser target accepted by Extension.js commands. */
-export type BrowserType = 'chrome' | 'edge' | 'firefox' | 'chromium' | 'brave' | 'opera' | 'vivaldi' | 'yandex' | 'waterfox' | 'librewolf' | 'zen' | 'floorp' | 'chromium-based' | 'gecko-based' | 'firefox-based' | 'safari' | 'webkit-based';
+export type BrowserType = 'chrome' | 'edge' | 'firefox' | 'chromium' | 'brave' | 'opera' | 'vivaldi' | 'yandex' | 'waterfox' | 'librewolf' | 'zen' | 'floorp' | 'chromium-based' | 'gecko-based' | 'firefox-based' | 'safari' | 'webkit-based' | 'chromium-emulator';
 /**
  * Companion extensions are "load-only" unpacked extension directories loaded
  * alongside the user extension in `dev`/`preview`/`start` (and `build` for
@@ -202,8 +202,10 @@ export interface FileConfig {
      * Escape hatch to customize the underlying Rspack/webpack-compatible
      * configuration. Receives and returns a bundler `Configuration` object.
      * Typed loosely to avoid requiring bundler types in consumer projects.
+     * The second argument names the target browser, the bundler mode and
+     * the command.
      */
-    config?: (config: any) => any;
+    config?: (config: any, context: ConfigHookContext) => any;
     /**
      * Runs once the bundler config is final, right before the first build, with
      * every loader rule attached. It can change `module`, `resolve`,
@@ -212,7 +214,17 @@ export interface FileConfig {
      * `environment`. Every other key is fixed by then (`entry`, `plugins`,
      * `mode`, `devtool`, `target`, `externals`, `output.path`, the rest of
      * `optimization`): a change is ignored with a warning, use `config`.
+     * The second argument is the same context `config` receives.
      */
-    configResolved?: (config: any) => any;
+    configResolved?: (config: any, context: ConfigHookContext) => any;
+}
+/** What the `config` and `configResolved` hooks are told about the run. */
+export interface ConfigHookContext {
+    /** The browser the command targets, as `--browser` names it. */
+    browser: BrowserType;
+    /** The bundler mode of the run. */
+    mode: 'development' | 'production' | 'none';
+    /** The command that started the run. */
+    command: 'dev' | 'build' | 'start' | 'preview';
 }
 export {};

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

@@ -7,6 +7,7 @@ export declare function isMachineOutput(): boolean;
 export declare function humanLine(...parts: unknown[]): void;
 export declare function humanWarn(...parts: unknown[]): void;
 export declare function humanError(...parts: unknown[]): void;
+export declare function debugLine(...parts: unknown[]): void;
 export declare const fmt: {
     heading: (title: string) => string;
     label: (key: string) => string;
@@ -91,7 +92,6 @@ export declare const CODES: {
     readonly E_CONFIG_LOAD: 'E_CONFIG_LOAD';
     readonly E_MANAGED_DEP_CONFLICT: 'E_MANAGED_DEP_CONFLICT';
     readonly E_TYPES_EMIT: 'E_TYPES_EMIT';
-    readonly E_TSCONFIG_MISSING: 'E_TSCONFIG_MISSING';
     readonly E_OPTIONAL_DEP_UNRESOLVED: 'E_OPTIONAL_DEP_UNRESOLVED';
     readonly E_OPTIONAL_DEP_LOAD: 'E_OPTIONAL_DEP_LOAD';
     readonly E_OPTIONAL_DEP_UNKNOWN: 'E_OPTIONAL_DEP_UNKNOWN';
@@ -107,11 +107,9 @@ export declare const CODES: {
     readonly E_CSS_PARSE: 'E_CSS_PARSE';
     readonly E_CSS_PREPROCESSOR_MISSING: 'E_CSS_PREPROCESSOR_MISSING';
     readonly E_CSS_DEAD_REF: 'E_CSS_DEAD_REF';
-    readonly E_INTEGRATION_INSTALL: 'E_INTEGRATION_INSTALL';
     readonly E_POLYFILL_NOT_FOUND: 'E_POLYFILL_NOT_FOUND';
     readonly E_LOCALES_LAYOUT: 'E_LOCALES_LAYOUT';
     readonly E_WAR_INVALID: 'E_WAR_INVALID';
-    readonly E_MATCH_PATTERN_INVALID: 'E_MATCH_PATTERN_INVALID';
     readonly E_BACKGROUND_REQUIRED: 'E_BACKGROUND_REQUIRED';
     readonly E_CONTENT_SCRIPT_SYNTAX: 'E_CONTENT_SCRIPT_SYNTAX';
     readonly E_NO_ENTRYPOINTS: 'E_NO_ENTRYPOINTS';
@@ -130,7 +128,6 @@ export declare const CODES: {
     readonly E_BROWSER_START_TIMEOUT: 'E_BROWSER_START_TIMEOUT';
     readonly E_LAUNCH_SKIPPED_COMPILE_ERRORS: 'E_LAUNCH_SKIPPED_COMPILE_ERRORS';
     readonly E_INSTANCE_AMBIGUOUS: 'E_INSTANCE_AMBIGUOUS';
-    readonly E_WSL_INTEROP: 'E_WSL_INTEROP';
     readonly E_EXTENSION_LOAD_REFUSED: 'E_EXTENSION_LOAD_REFUSED';
     readonly E_ADDON_INSTALL: 'E_ADDON_INSTALL';
     readonly E_BROWSER_CONNECT: 'E_BROWSER_CONNECT';
@@ -142,6 +139,7 @@ export declare const CODES: {
     readonly E_RDP_PROTOCOL: 'E_RDP_PROTOCOL';
     readonly E_PORT_IN_USE: 'E_PORT_IN_USE';
     readonly E_SESSION_STOPPED: 'E_SESSION_STOPPED';
+    readonly E_SESSION_EXISTS: 'E_SESSION_EXISTS';
     readonly E_LOGS_STREAM_GAP: 'E_LOGS_STREAM_GAP';
     readonly E_BROWSER_INSTALL_PRIVILEGE: 'E_BROWSER_INSTALL_PRIVILEGE';
     readonly E_UNINSTALL_NOOP: 'E_UNINSTALL_NOOP';
@@ -153,6 +151,15 @@ export interface EnvelopeErrorRefs {
     path?: string;
     version?: string;
 }
+export interface Diagnostic {
+    code?: ErrorCode;
+    message: string;
+    file?: string;
+    line?: number;
+    column?: number;
+    severity: 'error' | 'warning';
+    name?: string;
+}
 export interface EnvelopeError {
     code: ErrorCode;
     message: string;
@@ -160,6 +167,7 @@ export interface EnvelopeError {
     engine?: string;
     hint?: string;
     refs?: EnvelopeErrorRefs;
+    details?: Diagnostic[];
 }
 export interface Envelope<T = unknown> {
     schema: typeof ENVELOPE_SCHEMA;

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

@@ -6,4 +6,5 @@ export declare function detectDenoVersion(versions?: NodeJS.ProcessVersions): st
 export declare function unsupportedDenoVersionMessage(version: 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;
+export declare function unsupportedNodeVersionFrame(version: string, argv: string[]): Record<string, unknown> | undefined;
+export declare function enforceSupportedNodeVersion(version?: string, bunVersion?: string | undefined, denoVersion?: string | undefined, argv?: string[]): void;

package/dist/extension/helpers/ready-contract-codes.d.ts

@@ -1,3 +1,7 @@
 import { type ErrorCode } from './messaging.js';
 export declare const READY_CONTRACT_CODES: Record<string, ErrorCode>;
 export declare function readyContractErrorCode(code: unknown): ErrorCode | undefined;
+export declare function stampedLaunchFailureCode(ready: {
+    code?: unknown;
+    browserLaunchFailedCode?: unknown;
+}): ErrorCode | undefined;

package/dist/extension/helpers/telemetry-cli.d.ts

@@ -3,6 +3,7 @@ type KnownCommand = 'build' | 'capabilities' | 'create' | 'dev' | 'doctor' | 'ev
 export declare const KNOWN_COMMANDS: ReadonlySet<KnownCommand>;
 export declare function detectInvokedCommand(argv: string[]): KnownCommand;
 export declare function advertisedTemplateName(value: string | undefined): string | undefined;
+export declare function createSourceTag(value: string | undefined): string;
 export declare function telemetryCommandContext(command: string, argv?: string[]): {
     template?: string;
     source?: string;

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

package/dist/extension/index.d.ts

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
 import './helpers/node-version-guard.js';
-export type { BrowserConfig, BrowserType, CompanionExtensionsConfig, FileConfig } from './config-types.js';
+export type { BrowserConfig, BrowserType, CompanionExtensionsConfig, ConfigHookContext, FileConfig } from './config-types.js';

package/package.json

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