@owdproject/core 3.3.0 → 3.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owdproject/core",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "description": "Nuxt Desktop module for browser desktop experiences (windows, shell, apps)",
   "keywords": [
     "nuxt",
@@ -12,13 +12,13 @@
     "owd",
     "open-web-desktop"
   ],
-  "homepage": "https://github.com/owdproject/client#readme",
+  "homepage": "https://github.com/owdproject/core#readme",
   "bugs": {
-    "url": "https://github.com/owdproject/client/issues"
+    "url": "https://github.com/owdproject/core/issues"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/owdproject/client.git"
+    "url": "git+https://github.com/owdproject/core.git"
   },
   "license": "MIT",
   "author": {
@@ -28,23 +28,20 @@
   "type": "module",
   "types": "types/index.d.ts",
   "files": [
-    "bin",
     "dist",
+    "kit",
     "runtime",
     "types",
     "index.ts",
     "module.ts",
     "package.json",
-    "README.md"
+    "README.md",
+    "DESKTOP_KERNEL.md",
+    "CHANGELOG.md",
+    "MIGRATION_3.3.2.md",
+    "MIGRATION_3.4.md",
+    "PLAYGROUND.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"
-  },
   "exports": {
     ".": {
       "types": "./types/index.d.ts",
@@ -63,50 +60,83 @@
       "default": "./module.ts"
     },
     "./package.json": "./package.json",
-    "./runtime/*": {
-      "types": "./runtime/*",
-      "development": "./runtime/*",
-      "import": "./runtime/*",
-      "default": "./runtime/*"
+    "./kit/*": {
+      "types": "./types/index.d.ts",
+      "development": "./kit/*",
+      "import": "./kit/*",
+      "default": "./kit/*"
+    },
+    "./runtime/composables/*": {
+      "types": "./runtime/composables/*",
+      "development": "./runtime/composables/*",
+      "import": "./runtime/composables/*",
+      "default": "./runtime/composables/*"
+    },
+    "./runtime/constants/*": {
+      "types": "./runtime/constants/*",
+      "development": "./runtime/constants/*",
+      "import": "./runtime/constants/*",
+      "default": "./runtime/constants/*"
+    },
+    "./runtime/dialogs/*": {
+      "types": "./runtime/dialogs/*",
+      "development": "./runtime/dialogs/*",
+      "import": "./runtime/dialogs/*",
+      "default": "./runtime/dialogs/*"
+    },
+    "./runtime/utils/*": {
+      "types": "./runtime/utils/*",
+      "development": "./runtime/utils/*",
+      "import": "./runtime/utils/*",
+      "default": "./runtime/utils/*"
+    },
+    "./runtime/stores/*": {
+      "types": "./runtime/stores/*",
+      "development": "./runtime/stores/*",
+      "import": "./runtime/stores/*",
+      "default": "./runtime/stores/*"
+    },
+    "./runtime/components/*": {
+      "types": "./runtime/components/*",
+      "development": "./runtime/components/*",
+      "import": "./runtime/components/*",
+      "default": "./runtime/components/*"
+    },
+    "./runtime/types/*": {
+      "types": "./runtime/types/*",
+      "development": "./runtime/types/*",
+      "import": "./runtime/types/*",
+      "default": "./runtime/types/*"
     }
   },
-  "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",
     "@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",
-    "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"
+    "vue-resizable": "^2.1.7"
   },
   "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"
+    "typescript": "~6.0.3"
+  },
+  "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"
   }
-}
+}

package/runtime/components/{Desktop/Application/DesktopApplicationRender.vue → Application/DesktopCoreApplicationRender.vue}

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { useApplicationManager } from '../../../composables/useApplicationManager'
+import { useApplicationManager } from '../../composables/useApplicationManager'
 
 defineProps<{
   workspaceFilter?: string
@@ -10,7 +10,7 @@ const runningApps = applicationManager.appsRunning
 </script>
 
 <template>
-  <DesktopApplicationWindowsRender
+  <DesktopCoreApplicationWindowsRender
     v-for="app of runningApps"
     :key="app.id"
     :workspace-filter="workspaceFilter"

package/runtime/components/{Desktop/Application/DesktopApplicationWindowsRender.vue → Application/DesktopCoreApplicationWindowsRender.vue}

@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import { computed } from 'vue'
-import { useDesktopWorkspaceStore } from '../../../stores/storeDesktopWorkspace'
+import { useDesktopWorkspaceStore } from '../../stores/storeDesktopWorkspace'
 
 const props = defineProps<{
   workspaceFilter?: string

package/runtime/components/core/DesktopCore.vue

@@ -0,0 +1,43 @@
+<script setup lang="ts">
+import { useAttrs, computed } from 'vue'
+import { useAppConfig } from 'nuxt/app'
+
+defineOptions({ inheritAttrs: false })
+
+defineProps<{
+  windows?: DesktopWindowsConfig
+  systemBar?: DesktopSystemBarConfig
+  dockBar?: DesktopDockBarConfig
+  workspaces?: DesktopWorkspacesConfig
+}>()
+
+const appConfig = useAppConfig()
+const attrs = useAttrs()
+
+const classes = computed(() => {
+  const list = ['owd-desktop']
+
+  if (appConfig.desktop?.name) {
+    list.push(`owd-desktop--${appConfig.desktop.name}`)
+  }
+
+  return list
+})
+
+const rootClass = computed(() => [classes.value, attrs.class])
+const rootStyle = computed(() => attrs.style)
+</script>
+
+<template>
+  <div :class="rootClass" :style="rootStyle">
+    <slot />
+  </div>
+</template>
+
+<style scoped lang="scss">
+.owd-desktop {
+  width: 100vw;
+  height: 100dvh;
+  user-select: none;
+}
+</style>

package/runtime/components/{Desktop/Window/DesktopWindow.vue → window/DesktopCoreWindow.vue}

@@ -1,9 +1,9 @@
 <script setup lang="ts">
-import { ref, provide } from 'vue'
+import { ref, provide, onMounted } from 'vue'
 import { computed } from '@vue/reactivity'
 import { useAppConfig } from 'nuxt/app'
-import { handleWindowControllerProps } from '@owdproject/core/runtime/utils/utilWindow'
-import { useDesktopWorkspaceStore } from '../../../stores/storeDesktopWorkspace'
+import { handleWindowControllerProps } from '../../utils/utilWindowControllerAdapter'
+import { useDesktopWorkspaceStore } from '../../stores/storeDesktopWorkspace'
 
 const props = defineProps<{
   window?: IWindowController
@@ -41,6 +41,12 @@ provide<WindowContent>('windowContent', props.content ?? {})
 const isDragging = ref(false)
 const isResizing = ref(false)
 
+onMounted(() => {
+  if (windowController?.state?.focused) {
+    windowController.actions.bringToFront()
+  }
+})
+
 function onWindowPointerDown() {
   windowController?.actions?.setActive(true)
   windowController?.actions?.bringToFront()
@@ -144,9 +150,13 @@ function onOverviewNativeDragStart(e: DragEvent) {
   }
 }
 
+const windowPositionMode = computed(
+  () => appConfig.desktop?.windows?.position ?? 'fixed',
+)
+
 /** `fit-parent` clamps drag/resize to the parent box — wrong for viewport-fixed shells (Win11, GNOME). */
 const shouldFitParent = computed(
-  () => appConfig.desktop.windows.position !== 'fixed',
+  () => windowPositionMode.value !== 'fixed',
 )
 </script>
 
@@ -183,11 +193,11 @@ const shouldFitParent = computed(
 <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;
+  position: v-bind('windowPositionMode') !important;
 }
 
 .owd-window {
-  position: v-bind('appConfig.desktop.windows.position');
+  position: v-bind('windowPositionMode');
 
   &--dragging,
   &--resizing {
@@ -199,6 +209,7 @@ const shouldFitParent = computed(
   :deep(.owd-window__content) {
     overflow-y: auto;
     height: 100%;
+    min-height: 0;
   }
 }
 </style>

package/runtime/components/window/DesktopCoreWindowSnapHintsBase.vue

@@ -0,0 +1,74 @@
+<script setup lang="ts">
+import { computed } from 'vue'
+import { useDesktopWorkspaceStore } from '@owdproject/core/runtime/stores/storeDesktopWorkspace'
+import { useWindowSnapDrop } from '@owdproject/core/runtime/composables/useWindowSnapDrop'
+
+const props = defineProps<{
+  enabled?: boolean
+}>()
+
+const desktopWorkspaceStore = useDesktopWorkspaceStore()
+const { snapHint, snapHintRect, isSnapDragActive } = useWindowSnapDrop()
+
+const visible = computed(
+  () =>
+    props.enabled !== false &&
+    !desktopWorkspaceStore.overview &&
+    isSnapDragActive.value &&
+    snapHint.value !== null &&
+    snapHintRect.value !== null,
+)
+
+const hintStyle = computed(() => {
+  const rect = snapHintRect.value
+  if (!rect) return undefined
+
+  return {
+    left: `${rect.x}px`,
+    top: `${rect.y}px`,
+    width: `${rect.width}px`,
+    height: `${rect.height}px`,
+  }
+})
+</script>
+
+<template>
+  <div
+    v-if="visible"
+    class="owd-window-snap-hints"
+    aria-hidden="true"
+  >
+    <div
+      class="owd-window-snap-hints__zone"
+      :class="`owd-window-snap-hints__zone--${snapHint}`"
+      :style="hintStyle"
+    >
+      <slot
+        :zone="snapHint"
+        :rect="snapHintRect"
+      />
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.owd-window-snap-hints {
+  position: fixed;
+  inset: 0;
+  pointer-events: none;
+  z-index: 999998;
+}
+
+.owd-window-snap-hints__zone {
+  position: fixed;
+  box-sizing: border-box;
+  border: 2px solid rgba(96, 165, 250, 0.85);
+  background: rgba(96, 165, 250, 0.18);
+  border-radius: 4px;
+  transition:
+    left 80ms ease,
+    top 80ms ease,
+    width 80ms ease,
+    height 80ms ease;
+}
+</style>

package/runtime/components/workspace/DesktopCoreWorkspaceEdgeHintsBase.vue

@@ -0,0 +1,84 @@
+<script setup lang="ts">
+import { computed } from 'vue'
+import { useWorkspaceEdgeDrop } from '@owdproject/core/runtime/composables/useWorkspaceEdgeDrop'
+import { useDesktopWorkspaceStore } from '@owdproject/core/runtime/stores/storeDesktopWorkspace'
+
+const props = defineProps<{
+  enabled?: boolean
+}>()
+
+const desktopWorkspaceStore = useDesktopWorkspaceStore()
+const { edgeHint, edgeTargetDesktopIndex } = useWorkspaceEdgeDrop()
+
+const visible = computed(
+  () =>
+    props.enabled !== false &&
+    !desktopWorkspaceStore.overview &&
+    desktopWorkspaceStore.list.length > 1 &&
+    edgeHint.value !== null &&
+    edgeTargetDesktopIndex.value !== null,
+)
+</script>
+
+<template>
+  <div
+    v-if="visible"
+    class="owd-workspace-edge-hints"
+    aria-hidden="true"
+  >
+    <div
+      class="owd-workspace-edge-hints__zone owd-workspace-edge-hints__zone--left"
+      :class="{
+        'owd-workspace-edge-hints__zone--active': edgeHint === 'left',
+      }"
+    >
+      <slot
+        name="left"
+        :desktop-index="edgeTargetDesktopIndex"
+        :side="'left' as const"
+      />
+    </div>
+    <div
+      class="owd-workspace-edge-hints__zone owd-workspace-edge-hints__zone--right"
+      :class="{
+        'owd-workspace-edge-hints__zone--active': edgeHint === 'right',
+      }"
+    >
+      <slot
+        name="right"
+        :desktop-index="edgeTargetDesktopIndex"
+        :side="'right' as const"
+      />
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.owd-workspace-edge-hints {
+  position: fixed;
+  inset: 0;
+  pointer-events: none;
+  z-index: 999998;
+}
+
+.owd-workspace-edge-hints__zone {
+  position: fixed;
+  top: 0;
+  bottom: 0;
+  width: 72px;
+  opacity: 0;
+  transition: opacity 120ms ease;
+}
+
+.owd-workspace-edge-hints__zone--left {
+  left: 0;
+}
+
+.owd-workspace-edge-hints__zone--right {
+  right: 0;
+}
+
+.owd-workspace-edge-hints__zone--active {
+  opacity: 1;
+}
+</style>

package/runtime/composables/useBlockNonInputContextMenu.ts

@@ -0,0 +1,30 @@
+import { useEventListener } from '@vueuse/core'
+import { isDebugMode } from '../utils/utilDebug'
+
+/**
+ * Blocks the browser context menu on non-input elements (typical desktop shell behaviour).
+ * Debug builds skip blocking so DevTools stay usable when {@link isDebugMode} is true.
+ */
+export function useBlockNonInputContextMenu() {
+  useEventListener(
+    document,
+    'contextmenu',
+    (event: MouseEvent) => {
+      if (isDebugMode()) return
+
+      const target = event.target as HTMLElement | null
+      if (!target) return
+
+      const tag = target.tagName?.toLowerCase()
+      const isInput =
+        tag === 'input' ||
+        tag === 'textarea' ||
+        Boolean(target.isContentEditable)
+
+      if (!isInput) {
+        event.preventDefault()
+      }
+    },
+    { passive: false },
+  )
+}

package/runtime/composables/useDesktopConfig.ts

@@ -0,0 +1,8 @@
+import { useRuntimeConfig } from 'nuxt/app'
+import { computed } from 'vue'
+
+/** Reactive view of `runtimeConfig.public.desktop` (full desktop.config merge + coreVersion). */
+export function useDesktopConfig() {
+  const runtimeConfig = useRuntimeConfig()
+  return computed(() => runtimeConfig.public.desktop)
+}

package/runtime/composables/useDesktopDialogs.ts

@@ -0,0 +1,16 @@
+import { inject } from 'vue'
+import { DESKTOP_DIALOG_PROVIDER_KEY } from '../constants/desktopShellKeys'
+import {
+  createBrowserFallbackDialogProvider,
+  type DesktopDialogProvider,
+} from '../dialogs/desktopDialogProvider'
+
+/**
+ * Returns the active desktop dialog provider (theme) or a browser fallback.
+ */
+export function useDesktopDialogs(): DesktopDialogProvider {
+  return (
+    inject(DESKTOP_DIALOG_PROVIDER_KEY, null) ??
+    createBrowserFallbackDialogProvider()
+  )
+}

package/runtime/composables/useDesktopExtension.ts

@@ -0,0 +1,8 @@
+import { computed } from 'vue'
+import { useDesktopConfig } from './useDesktopConfig'
+
+/** Readonly slice for an extension namespace (`fs`, `terminal`, or custom `configKey`). */
+export function useDesktopExtension<K extends string>(key: K) {
+  const desktop = useDesktopConfig()
+  return computed(() => desktop.value?.[key as keyof typeof desktop.value])
+}

package/runtime/composables/useDesktopManager.ts

@@ -17,6 +17,8 @@ export function useDesktopManager() {
    * Merges and sets the desktop config at runtime (shell geometry, feature flags, etc.).
    */
   function setConfig(newConfig: DesktopConfig) {
+    if (!appConfig) return
+
     appConfig.desktop = defu(
       newConfig,
       (appConfig.desktop ?? {}) as DesktopConfig,

package/runtime/composables/useDesktopManifest.ts

@@ -0,0 +1,17 @@
+import { computed } from 'vue'
+import { useDesktopConfig } from './useDesktopConfig'
+
+export function hasDesktopModule(pkg: string) {
+  const desktop = useDesktopConfig()
+  return computed(() => desktop.value?.modules?.includes(pkg) ?? false)
+}
+
+export function hasDesktopApp(pkg: string) {
+  const desktop = useDesktopConfig()
+  return computed(() => desktop.value?.apps?.includes(pkg) ?? false)
+}
+
+export function hasDesktopExtension(key: string) {
+  const desktop = useDesktopConfig()
+  return computed(() => Boolean(desktop.value?.[key as keyof typeof desktop.value]))
+}

package/runtime/composables/useDesktopSession.ts

@@ -0,0 +1,27 @@
+import { useRouter } from 'nuxt/app'
+import { ref } from 'vue'
+
+/**
+ * Neutral API for “leave the desktop shell” flows (shutdown animation → start route).
+ * Themes keep their own `/start` / `/boot` pages and styling.
+ */
+const shuttingDown = ref(false)
+
+export function useDesktopSession() {
+  const initiateShutdownToStart = () => {
+    shuttingDown.value = true
+
+    setTimeout(() => {
+      useRouter()
+        .push('/start')
+        .then(() => {
+          shuttingDown.value = false
+        })
+    }, 2000)
+  }
+
+  return {
+    shuttingDown,
+    initiateShutdownToStart,
+  }
+}

package/runtime/composables/useDesktopShellIdentity.ts

@@ -0,0 +1,99 @@
+import { computed, ref } from 'vue'
+import { useRuntimeConfig } from 'nuxt/app'
+
+export type ShellIdentity = {
+  userId: string
+  displayName: string
+  avatarUrl: string | null
+  userHome: string
+}
+
+const GUEST_USER_ID = 'guest'
+
+const identity = ref<ShellIdentity | null>(null)
+
+export function sanitizeUserHomeSegment(input: string): string {
+  const cleaned = input
+    .trim()
+    .replace(/^@/, '')
+    .replace(/[^\w.\-]/g, '_')
+    .slice(0, 64)
+  return cleaned || 'user'
+}
+
+/** Build a VFS home path from an auth handle (e.g. Bluesky `@alice.bsky.social`). */
+export function userHomeFromHandle(handle: string, base = '/home'): string {
+  const baseNorm = base.endsWith('/') ? base.slice(0, -1) : base
+  return `${baseNorm}/${sanitizeUserHomeSegment(handle)}`
+}
+
+function resolveDefaultHome(): string {
+  try {
+    const config = useRuntimeConfig()
+    const desktop = config.public.desktop as {
+      fs?: { defaultUserHome?: string }
+    }
+    const home = desktop.fs?.defaultUserHome?.trim()
+    if (home) return home.startsWith('/') ? home : `/${home}`
+  } catch {
+    /* outside Nuxt setup */
+  }
+  return '/home/Guest'
+}
+
+function guestIdentity(defaultHome: string): ShellIdentity {
+  return {
+    userId: GUEST_USER_ID,
+    displayName: 'Guest',
+    avatarUrl: null,
+    userHome: defaultHome,
+  }
+}
+
+/**
+ * Shell session identity (display + VFS home). Auth modules call {@link setShellIdentity}
+ * after login; defaults to Guest.
+ */
+export function useDesktopShellIdentity() {
+  function ensureIdentity(): ShellIdentity {
+    if (!identity.value) {
+      identity.value = guestIdentity(resolveDefaultHome())
+    }
+    return identity.value
+  }
+
+  const userId = computed(() => ensureIdentity().userId)
+  const displayName = computed(() => ensureIdentity().displayName)
+  const avatarUrl = computed(() => ensureIdentity().avatarUrl)
+  const userHome = computed(() => ensureIdentity().userHome)
+  const isGuest = computed(() => userId.value === GUEST_USER_ID)
+
+  function setShellIdentity(partial: Partial<ShellIdentity>) {
+    const current = ensureIdentity()
+    identity.value = {
+      ...current,
+      ...partial,
+      userId: partial.userId?.trim() || current.userId,
+      displayName: partial.displayName?.trim() || current.displayName,
+      userHome: partial.userHome?.trim()
+        ? partial.userHome.startsWith('/')
+          ? partial.userHome
+          : `/${partial.userHome}`
+        : current.userHome,
+    }
+  }
+
+  function clearShellIdentity() {
+    identity.value = guestIdentity(resolveDefaultHome())
+  }
+
+  return {
+    userId,
+    displayName,
+    avatarUrl,
+    userHome,
+    isGuest,
+    setShellIdentity,
+    clearShellIdentity,
+  }
+}