react-native-bridges · saseungmin · Mar 13, 2026 · Mar 13, 2026
diff --git a/.changeset/flat-bats-greet.md b/.changeset/flat-bats-greet.md
diff --git a/.changeset/petite-dolls-marry.md b/.changeset/petite-dolls-marry.md
diff --git a/.changeset/petite-dolls-test.md b/.changeset/petite-dolls-test.md
diff --git a/.changeset/shiny-signs-agree.md b/.changeset/shiny-signs-agree.md
diff --git a/.changeset/some-places-matter.md b/.changeset/some-places-matter.md
diff --git a/.changeset/upset-ghosts-serve.md b/.changeset/upset-ghosts-serve.md
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
@@ -1,5 +1,52 @@
 # @react-native-youtube-bridge/core
 
+## 2.2.0
+
+### Minor Changes
+
+- [#85](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/85) [`65fa568`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/65fa568b8d94143ca09e695e8372ee0627456df9) Thanks [@saseungmin](https://github.com/saseungmin)! - feat: add muteChange event with subscription-based muted state tracking
+
+  - Add `muteChange` event for real-time muted state updates.
+  - Forward `muteChange` through core/web/webview/react-native bridge layers.
+  - Enable muted-state tracking only while `muteChange` is subscribed (performance optimization).
+  - Keep replay mute-preservation behavior intact.
+  - Update the example app to use `useYouTubeEvent(player, 'muteChange', false)` for muted state.
+  - Update README docs (EN/KO, root + package) to document `muteChange` usage and tracking behavior.
+
+  ```tsx
+  import {
+    YoutubeView,
+    useYouTubeEvent,
+    useYouTubePlayer,
+  } from "react-native-youtube-bridge";
+
+  function App() {
+    const player = useYouTubePlayer(videoIdOrUrl);
+
+    // 1. State-based event listening
+    const isMuted = useYouTubeEvent(player, "muteChange", false);
+
+    // 2. Callback-based event listening
+    useYouTubeEvent(player, "muteChange", (muted) => {
+      console.log("Player is muted:", muted);
+    });
+
+    return <YoutubeView player={player} />;
+  }
+  ```
+
+### Patch Changes
+
+- [#81](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/81) [`fd60a82`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/fd60a82bc08818523e6eea9c22555e7d28dbdeff) Thanks [@saseungmin](https://github.com/saseungmin)! - chore: update tsdown dependency
+
+- [#79](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/79) [`4993ebb`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/4993ebbe23418737e02ff2fbf712c7442dea5205) Thanks [@saseungmin](https://github.com/saseungmin)! - chore: reformat code with oxfmt
+
+- [#83](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/83) [`3cad8a0`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/3cad8a03da7a7beb1f9600ba54fca226aa9ba003) Thanks [@saseungmin](https://github.com/saseungmin)! - fix: preserve muted preference when replay starts after video end ([#82](https://github.com/react-native-bridges/react-native-youtube-bridge/issues/82))
+
+  When a video is configured with muted=true, pressing the YouTube replay button after ENDED could resume playback with sound.
+  This patch preserves mute intent across replay by tracking the desired muted state and reapplying mute on ENDED->PLAYING transitions in both inline WebView and core controller paths.
+  It also synchronizes desired mute state when mute/unmute is explicitly toggled and updates iframe playerVars typing to include mute for consistency across web and native flows.
+
 ## 2.1.4
 
 ### Patch Changes
@@ -79,7 +126,7 @@
 
   ```jsx
   // Imperative, ref-based API
-  const playerRef = useRef<PlayerControls>(null);
+  const playerRef = useRef < PlayerControls > null;
 
   <YoutubePlayer
     ref={playerRef}

diff --git a/packages/core/package.json b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@react-native-youtube-bridge/core",
-  "version": "2.1.4",
+  "version": "2.2.0",
   "description": "Core package for react-native-youtube-bridge",
   "keywords": [
     "android",

diff --git a/packages/react-native-youtube-bridge/CHANGELOG.md b/packages/react-native-youtube-bridge/CHANGELOG.md
@@ -1,5 +1,56 @@
 # react-native-youtube-bridge
 
+## 2.2.0
+
+### Minor Changes
+
+- [#85](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/85) [`65fa568`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/65fa568b8d94143ca09e695e8372ee0627456df9) Thanks [@saseungmin](https://github.com/saseungmin)! - feat: add muteChange event with subscription-based muted state tracking
+
+  - Add `muteChange` event for real-time muted state updates.
+  - Forward `muteChange` through core/web/webview/react-native bridge layers.
+  - Enable muted-state tracking only while `muteChange` is subscribed (performance optimization).
+  - Keep replay mute-preservation behavior intact.
+  - Update the example app to use `useYouTubeEvent(player, 'muteChange', false)` for muted state.
+  - Update README docs (EN/KO, root + package) to document `muteChange` usage and tracking behavior.
+
+  ```tsx
+  import {
+    YoutubeView,
+    useYouTubeEvent,
+    useYouTubePlayer,
+  } from "react-native-youtube-bridge";
+
+  function App() {
+    const player = useYouTubePlayer(videoIdOrUrl);
+
+    // 1. State-based event listening
+    const isMuted = useYouTubeEvent(player, "muteChange", false);
+
+    // 2. Callback-based event listening
+    useYouTubeEvent(player, "muteChange", (muted) => {
+      console.log("Player is muted:", muted);
+    });
+
+    return <YoutubeView player={player} />;
+  }
+  ```
+
+### Patch Changes
+
+- [#79](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/79) [`4993ebb`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/4993ebbe23418737e02ff2fbf712c7442dea5205) Thanks [@saseungmin](https://github.com/saseungmin)! - chore: reformat code with oxfmt
+
+- [#83](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/83) [`3cad8a0`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/3cad8a03da7a7beb1f9600ba54fca226aa9ba003) Thanks [@saseungmin](https://github.com/saseungmin)! - fix: preserve muted preference when replay starts after video end ([#82](https://github.com/react-native-bridges/react-native-youtube-bridge/issues/82))
+
+  When a video is configured with muted=true, pressing the YouTube replay button after ENDED could resume playback with sound.
+  This patch preserves mute intent across replay by tracking the desired muted state and reapplying mute on ENDED->PLAYING transitions in both inline WebView and core controller paths.
+  It also synchronizes desired mute state when mute/unmute is explicitly toggled and updates iframe playerVars typing to include mute for consistency across web and native flows.
+
+- [#84](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/84) [`a542bcc`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/a542bccb412a4e62b06649c40c13fc731b458b7f) Thanks [@saseungmin](https://github.com/saseungmin)! - chore(deps): update dependencies
+
+- Updated dependencies [[`65fa568`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/65fa568b8d94143ca09e695e8372ee0627456df9), [`fd60a82`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/fd60a82bc08818523e6eea9c22555e7d28dbdeff), [`4993ebb`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/4993ebbe23418737e02ff2fbf712c7442dea5205), [`3cad8a0`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/3cad8a03da7a7beb1f9600ba54fca226aa9ba003), [`a542bcc`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/a542bccb412a4e62b06649c40c13fc731b458b7f)]:
+  - @react-native-youtube-bridge/core@2.2.0
+  - @react-native-youtube-bridge/react@2.1.5
+
 ## 2.1.4
 
 ### Patch Changes
@@ -121,7 +172,7 @@
 
   ```jsx
   // Imperative, ref-based API
-  const playerRef = useRef<PlayerControls>(null);
+  const playerRef = useRef < PlayerControls > null;
 
   <YoutubePlayer
     ref={playerRef}

diff --git a/packages/react-native-youtube-bridge/package.json b/packages/react-native-youtube-bridge/package.json
@@ -1,6 +1,6 @@
 {
   "name": "react-native-youtube-bridge",
-  "version": "2.1.4",
+  "version": "2.2.0",
   "description": "🎥 Easy-to-use YouTube player for React Native with cross-platform support",
   "keywords": [
     "android",

diff --git a/packages/react/CHANGELOG.md b/packages/react/CHANGELOG.md
@@ -1,5 +1,24 @@
 # @react-native-youtube-bridge/react
 
+## 2.1.5
+
+### Patch Changes
+
+- [#81](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/81) [`fd60a82`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/fd60a82bc08818523e6eea9c22555e7d28dbdeff) Thanks [@saseungmin](https://github.com/saseungmin)! - chore: update tsdown dependency
+
+- [#79](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/79) [`4993ebb`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/4993ebbe23418737e02ff2fbf712c7442dea5205) Thanks [@saseungmin](https://github.com/saseungmin)! - chore: reformat code with oxfmt
+
+- [#83](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/83) [`3cad8a0`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/3cad8a03da7a7beb1f9600ba54fca226aa9ba003) Thanks [@saseungmin](https://github.com/saseungmin)! - fix: preserve muted preference when replay starts after video end ([#82](https://github.com/react-native-bridges/react-native-youtube-bridge/issues/82))
+
+  When a video is configured with muted=true, pressing the YouTube replay button after ENDED could resume playback with sound.
+  This patch preserves mute intent across replay by tracking the desired muted state and reapplying mute on ENDED->PLAYING transitions in both inline WebView and core controller paths.
+  It also synchronizes desired mute state when mute/unmute is explicitly toggled and updates iframe playerVars typing to include mute for consistency across web and native flows.
+
+- [#84](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/84) [`a542bcc`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/a542bccb412a4e62b06649c40c13fc731b458b7f) Thanks [@saseungmin](https://github.com/saseungmin)! - chore(deps): update dependencies
+
+- Updated dependencies [[`65fa568`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/65fa568b8d94143ca09e695e8372ee0627456df9), [`fd60a82`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/fd60a82bc08818523e6eea9c22555e7d28dbdeff), [`4993ebb`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/4993ebbe23418737e02ff2fbf712c7442dea5205), [`3cad8a0`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/3cad8a03da7a7beb1f9600ba54fca226aa9ba003)]:
+  - @react-native-youtube-bridge/core@2.2.0
+
 ## 2.1.4
 
 ### Patch Changes
@@ -79,7 +98,7 @@
 
   ```jsx
   // Imperative, ref-based API
-  const playerRef = useRef<PlayerControls>(null);
+  const playerRef = useRef < PlayerControls > null;
 
   <YoutubePlayer
     ref={playerRef}

diff --git a/packages/react/package.json b/packages/react/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@react-native-youtube-bridge/react",
-  "version": "2.1.4",
+  "version": "2.1.5",
   "description": "React implementation for react-native-youtube-bridge",
   "keywords": [
     "android",

diff --git a/packages/web/CHANGELOG.md b/packages/web/CHANGELOG.md
@@ -1,5 +1,58 @@
 # @react-native-youtube-bridge/web
 
+## 2.2.0
+
+### Minor Changes
+
+- [#85](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/85) [`65fa568`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/65fa568b8d94143ca09e695e8372ee0627456df9) Thanks [@saseungmin](https://github.com/saseungmin)! - feat: add muteChange event with subscription-based muted state tracking
+
+  - Add `muteChange` event for real-time muted state updates.
+  - Forward `muteChange` through core/web/webview/react-native bridge layers.
+  - Enable muted-state tracking only while `muteChange` is subscribed (performance optimization).
+  - Keep replay mute-preservation behavior intact.
+  - Update the example app to use `useYouTubeEvent(player, 'muteChange', false)` for muted state.
+  - Update README docs (EN/KO, root + package) to document `muteChange` usage and tracking behavior.
+
+  ```tsx
+  import {
+    YoutubeView,
+    useYouTubeEvent,
+    useYouTubePlayer,
+  } from "react-native-youtube-bridge";
+
+  function App() {
+    const player = useYouTubePlayer(videoIdOrUrl);
+
+    // 1. State-based event listening
+    const isMuted = useYouTubeEvent(player, "muteChange", false);
+
+    // 2. Callback-based event listening
+    useYouTubeEvent(player, "muteChange", (muted) => {
+      console.log("Player is muted:", muted);
+    });
+
+    return <YoutubeView player={player} />;
+  }
+  ```
+
+### Patch Changes
+
+- [#81](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/81) [`fd60a82`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/fd60a82bc08818523e6eea9c22555e7d28dbdeff) Thanks [@saseungmin](https://github.com/saseungmin)! - chore: update dependencies, including React, Vite
+
+- [#79](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/79) [`4993ebb`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/4993ebbe23418737e02ff2fbf712c7442dea5205) Thanks [@saseungmin](https://github.com/saseungmin)! - chore: reformat code with oxfmt
+
+- [#83](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/83) [`3cad8a0`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/3cad8a03da7a7beb1f9600ba54fca226aa9ba003) Thanks [@saseungmin](https://github.com/saseungmin)! - fix: preserve muted preference when replay starts after video end ([#82](https://github.com/react-native-bridges/react-native-youtube-bridge/issues/82))
+
+  When a video is configured with muted=true, pressing the YouTube replay button after ENDED could resume playback with sound.
+  This patch preserves mute intent across replay by tracking the desired muted state and reapplying mute on ENDED->PLAYING transitions in both inline WebView and core controller paths.
+  It also synchronizes desired mute state when mute/unmute is explicitly toggled and updates iframe playerVars typing to include mute for consistency across web and native flows.
+
+- [#84](https://github.com/react-native-bridges/react-native-youtube-bridge/pull/84) [`a542bcc`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/a542bccb412a4e62b06649c40c13fc731b458b7f) Thanks [@saseungmin](https://github.com/saseungmin)! - chore(deps): update dependencies
+
+- Updated dependencies [[`65fa568`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/65fa568b8d94143ca09e695e8372ee0627456df9), [`fd60a82`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/fd60a82bc08818523e6eea9c22555e7d28dbdeff), [`4993ebb`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/4993ebbe23418737e02ff2fbf712c7442dea5205), [`3cad8a0`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/3cad8a03da7a7beb1f9600ba54fca226aa9ba003), [`a542bcc`](https://github.com/react-native-bridges/react-native-youtube-bridge/commit/a542bccb412a4e62b06649c40c13fc731b458b7f)]:
+  - @react-native-youtube-bridge/core@2.2.0
+  - @react-native-youtube-bridge/react@2.1.5
+
 ## 2.1.4
 
 ### Patch Changes
@@ -84,7 +137,7 @@
 
   ```jsx
   // Imperative, ref-based API
-  const playerRef = useRef<PlayerControls>(null);
+  const playerRef = useRef < PlayerControls > null;
 
   <YoutubePlayer
     ref={playerRef}

diff --git a/packages/web/package.json b/packages/web/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@react-native-youtube-bridge/web",
-  "version": "2.1.4",
+  "version": "2.2.0",
   "description": "Web implementation for react-native-youtube-bridge",
   "keywords": [
     "android",