devlens-mcp 0.4.1 → 0.5.2

package/dist/src/platform/simulator-factory.js

@@ -0,0 +1,396 @@
+"use strict";
+/**
+ * SimulatorFactory — create, boot, and shutdown iOS Simulators and Android
+ * Emulators on demand from DeviceProfile definitions.
+ *
+ * DevLens-created devices are prefixed with "DevLens-" (iOS) or "devlens-"
+ * (Android) for easy identification and cleanup.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimulatorFactory = void 0;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const ios_device_js_1 = require("./ios/ios-device.js");
+const android_device_js_1 = require("./android/android-device.js");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+const DEVLENS_PREFIX_IOS = "DevLens-";
+const DEVLENS_PREFIX_ANDROID = "devlens-";
+// ─── Factory ──────────────────────────────────────────────────────────────
+class SimulatorFactory {
+    createdDeviceIds = new Set();
+    // ── iOS ─────────────────────────────────────────────────────────────
+    /**
+     * Find an existing iOS simulator matching the profile's device type,
+     * or create a new one. Returns the UDID.
+     */
+    async ensureIosSimulator(profile) {
+        if (!profile.simctlDeviceType) {
+            throw new Error(`Profile "${profile.id}" has no simctlDeviceType`);
+        }
+        // List all devices
+        const { stdout } = await execFileAsync("xcrun", [
+            "simctl", "list", "devices", "--json",
+        ]);
+        const data = JSON.parse(stdout);
+        // Search for existing device matching the device type
+        for (const deviceList of Object.values(data.devices)) {
+            for (const device of deviceList) {
+                if (device.deviceTypeIdentifier === profile.simctlDeviceType) {
+                    return {
+                        udid: device.udid,
+                        created: false,
+                        alreadyBooted: device.state === "Booted",
+                    };
+                }
+            }
+        }
+        // No matching device found — create one
+        const runtime = await this.getLatestIosRuntime();
+        const simName = `${DEVLENS_PREFIX_IOS}${profile.name}`;
+        const { stdout: udid } = await execFileAsync("xcrun", [
+            "simctl", "create", simName,
+            profile.simctlDeviceType,
+            runtime,
+        ]);
+        const newUdid = udid.trim();
+        this.createdDeviceIds.add(newUdid);
+        return { udid: newUdid, created: true, alreadyBooted: false };
+    }
+    /**
+     * Boot an iOS simulator by UDID and wait until it's fully ready.
+     */
+    async bootIosSimulator(udid, timeoutMs = 120_000) {
+        // Check if already booted
+        if (await this.isIosBooted(udid))
+            return;
+        await execFileAsync("xcrun", ["simctl", "boot", udid]);
+        // Wait for boot to complete (bootstatus blocks until springboard is up)
+        await execFileAsync("xcrun", ["simctl", "bootstatus", udid], {
+            timeout: timeoutMs,
+        });
+    }
+    /** Check if an iOS simulator is booted. */
+    async isIosBooted(udid) {
+        try {
+            const { stdout } = await execFileAsync("xcrun", [
+                "simctl", "list", "devices", "--json",
+            ]);
+            const data = JSON.parse(stdout);
+            for (const deviceList of Object.values(data.devices)) {
+                const found = deviceList.find((d) => d.udid === udid);
+                if (found)
+                    return found.state === "Booted";
+            }
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Shutdown an iOS simulator. */
+    async shutdownIos(udid) {
+        try {
+            await execFileAsync("xcrun", ["simctl", "shutdown", udid], {
+                timeout: 15_000,
+            });
+        }
+        catch {
+            // Already shut down or not found — ignore
+        }
+    }
+    /** Delete an iOS simulator (only if created by DevLens). */
+    async deleteIosSimulator(udid) {
+        await this.shutdownIos(udid);
+        try {
+            await execFileAsync("xcrun", ["simctl", "delete", udid], {
+                timeout: 15_000,
+            });
+        }
+        catch {
+            // Already deleted — ignore
+        }
+        this.createdDeviceIds.delete(udid);
+    }
+    /** Get the latest installed iOS runtime. */
+    async getLatestIosRuntime() {
+        const { stdout } = await execFileAsync("xcrun", [
+            "simctl", "list", "runtimes", "--json",
+        ]);
+        const data = JSON.parse(stdout);
+        const iosRuntimes = data.runtimes.filter((r) => r.isAvailable && r.identifier.includes("iOS"));
+        if (iosRuntimes.length === 0) {
+            throw new Error("No iOS runtimes installed. Install via Xcode → Settings → Platforms.");
+        }
+        // Return the last one (newest)
+        return iosRuntimes[iosRuntimes.length - 1].identifier;
+    }
+    // ── Android ─────────────────────────────────────────────────────────
+    /**
+     * Find an existing Android AVD matching the profile, or create one.
+     * Returns the AVD name.
+     */
+    async ensureAndroidAvd(profile) {
+        if (!profile.avdDeviceId) {
+            throw new Error(`Profile "${profile.id}" has no avdDeviceId`);
+        }
+        const avdName = `${DEVLENS_PREFIX_ANDROID}${profile.id}`;
+        // Check if AVD already exists
+        try {
+            const emulatorPath = this.getEmulatorPath();
+            const { stdout } = await execFileAsync(emulatorPath, ["-list-avds"]);
+            const avds = stdout.split("\n").map((l) => l.trim()).filter(Boolean);
+            if (avds.includes(avdName)) {
+                return { avdName, created: false };
+            }
+        }
+        catch {
+            // emulator not found — will fail later with clear error
+        }
+        // Create the AVD
+        const systemImage = await this.getLatestAndroidSystemImage();
+        const avdManagerPath = this.getAvdManagerPath();
+        await execFileAsync(avdManagerPath, [
+            "create", "avd",
+            "-n", avdName,
+            "-k", systemImage,
+            "--device", profile.avdDeviceId,
+            "--force",
+        ], { timeout: 60_000 });
+        this.createdDeviceIds.add(avdName);
+        return { avdName, created: true };
+    }
+    /**
+     * Boot an Android emulator by AVD name.
+     * Returns the serial number (e.g. "emulator-5554").
+     */
+    async bootAndroidEmulator(avdName, timeoutMs = 180_000) {
+        // Check if already running
+        const running = await this.findRunningAndroidEmulator(avdName);
+        if (running)
+            return running;
+        const port = await this.findFreeEmulatorPort();
+        const emulatorPath = this.getEmulatorPath();
+        // Spawn emulator in background (non-blocking)
+        const proc = (0, child_process_1.spawn)(emulatorPath, [
+            "-avd", avdName,
+            "-port", String(port),
+            "-no-boot-anim",
+            "-no-audio",
+            "-read-only",
+        ], {
+            detached: true,
+            stdio: "ignore",
+        });
+        proc.unref();
+        const serial = `emulator-${port}`;
+        // Poll adb until the device is online and booted
+        const adbPath = this.getAdbPath();
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            try {
+                const { stdout } = await execFileAsync(adbPath, [
+                    "-s", serial, "shell", "getprop", "sys.boot_completed",
+                ], { timeout: 5000 });
+                if (stdout.trim() === "1")
+                    return serial;
+            }
+            catch {
+                // Not ready yet
+            }
+            await this.sleep(2000);
+        }
+        throw new Error(`Android emulator "${avdName}" did not boot within ${timeoutMs / 1000}s`);
+    }
+    /** Find serial of a running emulator by AVD name. */
+    async findRunningAndroidEmulator(avdName) {
+        try {
+            const adbPath = this.getAdbPath();
+            const { stdout } = await execFileAsync(adbPath, ["devices", "-l"]);
+            for (const line of stdout.split("\n")) {
+                const match = line.match(/^(emulator-\d+)\s+device/);
+                if (match) {
+                    const serial = match[1];
+                    try {
+                        const { stdout: name } = await execFileAsync(adbPath, [
+                            "-s", serial, "shell",
+                            "getprop", "ro.boot.qemu.avd_name",
+                        ], { timeout: 5000 });
+                        if (name.trim() === avdName)
+                            return serial;
+                    }
+                    catch {
+                        // Not this one
+                    }
+                }
+            }
+        }
+        catch {
+            // No adb — fall through
+        }
+        return null;
+    }
+    /** Find the next free emulator console port (even number starting at 5554). */
+    async findFreeEmulatorPort() {
+        const adbPath = this.getAdbPath();
+        const usedPorts = new Set();
+        try {
+            const { stdout } = await execFileAsync(adbPath, ["devices"]);
+            for (const line of stdout.split("\n")) {
+                const match = line.match(/^emulator-(\d+)/);
+                if (match)
+                    usedPorts.add(parseInt(match[1]));
+            }
+        }
+        catch {
+            // No emulators running
+        }
+        for (let port = 5554; port <= 5584; port += 2) {
+            if (!usedPorts.has(port))
+                return port;
+        }
+        throw new Error("No free emulator ports available (5554-5584 all in use)");
+    }
+    /** Shutdown an Android emulator by serial. */
+    async shutdownAndroid(serial) {
+        try {
+            const adbPath = this.getAdbPath();
+            await execFileAsync(adbPath, ["-s", serial, "emu", "kill"], {
+                timeout: 15_000,
+            });
+        }
+        catch {
+            // Already dead — ignore
+        }
+    }
+    /** Get the latest installed Android system image. */
+    async getLatestAndroidSystemImage() {
+        const sdkManagerPath = this.getSdkManagerPath();
+        try {
+            const { stdout } = await execFileAsync(sdkManagerPath, [
+                "--list_installed",
+            ], { timeout: 30_000 });
+            const images = stdout
+                .split("\n")
+                .map((l) => l.trim())
+                .filter((l) => l.startsWith("system-images;"));
+            if (images.length > 0) {
+                // Pick the latest (last in sorted order)
+                const sorted = images.sort();
+                return sorted[sorted.length - 1].split(/\s+/)[0];
+            }
+        }
+        catch {
+            // sdkmanager not available
+        }
+        throw new Error("No Android system images installed. Run:\n" +
+            '  sdkmanager "system-images;android-34;google_apis;arm64-v8a"');
+    }
+    // ── Shared / Public ─────────────────────────────────────────────────
+    /**
+     * Boot a device from a profile. Returns a fully initialized BootedDevice.
+     * Handles both iOS and Android based on profile.platform.
+     */
+    async bootFromProfile(profile) {
+        if (profile.platform === "ios") {
+            const { udid, created, alreadyBooted } = await this.ensureIosSimulator(profile);
+            if (!alreadyBooted) {
+                await this.bootIosSimulator(udid);
+            }
+            return {
+                id: udid,
+                profile,
+                device: new ios_device_js_1.IosDevice(udid),
+                createdByDevLens: created,
+                wasAlreadyBooted: alreadyBooted,
+            };
+        }
+        else {
+            const { avdName, created } = await this.ensureAndroidAvd(profile);
+            const serial = await this.bootAndroidEmulator(avdName);
+            return {
+                id: serial,
+                profile,
+                device: new android_device_js_1.AndroidDevice(serial),
+                createdByDevLens: created,
+                wasAlreadyBooted: false, // Android boot always goes through us
+            };
+        }
+    }
+    /**
+     * Shutdown a device. Only shuts down if it wasn't already booted
+     * before DevLens touched it.
+     */
+    async shutdownDevice(booted) {
+        if (booted.wasAlreadyBooted)
+            return; // Don't touch user's device
+        if (booted.profile.platform === "ios") {
+            await this.shutdownIos(booted.id);
+        }
+        else {
+            await this.shutdownAndroid(booted.id);
+        }
+    }
+    /**
+     * Shutdown and optionally delete all devices created by DevLens.
+     */
+    async cleanupAll(deleteCreated = false) {
+        const cleaned = [];
+        for (const id of this.createdDeviceIds) {
+            try {
+                // Determine platform from prefix
+                if (id.startsWith(DEVLENS_PREFIX_ANDROID) || id.startsWith("devlens-")) {
+                    // Android AVD — find running serial and kill
+                    const serial = await this.findRunningAndroidEmulator(id);
+                    if (serial)
+                        await this.shutdownAndroid(serial);
+                    cleaned.push(id);
+                }
+                else {
+                    // iOS simulator UDID
+                    if (deleteCreated) {
+                        await this.deleteIosSimulator(id);
+                    }
+                    else {
+                        await this.shutdownIos(id);
+                    }
+                    cleaned.push(id);
+                }
+            }
+            catch {
+                // Best effort
+            }
+        }
+        this.createdDeviceIds.clear();
+        return cleaned;
+    }
+    /** Get IDs of all devices created by DevLens in this session. */
+    get createdDevices() {
+        return Array.from(this.createdDeviceIds);
+    }
+    // ── Path helpers ────────────────────────────────────────────────────
+    getAdbPath() {
+        const androidHome = process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT;
+        return androidHome ? `${androidHome}/platform-tools/adb` : "adb";
+    }
+    getEmulatorPath() {
+        const androidHome = process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT;
+        return androidHome ? `${androidHome}/emulator/emulator` : "emulator";
+    }
+    getAvdManagerPath() {
+        const androidHome = process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT;
+        return androidHome
+            ? `${androidHome}/cmdline-tools/latest/bin/avdmanager`
+            : "avdmanager";
+    }
+    getSdkManagerPath() {
+        const androidHome = process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT;
+        return androidHome
+            ? `${androidHome}/cmdline-tools/latest/bin/sdkmanager`
+            : "sdkmanager";
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+exports.SimulatorFactory = SimulatorFactory;
+//# sourceMappingURL=simulator-factory.js.map

package/dist/src/platform/simulator-factory.js.map

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

package/dist/src/platform/system-resources.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Detect system resources (RAM, CPU) and calculate optimal batch sizes
+ * for multi-device operations. Ensures DevLens doesn't overwhelm
+ * machines with limited resources (e.g. 16GB MacBooks).
+ */
+export interface SystemProfile {
+    totalMemoryGB: number;
+    freeMemoryGB: number;
+    cpuCores: number;
+    platform: NodeJS.Platform;
+}
+export interface BatchConfig {
+    /** Max iOS simulators to boot simultaneously in one batch */
+    iosBatchSize: number;
+    /** Max Android emulators to boot simultaneously in one batch */
+    androidBatchSize: number;
+    /** Delay between individual boot commands within a batch (ms) */
+    delayBetweenBootsMs: number;
+    /** Delay between batches to let RAM reclaim (ms) */
+    delayBetweenBatchesMs: number;
+    /** Pause booting if memory usage exceeds this % */
+    memoryThresholdPercent: number;
+}
+/**
+ * Read current system resource profile.
+ */
+export declare function getSystemProfile(): SystemProfile;
+/**
+ * Calculate optimal batch sizes based on available resources.
+ *
+ * @param profile - Current system profile
+ * @param alreadyBooted - Number of devices already running (don't count toward limits)
+ */
+export declare function calculateBatchConfig(profile: SystemProfile, alreadyBooted?: number): BatchConfig;
+/**
+ * Check if current memory usage is below the safe threshold.
+ * Returns true if it's safe to boot more devices.
+ */
+export declare function isMemorySafe(thresholdPercent?: number): boolean;
+/**
+ * Format system profile as a human-readable summary string.
+ */
+export declare function formatSystemInfo(profile: SystemProfile): string;
+//# sourceMappingURL=system-resources.d.ts.map

package/dist/src/platform/system-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-resources.d.ts","sourceRoot":"","sources":["../../../src/platform/system-resources.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oDAAoD;IACpD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAID;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAOhD;AAID;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,aAAa,SAAI,GAChB,WAAW,CAkDb;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,gBAAgB,SAAK,GAAG,OAAO,CAK3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAM/D"}

package/dist/src/platform/system-resources.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * Detect system resources (RAM, CPU) and calculate optimal batch sizes
+ * for multi-device operations. Ensures DevLens doesn't overwhelm
+ * machines with limited resources (e.g. 16GB MacBooks).
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSystemProfile = getSystemProfile;
+exports.calculateBatchConfig = calculateBatchConfig;
+exports.isMemorySafe = isMemorySafe;
+exports.formatSystemInfo = formatSystemInfo;
+const os_1 = __importDefault(require("os"));
+// ─── System Detection ─────────────────────────────────────────────────────
+/**
+ * Read current system resource profile.
+ */
+function getSystemProfile() {
+    return {
+        totalMemoryGB: os_1.default.totalmem() / (1024 ** 3),
+        freeMemoryGB: os_1.default.freemem() / (1024 ** 3),
+        cpuCores: os_1.default.cpus().length,
+        platform: os_1.default.platform(),
+    };
+}
+// ─── Batch Calculation ────────────────────────────────────────────────────
+/**
+ * Calculate optimal batch sizes based on available resources.
+ *
+ * @param profile - Current system profile
+ * @param alreadyBooted - Number of devices already running (don't count toward limits)
+ */
+function calculateBatchConfig(profile, alreadyBooted = 0) {
+    const free = profile.freeMemoryGB;
+    const cores = profile.cpuCores;
+    // Each iOS sim ≈ 1.3-2GB, each Android emu ≈ 2.5-4GB
+    // Leave ~4GB headroom for OS + Xcode/Studio
+    let iosBatch;
+    let androidBatch;
+    let bootDelay;
+    let batchDelay;
+    if (free < 6) {
+        // Very tight — sequential only
+        iosBatch = 1;
+        androidBatch = 1;
+        bootDelay = 0;
+        batchDelay = 3000;
+    }
+    else if (free < 10) {
+        // 16GB Mac typical (6-10GB free)
+        iosBatch = cores < 6 ? 2 : 3;
+        androidBatch = cores < 6 ? 1 : 2;
+        bootDelay = 500;
+        batchDelay = 2000;
+    }
+    else if (free < 18) {
+        // 32GB Mac or lightly loaded (10-18GB free)
+        iosBatch = cores < 8 ? 3 : 4;
+        androidBatch = cores < 8 ? 2 : 3;
+        bootDelay = 300;
+        batchDelay = 1500;
+    }
+    else {
+        // 64GB+ or very free system
+        iosBatch = cores < 8 ? 4 : 6;
+        androidBatch = cores < 8 ? 3 : 4;
+        bootDelay = 200;
+        batchDelay = 1000;
+    }
+    // Reduce batch size if devices are already consuming resources
+    const reduction = Math.floor(alreadyBooted / 2);
+    iosBatch = Math.max(1, iosBatch - reduction);
+    androidBatch = Math.max(1, androidBatch - reduction);
+    return {
+        iosBatchSize: iosBatch,
+        androidBatchSize: androidBatch,
+        delayBetweenBootsMs: bootDelay,
+        delayBetweenBatchesMs: batchDelay,
+        memoryThresholdPercent: 85,
+    };
+}
+// ─── Memory Monitor ───────────────────────────────────────────────────────
+/**
+ * Check if current memory usage is below the safe threshold.
+ * Returns true if it's safe to boot more devices.
+ */
+function isMemorySafe(thresholdPercent = 85) {
+    const total = os_1.default.totalmem();
+    const free = os_1.default.freemem();
+    const usedPercent = ((total - free) / total) * 100;
+    return usedPercent < thresholdPercent;
+}
+/**
+ * Format system profile as a human-readable summary string.
+ */
+function formatSystemInfo(profile) {
+    return (`${Math.round(profile.totalMemoryGB)}GB RAM ` +
+        `(${profile.freeMemoryGB.toFixed(1)}GB free), ` +
+        `${profile.cpuCores} cores`);
+}
+//# sourceMappingURL=system-resources.js.map

package/dist/src/platform/system-resources.js.map

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

package/dist/src/prototype/browser-engine.d.ts

@@ -0,0 +1,62 @@
+export interface BrowserEngineOptions {
+    viewportWidth?: number;
+    viewportHeight?: number;
+    headless?: boolean;
+}
+export interface DomElement {
+    tag: string;
+    text: string;
+    href?: string;
+    role?: string;
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+export interface DomMetadata {
+    title: string;
+    headings: string[];
+    links: Array<{
+        text: string;
+        href: string;
+    }>;
+    images: Array<{
+        src: string;
+        alt: string;
+    }>;
+    interactiveElements: DomElement[];
+    textContent: string;
+}
+/**
+ * Thin wrapper around Puppeteer for headless Chrome lifecycle management.
+ * Lazily imports puppeteer so the rest of DevLens does not fail if the
+ * optional dependency is missing.
+ */
+export declare class BrowserEngine {
+    private browser;
+    private page;
+    private readonly options;
+    constructor(options?: BrowserEngineOptions);
+    launch(): Promise<void>;
+    navigate(url: string): Promise<void>;
+    screenshot(): Promise<Buffer>;
+    viewportScreenshot(): Promise<Buffer>;
+    scrollPage(direction: "down" | "up", distance?: number): Promise<void>;
+    getScrollHeight(): Promise<number>;
+    getScrollPosition(): Promise<number>;
+    click(x: number, y: number): Promise<void>;
+    clickElement(selector: string): Promise<boolean>;
+    extractLinks(): Promise<Array<{
+        text: string;
+        href: string;
+    }>>;
+    extractDomMetadata(): Promise<DomMetadata>;
+    waitForNavigation(): Promise<void>;
+    waitMs(ms: number): Promise<void>;
+    currentUrl(): Promise<string>;
+    close(): Promise<void>;
+    private ensurePage;
+}
+//# sourceMappingURL=browser-engine.d.ts.map

package/dist/src/prototype/browser-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-engine.d.ts","sourceRoot":"","sources":["../../../src/prototype/browser-engine.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,MAAM,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,mBAAmB,EAAE,UAAU,EAAE,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;gBAE7C,OAAO,CAAC,EAAE,oBAAoB;IAQpC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBvB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAU7B,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAUrC,UAAU,CACd,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,GAAE,MAAY,GACrB,OAAO,CAAC,IAAI,CAAC;IASV,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAKlC,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKpC,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUhD,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAuB9D,kBAAkB,IAAI,OAAO,CAAC,WAAW,CAAC;IAuD1C,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAYlC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAK7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,OAAO,CAAC,UAAU;CAQnB"}