@gtkx/cli 1.0.0-rc.4 → 1.1.0

package/dist/mcp/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/mcp/client.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gio from \"@gtkx/gi/gio\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport { DEFAULT_SOCKET_PATH, ErrorCode, ProtocolConnection, ProtocolError, type Request } from \"@gtkx/mcp/internal\";\nimport { error, errorMessage, info, normalizeError, warn } from \"@gtkx/utils\";\nimport * as net from \"node:net\";\nimport { dispatch } from \"./handlers.js\";\nimport { WidgetRegistry } from \"./widget-registry.js\";\n\ntype McpClientOptions = {\n    socketPath?: string;\n    applicationId: string;\n};\n\ntype ConnectCallbacks = {\n    onSuccess?: (() => void) | undefined;\n    onError?: ((error: Error) => void) | undefined;\n};\n\ntype ConnectSettler = {\n    succeed: () => void;\n    fail: (error: Error) => void;\n};\n\nconst RECONNECT_DELAY_MS = 2000;\nconst REGISTER_TIMEOUT_MS = 30_000;\nconst DISCONNECT_ERROR_CODES: Set<string> = new Set([\"ENOENT\", \"ECONNREFUSED\", \"EPIPE\", \"ECONNRESET\"]);\n\nconst toResponseError = (error: unknown): { code: number; message: string; data?: unknown } =>\n    error instanceof ProtocolError\n        ? error.toErrorObject()\n        : { code: ErrorCode.INTERNAL_ERROR, message: errorMessage(error) };\n\nconst connectSettler = (callbacks: ConnectCallbacks): ConnectSettler => {\n    let isSettled = false;\n\n    const settle = (notify: () => void): void => {\n        if (isSettled) {\n            return;\n        }\n\n        isSettled = true;\n        notify();\n    };\n\n    return {\n        succeed: () => {\n            settle(() => callbacks.onSuccess?.());\n        },\n        fail: (failure) => {\n            settle(() => callbacks.onError?.(failure));\n        },\n    };\n};\n\nclass McpClient {\n    private socket: net.Socket | null = null;\n    private connection: ProtocolConnection | null = null;\n    private socketPath: string;\n    private applicationId: string;\n    private reconnectTimer: NodeJS.Timeout | null = null;\n    private hasConnected = false;\n    private isStopping = false;\n    private pendingConnectReject: ((error: Error) => void) | null = null;\n    private registry = new WidgetRegistry();\n\n    constructor(options: McpClientOptions) {\n        this.socketPath = options.socketPath ?? DEFAULT_SOCKET_PATH;\n        this.applicationId = options.applicationId;\n    }\n\n    private handleClose(): void {\n        if (this.hasConnected) {\n            info(\"Disconnected from MCP server\");\n            this.hasConnected = false;\n        }\n\n        this.socket = null;\n        this.connection = null;\n        this.scheduleReconnect();\n    }\n\n    private handleSocketError(socketError: Error): void {\n        const code = (socketError as NodeJS.ErrnoException).code;\n\n        if (code !== undefined && DISCONNECT_ERROR_CODES.has(code)) {\n            this.scheduleReconnect();\n        } else {\n            error(\"Socket error:\", socketError.message);\n        }\n    }\n\n    private async registerWithServer(settle: ConnectSettler): Promise<void> {\n        try {\n            await this.register();\n            info(\"Registered with MCP server\");\n            settle.succeed();\n        } catch (registerError) {\n            error(\"Failed to register with MCP server:\", errorMessage(registerError));\n            settle.fail(normalizeError(registerError));\n        }\n    }\n\n    private attemptConnect(callbacks: ConnectCallbacks = {}): void {\n        const settle = connectSettler(callbacks);\n\n        const socket = net.createConnection(this.socketPath, () => {\n            info(`Connected to MCP server at ${this.socketPath}`);\n            this.hasConnected = true;\n            void this.registerWithServer(settle);\n        });\n\n        const connection = ProtocolConnection.fromSocket(socket, {\n            onClose: () => {\n                this.handleClose();\n            },\n            onError: (socketError) => {\n                this.handleSocketError(socketError);\n                settle.fail(socketError);\n            },\n        });\n\n        connection.on(\"request\", (request) => {\n            void this.handleRequest(request);\n        });\n\n        connection.on(\"invalid\", ({ error: parseError }) => {\n            warn(`Received invalid JSON from MCP server: ${parseError.message}`);\n        });\n\n        this.socket = socket;\n        this.connection = connection;\n    }\n\n    private scheduleReconnect(): void {\n        if (this.reconnectTimer || this.isStopping) {\n            return;\n        }\n\n        this.reconnectTimer = setTimeout(() => {\n            this.reconnectTimer = null;\n            this.attemptConnect();\n        }, RECONNECT_DELAY_MS);\n    }\n\n    private register(): Promise<unknown> {\n        if (!this.connection) {\n            return Promise.reject(new Error(\"Connection not initialized\"));\n        }\n\n        return this.connection.send(\n            \"app.register\",\n            {\n                applicationId: this.applicationId,\n                pid: process.pid,\n                projectRoot: process.cwd(),\n            },\n            REGISTER_TIMEOUT_MS,\n        );\n    }\n\n    private async respondToRequest(request: Request): Promise<void> {\n        const { id, method, params } = request;\n        const connection = this.connection;\n\n        if (!connection) {\n            return;\n        }\n\n        try {\n            const defaultApp = Gio.Application.getDefault();\n\n            if (!(defaultApp instanceof Gtk.Application)) {\n                throw new TypeError(\"Application not initialized\");\n            }\n\n            this.registry.refresh();\n            const result = await dispatch(method, params, { app: defaultApp, registry: this.registry });\n            connection.write({ id, result });\n        } catch (dispatchError) {\n            connection.write({ id, error: toResponseError(dispatchError) });\n        }\n    }\n\n    private async handleRequest(request: Request): Promise<void> {\n        try {\n            await this.respondToRequest(request);\n        } catch (requestError) {\n            error(\"Error handling request:\", requestError);\n        }\n    }\n\n    async connect(): Promise<void> {\n        return new Promise<void>((resolve, reject) => {\n            this.pendingConnectReject = reject;\n\n            this.attemptConnect({\n                onSuccess: () => {\n                    this.pendingConnectReject = null;\n                    resolve();\n                },\n                onError: (connectError) => {\n                    this.pendingConnectReject = null;\n                    reject(connectError);\n                },\n            });\n        });\n    }\n\n    disconnect(): void {\n        this.isStopping = true;\n\n        if (this.pendingConnectReject) {\n            this.pendingConnectReject(new Error(\"Client disconnected before connection registered\"));\n            this.pendingConnectReject = null;\n        }\n\n        if (this.reconnectTimer) {\n            clearTimeout(this.reconnectTimer);\n            this.reconnectTimer = null;\n        }\n\n        this.connection?.rejectPending(new Error(\"Client disconnected\"));\n\n        if (this.socket) {\n            this.connection?.write({ id: crypto.randomUUID(), method: \"app.unregister\" });\n            this.socket.destroy();\n            this.socket = null;\n        }\n\n        this.connection = null;\n        this.hasConnected = false;\n    }\n}\n\nexport { McpClient, type McpClientOptions };\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/mcp/client.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gio from \"@gtkx/gi/gio\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport { DEFAULT_SOCKET_PATH, ErrorCode, ProtocolConnection, ProtocolError, type Request } from \"@gtkx/mcp/internal\";\nimport { error, errorMessage, info, normalizeError, warn } from \"@gtkx/utils\";\nimport * as net from \"node:net\";\nimport { dispatch } from \"./handlers.js\";\nimport { WidgetRegistry } from \"./widget-registry.js\";\n\ntype McpClientOptions = {\n    socketPath?: string;\n    applicationId: string;\n};\n\ntype ConnectCallbacks = {\n    onSuccess?: (() => void) | undefined;\n    onError?: ((error: Error) => void) | undefined;\n};\n\ntype ConnectSettler = {\n    succeed: () => void;\n    fail: (error: Error) => void;\n};\n\nconst RECONNECT_DELAY_MS = 2000;\nconst REGISTER_TIMEOUT_MS = 30_000;\nconst DISCONNECT_ERROR_CODES: Set<string> = new Set([\"ENOENT\", \"ECONNREFUSED\", \"EPIPE\", \"ECONNRESET\"]);\n\nconst toResponseError = (error: unknown): { code: number; message: string; data?: unknown } =>\n    error instanceof ProtocolError\n        ? error.toErrorObject()\n        : { code: ErrorCode.INTERNAL_ERROR, message: errorMessage(error) };\n\nconst connectSettler = (callbacks: ConnectCallbacks): ConnectSettler => {\n    let isSettled = false;\n\n    const settle = (notify: () => void): void => {\n        if (isSettled) {\n            return;\n        }\n\n        isSettled = true;\n        notify();\n    };\n\n    return {\n        succeed: () => {\n            settle(() => callbacks.onSuccess?.());\n        },\n        fail: (failure) => {\n            settle(() => callbacks.onError?.(failure));\n        },\n    };\n};\n\nclass McpClient {\n    private socket: net.Socket | null = null;\n    private connection: ProtocolConnection | null = null;\n    private socketPath: string;\n    private applicationId: string;\n    private reconnectTimer: NodeJS.Timeout | null = null;\n    private hasConnected = false;\n    private isStopping = false;\n    private pendingConnectReject: ((error: Error) => void) | null = null;\n    private registry = new WidgetRegistry();\n\n    constructor(options: McpClientOptions) {\n        this.socketPath = options.socketPath ?? DEFAULT_SOCKET_PATH;\n        this.applicationId = options.applicationId;\n    }\n\n    private handleClose(): void {\n        if (this.hasConnected) {\n            info(\"Disconnected from MCP server\");\n            this.hasConnected = false;\n        }\n\n        this.socket = null;\n        this.connection = null;\n        this.scheduleReconnect();\n    }\n\n    private handleSocketError(socketError: Error): void {\n        const code = (socketError as NodeJS.ErrnoException).code;\n\n        if (code !== undefined && DISCONNECT_ERROR_CODES.has(code)) {\n            this.scheduleReconnect();\n        } else {\n            error(\"Socket error:\", socketError.message);\n        }\n    }\n\n    private async registerWithServer(settle: ConnectSettler): Promise<void> {\n        try {\n            await this.register();\n            info(\"Registered with MCP server\");\n            settle.succeed();\n        } catch (registerError) {\n            error(\"Failed to register with MCP server:\", errorMessage(registerError));\n            settle.fail(normalizeError(registerError));\n        }\n    }\n\n    private attemptConnect(callbacks: ConnectCallbacks = {}): void {\n        const settle = connectSettler(callbacks);\n\n        const socket = net.createConnection(this.socketPath, () => {\n            info(`Connected to MCP server at ${this.socketPath}`);\n            this.hasConnected = true;\n            void this.registerWithServer(settle);\n        });\n\n        const connection = ProtocolConnection.fromSocket(socket, {\n            onClose: () => {\n                this.handleClose();\n            },\n            onError: (socketError) => {\n                this.handleSocketError(socketError);\n                settle.fail(socketError);\n            },\n        });\n\n        connection.on(\"request\", (request) => {\n            void this.handleRequest(request);\n        });\n\n        connection.on(\"invalid\", ({ error: parseError }) => {\n            warn(`Received invalid JSON from MCP server: ${parseError.message}`);\n        });\n\n        this.socket = socket;\n        this.connection = connection;\n    }\n\n    private scheduleReconnect(): void {\n        if (this.reconnectTimer || this.isStopping) {\n            return;\n        }\n\n        this.reconnectTimer = setTimeout(() => {\n            this.reconnectTimer = null;\n            this.attemptConnect();\n        }, RECONNECT_DELAY_MS);\n    }\n\n    private register(): Promise<unknown> {\n        if (!this.connection) {\n            return Promise.reject(new Error(\"Connection not initialized\"));\n        }\n\n        return this.connection.send(\n            \"app.register\",\n            {\n                applicationId: this.applicationId,\n                pid: process.pid,\n                projectRoot: process.cwd(),\n            },\n            REGISTER_TIMEOUT_MS,\n        );\n    }\n\n    private async respondToRequest(request: Request): Promise<void> {\n        const { id, method, params } = request;\n        const connection = this.connection;\n\n        if (!connection) {\n            return;\n        }\n\n        try {\n            const defaultApp = Gio.Application.getDefault();\n\n            if (!(defaultApp instanceof Gtk.Application)) {\n                throw new TypeError(\"Application not initialized\");\n            }\n\n            this.registry.refresh();\n            const result = await dispatch(method, params, { app: defaultApp, registry: this.registry });\n            connection.write({ id, result });\n        } catch (dispatchError) {\n            connection.write({ id, error: toResponseError(dispatchError) });\n        }\n    }\n\n    private async handleRequest(request: Request): Promise<void> {\n        try {\n            await this.respondToRequest(request);\n        } catch (requestError) {\n            error(\"Error handling request:\", requestError);\n        }\n    }\n\n    async connect(): Promise<void> {\n        return new Promise<void>((resolve, reject) => {\n            this.pendingConnectReject = reject;\n\n            this.attemptConnect({\n                onSuccess: () => {\n                    this.pendingConnectReject = null;\n                    resolve();\n                },\n                onError: (connectError) => {\n                    this.pendingConnectReject = null;\n                    reject(connectError);\n                },\n            });\n        });\n    }\n\n    disconnect(): void {\n        this.isStopping = true;\n\n        if (this.pendingConnectReject) {\n            this.pendingConnectReject(new Error(\"Client disconnected before connection registered\"));\n            this.pendingConnectReject = null;\n        }\n\n        if (this.reconnectTimer) {\n            clearTimeout(this.reconnectTimer);\n            this.reconnectTimer = null;\n        }\n\n        this.connection?.rejectPending(new Error(\"Client disconnected\"));\n\n        if (this.socket) {\n            this.connection?.write({ id: crypto.randomUUID(), method: \"app.unregister\" });\n            this.socket.destroy();\n            this.socket = null;\n        }\n\n        this.connection = null;\n        this.hasConnected = false;\n    }\n}\n\nexport { McpClient };\n"]}

package/dist/mcp/handlers.d.ts

@@ -5,5 +5,5 @@ type HandlerContext = {
     registry: WidgetRegistry;
 };
 declare const dispatch: (method: string, params: unknown, ctx: HandlerContext) => Promise<unknown>;
-export { dispatch, type HandlerContext };
+export { dispatch };
 //# sourceMappingURL=handlers.d.ts.map

package/dist/mcp/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/mcp/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAYpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,KAAK,cAAc,GAAG;IAClB,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;CAC5B,CAAC;AAyLF,QAAA,MAAM,QAAQ,GAAU,QAAQ,MAAM,EAAE,QAAQ,OAAO,EAAE,KAAK,cAAc,KAAG,OAAO,CAAC,OAAO,CAM7F,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,CAAC"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/mcp/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAUpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,KAAK,cAAc,GAAG;IAClB,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;CAC5B,CAAC;AA6PF,QAAA,MAAM,QAAQ,GAAU,QAAQ,MAAM,EAAE,QAAQ,OAAO,EAAE,KAAK,cAAc,KAAG,OAAO,CAAC,OAAO,CAM7F,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/mcp/handlers.js

@@ -1,9 +1,8 @@
 import * as Gtk from "@gtkx/gi/gtk";
 import { invalidRequestError, methodNotFoundError, ServerRequestParamsSchemas, widgetNotFoundError, } from "@gtkx/mcp/internal";
-import { mkdirSync, writeFileSync } from "node:fs";
-import { dirname } from "node:path";
 import { serializeWidget } from "./serialize-widget.js";
 import { loadTestingModule } from "./testing-loader.js";
+import { readWidgetProperties } from "./widget-properties.js";
 const HANDLERS = {
     "app.getWindows": validated(ServerRequestParamsSchemas["app.getWindows"], ({ registry }) => Promise.resolve({
         windows: registry.toplevels().map((window) => ({
@@ -23,31 +22,52 @@ const HANDLERS = {
         };
     }),
     "widget.query": validated(ServerRequestParamsSchemas["widget.query"], handleQuery),
-    "widget.getProps": validated(ServerRequestParamsSchemas["widget.getProps"], async ({ registry }, params) => {
-        const { testing, widget } = await widgetTarget(registry, params.widgetId);
-        return serializeWidget(widget, (target) => registry.getOrCreateId(target), testing);
-    }),
-    "widget.click": validated(ServerRequestParamsSchemas["widget.click"], async ({ registry }, params) => {
-        const { testing, widget } = await widgetTarget(registry, params.widgetId);
+    "widget.getProps": targeted(ServerRequestParamsSchemas["widget.getProps"], ({ registry }, { testing, widget }, params) => Promise.resolve({
+        ...(params.properties !== undefined && {
+            properties: readWidgetProperties(widget, params.properties, registry),
+        }),
+        ...serializeWidget(widget, (target) => registry.getOrCreateId(target), testing, params.maxDepth),
+    })),
+    "widget.click": targeted(ServerRequestParamsSchemas["widget.click"], async (_ctx, { testing, widget }) => {
         await testing.userEvent.click(widget);
         return { success: true };
     }),
-    "widget.type": validated(ServerRequestParamsSchemas["widget.type"], async ({ registry }, params) => {
-        const { testing, widget } = await widgetTarget(registry, params.widgetId);
+    "widget.type": targeted(ServerRequestParamsSchemas["widget.type"], async (_ctx, { testing, widget }, params) => {
         if (params.clear) {
             await testing.userEvent.clear(widget);
         }
         await testing.userEvent.type(widget, params.text);
         return { success: true };
     }),
-    "widget.fireEvent": validated(ServerRequestParamsSchemas["widget.fireEvent"], async ({ registry }, params) => {
-        const { testing, widget } = await widgetTarget(registry, params.widgetId);
+    "widget.fireEvent": targeted(ServerRequestParamsSchemas["widget.fireEvent"], async (_ctx, { testing, widget }, params) => {
         const signalArgs = (params.args ?? []).map((arg) => extractSignalArg(arg));
+        const isRealized = widget.getRealized();
+        const isMapped = widget.getMapped();
+        const isSensitive = widget.getSensitive();
         await testing.fireEvent(widget, params.signal, ...signalArgs);
-        return { success: true };
+        return {
+            signal: params.signal,
+            isRealized,
+            isMapped,
+            isSensitive,
+            note: emissionNote(isRealized, isMapped),
+        };
     }),
     "widget.screenshot": validated(ServerRequestParamsSchemas["widget.screenshot"], handleScreenshot),
 };
+const QUERY_RUNNERS = {
+    role: runRoleQuery,
+    text: runTextQuery,
+    name: runNameQuery,
+    labelText: runLabelTextQuery,
+};
+const SEARCHED_BY = {
+    role: "the accessible role, narrowed by any options given",
+    text: "the text the widget renders",
+    name: "the widget name (gtk_widget_get_name, which reports the GType name such as \"GtkButton\" when no name " +
+        "was set), the accessible label, and the text the widget renders",
+    labelText: "the accessible label, the labelled-by relation, and the label whose mnemonic targets the widget",
+};
 function validated(schema, handler) {
     return (ctx, params) => {
         const parsed = schema.safeParse(params ?? {});
@@ -57,6 +77,9 @@ function validated(schema, handler) {
         return handler(ctx, parsed.data);
     };
 }
+function targeted(schema, handler) {
+    return validated(schema, async (ctx, params) => handler(ctx, await widgetTarget(ctx.registry, params.widgetId), params));
+}
 const widgetTarget = async (registry, widgetId) => ({
     testing: await loadTestingModule(),
     widget: requireWidget(registry, widgetId),
@@ -75,6 +98,15 @@ const extractSignalArg = (arg) => {
     const isTypedArg = typeof arg === "object" && arg !== null && "type" in arg && "value" in arg;
     return isTypedArg ? arg.value : arg;
 };
+const emissionNote = (isRealized, isMapped) => {
+    if (isRealized && isMapped) {
+        return ("The signal was emitted. Default handlers that animate, such as a button activate, settle " +
+            "asynchronously, so read the widget again rather than assuming the effect has landed.");
+    }
+    return ("The signal was emitted on a widget that is not realized and mapped, so a default handler that " +
+        "requires a drawn widget does nothing. Present the containing window or open the containing " +
+        "popover first, then fire the signal again.");
+};
 const resolveRole = (value) => {
     if (typeof value === "number") {
         return value;
@@ -90,33 +122,40 @@ const matchesOrEmpty = async (find) => {
         return [];
     }
 };
+function runRoleQuery(testing, app, params) {
+    const roleValue = resolveRole(params.value);
+    if (roleValue === undefined) {
+        throw invalidRequestError(`Unknown accessible role "${String(params.value)}"; use the lowercase role shown in the ` +
+            "widget tree, e.g. \"button\", \"list\", \"list_item\", or \"checkbox\".");
+    }
+    return matchesOrEmpty(() => testing.findAllByRole(app, roleValue, params.options));
+}
+function runTextQuery(testing, app, params) {
+    return matchesOrEmpty(() => testing.findAllByText(app, String(params.value), params.options));
+}
+function runLabelTextQuery(testing, app, params) {
+    return matchesOrEmpty(() => testing.findAllByLabelText(app, String(params.value), params.options));
+}
+async function runNameQuery(testing, app, params) {
+    const matches = await Promise.all([
+        matchesOrEmpty(() => testing.findAllByName(app, String(params.value), params.options)),
+        runLabelTextQuery(testing, app, params),
+        runTextQuery(testing, app, params),
+    ]);
+    return [...new Set(matches.flat())];
+}
+const emptyQueryHint = (params) => `Nothing matched by:"${params.by}" value:"${String(params.value)}", which compared ${SEARCHED_BY[params.by]}. ` +
+    "Call gtkx_get_widget_tree to see what is mounted; by:\"name\" is the widest match, and by:\"role\" accepts " +
+    "options.name to match the accessible name of a known role.";
 async function handleQuery({ app, registry }, params) {
     const testing = await loadTestingModule();
-    let widgets = [];
-    switch (params.by) {
-        case "role": {
-            const roleValue = resolveRole(params.value);
-            if (roleValue === undefined) {
-                throw invalidRequestError(`Unknown accessible role "${String(params.value)}"; use the lowercase role shown in the ` +
-                    "widget tree, e.g. \"button\", \"list\", \"list_item\", or \"checkbox\".");
-            }
-            widgets = await matchesOrEmpty(() => testing.findAllByRole(app, roleValue, params.options));
-            break;
-        }
-        case "text": {
-            widgets = await matchesOrEmpty(() => testing.findAllByText(app, String(params.value), params.options));
-            break;
-        }
-        case "name": {
-            widgets = await matchesOrEmpty(() => testing.findAllByName(app, String(params.value), params.options));
-            break;
-        }
-        case "labelText": {
-            widgets = await matchesOrEmpty(() => testing.findAllByLabelText(app, String(params.value), params.options));
-            break;
-        }
-    }
-    return { widgets: widgets.map((w) => serializeWidget(w, (widget) => registry.getOrCreateId(widget), testing, 0)) };
+    const widgets = await QUERY_RUNNERS[params.by](testing, app, params);
+    const resolveId = (widget) => registry.getOrCreateId(widget);
+    return {
+        widgets: widgets.map((widget) => serializeWidget(widget, resolveId, testing, 0)),
+        searched: SEARCHED_BY[params.by],
+        ...(widgets.length === 0 && { hint: emptyQueryHint(params) }),
+    };
 }
 const defaultScreenshotTarget = (registry) => {
     const [toplevel] = registry.toplevels();
@@ -128,10 +167,8 @@ const defaultScreenshotTarget = (registry) => {
 async function handleScreenshot({ registry }, params) {
     const testing = await loadTestingModule();
     const target = params.windowId ? requireWidget(registry, params.windowId) : defaultScreenshotTarget(registry);
-    const result = await testing.screenshot(target);
+    const result = await testing.screenshot(target, { path: params.path });
     if (params.path) {
-        mkdirSync(dirname(params.path), { recursive: true });
-        writeFileSync(params.path, Buffer.from(result.data, "base64"));
         return { data: result.data, mimeType: result.mimeType, savedPath: params.path };
     }
     return { data: result.data, mimeType: result.mimeType };

package/dist/mcp/handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/mcp/handlers.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport {\n    invalidRequestError,\n    methodNotFoundError,\n    type ParamsSchema,\n    type ServerInitiatedMethod,\n    type ServerRequestParams,\n    ServerRequestParamsSchemas,\n    widgetNotFoundError,\n} from \"@gtkx/mcp/internal\";\nimport { mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport type { WidgetRegistry } from \"./widget-registry.js\";\nimport { serializeWidget } from \"./serialize-widget.js\";\nimport { loadTestingModule, type TestingModule } from \"./testing-loader.js\";\n\ntype HandlerContext = {\n    app: Gtk.Application;\n    registry: WidgetRegistry;\n};\n\ntype ValidatedHandler = (ctx: HandlerContext, params: unknown) => Promise<unknown>;\ntype WidgetTarget = { testing: TestingModule; widget: Gtk.Widget };\n\nconst HANDLERS: Record<ServerInitiatedMethod, ValidatedHandler> = {\n    \"app.getWindows\": validated(ServerRequestParamsSchemas[\"app.getWindows\"], ({ registry }) =>\n        Promise.resolve({\n            windows: registry.toplevels().map((window) => ({\n                id: registry.getOrCreateId(window),\n                title: window.getTitle(),\n            })),\n        })),\n    \"widget.getTree\": validated(ServerRequestParamsSchemas[\"widget.getTree\"], async ({ app, registry }, params) => {\n        const testing = await loadTestingModule();\n        const container = params.rootId === undefined ? app : requireWidget(registry, params.rootId);\n\n        return {\n            tree: testing.prettyWidget(container, {\n                getId: (w) => registry.getOrCreateId(w),\n                shouldHighlight: false,\n                ...((params.maxDepth !== undefined) && { maxDepth: params.maxDepth }),\n            }),\n        };\n    }),\n    \"widget.query\": validated(ServerRequestParamsSchemas[\"widget.query\"], handleQuery),\n    \"widget.getProps\": validated(ServerRequestParamsSchemas[\"widget.getProps\"], async ({ registry }, params) => {\n        const { testing, widget } = await widgetTarget(registry, params.widgetId);\n\n        return serializeWidget(widget, (target) => registry.getOrCreateId(target), testing);\n    }),\n    \"widget.click\": validated(ServerRequestParamsSchemas[\"widget.click\"], async ({ registry }, params) => {\n        const { testing, widget } = await widgetTarget(registry, params.widgetId);\n        await testing.userEvent.click(widget);\n\n        return { success: true };\n    }),\n    \"widget.type\": validated(ServerRequestParamsSchemas[\"widget.type\"], async ({ registry }, params) => {\n        const { testing, widget } = await widgetTarget(registry, params.widgetId);\n\n        if (params.clear) {\n            await testing.userEvent.clear(widget);\n        }\n\n        await testing.userEvent.type(widget, params.text);\n\n        return { success: true };\n    }),\n    \"widget.fireEvent\": validated(ServerRequestParamsSchemas[\"widget.fireEvent\"], async ({ registry }, params) => {\n        const { testing, widget } = await widgetTarget(registry, params.widgetId);\n        const signalArgs = (params.args ?? []).map((arg) => extractSignalArg(arg));\n        await testing.fireEvent(widget, params.signal, ...signalArgs);\n\n        return { success: true };\n    }),\n    \"widget.screenshot\": validated(ServerRequestParamsSchemas[\"widget.screenshot\"], handleScreenshot),\n};\n\nfunction validated<Params>(\n    schema: ParamsSchema<Params>,\n    handler: (ctx: HandlerContext, params: Params) => Promise<unknown>,\n): ValidatedHandler {\n    return (ctx, params) => {\n        const parsed = schema.safeParse(params ?? {});\n\n        if (!parsed.success) {\n            throw invalidRequestError(parsed.error.message);\n        }\n\n        return handler(ctx, parsed.data);\n    };\n}\n\nconst widgetTarget = async (registry: WidgetRegistry, widgetId: string | undefined): Promise<WidgetTarget> => ({\n    testing: await loadTestingModule(),\n    widget: requireWidget(registry, widgetId),\n});\n\nconst requireWidget = (registry: WidgetRegistry, widgetId: string | undefined): Gtk.Widget => {\n    if (widgetId === undefined) {\n        throw widgetNotFoundError(\"undefined\");\n    }\n\n    const widget = registry.get(widgetId);\n\n    if (!widget) {\n        throw widgetNotFoundError(widgetId);\n    }\n\n    return widget;\n};\n\nconst extractSignalArg = (arg: unknown): unknown => {\n    const isTypedArg = typeof arg === \"object\" && arg !== null && \"type\" in arg && \"value\" in arg;\n\n    return isTypedArg ? (arg as { value: unknown }).value : arg;\n};\n\nconst resolveRole = (value: string | number): Gtk.AccessibleRole | undefined => {\n    if (typeof value === \"number\") {\n        return value;\n    }\n\n    const resolved = Gtk.AccessibleRole[value.toUpperCase() as keyof typeof Gtk.AccessibleRole];\n\n    return typeof resolved === \"number\" ? resolved : undefined;\n};\n\nconst matchesOrEmpty = async (find: () => Promise<Gtk.Widget[]>): Promise<Gtk.Widget[]> => {\n    try {\n        return await find();\n    } catch {\n        return [];\n    }\n};\n\nasync function handleQuery(\n    { app, registry }: HandlerContext,\n    params: ServerRequestParams<\"widget.query\">,\n): Promise<unknown> {\n    const testing = await loadTestingModule();\n    let widgets: Gtk.Widget[] = [];\n\n    switch (params.by) {\n        case \"role\": {\n            const roleValue = resolveRole(params.value);\n\n            if (roleValue === undefined) {\n                throw invalidRequestError(\n                    `Unknown accessible role \"${String(params.value)}\"; use the lowercase role shown in the ` +\n                    \"widget tree, e.g. \\\"button\\\", \\\"list\\\", \\\"list_item\\\", or \\\"checkbox\\\".\",\n                );\n            }\n\n            widgets = await matchesOrEmpty(() => testing.findAllByRole(app, roleValue, params.options));\n            break;\n        }\n        case \"text\": {\n            widgets = await matchesOrEmpty(() => testing.findAllByText(app, String(params.value), params.options));\n            break;\n        }\n        case \"name\": {\n            widgets = await matchesOrEmpty(() => testing.findAllByName(app, String(params.value), params.options));\n            break;\n        }\n        case \"labelText\": {\n            widgets = await matchesOrEmpty(() => testing.findAllByLabelText(app, String(params.value), params.options));\n            break;\n        }\n    }\n\n    return { widgets: widgets.map((w) => serializeWidget(w, (widget) => registry.getOrCreateId(widget), testing, 0)) };\n}\n\nconst defaultScreenshotTarget = (registry: WidgetRegistry): Gtk.Widget => {\n    const [toplevel] = registry.toplevels();\n\n    if (!toplevel) {\n        throw new Error(\"No windows available for screenshot\");\n    }\n\n    return toplevel;\n};\n\nasync function handleScreenshot(\n    { registry }: HandlerContext,\n    params: ServerRequestParams<\"widget.screenshot\">,\n): Promise<unknown> {\n    const testing = await loadTestingModule();\n    const target = params.windowId ? requireWidget(registry, params.windowId) : defaultScreenshotTarget(registry);\n    const result = await testing.screenshot(target);\n\n    if (params.path) {\n        mkdirSync(dirname(params.path), { recursive: true });\n        writeFileSync(params.path, Buffer.from(result.data, \"base64\"));\n\n        return { data: result.data, mimeType: result.mimeType, savedPath: params.path };\n    }\n\n    return { data: result.data, mimeType: result.mimeType };\n}\n\nconst isServerInitiatedMethod = (method: string): method is ServerInitiatedMethod =>\n    Object.hasOwn(ServerRequestParamsSchemas, method);\n\nconst dispatch = async (method: string, params: unknown, ctx: HandlerContext): Promise<unknown> => {\n    if (!isServerInitiatedMethod(method)) {\n        throw methodNotFoundError(method);\n    }\n\n    return HANDLERS[method](ctx, params);\n};\n\nexport { dispatch, type HandlerContext };\n"]}
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/mcp/handlers.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Gtk from \"@gtkx/gi/gtk\";\nimport {\n    invalidRequestError,\n    methodNotFoundError,\n    type ParamsSchema,\n    type ServerInitiatedMethod,\n    type ServerRequestParams,\n    ServerRequestParamsSchemas,\n    widgetNotFoundError,\n} from \"@gtkx/mcp/internal\";\nimport type { WidgetRegistry } from \"./widget-registry.js\";\nimport { serializeWidget } from \"./serialize-widget.js\";\nimport { loadTestingModule, type TestingModule } from \"./testing-loader.js\";\nimport { readWidgetProperties } from \"./widget-properties.js\";\n\ntype HandlerContext = {\n    app: Gtk.Application;\n    registry: WidgetRegistry;\n};\n\ntype ValidatedHandler = (ctx: HandlerContext, params: unknown) => Promise<unknown>;\ntype WidgetTarget = { testing: TestingModule; widget: Gtk.Widget };\ntype WidgetParams = { widgetId?: string | undefined };\ntype TargetedHandler<Params> = (ctx: HandlerContext, target: WidgetTarget, params: Params) => Promise<unknown>;\ntype QueryParams = ServerRequestParams<\"widget.query\">;\ntype QueryBy = QueryParams[\"by\"];\ntype QueryRunner = (testing: TestingModule, app: Gtk.Application, params: QueryParams) => Promise<Gtk.Widget[]>;\n\nconst HANDLERS: Record<ServerInitiatedMethod, ValidatedHandler> = {\n    \"app.getWindows\": validated(ServerRequestParamsSchemas[\"app.getWindows\"], ({ registry }) =>\n        Promise.resolve({\n            windows: registry.toplevels().map((window) => ({\n                id: registry.getOrCreateId(window),\n                title: window.getTitle(),\n            })),\n        })),\n    \"widget.getTree\": validated(ServerRequestParamsSchemas[\"widget.getTree\"], async ({ app, registry }, params) => {\n        const testing = await loadTestingModule();\n        const container = params.rootId === undefined ? app : requireWidget(registry, params.rootId);\n\n        return {\n            tree: testing.prettyWidget(container, {\n                getId: (w) => registry.getOrCreateId(w),\n                shouldHighlight: false,\n                ...((params.maxDepth !== undefined) && { maxDepth: params.maxDepth }),\n            }),\n        };\n    }),\n    \"widget.query\": validated(ServerRequestParamsSchemas[\"widget.query\"], handleQuery),\n    \"widget.getProps\": targeted(\n        ServerRequestParamsSchemas[\"widget.getProps\"],\n        ({ registry }, { testing, widget }, params) =>\n            Promise.resolve({\n                ...(params.properties !== undefined && {\n                    properties: readWidgetProperties(widget, params.properties, registry),\n                }),\n                ...serializeWidget(widget, (target) => registry.getOrCreateId(target), testing, params.maxDepth),\n            }),\n    ),\n    \"widget.click\": targeted(ServerRequestParamsSchemas[\"widget.click\"], async (_ctx, { testing, widget }) => {\n        await testing.userEvent.click(widget);\n\n        return { success: true };\n    }),\n    \"widget.type\": targeted(ServerRequestParamsSchemas[\"widget.type\"], async (_ctx, { testing, widget }, params) => {\n        if (params.clear) {\n            await testing.userEvent.clear(widget);\n        }\n\n        await testing.userEvent.type(widget, params.text);\n\n        return { success: true };\n    }),\n    \"widget.fireEvent\": targeted(\n        ServerRequestParamsSchemas[\"widget.fireEvent\"],\n        async (_ctx, { testing, widget }, params) => {\n            const signalArgs = (params.args ?? []).map((arg) => extractSignalArg(arg));\n            const isRealized = widget.getRealized();\n            const isMapped = widget.getMapped();\n            const isSensitive = widget.getSensitive();\n            await testing.fireEvent(widget, params.signal, ...signalArgs);\n\n            return {\n                signal: params.signal,\n                isRealized,\n                isMapped,\n                isSensitive,\n                note: emissionNote(isRealized, isMapped),\n            };\n        },\n    ),\n    \"widget.screenshot\": validated(ServerRequestParamsSchemas[\"widget.screenshot\"], handleScreenshot),\n};\n\nconst QUERY_RUNNERS: Record<QueryBy, QueryRunner> = {\n    role: runRoleQuery,\n    text: runTextQuery,\n    name: runNameQuery,\n    labelText: runLabelTextQuery,\n};\n\nconst SEARCHED_BY: Record<QueryBy, string> = {\n    role: \"the accessible role, narrowed by any options given\",\n    text: \"the text the widget renders\",\n    name:\n        \"the widget name (gtk_widget_get_name, which reports the GType name such as \\\"GtkButton\\\" when no name \" +\n        \"was set), the accessible label, and the text the widget renders\",\n    labelText: \"the accessible label, the labelled-by relation, and the label whose mnemonic targets the widget\",\n};\n\nfunction validated<Params>(\n    schema: ParamsSchema<Params>,\n    handler: (ctx: HandlerContext, params: Params) => Promise<unknown>,\n): ValidatedHandler {\n    return (ctx, params) => {\n        const parsed = schema.safeParse(params ?? {});\n\n        if (!parsed.success) {\n            throw invalidRequestError(parsed.error.message);\n        }\n\n        return handler(ctx, parsed.data);\n    };\n}\n\nfunction targeted<Params extends WidgetParams>(\n    schema: ParamsSchema<Params>,\n    handler: TargetedHandler<Params>,\n): ValidatedHandler {\n    return validated(schema, async (ctx, params) =>\n        handler(ctx, await widgetTarget(ctx.registry, params.widgetId), params));\n}\n\nconst widgetTarget = async (registry: WidgetRegistry, widgetId: string | undefined): Promise<WidgetTarget> => ({\n    testing: await loadTestingModule(),\n    widget: requireWidget(registry, widgetId),\n});\n\nconst requireWidget = (registry: WidgetRegistry, widgetId: string | undefined): Gtk.Widget => {\n    if (widgetId === undefined) {\n        throw widgetNotFoundError(\"undefined\");\n    }\n\n    const widget = registry.get(widgetId);\n\n    if (!widget) {\n        throw widgetNotFoundError(widgetId);\n    }\n\n    return widget;\n};\n\nconst extractSignalArg = (arg: unknown): unknown => {\n    const isTypedArg = typeof arg === \"object\" && arg !== null && \"type\" in arg && \"value\" in arg;\n\n    return isTypedArg ? (arg as { value: unknown }).value : arg;\n};\n\nconst emissionNote = (isRealized: boolean, isMapped: boolean): string => {\n    if (isRealized && isMapped) {\n        return (\n            \"The signal was emitted. Default handlers that animate, such as a button activate, settle \" +\n            \"asynchronously, so read the widget again rather than assuming the effect has landed.\"\n        );\n    }\n\n    return (\n        \"The signal was emitted on a widget that is not realized and mapped, so a default handler that \" +\n        \"requires a drawn widget does nothing. Present the containing window or open the containing \" +\n        \"popover first, then fire the signal again.\"\n    );\n};\n\nconst resolveRole = (value: string | number): Gtk.AccessibleRole | undefined => {\n    if (typeof value === \"number\") {\n        return value;\n    }\n\n    const resolved = Gtk.AccessibleRole[value.toUpperCase() as keyof typeof Gtk.AccessibleRole];\n\n    return typeof resolved === \"number\" ? resolved : undefined;\n};\n\nconst matchesOrEmpty = async (find: () => Promise<Gtk.Widget[]>): Promise<Gtk.Widget[]> => {\n    try {\n        return await find();\n    } catch {\n        return [];\n    }\n};\n\nfunction runRoleQuery(testing: TestingModule, app: Gtk.Application, params: QueryParams): Promise<Gtk.Widget[]> {\n    const roleValue = resolveRole(params.value);\n\n    if (roleValue === undefined) {\n        throw invalidRequestError(\n            `Unknown accessible role \"${String(params.value)}\"; use the lowercase role shown in the ` +\n            \"widget tree, e.g. \\\"button\\\", \\\"list\\\", \\\"list_item\\\", or \\\"checkbox\\\".\",\n        );\n    }\n\n    return matchesOrEmpty(() => testing.findAllByRole(app, roleValue, params.options));\n}\n\nfunction runTextQuery(testing: TestingModule, app: Gtk.Application, params: QueryParams): Promise<Gtk.Widget[]> {\n    return matchesOrEmpty(() => testing.findAllByText(app, String(params.value), params.options));\n}\n\nfunction runLabelTextQuery(testing: TestingModule, app: Gtk.Application, params: QueryParams): Promise<Gtk.Widget[]> {\n    return matchesOrEmpty(() => testing.findAllByLabelText(app, String(params.value), params.options));\n}\n\nasync function runNameQuery(\n    testing: TestingModule,\n    app: Gtk.Application,\n    params: QueryParams,\n): Promise<Gtk.Widget[]> {\n    const matches = await Promise.all([\n        matchesOrEmpty(() => testing.findAllByName(app, String(params.value), params.options)),\n        runLabelTextQuery(testing, app, params),\n        runTextQuery(testing, app, params),\n    ]);\n\n    return [...new Set(matches.flat())];\n}\n\nconst emptyQueryHint = (params: QueryParams): string =>\n    `Nothing matched by:\"${params.by}\" value:\"${String(params.value)}\", which compared ${SEARCHED_BY[params.by]}. ` +\n    \"Call gtkx_get_widget_tree to see what is mounted; by:\\\"name\\\" is the widest match, and by:\\\"role\\\" accepts \" +\n    \"options.name to match the accessible name of a known role.\";\n\nasync function handleQuery({ app, registry }: HandlerContext, params: QueryParams): Promise<unknown> {\n    const testing = await loadTestingModule();\n    const widgets = await QUERY_RUNNERS[params.by](testing, app, params);\n    const resolveId = (widget: Gtk.Widget): string => registry.getOrCreateId(widget);\n\n    return {\n        widgets: widgets.map((widget) => serializeWidget(widget, resolveId, testing, 0)),\n        searched: SEARCHED_BY[params.by],\n        ...(widgets.length === 0 && { hint: emptyQueryHint(params) }),\n    };\n}\n\nconst defaultScreenshotTarget = (registry: WidgetRegistry): Gtk.Widget => {\n    const [toplevel] = registry.toplevels();\n\n    if (!toplevel) {\n        throw new Error(\"No windows available for screenshot\");\n    }\n\n    return toplevel;\n};\n\nasync function handleScreenshot(\n    { registry }: HandlerContext,\n    params: ServerRequestParams<\"widget.screenshot\">,\n): Promise<unknown> {\n    const testing = await loadTestingModule();\n    const target = params.windowId ? requireWidget(registry, params.windowId) : defaultScreenshotTarget(registry);\n    const result = await testing.screenshot(target, { path: params.path });\n\n    if (params.path) {\n        return { data: result.data, mimeType: result.mimeType, savedPath: params.path };\n    }\n\n    return { data: result.data, mimeType: result.mimeType };\n}\n\nconst isServerInitiatedMethod = (method: string): method is ServerInitiatedMethod =>\n    Object.hasOwn(ServerRequestParamsSchemas, method);\n\nconst dispatch = async (method: string, params: unknown, ctx: HandlerContext): Promise<unknown> => {\n    if (!isServerInitiatedMethod(method)) {\n        throw methodNotFoundError(method);\n    }\n\n    return HANDLERS[method](ctx, params);\n};\n\nexport { dispatch };\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAOxC,QAAA,MAAe,cAAc,kBAJF,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,EAInB,aAAa,QAHlC,IAGkE,CAAC;AAsCnF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAOxC,QAAA,MAAe,cAAc,kBAJF,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,EAInB,aAAa,QAHlC,IAGkE,CAAC;AAuCnF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC"}

package/dist/mcp/index.js

@@ -1,5 +1,6 @@
 import { McpClient } from "./client.js";
 const { start: startMcpClient, stop: stopMcpClient } = createMcpClientController();
+/* eslint-disable-next-line unicorn/consistent-boolean-name -- the boolean reports whether connecting succeeded */
 async function connectQuietly(client) {
     try {
         await client.connect();

package/dist/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAOxC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,yBAAyB,EAAE,CAAC;AAEnF,KAAK,UAAU,cAAc,CAAC,MAAiB;IAC3C,IAAI,CAAC;QACD,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QAEvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED,SAAS,yBAAyB;IAC9B,IAAI,OAAO,GAAqB,IAAI,CAAC;IAErC,OAAO;QACH,KAAK,EAAE,KAAK,EAAE,aAAqB,EAAsB,EAAE;YACvD,IAAI,OAAO,EAAE,CAAC;gBACV,OAAO,OAAO,CAAC;YACnB,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC;YAChD,OAAO,GAAG,MAAM,CAAC;YACjB,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;YAE7B,OAAO,MAAM,CAAC;QAClB,CAAC;QACD,IAAI,EAAE,GAAS,EAAE;YACb,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,OAAO;YACX,CAAC;YAED,OAAO,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO,GAAG,IAAI,CAAC;QACnB,CAAC;KACJ,CAAC;AACN,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC","sourcesContent":["import { McpClient } from \"./client.js\";\n\ntype McpClientController = {\n    start: (applicationId: string) => Promise<McpClient>;\n    stop: () => void;\n};\n\nconst { start: startMcpClient, stop: stopMcpClient } = createMcpClientController();\n\nasync function connectQuietly(client: McpClient): Promise<boolean> {\n    try {\n        await client.connect();\n\n        return true;\n    } catch {\n        return false;\n    }\n}\n\nfunction createMcpClientController(): McpClientController {\n    let current: McpClient | null = null;\n\n    return {\n        start: async (applicationId: string): Promise<McpClient> => {\n            if (current) {\n                return current;\n            }\n\n            const client = new McpClient({ applicationId });\n            current = client;\n            await connectQuietly(client);\n\n            return client;\n        },\n        stop: (): void => {\n            if (!current) {\n                return;\n            }\n\n            current.disconnect();\n            current = null;\n        },\n    };\n}\n\nexport { startMcpClient, stopMcpClient };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAOxC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,yBAAyB,EAAE,CAAC;AAEnF,kHAAkH;AAClH,KAAK,UAAU,cAAc,CAAC,MAAiB;IAC3C,IAAI,CAAC;QACD,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QAEvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED,SAAS,yBAAyB;IAC9B,IAAI,OAAO,GAAqB,IAAI,CAAC;IAErC,OAAO;QACH,KAAK,EAAE,KAAK,EAAE,aAAqB,EAAsB,EAAE;YACvD,IAAI,OAAO,EAAE,CAAC;gBACV,OAAO,OAAO,CAAC;YACnB,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC;YAChD,OAAO,GAAG,MAAM,CAAC;YACjB,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;YAE7B,OAAO,MAAM,CAAC;QAClB,CAAC;QACD,IAAI,EAAE,GAAS,EAAE;YACb,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,OAAO;YACX,CAAC;YAED,OAAO,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO,GAAG,IAAI,CAAC;QACnB,CAAC;KACJ,CAAC;AACN,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC","sourcesContent":["import { McpClient } from \"./client.js\";\n\ntype McpClientController = {\n    start: (applicationId: string) => Promise<McpClient>;\n    stop: () => void;\n};\n\nconst { start: startMcpClient, stop: stopMcpClient } = createMcpClientController();\n\n/* eslint-disable-next-line unicorn/consistent-boolean-name -- the boolean reports whether connecting succeeded */\nasync function connectQuietly(client: McpClient): Promise<boolean> {\n    try {\n        await client.connect();\n\n        return true;\n    } catch {\n        return false;\n    }\n}\n\nfunction createMcpClientController(): McpClientController {\n    let current: McpClient | null = null;\n\n    return {\n        start: async (applicationId: string): Promise<McpClient> => {\n            if (current) {\n                return current;\n            }\n\n            const client = new McpClient({ applicationId });\n            current = client;\n            await connectQuietly(client);\n\n            return client;\n        },\n        stop: (): void => {\n            if (!current) {\n                return;\n            }\n\n            current.disconnect();\n            current = null;\n        },\n    };\n}\n\nexport { startMcpClient, stopMcpClient };\n"]}

package/dist/mcp/serialize-widget.d.ts

@@ -1,10 +1,11 @@
 import type * as Gtk from "@gtkx/gi/gtk";
-import type { SerializedWidget } from "@gtkx/mcp/internal";
+import { type SerializedWidget } from "@gtkx/mcp/internal";
 type WidgetIdResolver = (widget: Gtk.Widget) => string;
 type WidgetFormatting = {
     formatRole(role: Gtk.AccessibleRole): string;
-    getWidgetNodeText(widget: Gtk.Widget): string | null;
+    getTypeTag(widget: Gtk.Widget): string;
+    getWidgetText(widget: Gtk.Widget): string | null;
 };
 declare const serializeWidget: (widget: Gtk.Widget, resolveId: WidgetIdResolver, testing: WidgetFormatting, maxDepth?: number) => SerializedWidget;
-export { serializeWidget, type WidgetFormatting };
+export { serializeWidget };
 //# sourceMappingURL=serialize-widget.d.ts.map

package/dist/mcp/serialize-widget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize-widget.d.ts","sourceRoot":"","sources":["../../src/mcp/serialize-widget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,KAAK,gBAAgB,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC;AAEvD,KAAK,gBAAgB,GAAG;IACpB,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,cAAc,GAAG,MAAM,CAAC;IAC7C,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACxD,CAAC;AAEF,QAAA,MAAM,eAAe,GACjB,QAAQ,GAAG,CAAC,MAAM,EAClB,WAAW,gBAAgB,EAC3B,SAAS,gBAAgB,EACzB,iBAAmB,KACpB,gBAuBF,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"serialize-widget.d.ts","sourceRoot":"","sources":["../../src/mcp/serialize-widget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,EAA8C,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEvG,KAAK,gBAAgB,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC;AAEvD,KAAK,gBAAgB,GAAG;IACpB,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,cAAc,GAAG,MAAM,CAAC;IAC7C,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IACvC,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACpD,CAAC;AAyDF,QAAA,MAAM,eAAe,GACjB,QAAQ,GAAG,CAAC,MAAM,EAClB,WAAW,gBAAgB,EAC3B,SAAS,gBAAgB,EACzB,iBAAgC,KACjC,gBAkBF,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/mcp/serialize-widget.js

@@ -1,23 +1,53 @@
-const serializeWidget = (widget, resolveId, testing, maxDepth = Infinity) => {
+import { DEFAULT_SUBTREE_DEPTH, MAX_SUBTREE_WIDGETS } from "@gtkx/mcp/internal";
+const getChildren = (widget) => {
     const children = [];
-    if (maxDepth > 0) {
-        let child = widget.getFirstChild();
-        while (child) {
-            children.push(serializeWidget(child, resolveId, testing, maxDepth - 1));
-            child = child.getNextSibling();
-        }
+    let child = widget.getFirstChild();
+    while (child) {
+        children.push(child);
+        child = child.getNextSibling();
     }
-    return {
-        id: resolveId(widget),
-        type: widget.constructor.name,
-        role: testing.formatRole(widget.getAccessibleRole()),
-        name: widget.getName() || null,
-        text: testing.getWidgetNodeText(widget),
-        isSensitive: widget.getSensitive(),
-        isVisible: widget.getVisible(),
-        cssClasses: widget.getCssClasses(),
-        children,
+    return children;
+};
+const createNode = (widget, expansion) => ({
+    id: expansion.resolveId(widget),
+    type: expansion.testing.getTypeTag(widget),
+    role: expansion.testing.formatRole(widget.getAccessibleRole()),
+    name: widget.getName() || null,
+    text: expansion.testing.getWidgetText(widget),
+    isSensitive: widget.getSensitive(),
+    isVisible: widget.getVisible(),
+    cssClasses: widget.getCssClasses(),
+    children: [],
+});
+const expandNode = (expansion, parent) => {
+    const children = getChildren(parent.widget);
+    const canDescend = parent.depth < expansion.maxDepth;
+    const shownCount = canDescend ? Math.min(children.length, expansion.budget) : 0;
+    expansion.budget -= shownCount;
+    for (const child of children.slice(0, shownCount)) {
+        const node = createNode(child, expansion);
+        parent.node.children.push(node);
+        expansion.pending.push({ depth: parent.depth + 1, node, widget: child });
+    }
+    if (shownCount < children.length) {
+        parent.node.hiddenChildren = children.length - shownCount;
+    }
+};
+const serializeWidget = (widget, resolveId, testing, maxDepth = DEFAULT_SUBTREE_DEPTH) => {
+    const expansion = {
+        budget: MAX_SUBTREE_WIDGETS - 1,
+        maxDepth,
+        pending: [],
+        resolveId,
+        testing,
     };
+    const root = createNode(widget, expansion);
+    let parent = { depth: 0, node: root, widget };
+    while (parent !== undefined) {
+        expandNode(expansion, parent);
+        parent = expansion.pending.shift();
+    }
+    return root;
 };
 export { serializeWidget };
 //# sourceMappingURL=serialize-widget.js.map

package/dist/mcp/serialize-widget.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialize-widget.js","sourceRoot":"","sources":["../../src/mcp/serialize-widget.ts"],"names":[],"mappings":"AAUA,MAAM,eAAe,GAAG,CACpB,MAAkB,EAClB,SAA2B,EAC3B,OAAyB,EACzB,QAAQ,GAAG,QAAQ,EACH,EAAE;IAClB,MAAM,QAAQ,GAAuB,EAAE,CAAC;IAExC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACf,IAAI,KAAK,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;QAEnC,OAAO,KAAK,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;YACxE,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;QACnC,CAAC;IACL,CAAC;IAED,OAAO;QACH,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI;QAC7B,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;QACpD,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI;QAC9B,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC;QACvC,WAAW,EAAE,MAAM,CAAC,YAAY,EAAE;QAClC,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE;QAC9B,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE;QAClC,QAAQ;KACX,CAAC;AACN,CAAC,CAAC;AAEF,OAAO,EAAE,eAAe,EAAyB,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { SerializedWidget } from \"@gtkx/mcp/internal\";\n\ntype WidgetIdResolver = (widget: Gtk.Widget) => string;\n\ntype WidgetFormatting = {\n    formatRole(role: Gtk.AccessibleRole): string;\n    getWidgetNodeText(widget: Gtk.Widget): string | null;\n};\n\nconst serializeWidget = (\n    widget: Gtk.Widget,\n    resolveId: WidgetIdResolver,\n    testing: WidgetFormatting,\n    maxDepth = Infinity,\n): SerializedWidget => {\n    const children: SerializedWidget[] = [];\n\n    if (maxDepth > 0) {\n        let child = widget.getFirstChild();\n\n        while (child) {\n            children.push(serializeWidget(child, resolveId, testing, maxDepth - 1));\n            child = child.getNextSibling();\n        }\n    }\n\n    return {\n        id: resolveId(widget),\n        type: widget.constructor.name,\n        role: testing.formatRole(widget.getAccessibleRole()),\n        name: widget.getName() || null,\n        text: testing.getWidgetNodeText(widget),\n        isSensitive: widget.getSensitive(),\n        isVisible: widget.getVisible(),\n        cssClasses: widget.getCssClasses(),\n        children,\n    };\n};\n\nexport { serializeWidget, type WidgetFormatting };\n"]}
+{"version":3,"file":"serialize-widget.js","sourceRoot":"","sources":["../../src/mcp/serialize-widget.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { DEFAULT_SUBTREE_DEPTH, MAX_SUBTREE_WIDGETS, type SerializedWidget } from \"@gtkx/mcp/internal\";\n\ntype WidgetIdResolver = (widget: Gtk.Widget) => string;\n\ntype WidgetFormatting = {\n    formatRole(role: Gtk.AccessibleRole): string;\n    getTypeTag(widget: Gtk.Widget): string;\n    getWidgetText(widget: Gtk.Widget): string | null;\n};\n\ntype PendingWidget = {\n    depth: number;\n    node: SerializedWidget;\n    widget: Gtk.Widget;\n};\n\ntype Expansion = {\n    budget: number;\n    maxDepth: number;\n    pending: PendingWidget[];\n    resolveId: WidgetIdResolver;\n    testing: WidgetFormatting;\n};\n\nconst getChildren = (widget: Gtk.Widget): Gtk.Widget[] => {\n    const children: Gtk.Widget[] = [];\n    let child = widget.getFirstChild();\n\n    while (child) {\n        children.push(child);\n        child = child.getNextSibling();\n    }\n\n    return children;\n};\n\nconst createNode = (widget: Gtk.Widget, expansion: Expansion): SerializedWidget => ({\n    id: expansion.resolveId(widget),\n    type: expansion.testing.getTypeTag(widget),\n    role: expansion.testing.formatRole(widget.getAccessibleRole()),\n    name: widget.getName() || null,\n    text: expansion.testing.getWidgetText(widget),\n    isSensitive: widget.getSensitive(),\n    isVisible: widget.getVisible(),\n    cssClasses: widget.getCssClasses(),\n    children: [],\n});\n\nconst expandNode = (expansion: Expansion, parent: PendingWidget): void => {\n    const children = getChildren(parent.widget);\n    const canDescend = parent.depth < expansion.maxDepth;\n    const shownCount = canDescend ? Math.min(children.length, expansion.budget) : 0;\n    expansion.budget -= shownCount;\n\n    for (const child of children.slice(0, shownCount)) {\n        const node = createNode(child, expansion);\n        parent.node.children.push(node);\n        expansion.pending.push({ depth: parent.depth + 1, node, widget: child });\n    }\n\n    if (shownCount < children.length) {\n        parent.node.hiddenChildren = children.length - shownCount;\n    }\n};\n\nconst serializeWidget = (\n    widget: Gtk.Widget,\n    resolveId: WidgetIdResolver,\n    testing: WidgetFormatting,\n    maxDepth = DEFAULT_SUBTREE_DEPTH,\n): SerializedWidget => {\n    const expansion: Expansion = {\n        budget: MAX_SUBTREE_WIDGETS - 1,\n        maxDepth,\n        pending: [],\n        resolveId,\n        testing,\n    };\n\n    const root = createNode(widget, expansion);\n    let parent: PendingWidget | undefined = { depth: 0, node: root, widget };\n\n    while (parent !== undefined) {\n        expandNode(expansion, parent);\n        parent = expansion.pending.shift();\n    }\n\n    return root;\n};\n\nexport { serializeWidget };\n"]}

package/dist/mcp/testing-loader.d.ts

@@ -1,5 +1,8 @@
-type TestingModule = typeof import("@gtkx/testing");
+type TestingPublicModule = typeof import("@gtkx/testing");
+type TestingInternalModule = typeof import("@gtkx/testing/internal");
+type TestingModule = TestingPublicModule & Pick<TestingInternalModule, "getTypeTag">;
 type TestingModuleLoader = () => Promise<TestingModule>;
 declare const setTestingModuleLoader: (next: TestingModuleLoader | null) => void, loadTestingModule: () => Promise<TestingModule>;
-export { setTestingModuleLoader, loadTestingModule, type TestingModule, type TestingModuleLoader };
+declare function mergeTestingModule(publicApi: TestingPublicModule, internals: TestingInternalModule): TestingModule;
+export { setTestingModuleLoader, loadTestingModule, mergeTestingModule, type TestingInternalModule, type TestingModule, type TestingPublicModule, };
 //# sourceMappingURL=testing-loader.d.ts.map

package/dist/mcp/testing-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testing-loader.d.ts","sourceRoot":"","sources":["../../src/mcp/testing-loader.ts"],"names":[],"mappings":"AAAA,KAAK,aAAa,GAAG,cAAc,eAAe,CAAC,CAAC;AACpD,KAAK,mBAAmB,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;AAaxD,QAAA,MAAmB,sBAAsB,SAVnB,mBAAmB,GAAG,IAAI,KAAK,IAAI,EAUR,iBAAiB,QATlD,OAAO,CAAC,aAAa,CAS4D,CAAC;AA0DlG,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,CAAC"}
+{"version":3,"file":"testing-loader.d.ts","sourceRoot":"","sources":["../../src/mcp/testing-loader.ts"],"names":[],"mappings":"AAAA,KAAK,mBAAmB,GAAG,cAAc,eAAe,CAAC,CAAC;AAC1D,KAAK,qBAAqB,GAAG,cAAc,wBAAwB,CAAC,CAAC;AACrE,KAAK,aAAa,GAAG,mBAAmB,GAAG,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,CAAC;AACrF,KAAK,mBAAmB,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;AAaxD,QAAA,MAAmB,sBAAsB,SAVnB,mBAAmB,GAAG,IAAI,KAAK,IAAI,EAUR,iBAAiB,QATlD,OAAO,CAAC,aAAa,CAS4D,CAAC;AAElG,iBAAS,kBAAkB,CAAC,SAAS,EAAE,mBAAmB,EAAE,SAAS,EAAE,qBAAqB,GAAG,aAAa,CAE3G;AA4DD,OAAO,EACH,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,mBAAmB,GAC3B,CAAC"}

package/dist/mcp/testing-loader.js

@@ -1,6 +1,10 @@
 const { setLoader: setTestingModuleLoader, load: loadTestingModule } = createTestingModuleCache();
-function defaultLoader() {
-    return import("@gtkx/testing");
+function mergeTestingModule(publicApi, internals) {
+    return { ...publicApi, getTypeTag: internals.getTypeTag };
+}
+async function defaultLoader() {
+    const [publicApi, internals] = await Promise.all([import("@gtkx/testing"), import("@gtkx/testing/internal")]);
+    return mergeTestingModule(publicApi, internals);
 }
 function missingTestingPackageError(cause) {
     return new Error("@gtkx/testing is not installed, install it to enable MCP widget interactions: " +
@@ -43,5 +47,5 @@ function createTestingModuleCache() {
         load: () => loadCachedTestingModule(state),
     };
 }
-export { setTestingModuleLoader, loadTestingModule };
+export { setTestingModuleLoader, loadTestingModule, mergeTestingModule, };
 //# sourceMappingURL=testing-loader.js.map

package/dist/mcp/testing-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing-loader.js","sourceRoot":"","sources":["../../src/mcp/testing-loader.ts"],"names":[],"mappings":"AAcA,MAAM,EAAE,SAAS,EAAE,sBAAsB,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,wBAAwB,EAAE,CAAC;AAElG,SAAS,aAAa;IAClB,OAAO,MAAM,CAAC,eAAe,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAc;IAC9C,OAAO,IAAI,KAAK,CACZ,gFAAgF;QAChF,6CAA6C,MAAM,CAAC,KAAK,CAAC,GAAG,EAC7D,EAAE,KAAK,EAAE,CACZ,CAAC;AACN,CAAC;AAED,SAAS,aAAa,CAAC,KAAyB,EAAE,IAAgC;IAC9E,KAAK,CAAC,MAAM,GAAG,IAAI,IAAI,aAAa,CAAC;IACrC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,KAAyB;IACxD,IAAI,CAAC;QACD,KAAK,CAAC,aAAa,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;QAE3C,OAAO,KAAK,CAAC,aAAa,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,KAAK,CAAC,gBAAgB,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,KAAK,CAAC,gBAAgB,CAAC;IACjC,CAAC;AACL,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAyB;IACtD,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,wBAAwB;IAC7B,MAAM,KAAK,GAAuB;QAC9B,MAAM,EAAE,aAAa;QACrB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,IAAI;KACzB,CAAC;IAEF,OAAO;QACH,SAAS,EAAE,CAAC,IAAgC,EAAQ,EAAE;YAClD,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,EAAE,GAA2B,EAAE,CAAC,uBAAuB,CAAC,KAAK,CAAC;KACrE,CAAC;AACN,CAAC;AAED,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAgD,CAAC","sourcesContent":["type TestingModule = typeof import(\"@gtkx/testing\");\ntype TestingModuleLoader = () => Promise<TestingModule>;\n\ntype TestingModuleCache = {\n    setLoader: (next: TestingModuleLoader | null) => void;\n    load: () => Promise<TestingModule>;\n};\n\ntype TestingModuleState = {\n    loader: TestingModuleLoader;\n    testingModule: TestingModule | null;\n    testingLoadError: Error | null;\n};\n\nconst { setLoader: setTestingModuleLoader, load: loadTestingModule } = createTestingModuleCache();\n\nfunction defaultLoader(): Promise<TestingModule> {\n    return import(\"@gtkx/testing\");\n}\n\nfunction missingTestingPackageError(cause: unknown): Error {\n    return new Error(\n        \"@gtkx/testing is not installed, install it to enable MCP widget interactions: \" +\n        `pnpm add -D @gtkx/testing (import failed: ${String(cause)})`,\n        { cause },\n    );\n}\n\nfunction replaceLoader(state: TestingModuleState, next: TestingModuleLoader | null): void {\n    state.loader = next ?? defaultLoader;\n    state.testingModule = null;\n    state.testingLoadError = null;\n}\n\nasync function importTestingModule(state: TestingModuleState): Promise<TestingModule> {\n    try {\n        state.testingModule = await state.loader();\n\n        return state.testingModule;\n    } catch (error) {\n        state.testingLoadError = missingTestingPackageError(error);\n        throw state.testingLoadError;\n    }\n}\n\nfunction loadCachedTestingModule(state: TestingModuleState): Promise<TestingModule> {\n    if (state.testingModule) {\n        return Promise.resolve(state.testingModule);\n    }\n\n    if (state.testingLoadError) {\n        return Promise.reject(state.testingLoadError);\n    }\n\n    return importTestingModule(state);\n}\n\nfunction createTestingModuleCache(): TestingModuleCache {\n    const state: TestingModuleState = {\n        loader: defaultLoader,\n        testingModule: null,\n        testingLoadError: null,\n    };\n\n    return {\n        setLoader: (next: TestingModuleLoader | null): void => {\n            replaceLoader(state, next);\n        },\n        load: (): Promise<TestingModule> => loadCachedTestingModule(state),\n    };\n}\n\nexport { setTestingModuleLoader, loadTestingModule, type TestingModule, type TestingModuleLoader };\n"]}
+{"version":3,"file":"testing-loader.js","sourceRoot":"","sources":["../../src/mcp/testing-loader.ts"],"names":[],"mappings":"AAgBA,MAAM,EAAE,SAAS,EAAE,sBAAsB,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,wBAAwB,EAAE,CAAC;AAElG,SAAS,kBAAkB,CAAC,SAA8B,EAAE,SAAgC;IACxF,OAAO,EAAE,GAAG,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC;AAC9D,CAAC;AAED,KAAK,UAAU,aAAa;IACxB,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC;IAE9G,OAAO,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAc;IAC9C,OAAO,IAAI,KAAK,CACZ,gFAAgF;QAChF,6CAA6C,MAAM,CAAC,KAAK,CAAC,GAAG,EAC7D,EAAE,KAAK,EAAE,CACZ,CAAC;AACN,CAAC;AAED,SAAS,aAAa,CAAC,KAAyB,EAAE,IAAgC;IAC9E,KAAK,CAAC,MAAM,GAAG,IAAI,IAAI,aAAa,CAAC;IACrC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,KAAyB;IACxD,IAAI,CAAC;QACD,KAAK,CAAC,aAAa,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;QAE3C,OAAO,KAAK,CAAC,aAAa,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,KAAK,CAAC,gBAAgB,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,KAAK,CAAC,gBAAgB,CAAC;IACjC,CAAC;AACL,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAyB;IACtD,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,wBAAwB;IAC7B,MAAM,KAAK,GAAuB;QAC9B,MAAM,EAAE,aAAa;QACrB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,IAAI;KACzB,CAAC;IAEF,OAAO;QACH,SAAS,EAAE,CAAC,IAAgC,EAAQ,EAAE;YAClD,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,EAAE,GAA2B,EAAE,CAAC,uBAAuB,CAAC,KAAK,CAAC;KACrE,CAAC;AACN,CAAC;AAED,OAAO,EACH,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,GAIrB,CAAC","sourcesContent":["type TestingPublicModule = typeof import(\"@gtkx/testing\");\ntype TestingInternalModule = typeof import(\"@gtkx/testing/internal\");\ntype TestingModule = TestingPublicModule & Pick<TestingInternalModule, \"getTypeTag\">;\ntype TestingModuleLoader = () => Promise<TestingModule>;\n\ntype TestingModuleCache = {\n    setLoader: (next: TestingModuleLoader | null) => void;\n    load: () => Promise<TestingModule>;\n};\n\ntype TestingModuleState = {\n    loader: TestingModuleLoader;\n    testingModule: TestingModule | null;\n    testingLoadError: Error | null;\n};\n\nconst { setLoader: setTestingModuleLoader, load: loadTestingModule } = createTestingModuleCache();\n\nfunction mergeTestingModule(publicApi: TestingPublicModule, internals: TestingInternalModule): TestingModule {\n    return { ...publicApi, getTypeTag: internals.getTypeTag };\n}\n\nasync function defaultLoader(): Promise<TestingModule> {\n    const [publicApi, internals] = await Promise.all([import(\"@gtkx/testing\"), import(\"@gtkx/testing/internal\")]);\n\n    return mergeTestingModule(publicApi, internals);\n}\n\nfunction missingTestingPackageError(cause: unknown): Error {\n    return new Error(\n        \"@gtkx/testing is not installed, install it to enable MCP widget interactions: \" +\n        `pnpm add -D @gtkx/testing (import failed: ${String(cause)})`,\n        { cause },\n    );\n}\n\nfunction replaceLoader(state: TestingModuleState, next: TestingModuleLoader | null): void {\n    state.loader = next ?? defaultLoader;\n    state.testingModule = null;\n    state.testingLoadError = null;\n}\n\nasync function importTestingModule(state: TestingModuleState): Promise<TestingModule> {\n    try {\n        state.testingModule = await state.loader();\n\n        return state.testingModule;\n    } catch (error) {\n        state.testingLoadError = missingTestingPackageError(error);\n        throw state.testingLoadError;\n    }\n}\n\nfunction loadCachedTestingModule(state: TestingModuleState): Promise<TestingModule> {\n    if (state.testingModule) {\n        return Promise.resolve(state.testingModule);\n    }\n\n    if (state.testingLoadError) {\n        return Promise.reject(state.testingLoadError);\n    }\n\n    return importTestingModule(state);\n}\n\nfunction createTestingModuleCache(): TestingModuleCache {\n    const state: TestingModuleState = {\n        loader: defaultLoader,\n        testingModule: null,\n        testingLoadError: null,\n    };\n\n    return {\n        setLoader: (next: TestingModuleLoader | null): void => {\n            replaceLoader(state, next);\n        },\n        load: (): Promise<TestingModule> => loadCachedTestingModule(state),\n    };\n}\n\nexport {\n    setTestingModuleLoader,\n    loadTestingModule,\n    mergeTestingModule,\n    type TestingInternalModule,\n    type TestingModule,\n    type TestingPublicModule,\n};\n"]}

package/dist/mcp/widget-properties.d.ts

@@ -0,0 +1,6 @@
+import * as Gtk from "@gtkx/gi/gtk";
+import { type SerializedProperty } from "@gtkx/mcp/internal";
+import type { WidgetRegistry } from "./widget-registry.js";
+declare function readWidgetProperties(widget: Gtk.Widget, properties: string[], registry: WidgetRegistry): Record<string, SerializedProperty>;
+export { readWidgetProperties };
+//# sourceMappingURL=widget-properties.d.ts.map

package/dist/mcp/widget-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-properties.d.ts","sourceRoot":"","sources":["../../src/mcp/widget-properties.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAyB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAapF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAyH3D,iBAAS,oBAAoB,CACzB,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,EACpB,QAAQ,EAAE,cAAc,GACzB,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAUpC;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}