@lingxia/page-runtime 0.11.1 → 0.12.0

package/dist/index.d.ts

@@ -1 +1,2 @@
 export { ensurePageBridgeSubscription, getPageActions, getPageSnapshot, getPageStateInfo, subscribePageData, subscribePageSnapshot, type ActionMap, type Snapshot, } from "./shared/runtime.js";
+export { getPageChromeLayout, installPageChromeRuntime, subscribePageChromeLayout, type LxPageChrome, type PageChromeLayoutListener, type PageChromeLayoutSnapshot, type PageChromeRect, } from "./page-chrome.js";

package/dist/index.js

@@ -1 +1,2 @@
 export { ensurePageBridgeSubscription, getPageActions, getPageSnapshot, getPageStateInfo, subscribePageData, subscribePageSnapshot, } from "./shared/runtime.js";
+export { getPageChromeLayout, installPageChromeRuntime, subscribePageChromeLayout, } from "./page-chrome.js";

package/dist/page-chrome.d.ts

@@ -0,0 +1,45 @@
+export interface PageChromeRect {
+    readonly width: number;
+    readonly height: number;
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+    readonly left: number;
+}
+export interface PageChromeLayoutSnapshot {
+    readonly revision: number;
+    /**
+     * Height of the runtime-owned drag strip across the top of a
+     * `chrome: 'full'` window. Zero everywhere else. Lay content out beneath it
+     * the same way you already do for the capsule — the strip stays draggable
+     * whether or not the page cooperates.
+     */
+    readonly topInset: number;
+    readonly bottomInset: number;
+    readonly capsuleRect: PageChromeRect | null;
+    readonly capsuleInlineEndInset: number;
+}
+export interface LxPageChrome {
+    readonly layout: PageChromeLayoutSnapshot;
+}
+export type PageChromeLayoutListener = (layout: PageChromeLayoutSnapshot) => void;
+declare global {
+    interface Window {
+        readonly lxPageChrome: LxPageChrome;
+    }
+    interface WindowEventMap {
+        lxpagechromechange: CustomEvent<PageChromeLayoutSnapshot>;
+    }
+}
+export declare function shouldApplyPageChromeRevision(currentRevision: number, nextRevision: number): boolean;
+/** Read the latest realized page-chrome layout synchronously. */
+export declare function getPageChromeLayout(): PageChromeLayoutSnapshot;
+/** Subscribe to realized page-chrome layout changes. */
+export declare function subscribePageChromeLayout(listener: PageChromeLayoutListener): () => void;
+/** Ensure browser previews have the same synchronous contract as native pages. */
+export declare function installPageChromeRuntime(): LxPageChrome | undefined;
+declare global {
+    interface Window {
+        readonly __lingxiaApplyPageChrome?: (layout: PageChromeLayoutSnapshot, scheme: "light" | "dark") => void;
+    }
+}

package/dist/page-chrome.js

@@ -0,0 +1,76 @@
+const initialLayout = Object.freeze({
+    revision: 0,
+    topInset: 0,
+    bottomInset: 0,
+    capsuleRect: null,
+    capsuleInlineEndInset: 0,
+});
+export function shouldApplyPageChromeRevision(currentRevision, nextRevision) {
+    return nextRevision >= currentRevision;
+}
+function projectPageChromeLayout(layout) {
+    const root = document.documentElement;
+    root?.style.setProperty("--lx-page-chrome-top-inset", `${layout.topInset}px`);
+    root?.style.setProperty("--lx-page-chrome-bottom-inset", `${layout.bottomInset}px`);
+    root?.style.setProperty("--lx-page-chrome-capsule-inline-end-inset", `${layout.capsuleInlineEndInset}px`);
+}
+/** Read the latest realized page-chrome layout synchronously. */
+export function getPageChromeLayout() {
+    if (typeof window === "undefined")
+        return initialLayout;
+    return installPageChromeRuntime()?.layout ?? initialLayout;
+}
+/** Subscribe to realized page-chrome layout changes. */
+export function subscribePageChromeLayout(listener) {
+    if (typeof window === "undefined")
+        return () => { };
+    installPageChromeRuntime();
+    const handleChange = (event) => {
+        listener(event.detail);
+    };
+    window.addEventListener("lxpagechromechange", handleChange);
+    return () => window.removeEventListener("lxpagechromechange", handleChange);
+}
+/** Ensure browser previews have the same synchronous contract as native pages. */
+export function installPageChromeRuntime() {
+    if (typeof window === "undefined")
+        return undefined;
+    if (window.lxPageChrome)
+        return window.lxPageChrome;
+    let layout = initialLayout;
+    const api = Object.freeze({
+        get layout() {
+            return layout;
+        },
+    });
+    Object.defineProperty(window, "lxPageChrome", {
+        configurable: false,
+        enumerable: true,
+        value: api,
+    });
+    Object.defineProperty(window, "__lingxiaApplyPageChrome", {
+        configurable: false,
+        enumerable: false,
+        value(next, scheme) {
+            if (!shouldApplyPageChromeRevision(layout.revision, next.revision))
+                return;
+            const capsuleRect = next.capsuleRect
+                ? Object.freeze({ ...next.capsuleRect })
+                : null;
+            layout = Object.freeze({ ...next, capsuleRect });
+            projectPageChromeLayout(layout);
+            const root = document.documentElement;
+            if (root) {
+                root.style.colorScheme = scheme;
+                // Authoritative theme signal: platform media queries can lag an
+                // in-place appearance switch (Android locks them at webview
+                // creation); [data-theme] CSS keys off this instead.
+                root.setAttribute('data-theme', scheme);
+            }
+            window.dispatchEvent(new CustomEvent("lxpagechromechange", { detail: layout }));
+        },
+    });
+    projectPageChromeLayout(initialLayout);
+    return api;
+}
+installPageChromeRuntime();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingxia/page-runtime",
-  "version": "0.11.1",
+  "version": "0.12.0",
   "private": false,
   "description": "Shared page runtime core for LingXia lxapp frameworks",
   "type": "module",
@@ -16,10 +16,11 @@
   "scripts": {
     "build": "npm run clean && npm --prefix ../lingxia-bridge run build:types && tsc -p tsconfig.json",
     "clean": "rm -rf dist",
+    "test:runtime": "npm run build && node tests/page-chrome-revision.mjs",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@lingxia/bridge": "^0.11.1"
+    "@lingxia/bridge": "~0.12.0"
   },
   "devDependencies": {
     "@lingxia/bridge": "file:../lingxia-bridge",