Merge branch 'master' into worktree-mosaic-library

# Conflicts:
#	docs/traceability.md

src/lib/utils/pictureInPicture.ts

@@ -89,14 +89,18 @@ export function setAutoEnterEnabled(enabled: boolean): void {
 /**
  * Tell native that a WebView `<video>` is (or is no longer) the playback surface.
  *
- * This is what makes PiP work at all in the shipping configuration. The native
- * side only ever knew about the ExoPlayer surface, and that path is behind
- * `experimentalNativeVideo`, which defaults to off — so `canEnterPip` was always
+ * This is what makes PiP work on the HTML5 path. The native side only ever knew
+ * about the ExoPlayer surface, and that path is behind `experimentalNativeVideo`,
+ * which defaulted to off when this was written — so `canEnterPip` was always
  * false and pressing the button did nothing. Reporting the element's state gives
  * native a surface it can legitimately shrink into, plus the intrinsic size it
  * needs for the PiP window's aspect ratio and the play state for its play/pause
  * action.
  *
+ * The flag defaults to **on** now (DR-161), so Android normally shrinks the real
+ * ExoPlayer surface instead; this remains the path for Linux and for anyone who
+ * turned the flag off.
+ *
  * Pass `active: false` when the element goes away, or PiP would be offered over a
  * video that is no longer there.
  *