@arkts/image-manager 0.5.3 → 0.5.5

package/dist/index.d.cts

@@ -33,7 +33,7 @@ interface SerializableContent<T extends SerializableContent.Content = Serializab
 }
 declare namespace SerializableContent {
   type Content = Record<PropertyKey, any> | Content[];
-  interface Serializable extends BaseSerializable<SerializableContent> {}
+  interface Serializable extends Omit<BaseSerializable<SerializableContent>, 'imageManager'> {}
 }
 //#endregion
 //#region src/configs/product/product.d.ts
@@ -90,7 +90,7 @@ declare namespace ProductConfigFile {
   } ? Content[DeviceType][number] : Content[DeviceType][number];
   /** Names from device types other than DeviceType. Used to detect ambiguous names like "Customize". */
   type OtherDeviceTypeNames<DeviceType extends ProductConfigFile.DeviceType> = Exclude<ProductConfigItem.Name, Content[DeviceType][number]['name']>;
-  interface Serializable extends BaseSerializable<ProductConfigFile> {}
+  interface Serializable extends Omit<BaseSerializable<ProductConfigFile>, 'imageManager'> {}
   interface Generic {
     readonly deviceType: DeviceType;
     readonly name: ProductConfigItem.NameWithString;
@@ -295,7 +295,7 @@ declare namespace ProductConfigItem {
     readonly name: WearableKidName;
   }
   type Content = PhoneContent | TabletContent | TwoInOneContent | FoldableContent | WideFoldContent | TripleFoldContent | TwoInOneFoldableContent | TVContent | WearableContent | WearableKidContent;
-  interface Serializable extends BaseSerializable<ProductConfigItem> {}
+  interface Serializable extends Omit<BaseSerializable<ProductConfigItem>, 'imageManager'> {}
   type DevModel = 'MCHEMU-AL00CN' | 'PHEMU-FD00' | 'PHEMU-FD01' | 'PHEMU-FD02' | 'PCEMU-FD05' | 'PHEMU-FD06';
   type DevModelWithString = DevModel | (string & {});
   function is(value: unknown): value is ProductConfigItem;
@@ -309,7 +309,7 @@ interface ListsFile extends Serializable<ListsFile.Serializable>, Omit<Serializa
 }
 declare namespace ListsFile {
   type Content = ListsFileItem.Content[];
-  interface Serializable extends BaseSerializable<ListsFile> {}
+  interface Serializable extends Omit<BaseSerializable<ListsFile>, 'imageManager'> {}
   function is(value: unknown): value is ListsFile;
 }
 //#endregion
@@ -318,7 +318,7 @@ interface ListsFileItem<ProductDeviceType extends ProductConfigFile.DeviceType =
   getListsFile(): ListsFile;
 }
 declare namespace ListsFileItem {
-  interface Serializable extends BaseSerializable<ListsFileItem> {}
+  interface Serializable extends Omit<BaseSerializable<ListsFileItem>, 'imageManager'> {}
   type DeviceType = 'phone' | 'tablet' | '2in1' | 'foldable' | 'widefold' | 'triplefold' | '2in1_foldable' | 'tv' | 'wearable';
   type DeviceTypeWithString = DeviceType | (string & {});
   interface Content<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> {
@@ -529,225 +529,100 @@ declare namespace CustomizeFoldableScreen {
   function is(value: unknown): value is CustomizeFoldableScreen;
 }
 //#endregion
-//#region src/configs/emulator/emulator-basic-item.d.ts
-interface EmulatorBasicItem extends SerializableContent<EmulatorBasicItem.Content> {
-  getEmulatorFile(): EmulatorFile;
-}
-declare namespace EmulatorBasicItem {
-  type DeviceType = '2in1' | 'tablet' | 'tv' | 'wearable' | 'phone';
-  type DeviceTypeWithString = DeviceType | (string & {});
-  interface Content {
-    readonly name: string;
-    readonly deviceType: DeviceType;
-    readonly resolutionWidth: number;
-    readonly resolutionHeight: number;
-    readonly physicalWidth: number;
-    readonly physicalHeight: number;
-    readonly diagonalSize: number;
-    readonly density: number;
-    readonly memoryRamSize: number;
-    readonly datadiskSize: number;
-    readonly procNumber: number;
-    readonly api: number;
-  }
-  function is(value: unknown): value is EmulatorBasicItem;
-  function isDeviceType(value: unknown): value is DeviceType;
-  function isContent(value: unknown): value is Content;
-}
-//#endregion
-//#region src/configs/emulator/emulator-fold-item.d.ts
-interface EmulatorFoldItem extends SerializableContent<EmulatorFoldItem.Content> {
-  getEmulatorFile(): EmulatorFile;
+//#region src/images/local-image.d.ts
+interface LocalImage extends Serializable<LocalImage.Serializable>, Omit<BaseImage, 'toJSON'> {
+  readonly imageType: 'local';
+  /**
+   * Get the SDK package file.
+   *
+   * @returns The SDK package file.
+   */
+  getSdkPkgFile(): LocalImage.OptionalSdkPkgFile;
+  /**
+   * Create a device from the local image.
+   *
+   * @param options - The options to create the device.
+   */
+  createDevice<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']>(options: LocalImage.CreateDeviceOptions<ProductDeviceType, ProductName>): Promise<Device<ProductDeviceType, ProductName>>;
 }
-declare namespace EmulatorFoldItem {
-  type DeviceType = 'foldable' | '2in1_foldable' | 'triplefold' | 'widefold';
-  interface Content extends Omit<EmulatorBasicItem.Content, 'deviceType'> {
-    readonly deviceType: DeviceType;
-    readonly coverResolutionWidth: number;
-    readonly coverResolutionHeight: number;
-    readonly coverDiagonalSize: number;
+declare namespace LocalImage {
+  interface Serializable extends BaseImage.Serializable, Omit<BaseSerializable<LocalImage>, 'imageManager'> {}
+  interface SdkPkgFile {
+    /**
+     * The SDK package file data.
+     */
+    readonly data: SdkPkgFile.Data;
   }
-  function is(value: unknown): value is EmulatorFoldItem;
-  function isDeviceType(value: unknown): value is DeviceType;
-  function isContent(value: unknown): value is Content;
-}
-//#endregion
-//#region src/configs/emulator/emulator-triplefold-item.d.ts
-interface EmulatorTripleFoldItem extends SerializableContent<EmulatorTripleFoldItem.Content> {
-  getEmulatorFile(): EmulatorFile;
-}
-declare namespace EmulatorTripleFoldItem {
-  type DeviceType = 'triplefold';
-  type DeviceTypeWithString = DeviceType;
-  interface Content extends Omit<EmulatorBasicItem.Content, 'deviceType'> {
-    readonly deviceType: DeviceType;
-    readonly singleResolutionWidth: number;
-    readonly singleResolutionHeight: number;
-    readonly singleDiagonalSize: number;
-    readonly doubleResolutionWidth: number;
-    readonly doubleResolutionHeight: number;
-    readonly doubleDiagonalSize: number;
+  namespace SdkPkgFile {
+    interface Data {
+      /** @example '13' */
+      readonly apiVersion: string;
+      /** @example 'System-image-foldable' */
+      readonly displayName: string;
+      /** @example 'system-image,HarmonyOS-5.0.1,foldable_arm' */
+      readonly path: string;
+      /** @example '5.0.1' */
+      readonly platformVersion: string;
+      /** @example 'Release' */
+      readonly releaseType: string;
+      /** @example '5.0.0.112' */
+      readonly version: string;
+      /** @example 'HarmonyOS 5.0.0.112(SP2)' */
+      readonly guestVersion: string;
+      /** @example 'Release' */
+      readonly stage: string;
+    }
   }
-  function is(value: unknown): value is EmulatorTripleFoldItem;
-  function isDeviceType(value: unknown): value is DeviceType;
-  function isContent(value: unknown): value is Content;
-}
-//#endregion
-//#region src/configs/emulator/group-item.d.ts
-interface EmulatorGroupItem extends SerializableContent<EmulatorGroupItem.Content> {
-  getEmulatorFile(): EmulatorFile;
-  getChildren(): EmulatorFile.DeviceItem[];
-}
-declare namespace EmulatorGroupItem {
-  type DeviceType = 'phone_all' | 'pc_all';
-  type DeviceTypeWithString = DeviceType | (string & {});
-  interface Content {
-    readonly name: string;
-    readonly deviceType: DeviceTypeWithString;
-    readonly api: number;
-    readonly children: EmulatorFile.ItemContent[];
+  type OptionalSdkPkgFile = DeepPartial<SdkPkgFile>;
+  interface InfoFile {
+    /** @example '21' */
+    apiVersion: string;
+    /** @example 'arm' */
+    abi: string;
+    /** @example '6.0.0.112' */
+    version: string;
   }
-  function is(value: unknown): value is EmulatorGroupItem;
-  function isContent(value: unknown): value is EmulatorGroupItem.Content;
-}
-//#endregion
-//#region src/configs/emulator/emulator.d.ts
-interface EmulatorFile extends Serializable<EmulatorFile.Serializable>, Omit<SerializableFile, 'toJSON'> {
-  findDeviceItems<DeviceType extends EmulatorFile.DeviceType>(options?: EmulatorFile.FindDeviceItemOptions<DeviceType extends EmulatorGroupItem.DeviceType ? never : DeviceType>): EmulatorFile.DeviceItem[];
-  findDeviceItem<DeviceType extends EmulatorFile.DeviceType>(options?: EmulatorFile.FindDeviceItemOptions<DeviceType extends EmulatorGroupItem.DeviceType ? never : DeviceType>): EmulatorFile.DeviceItem | undefined;
-  findItems(options?: EmulatorFile.FindItemOptions): EmulatorFile.Item[];
-  findItem(options?: EmulatorFile.FindItemOptions): EmulatorFile.Item | undefined;
-  getItems(): EmulatorFile.Item[];
-}
-declare namespace EmulatorFile {
-  interface Serializable extends BaseSerializable<EmulatorFile> {}
-  type ItemContent = EmulatorBasicItem.Content | EmulatorFoldItem.Content | EmulatorTripleFoldItem.Content;
-  type Content = Array<ContentItem>;
-  type ContentItem = EmulatorGroupItem.Content | ItemContent;
-  type DeviceItem = EmulatorBasicItem | EmulatorFoldItem | EmulatorTripleFoldItem;
-  type Item = EmulatorGroupItem | DeviceItem;
-  type DeviceType = EmulatorBasicItem.DeviceType | EmulatorFoldItem.DeviceType | EmulatorTripleFoldItem.DeviceType;
-  type DeviceTypeWithString = DeviceType | (string & {});
-  type FullDeviceType = DeviceType | EmulatorGroupItem.DeviceType;
-  type FullDeviceTypeWithString = FullDeviceType | (string & {});
-  function is(value: unknown): value is EmulatorFile;
-  function isItemContent(value: unknown): value is EmulatorFile.ItemContent;
-  function isContentItem(value: unknown): value is EmulatorFile.ContentItem;
-  interface FindDeviceItemOptions<DeviceType extends DeviceTypeWithString = DeviceTypeWithString> {
-    /**
-     * The API version to find.
-     */
-    readonly apiVersion?: number;
+  interface CreateDeviceOptions<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> {
     /**
-     * The device type to find.
+     * The name of the device.
+     *
+     * @example 'Huawei_Wearable'
      */
-    readonly deviceType?: DeviceType;
-  }
-  interface FindItemOptions {
+    readonly name: string;
     /**
-     * The API version to find.
+     * The CPU number.
+     *
+     * @example 4
      */
-    readonly apiVersion?: number;
+    readonly cpuNumber: number;
     /**
-     * The device type to find.
+     * The memory RAM size. (in MB)
+     *
+     * @example 4096
      */
-    readonly fullDeviceType?: FullDeviceTypeWithString;
-  }
-}
-//#endregion
-//#region src/screens/screen-preset.d.ts
-interface ScreenPreset<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> {
-  /**
-   * Get the emulator item content.
-   *
-   * @returns The emulator item content.
-   */
-  getEmulatorDeviceItem(): EmulatorFile.DeviceItem;
-  /**
-   * Get the product config item content.
-   *
-   * @returns The product config item content.
-   */
-  getProductConfigItem(): ProductConfigItem<ProductDeviceType, ProductName>;
-  /**
-   * Get the customize screen config.
-   *
-   * @returns The customize screen config.
-   */
-  getCustomizeScreenConfig(): CustomizeScreen | CustomizeFoldableScreen | undefined;
-}
-declare namespace ScreenPreset {
-  interface Serializable<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> extends BaseSerializable<ScreenPreset<ProductDeviceType, ProductName>> {}
-  interface PresetOptions<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> {
+    readonly memoryRamSize: number;
     /**
-     * The emulator item content.
+     * The data disk size. (in MB)
+     *
+     * @example 6144
      */
-    readonly emulatorDeviceItem: EmulatorFile.DeviceItem;
+    readonly dataDiskSize: number;
     /**
-     * The product config item content.
+     * The screen.
      */
-    readonly productConfigItem: ProductConfigItem<ProductDeviceType, ProductName>;
-  }
-  interface CustomizeOptions<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> extends PresetOptions<ProductDeviceType, ProductName> {
+    readonly screen: ScreenPreset.Options<ProductDeviceType, ProductName>;
     /**
-     * The customize screen options.
+     * The vendor country.
+     *
+     * @example 'CN'
      */
-    readonly customizeScreen: CustomizeScreen.Options;
-  }
-  interface CustomizeFoldableOptions<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> extends CustomizeOptions<ProductDeviceType, ProductName> {
+    readonly vendorCountry?: string;
     /**
-     * The customize foldable screen options.
+     * @default true
      */
-    readonly customizeFoldableScreen: CustomizeFoldableScreen.Options;
+    readonly isPublic?: boolean;
   }
-  type Options<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> = ProductName extends ProductConfigItem.Customize ? ProductDeviceType extends 'Foldable' ? CustomizeFoldableOptions<ProductDeviceType, ProductName> : CustomizeOptions<ProductDeviceType, ProductName> : PresetOptions<ProductDeviceType, ProductName>;
-  function is(value: unknown): value is ScreenPreset;
-}
-//#endregion
-//#region src/devices/device.d.ts
-interface Device<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> extends Serializable<Device.Serializable<ProductDeviceType, ProductName>> {
-  /** Get the screen of the device. */
-  getScreen(): ScreenPreset<ProductDeviceType, ProductName>;
-  /** Get the image manager of the device. */
-  getImageManager(): ImageManager;
-  /** Get the lists file of the device. */
-  getListsFile(): ListsFile;
-  /** Get the lists file item of the device. */
-  getListsFileItem(): ListsFileItem;
-  /** Get the config INI file of the device. */
-  getConfigIniFile(): ConfigIniFile<ProductDeviceType, ProductName>;
-  /** Get the named INI file of the device. */
-  getNamedIniFile(): NamedIniFile<ProductDeviceType, ProductName>;
-  /** Get the executable URI of the device. */
-  getExecutableUri(): vscode_uri0.URI;
-  /** Get the snapshot URI of the device. */
-  getSnapshotUri(): vscode_uri0.URI;
-  /** Get the snapshot base64 string of the device. */
-  getSnapshot(): Promise<string>;
-  /** Get the start command of the device. */
-  getStartCommand(): [string, string[]];
-  /** Get the stop command of the device. */
-  getStopCommand(): [string, string[]];
-  /** Start the device. */
-  start(): Promise<child_process.ChildProcessByStdio<null, Readable, Readable>>;
-  /** Stop the device. */
-  stop(): Promise<child_process.ChildProcessByStdio<null, Readable, Readable>>;
-  /** Delete the device. */
-  delete(): Promise<void>;
-  /** Get the storage size of the device. */
-  getStorageSize(): Promise<number>;
-  /**
-   * Get the watcher of the device.
-   *
-   * - If the watcher is already created, it will return the existing watcher.
-   * - If the watcher is disposed, it will create a new watcher.
-   * - If the watcher is already created but disposed, it will create a new watcher.
-   */
-  getWatcher(): Promise<FileSystemWatcher>;
-}
-declare namespace Device {
-  interface Serializable<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> extends Omit<BaseSerializable<Device<ProductDeviceType, ProductName>>, 'imageManager'> {}
-  function is(value: unknown): value is Device;
+  function is(value: unknown): value is LocalImage;
 }
 //#endregion
 //#region src/event-emitter.d.ts
@@ -876,199 +751,326 @@ declare namespace SDKList {
   type OKResponse = RemoteImageSDK[];
   interface ErrorResponse {
     /**
-     * The error code.
+     * The error code.
+     */
+    readonly code: number;
+    /**
+     * The error message.
+     */
+    readonly body: string;
+  }
+  type AxiosResponse = axios.AxiosResponse<OKResponse>;
+  type AxiosError = axios.AxiosError<ErrorResponse>;
+  type Result = AxiosResponse | AxiosError;
+  function isOKResponse(result: Result): result is AxiosResponse;
+  class SDKListError extends Error {
+    readonly code: SDKListError.Code;
+    readonly message: string;
+    readonly cause?: (AxiosError | AxiosResponse) | undefined;
+    constructor(code: SDKListError.Code, message: string, cause?: (AxiosError | AxiosResponse) | undefined);
+  }
+  namespace SDKListError {
+    enum Code {
+      VALIDATION_ERROR = 400,
+      REQUEST_ERROR = 500
+    }
+  }
+}
+//#endregion
+//#region src/images/remote-image.d.ts
+interface RemoteImage extends Serializable<RemoteImage.Serializable>, Omit<BaseImage, 'toJSON'> {
+  readonly imageType: 'remote';
+  /**
+   * Get the remote image SDK.
+   *
+   * @returns The remote image SDK.
+   */
+  getRemoteImageSDK(): SDKList.OptionalRemoteImageSDK;
+  /**
+   * Get the local image if it is already downloaded.
+   *
+   * @param force - If `true` will reload the local image from the image manager and file system again. Default is `false`.
+   * @returns The local image if it is already downloaded, otherwise `undefined`.
+   */
+  getLocalImage(force?: boolean): Promise<LocalImage | undefined>;
+  /**
+   * Create a downloader for the remote image.
+   *
+   * @param signals - The signals to abort the download.
+   */
+  createDownloader(signals?: AbortController): Promise<ImageDownloader>;
+}
+declare namespace RemoteImage {
+  interface Serializable extends BaseImage.Serializable, Omit<BaseSerializable<RemoteImage>, 'imageManager'> {}
+  function is(value: unknown): value is RemoteImage;
+}
+//#endregion
+//#region src/images/image.d.ts
+type Image = LocalImage | RemoteImage;
+declare namespace Image {
+  type RelativePath = `system-image/${string}/${string}`;
+  function is(value: unknown): value is Image;
+}
+//#endregion
+//#region src/images/base-image.d.ts
+interface BaseImage extends Serializable<BaseImage.Serializable> {
+  /**
+   * The type of the image.
+   */
+  readonly imageType: 'local' | 'remote';
+  /**
+   * Get the image manager.
+   */
+  getImageManager(): ImageManager;
+  /**
+   * Get the relative path of the image.
+   */
+  getRelativePath(): Image.RelativePath;
+  /**
+   * Get the full path of the image.
+   */
+  getFullPath(): vscode_uri0.URI;
+  /**
+   * Check if the image is downloaded.
+   */
+  isDownloaded(): Promise<boolean>;
+  /**
+   * Get the API version of the image.
+   */
+  getApiVersion(): number;
+  /**
+   * Get the device type of the image.
+   */
+  getFullDeviceType(): EmulatorFile.FullDeviceTypeWithString;
+}
+declare namespace BaseImage {
+  interface Serializable extends Omit<BaseSerializable<BaseImage>, 'imageManager'> {
+    imageType: 'local' | 'remote';
+  }
+  function is(value: unknown): value is BaseImage;
+}
+//#endregion
+//#region src/configs/emulator/emulator-basic-item.d.ts
+interface EmulatorBasicItem extends SerializableContent<EmulatorBasicItem.Content> {
+  getEmulatorFile(): EmulatorFile;
+}
+declare namespace EmulatorBasicItem {
+  type DeviceType = '2in1' | 'tablet' | 'tv' | 'wearable' | 'phone';
+  type DeviceTypeWithString = DeviceType | (string & {});
+  interface Content {
+    readonly name: string;
+    readonly deviceType: DeviceType;
+    readonly resolutionWidth: number;
+    readonly resolutionHeight: number;
+    readonly physicalWidth: number;
+    readonly physicalHeight: number;
+    readonly diagonalSize: number;
+    readonly density: number;
+    readonly memoryRamSize: number;
+    readonly datadiskSize: number;
+    readonly procNumber: number;
+    readonly api: number;
+  }
+  function is(value: unknown): value is EmulatorBasicItem;
+  function isDeviceType(value: unknown): value is DeviceType;
+  function isContent(value: unknown): value is Content;
+}
+//#endregion
+//#region src/configs/emulator/emulator-fold-item.d.ts
+interface EmulatorFoldItem extends SerializableContent<EmulatorFoldItem.Content> {
+  getEmulatorFile(): EmulatorFile;
+}
+declare namespace EmulatorFoldItem {
+  type DeviceType = 'foldable' | '2in1_foldable' | 'triplefold' | 'widefold';
+  interface Content extends Omit<EmulatorBasicItem.Content, 'deviceType'> {
+    readonly deviceType: DeviceType;
+    readonly coverResolutionWidth: number;
+    readonly coverResolutionHeight: number;
+    readonly coverDiagonalSize: number;
+  }
+  function is(value: unknown): value is EmulatorFoldItem;
+  function isDeviceType(value: unknown): value is DeviceType;
+  function isContent(value: unknown): value is Content;
+}
+//#endregion
+//#region src/configs/emulator/emulator-triplefold-item.d.ts
+interface EmulatorTripleFoldItem extends SerializableContent<EmulatorTripleFoldItem.Content> {
+  getEmulatorFile(): EmulatorFile;
+}
+declare namespace EmulatorTripleFoldItem {
+  type DeviceType = 'triplefold';
+  type DeviceTypeWithString = DeviceType;
+  interface Content extends Omit<EmulatorBasicItem.Content, 'deviceType'> {
+    readonly deviceType: DeviceType;
+    readonly singleResolutionWidth: number;
+    readonly singleResolutionHeight: number;
+    readonly singleDiagonalSize: number;
+    readonly doubleResolutionWidth: number;
+    readonly doubleResolutionHeight: number;
+    readonly doubleDiagonalSize: number;
+  }
+  function is(value: unknown): value is EmulatorTripleFoldItem;
+  function isDeviceType(value: unknown): value is DeviceType;
+  function isContent(value: unknown): value is Content;
+}
+//#endregion
+//#region src/configs/emulator/group-item.d.ts
+interface EmulatorGroupItem extends SerializableContent<EmulatorGroupItem.Content> {
+  getEmulatorFile(): EmulatorFile;
+  getChildren(): EmulatorFile.DeviceItem[];
+}
+declare namespace EmulatorGroupItem {
+  type DeviceType = 'phone_all' | 'pc_all';
+  type DeviceTypeWithString = DeviceType | (string & {});
+  interface Content {
+    readonly name: string;
+    readonly deviceType: DeviceTypeWithString;
+    readonly api: number;
+    readonly children: EmulatorFile.ItemContent[];
+  }
+  function is(value: unknown): value is EmulatorGroupItem;
+  function isContent(value: unknown): value is EmulatorGroupItem.Content;
+}
+//#endregion
+//#region src/configs/emulator/emulator.d.ts
+interface EmulatorFile extends Serializable<EmulatorFile.Serializable>, Omit<SerializableFile, 'toJSON'> {
+  findDeviceItems<DeviceType extends EmulatorFile.DeviceType>(options?: EmulatorFile.FindDeviceItemOptions<DeviceType extends EmulatorGroupItem.DeviceType ? never : DeviceType>): EmulatorFile.DeviceItem[];
+  findDeviceItem<DeviceType extends EmulatorFile.DeviceType>(options?: EmulatorFile.FindDeviceItemOptions<DeviceType extends EmulatorGroupItem.DeviceType ? never : DeviceType>): EmulatorFile.DeviceItem | undefined;
+  findItems(options?: EmulatorFile.FindItemOptions): EmulatorFile.Item[];
+  findItem(options?: EmulatorFile.FindItemOptions): EmulatorFile.Item | undefined;
+  findRemoteImageByDeviceItem(deviceItem: EmulatorFile.DeviceItem, remoteImages: RemoteImage[]): RemoteImage | undefined;
+  getItems(): EmulatorFile.Item[];
+  getDeviceItems(): EmulatorFile.DeviceItem[];
+}
+declare namespace EmulatorFile {
+  interface Serializable extends Omit<BaseSerializable<EmulatorFile>, 'imageManager'> {}
+  type ItemContent = EmulatorBasicItem.Content | EmulatorFoldItem.Content | EmulatorTripleFoldItem.Content;
+  type Content = Array<ContentItem>;
+  type ContentItem = EmulatorGroupItem.Content | ItemContent;
+  type DeviceItem = EmulatorBasicItem | EmulatorFoldItem | EmulatorTripleFoldItem;
+  type Item = EmulatorGroupItem | DeviceItem;
+  type DeviceType = EmulatorBasicItem.DeviceType | EmulatorFoldItem.DeviceType | EmulatorTripleFoldItem.DeviceType;
+  type DeviceTypeWithString = DeviceType | (string & {});
+  type FullDeviceType = DeviceType | EmulatorGroupItem.DeviceType;
+  type FullDeviceTypeWithString = FullDeviceType | (string & {});
+  function is(value: unknown): value is EmulatorFile;
+  function isItemContent(value: unknown): value is EmulatorFile.ItemContent;
+  function isContentItem(value: unknown): value is EmulatorFile.ContentItem;
+  interface FindDeviceItemOptions<DeviceType extends DeviceTypeWithString = DeviceTypeWithString> {
+    /**
+     * The API version to find.
      */
-    readonly code: number;
+    readonly apiVersion?: number;
     /**
-     * The error message.
+     * The device type to find.
      */
-    readonly body: string;
-  }
-  type AxiosResponse = axios.AxiosResponse<OKResponse>;
-  type AxiosError = axios.AxiosError<ErrorResponse>;
-  type Result = AxiosResponse | AxiosError;
-  function isOKResponse(result: Result): result is AxiosResponse;
-  class SDKListError extends Error {
-    readonly code: SDKListError.Code;
-    readonly message: string;
-    readonly cause?: (AxiosError | AxiosResponse) | undefined;
-    constructor(code: SDKListError.Code, message: string, cause?: (AxiosError | AxiosResponse) | undefined);
+    readonly deviceType?: DeviceType;
   }
-  namespace SDKListError {
-    enum Code {
-      VALIDATION_ERROR = 400,
-      REQUEST_ERROR = 500
-    }
+  interface FindItemOptions {
+    /**
+     * The API version to find.
+     */
+    readonly apiVersion?: number;
+    /**
+     * The device type to find.
+     */
+    readonly fullDeviceType?: FullDeviceTypeWithString;
   }
 }
 //#endregion
-//#region src/images/remote-image.d.ts
-interface RemoteImage extends Serializable<RemoteImage.Serializable>, Omit<BaseImage, 'toJSON'> {
-  readonly imageType: 'remote';
-  /**
-   * Get the remote image SDK.
-   *
-   * @returns The remote image SDK.
-   */
-  getRemoteImageSDK(): SDKList.OptionalRemoteImageSDK;
-  /**
-   * Get the local image if it is already downloaded.
-   *
-   * @param force - If `true` will reload the local image from the image manager and file system again. Default is `false`.
-   * @returns The local image if it is already downloaded, otherwise `undefined`.
-   */
-  getLocalImage(force?: boolean): Promise<LocalImage | undefined>;
+//#region src/screens/screen-preset.d.ts
+interface ScreenPreset<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> {
   /**
-   * Create a downloader for the remote image.
+   * Get the emulator item content.
    *
-   * @param signals - The signals to abort the download.
-   */
-  createDownloader(signals?: AbortController): Promise<ImageDownloader>;
-}
-declare namespace RemoteImage {
-  interface Serializable extends BaseImage.Serializable, BaseSerializable<RemoteImage> {}
-  function is(value: unknown): value is RemoteImage;
-}
-//#endregion
-//#region src/images/image.d.ts
-type Image = LocalImage | RemoteImage;
-declare namespace Image {
-  type RelativePath = `system-image/${string}/${string}`;
-  function is(value: unknown): value is Image;
-}
-//#endregion
-//#region src/images/base-image.d.ts
-interface BaseImage extends Serializable<BaseImage.Serializable> {
-  /**
-   * The type of the image.
-   */
-  readonly imageType: 'local' | 'remote';
-  /**
-   * Get the image manager.
-   */
-  getImageManager(): ImageManager;
-  /**
-   * Get the relative path of the image.
-   */
-  getRelativePath(): Image.RelativePath;
-  /**
-   * Get the full path of the image.
-   */
-  getFullPath(): vscode_uri0.URI;
-  /**
-   * Check if the image is downloaded.
-   */
-  isDownloaded(): Promise<boolean>;
-  /**
-   * Get the API version of the image.
-   */
-  getApiVersion(): number;
-  /**
-   * Get the device type of the image.
+   * @returns The emulator item content.
    */
-  getFullDeviceType(): EmulatorFile.FullDeviceTypeWithString;
-}
-declare namespace BaseImage {
-  interface Serializable extends BaseSerializable<BaseImage> {
-    imageType: 'local' | 'remote';
-  }
-  function is(value: unknown): value is BaseImage;
-}
-//#endregion
-//#region src/images/local-image.d.ts
-interface LocalImage extends Serializable<LocalImage.Serializable>, Omit<BaseImage, 'toJSON'> {
-  readonly imageType: 'local';
+  getEmulatorDeviceItem(): EmulatorFile.DeviceItem;
   /**
-   * Get the SDK package file.
+   * Get the product config item content.
    *
-   * @returns The SDK package file.
+   * @returns The product config item content.
    */
-  getSdkPkgFile(): LocalImage.OptionalSdkPkgFile;
+  getProductConfigItem(): ProductConfigItem<ProductDeviceType, ProductName>;
   /**
-   * Create a device from the local image.
+   * Get the customize screen config.
    *
-   * @param options - The options to create the device.
+   * @returns The customize screen config.
    */
-  createDevice<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']>(options: LocalImage.CreateDeviceOptions<ProductDeviceType, ProductName>): Promise<Device<ProductDeviceType, ProductName>>;
+  getCustomizeScreenConfig(): CustomizeScreen | CustomizeFoldableScreen | undefined;
 }
-declare namespace LocalImage {
-  interface Serializable extends BaseImage.Serializable, BaseSerializable<LocalImage> {}
-  interface SdkPkgFile {
-    /**
-     * The SDK package file data.
-     */
-    readonly data: SdkPkgFile.Data;
-  }
-  namespace SdkPkgFile {
-    interface Data {
-      /** @example '13' */
-      readonly apiVersion: string;
-      /** @example 'System-image-foldable' */
-      readonly displayName: string;
-      /** @example 'system-image,HarmonyOS-5.0.1,foldable_arm' */
-      readonly path: string;
-      /** @example '5.0.1' */
-      readonly platformVersion: string;
-      /** @example 'Release' */
-      readonly releaseType: string;
-      /** @example '5.0.0.112' */
-      readonly version: string;
-      /** @example 'HarmonyOS 5.0.0.112(SP2)' */
-      readonly guestVersion: string;
-      /** @example 'Release' */
-      readonly stage: string;
-    }
-  }
-  type OptionalSdkPkgFile = DeepPartial<SdkPkgFile>;
-  interface InfoFile {
-    /** @example '21' */
-    apiVersion: string;
-    /** @example 'arm' */
-    abi: string;
-    /** @example '6.0.0.112' */
-    version: string;
-  }
-  interface CreateDeviceOptions<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> {
-    /**
-     * The name of the device.
-     *
-     * @example 'Huawei_Wearable'
-     */
-    readonly name: string;
-    /**
-     * The CPU number.
-     *
-     * @example 4
-     */
-    readonly cpuNumber: number;
-    /**
-     * The memory RAM size. (in MB)
-     *
-     * @example 4096
-     */
-    readonly memoryRamSize: number;
+declare namespace ScreenPreset {
+  interface Serializable<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> extends BaseSerializable<ScreenPreset<ProductDeviceType, ProductName>> {}
+  interface PresetOptions<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> {
     /**
-     * The data disk size. (in MB)
-     *
-     * @example 6144
+     * The emulator item content.
      */
-    readonly dataDiskSize: number;
+    readonly emulatorDeviceItem: EmulatorFile.DeviceItem;
     /**
-     * The screen.
+     * The product config item content.
      */
-    readonly screen: ScreenPreset.Options<ProductDeviceType, ProductName>;
+    readonly productConfigItem: ProductConfigItem<ProductDeviceType, ProductName>;
+  }
+  interface CustomizeOptions<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> extends PresetOptions<ProductDeviceType, ProductName> {
     /**
-     * The vendor country.
-     *
-     * @example 'CN'
+     * The customize screen options.
      */
-    readonly vendorCountry?: string;
+    readonly customizeScreen: CustomizeScreen.Options;
+  }
+  interface CustomizeFoldableOptions<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> extends CustomizeOptions<ProductDeviceType, ProductName> {
     /**
-     * @default true
+     * The customize foldable screen options.
      */
-    readonly isPublic?: boolean;
+    readonly customizeFoldableScreen: CustomizeFoldableScreen.Options;
   }
-  function is(value: unknown): value is LocalImage;
+  type Options<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> = ProductName extends ProductConfigItem.Customize ? ProductDeviceType extends 'Foldable' ? CustomizeFoldableOptions<ProductDeviceType, ProductName> : CustomizeOptions<ProductDeviceType, ProductName> : PresetOptions<ProductDeviceType, ProductName>;
+  function is(value: unknown): value is ScreenPreset;
+}
+//#endregion
+//#region src/devices/device.d.ts
+interface Device<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> extends Serializable<Device.Serializable<ProductDeviceType, ProductName>> {
+  /** Get the screen of the device. */
+  getScreen(): ScreenPreset<ProductDeviceType, ProductName>;
+  /** Get the image manager of the device. */
+  getImageManager(): ImageManager;
+  /** Get the lists file of the device. */
+  getListsFile(): ListsFile;
+  /** Get the lists file item of the device. */
+  getListsFileItem(): ListsFileItem;
+  /** Get the config INI file of the device. */
+  getConfigIniFile(): ConfigIniFile<ProductDeviceType, ProductName>;
+  /** Get the named INI file of the device. */
+  getNamedIniFile(): NamedIniFile<ProductDeviceType, ProductName>;
+  /** Get the executable URI of the device. */
+  getExecutableUri(): vscode_uri0.URI;
+  /** Get the snapshot URI of the device. */
+  getSnapshotUri(): vscode_uri0.URI;
+  /** Get the snapshot base64 string of the device. */
+  getSnapshot(): Promise<string>;
+  /** Get the start command of the device. */
+  getStartCommand(): [string, string[]];
+  /** Get the stop command of the device. */
+  getStopCommand(): [string, string[]];
+  /** Start the device. */
+  start(): Promise<child_process.ChildProcessByStdio<null, Readable, Readable>>;
+  /** Stop the device. */
+  stop(): Promise<child_process.ChildProcessByStdio<null, Readable, Readable>>;
+  /** Delete the device. */
+  delete(): Promise<void>;
+  /** Get the storage size of the device. */
+  getStorageSize(): Promise<number>;
+  /**
+   * Get the watcher of the device.
+   *
+   * - If the watcher is already created, it will return the existing watcher.
+   * - If the watcher is disposed, it will create a new watcher.
+   * - If the watcher is already created but disposed, it will create a new watcher.
+   */
+  getWatcher(): Promise<FileSystemWatcher>;
+}
+declare namespace Device {
+  interface Serializable<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> extends Omit<BaseSerializable<Device<ProductDeviceType, ProductName>>, 'imageManager'> {}
+  function is(value: unknown): value is Device;
 }
 //#endregion
 //#region src/options.d.ts
@@ -1230,7 +1232,7 @@ interface SerializableFile extends Serializable<SerializableFile.Serializable>,
 }
 declare namespace SerializableFile {
   type Content = SerializableContent.Content;
-  interface Serializable extends BaseSerializable<SerializableFile> {}
+  interface Serializable extends Omit<BaseSerializable<SerializableFile>, 'imageManager'> {}
 }
 //#endregion
 //#region src/configs/config-ini/config-ini.d.ts
@@ -1243,7 +1245,7 @@ declare namespace ConfigIniFile {
   type GenericContent<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> = Content & {
     productModel: ProductName;
   };
-  interface Serializable<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> extends Omit<BaseSerializable<ConfigIniFile<ProductDeviceType, ProductName>>, 'device'> {}
+  interface Serializable<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> extends Omit<BaseSerializable<ConfigIniFile<ProductDeviceType, ProductName>>, 'device' | 'imageManager'> {}
   function is(value: unknown): value is ConfigIniFile;
 }
 //#endregion
@@ -1254,7 +1256,7 @@ interface NamedIniFile<ProductDeviceType extends ProductConfigFile.DeviceType =
 }
 declare namespace NamedIniFile {
   type Content = Record<string, string>;
-  interface Serializable<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> extends Omit<BaseSerializable<NamedIniFile<ProductDeviceType, ProductName>>, 'device'> {}
+  interface Serializable<ProductDeviceType extends ProductConfigFile.DeviceType = ProductConfigFile.DeviceType, ProductName extends ProductConfigFile.GenericContent<ProductDeviceType>['name'] = ProductConfigFile.GenericContent<ProductDeviceType>['name']> extends Omit<BaseSerializable<NamedIniFile<ProductDeviceType, ProductName>>, 'device' | 'imageManager'> {}
   function is(value: unknown): value is NamedIniFile;
 }
 //#endregion