winui-svelte 0.0.6 → 0.0.7

package/dist/app/tray-instance.js

@@ -1,7 +1,7 @@
 import { activateOrLaunch } from "./activate.js";
 import { currentUserSid, openPipe, pipeNameFor } from "./instance-pipe.js";
 import { encodeRedirect } from "./redirect.js";
-import { parseTrayManifest, TRAY_BUNDLE_FILE, TRAY_MANIFEST_FILE } from "../tray/tray-manifest.js";
+import { parseTrayManifestFile, processGuidOf, TRAY_BUNDLE_FILE, TRAY_MANIFEST_FILE } from "../tray/tray-manifest.js";
 import { readFileSync } from "node:fs";
 import path from "node:path";
 const KEY_PREFIX = "tray:";
@@ -16,8 +16,9 @@ export function trayInstanceKey(guid) {
     return `${KEY_PREFIX}${guid}`;
 }
 /**
- * Claims the right to be the one tray process for `guid`: the built `tray.js`
- * calls it first. A second copy finds the first and gets false, and exits.
+ * Claims the right to be the one tray process for `guid` (the first tray's,
+ * when the entrypoint defines several): the built `tray.js` calls it first.
+ * A second copy finds the first and gets false, and exits.
  * Needs no window or UI thread.
  *
  * @param options - The tray's guid.
@@ -38,7 +39,7 @@ export function claimTrayInstance({ guid }) {
 }
 /**
  * Starts the built `tray.js` as a process of its own, once: when one runs for
- * the same `guid` nothing starts. Optional, and never needed by the app's
+ * the same process guid nothing starts. Optional, and never needed by the app's
  * code: an installer, a launcher or the app's own `main` may call it.
  *
  * @param options - The folder of the build.
@@ -46,7 +47,8 @@ export function claimTrayInstance({ guid }) {
  * @throws {Error} When `tray.json` is missing or is not a tray manifest.
  */
 export function startTray({ directory = process.cwd(), activate = activateOrLaunch } = {}) {
-    const { guid } = parseTrayManifest(JSON.parse(readFileSync(path.join(directory, TRAY_MANIFEST_FILE), "utf8")));
+    const manifest = JSON.parse(readFileSync(path.join(directory, TRAY_MANIFEST_FILE), "utf8"));
+    const guid = processGuidOf(parseTrayManifestFile(manifest));
     return activate({
         key: trayInstanceKey(guid),
         activation: {

package/dist/app/tray-instance.js.map

@@ -1 +1 @@
-{"version":3,"file":"tray-instance.js","sourceRoot":"","sources":["../../src/app/tray-instance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrG,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,GAAG,OAAO,CAAC;AAE3B;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,GAAG,UAAU,GAAG,IAAI,EAAE,CAAC;AAChC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAE,IAAI,EAAoB;IAC1D,MAAM,IAAI,GAAG,QAAQ,CAAC;QACpB,QAAQ,EAAE,WAAW,CAAC;YACpB,GAAG,EAAE,eAAe,CAAC,IAAI,CAAC;YAC1B,GAAG,EAAE,cAAc,EAAE;SACtB,CAAC;QACF,OAAO,EAAE,cAAc,CAAC;YACtB,SAAS,EAAE,EAAE;YACb,gBAAgB,EAAE,OAAO,CAAC,GAAG,EAAE;SAChC,CAAC;KACH,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,SAAS,CAAC;AACxB,CAAC;AAWD;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,GAAG,gBAAgB,KAAuB,EAAE;IACzG,MAAM,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/G,OAAO,QAAQ,CAAC;QACd,GAAG,EAAE,eAAe,CAAC,IAAI,CAAC;QAC1B,UAAU,EAAE;YACV,SAAS,EAAE,EAAE;YACb,gBAAgB,EAAE,SAAS;SAC5B;QACD,MAAM,EAAE;YACN,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;YACnD,gBAAgB,EAAE,SAAS;SAC5B;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"tray-instance.js","sourceRoot":"","sources":["../../src/app/tray-instance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACxH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,GAAG,OAAO,CAAC;AAE3B;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,GAAG,UAAU,GAAG,IAAI,EAAE,CAAC;AAChC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAE,IAAI,EAAoB;IAC1D,MAAM,IAAI,GAAG,QAAQ,CAAC;QACpB,QAAQ,EAAE,WAAW,CAAC;YACpB,GAAG,EAAE,eAAe,CAAC,IAAI,CAAC;YAC1B,GAAG,EAAE,cAAc,EAAE;SACtB,CAAC;QACF,OAAO,EAAE,cAAc,CAAC;YACtB,SAAS,EAAE,EAAE;YACb,gBAAgB,EAAE,OAAO,CAAC,GAAG,EAAE;SAChC,CAAC;KACH,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,SAAS,CAAC;AACxB,CAAC;AAWD;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,GAAG,gBAAgB,KAAuB,EAAE;IACzG,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5F,MAAM,IAAI,GAAG,aAAa,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5D,OAAO,QAAQ,CAAC;QACd,GAAG,EAAE,eAAe,CAAC,IAAI,CAAC;QAC1B,UAAU,EAAE;YACV,SAAS,EAAE,EAAE;YACb,gBAAgB,EAAE,SAAS;SAC5B;QACD,MAAM,EAAE;YACN,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;YACnD,gBAAgB,EAAE,SAAS;SAC5B;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/automation/backend.d.ts

@@ -0,0 +1,51 @@
+import type { UiaControlType } from "./ids.js";
+/** An element, or a text range, inside the scope of one `withUiaClient` call. */
+export type UiaHandle = number;
+/** The properties of an element, read in one cross-process call. */
+export interface UiaProperties {
+    readonly name: string;
+    readonly className: string;
+    readonly automationId: string;
+    readonly controlType: UiaControlType;
+    readonly processId: number;
+    readonly isOffscreen: boolean;
+    readonly boundingRectangle: {
+        readonly left: number;
+        readonly top: number;
+        readonly width: number;
+        readonly height: number;
+    };
+    /** 1 to 9 for a heading, 0 for an element that is not one. */
+    readonly headingLevel: number;
+    readonly hasTextPattern: boolean;
+    readonly hasValuePattern: boolean;
+}
+/** A child found by the walk: its handle and its properties. */
+export interface UiaChild {
+    readonly handle: UiaHandle;
+    readonly properties: UiaProperties;
+}
+/**
+ * The calls the client makes of UI Automation, over opaque handles. The real
+ * one is `createUiaNativeBackend`; a test passes a fake. Every handle lives
+ * until `dispose`.
+ */
+export interface UiaBackend {
+    elementFromHandle(hwnd: bigint): UiaHandle | null;
+    focusedElement(): UiaHandle | null;
+    properties(handle: UiaHandle): UiaProperties;
+    children(handle: UiaHandle): readonly UiaChild[];
+    visibleRanges(handle: UiaHandle): readonly UiaHandle[] | null;
+    documentRange(handle: UiaHandle): UiaHandle | null;
+    rangeText(options: {
+        readonly range: UiaHandle;
+        readonly maxLength: number;
+    }): string;
+    value(handle: UiaHandle): string | null;
+    dispose(): void;
+}
+/** The element went away (or never answered) while the client was reading it. */
+export declare class UiaElementUnavailableError extends Error {
+    name: string;
+}
+//# sourceMappingURL=backend.d.ts.map

package/dist/automation/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/automation/backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,iFAAiF;AACjF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE;QAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;IAEF,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED,gEAAgE;AAChE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAClD,cAAc,IAAI,SAAS,GAAG,IAAI,CAAC;IACnC,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,QAAQ,EAAE,CAAC;IACjD,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,SAAS,EAAE,GAAG,IAAI,CAAC;IAC9D,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;IACnD,SAAS,CAAC,OAAO,EAAE;QACjB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;QAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,GAAG,MAAM,CAAC;IACX,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,iFAAiF;AACjF,qBAAa,0BAA2B,SAAQ,KAAK;IAC1C,IAAI,SAAgC;CAC9C"}

package/dist/automation/backend.js

@@ -0,0 +1,5 @@
+/** The element went away (or never answered) while the client was reading it. */
+export class UiaElementUnavailableError extends Error {
+    name = "UiaElementUnavailableError";
+}
+//# sourceMappingURL=backend.js.map

package/dist/automation/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../src/automation/backend.ts"],"names":[],"mappings":"AAoDA,iFAAiF;AACjF,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,IAAI,GAAG,4BAA4B,CAAC;CAC9C"}

package/dist/automation/client.d.ts

@@ -0,0 +1,97 @@
+import type { UiaBackend, UiaProperties } from "./backend.js";
+import { UiaPatternName } from "./ids.js";
+/** Why a walk ended. */
+export declare const UiaWalkEnd: {
+    readonly complete: "complete";
+    readonly maxElements: "maxElements";
+    readonly deadline: "deadline";
+};
+/** One reason a walk ended. */
+export type UiaWalkEnd = typeof UiaWalkEnd[keyof typeof UiaWalkEnd];
+/** The client was used after its `withUiaClient` call ended. */
+export declare class UiaScopeEndedError extends Error {
+    name: string;
+}
+/** A call into a target process did not answer in time. */
+export declare class UiaTimeout extends Error {
+    name: string;
+}
+/** A range of text inside a text pattern. */
+export interface UiaTextRange {
+    /**
+     * The text of the range.
+     *
+     * @param maxLength - The most characters to take; the text is cut there.
+     */
+    getText(maxLength?: number): string;
+}
+/** The text pattern of an element (browsers, Word, Notepad, the editor of VS Code). */
+export interface UiaTextPattern {
+    /** The ranges that are on screen; the text beneath the element is covered by them. */
+    visibleRanges(): readonly UiaTextRange[];
+    documentRange(): UiaTextRange | null;
+}
+/** The value pattern of an element (an edit box). */
+export interface UiaValuePattern {
+    readonly value: string;
+}
+/** The patterns an element can offer, by name. */
+export interface UiaPatterns {
+    readonly text: UiaTextPattern;
+    readonly value: UiaValuePattern;
+}
+/** An element of another application, valid inside its `withUiaClient` call only. */
+export interface UiaElement {
+    /** The properties, read again from the target (a walk's nodes also carry the cached ones). */
+    properties(): UiaProperties;
+    /** The pattern, or null when the element does not offer it. */
+    pattern<Name extends UiaPatternName>(name: Name): UiaPatterns[Name] | null;
+}
+/** An element the walk visited. */
+export interface UiaNode extends UiaElement {
+    readonly depth: number;
+    /** Do not walk into this element: its text pattern already covers what is beneath it. */
+    skipSubtree(): void;
+    /** The properties as the walk read them, with no further call. */
+    readonly cached: UiaProperties;
+}
+/** The options of `client.walk`. */
+export interface UiaWalkOptions {
+    readonly root: UiaElement;
+    /** The most elements to visit; 400 by default. */
+    readonly maxElements?: number;
+    /** The soft deadline: the walk stops and keeps what it has; 400 by default. */
+    readonly maxMilliseconds?: number;
+    /** Return false to skip an element and its subtree; the default visits all. */
+    readonly shouldVisit?: (properties: UiaProperties) => boolean;
+}
+/** A walk: iterate it, then read `end`. */
+export interface UiaWalk extends Iterable<UiaNode> {
+    /** Why the walk ended; `complete` until it has. */
+    readonly end: UiaWalkEnd;
+}
+/** What `withUiaClient` hands to its callback. */
+export interface UiaClient {
+    /** The element of a window, or null when the window cannot be read (gone, or elevated). */
+    elementFromHandle(hwnd: bigint): UiaElement | null;
+    /** The element that has the keyboard focus, or null. */
+    focusedElement(): UiaElement | null;
+    /**
+     * A breadth first walk of the control view below the root. An element that
+     * went away is skipped, never thrown.
+     */
+    walk(options: UiaWalkOptions): UiaWalk;
+}
+/**
+ * Makes a UI Automation client over a backend and gives it to `use`; every
+ * element, range and COM pointer it made is released when `use` ends, and the
+ * elements then refuse to work (`UiaScopeEndedError`).
+ *
+ * @param options - `use`: the work; `backend`: the calls into UI Automation.
+ * @returns What `use` returned.
+ */
+export declare function runUiaClient<T>({ use, backend }: {
+    readonly use: (client: UiaClient) => T | Promise<T>;
+    readonly backend: UiaBackend;
+}): Promise<T>;
+//# sourceMappingURL=client.d.ts.map

package/dist/automation/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/automation/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAa,aAAa,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAM1C,wBAAwB;AACxB,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AAEX,+BAA+B;AAC/B,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEpE,gEAAgE;AAChE,qBAAa,kBAAmB,SAAQ,KAAK;IAClC,IAAI,SAAwB;CACtC;AAED,2DAA2D;AAC3D,qBAAa,UAAW,SAAQ,KAAK;IAC1B,IAAI,SAAgB;CAC9B;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACrC;AAED,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC7B,sFAAsF;IACtF,aAAa,IAAI,SAAS,YAAY,EAAE,CAAC;IACzC,aAAa,IAAI,YAAY,GAAG,IAAI,CAAC;CACtC;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;CACjC;AAED,qFAAqF;AACrF,MAAM,WAAW,UAAU;IACzB,8FAA8F;IAC9F,UAAU,IAAI,aAAa,CAAC;IAE5B,+DAA+D;IAC/D,OAAO,CAAC,IAAI,SAAS,cAAc,EAAE,IAAI,EAAE,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC5E;AAED,mCAAmC;AACnC,MAAM,WAAW,OAAQ,SAAQ,UAAU;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,yFAAyF;IACzF,WAAW,IAAI,IAAI,CAAC;IAEpB,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B,kDAAkD;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,+EAA+E;IAC/E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAElC,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,aAAa,KAAK,OAAO,CAAC;CAC/D;AAED,2CAA2C;AAC3C,MAAM,WAAW,OAAQ,SAAQ,QAAQ,CAAC,OAAO,CAAC;IAChD,mDAAmD;IACnD,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;CAC1B;AAED,kDAAkD;AAClD,MAAM,WAAW,SAAS;IACxB,2FAA2F;IAC3F,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IAEnD,wDAAwD;IACxD,cAAc,IAAI,UAAU,GAAG,IAAI,CAAC;IAEpC;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;CACxC;AA4BD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;IACtD,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;CAC9B,cAkLA"}

package/dist/automation/client.js

@@ -0,0 +1,203 @@
+import { UiaElementUnavailableError } from "./backend.js";
+import { UiaPatternName } from "./ids.js";
+const DEFAULT_MAX_ELEMENTS = 400;
+const DEFAULT_MAX_MILLISECONDS = 400;
+const DEFAULT_MAX_TEXT_LENGTH = 12_000;
+/** Why a walk ended. */
+export const UiaWalkEnd = {
+    complete: "complete",
+    maxElements: "maxElements",
+    deadline: "deadline"
+};
+/** The client was used after its `withUiaClient` call ended. */
+export class UiaScopeEndedError extends Error {
+    name = "UiaScopeEndedError";
+}
+/** A call into a target process did not answer in time. */
+export class UiaTimeout extends Error {
+    name = "UiaTimeout";
+}
+function stopOf({ startedAt, maxMilliseconds, isFull }) {
+    const isOverDeadline = performance.now() - startedAt > maxMilliseconds;
+    if (isOverDeadline) {
+        return UiaWalkEnd.deadline;
+    }
+    return isFull ? UiaWalkEnd.maxElements : null;
+}
+function nullIfUnavailable(read) {
+    try {
+        return read();
+    }
+    catch (error) {
+        const isUnavailable = error instanceof UiaElementUnavailableError;
+        if (isUnavailable) {
+            return null;
+        }
+        throw error;
+    }
+}
+/**
+ * Makes a UI Automation client over a backend and gives it to `use`; every
+ * element, range and COM pointer it made is released when `use` ends, and the
+ * elements then refuse to work (`UiaScopeEndedError`).
+ *
+ * @param options - `use`: the work; `backend`: the calls into UI Automation.
+ * @returns What `use` returned.
+ */
+export async function runUiaClient({ use, backend }) {
+    let isAlive = true;
+    const handles = new WeakMap();
+    function assertAlive() {
+        if (!isAlive) {
+            throw new UiaScopeEndedError("the UI Automation client ended with its withUiaClient call");
+        }
+    }
+    function rangeOf(range) {
+        const textRange = {
+            getText(maxLength = DEFAULT_MAX_TEXT_LENGTH) {
+                assertAlive();
+                return backend.rangeText({
+                    range,
+                    maxLength
+                });
+            }
+        };
+        return textRange;
+    }
+    function textPatternOf(handle) {
+        const isSupported = backend.visibleRanges(handle) !== null;
+        if (!isSupported) {
+            return null;
+        }
+        const pattern = {
+            visibleRanges() {
+                assertAlive();
+                return (backend.visibleRanges(handle) ?? []).map(rangeOf);
+            },
+            documentRange() {
+                assertAlive();
+                const range = backend.documentRange(handle);
+                return range === null ? null : rangeOf(range);
+            }
+        };
+        return pattern;
+    }
+    function valuePatternOf(handle) {
+        const isSupported = backend.value(handle) !== null;
+        if (!isSupported) {
+            return null;
+        }
+        const pattern = {
+            get value() {
+                assertAlive();
+                return backend.value(handle) ?? "";
+            }
+        };
+        return pattern;
+    }
+    function elementOf(handle) {
+        const element = {
+            properties() {
+                assertAlive();
+                return backend.properties(handle);
+            },
+            pattern(name) {
+                assertAlive();
+                const isText = name === UiaPatternName.text;
+                const pattern = isText ? textPatternOf(handle) : valuePatternOf(handle);
+                // oxlint-disable-next-line typescript/consistent-type-assertions -- the name picks the pattern
+                return pattern;
+            }
+        };
+        handles.set(element, handle);
+        return element;
+    }
+    function handleOf(element) {
+        const handle = handles.get(element);
+        const isForeign = handle === undefined;
+        if (isForeign) {
+            throw new TypeError("the root is not an element of this client");
+        }
+        return handle;
+    }
+    function wrap(handle) {
+        return handle === null ? null : elementOf(handle);
+    }
+    function walk({ root, maxElements = DEFAULT_MAX_ELEMENTS, maxMilliseconds = DEFAULT_MAX_MILLISECONDS, shouldVisit }) {
+        assertAlive();
+        const rootHandle = handleOf(root);
+        let end = UiaWalkEnd.complete;
+        function* nodes() {
+            const startedAt = performance.now();
+            const queue = [{
+                    handle: rootHandle,
+                    depth: 0
+                }];
+            let visited = 0;
+            for (const { handle, depth } of queue) {
+                const children = nullIfUnavailable(() => backend.children(handle)) ?? [];
+                for (const child of children) {
+                    assertAlive();
+                    const stop = stopOf({
+                        startedAt,
+                        maxMilliseconds,
+                        isFull: visited >= maxElements
+                    });
+                    const isStopped = stop !== null;
+                    if (isStopped) {
+                        end = stop;
+                        return;
+                    }
+                    const isSkipped = shouldVisit !== undefined && !shouldVisit(child.properties);
+                    if (isSkipped) {
+                        continue;
+                    }
+                    visited += 1;
+                    let isPruned = false;
+                    const node = {
+                        ...elementOf(child.handle),
+                        depth: depth + 1,
+                        cached: child.properties,
+                        skipSubtree() {
+                            isPruned = true;
+                        }
+                    };
+                    handles.set(node, child.handle);
+                    yield node;
+                    if (!isPruned) {
+                        queue.push({
+                            handle: child.handle,
+                            depth: depth + 1
+                        });
+                    }
+                }
+            }
+        }
+        const walkResult = {
+            get end() {
+                return end;
+            },
+            [Symbol.iterator]: nodes
+        };
+        return walkResult;
+    }
+    const client = {
+        elementFromHandle(hwnd) {
+            assertAlive();
+            return wrap(nullIfUnavailable(() => backend.elementFromHandle(hwnd)));
+        },
+        focusedElement() {
+            assertAlive();
+            return wrap(nullIfUnavailable(() => backend.focusedElement()));
+        },
+        walk
+    };
+    try {
+        return await use(client);
+    }
+    finally {
+        isAlive = false;
+        backend.dispose();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/automation/client.js.map

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

package/dist/automation/ids.d.ts

@@ -0,0 +1,90 @@
+/**
+ * The control types of UI Automation (`UIA_*ControlTypeId` in
+ * `UIAutomationClient.h`), by name.
+ */
+export declare const UiaControlType: {
+    readonly button: 50000;
+    readonly calendar: 50001;
+    readonly checkBox: 50002;
+    readonly comboBox: 50003;
+    readonly edit: 50004;
+    readonly hyperlink: 50005;
+    readonly image: 50006;
+    readonly listItem: 50007;
+    readonly list: 50008;
+    readonly menu: 50009;
+    readonly menuBar: 50010;
+    readonly menuItem: 50011;
+    readonly progressBar: 50012;
+    readonly radioButton: 50013;
+    readonly scrollBar: 50014;
+    readonly slider: 50015;
+    readonly spinner: 50016;
+    readonly statusBar: 50017;
+    readonly tab: 50018;
+    readonly tabItem: 50019;
+    readonly text: 50020;
+    readonly toolBar: 50021;
+    readonly toolTip: 50022;
+    readonly tree: 50023;
+    readonly treeItem: 50024;
+    readonly custom: 50025;
+    readonly group: 50026;
+    readonly thumb: 50027;
+    readonly dataGrid: 50028;
+    readonly dataItem: 50029;
+    readonly document: 50030;
+    readonly splitButton: 50031;
+    readonly window: 50032;
+    readonly pane: 50033;
+    readonly header: 50034;
+    readonly headerItem: 50035;
+    readonly table: 50036;
+    readonly titleBar: 50037;
+    readonly separator: 50038;
+    readonly semanticZoom: 50039;
+    readonly appBar: 50040;
+};
+/** One control type of UI Automation. */
+export type UiaControlType = typeof UiaControlType[keyof typeof UiaControlType];
+/**
+ * The properties of an element that the client reads (`UIA_*PropertyId` in
+ * `UIAutomationClient.h`).
+ */
+export declare const UiaPropertyId: {
+    readonly boundingRectangle: 30001;
+    readonly processId: 30002;
+    readonly controlType: 30003;
+    readonly name: 30005;
+    readonly isEnabled: 30010;
+    readonly automationId: 30011;
+    readonly className: 30012;
+    readonly isControlElement: 30016;
+    readonly nativeWindowHandle: 30020;
+    readonly isOffscreen: 30022;
+    readonly isTextPatternAvailable: 30040;
+    readonly isValuePatternAvailable: 30043;
+    readonly headingLevel: 30173;
+};
+/** One property of UI Automation. */
+export type UiaPropertyId = typeof UiaPropertyId[keyof typeof UiaPropertyId];
+/** The patterns of an element that the client reads (`UIA_*PatternId`). */
+export declare const UiaPatternId: {
+    readonly value: 10002;
+    readonly text: 10014;
+};
+/** The names a caller gives a pattern, `element.pattern("text")`. */
+export declare const UiaPatternName: {
+    readonly text: "text";
+    readonly value: "value";
+};
+/** One pattern name. */
+export type UiaPatternName = typeof UiaPatternName[keyof typeof UiaPatternName];
+/**
+ * `HeadingLevel_None` (80050): the value of the heading level property of an
+ * element that is not a heading.
+ */
+export declare const HEADING_LEVEL_NONE = 80050;
+/** `HeadingLevel1` (80051): the property value of a first level heading; level 9 is 80059. */
+export declare const HEADING_LEVEL_FIRST = 80051;
+//# sourceMappingURL=ids.d.ts.map

package/dist/automation/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/automation/ids.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CjB,CAAC;AAEX,yCAAyC;AACzC,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEhF;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;CAchB,CAAC;AAEX,qCAAqC;AACrC,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE7E,2EAA2E;AAC3E,eAAO,MAAM,YAAY;;;CAGf,CAAC;AAEX,qEAAqE;AACrE,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AAEX,wBAAwB;AACxB,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEhF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,8FAA8F;AAC9F,eAAO,MAAM,mBAAmB,QAAQ,CAAC"}

package/dist/automation/ids.js

@@ -0,0 +1,84 @@
+/**
+ * The control types of UI Automation (`UIA_*ControlTypeId` in
+ * `UIAutomationClient.h`), by name.
+ */
+export const UiaControlType = {
+    button: 50000,
+    calendar: 50001,
+    checkBox: 50002,
+    comboBox: 50003,
+    edit: 50004,
+    hyperlink: 50005,
+    image: 50006,
+    listItem: 50007,
+    list: 50008,
+    menu: 50009,
+    menuBar: 50010,
+    menuItem: 50011,
+    progressBar: 50012,
+    radioButton: 50013,
+    scrollBar: 50014,
+    slider: 50015,
+    spinner: 50016,
+    statusBar: 50017,
+    tab: 50018,
+    tabItem: 50019,
+    text: 50020,
+    toolBar: 50021,
+    toolTip: 50022,
+    tree: 50023,
+    treeItem: 50024,
+    custom: 50025,
+    group: 50026,
+    thumb: 50027,
+    dataGrid: 50028,
+    dataItem: 50029,
+    document: 50030,
+    splitButton: 50031,
+    window: 50032,
+    pane: 50033,
+    header: 50034,
+    headerItem: 50035,
+    table: 50036,
+    titleBar: 50037,
+    separator: 50038,
+    semanticZoom: 50039,
+    appBar: 50040
+};
+/**
+ * The properties of an element that the client reads (`UIA_*PropertyId` in
+ * `UIAutomationClient.h`).
+ */
+export const UiaPropertyId = {
+    boundingRectangle: 30001,
+    processId: 30002,
+    controlType: 30003,
+    name: 30005,
+    isEnabled: 30010,
+    automationId: 30011,
+    className: 30012,
+    isControlElement: 30016,
+    nativeWindowHandle: 30020,
+    isOffscreen: 30022,
+    isTextPatternAvailable: 30040,
+    isValuePatternAvailable: 30043,
+    headingLevel: 30173
+};
+/** The patterns of an element that the client reads (`UIA_*PatternId`). */
+export const UiaPatternId = {
+    value: 10002,
+    text: 10014
+};
+/** The names a caller gives a pattern, `element.pattern("text")`. */
+export const UiaPatternName = {
+    text: "text",
+    value: "value"
+};
+/**
+ * `HeadingLevel_None` (80050): the value of the heading level property of an
+ * element that is not a heading.
+ */
+export const HEADING_LEVEL_NONE = 80050;
+/** `HeadingLevel1` (80051): the property value of a first level heading; level 9 is 80059. */
+export const HEADING_LEVEL_FIRST = 80051;
+//# sourceMappingURL=ids.js.map

package/dist/automation/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/automation/ids.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,KAAK;IACb,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,KAAK;IACf,IAAI,EAAE,KAAK;IACX,SAAS,EAAE,KAAK;IAChB,KAAK,EAAE,KAAK;IACZ,QAAQ,EAAE,KAAK;IACf,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,KAAK;IAClB,SAAS,EAAE,KAAK;IAChB,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,KAAK;IAChB,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,KAAK;IACX,QAAQ,EAAE,KAAK;IACf,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,KAAK;IACZ,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,KAAK;IAClB,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,KAAK;IACb,UAAU,EAAE,KAAK;IACjB,KAAK,EAAE,KAAK;IACZ,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,KAAK;IAChB,YAAY,EAAE,KAAK;IACnB,MAAM,EAAE,KAAK;CACL,CAAC;AAKX;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,iBAAiB,EAAE,KAAK;IACxB,SAAS,EAAE,KAAK;IAChB,WAAW,EAAE,KAAK;IAClB,IAAI,EAAE,KAAK;IACX,SAAS,EAAE,KAAK;IAChB,YAAY,EAAE,KAAK;IACnB,SAAS,EAAE,KAAK;IAChB,gBAAgB,EAAE,KAAK;IACvB,kBAAkB,EAAE,KAAK;IACzB,WAAW,EAAE,KAAK;IAClB,sBAAsB,EAAE,KAAK;IAC7B,uBAAuB,EAAE,KAAK;IAC9B,YAAY,EAAE,KAAK;CACX,CAAC;AAKX,2EAA2E;AAC3E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,KAAK;CACH,CAAC;AAEX,qEAAqE;AACrE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;CACN,CAAC;AAKX;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAExC,8FAA8F;AAC9F,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC"}

package/dist/automation/index.d.ts

@@ -0,0 +1,13 @@
+export { withUiaClient } from "./with-client.js";
+export { HEADING_LEVEL_FIRST, HEADING_LEVEL_NONE, UiaControlType, UiaPatternName, UiaPropertyId } from "./ids.js";
+export { UiaElementUnavailableError } from "./backend.js";
+export type { UiaChild, UiaProperties } from "./backend.js";
+export { UiaScopeEndedError, UiaTimeout, UiaWalkEnd } from "./client.js";
+export type { UiaClient, UiaElement, UiaNode, UiaPatterns, UiaTextPattern, UiaTextRange, UiaValuePattern, UiaWalk, UiaWalkOptions } from "./client.js";
+export { readWindowText, TextBlockKind, UIA_CHROME_CONTROL_TYPES } from "./text.js";
+export type { ReadWindowTextOptions, TextBlock, WindowText } from "./text.js";
+export { createUiaWorker } from "./worker.js";
+export type { UiaReadRequest, UiaWorker, UiaWorkerHandle } from "./worker.js";
+export { UiaTarget } from "./worker-job.js";
+export type { UiaTargetSpec } from "./worker-job.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/automation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAClH,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EACV,SAAS,EACT,UAAU,EACV,OAAO,EACP,WAAW,EACX,cAAc,EACd,YAAY,EACZ,eAAe,EACf,OAAO,EACP,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACpF,YAAY,EAAE,qBAAqB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/automation/index.js

@@ -0,0 +1,8 @@
+export { withUiaClient } from "./with-client.js";
+export { HEADING_LEVEL_FIRST, HEADING_LEVEL_NONE, UiaControlType, UiaPatternName, UiaPropertyId } from "./ids.js";
+export { UiaElementUnavailableError } from "./backend.js";
+export { UiaScopeEndedError, UiaTimeout, UiaWalkEnd } from "./client.js";
+export { readWindowText, TextBlockKind, UIA_CHROME_CONTROL_TYPES } from "./text.js";
+export { createUiaWorker } from "./worker.js";
+export { UiaTarget } from "./worker-job.js";
+//# sourceMappingURL=index.js.map

package/dist/automation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/automation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAClH,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAazE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAEpF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/automation/native.d.ts

@@ -0,0 +1,11 @@
+import type { UiaBackend } from "./backend.js";
+/**
+ * The real UI Automation calls, over `CUIAutomation`. The COM objects are made
+ * on the first call and every pointer is released by `dispose`; the thread
+ * that calls must already be in a COM apartment (a worker that called
+ * `DynCom.initialize`).
+ *
+ * @returns A backend for `runUiaClient`.
+ */
+export declare function createUiaNativeBackend(): UiaBackend;
+//# sourceMappingURL=native.d.ts.map