From 37464e2d950ed741ac0e50f0756130c3331e1b0a Mon Sep 17 00:00:00 2001
From: Karl Seguin <k@openmymind.io>
Date: Sat, 7 Feb 2026 17:39:12 +0800
Subject: [PATCH] Add Document.hidden and visibilityState properties

Always visible. I understand that this is for things like, being on a different
tab or being minimized.
---
 src/browser/tests/document/document.html |  2 ++
 src/browser/webapi/Document.zig          | 13 +++++++++++++
 2 files changed, 15 insertions(+)

diff --git a/src/browser/tests/document/document.html b/src/browser/tests/document/document.html
index 5f4e3e7f..995588e6 100644
--- a/src/browser/tests/document/document.html
+++ b/src/browser/tests/document/document.html
@@ -13,6 +13,8 @@
   testing.expectEqual(undefined, document.getCurrentScript);
   testing.expectEqual("http://127.0.0.1:9582/src/browser/tests/document/document.html", document.URL);
   testing.expectEqual(window, document.defaultView);
+  testing.expectEqual(false, document.hidden);
+  testing.expectEqual("visible", document.visibilityState);
 </script>
 
 <script id=headAndbody>
diff --git a/src/browser/webapi/Document.zig b/src/browser/webapi/Document.zig
index f428b1f1..7f2b233f 100644
--- a/src/browser/webapi/Document.zig
+++ b/src/browser/webapi/Document.zig
@@ -792,6 +792,17 @@ pub fn setAdoptedStyleSheets(self: *Document, sheets: js.Object) !void {
     self._adopted_style_sheets = try sheets.persist();
 }
 
+pub fn getHidden(_: *const Document) bool {
+    // it's hidden when, for example, the decive is locked, or user is on a
+    // a different tab.
+    return false;
+}
+
+pub fn getVisibilityState(_: *const Document) []const u8 {
+    // See getHidden above, possible options are "visible" or "hidden"
+    return "visible";
+}
+
 // Validates that nodes can be inserted into a Document, respecting Document constraints:
 // - At most one Element child
 // - At most one DocumentType child
@@ -987,6 +998,8 @@ pub const JsApi = struct {
     pub const lastElementChild = bridge.accessor(Document.getLastElementChild, null, .{});
     pub const childElementCount = bridge.accessor(Document.getChildElementCount, null, .{});
     pub const adoptedStyleSheets = bridge.accessor(Document.getAdoptedStyleSheets, Document.setAdoptedStyleSheets, .{});
+    pub const hidden = bridge.accessor(Document.getHidden, null, .{});
+    pub const visibilityState = bridge.accessor(Document.getVisibilityState, null, .{});
 
     pub const defaultView = bridge.accessor(struct {
         fn defaultView(_: *const Document, page: *Page) *@import("Window.zig") {