@lingxia/elements 0.11.1 → 0.13.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

@@ -2,7 +2,7 @@ export type NavigatorOpenType = 'navigate' | 'redirect' | 'navigateBack' | 'reLa
 export type NavigatorTarget = 'self' | 'lxapp' | 'browser';
 export type NavigatorQueryValue = string | number | boolean | null | undefined;
 export type NavigatorQuery = Record<string, NavigatorQueryValue>;
-export type NavigatorEnvVersion = 'release' | 'preview' | 'develop';
+export type NavigatorEnvVersion = 'release' | 'preview' | 'developer';
 export interface LxNavigatorEventDetail {
     success?: boolean;
     errMsg?: string;
@@ -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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingxia/elements",
-  "version": "0.11.1",
+  "version": "0.13.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

@@ -18,7 +18,7 @@ export type NavigatorTarget =
 
 export type NavigatorQueryValue = string | number | boolean | null | undefined;
 export type NavigatorQuery = Record<string, NavigatorQueryValue>;
-export type NavigatorEnvVersion = 'release' | 'preview' | 'develop';
+export type NavigatorEnvVersion = 'release' | 'preview' | 'developer';
 
 export interface LxNavigatorEventDetail {
   success?: boolean;
@@ -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;