@epsilon-asi/actors 0.0.22 → 0.0.33

package/dist/native/NativeCoordinateMapper.js

@@ -0,0 +1,201 @@
+import { CoordinateCalibrationError } from './errors.js';
+import { centerOf } from './utils/geometry.js';
+const DEFAULT_MARKER_A = { x: 120, y: 120 };
+const DEFAULT_MARKER_B = { x: 420, y: 320 };
+const DEFAULT_MARKER_SIZE = 22;
+function assertFinite(value, name) {
+    if (!Number.isFinite(value)) {
+        throw new CoordinateCalibrationError(`Coordinate calibration produced a non-finite ${name}.`, { [name]: value });
+    }
+}
+async function getViewportSnapshot(page) {
+    return page.evaluate(() => {
+        const view = globalThis.window;
+        return {
+            screenX: view.screenX,
+            screenY: view.screenY,
+            outerWidth: view.outerWidth,
+            outerHeight: view.outerHeight,
+            innerWidth: view.innerWidth,
+            innerHeight: view.innerHeight,
+            devicePixelRatio: view.devicePixelRatio
+        };
+    });
+}
+async function installMarkers(page, markers) {
+    const payload = { markers };
+    await page.evaluate((rawPayload) => {
+        const { markers: markerSpecs } = rawPayload;
+        const existing = document.getElementById('__paf_native_coordinate_markers__');
+        existing?.remove();
+        const root = document.createElement('div');
+        root.id = '__paf_native_coordinate_markers__';
+        root.style.position = 'fixed';
+        root.style.left = '0';
+        root.style.top = '0';
+        root.style.width = '0';
+        root.style.height = '0';
+        root.style.zIndex = '2147483647';
+        root.style.pointerEvents = 'none';
+        for (const marker of markerSpecs) {
+            const element = document.createElement('div');
+            element.id = marker.id;
+            element.setAttribute('data-paf-native-calibration-marker', marker.id);
+            element.style.position = 'fixed';
+            element.style.left = `${marker.point.x}px`;
+            element.style.top = `${marker.point.y}px`;
+            element.style.width = `${marker.size}px`;
+            element.style.height = `${marker.size}px`;
+            element.style.background = marker.color;
+            element.style.border = '3px solid #000';
+            element.style.boxSizing = 'border-box';
+            element.style.boxShadow = '0 0 0 2px #fff';
+            root.appendChild(element);
+        }
+        document.documentElement.appendChild(root);
+    }, payload);
+}
+async function removeMarkers(page) {
+    await page.evaluate(() => {
+        document.getElementById('__paf_native_coordinate_markers__')?.remove();
+    });
+}
+async function captureMarkerTemplate(page, marker) {
+    const margin = 8;
+    const screenshot = await page.screenshot({
+        type: 'png',
+        clip: {
+            x: marker.point.x - margin,
+            y: marker.point.y - margin,
+            width: marker.size + margin * 2,
+            height: marker.size + margin * 2
+        }
+    });
+    if (typeof screenshot === 'string') {
+        return { name: `${marker.id}.png`, buffer: Buffer.from(screenshot, 'base64') };
+    }
+    return { name: `${marker.id}.png`, buffer: screenshot };
+}
+export class ImageBasedCoordinateMapper {
+    options;
+    cached = null;
+    cacheExpiresAt = 0;
+    constructor(options) {
+        this.options = options;
+    }
+    async calibrate(page, options = {}) {
+        const markerSize = options.markerSizePx ?? DEFAULT_MARKER_SIZE;
+        const markerA = {
+            id: 'paf-native-calibration-a',
+            point: options.markerA ?? DEFAULT_MARKER_A,
+            size: markerSize,
+            color: '#ff00ff'
+        };
+        const markerB = {
+            id: 'paf-native-calibration-b',
+            point: options.markerB ?? DEFAULT_MARKER_B,
+            size: markerSize,
+            color: '#00ffff'
+        };
+        await installMarkers(page, [markerA, markerB]);
+        try {
+            const viewport = await getViewportSnapshot(page);
+            const [templateA, templateB] = await Promise.all([
+                captureMarkerTemplate(page, markerA),
+                captureMarkerTemplate(page, markerB)
+            ]);
+            const imageOptions = {};
+            const timeoutMs = options.timeoutMs ?? this.options.defaultTimeoutMs;
+            if (timeoutMs !== undefined)
+                imageOptions.timeoutMs = timeoutMs;
+            if (options.intervalMs !== undefined)
+                imageOptions.intervalMs = options.intervalMs;
+            const [matchA, matchB] = await Promise.all([
+                this.options.images.waitForTemplate(templateA, imageOptions),
+                this.options.images.waitForTemplate(templateB, imageOptions)
+            ]);
+            const screenA = centerOf(matchA.region);
+            const screenB = centerOf(matchB.region);
+            const browserA = {
+                x: markerA.point.x + markerA.size / 2,
+                y: markerA.point.y + markerA.size / 2
+            };
+            const browserB = {
+                x: markerB.point.x + markerB.size / 2,
+                y: markerB.point.y + markerB.size / 2
+            };
+            const scaleX = (screenB.x - screenA.x) / (browserB.x - browserA.x);
+            const scaleY = (screenB.y - screenA.y) / (browserB.y - browserA.y);
+            const offsetX = screenA.x - scaleX * browserA.x;
+            const offsetY = screenA.y - scaleY * browserA.y;
+            this.validateTransform({ offsetX, offsetY, scaleX, scaleY }, viewport);
+            const transform = {
+                offsetX,
+                offsetY,
+                scaleX,
+                scaleY,
+                calibratedAt: Date.now(),
+                viewport: {
+                    innerWidth: viewport.innerWidth,
+                    innerHeight: viewport.innerHeight,
+                    devicePixelRatio: viewport.devicePixelRatio
+                }
+            };
+            if (this.options.windows !== undefined && options.windowMatcher !== undefined) {
+                const window = await this.options.windows.find(options.windowMatcher);
+                if (window !== null)
+                    transform.window = window;
+            }
+            this.cached = transform;
+            this.cacheExpiresAt = transform.calibratedAt + (options.cacheTtlMs ?? this.options.defaultCacheTtlMs ?? 60_000);
+            return transform;
+        }
+        finally {
+            await removeMarkers(page).catch(error => {
+                this.options.logger?.warn('Failed to remove native coordinate calibration markers.', { error });
+            });
+        }
+    }
+    async browserToScreen(point, options = {}) {
+        const transform = await this.getTransform(options);
+        return {
+            x: transform.offsetX + transform.scaleX * point.x,
+            y: transform.offsetY + transform.scaleY * point.y
+        };
+    }
+    async screenToBrowser(point, options = {}) {
+        const transform = await this.getTransform(options);
+        return {
+            x: (point.x - transform.offsetX) / transform.scaleX,
+            y: (point.y - transform.offsetY) / transform.scaleY
+        };
+    }
+    invalidate() {
+        this.cached = null;
+        this.cacheExpiresAt = 0;
+    }
+    async getTransform(options) {
+        const useCache = options.useCache ?? true;
+        if (useCache && this.cached !== null && Date.now() < this.cacheExpiresAt) {
+            return this.cached;
+        }
+        if (options.page === undefined) {
+            throw new CoordinateCalibrationError('Coordinate mapping requires a calibrated transform or a page for calibration.');
+        }
+        return this.calibrate(options.page);
+    }
+    validateTransform(transform, viewport) {
+        assertFinite(transform.offsetX, 'offsetX');
+        assertFinite(transform.offsetY, 'offsetY');
+        assertFinite(transform.scaleX, 'scaleX');
+        assertFinite(transform.scaleY, 'scaleY');
+        if (transform.scaleX < 0.5 || transform.scaleX > 3.5 || transform.scaleY < 0.5 || transform.scaleY > 3.5) {
+            throw new CoordinateCalibrationError('Coordinate calibration produced an implausible scale.', {
+                scaleX: transform.scaleX,
+                scaleY: transform.scaleY,
+                viewport
+            });
+        }
+    }
+}
+//# sourceMappingURL=NativeCoordinateMapper.js.map

package/dist/native/NativeCoordinateMapper.js.map

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

package/dist/native/NativeFileDialogService.d.ts

@@ -0,0 +1,26 @@
+import type { Logger } from '../logging/Logger.js';
+import type { NativeImageFinder, NativeKeyboard, NativeMouse, SelectFileOptions } from './types.js';
+export interface FileDialogAccessibilityStrategy {
+    selectFile(filePath: string, options: SelectFileOptions): Promise<void>;
+}
+export interface NativeFileDialogServiceDependencies {
+    keyboard: NativeKeyboard;
+    mouse?: NativeMouse;
+    images?: NativeImageFinder;
+    accessibility?: FileDialogAccessibilityStrategy;
+    logger?: Logger;
+    defaultTimeoutMs?: number;
+    revealFilePathsInLogs?: boolean;
+}
+export declare class DefaultNativeFileDialogService {
+    private readonly deps;
+    constructor(deps: NativeFileDialogServiceDependencies);
+    selectFile(filePath: string, options?: SelectFileOptions): Promise<void>;
+    private assertFileExists;
+    private selectFileVisually;
+    private selectFileWithKeyboard;
+    private imageSearchOptions;
+    private wrapFailure;
+    private logSuccess;
+}
+//# sourceMappingURL=NativeFileDialogService.d.ts.map

package/dist/native/NativeFileDialogService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeFileDialogService.d.ts","sourceRoot":"","sources":["../../src/native/NativeFileDialogService.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpG,MAAM,WAAW,+BAA+B;IAC9C,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,aAAa,CAAC,EAAE,+BAA+B,CAAC;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,qBAAa,8BAA8B;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,mCAAmC;IAEhE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;YAkDpE,gBAAgB;YAShB,kBAAkB;YAuBlB,sBAAsB;IASpC,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,UAAU;CAMnB"}

package/dist/native/NativeFileDialogService.js

@@ -0,0 +1,121 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { NativeFileDialogError } from './errors.js';
+import { centerOf } from './utils/geometry.js';
+import { redactPath } from './utils/redactNative.js';
+export class DefaultNativeFileDialogService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async selectFile(filePath, options = {}) {
+        const absolutePath = path.resolve(filePath);
+        await this.assertFileExists(absolutePath);
+        const strategy = options.strategy ?? 'auto';
+        const failures = [];
+        if (strategy === 'applescript' || strategy === 'auto') {
+            if (this.deps.accessibility !== undefined) {
+                try {
+                    await this.deps.accessibility.selectFile(absolutePath, options);
+                    this.logSuccess('applescript', absolutePath);
+                    return;
+                }
+                catch (error) {
+                    failures.push(error);
+                    if (strategy === 'applescript')
+                        throw this.wrapFailure('applescript', absolutePath, failures);
+                }
+            }
+            else if (strategy === 'applescript') {
+                throw new NativeFileDialogError('AppleScript file-dialog strategy is not available.', { strategy });
+            }
+        }
+        if (strategy === 'visual' || strategy === 'auto') {
+            if (this.deps.images !== undefined && this.deps.mouse !== undefined) {
+                try {
+                    await this.selectFileVisually(absolutePath, options);
+                    this.logSuccess('visual', absolutePath);
+                    return;
+                }
+                catch (error) {
+                    failures.push(error);
+                    if (strategy === 'visual')
+                        throw this.wrapFailure('visual', absolutePath, failures);
+                }
+            }
+            else if (strategy === 'visual') {
+                throw new NativeFileDialogError('Visual file-dialog strategy requires image finder and native mouse dependencies.', { strategy });
+            }
+        }
+        if (strategy === 'keyboard' || strategy === 'auto') {
+            try {
+                await this.selectFileWithKeyboard(absolutePath, options);
+                this.logSuccess('keyboard', absolutePath);
+                return;
+            }
+            catch (error) {
+                failures.push(error);
+            }
+        }
+        throw this.wrapFailure(strategy, absolutePath, failures);
+    }
+    async assertFileExists(filePath) {
+        const stat = await fs.stat(filePath).catch(() => null);
+        if (stat === null || !stat.isFile()) {
+            throw new NativeFileDialogError('Cannot select file because the path does not exist or is not a file.', {
+                filePath: redactPath(filePath, this.deps.revealFilePathsInLogs)
+            });
+        }
+    }
+    async selectFileVisually(filePath, options) {
+        if (this.deps.images === undefined || this.deps.mouse === undefined) {
+            throw new NativeFileDialogError('Visual file-dialog strategy requires image finder and native mouse dependencies.');
+        }
+        if (options.inputFieldTemplate !== undefined) {
+            const input = await this.deps.images.waitForTemplate(options.inputFieldTemplate, this.imageSearchOptions(options));
+            await this.deps.mouse.click(centerOf(input.region));
+        }
+        else {
+            await this.deps.keyboard.pressShortcut(['Meta', 'Shift', 'G']);
+        }
+        await this.deps.keyboard.type(filePath);
+        await this.deps.keyboard.pressKey('Enter');
+        if ((options.clickOpen ?? true) && options.openButtonTemplate !== undefined) {
+            const openButton = await this.deps.images.waitForTemplate(options.openButtonTemplate, this.imageSearchOptions(options));
+            await this.deps.mouse.click(centerOf(openButton.region));
+        }
+        else if (options.clickOpen ?? true) {
+            await this.deps.keyboard.pressKey('Enter');
+        }
+    }
+    async selectFileWithKeyboard(filePath, options) {
+        await this.deps.keyboard.pressShortcut(['Meta', 'Shift', 'G']);
+        await this.deps.keyboard.type(filePath);
+        await this.deps.keyboard.pressKey('Enter');
+        if (options.clickOpen ?? true) {
+            await this.deps.keyboard.pressKey('Enter');
+        }
+    }
+    imageSearchOptions(options) {
+        const searchOptions = {};
+        if (options.timeoutMs !== undefined)
+            searchOptions.timeoutMs = options.timeoutMs;
+        if (options.intervalMs !== undefined)
+            searchOptions.intervalMs = options.intervalMs;
+        return searchOptions;
+    }
+    wrapFailure(strategy, filePath, failures) {
+        return new NativeFileDialogError('Failed to select a file in the native file dialog.', {
+            strategy,
+            filePath: redactPath(filePath, this.deps.revealFilePathsInLogs),
+            failures
+        });
+    }
+    logSuccess(strategy, filePath) {
+        this.deps.logger?.debug('Selected file in native dialog.', {
+            strategy,
+            filePath: redactPath(filePath, this.deps.revealFilePathsInLogs)
+        });
+    }
+}
+//# sourceMappingURL=NativeFileDialogService.js.map

package/dist/native/NativeFileDialogService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeFileDialogService.js","sourceRoot":"","sources":["../../src/native/NativeFileDialogService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAgBrD,MAAM,OAAO,8BAA8B;IACZ;IAA7B,YAA6B,IAAyC;QAAzC,SAAI,GAAJ,IAAI,CAAqC;IAAG,CAAC;IAE1E,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,UAA6B,EAAE;QAChE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;QAE1C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC;QAC5C,MAAM,QAAQ,GAAc,EAAE,CAAC;QAE/B,IAAI,QAAQ,KAAK,aAAa,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACtD,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;gBAC1C,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;oBAChE,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;oBAC7C,OAAO;gBACT,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACrB,IAAI,QAAQ,KAAK,aAAa;wBAAE,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;gBAChG,CAAC;YACH,CAAC;iBAAM,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;gBACtC,MAAM,IAAI,qBAAqB,CAAC,oDAAoD,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtG,CAAC;QACH,CAAC;QAED,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACjD,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACpE,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,kBAAkB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;oBACrD,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;oBACxC,OAAO;gBACT,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACrB,IAAI,QAAQ,KAAK,QAAQ;wBAAE,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;gBACtF,CAAC;YACH,CAAC;iBAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACjC,MAAM,IAAI,qBAAqB,CAAC,kFAAkF,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YACpI,CAAC;QACH,CAAC;QAED,IAAI,QAAQ,KAAK,UAAU,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACnD,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,sBAAsB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBACzD,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;gBAC1C,OAAO;YACT,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAED,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,QAAgB;QAC7C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,qBAAqB,CAAC,sEAAsE,EAAE;gBACtG,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC;aAChE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,QAAgB,EAAE,OAA0B;QAC3E,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACpE,MAAM,IAAI,qBAAqB,CAAC,kFAAkF,CAAC,CAAC;QACtH,CAAC;QAED,IAAI,OAAO,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;YACnH,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE3C,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,OAAO,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;YAC5E,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;YACxH,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3D,CAAC;aAAM,IAAI,OAAO,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,sBAAsB,CAAC,QAAgB,EAAE,OAA0B;QAC/E,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/D,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,OAAO,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,OAA0B;QACnD,MAAM,aAAa,GAAgD,EAAE,CAAC;QACtE,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;YAAE,aAAa,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACjF,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAAE,aAAa,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACpF,OAAO,aAAa,CAAC;IACvB,CAAC;IAEO,WAAW,CAAC,QAAgB,EAAE,QAAgB,EAAE,QAAmB;QACzE,OAAO,IAAI,qBAAqB,CAAC,oDAAoD,EAAE;YACrF,QAAQ;YACR,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC;YAC/D,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAEO,UAAU,CAAC,QAAgB,EAAE,QAAgB;QACnD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,iCAAiC,EAAE;YACzD,QAAQ;YACR,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC;SAChE,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/native/NativeImageFinder.d.ts

@@ -0,0 +1,12 @@
+import type { NativeImageFinder, NativeImageMatch, NativeImageSearchOptions, NativeTemplateRef } from './types.js';
+export interface NativeImageFinderDriver {
+    findTemplate(template: string | NativeTemplateRef, options?: NativeImageSearchOptions): Promise<NativeImageMatch | null>;
+}
+export declare class DefaultNativeImageFinder implements NativeImageFinder {
+    private readonly driver;
+    private readonly defaultTimeoutMs;
+    constructor(driver: NativeImageFinderDriver, defaultTimeoutMs?: number);
+    findTemplate(template: string | NativeTemplateRef, options?: NativeImageSearchOptions): Promise<NativeImageMatch | null>;
+    waitForTemplate(template: string | NativeTemplateRef, options?: NativeImageSearchOptions): Promise<NativeImageMatch>;
+}
+//# sourceMappingURL=NativeImageFinder.d.ts.map

package/dist/native/NativeImageFinder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeImageFinder.d.ts","sourceRoot":"","sources":["../../src/native/NativeImageFinder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAInH,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CAC1H;AAED,qBAAa,wBAAyB,YAAW,iBAAiB;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAA2B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAlE,MAAM,EAAE,uBAAuB,EAAmB,gBAAgB,SAAS;IAElG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAIxH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAiB/H"}

package/dist/native/NativeImageFinder.js

@@ -0,0 +1,29 @@
+import { NativeImageNotFoundError } from './errors.js';
+import { waitFor } from './utils/waitFor.js';
+export class DefaultNativeImageFinder {
+    driver;
+    defaultTimeoutMs;
+    constructor(driver, defaultTimeoutMs = 15_000) {
+        this.driver = driver;
+        this.defaultTimeoutMs = defaultTimeoutMs;
+    }
+    async findTemplate(template, options) {
+        return this.driver.findTemplate(template, options);
+    }
+    async waitForTemplate(template, options = {}) {
+        try {
+            return await waitFor(() => this.findTemplate(template, options), {
+                timeoutMs: options.timeoutMs ?? this.defaultTimeoutMs,
+                intervalMs: options.intervalMs ?? 100,
+                description: `native image template ${typeof template === 'string' ? template : template.name}`
+            });
+        }
+        catch (error) {
+            throw new NativeImageNotFoundError({
+                template: typeof template === 'string' ? template : template.name,
+                cause: error
+            });
+        }
+    }
+}
+//# sourceMappingURL=NativeImageFinder.js.map

package/dist/native/NativeImageFinder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeImageFinder.js","sourceRoot":"","sources":["../../src/native/NativeImageFinder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAM7C,MAAM,OAAO,wBAAwB;IACN;IAAkD;IAA/E,YAA6B,MAA+B,EAAmB,mBAAmB,MAAM;QAA3E,WAAM,GAAN,MAAM,CAAyB;QAAmB,qBAAgB,GAAhB,gBAAgB,CAAS;IAAG,CAAC;IAE5G,KAAK,CAAC,YAAY,CAAC,QAAoC,EAAE,OAAkC;QACzF,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,QAAoC,EAAE,UAAoC,EAAE;QAChG,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAClB,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,EAC1C;gBACE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,gBAAgB;gBACrD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;gBACrC,WAAW,EAAE,yBAAyB,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE;aAChG,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,wBAAwB,CAAC;gBACjC,QAAQ,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI;gBACjE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/native/NativeKeyboard.d.ts

@@ -0,0 +1,10 @@
+import type { NativeKeyboardDriver } from './drivers.js';
+import type { NativeKeyboard, NativeKeyboardTypeOptions } from './types.js';
+export declare class DefaultNativeKeyboard implements NativeKeyboard {
+    private readonly driver;
+    constructor(driver: NativeKeyboardDriver);
+    type(text: string, options?: NativeKeyboardTypeOptions): Promise<void>;
+    pressKey(key: string): Promise<void>;
+    pressShortcut(keys: readonly string[]): Promise<void>;
+}
+//# sourceMappingURL=NativeKeyboard.d.ts.map

package/dist/native/NativeKeyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeKeyboard.d.ts","sourceRoot":"","sources":["../../src/native/NativeKeyboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5E,qBAAa,qBAAsB,YAAW,cAAc;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,oBAAoB;IAEnD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAG5D"}

package/dist/native/NativeKeyboard.js

@@ -0,0 +1,16 @@
+export class DefaultNativeKeyboard {
+    driver;
+    constructor(driver) {
+        this.driver = driver;
+    }
+    async type(text, options = {}) {
+        await this.driver.type(text, options.delayMs === undefined ? undefined : { delayMs: options.delayMs });
+    }
+    async pressKey(key) {
+        await this.driver.pressKey(key);
+    }
+    async pressShortcut(keys) {
+        await this.driver.pressShortcut(keys);
+    }
+}
+//# sourceMappingURL=NativeKeyboard.js.map

package/dist/native/NativeKeyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeKeyboard.js","sourceRoot":"","sources":["../../src/native/NativeKeyboard.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,qBAAqB;IACH;IAA7B,YAA6B,MAA4B;QAA5B,WAAM,GAAN,MAAM,CAAsB;IAAG,CAAC;IAE7D,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,UAAqC,EAAE;QAC9D,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAW;QACxB,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAuB;QACzC,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/native/NativeMouse.d.ts

@@ -0,0 +1,38 @@
+import type { PageLike } from '../browser/PuppeteerLike.js';
+import type { NativeMouseDriver } from './drivers.js';
+import type { BrowserPoint, NativeMouse, NativeMouseClickOptions, NativeMouseMoveOptions, NativePoint, NativeRegion, ScreenPoint } from './types.js';
+export type NativeRandomFunction = () => number;
+export type NativeSleepFunction = (ms: number) => Promise<void>;
+export type PathGenerator = (from: NativePoint, to: NativePoint, options?: {
+    moveSpeed?: number;
+}) => NativePoint[];
+export interface HumanizedNativeMouseOptions {
+    jitterPixels?: number;
+    minJitterPixels?: number;
+    moveSpeed?: number;
+    random?: NativeRandomFunction;
+    sleep?: NativeSleepFunction;
+    pathGenerator?: PathGenerator;
+    coordinateMapper: {
+        browserToScreen(point: BrowserPoint, options?: {
+            page?: PageLike;
+        }): Promise<ScreenPoint>;
+    };
+}
+export declare class HumanizedNativeMouse implements NativeMouse {
+    private readonly driver;
+    private readonly options;
+    private readonly random;
+    private readonly sleep;
+    private readonly pathGenerator;
+    private readonly jitterPixels;
+    private readonly minJitterPixels;
+    private readonly moveSpeed;
+    constructor(driver: NativeMouseDriver, options: HumanizedNativeMouseOptions);
+    moveTo(point: ScreenPoint, options?: NativeMouseMoveOptions): Promise<void>;
+    click(point: ScreenPoint, options?: NativeMouseClickOptions): Promise<void>;
+    clickRegion(region: NativeRegion, options?: NativeMouseClickOptions): Promise<void>;
+    clickBrowserPoint(page: PageLike, point: BrowserPoint, options?: NativeMouseClickOptions): Promise<void>;
+    private applyJitter;
+}
+//# sourceMappingURL=NativeMouse.d.ts.map

package/dist/native/NativeMouse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeMouse.d.ts","sourceRoot":"","sources":["../../src/native/NativeMouse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,uBAAuB,EACvB,sBAAsB,EACtB,WAAW,EACX,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,oBAAoB,GAAG,MAAM,MAAM,CAAC;AAChD,MAAM,MAAM,mBAAmB,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,WAAW,EAAE,CAAC;AAEpH,MAAM,WAAW,2BAA2B;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,gBAAgB,EAAE;QAChB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,QAAQ,CAAA;SAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;KAC3F,CAAC;CACH;AAkBD,qBAAa,oBAAqB,YAAW,WAAW;IAQ1C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAqB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPhF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;gBAElB,MAAM,EAAE,iBAAiB,EAAmB,OAAO,EAAE,2BAA2B;IASvG,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB/E,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/E,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvF,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlH,OAAO,CAAC,WAAW;CAapB"}

package/dist/native/NativeMouse.js

@@ -0,0 +1,82 @@
+import { path as ghostCursorPath } from 'ghost-cursor';
+import { clampPointToRegion, randomPointInRegion, roundPoint } from './utils/geometry.js';
+const defaultSleep = async (ms) => {
+    if (ms <= 0)
+        return;
+    await new Promise(resolve => setTimeout(resolve, ms));
+};
+function defaultPathGenerator(from, to, options) {
+    const pathOptions = options?.moveSpeed === undefined ? undefined : { moveSpeed: options.moveSpeed };
+    return ghostCursorPath(from, to, pathOptions);
+}
+function normalizeJitter(minJitterPixels, jitterPixels) {
+    const max = Math.max(0, jitterPixels ?? 3);
+    const min = Math.min(max, Math.max(0, minJitterPixels ?? Math.min(2, max)));
+    return { min, max };
+}
+export class HumanizedNativeMouse {
+    driver;
+    options;
+    random;
+    sleep;
+    pathGenerator;
+    jitterPixels;
+    minJitterPixels;
+    moveSpeed;
+    constructor(driver, options) {
+        this.driver = driver;
+        this.options = options;
+        this.random = options.random ?? Math.random;
+        this.sleep = options.sleep ?? defaultSleep;
+        this.pathGenerator = options.pathGenerator ?? defaultPathGenerator;
+        this.jitterPixels = options.jitterPixels ?? 3;
+        this.minJitterPixels = options.minJitterPixels ?? 2;
+        this.moveSpeed = options.moveSpeed;
+    }
+    async moveTo(point, options = {}) {
+        const current = await this.driver.getPosition();
+        const target = roundPoint(this.applyJitter(point, options));
+        if (options.disableHumanPath === true) {
+            await this.driver.move(target);
+            return;
+        }
+        const moveSpeed = options.moveSpeed ?? this.moveSpeed;
+        const route = this.pathGenerator(current, target, moveSpeed === undefined ? undefined : { moveSpeed });
+        const points = route.length === 0 ? [target] : route;
+        for (const [index, routePoint] of points.entries()) {
+            const isLast = index === points.length - 1;
+            const nextPoint = isLast ? target : roundPoint(this.applyJitter(routePoint, options));
+            await this.driver.move(nextPoint);
+        }
+    }
+    async click(point, options = {}) {
+        await this.moveTo(point, options);
+        await this.sleep(options.delayBeforeClickMs ?? 0);
+        await this.driver.click(options.button ?? 'left');
+        await this.sleep(options.delayAfterMoveMs ?? 0);
+    }
+    async clickRegion(region, options = {}) {
+        const padding = options.regionPaddingPx ?? 4;
+        const point = randomPointInRegion(region, this.random, padding);
+        const target = options.precise === true ? point : clampPointToRegion(this.applyJitter(point, options), region);
+        await this.click(roundPoint(target), { ...options, precise: true });
+    }
+    async clickBrowserPoint(page, point, options = {}) {
+        const screenPoint = await this.options.coordinateMapper.browserToScreen(point, { page });
+        await this.click(screenPoint, options);
+    }
+    applyJitter(point, options) {
+        if (options.precise === true)
+            return point;
+        const { min, max } = normalizeJitter(options.minJitterPixels ?? this.minJitterPixels, options.jitterPixels ?? this.jitterPixels);
+        if (max <= 0)
+            return point;
+        const distance = min + this.random() * (max - min);
+        const angle = this.random() * Math.PI * 2;
+        return {
+            x: point.x + Math.cos(angle) * distance,
+            y: point.y + Math.sin(angle) * distance
+        };
+    }
+}
+//# sourceMappingURL=NativeMouse.js.map

package/dist/native/NativeMouse.js.map

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

package/dist/native/NativeWindowService.d.ts

@@ -0,0 +1,31 @@
+import type { Logger } from '../logging/Logger.js';
+import type { NativeScreenDriver, NativeWindowDriver } from './drivers.js';
+import type { EnsureWindowInViewOptions, NativeImageFinder, NativeMouse, NativeWindowInfo, WaitOptions, WindowButtonOptions, WindowMatcher } from './types.js';
+export interface NativeWindowServiceDependencies {
+    driver: NativeWindowDriver;
+    screen: NativeScreenDriver;
+    mouse?: NativeMouse;
+    images?: NativeImageFinder;
+    logger?: Logger;
+    defaultTimeoutMs?: number;
+}
+export declare class DefaultNativeWindowService {
+    private readonly deps;
+    private readonly defaultTimeoutMs;
+    constructor(deps: NativeWindowServiceDependencies);
+    list(): Promise<NativeWindowInfo[]>;
+    find(matcher: WindowMatcher, options?: WaitOptions): Promise<NativeWindowInfo | null>;
+    waitFor(matcher: WindowMatcher, options?: WaitOptions): Promise<NativeWindowInfo>;
+    isOpen(matcher: WindowMatcher): Promise<boolean>;
+    focus(matcher: WindowMatcher): Promise<NativeWindowInfo>;
+    ensureInView(matcher: WindowMatcher, options?: EnsureWindowInViewOptions): Promise<NativeWindowInfo>;
+    setFullscreen(matcher: WindowMatcher, fullscreen: boolean, options?: WindowButtonOptions): Promise<void>;
+    toggleFullscreen(matcher: WindowMatcher, options?: WindowButtonOptions): Promise<void>;
+    minimize(matcher: WindowMatcher): Promise<void>;
+    restore(matcher: WindowMatcher): Promise<void>;
+    private findHandle;
+    private waitForHandle;
+    private refreshHandleInfo;
+    private clickWindowButtonTemplate;
+}
+//# sourceMappingURL=NativeWindowService.d.ts.map

package/dist/native/NativeWindowService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeWindowService.d.ts","sourceRoot":"","sources":["../../src/native/NativeWindowService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAsB,MAAM,cAAc,CAAC;AAG/F,OAAO,KAAK,EACV,yBAAyB,EACzB,iBAAiB,EACjB,WAAW,EAEX,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,0BAA0B;IAGzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAEb,IAAI,EAAE,+BAA+B;IAI5D,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAKnC,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAczF,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUrF,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhD,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUxD,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyCxG,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B5G,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB1F,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;YAKtC,UAAU;YAWV,aAAa;YAeb,iBAAiB;YAIjB,yBAAyB;CAiBxC"}