@pieai/swimmer-ui-kit 2.7.2 → 2.8.0

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to `@pieai/swimmer-ui-kit`.
 Format: [Keep a Changelog](https://keepachangelog.com); versioning: semver.
 
+## 2.8.0 — 2026-09-18
+
+- Add optional `GameModal keepMounted` for unfinished form state that should
+  survive close/reopen. Closed modal content remains inert and keyboard
+  unreachable; the default still unmounts `children` on close.
+
 ## 2.7.2 — 2026-09-16
 
 - Use readable muted ink for editable input and textarea placeholders. Empty

package/dist/index.d.ts

@@ -1840,7 +1840,7 @@ export declare interface GameMaterialSwatchesProps {
     'data-testid'?: string | undefined;
 }
 
-export declare function GameModal({ children, className, closeLabel, closeOnBackdrop, footer, onClose, open, position, size, title, }: GameModalProps): ReactNode;
+export declare function GameModal({ children, className, closeLabel, closeOnBackdrop, footer, keepMounted, onClose, open, position, size, title, }: GameModalProps): ReactNode;
 
 export declare interface GameModalProps {
     children: ReactNode;
@@ -1852,6 +1852,8 @@ export declare interface GameModalProps {
     /** Called for every close intent: Esc, backdrop click, and close button. */
     onClose: () => void;
     open: boolean;
+    /** Keep children mounted while closed to preserve their local state. Closed content stays inert. */
+    keepMounted?: boolean;
     /**
      * `'bottom'` anchors the frame to the viewport's bottom edge (rounded top
      * corners only, safe-area-aware padding, slide-up entrance) for mobile

package/dist/index.js

@@ -7029,43 +7029,52 @@ function Va({ allowMaximize: e = !0, allowMinimize: t = !0, children: n, classNa
 		})]
 	});
 }
-function Ha({ children: e, className: t, closeLabel: n = "Close", closeOnBackdrop: r = !0, footer: i, onClose: a, open: o, position: l = "center", size: u = "md", title: f }) {
-	let p = d(null), m = c();
+function Ha({ children: e, className: t, closeLabel: n = "Close", closeOnBackdrop: r = !0, footer: i, keepMounted: a = !1, onClose: o, open: l, position: u = "center", size: p = "md", title: m }) {
+	let _ = d(null), v = d(null), y = c(), [b, x] = f(!l);
 	return s(() => {
-		let e = p.current;
-		e && (o && !e.open && e.showModal(), !o && e.open && e.close());
-	}, [o]), /* @__PURE__ */ h("dialog", {
-		"aria-labelledby": m,
+		let e = _.current, t = v.current;
+		if (!(!e || !t)) {
+			if (l) {
+				b && (t.removeAttribute("aria-hidden"), t.removeAttribute("inert")), e.open || e.showModal(), x(!1);
+				return;
+			}
+			e.open && e.close(), t.setAttribute("aria-hidden", "true"), t.setAttribute("inert", ""), x(!0);
+		}
+	}, [b, l]), /* @__PURE__ */ h("dialog", {
+		"aria-labelledby": y,
 		className: Ia("game-ui-modal", t),
-		"data-position": l,
-		"data-size": u,
+		"data-position": u,
+		"data-size": p,
 		onCancel: (e) => {
-			e.preventDefault(), a();
+			e.preventDefault(), o();
 		},
 		onClick: (e) => {
-			r && e.target === p.current && a();
+			r && e.target === _.current && o();
 		},
-		ref: p,
+		ref: _,
 		children: /* @__PURE__ */ g("div", {
+			"aria-hidden": b ? !0 : void 0,
 			className: "game-ui-modal-frame",
+			inert: b || void 0,
+			ref: v,
 			children: [
 				/* @__PURE__ */ g("header", {
 					className: "game-ui-modal-header",
 					children: [/* @__PURE__ */ h("h2", {
 						className: "game-ui-modal-title",
-						id: m,
-						children: f
+						id: y,
+						children: m
 					}), /* @__PURE__ */ h("button", {
 						"aria-label": n,
 						className: "game-ui-icon-button game-ui-window-button",
-						onClick: a,
+						onClick: o,
 						type: "button",
 						children: /* @__PURE__ */ h(Ba, { kind: "close" })
 					})]
 				}),
 				/* @__PURE__ */ h("div", {
 					className: "game-ui-modal-body",
-					children: o ? e : null
+					children: l || a ? e : null
 				}),
 				i ? /* @__PURE__ */ h("footer", {
 					className: "game-ui-modal-footer",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pieai/swimmer-ui-kit",
-  "version": "2.7.2",
+  "version": "2.8.0",
   "description": "Token-driven React game UI kit for web and wrapped PieAI game surfaces.",
   "keywords": [
     "design-system",