@backbay/glia 0.2.0-alpha.1

package/dist/desktop/core/shell/types.d.ts

@@ -0,0 +1,169 @@
+/**
+ * @backbay/glia Desktop OS - Shell Types
+ *
+ * Types for the shell layer (taskbar, start menu, context menu).
+ */
+import type { WindowId } from '../window/types';
+/**
+ * Taskbar button position for minimize/restore animations.
+ */
+export interface TaskbarButtonPosition {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Taskbar item representing an app on the taskbar.
+ */
+export interface TaskbarItem {
+    id: string;
+    windowId?: WindowId;
+    appId: string;
+    title: string;
+    icon?: string;
+    isPinned: boolean;
+    isActive: boolean;
+}
+/**
+ * Preview state for taskbar hover.
+ */
+export interface TaskbarPreviewState {
+    windowId: WindowId;
+    anchorRect: TaskbarButtonPosition;
+    icon?: string;
+}
+/**
+ * Return type for the useTaskbar hook.
+ */
+export interface UseTaskbarReturn {
+    /** All taskbar items (pinned + running) */
+    items: TaskbarItem[];
+    /** Currently active window ID */
+    activeWindowId: WindowId | null;
+    /** Preview hover state */
+    previewState: TaskbarPreviewState | null;
+    /** Button positions for animation targeting */
+    buttonPositions: Map<string, TaskbarButtonPosition>;
+    /** Register a taskbar button position */
+    registerButtonPosition: (id: string, position: TaskbarButtonPosition) => void;
+    /** Unregister a taskbar button position */
+    unregisterButtonPosition: (id: string) => void;
+    /** Get center of a button for animation */
+    getButtonCenter: (id: string) => {
+        x: number;
+        y: number;
+    } | undefined;
+    /** Pin an app to the taskbar */
+    pin: (appId: string) => void;
+    /** Unpin an app from the taskbar */
+    unpin: (appId: string) => void;
+    /** Start hover preview */
+    startPreviewHover: (windowId: WindowId, icon?: string) => void;
+    /** End hover preview */
+    endPreviewHover: () => void;
+    /** Cancel hide preview (when moving to preview) */
+    cancelHidePreview: () => void;
+    /** Immediately hide preview */
+    hidePreview: () => void;
+}
+/**
+ * Context menu target type.
+ */
+export type ContextMenuTargetType = 'desktop' | 'window' | 'taskbar' | 'taskbar-button' | 'icon';
+/**
+ * Context menu target identifying what was right-clicked.
+ */
+export interface ContextMenuTarget {
+    type: ContextMenuTargetType;
+    id?: string;
+    data?: Record<string, unknown>;
+}
+/**
+ * Context menu item.
+ */
+export interface ContextMenuItem {
+    id: string;
+    label: string;
+    icon?: string;
+    shortcut?: string;
+    disabled?: boolean;
+    danger?: boolean;
+    separator?: boolean;
+    children?: ContextMenuItem[];
+    action?: () => void;
+}
+/**
+ * Return type for the useContextMenu hook.
+ */
+export interface UseContextMenuReturn {
+    /** Whether menu is open */
+    isOpen: boolean;
+    /** Menu position */
+    position: {
+        x: number;
+        y: number;
+    };
+    /** What was right-clicked */
+    target: ContextMenuTarget | null;
+    /** Menu items to display */
+    items: ContextMenuItem[];
+    /** Show the context menu */
+    show: (e: React.MouseEvent, target: ContextMenuTarget, items: ContextMenuItem[]) => void;
+    /** Hide the context menu */
+    hide: () => void;
+}
+/**
+ * Start menu category.
+ */
+export interface StartMenuCategory {
+    id: string;
+    label: string;
+    icon?: string;
+}
+/**
+ * Start menu app item.
+ */
+export interface StartMenuApp {
+    id: string;
+    name: string;
+    icon?: string;
+    categoryId: string;
+    description?: string;
+    pinned?: boolean;
+    recent?: boolean;
+}
+/**
+ * Return type for the useStartMenu hook.
+ */
+export interface UseStartMenuReturn {
+    /** Whether menu is open */
+    isOpen: boolean;
+    /** All app categories */
+    categories: StartMenuCategory[];
+    /** All apps */
+    apps: StartMenuApp[];
+    /** Pinned apps */
+    pinnedApps: StartMenuApp[];
+    /** Recent apps */
+    recentApps: StartMenuApp[];
+    /** Search query */
+    searchQuery: string;
+    /** Filtered apps based on search */
+    filteredApps: StartMenuApp[];
+    /** Open the start menu */
+    open: () => void;
+    /** Close the start menu */
+    close: () => void;
+    /** Toggle the start menu */
+    toggle: () => void;
+    /** Set search query */
+    setSearchQuery: (query: string) => void;
+    /** Launch an app */
+    launchApp: (appId: string) => void;
+    /** Pin an app */
+    pinApp: (appId: string) => void;
+    /** Unpin an app */
+    unpinApp: (appId: string) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/desktop/core/shell/types.d.ts.map

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

package/dist/desktop/core/shell/types.js

@@ -0,0 +1,6 @@
+/**
+ * @backbay/glia Desktop OS - Shell Types
+ *
+ * Types for the shell layer (taskbar, start menu, context menu).
+ */
+export {};

package/dist/desktop/core/shell/useTaskbar.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @backbay/glia Desktop OS - useTaskbar Hook
+ *
+ * Taskbar state management for button positions and hover previews.
+ * Used for minimize/restore animations and window preview tooltips.
+ */
+import type { WindowId } from '../window/types';
+import type { TaskbarButtonPosition, TaskbarPreviewState, UseTaskbarReturn } from './types';
+interface TaskbarStore {
+    buttonPositions: Map<string, TaskbarButtonPosition>;
+    previewState: TaskbarPreviewState | null;
+    pinnedApps: string[];
+    _showPreviewTimeout: ReturnType<typeof setTimeout> | null;
+    _hidePreviewTimeout: ReturnType<typeof setTimeout> | null;
+    registerButtonPosition: (id: string, position: TaskbarButtonPosition) => void;
+    unregisterButtonPosition: (id: string) => void;
+    getButtonPosition: (id: string) => TaskbarButtonPosition | undefined;
+    getButtonCenter: (id: string) => {
+        x: number;
+        y: number;
+    } | undefined;
+    startPreviewHover: (windowId: WindowId, icon?: string) => void;
+    endPreviewHover: () => void;
+    cancelHidePreview: () => void;
+    hidePreview: () => void;
+    pinApp: (appId: string) => void;
+    unpinApp: (appId: string) => void;
+}
+export declare const useTaskbarStore: import("zustand").UseBoundStore<import("zustand").StoreApi<TaskbarStore>>;
+/**
+ * Hook for taskbar state management.
+ *
+ * Handles button position tracking for animations and hover preview state.
+ *
+ * @example
+ * ```tsx
+ * const { registerButtonPosition, startPreviewHover, endPreviewHover } = useTaskbar();
+ *
+ * // Register button position on mount
+ * useEffect(() => {
+ *   const rect = buttonRef.current?.getBoundingClientRect();
+ *   if (rect) {
+ *     registerButtonPosition(windowId, {
+ *       x: rect.x, y: rect.y, width: rect.width, height: rect.height
+ *     });
+ *   }
+ * }, []);
+ *
+ * // Handle hover
+ * <button
+ *   onMouseEnter={() => startPreviewHover(windowId)}
+ *   onMouseLeave={endPreviewHover}
+ * >
+ *   {title}
+ * </button>
+ * ```
+ */
+export declare function useTaskbar(windows?: Array<{
+    id: string;
+    appId: string;
+    title: string;
+    icon?: string;
+}>, activeWindowId?: WindowId | null): UseTaskbarReturn;
+export {};
+//# sourceMappingURL=useTaskbar.d.ts.map

package/dist/desktop/core/shell/useTaskbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTaskbar.d.ts","sourceRoot":"","sources":["../../../../src/desktop/core/shell/useTaskbar.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EAEnB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAgBjB,UAAU,YAAY;IACpB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACpD,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACzC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mBAAmB,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IAC1D,mBAAmB,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IAE1D,sBAAsB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC9E,wBAAwB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,iBAAiB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,qBAAqB,GAAG,SAAS,CAAC;IACrE,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAEtE,iBAAiB,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,IAAI,CAAC;IAExB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAMD,eAAO,MAAM,eAAe,2EA+HzB,CAAC;AAMJ;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,UAAU,CACxB,OAAO,GAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAM,EAChF,cAAc,GAAE,QAAQ,GAAG,IAAW,GACrC,gBAAgB,CAqElB"}

package/dist/desktop/core/shell/useTaskbar.js

@@ -0,0 +1,221 @@
+/**
+ * @backbay/glia Desktop OS - useTaskbar Hook
+ *
+ * Taskbar state management for button positions and hover previews.
+ * Used for minimize/restore animations and window preview tooltips.
+ */
+import { useMemo } from 'react';
+import { create } from 'zustand';
+import { useShallow } from 'zustand/react/shallow';
+// ═══════════════════════════════════════════════════════════════════════════
+// Constants
+// ═══════════════════════════════════════════════════════════════════════════
+/** Delay before showing preview (ms) */
+const PREVIEW_SHOW_DELAY = 200;
+/** Delay before hiding preview - allows moving to preview (ms) */
+const PREVIEW_HIDE_DELAY = 100;
+// ═══════════════════════════════════════════════════════════════════════════
+// Store Implementation
+// ═══════════════════════════════════════════════════════════════════════════
+export const useTaskbarStore = create((set, get) => ({
+    buttonPositions: new Map(),
+    previewState: null,
+    pinnedApps: [],
+    _showPreviewTimeout: null,
+    _hidePreviewTimeout: null,
+    registerButtonPosition: (id, position) => {
+        set((state) => {
+            const newPositions = new Map(state.buttonPositions);
+            newPositions.set(id, position);
+            return { buttonPositions: newPositions };
+        });
+    },
+    unregisterButtonPosition: (id) => {
+        set((state) => {
+            const newPositions = new Map(state.buttonPositions);
+            newPositions.delete(id);
+            return { buttonPositions: newPositions };
+        });
+    },
+    getButtonPosition: (id) => {
+        return get().buttonPositions.get(id);
+    },
+    getButtonCenter: (id) => {
+        const pos = get().buttonPositions.get(id);
+        if (!pos)
+            return undefined;
+        return {
+            x: pos.x + pos.width / 2,
+            y: pos.y + pos.height / 2,
+        };
+    },
+    startPreviewHover: (windowId, icon) => {
+        const state = get();
+        // Clear any pending hide timeout
+        if (state._hidePreviewTimeout) {
+            clearTimeout(state._hidePreviewTimeout);
+            set({ _hidePreviewTimeout: null });
+        }
+        // Clear any pending show timeout
+        if (state._showPreviewTimeout) {
+            clearTimeout(state._showPreviewTimeout);
+        }
+        // Start show timeout
+        const timeout = setTimeout(() => {
+            const currentState = get();
+            const anchorRect = currentState.buttonPositions.get(windowId);
+            if (anchorRect) {
+                set({
+                    previewState: { windowId, anchorRect, icon },
+                    _showPreviewTimeout: null,
+                });
+            }
+        }, PREVIEW_SHOW_DELAY);
+        set({ _showPreviewTimeout: timeout });
+    },
+    endPreviewHover: () => {
+        const state = get();
+        // Clear any pending show timeout
+        if (state._showPreviewTimeout) {
+            clearTimeout(state._showPreviewTimeout);
+            set({ _showPreviewTimeout: null });
+        }
+        // Start hide timeout (allows user to move mouse to preview)
+        if (state._hidePreviewTimeout) {
+            clearTimeout(state._hidePreviewTimeout);
+        }
+        const timeout = setTimeout(() => {
+            set({ previewState: null, _hidePreviewTimeout: null });
+        }, PREVIEW_HIDE_DELAY);
+        set({ _hidePreviewTimeout: timeout });
+    },
+    cancelHidePreview: () => {
+        const state = get();
+        // Cancel any pending hide timeout (when user hovers over preview)
+        if (state._hidePreviewTimeout) {
+            clearTimeout(state._hidePreviewTimeout);
+            set({ _hidePreviewTimeout: null });
+        }
+    },
+    hidePreview: () => {
+        const state = get();
+        // Clear all timeouts
+        if (state._showPreviewTimeout) {
+            clearTimeout(state._showPreviewTimeout);
+        }
+        if (state._hidePreviewTimeout) {
+            clearTimeout(state._hidePreviewTimeout);
+        }
+        set({
+            previewState: null,
+            _showPreviewTimeout: null,
+            _hidePreviewTimeout: null,
+        });
+    },
+    pinApp: (appId) => {
+        set((state) => ({
+            pinnedApps: state.pinnedApps.includes(appId)
+                ? state.pinnedApps
+                : [...state.pinnedApps, appId],
+        }));
+    },
+    unpinApp: (appId) => {
+        set((state) => ({
+            pinnedApps: state.pinnedApps.filter((id) => id !== appId),
+        }));
+    },
+}));
+// ═══════════════════════════════════════════════════════════════════════════
+// Public Hook
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Hook for taskbar state management.
+ *
+ * Handles button position tracking for animations and hover preview state.
+ *
+ * @example
+ * ```tsx
+ * const { registerButtonPosition, startPreviewHover, endPreviewHover } = useTaskbar();
+ *
+ * // Register button position on mount
+ * useEffect(() => {
+ *   const rect = buttonRef.current?.getBoundingClientRect();
+ *   if (rect) {
+ *     registerButtonPosition(windowId, {
+ *       x: rect.x, y: rect.y, width: rect.width, height: rect.height
+ *     });
+ *   }
+ * }, []);
+ *
+ * // Handle hover
+ * <button
+ *   onMouseEnter={() => startPreviewHover(windowId)}
+ *   onMouseLeave={endPreviewHover}
+ * >
+ *   {title}
+ * </button>
+ * ```
+ */
+export function useTaskbar(windows = [], activeWindowId = null) {
+    const store = useTaskbarStore(useShallow((state) => ({
+        buttonPositions: state.buttonPositions,
+        previewState: state.previewState,
+        pinnedApps: state.pinnedApps,
+        registerButtonPosition: state.registerButtonPosition,
+        unregisterButtonPosition: state.unregisterButtonPosition,
+        getButtonCenter: state.getButtonCenter,
+        startPreviewHover: state.startPreviewHover,
+        endPreviewHover: state.endPreviewHover,
+        cancelHidePreview: state.cancelHidePreview,
+        hidePreview: state.hidePreview,
+        pinApp: state.pinApp,
+        unpinApp: state.unpinApp,
+    })));
+    // Build taskbar items from windows and pinned apps (memoized to prevent unnecessary re-renders)
+    const items = useMemo(() => {
+        const result = [];
+        // Add pinned apps (even if not running)
+        for (const appId of store.pinnedApps) {
+            const runningWindow = windows.find((w) => w.appId === appId);
+            result.push({
+                id: runningWindow?.id ?? `pinned-${appId}`,
+                windowId: runningWindow?.id,
+                appId,
+                title: runningWindow?.title ?? appId,
+                icon: runningWindow?.icon,
+                isPinned: true,
+                isActive: runningWindow?.id === activeWindowId,
+            });
+        }
+        // Add running windows that aren't pinned
+        for (const window of windows) {
+            if (!store.pinnedApps.includes(window.appId)) {
+                result.push({
+                    id: window.id,
+                    windowId: window.id,
+                    appId: window.appId,
+                    title: window.title,
+                    icon: window.icon,
+                    isPinned: false,
+                    isActive: window.id === activeWindowId,
+                });
+            }
+        }
+        return result;
+    }, [windows, store.pinnedApps, activeWindowId]);
+    return {
+        items,
+        activeWindowId,
+        previewState: store.previewState,
+        buttonPositions: store.buttonPositions,
+        registerButtonPosition: store.registerButtonPosition,
+        unregisterButtonPosition: store.unregisterButtonPosition,
+        getButtonCenter: store.getButtonCenter,
+        pin: store.pinApp,
+        unpin: store.unpinApp,
+        startPreviewHover: store.startPreviewHover,
+        endPreviewHover: store.endPreviewHover,
+        cancelHidePreview: store.cancelHidePreview,
+        hidePreview: store.hidePreview,
+    };
+}

package/dist/desktop/core/window/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @backbay/glia Desktop OS - Window Core
+ */
+export * from './types';
+export * from './useWindowManager';
+//# sourceMappingURL=index.d.ts.map

package/dist/desktop/core/window/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/desktop/core/window/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC"}

package/dist/desktop/core/window/index.js

@@ -0,0 +1,5 @@
+/**
+ * @backbay/glia Desktop OS - Window Core
+ */
+export * from './types';
+export * from './useWindowManager';

package/dist/desktop/core/window/types.d.ts

@@ -0,0 +1,167 @@
+/**
+ * @backbay/glia Desktop OS - Window Types
+ *
+ * Core types for window management. These types are designed to be
+ * framework-agnostic and work with both provider-managed and standalone modes.
+ */
+export type WindowId = string;
+/**
+ * Tile positions for snapping windows to screen edges/corners.
+ * Based on Hyprland-style tiling behavior.
+ */
+export type TilePosition = 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+/**
+ * Window state representing a single window instance.
+ */
+export interface WindowState {
+    id: WindowId;
+    title: string;
+    icon?: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    size: {
+        width: number;
+        height: number;
+    };
+    minSize?: {
+        width: number;
+        height: number;
+    };
+    maxSize?: {
+        width: number;
+        height: number;
+    };
+    isMinimized: boolean;
+    isMaximized: boolean;
+    isFullscreen: boolean;
+    isFocused: boolean;
+    zIndex: number;
+    /** Tile position if window is snapped to an edge */
+    tilePosition?: TilePosition;
+    /** Group ID if window is part of a tab group */
+    groupId?: string;
+    /** Whether this is the active tab in its group */
+    isGroupActive?: boolean;
+    /** Pre-maximize position for restore */
+    preMaximize?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Pre-fullscreen position for restore */
+    preFullscreen?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Pre-tile position for restore */
+    preTile?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Window group representing a tab group of windows.
+ */
+export interface WindowGroup {
+    id: string;
+    windowIds: WindowId[];
+    activeWindowId: WindowId;
+}
+/**
+ * Configuration for opening a new window.
+ */
+export interface WindowOpenConfig {
+    title: string;
+    icon?: string;
+    position?: {
+        x: number;
+        y: number;
+    };
+    size?: {
+        width: number;
+        height: number;
+    };
+    minSize?: {
+        width: number;
+        height: number;
+    };
+    maxSize?: {
+        width: number;
+        height: number;
+    };
+    isMinimized?: boolean;
+    isMaximized?: boolean;
+}
+/**
+ * Return type for the useWindowManager hook.
+ */
+export interface UseWindowManagerReturn {
+    /** All windows in the system */
+    windows: WindowState[];
+    /** Currently focused window ID */
+    focusedId: WindowId | null;
+    /** Window currently in fullscreen mode */
+    fullscreenId: WindowId | null;
+    /** All window groups */
+    groups: WindowGroup[];
+    /** Open a new window and return its ID */
+    open: (config: WindowOpenConfig) => WindowId;
+    /** Close a window by ID */
+    close: (id: WindowId) => void;
+    /** Focus a window by ID */
+    focus: (id: WindowId) => void;
+    /** Cycle focus to the next window */
+    cycleFocusNext: () => void;
+    /** Minimize a window */
+    minimize: (id: WindowId) => void;
+    /** Maximize a window */
+    maximize: (id: WindowId) => void;
+    /** Restore a window from minimized/maximized state */
+    restore: (id: WindowId) => void;
+    /** Enter fullscreen mode */
+    fullscreen: (id: WindowId) => void;
+    /** Exit fullscreen mode */
+    exitFullscreen: () => void;
+    /** Move a window to a new position */
+    move: (id: WindowId, position: {
+        x: number;
+        y: number;
+    }) => void;
+    /** Resize a window */
+    resize: (id: WindowId, size: {
+        width: number;
+        height: number;
+    }) => void;
+    /** Tile a window to a screen position */
+    tile: (id: WindowId, position: TilePosition) => void;
+    /** Untile a window */
+    untile: (id: WindowId) => void;
+    /** Create a new group from two windows */
+    createGroup: (windowId1: WindowId, windowId2: WindowId) => string | null;
+    /** Add a window to an existing group */
+    addToGroup: (groupId: string, windowId: WindowId) => void;
+    /** Remove a window from its group */
+    removeFromGroup: (windowId: WindowId) => void;
+    /** Set the active tab in a group */
+    setActiveTab: (groupId: string, windowId: WindowId) => void;
+    /** Minimize all windows */
+    minimizeAll: () => void;
+    /** Close all windows */
+    closeAll: () => void;
+    /** Cascade all windows */
+    cascade: () => void;
+    /** Tile all windows in a layout */
+    tileAll: (layout: 'horizontal' | 'vertical' | 'grid') => void;
+    /** Get a single window by ID */
+    getWindow: (id: WindowId) => WindowState | undefined;
+    /** Get the group a window belongs to */
+    getWindowGroup: (windowId: WindowId) => WindowGroup | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/desktop/core/window/types.d.ts.map

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

package/dist/desktop/core/window/types.js

@@ -0,0 +1,7 @@
+/**
+ * @backbay/glia Desktop OS - Window Types
+ *
+ * Core types for window management. These types are designed to be
+ * framework-agnostic and work with both provider-managed and standalone modes.
+ */
+export {};