react-native-ai-devtools 1.4.3 → 1.4.5

package/build/__tests__/helpers/tap-test-helpers.d.ts

@@ -0,0 +1,36 @@
+import type { TapResult } from "../../pro/tap.js";
+export type Platform = "ios" | "android";
+/**
+ * Detect which platform is available by checking for booted simulators/emulators.
+ * Returns the first available platform.
+ */
+export declare function detectPlatform(): Promise<Platform>;
+/**
+ * Connect to Metro and return the platform of the connected device.
+ */
+export declare function connectToMetro(): Promise<Platform>;
+/**
+ * Disconnect all apps and clean up state.
+ */
+export declare function disconnectAll(): Promise<void>;
+/**
+ * Read the test app's global state to verify a tap was registered.
+ * Returns { tapCount, lastTapped } or null if not available.
+ */
+export declare function readTestState(): Promise<{
+    tapCount: number;
+    lastTapped: string;
+} | null>;
+/**
+ * Reset the test app's tap counter and last-tapped state.
+ */
+export declare function resetTestState(): Promise<void>;
+/**
+ * Assert that a tap result succeeded and the test app registered the tap on the expected element.
+ */
+export declare function assertTapWorked(result: TapResult, expectedElement: string): Promise<void>;
+/**
+ * Wait for a short duration (ms) to let UI settle.
+ */
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=tap-test-helpers.d.ts.map

package/build/__tests__/helpers/tap-test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap-test-helpers.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/tap-test-helpers.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAEzC;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,QAAQ,CAAC,CAYxD;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,QAAQ,CAAC,CAwBxD;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAmBnD;AAED;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAU9F;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpD;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/F;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/build/__tests__/helpers/tap-test-helpers.js

@@ -0,0 +1,125 @@
+// src/__tests__/helpers/tap-test-helpers.ts
+import { scanMetroPorts, fetchDevices, selectMainDevice } from "../../core/metro.js";
+import { connectToDevice } from "../../core/connection.js";
+import { executeInApp } from "../../core/executor.js";
+import { connectedApps, pendingExecutions } from "../../core/state.js";
+import { cancelAllReconnectionTimers, clearAllConnectionState } from "../../core/connectionState.js";
+/**
+ * Detect which platform is available by checking for booted simulators/emulators.
+ * Returns the first available platform.
+ */
+export async function detectPlatform() {
+    const { execSync } = await import("child_process");
+    try {
+        const result = execSync("xcrun simctl list devices booted 2>/dev/null", { encoding: "utf-8" });
+        if (result.includes("Booted"))
+            return "ios";
+    }
+    catch { /* no iOS */ }
+    try {
+        const result = execSync("adb devices 2>/dev/null", { encoding: "utf-8" });
+        const lines = result.trim().split("\n").filter(l => l.includes("device") && !l.includes("List"));
+        if (lines.length > 0)
+            return "android";
+    }
+    catch { /* no Android */ }
+    throw new Error("No booted iOS simulator or Android emulator found");
+}
+/**
+ * Connect to Metro and return the platform of the connected device.
+ */
+export async function connectToMetro() {
+    const ports = await scanMetroPorts();
+    if (ports.length === 0) {
+        throw new Error("No Metro bundler found. Start Metro with the test app first.");
+    }
+    for (const port of ports) {
+        const devices = await fetchDevices(port);
+        const main = selectMainDevice(devices);
+        if (main) {
+            const key = await connectToDevice(main, port, {
+                reconnectionConfig: {
+                    enabled: false,
+                    maxAttempts: 0,
+                    initialDelayMs: 0,
+                    maxDelayMs: 0,
+                    backoffMultiplier: 1,
+                },
+            });
+            const app = connectedApps.get(key);
+            if (app?.platform)
+                return app.platform;
+        }
+    }
+    throw new Error("Connected to Metro but could not determine platform");
+}
+/**
+ * Disconnect all apps and clean up state.
+ */
+export async function disconnectAll() {
+    const closePromises = [];
+    for (const [key, app] of connectedApps.entries()) {
+        closePromises.push(new Promise((resolve) => {
+            if (app.ws.readyState === app.ws.CLOSED) {
+                resolve();
+            }
+            else {
+                app.ws.on("close", () => resolve());
+                try {
+                    app.ws.close();
+                }
+                catch {
+                    resolve();
+                }
+            }
+        }));
+        connectedApps.delete(key);
+    }
+    await Promise.all(closePromises);
+    pendingExecutions.clear();
+    cancelAllReconnectionTimers();
+    clearAllConnectionState();
+}
+/**
+ * Read the test app's global state to verify a tap was registered.
+ * Returns { tapCount, lastTapped } or null if not available.
+ */
+export async function readTestState() {
+    const result = await executeInApp("JSON.stringify({ tapCount: global.__TEST_STATE__?.tapCount ?? -1, lastTapped: global.__TEST_STATE__?.lastTapped ?? 'unknown' })");
+    if (!result.success || !result.result)
+        return null;
+    try {
+        return JSON.parse(result.result);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Reset the test app's tap counter and last-tapped state.
+ */
+export async function resetTestState() {
+    await executeInApp("global.__TEST_STATE__?.reset?.()");
+}
+/**
+ * Assert that a tap result succeeded and the test app registered the tap on the expected element.
+ */
+export async function assertTapWorked(result, expectedElement) {
+    if (!result.success) {
+        throw new Error(`Tap failed: ${result.error ?? result.suggestion ?? "unknown reason"}`);
+    }
+    const state = await readTestState();
+    if (!state) {
+        throw new Error("Could not read test app state via execute_in_app");
+    }
+    if (state.lastTapped !== expectedElement) {
+        throw new Error(`Expected lastTapped="${expectedElement}" but got "${state.lastTapped}"`);
+    }
+}
+/**
+ * Wait for a short duration (ms) to let UI settle.
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=tap-test-helpers.js.map

package/build/__tests__/helpers/tap-test-helpers.js.map

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

package/build/__tests__/integration/tap-strategies.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tap-strategies.test.d.ts.map

package/build/__tests__/integration/tap-strategies.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap-strategies.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/tap-strategies.test.ts"],"names":[],"mappings":""}

package/build/__tests__/integration/tap-strategies.test.js

@@ -0,0 +1,265 @@
+// src/__tests__/integration/tap-strategies.test.ts
+import { describe, it, expect, beforeAll, afterAll, afterEach } from "@jest/globals";
+import { tap } from "../../pro/tap.js";
+import { connectToMetro, disconnectAll, resetTestState, readTestState, assertTapWorked, sleep, } from "../helpers/tap-test-helpers.js";
+let platform;
+beforeAll(async () => {
+    platform = await connectToMetro();
+}, 30000);
+afterAll(async () => {
+    await disconnectAll();
+}, 10000);
+afterEach(async () => {
+    await resetTestState();
+    await sleep(500);
+}, 10000);
+describe("Category 1: RN Fiber & JS Strategies", () => {
+    it("tap button by testID (auto strategy)", async () => {
+        const result = await tap({ testID: "submit-btn" });
+        await assertTapWorked(result, "submit-btn");
+    }, 30000);
+    it("tap button by visible text (auto strategy)", async () => {
+        const result = await tap({ text: "Cancel" });
+        await assertTapWorked(result, "cancel-btn");
+    }, 30000);
+    it("tap icon-only button by component name", async () => {
+        const result = await tap({ component: "HeartIcon" });
+        await assertTapWorked(result, "heart-btn");
+    }, 30000);
+    it("tap by text with explicit fiber strategy", async () => {
+        const result = await tap({ text: "Submit", strategy: "fiber" });
+        await assertTapWorked(result, "submit-btn");
+    }, 30000);
+    it("tap by testID with explicit accessibility strategy", async () => {
+        const result = await tap({ testID: "submit-btn", strategy: "accessibility" });
+        await assertTapWorked(result, "submit-btn");
+    }, 30000);
+    it("tap by text with explicit OCR strategy", async () => {
+        const result = await tap({ text: "Submit", strategy: "ocr" });
+        await assertTapWorked(result, "submit-btn");
+    }, 30000);
+    it("focus TextInput by testID", async () => {
+        const result = await tap({ testID: "name-input" });
+        expect(result.success).toBe(true);
+        // TextInput has onChangeText, not onPress — fiber detects this and falls
+        // through to native tap for focus. No tap counter increment expected since
+        // the test app only counts onPress handlers, not input focus events.
+        expect(result.method).toBeDefined();
+    }, 30000);
+    it("tap Cyrillic text button", async () => {
+        const result = await tap({ text: "Отправить" });
+        await assertTapWorked(result, "cyrillic-btn");
+    }, 30000);
+    it("tap CJK text button", async () => {
+        const result = await tap({ text: "送信" });
+        await assertTapWorked(result, "cjk-btn");
+    }, 30000);
+});
+describe("Category 2: RN Coordinates & Verification", () => {
+    it("tap by pixel coordinates", async () => {
+        // First, tap by testID to find the element's coordinates.
+        // tappedAt returns coordinates in the native unit used by the platform
+        // (points on iOS, pixels on Android). tap({ x, y }) treats these as
+        // screenshot pixel coordinates and applies conversion internally.
+        const findResult = await tap({ testID: "submit-btn", screenshot: true });
+        expect(findResult.success).toBe(true);
+        expect(findResult.tappedAt).toBeDefined();
+        await resetTestState();
+        await sleep(500);
+        const { x, y } = findResult.tappedAt;
+        const result = await tap({ x, y });
+        await assertTapWorked(result, "submit-btn");
+        expect(result.method).toBe("coordinate");
+    }, 30000);
+    it("tap with native=true at coordinates", async () => {
+        // Get coordinates from a known element
+        const findResult = await tap({ testID: "cancel-btn", screenshot: true });
+        expect(findResult.success).toBe(true);
+        expect(findResult.tappedAt).toBeDefined();
+        await resetTestState();
+        await sleep(500);
+        const { x, y } = findResult.tappedAt;
+        const result = await tap({ x, y, native: true });
+        expect(result.success).toBe(true);
+        // Native tap bypasses RN, verify via test state
+        const state = await readTestState();
+        expect(state?.lastTapped).toBe("cancel-btn");
+    }, 30000);
+    it("tap with screenshot verification", async () => {
+        const result = await tap({ testID: "submit-btn", verify: true, screenshot: true });
+        expect(result.success).toBe(true);
+        expect(result.screenshot).toBeDefined();
+        expect(result.screenshot?.image).toBeTruthy();
+        expect(result.verification).toBeDefined();
+        expect(result.verification?.meaningful).toBe(true);
+    }, 30000);
+    it("tap with screenshot=false", async () => {
+        const result = await tap({ testID: "submit-btn", screenshot: false });
+        expect(result.success).toBe(true);
+        expect(result.screenshot).toBeUndefined();
+    }, 30000);
+    it("tap non-existent element returns failure with suggestion", async () => {
+        const result = await tap({ text: "DoesNotExist" });
+        expect(result.success).toBe(false);
+        expect(result.suggestion).toBeTruthy();
+        expect(result.attempted).toBeDefined();
+        expect(result.attempted.length).toBeGreaterThan(0);
+    }, 30000);
+    it("tap completes within timeout budget", async () => {
+        const start = Date.now();
+        const result = await tap({ testID: "submit-btn" });
+        const elapsed = Date.now() - start;
+        expect(result.success).toBe(true);
+        // Successful tap should complete well under the 10s timeout
+        expect(elapsed).toBeLessThan(10000);
+    }, 30000);
+    it("failed tap respects timeout and does not hang", async () => {
+        const start = Date.now();
+        const result = await tap({ text: "DoesNotExist_Timeout_Test" });
+        const elapsed = Date.now() - start;
+        expect(result.success).toBe(false);
+        // Failed tap should not exceed ~10s budget (with some margin for cleanup)
+        expect(elapsed).toBeLessThan(15000);
+        // Check that attempted strategies report timeout/skip info
+        expect(result.attempted).toBeDefined();
+        expect(result.attempted.length).toBeGreaterThan(0);
+    }, 30000);
+    it("tap navigation button and verify screen change", async () => {
+        const result = await tap({ testID: "nav-scroll-btn" });
+        expect(result.success).toBe(true);
+        await sleep(1000); // wait for navigation animation
+        // Verify we're on Screen 2 by checking for its elements
+        const backBtnResult = await tap({ testID: "nav-back-btn", screenshot: false });
+        expect(backBtnResult.success).toBe(true);
+        await sleep(500); // wait for navigation back
+    }, 30000);
+    it("scroll then tap bottom button", async () => {
+        // Navigate to scroll screen
+        await tap({ testID: "nav-scroll-btn" });
+        await sleep(1000);
+        // Swipe up to scroll down and reveal the bottom button
+        const { iosSwipe } = await import("../../core/ios.js");
+        const { androidSwipe } = await import("../../core/android.js");
+        // Perform multiple swipes to reach the bottom
+        for (let i = 0; i < 5; i++) {
+            if (platform === "ios") {
+                await iosSwipe(200, 600, 200, 200);
+            }
+            else {
+                await androidSwipe(540, 1500, 540, 500);
+            }
+            await sleep(500);
+        }
+        // Try to tap the bottom button
+        const result = await tap({ testID: "bottom-btn" });
+        await assertTapWorked(result, "bottom-btn");
+        // Navigate back
+        await tap({ testID: "nav-back-btn" });
+        await sleep(500);
+    }, 60000);
+});
+describe("Category 3: Non-RN Native App (System Apps)", () => {
+    const IOS_SETTINGS_BUNDLE = "com.apple.Preferences";
+    const ANDROID_SETTINGS_PACKAGE = "com.android.settings";
+    // Platform checks are inside it() bodies because platform is set in beforeAll,
+    // which runs after Jest collects describe blocks synchronously.
+    it("tap Settings item by text (iOS)", async () => {
+        if (platform !== "ios")
+            return;
+        const { iosLaunchApp } = await import("../../core/ios.js");
+        await iosLaunchApp(IOS_SETTINGS_BUNDLE);
+        await sleep(2000);
+        const result = await tap({ text: "General", native: true });
+        expect(result.success).toBe(true);
+    }, 30000);
+    it("tap by OCR on native app (iOS)", async () => {
+        if (platform !== "ios")
+            return;
+        const { iosLaunchApp } = await import("../../core/ios.js");
+        await iosLaunchApp(IOS_SETTINGS_BUNDLE);
+        await sleep(2000);
+        const result = await tap({ text: "General", strategy: "ocr", native: true });
+        expect(result.success).toBe(true);
+        expect(result.method).toBe("ocr");
+    }, 30000);
+    it("find and tap via iOS accessibility tree", async () => {
+        if (platform !== "ios")
+            return;
+        const { iosLaunchApp, iosFindElement } = await import("../../core/ios.js");
+        await iosLaunchApp(IOS_SETTINGS_BUNDLE);
+        await sleep(2000);
+        const findResult = await iosFindElement({ labelContains: "General" });
+        expect(findResult.success).toBe(true);
+        expect(findResult.found).toBe(true);
+        expect(findResult.element).toBeDefined();
+        const { x, y } = findResult.element.center;
+        const tapResult = await tap({ x, y, native: true });
+        expect(tapResult.success).toBe(true);
+    }, 30000);
+    it("tap Settings item by text (Android)", async () => {
+        if (platform !== "android")
+            return;
+        const { androidLaunchApp } = await import("../../core/android.js");
+        await androidLaunchApp(ANDROID_SETTINGS_PACKAGE);
+        await sleep(2000);
+        const result = await tap({ text: "Network", native: true });
+        expect(result.success).toBe(true);
+    }, 30000);
+    it("tap by OCR on native app (Android)", async () => {
+        if (platform !== "android")
+            return;
+        const { androidLaunchApp } = await import("../../core/android.js");
+        await androidLaunchApp(ANDROID_SETTINGS_PACKAGE);
+        await sleep(2000);
+        const result = await tap({ text: "Network", strategy: "ocr", native: true });
+        expect(result.success).toBe(true);
+        expect(result.method).toBe("ocr");
+    }, 30000);
+    it("find and tap via Android accessibility tree", async () => {
+        if (platform !== "android")
+            return;
+        const { androidLaunchApp, androidFindElement } = await import("../../core/android.js");
+        await androidLaunchApp(ANDROID_SETTINGS_PACKAGE);
+        await sleep(2000);
+        const findResult = await androidFindElement({ textContains: "Network" });
+        expect(findResult.success).toBe(true);
+        expect(findResult.found).toBe(true);
+        expect(findResult.element).toBeDefined();
+        const { x, y } = findResult.element.center;
+        const tapResult = await tap({ x, y, native: true });
+        expect(tapResult.success).toBe(true);
+    }, 30000);
+    it("tap by coordinates on native app", async () => {
+        if (platform === "ios") {
+            const { iosLaunchApp } = await import("../../core/ios.js");
+            await iosLaunchApp(IOS_SETTINGS_BUNDLE);
+        }
+        else {
+            const { androidLaunchApp } = await import("../../core/android.js");
+            await androidLaunchApp(ANDROID_SETTINGS_PACKAGE);
+        }
+        await sleep(2000);
+        const targetText = platform === "ios" ? "General" : "Network";
+        const ocrResult = await tap({ text: targetText, strategy: "ocr", native: true });
+        expect(ocrResult.success).toBe(true);
+        expect(ocrResult.tappedAt).toBeDefined();
+    }, 30000);
+    it("tap without Metro connection (native only)", async () => {
+        await disconnectAll();
+        await sleep(1000);
+        if (platform === "ios") {
+            const { iosLaunchApp } = await import("../../core/ios.js");
+            await iosLaunchApp(IOS_SETTINGS_BUNDLE);
+        }
+        else {
+            const { androidLaunchApp } = await import("../../core/android.js");
+            await androidLaunchApp(ANDROID_SETTINGS_PACKAGE);
+        }
+        await sleep(2000);
+        const result = await tap({ x: 200, y: 400, native: true, platform });
+        expect(result.success).toBe(true);
+        // Reconnect for any subsequent test runs
+        await connectToMetro();
+    }, 30000);
+});
+//# sourceMappingURL=tap-strategies.test.js.map

package/build/__tests__/integration/tap-strategies.test.js.map

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

package/build/__tests__/unit/burst.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=burst.test.d.ts.map

package/build/__tests__/unit/burst.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"burst.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/burst.test.ts"],"names":[],"mappings":""}

package/build/__tests__/unit/burst.test.js

@@ -0,0 +1,50 @@
+import { describe, it, expect } from "@jest/globals";
+import sharp from "sharp";
+import { analyzeBurstFrames } from "../../pro/tap.js";
+async function solidImage(r, g, b, size = 100) {
+    return sharp({
+        create: { width: size, height: size, channels: 3, background: { r, g, b } },
+    }).png().toBuffer();
+}
+describe("analyzeBurstFrames", () => {
+    it("detects no change when all frames are identical", async () => {
+        const frame = await solidImage(200, 200, 200);
+        const result = await analyzeBurstFrames([frame, frame, frame, frame, frame]);
+        expect(result.transientChangeDetected).toBe(false);
+        expect(result.peakChangeRate).toBeLessThan(0.005);
+        expect(result.persistentChangeRate).toBeLessThan(0.005);
+        expect(result.meaningful).toBe(false);
+    });
+    it("detects persistent change (last frame differs from first)", async () => {
+        const before = await solidImage(200, 200, 200);
+        const after = await solidImage(255, 0, 0);
+        const result = await analyzeBurstFrames([before, before, before, after, after]);
+        expect(result.meaningful).toBe(true);
+        expect(result.persistentChangeRate).toBeGreaterThan(0.005);
+    });
+    it("detects transient change (middle frame differs, last matches first)", async () => {
+        const normal = await solidImage(200, 200, 200);
+        const highlight = await solidImage(255, 0, 0);
+        const result = await analyzeBurstFrames([normal, highlight, normal, normal, normal]);
+        expect(result.transientChangeDetected).toBe(true);
+        expect(result.meaningful).toBe(true);
+        expect(result.peakFrame).toBe(1);
+        expect(result.peakChangeRate).toBeGreaterThan(0.5);
+        expect(result.persistentChangeRate).toBeLessThan(0.005);
+    });
+    it("handles 2 frames (minimum)", async () => {
+        const a = await solidImage(200, 200, 200);
+        const b = await solidImage(255, 0, 0);
+        const result = await analyzeBurstFrames([a, b]);
+        expect(result.meaningful).toBe(true);
+        expect(result.persistentChangeRate).toBeGreaterThan(0.5);
+    });
+    it("returns correct framesWithChange indices", async () => {
+        const normal = await solidImage(200, 200, 200);
+        const highlight = await solidImage(255, 0, 0);
+        const result = await analyzeBurstFrames([normal, highlight, highlight, normal, normal]);
+        expect(result.framesWithChange).toContain(1);
+        expect(result.framesWithChange).toContain(3);
+    });
+});
+//# sourceMappingURL=burst.test.js.map

package/build/__tests__/unit/burst.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"burst.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/burst.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,KAAK,UAAU,UAAU,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,IAAI,GAAG,GAAG;IACjE,OAAO,KAAK,CAAC;QACT,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;KAC9E,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAC7E,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAChF,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACrF,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,CAAC,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACxF,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/build/__tests__/unit/imageBuffer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=imageBuffer.test.d.ts.map

package/build/__tests__/unit/imageBuffer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageBuffer.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/imageBuffer.test.ts"],"names":[],"mappings":""}