defuss-desktop 0.0.1

package/dist/index.d.cts

@@ -0,0 +1,234 @@
+import * as defuss from 'defuss';
+import { Props, CallChainImpl, Dequery, NodeType, Ref } from 'defuss';
+
+declare function Desktop({ ref }: Props): any;
+
+interface ButtonProps extends Props {
+    onClick?: () => void;
+    disabled?: boolean;
+}
+declare function Button({ onClick, disabled, children, ref, }: ButtonProps): any;
+
+interface LogonScreenProps extends Props {
+    cDriveBasePath?: string;
+    showGuestUser?: boolean;
+    onTurnOffComputer?: () => void;
+    onGuestLogon?: () => void;
+    onUserLogonSubmit?: (userName: string, password: string) => Promise<boolean | string>;
+}
+type LoginForm = {
+    username: string;
+    password: string;
+};
+declare const LogonScreen: ({ cDriveBasePath, showGuestUser, onTurnOffComputer, onGuestLogon, onUserLogonSubmit, ref, }: LogonScreenProps) => any;
+
+interface DefussAppConfig {
+    name: string;
+    icon: string;
+    main: (app: DefussApp, ...args: any[]) => void;
+    argv?: any[];
+}
+declare class DefussApp {
+    config: DefussAppConfig;
+    constructor(config: DefussAppConfig);
+    run(): void;
+}
+
+interface Dimensions2D {
+    width: number;
+    height: number;
+}
+
+interface DesktopIconConfig {
+    name: string;
+    icon: string;
+    app: DefussApp;
+    x?: number;
+    y?: number;
+}
+interface DesktopState {
+    icons: DesktopIconConfig[];
+}
+declare class DefussDesktopAppIcon {
+    config: DesktopIconConfig;
+    constructor(config: DesktopIconConfig);
+}
+type DesktopResizeCallback = (dimensions: Dimensions2D) => void;
+interface CreateDesktopOptions {
+    icons: DefussDesktopAppIcon[];
+    iconSize?: "small" | "medium" | "large";
+    backgroundImage?: string;
+    backgroundImageSize?: "cover" | "contain";
+    backgroundRepeat?: "no-repeat" | "repeat" | "repeat-x" | "repeat-y";
+    backgroundPosition?: "center" | "top" | "bottom" | "left" | "right";
+    backgroundColor: string;
+}
+declare const defaultDesktopOptions: CreateDesktopOptions;
+declare class DesktopManager {
+    options: CreateDesktopOptions;
+    el?: HTMLElement;
+    state?: DesktopState;
+    resizeObserver?: ResizeObserver;
+    resizeCallbacks: Set<DesktopResizeCallback>;
+    constructor(options?: CreateDesktopOptions);
+    init(el: HTMLElement, options?: CreateDesktopOptions): void;
+    render(el: HTMLElement): void;
+    addIcon(icon: DefussDesktopAppIcon): void;
+    getDimensions(): Dimensions2D;
+    private setupResizeObserver;
+    /**
+     * Register a callback for desktop resize events
+     * @param callback Function to call when desktop is resized
+     * @returns Unregister function to remove the callback
+     */
+    onResize(callback: DesktopResizeCallback): () => void;
+}
+declare const desktopManager: DesktopManager;
+
+interface ShellProps extends Props {
+    desktopConfig: CreateDesktopOptions;
+}
+declare function Shell({ ref, desktopConfig, }: ShellProps): any;
+
+declare const Taskbar: () => any;
+
+declare const StartButton: () => any;
+
+declare const StartMenu: () => any;
+
+declare class DequeryWithWindowManager<NT> extends CallChainImpl<NT, DequeryWithWindowManager<NT> & Dequery<NT>> {
+    createDesktopApp(options: DefussAppConfig): PromiseLike<DefussApp>;
+    createDesktopAppIcon(options: DesktopIconConfig): PromiseLike<DefussDesktopAppIcon>;
+}
+/**
+ * Extended dequery function with window management capabilities.
+ *
+ * @param selector - CSS selector, element, or NodeList to query
+ * @param options - Optional dequery options
+ * @returns Extended dequery instance with createWindow and createTaskbar methods
+ */
+declare const $: <NT = defuss.DequerySyncMethodReturnType>(selectorRefOrEl: string | NodeType | defuss.Ref<any, NodeType> | defuss.RenderInput | Function, options?: (defuss.DequeryOptions<NT> & JSX.HTMLAttributesLowerCase & {
+    html?: string;
+    text?: string;
+}) | undefined) => DequeryWithWindowManager<unknown>;
+
+interface WindowRefState {
+    onClose: () => void;
+    onMinimize: () => void;
+    onMaximize: () => void;
+    minimize: () => void;
+    maximize: () => void;
+    restore: () => void;
+    close: () => void;
+}
+
+interface CreateWindowOptions {
+    id?: string;
+    title?: string;
+    icon?: string;
+    width?: number;
+    height?: number;
+    x?: number;
+    y?: number;
+    minimizable?: boolean;
+    maximizable?: boolean;
+    minimized?: boolean;
+    maximized?: boolean;
+    onClose?: () => void;
+    onMinimize?: () => void;
+    onMaximize?: () => void;
+    resizable?: boolean;
+}
+interface WindowState {
+    id: string;
+    el: HTMLElement;
+    ref: Ref<WindowRefState>;
+    title: string;
+    icon: string;
+    width: number;
+    height: number;
+    prevX: number;
+    prevY: number;
+    prevWidth: number;
+    prevHeight: number;
+    originalDimensionsStored: boolean;
+    x: number;
+    y: number;
+    resizable: boolean;
+    draggable: boolean;
+    closeable: boolean;
+    minimizable: boolean;
+    maximizable: boolean;
+    minimized: boolean;
+    maximized: boolean;
+}
+declare const defaultWindowOptions: CreateWindowOptions;
+declare class WindowManager {
+    windows: Array<WindowState>;
+    constructor();
+    onDesktopResized(dimensions: Dimensions2D): void;
+    getActiveWindow(): WindowState | undefined;
+    getWindow(id?: string): WindowState | undefined;
+    setActiveWindow(id: string): void;
+    renderWindowsActivationState(): void;
+    addWindow(options: CreateWindowOptions): WindowState;
+    updateWindow(id: string, options: Partial<WindowState>): WindowState | undefined;
+    closeWindow(id: string): void;
+    maximizeWindow(id: string): void;
+    minimizeWindow(id: string): void;
+    restoreWindow(id: string): void;
+    toggleTitleBarMaximizedButtonState(id: string): void;
+}
+declare const windowManager: WindowManager;
+
+interface CreateTaskbarOptions {
+    position?: "top" | "bottom" | "left" | "right";
+    stateful?: boolean;
+    theme?: string;
+    size?: "small" | "medium" | "large";
+}
+interface TaskbarState {
+    position: "top" | "bottom" | "left" | "right";
+    theme: string;
+    size: "small" | "medium" | "large";
+}
+declare const defaultTaskbarOptions: CreateTaskbarOptions;
+declare class TaskbarManager {
+    position: "top" | "bottom" | "left" | "right";
+    theme: string;
+    size: "small" | "medium" | "large";
+    constructor(options?: CreateTaskbarOptions);
+    getDimensions(): Dimensions2D;
+}
+declare const taskbarManager: TaskbarManager;
+
+type DesktopShellTheme = "xp" | "98";
+interface DesktopShellState {
+    taskbar: TaskbarState;
+    windows: Record<string, WindowState>;
+}
+declare class DesktopShellManager {
+    apps: DefussApp[];
+    constructor(apps?: DefussApp[]);
+    addApp(app: DefussApp): void;
+}
+declare const desktopShell: DesktopShellManager;
+
+declare const defaultSystemSoundFilePaths: Array<string>;
+declare class SoundManager {
+    private audioContext;
+    private audioCacheBuffers;
+    private activeSources;
+    init(): Promise<void>;
+    preload(url: Array<string> | string): Promise<AudioBuffer | AudioBuffer[]>;
+    play(bufferOrBufferUrl: AudioBuffer | string, options?: {
+        volume?: number;
+        loop?: boolean;
+    }): Promise<AudioBufferSourceNode>;
+    stopAllSounds(): void;
+    clearCache(): void;
+}
+declare const soundManager: SoundManager;
+
+export { $, Button, DefussApp, DefussDesktopAppIcon, DequeryWithWindowManager, Desktop, DesktopManager, DesktopShellManager, LogonScreen, Shell, SoundManager, StartButton, StartMenu, Taskbar, TaskbarManager, WindowManager, defaultDesktopOptions, defaultSystemSoundFilePaths, defaultTaskbarOptions, defaultWindowOptions, desktopManager, desktopShell, soundManager, taskbarManager, windowManager };
+export type { ButtonProps, CreateDesktopOptions, CreateTaskbarOptions, CreateWindowOptions, DefussAppConfig, DesktopIconConfig, DesktopResizeCallback, DesktopShellState, DesktopShellTheme, DesktopState, LoginForm, LogonScreenProps, ShellProps, TaskbarState, WindowState };

package/dist/index.d.mts

@@ -0,0 +1,234 @@
+import * as defuss from 'defuss';
+import { Props, CallChainImpl, Dequery, NodeType, Ref } from 'defuss';
+
+declare function Desktop({ ref }: Props): any;
+
+interface ButtonProps extends Props {
+    onClick?: () => void;
+    disabled?: boolean;
+}
+declare function Button({ onClick, disabled, children, ref, }: ButtonProps): any;
+
+interface LogonScreenProps extends Props {
+    cDriveBasePath?: string;
+    showGuestUser?: boolean;
+    onTurnOffComputer?: () => void;
+    onGuestLogon?: () => void;
+    onUserLogonSubmit?: (userName: string, password: string) => Promise<boolean | string>;
+}
+type LoginForm = {
+    username: string;
+    password: string;
+};
+declare const LogonScreen: ({ cDriveBasePath, showGuestUser, onTurnOffComputer, onGuestLogon, onUserLogonSubmit, ref, }: LogonScreenProps) => any;
+
+interface DefussAppConfig {
+    name: string;
+    icon: string;
+    main: (app: DefussApp, ...args: any[]) => void;
+    argv?: any[];
+}
+declare class DefussApp {
+    config: DefussAppConfig;
+    constructor(config: DefussAppConfig);
+    run(): void;
+}
+
+interface Dimensions2D {
+    width: number;
+    height: number;
+}
+
+interface DesktopIconConfig {
+    name: string;
+    icon: string;
+    app: DefussApp;
+    x?: number;
+    y?: number;
+}
+interface DesktopState {
+    icons: DesktopIconConfig[];
+}
+declare class DefussDesktopAppIcon {
+    config: DesktopIconConfig;
+    constructor(config: DesktopIconConfig);
+}
+type DesktopResizeCallback = (dimensions: Dimensions2D) => void;
+interface CreateDesktopOptions {
+    icons: DefussDesktopAppIcon[];
+    iconSize?: "small" | "medium" | "large";
+    backgroundImage?: string;
+    backgroundImageSize?: "cover" | "contain";
+    backgroundRepeat?: "no-repeat" | "repeat" | "repeat-x" | "repeat-y";
+    backgroundPosition?: "center" | "top" | "bottom" | "left" | "right";
+    backgroundColor: string;
+}
+declare const defaultDesktopOptions: CreateDesktopOptions;
+declare class DesktopManager {
+    options: CreateDesktopOptions;
+    el?: HTMLElement;
+    state?: DesktopState;
+    resizeObserver?: ResizeObserver;
+    resizeCallbacks: Set<DesktopResizeCallback>;
+    constructor(options?: CreateDesktopOptions);
+    init(el: HTMLElement, options?: CreateDesktopOptions): void;
+    render(el: HTMLElement): void;
+    addIcon(icon: DefussDesktopAppIcon): void;
+    getDimensions(): Dimensions2D;
+    private setupResizeObserver;
+    /**
+     * Register a callback for desktop resize events
+     * @param callback Function to call when desktop is resized
+     * @returns Unregister function to remove the callback
+     */
+    onResize(callback: DesktopResizeCallback): () => void;
+}
+declare const desktopManager: DesktopManager;
+
+interface ShellProps extends Props {
+    desktopConfig: CreateDesktopOptions;
+}
+declare function Shell({ ref, desktopConfig, }: ShellProps): any;
+
+declare const Taskbar: () => any;
+
+declare const StartButton: () => any;
+
+declare const StartMenu: () => any;
+
+declare class DequeryWithWindowManager<NT> extends CallChainImpl<NT, DequeryWithWindowManager<NT> & Dequery<NT>> {
+    createDesktopApp(options: DefussAppConfig): PromiseLike<DefussApp>;
+    createDesktopAppIcon(options: DesktopIconConfig): PromiseLike<DefussDesktopAppIcon>;
+}
+/**
+ * Extended dequery function with window management capabilities.
+ *
+ * @param selector - CSS selector, element, or NodeList to query
+ * @param options - Optional dequery options
+ * @returns Extended dequery instance with createWindow and createTaskbar methods
+ */
+declare const $: <NT = defuss.DequerySyncMethodReturnType>(selectorRefOrEl: string | NodeType | defuss.Ref<any, NodeType> | defuss.RenderInput | Function, options?: (defuss.DequeryOptions<NT> & JSX.HTMLAttributesLowerCase & {
+    html?: string;
+    text?: string;
+}) | undefined) => DequeryWithWindowManager<unknown>;
+
+interface WindowRefState {
+    onClose: () => void;
+    onMinimize: () => void;
+    onMaximize: () => void;
+    minimize: () => void;
+    maximize: () => void;
+    restore: () => void;
+    close: () => void;
+}
+
+interface CreateWindowOptions {
+    id?: string;
+    title?: string;
+    icon?: string;
+    width?: number;
+    height?: number;
+    x?: number;
+    y?: number;
+    minimizable?: boolean;
+    maximizable?: boolean;
+    minimized?: boolean;
+    maximized?: boolean;
+    onClose?: () => void;
+    onMinimize?: () => void;
+    onMaximize?: () => void;
+    resizable?: boolean;
+}
+interface WindowState {
+    id: string;
+    el: HTMLElement;
+    ref: Ref<WindowRefState>;
+    title: string;
+    icon: string;
+    width: number;
+    height: number;
+    prevX: number;
+    prevY: number;
+    prevWidth: number;
+    prevHeight: number;
+    originalDimensionsStored: boolean;
+    x: number;
+    y: number;
+    resizable: boolean;
+    draggable: boolean;
+    closeable: boolean;
+    minimizable: boolean;
+    maximizable: boolean;
+    minimized: boolean;
+    maximized: boolean;
+}
+declare const defaultWindowOptions: CreateWindowOptions;
+declare class WindowManager {
+    windows: Array<WindowState>;
+    constructor();
+    onDesktopResized(dimensions: Dimensions2D): void;
+    getActiveWindow(): WindowState | undefined;
+    getWindow(id?: string): WindowState | undefined;
+    setActiveWindow(id: string): void;
+    renderWindowsActivationState(): void;
+    addWindow(options: CreateWindowOptions): WindowState;
+    updateWindow(id: string, options: Partial<WindowState>): WindowState | undefined;
+    closeWindow(id: string): void;
+    maximizeWindow(id: string): void;
+    minimizeWindow(id: string): void;
+    restoreWindow(id: string): void;
+    toggleTitleBarMaximizedButtonState(id: string): void;
+}
+declare const windowManager: WindowManager;
+
+interface CreateTaskbarOptions {
+    position?: "top" | "bottom" | "left" | "right";
+    stateful?: boolean;
+    theme?: string;
+    size?: "small" | "medium" | "large";
+}
+interface TaskbarState {
+    position: "top" | "bottom" | "left" | "right";
+    theme: string;
+    size: "small" | "medium" | "large";
+}
+declare const defaultTaskbarOptions: CreateTaskbarOptions;
+declare class TaskbarManager {
+    position: "top" | "bottom" | "left" | "right";
+    theme: string;
+    size: "small" | "medium" | "large";
+    constructor(options?: CreateTaskbarOptions);
+    getDimensions(): Dimensions2D;
+}
+declare const taskbarManager: TaskbarManager;
+
+type DesktopShellTheme = "xp" | "98";
+interface DesktopShellState {
+    taskbar: TaskbarState;
+    windows: Record<string, WindowState>;
+}
+declare class DesktopShellManager {
+    apps: DefussApp[];
+    constructor(apps?: DefussApp[]);
+    addApp(app: DefussApp): void;
+}
+declare const desktopShell: DesktopShellManager;
+
+declare const defaultSystemSoundFilePaths: Array<string>;
+declare class SoundManager {
+    private audioContext;
+    private audioCacheBuffers;
+    private activeSources;
+    init(): Promise<void>;
+    preload(url: Array<string> | string): Promise<AudioBuffer | AudioBuffer[]>;
+    play(bufferOrBufferUrl: AudioBuffer | string, options?: {
+        volume?: number;
+        loop?: boolean;
+    }): Promise<AudioBufferSourceNode>;
+    stopAllSounds(): void;
+    clearCache(): void;
+}
+declare const soundManager: SoundManager;
+
+export { $, Button, DefussApp, DefussDesktopAppIcon, DequeryWithWindowManager, Desktop, DesktopManager, DesktopShellManager, LogonScreen, Shell, SoundManager, StartButton, StartMenu, Taskbar, TaskbarManager, WindowManager, defaultDesktopOptions, defaultSystemSoundFilePaths, defaultTaskbarOptions, defaultWindowOptions, desktopManager, desktopShell, soundManager, taskbarManager, windowManager };
+export type { ButtonProps, CreateDesktopOptions, CreateTaskbarOptions, CreateWindowOptions, DefussAppConfig, DesktopIconConfig, DesktopResizeCallback, DesktopShellState, DesktopShellTheme, DesktopState, LoginForm, LogonScreenProps, ShellProps, TaskbarState, WindowState };