@minicode-dev/chat 0.1.5 → 0.1.7

package/README.md

@@ -230,6 +230,7 @@ const config = {
     enabled: true,
     autoPlay: true,
     sound: true,
+    backgroundSound: true,
     volume: 0.35,
     cooldownMs: 5000,
     maxAgeMs: 10000,
@@ -247,7 +248,10 @@ alongside the versioned payload. Set `effects: false` to disable the feature.
 Audio requires browser permission to play after a user gesture and respects the chat's
 mute control. Effects stop when closed or when leaving the conversation; motion reduction
 uses a static alternative. History, duplicates and reconnection baselines do not trigger
-automatic playback. Automatic effects require a visible conversation in a visible tab. Same-origin
+automatic playback. Automatic animations require a visible conversation in a visible tab.
+With `backgroundSound` (default `true`), an effect nobody is watching — hidden tab, closed
+chat window or another conversation — still plays its sound, like new-message sounds; returning
+to that conversation within `maxAgeMs` replays it with its animation. Same-origin
 tab deduplication is best effort. Receiving clients use a cooldown and ignore stale events.
 The server should enforce its own authorization and rate limits; browser controls alone
 cannot prevent abusive clients.
@@ -286,7 +290,7 @@ excluded from npm. Source generators are in `demo/audio-lab/`; see
 
 New incoming effects automatically animate in the visible conversation by default;
 manual replay is still available. The default cooldown is 5 seconds. Window focus is
-not required, but hidden tabs and old messages do not replay effects. A new permitted
+not required; hidden tabs only play the sound (see `backgroundSound`) and old messages do not replay effects. A new permitted
 effect can replace the animation currently playing. Confetti fills the panel with
 220 colored particles and scales to its height. Reduced-motion preferences remain respected.
 Browsers can still block sound before the recipient interacts with the site; the visual