@zenalexa/unicli 0.217.0 → 0.218.0

package/dist/transport/refs.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Element-ref allocator. Each snapshot gets short monotonic aliases (`@e1`)
+ * backed by stable transport tokens so later actions can dereference either
+ * form without reparsing encoded text.
+ */
+export interface ElementRef {
+    alias: string;
+    stable: string;
+    role: string;
+    name?: string;
+    value?: string;
+    bounds?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    screenIndex?: number;
+    states?: readonly string[];
+    app?: string;
+    pid?: number;
+}
+export interface RefBucket {
+    byAlias: ReadonlyMap<string, ElementRef>;
+    byStable: ReadonlyMap<string, ElementRef>;
+    createdAt: number;
+    transport: string;
+    scope: string;
+}
+export declare class RefAllocator {
+    private counter;
+    private readonly byAlias;
+    private readonly byStable;
+    get size(): number;
+    alloc(input: Omit<ElementRef, "alias">): ElementRef;
+    freeze(transport: string, scope: string): RefBucket;
+}
+export declare class RefStore {
+    private readonly latest;
+    put(bucket: RefBucket): void;
+    resolve(alias: string): ElementRef | undefined;
+    resolveStable(stable: string): ElementRef | undefined;
+    list(): ElementRef[];
+    buckets(): RefBucket[];
+    clear(): void;
+    private key;
+}
+export declare function computeRefsPath(): string;
+export declare function saveRefStore(store: RefStore, file?: string): void;
+export declare function loadRefStore(file?: string): RefStore;
+//# sourceMappingURL=refs.d.ts.map

package/dist/transport/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/transport/refs.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAYD,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAE1D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,UAAU;IAUnD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;CASpD;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IAEvD,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAI5B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAQ9C,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAQrD,IAAI,IAAI,UAAU,EAAE;IAMpB,OAAO,IAAI,SAAS,EAAE;IAUtB,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,GAAG;CAGZ;AAED,wBAAgB,eAAe,IAAI,MAAM,CAKxC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,SAAoB,GAAG,IAAI,CAY5E;AAED,wBAAgB,YAAY,CAAC,IAAI,SAAoB,GAAG,QAAQ,CAyB/D"}

package/dist/transport/refs.js

@@ -0,0 +1,135 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+export class RefAllocator {
+    counter = 0;
+    byAlias = new Map();
+    byStable = new Map();
+    get size() {
+        return this.byAlias.size;
+    }
+    alloc(input) {
+        const existing = this.byStable.get(input.stable);
+        if (existing)
+            return existing;
+        const ref = { ...input, alias: `@e${++this.counter}` };
+        this.byAlias.set(ref.alias, ref);
+        this.byStable.set(ref.stable, ref);
+        return ref;
+    }
+    freeze(transport, scope) {
+        return {
+            byAlias: new Map(this.byAlias),
+            byStable: new Map(this.byStable),
+            createdAt: Date.now(),
+            transport,
+            scope,
+        };
+    }
+}
+export class RefStore {
+    latest = new Map();
+    put(bucket) {
+        this.latest.set(this.key(bucket.transport, bucket.scope), bucket);
+    }
+    resolve(alias) {
+        for (const bucket of this.latest.values()) {
+            const ref = bucket.byAlias.get(alias);
+            if (ref)
+                return ref;
+        }
+        return undefined;
+    }
+    resolveStable(stable) {
+        for (const bucket of this.latest.values()) {
+            const ref = bucket.byStable.get(stable);
+            if (ref)
+                return ref;
+        }
+        return undefined;
+    }
+    list() {
+        return Array.from(this.latest.values()).flatMap((bucket) => Array.from(bucket.byAlias.values()));
+    }
+    buckets() {
+        return Array.from(this.latest.values()).map((bucket) => ({
+            byAlias: new Map(bucket.byAlias),
+            byStable: new Map(bucket.byStable),
+            createdAt: bucket.createdAt,
+            transport: bucket.transport,
+            scope: bucket.scope,
+        }));
+    }
+    clear() {
+        this.latest.clear();
+    }
+    key(transport, scope) {
+        return `${transport}:${scope}`;
+    }
+}
+export function computeRefsPath() {
+    return (process.env.UNICLI_COMPUTE_REFS_PATH ??
+        join(homedir(), ".unicli", "compute", "refs.json"));
+}
+export function saveRefStore(store, file = computeRefsPath()) {
+    const payload = {
+        schema_version: 1,
+        buckets: store.buckets().map((bucket) => ({
+            transport: bucket.transport,
+            scope: bucket.scope,
+            createdAt: bucket.createdAt,
+            refs: Array.from(bucket.byAlias.values()),
+        })),
+    };
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, JSON.stringify(payload, null, 2) + "\n");
+}
+export function loadRefStore(file = computeRefsPath()) {
+    const store = new RefStore();
+    if (!existsSync(file))
+        return store;
+    const text = readFileSync(file, "utf8").trim();
+    if (!text)
+        return store;
+    const raw = JSON.parse(text);
+    if (!isSerializedRefStore(raw))
+        return store;
+    for (const bucket of raw.buckets) {
+        const byAlias = new Map();
+        const byStable = new Map();
+        for (const ref of bucket.refs) {
+            byAlias.set(ref.alias, ref);
+            byStable.set(ref.stable, ref);
+        }
+        store.put({
+            byAlias,
+            byStable,
+            createdAt: bucket.createdAt,
+            transport: bucket.transport,
+            scope: bucket.scope,
+        });
+    }
+    return store;
+}
+function isSerializedRefStore(value) {
+    if (!isRecord(value) || value.schema_version !== 1)
+        return false;
+    if (!Array.isArray(value.buckets))
+        return false;
+    return value.buckets.every((bucket) => isRecord(bucket) &&
+        typeof bucket.transport === "string" &&
+        typeof bucket.scope === "string" &&
+        typeof bucket.createdAt === "number" &&
+        Array.isArray(bucket.refs) &&
+        bucket.refs.every(isElementRef));
+}
+function isElementRef(value) {
+    return (isRecord(value) &&
+        typeof value.alias === "string" &&
+        typeof value.stable === "string" &&
+        typeof value.role === "string");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=refs.js.map

package/dist/transport/refs.js.map

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

package/dist/transport/sidecar-binary.d.ts

@@ -0,0 +1,18 @@
+export type SidecarName = "unicli-uia" | "unicli-atspi";
+export interface ResolvedSidecarBinary {
+    command: string;
+    source: "env" | "package" | "user" | "path";
+    packageName?: string;
+}
+interface ResolveSidecarOptions {
+    platform?: NodeJS.Platform;
+    arch?: string;
+    env?: NodeJS.ProcessEnv;
+    exists?: (path: string) => boolean;
+    requireResolve?: (id: string) => string;
+    homeDir?: string;
+}
+export declare function resolveSidecarBinary(name: SidecarName, opts?: ResolveSidecarOptions): ResolvedSidecarBinary;
+export declare function packageNameForSidecar(name: SidecarName, platform: NodeJS.Platform, arch: string): string | undefined;
+export {};
+//# sourceMappingURL=sidecar-binary.d.ts.map

package/dist/transport/sidecar-binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-binary.d.ts","sourceRoot":"","sources":["../../src/transport/sidecar-binary.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,cAAc,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EACjB,IAAI,GAAE,qBAA0B,GAC/B,qBAAqB,CAsCvB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAUpB"}

package/dist/transport/sidecar-binary.js

@@ -0,0 +1,55 @@
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+export function resolveSidecarBinary(name, opts = {}) {
+    const env = opts.env ?? process.env;
+    const platform = opts.platform ?? process.platform;
+    const hostArch = opts.arch ?? process.arch;
+    const exists = opts.exists ?? existsSync;
+    const requireResolve = opts.requireResolve ?? require.resolve;
+    const packageName = packageNameForSidecar(name, platform, hostArch);
+    const override = env[envVarForSidecar(name)];
+    if (override) {
+        return { command: override, source: "env", packageName };
+    }
+    if (packageName) {
+        try {
+            const pkgJson = requireResolve(`${packageName}/package.json`);
+            const command = join(dirname(pkgJson), executableName(name, platform));
+            return { command, source: "package", packageName };
+        }
+        catch {
+            // Optional platform packages are absent on non-matching hosts.
+        }
+    }
+    const userCommand = join(opts.homeDir ?? homedir(), ".unicli", "sidecars", executableName(name, platform));
+    if (exists(userCommand)) {
+        return { command: userCommand, source: "user", packageName };
+    }
+    return {
+        command: executableName(name, platform),
+        source: "path",
+        packageName,
+    };
+}
+export function packageNameForSidecar(name, platform, arch) {
+    const normalizedArch = arch === "x64" || arch === "arm64" ? arch : undefined;
+    if (!normalizedArch)
+        return undefined;
+    if (name === "unicli-uia" && platform === "win32") {
+        return `@zenalexa/unicli-uia-win32-${normalizedArch}`;
+    }
+    if (name === "unicli-atspi" && platform === "linux") {
+        return `@zenalexa/unicli-atspi-linux-${normalizedArch}`;
+    }
+    return undefined;
+}
+function envVarForSidecar(name) {
+    return name === "unicli-uia" ? "UNICLI_UIA_SIDECAR" : "UNICLI_ATSPI_SIDECAR";
+}
+function executableName(name, platform) {
+    return platform === "win32" ? `${name}.exe` : name;
+}
+//# sourceMappingURL=sidecar-binary.js.map

package/dist/transport/sidecar-binary.js.map

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

package/dist/transport/sidecar.d.ts

@@ -0,0 +1,35 @@
+export interface SidecarClient {
+    call<T = unknown>(kind: string, params: Record<string, unknown>): Promise<T>;
+    close(): Promise<void>;
+}
+export interface SidecarError {
+    transport: string;
+    action: string;
+    reason: string;
+    suggestion: string;
+    minimum_capability: string;
+    exit_code: number;
+}
+export declare class StdioSidecarClient implements SidecarClient {
+    private readonly command;
+    private readonly args;
+    private readonly opts;
+    private child;
+    private lines;
+    private nextId;
+    private active;
+    private readonly queue;
+    private closed;
+    constructor(command: string, args?: readonly string[], opts?: {
+        env?: NodeJS.ProcessEnv;
+    });
+    call<T = unknown>(kind: string, params: Record<string, unknown>): Promise<T>;
+    close(): Promise<void>;
+    private processNext;
+    private ensureChild;
+    private handleLine;
+    private rejectActive;
+    private rejectQueue;
+}
+export declare function isSidecarError(value: unknown): value is SidecarError;
+//# sourceMappingURL=sidecar.d.ts.map

package/dist/transport/sidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/transport/sidecar.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAkBD,qBAAa,kBAAmB,YAAW,aAAa;IASpD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAVvB,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,MAAM,CAAS;gBAGJ,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,IAAI,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAO;IAGnD,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC;IAcP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,WAAW;IAgCnB,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,WAAW;CAKpB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAUpE"}

package/dist/transport/sidecar.js

@@ -0,0 +1,134 @@
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+export class StdioSidecarClient {
+    command;
+    args;
+    opts;
+    child;
+    lines;
+    nextId = 0;
+    active;
+    queue = [];
+    closed = false;
+    constructor(command, args = [], opts = {}) {
+        this.command = command;
+        this.args = args;
+        this.opts = opts;
+    }
+    async call(kind, params) {
+        const id = ++this.nextId;
+        return new Promise((resolve, reject) => {
+            this.queue.push({
+                id,
+                kind,
+                params,
+                resolve: (value) => resolve(value),
+                reject,
+            });
+            this.processNext();
+        });
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.lines?.close();
+        this.rejectActive(new Error("sidecar closed"));
+        this.rejectQueue(new Error("sidecar closed"));
+        this.child?.kill();
+        this.child = undefined;
+    }
+    processNext() {
+        if (this.active || this.queue.length === 0 || this.closed)
+            return;
+        const call = this.queue.shift();
+        if (!call)
+            return;
+        this.active = call;
+        const child = this.ensureChild();
+        const request = JSON.stringify({
+            id: call.id,
+            kind: call.kind,
+            params: call.params,
+        });
+        child.stdin.write(`${request}\n`, (error) => {
+            if (!error)
+                return;
+            this.rejectActive(error);
+            this.processNext();
+        });
+    }
+    ensureChild() {
+        if (this.child)
+            return this.child;
+        if (this.closed) {
+            throw new Error("sidecar client is closed");
+        }
+        const child = spawn(this.command, [...this.args], {
+            env: this.opts.env,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        this.child = child;
+        this.lines = createInterface({ input: child.stdout });
+        this.lines.on("line", (line) => this.handleLine(line));
+        child.on("error", (error) => {
+            this.rejectActive(error);
+            this.child = undefined;
+            this.processNext();
+        });
+        child.on("close", (code) => {
+            this.rejectActive(new Error(`sidecar exited with code ${code ?? "unknown"}`));
+            this.child = undefined;
+            this.processNext();
+        });
+        child.stderr.on("data", () => {
+            // stderr is reserved for sidecar diagnostics; callers receive protocol
+            // failures through stdout envelopes.
+        });
+        return child;
+    }
+    handleLine(line) {
+        let response;
+        try {
+            response = JSON.parse(line);
+        }
+        catch (error) {
+            this.rejectActive(error);
+            this.processNext();
+            return;
+        }
+        const call = this.active;
+        if (!call || call.id !== response.id)
+            return;
+        this.active = undefined;
+        if (response.ok) {
+            call.resolve(response.data);
+        }
+        else {
+            call.reject(response.error ?? new Error(`sidecar ${response.kind} failed`));
+        }
+        this.processNext();
+    }
+    rejectActive(error) {
+        const call = this.active;
+        if (!call)
+            return;
+        this.active = undefined;
+        call.reject(error);
+    }
+    rejectQueue(error) {
+        while (this.queue.length > 0) {
+            this.queue.shift()?.reject(error);
+        }
+    }
+}
+export function isSidecarError(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "transport" in value &&
+        "reason" in value &&
+        "suggestion" in value &&
+        "minimum_capability" in value &&
+        "exit_code" in value);
+}
+//# sourceMappingURL=sidecar.js.map

package/dist/transport/sidecar.js.map

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

package/dist/transport/snapshot-encoder.d.ts

@@ -0,0 +1,34 @@
+import type { RefAllocator } from "./refs.js";
+export type SnapshotEncoding = "compact" | "tree" | "json";
+export interface RawAxNode {
+    role: string;
+    name?: string;
+    value?: string;
+    bounds?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    screenIndex?: number;
+    states?: readonly string[];
+    children?: RawAxNode[];
+    path: string;
+    scope: string;
+    app?: string;
+    pid?: number;
+}
+export interface EncodeOpts {
+    format?: SnapshotEncoding;
+    interactiveOnly?: boolean;
+    namedOnly?: boolean;
+    maxDepth?: number;
+    includeBounds?: boolean;
+    transport: string;
+    alloc: RefAllocator;
+}
+export declare function encodeSnapshot(root: RawAxNode, opts: EncodeOpts): {
+    encoded: string;
+    refCount: number;
+};
+//# sourceMappingURL=snapshot-encoder.d.ts.map

package/dist/transport/snapshot-encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-encoder.d.ts","sourceRoot":"","sources":["../../src/transport/snapshot-encoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,WAAW,CAAC;AAE1D,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,UAAU,GACf;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CASvC"}

package/dist/transport/snapshot-encoder.js

@@ -0,0 +1,139 @@
+export function encodeSnapshot(root, opts) {
+    const format = opts.format ?? "compact";
+    if (format === "json") {
+        return { encoded: JSON.stringify(root), refCount: 0 };
+    }
+    const lines = [];
+    walk(root, opts, lines, 0);
+    return { encoded: lines.join("\n"), refCount: opts.alloc.size };
+}
+function walk(node, opts, lines, depth) {
+    const maxDepth = opts.maxDepth ?? 64;
+    if (depth > maxDepth)
+        return;
+    const format = opts.format ?? "compact";
+    const namedOnly = opts.namedOnly ?? format === "compact";
+    const interactive = isInteractive(node);
+    const named = Boolean(node.name);
+    const include = (!opts.interactiveOnly || interactive) &&
+        (!namedOnly || named || depth === 0);
+    if (include) {
+        const ref = opts.alloc.alloc({
+            stable: `${opts.transport}:${node.scope}:${node.path}`,
+            role: node.role,
+            name: node.name,
+            value: node.value,
+            bounds: node.bounds,
+            screenIndex: node.screenIndex,
+            states: node.states,
+            app: node.app,
+            pid: node.pid,
+        });
+        lines.push(formatLine(ref, {
+            format,
+            depth,
+            includeBounds: opts.includeBounds ?? true,
+            includeName: opts.interactiveOnly !== true,
+        }));
+    }
+    for (const child of node.children ?? []) {
+        walk(child, opts, lines, depth + 1);
+    }
+}
+function formatLine(ref, opts) {
+    const { format, depth, includeBounds, includeName } = opts;
+    const pad = format === "tree" ? "  ".repeat(depth) : "";
+    const role = simplifyRole(ref.role);
+    const name = includeName && ref.name ? ` "${escapeQuotes(ref.name)}"` : "";
+    const value = includeName && ref.value ? ` value="${escapeQuotes(ref.value)}"` : "";
+    const bounds = includeBounds && ref.bounds
+        ? ` ${ref.bounds.w}x${ref.bounds.h}@${ref.bounds.x},${ref.bounds.y}`
+        : "";
+    const states = ref.states && ref.states.length > 0 ? ` {${ref.states.join(",")}}` : "";
+    const screen = typeof ref.screenIndex === "number" && Number.isFinite(ref.screenIndex)
+        ? ` screen=${Math.trunc(ref.screenIndex)}`
+        : "";
+    const app = ref.app ? ` app=${ref.app}` : "";
+    return `${pad}${ref.alias} ${role}${name}${value}${bounds}${screen}${states}${app}`;
+}
+const ROLE_SIMPLIFY = {
+    AXButton: "button",
+    AXTextField: "input",
+    AXTextArea: "textarea",
+    AXStaticText: "text",
+    AXMenuItem: "menuitem",
+    AXCheckBox: "checkbox",
+    AXRadioButton: "radio",
+    AXLink: "link",
+    AXImage: "image",
+    AXWindow: "window",
+    AXGroup: "group",
+    AXList: "list",
+    Button: "button",
+    Edit: "input",
+    Text: "text",
+    MenuItem: "menuitem",
+    CheckBox: "checkbox",
+    RadioButton: "radio",
+    Hyperlink: "link",
+    Image: "image",
+    Window: "window",
+    push_button: "button",
+    text: "input",
+    label: "text",
+    menu_item: "menuitem",
+    check_box: "checkbox",
+    radio_button: "radio",
+    link: "link",
+    image: "image",
+    frame: "window",
+};
+function simplifyRole(role) {
+    return ROLE_SIMPLIFY[role] ?? role.toLowerCase();
+}
+const INTERACTIVE_ROLES = new Set([
+    "AXButton",
+    "AXTextField",
+    "AXTextArea",
+    "AXMenuItem",
+    "AXCheckBox",
+    "AXRadioButton",
+    "AXLink",
+    "AXPopUpButton",
+    "AXSlider",
+    "AXIncrementor",
+    "Button",
+    "Edit",
+    "MenuItem",
+    "CheckBox",
+    "RadioButton",
+    "Hyperlink",
+    "ComboBox",
+    "Slider",
+    "Spinner",
+    "Tab",
+    "TabItem",
+    "TreeItem",
+    "ListItem",
+    "push_button",
+    "text",
+    "menu_item",
+    "check_box",
+    "radio_button",
+    "link",
+    "combo_box",
+    "slider",
+    "spin_button",
+    "tab",
+    "tree_item",
+    "list_item",
+]);
+function isInteractive(node) {
+    if (INTERACTIVE_ROLES.has(node.role))
+        return true;
+    return (node.states ?? []).some((state) => state === "focusable" || state === "editable" || state === "clickable");
+}
+function escapeQuotes(value) {
+    return value.replace(/"/g, '\\"');
+}
+//# sourceMappingURL=snapshot-encoder.js.map

package/dist/transport/snapshot-encoder.js.map

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