@hypen-space/web 0.4.980 → 0.5.3

package/dist/dom/components/tabs.js

@@ -0,0 +1,69 @@
+/**
+ * Composite-widget hosts: Tabs / Tab / TabPanel / Option.
+ *
+ * These exist so the composite element types render *focusable, styleable*
+ * hosts instead of falling through to the unknown-component fallback (a
+ * `display: contents` div, which cannot reliably hold keyboard focus). The
+ * accessibility roles come from the engine-derived Semantics block
+ * (tablist/tab/tabpanel/option), not from these handlers; keyboard roving is
+ * wired by the renderer when it sees `role="tablist"` (see operability.ts).
+ */
+/** Tabs → a plain row container; role="tablist" arrives via semantics. */
+export const tabsHandler = {
+    create() {
+        const el = document.createElement("div");
+        el.dataset.hypenType = "tabs";
+        el.style.display = "flex";
+        el.style.flexDirection = "row";
+        return el;
+    },
+};
+/**
+ * Tab → a native `<button>` so focus and Enter/Space activation come free;
+ * the engine's `role="tab"` overrides the implicit button role (see the
+ * IMPLICIT_ROLE override logic in semantics.ts).
+ */
+export const tabHandler = {
+    create() {
+        const el = document.createElement("button");
+        el.setAttribute("type", "button");
+        el.dataset.hypenType = "tab";
+        return el;
+    },
+    applyProps(el, props) {
+        const text = props["0"] ?? props.text;
+        if (text !== undefined) {
+            el.dataset.textTemplate = String(text);
+            el.textContent = String(text);
+        }
+    },
+};
+/**
+ * TabPanel → a focusable region (`tabindex=0`) so a Tab keypress from the
+ * tablist lands inside the panel even when it has no focusable content
+ * (WAI-ARIA APG recommendation).
+ */
+export const tabPanelHandler = {
+    create() {
+        const el = document.createElement("div");
+        el.dataset.hypenType = "tabpanel";
+        el.tabIndex = 0;
+        return el;
+    },
+};
+/** Option → a plain div host; role="option" arrives via semantics. */
+export const optionHandler = {
+    create() {
+        const el = document.createElement("div");
+        el.dataset.hypenType = "option";
+        return el;
+    },
+    applyProps(el, props) {
+        const text = props["0"] ?? props.text;
+        if (text !== undefined) {
+            el.dataset.textTemplate = String(text);
+            el.textContent = String(text);
+        }
+    },
+};
+//# sourceMappingURL=tabs.js.map

package/dist/dom/components/tabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.js","sourceRoot":"","sources":["../../../src/dom/components/tabs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,MAAM;QACJ,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC;QAC9B,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;QAC1B,EAAE,CAAC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC;QAC/B,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAqB;IAC1C,MAAM;QACJ,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC5C,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAClC,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,UAAU,CAAC,EAAe,EAAE,KAA0B;QACpD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC;QACtC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,EAAE,CAAC,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YACvC,EAAE,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C,MAAM;QACJ,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,UAAU,CAAC;QAClC,EAAE,CAAC,QAAQ,GAAG,CAAC,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAC;AAEF,sEAAsE;AACtE,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC7C,MAAM;QACJ,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,UAAU,CAAC,EAAe,EAAE,KAA0B;QACpD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC;QACtC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,EAAE,CAAC,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YACvC,EAAE,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/dom/components/text.js

@@ -2,8 +2,8 @@
  * Text Component
  */
 export const textHandler = {
-    create(doc) {
-        const el = doc.createElement("span");
+    create() {
+        const el = document.createElement("span");
         // Use inline-block for proper flex child behavior
         el.style.display = "inline-block";
         // Tight line-height to match iOS/Android
@@ -16,11 +16,8 @@ export const textHandler = {
         return el;
     },
     applyProps(el, props) {
-        // Text content from first positional arg or "text" prop. Use `??` (not
-        // `||`) so the literal number `0`, `false`, and the empty string still
-        // render — `||` falls through on falsy values and a bound `0` was
-        // disappearing entirely on web while iOS rendered it correctly.
-        const text = props["0"] ?? props.text;
+        // Text content from first positional arg or "text" prop
+        const text = props["0"] || props.text;
         if (text !== undefined) {
             // Store the original text template for state interpolation
             el.dataset.textTemplate = String(text);

package/dist/dom/components/text.js.map

@@ -1 +1 @@
-{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/dom/components/text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,MAAM,CAAC,GAAa;QAClB,MAAM,EAAE,GAAG,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QACrC,kDAAkD;QAClD,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,cAAc,CAAC;QAClC,yCAAyC;QACzC,EAAE,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC;QAC1B,4DAA4D;QAC5D,EAAE,CAAC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC;QAC/B,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;QACtB,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC;QACvB,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,UAAU,CAAC,EAAe,EAAE,KAA0B;QACpD,uEAAuE;QACvE,uEAAuE;QACvE,kEAAkE;QAClE,gEAAgE;QAChE,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC;QACtC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,2DAA2D;YAC3D,EAAE,CAAC,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YACvC,EAAE,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/dom/components/text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,MAAM;QACJ,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC1C,kDAAkD;QAClD,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,cAAc,CAAC;QAClC,yCAAyC;QACzC,EAAE,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC;QAC1B,4DAA4D;QAC5D,EAAE,CAAC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC;QAC/B,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;QACtB,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC;QACvB,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,UAAU,CAAC,EAAe,EAAE,KAA0B;QACpD,wDAAwD;QACxD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC;QACtC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,2DAA2D;YAC3D,EAAE,CAAC,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YACvC,EAAE,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/dom/components/textarea.js

@@ -2,8 +2,8 @@
  * Textarea Component
  */
 export const textareaHandler = {
-    create(doc) {
-        const el = doc.createElement("textarea");
+    create() {
+        const el = document.createElement("textarea");
         el.dataset.hypenType = "textarea";
         // Same user-agent reset as Input — otherwise `.tw(...)` styling draws
         // over a native dark border and inset shadow.

package/dist/dom/components/textarea.js.map

@@ -1 +1 @@
-{"version":3,"file":"textarea.js","sourceRoot":"","sources":["../../../src/dom/components/textarea.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C,MAAM,CAAC,GAAa;QAClB,MAAM,EAAE,GAAG,GAAG,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACzC,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,UAAU,CAAC;QAClC,sEAAsE;QACtE,8CAA8C;QAC9C,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;QAC1B,EAAE,CAAC,KAAK,CAAC,UAAU,GAAG,aAAa,CAAC;QACpC,EAAE,CAAC,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC;QAC1B,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;QAC3B,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,OAAO,EAAiB,CAAC;IAC3B,CAAC;IAED,UAAU,CAAC,EAAe,EAAE,KAA0B;QACpD,MAAM,QAAQ,GAAG,EAAyB,CAAC;QAE3C,mFAAmF;QACnF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,QAAQ,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QAED,cAAc;QACd,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACpC,QAAQ,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACnD,CAAC;QAED,OAAO;QACP,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,QAAQ,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QAED,OAAO;QACP,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,QAAQ,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QAED,WAAW;QACX,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;QAED,WAAW;QACX,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"textarea.js","sourceRoot":"","sources":["../../../src/dom/components/textarea.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C,MAAM;QACJ,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAC9C,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,UAAU,CAAC;QAClC,sEAAsE;QACtE,8CAA8C;QAC9C,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;QAC1B,EAAE,CAAC,KAAK,CAAC,UAAU,GAAG,aAAa,CAAC;QACpC,EAAE,CAAC,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC;QAC1B,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;QAC3B,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,OAAO,EAAiB,CAAC;IAC3B,CAAC;IAED,UAAU,CAAC,EAAe,EAAE,KAA0B;QACpD,MAAM,QAAQ,GAAG,EAAyB,CAAC;QAE3C,mFAAmF;QACnF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,QAAQ,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QAED,cAAc;QACd,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACpC,QAAQ,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACnD,CAAC;QAED,OAAO;QACP,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,QAAQ,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QAED,OAAO;QACP,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,QAAQ,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QAED,WAAW;QACX,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;QAED,WAAW;QACX,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/dom/components/video.js

@@ -2,8 +2,8 @@
  * Video Component
  */
 export const videoHandler = {
-    create(doc) {
-        const el = doc.createElement("video");
+    create() {
+        const el = document.createElement("video");
         el.dataset.hypenType = "video";
         return el;
     },

package/dist/dom/components/video.js.map

@@ -1 +1 @@
-{"version":3,"file":"video.js","sourceRoot":"","sources":["../../../src/dom/components/video.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,MAAM,CAAC,GAAa;QAClB,MAAM,EAAE,GAAG,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACtC,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC;QAC/B,OAAO,EAAwB,CAAC;IAClC,CAAC;IAED,UAAU,CAAC,EAAe,EAAE,KAA0B;QACpD,MAAM,KAAK,GAAG,EAAsB,CAAC;QAErC,SAAS;QACT,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC;QACpC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QAED,WAAW;QACX,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAED,WAAW;QACX,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO;QACP,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,QAAQ;QACR,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;QAED,SAAS;QACT,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"video.js","sourceRoot":"","sources":["../../../src/dom/components/video.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,MAAM;QACJ,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC3C,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC;QAC/B,OAAO,EAAwB,CAAC;IAClC,CAAC;IAED,UAAU,CAAC,EAAe,EAAE,KAA0B;QACpD,MAAM,KAAK,GAAG,EAAsB,CAAC;QAErC,SAAS;QACT,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC;QACpC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QAED,WAAW;QACX,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAED,WAAW;QACX,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO;QACP,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,QAAQ;QACR,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;QAED,SAAS;QACT,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/dom/components/visuallyhidden.d.ts

@@ -0,0 +1,9 @@
+/**
+ * VisuallyHidden Component
+ *
+ * Renders content that is invisible on screen but remains in the accessibility
+ * tree for screen readers — the standard "sr-only" pattern. Useful for giving
+ * an icon-only control readable text, announcing context, etc.
+ */
+import type { ComponentHandler } from "./index.js";
+export declare const visuallyHiddenHandler: ComponentHandler;

package/dist/dom/components/visuallyhidden.js

@@ -0,0 +1,26 @@
+/**
+ * VisuallyHidden Component
+ *
+ * Renders content that is invisible on screen but remains in the accessibility
+ * tree for screen readers — the standard "sr-only" pattern. Useful for giving
+ * an icon-only control readable text, announcing context, etc.
+ */
+export const visuallyHiddenHandler = {
+    create() {
+        const el = document.createElement("span");
+        el.dataset.hypenType = "visuallyhidden";
+        // Standard visually-hidden (sr-only) styles: removed from the visual
+        // layout but still read by assistive technology.
+        el.style.position = "absolute";
+        el.style.width = "1px";
+        el.style.height = "1px";
+        el.style.padding = "0";
+        el.style.margin = "-1px";
+        el.style.overflow = "hidden";
+        el.style.clip = "rect(0, 0, 0, 0)";
+        el.style.whiteSpace = "nowrap";
+        el.style.border = "0";
+        return el;
+    },
+};
+//# sourceMappingURL=visuallyhidden.js.map

package/dist/dom/components/visuallyhidden.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visuallyhidden.js","sourceRoot":"","sources":["../../../src/dom/components/visuallyhidden.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD,MAAM;QACJ,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC1C,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,gBAAgB,CAAC;QAExC,qEAAqE;QACrE,iDAAiD;QACjD,EAAE,CAAC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC;QAC/B,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACvB,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;QACxB,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC;QACvB,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,EAAE,CAAC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC7B,EAAE,CAAC,KAAK,CAAC,IAAI,GAAG,kBAAkB,CAAC;QACnC,EAAE,CAAC,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAC;QAC/B,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;QAEtB,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAC"}

package/dist/dom/debug.js

@@ -51,13 +51,11 @@ export class RerenderTracker {
      * Create or update the heatmap overlay for an element
      */
     updateHeatmap(id, element, renderCount, patchType) {
-        const doc = element.ownerDocument;
-        const win = doc.defaultView ?? window;
         // Calculate opacity based on render count (increment by heatmapIncrement% each time)
         const opacity = Math.min((renderCount * this.config.heatmapIncrement) / 100, this.config.maxOpacity);
         log.debug(`Updating heatmap for ${id}, count: ${renderCount}, opacity: ${opacity}`);
         // For inline elements or text, use a simpler approach: background color + outline
-        const isInline = win.getComputedStyle(element).display.includes('inline');
+        const isInline = window.getComputedStyle(element).display.includes('inline');
         if (isInline || element.tagName === 'SPAN') {
             // Store original styles if not already stored
             if (!element.dataset.hypenDebugOriginalBg) {
@@ -73,8 +71,8 @@ export class RerenderTracker {
             // Add count badge as ::before pseudo-element or data attribute
             element.setAttribute('data-hypen-renders', `${renderCount}× ${patchType}`);
             // Add CSS for the badge if not already added
-            if (!doc.getElementById('hypen-debug-styles')) {
-                const style = doc.createElement('style');
+            if (!document.getElementById('hypen-debug-styles')) {
+                const style = document.createElement('style');
                 style.id = 'hypen-debug-styles';
                 style.textContent = `
           [data-hypen-renders]::before {
@@ -95,7 +93,7 @@ export class RerenderTracker {
             text-shadow: none;
           }
         `;
-                doc.head.appendChild(style);
+                document.head.appendChild(style);
             }
             // Store in overlays map for cleanup
             this.overlays.set(id, element);
@@ -114,7 +112,7 @@ export class RerenderTracker {
             // For block elements, use overlay approach
             let overlay = this.overlays.get(id);
             if (!overlay) {
-                overlay = doc.createElement("div");
+                overlay = document.createElement("div");
                 overlay.className = "hypen-debug-overlay";
                 overlay.style.cssText = `
           position: absolute;
@@ -136,7 +134,7 @@ export class RerenderTracker {
           display: block !important;
           visibility: visible !important;
         `;
-                const currentPosition = win.getComputedStyle(element).position;
+                const currentPosition = window.getComputedStyle(element).position;
                 if (currentPosition === 'static') {
                     element.style.position = 'relative';
                 }

package/dist/dom/debug.js.map

@@ -1 +1 @@
-{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/dom/debug.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/dom/debug.ts"],"names":[],"mappings":"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"}

package/dist/dom/index.d.ts

@@ -8,4 +8,3 @@ export { ComponentRegistry } from "./components/index.js";
 export { ApplicatorRegistry } from "./applicators/index.js";
 export { EventManager } from "./events.js";
 export { RerenderTracker, type DebugConfig, defaultDebugConfig } from "./debug.js";
-export { createDomClient as createHypenClient, createDomClient, type DomClient as HypenClient, type DomClient, type DomClientOptions as HypenClientOptions, type DomClientOptions, } from "../client.js";

package/dist/dom/index.js

@@ -8,5 +8,4 @@ export { ComponentRegistry } from "./components/index.js";
 export { ApplicatorRegistry } from "./applicators/index.js";
 export { EventManager } from "./events.js";
 export { RerenderTracker, defaultDebugConfig } from "./debug.js";
-export { createDomClient as createHypenClient, createDomClient, } from "../client.js";
 //# sourceMappingURL=index.js.map

package/dist/dom/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dom/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAoB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EACL,eAAe,IAAI,iBAAiB,EACpC,eAAe,GAKhB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dom/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAoB,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/dom/operability.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Keyboard operability for actionable elements.
+ *
+ * Native interactive elements (`<button>`, `<a href>`) are keyboard-operable
+ * for free — the browser activates them on Enter/Space. But Hypen's actionable
+ * `Card` renders a plain `<div>`, which is neither focusable nor
+ * keyboard-activatable. This module closes that gap: a non-native actionable
+ * host is given a `button` role, made focusable (`tabindex=0`), and wired so
+ * Enter/Space dispatch the same action as a click.
+ *
+ * This is intentionally client-side: focus and key handling are synchronous
+ * interactions the streaming engine cannot mediate.
+ */
+/**
+ * Make a non-native actionable element keyboard-operable. Idempotent across
+ * re-renders (guarded by a dataset flag). No-op for native interactive tags.
+ */
+export declare function makeKeyboardActivatable(element: HTMLElement, actionValue: unknown): void;
+/**
+ * Pick the focus target for a Tab keypress within a trapped container, wrapping
+ * at the ends.
+ *
+ * Pure over the ordered list of focusable descendants so it is testable without
+ * a real DOM: given the currently-focused element (`active`) and the Shift
+ * state, returns the element that should receive focus next, or `null` when
+ * there is nothing to focus. Tab past the last element wraps to the first;
+ * Shift+Tab past the first wraps to the last. When focus is outside the set,
+ * Tab lands on the first element and Shift+Tab on the last.
+ */
+export declare function nextTrapFocus<T>(focusable: T[], active: T | null, shift: boolean): T | null;
+/**
+ * Pick the tab that should receive focus for a keypress inside a roving
+ * tablist (WAI-ARIA APG "Tabs" keyboard contract). Pure over the ordered tab
+ * list so it is testable without a real DOM: Arrow Right/Down move to the
+ * next tab (wrapping), Arrow Left/Up to the previous (wrapping), Home/End to
+ * the first/last. Any other key — or an empty list — returns `null` (leave
+ * focus alone).
+ */
+export declare function nextRovingFocus<T>(tabs: T[], active: T | null, key: string): T | null;
+/**
+ * Pick the item typeahead should move focus to (WAI-ARIA APG first-character
+ * navigation). Pure over the ordered item list so it is testable without a
+ * real DOM: the search is a case-insensitive `startsWith` over `textOf(item)`,
+ * starting from the item AFTER `active` and wrapping; `active` itself is the
+ * last candidate, so a query the current item already matches keeps focus in
+ * place (multi-char accumulation refining onto the same item). Returns `null`
+ * when nothing matches or the query is empty. Query accumulation and its
+ * timeout live at the caller.
+ */
+export declare function nextTypeaheadFocus<T>(items: T[], active: T | null, query: string, textOf: (item: T) => string): T | null;
+/**
+ * Install the WAI-ARIA APG "Tabs" keyboard contract on a tablist container:
+ * roving tabindex over the `role="tab"` descendants plus first-character
+ * typeahead (see `installRovingWidget`).
+ */
+export declare function makeRovingTablist(container: HTMLElement): void;
+/**
+ * Install the WAI-ARIA APG "Listbox" keyboard contract on a listbox
+ * container: roving tabindex over the `role="option"` descendants plus
+ * first-character typeahead (see `installRovingWidget`). No-op for a native
+ * `<select>` host (Hypen's `Select`), where the browser already owns arrow
+ * and typeahead behaviour.
+ */
+export declare function makeRovingListbox(container: HTMLElement): void;
+/**
+ * Install a focus trap on a dialog-like container: Tab / Shift+Tab cycle focus
+ * among the container's focusable descendants and wrap at the ends. Closing is
+ * app state: Escape is handled by `installDialogEscape` only when the dialog
+ * declares an `onClose` action. Idempotent across re-renders, guarded by a
+ * dataset flag.
+ */
+export declare function makeFocusTrap(container: HTMLElement): void;
+/**
+ * First focusable descendant of `root` in document order, or `null`. Matches
+ * the focus trap's element set (`FOCUSABLE_SELECTOR`) but walks `children`
+ * recursively instead of `querySelectorAll`, so it works on hosts without
+ * selector support (test doubles) — document order is exactly child order.
+ */
+export declare function findFirstFocusable(root: HTMLElement): HTMLElement | null;
+/**
+ * Dialog auto-focus on mount (WAI-ARIA APG "Dialog (Modal)"): focus the
+ * dialog's first focusable descendant, else the dialog itself (granted
+ * programmatic focusability by `focusRouteTarget`). Returns the element that
+ * held focus before the dialog opened, so the caller can restore it on close.
+ */
+export declare function focusDialogOnOpen(dialog: HTMLElement): HTMLElement | null;
+/**
+ * Restore focus to the element that had it before a dialog opened. Skipped
+ * when the opener is gone: no longer connected to the document, or living
+ * inside the (now closed) dialog itself.
+ */
+export declare function restoreDialogFocus(dialog: HTMLElement, opener: HTMLElement | null): void;
+/**
+ * Escape-to-close for a dialog that declares an `onClose` action: Escape
+ * dispatches the action; the actual close (state flip, unmount) stays with
+ * the app. A dialog without `onClose` gets no Escape behaviour — the renderer
+ * cannot know how to close it. Idempotent across re-renders, guarded by a
+ * dataset flag.
+ */
+export declare function installDialogEscape(dialog: HTMLElement, onCloseValue: unknown): void;