extension 4.0.32 → 4.0.34

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

@@ -1,7 +1,9 @@
 import type { BrowserType } from '../browsers-types';
 type Browser = BrowserType;
 export declare function capitalizedBrowserName(browser: Browser): string;
-export declare function resolveBrowserVersionLine(browser: string, pinnedLine?: string): string;
+export declare function resolveBrowserVersionLine(browser: string, pinnedLine?: string, opts?: {
+    pinned?: boolean;
+}): string;
 export declare function creatingUserProfile(profilePath: string): string;
 export declare function browserInstanceExited(browser: Browser): string;
 export declare function cdpClientAttachedToTarget(sessionId: string, targetType: string): string;

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

@@ -3,6 +3,8 @@ export declare function getCompilationOutputPath(compilation: CompilationLike):
 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 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;
 export declare function resolveChromiumFamilyFallback(compilation: CompilationLike, requested?: 'chrome' | 'chromium'): {
     browser: 'chrome' | 'chromium' | 'edge';
     binary: string;

package/dist/extension/browsers/browsers-lib/shared-utils.d.ts

@@ -2,7 +2,7 @@ export declare function shortInstanceId(instanceId?: string): string;
 export declare function instanceOffsetFromId(instanceId?: string): number;
 export declare function deriveDebugPortWithInstance(optionPort?: number | string, instanceId?: string): number;
 export declare function calculateDebugPort(portFromConfig?: number | string, devServerPort?: number, defaultPort?: number): number;
-export declare function filterBrowserFlags(defaultFlags: string[], excludeFlags?: string[]): string[];
+export declare function filterBrowserFlags(flags: string[], excludeFlags?: string[]): string[];
 export interface ChromiumBinaryChoice {
     binary: string | null;
     usedManagedSnapshot: boolean;
@@ -21,6 +21,7 @@ export declare function classifyBinaryProvenance(opts: {
     pinnedByFlag?: boolean;
     usedManagedSnapshot?: boolean;
 }): BinaryProvenance;
+export declare function probeChromiumBinaryVersion(bin: string, browser?: string): string;
 export declare function parseEnvBrowserFlags(raw: string | undefined | null): string[];
 export declare function isHeadlessGuardRequested(env?: NodeJS.ProcessEnv): boolean;
 export declare function mergeChromiumFeatureSwitches(flags: string[]): string[];

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

@@ -140,7 +140,7 @@ declare const COMMAND_TABLE: readonly [{
     readonly supportsSourceInspection: false;
     readonly notes: readonly [{
         readonly usage: '--browser <chrome|chromium|edge|firefox|chromium-based|gecko-based|firefox-based|all>';
-        readonly description: 'Install multiple browsers, browser families, or all';
+        readonly description: 'Install one or more managed browsers (comma-separated) or all';
     }, {
         readonly usage: '--where';
         readonly description: 'Print the managed browser cache root (or browser install path(s) when a browser name or --browser is provided)';
@@ -154,11 +154,14 @@ declare const COMMAND_TABLE: readonly [{
     readonly description: 'Remove managed browser binaries from the Extension.js cache';
     readonly supportsSourceInspection: false;
     readonly notes: readonly [{
+        readonly usage: '--browser <chrome|chromium|edge|firefox|chromium-based|gecko-based|firefox-based|all>';
+        readonly description: 'Remove one or more managed browsers (comma-separated), same names as install';
+    }, {
         readonly usage: '--all';
         readonly description: 'Remove every managed browser binary';
     }, {
         readonly usage: '--where';
-        readonly description: 'Print the managed browser cache root (or browser install path(s) when --browser/--all is provided)';
+        readonly description: 'Print the managed browser cache root (or browser install path(s) when a browser name, --browser, or --all is provided)';
     }];
 }, {
     readonly name: 'telemetry';
@@ -204,6 +207,9 @@ export declare function noURLWithoutStart(argument: string): string;
 export declare function notImplemented(argument: string): string;
 export declare function programUserHelp(): string;
 export declare function unsupportedBrowserFlag(value: string, supported: string[]): string;
+export declare function browserNotInstallablePlain(value: string): string;
+export declare function browserNotInstallable(value: string): string;
+export declare function browserDownloadFailed(browser: string, detail: string): string;
 export declare function safariOnlyOption(flags: string[]): string;
 export declare function safariInvalidBundleId(bundleId: string): string;
 export declare function safariCommandNotSupported(command: 'dev' | 'preview' | 'start'): string;

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

@@ -1,6 +1,10 @@
 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 telemetryCommandContext(command: string, argv?: string[]): {
+    template?: string;
+    source?: string;
+};
 export declare const telemetry: Telemetry;
 export declare function getTelemetryConsent(): {
     enabled: boolean;

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

@@ -16,6 +16,7 @@ type TelemetryInit = {
     sampleRate?: number;
     maxEventsPerRun?: number;
     debounceMs?: number;
+    timeoutMs?: number;
 };
 type TelemetryStorage = {
     telemetryDir: string;
@@ -45,6 +46,7 @@ export declare class Telemetry {
     private readonly sampleRate;
     private readonly maxEventsPerRun;
     private readonly debounceMs;
+    private readonly timeoutMs;
     private readonly debug;
     private readonly common;
     private recent;

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

@@ -5,5 +5,15 @@ export declare const BROWSER_TARGETS_HELP: string;
 export declare const NO_SAFARI_BROWSER_TARGETS_HELP: string;
 export declare function parseOptionalBoolean(value?: string): boolean;
 export declare const vendors: (browser?: Browser | 'all') => string[];
+export declare const MANAGED_INSTALL_TARGETS: readonly ['chrome', 'chromium', 'edge', 'firefox', 'chromium-based', 'gecko-based', 'firefox-based'];
+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 validateManagedInstallTargets(targetsList: string[], onInvalid: (invalid: string, supported: string[]) => void): boolean;
+export type ManagedInstallTargetClass = 'managed' | 'not-installable' | 'unknown';
+export declare function classifyManagedInstallTarget(name: string): ManagedInstallTargetClass;
+export declare function firstNonManagedInstallTarget(targetsList: string[]): {
+    name: string;
+    kind: Exclude<ManagedInstallTargetClass, 'managed'>;
+} | null;

package/package.json

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