@lingxia/types 0.3.0 → 0.4.3

package/dist/index.d.ts

@@ -8,24 +8,27 @@ export * from './device';
 export * from './display';
 export * from './input';
 export * from './storage';
-export * from './document';
+export * from './file';
 export * from './location';
 export * from './navigator';
 export * from './system';
 export * from './update';
 export * from './media';
 export * from './ui';
-import type { AppConfig, AppInstance, PageConfig, PageInstance } from './app';
+export * from './error';
+export * from './generated/error';
+export * from './generated/i18n';
+import type { AppConfig, AppInstance, LxAppInfo, PageConfig, PageInstance } from './app';
 import type { DeviceInfo, ScreenInfo, MakePhoneCallOptions, WifiInfo, ConnectWifiOptions, WifiConnectedCallback, NetworkInfo, NetworkChangeCallback } from './device';
 import type { KeyEventCallback } from './input';
 import type { LxEnv, Storage } from './storage';
-import type { OpenDocumentOptions } from './document';
-import type { AppOrientationInfo, SetAppOrientationOptions } from './display';
+import type { OpenDocumentOptions, ChooseDirectoryOptions, ChooseDirectoryResult, ChooseFileOptions, ChooseFileResult, DownloadTask, DownloadOptions } from './file';
+import type { DeviceOrientation, DeviceOrientationChangeEvent } from './display';
 import type { GetLocationOptions, LocationInfo } from './location';
 import type { AppBaseInfo, SystemSettingInfo, OpenURLOptions } from './system';
 import type { NavigateToLxAppOptions } from './navigator';
 import type { UpdateManager } from './update';
-import type { GetImageInfoOptions, ImageInfo, CompressImageOptions, CompressImageResult, CompressVideoOptions, CompressVideoResult, GetVideoInfoOptions, VideoInfo, ExtractVideoThumbnailOptions, ExtractVideoThumbnailResult, ChooseMediaOptions, ChosenMediaEntry, PreviewMediaOptions, SaveMediaOptions, ScanCodeOptions, ScanCodeResult, VideoContext } from './media';
+import type { GetImageInfoOptions, ImageInfo, CompressImageOptions, CompressImageResult, CompressVideoOptions, CompressVideoResult, GetVideoInfoOptions, VideoInfo, ExtractVideoThumbnailOptions, ExtractVideoThumbnailResult, ChooseMediaOptions, ChosenMediaEntry, PreviewMediaOptions, PreviewMediaResult, SaveMediaOptions, ScanCodeOptions, ScanCodeResult, VideoContext } from './media';
 import type { ShowToastOptions, ShowModalOptions, ModalResult, ShowActionSheetOptions, ActionSheetResult, NavigateToOptions, NavigateToResult, NavigateBackOptions, RedirectToOptions, SwitchTabOptions, ReLaunchOptions, SetNavigationBarTitleOptions, SetNavigationBarColorOptions, TabBarRedDotOptions, SetTabBarBadgeOptions, RemoveTabBarBadgeOptions, SetTabBarStyleOptions, SetTabBarItemOptions, ShowPopupOptions, ShowPopupResult, CapsuleRect } from './ui';
 export interface Lx {
     env: LxEnv;
@@ -44,14 +47,17 @@ export interface Lx {
     getNetworkInfo(): Promise<NetworkInfo>;
     onNetworkChange(callback: NetworkChangeCallback): void;
     offNetworkChange(callback?: NetworkChangeCallback): void;
-    getAppOrientation(): AppOrientationInfo;
-    setAppOrientation(options: SetAppOrientationOptions): boolean;
+    setDeviceOrientation(orientation: DeviceOrientation): boolean;
+    onDeviceOrientationChange(callback: (event: DeviceOrientationChangeEvent) => void): void;
+    offDeviceOrientationChange(callback?: (event: DeviceOrientationChangeEvent) => void): void;
     openDocument(options: OpenDocumentOptions): void;
+    downloadFile(options: DownloadOptions): DownloadTask;
     getStorage(): Storage;
     getLocation(options?: GetLocationOptions): Promise<LocationInfo>;
     navigateToLxApp(options: NavigateToLxAppOptions): Promise<void>;
     navigateBackLxApp(): Promise<void>;
     getAppBaseInfo(): AppBaseInfo;
+    getLxAppInfo(): LxAppInfo;
     getSystemSetting(): SystemSettingInfo;
     openURL(options: OpenURLOptions): void;
     getUpdateManager(): UpdateManager;
@@ -61,7 +67,19 @@ export interface Lx {
     getVideoInfo(options: GetVideoInfoOptions): Promise<VideoInfo>;
     extractVideoThumbnail(options: ExtractVideoThumbnailOptions): Promise<ExtractVideoThumbnailResult>;
     chooseMedia(options?: ChooseMediaOptions): Promise<ChosenMediaEntry[]>;
-    previewMedia(options: PreviewMediaOptions): void;
+    /**
+     * Opens native media preview.
+     *
+     * Supports:
+     * - a single source path string for the simplest case
+     * - a single-item object for per-item options like `rotate`, `objectFit`, or `durationMs`
+     * - a sequence object for multi-item preview with `sources`, `startIndex`, and `advance`
+     *
+     * Resolves when preview session is closed (manual/auto/interrupted/error).
+     * Rejects with a cancellation error if `signal` is aborted, and abort also requests
+     * the active native preview session to close immediately.
+     */
+    previewMedia(options: PreviewMediaOptions): Promise<PreviewMediaResult>;
     saveImageToPhotosAlbum(options: SaveMediaOptions): Promise<void>;
     saveVideoToPhotosAlbum(options: SaveMediaOptions): Promise<void>;
     scanCode(options?: ScanCodeOptions): Promise<ScanCodeResult>;
@@ -91,6 +109,10 @@ export interface Lx {
     startPullDownRefresh(): void;
     stopPullDownRefresh(): void;
     getCapsuleRect(): Promise<CapsuleRect>;
+    /** Desktop only. Currently supported on macOS. Windows is planned. */
+    chooseFile(options?: ChooseFileOptions): Promise<ChooseFileResult>;
+    /** Desktop only. Currently supported on macOS. Windows is planned. */
+    chooseDirectory(options?: ChooseDirectoryOptions): Promise<ChooseDirectoryResult>;
     onKeyDown(callback: KeyEventCallback): void;
     offKeyDown(callback?: KeyEventCallback): void;
     onKeyUp(callback: KeyEventCallback): void;

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -24,11 +24,14 @@ __exportStar(require("./device"), exports);
 __exportStar(require("./display"), exports);
 __exportStar(require("./input"), exports);
 __exportStar(require("./storage"), exports);
-__exportStar(require("./document"), exports);
+__exportStar(require("./file"), exports);
 __exportStar(require("./location"), exports);
 __exportStar(require("./navigator"), exports);
 __exportStar(require("./system"), exports);
 __exportStar(require("./update"), exports);
 __exportStar(require("./media"), exports);
 __exportStar(require("./ui"), exports);
+__exportStar(require("./error"), exports);
+__exportStar(require("./generated/error"), exports);
+__exportStar(require("./generated/i18n"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,wCAAsB;AACtB,2CAAyB;AACzB,4CAA0B;AAC1B,0CAAwB;AACxB,4CAA0B;AAC1B,6CAA2B;AAC3B,6CAA2B;AAC3B,8CAA4B;AAC5B,2CAAyB;AACzB,2CAAyB;AACzB,0CAAwB;AACxB,uCAAqB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,wCAAsB;AACtB,2CAAyB;AACzB,4CAA0B;AAC1B,0CAAwB;AACxB,4CAA0B;AAC1B,yCAAuB;AACvB,6CAA2B;AAC3B,8CAA4B;AAC5B,2CAAyB;AACzB,2CAAyB;AACzB,0CAAwB;AACxB,uCAAqB;AACrB,0CAAwB;AACxB,oDAAkC;AAClC,mDAAiC"}

package/dist/media/index.d.ts

@@ -165,13 +165,110 @@ export interface ChosenMediaEntry {
     fileType: 'image' | 'video';
     isOriginal: boolean;
 }
-export interface PreviewMediaItem {
+export type MediaRotation = 0 | 90 | 180 | 270;
+export type MediaObjectFit = 'cover' | 'contain' | 'fill' | 'fit';
+export interface PreviewMediaSource {
+    /**
+     * Media source path.
+     * Recommended: `lx://` path (for example `lx://usercache/...`) or a sandbox-local path
+     * that can be resolved by runtime access rules.
+     */
     path: string;
     type?: 'image' | 'video';
+    /**
+     * Optional poster image path for video preview.
+     * Uses the same path contract as `path`.
+     */
     coverPath?: string;
+    /**
+     * Optional clockwise rotation in degrees (`0 | 90 | 180 | 270`).
+     * Default: when omitted, runtime resolves orientation from media metadata.
+     */
+    rotate?: MediaRotation;
+    /**
+     * Optional display fit mode for video preview.
+     * Default: `contain`.
+     */
+    objectFit?: MediaObjectFit;
+    /**
+     * Image display duration in milliseconds.
+     * Effective only for image items and only when preview `advance` is not `manual`.
+     */
+    durationMs?: number;
+}
+export type PreviewMediaAdvance = 'manual' | 'next' | 'loop';
+export interface PreviewMediaSingleOptions extends PreviewMediaSource {
+    /**
+     * Auto behavior for the preview session.
+     *
+     * - `manual`: never auto-advance
+     * - `next`: advance to the next item; if already on the last item, close the session
+     * - `loop`: advance to the next item; if already on the last item, wrap to the first item
+     *
+     * Default: `manual`
+     */
+    advance?: PreviewMediaAdvance;
+    /**
+     * Optional cancellation signal for the preview request.
+     *
+     * Aborting rejects the returned promise with a cancellation error and requests the active
+     * native preview session to close immediately.
+     */
+    signal?: AbortSignal;
+    /**
+     * Whether to show the top `current/total` indicator.
+     *
+     * Default: `true` when previewing multiple items, otherwise `false`.
+     */
+    showIndexIndicator?: boolean;
+}
+export interface PreviewMediaSequenceOptions {
+    /**
+     * Preview list. Supports images, videos, or a mixed queue.
+     */
+    sources: PreviewMediaSource[];
+    /**
+     * Initial item index in `sources`.
+     * Must be an integer.
+     * Out-of-range values are clamped by runtime.
+     * Default: `0`.
+     */
+    startIndex?: number;
+    /**
+     * Auto behavior for the preview session.
+     *
+     * - `manual`: never auto-advance
+     * - `next`: advance to the next item; if already on the last item, close the session
+     * - `loop`: advance to the next item; if already on the last item, wrap to the first item
+     *
+     * Default: `manual`
+     */
+    advance?: PreviewMediaAdvance;
+    /**
+     * Optional cancellation signal for the preview request.
+     *
+     * Aborting rejects the returned promise with a cancellation error and requests the active
+     * native preview session to close immediately.
+     */
+    signal?: AbortSignal;
+    /**
+     * Whether to show the top `current/total` indicator.
+     *
+     * Default: `true` when previewing multiple items, otherwise `false`.
+     */
+    showIndexIndicator?: boolean;
 }
-export interface PreviewMediaOptions {
-    sources: PreviewMediaItem[];
+export type PreviewMediaOptions = string | PreviewMediaSingleOptions | PreviewMediaSequenceOptions;
+export type PreviewMediaCloseReason = 'manual' | 'completed' | 'interrupted' | 'error';
+export interface PreviewMediaResult {
+    /**
+     * Why the preview session finished.
+     */
+    reason: PreviewMediaCloseReason;
+    /**
+     * Last active item index before close.
+     */
+    lastIndex: number;
 }
 export interface SaveMediaOptions {
     filePath: string;

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

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

package/dist/system/index.d.ts

@@ -6,6 +6,7 @@ export interface AppBaseInfo {
     language: string;
     productName: string;
     version: string;
+    SDKVersion: string;
 }
 export interface SystemSettingInfo {
     bluetoothEnabled: boolean;
@@ -14,6 +15,6 @@ export interface SystemSettingInfo {
 }
 export interface OpenURLOptions {
     url: string;
-    openIn?: 'external' | 'internal';
+    target?: 'self' | 'external';
 }
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/system/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;CAClC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/system/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;CAC9B"}

package/dist/update/index.d.ts

@@ -4,7 +4,15 @@
  */
 export interface UpdateManager {
     applyUpdate(): void;
-    onUpdateReady(callback: () => void): void;
-    onUpdateFailed(callback: () => void): void;
+    onUpdateReady(callback: (info: UpdateReadyInfo) => void): void;
+    onUpdateFailed(callback: (info: UpdateFailedInfo) => void): void;
+}
+export interface UpdateReadyInfo {
+    version?: string;
+    isForceUpdate?: boolean;
+    releaseType?: "release" | "preview" | "developer" | string;
+}
+export interface UpdateFailedInfo extends UpdateReadyInfo {
+    error?: string;
 }
 //# sourceMappingURL=index.d.ts.map

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,MAAM,IAAI,GAAG,IAAI,CAAC;IAC1C,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAC5C"}
+{"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"}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@lingxia/types",
-  "version": "0.3.0",
+  "version": "0.4.3",
   "description": "TypeScript type definitions for the LingXia JS API",
   "repository": {
     "type": "git",
     "url": "https://github.com/LingXia-Dev/LingXia.git",
-    "directory": "lingxia-types"
+    "directory": "packages/lingxia-types"
   },
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -41,10 +41,10 @@
       "import": "./dist/storage/index.js",
       "require": "./dist/storage/index.js"
     },
-    "./document": {
-      "types": "./dist/document/index.d.ts",
-      "import": "./dist/document/index.js",
-      "require": "./dist/document/index.js"
+    "./file": {
+      "types": "./dist/file/index.d.ts",
+      "import": "./dist/file/index.js",
+      "require": "./dist/file/index.js"
     },
     "./location": {
       "types": "./dist/location/index.d.ts",
@@ -75,6 +75,11 @@
       "types": "./dist/ui/index.d.ts",
       "import": "./dist/ui/index.js",
       "require": "./dist/ui/index.js"
+    },
+    "./error": {
+      "types": "./dist/error.d.ts",
+      "import": "./dist/error.js",
+      "require": "./dist/error.js"
     }
   },
   "files": [
@@ -82,7 +87,8 @@
     "src"
   ],
   "scripts": {
-    "build": "tsc",
+    "gen:i18n": "node scripts/gen-i18n.mjs",
+    "build": "npm run gen:i18n && tsc",
     "clean": "rm -rf dist",
     "prepublishOnly": "npm run clean && npm run build"
   },

package/src/app/index.ts

@@ -15,6 +15,15 @@ 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>;

package/src/display/index.ts

@@ -3,10 +3,8 @@
  * Corresponds to: lingxia-logic/src/display.rs
  */
 
-export interface AppOrientationInfo {
-  orientation: string;
-}
+export type DeviceOrientation = "portrait" | "landscape";
 
-export interface SetAppOrientationOptions {
-  orientation: string;
+export interface DeviceOrientationChangeEvent {
+  value: DeviceOrientation;
 }

package/src/error.ts

@@ -0,0 +1,82 @@
+import { ERR_CODE_INFO_BY_CODE, type LxErrorCodeInfo } from "./generated/error";
+
+const ERR_CODE_INDEX = ERR_CODE_INFO_BY_CODE as Record<number, LxErrorCodeInfo>;
+
+export interface LxApiError {
+  readonly code: number;
+  readonly key: LxErrorCodeInfo["key"];
+  readonly message: string;
+  readonly raw: unknown;
+}
+
+export function isLxApiError(error: unknown): error is LxApiError {
+  return parseLxApiError(error) !== null;
+}
+
+function readMessage(error: unknown): string {
+  if (typeof error === "string") return error;
+  if (error instanceof Error && typeof error.message === "string") return error.message;
+  if (typeof error === "object" && error !== null) {
+    const value = (error as { message?: unknown }).message;
+    if (typeof value === "string") return value;
+  }
+  return "Unknown LingXia error";
+}
+
+function toRecord(value: unknown): Record<string, unknown> | null {
+  if (typeof value !== "object" || value === null) return null;
+  return value as Record<string, unknown>;
+}
+
+function parseIntegerCode(value: unknown): number | null {
+  if (typeof value === "number" && Number.isInteger(value)) return value;
+  if (typeof value === "string" && value.trim() !== "") {
+    const parsed = Number(value);
+    if (Number.isInteger(parsed)) return parsed;
+  }
+  return null;
+}
+
+export function extractLxErrorCode(error: unknown): number | null {
+  const root = toRecord(error);
+  if (!root) return null;
+
+  const rootCode = parseIntegerCode(root.code);
+  if (rootCode !== null) return rootCode;
+
+  const data = toRecord(root.data);
+  if (!data) return null;
+
+  return parseIntegerCode(data.bizCode) ?? parseIntegerCode(data.code);
+}
+
+export function isKnownLxErrorCode(code: number): boolean {
+  return Number.isInteger(code) && Object.prototype.hasOwnProperty.call(ERR_CODE_INDEX, code);
+}
+
+export function infoForLxErrorCode(code: number): LxErrorCodeInfo | null {
+  if (!isKnownLxErrorCode(code)) return null;
+  return ERR_CODE_INDEX[code];
+}
+
+export function parseLxApiError(error: unknown): LxApiError | null {
+  const code = extractLxErrorCode(error);
+  if (code === null) return null;
+  const info = infoForLxErrorCode(code);
+  if (!info) return null;
+  return {
+    ...info,
+    message: readMessage(error),
+    raw: error,
+  };
+}
+
+export function requireLxApiError(error: unknown): LxApiError {
+  const parsed = parseLxApiError(error);
+  if (parsed) return parsed;
+  throw new Error(`Unknown LingXia API error: ${readMessage(error)}`);
+}
+
+export function formatLxApiError(error: LxApiError): string {
+  return `[${error.code}] ${error.message}`;
+}

package/src/file/index.ts

@@ -0,0 +1,121 @@
+/**
+ * File system APIs.
+ * Corresponds to: lingxia-logic/src/fs.rs
+ */
+
+export interface OpenDocumentOptions {
+  filePath: string;
+  fileType?: string;
+  showMenu?: boolean;
+}
+
+/** Desktop only. Currently supported on macOS. Windows is planned. */
+export interface FileDialogFilter {
+  /** Optional label shown in the native dialog. */
+  name?: string;
+  /** Allowed extensions without dots, e.g. ['pdf', 'txt']. */
+  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. */
+  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. */
+  path?: string;
+}
+
+export interface DownloadOptions {
+  /** HTTP(S) source URL. */
+  url: string;
+  /**
+   * Optional external cancellation channel.
+   * When aborted, it has the same effect as calling `task.cancel()`.
+   * Useful for timeout/router/lifecycle composition.
+   */
+  signal?: AbortSignal;
+}
+
+export interface DownloadResult {
+  /** Downloaded file URI under user cache, e.g. lx://usercache/... */
+  tempFilePath: string;
+  /** Suggested filename resolved by runtime from headers/url. */
+  fileName: string;
+  /** MIME type when available. */
+  mimeType?: string;
+  /** File size in bytes. */
+  size: number;
+}
+
+export interface DownloadProgressEvent {
+  kind: 'progress';
+  downloadedBytes: number;
+  totalBytes?: number;
+  /**
+   * 0~1 progress value.
+   * - precise ratio when totalBytes is known
+   * - monotonic estimated progress when totalBytes is unknown
+   */
+  progress: number;
+}
+
+export interface DownloadSuccessEvent {
+  kind: 'success';
+  result: DownloadResult;
+}
+
+export interface DownloadPausedEvent {
+  kind: 'paused';
+}
+
+export interface DownloadResumedEvent {
+  kind: 'resumed';
+}
+
+export interface DownloadCanceledEvent {
+  kind: 'canceled';
+}
+
+export type DownloadEvent =
+  | DownloadProgressEvent
+  | DownloadSuccessEvent
+  | DownloadPausedEvent
+  | DownloadResumedEvent
+  | DownloadCanceledEvent;
+
+export interface DownloadTask extends AsyncIterable<DownloadEvent> {
+  /** Pause current download and keep resume metadata. */
+  pause(): Promise<void>;
+  /** Resume a paused download from persisted resume metadata. */
+  resume(): Promise<void>;
+  /** Cancel and remove downloaded temp artifacts. */
+  cancel(): Promise<void>;
+}

package/src/generated/error.ts

@@ -0,0 +1,52 @@
+// Auto-generated by lingxia-gen. DO NOT EDIT.
+
+import type { I18nKey } from "./i18n";
+
+export const ERR_CODE_INFO_BY_CODE = {
+  1000: { code: 1000, key: "err_code_1000" },
+  1001: { code: 1001, key: "err_code_1001" },
+  1002: { code: 1002, key: "err_code_1002" },
+  1003: { code: 1003, key: "err_code_1003" },
+  1004: { code: 1004, key: "err_code_1004" },
+  1005: { code: 1005, key: "err_code_1005" },
+  2000: { code: 2000, key: "err_code_2000" },
+  2001: { code: 2001, key: "err_code_2001" },
+  3000: { code: 3000, key: "err_code_3000" },
+  3001: { code: 3001, key: "err_code_3001" },
+  3002: { code: 3002, key: "err_code_3002" },
+  3003: { code: 3003, key: "err_code_3003" },
+  3004: { code: 3004, key: "err_code_3004" },
+  3005: { code: 3005, key: "err_code_3005" },
+  3006: { code: 3006, key: "err_code_3006" },
+  3007: { code: 3007, key: "err_code_3007" },
+  4000: { code: 4000, key: "err_code_4000" },
+  4001: { code: 4001, key: "err_code_4001" },
+  4002: { code: 4002, key: "err_code_4002" },
+  4003: { code: 4003, key: "err_code_4003" },
+  5000: { code: 5000, key: "err_code_5000" },
+  5001: { code: 5001, key: "err_code_5001" },
+  5002: { code: 5002, key: "err_code_5002" },
+  5003: { code: 5003, key: "err_code_5003" },
+  5004: { code: 5004, key: "err_code_5004" },
+  6000: { code: 6000, key: "err_code_6000" },
+  6001: { code: 6001, key: "err_code_6001" },
+  6002: { code: 6002, key: "err_code_6002" },
+  12000: { code: 12000, key: "err_code_12000" },
+  12001: { code: 12001, key: "err_code_12001" },
+  12002: { code: 12002, key: "err_code_12002" },
+  12003: { code: 12003, key: "err_code_12003" },
+  12004: { code: 12004, key: "err_code_12004" },
+  12005: { code: 12005, key: "err_code_12005" },
+  12006: { code: 12006, key: "err_code_12006" },
+  12007: { code: 12007, key: "err_code_12007" },
+  12008: { code: 12008, key: "err_code_12008" },
+  12009: { code: 12009, key: "err_code_12009" },
+  12010: { code: 12010, key: "err_code_12010" },
+} as const;
+
+export type LxErrorCode = (typeof ERR_CODE_INFO_BY_CODE)[keyof typeof ERR_CODE_INFO_BY_CODE]["code"];
+export interface LxErrorCodeInfo {
+  readonly code: LxErrorCode;
+  readonly key: I18nKey;
+}
+