extension 4.1.12 → 4.1.13

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

@@ -58,7 +58,7 @@ export declare function firefoxNoBinaryArgsFound(): string;
 export declare function firefoxFailedToStart(error: unknown): string;
 export declare function firefoxDryRunNotLaunching(): string;
 export declare function firefoxDryRunBinary(path: string): string;
-export declare function firefoxDryRunConfig(cfg: string): string;
+export declare function firefoxDryRunArgs(args: string): string;
 export declare function safariBuildCalled(): string;
 export declare function safariRequiresMacOS(platform: string): string;
 export declare function safariPackagingSkippedNonMac(platform: string): string;

package/dist/extension/browsers/browsers-lib/newtab-override.d.ts

@@ -0,0 +1 @@
+export declare function manifestDeclaresNewtabOverride(outPath: string): boolean;

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

@@ -30,6 +30,7 @@ export interface ResolveProfileInput {
     /** `copyFromProfile` option, seed the managed profile as a copy of this path. */
     copyFromProfile?: string;
     resolveExplicit: (trimmedProfile: string) => string;
+    provision?: boolean;
 }
 export interface ResolvedProfile {
     kind: ProfileKind;

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

@@ -1,3 +1,10 @@
 import type { CompilationLike, DefaultBrowserFlags, PluginInterface } from '../../browsers-types';
 export declare const DEFAULT_BROWSER_FLAGS: DefaultBrowserFlags[];
-export declare function browserConfig(compilation: CompilationLike, configOptions: PluginInterface): string[];
+export interface BrowserConfigMode {
+    provision?: boolean;
+}
+export declare function chromiumLaunchPlan(binary: string, chromiumConfig: string[], startingUrl?: string): {
+    binary: string;
+    args: string[];
+};
+export declare function browserConfig(compilation: CompilationLike, configOptions: PluginInterface, mode?: BrowserConfigMode): string[];

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

@@ -30,6 +30,7 @@ export declare class ChromiumLaunchPlugin {
     }): Promise<void>;
     apply(compiler: unknown): void;
     private launchChromium;
+    private printDryRunPlan;
     private launchWithDirectSpawn;
     private printEnhancedPuppeteerInstallHint;
 }

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

@@ -3,6 +3,16 @@ export declare function parseFlatpakBinary(binary: string): {
 } | null;
 export declare function isFirefoxHeadlessRequested(env?: NodeJS.ProcessEnv): boolean;
 export declare class FirefoxBinaryDetector {
+    static launchPlan(input: {
+        binaryPath: string;
+        profilePath: string;
+        debugPort: number;
+        binaryArgs: string[];
+        headless: boolean;
+    }): {
+        binary: string;
+        args: string[];
+    };
     static generateFirefoxArgs(binaryPath: string, profilePath: string, debugPort: number, additionalArgs?: string[], headless?: boolean): {
         binary: string;
         args: string[];

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

@@ -14,5 +14,14 @@ type BrowserConfigOptions = {
     copyFromProfile?: string;
     instanceId?: string;
 };
+export interface FirefoxLaunchConfig {
+    profilePath: string;
+    binaryArgs: string[];
+    config: string;
+}
+export interface FirefoxConfigMode {
+    provision?: boolean;
+}
 export declare function browserConfig(compilation: CompilationLike, configOptions: BrowserConfigOptions): Promise<string>;
+export declare function resolveFirefoxLaunchConfig(compilation: CompilationLike, configOptions: BrowserConfigOptions, mode?: FirefoxConfigMode): Promise<FirefoxLaunchConfig>;
 export {};

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

@@ -1 +1 @@
-export declare function logFirefoxDryRun(browserBinaryLocation: string, firefoxConfig: string): void;
+export declare function logFirefoxDryRun(browserBinaryLocation: string, launchArgs: string[]): void;

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

@@ -22,6 +22,7 @@ export declare class FirefoxLaunchPlugin {
     runOnce(compilation: CompilationLike, options: LaunchOptions): Promise<void>;
     apply(compiler: unknown): void;
     private launch;
+    private printDryRunPlan;
     private resolveSpawnStdio;
     private spawnFirefoxChild;
     private pipeChildOutput;

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

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

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

@@ -22,6 +22,7 @@ export declare class FirefoxRDPController {
     constructor(plugin: PluginLike, debugPort: number);
     ensureLoaded(compilation: CompilationLike): Promise<void>;
     getAddonInstallRefusalReason(): string | null;
+    openNewTab(): Promise<boolean>;
     getExtensionId(): string | undefined;
     enableUnifiedLogging(opts: {
         level?: string;

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

@@ -21,6 +21,7 @@ export declare class RemoteFirefox {
     private connectClient;
     private invalidateConnectionScopedCaches;
     installAddons(compilation: CompilationLike): Promise<void>;
+    openNewTab(): Promise<boolean>;
     enableUnifiedLogging(opts: {
         level?: string;
         contexts?: string[] | undefined;

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

@@ -0,0 +1,10 @@
+export declare const MANAGER_ADDON_ID = "devtools@extension.js";
+export declare const OPEN_NEW_TAB_EXPRESSION: string;
+export interface ManagerTabClient {
+    request: (payload: unknown) => Promise<unknown>;
+    evaluate: (actor: string, expression: string) => 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;
+}
+export declare function openManagerNewTab(client: ManagerTabClient): Promise<boolean>;

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

@@ -6,6 +6,7 @@ export declare class MessagingClient extends EventEmitter {
     private reconnecting;
     private disconnectedByUser;
     connect(port: number): Promise<void>;
+    private openTransport;
     disconnect(): void;
     private attemptReconnect;
     request(requestProps: unknown): Promise<unknown>;

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

@@ -1,9 +1,11 @@
 import EventEmitter from 'node:events';
+export declare function surfaceTransportError(emitter: EventEmitter, error: unknown): void;
 export declare class RdpTransport extends EventEmitter {
     private conn?;
     private incoming;
     private active;
     private pending;
+    private lost;
     connect(port: number, host?: string): Promise<void>;
     disconnect(): void;
     private rejectAll;
@@ -15,6 +17,6 @@ export declare class RdpTransport extends EventEmitter {
     private onData;
     private readMessage;
     private handleMessage;
-    private onEnd;
+    private onConnectionLost;
     private onTimeout;
 }

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

@@ -10,7 +10,7 @@ interface DoctorOptions {
     browser?: string;
     output?: 'pretty' | 'json';
 }
-export declare function resolveDoctorBrowser(projectPathArg: string | undefined, optsBrowser: string | undefined): {
+export declare function resolveDoctorBrowser(projectPath: string | undefined, optsBrowser: string | undefined): {
     browser: string;
     sessionBrowsers: string[];
 };

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

@@ -0,0 +1,8 @@
+import type { Command } from 'commander';
+export declare function scanArgvValue(argv: string[], flag: string): string | undefined;
+export declare function collectValuedLongFlags(program: Command): Set<string>;
+export declare function resolveCommandFromArgv(argv: string[], valuedFlags?: ReadonlySet<string>): string | undefined;
+export declare function rewriteOutputAliasArgv(argv: string[], valuedFlags?: ReadonlySet<string>): {
+    argv: string[];
+    rewritten: boolean;
+};

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

@@ -0,0 +1,7 @@
+import { Option } from 'commander';
+export declare function geckoBinaryOption(): Option;
+export declare function firefoxBinaryAliasOption(): Option;
+export declare function cliGeckoBinary(opts: {
+    geckoBinary?: string;
+    firefoxBinary?: string;
+}): string | undefined;

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

@@ -280,4 +280,9 @@ 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 openSurfaceGestureStep(surface: string): string;
+export declare function openSurfaceNeedsGesturePlain(surface: string): string;
+export declare function openSurfaceNeedsGesture(surface: 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/msg-placeholders.d.ts

@@ -0,0 +1,2 @@
+export declare function collectMsgReferences(value: unknown): string[];
+export declare function findUndefinedMsgReferences(value: unknown, catalogKeys: Iterable<string>): string[];

package/dist/extension/helpers/output-flag.d.ts

@@ -1,5 +1,11 @@
 export type OutputFormat = 'pretty' | 'json';
 export declare function warnDeprecatedOutputAlias(flag: string): void;
+export declare function normalizeOutputFormat(value: unknown): OutputFormat | undefined;
+export declare function isJsonOutput(opts: {
+    output?: string;
+    format?: string;
+    waitFormat?: string;
+}): boolean;
 export declare function resolveOutputFormat(opts: {
     output?: string;
     format?: string;

package/dist/extension/helpers/session-project-path.d.ts

@@ -0,0 +1,4 @@
+import type { AnyDevelopModule } from './extension-develop-runtime';
+export declare function resolveSessionProjectPath(bridge: AnyDevelopModule, pathArg?: string): string;
+export declare function sessionReadyPath(bridge: AnyDevelopModule, projectPath: string, browser: string): string;
+export declare function sessionLogsPath(bridge: AnyDevelopModule, projectPath: string, browser: string): string;

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

@@ -1,6 +1,7 @@
 import { Telemetry, type TelemetrySource } from './telemetry';
 type KnownCommand = 'create' | 'dev' | 'start' | 'preview' | 'build' | 'install' | 'uninstall' | 'telemetry' | 'unknown';
 export declare function detectInvokedCommand(argv: string[]): KnownCommand;
+export declare function advertisedTemplateName(value: string | undefined): string | undefined;
 export declare function telemetryCommandContext(command: string, argv?: string[]): {
     template?: string;
     source?: string;

package/dist/extension/helpers/template-catalog.d.ts

@@ -1,4 +1,4 @@
-export declare const DEFAULT_TEMPLATE = "javascript";
+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/cb6a25377bd9516a1e55447a2010537019851ab2/examples";
 export interface TemplateGroup {

package/package.json

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

package/types/assets.d.ts

@@ -0,0 +1,65 @@
+// Wildcard module declarations for assets and stylesheets.
+// This file is a script on purpose: index.d.ts is a module (it augments the
+// global scope), and a wildcard `declare module` inside a module file is an
+// augmentation TypeScript silently ignores, so the declares live here and
+// index.d.ts pulls them in through a reference.
+
+type CSSContentData = Readonly<Record<string, string>>
+type CSSModuleData = Readonly<Record<string, string>>
+
+declare module '*.css' {
+  const content: CSSContentData
+  export default content
+}
+
+declare module '*.module.css' {
+  const content: CSSModuleData
+  export default content
+}
+declare module '*.module.scss' {
+  const content: CSSModuleData
+  export default content
+}
+declare module '*.module.sass' {
+  const content: CSSModuleData
+  export default content
+}
+
+declare module '*.png' {
+  const content: string
+  export default content
+}
+declare module '*.jpg' {
+  const content: string
+  export default content
+}
+declare module '*.jpeg' {
+  const content: string
+  export default content
+}
+declare module '*.gif' {
+  const content: string
+  export default content
+}
+declare module '*.webp' {
+  const content: string
+  export default content
+}
+declare module '*.avif' {
+  const content: string
+  export default content
+}
+declare module '*.ico' {
+  const content: string
+  export default content
+}
+declare module '*.bmp' {
+  const content: string
+  export default content
+}
+declare module '*.svg' {
+  // Use any to avoid conflicts with SVGR or other SVG loaders.
+  // biome-ignore lint/suspicious/noExplicitAny: deliberate, a stricter type conflicts with SVGR-style loaders
+  const content: any
+  export default content
+}

package/types/index.d.ts

@@ -2,6 +2,7 @@
 // This file is published by the extension package.
 /// <reference types="node" />
 /// <reference types="chrome" />
+/// <reference path="./assets.d.ts" />
 
 declare global {
   // Align types with Extension.js runtime: we provide the browser global via
@@ -59,64 +60,4 @@ declare global {
   }
 }
 
-type CSSContentData = Readonly<Record<string, string>>
-type CSSModuleData = Readonly<Record<string, string>>
-
-declare module '*.css' {
-  const content: CSSContentData
-  export default content
-}
-
-declare module '*.module.css' {
-  const content: CSSModuleData
-  export default content
-}
-declare module '*.module.scss' {
-  const content: CSSModuleData
-  export default content
-}
-declare module '*.module.sass' {
-  const content: CSSModuleData
-  export default content
-}
-
-declare module '*.png' {
-  const content: string
-  export default content
-}
-declare module '*.jpg' {
-  const content: string
-  export default content
-}
-declare module '*.jpeg' {
-  const content: string
-  export default content
-}
-declare module '*.gif' {
-  const content: string
-  export default content
-}
-declare module '*.webp' {
-  const content: string
-  export default content
-}
-declare module '*.avif' {
-  const content: string
-  export default content
-}
-declare module '*.ico' {
-  const content: string
-  export default content
-}
-declare module '*.bmp' {
-  const content: string
-  export default content
-}
-declare module '*.svg' {
-  // Use any to avoid conflicts with SVGR or other SVG loaders.
-  // biome-ignore lint/suspicious/noExplicitAny: deliberate, a stricter type conflicts with SVGR-style loaders
-  const content: any
-  export default content
-}
-
 export {}