@lingxia/elements 0.10.0 → 0.12.0

package/dist/native_component_wrapper_shared.d.ts

@@ -11,7 +11,6 @@ export interface NavigatorNativeAttrOptions {
     target?: NavigatorTarget;
     delta?: number;
     appId?: string;
-    path?: string;
     query?: NavigatorQuery;
     envVersion?: NavigatorEnvVersion;
     targetVersion?: string;

package/dist/native_component_wrapper_shared.js

@@ -41,8 +41,6 @@ export function buildNavigatorNativeAttrs(options, extraAttrs = {}) {
         result.target = options.target;
     if (options.appId)
         result["app-id"] = options.appId;
-    if (options.path)
-        result.path = options.path;
     if (options.query)
         result.query = JSON.stringify(options.query);
     if (options.envVersion)

package/dist/navigator.d.ts

@@ -13,7 +13,6 @@ export interface LxNavigatorEvent extends CustomEvent<LxNavigatorEventDetail> {
 export type LxNavigatorAttributes = {
     url?: string;
     page?: string;
-    path?: string;
     query?: string;
     'open-type'?: NavigatorOpenType;
     target?: NavigatorTarget;

package/dist/navigator.js

@@ -39,7 +39,6 @@ export class LxNavigatorElement extends HTMLElement {
         return [
             "url",
             "page",
-            "path",
             "query",
             "open-type",
             "target",
@@ -162,6 +161,8 @@ export class LxNavigatorElement extends HTMLElement {
         e.preventDefault();
         const url = this.getAttribute('url') || '';
         const page = this.getAttribute('page');
+        // Read the removed attribute only to provide a forward-only runtime error
+        // for untyped HTML callers instead of silently ignoring it.
         const path = this.getAttribute('path');
         const query = this.getAttribute('query');
         const openType = (this.getAttribute('open-type') || 'navigate');
@@ -282,6 +283,9 @@ export class LxNavigatorElement extends HTMLElement {
     async performNavigation(options) {
         const url = options.url || '';
         const delta = Number.isFinite(options.delta) && options.delta > 0 ? options.delta : 1;
+        if (options.path !== null && options.path !== undefined) {
+            throw new Error('path is not supported; pass the configured page name in page');
+        }
         if (options.openType === 'tel') {
             if (!options.phoneNumber) {
                 throw new Error('tel requires phone-number attribute');
@@ -290,12 +294,12 @@ export class LxNavigatorElement extends HTMLElement {
             return;
         }
         if (options.openType === 'exit') {
-            await this.callHost('navigator.navigateBackLxApp');
+            await this.callHost('navigator.navigateBackApp');
             return;
         }
         if (options.openType === 'navigateBack') {
             if (options.target === 'lxapp') {
-                await this.callHost('navigator.navigateBackLxApp');
+                await this.callHost('navigator.navigateBackApp');
                 return;
             }
             if (options.target === 'browser') {
@@ -313,9 +317,9 @@ export class LxNavigatorElement extends HTMLElement {
         }
         if (options.target === 'lxapp') {
             if (!options.appId) {
-                throw new Error('navigateToLxApp requires app-id');
+                throw new Error('navigateToApp requires app-id');
             }
-            await this.callHost('navigator.navigateToLxApp', this.buildLxAppTarget(options));
+            await this.callHost('navigator.navigateToApp', this.buildLxAppTarget(options));
             return;
         }
         if (options.target === 'self' && /^https?:\/\//i.test(url)) {
@@ -327,7 +331,7 @@ export class LxNavigatorElement extends HTMLElement {
         }
         const target = this.buildPageTarget(options);
         if (!target) {
-            throw new Error(`${options.openType} requires page or path`);
+            throw new Error(`${options.openType} requires page`);
         }
         switch (options.openType) {
             case 'navigate':
@@ -362,17 +366,13 @@ export class LxNavigatorElement extends HTMLElement {
         return parsed;
     }
     buildPageTarget(options) {
-        var _a, _b;
+        var _a;
         const page = (_a = options.page) === null || _a === void 0 ? void 0 : _a.trim();
-        const path = (_b = options.path) === null || _b === void 0 ? void 0 : _b.trim();
-        if (page && path) {
-            throw new Error('pass either page or path, not both');
-        }
-        if (!page && !path)
+        if (!page)
             return null;
         const query = this.readQuery(options.query);
         return {
-            ...(page ? { page } : { path: path }),
+            page,
             ...(query ? { query } : {}),
         };
     }

package/dist/video.d.ts

@@ -67,6 +67,8 @@ export declare class LxVideoElement extends HTMLElement {
     private attrObserver?;
     private resizeEventListener;
     private iOSScrollEventListener;
+    private scrollSettleFrame;
+    private containerScrollListener;
     private rawHandlers;
     private _pageBindings;
     private parseRotateValue;

package/dist/video.js

@@ -25,6 +25,21 @@ export class LxVideoElement extends HTMLElement {
         this.iOSScrollEventListener = {
             handleEvent: () => this.boundUpdatePosition(),
         };
+        this.scrollSettleFrame = null;
+        // Scroll events do not bubble, so a plain window listener misses inner
+        // scroll containers; the capture phase sees them all. Any ancestor
+        // scrolling moves the element's document rect, so re-measure (coalesced
+        // to one update per frame; decide() dedups unchanged rects).
+        this.containerScrollListener = {
+            handleEvent: () => {
+                if (this.scrollSettleFrame !== null)
+                    return;
+                this.scrollSettleFrame = requestAnimationFrame(() => {
+                    this.scrollSettleFrame = null;
+                    this.updatePosition();
+                });
+            },
+        };
         this.rawHandlers = {};
         this._pageBindings = {};
     }
@@ -538,6 +553,12 @@ export class LxVideoElement extends HTMLElement {
         if (isIOS()) {
             window.addEventListener("scroll", this.iOSScrollEventListener, { passive: true });
         }
+        else if (isWindows()) {
+            window.addEventListener("scroll", this.containerScrollListener, {
+                capture: true,
+                passive: true,
+            });
+        }
         if (isAndroid()) {
             this.removeLayoutInvalidationListener = addNativeComponentLayoutInvalidationListener(this.resizeEventListener);
         }
@@ -550,9 +571,16 @@ export class LxVideoElement extends HTMLElement {
         if (isIOS()) {
             window.removeEventListener("scroll", this.iOSScrollEventListener);
         }
+        else if (isWindows()) {
+            window.removeEventListener("scroll", this.containerScrollListener, { capture: true });
+        }
         (_a = this.removeLayoutInvalidationListener) === null || _a === void 0 ? void 0 : _a.call(this);
         this.removeLayoutInvalidationListener = undefined;
         this.stopSizeObserver();
+        if (this.scrollSettleFrame !== null) {
+            cancelAnimationFrame(this.scrollSettleFrame);
+            this.scrollSettleFrame = null;
+        }
         if (this.winSettleFrame !== null) {
             cancelAnimationFrame(this.winSettleFrame);
             this.winSettleFrame = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingxia/elements",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "private": false,
   "description": "LingXia custom elements — native-backed web components for LxApp pages",
   "type": "module",

package/src/native_component_wrapper_shared.ts

@@ -38,7 +38,6 @@ export interface NavigatorNativeAttrOptions {
   target?: NavigatorTarget;
   delta?: number;
   appId?: string;
-  path?: string;
   query?: NavigatorQuery;
   envVersion?: NavigatorEnvVersion;
   targetVersion?: string;
@@ -66,7 +65,6 @@ export function buildNavigatorNativeAttrs(
   if (options.page) result.page = options.page;
   if (options.target) result.target = options.target;
   if (options.appId) result["app-id"] = options.appId;
-  if (options.path) result.path = options.path;
   if (options.query) result.query = JSON.stringify(options.query);
   if (options.envVersion) result["env-version"] = options.envVersion;
   if (options.targetVersion) result["target-version"] = options.targetVersion;

package/src/navigator.ts

@@ -36,8 +36,7 @@ type LingXiaBridgeCall = {
 export type LxNavigatorAttributes = {
   // Navigation
   url?: string;                    // Browser URL for openUrl/browser target
-  page?: string;                   // Named page in lxapp.json
-  path?: string;                   // Raw page path, supports query string
+  page?: string;                   // Configured page name from lxapp.json; routes are unsupported
   query?: string;                  // JSON-encoded page query params
   'open-type'?: NavigatorOpenType; // Navigation type
   target?: NavigatorTarget;        // Navigation target (auto-inferred if not specified)
@@ -85,7 +84,6 @@ export class LxNavigatorElement extends HTMLElement {
     return [
       "url",
       "page",
-      "path",
       "query",
       "open-type",
       "target",
@@ -257,6 +255,8 @@ export class LxNavigatorElement extends HTMLElement {
 
     const url = this.getAttribute('url') || '';
     const page = this.getAttribute('page');
+    // Read the removed attribute only to provide a forward-only runtime error
+    // for untyped HTML callers instead of silently ignoring it.
     const path = this.getAttribute('path');
     const query = this.getAttribute('query');
     const openType = (this.getAttribute('open-type') || 'navigate') as NavigatorOpenType;
@@ -422,6 +422,10 @@ export class LxNavigatorElement extends HTMLElement {
     const url = options.url || '';
     const delta = Number.isFinite(options.delta) && options.delta > 0 ? options.delta : 1;
 
+    if (options.path !== null && options.path !== undefined) {
+      throw new Error('path is not supported; pass the configured page name in page');
+    }
+
     if (options.openType === 'tel') {
       if (!options.phoneNumber) {
         throw new Error('tel requires phone-number attribute');
@@ -431,13 +435,13 @@ export class LxNavigatorElement extends HTMLElement {
     }
 
     if (options.openType === 'exit') {
-      await this.callHost('navigator.navigateBackLxApp');
+      await this.callHost('navigator.navigateBackApp');
       return;
     }
 
     if (options.openType === 'navigateBack') {
       if (options.target === 'lxapp') {
-        await this.callHost('navigator.navigateBackLxApp');
+        await this.callHost('navigator.navigateBackApp');
         return;
       }
       if (options.target === 'browser') {
@@ -457,9 +461,9 @@ export class LxNavigatorElement extends HTMLElement {
 
     if (options.target === 'lxapp') {
       if (!options.appId) {
-        throw new Error('navigateToLxApp requires app-id');
+        throw new Error('navigateToApp requires app-id');
       }
-      await this.callHost('navigator.navigateToLxApp', this.buildLxAppTarget(options));
+      await this.callHost('navigator.navigateToApp', this.buildLxAppTarget(options));
       return;
     }
 
@@ -473,7 +477,7 @@ export class LxNavigatorElement extends HTMLElement {
 
     const target = this.buildPageTarget(options);
     if (!target) {
-      throw new Error(`${options.openType} requires page or path`);
+      throw new Error(`${options.openType} requires page`);
     }
 
     switch (options.openType) {
@@ -511,18 +515,13 @@ export class LxNavigatorElement extends HTMLElement {
 
   private buildPageTarget(options: {
     page?: string | null;
-    path?: string | null;
     query?: string | null;
-  }): { page?: string; path?: string; query?: NavigatorQuery } | null {
+  }): { page: string; query?: NavigatorQuery } | null {
     const page = options.page?.trim();
-    const path = options.path?.trim();
-    if (page && path) {
-      throw new Error('pass either page or path, not both');
-    }
-    if (!page && !path) return null;
+    if (!page) return null;
     const query = this.readQuery(options.query);
     return {
-      ...(page ? { page } : { path: path! }),
+      page,
       ...(query ? { query } : {}),
     };
   }
@@ -530,7 +529,6 @@ export class LxNavigatorElement extends HTMLElement {
   private buildLxAppTarget(options: {
     appId?: string | null;
     page?: string | null;
-    path?: string | null;
     query?: string | null;
     envVersion?: NavigatorEnvVersion | null;
     targetVersion?: string | null;

package/src/video.ts

@@ -106,6 +106,20 @@ export class LxVideoElement extends HTMLElement {
   private iOSScrollEventListener: EventListenerObject = {
     handleEvent: () => this.boundUpdatePosition(),
   };
+  private scrollSettleFrame: number | null = null;
+  // Scroll events do not bubble, so a plain window listener misses inner
+  // scroll containers; the capture phase sees them all. Any ancestor
+  // scrolling moves the element's document rect, so re-measure (coalesced
+  // to one update per frame; decide() dedups unchanged rects).
+  private containerScrollListener: EventListenerObject = {
+    handleEvent: () => {
+      if (this.scrollSettleFrame !== null) return;
+      this.scrollSettleFrame = requestAnimationFrame(() => {
+        this.scrollSettleFrame = null;
+        this.updatePosition();
+      });
+    },
+  };
   private rawHandlers: Record<string, EventListenerOrEventListenerObject> = {};
   private _pageBindings: Record<string, string> = {};
 
@@ -641,6 +655,11 @@ export class LxVideoElement extends HTMLElement {
     window.addEventListener("resize", this.resizeEventListener);
     if (isIOS()) {
       window.addEventListener("scroll", this.iOSScrollEventListener, { passive: true });
+    } else if (isWindows()) {
+      window.addEventListener("scroll", this.containerScrollListener, {
+        capture: true,
+        passive: true,
+      });
     }
     if (isAndroid()) {
       this.removeLayoutInvalidationListener = addNativeComponentLayoutInvalidationListener(this.resizeEventListener);
@@ -653,10 +672,16 @@ export class LxVideoElement extends HTMLElement {
     window.removeEventListener("resize", this.resizeEventListener);
     if (isIOS()) {
       window.removeEventListener("scroll", this.iOSScrollEventListener);
+    } else if (isWindows()) {
+      window.removeEventListener("scroll", this.containerScrollListener, { capture: true });
     }
     this.removeLayoutInvalidationListener?.();
     this.removeLayoutInvalidationListener = undefined;
     this.stopSizeObserver();
+    if (this.scrollSettleFrame !== null) {
+      cancelAnimationFrame(this.scrollSettleFrame);
+      this.scrollSettleFrame = null;
+    }
     if (this.winSettleFrame !== null) {
       cancelAnimationFrame(this.winSettleFrame);
       this.winSettleFrame = null;