winui-svelte 0.0.6 → 0.0.8

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

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/automation/text.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOrE,uFAAuF;AACvF,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,CAevD,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX,8BAA8B;AAC9B,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE7E,uCAAuC;AACvC,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAE7B,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAEtC,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,6EAA6E;IAC7E,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;CAC1B;AAED,uCAAuC;AACvC,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,qDAAqD;IACrD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAElC,6DAA6D;IAC7D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAkDD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,IAAI,EACJ,WAAW,EACX,eAAe,EACf,aAAsC,EACvC,EAAE,qBAAqB,GAAG;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B,cAsCA"}

package/dist/automation/text.js

@@ -0,0 +1,110 @@
+import { UiaControlType, UiaPatternName } from "./ids.js";
+import { createHash } from "node:crypto";
+const DEFAULT_MAX_CHARACTERS = 12_000;
+const VERSION_LENGTH = 16;
+/** The control types that are window chrome, not content: their subtree is skipped. */
+export const UIA_CHROME_CONTROL_TYPES = new Set([
+    UiaControlType.button,
+    UiaControlType.splitButton,
+    UiaControlType.menu,
+    UiaControlType.menuBar,
+    UiaControlType.menuItem,
+    UiaControlType.toolBar,
+    UiaControlType.tab,
+    UiaControlType.tabItem,
+    UiaControlType.scrollBar,
+    UiaControlType.statusBar,
+    UiaControlType.titleBar,
+    UiaControlType.image,
+    UiaControlType.separator,
+    UiaControlType.thumb
+]);
+/** The kinds of block a window's text is made of. */
+export const TextBlockKind = {
+    heading: "heading",
+    text: "text"
+};
+function textOf(value) {
+    return value.replaceAll("", "").trim();
+}
+function blocksOf({ node, remaining }) {
+    const { cached } = node;
+    const isHeading = cached.headingLevel > 0;
+    if (cached.hasTextPattern) {
+        node.skipSubtree();
+        const ranges = node.pattern(UiaPatternName.text)?.visibleRanges() ?? [];
+        return ranges
+            .map(range => textOf(range.getText(remaining)))
+            .filter(text => text !== "")
+            .map(text => ({
+            kind: TextBlockKind.text,
+            level: 0,
+            text
+        }));
+    }
+    const isEdit = cached.controlType === UiaControlType.edit && cached.hasValuePattern;
+    if (isEdit) {
+        const text = textOf(node.pattern(UiaPatternName.value)?.value ?? "");
+        return text === "" ? [] : [{
+                kind: TextBlockKind.text,
+                level: 0,
+                text
+            }];
+    }
+    const isTextType = cached.controlType === UiaControlType.text || cached.controlType === UiaControlType.listItem;
+    const isNamedText = isHeading || isTextType;
+    const text = textOf(cached.name);
+    const isBlock = isNamedText && text !== "";
+    return isBlock ? [{
+            kind: isHeading ? TextBlockKind.heading : TextBlockKind.text,
+            level: cached.headingLevel,
+            text
+        }] : [];
+}
+/**
+ * Reads the text of a window: headings and the exact copy of the text beneath
+ * the chrome, through the control view. Elements that are off screen and
+ * window chrome (buttons, menus, tool bars, tabs, scroll bars, status bars,
+ * images) are skipped; an element with a text pattern gives its visible
+ * ranges and its subtree is not walked again.
+ *
+ * @param options - `client`: the client of a `withUiaClient` call; `root`: the window's element; the limits.
+ * @returns The title, the blocks and a version that changes with the text.
+ */
+export function readWindowText({ client, root, maxElements, maxMilliseconds, maxCharacters = DEFAULT_MAX_CHARACTERS }) {
+    const blocks = [];
+    let used = 0;
+    const walk = client.walk({
+        root,
+        ...maxElements === undefined ? {} : { maxElements },
+        ...maxMilliseconds === undefined ? {} : { maxMilliseconds },
+        shouldVisit: ({ isOffscreen, controlType }) => !isOffscreen && !UIA_CHROME_CONTROL_TYPES.has(controlType)
+    });
+    for (const node of walk) {
+        const remaining = maxCharacters - used;
+        const isFull = remaining <= 0;
+        if (isFull) {
+            break;
+        }
+        for (const block of blocksOf({
+            node,
+            remaining
+        })) {
+            blocks.push(block);
+            used += block.text.length;
+        }
+    }
+    const title = root.properties().name;
+    const hash = createHash("sha256").update(title);
+    for (const block of blocks) {
+        hash.update(`\n${block.level}:${block.text}`);
+    }
+    const windowText = {
+        title,
+        blocks,
+        version: hash.digest("hex").slice(0, VERSION_LENGTH),
+        end: walk.end
+    };
+    return windowText;
+}
+//# sourceMappingURL=text.js.map

package/dist/automation/text.js.map

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

package/dist/automation/with-client.d.ts

@@ -0,0 +1,13 @@
+import type { UiaClient } from "./client.js";
+/**
+ * Creates a UI Automation client, runs `use` with it, then releases every
+ * element, range and COM pointer it made; the elements refuse to work after
+ * that. Call it from a thread in a COM apartment, ideally a worker in the
+ * multithreaded one (an apartment that pumps messages can hang on a target
+ * that does not answer).
+ *
+ * @param use - The work; it may be async.
+ * @returns What `use` returned.
+ */
+export declare function withUiaClient<T>(use: (client: UiaClient) => T | Promise<T>): Promise<T>;
+//# sourceMappingURL=with-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"with-client.d.ts","sourceRoot":"","sources":["../../src/automation/with-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,cAK1E"}

package/dist/automation/with-client.js

@@ -0,0 +1,19 @@
+import { runUiaClient } from "./client.js";
+import { createUiaNativeBackend } from "./native.js";
+/**
+ * Creates a UI Automation client, runs `use` with it, then releases every
+ * element, range and COM pointer it made; the elements refuse to work after
+ * that. Call it from a thread in a COM apartment, ideally a worker in the
+ * multithreaded one (an apartment that pumps messages can hang on a target
+ * that does not answer).
+ *
+ * @param use - The work; it may be async.
+ * @returns What `use` returned.
+ */
+export function withUiaClient(use) {
+    return runUiaClient({
+        use,
+        backend: createUiaNativeBackend()
+    });
+}
+//# sourceMappingURL=with-client.js.map

package/dist/automation/with-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-client.js","sourceRoot":"","sources":["../../src/automation/with-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAI,GAA0C;IACzE,OAAO,YAAY,CAAC;QAClB,GAAG;QACH,OAAO,EAAE,sBAAsB,EAAE;KAClC,CAAC,CAAC;AACL,CAAC"}

package/dist/automation/worker-job.d.ts

@@ -0,0 +1,32 @@
+import type { ReadWindowTextOptions, WindowText } from "./text.js";
+/** Which window to read. */
+export declare const UiaTarget: {
+    readonly foreground: "foreground";
+    readonly focused: "focused";
+};
+/** The foreground window, the window of the focused element, or the window with this handle. */
+export type UiaTargetSpec = typeof UiaTarget[keyof typeof UiaTarget] | {
+    readonly hwnd: bigint;
+};
+/** What the host asks of the worker. */
+export interface UiaWorkerRequest extends ReadWindowTextOptions {
+    readonly id: number;
+    readonly target: UiaTargetSpec;
+    /** A window of this process is not read (the app itself). */
+    readonly excludeProcessId?: number;
+}
+/** What the worker answers. */
+export type UiaWorkerResponse = {
+    readonly id: number;
+    readonly text: WindowText | null;
+} | {
+    readonly id: number;
+    readonly error: string;
+};
+/**
+ * The body of the UI Automation worker: joins the multithreaded apartment and
+ * answers each request on the parent port. The host starts it; an app does not
+ * call it.
+ */
+export declare function runUiaWorker(): void;
+//# sourceMappingURL=worker-job.d.ts.map

package/dist/automation/worker-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-job.d.ts","sourceRoot":"","sources":["../../src/automation/worker-job.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAQnE,4BAA4B;AAC5B,eAAO,MAAM,SAAS;;;CAGZ,CAAC;AAEX,gGAAgG;AAChG,MAAM,MAAM,aAAa,GAAG,OAAO,SAAS,CAAC,MAAM,OAAO,SAAS,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG,wCAAwC;AACxC,MAAM,WAAW,gBAAiB,SAAQ,qBAAqB;IAC7D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAE/B,6DAA6D;IAC7D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,+BAA+B;AAC/B,MAAM,MAAM,iBAAiB,GACzB;IACA,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CAClC,GACC;IACA,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAuCJ;;;;GAIG;AACH,wBAAgB,YAAY,SAgB3B"}

package/dist/automation/worker-job.js

@@ -0,0 +1,69 @@
+import { readWindowText } from "./text.js";
+import { withUiaClient } from "./with-client.js";
+import { DynCom } from "@microsoft/dynwinrt/com/unsafe";
+import { bindDll } from "../win32-calls.js";
+import { parentPort } from "node:worker_threads";
+const MULTITHREADED_APARTMENT = 0;
+/** Which window to read. */
+export const UiaTarget = {
+    foreground: "foreground",
+    focused: "focused"
+};
+/**
+ * Reads one request inside a UI Automation client, on the calling thread.
+ *
+ * @param request - The window and the limits.
+ * @returns The text, or null when there is no window to read or it is the excluded process's.
+ */
+function readTarget({ target, excludeProcessId, ...limits }) {
+    const user32 = bindDll({
+        dll: "user32.dll",
+        functions: {
+            foregroundWindow: ["GetForegroundWindow", [], "pointer"]
+        }
+    });
+    return withUiaClient(client => {
+        const isFocused = target === UiaTarget.focused;
+        const isWindow = typeof target === "object";
+        const root = isFocused
+            ? client.focusedElement()
+            : client.elementFromHandle(isWindow ? target.hwnd : user32.foregroundWindow());
+        const isRootNull = root === null;
+        if (isRootNull) {
+            return null;
+        }
+        const isExcluded = excludeProcessId !== undefined && root.properties().processId === excludeProcessId;
+        if (isExcluded) {
+            return null;
+        }
+        return readWindowText({
+            client,
+            root,
+            ...limits
+        });
+    });
+}
+/**
+ * The body of the UI Automation worker: joins the multithreaded apartment and
+ * answers each request on the parent port. The host starts it; an app does not
+ * call it.
+ */
+export function runUiaWorker() {
+    DynCom.initialize(MULTITHREADED_APARTMENT);
+    parentPort?.on("message", async ({ id, ...request }) => {
+        try {
+            const text = await readTarget(request);
+            parentPort?.postMessage({
+                id,
+                text
+            });
+        }
+        catch (error) {
+            parentPort?.postMessage({
+                id,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    });
+}
+//# sourceMappingURL=worker-job.js.map

package/dist/automation/worker-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-job.js","sourceRoot":"","sources":["../../src/automation/worker-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAElC,4BAA4B;AAC5B,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;CACV,CAAC;AAyBX;;;;;GAKG;AACH,SAAS,UAAU,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,EAAgC;IACvF,MAAM,MAAM,GAAG,OAAO,CAAC;QACrB,GAAG,EAAE,YAAY;QACjB,SAAS,EAAE;YACT,gBAAgB,EAAE,CAAC,qBAAqB,EAAE,EAAE,EAAE,SAAS,CAAC;SACzD;KACF,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,MAAM,CAAC,EAAE;QAC5B,MAAM,SAAS,GAAG,MAAM,KAAK,SAAS,CAAC,OAAO,CAAC;QAC/C,MAAM,QAAQ,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC;QAC5C,MAAM,IAAI,GAAG,SAAS;YACpB,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE;YACzB,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACjF,MAAM,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;QACjC,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAG,gBAAgB,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,SAAS,KAAK,gBAAgB,CAAC;QACtG,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,cAAc,CAAC;YACpB,MAAM;YACN,IAAI;YACJ,GAAG,MAAM;SACV,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;IAC3C,UAAU,EAAE,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,EAAoB,EAAE,EAAE;QACvE,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;YACvC,UAAU,EAAE,WAAW,CAAC;gBACtB,EAAE;gBACF,IAAI;aACuB,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,UAAU,EAAE,WAAW,CAAC;gBACtB,EAAE;gBACF,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAClC,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/automation/worker.d.ts

@@ -0,0 +1,44 @@
+import type { WindowText } from "./text.js";
+import type { UiaTargetSpec, UiaWorkerRequest, UiaWorkerResponse } from "./worker-job.js";
+/** The part of a worker the host uses; a test passes a fake. */
+export interface UiaWorkerHandle {
+    postMessage(request: UiaWorkerRequest): void;
+    on(event: "message", listener: (response: UiaWorkerResponse) => void): unknown;
+    on(event: "error" | "exit", listener: (error: unknown) => void): unknown;
+    terminate(): unknown;
+}
+/** The request of `UiaWorker.readText`. */
+export interface UiaReadRequest {
+    readonly target: UiaTargetSpec;
+    /** A window of this process is not read. */
+    readonly excludeProcessId?: number;
+    readonly maxElements?: number;
+    /** The soft deadline of the walk; 400 by default. */
+    readonly maxMilliseconds?: number;
+    readonly maxCharacters?: number;
+    /** The hard deadline: the call rejects with `UiaTimeout` and the worker is replaced; 1500 by default. */
+    readonly hardMilliseconds?: number;
+}
+/** A worker thread that owns the UI Automation client. */
+export interface UiaWorker {
+    /**
+     * Reads the text of a window in the worker. A blocked COM call cannot be
+     * cancelled, so a call that outlives `hardMilliseconds` rejects with
+     * `UiaTimeout`, the worker is ended, and the next call starts a new one.
+     */
+    readText(request: UiaReadRequest): Promise<WindowText | null>;
+    /** Ends the worker. */
+    close(): void;
+}
+/**
+ * Starts a UI Automation worker thread on first use. Its COM apartment is the
+ * multithreaded one, which Microsoft advises for a client, and a hung target
+ * app costs one call its hard deadline, not the caller's thread.
+ *
+ * @param options - `spawn`: how to make the worker (a test passes a fake).
+ * @returns The worker.
+ */
+export declare function createUiaWorker({ spawn }?: {
+    readonly spawn?: () => UiaWorkerHandle;
+}): UiaWorker;
+//# sourceMappingURL=worker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/automation/worker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAK1F,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC7C,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC;IAC/E,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC;IACzE,SAAS,IAAI,OAAO,CAAC;CACtB;AAED,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAE/B,4CAA4C;IAC5C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,qDAAqD;IACrD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC,yGAAyG;IACzG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAE9D,uBAAuB;IACvB,KAAK,IAAI,IAAI,CAAC;CACf;AAUD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAAE,KAAmB,EAAE,GAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,eAAe,CAAA;CAAO,aAuDvG"}

package/dist/automation/worker.js

@@ -0,0 +1,70 @@
+import { UiaTimeout } from "./client.js";
+import { Worker } from "node:worker_threads";
+const DEFAULT_HARD_MILLISECONDS = 1500;
+function spawnNative() {
+    const extension = import.meta.url.endsWith(".ts") ? "ts" : "js";
+    const moduleUrl = new URL(`./worker-job.${extension}`, import.meta.url).href;
+    const source = `import(${JSON.stringify(moduleUrl)}).then(module => module.runUiaWorker())`;
+    // oxlint-disable-next-line typescript/consistent-type-assertions -- Worker's overloads are wider than the part used
+    return new Worker(source, { eval: true });
+}
+/**
+ * Starts a UI Automation worker thread on first use. Its COM apartment is the
+ * multithreaded one, which Microsoft advises for a client, and a hung target
+ * app costs one call its hard deadline, not the caller's thread.
+ *
+ * @param options - `spawn`: how to make the worker (a test passes a fake).
+ * @returns The worker.
+ */
+export function createUiaWorker({ spawn = spawnNative } = {}) {
+    let worker = null;
+    let nextId = 0;
+    function discard() {
+        void worker?.terminate();
+        worker = null;
+    }
+    const uiaWorker = {
+        readText({ hardMilliseconds = DEFAULT_HARD_MILLISECONDS, ...request }) {
+            const current = worker ?? spawn();
+            worker = current;
+            nextId += 1;
+            const id = nextId;
+            return new Promise((resolve, reject) => {
+                const timer = setTimeout(() => {
+                    discard();
+                    reject(new UiaTimeout(`the target did not answer in ${hardMilliseconds} ms`));
+                }, hardMilliseconds);
+                current.on("message", response => {
+                    const isOurs = response.id === id;
+                    if (!isOurs) {
+                        return;
+                    }
+                    clearTimeout(timer);
+                    const isErrorInResponse = "error" in response;
+                    if (isErrorInResponse) {
+                        reject(new Error(response.error));
+                        return;
+                    }
+                    resolve(response.text);
+                });
+                current.on("error", error => {
+                    clearTimeout(timer);
+                    discard();
+                    reject(error instanceof Error ? error : new Error(String(error)));
+                });
+                current.on("exit", () => {
+                    clearTimeout(timer);
+                    worker = null;
+                    reject(new Error("the UI Automation worker ended"));
+                });
+                current.postMessage({
+                    ...request,
+                    id
+                });
+            });
+        },
+        close: discard
+    };
+    return uiaWorker;
+}
+//# sourceMappingURL=worker.js.map

package/dist/automation/worker.js.map

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

package/dist/bindings/.dynwinrt-js-types

@@ -40330,6 +40330,34 @@
       "implementation_helpers": [],
       "reserved_symbols": []
     },
+    {
+      "identity": {
+        "namespace": "Windows.ApplicationModel.Activation",
+        "name": "ActivationKind",
+        "kind": "enum",
+        "variant": ""
+      },
+      "projected_name": "ActivationKind",
+      "implementation_name": "ActivationKind",
+      "abi_identity": "type",
+      "compatibility_aliases": [],
+      "implementation_helpers": [],
+      "reserved_symbols": []
+    },
+    {
+      "identity": {
+        "namespace": "Windows.ApplicationModel.Activation",
+        "name": "ApplicationExecutionState",
+        "kind": "enum",
+        "variant": ""
+      },
+      "projected_name": "ApplicationExecutionState",
+      "implementation_name": "ApplicationExecutionState",
+      "abi_identity": "type",
+      "compatibility_aliases": [],
+      "implementation_helpers": [],
+      "reserved_symbols": []
+    },
     {
       "identity": {
         "namespace": "Windows.ApplicationModel.Activation",
@@ -40344,6 +40372,148 @@
       "implementation_helpers": [],
       "reserved_symbols": []
     },
+    {
+      "identity": {
+        "namespace": "Windows.ApplicationModel.Activation",
+        "name": "IActivatedEventArgs",
+        "kind": "interface",
+        "variant": ""
+      },
+      "projected_name": "IActivatedEventArgs",
+      "implementation_name": "IActivatedEventArgs",
+      "abi_identity": "iid:cf651713-cd08-4fd8-b697-a281b6544e2e",
+      "compatibility_aliases": [],
+      "implementation_helpers": [
+        {
+          "key": "handlers",
+          "suffix": "Handlers",
+          "name": "IActivatedEventArgsHandlers",
+          "implementation_name": "IActivatedEventArgsHandlers"
+        }
+      ],
+      "reserved_symbols": []
+    },
+    {
+      "identity": {
+        "namespace": "Windows.ApplicationModel.Activation",
+        "name": "IActivatedEventArgsWithUser",
+        "kind": "interface",
+        "variant": ""
+      },
+      "projected_name": "IActivatedEventArgsWithUser",
+      "implementation_name": "IActivatedEventArgsWithUser",
+      "abi_identity": "iid:1cf09b9e-9962-4936-80ff-afc8e8ae5c8c",
+      "compatibility_aliases": [],
+      "implementation_helpers": [
+        {
+          "key": "handlers",
+          "suffix": "Handlers",
+          "name": "IActivatedEventArgsWithUserHandlers",
+          "implementation_name": "IActivatedEventArgsWithUserHandlers"
+        }
+      ],
+      "reserved_symbols": []
+    },
+    {
+      "identity": {
+        "namespace": "Windows.ApplicationModel.Activation",
+        "name": "IApplicationViewActivatedEventArgs",
+        "kind": "interface",
+        "variant": ""
+      },
+      "projected_name": "IApplicationViewActivatedEventArgs",
+      "implementation_name": "IApplicationViewActivatedEventArgs",
+      "abi_identity": "iid:930cef4b-b829-40fc-88f4-8513e8a64738",
+      "compatibility_aliases": [],
+      "implementation_helpers": [
+        {
+          "key": "handlers",
+          "suffix": "Handlers",
+          "name": "IApplicationViewActivatedEventArgsHandlers",
+          "implementation_name": "IApplicationViewActivatedEventArgsHandlers"
+        }
+      ],
+      "reserved_symbols": []
+    },
+    {
+      "identity": {
+        "namespace": "Windows.ApplicationModel.Activation",
+        "name": "IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndData",
+        "kind": "interface",
+        "variant": ""
+      },
+      "projected_name": "IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndData",
+      "implementation_name": "IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndData",
+      "abi_identity": "iid:d84a0c12-5c8f-438c-83cb-c28fcc0b2fdb",
+      "compatibility_aliases": [],
+      "implementation_helpers": [
+        {
+          "key": "handlers",
+          "suffix": "Handlers",
+          "name": "IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndDataHandlers",
+          "implementation_name": "IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndDataHandlers"
+        }
+      ],
+      "reserved_symbols": []
+    },
+    {
+      "identity": {
+        "namespace": "Windows.ApplicationModel.Activation",
+        "name": "IViewSwitcherProvider",
+        "kind": "interface",
+        "variant": ""
+      },
+      "projected_name": "IViewSwitcherProvider",
+      "implementation_name": "IViewSwitcherProvider",
+      "abi_identity": "iid:33f288a6-5c2c-4d27-bac7-7536088f1219",
+      "compatibility_aliases": [],
+      "implementation_helpers": [
+        {
+          "key": "handlers",
+          "suffix": "Handlers",
+          "name": "IViewSwitcherProviderHandlers",
+          "implementation_name": "IViewSwitcherProviderHandlers"
+        }
+      ],
+      "reserved_symbols": []
+    },
+    {
+      "identity": {
+        "namespace": "Windows.ApplicationModel.Activation",
+        "name": "ProtocolActivatedEventArgs",
+        "kind": "class",
+        "variant": ""
+      },
+      "projected_name": "ProtocolActivatedEventArgs",
+      "implementation_name": "ProtocolActivatedEventArgs",
+      "abi_identity": "type",
+      "compatibility_aliases": [],
+      "implementation_helpers": [],
+      "reserved_symbols": []
+    },
+    {
+      "identity": {
+        "namespace": "Windows.ApplicationModel.Activation",
+        "name": "SplashScreen",
+        "kind": "class",
+        "variant": ""
+      },
+      "projected_name": "SplashScreen",
+      "implementation_name": "SplashScreen",
+      "abi_identity": "type",
+      "compatibility_aliases": [],
+      "implementation_helpers": [],
+      "reserved_symbols": [
+        "EventRegistrationToken",
+        "EventRegistrationToken_Type",
+        "Rect",
+        "Rect_Type",
+        "packEventRegistrationToken",
+        "packRect",
+        "unpackEventRegistrationToken",
+        "unpackRect"
+      ]
+    },
     {
       "identity": {
         "namespace": "Windows.ApplicationModel.Background",
@@ -46387,6 +46557,20 @@
       "implementation_helpers": [],
       "reserved_symbols": []
     },
+    {
+      "identity": {
+        "namespace": "Windows.Foundation",
+        "name": "TypedEventHandler_WindowsApplicationModelActivationSplashScreen_Object_g7a7dbfa699cd28ff",
+        "kind": "delegate",
+        "variant": "piid:9de1c534-6ae1-11e0-84e1-18a905bcc53f:args:[class(Windows.ApplicationModel.Activation.SplashScreen;default=interface(Windows.ApplicationModel.Activation.ISplashScreen,ca4d975c-d4d6-43f0-97c0-0833c6391c24)),object]"
+      },
+      "projected_name": "TypedEventHandler_WindowsApplicationModelActivationSplashScreen_Object_g7a7dbfa699cd28ff",
+      "implementation_name": "TypedEventHandler_WindowsApplicationModelActivationSplashScreen_Object_g7a7dbfa699cd28ff",
+      "abi_identity": "piid:9de1c534-6ae1-11e0-84e1-18a905bcc53f:iid:9de1c534-6ae1-11e0-84e1-18a905bcc53f:args:[class(Windows.ApplicationModel.Activation.SplashScreen;default=interface(Windows.ApplicationModel.Activation.ISplashScreen,ca4d975c-d4d6-43f0-97c0-0833c6391c24)),object]",
+      "compatibility_aliases": [],
+      "implementation_helpers": [],
+      "reserved_symbols": []
+    },
     {
       "identity": {
         "namespace": "Windows.Foundation",
@@ -68332,6 +68516,20 @@
         "unpackEventRegistrationToken"
       ]
     },
+    {
+      "identity": {
+        "namespace": "Windows.UI.ViewManagement",
+        "name": "ActivationViewSwitcher",
+        "kind": "class",
+        "variant": ""
+      },
+      "projected_name": "ActivationViewSwitcher",
+      "implementation_name": "ActivationViewSwitcher",
+      "abi_identity": "type",
+      "compatibility_aliases": [],
+      "implementation_helpers": [],
+      "reserved_symbols": []
+    },
     {
       "identity": {
         "namespace": "Windows.UI.ViewManagement",

package/dist/bindings/.dynwinrt-managed

@@ -1,3 +1,3 @@
 # Generated by winapp dynwinrt-codegen integration. Do not edit.
 # Presence of this file authorises winapp to wipe the directory on the next run.
-generated_at: 2026-11-07T23:15:35.528Z
+generated_at: 2026-11-10T21:57:02.000Z