Skip to content

4.1.31 (October 4, 2026)

Choose a tag to compare

@github-actions github-actions released this 04 Oct 13:13
· 364 commits to main since this release
  • One sidebar or toolbar key builds for every browser. Declare the Chrome side panel and Firefox gets a working sidebar, declare the Firefox sidebar and Chrome and Edge get the side panel, and the Firefox Manifest V2 recipe gets its toolbar button back. The build translates side_panel, sidebar_action and action to the key each browser reads and says so in one line.
  • Zip archives moved, so check your CI paths. extension build --zip writes beside the browser folder as dist/<name>-<version>-<browser>.zip instead of inside dist/<browser>/. --zip-filename=release writes dist/release-chrome.zip, and adding --zip-source writes one dist/release-source.zip, so two browsers built with the same name never write over each other.
  • The dev server answers only the hosts it knows. A request under another name, like a Docker service, a tunnel or a .local address, gets a 403 that names the fix: extension dev --allowed-hosts web,.ngrok.app, or commands.dev.allowedHosts in the config.
  • Dev says what it really loaded. A changed .env restarts the session with the new value and an edited extension.config.js asks for a restart instead of printing success. A browser that never started or quit early marks ready.json as an error and --wait exits non-zero. extension dev <github url> builds only a folder it downloaded itself and leaves a same-named folder of yours untouched.

Features

  • Add the examples catalog nightly lane and typecheck every spec (#766) (73e50b93e)
  • Add configResolved, a folders key, define typings and ?raw (#671) (9e9b43b9f)
  • Add a define option, a manifest entry and whole locale trees (#665) (f8966b2e2)

Fixes

  • Resolve the Sass and Less loaders to absolute paths (#770) (9451400b5)
  • Restore the CLI contracts scripts relied on at 4.1.30 (#764) (715cc6455)
  • Resolve a remote source to a tree this tool actually fetched (#759) (11a99f545)
  • Restore the browser launch and project layouts 4.1.30 accepted (#762) (e4dc4d06b)
  • Stop a dev session reporting success for a change it ignored (#758) (d1a0f04d6)
  • Stop shipping dev reload scaffolding and duplicate bundles (#755) (fd29e7077)
  • Resolve locales per browser and accept _locales inside public (#729) (eb7540873)
  • Stop telemetry from swallowing crashes and reprinting the notice (#723) (e45a8b734)
  • Harden the dev server HTTP surface, port probe and emulator route (#722) (7e30f06ca)
  • Stop the dev log relay from posing as the extension's devtools port (#720) (4363bc925)
  • Guard cache groups and runtimeChunk, background.page is a page (#704) (d4fe9f6a2)
  • Sweep only staging dirs whose owning build is gone (#681) (2454a9afa)
  • Resolve root-owned web accessible resources at their root path (#666) (f556fd007)
  • Fix the companion scan, unpacked preview and permission warnings (#664) (dab685f9d)
  • Fix CSS module, JSON, extra entry and Vue loader defaults (#663) (33064f0fb)
Other changes (94)
  • Stamp a silent pin on the contract and bound create fetches (#778) (3a204a144)
  • Keep thrown values out of the emulator file index error body (#777) (2d7f7d67e)
  • Bound version probes and align remote and override failures (#776) (97f6cfca7)
  • Let configResolved set minimize, fix folders off and command types (#774) (4bbb683a0)
  • Give launch, remote archive and startup failures one coded frame (#775) (03b1680ff)
  • Refuse a non-ZIP template URL, frame a preview launch failure (#773) (7c038f977)
  • Write the 4.1.31 release highlights (#772) (872fccefe)
  • Stamp a browser that never spawned on the ready contract (#771) (9cb3da42a)
  • Replace the dead cli gate with a guard, type manifest_version (#769) (89e18a657)
  • Verify managed installs, withhold ready once the browser is gone (#767) (7b648717a)
  • Keep raw imports, typeless configs, PostCSS order and asset types (#768) (0055752e8)
  • Pin the template corpus to the pruned examples tree (#765) (d4a591852)
  • Keep dev hosts, env ignores, force kill and preview as before (#763) (0c1d95631)
  • Build Solid, Vue 2 and custom config projects that 4.1.30 built (#761) (5d1a3b09e)
  • Keep projects that built on 4.1.30 building with the same output (#760) (73076a546)
  • Scaffold what the user asked for and name why a create refused (#756) (51e5fc8ce)
  • Translate sidebar and toolbar keys to the name each browser reads (#757) (7ac518023)
  • Handle a dead CDP pipe instead of reporting a dev server fault (#754) (bc9b4b15a)
  • Refuse a managed binary an interrupted download left behind (#753) (40e31d7f1)
  • Wait for the state these bridge tests assert, not for a stopwatch (#752) (a0853e5fb)
  • Trust the install over the folder label, and name the collision (#751) (f279e5fd3)
  • Reach an idled Firefox event page over the protocol (#750) (81de79724)
  • Evaluate a config where it lives instead of a temp copy (#749) (d78394685)
  • Say what a --wait failure was instead of printing a stack trace (#747) (cc074f896)
  • Make a requested zip exist or fail the build (#748) (d494fc6e1)
  • Point a built page at the public files it actually ships (#746) (1258a32f8)
  • Say what a preview run resolved on every output path (#745) (ddb5010ef)
  • Refuse a preview the browser will not load (#744) (5bb6e5812)
  • Prove a spec install stayed offline instead of trusting an env pin (#742) (3cea81ce7)
  • Name the dev server, session and port refusals the table promised (#741) (f567c630b)
  • Give a headless session a page and name the browser it launched (#740) (e36e8da74)
  • Evaluate a CSP-locked Gecko extension document over the protocol (#739) (6efc0f9cf)
  • Delete a dead block-form @ts-nocheck and guard against its return (#738) (d0f46588b)
  • Typecheck the specs and fail a mock that drops a class method (#736) (f220a46e5)
  • Serve the template catalog locally in the required gates (#735) (157142f92)
  • Name the project and manifest refusals the error table promised (#737) (b649293bf)
  • Keep a runtime-registered MAIN world script out of the dev runtime (#734) (481cf2dd0)
  • Compile node_modules sources and .cts, merge loader options (#733) (e41d5fe5a)
  • Read every PostCSS config spelling and URL() as url() (#731) (7eea55388)
  • Confirm a full reload only when the worker acks it (#730) (7f916c144)
  • Keep dev permissions Safari-safe and drop a dead management grant (#732) (9ec741051)
  • Normalize MV2-spelled keys that an MV3 build silently drops (#728) (7ebb90a3a)
  • Stamp the control port bind failure into the ready contract (#727) (6939588a8)
  • Refuse create failures with one frame and a clean directory (#725) (2ccf785ad)
  • Decide doctor checks on live evidence and name the session (#726) (8ac782844)
  • Fail a crashed dev session, cap its event log, scope its stamps (#724) (d6be17a6b)
  • Confirm reload delivery and report a control port that cannot bind (#721) (f969b8e57)
  • Refuse the open gesture only on Chromium, not every Gecko fork (#719) (f4810c0a2)
  • Publish with the npm bundled in Node 24 and drop the tool lockfile (#717) (d8ea8bc59)
  • Bump brace-expansion, fast-uri and devalue past their advisories (#715) (393d36304)
  • Pass TMPDIR through turbo so tasks and direct runs agree (#716) (9f9f10193)
  • Keep Babel on 7 until the Solid preset accepts Babel 8 (#714) (e55168425)
  • Bump github/codeql-action to 4.38.2 across every workflow (#713) (06c13b65e)
  • Adopt a project root only when it owns the manifest (#712) (57996cdb0)
  • Scope the session ignore file and drop a dead preview option (#711) (1e04a461a)
  • Route unsolicited RDP packets apart and close the client on exit (#710) (0c782db46)
  • Make dev content script registrations shrink, heal and stamp CSS (#709) (fd5c9c066)
  • Honor nested gitignore rules in the source zip on Windows (#708) (a6ace9409)
  • Strip types before Svelte compiles a .svelte.ts rune module (#706) (3c0c90747)
  • Give the Safari build the same config layers and gates as dev (#705) (a9bc73af8)
  • Warn when a build uses the browser global without the polyfill (#703) (4c965a588)
  • Fail the postcompile on a stale companion and vacuous smoke runs (#702) (efce2231a)
  • Report ring overflow once, fail commands when the executor leaves (#701) (d0362772a)
  • Never adopt a companion manifest as the project's own (#700) (73d22701b)
  • Record the Firefox store check outcome and say when it failed (#699) (f83f132ca)
  • Refuse unknown log filters and report dropped log events (#698) (0c6e0aa8b)
  • Budget every surface the build emits, shared chunk included (#697) (58becb4b4)
  • Declare every asset import once with scss, less, raw and url (#696) (2e2b3c6a9)
  • Make publish refuse a reply without a link and code its refusals (#695) (d9bc703c3)
  • Keep install JSON output clean and emit the declared codes (#694) (1f7f1dc55)
  • Watch the configured special folders with the scan's own rules (#693) (14ca0c67b)
  • Compile Solid JSX in plain js and ts files through babel (#692) (9e9ca24e2)
  • Keep the shared control token mirror from naming another browser (#691) (a94df23cf)
  • Frame build refusals as JSON and validate numeric act flags (#690) (e268da772)
  • Name why the browser quit when a preview or dev session loses it (#689) (c16fff268)
  • Name the field for folder icon refs and mistyped manifest values (#688) (95f3a6d41)
  • Detect Chromium profile locks and keep user profiles intact (#687) (19df348a3)
  • Treat build receipts as no session and report unread peers (#686) (24de2d7e1)
  • Escape env values for the JSON and HTML assets they land in (#683) (eba55af67)
  • Emit both pages when paired sidebar or toolbar keys differ (#682) (d27904306)
  • Replay script injections only into the tab page they targeted (#680) (bd7a80e9a)
  • Drop the bare registerCleanup global and count reinjects (#679) (130188b17)
  • Make the test matrix, telemetry and Safari lanes assert real work (#707) (714c80c3f)
  • Keep env templates tracked and print create failures once (#678) (d9690d412)
  • Keep the ready contract alive across a dev restart (#677) (02cfacead)
  • Keep build output out of the source zip and name it from dist (#676) (df97b2745)
  • Find the config the managed-dependency guard scans (#675) (6f91e63bc)
  • Preview a build archive where it landed, with no build advice (#674) (7d673e081)
  • Compile MAIN world content scripts apart from the HMR runtime (#673) (087ad6ced)
  • Compile Solid, refuse Vue 2, check Rspack peers, add fallbacks (#672) (f8cd06f43)
  • Keep the refresh runtime and DOM patches out of content scripts (#670) (07c3f5851)
  • Write the zip beside the browser folder, quiet vendor key siblings (#669) (9dc338e05)
  • Ship files named only in code and keep nested manifests quiet (#668) (081c9a145)
  • Serve manifest pages and icons from the project public folder (#662) (dbc7db2e5)