@owdproject/core 3.4.0 → 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,142 +1,86 @@
 {
   "name": "@owdproject/core",
-  "version": "3.4.0",
-  "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"
-  ],
+  "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",
-  "bugs": {
-    "url": "https://github.com/owdproject/core/issues"
-  },
   "repository": {
     "type": "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": [
     "dist",
-    "kit",
-    "runtime",
-    "types",
-    "index.ts",
-    "module.ts",
-    "package.json",
-    "README.md",
-    "DESKTOP_KERNEL.md",
-    "CHANGELOG.md",
-    "MIGRATION_3.3.2.md",
-    "MIGRATION_3.4.md",
-    "PLAYGROUND.md"
+    "README.md"
   ],
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha",
+    "registry": "https://registry.npmjs.org/"
+  },
   "exports": {
     ".": {
-      "types": "./types/index.d.ts",
-      "default": "./index.ts"
-    },
-    "./module": {
-      "types": "./dist/types.d.mts",
-      "development": "./module.ts",
-      "import": "./module.ts",
-      "default": "./module.ts"
-    },
-    "./nuxt": {
-      "types": "./dist/types.d.mts",
-      "development": "./module.ts",
-      "import": "./module.ts",
-      "default": "./module.ts"
-    },
-    "./package.json": "./package.json",
-    "./kit/*": {
-      "types": "./types/index.d.ts",
-      "development": "./kit/*",
-      "import": "./kit/*",
-      "default": "./kit/*"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
     },
-    "./runtime/composables/*": {
-      "types": "./runtime/composables/*",
-      "development": "./runtime/composables/*",
-      "import": "./runtime/composables/*",
-      "default": "./runtime/composables/*"
+    "./machines": {
+      "types": "./dist/machines/index.d.ts",
+      "import": "./dist/machines/index.mjs",
+      "default": "./dist/machines/index.mjs"
     },
-    "./runtime/constants/*": {
-      "types": "./runtime/constants/*",
-      "development": "./runtime/constants/*",
-      "import": "./runtime/constants/*",
-      "default": "./runtime/constants/*"
+    "./layout": {
+      "types": "./dist/layout/index.d.ts",
+      "import": "./dist/layout/index.mjs",
+      "default": "./dist/layout/index.mjs"
     },
-    "./runtime/dialogs/*": {
-      "types": "./runtime/dialogs/*",
-      "development": "./runtime/dialogs/*",
-      "import": "./runtime/dialogs/*",
-      "default": "./runtime/dialogs/*"
+    "./managers": {
+      "types": "./dist/managers/index.d.ts",
+      "import": "./dist/managers/index.mjs",
+      "default": "./dist/managers/index.mjs"
     },
-    "./runtime/utils/*": {
-      "types": "./runtime/utils/*",
-      "development": "./runtime/utils/*",
-      "import": "./runtime/utils/*",
-      "default": "./runtime/utils/*"
+    "./events": {
+      "types": "./dist/events/index.d.ts",
+      "import": "./dist/events/index.mjs",
+      "default": "./dist/events/index.mjs"
     },
-    "./runtime/stores/*": {
-      "types": "./runtime/stores/*",
-      "development": "./runtime/stores/*",
-      "import": "./runtime/stores/*",
-      "default": "./runtime/stores/*"
+    "./session": {
+      "types": "./dist/session/index.d.ts",
+      "import": "./dist/session/index.mjs",
+      "default": "./dist/session/index.mjs"
     },
-    "./runtime/components/*": {
-      "types": "./runtime/components/*",
-      "development": "./runtime/components/*",
-      "import": "./runtime/components/*",
-      "default": "./runtime/components/*"
+    "./dom": {
+      "types": "./dist/dom/index.d.ts",
+      "import": "./dist/dom/index.mjs",
+      "default": "./dist/dom/index.mjs"
     },
-    "./runtime/types/*": {
-      "types": "./runtime/types/*",
-      "development": "./runtime/types/*",
-      "import": "./runtime/types/*",
-      "default": "./runtime/types/*"
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.mjs",
+      "default": "./dist/types/index.mjs"
     }
   },
   "dependencies": {
-    "@nuxt/fonts": "^0.14.0",
-    "@nuxt/icon": "^2.2.1",
-    "@nuxt/kit": "^4.4.4",
-    "@nuxtjs/i18n": "^10.3.0",
-    "@pinia/nuxt": "^0.11.3",
-    "@vueuse/components": "^14.3.0",
-    "@vueuse/core": "^14.3.0",
-    "@vueuse/nuxt": "^14.3.0",
-    "defu": "^6.1.4",
-    "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",
-    "vue-resizable": "^2.1.7"
+    "getopts": "^2.3.0",
+    "hookable": "^6.1.2",
+    "nanoid": "^6.0.2",
+    "shellwords": "^1.1.1",
+    "xstate": "^5.33.3"
   },
   "devDependencies": {
-    "@nuxt/module-builder": "^1.0.2",
-    "typescript": "~6.0.3"
+    "unbuild": "^3.6.1",
+    "typescript": "~6.0.3",
+    "@types/getopts": "^2.1.0"
   },
   "scripts": {
-    "dev": "pnpm run dev:prepare",
-    "dev:prepare": "nuxt-module-build build --stub",
-    "build:module": "nuxt-module-build build",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage"
+    "build": "unbuild",
+    "prepack": "unbuild"
   }
-}
+}

package/CHANGELOG.md

@@ -1,98 +0,0 @@
-## 3.4.1 (2026-06-09)
-
-### 🚀 Features
-
-- Pinia store ids use `desktop/*` and `desktop/application/*` instead of legacy `owd/desktop/*` and `owd/application/*`.
-- Automatic one-shot localStorage migration on first client boot when `@owdproject/module-persistence` is installed (legacy keys are copied then removed).
-
-### 📚 Documentation
-
-- Document Pinia store id changes in `MIGRATION_3.4.md` and `DESKTOP_KERNEL.md`.
-
-## 3.4.0 (2026-06-10)
-
-### ⚠️ Breaking Changes
-
-- Core no longer installs PrimeVue or Tailwind. Use `@owdproject/kit-primevue` in themes; register Tailwind content via `registerTailwindPath` / `registerThemeTailwindPath` from the kit.
-- Headless explorer and ZenFS live in `@owdproject/module-fs`; optional PV explorer UI in `@owdproject/kit-primevue`.
-- Nuxt module `configKey` is `desktop` (was `owd`). App plugins should use `desktop-<slug>-register` (legacy `owd-<slug>-register` is rejected by validate).
-
-### 🚀 Features
-
-- `validateModule` accepts `defineDesktopModule` / `defineDesktopTheme`; infrastructure playbook for `@owdproject/kit-primevue`.
-- Nx install executors resolve `desktop.config.ts` with `owd.config.ts` fallback.
-
-### 📚 Documentation
-
-- Add `MIGRATION_3.4.md` (import paths, Tailwind contract, module naming).
-- Ship `DESKTOP_KERNEL.md` and migration guides in the npm package.
-
-## 3.3.2 (2026-06-01)
-
-### 🚀 Features
-
-- Add `defineDesktopModule`, `defineDesktopTheme`, `setDesktopExtensionConfig`, `installDesktopPackage` (core bootstrap), and `mergeDesktopExtensionConfig` for extension/theme authoring.
-- Add runtime composables: `useDesktopConfig`, `useDesktopExtension`, `hasDesktopModule`, `hasDesktopApp`, `hasDesktopExtension`.
-- Extension packages augment `DesktopConfig` via `types/desktop.d.ts` (`terminal`, `fs`, …) instead of hard-coding keys in core.
-
-### 🩹 Fixes
-
-- Merge the full `desktop.config.ts` export into `runtimeConfig.public.desktop` (including `theme`, `apps`, `modules`, and extension namespaces).
-- Remove misleading “unknown desktop key” warnings for valid extension keys (`fs`, `terminal`, custom app namespaces); only warn keys that look like Nuxt options (`ssr`, `vite`, …).
-- `app-terminal` no longer overwrites `desktop.config` `terminal` with module defaults only; UI reads `public.desktop.terminal`.
-
-### 📚 Documentation
-
-- Update `desktop-config` setup doc and `DESKTOP_KERNEL.md` for 3.3.2 merge and API (supersedes 3.3.0 `splitDesktopUserConfig` / allowlist description).
-- Add migration guide for themes, apps, and modules (`docs/content/6.setup/5.migrate-packages-3.3.2.md`, `MIGRATION_3.3.2.md`).
-
-### 🔧 Internal
-
-- Remove `splitDesktopUserConfig` (was not a public export).
-
-## 3.3.0 (2026-05-31)
-
-### ⚠️ Breaking Changes
-
-- Rename kernel Vue components from `Core*` to `Desktop*` (e.g. `CoreDesktop` → `DesktopCore`, `CoreWindow` → `DesktopWindow`). Themes must update their templates.
-- Remove explorer from kernel: `DesktopExplorer*` components, `useDesktopExplorerStore`, and `explorer` slice in `useDesktopStore` moved to `@owdproject/kit-fs` (`useExplorerStore`, `KitFsExplorer*`).
-- `desktop.config.ts` is no longer spread onto `_nuxt.options`; only `runtimeConfig.public.desktop` / `appConfig.desktop` receive shell keys.
-
-### 🚀 Features
-
-- Add `splitDesktopUserConfig` with allowlist warnings for misconfigured keys.
-- Shell config merge uses `defu` (UnJS) instead of custom `deepMerge` / `mergeDesktopShell`.
-- Add window manager contract tests and [`DESKTOP_KERNEL.md`](DESKTOP_KERNEL.md).
-
-## 3.2.0 (2026-05-22)
-
-### 🚀 Features
-
-- Workspace edge drop helpers moved to `@owdproject/kit-theme` (`useWorkspaceEdgeDrop`).
-- Desktop config and module playground validation aligned with Nuxt 4 module authoring.
-
-## 3.1.4 (2025-05-22)
-
-### 🚀 Features
-
-- Allow apps to have a menu ([4bfea74](https://github.com/owdproject/client/commit/4bfea74))
-- Add methods to better handle window changes ([54d1346](https://github.com/owdproject/client/commit/54d1346))
-- Check if owd.config.ts is available and valid ([4920302](https://github.com/owdproject/client/commit/4920302))
-- Add fit-parent to CoreWindow.vue ([59e068c](https://github.com/owdproject/client/commit/59e068c))
-- Add focus() to WindowController and set methods as public (deprecate actions) ([710f7be](https://github.com/owdproject/client/commit/710f7be))
-- Add owd global command ([f98c74c](https://github.com/owdproject/client/commit/f98c74c))
-- Add useClipboardFs.ts composable ([cf934f4](https://github.com/owdproject/client/commit/cf934f4))
-- Add window utils in ApplicationController.ts ([ffc97d0](https://github.com/owdproject/client/commit/ffc97d0))
-- Export most used functions from core ([6635af7](https://github.com/owdproject/client/commit/6635af7))
-- Merge owd.config.ts with nuxt.config.ts in module.ts ([069243c](https://github.com/owdproject/client/commit/069243c))
-- Implement basic owd.config.ts ([d052552](https://github.com/owdproject/client/commit/d052552))
-- Rewrite project ([cbbd45d](https://github.com/owdproject/client/commit/cbbd45d))
-
-### 🩹 Fixes
-
-- Add key on CoreApplicationWindowsRender v-for ([d2e8e3c](https://github.com/owdproject/client/commit/d2e8e3c))
-- Check if entries property is set before normalizing in utilApp.ts ([6092c33](https://github.com/owdproject/client/commit/6092c33))
-- Add missing min-width ([aa0c1b5](https://github.com/owdproject/client/commit/aa0c1b5))
-- Minor improvements ([7f79208](https://github.com/owdproject/client/commit/7f79208))
-- Fix imports ([44740cd](https://github.com/owdproject/client/commit/44740cd))
-- Set window starting positionZ to 0 ([b99352e](https://github.com/owdproject/client/commit/b99352e))