extension 4.1.18 → 4.1.20

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

@@ -29,143 +29,55 @@ export interface BrowserConfig {
     browserFlags: string[];
     startingUrl: string | undefined;
 }
-/**
- * List of default browser flags used by extension.js.
- * These can be excluded using the `excludeBrowserFlags` option.
- *
- * 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' | '--disable-features=DisableLoadExtensionCommandLineSwitch' | '--disable-features=ExtensionDisableUnsupportedDeveloper' | '--enable-unsafe-extension-debugging' | '--silent-debugger-extension-api';
-/**
- * Options for the browser plugin.
- */
 export interface PluginOptions {
     /**
-     * Launch the browser but open no tab, not even the starting URL.
      * @default false
      */
     noOpen?: boolean;
-    /**
-     * Additional browser flags to pass to the browser process.
-     * Example: ['--disable-extensions', '--disable-gpu']
-     */
     browserFlags?: string[];
-    /**
-     * Array of browser flags to exclude from the default set.
-     * Example: ['--hide-scrollbars', '--mute-audio']
-     */
     excludeBrowserFlags?: Array<DefaultBrowserFlags | string>;
-    /**
-     * Path to the browser profile directory, or false for a temporary profile.
-     * Example: 'dist/extension' or false
-     */
     profile?: string | false;
-    /**
-     * Use a persistent managed profile for development.
-     * Defaults to false (ephemeral temp profiles are used).
-     */
     persistProfile?: boolean;
-    /**
-     * Browser preferences object.
-     * Example: { extensions: ['dist/extension', 'dist/extension2'] }
-     */
     preferences?: Record<string, unknown>;
-    /**
-     * Firefox only: persist changes made to the profile directory.
-     */
     keepProfileChanges?: boolean;
-    /**
-     * Firefox only: copy an existing profile before launching.
-     */
     copyFromProfile?: string;
-    /**
-     * URL to open when the browser starts.
-     * Example: 'http://localhost:3000'
-     */
     startingUrl?: string;
     /**
-     * Enable the browser console.
      * @default false
      */
     browserConsole?: boolean;
     /**
-     * Open DevTools automatically.
      * @default false
      */
     devtools?: boolean;
-    /**
-     * Path to the Chromium binary.
-     * Example: '/path/to/chromium'
-     */
     chromiumBinary?: string;
-    /**
-     * Path to the Gecko (Firefox) binary.
-     * Example: '/path/to/gecko'
-     */
     geckoBinary?: string;
 }
-/**
- * Main interface for the browser plugin.
- */
 export interface PluginInterface extends PluginOptions {
     /**
-     * Browser type to launch.
      * @default 'chrome'
      * @see DevOptions['browser']
      * Example: 'chrome' | 'edge' | 'firefox'
      */
     browser: BrowserType;
-    /**
-     * Path(s) to the extension(s) to load.
-     * Example: 'dist/extension' or ['dist/extension', 'dist/extension2']
-     */
     extension: string | string[];
-    /**
-     * Port to use for the extension or debugging.
-     * Example: 12345 or '12345'
-     */
     port?: string | number;
-    /**
-     * Internal auto-generated instance ID (not user-configurable).
-     * Example: '1234567890'
-     */
     instanceId?: string;
-    /**
-     * Log level for unified logger (Chromium CDP logging).
-     * One of: 'off', 'error', 'warn', 'info', 'debug', 'trace', 'all'
-     */
     logLevel?: 'off' | 'error' | 'warn' | 'info' | 'debug' | 'trace' | 'all';
-    /**
-     * Log contexts to enable.
-     * Example: ['background', 'content', 'page']
-     */
     logContexts?: Array<'background' | 'content' | 'page' | 'sidebar' | 'popup' | 'options' | 'devtools'>;
-    /**
-     * Log output format.
-     * One of: 'pretty', 'json'
-     */
     logFormat?: 'pretty' | 'json' | 'ndjson';
     /**
-     * Include timestamps in logs.
      * @default true
      */
     logTimestamps?: boolean;
     /**
-     * Enable colored log output.
      * @default false
      */
     logColor?: boolean;
-    /**
-     * URL to send logs to.
-     * Example: 'http://localhost:3000'
-     */
     logUrl?: string;
-    /**
-     * Tab ID or index for logging context.
-     */
     logTab?: number | string;
     /**
-     * Perform a dry run without launching the browser.
      * @default false
      */
     dryRun?: boolean;
@@ -183,7 +95,6 @@ export interface BrowserLogSinkEvent {
     lineNumber?: number;
     timestamp?: number;
 }
-/** Host-provided sink for {@link BrowserLogSinkEvent}s. Must never throw. */
 export type BrowserLogSink = (event: BrowserLogSinkEvent) => void;
 export interface ExtensionLoadRetryResult {
     status: 'loaded' | 'refused' | 'unknown';

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

@@ -1,8 +1,5 @@
 import type { BrowserLogSink, BrowserType, ExtensionLoadRetryResult } from './browsers-types.js';
 export type { BrowserType, CompilationLike, Controller } from './browsers-types.js';
-/**
- * Options for launching a browser with an extension loaded.
- */
 export interface BrowserLaunchOptions {
     browser: BrowserType;
     outputPath: string;
@@ -31,24 +28,8 @@ export interface BrowserLaunchOptions {
     logColor?: boolean;
     logUrl?: string;
     logTab?: number | string;
-    /**
-     * Host log pipeline for browser-generated CDP `Log.entryAdded` entries
-     * (E21). Provided by the dev server so alarm clamps / CSP refusals land in
-     * logs.ndjson; Chromium-only (Firefox RDP exposes no equivalent stream).
-     */
     logSink?: BrowserLogSink;
 }
-/**
- * Handle returned by `launchBrowser`, provides logging control.
- *
- * Reload is owned by the dev server's control-bridge SW producer (the same
- * executor for launched + `--no-browser`), not this controller; the CDP/RDP
- * controller is kept only for unified logging.
- *
- * Browser process cleanup is owned by signal handlers installed during launch
- * (`setupFirefoxProcessHandlers` / Chromium equivalents). The controller is
- * deliberately not responsible for teardown, so there is no `close()`.
- */
 export type { ExtensionLoadRetryResult };
 export interface BrowserController {
     enableUnifiedLogging(opts: {
@@ -60,18 +41,9 @@ export interface BrowserController {
         urlFilter?: string;
         tabFilter?: number | string;
     }): Promise<void>;
-    /** The browser's refusal reason for this session, or null when it loaded. */
     getExtensionLoadRefusal?(): string | null;
-    /** Re-offer the current dist. Only ever called while the session is refused. */
     retryExtensionLoad?(): Promise<ExtensionLoadRetryResult>;
 }
-/**
- * Launch a browser with the given extension(s) loaded.
- *
- * Returns a `BrowserController` that provides unified-logging control.
- * This is the primary entry point for the CLI orchestration layer, it replaces
- * the old BrowsersPlugin that lived inside the bundler.
- */
 export declare function launchBrowser(opts: BrowserLaunchOptions): Promise<BrowserController>;
 export { runOnlyPreviewBrowser } from './run-only.js';
 export { packageSafariExtension, type SafariBuildPreflight, type SafariPackageResult, type SafariPipelineMode, safariBuildPreflight, safariPreflightError } from './run-safari/safari-launch/index.js';

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

@@ -1,8 +1,2 @@
 import type { CompilationLike } from '../../browsers-types.js';
-/**
- * Derive the user extension output path from `--load-extension=...` flags.
- *
- * Kept in a standalone module so run-only preview can reuse it without
- * importing CDP/WS-related code paths.
- */
 export declare function getExtensionOutputPath(compilation: CompilationLike | undefined, loadExtensionFlag: string | undefined): string;

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

@@ -3,15 +3,6 @@ import type { CompilationLike } from '../../browsers-types.js';
 import type { ChromiumContext } from '../chromium-context/index.js';
 import type { ChromiumLaunchOptions } from '../chromium-types.js';
 export { stampReadyBrowserExited };
-/**
- * ChromiumLaunchPlugin
- *
- * Intended responsibilities (will be wired incrementally without changing inner logic):
- * - Resolve binary; compose flags (profiles, excludes, overrides)
- * - Allocate CDP port; spawn process; setup signals; dry-run
- * - Connect CDP; ensure extension loaded; print dev banner
- * - Publish controller + port via ChromiumContext
- */
 export declare class ChromiumLaunchPlugin {
     private readonly options;
     private readonly ctx;

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

@@ -55,7 +55,6 @@ export interface ChromiumLogger {
     timestamps?: boolean;
     color?: boolean;
 }
-/** CDP `Target.TargetInfo`, the fields read off `Target.getTargets` results. */
 export interface CdpTargetInfo {
     type?: string;
     targetId?: string;
@@ -70,12 +69,10 @@ export interface CdpExecutionContextDescription {
         frameId?: string;
     };
 }
-/** A CDP `Runtime.RemoteObject` as seen in console-call args. */
 export interface CdpRemoteObject {
     value?: unknown;
     description?: string;
 }
-/** A CDP `Log.LogEntry` as delivered by `Log.entryAdded`. */
 export interface CdpLogEntry {
     source?: string;
     level?: string;
@@ -85,7 +82,6 @@ export interface CdpLogEntry {
     columnNumber?: number;
     timestamp?: number;
 }
-/** A CDP `Runtime.StackTrace`, only the top call frame fields are read. */
 export interface CdpStackTrace {
     callFrames?: Array<{
         url?: string;
@@ -93,7 +89,6 @@ export interface CdpStackTrace {
         columnNumber?: number;
     }>;
 }
-/** The `params` bag carried on a raw CDP protocol message. */
 export interface CdpProtocolParams {
     targetInfo?: CdpTargetInfo;
     context?: CdpExecutionContextDescription;
@@ -110,7 +105,6 @@ export interface CdpProtocolMessage {
     sessionId?: string;
     id?: number;
 }
-/** A CDP `DOM.Node` subtree as returned by `DOM.getDocument` (fields walked). */
 export interface CdpDomNode {
     localName?: string;
     nodeName?: string;
@@ -120,19 +114,16 @@ export interface CdpDomNode {
     children?: CdpDomNode[];
     contentDocument?: CdpDomNode;
 }
-/** A frame node read off a CDP `Page.getFrameTree` result. */
 export interface CdpFrameNode {
     id?: string;
     url?: string;
 }
-/** A CDP `Page.getFrameTree` result (only the frame id/url are read). */
 export interface CdpFrameTreeResult {
     frameTree?: {
         frame?: CdpFrameNode;
     };
     frame?: CdpFrameNode;
 }
-/** The console-count buckets keyed by normalized console level. */
 export type ConsoleCountKey = 'error' | 'warn' | 'info' | 'log' | 'debug';
 export type PageMetaSnapshot = {
     readyState?: string;
@@ -143,7 +134,6 @@ export type PageMetaSnapshot = {
     };
     frameCount?: number;
 };
-/** One selector-probe sample collected from the inspected page. */
 export interface SelectorProbeSample {
     tag: string;
     id?: string;
@@ -153,7 +143,6 @@ export interface SelectorProbeSample {
     textLength?: number;
     textSnippet?: string;
 }
-/** A single selector-probe result (selector + match count + samples). */
 export interface SelectorProbeResult {
     selector: string;
     count: number;

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

@@ -1,13 +1,8 @@
 import type { BrowserLogger } from '../../browsers-types.js';
 import type { SafariPluginLike } from '../safari-types.js';
 export declare function toolOutputTail(output: string): string;
+export declare function converterWarnings(output: string): string[];
 export type SafariPipelineMode = 'full' | 'resync';
-/**
- * What the pipeline resolved for this app. `bundleIdDerived` used to exist
- * only as a log line, which left a machine caller unable to learn that its
- * app carries a generated dev.extensionjs.* id shared with every project
- * built from the same source.
- */
 export interface SafariPackageResult {
     appName: string;
     bundleId: string;

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

@@ -1,34 +1,19 @@
 import type { BrowserLogger } from '../browsers-types.js';
 import { type SafariPackageResult, type SafariPipelineMode } from './safari-launch/index.js';
-/**
- * Identity overrides develop resolves per build (CLI flags merged with
- * `extension.config.js` `browser.safari`) and hands to the packager.
- */
 export interface SafariPackagerOverrides {
     appName?: string;
     bundleId?: string;
     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'. */
     browser?: 'safari' | 'webkit-based';
-    /** Print the dev identity card and ready line after the first full package. */
     announceDevReady?: boolean;
-    /** Skip opening the packaged app. Defaults to true: packaging is not launching. */
     noOpen?: boolean;
-    /** Print the commands instead of running them. */
     dryRun?: boolean;
     logger?: BrowserLogger;
 }
 export type SafariPackagerFn = (distPath: string, mode?: SafariPipelineMode, overrides?: SafariPackagerOverrides) => Promise<SafariPackageResult>;
-/**
- * Builds the `safariPackager` callback `extensionBuild`/`extensionDev` accept.
- * Without it a library caller that asks for `browser: 'safari'` gets a plain
- * dist and no app at all, because develop deliberately owns no Xcode code and
- * only packages when a packager is injected.
- */
 export declare function createSafariPackager(options?: SafariPackagerOptions): SafariPackagerFn;

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

@@ -14,7 +14,6 @@ export interface SafariBuildConfig {
     projectLocation: string;
     appName: string;
     bundleIdentifier: string;
-    /** True when the bundle id was derived (dev.extensionjs.*), not user-set. */
     bundleIdDerived: boolean;
     macOsOnly: boolean;
     language: 'swift' | 'objc';

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

@@ -14,12 +14,6 @@ interface ActResultLike {
         code?: unknown;
     };
 }
-/**
- * Wrap an act frame in the schema-1 envelope without dropping a key. `value`,
- * `truncated`, `error.name`, `error.engine`, `error.hint` and any verb
- * augmentation (`inspect --with-console` merges `console`) are what the MCP
- * reads today, so they keep their exact place.
- */
 export declare function buildActEnvelope(command: string, result: ActResultLike): Record<string, unknown>;
 export declare function registerActCommands(program: Command): void;
 export {};

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

@@ -14,13 +14,6 @@ export declare function resolveDoctorBrowser(projectPath: string | undefined, op
     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
- * gives on its own. Checks keep running past a failure wherever the answer
- * is still meaningful (a skip always names the check that blocked it, a
- * skip is NOT a pass).
- */
 export declare function runDoctor(projectPathArg: string | undefined, opts: DoctorOptions): Promise<DoctorCheckResult[]>;
 export declare function registerDoctorCommand(program: Command): void;
 export {};

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

@@ -21,18 +21,12 @@ export interface PublishInput {
     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;

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

@@ -1,19 +1,4 @@
 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/dist/extension/helpers/node-version-guard.d.ts

@@ -1,4 +1,7 @@
 export declare function isSupportedNodeVersion(version: string): boolean;
+export declare function isSupportedDenoVersion(version: string): boolean;
 export declare function detectBunVersion(versions?: NodeJS.ProcessVersions): string | undefined;
+export declare function detectDenoVersion(versions?: NodeJS.ProcessVersions): string | undefined;
+export declare function unsupportedDenoVersionMessage(version: string): string;
 export declare function unsupportedNodeVersionMessage(version: string, bunVersion?: string): string;
-export declare function enforceSupportedNodeVersion(version?: string, bunVersion?: string | undefined): void;
+export declare function enforceSupportedNodeVersion(version?: string, bunVersion?: string | undefined, denoVersion?: string | undefined): void;

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

@@ -1,6 +1,6 @@
 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/e552f6db6f2862093ba9d7026e0d376f002d95cc/examples";
+export declare const TEMPLATE_CATALOG_URL = "https://github.com/extension-js/examples/tree/39448a235ea1b02516e6d555bcae409db2258b7f/examples";
 export interface TemplateGroup {
     title: string;
     summary: string;

package/dist/extension/helpers/template-corpus.generated.d.ts

@@ -1,3 +1,3 @@
 export declare const TEMPLATE_CORPUS_REPO = "extension-js/examples";
-export declare const TEMPLATE_CORPUS_REF = "e552f6db6f2862093ba9d7026e0d376f002d95cc";
+export declare const TEMPLATE_CORPUS_REF = "39448a235ea1b02516e6d555bcae409db2258b7f";
 export declare const TEMPLATE_CORPUS_SLUGS: readonly string[];

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

@@ -2,6 +2,7 @@ export type Browser = 'chrome' | 'edge' | 'firefox' | 'chromium' | 'chromium-bas
 export declare function isSafariVendor(value: string): boolean;
 export declare const SUPPORTED_BROWSER_TARGETS: string[];
 export declare const BROWSER_TARGETS_HELP: 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;
 export declare const vendors: (browser?: Browser | 'all') => string[];

package/package.json

@@ -38,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "4.1.18",
+  "version": "4.1.20",
   "description": "The cross-browser extension framework. Build Chrome, Edge, Firefox, and Safari extensions with no build configuration.",
   "homepage": "https://extension.js.org/",
   "bugs": {
@@ -106,24 +106,24 @@
     "vivaldi-location2": "2.1.1",
     "waterfox-location": "2.1.1",
     "yandex-location": "2.1.1",
-    "extension-create": "4.1.18",
-    "extension-develop": "4.1.18",
-    "extension-install": "4.1.18",
+    "extension-create": "4.1.20",
+    "extension-develop": "4.1.20",
+    "extension-install": "4.1.20",
     "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",
-    "wsl-support": "0.1.0"
+    "wsl-support": "0.1.0",
+    "@types/chrome": "*",
+    "@types/node": "*",
+    "@types/webextension-polyfill": "*"
   },
   "devDependencies": {
     "@rslib/core": "^1.0.0",
-    "@types/chrome": "^0.1.33",
     "@types/cross-spawn": "^6.0.6",
-    "@types/node": "^26",
     "@types/semver": "^7.7.1",
-    "@types/webextension-polyfill": "0.12.4",
     "@types/ws": "^8.18.1",
     "webextension-polyfill": "^0.12.0",
     "tsconfig": "*",