refactor: restructure module to src directory, update dependencies, and setup playground

Author: dxlliv

.github/workflows/pages.yml

@@ -0,0 +1,37 @@
+name: Deploy playground to GitHub Pages
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+concurrency:
+  group: pages
+  cancel-in-progress: true
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 22
+      - run: npm i -g --force corepack@latest && corepack enable
+      - run: npx nypm@latest i
+      - run: npm run dev:prepare
+      - run: npm run dev:generate
+        env:
+          NUXT_APP_BASE_URL: /app-debug/
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: playground/.output/public
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/deploy-pages@v4

.gitignore

@@ -1 +1,7 @@
 node_modules
+.nuxt
+dist
+.output
+playground/.nuxt
+playground/node_modules
+._*

README.md

@@ -15,7 +15,7 @@ This app for Open Web Desktop is a test module with window states information.
 ## Installation
 
 ```bash
-owd install-app @owdproject/app-debug
+pnpm desktop add @owdproject/app-debug
 ```
 
 ## License

package.json

@@ -13,7 +13,51 @@
     "name": "Open Web Desktop Team",
     "url": "https://github.com/owdproject"
   },
-  "peerDependencies": {
-    "@owdproject/core": "^3.1.0"
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/types.d.mts",
+      "development": "./src/module.ts",
+      "import": "./dist/module.mjs"
+    }
+  },
+  "main": "./dist/module.mjs",
+  "typesVersions": {
+    "*": {
+      ".": [
+        "./dist/types.d.mts"
+      ]
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "nx": {
+    "name": "app-debug"
+  },
+  "scripts": {
+    "prepack": "nuxt-module-build build",
+    "dev": "pnpm run dev:prepare && cd playground && pnpm exec nuxt dev",
+    "dev:build": "nuxt build playground",
+    "dev:generate": "NUXT_APP_BASE_URL=${NUXT_APP_BASE_URL:-/app-debug/} nuxt generate playground",
+    "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && cd playground && pnpm exec nuxt prepare",
+    "validate": "desktop validate ."
+  },
+  "dependencies": {
+    "@nuxt/kit": "^4.4.6"
+  },
+  "devDependencies": {
+    "@nuxt/devtools": "^3.2.4",
+    "@nuxt/eslint-config": "^1.15.2",
+    "@nuxt/module-builder": "^1.0.2",
+    "@nuxt/schema": "^4.4.6",
+    "@nuxt/test-utils": "^4.0.3",
+    "@types/node": "latest",
+    "changelogen": "^0.6.2",
+    "eslint": "^10.4.0",
+    "nuxt": "^4.4.6",
+    "typescript": "~6.0.3",
+    "vitest": "^4.1.7",
+    "vue-tsc": "^3.3.1"
   }
 }

playground/app/app.vue

@@ -0,0 +1,3 @@
+<template>
+  <Desktop />
+</template>

playground/app/plugins/launch-debug.client.ts

@@ -0,0 +1,42 @@
+import { nextTick } from 'vue'
+import { defineNuxtPlugin } from 'nuxt/app'
+import { useApplicationManager } from '@owdproject/core/runtime/composables/useApplicationManager'
+
+const APP_ID = 'org.owdproject.debug'
+const WINDOW_MODEL = 'main'
+
+export default defineNuxtPlugin({
+  name: 'app-debug-playground-launch',
+  dependsOn: ['owd-app-debug-register'],
+  async setup(nuxtApp) {
+    if (!import.meta.dev) return
+
+    const applicationManager = useApplicationManager()
+
+    async function surfaceWindow() {
+      if (!applicationManager.isAppDefined(APP_ID)) return false
+      const app = applicationManager.getAppById(APP_ID)!
+      if (app.storeWindows.$persistedState) {
+        await app.storeWindows.$persistedState.isReady()
+      }
+      app.closeAllWindows()
+      app.storeWindows.windows = {}
+      await applicationManager.execAppCommand(APP_ID, "debug")
+      const window = app.getFirstWindowByModel(WINDOW_MODEL)
+      if (window) {
+        window.actions.setActive(true)
+        window.actions.bringToFront()
+      }
+      return Boolean(window)
+    }
+
+    nuxtApp.hook('app:mounted', async () => {
+      await nextTick()
+
+      for (let attempt = 0; attempt < 80; attempt++) {
+        if (await surfaceWindow()) return
+        await new Promise((resolve) => setTimeout(resolve, 50))
+      }
+    })
+  },
+})

playground/desktop.config.ts

@@ -0,0 +1,7 @@
+import { defineDesktopConfig } from '@owdproject/core'
+
+export default defineDesktopConfig({
+  theme: '@owdproject/theme-nova',
+  apps: ['@owdproject/app-debug'],
+  systemBar: { enabled: true, startButton: true },
+})

playground/nuxt.config.ts

@@ -0,0 +1,8 @@
+export default defineNuxtConfig({
+  modules: ['@owdproject/core'],
+  app: { baseURL: process.env.NUXT_APP_BASE_URL || '/' },
+  i18n: { strategy: 'no_prefix' },
+  devtools: { enabled: true },
+  compatibilityDate: 'latest',
+  ssr: false,
+})

playground/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@owdproject/app-debug-playground",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "nuxt dev",
+    "build": "nuxt build",
+    "generate": "nuxt generate"
+  },
+  "dependencies": {
+    "@owdproject/app-debug": "latest",
+    "@owdproject/core": "^3.4.0",
+    "@owdproject/theme-nova": "^0.0.2"
+  }
+}

playground/tsconfig.json

@@ -0,0 +1 @@
+{ "extends": "./.nuxt/tsconfig.json" }