@owdproject/core 3.1.4 → 3.2.0

package/dist/module.d.mts

@@ -0,0 +1,13 @@
+import * as _nuxt_schema from '@nuxt/schema';
+
+declare const _default: _nuxt_schema.NuxtModule<{
+    theme: string;
+    apps: never[];
+    modules: never[];
+}, {
+    theme: string;
+    apps: never[];
+    modules: never[];
+}, false>;
+
+export { _default as default };

package/dist/module.json

@@ -0,0 +1,9 @@
+{
+  "name": "desktop",
+  "configKey": "owd",
+  "version": "3.2.0",
+  "builder": {
+    "@nuxt/module-builder": "1.0.2",
+    "unbuild": "3.6.1"
+  }
+}

package/dist/module.mjs

@@ -0,0 +1,219 @@
+import { defineNuxtModule, createResolver, installModule, addComponentsDir, addPlugin, addImportsDir } from '@nuxt/kit';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+function deepMerge(target, source) {
+  function isObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date) && !(value instanceof RegExp);
+  }
+  if (isObject(target) && isObject(source)) {
+    const result = { ...target };
+    for (const key in source) {
+      const targetValue = target[key];
+      const sourceValue = source[key];
+      if (isObject(sourceValue) && isObject(targetValue)) {
+        result[key] = deepMerge(targetValue, sourceValue);
+      } else {
+        result[key] = sourceValue;
+      }
+    }
+    return result;
+  }
+  return source;
+}
+
+function assertValidOwdUserConfig(config, configFile = "desktop.config.ts") {
+  if (!config || typeof config !== "object" || Array.isArray(config)) {
+    throw new Error(
+      `[@owdproject/core] ${configFile} must default-export a non-array object from defineDesktopConfig({ ... }).`
+    );
+  }
+  const c = config;
+  if (c.theme != null && typeof c.theme !== "string") {
+    throw new Error(
+      `[@owdproject/core] ${configFile}: \`theme\` must be a string (npm package name of the theme module).`
+    );
+  }
+  if (c.apps !== void 0) {
+    if (!Array.isArray(c.apps) || !c.apps.every((item) => typeof item === "string")) {
+      throw new Error(
+        `[@owdproject/core] ${configFile}: \`apps\` must be an array of strings (Nuxt module package names).`
+      );
+    }
+  }
+  if (c.modules !== void 0) {
+    if (!Array.isArray(c.modules) || !c.modules.every((item) => typeof item === "string")) {
+      throw new Error(
+        `[@owdproject/core] ${configFile}: \`modules\` must be an array of strings (Nuxt module package names).`
+      );
+    }
+  }
+}
+
+const DESKTOP_CONFIG_FILENAME = "desktop.config.ts";
+const LEGACY_DESKTOP_CONFIG_FILENAME = "owd.config.ts";
+const LEGACY_CONFIG_DEPRECATION = "[@owdproject/core] owd.config.ts is deprecated and kept only for backward compatibility; rename to desktop.config.ts (required from @owdproject/core 3.2).";
+function resolveDesktopConfigPath(rootDir) {
+  const desktopPath = join(rootDir, DESKTOP_CONFIG_FILENAME);
+  const legacyPath = join(rootDir, LEGACY_DESKTOP_CONFIG_FILENAME);
+  const hasDesktop = existsSync(desktopPath);
+  const hasLegacy = existsSync(legacyPath);
+  if (hasDesktop && hasLegacy) {
+    console.warn(
+      "[@owdproject/core] Both desktop.config.ts and owd.config.ts exist; using desktop.config.ts. Remove owd.config.ts."
+    );
+    return { path: desktopPath, file: DESKTOP_CONFIG_FILENAME, legacy: false };
+  }
+  if (hasDesktop) {
+    return { path: desktopPath, file: DESKTOP_CONFIG_FILENAME, legacy: false };
+  }
+  if (hasLegacy) {
+    return {
+      path: legacyPath,
+      file: LEGACY_DESKTOP_CONFIG_FILENAME,
+      legacy: true
+    };
+  }
+  return null;
+}
+function warnLegacyDesktopConfig(resolved) {
+  if (resolved?.legacy) {
+    console.warn(LEGACY_CONFIG_DEPRECATION);
+  }
+}
+
+const version = "3.2.0";
+const pkg = {
+	version: version};
+
+const module$1 = defineNuxtModule({
+  meta: {
+    name: "desktop",
+    configKey: "owd"
+  },
+  defaults: {
+    theme: "@owdproject/theme-nova",
+    apps: [],
+    modules: []
+  },
+  async setup(_options, _nuxt) {
+    const { resolve } = createResolver(import.meta.url);
+    _nuxt.options.experimental = {
+      ..._nuxt.options.experimental,
+      viteEnvironmentApi: _nuxt.options.experimental?.viteEnvironmentApi ?? true
+    };
+    _nuxt.options.runtimeConfig.public.desktop = {};
+    let clientConfig;
+    const resolvedConfig = resolveDesktopConfigPath(_nuxt.options.rootDir);
+    if (!resolvedConfig) {
+      const hint = "Create desktop.config.ts next to your Nuxt root (e.g. desktop/desktop.config.ts), export default defineDesktopConfig({ theme, apps, modules }).";
+      throw new Error(`[@owdproject/core] Cannot find desktop.config.ts in ${_nuxt.options.rootDir}. ${hint}`);
+    }
+    warnLegacyDesktopConfig(resolvedConfig);
+    try {
+      clientConfig = (await import(resolvedConfig.path)).default;
+    } catch (e) {
+      const hint = "Export default defineDesktopConfig({ theme, apps, modules }) from desktop.config.ts.";
+      throw new Error(
+        `[@owdproject/core] Cannot load ${resolvedConfig.file}. ${hint}`,
+        { cause: e }
+      );
+    }
+    assertValidOwdUserConfig(clientConfig, resolvedConfig.file);
+    if (!clientConfig.theme) {
+      clientConfig.theme = "@owdproject/theme-nova";
+    }
+    _nuxt.options = {
+      ..._nuxt.options,
+      ...clientConfig
+    };
+    _nuxt.options.runtimeConfig.public.desktop = {
+      coreVersion: pkg.version
+    };
+    _nuxt.options.runtimeConfig.public.desktop = deepMerge(
+      _nuxt.options.runtimeConfig.public.desktop,
+      clientConfig
+    );
+    {
+      if (clientConfig.theme) {
+        await installModule(clientConfig.theme);
+      }
+      if (clientConfig.modules && Array.isArray(clientConfig.modules)) {
+        for (const modulePath of clientConfig.modules) {
+          await installModule(modulePath);
+        }
+      }
+      if (clientConfig.apps && Array.isArray(clientConfig.apps)) {
+        for (const appPath of clientConfig.apps) {
+          await installModule(appPath);
+        }
+      }
+    }
+    _nuxt.options.appConfig.desktop = _nuxt.options.runtimeConfig.public.desktop;
+    {
+      _nuxt.options.primevue = _nuxt.options.primevue || {};
+      _nuxt.options.primevue.options = _nuxt.options.primevue.options || {};
+      _nuxt.options.primevue.options.theme = _nuxt.options.primevue.options.theme || {};
+      await installModule("@primevue/nuxt-module");
+    }
+    {
+      const tailwindPaths = _nuxt.options.runtimeConfig.app.owd?.tailwindPaths || [];
+      tailwindPaths.push("./runtime/components/**/*.{vue,mjs,ts}");
+      _nuxt.options.tailwindcss = _nuxt.options.tailwindcss || {};
+      _nuxt.options.tailwindcss.config = _nuxt.options.tailwindcss.config || {};
+      _nuxt.options.tailwindcss.config.content = tailwindPaths;
+      await installModule("@nuxtjs/tailwindcss", {
+        viewer: false
+      });
+    }
+    {
+      await installModule("@pinia/nuxt");
+    }
+    {
+      await installModule("@nuxt/fonts");
+    }
+    {
+      await installModule("@nuxt/icon", {
+        clientBundle: {
+          scan: true,
+          sizeLimitKb: 256
+        }
+      });
+    }
+    {
+      await installModule("@vueuse/nuxt");
+    }
+    {
+      await installModule("@nuxtjs/i18n");
+    }
+    {
+      _nuxt.hook("vite:extendConfig", (viteConfig) => {
+        viteConfig.css = viteConfig.css || {};
+        viteConfig.css.preprocessorOptions = viteConfig.css.preprocessorOptions || {};
+        viteConfig.css.preprocessorOptions.scss = {
+          api: "modern-compiler"
+        };
+      });
+    }
+    {
+      _nuxt.options.css.push("sanitize.css");
+    }
+    {
+      addComponentsDir({
+        path: resolve("./runtime/components"),
+        prefix: "",
+        global: true
+      });
+    }
+    {
+      addPlugin(resolve("./runtime/plugins/resize.client.ts"));
+      addPlugin(resolve("./runtime/plugins/01.owd-dialogs-fallback.ts"));
+      addImportsDir(resolve("./runtime/composables"));
+      addImportsDir(resolve("./runtime/core"));
+      addImportsDir(resolve("./runtime/stores"));
+      addImportsDir(resolve("./runtime/utils"));
+    }
+  }
+});
+
+export { module$1 as default };

package/dist/types.d.mts

@@ -0,0 +1,7 @@
+import type { NuxtModule } from '@nuxt/schema'
+
+import type { default as Module } from './module.mjs'
+
+export type ModuleOptions = typeof Module extends NuxtModule<infer O> ? Partial<O> : Record<string, any>
+
+export { default } from './module.mjs'

package/module.ts

@@ -7,43 +7,68 @@ import {
   addPlugin
 } from '@nuxt/kit'
 import { deepMerge } from './runtime/utils/utilCommon'
+import { assertValidOwdUserConfig } from './runtime/utils/validateOwdUserConfig'
+import {
+  resolveDesktopConfigPath,
+  warnLegacyDesktopConfig,
+} from './runtime/utils/resolveDesktopConfigPath'
 import pkg from './package.json'
 
 export default defineNuxtModule({
   meta: {
-    name: 'owd-core',
-    configKey: 'owd'
+    name: 'desktop',
+    configKey: 'owd',
   },
   defaults: {
-    theme: '@owdproject/theme-win95',
+    theme: '@owdproject/theme-nova',
     apps: [],
     modules: [],
   },
   async setup(_options, _nuxt) {
     const { resolve } = createResolver(import.meta.url)
 
+    // Required for Nuxt 4 dev (playgrounds, module graphs): avoids
+    // "Vite Node IPC socket path not configured" when using @nuxt/kit pipelines.
+    _nuxt.options.experimental = {
+      ..._nuxt.options.experimental,
+      viteEnvironmentApi:
+        _nuxt.options.experimental?.viteEnvironmentApi ?? true,
+    }
+
     _nuxt.options.runtimeConfig.public.desktop = {}
 
-    // get open web desktop config
+    // get open web desktop config (desktop.config.ts; owd.config.ts legacy)
 
     let clientConfig
 
-    try {
+    const resolvedConfig = resolveDesktopConfigPath(_nuxt.options.rootDir)
 
-      clientConfig = (
-        await import(_nuxt.options.rootDir + '/owd.config.ts')
-      ).default
+    if (!resolvedConfig) {
+      const hint =
+        'Create desktop.config.ts next to your Nuxt root (e.g. desktop/desktop.config.ts), export default defineDesktopConfig({ theme, apps, modules }).'
+      throw new Error(`[@owdproject/core] Cannot find desktop.config.ts in ${_nuxt.options.rootDir}. ${hint}`)
+    }
+
+    warnLegacyDesktopConfig(resolvedConfig)
 
+    try {
+      clientConfig = (await import(resolvedConfig.path)).default
     } catch (e) {
-      console.error('/desktop/owd.config.ts not found or invalid', e)
-      return
+      const hint =
+        'Export default defineDesktopConfig({ theme, apps, modules }) from desktop.config.ts.'
+      throw new Error(
+        `[@owdproject/core] Cannot load ${resolvedConfig.file}. ${hint}`,
+        { cause: e },
+      )
     }
 
+    assertValidOwdUserConfig(clientConfig, resolvedConfig.file)
+
     if (!clientConfig.theme) {
-      clientConfig.theme = '@owdproject/theme-win95'
+      clientConfig.theme = '@owdproject/theme-nova'
     }
 
-    // extend nuxt.config.ts with owd.config.ts
+    // extend nuxt.config.ts with desktop.config.ts
 
     _nuxt.options = {
       ..._nuxt.options,
@@ -186,6 +211,7 @@ export default defineNuxtModule({
 
     {
       addPlugin(resolve('./runtime/plugins/resize.client.ts'))
+      addPlugin(resolve('./runtime/plugins/01.owd-dialogs-fallback.ts'))
 
       // add other files
 

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "@owdproject/core",
-  "version": "3.1.4",
+  "version": "3.2.0",
+  "description": "Nuxt Desktop module for browser desktop experiences (windows, shell, apps)",
   "keywords": [
-    "web",
-    "desktop",
-    "vue",
     "nuxt",
+    "nuxt-module",
+    "nuxt-desktop",
+    "desktop",
     "web-desktop",
-    "web-os"
+    "vue",
+    "owd",
+    "open-web-desktop"
   ],
   "homepage": "https://github.com/owdproject/client#readme",
   "bugs": {
@@ -24,30 +27,83 @@
   },
   "type": "module",
   "types": "types/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"
+  },
+  "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",
+    "./runtime/*": {
+      "types": "./runtime/*",
+      "development": "./runtime/*",
+      "import": "./runtime/*",
+      "default": "./runtime/*"
+    }
+  },
   "bin": {
+    "desktop": "bin/desktop.js",
     "owd": "bin/owd.js"
   },
   "dependencies": {
-    "@nuxt/fonts": "^0.11.4",
-    "@nuxt/icon": "^1.14.0",
-    "@nuxt/kit": "^3.17.5",
-    "@nuxtjs/i18n": "^9.5.5",
+    "@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.1",
-    "@primeuix/themes": "^1.1.2",
-    "@primevue/forms": "^4.3.5",
-    "@primevue/nuxt-module": "^4.3.5",
-    "@vueuse/components": "^13.4.0",
-    "@vueuse/core": "^13.4.0",
-    "@vueuse/nuxt": "^13.4.0",
+    "@pinia/nuxt": "^0.11.3",
+    "@primeuix/themes": "^2.0.3",
+    "@primevue/forms": "^4.5.5",
+    "@primevue/nuxt-module": "^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.5",
-    "nuxt": "^3.17.5",
-    "pinia": "^3.0.3",
+    "nanoid": "^5.1.11",
+    "nuxt": "^4.4.4",
+    "pinia": "^3.0.4",
     "sanitize.css": "^13.0.0",
-    "sass": "^1.89.2",
-    "shellwords": "^1.0.1",
+    "sass": "^1.99.0",
+    "shellwords": "^1.1.1",
     "vue-resizable": "^2.1.7",
-    "getopts": "^2.3.0"
+    "getopts": "^2.3.0",
+    "neo-blessed": "^0.2.0"
+  },
+  "optionalDependencies": {
+    "html2canvas": "^1.4.1"
+  },
+  "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"
   }
 }

package/runtime/components/Core/Application/CoreApplicationRender.vue

@@ -6,13 +6,15 @@ defineProps<{
 }>()
 
 const applicationManager = useApplicationManager()
+const runningApps = applicationManager.appsRunning
 </script>
 
 <template>
   <CoreApplicationWindowsRender
-    v-for="app of applicationManager.appsRunning.value"
+    v-for="app of runningApps"
     :key="app.id"
     :workspace-filter="workspaceFilter"
     :windows="app.windowsOpened"
+    :window-revision="app.openWindowCount.value"
   />
 </template>

package/runtime/components/Core/Application/CoreApplicationWindowsRender.vue

@@ -1,17 +1,38 @@
 <script setup lang="ts">
-defineProps<{
+import { computed } from 'vue'
+import { useDesktopWorkspaceStore } from '../../../stores/storeDesktopWorkspace'
+
+const props = defineProps<{
   workspaceFilter?: string
-  windows: Map<string, IApplicationController['windows']>
+  windows: Map<string, IWindowController>
+  /** Tracks ApplicationController.openWindowCount so Vue re-renders when the map is replaced. */
+  windowRevision?: number
 }>()
+
+const desktopWorkspaceStore = useDesktopWorkspaceStore()
+
+const windowEntries = computed(() => {
+  void props.windowRevision
+  return Array.from(props.windows.entries())
+})
+
+function matchesWorkspace(window: IWindowController): boolean {
+  const filter = props.workspaceFilter
+  if (!filter) return true
+
+  const ws = window.state.workspace
+  if (!ws) {
+    return filter === desktopWorkspaceStore.active
+  }
+
+  return ws === filter
+}
 </script>
 
 <template>
-  <template v-for="[windowId, window] in windows" :key="windowId">
+  <template v-for="[windowId, window] in windowEntries" :key="windowId">
     <component
-      v-if="
-        !workspaceFilter ||
-        (workspaceFilter && window.state.workspace === workspaceFilter)
-      "
+      v-if="matchesWorkspace(window)"
       :window="window"
       :is="window.config.component"
     />

package/runtime/components/Core/Window/CoreWindow.vue

@@ -2,14 +2,16 @@
 import { ref, provide } from 'vue'
 import { computed } from '@vue/reactivity'
 import { useAppConfig } from 'nuxt/app'
-import { useDesktopManager } from '@owdproject/core/runtime/composables/useDesktopManager'
 import { handleWindowControllerProps } from '@owdproject/core/runtime/utils/utilWindow'
+import { useDesktopWorkspaceStore } from '../../../stores/storeDesktopWorkspace'
 
 const props = defineProps<{
   window?: IWindowController
   content?: WindowContent
 }>()
 
+const desktopWorkspaceStore = useDesktopWorkspaceStore()
+
 const emit = defineEmits([
   'resize:start',
   'resize:move',
@@ -29,7 +31,6 @@ const emit = defineEmits([
 ])
 
 const appConfig = useAppConfig()
-const desktopManager = useDesktopManager() // used in <style v-bind>
 const windowController: IWindowController = handleWindowControllerProps(
   props.window,
 )
@@ -117,6 +118,36 @@ const classes = computed(() => {
 
   return list
 })
+
+/** While workspace overview is open, disable vue-resizable chrome drag and use native HTML5 drag to move windows between desktops. */
+const workspaceChromeDragSelector = computed(() => {
+  if (desktopWorkspaceStore.overview) {
+    return '.owd-window-overview-drag-none'
+  }
+  return windowController?.isDraggable
+    ? '.owd-window-nav__draggable'
+    : '.owd-window-nav__draggable-none'
+})
+
+function onOverviewNativeDragStart(e: DragEvent) {
+  if (!desktopWorkspaceStore.overview || !windowController) return
+  e.stopPropagation()
+  e.dataTransfer?.setData('text/plain', windowController.state.id)
+  e.dataTransfer!.effectAllowed = 'move'
+  try {
+    const img = new Image()
+    img.src =
+      'data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7'
+    e.dataTransfer?.setDragImage(img, 0, 0)
+  } catch {
+    /* noop */
+  }
+}
+
+/** `fit-parent` clamps drag/resize to the parent box — wrong for viewport-fixed shells (Win11, GNOME). */
+const shouldFitParent = computed(
+  () => appConfig.desktop.windows.position !== 'fixed',
+)
 </script>
 
 <template>
@@ -132,7 +163,7 @@ const classes = computed(() => {
     :left="windowController?.position?.x"
     :top="windowController?.position?.y"
     :active="windowController?.isResizable ? undefined : []"
-    fit-parent
+    :fit-parent="shouldFitParent"
     @drag:start="onWindowDragStart"
     @drag:move="onWindowDragMove"
     @drag:end="onWindowDragEnd"
@@ -140,18 +171,21 @@ const classes = computed(() => {
     @resize:move="onWindowResizeMove"
     @resize:end="onWindowResizeEnd"
     :style="{ zIndex: windowController?.position?.z }"
-    :drag-selector="
-      windowController?.isDraggable
-        ? '.owd-window-nav__draggable'
-        : '.owd-window-nav__draggable-none'
-    "
+    :drag-selector="workspaceChromeDragSelector"
+    :draggable="desktopWorkspaceStore.overview"
     @pointerdown="onWindowPointerDown"
+    @dragstart="onOverviewNativeDragStart"
   >
     <slot />
   </vue-resizable>
 </template>
 
 <style scoped lang="scss">
+/* vue-resizable sets `.resizable-component { position: relative }` — override so desktop geometry stays consistent */
+.owd-window.resizable-component {
+  position: v-bind('appConfig.desktop.windows.position') !important;
+}
+
 .owd-window {
   position: v-bind('appConfig.desktop.windows.position');
 

package/runtime/components/Core/Window/CoreWindowNav.vue

@@ -14,10 +14,7 @@ const classes = computed(() => {
     list.push('owd-window-nav--active')
   }
 
-  if (
-    typeof windowController?.state.focused === 'undefined' ||
-    !!windowController?.state.focused
-  ) {
+  if (windowController?.state.focused) {
     list.push('owd-window-nav--focused')
   }
 
@@ -34,15 +31,36 @@ const classes = computed(() => {
 </template>
 
 <style lang="scss">
+/**
+ * Title/icon sit above the drag layer in DOM order; use pointer-events so
+ * mousedown reaches `.owd-window-nav__draggable` for vue-resizable. Window
+ * controls stay clickable.
+ */
 .owd-window-nav {
   position: relative;
+  display: flex;
+  align-items: stretch;
+  width: 100%;
+  min-height: 0;
 
   &__draggable {
     position: absolute;
-    top: 0;
-    left: 0;
-    right: 0;
-    height: 100%;
+    inset: 0;
+    z-index: 1;
+  }
+
+  > :not(.owd-window-nav__draggable) {
+    position: relative;
+    z-index: 2;
+    pointer-events: none;
+  }
+
+  > .owd-window-nav__btn-group {
+    pointer-events: auto;
+  }
+
+  > .owd-window-nav__interactive {
+    pointer-events: auto;
   }
 }
 </style>