@owdproject/core 3.3.1 → 4.0.0-alpha.3

package/dist/types/index.d.ts

@@ -0,0 +1,266 @@
+/**
+ * @owdproject/core - Framework-Agnostic Types
+ */
+type WindowLayout = 'normal' | 'maximize' | 'bottom-half' | 'left-half' | 'right-half' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+type SnapZoneHint = Exclude<WindowLayout, 'normal'>;
+interface WindowBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface DesktopWorkareaRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+type WindowSizeValue = number | string | undefined;
+interface WindowSize {
+    width?: WindowSizeValue;
+    height?: WindowSizeValue;
+    minWidth?: WindowSizeValue;
+    minHeight?: WindowSizeValue;
+    maxWidth?: WindowSizeValue;
+    maxHeight?: WindowSizeValue;
+}
+interface WindowPosition {
+    x?: number;
+    y?: number;
+    z?: number;
+}
+interface SpatialPoint3D {
+    x: number;
+    y: number;
+    z: number;
+}
+interface SpatialEuler {
+    pitch: number;
+    yaw: number;
+    roll: number;
+}
+interface SpatialTransform {
+    position: SpatialPoint3D;
+    rotation?: SpatialEuler;
+    scale?: SpatialPoint3D;
+    distance?: number;
+    curveRadius?: number;
+}
+type SpatialLayoutMode = 'cylinder' | 'sphere' | 'carousel' | 'depth-stack';
+interface WindowConfig {
+    title?: string;
+    category?: string;
+    icon?: string;
+    component?: any;
+    position?: WindowPosition;
+    size: WindowSize;
+    minimizable?: boolean;
+    maximized?: boolean;
+    maximizable?: boolean;
+    destroyable?: boolean;
+    draggable?: boolean;
+    resizable?: boolean;
+    spatial?: SpatialTransform;
+    overridable?: Partial<Record<'position' | 'size' | 'maximized' | 'draggable' | 'resizable' | 'destroyable' | 'minimizable', boolean>>;
+}
+interface WindowOverride {
+    title?: string;
+    windowTitle?: string;
+    icon?: string;
+}
+interface WindowState {
+    id: string;
+    createdAt: number;
+    category?: string;
+    workspace: string;
+    position?: WindowPosition;
+    size?: WindowSize;
+    spatial?: SpatialTransform;
+    focused: boolean;
+    dragging?: boolean;
+    resizing?: boolean;
+    active?: boolean;
+    minimizable?: boolean;
+    maximized?: boolean;
+    maximizable?: boolean;
+    destroyable?: boolean;
+    draggable?: boolean;
+    resizable?: boolean;
+    layout?: WindowLayout;
+    boundsBeforeLayout?: WindowBounds;
+}
+interface WindowStoredState {
+    model: string;
+    state: WindowState;
+    meta: any;
+}
+type ApplicationEntryVisibility = 'primary' | 'secondary' | 'hidden';
+interface ApplicationEntry {
+    title?: string;
+    icon?: string;
+    category?: string;
+    visibility?: ApplicationEntryVisibility;
+    command: string | any;
+}
+type ApplicationPermission = string;
+interface ApplicationConfigProvide {
+    name: string;
+    entry: string;
+    command?: string;
+}
+interface ApplicationConfig {
+    id: string;
+    title: string;
+    icon?: string;
+    category?: string;
+    version?: string;
+    description?: string;
+    provides?: ApplicationConfigProvide;
+    singleton?: boolean;
+    meta?: Record<string, any>;
+    permissions?: ApplicationPermission[];
+    windows?: {
+        [key: string]: WindowConfig;
+    };
+    entries: {
+        [key: string]: ApplicationEntry;
+    };
+    commands?: {
+        [key: string]: (app: any, args: any) => void;
+    };
+    terminal?: {
+        [commandName: string]: Omit<DesktopCommand, 'name' | 'applicationId'>;
+    };
+    onReady?(app: any): void | Promise<void>;
+    onLaunch?(app: any): void | Promise<void>;
+    onRestore?(app: any): void | Promise<void>;
+    onClose?(app: any): void | Promise<void>;
+}
+interface DesktopCommandArg {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
+interface DesktopCommandOption {
+    flag: string;
+    description?: string;
+}
+interface DesktopCommand {
+    name: string;
+    applicationId: string;
+    description?: string;
+    usage?: string;
+    args?: DesktopCommandArg[];
+    options?: DesktopCommandOption[];
+}
+interface CommandOutput {
+    message: string;
+    isError?: boolean;
+}
+interface DesktopKernelEvent {
+    id: string;
+    timestamp: number;
+    channel: string;
+    source: string;
+    severity: 'info' | 'warn' | 'error';
+    payload?: any;
+}
+interface DesktopAppDefineContext {
+    id: string;
+    config: ApplicationConfig;
+    cancel?: boolean;
+}
+interface DesktopAppLaunchContext {
+    app: any;
+    entryKey?: string;
+    argument?: string;
+    cancel?: boolean;
+}
+interface DesktopAppSignalContext {
+    app: any;
+    signal?: 'SIGTERM' | 'SIGKILL' | 'SIGSTOP' | 'SIGCONT';
+    cancel?: boolean;
+}
+interface DesktopWindowOpenContext {
+    app: any;
+    model: string;
+    config: WindowConfig;
+    meta?: Record<string, any>;
+    cancel?: boolean;
+}
+interface DesktopWindowCloseContext {
+    window: any;
+    app: any;
+    cancel?: boolean;
+}
+interface DesktopCommandExecContext {
+    input: string;
+    commandName: string;
+    args: string[];
+    cancel?: boolean;
+    overrideOutput?: CommandOutput;
+}
+interface DesktopWorkspaceSwitchContext {
+    from: string;
+    to: string;
+    cancel?: boolean;
+}
+interface DesktopRuntimeHooks {
+    'app:before-define': (ctx: DesktopAppDefineContext) => Promise<void> | void;
+    'app:defined': (payload: {
+        app: any;
+    }) => Promise<void> | void;
+    'app:before-launch': (ctx: DesktopAppLaunchContext) => Promise<void> | void;
+    'app:launched': (payload: {
+        app: any;
+        pid: number | null;
+    }) => Promise<void> | void;
+    'app:before-suspend': (ctx: DesktopAppSignalContext) => Promise<void> | void;
+    'app:suspended': (payload: {
+        app: any;
+    }) => Promise<void> | void;
+    'app:before-resume': (ctx: DesktopAppSignalContext) => Promise<void> | void;
+    'app:resumed': (payload: {
+        app: any;
+    }) => Promise<void> | void;
+    'app:before-terminate': (ctx: DesktopAppSignalContext) => Promise<void> | void;
+    'app:terminated': (payload: {
+        id: string;
+        title: string;
+        pid: number | null;
+    }) => Promise<void> | void;
+    'window:before-open': (ctx: DesktopWindowOpenContext) => Promise<void> | void;
+    'window:opened': (payload: {
+        window: any;
+        app: any;
+    }) => Promise<void> | void;
+    'window:focused': (payload: {
+        window: any;
+        previousWindow?: any;
+    }) => Promise<void> | void;
+    'window:blurred': (payload: {
+        window: any;
+    }) => Promise<void> | void;
+    'window:layout-change': (payload: {
+        window: any;
+        layout: WindowLayout;
+    }) => Promise<void> | void;
+    'window:before-close': (ctx: DesktopWindowCloseContext) => Promise<void> | void;
+    'window:closed': (payload: {
+        windowId: string;
+        app: any;
+    }) => Promise<void> | void;
+    'command:before-exec': (ctx: DesktopCommandExecContext) => Promise<void> | void;
+    'command:after-exec': (payload: {
+        input: string;
+        commandName: string;
+        output: CommandOutput | void;
+    }) => Promise<void> | void;
+    'workspace:before-switch': (ctx: DesktopWorkspaceSwitchContext) => Promise<void> | void;
+    'workspace:switched': (payload: {
+        from: string;
+        to: string;
+    }) => Promise<void> | void;
+}
+
+export type { ApplicationConfig, ApplicationConfigProvide, ApplicationEntry, ApplicationEntryVisibility, ApplicationPermission, CommandOutput, DesktopAppDefineContext, DesktopAppLaunchContext, DesktopAppSignalContext, DesktopCommand, DesktopCommandArg, DesktopCommandExecContext, DesktopCommandOption, DesktopKernelEvent, DesktopRuntimeHooks, DesktopWindowCloseContext, DesktopWindowOpenContext, DesktopWorkareaRect, DesktopWorkspaceSwitchContext, SnapZoneHint, SpatialEuler, SpatialLayoutMode, SpatialPoint3D, SpatialTransform, WindowBounds, WindowConfig, WindowLayout, WindowOverride, WindowPosition, WindowSize, WindowSizeValue, WindowState, WindowStoredState };

package/dist/types/index.mjs

@@ -0,0 +1 @@
+

package/package.json

@@ -1,113 +1,86 @@
 {
   "name": "@owdproject/core",
-  "version": "3.3.1",
-  "description": "Nuxt Desktop module for browser desktop experiences (windows, shell, apps)",
-  "keywords": [
-    "nuxt",
-    "nuxt-module",
-    "nuxt-desktop",
-    "desktop",
-    "web-desktop",
-    "vue",
-    "owd",
-    "open-web-desktop"
-  ],
-  "homepage": "https://github.com/owdproject/client#readme",
-  "bugs": {
-    "url": "https://github.com/owdproject/client/issues"
-  },
+  "version": "4.0.0-alpha.3",
+  "description": "Headless desktop engine for the web: windows, applications, workspaces, commands, hooks, IPC, and pointer math",
+  "homepage": "https://github.com/owdproject/core#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/owdproject/client.git"
+    "url": "git+https://github.com/owdproject/core.git"
   },
-  "license": "MIT",
   "author": {
-    "name": "Open Web Desktop Team",
-    "url": "https://github.com/owdproject"
+    "name": "Diego Villa (@dxlliv)",
+    "url": "https://github.com/dxlliv"
   },
+  "license": "MIT",
   "type": "module",
-  "types": "types/index.d.ts",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
   "files": [
-    "bin",
     "dist",
-    "runtime",
-    "types",
-    "index.ts",
-    "module.ts",
-    "package.json",
     "README.md"
   ],
-  "scripts": {
-    "dev": "pnpm run dev:prepare",
-    "dev:prepare": "nuxt-module-build build --stub",
-    "build:module": "nuxt-module-build build",
-    "prepack": "nuxt-module-build build",
-    "test": "vitest run",
-    "test:watch": "vitest"
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha",
+    "registry": "https://registry.npmjs.org/"
   },
   "exports": {
     ".": {
-      "types": "./types/index.d.ts",
-      "default": "./index.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./machines": {
+      "types": "./dist/machines/index.d.ts",
+      "import": "./dist/machines/index.mjs",
+      "default": "./dist/machines/index.mjs"
+    },
+    "./layout": {
+      "types": "./dist/layout/index.d.ts",
+      "import": "./dist/layout/index.mjs",
+      "default": "./dist/layout/index.mjs"
+    },
+    "./managers": {
+      "types": "./dist/managers/index.d.ts",
+      "import": "./dist/managers/index.mjs",
+      "default": "./dist/managers/index.mjs"
     },
-    "./module": {
-      "types": "./dist/types.d.mts",
-      "development": "./module.ts",
-      "import": "./module.ts",
-      "default": "./module.ts"
+    "./events": {
+      "types": "./dist/events/index.d.ts",
+      "import": "./dist/events/index.mjs",
+      "default": "./dist/events/index.mjs"
     },
-    "./nuxt": {
-      "types": "./dist/types.d.mts",
-      "development": "./module.ts",
-      "import": "./module.ts",
-      "default": "./module.ts"
+    "./session": {
+      "types": "./dist/session/index.d.ts",
+      "import": "./dist/session/index.mjs",
+      "default": "./dist/session/index.mjs"
     },
-    "./package.json": "./package.json",
-    "./runtime/*": {
-      "types": "./runtime/*",
-      "development": "./runtime/*",
-      "import": "./runtime/*",
-      "default": "./runtime/*"
+    "./dom": {
+      "types": "./dist/dom/index.d.ts",
+      "import": "./dist/dom/index.mjs",
+      "default": "./dist/dom/index.mjs"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.mjs",
+      "default": "./dist/types/index.mjs"
     }
   },
-  "bin": {
-    "desktop": "bin/desktop.js",
-    "owd": "bin/owd.js"
-  },
   "dependencies": {
-    "@nuxt/fonts": "^0.14.0",
-    "@nuxt/icon": "^2.2.1",
-    "@nuxt/kit": "^4.4.4",
-    "@nuxtjs/i18n": "^10.3.0",
-    "@nuxtjs/tailwindcss": "^6.14.0",
-    "@pinia/nuxt": "^0.11.3",
-    "@primeuix/themes": "^2.0.3",
-    "@primevue/forms": "^4.5.5",
-    "@primevue/nuxt-module": "^4.5.5",
-    "primevue": "^4.5.5",
-    "@vueuse/components": "^14.3.0",
-    "@vueuse/core": "^14.3.0",
-    "@vueuse/nuxt": "^14.3.0",
-    "mitt": "^3.0.1",
-    "nanoid": "^5.1.11",
-    "nuxt": "^4.4.4",
-    "pinia": "^3.0.4",
-    "sanitize.css": "^13.0.0",
-    "sass": "^1.99.0",
-    "shellwords": "^1.1.1",
-    "vue-resizable": "^2.1.7",
     "getopts": "^2.3.0",
-    "defu": "^6.1.4",
-    "neo-blessed": "^0.2.0"
-  },
-  "optionalDependencies": {
-    "html2canvas": "^1.4.1"
+    "hookable": "^6.1.2",
+    "nanoid": "^6.0.2",
+    "shellwords": "^1.1.1",
+    "xstate": "^5.33.3"
   },
   "devDependencies": {
-    "@nuxt/devtools": "^3.2.4",
-    "@nuxt/module-builder": "^1.0.2",
-    "@nuxt/schema": "^4.4.4",
-    "typescript": "~5.8.3",
-    "vue-tsc": "^2.2.10"
+    "unbuild": "^3.6.1",
+    "typescript": "~6.0.3",
+    "@types/getopts": "^2.1.0"
+  },
+  "scripts": {
+    "build": "unbuild",
+    "prepack": "unbuild"
   }
 }