@jacques-ai/server 0.0.7-alpha.1

package/dist/window-manager/layouts.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Layout Calculations
+ *
+ * Functions to calculate window geometry for various tiling layouts.
+ * All calculations account for work area (excluding dock/taskbar).
+ */
+import type { WindowGeometry, TileLayout } from './types.js';
+/**
+ * Calculate window geometry for a tile position within a layout
+ *
+ * @param workArea - The usable work area of the display
+ * @param layout - The tile layout type
+ * @param position - The position index (0-based)
+ * @param total - Total number of windows being tiled
+ */
+export declare function calculateTileGeometry(workArea: WindowGeometry, layout: TileLayout, position: number, total: number): WindowGeometry;
+/**
+ * Determine the best layout for a given number of windows
+ *
+ * @param windowCount - Number of windows to tile
+ */
+export declare function suggestLayout(windowCount: number): TileLayout;
+/**
+ * Get the maximum windows supported by a layout
+ */
+export declare function getLayoutCapacity(layout: TileLayout): number;
+/**
+ * Validate that a layout can accommodate the given number of windows
+ */
+export declare function validateLayout(layout: TileLayout, windowCount: number): boolean;
+/**
+ * Calculate geometry for browser + terminal(s) layout
+ *
+ * @param workArea - The usable work area of the display
+ * @param layout - The browser layout type
+ * @returns Geometry for browser window and terminal window(s)
+ */
+export declare function calculateBrowserLayout(workArea: WindowGeometry, layout: 'browser-terminal' | 'browser-two-terminals'): {
+    browser: WindowGeometry;
+    terminals: WindowGeometry[];
+};
+//# sourceMappingURL=layouts.d.ts.map

package/dist/window-manager/layouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layouts.d.ts","sourceRoot":"","sources":["../../src/window-manager/layouts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7D;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,cAAc,CAmDhB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAQ7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAa5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAE/E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,kBAAkB,GAAG,uBAAuB,GACnD;IAAE,OAAO,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,cAAc,EAAE,CAAA;CAAE,CAwB1D"}

package/dist/window-manager/layouts.js

@@ -0,0 +1,133 @@
+/**
+ * Layout Calculations
+ *
+ * Functions to calculate window geometry for various tiling layouts.
+ * All calculations account for work area (excluding dock/taskbar).
+ */
+/**
+ * Calculate window geometry for a tile position within a layout
+ *
+ * @param workArea - The usable work area of the display
+ * @param layout - The tile layout type
+ * @param position - The position index (0-based)
+ * @param total - Total number of windows being tiled
+ */
+export function calculateTileGeometry(workArea, layout, position, total) {
+    const { x, y, width, height } = workArea;
+    switch (layout) {
+        case 'side-by-side': {
+            // 2 windows, split horizontally
+            const halfW = Math.floor(width / 2);
+            if (position === 0) {
+                return { x, y, width: halfW, height };
+            }
+            else {
+                // Right side gets remaining width (handles odd pixels)
+                return { x: x + halfW, y, width: width - halfW, height };
+            }
+        }
+        case 'thirds': {
+            // 3 windows, equal thirds
+            const thirdW = Math.floor(width / 3);
+            if (position === 0) {
+                return { x, y, width: thirdW, height };
+            }
+            else if (position === 1) {
+                return { x: x + thirdW, y, width: thirdW, height };
+            }
+            else {
+                // Last third gets remaining width (handles uneven division)
+                return { x: x + thirdW * 2, y, width: width - thirdW * 2, height };
+            }
+        }
+        case '2x2': {
+            // 4 windows in a 2x2 grid
+            const halfW = Math.floor(width / 2);
+            const halfH = Math.floor(height / 2);
+            const row = Math.floor(position / 2); // 0 or 1
+            const col = position % 2; // 0 or 1
+            // Handle odd pixels by giving extra to right/bottom
+            const cellW = col === 1 ? width - halfW : halfW;
+            const cellH = row === 1 ? height - halfH : halfH;
+            return {
+                x: x + col * halfW,
+                y: y + row * halfH,
+                width: cellW,
+                height: cellH,
+            };
+        }
+        default:
+            // Fallback: just return the full work area
+            return workArea;
+    }
+}
+/**
+ * Determine the best layout for a given number of windows
+ *
+ * @param windowCount - Number of windows to tile
+ */
+export function suggestLayout(windowCount) {
+    if (windowCount <= 2) {
+        return 'side-by-side';
+    }
+    else if (windowCount === 3) {
+        return 'thirds';
+    }
+    else {
+        return 'smart';
+    }
+}
+/**
+ * Get the maximum windows supported by a layout
+ */
+export function getLayoutCapacity(layout) {
+    switch (layout) {
+        case 'side-by-side':
+            return 2;
+        case 'thirds':
+            return 3;
+        case '2x2':
+            return 4;
+        case 'smart':
+            return 8;
+        default:
+            return 2;
+    }
+}
+/**
+ * Validate that a layout can accommodate the given number of windows
+ */
+export function validateLayout(layout, windowCount) {
+    return windowCount <= getLayoutCapacity(layout);
+}
+/**
+ * Calculate geometry for browser + terminal(s) layout
+ *
+ * @param workArea - The usable work area of the display
+ * @param layout - The browser layout type
+ * @returns Geometry for browser window and terminal window(s)
+ */
+export function calculateBrowserLayout(workArea, layout) {
+    const { x, y, width, height } = workArea;
+    if (layout === 'browser-terminal') {
+        // Browser takes 5/7, terminal takes 2/7
+        const browserW = Math.floor(width * 5 / 7);
+        const terminalW = width - browserW;
+        return {
+            browser: { x, y, width: browserW, height },
+            terminals: [{ x: x + browserW, y, width: terminalW, height }],
+        };
+    }
+    // browser-two-terminals: browser on left (5/7), two terminals stacked on right (2/7)
+    const browserW = Math.floor(width * 5 / 7);
+    const terminalW = width - browserW;
+    const halfH = Math.floor(height / 2);
+    return {
+        browser: { x, y, width: browserW, height },
+        terminals: [
+            { x: x + browserW, y, width: terminalW, height: halfH },
+            { x: x + browserW, y: y + halfH, width: terminalW, height: height - halfH },
+        ],
+    };
+}
+//# sourceMappingURL=layouts.js.map

package/dist/window-manager/layouts.js.map

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

package/dist/window-manager/linux-manager.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Linux Window Manager
+ *
+ * Implements window positioning and tiling using wmctrl and xrandr for X11.
+ * Note: Wayland does not support window positioning by design.
+ */
+import type { WindowManager, WindowGeometry, Display, TileLayout, PositionResult, TileResult } from './types.js';
+/**
+ * Linux Window Manager using wmctrl and xrandr
+ */
+export declare class LinuxWindowManager implements WindowManager {
+    private wmctrlAvailable;
+    private xdotoolAvailable;
+    getPlatform(): string;
+    isSupported(): boolean;
+    /**
+     * Check if wmctrl is available (lazy check)
+     */
+    private checkWmctrl;
+    /**
+     * Check if xdotool is available (lazy check)
+     */
+    private checkXdotool;
+    /**
+     * Get all displays using xrandr
+     */
+    getDisplays(): Promise<Display[]>;
+    /**
+     * Position a terminal window by its terminal key
+     */
+    positionWindow(terminalKey: string, geometry: WindowGeometry): Promise<PositionResult>;
+    /**
+     * Position a window by X11 window ID using wmctrl
+     */
+    private positionByWindowId;
+    /**
+     * Position a window by process ID
+     */
+    private positionByPid;
+    /**
+     * Tile multiple terminal windows
+     */
+    tileWindows(terminalKeys: string[], layout: TileLayout, display?: Display): Promise<TileResult>;
+}
+//# sourceMappingURL=linux-manager.d.ts.map

package/dist/window-manager/linux-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux-manager.d.ts","sourceRoot":"","sources":["../../src/window-manager/linux-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,OAAO,EACP,UAAU,EACV,cAAc,EACd,UAAU,EACX,MAAM,YAAY,CAAC;AAyBpB;;GAEG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACtD,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,gBAAgB,CAAwB;IAEhD,WAAW,IAAI,MAAM;IAIrB,WAAW,IAAI,OAAO;IAKtB;;OAEG;YACW,WAAW;IAOzB;;OAEG;YACW,YAAY;IAO1B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IA4EvC;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAuC5F;;OAEG;YACW,kBAAkB;IAsBhC;;OAEG;YACW,aAAa;IAuD3B;;OAEG;IACG,WAAW,CACf,YAAY,EAAE,MAAM,EAAE,EACtB,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,UAAU,CAAC;CAoEvB"}

package/dist/window-manager/linux-manager.js

@@ -0,0 +1,299 @@
+/**
+ * Linux Window Manager
+ *
+ * Implements window positioning and tiling using wmctrl and xrandr for X11.
+ * Note: Wayland does not support window positioning by design.
+ */
+import { exec as execCb } from 'child_process';
+import { promisify } from 'util';
+import { calculateAllSlots } from './smart-layouts.js';
+const execAsync = promisify(execCb);
+/**
+ * Check if a command exists on the system
+ */
+async function commandExists(cmd) {
+    try {
+        await execAsync(`which ${cmd}`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if running under Wayland
+ */
+function isWayland() {
+    return process.env.XDG_SESSION_TYPE === 'wayland' ||
+        process.env.WAYLAND_DISPLAY !== undefined;
+}
+/**
+ * Linux Window Manager using wmctrl and xrandr
+ */
+export class LinuxWindowManager {
+    wmctrlAvailable = null;
+    xdotoolAvailable = null;
+    getPlatform() {
+        return 'linux';
+    }
+    isSupported() {
+        // Linux is supported, but Wayland has limitations
+        return process.platform === 'linux';
+    }
+    /**
+     * Check if wmctrl is available (lazy check)
+     */
+    async checkWmctrl() {
+        if (this.wmctrlAvailable === null) {
+            this.wmctrlAvailable = await commandExists('wmctrl');
+        }
+        return this.wmctrlAvailable;
+    }
+    /**
+     * Check if xdotool is available (lazy check)
+     */
+    async checkXdotool() {
+        if (this.xdotoolAvailable === null) {
+            this.xdotoolAvailable = await commandExists('xdotool');
+        }
+        return this.xdotoolAvailable;
+    }
+    /**
+     * Get all displays using xrandr
+     */
+    async getDisplays() {
+        if (isWayland()) {
+            // Wayland doesn't provide standard display enumeration
+            // Return a single display with estimated dimensions
+            return [
+                {
+                    id: 'wayland-primary',
+                    bounds: { x: 0, y: 0, width: 1920, height: 1080 },
+                    workArea: { x: 0, y: 0, width: 1920, height: 1080 },
+                    isPrimary: true,
+                },
+            ];
+        }
+        try {
+            const { stdout } = await execAsync('xrandr --query');
+            const displays = [];
+            // Parse xrandr output
+            // Example: "DP-1 connected primary 2560x1440+0+0 (normal left inverted right x axis y axis)"
+            const lines = stdout.split('\n');
+            let displayIndex = 0;
+            for (const line of lines) {
+                const match = line.match(/^(\S+)\s+connected\s*(primary)?\s*(\d+)x(\d+)\+(\d+)\+(\d+)/);
+                if (match) {
+                    const [, name, primary, width, height, x, y] = match;
+                    displays.push({
+                        id: name,
+                        bounds: {
+                            x: parseInt(x, 10),
+                            y: parseInt(y, 10),
+                            width: parseInt(width, 10),
+                            height: parseInt(height, 10),
+                        },
+                        workArea: {
+                            // Estimate work area (subtract common panel sizes)
+                            x: parseInt(x, 10),
+                            y: parseInt(y, 10) + 28, // Assume 28px top panel
+                            width: parseInt(width, 10),
+                            height: parseInt(height, 10) - 28,
+                        },
+                        isPrimary: primary === 'primary' || displayIndex === 0,
+                    });
+                    displayIndex++;
+                }
+            }
+            if (displays.length === 0) {
+                // Fallback
+                return [
+                    {
+                        id: 'primary',
+                        bounds: { x: 0, y: 0, width: 1920, height: 1080 },
+                        workArea: { x: 0, y: 28, width: 1920, height: 1052 },
+                        isPrimary: true,
+                    },
+                ];
+            }
+            return displays;
+        }
+        catch {
+            // Fallback to reasonable defaults
+            return [
+                {
+                    id: 'primary',
+                    bounds: { x: 0, y: 0, width: 1920, height: 1080 },
+                    workArea: { x: 0, y: 28, width: 1920, height: 1052 },
+                    isPrimary: true,
+                },
+            ];
+        }
+    }
+    /**
+     * Position a terminal window by its terminal key
+     */
+    async positionWindow(terminalKey, geometry) {
+        if (isWayland()) {
+            return {
+                success: false,
+                error: 'Window positioning is not supported on Wayland. Use your compositor\'s built-in tiling.',
+            };
+        }
+        const hasWmctrl = await this.checkWmctrl();
+        if (!hasWmctrl) {
+            return {
+                success: false,
+                error: 'wmctrl not installed. Install with: sudo apt install wmctrl',
+            };
+        }
+        const colonIndex = terminalKey.indexOf(':');
+        if (colonIndex === -1) {
+            return { success: false, error: `Invalid terminal key format: ${terminalKey}` };
+        }
+        const prefix = terminalKey.substring(0, colonIndex);
+        const value = terminalKey.substring(colonIndex + 1);
+        switch (prefix) {
+            case 'PID':
+                return this.positionByPid(value, geometry);
+            case 'WINDOWID':
+            case 'X11':
+                return this.positionByWindowId(value, geometry);
+            default:
+                // Try PID-based positioning as fallback
+                if (/^\d+$/.test(value)) {
+                    return this.positionByPid(value, geometry);
+                }
+                return { success: false, error: `Unsupported terminal key prefix: ${prefix}` };
+        }
+    }
+    /**
+     * Position a window by X11 window ID using wmctrl
+     */
+    async positionByWindowId(windowId, geometry) {
+        const { x, y, width, height } = geometry;
+        try {
+            // wmctrl -e format: gravity,x,y,width,height
+            // gravity 0 means use current gravity
+            await execAsync(`wmctrl -i -r ${windowId} -e 0,${x},${y},${width},${height}`);
+            // Activate the window
+            await execAsync(`wmctrl -i -a ${windowId}`);
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    /**
+     * Position a window by process ID
+     */
+    async positionByPid(pid, geometry) {
+        const { x, y, width, height } = geometry;
+        try {
+            // First, try to find the window ID for this PID using wmctrl
+            const { stdout } = await execAsync('wmctrl -l -p');
+            // Parse wmctrl output to find window with matching PID
+            // Format: 0x0400006  0 12345  hostname Window Title
+            const lines = stdout.split('\n');
+            let windowId = null;
+            for (const line of lines) {
+                const match = line.match(/^(0x[\da-f]+)\s+\d+\s+(\d+)/i);
+                if (match && match[2] === pid) {
+                    windowId = match[1];
+                    break;
+                }
+            }
+            // If not found directly, try xdotool to search by PID
+            if (!windowId) {
+                const hasXdotool = await this.checkXdotool();
+                if (hasXdotool) {
+                    try {
+                        const { stdout: xdoResult } = await execAsync(`xdotool search --pid ${pid}`);
+                        const ids = xdoResult.trim().split('\n').filter(Boolean);
+                        if (ids.length > 0) {
+                            // Convert decimal to hex for wmctrl
+                            windowId = '0x' + parseInt(ids[0], 10).toString(16);
+                        }
+                    }
+                    catch {
+                        // xdotool search failed
+                    }
+                }
+            }
+            if (!windowId) {
+                return { success: false, error: `No window found for PID ${pid}` };
+            }
+            // Position using wmctrl
+            await execAsync(`wmctrl -i -r ${windowId} -e 0,${x},${y},${width},${height}`);
+            // Activate the window
+            await execAsync(`wmctrl -i -a ${windowId}`);
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    /**
+     * Tile multiple terminal windows
+     */
+    async tileWindows(terminalKeys, layout, display) {
+        if (terminalKeys.length === 0) {
+            return { success: true, positioned: 0, total: 0 };
+        }
+        if (isWayland()) {
+            return {
+                success: false,
+                positioned: 0,
+                total: terminalKeys.length,
+                errors: ['Window tiling is not supported on Wayland. Use your compositor\'s built-in tiling.'],
+            };
+        }
+        const hasWmctrl = await this.checkWmctrl();
+        if (!hasWmctrl) {
+            return {
+                success: false,
+                positioned: 0,
+                total: terminalKeys.length,
+                errors: ['wmctrl not installed. Install with: sudo apt install wmctrl'],
+            };
+        }
+        // Get display info
+        const displays = await this.getDisplays();
+        const targetDisplay = display || displays.find(d => d.isPrimary) || displays[0];
+        if (!targetDisplay) {
+            return {
+                success: false,
+                positioned: 0,
+                total: terminalKeys.length,
+                errors: ['No display available'],
+            };
+        }
+        // Use smart layout engine for all window counts (consistent with tile state)
+        const allSlots = calculateAllSlots(targetDisplay.workArea, terminalKeys.length);
+        const errors = [];
+        let positioned = 0;
+        // Position each window
+        for (let i = 0; i < terminalKeys.length; i++) {
+            const terminalKey = terminalKeys[i];
+            const geometry = allSlots[i].geometry;
+            const result = await this.positionWindow(terminalKey, geometry);
+            if (result.success) {
+                positioned++;
+            }
+            else if (result.error) {
+                errors.push(`${terminalKey}: ${result.error}`);
+            }
+            // Small delay between windows
+            if (i < terminalKeys.length - 1) {
+                await new Promise(resolve => setTimeout(resolve, 50));
+            }
+        }
+        return {
+            success: positioned === terminalKeys.length,
+            positioned,
+            total: terminalKeys.length,
+            errors: errors.length > 0 ? errors : undefined,
+        };
+    }
+}
+//# sourceMappingURL=linux-manager.js.map

package/dist/window-manager/linux-manager.js.map

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

package/dist/window-manager/macos-manager.d.ts

@@ -0,0 +1,103 @@
+/**
+ * macOS Window Manager
+ *
+ * Implements window positioning and tiling using AppleScript.
+ * Supports iTerm2, Terminal.app, and PID-based fallback.
+ */
+import type { WindowManager, WindowGeometry, Display, TileLayout, PositionResult, TileResult } from './types.js';
+/**
+ * macOS Window Manager using AppleScript
+ */
+export declare class MacOSWindowManager implements WindowManager {
+    getPlatform(): string;
+    isSupported(): boolean;
+    /**
+     * Get all displays using NSScreen via JXA (JavaScript for Automation).
+     * Falls back to Finder AppleScript (primary only) if JXA fails.
+     */
+    getDisplays(): Promise<Display[]>;
+    /**
+     * Enumerate all displays via JXA using NSScreen.
+     * Returns displays with screen coordinates (top-left origin, Y-down).
+     */
+    private getDisplaysViaJXA;
+    /**
+     * Fallback: get primary display via Finder AppleScript
+     */
+    private getDisplaysViaFinder;
+    private defaultDisplay;
+    /**
+     * Position a terminal window by its terminal key.
+     * Handles DISCOVERED: wrapper by extracting the inner terminal type.
+     */
+    positionWindow(terminalKey: string, geometry: WindowGeometry): Promise<PositionResult>;
+    /**
+     * Position an iTerm2 window by session UUID
+     */
+    private positionITerm;
+    /**
+     * Position a Terminal.app window by TTY path
+     */
+    private positionTerminalApp;
+    /**
+     * Find a TTY across all known terminal apps and position the window.
+     * Tries iTerm2 first (most common for discovered sessions), then Terminal.app.
+     */
+    private findAndPositionByTTY;
+    /**
+     * Find a TTY across all known terminal apps and return window bounds.
+     * Tries iTerm2 first, then Terminal.app.
+     */
+    private findBoundsByTTY;
+    /**
+     * Position a window by process ID using System Events
+     * Note: This is app-level only (cannot select specific tabs)
+     */
+    private positionByPid;
+    /**
+     * Resolve a TTY device path from a PID using lsof.
+     * Useful when ps returns ?? but the process has a controlling TTY.
+     */
+    private resolveTtyFromPid;
+    /**
+     * Resolve a PID to a positioned window via TTY lookup with PID fallback.
+     * Chain: PID → lsof → TTY → iTerm/Terminal.app (tab-specific) → PID app-level
+     */
+    private resolveAndPositionByPid;
+    /**
+     * Resolve a PID to window bounds via TTY lookup.
+     * Chain: PID → lsof → TTY → findBoundsByTTY
+     */
+    private resolveBoundsByPid;
+    /**
+     * Position the browser window showing the Jacques GUI.
+     * Searches for a window with "Jacques" in its title across common browsers.
+     */
+    positionBrowserWindow(geometry: WindowGeometry): Promise<PositionResult>;
+    /**
+     * Get current bounds of a terminal window.
+     * Returns null if bounds cannot be determined.
+     * Handles DISCOVERED: wrapper by extracting the inner terminal type.
+     */
+    private getWindowBounds;
+    /**
+     * Detect which display contains the center point of the given bounds.
+     * Returns the matching display, or null if no display contains the center.
+     */
+    private detectDisplayForBounds;
+    /**
+     * Auto-detect the best display for tiling based on where windows currently are.
+     * Uses majority vote: tiles on the display with the most windows.
+     */
+    private detectTargetDisplay;
+    /**
+     * Get the target display for a set of terminal windows using majority vote.
+     * Returns the display with the most terminal windows, or primary display as fallback.
+     */
+    getTargetDisplayForTerminals(terminalKeys: string[]): Promise<Display | null>;
+    /**
+     * Tile multiple terminal windows
+     */
+    tileWindows(terminalKeys: string[], layout: TileLayout, display?: Display): Promise<TileResult>;
+}
+//# sourceMappingURL=macos-manager.d.ts.map

package/dist/window-manager/macos-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"macos-manager.d.ts","sourceRoot":"","sources":["../../src/window-manager/macos-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,OAAO,EACP,UAAU,EACV,cAAc,EACd,UAAU,EACX,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACtD,WAAW,IAAI,MAAM;IAIrB,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAavC;;;OAGG;YACW,iBAAiB;IAoD/B;;OAEG;YACW,oBAAoB;IAwBlC,OAAO,CAAC,cAAc;IAStB;;;OAGG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAuC5F;;OAEG;YACW,aAAa;IA2C3B;;OAEG;YACW,mBAAmB;IAwCjC;;;OAGG;YACW,oBAAoB;IAwClC;;;OAGG;YACW,eAAe;IA8D7B;;;OAGG;YACW,aAAa;IA+B3B;;;OAGG;YACW,iBAAiB;IAa/B;;;OAGG;YACW,uBAAuB;IAWrC;;;OAGG;YACW,kBAAkB;IAQhC;;;OAGG;IACG,qBAAqB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAwC9E;;;;OAIG;YACW,eAAe;IAiE7B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;;OAGG;YACW,mBAAmB;IA8BjC;;;OAGG;IACG,4BAA4B,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAOnF;;OAEG;IACG,WAAW,CACf,YAAY,EAAE,MAAM,EAAE,EACtB,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,UAAU,CAAC;CA8DvB"}