extension 3.4.0 → 3.4.1

package/bin/extension.cjs

@@ -26,15 +26,13 @@ if (fs.existsSync(distCjsEntry)) {
       {stdio: 'inherit'}
     )
     process.exit(result.status ?? 1)
-  } catch (error) {
-    // eslint-disable-next-line no-console
+  } catch {
     console.error(
       '[Extension.js] CLI not built. Run "pnpm --filter extension compile".'
     )
     process.exit(1)
   }
 } else {
-  // eslint-disable-next-line no-console
   console.error('[Extension.js] CLI entry not found.')
   process.exit(1)
 }

package/dist/cli.cjs

@@ -785,7 +785,7 @@ Cross-Browser Compatibility
                     source: devOptions.source,
                     watchSource: devOptions.watchSource,
                     install: devOptions.install,
-                    noRunner: devOptions.noRunner,
+                    noRunner: false === devOptions.runner,
                     logLevel: logsOption || devOptions.logLevel || 'off',
                     logContexts: parseLogContexts(logContextOption),
                     logFormat: devOptions.logFormat || 'pretty',
@@ -844,7 +844,7 @@ Cross-Browser Compatibility
                     startingUrl: startOptions.startingUrl,
                     port: startOptions.port,
                     install: startOptions.install,
-                    noRunner: startOptions.noRunner,
+                    noRunner: false === startOptions.runner,
                     source: 'string' == typeof startOptions.source ? startOptions.source : startOptions.source,
                     watchSource: startOptions.watchSource,
                     logLevel: logsOption || startOptions.logLevel || 'off',
@@ -906,7 +906,7 @@ Cross-Browser Compatibility
                     geckoBinary: previewOptions.geckoBinary,
                     startingUrl: previewOptions.startingUrl,
                     port: previewOptions.port,
-                    noRunner: previewOptions.noRunner,
+                    noRunner: false === previewOptions.runner,
                     source: 'string' == typeof previewOptions.source ? previewOptions.source : previewOptions.source,
                     watchSource: previewOptions.watchSource,
                     logLevel: logsOption || previewOptions.logLevel || 'off',

package/package.json

@@ -14,19 +14,26 @@
       "types": "./dist/cli.d.ts",
       "import": "./dist/cli.cjs",
       "require": "./dist/cli.cjs"
+    },
+    "./types": {
+      "types": "./types/index.d.ts"
+    },
+    "./types/polyfill": {
+      "types": "./types/polyfill.d.ts"
     }
   },
   "main": "./dist/cli.cjs",
   "types": "./dist/cli.d.ts",
   "files": [
     "dist",
-    "bin"
+    "bin",
+    "types"
   ],
   "bin": {
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "3.4.0",
+  "version": "3.4.1",
   "description": "Create cross-browser extensions with no build configuration.",
   "homepage": "https://extension.js.org/",
   "bugs": {
@@ -80,8 +87,11 @@
     "cli"
   ],
   "dependencies": {
-    "extension-create": "^3.4.0",
-    "extension-develop": "^3.4.0",
+    "@types/chrome": "^0.1.33",
+    "@types/node": "^25.0.9",
+    "@types/webextension-polyfill": "0.12.4",
+    "extension-create": "^3.4.1",
+    "extension-develop": "^3.4.1",
     "commander": "^14.0.2",
     "pintor": "0.3.0",
     "semver": "^7.7.3",
@@ -89,11 +99,8 @@
   },
   "devDependencies": {
     "@rslib/core": "^0.19.2",
-    "@types/chrome": "^0.1.33",
-    "@types/node": "^25.0.9",
     "@types/react": "^19.2.8",
     "@types/react-dom": "^19.2.3",
-    "@types/webextension-polyfill": "0.12.4",
     "@types/mock-fs": "^4.13.4",
     "@types/semver": "^7.7.1",
     "mock-fs": "^5.5.0",

package/types/index.d.ts

@@ -0,0 +1,121 @@
+// Required Extension.js types for TypeScript projects.
+// This file is published by the extension package.
+/// <reference types="node" />
+/// <reference types="chrome" />
+
+declare global {
+  // Align types with Extension.js runtime: we provide the browser global via
+  // webextension-polyfill in Chromium, and it's natively available in Firefox.
+  const browser: typeof import('webextension-polyfill')
+
+  type ExtensionBrowser =
+    | 'chrome'
+    | 'edge'
+    | 'firefox'
+    | 'chromium-based'
+    | 'gecko-based'
+
+  type ExtensionMode = 'development' | 'production'
+
+  interface ExtensionEnv {
+    EXTENSION_BROWSER: ExtensionBrowser
+    EXTENSION_MODE: ExtensionMode
+    EXTENSION_PUBLIC_BROWSER: ExtensionBrowser
+    EXTENSION_PUBLIC_MODE: ExtensionMode
+    EXTENSION_PUBLIC_DESCRIPTION_TEXT: string
+    EXTENSION_PUBLIC_LLM_API_KEY: string
+    EXTENSION_AUTHOR_MODE: string
+    EXTENSION_PUBLIC_AUTHOR_MODE: string
+  }
+
+  namespace NodeJS {
+    interface ProcessEnv extends ExtensionEnv {
+      [key: string]: string | undefined
+    }
+  }
+
+  interface ImportMetaEnv extends ExtensionEnv {
+    [key: string]: string | undefined
+  }
+
+  interface ImportMeta {
+    readonly env: ImportMetaEnv
+    readonly webpackHot?: {
+      accept: (module?: string | string[], callback?: () => void) => void
+      dispose: (callback: () => void) => void
+    }
+    url: string
+  }
+
+  interface Window {
+    /**
+     * @deprecated
+     * @description
+     * This is how Extension.js used to inject the shadow root into the window object.
+     * Use the shadowRoot reference from the content script instead.
+     */
+    __EXTENSION_SHADOW_ROOT__: ShadowRoot
+  }
+}
+
+// Asset imports (CSS modules + static images)
+type CSSContentData = Readonly<Record<string, string>>
+type CSSModuleData = Readonly<Record<string, string>>
+
+declare module '*.css' {
+  const content: CSSContentData
+  export default content
+}
+
+declare module '*.module.css' {
+  const content: CSSModuleData
+  export default content
+}
+declare module '*.module.scss' {
+  const content: CSSModuleData
+  export default content
+}
+declare module '*.module.sass' {
+  const content: CSSModuleData
+  export default content
+}
+
+declare module '*.png' {
+  const content: string
+  export default content
+}
+declare module '*.jpg' {
+  const content: string
+  export default content
+}
+declare module '*.jpeg' {
+  const content: string
+  export default content
+}
+declare module '*.gif' {
+  const content: string
+  export default content
+}
+declare module '*.webp' {
+  const content: string
+  export default content
+}
+declare module '*.avif' {
+  const content: string
+  export default content
+}
+declare module '*.ico' {
+  const content: string
+  export default content
+}
+declare module '*.bmp' {
+  const content: string
+  export default content
+}
+declare module '*.svg' {
+  // Use any to avoid conflicts with SVGR or other SVG loaders.
+  const content: any
+  export default content
+}
+
+export {}

package/types/polyfill.d.ts

@@ -0,0 +1,4 @@
+// Polyfill types for browser.* APIs
+/// <reference types="webextension-polyfill" />
+
+export {}