feat(playground): Add playgorund and update to core 3.2.0

Author: dxlliv

.github/workflows/pages.yml

@@ -0,0 +1,55 @@
+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
+
+      - name: Install dependencies
+        run: npx nypm@latest i
+
+      - name: Prepare module and playground
+        run: npm run dev:prepare
+
+      - name: Generate static playground
+        run: npm run dev:generate
+        env:
+          NUXT_APP_BASE_URL: /module-persistence/
+
+      - name: Upload Pages artifact
+        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:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

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

README.md

@@ -3,23 +3,22 @@
 </p>
 <h1 align="center">Persistence Module</h1>
 <h3 align="center">
-  Pinia with LocalForage for Open Web Desktop.
+  Pinia persistence for Open Web Desktop (IndexedDB via idb-keyval).
 </h3>
 
 ## Overview
 
-This module enables [localForage](https://www.npmjs.com/package/localforage) within Pinia to store application states persistently.
+This module registers [`pinia-plugin-persistedstate-2`](https://github.com/wobsoriano/pinia-plugin-persistedstate-2) with storage backed by [`idb-keyval`](https://github.com/jakearchibald/idb-keyval) (small ESM library on IndexedDB). It avoids legacy UMD packages such as `localforage`, which break under Vite’s native ESM handling (`does not provide an export named 'default'`).
 
 ## Features
 
-- Configures `pinia-plugin-persistedstate-2` to use `localforage`
-- Enables persistent storage for Pinia stores
-- Works seamlessly with Nuxt
+- Async `getItem` / `setItem` / `removeItem` compatible with the persisted-state plugin
+- Client-only Nuxt plugin (same pattern as before)
 
 ## Installation
 
 ```bash
-owd install-module @owdproject/module-pinia-localforage
+pnpm desktop add @owdproject/module-persistence
 ```
 
 ## License

package.json

@@ -1,33 +1,51 @@
 {
   "name": "@owdproject/module-persistence",
   "version": "0.0.1",
-  "description": "Enables localforage within Pinia to store states persistently",
+  "description": "Pinia persistence via IndexedDB (idb-keyval), ESM-friendly",
   "license": "MIT",
   "homepage": "https://github.com/owdproject/module-persistence",
   "author": {
     "name": "Open Web Desktop Team",
     "url": "https://github.com/owdproject"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/owdproject/module-persistence"
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/types.d.mts",
+      "import": "./dist/module.mjs"
+    }
   },
-  "bugs": {
-    "url": "https://github.com/owdproject/module-persistence/issues"
+  "main": "./dist/module.mjs",
+  "typesVersions": {
+    "*": {
+      ".": ["./dist/types.d.mts"]
+    }
+  },
+  "files": ["dist"],
+  "nx": { "name": "module-persistence" },
+  "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:-/module-persistence/} nuxt generate playground",
+    "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && cd playground && pnpm exec nuxt prepare",
+    "validate": "desktop validate ."
   },
-  "keywords": [
-    "owdproject",
-    "owd-client",
-    "pinia",
-    "nuxt",
-    "persist",
-    "state"
-  ],
   "dependencies": {
-    "localforage": "^1.10.0",
+    "@nuxt/kit": "^4.3.0",
+    "idb-keyval": "^6.2.2",
     "pinia-plugin-persistedstate-2": "^2.0.30"
   },
+  "devDependencies": {
+    "@nuxt/module-builder": "^1.0.2",
+    "@owdproject/app-todo": "workspace:*",
+    "@owdproject/core": "workspace:*",
+    "@owdproject/theme-nova": "workspace:*",
+    "nuxt": "^4.3.0",
+    "typescript": "~5.9.3"
+  },
   "peerDependencies": {
-    "@owdproject/core": "^3.1.0"
+    "@owdproject/core": "^3.2.0",
+    "pinia": "^3.0.0"
   }
 }

playground/app/app.vue

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

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

@@ -0,0 +1,41 @@
+import { nextTick } from 'vue'
+import { defineNuxtPlugin } from 'nuxt/app'
+import { useApplicationManager } from '@owdproject/core/runtime/composables/useApplicationManager'
+
+const APP_ID = 'org.owdproject.todo'
+const WINDOW_MODEL = 'main'
+
+export default defineNuxtPlugin({
+  name: 'module-persistence-playground-launch',
+  dependsOn: ['owd-app-todo-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, 'todo')
+      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 i = 0; i < 80; i++) {
+        if (await surfaceWindow()) return
+        await new Promise((resolve) => setTimeout(resolve, 50))
+      }
+    })
+  },
+})

playground/desktop.config.ts

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

playground/nuxt.config.ts

@@ -0,0 +1,12 @@
+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,17 @@
+{
+  "name": "@owdproject/module-persistence-playground",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "nuxt dev",
+    "build": "nuxt build",
+    "generate": "nuxt generate"
+  },
+  "dependencies": {
+    "@owdproject/app-todo": "workspace:*",
+    "@owdproject/core": "workspace:*",
+    "@owdproject/module-persistence": "workspace:*",
+    "@owdproject/theme-nova": "workspace:*",
+    "nuxt": "^4.4.4"
+  }
+}

playground/tsconfig.json

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