@lingxia/types 0.5.1 → 0.6.0

package/dist/ui/index.d.ts

@@ -1,8 +1,6 @@
 /**
- * UI APIs
- * Corresponds to: lingxia-logic/src/ui/
+ * UI feedback, navigation, and surface control APIs.
  */
-import type { EventEmitter } from '../app';
 export interface ShowToastOptions {
     title: string;
     icon?: 'success' | 'error' | 'loading' | 'none';
@@ -31,24 +29,24 @@ export interface ShowActionSheetOptions {
 export interface ActionSheetResult {
     tapIndex: number;
 }
-export interface NavigateToOptions {
-    url: string;
-}
-export interface NavigateToResult {
-    eventEmitter: EventEmitter;
-}
+export type PageQueryValue = string | number | boolean | null | undefined;
+export type PageQuery = Record<string, PageQueryValue>;
+export type PageTargetOptions = {
+    page: string;
+    path?: never;
+    query?: PageQuery;
+} | {
+    path: string;
+    page?: never;
+    query?: PageQuery;
+};
+export type NavigateToOptions = PageTargetOptions;
 export interface NavigateBackOptions {
     delta: number;
 }
-export interface RedirectToOptions {
-    url: string;
-}
-export interface SwitchTabOptions {
-    url: string;
-}
-export interface ReLaunchOptions {
-    url: string;
-}
+export type RedirectToOptions = PageTargetOptions;
+export type SwitchTabOptions = PageTargetOptions;
+export type ReLaunchOptions = PageTargetOptions;
 export interface SetNavigationBarTitleOptions {
     title: string;
 }
@@ -78,15 +76,55 @@ export interface SetTabBarItemOptions {
     iconPath?: string;
     selectedIconPath?: string;
 }
-export interface ShowPopupOptions {
+export type SurfaceQueryValue = PageQueryValue;
+export type SurfaceQuery = PageQuery;
+export type SurfacePageTargetOptions = {
+    page: string;
+    path?: never;
+    url?: never;
+    query?: SurfaceQuery;
+} | {
+    path: string;
+    page?: never;
+    url?: never;
+    query?: SurfaceQuery;
+};
+export type SurfaceUrlTargetOptions = {
     url: string;
-    widthRatio?: number;
-    heightRatio?: number;
-    position?: 'center' | 'bottom' | 'left' | 'right';
-}
-export interface ShowPopupResult {
-    eventEmitter: EventEmitter;
+    page?: never;
+    path?: never;
+    query?: never;
+};
+export type SurfaceTargetOptions = SurfacePageTargetOptions | SurfaceUrlTargetOptions;
+/**
+ * Popup size value.
+ *
+ * - number: absolute size, must be > 0
+ * - `${number}%`: percentage size, must be > 0% and <= 100%
+ */
+export type PopupSurfaceSizeValue = number | `${number}%`;
+export interface PopupSurfaceSize {
+    /** Width for popup surface. */
+    width?: PopupSurfaceSizeValue;
+    /** Height for popup surface. */
+    height?: PopupSurfaceSizeValue;
+}
+export type PopupSurfaceOptions = SurfaceTargetOptions & {
+    kind: 'popup';
+    position?: 'center' | 'bottom' | 'left' | 'right' | 'top';
+    size?: PopupSurfaceSize;
+};
+export interface WindowSurfaceSize {
+    /** Window width, must be a positive number. */
+    width?: number;
+    /** Window height, must be a positive number. */
+    height?: number;
 }
+export type WindowSurfaceOptions = SurfaceTargetOptions & {
+    kind: 'window';
+    size?: WindowSurfaceSize;
+};
+export type SurfaceOpenOptions = PopupSurfaceOptions | WindowSurfaceOptions;
 export interface CapsuleRect {
     width?: number;
     height?: number;

package/dist/ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"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"}

package/dist/ui/index.js

@@ -1,7 +1,6 @@
 "use strict";
 /**
- * UI APIs
- * Corresponds to: lingxia-logic/src/ui/
+ * UI feedback, navigation, and surface control APIs.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=index.js.map

package/dist/ui/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":";AAAA;;;GAGG"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/update/index.d.ts

@@ -1,6 +1,5 @@
 /**
- * Update APIs
- * Corresponds to: lingxia-logic/src/update.rs
+ * Runtime update APIs.
  */
 export interface UpdateManager {
     applyUpdate(): void;
@@ -10,7 +9,7 @@ export interface UpdateManager {
 export interface UpdateReadyInfo {
     version?: string;
     isForceUpdate?: boolean;
-    releaseType?: "release" | "preview" | "developer" | string;
+    channel?: "release" | "preview" | "developer" | string;
 }
 export interface UpdateFailedInfo extends UpdateReadyInfo {
     error?: string;

package/dist/update/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/update/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,WAAW,IAAI,IAAI,CAAC;IACpB,aAAa,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/D,cAAc,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;CAC5D;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/update/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,WAAW,IAAI,IAAI,CAAC;IACpB,aAAa,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/D,cAAc,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;CACxD;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/update/index.js

@@ -1,7 +1,6 @@
 "use strict";
 /**
- * Update APIs
- * Corresponds to: lingxia-logic/src/update.rs
+ * Runtime update APIs.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=index.js.map

package/dist/update/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/update/index.ts"],"names":[],"mappings":";AAAA;;;GAGG"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/update/index.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingxia/types",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "TypeScript type definitions for the LingXia JS API",
   "repository": {
     "type": "git",
@@ -21,6 +21,11 @@
       "import": "./dist/app/index.js",
       "require": "./dist/app/index.js"
     },
+    "./lxapp": {
+      "types": "./dist/lxapp/index.d.ts",
+      "import": "./dist/lxapp/index.js",
+      "require": "./dist/lxapp/index.js"
+    },
     "./device": {
       "types": "./dist/device/index.d.ts",
       "import": "./dist/device/index.js",
@@ -46,6 +51,11 @@
       "import": "./dist/file/index.js",
       "require": "./dist/file/index.js"
     },
+    "./transfer": {
+      "types": "./dist/transfer/index.d.ts",
+      "import": "./dist/transfer/index.js",
+      "require": "./dist/transfer/index.js"
+    },
     "./location": {
       "types": "./dist/location/index.d.ts",
       "import": "./dist/location/index.js",

package/src/app/index.ts

@@ -1,8 +1,115 @@
 /**
- * App & Page APIs
- * Corresponds to: lingxia-lxapp/src/appservice/
+ * Host app, app lifecycle, and page instance APIs.
  */
 
+export interface AppBaseInfo {
+  language: string;
+  productName: string;
+  version: string;
+  SDKVersion: string;
+}
+
+export interface HostAppUpdateInfo {
+  version: string;
+  size?: number;
+  releaseNotes?: string[];
+  isForceUpdate: boolean;
+  /**
+   * Download and apply this checked update.
+   *
+   * `apply()` is single-use for this update object.
+   *
+   * The returned task can be awaited directly when progress is not needed, or
+   * consumed with `for await...of` to render progress.
+   *
+   * Direct package handoff is currently supported on Android and macOS. Other
+   * platforms reject with an unsupported-operation error; use `version` and
+   * `releaseNotes` to guide users to the appropriate app marketplace.
+   */
+  apply(): HostAppUpdateTask;
+}
+
+export type HostAppUpdateApplyStage = 'download' | 'install';
+
+export type HostAppUpdateCheckResult =
+  | {
+      hasUpdate: false;
+      update?: never;
+    }
+  | {
+      hasUpdate: true;
+      update: HostAppUpdateInfo;
+    };
+
+export type HostAppUpdateEvent =
+  | {
+      state: 'downloading';
+      downloadedBytes?: number;
+      progress?: number;
+    }
+  | {
+      state: 'downloaded' | 'installRequested';
+    }
+  | {
+      state: 'failed';
+      stage: HostAppUpdateApplyStage;
+      error: string;
+    };
+
+export interface HostAppUpdateResult {
+  state: 'installRequested';
+}
+
+export interface HostAppUpdateIteratorResult {
+  done: boolean;
+  value?: HostAppUpdateEvent;
+}
+
+export interface HostAppUpdateTask
+  extends PromiseLike<HostAppUpdateResult>,
+    AsyncIterable<HostAppUpdateEvent> {
+  next(): Promise<HostAppUpdateIteratorResult>;
+  /** Stops iteration only. It does not cancel an app update already handed to the platform. */
+  return(): Promise<HostAppUpdateIteratorResult>;
+  catch<TResult = never>(
+    onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null,
+  ): Promise<HostAppUpdateResult | TResult>;
+  finally(onfinally?: (() => void) | null): Promise<HostAppUpdateResult>;
+  wait(): Promise<HostAppUpdateResult>;
+}
+
+export interface HostAppApi {
+  getBaseInfo(): AppBaseInfo;
+
+  /**
+   * Check whether the host app has an update.
+   *
+   * This is a host app level capability and is only available to the home
+   * lxapp. Non-home lxapps receive a permission error.
+   *
+   * Calling this API opts the host app into custom update handling for this
+   * process. LingXia will not show its built-in host app update UI or
+   * auto-install host app updates after that point.
+   *
+   * If no update is available, or if an update requires a newer LingXia
+   * runtime than the current host app provides, `hasUpdate` is `false`.
+   *
+   * `checkUpdate()` may return version metadata on platforms that cannot apply
+   * host app packages directly. In that case, `update.apply()` rejects with an
+   * unsupported-operation error.
+   */
+  checkUpdate(): Promise<HostAppUpdateCheckResult>;
+
+  /**
+   * Exit the host app immediately.
+   *
+   * This API does not show a confirmation dialog. If the user should confirm
+   * first, call `lx.showModal(...)` in page logic and invoke `lx.app.exit()`
+   * only after the user confirms.
+   */
+  exit(): void;
+}
+
 export interface AppLifecycleEventArgs {
   source: 'host' | 'lxapp';
   reason:
@@ -15,15 +122,6 @@ export interface AppLifecycleEventArgs {
     | 'switch_away';
 }
 
-export type LxAppReleaseType = 'release' | 'preview' | 'developer';
-
-export interface LxAppInfo {
-  appId: string;
-  appName: string;
-  version: string;
-  releaseType: LxAppReleaseType;
-}
-
 export interface AppLaunchOptions {
   path?: string;
   query?: Record<string, string>;
@@ -62,18 +160,52 @@ export interface PageConfig<TData extends Record<string, unknown> = Record<strin
   [key: string]: unknown;
 }
 
+export type SurfaceCloseReason =
+  | 'user'
+  | 'programmatic'
+  | 'owner_closed'
+  | 'app_closed'
+  | 'failed'
+  | 'unknown';
+
+export interface SurfaceClosedEvent {
+  id: string;
+  kind: 'popup' | 'window';
+  reason: SurfaceCloseReason;
+}
+
+export interface Surface {
+  readonly id: string;
+  readonly kind: 'popup' | 'window';
+  /**
+   * Sends a message to the other side of a page surface.
+   *
+   * For the opener this targets the opened page. For the opened page this
+   * targets the opener. URL surfaces have no page-side receiver.
+  */
+  postMessage(message: unknown): void;
+  onMessage(handler: (message: unknown) => void): () => void;
+  onClose(handler: (event: SurfaceClosedEvent) => void): () => void;
+  close(): Promise<void>;
+}
+
+export interface PageMessagePort {
+  postMessage(message: unknown): void;
+  onMessage(handler: (message: unknown) => void): () => void;
+}
+
 export interface PageInstance<TData extends Record<string, unknown> = Record<string, unknown>> {
   data: TData;
   route: string;
+  /**
+   * Available when this page was opened by `lx.surface.open(...)`.
+   */
+  surface?: Surface;
+  /**
+   * Available when this page was opened by `lx.navigateTo(...)`.
+   */
+  opener?: PageMessagePort;
   setData(data: Partial<TData> | Record<string, unknown>, callback?: () => void): void;
-  getEventEmitter(): EventEmitter;
-}
-
-export interface EventEmitter {
-  on(event: string, handler: (...args: unknown[]) => void): void;
-  off(event: string, handler: (...args: unknown[]) => void): void;
-  emit(event: string, ...args: unknown[]): void;
-  once(event: string, handler: (...args: unknown[]) => void): void;
 }
 
 /**

package/src/device/actions.ts

@@ -1,6 +1,5 @@
 /**
- * Device action APIs
- * Corresponds to: lingxia-logic/src/device/actions.rs
+ * Device action APIs.
  */
 
 export interface MakePhoneCallOptions {

package/src/device/info.ts

@@ -1,6 +1,5 @@
 /**
- * Device info APIs
- * Corresponds to: lingxia-logic/src/device/info.rs
+ * Device info APIs.
  */
 
 export interface DeviceInfo {

package/src/device/network.ts

@@ -1,6 +1,5 @@
 /**
- * Network APIs
- * Corresponds to: lingxia-logic/src/device/network.rs
+ * Network status APIs.
  */
 
 // Matches mini-program style where possible: wifi/2g/3g/4g/5g/none/unknown.

package/src/device/wifi.ts

@@ -1,6 +1,5 @@
 /**
- * WiFi APIs
- * Corresponds to: lingxia-logic/src/device/wifi.rs
+ * Wi-Fi APIs.
  */
 
 export interface WifiInfo {

package/src/display/index.ts

@@ -1,6 +1,5 @@
 /**
- * Display APIs
- * Corresponds to: lingxia-logic/src/display.rs
+ * Display and orientation APIs.
  */
 
 export type DeviceOrientation = "portrait" | "landscape";

package/src/env/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Runtime environment constants.
+ */
+
+export interface LxEnv {
+  USER_DATA_PATH: string;
+  USER_CACHE_PATH: string;
+}

package/src/file/index.ts

@@ -1,6 +1,5 @@
 /**
  * File system APIs.
- * Corresponds to: lingxia-logic/src/fs.rs
  */
 
 export interface OpenFileOptions {
@@ -18,7 +17,6 @@ export interface OpenFileOptions {
   showMenu?: boolean;
 }
 
-/** Desktop only. Currently supported on macOS. Windows is planned. */
 export interface FileDialogFilter {
   /** Optional label shown in the native dialog. */
   name?: string;
@@ -26,88 +24,139 @@ export interface FileDialogFilter {
   extensions: string[];
 }
 
-/** Desktop only. Currently supported on macOS. Windows is planned. */
 export interface ChooseFileOptions {
   /** Allow selecting multiple files. Default: false */
   multiple?: boolean;
   /** Optional file filters. Empty or omitted means all file types. */
   filters?: FileDialogFilter[];
-  /** Dialog window title. Platform provides a default if omitted. */
-  title?: string;
   /** Initial directory the dialog opens in. Platform default if omitted. */
   defaultPath?: string;
 }
 
-/** Desktop only. Currently supported on macOS. Windows is planned. */
 export interface ChooseFileResult {
   /** True if the user dismissed the dialog without selecting. */
   canceled: boolean;
-  /** Absolute system paths of selected files. Empty when canceled. */
+  /** Native-consumable file references (paths or URIs). Empty when canceled. */
   paths: string[];
 }
 
-/** Desktop only. Currently supported on macOS. Windows is planned. */
 export interface ChooseDirectoryOptions {
-  /** Dialog window title. Platform provides a default if omitted. */
-  title?: string;
   /** Initial directory the dialog opens in. Platform default if omitted. */
   defaultPath?: string;
 }
 
-/** Desktop only. Currently supported on macOS. Windows is planned. */
 export interface ChooseDirectoryResult {
   /** True if the user dismissed the dialog without selecting. */
   canceled: boolean;
-  /** Absolute system path of the selected directory. Undefined when canceled. */
+  /** Native-consumable directory reference (path or URI). Undefined when canceled. */
   path?: string;
 }
 
-export interface DownloadOptions {
-  /** HTTP(S) source URL. */
-  url: string;
-  /** Optional request headers. */
-  headers?: Record<string, string>;
-  /** Request timeout in milliseconds. */
-  timeout?: number;
-  /** Optional destination path. Relative paths resolve under user data. */
-  filePath?: string;
-  /** Optional abort signal. */
-  signal?: AbortSignal;
+export interface ExistsOptions {
+  path: string;
 }
 
-export interface DownloadProgressEvent {
-  kind: 'progress' | 'paused' | 'resumed' | 'canceled' | 'success';
-  downloadedBytes?: number;
-  totalBytes?: number;
-  /** Present only when the total size is known. */
-  progress?: number;
-  result?: DownloadResult;
+export interface StatOptions {
+  path: string;
 }
 
-export interface DownloadIteratorResult {
-  done: boolean;
-  value?: DownloadProgressEvent;
+export interface FileStats {
+  isFile: boolean;
+  isDirectory: boolean;
+  isSymlink: boolean;
+  size: number;
+  lastModifiedTime?: number;
+  lastAccessedTime?: number;
+  createTime?: number;
+}
+
+export interface ReadDirOptions {
+  path: string;
+}
+
+export interface DirEntry {
+  name: string;
+  isFile: boolean;
+  isDirectory: boolean;
+  isSymlink: boolean;
+}
+
+export interface MkdirOptions {
+  path: string;
+  recursive?: boolean;
 }
 
-export interface DownloadResult {
-  /** Final accessible file path or URI. */
+export interface ReadTextFileOptions {
   filePath: string;
-  /** MIME type when available. */
-  mimeType?: string;
-  /** File size in bytes. */
-  size: number;
+  encoding: 'utf8' | 'base64';
+}
+
+export interface ReadBinaryFileOptions {
+  filePath: string;
+  encoding?: undefined;
+}
+
+export type ReadFileOptions = ReadTextFileOptions | ReadBinaryFileOptions;
+
+export interface ReadTextFileResult {
+  data: string;
+}
+
+export interface ReadBinaryFileResult {
+  data: ArrayBuffer;
+}
+
+export type ReadFileResult = ReadTextFileResult | ReadBinaryFileResult;
+
+export type BinaryFileData = ArrayBuffer | ArrayBufferView;
+
+export interface WriteTextFileOptions {
+  filePath: string;
+  data: string;
+  encoding?: 'utf8' | 'base64';
+  /** Defaults to false. */
+  overwrite?: boolean;
+}
+
+export interface WriteBinaryFileOptions {
+  filePath: string;
+  data: BinaryFileData;
+  encoding?: never;
+  /** Defaults to false. */
+  overwrite?: boolean;
+}
+
+export type WriteFileOptions = WriteTextFileOptions | WriteBinaryFileOptions;
+
+export interface CopyFileOptions {
+  srcPath: string;
+  destPath: string;
+  /** Defaults to false. */
+  overwrite?: boolean;
+}
+
+export interface RenameOptions {
+  oldPath: string;
+  newPath: string;
+  /** Defaults to false. */
+  overwrite?: boolean;
+}
+
+export interface RemoveOptions {
+  path: string;
+  recursive?: boolean;
 }
 
-export interface DownloadTask extends PromiseLike<DownloadResult>, AsyncIterable<DownloadProgressEvent> {
-  next(): Promise<DownloadIteratorResult>;
-  return(): Promise<DownloadIteratorResult>;
-  catch<TResult = never>(
-    onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null,
-  ): Promise<DownloadResult | TResult>;
-  finally(onfinally?: (() => void) | null): Promise<DownloadResult>;
-  pause(): Promise<void>;
-  resume(): Promise<void>;
-  cancel(): Promise<void>;
-  abort(): Promise<void>;
-  wait(): Promise<DownloadResult>;
+export interface FileManager {
+  exists(options: ExistsOptions): Promise<boolean>;
+  stat(options: StatOptions): Promise<FileStats>;
+  readDir(options: ReadDirOptions): Promise<AsyncIterableIterator<DirEntry>>;
+  mkdir(options: MkdirOptions): Promise<void>;
+  readFile(options: ReadTextFileOptions): Promise<ReadTextFileResult>;
+  readFile(options: ReadBinaryFileOptions): Promise<ReadBinaryFileResult>;
+  readFile(options: ReadFileOptions): Promise<ReadFileResult>;
+  writeFile(options: WriteFileOptions): Promise<void>;
+  copyFile(options: CopyFileOptions): Promise<void>;
+  rename(options: RenameOptions): Promise<void>;
+  remove(options: RemoveOptions): Promise<void>;
 }