@backbay/glia 0.2.0-alpha.1

package/dist/desktop/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @backbay/glia Desktop OS
+ *
+ * Reusable desktop OS components for React applications.
+ * Includes window management, taskbar, context menus, and more.
+ *
+ * @example Basic usage with provider
+ * ```tsx
+ * import { DesktopOSProvider, Window, Taskbar, Desktop } from '@backbay/glia/desktop';
+ *
+ * function App() {
+ *   return (
+ *     <DesktopOSProvider
+ *       processes={myApps}
+ *       theme={{ colors: { accent: '#00ff88' } }}
+ *     >
+ *       <Desktop />
+ *       <Taskbar />
+ *     </DesktopOSProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @example Power user path with headless hooks
+ * ```tsx
+ * import { useWindowManager, useTaskbar } from '@backbay/glia/desktop/core';
+ *
+ * function MyWindowManager() {
+ *   const { windows, open, close, focus } = useWindowManager();
+ *   // Build your own UI
+ * }
+ * ```
+ */
+export { type WindowId, type TilePosition, type WindowState, type WindowGroup, type WindowOpenConfig, type UseWindowManagerReturn, useWindowManager, useWindowManagerStore, useWindowIds, useWindow, useIsWindowFocused, useIsWindowFullscreen, useIsFullscreenActive, useWindowActions, useWindowGroup, type TaskbarButtonPosition, type TaskbarItem, type TaskbarPreviewState, type UseTaskbarReturn, type ContextMenuTargetType, type ContextMenuTarget, type ContextMenuItem, type UseContextMenuReturn, type StartMenuCategory, type StartMenuApp, type UseStartMenuReturn, useTaskbar, useTaskbarStore, type ProcessDefinition, type ProcessInstance, type DesktopIcon as DesktopIconDef, type UseDesktopReturn, type UseProcessRegistryReturn, type SnapZone, type UseSnapZonesReturn, type DesktopOSConfig, useSnapZones, useSnapZoneStore, getSnapZoneDimensions, EDGE_THRESHOLD, CORNER_SIZE, } from './core';
+export * from './themes';
+export * from './providers';
+export * from './components/desktop';
+export * from './components/window';
+export * from './components/shell';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/desktop/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAIH,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAE3B,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EAEd,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EAEvB,UAAU,EACV,eAAe,EAEf,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,WAAW,IAAI,cAAc,EAClC,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,eAAe,EAEpB,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,WAAW,GACZ,MAAM,QAAQ,CAAC;AAGhB,cAAc,UAAU,CAAC;AAGzB,cAAc,aAAa,CAAC;AAG5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/desktop/index.js

@@ -0,0 +1,50 @@
+/**
+ * @backbay/glia Desktop OS
+ *
+ * Reusable desktop OS components for React applications.
+ * Includes window management, taskbar, context menus, and more.
+ *
+ * @example Basic usage with provider
+ * ```tsx
+ * import { DesktopOSProvider, Window, Taskbar, Desktop } from '@backbay/glia/desktop';
+ *
+ * function App() {
+ *   return (
+ *     <DesktopOSProvider
+ *       processes={myApps}
+ *       theme={{ colors: { accent: '#00ff88' } }}
+ *     >
+ *       <Desktop />
+ *       <Taskbar />
+ *     </DesktopOSProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @example Power user path with headless hooks
+ * ```tsx
+ * import { useWindowManager, useTaskbar } from '@backbay/glia/desktop/core';
+ *
+ * function MyWindowManager() {
+ *   const { windows, open, close, focus } = useWindowManager();
+ *   // Build your own UI
+ * }
+ * ```
+ */
+// Core (headless hooks and types)
+// Note: DesktopIcon type is exported as DesktopIconDef to avoid conflict with DesktopIcon component
+export { 
+// Window hooks
+useWindowManager, useWindowManagerStore, useWindowIds, useWindow, useIsWindowFocused, useIsWindowFullscreen, useIsFullscreenActive, useWindowActions, useWindowGroup, 
+// Shell hooks
+useTaskbar, useTaskbarStore, 
+// Desktop hooks
+useSnapZones, useSnapZoneStore, getSnapZoneDimensions, EDGE_THRESHOLD, CORNER_SIZE, } from './core';
+// Themes
+export * from './themes';
+// Providers
+export * from './providers';
+// Components (styled)
+export * from './components/desktop';
+export * from './components/window';
+export * from './components/shell';

package/dist/desktop/providers/DesktopOSProvider.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @backbay/glia Desktop OS - DesktopOSProvider
+ *
+ * Main provider that wires together all desktop OS functionality.
+ * Manages windows, processes, taskbar, and context menus.
+ */
+import React from 'react';
+import type { PartialDesktopOSTheme } from '../themes/types';
+import type { WindowId, UseWindowManagerReturn } from '../core/window/types';
+import type { UseSnapZonesReturn } from '../core/desktop/types';
+import type { UseTaskbarReturn } from '../core/shell/types';
+import type { ProcessDefinition, ProcessInstance, DesktopOSConfig } from '../core/desktop/types';
+interface DesktopOSContextValue {
+    windows: UseWindowManagerReturn;
+    snapZones: UseSnapZonesReturn;
+    taskbar: UseTaskbarReturn;
+    processes: {
+        definitions: ProcessDefinition[];
+        instances: ProcessInstance[];
+        launch: (processId: string, args?: Record<string, unknown>) => string | null;
+        terminate: (instanceId: string) => void;
+        getDefinition: (id: string) => ProcessDefinition | undefined;
+        getInstanceByWindow: (windowId: WindowId) => ProcessInstance | undefined;
+    };
+    config: {
+        enableSnapZones: boolean;
+        enableWindowGroups: boolean;
+        enableAnimations: boolean;
+    };
+}
+/**
+ * Access the desktop OS context.
+ *
+ * @throws Error if used outside DesktopOSProvider
+ *
+ * @example
+ * ```tsx
+ * const { windows, processes, taskbar } = useDesktopOS();
+ *
+ * const handleLaunch = () => {
+ *   processes.launch('my-app');
+ * };
+ * ```
+ */
+export declare function useDesktopOS(): DesktopOSContextValue;
+/**
+ * Check if we're inside a DesktopOSProvider.
+ * Useful for components that work in both standalone and managed modes.
+ */
+export declare function useIsInDesktopOS(): boolean;
+export interface DesktopOSProviderProps extends DesktopOSConfig {
+    children: React.ReactNode;
+    /** Theme customization */
+    theme?: PartialDesktopOSTheme;
+}
+/**
+ * Main provider for desktop OS functionality.
+ *
+ * Wires together window management, process registry, taskbar, and theming.
+ *
+ * @example
+ * ```tsx
+ * const myApps: ProcessDefinition[] = [
+ *   {
+ *     id: 'notepad',
+ *     name: 'Notepad',
+ *     icon: <NotepadIcon />,
+ *     component: NotepadApp,
+ *     defaultSize: { width: 600, height: 400 },
+ *   },
+ * ];
+ *
+ * function App() {
+ *   return (
+ *     <DesktopOSProvider
+ *       processes={myApps}
+ *       theme={{ colors: { accent: '#00ff88' } }}
+ *       enableSnapZones
+ *       enableWindowGroups
+ *     >
+ *       <Desktop>
+ *         <WindowManager />
+ *       </Desktop>
+ *       <Taskbar />
+ *       <ContextMenu />
+ *     </DesktopOSProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function DesktopOSProvider({ children, processes: processDefinitions, initialWindows, initialPinnedApps, theme, onWindowsChange, onPinnedAppsChange, enableSnapZones, enableWindowGroups, enableAnimations, }: DesktopOSProviderProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=DesktopOSProvider.d.ts.map

package/dist/desktop/providers/DesktopOSProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesktopOSProvider.d.ts","sourceRoot":"","sources":["../../../src/desktop/providers/DesktopOSProvider.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAON,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAM7D,OAAO,KAAK,EAAE,QAAQ,EAAe,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE1F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAoBjG,UAAU,qBAAqB;IAE7B,OAAO,EAAE,sBAAsB,CAAC;IAGhC,SAAS,EAAE,kBAAkB,CAAC;IAG9B,OAAO,EAAE,gBAAgB,CAAC;IAG1B,SAAS,EAAE;QACT,WAAW,EAAE,iBAAiB,EAAE,CAAC;QACjC,SAAS,EAAE,eAAe,EAAE,CAAC;QAC7B,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAAG,IAAI,CAAC;QAC7E,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;QACxC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAC;QAC7D,mBAAmB,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,eAAe,GAAG,SAAS,CAAC;KAC1E,CAAC;IAGF,MAAM,EAAE;QACN,eAAe,EAAE,OAAO,CAAC;QACzB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,gBAAgB,EAAE,OAAO,CAAC;KAC3B,CAAC;CACH;AAQD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,IAAI,qBAAqB,CAMpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAMD,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,SAAS,EAAE,kBAAkB,EAC7B,cAAc,EACd,iBAAiB,EACjB,KAAK,EACL,eAAe,EACf,kBAAkB,EAClB,eAAsB,EACtB,kBAAyB,EACzB,gBAAuB,GACxB,EAAE,sBAAsB,2CA8NxB"}

package/dist/desktop/providers/DesktopOSProvider.js

@@ -0,0 +1,246 @@
+/**
+ * @backbay/glia Desktop OS - DesktopOSProvider
+ *
+ * Main provider that wires together all desktop OS functionality.
+ * Manages windows, processes, taskbar, and context menus.
+ */
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import React, { createContext, useContext, useMemo, useCallback, useEffect, useRef, } from 'react';
+import { ThemeProvider } from './ThemeProvider';
+import { useWindowManager, } from '../core/window/useWindowManager';
+import { useSnapZones } from '../core/desktop/useSnapZones';
+import { useTaskbar, useTaskbarStore } from '../core/shell/useTaskbar';
+let processIdCounter = 0;
+function generateProcessInstanceId() {
+    return `process-${Date.now()}-${++processIdCounter}`;
+}
+const DesktopOSContext = createContext(null);
+// ═══════════════════════════════════════════════════════════════════════════
+// Hook
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Access the desktop OS context.
+ *
+ * @throws Error if used outside DesktopOSProvider
+ *
+ * @example
+ * ```tsx
+ * const { windows, processes, taskbar } = useDesktopOS();
+ *
+ * const handleLaunch = () => {
+ *   processes.launch('my-app');
+ * };
+ * ```
+ */
+export function useDesktopOS() {
+    const context = useContext(DesktopOSContext);
+    if (!context) {
+        throw new Error('useDesktopOS must be used within a DesktopOSProvider');
+    }
+    return context;
+}
+/**
+ * Check if we're inside a DesktopOSProvider.
+ * Useful for components that work in both standalone and managed modes.
+ */
+export function useIsInDesktopOS() {
+    return useContext(DesktopOSContext) !== null;
+}
+/**
+ * Main provider for desktop OS functionality.
+ *
+ * Wires together window management, process registry, taskbar, and theming.
+ *
+ * @example
+ * ```tsx
+ * const myApps: ProcessDefinition[] = [
+ *   {
+ *     id: 'notepad',
+ *     name: 'Notepad',
+ *     icon: <NotepadIcon />,
+ *     component: NotepadApp,
+ *     defaultSize: { width: 600, height: 400 },
+ *   },
+ * ];
+ *
+ * function App() {
+ *   return (
+ *     <DesktopOSProvider
+ *       processes={myApps}
+ *       theme={{ colors: { accent: '#00ff88' } }}
+ *       enableSnapZones
+ *       enableWindowGroups
+ *     >
+ *       <Desktop>
+ *         <WindowManager />
+ *       </Desktop>
+ *       <Taskbar />
+ *       <ContextMenu />
+ *     </DesktopOSProvider>
+ *   );
+ * }
+ * ```
+ */
+export function DesktopOSProvider({ children, processes: processDefinitions, initialWindows, initialPinnedApps, theme, onWindowsChange, onPinnedAppsChange, enableSnapZones = true, enableWindowGroups = true, enableAnimations = true, }) {
+    // ─────────────────────────────────────────────────────────────────────────
+    // Process Registry State
+    // ─────────────────────────────────────────────────────────────────────────
+    const [processState, setProcessState] = React.useState(() => ({
+        definitions: new Map(processDefinitions.map((d) => [d.id, d])),
+        instances: new Map(),
+    }));
+    // Update definitions when prop changes
+    useEffect(() => {
+        setProcessState((prev) => ({
+            ...prev,
+            definitions: new Map(processDefinitions.map((d) => [d.id, d])),
+        }));
+    }, [processDefinitions]);
+    // ─────────────────────────────────────────────────────────────────────────
+    // Core Hooks
+    // ─────────────────────────────────────────────────────────────────────────
+    const windowManager = useWindowManager();
+    const snapZones = useSnapZones();
+    // Build window info for taskbar
+    const windowsForTaskbar = useMemo(() => windowManager.windows.map((w) => {
+        // Find the process instance for this window
+        const instance = Array.from(processState.instances.values()).find((i) => i.windowId === w.id);
+        return {
+            id: w.id,
+            appId: instance?.processId ?? 'unknown',
+            title: w.title,
+            icon: w.icon,
+        };
+    }), [windowManager.windows, processState.instances]);
+    const taskbar = useTaskbar(windowsForTaskbar, windowManager.focusedId);
+    // ─────────────────────────────────────────────────────────────────────────
+    // Process Management
+    // ─────────────────────────────────────────────────────────────────────────
+    const launch = useCallback((processId, args) => {
+        const definition = processState.definitions.get(processId);
+        if (!definition) {
+            console.warn(`Process not found: ${processId}`);
+            return null;
+        }
+        // Check singleton constraint
+        if (definition.singleton) {
+            const existing = Array.from(processState.instances.values()).find((i) => i.processId === processId);
+            if (existing) {
+                // Focus existing window instead
+                windowManager.focus(existing.windowId);
+                return existing.id;
+            }
+        }
+        // Open window
+        const windowId = windowManager.open({
+            title: definition.name,
+            icon: typeof definition.icon === 'string' ? definition.icon : undefined,
+            size: definition.defaultSize,
+            minSize: definition.minSize,
+            maxSize: definition.maxSize,
+        });
+        // Create process instance
+        const instanceId = generateProcessInstanceId();
+        const instance = {
+            id: instanceId,
+            processId,
+            windowId,
+            args,
+            startedAt: Date.now(),
+        };
+        setProcessState((prev) => {
+            const newInstances = new Map(prev.instances);
+            newInstances.set(instanceId, instance);
+            return { ...prev, instances: newInstances };
+        });
+        return instanceId;
+    }, [processState.definitions, processState.instances, windowManager]);
+    const terminate = useCallback((instanceId) => {
+        const instance = processState.instances.get(instanceId);
+        if (!instance)
+            return;
+        // Close the window
+        windowManager.close(instance.windowId);
+        // Remove process instance
+        setProcessState((prev) => {
+            const newInstances = new Map(prev.instances);
+            newInstances.delete(instanceId);
+            return { ...prev, instances: newInstances };
+        });
+    }, [processState.instances, windowManager]);
+    const getDefinition = useCallback((id) => processState.definitions.get(id), [processState.definitions]);
+    const getInstanceByWindow = useCallback((windowId) => Array.from(processState.instances.values()).find((i) => i.windowId === windowId), [processState.instances]);
+    // ─────────────────────────────────────────────────────────────────────────
+    // Callbacks
+    // ─────────────────────────────────────────────────────────────────────────
+    // Notify on windows change
+    useEffect(() => {
+        onWindowsChange?.(windowManager.windows);
+    }, [windowManager.windows, onWindowsChange]);
+    // Clean up process instances when windows close
+    useEffect(() => {
+        const windowIds = new Set(windowManager.windows.map((w) => w.id));
+        setProcessState((prev) => {
+            let changed = false;
+            const newInstances = new Map(prev.instances);
+            for (const [instanceId, instance] of prev.instances) {
+                if (!windowIds.has(instance.windowId)) {
+                    newInstances.delete(instanceId);
+                    changed = true;
+                }
+            }
+            return changed ? { ...prev, instances: newInstances } : prev;
+        });
+    }, [windowManager.windows]);
+    // ─────────────────────────────────────────────────────────────────────────
+    // Initialize pinned apps
+    // ─────────────────────────────────────────────────────────────────────────
+    const pinnedAppsInitialized = useRef(false);
+    useEffect(() => {
+        // Only initialize once, even if initialPinnedApps changes
+        if (pinnedAppsInitialized.current)
+            return;
+        if (initialPinnedApps && initialPinnedApps.length > 0) {
+            pinnedAppsInitialized.current = true;
+            const taskbarStore = useTaskbarStore.getState();
+            for (const appId of initialPinnedApps) {
+                taskbarStore.pinApp(appId);
+            }
+        }
+    }, [initialPinnedApps]);
+    // ─────────────────────────────────────────────────────────────────────────
+    // Context Value
+    // ─────────────────────────────────────────────────────────────────────────
+    const contextValue = useMemo(() => ({
+        windows: windowManager,
+        snapZones,
+        taskbar,
+        processes: {
+            definitions: Array.from(processState.definitions.values()),
+            instances: Array.from(processState.instances.values()),
+            launch,
+            terminate,
+            getDefinition,
+            getInstanceByWindow,
+        },
+        config: {
+            enableSnapZones,
+            enableWindowGroups,
+            enableAnimations,
+        },
+    }), [
+        windowManager,
+        snapZones,
+        taskbar,
+        processState,
+        launch,
+        terminate,
+        getDefinition,
+        getInstanceByWindow,
+        enableSnapZones,
+        enableWindowGroups,
+        enableAnimations,
+    ]);
+    return (_jsx(ThemeProvider, { theme: theme, children: _jsx(DesktopOSContext.Provider, { value: contextValue, children: children }) }));
+}

package/dist/desktop/providers/ThemeProvider.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @backbay/glia Desktop OS - ThemeProvider
+ *
+ * Injects theme CSS variables into the DOM.
+ * Can be used standalone or wrapped by DesktopOSProvider.
+ */
+import React from 'react';
+import { type DesktopOSTheme, type PartialDesktopOSTheme } from '../themes/types';
+interface ThemeContextValue {
+    theme: DesktopOSTheme;
+    cssVariables: Record<string, string>;
+}
+/**
+ * Access the current theme.
+ *
+ * @example
+ * ```tsx
+ * const { theme } = useDesktopTheme();
+ * console.log(theme.colors.accent);
+ * ```
+ */
+export declare function useDesktopTheme(): ThemeContextValue;
+export interface ThemeProviderProps {
+    children: React.ReactNode;
+    /** Custom theme or partial theme to merge with default */
+    theme?: PartialDesktopOSTheme;
+    /** Target element to inject CSS variables (defaults to :root) */
+    target?: 'root' | 'local';
+    /** Class name for the wrapper div (only used when target='local') */
+    className?: string;
+}
+/**
+ * Provides theme context and injects CSS variables.
+ *
+ * @example Global injection (recommended)
+ * ```tsx
+ * <ThemeProvider theme={{ colors: { accent: '#00ff88' } }}>
+ *   <App />
+ * </ThemeProvider>
+ * ```
+ *
+ * @example Local injection (for isolated instances)
+ * ```tsx
+ * <ThemeProvider target="local" className="my-desktop">
+ *   <Desktop />
+ * </ThemeProvider>
+ * ```
+ */
+export declare function ThemeProvider({ children, theme: partialTheme, target, className, }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=ThemeProvider.d.ts.map

package/dist/desktop/providers/ThemeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../../src/desktop/providers/ThemeProvider.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAyE,MAAM,OAAO,CAAC;AAK9F,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAG3B,MAAM,iBAAiB,CAAC;AAOzB,UAAU,iBAAiB;IACzB,KAAK,EAAE,cAAc,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAQD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAUnD;AAMD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,KAAK,EAAE,YAAY,EACnB,MAAe,EACf,SAAS,GACV,EAAE,kBAAkB,2CA6DpB"}

package/dist/desktop/providers/ThemeProvider.js

@@ -0,0 +1,93 @@
+/**
+ * @backbay/glia Desktop OS - ThemeProvider
+ *
+ * Injects theme CSS variables into the DOM.
+ * Can be used standalone or wrapped by DesktopOSProvider.
+ */
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo, useLayoutEffect, useEffect } from 'react';
+// SSR-safe useLayoutEffect - avoids React warnings during server rendering
+const useIsomorphicLayoutEffect = typeof window !== 'undefined' ? useLayoutEffect : useEffect;
+import { themeToCssVariables, mergeTheme, } from '../themes/types';
+import { defaultTheme } from '../themes/default';
+const ThemeContext = createContext(null);
+// ═══════════════════════════════════════════════════════════════════════════
+// Hook
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Access the current theme.
+ *
+ * @example
+ * ```tsx
+ * const { theme } = useDesktopTheme();
+ * console.log(theme.colors.accent);
+ * ```
+ */
+export function useDesktopTheme() {
+    const context = useContext(ThemeContext);
+    if (!context) {
+        // Return default theme if not in provider (standalone mode)
+        return {
+            theme: defaultTheme,
+            cssVariables: themeToCssVariables(defaultTheme),
+        };
+    }
+    return context;
+}
+/**
+ * Provides theme context and injects CSS variables.
+ *
+ * @example Global injection (recommended)
+ * ```tsx
+ * <ThemeProvider theme={{ colors: { accent: '#00ff88' } }}>
+ *   <App />
+ * </ThemeProvider>
+ * ```
+ *
+ * @example Local injection (for isolated instances)
+ * ```tsx
+ * <ThemeProvider target="local" className="my-desktop">
+ *   <Desktop />
+ * </ThemeProvider>
+ * ```
+ */
+export function ThemeProvider({ children, theme: partialTheme, target = 'root', className, }) {
+    // Merge custom theme with default
+    const theme = useMemo(() => (partialTheme ? mergeTheme(defaultTheme, partialTheme) : defaultTheme), [partialTheme]);
+    // Convert to CSS variables
+    const cssVariables = useMemo(() => themeToCssVariables(theme), [theme]);
+    // Inject CSS variables into :root
+    useIsomorphicLayoutEffect(() => {
+        if (target !== 'root')
+            return;
+        const root = document.documentElement;
+        const previousValues = {};
+        // Store previous values and set new ones
+        for (const [key, value] of Object.entries(cssVariables)) {
+            previousValues[key] = root.style.getPropertyValue(key);
+            root.style.setProperty(key, value);
+        }
+        // Cleanup: restore previous values
+        return () => {
+            for (const [key, value] of Object.entries(previousValues)) {
+                if (value) {
+                    root.style.setProperty(key, value);
+                }
+                else {
+                    root.style.removeProperty(key);
+                }
+            }
+        };
+    }, [cssVariables, target]);
+    const contextValue = useMemo(() => ({ theme, cssVariables }), [theme, cssVariables]);
+    // Local injection wraps children in a div with inline CSS variables
+    if (target === 'local') {
+        const style = {};
+        for (const [key, value] of Object.entries(cssVariables)) {
+            style[key] = value;
+        }
+        return (_jsx(ThemeContext.Provider, { value: contextValue, children: _jsx("div", { className: className, style: style, children: children }) }));
+    }
+    return (_jsx(ThemeContext.Provider, { value: contextValue, children: children }));
+}

package/dist/desktop/providers/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @backbay/glia Desktop OS - Providers
+ */
+export * from './ThemeProvider';
+export * from './DesktopOSProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/desktop/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/desktop/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/desktop/providers/index.js

@@ -0,0 +1,5 @@
+/**
+ * @backbay/glia Desktop OS - Providers
+ */
+export * from './ThemeProvider';
+export * from './DesktopOSProvider';

package/dist/desktop/themes/default.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @backbay/glia Desktop OS - Default Theme
+ *
+ * A sophisticated dark theme inspired by the Backbay "Gold + Steel" aesthetic.
+ * Features gold accent colors, refined typography, and subtle glass effects.
+ */
+import type { DesktopOSTheme } from './types';
+/**
+ * Default desktop OS theme - "Gold + Steel"
+ *
+ * A dark, refined theme with:
+ * - Gold primary accent (#d4a84b)
+ * - Steel secondary accent (#4a6fa5)
+ * - Elegant display fonts (Cinzel)
+ * - Subtle shadows and glass effects
+ */
+export declare const defaultTheme: DesktopOSTheme;
+//# sourceMappingURL=default.d.ts.map

package/dist/desktop/themes/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../src/desktop/themes/default.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,cAwF1B,CAAC"}