extension 4.1.35 → 4.1.36

package/dist/extension/browsers/__spec__/safari-fake-tools.d.ts

@@ -20,6 +20,10 @@ export interface FakeSafariToolsOptions {
     };
     automationMatch?: string;
     appMatch?: string;
+    codesign?: {
+        output: string;
+    };
+    xcodeTeams?: string;
 }
 export interface FakeSafariTools extends SafariPipelineTools {
     calls: {
@@ -30,6 +34,8 @@ export interface FakeSafariTools extends SafariPipelineTools {
         resolvePid: string[];
         pluginkit: number;
         webdriver: number[];
+        codesign: string[];
+        xcodeTeams: number;
     };
     webdriverProcesses: SafariWebDriverProcess[];
     events: string[];

package/dist/extension/browsers/browsers-lib/companion-session.d.ts

@@ -1,6 +1,7 @@
 export declare const COMPANION_SESSION_FLAGS_FILE = "extension-js-session.json";
 export interface CompanionSessionFlags {
     noOpen: boolean;
+    startingUrl: boolean;
 }
 export declare function isDevtoolsCompanionPath(extensionPath: string): boolean;
 export declare function companionPathsForCdpLoad(extensionPaths: string[], outPath: string): string[];
@@ -8,6 +9,7 @@ export declare function stagedCompanionPath(stageRoot: string, companionPath: st
 export declare function stageCompanionForSession(input: {
     extensionPaths: string[];
     noOpen?: boolean;
+    startingUrl?: boolean;
     browser?: string;
     stageRoot?: string;
     provision?: boolean;

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

@@ -75,6 +75,13 @@ export type SystemProfileSource = {
 export declare function geckoSystemProfileRefused(browser: Browser, sources: SystemProfileSource[]): string;
 export declare function browserStderrTail(browser: Browser, lines: string[]): string;
 export declare function browserGoneBeforeReady(browser: Browser): string;
+export declare function browserUpNotAttached(opts: {
+    browser: Browser;
+    browserPid?: number;
+    profilePath?: string;
+    profileReused: boolean;
+    waitedMs: number;
+}): string;
 export declare function chromeProcessError(error: unknown): string;
 export declare function chromeFailedToSpawn(error: unknown): string;
 export declare function chromeInitializingEnhancedReload(browser: Browser): string;
@@ -103,14 +110,30 @@ export declare function safariConverted(projectDir: string): string;
 export declare function safariBuilding(scheme: string): string;
 export declare function safariBuilt(appPath: string): string;
 export declare function safariOpening(target: string): string;
-export declare function safariToolFailed(tool: string, exitCode: number | null, outputTail: string): string;
+export declare function safariToolFailed(tool: string, exitCode: number | null, outputTail: string, cause?: string): string;
+export interface SafariKnownTeam {
+    id: string;
+    name: string | null;
+}
+export declare function safariTeamRemedyLines(team: string, knownTeams?: SafariKnownTeam[]): string[];
+export declare function safariNoAccountForTeam(team: string, knownTeams?: SafariKnownTeam[]): string;
+export interface SafariSigningNote {
+    team?: string | null;
+    requestedTeam?: string;
+    noAccount?: boolean;
+    knownTeams?: SafariKnownTeam[];
+}
 export declare function safariConverterWarnings(warnings: string[]): string;
 export declare function safariDefaultBundleIdNote(bundleId: string): string;
 export declare function safariOpenHint(appPath: string, appName: string): string;
 export declare function safariDryRunNotBuilding(): string;
 export declare function safariDryRunConverter(cmd: string): string;
 export declare function safariDryRunXcodebuild(cmd: string): string;
-export declare function safariNextSteps(appName: string, signed?: boolean): string;
+export declare const SAFARI_AD_HOC_LOADING = "Safari runs an ad-hoc build only while unsigned extensions are allowed, and Safari turns that off at quit";
+export declare const SAFARI_TEAM_SIGNED_LOADING = "A team-signed build needs no toggle, and the Apple Development certificate of an Xcode account signed in on this Mac is enough for local runs, no Developer ID needed";
+export declare const SAFARI_DEVELOPMENT_TEAM_HELP: string;
+export declare function safariNextSteps(appName: string, signed?: boolean, signing?: SafariSigningNote): string;
+export declare function safariSigningChanged(appName: string, before: string, after: string): string;
 export declare function safariEnableStep(step: string, before: string | null, after: string | null, detail?: string): string;
 export declare function safariEnabled(appName: string, otherWebsites: string | null): string;
 export declare function safariEnableIncomplete(appName: string, reason: string): string;
@@ -126,7 +149,6 @@ export declare function safariForcedRegeneration(): string;
 export declare function safariRegenerationDiscards(preservedKeys: string[]): string;
 export declare function safariSettingsPreserved(keys: string[]): string;
 export declare function safariBuildUpToDate(): string;
-export declare function safariStorageReset(appName: string): string;
 export declare function safariSkippingConversion(): string;
 export declare function cdpClientFoundTargets(count: number): string;
 export declare function cdpClientTargetWebSocketUrlStored(): string;

package/dist/extension/browsers/browsers-lib/ready-stamp.d.ts

@@ -15,6 +15,12 @@ export declare function stampReadyBrowserLaunch(extensionOutputPath: string | un
     extensionId?: string;
     binary?: string;
     binaryProvenance?: 'managed' | 'pinned' | 'system' | 'snapshot';
+    profileReused?: boolean;
+}, runId?: string): void;
+export declare function readReadyExecutorAttached(extensionOutputPath: string | undefined, runId?: string): boolean;
+export declare function stampReadyBrowserUpNotAttached(extensionOutputPath: string | undefined, details: {
+    waitedMs: number;
+    hint: string;
 }, runId?: string): void;
 export declare function describeLaunchFailure(error: unknown): string;
 export declare function stampReadyBrowserLaunchFailed(extensionOutputPath: string | undefined, reason: string, runId?: string, errorCode?: string): void;

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

@@ -1,5 +1,7 @@
 import type { CompilationLike, DefaultBrowserFlags, PluginInterface } from '../../browsers-types.js';
 export declare const DEFAULT_BROWSER_FLAGS: DefaultBrowserFlags[];
+export declare const HEADLESS_ONLY_BROWSER_FLAGS: string[];
+export declare function applyLaunchModeFlags(flags: string[], excludeFlags?: string[]): string[];
 export declare function getChromiumMasterPreferences(browser: PluginInterface['browser']): Record<string, unknown>;
 export interface BrowserConfigMode {
     provision?: boolean;

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

@@ -12,6 +12,8 @@ export declare class ChromiumLaunchPlugin {
     private readonly ctx;
     private didLaunch;
     private didReportReady;
+    private readyDeferred;
+    private profileReused;
     private browserGone;
     private didSpawn;
     private extensionLoadRefused;
@@ -28,6 +30,15 @@ export declare class ChromiumLaunchPlugin {
     private stampCdpFault;
     apply(compiler: unknown): void;
     private launchChromium;
+    reportReadyWhenAttached(opts: {
+        compilation: CompilationLike;
+        enableCdp: boolean;
+        reportReady: () => void;
+        browserPid?: number;
+        profilePath?: string;
+        graceMs?: number;
+        pollMs?: number;
+    }): Promise<void>;
     private waitForBrowserGone;
     private printDryRunPlan;
     private launchWithDirectSpawn;

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

@@ -0,0 +1,18 @@
+import type { SafariBuildConfig } from '../safari-types.js';
+export interface SafariCodeSignature {
+    signed: boolean;
+    team: string | null;
+}
+export declare const ADHOC_SIGNATURE = "adhoc";
+export declare function parseCodeSignature(output: string): SafariCodeSignature;
+export declare function signatureKey(signature: SafariCodeSignature): string;
+export declare function describeSignature(key: string | null): string;
+export declare function noAccountForTeam(output: string): string | null;
+export interface XcodeTeam {
+    id: string;
+    name: string | null;
+}
+export declare function parseXcodeTeams(output: string): XcodeTeam[];
+export declare function signatureRecordPath(config: SafariBuildConfig): string;
+export declare function readSignatureRecord(config: SafariBuildConfig): string | null;
+export declare function saveSignatureRecord(config: SafariBuildConfig, signature: SafariCodeSignature): void;

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

@@ -22,6 +22,8 @@ export interface SafariPipelineTools {
     startWebDriver(port: number): Promise<SafariWebDriverProcess>;
     listAutomationPids(): Promise<number[]>;
     listAppPids(appPath: string): Promise<number[]>;
+    readCodeSignature(appPath: string): Promise<SafariToolResult>;
+    readXcodeTeams(): Promise<string>;
 }
 export declare function isAutomationSafariArgs(args: string): boolean;
 export declare function isContainerAppArgs(appPath: string, args: string): boolean;

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

@@ -1,4 +1,6 @@
 import type { SafariPipelineTools } from './tools.js';
+export declare const WEBDRIVER_NOT_ASKED_YET = "the launcher has not asked safaridriver for a session yet: it opens the app and enables the extension first, then asks, and this line is replaced by the session or by the reason it got none";
+export declare const WEBDRIVER_SESSION_PENDING = "the launcher is asking safaridriver for a session now: the request alone waits up to 30 s, and this line is replaced by the session or by the reason it got none";
 export interface SafariWebDriverSession {
     port: number;
     sessionId: string;

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

@@ -113,6 +113,7 @@ export declare const CODES: {
     readonly E_LOCALES_LAYOUT: 'E_LOCALES_LAYOUT';
     readonly E_WAR_INVALID: 'E_WAR_INVALID';
     readonly E_DEV_SESSION_DIST_SHARED: 'E_DEV_SESSION_DIST_SHARED';
+    readonly E_PROD_LOOPBACK_ORIGIN: 'E_PROD_LOOPBACK_ORIGIN';
     readonly E_BACKGROUND_REQUIRED: 'E_BACKGROUND_REQUIRED';
     readonly E_CONTENT_SCRIPT_SYNTAX: 'E_CONTENT_SCRIPT_SYNTAX';
     readonly E_NO_ENTRYPOINTS: 'E_NO_ENTRYPOINTS';

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/4753cbd121dac8784f4cb5c515b773f87ebff3b4/examples";
+export declare const TEMPLATE_CATALOG_URL = "https://github.com/extension-js/examples/tree/6443985200d0a27526662fc7be5d13fe66a0fa2b/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 = "4753cbd121dac8784f4cb5c515b773f87ebff3b4";
+export declare const TEMPLATE_CORPUS_REF = "6443985200d0a27526662fc7be5d13fe66a0fa2b";
 export declare const TEMPLATE_CORPUS_SLUGS: readonly string[];

package/package.json

@@ -38,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "4.1.35",
+  "version": "4.1.36",
   "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",
@@ -104,9 +104,9 @@
     "chromium-location": "2.1.2",
     "commander": "^15.0.0",
     "edge-location": "2.3.1",
-    "extension-create": "4.1.35",
-    "extension-develop": "4.1.35",
-    "extension-install": "4.1.35",
+    "extension-create": "4.1.36",
+    "extension-develop": "4.1.36",
+    "extension-install": "4.1.36",
     "firefox-location2": "3.2.0",
     "floorp-location": "1.0.0",
     "librewolf-location": "1.2.1",

package/types/index.d.ts

@@ -9,12 +9,27 @@ declare global {
   // webextension-polyfill in Chromium; Firefox and Safari ship it natively.
   const browser: typeof import('webextension-polyfill')
 
+  // Every target the CLI accepts for --browser, so a branch on
+  // process.env.EXTENSION_PUBLIC_BROWSER typechecks for each of them.
   type ExtensionBrowser =
     | 'chrome'
     | 'edge'
     | 'firefox'
+    | 'chromium'
+    | 'brave'
+    | 'opera'
+    | 'vivaldi'
+    | 'yandex'
+    | 'waterfox'
+    | 'librewolf'
+    | 'zen'
+    | 'floorp'
     | 'chromium-based'
     | 'gecko-based'
+    | 'firefox-based'
+    | 'safari'
+    | 'webkit-based'
+    | 'chromium-emulator'
 
   type ExtensionMode = 'development' | 'production'