@oniroproject/core 0.12.0 → 0.13.0

package/dist/index.d.cts

@@ -1008,13 +1008,20 @@ interface SendInputOptions {
     pxY2?: number;
     /** Velocity for swipe/drag/fling. */
     speed?: number;
-    /** Key id or symbolic name (Back/Home/Power) for keyEvent. */
+    /** Key for keyEvent: a KeyCode id, a name (Back, Delete, Enter, …), or a combo like `Ctrl+A`. See {@link resolveKeyEvent}. */
     key?: string | number;
     /** Text for inputText. */
     text?: string;
     deviceSerial?: string;
     logger?: Logger;
 }
+/**
+ * Resolve a key spec to `uitest uiInput keyEvent` arguments. Accepts uitest's
+ * own names (Back/Home/Power), numeric KeyCode ids, named keys (Delete, Enter,
+ * Tab, Escape, MoveHome, …), single letters, and combos of up to three keys
+ * joined by "+" (e.g. `Ctrl+A`) or given as space-separated ids. Pure.
+ */
+declare function resolveKeyEvent(key: string | number): string;
 /**
  * Build the `uitest uiInput …` command for an input action, in pixel space.
  * Pure (no I/O) so it is unit-testable. Mirrors the proven MCP construction
@@ -1125,6 +1132,8 @@ interface LayoutNode {
     type?: string;
     text?: string;
     desc?: string;
+    /** Placeholder text, e.g. an empty TextInput's "you@example.com". */
+    hint?: string;
     id?: string;
     key?: string;
     bundle?: string;
@@ -1135,28 +1144,105 @@ interface LayoutNode {
     focus?: boolean;
     scroll?: boolean;
     longClick?: boolean;
+    /** The component is disabled (`enabled: false`). */
+    disabled?: boolean;
+    /** The node's center is painted over by a later filled node (an overlay, a
+     *  dialog scrim, the soft keyboard), so a tap there would land on that instead. */
+    covered?: boolean;
     children?: LayoutNode[];
 }
+/** The soft keyboard, when an input-method window is on screen. */
+interface KeyboardState {
+    shown: boolean;
+    /** Bundle of the input-method window. */
+    bundle?: string;
+    /** Bounds [x1,y1,x2,y2] normalized to 0–1 of the display. */
+    b?: [number, number, number, number];
+}
 interface DumpLayoutResult {
     display: DisplaySize | null;
     tree: LayoutNode;
+    /** Present when the dump was asked to detect the soft keyboard. */
+    keyboard?: KeyboardState;
 }
 /** Parse a uitest bounds string `"[x1,y1][x2,y2]"` into a tuple, or null. */
 declare function parseBounds(s: string | undefined): [number, number, number, number] | null;
+/**
+ * Find nodes whose center is painted over by a later node with a visible
+ * background fill — a full-screen overlay, a dialog scrim, a sticky bar, or the
+ * soft-keyboard window. Paint order is depth-first, siblings ordered by
+ * `zIndex`, windows in dump order; ancestors and descendants never cover a node.
+ *
+ * A heuristic: only background fills count (an Image or Text drawn on top does
+ * not), which is what overlays in practice use.
+ */
+declare function findCoveredNodes(root: RawLayoutNode): Set<RawLayoutNode>;
 /**
  * Prune a raw `uitest dumpLayout` tree into a compact, signal-bearing tree with
  * bounds/center normalized to 0–1 of the display. Structural wrapper nodes with
  * no signal collapse into their children. Returns a node, a flat list of nodes
  * (collapsed wrapper with multiple children), or null (nothing useful). Ported
- * verbatim from the proven MCP `pruneNode`.
+ * from the proven MCP `pruneNode`; `covered` (from {@link findCoveredNodes})
+ * marks nodes hidden under an overlay.
+ */
+declare function pruneLayout(node: RawLayoutNode, display: DisplaySize | null, covered?: ReadonlySet<RawLayoutNode>): LayoutNode | LayoutNode[] | null;
+/** A pruned layout node without children, tagged with the window it belongs to. */
+interface FlatLayoutNode extends Omit<LayoutNode, 'children'> {
+    /** Bundle of the enclosing window (the nearest node carrying `bundle`). */
+    window?: string;
+}
+/** Flatten a pruned layout tree into a depth-first (paint-order) list. */
+declare function flattenLayout(tree: LayoutNode): FlatLayoutNode[];
+/** Selects layout nodes by what an agent can read off the screen. */
+interface LayoutSelector {
+    /** Matches `text`, `desc`, or `hint`: case-insensitive exact matches win; otherwise substring matches. */
+    text?: string;
+    /** Matches `id` or `key` exactly. */
+    id?: string;
+    /** Restricts to a component type (e.g. `Button`, `TextInput`); case-insensitive. */
+    type?: string;
+}
+/** Throw unless `selector` constrains something: a non-blank text, an id, or a type. */
+declare function assertLayoutSelector(selector: LayoutSelector): void;
+/**
+ * The tree without the windows owned by `bundle` — e.g. the soft keyboard, whose
+ * keys ("Done", "9") would otherwise match element selectors. Pure.
+ */
+declare function withoutWindow(tree: LayoutNode, bundle: string): LayoutNode;
+/**
+ * Find the nodes matching `selector` in a pruned layout tree, in paint order.
+ * For `text`, exact (case-insensitive, trimmed) matches are returned when any
+ * exist; otherwise substring matches. Covered nodes are included — callers
+ * decide what to do with them (see {@link pickTarget}).
  */
-declare function pruneLayout(node: RawLayoutNode, display: DisplaySize | null): LayoutNode | LayoutNode[] | null;
+declare function findLayoutNodes(tree: LayoutNode, selector: LayoutSelector): FlatLayoutNode[];
+/** One-line summary of a node, used in errors and logs. */
+declare function describeLayoutNode(n: FlatLayoutNode): string;
+/** Why {@link pickTarget} could not choose a node. */
+type PickTargetFailure = 'none' | 'covered' | 'ambiguous';
+declare class TargetNotFoundError extends OniroError {
+    readonly reason: PickTargetFailure;
+    constructor(message: string, reason: PickTargetFailure);
+}
+/**
+ * Choose the single node to act on for `selector`. Covered nodes are skipped;
+ * clickable matches are preferred over plain ones (a "Sign in" Button over the
+ * "Sign in" title); a match nested inside another clickable match collapses
+ * into it. `index` picks among what remains, in paint order. Throws
+ * {@link TargetNotFoundError} when nothing (or more than one node) qualifies.
+ */
+declare function pickTarget(tree: LayoutNode, selector: LayoutSelector, index?: number): FlatLayoutNode;
 interface DumpLayoutOptions {
     config: ConfigProvider;
     /** Filter to a single window/bundle (`uitest dumpLayout -b '<bundle>'`). */
     bundleName?: string;
     /** When false, return the parsed-but-unpruned tree. Default true. */
     prune?: boolean;
+    /**
+     * Also report whether the soft keyboard is on screen (one extra `hidumper` call).
+     * Ignored with `bundleName`, which filters the keyboard window out of the dump.
+     */
+    detectKeyboard?: boolean;
     deviceSerial?: string;
     timeoutMs?: number;
     logger?: Logger;
@@ -1167,6 +1253,125 @@ interface DumpLayoutOptions {
  */
 declare function dumpLayout(opts: DumpLayoutOptions): Promise<DumpLayoutResult>;
 
+/**
+ * Extract input-method bundle names from `hidumper -s 3703 -a -a` output, whose
+ * `imeList` entries look like `"ime": "com.example.kikakeyboard/ServiceExtAbility"`.
+ * The current IME comes first. Pure.
+ */
+declare function parseImeBundles(output: string): string[];
+/**
+ * List the installed input-method bundles (current first). Empty when hidumper
+ * fails or times out, so keyboard detection never fails the caller.
+ */
+declare function getImeBundles(config: ConfigProvider, opts?: {
+    deviceSerial?: string;
+    logger?: Logger;
+}): Promise<string[]>;
+/**
+ * Find the input-method window in a pruned layout tree. uitest lists the soft
+ * keyboard as its own window (a node carrying the IME's `bundle`) only while it
+ * is shown. With no known IME bundles, falls back to a name heuristic. Pure.
+ */
+declare function findKeyboardWindow(tree: LayoutNode, imeBundles: readonly string[]): LayoutNode | null;
+
+/** `uitest uiInput` actions plus the composite ones built on top of them. */
+type UiInputType = InputType | 'clearText' | 'hideKeyboard';
+interface DeviceOptions {
+    config: ConfigProvider;
+    deviceSerial?: string;
+    logger?: Logger;
+}
+/**
+ * Dismiss the soft keyboard with Back — only when it is actually on screen, since
+ * Back without a keyboard navigates away. Returns whether a keyboard was dismissed.
+ */
+declare function hideKeyboard(opts: DeviceOptions): Promise<boolean>;
+interface LocateTargetOptions extends DeviceOptions {
+    selector: LayoutSelector;
+    /** Picks among several matching elements (see {@link pickTarget}). */
+    index?: number;
+    /**
+     * When the soft keyboard is up and the target is missing, covered, or matches
+     * only a non-clickable label (the button may be hidden below the keyboard),
+     * dismiss the keyboard and look again. Default true.
+     */
+    hideKeyboard?: boolean;
+}
+interface LocatedTarget {
+    node: FlatLayoutNode;
+    /** Center of the element in device pixels. */
+    x: number;
+    y: number;
+    display: DisplaySize;
+    /** The soft keyboard was dismissed to reach the element. */
+    keyboardHidden: boolean;
+}
+/**
+ * Resolve a selector against the live layout to one element and its pixel
+ * center. Keys on the soft keyboard are not candidates.
+ */
+declare function locateTarget(opts: LocateTargetOptions): Promise<LocatedTarget>;
+interface PerformInputOptions extends DeviceOptions {
+    type: UiInputType;
+    /** Start point in device pixels. */
+    pxX?: number;
+    pxY?: number;
+    /** End point in device pixels (swipe/drag/fling). */
+    pxX2?: number;
+    pxY2?: number;
+    /** Start point as 0–1 fractions of the display. */
+    fx?: number;
+    fy?: number;
+    /** End point as 0–1 fractions of the display. */
+    fx2?: number;
+    fy2?: number;
+    /** Start point: the center of the element matching this selector. */
+    target?: LayoutSelector;
+    /** Picks among several elements matching `target`. */
+    targetIndex?: number;
+    /** Velocity for swipe/drag/fling. */
+    speed?: number;
+    /** Key for keyEvent (see `resolveKeyEvent`). */
+    key?: string | number;
+    /** Text for inputText. */
+    text?: string;
+    /** inputText: clear the field before typing. */
+    clear?: boolean;
+    /** Dismiss the soft keyboard after the action, if it is up. */
+    hideKeyboard?: boolean;
+}
+interface PerformInputResult {
+    /** Resolved start point in device pixels, when the action has one. */
+    x?: number;
+    y?: number;
+    /** The element `target` resolved to. */
+    target?: FlatLayoutNode;
+    /** The soft keyboard was dismissed (to reach the target, or because it was asked to). */
+    keyboardHidden: boolean;
+}
+/**
+ * Perform a UI input action. Beyond the raw `uitest uiInput` primitives, this
+ * resolves the start point from an element selector (`target`), 0–1 display
+ * fractions, or pixels; clears text fields (Ctrl+A, Delete); and dismisses the
+ * soft keyboard only when it is up.
+ */
+declare function performInput(opts: PerformInputOptions): Promise<PerformInputResult>;
+interface WaitForTargetOptions extends DeviceOptions {
+    selector: LayoutSelector;
+    /** Wait until no uncovered element matches, instead of until one does. */
+    gone?: boolean;
+    timeoutMs: number;
+    /** Poll interval. Default 500 (each poll is a full layout dump). */
+    pollMs?: number;
+    abortSignal?: AbortSignal;
+}
+/**
+ * Poll the layout until an uncovered element matches `selector` (resolving with
+ * it), or with `gone`, until none does (resolving null). Keys on the soft
+ * keyboard are ignored. Throws on timeout.
+ */
+declare function waitForTarget(opts: WaitForTargetOptions): Promise<FlatLayoutNode | null>;
+
 /**
  * Read the project's bundle name from `AppScope/app.json5`.
  */
@@ -2069,4 +2274,4 @@ declare function harmonyOsAutoSign(opts: HarmonyOsAutoSignOptions): Promise<Harm
 
 declare const VERSION: string;
 
-export { ALL_SDKS, APL_VALUES, APP_FEATURE_VALUES, type AbilityInfo, type AgcAuthInfo, AgcError, 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 DeveloperAgreementStatus, 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, HARMONYOS_SDK_VERSIONS, HUAWEI_SITES, type HapAssetDiff, type HarmonyOsAutoSignOptions, type HarmonyOsSdk, type HarmonyOsSession, type HarmonyOsSessionOptions, type HarmonyOsSigningResult, type HdcExecOptions, type HdcExecResult, type HdcShellOptions, type HidumperOptions, type HilogEntry, type HilogLevel, type HuaweiSite, type HuaweiSiteCode, type HuaweiTeam, type HuaweiUserInfo, 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 ProvisionProfileInfo, type RawLayoutNode, type RawTouchEvent, type RebootDecision, type RebootOptions, type RecvFileOptions, type RunCodelinterOptions, type RunHvigorwOptions, type RunHvigorwResult, type RunOhpmOptions, type RunProcessOptions, type RunningProcess, type RuntimeOs, SIGNING_ERRORS, 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 SigningMaterialPaths, type SigningPasswords, type StartEmulatorOptions, type StoredSession, type StreamHilogOptions, TMP_DIR_HINT, type TemplateOption, type TokenStore, 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, createHarmonyOsSession, createInstallTempDir, createMaterial, createScaffold, createTempWorkDir, createTokenStore, decideInstallMethod, decideReboot, decryptPwd, dedupEntries, defaultContext, defaultPaths, detectAaStartFailure, detectProjectSdkVersion, detectRuntimeOs, detectSigningConfigNames, diffEntryNames, diffHapAssets, discoverHaps, downloadAndInstallSdk, downloadFile, dumpLayout, dumpLog, dumpRenderService, dumpScreen, dumpWindow, encryptPwd, ensureFreeSpace, ensureOhModules, ensureOk, ensureRemoteOk, escapeCmdArgument, escapeCmdCommand, extractTarball, extractZipWithProgress, findAppProcessId, findCmdToolsSourceDir, findHarmonyOsSdk, findRunningProcess, forceStop, formatBytes, generateSigningConfigs, getBundleName, getCmdToolsBin, getCmdToolsDownloadUrl, getCmdToolsPath, getCmdToolsStatus, getDeviceInfo, getDisplaySize, getEmulatorDir, getFreeSpaceBytes, getHdcPath, getHvigorwPath, getInstalledSdks, getKey, getMainAbility, getOhosBaseSdkHome, getOhpmPath, getOsFolder, getSdkFilename, getSdkRootDir, getSupportedSdksForUi, harmonyOsAutoSign, harmonyOsSdkLabelForApi, 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, readProvisionProfile, reboot, recvFile, removeCmdTools, removeEmulator, removeSdk, removeTempWorkDir, requireHarmonyOsSdk, 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 };
+export { ALL_SDKS, APL_VALUES, APP_FEATURE_VALUES, type AbilityInfo, type AgcAuthInfo, AgcError, 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 DeveloperAgreementStatus, type DeviceFullInfo, type DeviceInfo, type DiscoverHapsOptions, type DisplaySize, type DisplaySizeOptions, type DownloadOptions, type DumpLayoutOptions, type DumpLayoutResult, type DumpLogOptions, type ExtractZipOptions, type FlatLayoutNode, type GenerateSigningConfigsOptions, type GestureUitestOptions, type GetDeviceInfoOptions, HARMONYOS_SDK_VERSIONS, HUAWEI_SITES, type HapAssetDiff, type HarmonyOsAutoSignOptions, type HarmonyOsSdk, type HarmonyOsSession, type HarmonyOsSessionOptions, type HarmonyOsSigningResult, type HdcExecOptions, type HdcExecResult, type HdcShellOptions, type HidumperOptions, type HilogEntry, type HilogLevel, type HuaweiSite, type HuaweiSiteCode, type HuaweiTeam, type HuaweiUserInfo, INSTALL_TMP_DIRNAME, type InputType, type InstallAppOptions, type InstallAppResult, type InstallCmdToolsOptions, type InstallEmulatorOptions, type InstallMethod, type InstallSdkOptions, type InstallTempDir, type InstallTempDirOptions, InsufficientSpaceError, type KeyboardState, type LaunchAppOptions, type LayoutNode, type LayoutSelector, type LocateTargetOptions, type LocatedTarget, type Logger, type ModuleHaps, OHOS_URL_BASE, type OniroContext, OniroError, type OsFolder, type OutputSink, type ParamOptions, type PerformInputOptions, type PerformInputResult, type PickTargetFailure, type PrepareSigningOptions, type PrepareSigningResult, type ProgressReporter, type ProgressUpdate, type ProjectModule, type Prompter, type ProvisionProfileInfo, type RawLayoutNode, type RawTouchEvent, type RebootDecision, type RebootOptions, type RecvFileOptions, type RunCodelinterOptions, type RunHvigorwOptions, type RunHvigorwResult, type RunOhpmOptions, type RunProcessOptions, type RunningProcess, type RuntimeOs, SIGNING_ERRORS, 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 SigningMaterialPaths, type SigningPasswords, type StartEmulatorOptions, type StoredSession, type StreamHilogOptions, TMP_DIR_HINT, TargetNotFoundError, type TemplateOption, type TokenStore, type UiInputType, UnsupportedPlatformError, VERSION, type WaitForBootOptions, type WaitForBundleOptions, type WaitForConditionOptions, type WaitForLogOptions, type WaitForTargetOptions, type WatchLogOptions, type Waypoint, applyChanges, assertLayoutSelector, attemptHdcConnection, buildCmdWrapper, buildGestureCommands, buildGestureUitestCommand, buildHap, buildHvigorwArgs, buildInputCommand, buildRawTouchCommand, captureBurst, consoleLogger, createHarmonyOsSession, createInstallTempDir, createMaterial, createScaffold, createTempWorkDir, createTokenStore, decideInstallMethod, decideReboot, decryptPwd, dedupEntries, defaultContext, defaultPaths, describeLayoutNode, detectAaStartFailure, detectProjectSdkVersion, detectRuntimeOs, detectSigningConfigNames, diffEntryNames, diffHapAssets, discoverHaps, downloadAndInstallSdk, downloadFile, dumpLayout, dumpLog, dumpRenderService, dumpScreen, dumpWindow, encryptPwd, ensureFreeSpace, ensureOhModules, ensureOk, ensureRemoteOk, escapeCmdArgument, escapeCmdCommand, extractTarball, extractZipWithProgress, findAppProcessId, findCmdToolsSourceDir, findCoveredNodes, findHarmonyOsSdk, findKeyboardWindow, findLayoutNodes, findRunningProcess, flattenLayout, forceStop, formatBytes, generateSigningConfigs, getBundleName, getCmdToolsBin, getCmdToolsDownloadUrl, getCmdToolsPath, getCmdToolsStatus, getDeviceInfo, getDisplaySize, getEmulatorDir, getFreeSpaceBytes, getHdcPath, getHvigorwPath, getImeBundles, getInstalledSdks, getKey, getMainAbility, getOhosBaseSdkHome, getOhpmPath, getOsFolder, getSdkFilename, getSdkRootDir, getSupportedSdksForUi, harmonyOsAutoSign, harmonyOsSdkLabelForApi, hdcExec, hideKeyboard, installApp, installCmdTools, installEmulator, isCmdToolsInstalled, isEmulatorInstalled, isOutOfSpaceError, isRamBackedPath, isValidBundleName, isValidProjectName, killProcessTree, launchApp, listAbilities, listDevices, listModules, listRunningProcesses, listTemplates, locateTarget, needsCmdWrapper, nonInteractivePrompter, noopLogger, noopProgress, paramGet, paramSet, parseBounds, parseCodelinterFindings, parseDeviceList, parseHilogLine, parseImeBundles, parseMainAbilityFromBmDump, parseRemoteExit, performInput, pickSigningKind, pickTarget, prepareSigning, pruneLayout, readJson5File, readJsonFile, readProvisionProfile, reboot, recvFile, removeCmdTools, removeEmulator, removeSdk, removeTempWorkDir, requireHarmonyOsSdk, resolveKeyEvent, 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, waitForTarget, watchLog, waypointsToRawEvents, withoutWindow, writeJson5File, writeJsonFile };

package/dist/index.d.ts

@@ -1008,13 +1008,20 @@ interface SendInputOptions {
     pxY2?: number;
     /** Velocity for swipe/drag/fling. */
     speed?: number;
-    /** Key id or symbolic name (Back/Home/Power) for keyEvent. */
+    /** Key for keyEvent: a KeyCode id, a name (Back, Delete, Enter, …), or a combo like `Ctrl+A`. See {@link resolveKeyEvent}. */
     key?: string | number;
     /** Text for inputText. */
     text?: string;
     deviceSerial?: string;
     logger?: Logger;
 }
+/**
+ * Resolve a key spec to `uitest uiInput keyEvent` arguments. Accepts uitest's
+ * own names (Back/Home/Power), numeric KeyCode ids, named keys (Delete, Enter,
+ * Tab, Escape, MoveHome, …), single letters, and combos of up to three keys
+ * joined by "+" (e.g. `Ctrl+A`) or given as space-separated ids. Pure.
+ */
+declare function resolveKeyEvent(key: string | number): string;
 /**
  * Build the `uitest uiInput …` command for an input action, in pixel space.
  * Pure (no I/O) so it is unit-testable. Mirrors the proven MCP construction
@@ -1125,6 +1132,8 @@ interface LayoutNode {
     type?: string;
     text?: string;
     desc?: string;
+    /** Placeholder text, e.g. an empty TextInput's "you@example.com". */
+    hint?: string;
     id?: string;
     key?: string;
     bundle?: string;
@@ -1135,28 +1144,105 @@ interface LayoutNode {
     focus?: boolean;
     scroll?: boolean;
     longClick?: boolean;
+    /** The component is disabled (`enabled: false`). */
+    disabled?: boolean;
+    /** The node's center is painted over by a later filled node (an overlay, a
+     *  dialog scrim, the soft keyboard), so a tap there would land on that instead. */
+    covered?: boolean;
     children?: LayoutNode[];
 }
+/** The soft keyboard, when an input-method window is on screen. */
+interface KeyboardState {
+    shown: boolean;
+    /** Bundle of the input-method window. */
+    bundle?: string;
+    /** Bounds [x1,y1,x2,y2] normalized to 0–1 of the display. */
+    b?: [number, number, number, number];
+}
 interface DumpLayoutResult {
     display: DisplaySize | null;
     tree: LayoutNode;
+    /** Present when the dump was asked to detect the soft keyboard. */
+    keyboard?: KeyboardState;
 }
 /** Parse a uitest bounds string `"[x1,y1][x2,y2]"` into a tuple, or null. */
 declare function parseBounds(s: string | undefined): [number, number, number, number] | null;
+/**
+ * Find nodes whose center is painted over by a later node with a visible
+ * background fill — a full-screen overlay, a dialog scrim, a sticky bar, or the
+ * soft-keyboard window. Paint order is depth-first, siblings ordered by
+ * `zIndex`, windows in dump order; ancestors and descendants never cover a node.
+ *
+ * A heuristic: only background fills count (an Image or Text drawn on top does
+ * not), which is what overlays in practice use.
+ */
+declare function findCoveredNodes(root: RawLayoutNode): Set<RawLayoutNode>;
 /**
  * Prune a raw `uitest dumpLayout` tree into a compact, signal-bearing tree with
  * bounds/center normalized to 0–1 of the display. Structural wrapper nodes with
  * no signal collapse into their children. Returns a node, a flat list of nodes
  * (collapsed wrapper with multiple children), or null (nothing useful). Ported
- * verbatim from the proven MCP `pruneNode`.
+ * from the proven MCP `pruneNode`; `covered` (from {@link findCoveredNodes})
+ * marks nodes hidden under an overlay.
+ */
+declare function pruneLayout(node: RawLayoutNode, display: DisplaySize | null, covered?: ReadonlySet<RawLayoutNode>): LayoutNode | LayoutNode[] | null;
+/** A pruned layout node without children, tagged with the window it belongs to. */
+interface FlatLayoutNode extends Omit<LayoutNode, 'children'> {
+    /** Bundle of the enclosing window (the nearest node carrying `bundle`). */
+    window?: string;
+}
+/** Flatten a pruned layout tree into a depth-first (paint-order) list. */
+declare function flattenLayout(tree: LayoutNode): FlatLayoutNode[];
+/** Selects layout nodes by what an agent can read off the screen. */
+interface LayoutSelector {
+    /** Matches `text`, `desc`, or `hint`: case-insensitive exact matches win; otherwise substring matches. */
+    text?: string;
+    /** Matches `id` or `key` exactly. */
+    id?: string;
+    /** Restricts to a component type (e.g. `Button`, `TextInput`); case-insensitive. */
+    type?: string;
+}
+/** Throw unless `selector` constrains something: a non-blank text, an id, or a type. */
+declare function assertLayoutSelector(selector: LayoutSelector): void;
+/**
+ * The tree without the windows owned by `bundle` — e.g. the soft keyboard, whose
+ * keys ("Done", "9") would otherwise match element selectors. Pure.
+ */
+declare function withoutWindow(tree: LayoutNode, bundle: string): LayoutNode;
+/**
+ * Find the nodes matching `selector` in a pruned layout tree, in paint order.
+ * For `text`, exact (case-insensitive, trimmed) matches are returned when any
+ * exist; otherwise substring matches. Covered nodes are included — callers
+ * decide what to do with them (see {@link pickTarget}).
  */
-declare function pruneLayout(node: RawLayoutNode, display: DisplaySize | null): LayoutNode | LayoutNode[] | null;
+declare function findLayoutNodes(tree: LayoutNode, selector: LayoutSelector): FlatLayoutNode[];
+/** One-line summary of a node, used in errors and logs. */
+declare function describeLayoutNode(n: FlatLayoutNode): string;
+/** Why {@link pickTarget} could not choose a node. */
+type PickTargetFailure = 'none' | 'covered' | 'ambiguous';
+declare class TargetNotFoundError extends OniroError {
+    readonly reason: PickTargetFailure;
+    constructor(message: string, reason: PickTargetFailure);
+}
+/**
+ * Choose the single node to act on for `selector`. Covered nodes are skipped;
+ * clickable matches are preferred over plain ones (a "Sign in" Button over the
+ * "Sign in" title); a match nested inside another clickable match collapses
+ * into it. `index` picks among what remains, in paint order. Throws
+ * {@link TargetNotFoundError} when nothing (or more than one node) qualifies.
+ */
+declare function pickTarget(tree: LayoutNode, selector: LayoutSelector, index?: number): FlatLayoutNode;
 interface DumpLayoutOptions {
     config: ConfigProvider;
     /** Filter to a single window/bundle (`uitest dumpLayout -b '<bundle>'`). */
     bundleName?: string;
     /** When false, return the parsed-but-unpruned tree. Default true. */
     prune?: boolean;
+    /**
+     * Also report whether the soft keyboard is on screen (one extra `hidumper` call).
+     * Ignored with `bundleName`, which filters the keyboard window out of the dump.
+     */
+    detectKeyboard?: boolean;
     deviceSerial?: string;
     timeoutMs?: number;
     logger?: Logger;
@@ -1167,6 +1253,125 @@ interface DumpLayoutOptions {
  */
 declare function dumpLayout(opts: DumpLayoutOptions): Promise<DumpLayoutResult>;
 
+/**
+ * Extract input-method bundle names from `hidumper -s 3703 -a -a` output, whose
+ * `imeList` entries look like `"ime": "com.example.kikakeyboard/ServiceExtAbility"`.
+ * The current IME comes first. Pure.
+ */
+declare function parseImeBundles(output: string): string[];
+/**
+ * List the installed input-method bundles (current first). Empty when hidumper
+ * fails or times out, so keyboard detection never fails the caller.
+ */
+declare function getImeBundles(config: ConfigProvider, opts?: {
+    deviceSerial?: string;
+    logger?: Logger;
+}): Promise<string[]>;
+/**
+ * Find the input-method window in a pruned layout tree. uitest lists the soft
+ * keyboard as its own window (a node carrying the IME's `bundle`) only while it
+ * is shown. With no known IME bundles, falls back to a name heuristic. Pure.
+ */
+declare function findKeyboardWindow(tree: LayoutNode, imeBundles: readonly string[]): LayoutNode | null;
+
+/** `uitest uiInput` actions plus the composite ones built on top of them. */
+type UiInputType = InputType | 'clearText' | 'hideKeyboard';
+interface DeviceOptions {
+    config: ConfigProvider;
+    deviceSerial?: string;
+    logger?: Logger;
+}
+/**
+ * Dismiss the soft keyboard with Back — only when it is actually on screen, since
+ * Back without a keyboard navigates away. Returns whether a keyboard was dismissed.
+ */
+declare function hideKeyboard(opts: DeviceOptions): Promise<boolean>;
+interface LocateTargetOptions extends DeviceOptions {
+    selector: LayoutSelector;
+    /** Picks among several matching elements (see {@link pickTarget}). */
+    index?: number;
+    /**
+     * When the soft keyboard is up and the target is missing, covered, or matches
+     * only a non-clickable label (the button may be hidden below the keyboard),
+     * dismiss the keyboard and look again. Default true.
+     */
+    hideKeyboard?: boolean;
+}
+interface LocatedTarget {
+    node: FlatLayoutNode;
+    /** Center of the element in device pixels. */
+    x: number;
+    y: number;
+    display: DisplaySize;
+    /** The soft keyboard was dismissed to reach the element. */
+    keyboardHidden: boolean;
+}
+/**
+ * Resolve a selector against the live layout to one element and its pixel
+ * center. Keys on the soft keyboard are not candidates.
+ */
+declare function locateTarget(opts: LocateTargetOptions): Promise<LocatedTarget>;
+interface PerformInputOptions extends DeviceOptions {
+    type: UiInputType;
+    /** Start point in device pixels. */
+    pxX?: number;
+    pxY?: number;
+    /** End point in device pixels (swipe/drag/fling). */
+    pxX2?: number;
+    pxY2?: number;
+    /** Start point as 0–1 fractions of the display. */
+    fx?: number;
+    fy?: number;
+    /** End point as 0–1 fractions of the display. */
+    fx2?: number;
+    fy2?: number;
+    /** Start point: the center of the element matching this selector. */
+    target?: LayoutSelector;
+    /** Picks among several elements matching `target`. */
+    targetIndex?: number;
+    /** Velocity for swipe/drag/fling. */
+    speed?: number;
+    /** Key for keyEvent (see `resolveKeyEvent`). */
+    key?: string | number;
+    /** Text for inputText. */
+    text?: string;
+    /** inputText: clear the field before typing. */
+    clear?: boolean;
+    /** Dismiss the soft keyboard after the action, if it is up. */
+    hideKeyboard?: boolean;
+}
+interface PerformInputResult {
+    /** Resolved start point in device pixels, when the action has one. */
+    x?: number;
+    y?: number;
+    /** The element `target` resolved to. */
+    target?: FlatLayoutNode;
+    /** The soft keyboard was dismissed (to reach the target, or because it was asked to). */
+    keyboardHidden: boolean;
+}
+/**
+ * Perform a UI input action. Beyond the raw `uitest uiInput` primitives, this
+ * resolves the start point from an element selector (`target`), 0–1 display
+ * fractions, or pixels; clears text fields (Ctrl+A, Delete); and dismisses the
+ * soft keyboard only when it is up.
+ */
+declare function performInput(opts: PerformInputOptions): Promise<PerformInputResult>;
+interface WaitForTargetOptions extends DeviceOptions {
+    selector: LayoutSelector;
+    /** Wait until no uncovered element matches, instead of until one does. */
+    gone?: boolean;
+    timeoutMs: number;
+    /** Poll interval. Default 500 (each poll is a full layout dump). */
+    pollMs?: number;
+    abortSignal?: AbortSignal;
+}
+/**
+ * Poll the layout until an uncovered element matches `selector` (resolving with
+ * it), or with `gone`, until none does (resolving null). Keys on the soft
+ * keyboard are ignored. Throws on timeout.
+ */
+declare function waitForTarget(opts: WaitForTargetOptions): Promise<FlatLayoutNode | null>;
+
 /**
  * Read the project's bundle name from `AppScope/app.json5`.
  */
@@ -2069,4 +2274,4 @@ declare function harmonyOsAutoSign(opts: HarmonyOsAutoSignOptions): Promise<Harm
 
 declare const VERSION: string;
 
-export { ALL_SDKS, APL_VALUES, APP_FEATURE_VALUES, type AbilityInfo, type AgcAuthInfo, AgcError, 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 DeveloperAgreementStatus, 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, HARMONYOS_SDK_VERSIONS, HUAWEI_SITES, type HapAssetDiff, type HarmonyOsAutoSignOptions, type HarmonyOsSdk, type HarmonyOsSession, type HarmonyOsSessionOptions, type HarmonyOsSigningResult, type HdcExecOptions, type HdcExecResult, type HdcShellOptions, type HidumperOptions, type HilogEntry, type HilogLevel, type HuaweiSite, type HuaweiSiteCode, type HuaweiTeam, type HuaweiUserInfo, 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 ProvisionProfileInfo, type RawLayoutNode, type RawTouchEvent, type RebootDecision, type RebootOptions, type RecvFileOptions, type RunCodelinterOptions, type RunHvigorwOptions, type RunHvigorwResult, type RunOhpmOptions, type RunProcessOptions, type RunningProcess, type RuntimeOs, SIGNING_ERRORS, 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 SigningMaterialPaths, type SigningPasswords, type StartEmulatorOptions, type StoredSession, type StreamHilogOptions, TMP_DIR_HINT, type TemplateOption, type TokenStore, 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, createHarmonyOsSession, createInstallTempDir, createMaterial, createScaffold, createTempWorkDir, createTokenStore, decideInstallMethod, decideReboot, decryptPwd, dedupEntries, defaultContext, defaultPaths, detectAaStartFailure, detectProjectSdkVersion, detectRuntimeOs, detectSigningConfigNames, diffEntryNames, diffHapAssets, discoverHaps, downloadAndInstallSdk, downloadFile, dumpLayout, dumpLog, dumpRenderService, dumpScreen, dumpWindow, encryptPwd, ensureFreeSpace, ensureOhModules, ensureOk, ensureRemoteOk, escapeCmdArgument, escapeCmdCommand, extractTarball, extractZipWithProgress, findAppProcessId, findCmdToolsSourceDir, findHarmonyOsSdk, findRunningProcess, forceStop, formatBytes, generateSigningConfigs, getBundleName, getCmdToolsBin, getCmdToolsDownloadUrl, getCmdToolsPath, getCmdToolsStatus, getDeviceInfo, getDisplaySize, getEmulatorDir, getFreeSpaceBytes, getHdcPath, getHvigorwPath, getInstalledSdks, getKey, getMainAbility, getOhosBaseSdkHome, getOhpmPath, getOsFolder, getSdkFilename, getSdkRootDir, getSupportedSdksForUi, harmonyOsAutoSign, harmonyOsSdkLabelForApi, 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, readProvisionProfile, reboot, recvFile, removeCmdTools, removeEmulator, removeSdk, removeTempWorkDir, requireHarmonyOsSdk, 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 };
+export { ALL_SDKS, APL_VALUES, APP_FEATURE_VALUES, type AbilityInfo, type AgcAuthInfo, AgcError, 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 DeveloperAgreementStatus, type DeviceFullInfo, type DeviceInfo, type DiscoverHapsOptions, type DisplaySize, type DisplaySizeOptions, type DownloadOptions, type DumpLayoutOptions, type DumpLayoutResult, type DumpLogOptions, type ExtractZipOptions, type FlatLayoutNode, type GenerateSigningConfigsOptions, type GestureUitestOptions, type GetDeviceInfoOptions, HARMONYOS_SDK_VERSIONS, HUAWEI_SITES, type HapAssetDiff, type HarmonyOsAutoSignOptions, type HarmonyOsSdk, type HarmonyOsSession, type HarmonyOsSessionOptions, type HarmonyOsSigningResult, type HdcExecOptions, type HdcExecResult, type HdcShellOptions, type HidumperOptions, type HilogEntry, type HilogLevel, type HuaweiSite, type HuaweiSiteCode, type HuaweiTeam, type HuaweiUserInfo, INSTALL_TMP_DIRNAME, type InputType, type InstallAppOptions, type InstallAppResult, type InstallCmdToolsOptions, type InstallEmulatorOptions, type InstallMethod, type InstallSdkOptions, type InstallTempDir, type InstallTempDirOptions, InsufficientSpaceError, type KeyboardState, type LaunchAppOptions, type LayoutNode, type LayoutSelector, type LocateTargetOptions, type LocatedTarget, type Logger, type ModuleHaps, OHOS_URL_BASE, type OniroContext, OniroError, type OsFolder, type OutputSink, type ParamOptions, type PerformInputOptions, type PerformInputResult, type PickTargetFailure, type PrepareSigningOptions, type PrepareSigningResult, type ProgressReporter, type ProgressUpdate, type ProjectModule, type Prompter, type ProvisionProfileInfo, type RawLayoutNode, type RawTouchEvent, type RebootDecision, type RebootOptions, type RecvFileOptions, type RunCodelinterOptions, type RunHvigorwOptions, type RunHvigorwResult, type RunOhpmOptions, type RunProcessOptions, type RunningProcess, type RuntimeOs, SIGNING_ERRORS, 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 SigningMaterialPaths, type SigningPasswords, type StartEmulatorOptions, type StoredSession, type StreamHilogOptions, TMP_DIR_HINT, TargetNotFoundError, type TemplateOption, type TokenStore, type UiInputType, UnsupportedPlatformError, VERSION, type WaitForBootOptions, type WaitForBundleOptions, type WaitForConditionOptions, type WaitForLogOptions, type WaitForTargetOptions, type WatchLogOptions, type Waypoint, applyChanges, assertLayoutSelector, attemptHdcConnection, buildCmdWrapper, buildGestureCommands, buildGestureUitestCommand, buildHap, buildHvigorwArgs, buildInputCommand, buildRawTouchCommand, captureBurst, consoleLogger, createHarmonyOsSession, createInstallTempDir, createMaterial, createScaffold, createTempWorkDir, createTokenStore, decideInstallMethod, decideReboot, decryptPwd, dedupEntries, defaultContext, defaultPaths, describeLayoutNode, detectAaStartFailure, detectProjectSdkVersion, detectRuntimeOs, detectSigningConfigNames, diffEntryNames, diffHapAssets, discoverHaps, downloadAndInstallSdk, downloadFile, dumpLayout, dumpLog, dumpRenderService, dumpScreen, dumpWindow, encryptPwd, ensureFreeSpace, ensureOhModules, ensureOk, ensureRemoteOk, escapeCmdArgument, escapeCmdCommand, extractTarball, extractZipWithProgress, findAppProcessId, findCmdToolsSourceDir, findCoveredNodes, findHarmonyOsSdk, findKeyboardWindow, findLayoutNodes, findRunningProcess, flattenLayout, forceStop, formatBytes, generateSigningConfigs, getBundleName, getCmdToolsBin, getCmdToolsDownloadUrl, getCmdToolsPath, getCmdToolsStatus, getDeviceInfo, getDisplaySize, getEmulatorDir, getFreeSpaceBytes, getHdcPath, getHvigorwPath, getImeBundles, getInstalledSdks, getKey, getMainAbility, getOhosBaseSdkHome, getOhpmPath, getOsFolder, getSdkFilename, getSdkRootDir, getSupportedSdksForUi, harmonyOsAutoSign, harmonyOsSdkLabelForApi, hdcExec, hideKeyboard, installApp, installCmdTools, installEmulator, isCmdToolsInstalled, isEmulatorInstalled, isOutOfSpaceError, isRamBackedPath, isValidBundleName, isValidProjectName, killProcessTree, launchApp, listAbilities, listDevices, listModules, listRunningProcesses, listTemplates, locateTarget, needsCmdWrapper, nonInteractivePrompter, noopLogger, noopProgress, paramGet, paramSet, parseBounds, parseCodelinterFindings, parseDeviceList, parseHilogLine, parseImeBundles, parseMainAbilityFromBmDump, parseRemoteExit, performInput, pickSigningKind, pickTarget, prepareSigning, pruneLayout, readJson5File, readJsonFile, readProvisionProfile, reboot, recvFile, removeCmdTools, removeEmulator, removeSdk, removeTempWorkDir, requireHarmonyOsSdk, resolveKeyEvent, 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, waitForTarget, watchLog, waypointsToRawEvents, withoutWindow, writeJson5File, writeJsonFile };