extension 4.1.25 → 4.1.27

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

@@ -9,6 +9,7 @@ type HostPort = {
     port?: number | string;
 };
 type BinaryProvenance = 'managed' | 'pinned' | 'system' | 'snapshot';
+export declare function chromiumExtensionIdFromRegisteredPath(registeredPath: string, platform?: NodeJS.Platform): string;
 export declare function expectedChromiumExtensionId(outPath: string): string;
 export declare function expectedGeckoExtensionId(outPath: string): string;
 export declare function printDevBannerOnce(opts: {

package/dist/extension/browsers/browsers-lib/browser-family.d.ts

@@ -3,3 +3,5 @@ export declare const CHROMIUM_BROWSERS: ReadonlySet<string>;
 export declare const FIREFOX_BROWSERS: ReadonlySet<string>;
 export declare function isChromiumBrowser(browser: BrowserType | string): boolean;
 export declare function isFirefoxBrowser(browser: BrowserType | string): boolean;
+export declare const EMULATOR_BROWSERS: ReadonlySet<string>;
+export declare function isEmulatorBrowser(browser: BrowserType | string): boolean;

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

@@ -11,6 +11,7 @@ export declare function bestEffortBannerPrintFailed(message: string): string;
 export declare function firefoxRdpRuntimeCapabilitySummary(state: 'available' | 'unavailable'): string;
 export declare function skippingBrowserLaunchDueToCompileErrors(): string;
 export declare function browserNotInstalledError(browser: Browser, browserBinaryLocation: string): string;
+export declare function geckoForkNotInstalled(browser: Browser, guidance: string): string;
 export declare function usingManagedChromiumFamilyFallback(requestedBrowser: Browser, _fallbackBrowser: Browser, _binaryPath: string): string;
 export declare function preferringSystemBrowserOverSnapshot(_systemBinary: string, _snapshotBinary: string): string;
 export declare function mv2NotSupportedByChromium(extensionPath: string): string;
@@ -52,7 +53,8 @@ export declare function chromiumDryRunNotLaunching(): string;
 export declare function chromiumDryRunBinary(path: string): string;
 export declare function chromiumDryRunFlags(flags: string): string;
 export declare function prettyPuppeteerInstallGuidance(browser: Browser, rawGuidance: string, cacheDir: string): string;
-export declare function firefoxLaunchCalled(): string;
+export declare function firefoxLaunchCalled(browser?: Browser | string): string;
+export declare function librewolfRemoteDebuggingLocked(overridesPath: string): string;
 export declare function firefoxBinaryArgsExtracted(args: string): string;
 export declare function firefoxNoBinaryArgsFound(): string;
 export declare function firefoxFailedToStart(error: unknown): string;

package/dist/extension/browsers/browsers-lib/output-binaries-resolver.d.ts

@@ -1,7 +1,7 @@
 import type { CompilationLike } from '../browsers-types.js';
 export declare function getCompilationOutputPath(compilation: CompilationLike): string;
 export declare function computeBinariesBaseDir(compilation: CompilationLike): string;
-export declare function managedBrowserCacheEnv(cacheRoot: string, browser: 'chrome' | 'chromium' | 'firefox' | 'edge' | 'brave' | 'opera' | 'vivaldi' | 'yandex' | 'waterfox' | 'librewolf' | 'chromium-based' | 'gecko-based' | 'firefox-based' | 'safari' | 'webkit-based'): Record<string, string>;
+export declare function managedBrowserCacheEnv(cacheRoot: string, browser: 'chrome' | 'chromium' | 'firefox' | 'edge' | 'brave' | 'opera' | 'vivaldi' | 'yandex' | 'waterfox' | 'librewolf' | 'zen' | 'floorp' | 'chromium-based' | 'gecko-based' | 'firefox-based' | 'safari' | 'webkit-based' | 'chromium-emulator'): Record<string, string>;
 export declare function resolveFromBinaries(compilation: CompilationLike, browser: 'chrome' | 'chromium' | 'firefox' | 'edge'): string | null;
 export declare function parseManagedBuildId(dirName: string): number[];
 export declare function compareManagedBuildDirNames(a: string, b: string): number;

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

@@ -1,4 +1,4 @@
-export type BrowserType = 'chrome' | 'edge' | 'firefox' | 'chromium' | 'brave' | 'opera' | 'vivaldi' | 'yandex' | 'waterfox' | 'librewolf' | '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';
 export interface CompilationLike {
     options: {
         mode?: string;

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

@@ -29,6 +29,7 @@ export interface BrowserLaunchOptions {
     logUrl?: string;
     logTab?: number | string;
     logSink?: BrowserLogSink;
+    emulatorViewerUrl?: string;
 }
 export type { ExtensionLoadRetryResult };
 export interface BrowserController {

package/dist/extension/browsers/run-emulator/index.d.ts

@@ -0,0 +1,30 @@
+export interface EmulatorLaunchOptions {
+    browser: string;
+    mode?: 'development' | 'production';
+    noOpen?: boolean;
+    dryRun?: boolean;
+    logLevel?: string;
+    emulatorViewerUrl?: string;
+}
+export interface EmulatorController {
+    enableUnifiedLogging(): Promise<void>;
+}
+export type UrlOpener = (url: string) => void;
+export declare function emulatorViewerUrlLine(url: string): string;
+export declare function emulatorLogsLimitLine(): string;
+export declare function openCommandFor(url: string, platform?: NodeJS.Platform): {
+    command: string;
+    args: string[];
+};
+export type EngineOriginVerdict = 'open' | 'held' | 'throttled' | 'unknown';
+export type OriginFetch = (url: string, init: {
+    signal: AbortSignal;
+}) => Promise<{
+    status: number;
+    json(): Promise<unknown>;
+}>;
+export declare function engineVersionUrl(viewerUrl: string): string | null;
+export declare function probeEngineOrigin(viewerUrl: string, fetchImpl?: OriginFetch, timeoutMs?: number): Promise<EngineOriginVerdict>;
+export declare function engineOriginLine(verdict: EngineOriginVerdict): string | null;
+export declare function openInDefaultBrowser(url: string): void;
+export declare function launchEmulator(opts: EmulatorLaunchOptions, opener?: UrlOpener, probe?: (url: string) => Promise<EngineOriginVerdict>): Promise<EmulatorController>;

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

@@ -0,0 +1,11 @@
+import type { ChildProcess } from 'node:child_process';
+import type { Writable } from 'node:stream';
+type ChildStreams = Pick<ChildProcess, 'stdout' | 'stderr'>;
+export declare function attachChildOutput(child: ChildStreams, opts: {
+    debug: boolean;
+    sinks?: {
+        stdout: Writable;
+        stderr: Writable;
+    };
+}): void;
+export {};

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

@@ -0,0 +1,11 @@
+type FsLike = {
+    existsSync: (p: string) => boolean;
+    readFileSync: (p: string, encoding: 'utf-8') => string;
+};
+export declare const LIBREWOLF_REMOTE_DEBUGGING_LINES: string[];
+export declare function librewolfOverridesCandidates(env: NodeJS.ProcessEnv, platform: NodeJS.Platform): string[];
+export declare function librewolfRemoteDebuggingEnabled(fsLike: FsLike, env: NodeJS.ProcessEnv, platform: NodeJS.Platform): {
+    enabled: boolean;
+    expectedPath: string;
+};
+export {};

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

@@ -1,4 +1,5 @@
-export declare function printRunningInDevelopmentSummary(candidateAddonPaths: string[], browser: 'firefox', extensionId?: string, browserVersionLine?: string, launchIdentity?: {
+import type { BrowserType } from '../../../browsers-types.js';
+export declare function printRunningInDevelopmentSummary(candidateAddonPaths: string[], browser: BrowserType, extensionId?: string, browserVersionLine?: string, launchIdentity?: {
     profilePath?: string;
     binaryPath?: string;
     binaryProvenance?: 'managed' | 'pinned' | 'system' | 'snapshot';

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' | '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';
 /**
  * Companion extensions are "load-only" unpacked extension directories loaded
  * alongside the user extension in `dev`/`preview`/`start` (and `build` for
@@ -97,6 +97,11 @@ export interface BuildCommandConfig {
      * as warnings. Needs `addons-linter` installed. Defaults to `true`.
      */
     addonLint?: boolean;
+    /**
+     * Minify first-party code in production builds. Defaults to `true` for
+     * every target but `opera`, whose store reviews readable source only.
+     */
+    minify?: boolean;
     extensions?: CompanionExtensionsConfig;
     transpilePackages?: string[];
     perfBudgets?: PerfBudgetsConfig;

package/dist/extension/helpers/emulator-session.d.ts

@@ -0,0 +1,4 @@
+export declare const EMULATOR_LOGS_REFUSAL = "emulated Chromium runs in a web page, so extension logs has nothing to attach to. Open your browser devtools on that page to read the console.";
+export declare function emulatorRefusalFor(command: string): string;
+export declare function isEmulatorSession(bridge: unknown, projectPath: string, browser: string, env?: NodeJS.ProcessEnv): boolean;
+export declare function emulatorSessionRefusal(bridge: unknown, projectPath: string, browser: string, command: string, env?: NodeJS.ProcessEnv): string | null;

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

@@ -26,6 +26,7 @@ export interface CardInput {
 }
 export declare const MAX_CARD_ROWS = 3;
 export declare function card(input?: CardInput): string;
+export declare function browserDisplayName(browser: string): string;
 export declare function browserRowValue(browser: string, versionLine?: string): string;
 export declare function isCardKeyClaimed(key: string): boolean;
 export declare function claimCardKey(key: string): boolean;

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

@@ -1,7 +1,11 @@
-export type Browser = 'chrome' | 'edge' | 'firefox' | 'chromium' | 'chromium-based' | 'gecko-based' | 'firefox-based' | 'safari' | 'webkit-based';
+export type Browser = 'chrome' | 'edge' | 'firefox' | 'chromium' | 'chromium-based' | 'gecko-based' | 'firefox-based' | 'safari' | 'webkit-based' | 'chromium-emulator';
+export declare const EMULATOR_BROWSER_TARGET = "chromium-emulator";
+export declare function isEmulatorLaneEnabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function isEmulatorVendor(value: unknown): boolean;
 export declare function isSafariVendor(value: string): boolean;
 export declare const SUPPORTED_BROWSER_TARGETS: string[];
 export declare const BROWSER_TARGETS_HELP: string;
+export declare function supportedBrowserTargets(env?: NodeJS.ProcessEnv): string[];
 export declare const SESSION_BROWSER_TARGETS_HELP: string;
 export declare const NO_SAFARI_BROWSER_TARGETS_HELP: string;
 export declare function parseOptionalBoolean(value?: string): boolean;
@@ -10,7 +14,9 @@ export declare const MANAGED_INSTALL_TARGETS: readonly ['chrome', 'chromium', 'e
 export declare const MANAGED_INSTALL_TARGETS_HELP: string;
 export declare const MANAGED_INSTALL_BINARIES: readonly ['chrome', 'chromium', 'edge', 'firefox'];
 export declare const installTargets: (browser?: Browser | 'all') => string[];
-export declare function validateVendors(vendorsList: string[], onInvalid: (invalid: string, supported: string[]) => void): boolean;
+export declare function validateVendors(vendorsList: string[], onInvalid: (invalid: string, supported: string[]) => void, options?: {
+    allowEmulator?: boolean;
+}): boolean;
 export declare function validateManagedInstallTargets(targetsList: string[], onInvalid: (invalid: string, supported: string[]) => void): boolean;
 export type ManagedInstallTargetClass = 'managed' | 'not-installable' | 'unknown';
 export declare function classifyManagedInstallTarget(name: string): ManagedInstallTargetClass;

package/package.json

@@ -38,9 +38,10 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "4.1.25",
+  "version": "4.1.27",
   "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",
   "bugs": {
     "url": "https://github.com/extension-js/extension.js/issues"
   },
@@ -95,29 +96,31 @@
     "cli"
   ],
   "dependencies": {
+    "@types/chrome": "*",
+    "@types/node": "*",
+    "@types/webextension-polyfill": "*",
     "brave-location": "3.1.1",
     "chrome-location2": "4.1.1",
     "chromium-location": "2.1.2",
+    "commander": "^15.0.0",
     "edge-location": "2.3.1",
+    "extension-create": "4.1.27",
+    "extension-develop": "4.1.27",
+    "extension-install": "4.1.27",
     "firefox-location2": "3.1.1",
+    "floorp-location": "1.0.0",
     "librewolf-location": "1.2.1",
     "opera-location2": "2.1.1",
-    "vivaldi-location2": "2.1.1",
-    "waterfox-location": "2.1.1",
-    "yandex-location": "2.1.1",
-    "extension-create": "4.1.25",
-    "extension-develop": "4.1.25",
-    "extension-install": "4.1.25",
-    "commander": "^15.0.0",
     "pintor": "0.3.0",
     "semver": "^7.7.3",
     "unique-names-generator": "^4.7.1",
-    "ws": "^8.20.1",
     "update-check": "^1.5.4",
+    "vivaldi-location2": "2.1.1",
+    "waterfox-location": "2.1.1",
+    "ws": "^8.20.1",
     "wsl-support": "0.1.0",
-    "@types/chrome": "*",
-    "@types/node": "*",
-    "@types/webextension-polyfill": "*"
+    "yandex-location": "2.1.1",
+    "zen-location": "1.0.0"
   },
   "devDependencies": {
     "@rslib/core": "^1.0.0",