From d72ee17786a6624e1e547d9fb6a7d58924272398 Mon Sep 17 00:00:00 2001
From: Chris Harvey <1362083+chharvey@users.noreply.github.com>
Date: Wed, 29 Jul 2026 20:58:53 -0400
Subject: [PATCH 1/3] feat!: merge `Module['readBinaryWithFeatures']` into
 `Module['readBinary']`

---
 src/js/binaryen.js-post.js       | 19 ++++++-------------
 test/binaryen.js/kitchen-sink.js |  4 ++--
 2 files changed, 8 insertions(+), 15 deletions(-)

diff --git a/src/js/binaryen.js-post.js b/src/js/binaryen.js-post.js
index c9f78b153f3..9551a655fc6 100644
--- a/src/js/binaryen.js-post.js
+++ b/src/js/binaryen.js-post.js
@@ -3368,30 +3368,23 @@ function handleFatalError(func) {
   }
 }
 
-// Parses a binary to a module
-
 // If building with Emscripten ASSERTIONS, there is a property added to
 // Module to guard against users mistakening using the removed readBinary()
 // API. We must defuse that carefully.
 Object.defineProperty(Module, 'readBinary', { writable: true });
 
-Module['readBinary'] = function(data) {
-  const buffer = _malloc(data.length);
-  HEAP8.set(data, buffer);
-  const ptr = handleFatalError(() => Module['_BinaryenModuleRead'](buffer, data.length));
-  _free(buffer);
-  return wrapModule(ptr);
-};
-
-Module['readBinaryWithFeatures'] = function(data, features) {
+// Parses a binary to a module with the given feature set enabled. `features` defaults to MVP.
+Module['readBinary'] = function(data, features) {
   const buffer = _malloc(data.length);
   HEAP8.set(data, buffer);
-  const ptr = handleFatalError(() => Module['_BinaryenModuleReadWithFeatures'](buffer, data.length, features));
+  const ptr = features === undefined
+    ? handleFatalError(() => Module['_BinaryenModuleRead'](buffer, data.length))
+    : handleFatalError(() => Module['_BinaryenModuleReadWithFeatures'](buffer, data.length, features));
   _free(buffer);
   return wrapModule(ptr);
 };
 
-// Parses text format to a module with the given feature set enabled.
+// Parses text format to a module with the given feature set enabled. `features` defaults to MVP.
 Module['parseText'] = function(text, features) {
   const buffer = _malloc(text.length + 1);
   stringToAscii(text, buffer);
diff --git a/test/binaryen.js/kitchen-sink.js b/test/binaryen.js/kitchen-sink.js
index 6baea5157fd..0d4c158e66e 100644
--- a/test/binaryen.js/kitchen-sink.js
+++ b/test/binaryen.js/kitchen-sink.js
@@ -1059,14 +1059,14 @@ function test_binaries_with_features() {
   binaryen.setDebugInfo(false);
   module.dispose();
 
-  module = binaryen.readBinaryWithFeatures(buffer, features);
+  module = binaryen.readBinary(buffer, features);
 
   assert(module.validate());
   console.log("module loaded from binary with features:");
   console.log(module.emitText());
   module.dispose();
 
-  module = binaryen.readBinaryWithFeatures(buffer, binaryen.Features.MVP);
+  module = binaryen.readBinary(buffer, binaryen.Features.MVP);
   assert(!module.validate());
   module.dispose();
 }

From e407c8356eda8648e2d5d2758b8df24323685045 Mon Sep 17 00:00:00 2001
From: Chris Harvey <1362083+chharvey@users.noreply.github.com>
Date: Wed, 29 Jul 2026 21:02:35 -0400
Subject: [PATCH 2/3] docs: update CHANGELOG

---
 CHANGELOG.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8f40d88d796..67dfc4a96d0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -15,6 +15,9 @@ full changeset diff at the end of each section.
 Current Trunk
 -------------
 
+- [JS API] support `BinaryenStringConst` (#8951)
+- [JS API] Merge `Module['readBinaryWithFeatures']` into `Module['readBinary']`
+
 v131
 ----
 

From 0ed6c415ba74cd7ee6ead337491421a3e3d5e8fb Mon Sep 17 00:00:00 2001
From: Chris Harvey <1362083+chharvey@users.noreply.github.com>
Date: Thu, 30 Jul 2026 12:58:39 -0400
Subject: [PATCH 3/3] docs: clarify CHANGELOG verbiage

---
 CHANGELOG.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 67dfc4a96d0..7a7dd724be4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,7 +16,8 @@ Current Trunk
 -------------
 
 - [JS API] support `BinaryenStringConst` (#8951)
-- [JS API] Merge `Module['readBinaryWithFeatures']` into `Module['readBinary']`
+- [JS API] Replace `Module['readBinaryWithFeatures']` with an
+  optional `features` parameter to `Module['readBinary']` (#8954)
 
 v131
 ----
@@ -25,8 +26,8 @@ v131
 - Add acqrel ordering support for atomic fences (#8845). Breaks the C API;
   `BinaryenAtomicFence` now takes a memory order param. Use
   `BinaryenMemoryOrderSeqCst()` to preserve the original behavior.
-- [JS API] Merge `Module['parseTextWithFeatures']` into `Module['parseText']`
-  (#8901)
+- [JS API] Replace `Module['parseTextWithFeatures']` with an
+  optional `features` parameter to `Module['parseText']` (#8901)
 - Add a ConstraintAnalysis pass (#8853)
 
 v130