extension 3.12.0 → 3.12.2

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

@@ -0,0 +1,52 @@
+import type { FirefoxContext } from '../firefox-context';
+export declare class FirefoxSourceInspectionPlugin {
+    private readonly host;
+    private readonly _ctx?;
+    private devOptions?;
+    private client;
+    private currentConsoleActor;
+    private currentTabActor;
+    private isWatching;
+    private debounceTimer;
+    private initialized;
+    private lastUrlToInspect;
+    private lastOutputHash?;
+    private lastByteLength?;
+    private lastSummary?;
+    private lastDomSnapshot?;
+    private consoleCounts;
+    private consoleTop;
+    private consoleCaptureReady;
+    constructor(host: any, ctx?: FirefoxContext);
+    private setDevOptions;
+    private getOutputConfig;
+    private buildPrettyTitle;
+    private getFrameContext;
+    private emitSourceOutput;
+    private setupConsoleCapture;
+    private recordConsoleEvent;
+    private emitExtraOutputs;
+    private evaluateJson;
+    private evaluateString;
+    private getShadowStyleSnapshot;
+    private getDomSnapshot;
+    private getExtensionRootMeta;
+    private emitEventPayload;
+    private getRdpPort;
+    private initialize;
+    private resolveUrlToInspect;
+    private selectActors;
+    private ensureNavigatedAndLoaded;
+    private ensureUrlAndReady;
+    private resolveConsoleActor;
+    private printHTML;
+    private waitForContentScriptInjection;
+    private hasVisibleShadowHostContentFirefox;
+    /** Align with Chromium: settle root meta / shadow styles before emitting injection telemetry. */
+    private shouldEmitFirefoxContentScriptInjected;
+    private reopenTabAndResolveActors;
+    private waitForContentScriptStyles;
+    private handleFileChange;
+    private registerContentReloadSnapshotHook;
+    apply(compiler: any): void;
+}

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

@@ -0,0 +1,38 @@
+import type { CompilationLike } from '../../../browsers-types';
+import { RemoteFirefox } from '../remote-firefox';
+import type { BrowserType } from '../../../browsers-types';
+import type { ContentScriptTargetRule } from '../../../browsers-lib/content-script-targets';
+type PluginLike = {
+    extension: string | string[];
+    browser: BrowserType;
+    browserFlags?: string[];
+    profile?: string | false;
+    preferences?: Record<string, unknown>;
+    startingUrl?: string;
+    geckoBinary?: string;
+    instanceId?: string;
+    source?: string | boolean;
+    watchSource?: boolean;
+    port?: number | string;
+    browserVersionLine?: string;
+};
+export declare class FirefoxRDPController {
+    private readonly remote;
+    private readonly debugPort;
+    constructor(plugin: PluginLike, debugPort: number);
+    getRemoteFirefox(): RemoteFirefox;
+    connect(): Promise<void>;
+    ensureLoaded(compilation: CompilationLike): Promise<void>;
+    hardReload(compilation: CompilationLike, changedAssets: string[]): Promise<void>;
+    reloadMatchingTabsForContentScripts(rules: ContentScriptTargetRule[]): Promise<number>;
+    enableUnifiedLogging(opts: {
+        level?: string;
+        contexts?: string[] | undefined;
+        urlFilter?: string | undefined;
+        tabFilter?: number | string | undefined;
+        format?: 'pretty' | 'json' | 'ndjson';
+        timestamps?: boolean;
+        color?: boolean;
+    }): Promise<void>;
+}
+export { FirefoxRDPController as RDPExtensionController };

package/dist/extension/browsers/run-firefox/firefox-source-inspection/remote-firefox/addons-install.d.ts

@@ -0,0 +1,10 @@
+import type { CompilationLike } from '../../../browsers-types';
+import { MessagingClient } from './messaging-client';
+export declare function getAddonsActorWithRetry(client: MessagingClient, cached: string | undefined, tries?: number, delayMs?: number): Promise<string | undefined>;
+export declare function computeCandidateAddonPaths(compilation: CompilationLike, extensionsToLoad: string[], projectContext?: string): string[];
+export declare function waitForManagerWelcome(client: MessagingClient): Promise<void>;
+export declare function installTemporaryAddon(client: MessagingClient, addonsActor: string, addonPath: string, openDevTools: boolean): Promise<{
+    addon?: {
+        id?: string;
+    };
+} | undefined>;

package/dist/extension/browsers/run-firefox/firefox-source-inspection/remote-firefox/addons.d.ts

@@ -0,0 +1 @@
+export declare function resolveAddonDirectory(baseDir: string, inputPath: string): string;

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

@@ -0,0 +1,18 @@
+interface RdpClientLike {
+    request: (payload: unknown) => Promise<unknown>;
+    getTargetFromDescriptor?: (descriptorId: 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 evaluate(client: RdpClientLike, tabId: string, expression: string): Promise<any>;
+export declare function evaluateRaw(client: RdpClientLike, tabId: string, expression: string): Promise<unknown>;
+export declare function coerceResponseToString(client: RdpClientLike, tabId: string, response: unknown, opts?: {
+    fallbackToFullDocument?: boolean;
+}): Promise<string>;
+export declare function resolveActorForEvaluation(client: RdpClientLike, descriptorActor: string, consoleActorHint?: string): Promise<string>;
+export declare function serializeDocument(client: RdpClientLike, actorToUse: string): Promise<string>;
+export declare function extractShadowContent(client: RdpClientLike, actorToUse: string): Promise<string>;
+export declare function mergeShadowIntoMain(mainHTML: string, shadowContent: string): string;
+export declare function getPageHTML(client: RdpClientLike, descriptorActor: string, consoleActorHint?: string): Promise<string>;
+export {};

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

@@ -0,0 +1,17 @@
+export declare function printRunningInDevelopmentSummary(candidateAddonPaths: string[], browser: 'firefox', extensionId?: string, browserVersionLine?: string): Promise<boolean>;
+export declare function printSourceInspection(html: string): void;
+export declare function printLogEventPretty(event: {
+    id: string;
+    timestamp: number;
+    level: string;
+    context: string;
+    messageParts: string[];
+    url: string;
+    tabId: number | undefined;
+}, color: boolean, colorFns: {
+    red: (s: string) => string;
+    yellow: (s: string) => string;
+    gray: (s: string) => string;
+    blue: (s: string) => string;
+}, showTs: boolean): void;
+export declare function printLogEventJson(event: unknown): void;

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

@@ -0,0 +1,38 @@
+import type { CompilationLike } from '../../../browsers-types';
+import { type PluginInterface } from '../../../browsers-types';
+import { type ContentScriptTargetRule } from '../../../browsers-lib/content-script-targets';
+export declare class RemoteFirefox {
+    private readonly options;
+    private needsReinstall;
+    private client;
+    private loggingAttached;
+    private cachedAddonsActor;
+    private cachedSupportsReload;
+    private lastInstalledAddonPath;
+    private derivedExtensionId;
+    private selectPrimaryAddonPath;
+    constructor(configOptions: PluginInterface & {
+        browserVersionLine?: string;
+    });
+    private resolveRdpPort;
+    private connectClient;
+    installAddons(compilation: CompilationLike): Promise<void>;
+    markNeedsReinstall(): void;
+    private ensureCapabilities;
+    private reloadAddonOrReinstall;
+    hardReloadIfNeeded(compilation: CompilationLike, changedAssets: string[]): Promise<void>;
+    reloadMatchingTabsForContentScripts(rules: ContentScriptTargetRule[]): Promise<number>;
+    inspectSource(compilation: CompilationLike, opts: {
+        startingUrl?: string;
+        source?: string | boolean;
+    }): Promise<void>;
+    enableUnifiedLogging(opts: {
+        level?: string;
+        contexts?: string[] | undefined;
+        urlFilter?: string | undefined;
+        tabFilter?: number | string | undefined;
+        format?: 'pretty' | 'json' | 'ndjson';
+        timestamps?: boolean;
+        color?: boolean;
+    }): Promise<void>;
+}

package/dist/extension/browsers/run-firefox/firefox-source-inspection/remote-firefox/logging.d.ts

@@ -0,0 +1,11 @@
+import { MessagingClient } from './messaging-client';
+export declare function attachConsoleListeners(client: MessagingClient): Promise<void>;
+export declare function subscribeUnifiedLogging(client: MessagingClient, opts: {
+    level?: string;
+    contexts?: string[] | undefined;
+    urlFilter?: string | undefined;
+    tabFilter?: string;
+    format?: 'pretty' | 'json' | 'ndjson';
+    timestamps?: boolean;
+    color?: boolean;
+}): void;

package/dist/extension/browsers/run-firefox/firefox-source-inspection/remote-firefox/message-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function requestErrorToMessage(error: unknown): string;
+export declare function isErrorWithCode(codeWanted: string | string[], error: unknown): boolean;

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

@@ -0,0 +1,42 @@
+import EventEmitter from 'events';
+export declare class MessagingClient extends EventEmitter {
+    private transport;
+    private forwardingSetup;
+    private lastPort;
+    private reconnecting;
+    private disconnectedByUser;
+    connect(port: number): Promise<void>;
+    disconnect(): void;
+    private attemptReconnect;
+    request(requestProps: unknown): Promise<unknown>;
+    onError(error: Error): void;
+    getTargets(): Promise<{
+        actor?: string;
+        url?: string;
+        consoleActor?: string;
+        webConsoleActor?: string;
+    }[]>;
+    navigate(tabId: string, url: string): Promise<void>;
+    attach(tabId: string): Promise<unknown>;
+    getTargetFromDescriptor(descriptorId: string): Promise<{
+        targetActor: string | undefined;
+        consoleActor: string | undefined;
+    } | {
+        targetActor?: undefined;
+        consoleActor?: undefined;
+    }>;
+    addTab(url: string): Promise<unknown>;
+    navigateViaScript(consoleActor: string, url: string): Promise<void>;
+    waitForPageReady(consoleActor: string, url: string, timeoutMs?: number): Promise<void>;
+    waitForLoadEvent(tabId: string): Promise<void>;
+    evaluate(tabId: string, expression: string): Promise<any>;
+    evaluateRaw(tabId: string, expression: string): Promise<unknown>;
+    private coerceResponseToString;
+    private resolveActorForEvaluation;
+    private serializeDocument;
+    private extractShadowContent;
+    private mergeShadowIntoMain;
+    private isDev;
+    getPageHTML(descriptorActor: string, consoleActorHint?: string): Promise<string>;
+    closeTab(tabId: string): Promise<void>;
+}

package/dist/extension/browsers/run-firefox/firefox-source-inspection/remote-firefox/moz-id.d.ts

@@ -0,0 +1,2 @@
+import { MessagingClient } from './messaging-client';
+export declare function deriveMozExtensionId(client: MessagingClient): Promise<string | undefined>;

package/dist/extension/browsers/run-firefox/firefox-source-inspection/remote-firefox/rdp-api.d.ts

@@ -0,0 +1,29 @@
+import { RdpTransport } from './transport';
+export declare function listTabs(transport: RdpTransport): Promise<{
+    actor?: string;
+    url?: string;
+    consoleActor?: string;
+    webConsoleActor?: string;
+}[]>;
+export declare function addTab(transport: RdpTransport, url: string): Promise<unknown>;
+export declare function navigate(transport: RdpTransport, tabId: string, url: string): Promise<void>;
+export declare function attach(transport: RdpTransport, tabId: string): Promise<unknown>;
+export declare function getTargetFromDescriptor(transport: RdpTransport, descriptorId: string): Promise<{
+    frame?: {
+        actor?: string;
+        consoleActor?: string;
+    };
+    actor?: string;
+    target?: {
+        actor?: string;
+        consoleActor?: string;
+    };
+    tab?: {
+        actor?: string;
+    } | string;
+    webConsoleActor?: string;
+    consoleActor?: string;
+}>;
+export declare function navigateViaScript(transport: RdpTransport, consoleActor: string, url: string): Promise<void>;
+export declare function waitForPageReady(transport: RdpTransport, consoleActor: string, url: string, timeoutMs?: number): Promise<void>;
+export declare function waitForLoadEvent(transport: RdpTransport, tabId: string): Promise<void>;

package/dist/extension/browsers/run-firefox/firefox-source-inspection/remote-firefox/rdp-wire.d.ts

@@ -0,0 +1,8 @@
+export interface RdpFrameParseResult<T = unknown> {
+    remainingData: Buffer;
+    parsedMessage?: T;
+    error?: Error;
+    fatal?: boolean;
+}
+export declare function parseRdpFrame<T = unknown>(data: Buffer): RdpFrameParseResult<T>;
+export declare function buildRdpFrame(obj: unknown): string;

package/dist/extension/browsers/run-firefox/firefox-source-inspection/remote-firefox/setup-firefox-inspection-actors.d.ts

@@ -0,0 +1,5 @@
+import { MessagingClient } from './messaging-client';
+export declare function selectActors(client: MessagingClient, urlToInspect: string): Promise<{
+    tabActor: string;
+    consoleActor: string;
+}>;

package/dist/extension/browsers/run-firefox/firefox-source-inspection/remote-firefox/setup-firefox-inspection-navigation.d.ts

@@ -0,0 +1,2 @@
+import { MessagingClient } from './messaging-client';
+export declare function ensureNavigatedAndLoaded(client: MessagingClient, urlToInspect: string, tabActor: string): Promise<void>;

package/dist/extension/browsers/run-firefox/firefox-source-inspection/remote-firefox/source-inspect.d.ts

@@ -0,0 +1,9 @@
+import { MessagingClient } from './messaging-client';
+export declare function ensureTabForUrl(client: MessagingClient, urlToInspect?: string): Promise<{
+    actor: string;
+    consoleActor?: string;
+} | null>;
+export declare function navigateTo(client: MessagingClient, tabActor: string, consoleActorHint: string | undefined, url: string): Promise<void>;
+export declare function getPageHTML(client: MessagingClient, descriptorActor: string, consoleActorHint?: string): Promise<any>;
+export declare function resolveConsoleActorMethod(client: MessagingClient, tabActor: string, urlToInspect: string): Promise<string>;
+export declare function waitForContentScriptInjectionMethod(client: MessagingClient, consoleActor: string): Promise<boolean>;

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

@@ -0,0 +1,20 @@
+import EventEmitter from 'events';
+export declare class RdpTransport extends EventEmitter {
+    private conn?;
+    private incoming;
+    private active;
+    private pending;
+    connect(port: number): Promise<void>;
+    disconnect(): void;
+    private rejectAll;
+    request(payload: any & {
+        to?: string;
+    }): Promise<unknown>;
+    private flush;
+    private expectReply;
+    private onData;
+    private readMessage;
+    private handleMessage;
+    private onEnd;
+    private onTimeout;
+}

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

@@ -0,0 +1,16 @@
+import type { PluginInterface } from '../browsers-types';
+import type { FirefoxRDPController } from './firefox-source-inspection/rdp-extension-controller';
+/**
+ * Narrowed plugin options used through the Firefox flow.
+ */
+export type FirefoxPluginLike = Pick<PluginInterface, 'extension' | 'browserFlags' | 'profile' | 'preferences' | 'startingUrl' | 'geckoBinary' | 'instanceId' | 'watchSource' | 'sourceFormat' | 'sourceSummary' | 'sourceMeta' | 'sourceProbe' | 'sourceTree' | 'sourceConsole' | 'sourceDom' | 'sourceMaxBytes' | 'sourceRedact' | 'sourceIncludeShadow' | 'sourceDiff' | 'port' | 'logLevel' | 'logContexts' | 'logFormat' | 'logTimestamps' | 'logColor' | 'logUrl' | 'logTab' | 'dryRun'> & {
+    browser: PluginInterface['browser'];
+    source?: string | boolean;
+};
+/**
+ * Runtime state in Firefox flow.
+ */
+export interface FirefoxPluginRuntime extends FirefoxPluginLike {
+    rdpController?: FirefoxRDPController;
+    browserVersionLine?: string;
+}

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

@@ -0,0 +1,14 @@
+import type { FirefoxContext } from '../firefox-context';
+/**
+ * FirefoxUnifiedLoggerPlugin
+ *
+ * Responsibilities:
+ * - Wait for RDP controller readiness; enable unified logging
+ * - Respect level/contexts/filters/format/timestamps/color
+ */
+export declare class FirefoxUnifiedLoggerPlugin {
+    private readonly options;
+    private readonly ctx;
+    constructor(options: FirefoxUnifiedLoggerPlugin['options'], ctx: FirefoxContext);
+    apply(_compiler: any): void;
+}

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

@@ -0,0 +1,22 @@
+import type { BrowserType } from './browsers-types';
+type PreviewRunOptions = {
+    browser: BrowserType;
+    outPath: string;
+    contextDir: string;
+    extensionsToLoad: string[];
+    noOpen?: boolean;
+    profile?: string | false;
+    persistProfile?: boolean;
+    preferences?: Record<string, unknown>;
+    browserFlags?: string[];
+    excludeBrowserFlags?: string[];
+    startingUrl?: string;
+    chromiumBinary?: string;
+    geckoBinary?: string;
+    instanceId?: string;
+    port?: number | string;
+    dryRun?: boolean;
+    readyPath?: string;
+};
+export declare function runOnlyPreviewBrowser(opts: PreviewRunOptions): Promise<void>;
+export {};

package/dist/extension/helpers/extension-develop-runtime.d.ts

@@ -0,0 +1,9 @@
+export declare function resolveExtensionDevelopRoot(startDir?: string): string;
+export declare function resolveExtensionDevelopVersion(startDir?: string, fallbackVersion?: string): string;
+export declare function loadExtensionDevelopModule<T = any>(startDir?: string): T;
+/**
+ * Load only the lightweight preview entry from extension-develop.
+ * This avoids pulling in rspack and the full build toolchain, making
+ * `extension preview` start significantly faster.
+ */
+export declare function loadExtensionDevelopPreviewModule<T = any>(startDir?: string): T;

package/dist/{utils.d.ts → extension/helpers/vendors.d.ts}

@@ -1,4 +1,3 @@
-export declare function resolveModuleEntry(modulePath: string, pkgJson: any): string | undefined;
 export type Browser = 'chrome' | 'edge' | 'firefox' | 'chromium' | 'chromium-based' | 'gecko-based' | 'firefox-based';
 export declare function parseOptionalBoolean(value?: string): boolean;
 export declare const vendors: (browser?: Browser | "all") => string[];

package/dist/extension/vitest.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;

package/package.json

@@ -4,7 +4,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/extension-js/extension.js.git",
-    "directory": "programs/cli"
+    "directory": "programs/extension"
   },
   "engines": {
     "node": ">=18"
@@ -15,6 +15,11 @@
       "import": "./dist/cli.cjs",
       "require": "./dist/cli.cjs"
     },
+    "./browsers": {
+      "types": "./dist/browsers.d.ts",
+      "import": "./dist/browsers.cjs",
+      "require": "./dist/browsers.cjs"
+    },
     "./types": {
       "types": "./types/index.d.ts"
     },
@@ -33,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "3.12.0",
+  "version": "3.12.2",
   "description": "Create cross-browser extensions with no build configuration.",
   "homepage": "https://extension.js.org/",
   "bugs": {
@@ -90,21 +95,26 @@
     "@types/chrome": "^0.1.33",
     "@types/node": "^25.2.0",
     "@types/webextension-polyfill": "0.12.4",
-    "extension-create": "3.12.0",
-    "extension-develop": "3.12.0",
-    "extension-install": "3.12.0",
+    "chrome-location2": "4.0.0",
+    "chromium-location": "2.0.0",
+    "cross-spawn": "^7.0.6",
+    "edge-location": "2.2.0",
+    "firefox-location2": "3.0.0",
+    "extension-create": "3.12.2",
+    "extension-develop": "3.12.2",
+    "extension-install": "3.12.2",
     "commander": "^14.0.3",
     "pintor": "0.3.0",
     "semver": "^7.7.3",
+    "unique-names-generator": "^4.7.1",
+    "ws": "^8.19.0",
     "update-check": "^1.5.4"
   },
   "devDependencies": {
     "@rslib/core": "^0.19.4",
-    "@types/react": "^19.2.8",
-    "@types/react-dom": "^19.2.3",
-    "@types/mock-fs": "^4.13.4",
+    "@types/cross-spawn": "^6.0.6",
     "@types/semver": "^7.7.1",
-    "mock-fs": "^5.5.0",
+    "@types/ws": "^8.18.1",
     "webextension-polyfill": "^0.12.0",
     "tsconfig": "*",
     "typescript": "6.0.2",

package/dist/cli-lib/extension-develop-runtime.d.ts

@@ -1,3 +0,0 @@
-export declare function resolveExtensionDevelopRoot(startDir?: string): string;
-export declare function resolveExtensionDevelopVersion(startDir?: string, fallbackVersion?: string): string;
-export declare function loadExtensionDevelopModule<T = any>(startDir?: string): T;