From ea35f370cca3c6a5947798d4512f104d1831b8c5 Mon Sep 17 00:00:00 2001
From: Marcos Caceres <caceres_m@apple.com>
Date: Fri, 17 Oct 2025 14:32:34 +0800
Subject: [PATCH] Standardize window.orientation API
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add Window interface extension with orientation attribute and onorientationchange handler
- Integrate orientationchange event firing into existing screen orientation change steps
- Map window.orientation values according to WHATWG compat spec algorithm
- Support required values (-90, 0, 90) and optional 180° value
- Remove device-specific restrictions to support device-independent web

This moves window.orientation from WHATWG compat spec to Screen Orientation spec
where it belongs conceptually, providing a single authoritative definition.

Fixes #249
---
 index.html | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/index.html b/index.html
index 5b5f19c..cf817c1 100644
--- a/index.html
+++ b/index.html
@@ -312,6 +312,55 @@ <h2>
         </table>
       </section>
     </section>
+    <section data-dfn-for="Window">
+      <h2>
+        Extensions to the `Window` interface
+      </h2>
+      <pre class="idl">
+        partial interface Window {
+          readonly attribute short orientation;
+          attribute EventHandler onorientationchange;
+        };
+      </pre>
+      <section>
+        <h2>
+          `orientation` attribute
+        </h2>
+        <p>
+          When getting the {{Window/orientation}} attribute, the [=user agent=] MUST run
+          the following steps:
+        </p>
+        <ol class="algorithm">
+          <li>Let |orientationAngle| be the [=Screen/current orientation angle=].
+          </li>
+          <li>If |orientationAngle| is less than 180, return |orientationAngle|.
+          </li>
+          <li>If |orientationAngle| is 180, and the [=user agent=] supports that value,
+          return |orientationAngle|, else return 0.
+          </li>
+          <li>If |orientationAngle| is greater than 180, return |orientationAngle| - 360.
+          </li>
+        </ol>
+        <p>
+          User agents MUST support the `-90`, `0` and `90` values and MAY optionally support `180`.
+        </p>
+        <p class="note">
+          `0` represents the natural orientation, `-90` represents 90 degrees clockwise,
+          `90` represents 90 degrees counterclockwise, and `180` represents 180 degrees
+          from natural orientation.
+        </p>
+      </section>
+      <section>
+        <h2>
+          `onorientationchange` event handler attribute
+        </h2>
+        <p>
+          The {{Window/onorientationchange}} attribute is an [=event handler IDL attribute=] for
+          the {{Window/onorientationchange}} [=event handler=], whose [=event handler event type=]
+          is <dfn class="event" data-dfn-for="Window">orientationchange</dfn>.
+        </p>
+      </section>
+    </section>
     <section data-dfn-for="Screen">
       <h2>
         Extensions to the `Screen` interface
@@ -801,6 +850,9 @@ <h2>
             <li>[=Fire an event=] named "<a data-link-for=
             "ScreenOrientation">change</a>" at |screenOrientation|.
             </li>
+            <li>[=Fire an event=] named "<a data-link-for=
+            "Window">orientationchange</a>" at |document|'s [=relevant global object=].
+            </li>
           </ol>
         </li>
         <li>Let |descendantDocs| be an [=ordered set=] consisting of