From d2d63a38fe4a021be2b8292bc6a03c8d08ecd9c2 Mon Sep 17 00:00:00 2001
From: Chris Needham <chris.needham@bbc.co.uk>
Date: Thu, 21 Mar 2024 15:30:21 +0000
Subject: [PATCH 1/2] Move requirements for PiP window visibility and closing

See #191
---
 index.bs | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/index.bs b/index.bs
index 8a40305..e5ebb52 100644
--- a/index.bs
+++ b/index.bs
@@ -209,14 +209,16 @@ the user agent MUST run the following steps:
 8. Set {{pictureInPictureElement}} to |video|.
 9. Let <dfn>Picture-in-Picture window</dfn> be a new instance of
     {{PictureInPictureWindow}} associated with {{pictureInPictureElement}}.
-10. Append <a>relevant settings object</a>'s <a>origin</a> to
+10. When the Picture-in-Picture window is opened it MUST be visible, even when
+    the <a>Document</a> is not in focus or hidden.
+11. Append <a>relevant settings object</a>'s <a>origin</a> to
     <a>initiators of active Picture-in-Picture sessions</a>.
-11. <a>Queue a task</a> to <a>fire an event</a> named
+12. <a>Queue a task</a> to <a>fire an event</a> named
     {{enterpictureinpicture}} using {{PictureInPictureEvent}} at the
     |video| with its {{bubbles}} attribute initialized to `true` and its
     {{PictureInPictureEvent/pictureInPictureWindow}} attribute initialized to
     <a>Picture-in-Picture window</a>.
-12. If {{pictureInPictureElement}} is <a>fullscreenElement</a>, it is
+13. If {{pictureInPictureElement}} is <a>fullscreenElement</a>, it is
     RECOMMENDED to <a>exit fullscreen</a>.
 
 It is RECOMMENDED that video frames are not rendered in the page and in the
@@ -237,6 +239,9 @@ It is also RECOMMENDED that the Picture-in-Picture window has a maximum and
 minimum size. For example, it could be restricted to be between a quarter and
 a half of one dimension of the screen.
 
+The user agent SHOULD provide a way for users to manually close the
+Picture-in-Picture window.
+
 ## Exit Picture-in-Picture ## {#exit-pip}
 
 When the <dfn>exit Picture-in-Picture algorithm</dfn> is invoked,
@@ -306,11 +311,6 @@ available controls on the Picture-in-Picture window.
 
 ## Interaction with Page Visibility ## {#page-visibility}
 
-When {{pictureInPictureElement}} is set, the Picture-in-Picture window MUST
-be visible, even when the <a>Document</a> is not in focus or hidden. The user
-agent SHOULD provide a way for users to manually close the Picture-in-Picture
-window.
-
 The Picture-in-Picture window visibility MUST NOT be taken into account by the
 user agent to determine if the <a>system visibility state</a> of a 
 <a for="/">traversable navigable</a> has changed.

From 708dd16ebc1d27cd4bf2df543b52b3f8568b90b7 Mon Sep 17 00:00:00 2001
From: Chris Needham <chris.needham@bbc.co.uk>
Date: Thu, 21 Mar 2024 15:53:34 +0000
Subject: [PATCH 2/2] Move requirements for PiP window visibility and closing

---
 index.bs | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/index.bs b/index.bs
index e5ebb52..e7dc4b8 100644
--- a/index.bs
+++ b/index.bs
@@ -209,16 +209,14 @@ the user agent MUST run the following steps:
 8. Set {{pictureInPictureElement}} to |video|.
 9. Let <dfn>Picture-in-Picture window</dfn> be a new instance of
     {{PictureInPictureWindow}} associated with {{pictureInPictureElement}}.
-10. When the Picture-in-Picture window is opened it MUST be visible, even when
-    the <a>Document</a> is not in focus or hidden.
-11. Append <a>relevant settings object</a>'s <a>origin</a> to
+10. Append <a>relevant settings object</a>'s <a>origin</a> to
     <a>initiators of active Picture-in-Picture sessions</a>.
-12. <a>Queue a task</a> to <a>fire an event</a> named
+11. <a>Queue a task</a> to <a>fire an event</a> named
     {{enterpictureinpicture}} using {{PictureInPictureEvent}} at the
     |video| with its {{bubbles}} attribute initialized to `true` and its
     {{PictureInPictureEvent/pictureInPictureWindow}} attribute initialized to
     <a>Picture-in-Picture window</a>.
-13. If {{pictureInPictureElement}} is <a>fullscreenElement</a>, it is
+12. If {{pictureInPictureElement}} is <a>fullscreenElement</a>, it is
     RECOMMENDED to <a>exit fullscreen</a>.
 
 It is RECOMMENDED that video frames are not rendered in the page and in the
@@ -239,8 +237,10 @@ It is also RECOMMENDED that the Picture-in-Picture window has a maximum and
 minimum size. For example, it could be restricted to be between a quarter and
 a half of one dimension of the screen.
 
-The user agent SHOULD provide a way for users to manually close the
-Picture-in-Picture window.
+When {{pictureInPictureElement}} is set, the Picture-in-Picture window MUST
+be visible, even when the <a>Document</a> is not in focus or hidden. The user
+agent SHOULD provide a way for users to manually close the Picture-in-Picture
+window.
 
 ## Exit Picture-in-Picture ## {#exit-pip}