extension 4.0.26 → 4.0.28

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

@@ -18,7 +18,7 @@
  */
 export type ProfileKind = 'system' | 'explicit' | 'managed';
 export interface ResolveProfileInput {
-    rawProfile?: string | false;
+    rawProfile?: string | boolean;
     /** Managed-profile base directory: `<distRoot>/extension-js/profiles/<browser>-profile`. */
     managedBaseDir: string;
     /** EXTENSION_USE_SYSTEM_PROFILE / EXTJS_USE_SYSTEM_PROFILE resolved to a boolean. */
@@ -39,6 +39,17 @@ export interface ResolvedProfile {
     /** Set when `copyFromProfile` seeded this run, for logging/visibility. */
     seededFrom?: string;
 }
+/**
+ * The one interpretation of the `--profile` / `profile` option value.
+ * Commander delivers flag values as strings, so `--profile false` arrives as
+ * the string `'false'`. Without this normalization that string reads as an
+ * explicit path and a literal profile directory named `false` gets created.
+ *
+ * - `false` / `'false'`: the browser's own default profile (system).
+ * - `true` / `'true'`: the managed default (same as leaving the option unset).
+ * - any other string: an explicit profile path.
+ */
+export declare function normalizeProfileOption(value: string | boolean | undefined): string | false | undefined;
 export declare function ensureProfileRootIgnoreFile(managedBaseDir: string): void;
 export declare function seedProfileFrom(source: string, dest: string): void;
 export declare function resolveProfileConfig(input: ResolveProfileInput): ResolvedProfile;

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

@@ -35,7 +35,7 @@ export interface BrowserConfig {
  *
  * Each flag disables or modifies a specific browser feature for a more controlled development environment.
  */
-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' | '--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' | '--enable-unsafe-extension-debugging' | '--silent-debugger-extension-api';
 /**
  * Options for the browser plugin.
  */

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

@@ -17,6 +17,13 @@ type PreviewRunOptions = {
     port?: number | string;
     dryRun?: boolean;
     readyPath?: string;
+    logLevel?: string;
+    logContexts?: string[];
+    logFormat?: 'pretty' | 'json' | 'ndjson';
+    logTimestamps?: boolean;
+    logColor?: boolean;
+    logUrl?: string;
+    logTab?: number | string;
 };
 export declare function runOnlyPreviewBrowser(opts: PreviewRunOptions): Promise<void>;
 export {};

package/dist/extension/browsers/run-safari/safari-packager.d.ts

@@ -10,6 +10,8 @@ export interface SafariPackagerOverrides {
     macOsOnly?: boolean;
     forceRegenerate?: boolean;
     safariBinary?: string;
+    /** When set, overrides the factory `noOpen` for this packaging call. */
+    noOpen?: boolean;
 }
 export interface SafariPackagerOptions extends SafariPackagerOverrides {
     /** 'safari' or 'webkit-based'. Defaults to 'safari'. */

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

@@ -10,6 +10,10 @@ interface DoctorOptions {
     browser?: string;
     output?: 'pretty' | 'json';
 }
+export declare function resolveDoctorBrowser(projectPathArg: string | undefined, optsBrowser: string | undefined): {
+    browser: string;
+    sessionBrowsers: string[];
+};
 /**
  * Walks the control-channel legs in dependency order and reports the first
  * failing one with a remediation, instead of the dead-end errors each verb

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

@@ -1,4 +1,12 @@
 import type { Command } from 'commander';
+export interface StoredLogin {
+    token: string;
+    projectSlug: string;
+    workspaceSlug: string;
+}
+export declare function readStoredLogin(): StoredLogin | null;
+export declare function readStoredLoginToken(): string;
+export declare function readLocalProjectName(projectPath: string): string;
 export interface PublishRequest {
     url: string;
     headers: Record<string, string>;
@@ -9,7 +17,24 @@ export interface PublishInput {
     api?: string;
     ttl?: string | number;
     buildSha?: string;
+    projectPath?: string;
+    project?: string;
+}
+/**
+ * The project this publish will act for, and where that answer came from. A
+ * stored login is scoped to one project, so a publish run anywhere else answers
+ * for the wrong one; `actsFor` is what the command prints and refuses on.
+ */
+export interface PublishScope {
+    source: 'flag' | 'env' | 'stored-login';
+    actsFor: string;
+    workspace: string;
+    localName: string;
 }
 /** Build the HTTP request (pure, unit-testable, no network). */
 export declare function buildPublishRequest(opts: PublishInput): PublishRequest;
+export declare function buildPublishPlan(opts: PublishInput): {
+    request: PublishRequest;
+    scope: PublishScope;
+};
 export declare function registerPublishCommand(program: Command): void;

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

@@ -50,6 +50,13 @@ export interface BrowserConfig extends BrowserLaunchConfig {
     geckoBinary?: string;
     firefoxBinary?: string;
 }
+/** Asset categories the perf-budgets plugin recognizes. */
+export type PerfBudgetCategory = 'content-script' | 'service-worker' | 'page' | 'ignored';
+/**
+ * Per-category asset size budgets (bytes) for compiling commands.
+ * Set at the top level, or per command via `commands.dev|build.perfBudgets`.
+ */
+export type PerfBudgetsConfig = Partial<Record<PerfBudgetCategory, number>>;
 /** `commands.dev` overrides. */
 export interface DevCommandConfig extends BrowserLaunchConfig, UnifiedLoggerConfig {
     browser?: BrowserType;
@@ -60,6 +67,7 @@ export interface DevCommandConfig extends BrowserLaunchConfig, UnifiedLoggerConf
     noBrowser?: boolean;
     polyfill?: boolean;
     hashContentScripts?: boolean;
+    perfBudgets?: PerfBudgetsConfig;
 }
 /** Shared `commands.start` / `commands.preview` overrides. */
 export interface ServeCommandConfig extends BrowserLaunchConfig, UnifiedLoggerConfig {
@@ -80,8 +88,10 @@ export interface BuildCommandConfig {
     zip?: boolean;
     zipSource?: boolean;
     zipFilename?: string;
+    silent?: boolean;
     extensions?: CompanionExtensionsConfig;
     transpilePackages?: string[];
+    perfBudgets?: PerfBudgetsConfig;
 }
 /**
  * The shape of `extension.config.js`.
@@ -119,6 +129,11 @@ export interface FileConfig {
      * `commands.<name>.transpilePackages` overrides this value.
      */
     transpilePackages?: string[];
+    /**
+     * Default per-category asset budgets for all commands. Per-command
+     * `commands.dev|build.perfBudgets` overrides this value.
+     */
+    perfBudgets?: PerfBudgetsConfig;
     /**
      * Escape hatch to customize the underlying Rspack/webpack-compatible
      * configuration. Receives and returns a bundler `Configuration` object.

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

@@ -0,0 +1,19 @@
+import type { Command } from 'commander';
+/**
+ * True when the user typed this option on the CLI (not a commander default).
+ * Negated boolean options (`--no-open`, `--no-log-color`) set a default value
+ * even when absent. Use this to leave those unset so extension.config.js
+ * `commands.*` values can apply downstream.
+ */
+export declare function isExplicitCliOption(command: Command, name: string): boolean;
+/**
+ * Return `value` only when the user typed the flag, `undefined` otherwise,
+ * so develop can fall through to extension.config.js and stock defaults.
+ */
+export declare function explicitCliValue<T>(command: Command, name: string, value: T): T | undefined;
+/**
+ * Coerce an optional boolean CLI value without inventing a default. Commander
+ * may leave the key unset, or set a boolean/string from `--flag`,
+ * `--flag false`, or `--no-flag`.
+ */
+export declare function explicitOptionalBoolean(value: boolean | string | undefined): boolean | undefined;

package/package.json

@@ -38,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "4.0.26",
+  "version": "4.0.28",
   "description": "The cross-browser extension framework. Build Chrome, Edge, Firefox, and Safari extensions with no build configuration.",
   "homepage": "https://extension.js.org/",
   "bugs": {
@@ -95,20 +95,20 @@
     "cli"
   ],
   "dependencies": {
-    "brave-location": "3.1.0",
-    "chrome-location2": "4.1.0",
-    "chromium-location": "2.1.1",
+    "brave-location": "3.1.1",
+    "chrome-location2": "4.1.1",
+    "chromium-location": "2.1.2",
     "cross-spawn": "^7.0.6",
-    "edge-location": "2.3.0",
-    "firefox-location2": "3.1.0",
-    "librewolf-location": "1.2.0",
-    "opera-location2": "2.1.0",
-    "vivaldi-location2": "2.1.0",
-    "waterfox-location": "2.1.0",
-    "yandex-location": "2.1.0",
-    "extension-create": "4.0.26",
-    "extension-develop": "4.0.26",
-    "extension-install": "4.0.26",
+    "edge-location": "2.3.1",
+    "firefox-location2": "3.1.1",
+    "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.0.28",
+    "extension-develop": "4.0.28",
+    "extension-install": "4.0.28",
     "commander": "^15.0.0",
     "pintor": "0.3.0",
     "semver": "^7.7.3",