devlens-mcp 0.3.0 → 0.3.1

package/dist/src/platform/ios/simctl.d.ts

@@ -1,54 +0,0 @@
-/**
- * Wrapper around `xcrun simctl` for iOS Simulator interaction.
- */
-export declare class Simctl {
-    private deviceId;
-    constructor(deviceId: string);
-    /** Execute a simctl command */
-    exec(...args: string[]): Promise<string>;
-    /** Take a screenshot and return PNG buffer */
-    screenshot(): Promise<Buffer>;
-    /** Get the accessibility tree using simctl's accessibility audit */
-    getAccessibilityTree(): Promise<string>;
-    /**
-     * Fallback: Get view hierarchy by running a small XCTest snippet.
-     * This uses `simctl launch` with a debugger approach, but the simplest
-     * method is to use the accessibility description from the simulator.
-     */
-    private getViewHierarchyViaXctest;
-    /** Get device info from simctl */
-    getDeviceInfo(): Promise<{
-        name: string;
-        runtime: string;
-        state: string;
-    }>;
-    /** Get screen size of the simulator */
-    getScreenSize(): Promise<{
-        width: number;
-        height: number;
-    }>;
-    /** Tap at coordinates using simctl */
-    tap(x: number, y: number): Promise<void>;
-    /** Swipe on the simulator */
-    swipe(startX: number, startY: number, endX: number, endY: number): Promise<void>;
-    /** Type text using simctl keyboard input */
-    typeText(text: string): Promise<void>;
-    /** Press a key using simctl */
-    pressKey(key: string): Promise<void>;
-    /** Launch an app */
-    launchApp(bundleId: string): Promise<void>;
-    /** Terminate an app */
-    terminateApp(bundleId: string): Promise<void>;
-    /** Install an app (.app bundle or .ipa) */
-    installApp(path: string): Promise<void>;
-    /** List installed apps */
-    listApps(): Promise<Array<{
-        bundleId: string;
-        name: string;
-    }>>;
-    /** Open a URL */
-    openUrl(url: string): Promise<void>;
-    /** Set device orientation */
-    setOrientation(orientation: "portrait" | "landscape"): Promise<void>;
-}
-//# sourceMappingURL=simctl.d.ts.map

package/dist/src/platform/ios/simctl.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"simctl.d.ts","sourceRoot":"","sources":["../../../../src/platform/ios/simctl.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAEpC,+BAA+B;IACzB,IAAI,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAS9C,8CAA8C;IACxC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAUnC,oEAAoE;IAC9D,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;IAe7C;;;;OAIG;YACW,yBAAyB;IAcvC,kCAAkC;IAC5B,aAAa,IAAI,OAAO,CAAC;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IA2BF,uCAAuC;IACjC,aAAa,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAqBjE,sCAAsC;IAChC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB9C,6BAA6B;IACvB,KAAK,CACT,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC;IAgBhB,4CAA4C;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,+BAA+B;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,oBAAoB;IACd,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,uBAAuB;IACjB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,2CAA2C;IACrC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,0BAA0B;IACpB,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA6BpE,iBAAiB;IACX,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,6BAA6B;IACvB,cAAc,CAAC,WAAW,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAc3E"}

package/dist/src/platform/ios/simctl.js

@@ -1,192 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Simctl = void 0;
-const child_process_1 = require("child_process");
-const util_1 = require("util");
-const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
-/**
- * Wrapper around `xcrun simctl` for iOS Simulator interaction.
- */
-class Simctl {
-    deviceId;
-    constructor(deviceId) {
-        this.deviceId = deviceId;
-    }
-    /** Execute a simctl command */
-    async exec(...args) {
-        const { stdout } = await execFileAsync("xcrun", ["simctl", ...args], { maxBuffer: 10 * 1024 * 1024, timeout: 30000 });
-        return stdout;
-    }
-    /** Take a screenshot and return PNG buffer */
-    async screenshot() {
-        const tmpPath = `/tmp/devlens-screenshot-${Date.now()}.png`;
-        await this.exec("io", this.deviceId, "screenshot", tmpPath);
-        const { readFile, unlink } = await import("fs/promises");
-        const buffer = await readFile(tmpPath);
-        unlink(tmpPath).catch(() => { });
-        return buffer;
-    }
-    /** Get the accessibility tree using simctl's accessibility audit */
-    async getAccessibilityTree() {
-        // Use simctl ui to get the accessibility hierarchy
-        try {
-            const output = await this.exec("ui", this.deviceId, "accessibility");
-            return output;
-        }
-        catch {
-            // Fallback: use the description command for view hierarchy
-            return this.getViewHierarchyViaXctest();
-        }
-    }
-    /**
-     * Fallback: Get view hierarchy by running a small XCTest snippet.
-     * This uses `simctl launch` with a debugger approach, but the simplest
-     * method is to use the accessibility description from the simulator.
-     */
-    async getViewHierarchyViaXctest() {
-        // Use the simctl subprocess to query the UI
-        // We'll use `simctl ui <device> describe` to get the UI hierarchy
-        try {
-            const output = await this.exec("ui", this.deviceId, "describe");
-            return output;
-        }
-        catch {
-            throw new Error("Could not extract accessibility tree from iOS Simulator. " +
-                "Ensure the simulator is booted and has an app running.");
-        }
-    }
-    /** Get device info from simctl */
-    async getDeviceInfo() {
-        const { stdout } = await execFileAsync("xcrun", [
-            "simctl",
-            "list",
-            "devices",
-            "--json",
-        ]);
-        const data = JSON.parse(stdout);
-        for (const [runtime, devices] of Object.entries(data.devices)) {
-            for (const device of devices) {
-                if (device.udid === this.deviceId) {
-                    return {
-                        name: device.name,
-                        runtime: runtime
-                            .replace(/^com\.apple\.CoreSimulator\.SimRuntime\./, "")
-                            .replace(/-/g, "."),
-                        state: device.state,
-                    };
-                }
-            }
-        }
-        throw new Error(`Device ${this.deviceId} not found in simctl list`);
-    }
-    /** Get screen size of the simulator */
-    async getScreenSize() {
-        // Take a tiny screenshot and check its dimensions via sharp
-        const tmpPath = `/tmp/devlens-size-check-${Date.now()}.png`;
-        await this.exec("io", this.deviceId, "screenshot", tmpPath);
-        try {
-            const sharp = (await import("sharp")).default;
-            const metadata = await sharp(tmpPath).metadata();
-            const { unlink } = await import("fs/promises");
-            unlink(tmpPath).catch(() => { });
-            return {
-                width: metadata.width || 390,
-                height: metadata.height || 844,
-            };
-        }
-        catch {
-            // Fallback defaults (iPhone 14)
-            return { width: 390, height: 844 };
-        }
-    }
-    /** Tap at coordinates using simctl */
-    async tap(x, y) {
-        // simctl doesn't have a direct tap command, so we use the io command
-        // with the AppleScript approach or the simctl interact command
-        try {
-            await this.exec("io", this.deviceId, "tap", String(Math.round(x)), String(Math.round(y)));
-        }
-        catch {
-            // Fallback: use AppleScript to tap on the simulator
-            await execFileAsync("osascript", [
-                "-e",
-                `tell application "Simulator" to activate`,
-            ]);
-            // Use cliclick or similar for coordinate-based tapping
-            throw new Error("Direct tap not supported on this simctl version. Consider using a newer Xcode.");
-        }
-    }
-    /** Swipe on the simulator */
-    async swipe(startX, startY, endX, endY) {
-        try {
-            await this.exec("io", this.deviceId, "swipe", String(Math.round(startX)), String(Math.round(startY)), String(Math.round(endX)), String(Math.round(endY)));
-        }
-        catch {
-            throw new Error("Swipe not supported on this simctl version.");
-        }
-    }
-    /** Type text using simctl keyboard input */
-    async typeText(text) {
-        await this.exec("io", this.deviceId, "keyboard", "type", text);
-    }
-    /** Press a key using simctl */
-    async pressKey(key) {
-        await this.exec("io", this.deviceId, "keyboard", "key", key);
-    }
-    /** Launch an app */
-    async launchApp(bundleId) {
-        await this.exec("launch", this.deviceId, bundleId);
-    }
-    /** Terminate an app */
-    async terminateApp(bundleId) {
-        await this.exec("terminate", this.deviceId, bundleId);
-    }
-    /** Install an app (.app bundle or .ipa) */
-    async installApp(path) {
-        await this.exec("install", this.deviceId, path);
-    }
-    /** List installed apps */
-    async listApps() {
-        try {
-            const output = await this.exec("listapps", this.deviceId);
-            // Parse the plist/json output
-            const apps = [];
-            const bundleIdMatches = output.matchAll(/"CFBundleIdentifier"\s*=\s*"([^"]+)"/g);
-            const nameMatches = output.matchAll(/"CFBundleDisplayName"\s*=\s*"([^"]+)"/g);
-            const bundleIds = [...bundleIdMatches].map((m) => m[1]);
-            const names = [...nameMatches].map((m) => m[1]);
-            for (let i = 0; i < bundleIds.length; i++) {
-                apps.push({
-                    bundleId: bundleIds[i],
-                    name: names[i] || bundleIds[i],
-                });
-            }
-            return apps;
-        }
-        catch {
-            return [];
-        }
-    }
-    /** Open a URL */
-    async openUrl(url) {
-        await this.exec("openurl", this.deviceId, url);
-    }
-    /** Set device orientation */
-    async setOrientation(orientation) {
-        // simctl doesn't have a direct orientation command
-        // Use the Simulator menu via AppleScript
-        const rotation = orientation === "portrait" ? "0" : "90";
-        try {
-            await execFileAsync("osascript", [
-                "-e",
-                `tell application "System Events" to tell process "Simulator" to ` +
-                    `click menu item "Rotate ${orientation === "landscape" ? "Right" : "Left"}" of menu "Device" of menu bar 1`,
-            ]);
-        }
-        catch {
-            // Orientation setting may not be available in all environments
-        }
-    }
-}
-exports.Simctl = Simctl;
-//# sourceMappingURL=simctl.js.map

package/dist/src/platform/ios/simctl.js.map

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

package/dist/src/server.d.ts

@@ -1,3 +0,0 @@
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-export declare function startServer(): Promise<Server>;
-//# sourceMappingURL=server.d.ts.map

package/dist/src/server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAuCnE,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAsHnD"}

package/dist/src/server.js

@@ -1,176 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.startServer = startServer;
-const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
-const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
-const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
-const device_manager_js_1 = require("./platform/device-manager.js");
-const ref_registry_js_1 = require("./snapshot/ref-registry.js");
-const devlens_config_js_1 = require("./config/devlens-config.js");
-const ds_tools_js_1 = require("./tools/ds-tools.js");
-const device_tools_js_1 = require("./tools/device-tools.js");
-const snapshot_tools_js_1 = require("./tools/snapshot-tools.js");
-const interaction_tools_js_1 = require("./tools/interaction-tools.js");
-const screenshot_tools_js_1 = require("./tools/screenshot-tools.js");
-const app_tools_js_1 = require("./tools/app-tools.js");
-const metro_tools_js_1 = require("./tools/metro-tools.js");
-const navigation_tools_js_1 = require("./tools/navigation-tools.js");
-async function startServer() {
-    const server = new index_js_1.Server({
-        name: "devlens-mcp",
-        version: "0.3.0",
-    }, {
-        capabilities: {
-            tools: {},
-        },
-    });
-    // Load config (from DEVLENS_CONFIG env var or ./devlens.config.json)
-    const devlensConfig = await (0, devlens_config_js_1.loadDevLensConfig)();
-    // Shared state
-    const deviceManager = new device_manager_js_1.DeviceManager();
-    const refRegistry = new ref_registry_js_1.RefRegistry();
-    const metroPort = parseInt(process.env.METRO_PORT || "8081", 10);
-    // Create tool handlers
-    const dsHandlers = (0, ds_tools_js_1.createDsToolHandlers)(devlensConfig.designSystem);
-    const deviceHandlers = (0, device_tools_js_1.createDeviceToolHandlers)(deviceManager);
-    const { handlers: snapshotHandlers, resetPreviousSnapshot } = (0, snapshot_tools_js_1.createSnapshotToolHandlers)(deviceManager, refRegistry);
-    const interactionHandlers = (0, interaction_tools_js_1.createInteractionToolHandlers)(deviceManager, refRegistry, resetPreviousSnapshot);
-    const screenshotHandlers = (0, screenshot_tools_js_1.createScreenshotToolHandlers)(deviceManager, refRegistry);
-    const appHandlers = (0, app_tools_js_1.createAppToolHandlers)(deviceManager);
-    const metroHandlers = (0, metro_tools_js_1.createMetroToolHandlers)(metroPort, deviceManager);
-    const navigationHandlers = (0, navigation_tools_js_1.createNavigationToolHandlers)(deviceManager, refRegistry, resetPreviousSnapshot);
-    // Merge all tool schemas
-    const allSchemas = {
-        ...ds_tools_js_1.dsToolSchemas,
-        ...device_tools_js_1.deviceToolSchemas,
-        ...snapshot_tools_js_1.snapshotToolSchemas,
-        ...interaction_tools_js_1.interactionToolSchemas,
-        ...screenshot_tools_js_1.screenshotToolSchemas,
-        ...app_tools_js_1.appToolSchemas,
-        ...metro_tools_js_1.metroToolSchemas,
-        ...navigation_tools_js_1.navigationToolSchemas,
-    };
-    // Merge all handlers
-    const allHandlers = {
-        ...dsHandlers,
-        ...deviceHandlers,
-        ...snapshotHandlers,
-        ...interactionHandlers,
-        ...screenshotHandlers,
-        ...appHandlers,
-        ...metroHandlers,
-        ...navigationHandlers,
-    };
-    // Register tools/list handler
-    server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
-        return {
-            tools: Object.entries(allSchemas).map(([name, schema]) => ({
-                name,
-                description: schema.description,
-                inputSchema: zodToJsonSchema(schema.parameters),
-            })),
-        };
-    });
-    // Register tools/call handler
-    server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
-        const { name, arguments: args } = request.params;
-        const handler = allHandlers[name];
-        if (!handler) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `Unknown tool: ${name}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-        try {
-            // Validate params with Zod schema
-            const schema = allSchemas[name];
-            const validatedArgs = schema.parameters.parse(args || {});
-            return await handler(validatedArgs);
-        }
-        catch (error) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `Error: ${error.message || String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
-    // Connect via stdio transport
-    const transport = new stdio_js_1.StdioServerTransport();
-    await server.connect(transport);
-    return server;
-}
-/**
- * Convert a Zod schema to JSON Schema for MCP tool registration.
- * This is a simplified converter that handles the common cases.
- */
-function zodToJsonSchema(schema) {
-    // Use Zod's built-in JSON schema support if available
-    if (schema._def) {
-        return convertZodDef(schema._def);
-    }
-    return { type: "object", properties: {} };
-}
-function convertZodDef(def) {
-    switch (def.typeName) {
-        case "ZodObject": {
-            const properties = {};
-            const required = [];
-            for (const [key, value] of Object.entries(def.shape())) {
-                const propDef = value._def;
-                if (propDef.typeName === "ZodOptional" || propDef.typeName === "ZodDefault") {
-                    properties[key] = convertZodDef(propDef.typeName === "ZodDefault" ? propDef.innerType._def : propDef.innerType._def);
-                }
-                else {
-                    properties[key] = convertZodDef(propDef);
-                    required.push(key);
-                }
-                // Add description from Zod describe()
-                if (propDef.description) {
-                    properties[key].description = propDef.description;
-                }
-                else if (value.description) {
-                    properties[key].description = value.description;
-                }
-            }
-            return {
-                type: "object",
-                properties,
-                ...(required.length > 0 ? { required } : {}),
-            };
-        }
-        case "ZodString":
-            return { type: "string", ...(def.description ? { description: def.description } : {}) };
-        case "ZodNumber":
-            return { type: "number", ...(def.description ? { description: def.description } : {}) };
-        case "ZodBoolean":
-            return { type: "boolean", ...(def.description ? { description: def.description } : {}) };
-        case "ZodEnum":
-            return { type: "string", enum: def.values, ...(def.description ? { description: def.description } : {}) };
-        case "ZodArray":
-            return {
-                type: "array",
-                items: convertZodDef(def.type._def),
-                ...(def.description ? { description: def.description } : {}),
-            };
-        case "ZodDefault":
-            return {
-                ...convertZodDef(def.innerType._def),
-                default: def.defaultValue(),
-            };
-        case "ZodOptional":
-            return convertZodDef(def.innerType._def);
-        default:
-            return {};
-    }
-}
-//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

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

package/dist/src/snapshot/formatter.d.ts

@@ -1,18 +0,0 @@
-import type { SnapshotNode } from "../platform/device.js";
-/**
- * Formats a SnapshotNode tree into a YAML-like text representation
- * that LLMs can easily parse and reason about.
- *
- * Output format (inspired by Playwright MCP):
- *
- * - FrameLayout
- *   - LinearLayout
- *     - TextView "Hello World" [ref=e1]
- *     - Button "Submit" [ref=e2]
- *     - EditText "Email" [ref=e3] [focused]
- *   - RecyclerView [ref=e4]
- *     - CardView
- *       - TextView "Item 1" [ref=e5]
- */
-export declare function formatSnapshot(root: SnapshotNode, nodeToRef: Map<SnapshotNode, string>): string;
-//# sourceMappingURL=formatter.d.ts.map

package/dist/src/snapshot/formatter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../../src/snapshot/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,GACnC,MAAM,CAIR"}

package/dist/src/snapshot/formatter.js

@@ -1,86 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatSnapshot = formatSnapshot;
-/**
- * Formats a SnapshotNode tree into a YAML-like text representation
- * that LLMs can easily parse and reason about.
- *
- * Output format (inspired by Playwright MCP):
- *
- * - FrameLayout
- *   - LinearLayout
- *     - TextView "Hello World" [ref=e1]
- *     - Button "Submit" [ref=e2]
- *     - EditText "Email" [ref=e3] [focused]
- *   - RecyclerView [ref=e4]
- *     - CardView
- *       - TextView "Item 1" [ref=e5]
- */
-function formatSnapshot(root, nodeToRef) {
-    const lines = [];
-    formatNode(root, nodeToRef, 0, lines);
-    return lines.join("\n");
-}
-function formatNode(node, nodeToRef, depth, lines) {
-    const indent = "  ".repeat(depth);
-    const parts = [];
-    // Type
-    parts.push(node.type);
-    // Text content
-    if (node.text) {
-        parts.push(`"${truncate(node.text, 60)}"`);
-    }
-    // Accessibility label (if different from text)
-    if (node.label && node.label !== node.text) {
-        parts.push(`label="${truncate(node.label, 40)}"`);
-    }
-    // Annotations
-    const annotations = [];
-    // Ref
-    const ref = nodeToRef.get(node);
-    if (ref) {
-        annotations.push(`ref=${ref}`);
-    }
-    // State annotations
-    if (node.focused)
-        annotations.push("focused");
-    if (node.value)
-        annotations.push(`value="${node.value}"`);
-    if (node.enabled === false)
-        annotations.push("disabled");
-    if (node.resourceId) {
-        const shortId = node.resourceId.includes("/")
-            ? node.resourceId.split("/").pop()
-            : node.resourceId;
-        annotations.push(`id="${shortId}"`);
-    }
-    if (annotations.length > 0) {
-        parts.push(`[${annotations.join("] [")}]`);
-    }
-    // Build the line
-    const line = `${indent}- ${parts.join(" ")}`;
-    // Only include nodes that have refs, text, labels, or children with refs
-    if (ref || node.text || node.label || hasRefInSubtree(node, nodeToRef)) {
-        lines.push(line);
-    }
-    // Recurse into children
-    for (const child of node.children) {
-        formatNode(child, nodeToRef, depth + 1, lines);
-    }
-}
-/** Check if any descendant has a ref assigned */
-function hasRefInSubtree(node, nodeToRef) {
-    for (const child of node.children) {
-        if (nodeToRef.has(child))
-            return true;
-        if (hasRefInSubtree(child, nodeToRef))
-            return true;
-    }
-    return false;
-}
-function truncate(str, maxLen) {
-    if (str.length <= maxLen)
-        return str;
-    return str.slice(0, maxLen - 3) + "...";
-}
-//# sourceMappingURL=formatter.js.map

package/dist/src/snapshot/formatter.js.map

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

package/dist/src/snapshot/ref-registry.d.ts

@@ -1,67 +0,0 @@
-import type { SnapshotNode, Bounds } from "../platform/device.js";
-/**
- * RefRegistry — the Playwright-style ref assignment system.
- *
- * Assigns monotonically increasing refs (e1, e2, ...) to every interactive
- * or meaningful node in the accessibility tree. Maintains a map from ref
- * to node info (bounds, center coords) so interaction tools can resolve
- * "tap ref=e5" to actual screen coordinates.
- */
-export interface RefEntry {
-    ref: string;
-    node: SnapshotNode;
-    centerX: number;
-    centerY: number;
-    bounds: Bounds;
-}
-export interface ValidationIssue {
-    type: "zero-size" | "invisible" | "empty-container";
-    nodeType: string;
-    text?: string;
-    label?: string;
-    resourceId?: string;
-    bounds: Bounds;
-    detail: string;
-}
-export interface ValidationReport {
-    issues: ValidationIssue[];
-    totalNodes: number;
-    visibleNodes: number;
-    zeroSizeNodes: number;
-    interactiveNodes: number;
-}
-export declare class RefRegistry {
-    private refMap;
-    private counter;
-    /** Clear all refs and reset counter (call before each new snapshot) */
-    reset(): void;
-    /**
-     * Walk the snapshot tree and assign refs to all interactive or content-bearing nodes.
-     * Returns a new tree with refs attached (as annotations in the formatter output).
-     */
-    assignRefs(root: SnapshotNode): Map<SnapshotNode, string>;
-    private walkAndAssign;
-    /** Determine if a node should get a ref */
-    private shouldAssignRef;
-    /** Resolve a ref string to its entry (coordinates + node info) */
-    resolve(ref: string): RefEntry | undefined;
-    /** Get all current ref entries */
-    getAllRefs(): RefEntry[];
-    /** Get the total number of assigned refs */
-    get size(): number;
-    /**
-     * Validate the snapshot tree for visibility issues.
-     * Flags zero-size elements that should be visible, explicitly invisible elements,
-     * and empty containers that might indicate missing content.
-     */
-    validateTree(root: SnapshotNode): ValidationReport;
-    /**
-     * Search the full snapshot tree (including zero-size nodes) for text/label matches.
-     * Used by find_element to detect invisible elements that the refMap skips.
-     */
-    findInTree(root: SnapshotNode, query: {
-        text?: string;
-        label?: string;
-    }): SnapshotNode[];
-}
-//# sourceMappingURL=ref-registry.d.ts.map

package/dist/src/snapshot/ref-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ref-registry.d.ts","sourceRoot":"","sources":["../../../src/snapshot/ref-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAElE;;;;;;;GAOG;AAEH,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,iBAAiB,CAAC;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,OAAO,CAAa;IAE5B,uEAAuE;IACvE,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC;IAOzD,OAAO,CAAC,aAAa;IAwBrB,2CAA2C;IAC3C,OAAO,CAAC,eAAe;IAiBvB,kEAAkE;IAClE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAI1C,kCAAkC;IAClC,UAAU,IAAI,QAAQ,EAAE;IAIxB,4CAA4C;IAC5C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,gBAAgB;IA4ElD;;;OAGG;IACH,UAAU,CACR,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACvC,YAAY,EAAE;CA0BlB"}