@hanzo/ui 8.27.8 → 8.27.10

package/dist/backends/gui/desktop-window.js.map

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

package/dist/backends/gui/desktop.cjs

@@ -0,0 +1,238 @@
+'use client';"use strict";
+'use client';
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useWindowManager = useWindowManager;
+exports.useDesktopSettings = useDesktopSettings;
+exports.useOverlayManager = useOverlayManager;
+exports.useKeyboardShortcuts = useKeyboardShortcuts;
+exports.Desktop = Desktop;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * Desktop — the surface and state hooks behind a macOS-style desktop
+ * interface: a full-viewport background that hosts windows, a dock and a
+ * spotlight, plus the four hooks that give those pieces somewhere to keep
+ * their state (`useWindowManager`, `useDesktopSettings`, `useOverlayManager`,
+ * `useKeyboardShortcuts`). `Window` and `Spotlight` are their own components;
+ * this is the ground they sit on.
+ *
+ * The hooks own no rendering and reach `@hanzo/gui` nowhere — a reducer, a
+ * `localStorage` mirror and a `keydown` listener behave identically on every
+ * backend, so they are plain React. Only `Desktop` itself is gui-native.
+ */
+const React = __importStar(require("react"));
+const gui_1 = require("@hanzo/gui");
+function windowReducer(state, action) {
+    switch (action.type) {
+        case 'OPEN':
+            return { windows: { ...state.windows, [action.id]: true }, activeWindow: action.id };
+        case 'CLOSE':
+            return {
+                windows: { ...state.windows, [action.id]: false },
+                activeWindow: state.activeWindow === action.id ? null : state.activeWindow,
+            };
+        case 'TOGGLE': {
+            const isOpen = state.windows[action.id];
+            return {
+                windows: { ...state.windows, [action.id]: !isOpen },
+                activeWindow: !isOpen ? action.id : state.activeWindow === action.id ? null : state.activeWindow,
+            };
+        }
+        case 'CLOSE_ALL':
+            return {
+                windows: Object.keys(state.windows).reduce((acc, key) => {
+                    acc[key] = false;
+                    return acc;
+                }, {}),
+                activeWindow: null,
+            };
+        case 'SET_ACTIVE':
+            return { ...state, activeWindow: action.id };
+        default:
+            return state;
+    }
+}
+/** Reducer-backed open/close/focus state for any number of named windows. */
+function useWindowManager(initialWindows = []) {
+    const initialState = React.useMemo(() => ({
+        windows: initialWindows.reduce((acc, id) => {
+            acc[id] = false;
+            return acc;
+        }, {}),
+        activeWindow: null,
+    }), 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    []);
+    const [state, dispatch] = React.useReducer(windowReducer, initialState);
+    const openWindows = React.useMemo(() => Object.entries(state.windows).filter(([, isOpen]) => isOpen).map(([id]) => id), [state.windows]);
+    const openWindow = React.useCallback((id) => dispatch({ type: 'OPEN', id }), []);
+    const closeWindow = React.useCallback((id) => dispatch({ type: 'CLOSE', id }), []);
+    const toggleWindow = React.useCallback((id) => dispatch({ type: 'TOGGLE', id }), []);
+    const focusWindow = React.useCallback((id) => dispatch({ type: 'SET_ACTIVE', id }), []);
+    const closeAllWindows = React.useCallback(() => dispatch({ type: 'CLOSE_ALL' }), []);
+    const isOpen = React.useCallback((id) => state.windows[id] ?? false, [state.windows]);
+    return {
+        windows: state.windows,
+        activeWindow: state.activeWindow,
+        openWindows,
+        openWindow,
+        closeWindow,
+        toggleWindow,
+        focusWindow,
+        closeAllWindows,
+        isOpen,
+    };
+}
+const defaultSettings = {
+    theme: 'default',
+    colorScheme: 'dark',
+    backgroundImage: undefined,
+    backgroundColor: undefined,
+    dockPosition: 'bottom',
+    dockSize: 64,
+    dockMagnification: true,
+    dockAutoHide: false,
+    windowTransparency: 20,
+    fontSize: 'medium',
+    reducedMotion: false,
+};
+const STORAGE_KEY = 'desktop-settings';
+function loadSettings() {
+    if (typeof window === 'undefined')
+        return defaultSettings;
+    try {
+        const stored = window.localStorage.getItem(STORAGE_KEY);
+        if (stored)
+            return { ...defaultSettings, ...JSON.parse(stored) };
+    }
+    catch {
+        // Ignore a blocked or corrupt store; the defaults still render correctly.
+    }
+    return defaultSettings;
+}
+function saveSettings(settings) {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        window.localStorage.setItem(STORAGE_KEY, JSON.stringify(settings));
+    }
+    catch {
+        // Ignore a full or blocked store; the setting still holds for this session.
+    }
+}
+/** Desktop preferences — theme, dock, transparency — mirrored to `localStorage`. */
+function useDesktopSettings() {
+    const [settings, setSettings] = React.useState(loadSettings);
+    React.useEffect(() => {
+        saveSettings(settings);
+    }, [settings]);
+    const updateSetting = (key, value) => setSettings((prev) => ({ ...prev, [key]: value }));
+    return {
+        ...settings,
+        setTheme: (theme) => updateSetting('theme', theme),
+        setColorScheme: (scheme) => updateSetting('colorScheme', scheme),
+        setBackgroundImage: (url) => updateSetting('backgroundImage', url),
+        setBackgroundColor: (color) => updateSetting('backgroundColor', color),
+        setDockPosition: (position) => updateSetting('dockPosition', position),
+        setDockSize: (size) => updateSetting('dockSize', size),
+        setDockMagnification: (enabled) => updateSetting('dockMagnification', enabled),
+        setDockAutoHide: (enabled) => updateSetting('dockAutoHide', enabled),
+        setWindowTransparency: (value) => updateSetting('windowTransparency', value),
+        setFontSize: (size) => updateSetting('fontSize', size),
+        setReducedMotion: (enabled) => updateSetting('reducedMotion', enabled),
+        toggleDarkMode: () => setSettings((prev) => ({ ...prev, colorScheme: prev.colorScheme === 'dark' ? 'light' : 'dark' })),
+        resetToDefaults: () => setSettings(defaultSettings),
+    };
+}
+/** Open/close state for the desktop's overlays — spotlight, a menu, a modal, a drawer. */
+function useOverlayManager() {
+    const [overlays, setOverlays] = React.useState({
+        spotlight: false,
+        contextMenu: false,
+        modal: false,
+        drawer: false,
+    });
+    const isOpen = React.useCallback((id) => overlays[id] ?? false, [overlays]);
+    const open = React.useCallback((id) => setOverlays((prev) => ({ ...prev, [id]: true })), []);
+    const close = React.useCallback((id) => setOverlays((prev) => ({ ...prev, [id]: false })), []);
+    const toggle = React.useCallback((id) => setOverlays((prev) => ({ ...prev, [id]: !prev[id] })), []);
+    const closeAll = React.useCallback(() => setOverlays((prev) => Object.keys(prev).reduce((acc, key) => {
+        acc[key] = false;
+        return acc;
+    }, {})), []);
+    return { overlays, isOpen, open, close, toggle, closeAll };
+}
+/** Registers global ⌘/Ctrl-chord shortcuts for the lifetime of the caller. */
+function useKeyboardShortcuts(shortcuts) {
+    React.useEffect(() => {
+        const handleKeyDown = (e) => {
+            for (const shortcut of shortcuts) {
+                const metaMatch = shortcut.meta ? e.metaKey || e.ctrlKey : !e.metaKey;
+                const ctrlMatch = shortcut.ctrl ? e.ctrlKey : true;
+                const altMatch = shortcut.alt ? e.altKey : !e.altKey;
+                const shiftMatch = shortcut.shift ? e.shiftKey : !e.shiftKey;
+                const keyMatch = e.key.toLowerCase() === shortcut.key.toLowerCase();
+                if (keyMatch && metaMatch && ctrlMatch && altMatch && shiftMatch) {
+                    if (shortcut.preventDefault !== false)
+                        e.preventDefault();
+                    shortcut.action();
+                    return;
+                }
+            }
+        };
+        window.addEventListener('keydown', handleKeyDown);
+        return () => window.removeEventListener('keydown', handleKeyDown);
+    }, [shortcuts]);
+}
+// ============================================================================
+// Desktop — the surface Window, Spotlight and a Dock render onto
+// ============================================================================
+const Frame = (0, gui_1.styled)(gui_1.YStack, {
+    name: 'Desktop',
+    position: 'relative',
+    width: '100%',
+    height: '100%',
+    overflow: 'hidden',
+    bg: '$background',
+});
+/**
+ * The full-viewport ground of a desktop interface: an optional painted
+ * background under a relatively-positioned surface, so absolutely-positioned
+ * windows, a dock and a spotlight all measure against this box rather than
+ * the document.
+ */
+function Desktop({ background, children, ...props }) {
+    return ((0, jsx_runtime_1.jsxs)(Frame, { "data-slot": "desktop", ...props, children: [background ? ((0, jsx_runtime_1.jsx)(gui_1.YStack, { "data-slot": "desktop-background", position: "absolute", inset: 0, style: { background } })) : null, (0, jsx_runtime_1.jsx)(gui_1.YStack, { "data-slot": "desktop-surface", position: "relative", width: "100%", height: "100%", children: children })] }));
+}

package/dist/backends/gui/desktop.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Desktop — the surface and state hooks behind a macOS-style desktop
+ * interface: a full-viewport background that hosts windows, a dock and a
+ * spotlight, plus the four hooks that give those pieces somewhere to keep
+ * their state (`useWindowManager`, `useDesktopSettings`, `useOverlayManager`,
+ * `useKeyboardShortcuts`). `Window` and `Spotlight` are their own components;
+ * this is the ground they sit on.
+ *
+ * The hooks own no rendering and reach `@hanzo/gui` nowhere — a reducer, a
+ * `localStorage` mirror and a `keydown` listener behave identically on every
+ * backend, so they are plain React. Only `Desktop` itself is gui-native.
+ */
+import * as React from 'react';
+export type WindowId = string;
+export interface WindowState {
+    [key: string]: boolean;
+}
+export interface WindowManager {
+    windows: WindowState;
+    activeWindow: WindowId | null;
+    openWindows: WindowId[];
+    openWindow: (id: WindowId) => void;
+    closeWindow: (id: WindowId) => void;
+    toggleWindow: (id: WindowId) => void;
+    focusWindow: (id: WindowId) => void;
+    closeAllWindows: () => void;
+    isOpen: (id: WindowId) => boolean;
+}
+/** Reducer-backed open/close/focus state for any number of named windows. */
+export declare function useWindowManager(initialWindows?: WindowId[]): WindowManager;
+export type ColorScheme = 'dark' | 'light' | 'auto';
+export type DockPosition = 'bottom' | 'left' | 'right';
+export interface DesktopSettings {
+    theme: string;
+    colorScheme: ColorScheme;
+    backgroundImage?: string;
+    backgroundColor?: string;
+    dockPosition: DockPosition;
+    dockSize: number;
+    dockMagnification: boolean;
+    dockAutoHide: boolean;
+    windowTransparency: number;
+    fontSize: 'small' | 'medium' | 'large';
+    reducedMotion: boolean;
+}
+export interface DesktopSettingsActions {
+    setTheme: (theme: string) => void;
+    setColorScheme: (scheme: ColorScheme) => void;
+    setBackgroundImage: (url?: string) => void;
+    setBackgroundColor: (color?: string) => void;
+    setDockPosition: (position: DockPosition) => void;
+    setDockSize: (size: number) => void;
+    setDockMagnification: (enabled: boolean) => void;
+    setDockAutoHide: (enabled: boolean) => void;
+    setWindowTransparency: (value: number) => void;
+    setFontSize: (size: 'small' | 'medium' | 'large') => void;
+    setReducedMotion: (enabled: boolean) => void;
+    toggleDarkMode: () => void;
+    resetToDefaults: () => void;
+}
+/** Desktop preferences — theme, dock, transparency — mirrored to `localStorage`. */
+export declare function useDesktopSettings(): DesktopSettings & DesktopSettingsActions;
+export interface OverlayState {
+    spotlight: boolean;
+    contextMenu: boolean;
+    modal: boolean;
+    drawer: boolean;
+    [key: string]: boolean;
+}
+export interface OverlayManager {
+    overlays: OverlayState;
+    isOpen: (id: string) => boolean;
+    open: (id: string) => void;
+    close: (id: string) => void;
+    toggle: (id: string) => void;
+    closeAll: () => void;
+}
+/** Open/close state for the desktop's overlays — spotlight, a menu, a modal, a drawer. */
+export declare function useOverlayManager(): OverlayManager;
+export interface KeyboardShortcut {
+    key: string;
+    meta?: boolean;
+    ctrl?: boolean;
+    alt?: boolean;
+    shift?: boolean;
+    action: () => void;
+    description?: string;
+    preventDefault?: boolean;
+}
+/** Registers global ⌘/Ctrl-chord shortcuts for the lifetime of the caller. */
+export declare function useKeyboardShortcuts(shortcuts: KeyboardShortcut[]): void;
+declare const Frame: import("@hanzogui/web").GuiComponent<import("@hanzogui/web").TamaDefer, import("@hanzogui/web").GuiElement, import("@hanzogui/core").RNGuiViewNonStyleProps, import("@hanzogui/web").StackStyleBase, {
+    elevation?: number | import("@hanzogui/web").SizeTokens | undefined;
+    fullscreen?: boolean | undefined;
+}, import("@hanzogui/web").StaticConfigPublic>;
+export interface DesktopProps extends React.ComponentProps<typeof Frame> {
+    /** A CSS `background` value (a gradient, a color, an image) behind the content. */
+    background?: string;
+    children?: React.ReactNode;
+}
+/**
+ * The full-viewport ground of a desktop interface: an optional painted
+ * background under a relatively-positioned surface, so absolutely-positioned
+ * windows, a dock and a spotlight all measure against this box rather than
+ * the document.
+ */
+export declare function Desktop({ background, children, ...props }: DesktopProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=desktop.d.ts.map

package/dist/backends/gui/desktop.d.ts.map

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

package/dist/backends/gui/desktop.js

@@ -0,0 +1,199 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Desktop — the surface and state hooks behind a macOS-style desktop
+ * interface: a full-viewport background that hosts windows, a dock and a
+ * spotlight, plus the four hooks that give those pieces somewhere to keep
+ * their state (`useWindowManager`, `useDesktopSettings`, `useOverlayManager`,
+ * `useKeyboardShortcuts`). `Window` and `Spotlight` are their own components;
+ * this is the ground they sit on.
+ *
+ * The hooks own no rendering and reach `@hanzo/gui` nowhere — a reducer, a
+ * `localStorage` mirror and a `keydown` listener behave identically on every
+ * backend, so they are plain React. Only `Desktop` itself is gui-native.
+ */
+import * as React from 'react';
+import { YStack, styled } from '@hanzo/gui';
+function windowReducer(state, action) {
+    switch (action.type) {
+        case 'OPEN':
+            return { windows: { ...state.windows, [action.id]: true }, activeWindow: action.id };
+        case 'CLOSE':
+            return {
+                windows: { ...state.windows, [action.id]: false },
+                activeWindow: state.activeWindow === action.id ? null : state.activeWindow,
+            };
+        case 'TOGGLE': {
+            const isOpen = state.windows[action.id];
+            return {
+                windows: { ...state.windows, [action.id]: !isOpen },
+                activeWindow: !isOpen ? action.id : state.activeWindow === action.id ? null : state.activeWindow,
+            };
+        }
+        case 'CLOSE_ALL':
+            return {
+                windows: Object.keys(state.windows).reduce((acc, key) => {
+                    acc[key] = false;
+                    return acc;
+                }, {}),
+                activeWindow: null,
+            };
+        case 'SET_ACTIVE':
+            return { ...state, activeWindow: action.id };
+        default:
+            return state;
+    }
+}
+/** Reducer-backed open/close/focus state for any number of named windows. */
+export function useWindowManager(initialWindows = []) {
+    const initialState = React.useMemo(() => ({
+        windows: initialWindows.reduce((acc, id) => {
+            acc[id] = false;
+            return acc;
+        }, {}),
+        activeWindow: null,
+    }), 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    []);
+    const [state, dispatch] = React.useReducer(windowReducer, initialState);
+    const openWindows = React.useMemo(() => Object.entries(state.windows).filter(([, isOpen]) => isOpen).map(([id]) => id), [state.windows]);
+    const openWindow = React.useCallback((id) => dispatch({ type: 'OPEN', id }), []);
+    const closeWindow = React.useCallback((id) => dispatch({ type: 'CLOSE', id }), []);
+    const toggleWindow = React.useCallback((id) => dispatch({ type: 'TOGGLE', id }), []);
+    const focusWindow = React.useCallback((id) => dispatch({ type: 'SET_ACTIVE', id }), []);
+    const closeAllWindows = React.useCallback(() => dispatch({ type: 'CLOSE_ALL' }), []);
+    const isOpen = React.useCallback((id) => state.windows[id] ?? false, [state.windows]);
+    return {
+        windows: state.windows,
+        activeWindow: state.activeWindow,
+        openWindows,
+        openWindow,
+        closeWindow,
+        toggleWindow,
+        focusWindow,
+        closeAllWindows,
+        isOpen,
+    };
+}
+const defaultSettings = {
+    theme: 'default',
+    colorScheme: 'dark',
+    backgroundImage: undefined,
+    backgroundColor: undefined,
+    dockPosition: 'bottom',
+    dockSize: 64,
+    dockMagnification: true,
+    dockAutoHide: false,
+    windowTransparency: 20,
+    fontSize: 'medium',
+    reducedMotion: false,
+};
+const STORAGE_KEY = 'desktop-settings';
+function loadSettings() {
+    if (typeof window === 'undefined')
+        return defaultSettings;
+    try {
+        const stored = window.localStorage.getItem(STORAGE_KEY);
+        if (stored)
+            return { ...defaultSettings, ...JSON.parse(stored) };
+    }
+    catch {
+        // Ignore a blocked or corrupt store; the defaults still render correctly.
+    }
+    return defaultSettings;
+}
+function saveSettings(settings) {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        window.localStorage.setItem(STORAGE_KEY, JSON.stringify(settings));
+    }
+    catch {
+        // Ignore a full or blocked store; the setting still holds for this session.
+    }
+}
+/** Desktop preferences — theme, dock, transparency — mirrored to `localStorage`. */
+export function useDesktopSettings() {
+    const [settings, setSettings] = React.useState(loadSettings);
+    React.useEffect(() => {
+        saveSettings(settings);
+    }, [settings]);
+    const updateSetting = (key, value) => setSettings((prev) => ({ ...prev, [key]: value }));
+    return {
+        ...settings,
+        setTheme: (theme) => updateSetting('theme', theme),
+        setColorScheme: (scheme) => updateSetting('colorScheme', scheme),
+        setBackgroundImage: (url) => updateSetting('backgroundImage', url),
+        setBackgroundColor: (color) => updateSetting('backgroundColor', color),
+        setDockPosition: (position) => updateSetting('dockPosition', position),
+        setDockSize: (size) => updateSetting('dockSize', size),
+        setDockMagnification: (enabled) => updateSetting('dockMagnification', enabled),
+        setDockAutoHide: (enabled) => updateSetting('dockAutoHide', enabled),
+        setWindowTransparency: (value) => updateSetting('windowTransparency', value),
+        setFontSize: (size) => updateSetting('fontSize', size),
+        setReducedMotion: (enabled) => updateSetting('reducedMotion', enabled),
+        toggleDarkMode: () => setSettings((prev) => ({ ...prev, colorScheme: prev.colorScheme === 'dark' ? 'light' : 'dark' })),
+        resetToDefaults: () => setSettings(defaultSettings),
+    };
+}
+/** Open/close state for the desktop's overlays — spotlight, a menu, a modal, a drawer. */
+export function useOverlayManager() {
+    const [overlays, setOverlays] = React.useState({
+        spotlight: false,
+        contextMenu: false,
+        modal: false,
+        drawer: false,
+    });
+    const isOpen = React.useCallback((id) => overlays[id] ?? false, [overlays]);
+    const open = React.useCallback((id) => setOverlays((prev) => ({ ...prev, [id]: true })), []);
+    const close = React.useCallback((id) => setOverlays((prev) => ({ ...prev, [id]: false })), []);
+    const toggle = React.useCallback((id) => setOverlays((prev) => ({ ...prev, [id]: !prev[id] })), []);
+    const closeAll = React.useCallback(() => setOverlays((prev) => Object.keys(prev).reduce((acc, key) => {
+        acc[key] = false;
+        return acc;
+    }, {})), []);
+    return { overlays, isOpen, open, close, toggle, closeAll };
+}
+/** Registers global ⌘/Ctrl-chord shortcuts for the lifetime of the caller. */
+export function useKeyboardShortcuts(shortcuts) {
+    React.useEffect(() => {
+        const handleKeyDown = (e) => {
+            for (const shortcut of shortcuts) {
+                const metaMatch = shortcut.meta ? e.metaKey || e.ctrlKey : !e.metaKey;
+                const ctrlMatch = shortcut.ctrl ? e.ctrlKey : true;
+                const altMatch = shortcut.alt ? e.altKey : !e.altKey;
+                const shiftMatch = shortcut.shift ? e.shiftKey : !e.shiftKey;
+                const keyMatch = e.key.toLowerCase() === shortcut.key.toLowerCase();
+                if (keyMatch && metaMatch && ctrlMatch && altMatch && shiftMatch) {
+                    if (shortcut.preventDefault !== false)
+                        e.preventDefault();
+                    shortcut.action();
+                    return;
+                }
+            }
+        };
+        window.addEventListener('keydown', handleKeyDown);
+        return () => window.removeEventListener('keydown', handleKeyDown);
+    }, [shortcuts]);
+}
+// ============================================================================
+// Desktop — the surface Window, Spotlight and a Dock render onto
+// ============================================================================
+const Frame = styled(YStack, {
+    name: 'Desktop',
+    position: 'relative',
+    width: '100%',
+    height: '100%',
+    overflow: 'hidden',
+    bg: '$background',
+});
+/**
+ * The full-viewport ground of a desktop interface: an optional painted
+ * background under a relatively-positioned surface, so absolutely-positioned
+ * windows, a dock and a spotlight all measure against this box rather than
+ * the document.
+ */
+export function Desktop({ background, children, ...props }) {
+    return (_jsxs(Frame, { "data-slot": "desktop", ...props, children: [background ? (_jsx(YStack, { "data-slot": "desktop-background", position: "absolute", inset: 0, style: { background } })) : null, _jsx(YStack, { "data-slot": "desktop-surface", position: "relative", width: "100%", height: "100%", children: children })] }));
+}
+//# sourceMappingURL=desktop.js.map

package/dist/backends/gui/desktop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop.js","sourceRoot":"","sources":["../../../src/backends/gui/desktop.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAwB3C,SAAS,aAAa,CAAC,KAAyB,EAAE,MAAoB;IACpE,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,EAAE,CAAA;QACtF,KAAK,OAAO;YACV,OAAO;gBACL,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE;gBACjD,YAAY,EAAE,KAAK,CAAC,YAAY,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY;aAC3E,CAAA;QACH,KAAK,QAAQ,EAAE,CAAC;YACd,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YACvC,OAAO;gBACL,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE;gBACnD,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY;aACjG,CAAA;QACH,CAAC;QACD,KAAK,WAAW;YACd,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;oBACtD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;oBAChB,OAAO,GAAG,CAAA;gBACZ,CAAC,EAAE,EAAiB,CAAC;gBACrB,YAAY,EAAE,IAAI;aACnB,CAAA;QACH,KAAK,YAAY;YACf,OAAO,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,EAAE,CAAA;QAC9C;YACE,OAAO,KAAK,CAAA;IAChB,CAAC;AACH,CAAC;AAcD,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAAC,cAAc,GAAe,EAAE;IAC9D,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAChC,GAAG,EAAE,CAAC,CAAC;QACL,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE;YACzC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAA;YACf,OAAO,GAAG,CAAA;QACZ,CAAC,EAAE,EAAiB,CAAC;QACrB,YAAY,EAAE,IAAI;KACnB,CAAC;IACF,uDAAuD;IACvD,EAAE,CACH,CAAA;IACD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;IAEvE,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAC/B,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EACpF,CAAC,KAAK,CAAC,OAAO,CAAC,CAChB,CAAA;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,EAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;IAC1F,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,EAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;IAC5F,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,EAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;IAC9F,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,EAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;IACjG,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;IACpF,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,EAAY,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;IAE/F,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,WAAW;QACX,UAAU;QACV,WAAW;QACX,YAAY;QACZ,WAAW;QACX,eAAe;QACf,MAAM;KACP,CAAA;AACH,CAAC;AAuCD,MAAM,eAAe,GAAoB;IACvC,KAAK,EAAE,SAAS;IAChB,WAAW,EAAE,MAAM;IACnB,eAAe,EAAE,SAAS;IAC1B,eAAe,EAAE,SAAS;IAC1B,YAAY,EAAE,QAAQ;IACtB,QAAQ,EAAE,EAAE;IACZ,iBAAiB,EAAE,IAAI;IACvB,YAAY,EAAE,KAAK;IACnB,kBAAkB,EAAE,EAAE;IACtB,QAAQ,EAAE,QAAQ;IAClB,aAAa,EAAE,KAAK;CACrB,CAAA;AAED,MAAM,WAAW,GAAG,kBAAkB,CAAA;AAEtC,SAAS,YAAY;IACnB,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,eAAe,CAAA;IACzD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QACvD,IAAI,MAAM;YAAE,OAAO,EAAE,GAAG,eAAe,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAA;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;IAC5E,CAAC;IACD,OAAO,eAAe,CAAA;AACxB,CAAC;AAED,SAAS,YAAY,CAAC,QAAyB;IAC7C,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAM;IACzC,IAAI,CAAC;QACH,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;IAC9E,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,kBAAkB;IAChC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAkB,YAAY,CAAC,CAAA;IAE7E,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,YAAY,CAAC,QAAQ,CAAC,CAAA;IACxB,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEd,MAAM,aAAa,GAAG,CAAkC,GAAM,EAAE,KAAyB,EAAE,EAAE,CAC3F,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;IAEpD,OAAO;QACL,GAAG,QAAQ;QACX,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC;QAClD,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,MAAM,CAAC;QAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,iBAAiB,EAAE,GAAG,CAAC;QAClE,kBAAkB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,iBAAiB,EAAE,KAAK,CAAC;QACtE,eAAe,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,QAAQ,CAAC;QACtE,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC;QACtD,oBAAoB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,mBAAmB,EAAE,OAAO,CAAC;QAC9E,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,OAAO,CAAC;QACpE,qBAAqB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,oBAAoB,EAAE,KAAK,CAAC;QAC5E,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC;QACtD,gBAAgB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,eAAe,EAAE,OAAO,CAAC;QACtE,cAAc,EAAE,GAAG,EAAE,CACnB,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACnG,eAAe,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,eAAe,CAAC;KACpD,CAAA;AACH,CAAC;AAuBD,0FAA0F;AAC1F,MAAM,UAAU,iBAAiB;IAC/B,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAe;QAC3D,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,KAAK;QAClB,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK;KACd,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;IACnF,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACpG,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACtG,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAC9B,CAAC,EAAU,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACrE,EAAE,CACH,CAAA;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAChC,GAAG,EAAE,CACH,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CACnB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACpC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QAChB,OAAO,GAAG,CAAA;IACZ,CAAC,EAAE,EAAkB,CAAC,CACvB,EACH,EAAE,CACH,CAAA;IAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AAC5D,CAAC;AAiBD,8EAA8E;AAC9E,MAAM,UAAU,oBAAoB,CAAC,SAA6B;IAChE,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,MAAM,aAAa,GAAG,CAAC,CAAgB,EAAE,EAAE;YACzC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;gBACrE,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;gBAClD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;gBACpD,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;gBAC5D,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAA;gBAEnE,IAAI,QAAQ,IAAI,SAAS,IAAI,SAAS,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;oBACjE,IAAI,QAAQ,CAAC,cAAc,KAAK,KAAK;wBAAE,CAAC,CAAC,cAAc,EAAE,CAAA;oBACzD,QAAQ,CAAC,MAAM,EAAE,CAAA;oBACjB,OAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC,CAAA;QAED,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAA;QACjD,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAA;IACnE,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAA;AACjB,CAAC;AAED,+EAA+E;AAC/E,iEAAiE;AACjE,+EAA+E;AAE/E,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE;IAC3B,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,QAAQ;IAClB,EAAE,EAAE,aAAa;CAClB,CAAC,CAAA;AAQF;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAgB;IACtE,OAAO,CACL,MAAC,KAAK,iBAAW,SAAS,KAAK,KAAK,aACjC,UAAU,CAAC,CAAC,CAAC,CACZ,KAAC,MAAM,iBAAW,oBAAoB,EAAC,QAAQ,EAAC,UAAU,EAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,GAAI,CAC/F,CAAC,CAAC,CAAC,IAAI,EACR,KAAC,MAAM,iBAAW,iBAAiB,EAAC,QAAQ,EAAC,UAAU,EAAC,KAAK,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,YAC/E,QAAQ,GACF,IACH,CACT,CAAA;AACH,CAAC"}

package/dist/backends/gui/dialog-stack.cjs

@@ -0,0 +1,26 @@
+'use client';"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DialogStack = DialogStack;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * DialogStack — a pile of panels offset diagonally, front one on top.
+ *
+ * Each dialog is an absolutely positioned card inside a relatively positioned
+ * frame; index alone decides both its offset (`translate(index*10, index*10)`)
+ * and its stacking (`zIndex: index`), so the last item in `dialogs` reads as the
+ * top of the pile. A panel closes through its own corner button, which reports
+ * the closed id back through `onClose` — nothing here removes an item from the
+ * list, the caller owns that.
+ */
+const gui_1 = require("@hanzo/gui");
+const lucide_icons_2_1 = require("@hanzogui/lucide-icons-2");
+const button_1 = require("./button.cjs");
+const ink_1 = require("./ink.cjs");
+const slot_1 = require("./slot.cjs");
+const gesture_1 = require("./gesture.cjs");
+const OFFSET = 10;
+const CLOSE = 24;
+function DialogStack({ dialogs, onClose, children, ...props }) {
+    return ((0, jsx_runtime_1.jsxs)(gui_1.YStack, { ...(0, slot_1.slot)('dialog-stack'), position: "relative", ...props, children: [dialogs.map((dialog, index) => ((0, jsx_runtime_1.jsxs)(gui_1.YStack, { ...(0, slot_1.slot)('dialog-stack-item'), "data-index": index, position: "absolute", t: 0, l: 0, r: 0, b: 0, rounded: "$5", borderWidth: 1, borderColor: "$borderColor", bg: "$background", p: "$6", gap: "$4", transform: [{ translateX: index * OFFSET }, { translateY: index * OFFSET }], style: { zIndex: index }, children: [(0, jsx_runtime_1.jsxs)(gui_1.XStack, { items: "center", justify: "space-between", children: [(0, ink_1.ink)(dialog.title, undefined, { fontSize: '$5', fontWeight: '600' }), (0, jsx_runtime_1.jsx)(button_1.Button, { ...(0, slot_1.slot)('dialog-stack-close'), variant: "ghost", size: "icon", minH: CLOSE, minW: CLOSE, ...(0, gesture_1.touch)(CLOSE), "aria-label": "Close", onPress: () => onClose?.(dialog.id), children: (0, jsx_runtime_1.jsx)(lucide_icons_2_1.X, { size: 16 }) })] }), (0, jsx_runtime_1.jsx)(gui_1.YStack, { children: (0, ink_1.ink)(dialog.content) })] }, dialog.id))), children] }));
+}

package/dist/backends/gui/dialog-stack.d.ts

@@ -0,0 +1,23 @@
+/**
+ * DialogStack — a pile of panels offset diagonally, front one on top.
+ *
+ * Each dialog is an absolutely positioned card inside a relatively positioned
+ * frame; index alone decides both its offset (`translate(index*10, index*10)`)
+ * and its stacking (`zIndex: index`), so the last item in `dialogs` reads as the
+ * top of the pile. A panel closes through its own corner button, which reports
+ * the closed id back through `onClose` — nothing here removes an item from the
+ * list, the caller owns that.
+ */
+import { YStack } from '@hanzo/gui';
+import type { ComponentProps, ReactNode } from 'react';
+export type DialogStackItem = {
+    id: string;
+    title: ReactNode;
+    content: ReactNode;
+};
+export type DialogStackProps = ComponentProps<typeof YStack> & {
+    dialogs: DialogStackItem[];
+    onClose?: (id: string) => void;
+};
+export declare function DialogStack({ dialogs, onClose, children, ...props }: DialogStackProps): import("react").JSX.Element;
+//# sourceMappingURL=dialog-stack.d.ts.map

package/dist/backends/gui/dialog-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-stack.d.ts","sourceRoot":"","sources":["../../../src/backends/gui/dialog-stack.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,OAAO,EAAU,MAAM,EAAE,MAAM,YAAY,CAAA;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAStD,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,SAAS,CAAA;IAChB,OAAO,EAAE,SAAS,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC,OAAO,MAAM,CAAC,GAAG;IAC7D,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B,CAAA;AAED,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,+BA2CrF"}