@lingxia/html 0.20.1 → 0.21.0

package/dist/global.d.ts

@@ -1,2 +1,2 @@
 export { pageReady, getPage, subscribePage } from "./page.js";
-export { getHost, subscribeHost } from "@lingxia/bridge";
+export { getHost, subscribeHost, holdLeaveGuard } from "@lingxia/bridge";

package/dist/global.es2020.js

@@ -366,12 +366,12 @@ ${ERROR_STYLES.replace(/\bbody\b/g, ".lx-page-fault")}`;
 	* whichever copy won the race to install the hook, and the other, which is the
 	* one the framework hooks read, would answer with the boot value forever.
 	*/
-	const fallbackStore$1 = {
+	const fallbackStore$2 = {
 		value: BRIDGE_CONFIG.displayLanguage?.trim() || "en-US",
 		listeners: /* @__PURE__ */ new Set()
 	};
-	function store$1() {
-		if (typeof window === "undefined") return fallbackStore$1;
+	function store$2() {
+		if (typeof window === "undefined") return fallbackStore$2;
 		if (!window.__lxDisplayLanguage) window.__lxDisplayLanguage = {
 			value: BRIDGE_CONFIG.displayLanguage?.trim() || "en-US",
 			listeners: /* @__PURE__ */ new Set()
@@ -406,7 +406,7 @@ ${ERROR_STYLES.replace(/\bbody\b/g, ".lx-page-fault")}`;
 	*/
 	function stampDocumentLanguage() {
 		if (typeof document !== "undefined" && document.documentElement) {
-			const language = store$1().value;
+			const language = store$2().value;
 			document.documentElement.lang = language;
 			document.documentElement.dir = textDirection(language);
 		}
@@ -425,7 +425,7 @@ ${ERROR_STYLES.replace(/\bbody\b/g, ".lx-page-fault")}`;
 	*/
 	function applyDisplayLanguage(next, revision) {
 		const normalized = typeof next === "string" ? next.trim() : "";
-		const current = store$1();
+		const current = store$2();
 		if (typeof revision === "number" && Number.isFinite(revision)) {
 			if (revision <= (current.revision ?? 0)) return;
 			current.revision = revision;
@@ -441,7 +441,7 @@ ${ERROR_STYLES.replace(/\bbody\b/g, ".lx-page-fault")}`;
 		value: applyDisplayLanguage
 	});
 	function getDisplayLanguage() {
-		return store$1().value;
+		return store$2().value;
 	}
 	/**
 	* Subscribe to host display-language changes. Returns an unsubscribe.
@@ -452,7 +452,7 @@ ${ERROR_STYLES.replace(/\bbody\b/g, ".lx-page-fault")}`;
 	* deliberately — it has no render loop to feed, so it delivers immediately.
 	*/
 	function subscribeDisplayLanguage(listener) {
-		const listeners = store$1().listeners;
+		const listeners = store$2().listeners;
 		listeners.add(listener);
 		return () => {
 			listeners.delete(listener);
@@ -493,8 +493,8 @@ ${ERROR_STYLES.replace(/\bbody\b/g, ".lx-page-fault")}`;
 	* language: the bridge module is present twice in a page, and the host must
 	* reach the copy the framework hooks read.
 	*/
-	function store() {
-		if (typeof window === "undefined") return fallbackStore;
+	function store$1() {
+		if (typeof window === "undefined") return fallbackStore$1;
 		if (!window.__lxSurfaceContext) {
 			const config = window.__LX_BRIDGE_CFG;
 			window.__lxSurfaceContext = {
@@ -505,7 +505,7 @@ ${ERROR_STYLES.replace(/\bbody\b/g, ".lx-page-fault")}`;
 		}
 		return window.__lxSurfaceContext;
 	}
-	const fallbackStore = {
+	const fallbackStore$1 = {
 		value: UNREPORTED,
 		revision: 0,
 		listeners: /* @__PURE__ */ new Set()
@@ -532,7 +532,7 @@ ${ERROR_STYLES.replace(/\bbody\b/g, ".lx-page-fault")}`;
 	*/
 	function applySurfaceContext(next, revision) {
 		const context = parse(next);
-		const current = store();
+		const current = store$1();
 		if (!context) return;
 		if (typeof revision === "number") {
 			if (revision <= current.revision) return;
@@ -553,14 +553,14 @@ ${ERROR_STYLES.replace(/\bbody\b/g, ".lx-page-fault")}`;
 	* than this API reports `compact` with a 0×0 viewport.
 	*/
 	function getSurfaceContext() {
-		return store().value;
+		return store$1().value;
 	}
 	/**
 	* Follow the adaptive context. Change-only, like `subscribeDisplayLanguage`,
 	* so it composes with `useSyncExternalStore`. Returns an unsubscribe.
 	*/
 	function subscribeSurfaceContext(listener) {
-		const listeners = store().listeners;
+		const listeners = store$1().listeners;
 		listeners.add(listener);
 		return () => {
 			listeners.delete(listener);
@@ -613,6 +613,108 @@ ${ERROR_STYLES.replace(/\bbody\b/g, ".lx-page-fault")}`;
 		};
 	}
 	//#endregion
+	//#region ../lingxia-bridge/dist/es2020/leave-guard.js
+	/**
+	* Guarding a page against being left with unsaved changes.
+	*
+	* While a page holds the guard, a user back or home (navigation bar buttons,
+	* Android/Harmony system back, the iOS/Harmony edge swipe) does not leave it.
+	* The host asks here instead, each holder answers, and when all agree the
+	* host carries out what the user asked for.
+	*
+	* Works without Logic: a View-only (`logic: false`) page owns its drafts, so
+	* the guard is held from the View.
+	*
+	* Its only import-time effect is installing the host hook (idempotent, shared
+	* across bundle copies). It reaches the host through the already-booted
+	* `window.LingXiaBridge` at call time and never imports the bridge module, so
+	* the plain-HTML global build can include it without booting a second bridge.
+	*/
+	function newStore() {
+		return {
+			holders: [],
+			sent: false,
+			tail: Promise.resolve(),
+			asking: false
+		};
+	}
+	const fallbackStore = newStore();
+	function store() {
+		if (typeof window === "undefined") return fallbackStore;
+		const host = window;
+		if (!host.__lxLeaveGuard) host.__lxLeaveGuard = newStore();
+		return host.__lxLeaveGuard;
+	}
+	function syncGuard() {
+		const s = store();
+		s.tail = s.tail.then(() => {
+			const want = s.holders.length > 0;
+			if (want === s.sent) return void 0;
+			s.sent = want;
+			return callHost("navigation.setLeaveGuard", { enabled: want }).catch((error) => {
+				s.sent = !want;
+				console.warn("[lingxia] leave guard not applied; the page is not guarded", error);
+			});
+		});
+	}
+	/** Host entry point: the user tried to leave a guarded page. */
+	function dispatchLeaveRequest(reason) {
+		const s = store();
+		if (s.asking) return;
+		s.asking = true;
+		const request = { reason };
+		const holders = s.holders.slice().reverse();
+		let agreed = Promise.resolve(true);
+		holders.forEach((handler) => {
+			agreed = agreed.then((leave) => leave ? handler(request) : false);
+		});
+		agreed.then((leave) => leave === true, (error) => {
+			console.error("[lingxia] leave guard handler failed; staying on the page", error);
+			return false;
+		}).then((leave) => {
+			s.asking = false;
+			if (!leave) return void 0;
+			return callHost("navigation.leave", { reason }).catch((error) => {
+				console.warn("[lingxia] leaving the page failed", error);
+			});
+		});
+	}
+	if (typeof window !== "undefined" && !window.__lingxiaDispatchLeaveRequest) Object.defineProperty(window, "__lingxiaDispatchLeaveRequest", {
+		configurable: false,
+		enumerable: false,
+		value: dispatchLeaveRequest
+	});
+	/**
+	* Hold this page against user back and home until the returned function is
+	* called. Hold while there are unsaved changes; `onRequest` is asked when the
+	* user tries to leave and returns whether they may.
+	*
+	* Holds are independent: each part of a page holds for itself, the page stays
+	* guarded while any hold is live, and every holder must agree to leave. A
+	* reloaded document, or a page that has left the stack, starts unguarded.
+	*/
+	function holdLeaveGuard(onRequest) {
+		const s = store();
+		const handler = (request) => onRequest(request);
+		s.holders.push(handler);
+		syncGuard();
+		return () => {
+			const index = s.holders.indexOf(handler);
+			if (index < 0) return;
+			s.holders.splice(index, 1);
+			syncGuard();
+		};
+	}
+	function callHost(route, input) {
+		const bridge = typeof window !== "undefined" ? window.LingXiaBridge : void 0;
+		if (!bridge) return Promise.reject(/* @__PURE__ */ new Error("LingXiaBridge is not available"));
+		try {
+			return bridge.invoke(route, input);
+		} catch (error) {
+			return Promise.reject(error);
+		}
+	}
+	//#endregion
 	//#region ../lingxia-page-runtime/dist/shared/startup.js
 	let pending;
 	/** Mount with complete initial data; a delayed startup stays recoverable. */
@@ -727,6 +829,7 @@ ${ERROR_STYLES.replace(/\bbody\b/g, ".lx-page-fault")}`;
 	//#endregion
 	exports.getHost = getHost;
 	exports.getPage = getPage;
+	exports.holdLeaveGuard = holdLeaveGuard;
 	exports.pageReady = pageReady;
 	exports.subscribeHost = subscribeHost;
 	exports.subscribePage = subscribePage;

package/dist/global.es5.js

@@ -427,14 +427,14 @@ var LingXiaPage = (function (exports) {
     * whichever copy won the race to install the hook, and the other, which is the
     * one the framework hooks read, would answer with the boot value forever.
     */
-    var fallbackStore$1 = {
+    var fallbackStore$2 = {
         value: ((_a = BRIDGE_CONFIG.displayLanguage) === null || _a === void 0 ? void 0 : _a.trim()) || "en-US",
         listeners: /* @__PURE__ */ new Set()
     };
-    function store$1() {
+    function store$2() {
         var _a;
         if (typeof window === "undefined")
-            return fallbackStore$1;
+            return fallbackStore$2;
         if (!window.__lxDisplayLanguage)
             window.__lxDisplayLanguage = {
                 value: ((_a = BRIDGE_CONFIG.displayLanguage) === null || _a === void 0 ? void 0 : _a.trim()) || "en-US",
@@ -472,7 +472,7 @@ var LingXiaPage = (function (exports) {
     */
     function stampDocumentLanguage() {
         if (typeof document !== "undefined" && document.documentElement) {
-            var language = store$1().value;
+            var language = store$2().value;
             document.documentElement.lang = language;
             document.documentElement.dir = textDirection(language);
         }
@@ -492,7 +492,7 @@ var LingXiaPage = (function (exports) {
     function applyDisplayLanguage(next, revision) {
         var _a;
         var normalized = typeof next === "string" ? next.trim() : "";
-        var current = store$1();
+        var current = store$2();
         if (typeof revision === "number" && Number.isFinite(revision)) {
             if (revision <= ((_a = current.revision) !== null && _a !== void 0 ? _a : 0))
                 return;
@@ -514,7 +514,7 @@ var LingXiaPage = (function (exports) {
             value: applyDisplayLanguage
         });
     function getDisplayLanguage() {
-        return store$1().value;
+        return store$2().value;
     }
     /**
     * Subscribe to host display-language changes. Returns an unsubscribe.
@@ -525,7 +525,7 @@ var LingXiaPage = (function (exports) {
     * deliberately — it has no render loop to feed, so it delivers immediately.
     */
     function subscribeDisplayLanguage(listener) {
-        var listeners = store$1().listeners;
+        var listeners = store$2().listeners;
         listeners.add(listener);
         return function () {
             listeners.delete(listener);
@@ -567,10 +567,10 @@ var LingXiaPage = (function (exports) {
     * language: the bridge module is present twice in a page, and the host must
     * reach the copy the framework hooks read.
     */
-    function store() {
+    function store$1() {
         var _a;
         if (typeof window === "undefined")
-            return fallbackStore;
+            return fallbackStore$1;
         if (!window.__lxSurfaceContext) {
             var config = window.__LX_BRIDGE_CFG;
             window.__lxSurfaceContext = {
@@ -581,7 +581,7 @@ var LingXiaPage = (function (exports) {
         }
         return window.__lxSurfaceContext;
     }
-    var fallbackStore = {
+    var fallbackStore$1 = {
         value: UNREPORTED,
         revision: 0,
         listeners: /* @__PURE__ */ new Set()
@@ -611,7 +611,7 @@ var LingXiaPage = (function (exports) {
     */
     function applySurfaceContext(next, revision) {
         var context = parse(next);
-        var current = store();
+        var current = store$1();
         if (!context)
             return;
         if (typeof revision === "number") {
@@ -639,14 +639,14 @@ var LingXiaPage = (function (exports) {
     * than this API reports `compact` with a 0×0 viewport.
     */
     function getSurfaceContext() {
-        return store().value;
+        return store$1().value;
     }
     /**
     * Follow the adaptive context. Change-only, like `subscribeDisplayLanguage`,
     * so it composes with `useSyncExternalStore`. Returns an unsubscribe.
     */
     function subscribeSurfaceContext(listener) {
-        var listeners = store().listeners;
+        var listeners = store$1().listeners;
         listeners.add(listener);
         return function () {
             listeners.delete(listener);
@@ -701,6 +701,117 @@ var LingXiaPage = (function (exports) {
         };
     }
     //#endregion
+    //#region ../lingxia-bridge/dist/es2020/leave-guard.js
+    /**
+    * Guarding a page against being left with unsaved changes.
+    *
+    * While a page holds the guard, a user back or home (navigation bar buttons,
+    * Android/Harmony system back, the iOS/Harmony edge swipe) does not leave it.
+    * The host asks here instead, each holder answers, and when all agree the
+    * host carries out what the user asked for.
+    *
+    * Works without Logic: a View-only (`logic: false`) page owns its drafts, so
+    * the guard is held from the View.
+    *
+    * Its only import-time effect is installing the host hook (idempotent, shared
+    * across bundle copies). It reaches the host through the already-booted
+    * `window.LingXiaBridge` at call time and never imports the bridge module, so
+    * the plain-HTML global build can include it without booting a second bridge.
+    */
+    function newStore() {
+        return {
+            holders: [],
+            sent: false,
+            tail: Promise.resolve(),
+            asking: false
+        };
+    }
+    var fallbackStore = newStore();
+    function store() {
+        if (typeof window === "undefined")
+            return fallbackStore;
+        var host = window;
+        if (!host.__lxLeaveGuard)
+            host.__lxLeaveGuard = newStore();
+        return host.__lxLeaveGuard;
+    }
+    function syncGuard() {
+        var s = store();
+        s.tail = s.tail.then(function () {
+            var want = s.holders.length > 0;
+            if (want === s.sent)
+                return void 0;
+            s.sent = want;
+            return callHost("navigation.setLeaveGuard", { enabled: want }).catch(function (error) {
+                s.sent = !want;
+                console.warn("[lingxia] leave guard not applied; the page is not guarded", error);
+            });
+        });
+    }
+    /** Host entry point: the user tried to leave a guarded page. */
+    function dispatchLeaveRequest(reason) {
+        var s = store();
+        if (s.asking)
+            return;
+        s.asking = true;
+        var request = { reason: reason };
+        var holders = s.holders.slice().reverse();
+        var agreed = Promise.resolve(true);
+        holders.forEach(function (handler) {
+            agreed = agreed.then(function (leave) { return leave ? handler(request) : false; });
+        });
+        agreed.then(function (leave) { return leave === true; }, function (error) {
+            console.error("[lingxia] leave guard handler failed; staying on the page", error);
+            return false;
+        }).then(function (leave) {
+            s.asking = false;
+            if (!leave)
+                return void 0;
+            return callHost("navigation.leave", { reason: reason }).catch(function (error) {
+                console.warn("[lingxia] leaving the page failed", error);
+            });
+        });
+    }
+    if (typeof window !== "undefined" && !window.__lingxiaDispatchLeaveRequest)
+        Object.defineProperty(window, "__lingxiaDispatchLeaveRequest", {
+            configurable: false,
+            enumerable: false,
+            value: dispatchLeaveRequest
+        });
+    /**
+    * Hold this page against user back and home until the returned function is
+    * called. Hold while there are unsaved changes; `onRequest` is asked when the
+    * user tries to leave and returns whether they may.
+    *
+    * Holds are independent: each part of a page holds for itself, the page stays
+    * guarded while any hold is live, and every holder must agree to leave. A
+    * reloaded document, or a page that has left the stack, starts unguarded.
+    */
+    function holdLeaveGuard(onRequest) {
+        var s = store();
+        var handler = function (request) { return onRequest(request); };
+        s.holders.push(handler);
+        syncGuard();
+        return function () {
+            var index = s.holders.indexOf(handler);
+            if (index < 0)
+                return;
+            s.holders.splice(index, 1);
+            syncGuard();
+        };
+    }
+    function callHost(route, input) {
+        var bridge = typeof window !== "undefined" ? window.LingXiaBridge : void 0;
+        if (!bridge)
+            return Promise.reject(/* @__PURE__ */ new Error("LingXiaBridge is not available"));
+        try {
+            return bridge.invoke(route, input);
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+    }
+    //#endregion
     //#region ../lingxia-page-runtime/dist/shared/startup.js
     var pending;
     /** Mount with complete initial data; a delayed startup stays recoverable. */
@@ -834,6 +945,7 @@ var LingXiaPage = (function (exports) {
     //#endregion
     exports.getHost = getHost;
     exports.getPage = getPage;
+    exports.holdLeaveGuard = holdLeaveGuard;
     exports.pageReady = pageReady;
     exports.subscribeHost = subscribeHost;
     exports.subscribePage = subscribePage;

package/dist/global.js

@@ -2,4 +2,4 @@
 // the module. The host already booted the bridge, so the build aliases
 // `@lingxia/bridge` to its side-effect-free parts.
 export { pageReady, getPage, subscribePage } from "./page.js";
-export { getHost, subscribeHost } from "@lingxia/bridge";
+export { getHost, subscribeHost, holdLeaveGuard } from "@lingxia/bridge";

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { pageReady, getPage, subscribePage } from "./page.js";
-export { getHost, subscribeHost, type LxHost } from "@lingxia/bridge";
+export { getHost, subscribeHost, holdLeaveGuard, type LxHost, type LxLeaveHandler, type LxLeaveReason, type LxLeaveRequest, } from "@lingxia/bridge";
 export type { ActionMap, DeepReadonly, Snapshot } from "@lingxia/page-runtime";
 export { registerInlineNativeComponents, registerInlineNativeAuthorComponents, compileInlineNativeRoot, compileInlineNativeForest, unwrapNativeEventPayload, } from "@lingxia/elements";

package/dist/index.js

@@ -1,3 +1,3 @@
 export { pageReady, getPage, subscribePage } from "./page.js";
-export { getHost, subscribeHost } from "@lingxia/bridge";
+export { getHost, subscribeHost, holdLeaveGuard, } from "@lingxia/bridge";
 export { registerInlineNativeComponents, registerInlineNativeAuthorComponents, compileInlineNativeRoot, compileInlineNativeForest, unwrapNativeEventPayload, } from "@lingxia/elements";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingxia/html",
-  "version": "0.20.1",
+  "version": "0.21.0",
   "private": false,
   "description": "LingXia HTML runtime for lxapp pages",
   "type": "module",
@@ -21,9 +21,9 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@lingxia/bridge": "~0.20.1",
-    "@lingxia/elements": "~0.20.1",
-    "@lingxia/page-runtime": "~0.20.1"
+    "@lingxia/bridge": "~0.21.0",
+    "@lingxia/elements": "~0.21.0",
+    "@lingxia/page-runtime": "~0.21.0"
   },
   "devDependencies": {
     "@lingxia/bridge": "file:../lingxia-bridge",