@oniroproject/core 0.7.0 → 0.9.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ChildProcessWithoutNullStreams } from 'node:child_process';
+import { ChildProcess, SpawnOptions, ChildProcessWithoutNullStreams } from 'node:child_process';
 
 interface Logger {
     debug(message: string): void;
@@ -28,7 +28,7 @@ declare const noopProgress: ProgressReporter;
  * Keys read from the ConfigProvider by core. Frontends (CLI, VS Code extension)
  * implement the provider however they like (env vars, settings.json, etc.).
  */
-type ConfigKey = 'sdkRootDir' | 'cmdToolsPath' | 'emulatorDir' | 'hapPath' | 'cmdToolsUrlLinux' | 'cmdToolsUrlWindows' | 'cmdToolsUrlMac' | 'emulatorUrl' | 'sdkUrlBase' | 'applicationCertPath';
+type ConfigKey = 'sdkRootDir' | 'cmdToolsPath' | 'hdcPath' | 'emulatorDir' | 'hapPath' | 'cmdToolsUrlLinux' | 'cmdToolsUrlWindows' | 'cmdToolsUrlMac' | 'emulatorUrl' | 'tmpDir' | 'sdkUrlBase' | 'applicationCertPath';
 interface ConfigProvider {
     /**
      * Get the configured value for `key`, or `fallback` if unset/empty.
@@ -96,6 +96,15 @@ declare class ChecksumMismatchError extends OniroError {
     readonly actual: string;
     constructor(expected: string, actual: string);
 }
+/**
+ * A download/extract ran out of room on the filesystem holding its scratch
+ * directory. The message is built by the caller (see `sdk/tmp.ts`) so it can name
+ * the directory, whether it is RAM-backed, and how to point elsewhere.
+ */
+declare class InsufficientSpaceError extends OniroError {
+    readonly dir: string;
+    constructor(message: string, dir: string, cause?: unknown);
+}
 declare class CancelledError extends OniroError {
     constructor(message?: string);
 }
@@ -173,6 +182,26 @@ declare function getSdkRootDir(config: ConfigProvider): string;
 declare function getOhosBaseSdkHome(config: ConfigProvider): string;
 declare function getCmdToolsPath(config: ConfigProvider): string;
 declare function getEmulatorDir(config: ConfigProvider): string;
+/**
+ * Expand a Windows 8.3 short path (`C:\Users\FRANCE~1\...`) to its long form.
+ *
+ * Short names reach us whenever a caller passes `%TEMP%` or a path built in a
+ * `cmd` context, and hvigor cannot resolve a module directory underneath one:
+ * it aborts with `00303149 Configuration Error / Path not found` naming a
+ * `srcPath` that plainly exists. Node and the Win32 API resolve short names
+ * fine, so the mismatch only surfaces once hvigor is running.
+ *
+ * No-op off Windows, where short names do not exist and resolving would only
+ * dereference symlinks the caller chose deliberately. On Windows it does also
+ * canonicalise case and follow junctions — the same path the OS resolves to
+ * anyway.
+ *
+ * Returns `p` unchanged when it does not exist, so a caller's "not found"
+ * error still quotes the path the user actually typed.
+ *
+ * `platform` is injectable so the behaviour is unit-testable off Windows.
+ */
+declare function toLongPath(p: string, platform?: NodeJS.Platform): string;
 /**
  * Resolve a binary inside the command-line tools `bin/` directory by name
  * (e.g. `'ohpm'`, `'hvigorw'`, `'codelinter'`). On Windows tries common
@@ -182,7 +211,10 @@ declare function getCmdToolsBin(config: ConfigProvider, name?: string): string;
 /** Resolve the OHPM binary path inside the command-line tools install. */
 declare function getOhpmPath(config: ConfigProvider): string;
 /**
- * Resolve the hdc binary path inside the SDK toolchains tree.
+ * Resolve the hdc binary. An explicit `hdcPath` override (config key / `ONIRO_HDC`
+ * env var) wins — point it at a wrapper/proxy hdc when the device is not directly
+ * attached here (e.g. a remote device behind an SSH-tunnel `hdc` wrapper). When
+ * unset, fall back to the hdc bundled in the SDK toolchains tree.
  */
 declare function getHdcPath(config: ConfigProvider): string;
 /**
@@ -192,8 +224,13 @@ declare function getHdcPath(config: ConfigProvider): string;
  * ship a project-local `hvigorw` whose `hvigor/` install is absent, so the
  * wrapper crashes on startup; in that case we fall back to the hvigorw bundled
  * with the command-line tools, which is always installed.
+ *
+ * DevEco projects ship both wrappers side by side: an extensionless POSIX shell
+ * script and a `.bat` for Windows. The candidate order is therefore
+ * platform-dependent — picking the shell script on Windows would hand `spawn` a
+ * file the OS cannot execute.
  */
-declare function getHvigorwPath(config: ConfigProvider, projectDir: string): string;
+declare function getHvigorwPath(config: ConfigProvider, projectDir: string, platform?: NodeJS.Platform): string;
 
 /**
  * Detect the SDK API a project targets by reading `build-profile.json5`.
@@ -202,6 +239,82 @@ declare function getHvigorwPath(config: ConfigProvider, projectDir: string): str
  */
 declare function detectProjectSdkVersion(projectRoot: string, logger?: Logger): number | undefined;
 
+/** Name of the scratch folder created next to an install target. */
+declare const INSTALL_TMP_DIRNAME = ".oniro-tmp";
+/** Advice appended to out-of-space failures in the scratch directory. */
+declare const TMP_DIR_HINT: string;
+/**
+ * Resolve the directory that download/extract scratch space is created in.
+ *
+ * Precedence: explicit override (CLI `--tmp-dir`) → `tmpDir` config key
+ * (`ONIRO_TMP_DIR`) → `<installRoot>/.oniro-tmp` → the system temp dir.
+ *
+ * The default sits next to the install target so that the unpacked tree is renamed
+ * into place rather than copied across a device boundary, and so the system temp dir
+ * — a RAM-backed `tmpfs` on most Linux systems, and far smaller than a multi-GB
+ * archive — is never in the picture.
+ */
+declare function resolveTmpRoot(config: ConfigProvider, override?: string, installRoot?: string): string;
+/** Create a private scratch directory under `root`, creating `root` if needed. */
+declare function createTempWorkDir(root: string, prefix: string): string;
+/**
+ * Remove a scratch directory once an install is done, taking the `.oniro-tmp` root
+ * with it when that leaves it empty. A root the caller named explicitly is left alone,
+ * as are roots another install is still using (the rmdir simply fails).
+ */
+declare function removeTempWorkDir(dir: string, root?: string): void;
+interface InstallTempDirOptions {
+    config: ConfigProvider;
+    /** Explicit scratch directory (CLI `--tmp-dir`). */
+    override?: string;
+    /** Directory the install lands in; the default scratch root is created inside it. */
+    installRoot: string;
+    prefix: string;
+    logger?: Logger;
+}
+interface InstallTempDir {
+    /** The private per-run scratch directory. Remove it when the install finishes. */
+    dir: string;
+    /** The configurable root it was created under, for out-of-space messages. */
+    root: string;
+}
+/**
+ * Create the scratch directory for an install, defaulting to `<installRoot>/.oniro-tmp`.
+ *
+ * When that default is unusable — a read-only or root-owned install parent, say — the
+ * system temp dir is used instead. A directory the caller asked for explicitly is never
+ * swapped out silently, and a full filesystem is reported rather than papered over.
+ */
+declare function createInstallTempDir(opts: InstallTempDirOptions): InstallTempDir;
+/**
+ * Bytes available to an unprivileged user on the filesystem holding `dir`.
+ * Returns null when the platform cannot report it.
+ */
+declare function getFreeSpaceBytes(dir: string): number | null;
+/**
+ * Whether `dir` lives on a RAM-backed filesystem (`tmpfs`/`ramfs`), i.e. one whose
+ * capacity comes out of memory rather than disk.
+ */
+declare function isRamBackedPath(dir: string): boolean;
+declare function formatBytes(bytes: number): string;
+/** Recognise an out-of-disk-space failure from fs/stream errors and their wrappers. */
+declare function isOutOfSpaceError(err: unknown): boolean;
+/**
+ * Fail before writing a byte when the filesystem holding `dir` cannot take
+ * `requiredBytes`. A no-op when free space cannot be determined.
+ */
+declare function ensureFreeSpace(dir: string, requiredBytes: number, what: string): void;
+/**
+ * Convert an out-of-space failure into an {@link InsufficientSpaceError}; any other
+ * error is returned unchanged, so callers can `throw toSpaceError(err, ...)`.
+ *
+ * `tmpRoot` is the scratch directory the operation was using. Failures under it are
+ * reported against it (not the per-run subdirectory the user cannot configure) and get
+ * the `--tmp-dir` remedy; failures elsewhere — an install target that is full — name
+ * their own directory and skip the remedy, which would not help.
+ */
+declare function toSpaceError(err: unknown, tmpRoot: string, what: string): unknown;
+
 interface DownloadOptions {
     url: string;
     dest: string;
@@ -211,10 +324,21 @@ interface DownloadOptions {
     start?: number;
     /** Overall progress range to consume (0..100). Default 100. */
     range?: number;
+    /** What the download is for, used in out-of-space messages. */
+    what?: string;
+    /**
+     * Configurable scratch root that `dest` lives under, if any. Out-of-space messages
+     * name it instead of the per-run subdirectory, since that is what the user can change.
+     */
+    tmpRoot?: string;
 }
 /**
  * Stream a remote file to disk with optional progress reporting and cancellation.
  * Follows redirects via the `follow-redirects` library.
+ *
+ * Fails fast with an `InsufficientSpaceError` when the destination filesystem cannot
+ * hold the advertised `content-length` — the common case being a system temp dir on a
+ * RAM-backed tmpfs that is far smaller than the SDK/tools archives.
  */
 declare function downloadFile(opts: DownloadOptions): Promise<void>;
 /**
@@ -273,6 +397,11 @@ interface InstallSdkOptions {
     progress?: ProgressReporter;
     abortSignal?: AbortSignal;
     logger?: Logger;
+    /**
+     * Scratch directory for the download/extract temporaries. Overrides the `tmpDir`
+     * config key and the default location next to the install target.
+     */
+    tmpDir?: string;
 }
 /**
  * Download and install an OpenHarmony SDK release into `<sdkRootDir>/<osFolder>/<api>`.
@@ -310,6 +439,11 @@ interface InstallCmdToolsOptions {
     logger?: Logger;
     /** Skip download and install from a local zip the caller already has. */
     localZipPath?: string;
+    /**
+     * Scratch directory for the download/extract temporaries. Overrides the `tmpDir`
+     * config key and the default location next to the install target.
+     */
+    tmpDir?: string;
 }
 /**
  * Install the OpenHarmony command-line tools into `<cmdToolsPath>`.
@@ -437,6 +571,11 @@ interface InstallEmulatorOptions {
     progress?: ProgressReporter;
     abortSignal?: AbortSignal;
     logger?: Logger;
+    /**
+     * Scratch directory for the downloaded ZIP. Overrides the `tmpDir` config key and
+     * the default location next to the install target.
+     */
+    tmpDir?: string;
 }
 /**
  * Download and extract the Oniro emulator into the configured `emulatorDir`.
@@ -491,6 +630,63 @@ interface StartEmulatorOptions {
 declare function startEmulator(opts: StartEmulatorOptions): Promise<void>;
 declare function stopEmulator(logger?: Logger): Promise<void>;
 
+/**
+ * True when `command` must be routed through `cmd.exe` to run at all —
+ * i.e. we are on Windows and the target is a batch wrapper.
+ *
+ * `platform` is injectable so the behaviour is unit-testable off Windows.
+ */
+declare function needsCmdWrapper(command: string, platform?: NodeJS.Platform): boolean;
+/**
+ * Escape one argument for a `cmd.exe` command line: quote it, double the
+ * backslashes that would otherwise escape the closing quote, then caret-escape
+ * every metacharacter.
+ *
+ * `doubleEscapeMetaChars` adds the second caret layer needed by `%*`-forwarding
+ * shims — see {@link CMD_SHIM_RE}.
+ */
+declare function escapeCmdArgument(arg: string, doubleEscapeMetaChars?: boolean): string;
+/**
+ * Escape the executable path. It is caret-escaped but deliberately NOT quoted:
+ * `cmd.exe /s /c "..."` strips the outer quotes of the whole line, and a quoted
+ * first token confuses that parse. Caret-escaping the spaces is what makes
+ * `C:\Program Files\...` work.
+ */
+declare function escapeCmdCommand(command: string): string;
+interface CmdWrapper {
+    command: string;
+    args: string[];
+}
+/**
+ * Build the `cmd.exe /d /s /c "<command> <args...>"` invocation for a batch
+ * wrapper. Pure (no I/O, no spawning) so the escaping is unit-testable on every
+ * platform.
+ *
+ * `/d` skips AutoRun registry commands, `/s` keeps the outer quotes intact,
+ * `/c` runs the command and exits.
+ *
+ * @throws OniroError if the command or any argument contains a character that
+ * cannot survive `cmd.exe` unambiguously (see {@link UNSAFE_CMD_CHARS_RE}).
+ */
+declare function buildCmdWrapper(command: string, args: readonly string[]): CmdWrapper;
+/**
+ * `child_process.spawn`, but able to run Windows batch wrappers.
+ *
+ * Identical to `spawn` everywhere else — on POSIX, and on Windows for real
+ * executables, the command and args are passed straight through with
+ * `shell: false`.
+ */
+declare function spawnCompat(command: string, args: readonly string[], options?: SpawnOptions): ChildProcess;
+/**
+ * Kill a child and everything it started.
+ *
+ * On Windows a signal only reaches the process we spawned — killing the
+ * `cmd.exe` wrapper leaves the Node/hvigor process it launched running, so an
+ * aborted or timed-out build would keep holding the project's output files.
+ * `taskkill /T /F` tears down the whole tree instead.
+ */
+declare function killProcessTree(child: ChildProcess): void;
+
 /** Result of a spawned command. `code` is the process exit code (-1 if it was killed). */
 interface HdcExecResult {
     code: number;
@@ -521,6 +717,12 @@ interface RunProcessOptions {
  * because args are passed as an array and never interpolated into a shell
  * string, command construction is injection-safe by construction.
  *
+ * The one exception is a Windows batch wrapper (`.bat`/`.cmd`, how the
+ * OpenHarmony command-line tools ship there), which the OS cannot execute
+ * directly: those go through `cmd.exe` with every argument individually
+ * escaped — see {@link spawnCompat}. The array-in, no-word-splitting contract
+ * is preserved.
+ *
  * Resolves with `{ code, stdout, stderr }` for ANY exit code (callers opt into
  * throw-on-non-zero via {@link ensureOk}). Rejects only on spawn failure
  * (e.g. missing binary), timeout, or abort.
@@ -554,6 +756,33 @@ declare function shell(opts: HdcShellOptions): Promise<HdcExecResult>;
  * return the result unchanged. Lets callers opt into throw-semantics.
  */
 declare function ensureOk(result: HdcExecResult, command: string): HdcExecResult;
+/**
+ * Parse the exit-code marker appended by {@link shellChecked}. Pure/testable.
+ * Returns the remote exit code plus stdout with every marker occurrence
+ * stripped, or `null` when no marker is present (the command was killed/timed
+ * out, or the device shell never reached the trailing `echo`).
+ */
+declare function parseRemoteExit(stdout: string): {
+    code: number;
+    stdout: string;
+} | null;
+/**
+ * Like {@link shell}, but recovers the REMOTE command's exit status.
+ *
+ * `hdc shell "<cmd>"` reports hdc's OWN exit code (≈ always 0) regardless of
+ * whether `<cmd>` succeeded on the device — so on-device failures (`uinput`
+ * rejecting its args, a `bm install` error, a missing binary) otherwise look
+ * like success. We append an exit-code marker, parse it back out, and report
+ * it as `code`, with the marker stripped from stdout. Pair with
+ * {@link ensureRemoteOk} to throw on a non-zero remote exit.
+ */
+declare function shellChecked(opts: HdcShellOptions): Promise<HdcExecResult>;
+/**
+ * Throw a typed {@link CommandFailedError} on a non-zero result, preferring
+ * stderr but falling back to stdout for the detail — device tools like
+ * `uinput`/`uitest` print their errors to stdout, not stderr.
+ */
+declare function ensureRemoteOk(result: HdcExecResult, command: string): HdcExecResult;
 
 interface DeviceInfo {
     /** Connect key — a USB serial or a `host:port` for a TCP target. */
@@ -827,10 +1056,35 @@ interface SendRawTouchOptions {
  * interleaving `-i <ms>` intervals from the event time deltas. Pure.
  */
 declare function buildRawTouchCommand(events: RawTouchEvent[]): string;
+/** Expand a waypoint path (+ optional holds) into raw down/move/up events for
+ *  the `uinput` escape hatch ({@link sendRawTouch} / {@link buildRawTouchCommand}). */
+declare function waypointsToRawEvents(waypoints: Waypoint[], holdStartMs?: number, holdEndMs?: number): RawTouchEvent[];
+interface GestureUitestOptions {
+    /** A leading press-hold; when > 0 the stroke uses `drag` (press-and-hold,
+     *  then move) instead of `swipe`. uitest has no arbitrary hold duration. */
+    holdStartMs?: number;
+}
 /**
- * Drive a smooth multi-waypoint path. With no holds, issues chained
- * `uitest uiInput drag` segments. When `holdStartMs`/`holdEndMs` are set, routes
- * through {@link sendRawTouch} (uinput), the only path with real press-time control.
+ * Build a single continuous `uitest uiInput` stroke for a waypoint path. Pure.
+ *
+ * uitest has no polyline or stationary-hold primitive, so the path is collapsed
+ * to first→last (gesture-nav strokes are straight lines) with the velocity
+ * derived from the total elapsed time and clamped to uitest's range. A
+ * requested `holdStartMs` maps to `drag` (which presses-and-holds before
+ * moving — uitest's nearest equivalent to a leading hold); otherwise `swipe`.
+ */
+declare function buildGestureUitestCommand(waypoints: Waypoint[], opts?: GestureUitestOptions): string;
+/**
+ * Drive a swipe-style gesture via a single continuous `uitest uiInput` stroke —
+ * the MMI-injection path that `inputMonitor`-based services (gesture-nav,
+ * systemui overlays) actually observe. Preferred over raw `uinput`, whose
+ * kernel virtual-device events do not reach `inputMonitor` on some native-boot
+ * devices (and whose multi-op form some on-device `uinput` builds reject).
+ *
+ * uitest has no polyline or stationary-hold primitive: a multi-waypoint path is
+ * collapsed to first→last, `holdStartMs` maps to `drag` (press-hold-then-move),
+ * and `holdEndMs` has no equivalent (ignored). For true press-time control use
+ * {@link sendRawTouch} (raw `uinput`) — accepting the device caveats above.
  */
 declare function sendGesture(opts: SendGestureOptions): Promise<void>;
 /**
@@ -840,6 +1094,12 @@ declare function sendGesture(opts: SendGestureOptions): Promise<void>;
  * WARNING: uinput's gesture form `uinput -T -g x1 y1 x2 y2 [press] [total]`
  * silently no-ops if `press < 500ms` or `total - press < 500ms` ("press time is
  * out of range" — it runs nothing). Keep press and post-press windows ≥ 500ms.
+ *
+ * DEVICE CAVEAT: on some native-boot devices these kernel-`uinput` events never
+ * reach MMI `inputMonitor` services (gesture-nav, systemui), and some on-device
+ * `uinput` builds reject the multi-op `-d/-m/-u` form with "wrong number of
+ * parameters". Prefer {@link sendGesture} (uitest) for those; this path now
+ * surfaces such failures instead of silently succeeding.
  */
 declare function sendRawTouch(opts: SendRawTouchOptions): Promise<void>;
 
@@ -935,11 +1195,19 @@ interface InstallAppResult {
 declare function installApp(opts: InstallAppOptions): Promise<InstallAppResult>;
 interface LaunchAppOptions {
     config: ConfigProvider;
-    projectDir: string;
-    /** Override the module name if it isn't the default `entry`. */
+    /** Project mode: resolve bundle + main ability from the project. Required unless `bundleName` is given. */
+    projectDir?: string;
+    /**
+     * Bundle mode: launch an already-installed app directly by bundle name (no
+     * project needed). When set, `projectDir` is ignored. If `abilityName` is
+     * omitted, the main ability is resolved from the device via `bm dump -n`.
+     */
+    bundleName?: string;
+    /** Override the module name if it isn't the default `entry` (project mode). */
     moduleName?: string;
-    /** Explicit ability to launch; defaults to the module's mainElement / first visible ability. */
+    /** Explicit ability to launch; defaults to the module's mainElement / first visible ability (project mode) or the installed bundle's main ability (bundle mode). */
     abilityName?: string;
+    deviceSerial?: string;
     logger?: Logger;
 }
 /**
@@ -949,6 +1217,14 @@ interface LaunchAppOptions {
  * failed launch, or null when it looks like a success.
  */
 declare function detectAaStartFailure(output: string): string | null;
+/**
+ * Parse the main ability of an installed bundle from `bm dump -n <bundle>`
+ * output. Pure/testable. The output is a bundle-name prefix line followed by a
+ * JSON blob; we take the entry module's `mainElementName` (fallback
+ * `mainAbility`), or the first module that declares one. Returns null when the
+ * bundle isn't installed or the output is unparseable.
+ */
+declare function parseMainAbilityFromBmDump(stdout: string): string | null;
 declare function launchApp(opts: LaunchAppOptions): Promise<void>;
 interface RunningProcess {
     pid: string;
@@ -973,10 +1249,16 @@ interface BundleOptions {
     logger?: Logger;
 }
 /**
- * Non-throwing companion to {@link listRunningProcesses}: resolve the running
- * process for a bundle via `pidof`, or `null` when it isn't running. Suitable
- * for "is X running?" checks (e.g. the pre/post-install pid comparison in
- * applyChanges).
+ * Non-throwing companion to {@link listRunningProcesses}: resolve a running
+ * process for a bundle, or `null` when it isn't running. Suitable for "is X
+ * running?" checks (e.g. the pre/post-install pid comparison in applyChanges).
+ *
+ * `pidof` matches the bundle's main (UIAbility) process. When that isn't found,
+ * we fall back to `track-jpid` to also catch **extension-ability** processes,
+ * which run under a separate process name `"<bundle>:<ext>"` (e.g. a
+ * ServiceExtension, FormExtension, UIExtension or input method). Without this,
+ * "verify the running process took the change" silently reported nothing for an
+ * app whose only live process is an extension.
  */
 declare function findRunningProcess(opts: BundleOptions): Promise<RunningProcess | null>;
 /** Uninstall an app by bundle name (`hdc uninstall <bundle>`). */
@@ -1144,9 +1426,10 @@ interface DiscoverHapsOptions {
 }
 /**
  * Walk a project's build outputs and group `*-signed.hap` / `*-unsigned.hap`
- * by module folder. Skips `node_modules` / `oh_modules` / `.git`. Ported from
- * the proven MCP `findHaps`, extended with per-module grouping so multi-module
- * projects can install the right HAP. Empty object when nothing is built.
+ * by build module name (parsed from the HAP filename). Skips `node_modules` /
+ * `oh_modules` / `.git`. Ported from the proven MCP `findHaps`, extended with
+ * per-module grouping so multi-module projects can install the right HAP.
+ * Empty object when nothing is built.
  */
 declare function discoverHaps(opts: DiscoverHapsOptions): Promise<Record<string, ModuleHaps>>;
 
@@ -1476,4 +1759,4 @@ declare function applyChanges(opts: ApplyChangesOptions): Promise<ApplyChangesRe
 
 declare const VERSION: string;
 
-export { ALL_SDKS, APL_VALUES, APP_FEATURE_VALUES, type AbilityInfo, type Apl, type AppFeature, type ApplyChangesOptions, type ApplyChangesResult, type BuildHapOptions, type BuildHapResult, type BundleOptions, CancelledError, type CaptureBurstOptions, ChecksumMismatchError, CmdToolsNotInstalledError, type CmdToolsStatus, type CodelinterFinding, type CodelinterResult, CommandFailedError, type ConfigKey, type ConfigProvider, type CreateScaffoldOptions, type CreateScaffoldResult, type DeviceFullInfo, type DeviceInfo, type DiscoverHapsOptions, type DisplaySize, type DisplaySizeOptions, type DownloadOptions, type DumpLayoutOptions, type DumpLayoutResult, type DumpLogOptions, type ExtractZipOptions, type GenerateSigningConfigsOptions, type GetDeviceInfoOptions, type HapAssetDiff, type HdcExecOptions, type HdcExecResult, type HdcShellOptions, type HidumperOptions, type HilogEntry, type HilogLevel, type InputType, type InstallAppOptions, type InstallAppResult, type InstallCmdToolsOptions, type InstallEmulatorOptions, type InstallMethod, type InstallSdkOptions, type LaunchAppOptions, type LayoutNode, type Logger, type ModuleHaps, OHOS_URL_BASE, type OniroContext, OniroError, type OsFolder, type OutputSink, type ParamOptions, type PrepareSigningOptions, type PrepareSigningResult, type ProgressReporter, type ProgressUpdate, type ProjectModule, type Prompter, type RawLayoutNode, type RawTouchEvent, type RebootDecision, type RebootOptions, type RecvFileOptions, type RunCodelinterOptions, type RunHvigorwOptions, type RunHvigorwResult, type RunOhpmOptions, type RunProcessOptions, type RunningProcess, type ScreenDump, type Screenshot, type ScreenshotOptions, type SdkArchiveInfo, type SdkInfo, SdkNotInstalledError, type SdkRelease, type SendFileOptions, type SendGestureOptions, type SendInputOptions, type SendRawTouchOptions, type SetHilogLevelOptions, type SigningKind, type SigningPasswords, type StartEmulatorOptions, type StreamHilogOptions, type TemplateOption, UnsupportedPlatformError, VERSION, type WaitForBootOptions, type WaitForBundleOptions, type WaitForConditionOptions, type WaitForLogOptions, type WatchLogOptions, type Waypoint, applyChanges, attemptHdcConnection, buildGestureCommands, buildHap, buildHvigorwArgs, buildInputCommand, buildRawTouchCommand, captureBurst, consoleLogger, createMaterial, createScaffold, decideInstallMethod, decideReboot, decryptPwd, dedupEntries, defaultContext, defaultPaths, detectAaStartFailure, detectProjectSdkVersion, detectSigningConfigNames, diffEntryNames, diffHapAssets, discoverHaps, downloadAndInstallSdk, downloadFile, dumpLayout, dumpLog, dumpRenderService, dumpScreen, dumpWindow, encryptPwd, ensureOhModules, ensureOk, extractTarball, extractZipWithProgress, findAppProcessId, findCmdToolsSourceDir, findRunningProcess, forceStop, generateSigningConfigs, getBundleName, getCmdToolsBin, getCmdToolsDownloadUrl, getCmdToolsPath, getCmdToolsStatus, getDeviceInfo, getDisplaySize, getEmulatorDir, getHdcPath, getHvigorwPath, getInstalledSdks, getKey, getMainAbility, getOhosBaseSdkHome, getOhpmPath, getOsFolder, getSdkFilename, getSdkRootDir, getSupportedSdksForUi, hdcExec, installApp, installCmdTools, installEmulator, isCmdToolsInstalled, isEmulatorInstalled, isValidBundleName, isValidProjectName, launchApp, listAbilities, listDevices, listModules, listRunningProcesses, listTemplates, nonInteractivePrompter, noopLogger, noopProgress, paramGet, paramSet, parseBounds, parseCodelinterFindings, parseDeviceList, parseHilogLine, pickSigningKind, prepareSigning, pruneLayout, readJson5File, readJsonFile, reboot, recvFile, removeCmdTools, removeEmulator, removeSdk, runCodelinter, runHvigorw, runOhpm, runProcess, scopedLogger, selectDevice, sendFile, sendGesture, sendInput, sendRawTouch, setHilogLevel, shell, startEmulator, staticConfig, stopEmulator, streamHilog, takeScreenshot, uninstallApp, validateTemplateLayout, verifySha256, waitForBoot, waitForBundle, waitForCondition, waitForLog, watchLog, writeJson5File, writeJsonFile };
+export { ALL_SDKS, APL_VALUES, APP_FEATURE_VALUES, type AbilityInfo, type Apl, type AppFeature, type ApplyChangesOptions, type ApplyChangesResult, type BuildHapOptions, type BuildHapResult, type BundleOptions, CancelledError, type CaptureBurstOptions, ChecksumMismatchError, CmdToolsNotInstalledError, type CmdToolsStatus, type CmdWrapper, type CodelinterFinding, type CodelinterResult, CommandFailedError, type ConfigKey, type ConfigProvider, type CreateScaffoldOptions, type CreateScaffoldResult, type DeviceFullInfo, type DeviceInfo, type DiscoverHapsOptions, type DisplaySize, type DisplaySizeOptions, type DownloadOptions, type DumpLayoutOptions, type DumpLayoutResult, type DumpLogOptions, type ExtractZipOptions, type GenerateSigningConfigsOptions, type GestureUitestOptions, type GetDeviceInfoOptions, type HapAssetDiff, type HdcExecOptions, type HdcExecResult, type HdcShellOptions, type HidumperOptions, type HilogEntry, type HilogLevel, INSTALL_TMP_DIRNAME, type InputType, type InstallAppOptions, type InstallAppResult, type InstallCmdToolsOptions, type InstallEmulatorOptions, type InstallMethod, type InstallSdkOptions, type InstallTempDir, type InstallTempDirOptions, InsufficientSpaceError, type LaunchAppOptions, type LayoutNode, type Logger, type ModuleHaps, OHOS_URL_BASE, type OniroContext, OniroError, type OsFolder, type OutputSink, type ParamOptions, type PrepareSigningOptions, type PrepareSigningResult, type ProgressReporter, type ProgressUpdate, type ProjectModule, type Prompter, type RawLayoutNode, type RawTouchEvent, type RebootDecision, type RebootOptions, type RecvFileOptions, type RunCodelinterOptions, type RunHvigorwOptions, type RunHvigorwResult, type RunOhpmOptions, type RunProcessOptions, type RunningProcess, type ScreenDump, type Screenshot, type ScreenshotOptions, type SdkArchiveInfo, type SdkInfo, SdkNotInstalledError, type SdkRelease, type SendFileOptions, type SendGestureOptions, type SendInputOptions, type SendRawTouchOptions, type SetHilogLevelOptions, type SigningKind, type SigningPasswords, type StartEmulatorOptions, type StreamHilogOptions, TMP_DIR_HINT, type TemplateOption, UnsupportedPlatformError, VERSION, type WaitForBootOptions, type WaitForBundleOptions, type WaitForConditionOptions, type WaitForLogOptions, type WatchLogOptions, type Waypoint, applyChanges, attemptHdcConnection, buildCmdWrapper, buildGestureCommands, buildGestureUitestCommand, buildHap, buildHvigorwArgs, buildInputCommand, buildRawTouchCommand, captureBurst, consoleLogger, createInstallTempDir, createMaterial, createScaffold, createTempWorkDir, decideInstallMethod, decideReboot, decryptPwd, dedupEntries, defaultContext, defaultPaths, detectAaStartFailure, detectProjectSdkVersion, detectSigningConfigNames, diffEntryNames, diffHapAssets, discoverHaps, downloadAndInstallSdk, downloadFile, dumpLayout, dumpLog, dumpRenderService, dumpScreen, dumpWindow, encryptPwd, ensureFreeSpace, ensureOhModules, ensureOk, ensureRemoteOk, escapeCmdArgument, escapeCmdCommand, extractTarball, extractZipWithProgress, findAppProcessId, findCmdToolsSourceDir, findRunningProcess, forceStop, formatBytes, generateSigningConfigs, getBundleName, getCmdToolsBin, getCmdToolsDownloadUrl, getCmdToolsPath, getCmdToolsStatus, getDeviceInfo, getDisplaySize, getEmulatorDir, getFreeSpaceBytes, getHdcPath, getHvigorwPath, getInstalledSdks, getKey, getMainAbility, getOhosBaseSdkHome, getOhpmPath, getOsFolder, getSdkFilename, getSdkRootDir, getSupportedSdksForUi, hdcExec, installApp, installCmdTools, installEmulator, isCmdToolsInstalled, isEmulatorInstalled, isOutOfSpaceError, isRamBackedPath, isValidBundleName, isValidProjectName, killProcessTree, launchApp, listAbilities, listDevices, listModules, listRunningProcesses, listTemplates, needsCmdWrapper, nonInteractivePrompter, noopLogger, noopProgress, paramGet, paramSet, parseBounds, parseCodelinterFindings, parseDeviceList, parseHilogLine, parseMainAbilityFromBmDump, parseRemoteExit, pickSigningKind, prepareSigning, pruneLayout, readJson5File, readJsonFile, reboot, recvFile, removeCmdTools, removeEmulator, removeSdk, removeTempWorkDir, resolveTmpRoot, runCodelinter, runHvigorw, runOhpm, runProcess, scopedLogger, selectDevice, sendFile, sendGesture, sendInput, sendRawTouch, setHilogLevel, shell, shellChecked, spawnCompat, startEmulator, staticConfig, stopEmulator, streamHilog, takeScreenshot, toLongPath, toSpaceError, uninstallApp, validateTemplateLayout, verifySha256, waitForBoot, waitForBundle, waitForCondition, waitForLog, watchLog, waypointsToRawEvents, writeJson5File, writeJsonFile };