@poveste/plugin-nuxt 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2022 Guillaume Chau (original "histoire" project)
+Copyright (c) 2026 Sorin Gitlan (poveste fork)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,18 @@
+# Poveste + Nuxt 3
+
+```bash
+pnpm add -D @poveste/plugin-nuxt
+```
+
+Add the plugin in histoire config:
+
+```js
+import { HstNuxt } from '@poveste/plugin-nuxt'
+import { defineConfig } from 'poveste'
+
+export default defineConfig({
+  plugins: [
+    HstNuxt(),
+  ],
+})
+```

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import type { Plugin } from 'poveste';
+export declare function HstNuxt(): Plugin;

package/dist/index.js

@@ -0,0 +1,171 @@
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import replace from '@rollup/plugin-replace';
+const ignorePlugins = [
+    'nuxt:vite-node-server',
+    'nuxt:dev-style-ssr',
+    'nuxt:vite-relative-asset',
+    'nuxt:cache-dir',
+    'nuxt:dynamic-base-path',
+    'nuxt:import-protection',
+];
+export function HstNuxt() {
+    let nuxt;
+    return {
+        name: '@poveste/plugin-nuxt',
+        async defaultConfig() {
+            const nuxtViteConfig = await useNuxtViteConfig();
+            const { viteConfig } = nuxtViteConfig;
+            nuxt = nuxtViteConfig.nuxt; // We save it to close it later
+            const plugins = viteConfig.plugins.filter((p) => !ignorePlugins.includes(p?.name));
+            return {
+                vite: {
+                    server: {
+                        watch: viteConfig.server.watch,
+                        fs: {
+                            allow: viteConfig.server.fs.allow,
+                        },
+                        middlewareMode: false,
+                    },
+                    define: {
+                        ...viteConfig.define,
+                        'process.server': false,
+                        'process.client': true,
+                        'process.browser': true,
+                        'process.nitro': false,
+                        'process.prerender': false,
+                    },
+                    resolve: {
+                        alias: viteConfig.resolve.alias,
+                        extensions: viteConfig.resolve.extensions,
+                        dedupe: viteConfig.resolve.dedupe,
+                    },
+                    plugins: [
+                        ...plugins,
+                        replace({
+                            values: {
+                                'import.meta.server': 'false',
+                                'import.meta.client': 'true',
+                            },
+                            preventAssignment: true,
+                        }),
+                    ],
+                    css: viteConfig.css,
+                    publicDir: viteConfig.publicDir,
+                    optimizeDeps: {
+                        ...viteConfig.optimizeDeps,
+                        exclude: [
+                            ...viteConfig.optimizeDeps.exclude,
+                            '@poveste/plugin-nuxt',
+                        ],
+                    },
+                    // @ts-expect-error Vue-specific config
+                    vue: viteConfig.vue,
+                    logLevel: 'info',
+                },
+                setupCode: [
+                    `${nuxt.options.css.map(file => `import '${file}'`).join('\n')}`,
+                    `import { setupNuxtApp } from '@poveste/plugin-nuxt/dist/runtime/app-setup.js'
+export async function setupVue3 () {
+  await setupNuxtApp(${JSON.stringify(nuxt.options.runtimeConfig.public)})
+}`,
+                ],
+                viteNodeInlineDeps: [
+                    /\/(nuxt|nuxt3)\//,
+                    /^#/,
+                    /\.nuxt/,
+                    ...nuxt.options.build.transpile.filter(r => typeof r === 'string' || r instanceof RegExp),
+                ],
+                build: {
+                    excludeFromVendorsChunk: [
+                        /nuxt\/dist\/app/,
+                    ],
+                },
+            };
+        },
+        onDev(api, onCleanup) {
+            onCleanup(async () => {
+                nuxt?.close();
+            });
+        },
+        onBuild(api) {
+            api.onBuildEnd(() => {
+                nuxt?.close();
+            });
+        },
+        onPreview() {
+            nuxt?.close();
+        },
+    };
+}
+async function useNuxtViteConfig() {
+    const { loadNuxt, buildNuxt } = await import('@nuxt/kit');
+    const nuxt = await loadNuxt({
+        // cwd: process.cwd(),
+        ready: false,
+        dev: true,
+        overrides: {
+            devtools: { enabled: false },
+            ssr: false,
+            experimental: {
+                appManifest: false,
+            },
+            app: {
+                rootId: 'nuxt-test',
+            },
+            pages: false,
+            typescript: {
+                typeCheck: false,
+            },
+        },
+    });
+    if (nuxt.options.builder !== '@nuxt/vite-builder') {
+        throw new Error(`Poveste only supports Vite bundler, but Nuxt builder is currently set to '${nuxt.options.builder}'.`);
+    }
+    const runtimeDir = fileURLToPath(new URL('../runtime', import.meta.url));
+    nuxt.options.build.templates.push({ src: join(runtimeDir, 'composables.mjs'), filename: 'poveste/composables.mjs' }, { src: join(runtimeDir, 'components.mjs'), filename: 'poveste/components.mjs' });
+    nuxt.hook('app:templates', (app) => {
+        app.templates = app.templates.filter(template => template.filename !== 'app-component.mjs');
+        app.templates.push({ src: join(runtimeDir, 'app-component.mjs'), filename: 'app-component.mjs' });
+    });
+    nuxt.hook('imports:sources', (presets) => {
+        const polyfills = ['requestIdleCallback', 'cancelIdleCallback'];
+        const stubbedComposables = ['useNuxtApp'];
+        for (const appPreset of presets.filter(p => p && typeof p === 'object' && 'from' in p && p.from?.startsWith('#app'))) {
+            if ('imports' in appPreset && Array.isArray(appPreset.imports)) {
+                appPreset.imports = appPreset.imports.filter(i => typeof i !== 'string' || (!stubbedComposables.includes(i) && !polyfills.includes(i)));
+            }
+        }
+        presets.push({
+            from: '#build/poveste/composables.mjs',
+            imports: stubbedComposables,
+        });
+    });
+    return {
+        viteConfig: await new Promise((resolve, reject) => {
+            nuxt.hook('modules:done', () => {
+                nuxt.hook('components:extend', (components) => {
+                    for (const name of ['NuxtLink']) {
+                        Object.assign(components.find(c => c.pascalName === name) || {}, {
+                            export: name,
+                            filePath: '#build/poveste/components.mjs',
+                        });
+                    }
+                });
+                nuxt.hook('vite:configResolved', (config, { isClient }) => {
+                    if (isClient) {
+                        resolve(config);
+                    }
+                });
+            });
+            nuxt.ready()
+                .then(() => buildNuxt(nuxt))
+                .catch((err) => {
+                if (!err.toString().includes('_stop_')) {
+                    reject(err);
+                }
+            });
+        }),
+        nuxt,
+    };
+}

package/dist/runtime/app-setup.d.ts

@@ -0,0 +1,2 @@
+import type { PublicRuntimeConfig } from '@nuxt/schema';
+export declare function setupNuxtApp(publicConfig: PublicRuntimeConfig): Promise<void>;

package/dist/runtime/app-setup.js

@@ -0,0 +1,46 @@
+import { createApp } from 'h3';
+import { createFetch } from 'ofetch';
+export async function setupNuxtApp(publicConfig) {
+    const win = window;
+    win.__NUXT__ = {
+        serverRendered: false,
+        config: {
+            public: { ...publicConfig },
+            app: { baseURL: '/' },
+        },
+        data: {},
+        state: {},
+    };
+    const app = win.document.createElement('div');
+    // this is a workaround for a happy-dom bug with ids beginning with _
+    app.id = 'nuxt-test';
+    win.document.body.appendChild(app);
+    win.IntersectionObserver
+        = win.IntersectionObserver
+            || class IntersectionObserver {
+                observe() {
+                    // noop
+                }
+            };
+    const h3App = createApp();
+    const registry = new Set();
+    if (__HST_COLLECT__) {
+        const { toNodeListener, } = await import('h3');
+        const { createCall, createFetch: createLocalFetch, } = await import('unenv/runtime/fetch/index');
+        // @ts-expect-error TODO: fix in h3
+        const localCall = createCall(toNodeListener(h3App));
+        const localFetch = createLocalFetch(localCall, globalThis.fetch);
+        win.fetch = (init, options) => {
+            if (typeof init === 'string' && registry.has(init)) {
+                init = `/_${init}`;
+            }
+            return localFetch(init, options);
+        };
+    }
+    win.$fetch = createFetch({ fetch: win.fetch, Headers: win.Headers });
+    win.__registry = registry;
+    win.__app = h3App;
+    // @ts-expect-error no types
+    const result = await import('#app/entry');
+    await result.default();
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@poveste/plugin-nuxt",
+  "type": "module",
+  "version": "0.1.0",
+  "description": "Poveste plugin to integrate with Nuxt 3",
+  "author": {
+    "name": "Sorin Gitlan"
+  },
+  "license": "MIT",
+  "repository": {
+    "url": "https://github.com/poveste-dev/poveste.git",
+    "type": "git",
+    "directory": "packages/poveste-plugin-nuxt"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./*": "./*"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "peerDependencies": {
+    "nuxt": "^3.0.0-rc.11",
+    "poveste": "^0.1.0",
+    "@poveste/plugin-vue": "^0.1.0"
+  },
+  "dependencies": {
+    "@nuxt/kit": "^3.14.1592",
+    "@rollup/plugin-replace": "^6.0.1",
+    "h3": "^1.13.0",
+    "ofetch": "^1.4.1",
+    "unenv": "^1.10.0"
+  },
+  "devDependencies": {
+    "@nuxt/schema": "^3.14.1592",
+    "@types/node": "^22.10.1",
+    "typescript": "5.6.3",
+    "vite": "^7.3.0",
+    "poveste": "0.1.0"
+  },
+  "scripts": {
+    "build": "rimraf dist && tsc -d",
+    "watch": "tsc -d -w --sourceMap"
+  }
+}

package/runtime/app-component.mjs

@@ -0,0 +1,3 @@
+export default function render() {
+  return null
+}

package/runtime/components.mjs

@@ -0,0 +1,14 @@
+import { defineComponent, h } from 'vue'
+
+export const NuxtLink = defineComponent({
+  name: 'NuxtLink',
+  props: {
+    to: [String, Object],
+  },
+  setup(props, ctx) {
+    return () => h('a', {
+      href: typeof props.to === 'string' ? props.to : '#',
+      ...ctx.attrs,
+    }, [ctx.slots.default?.()])
+  },
+})

package/runtime/composables.mjs

@@ -0,0 +1 @@
+export const useNuxtApp = () => ({ runWithContext: async fn => await fn() })

package/src/global.d.ts

@@ -0,0 +1,5 @@
+declare global {
+  const __HST_COLLECT__: boolean
+}
+
+export {}

package/src/index.ts

@@ -0,0 +1,191 @@
+import type { Nuxt } from '@nuxt/schema'
+import type { Plugin } from 'poveste'
+import type { UserConfig as ViteConfig } from 'vite'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import replace from '@rollup/plugin-replace'
+
+const ignorePlugins = [
+  'nuxt:vite-node-server',
+  'nuxt:dev-style-ssr',
+  'nuxt:vite-relative-asset',
+  'nuxt:cache-dir',
+  'nuxt:dynamic-base-path',
+  'nuxt:import-protection',
+]
+
+export function HstNuxt(): Plugin {
+  let nuxt: Nuxt
+  return {
+    name: '@poveste/plugin-nuxt',
+
+    async defaultConfig() {
+      const nuxtViteConfig = await useNuxtViteConfig()
+      const { viteConfig } = nuxtViteConfig
+
+      nuxt = nuxtViteConfig.nuxt // We save it to close it later
+      const plugins = viteConfig.plugins.filter((p: any) => !ignorePlugins.includes(p?.name))
+      return {
+        vite: {
+          server: {
+            watch: viteConfig.server.watch,
+            fs: {
+              allow: viteConfig.server.fs.allow,
+            },
+            middlewareMode: false,
+          },
+          define: {
+            ...viteConfig.define,
+            'process.server': false,
+            'process.client': true,
+            'process.browser': true,
+            'process.nitro': false,
+            'process.prerender': false,
+          },
+          resolve: {
+            alias: viteConfig.resolve.alias,
+            extensions: viteConfig.resolve.extensions,
+            dedupe: viteConfig.resolve.dedupe,
+          },
+          plugins: [
+            ...plugins,
+            replace({
+              values: {
+                'import.meta.server': 'false',
+                'import.meta.client': 'true',
+              },
+              preventAssignment: true,
+            }),
+          ],
+          css: viteConfig.css,
+          publicDir: viteConfig.publicDir,
+          optimizeDeps: {
+            ...viteConfig.optimizeDeps,
+            exclude: [
+              ...viteConfig.optimizeDeps.exclude,
+              '@poveste/plugin-nuxt',
+            ],
+          },
+          // @ts-expect-error Vue-specific config
+          vue: viteConfig.vue,
+          logLevel: 'info',
+        },
+        setupCode: [
+          `${nuxt.options.css.map(file => `import '${file}'`).join('\n')}`,
+          `import { setupNuxtApp } from '@poveste/plugin-nuxt/dist/runtime/app-setup.js'
+export async function setupVue3 () {
+  await setupNuxtApp(${JSON.stringify(nuxt.options.runtimeConfig.public)})
+}`,
+        ],
+        viteNodeInlineDeps: [
+          /\/(nuxt|nuxt3)\//,
+          /^#/,
+          /\.nuxt/,
+          ...(nuxt.options.build.transpile.filter(
+            r => typeof r === 'string' || r instanceof RegExp,
+          ) as Array<string | RegExp>),
+        ],
+        build: {
+          excludeFromVendorsChunk: [
+            /nuxt\/dist\/app/,
+          ],
+        },
+      }
+    },
+
+    onDev(api, onCleanup) {
+      onCleanup(async () => {
+        nuxt?.close()
+      })
+    },
+
+    onBuild(api) {
+      api.onBuildEnd(() => {
+        nuxt?.close()
+      })
+    },
+
+    onPreview() {
+      nuxt?.close()
+    },
+  }
+}
+
+async function useNuxtViteConfig() {
+  const { loadNuxt, buildNuxt } = await import('@nuxt/kit')
+  const nuxt = await loadNuxt({
+    // cwd: process.cwd(),
+    ready: false,
+    dev: true,
+    overrides: {
+      devtools: { enabled: false },
+      ssr: false,
+      experimental: {
+        appManifest: false,
+      },
+      app: {
+        rootId: 'nuxt-test',
+      },
+      pages: false,
+      typescript: {
+        typeCheck: false,
+      },
+    },
+  })
+  if (nuxt.options.builder as string !== '@nuxt/vite-builder') {
+    throw new Error(`Poveste only supports Vite bundler, but Nuxt builder is currently set to '${nuxt.options.builder}'.`)
+  }
+  const runtimeDir = fileURLToPath(new URL('../runtime', import.meta.url))
+  nuxt.options.build.templates.push(
+    { src: join(runtimeDir, 'composables.mjs'), filename: 'poveste/composables.mjs' },
+    { src: join(runtimeDir, 'components.mjs'), filename: 'poveste/components.mjs' },
+  )
+
+  nuxt.hook('app:templates', (app) => {
+    app.templates = app.templates.filter(template => template.filename !== 'app-component.mjs')
+    app.templates.push({ src: join(runtimeDir, 'app-component.mjs'), filename: 'app-component.mjs' })
+  })
+
+  nuxt.hook('imports:sources', (presets) => {
+    const polyfills = ['requestIdleCallback', 'cancelIdleCallback']
+    const stubbedComposables = ['useNuxtApp']
+    for (const appPreset of presets.filter(p => p && typeof p === 'object' && 'from' in p && p.from?.startsWith('#app'))) {
+      if ('imports' in appPreset && Array.isArray(appPreset.imports)) {
+        appPreset.imports = appPreset.imports.filter(i => typeof i !== 'string' || (!stubbedComposables.includes(i) && !polyfills.includes(i)))
+      }
+    }
+    presets.push({
+      from: '#build/poveste/composables.mjs',
+      imports: stubbedComposables,
+    })
+  })
+
+  return {
+    viteConfig: await new Promise<ViteConfig>((resolve, reject) => {
+      nuxt.hook('modules:done', () => {
+        nuxt.hook('components:extend', (components) => {
+          for (const name of ['NuxtLink']) {
+            Object.assign(components.find(c => c.pascalName === name) || {}, {
+              export: name,
+              filePath: '#build/poveste/components.mjs',
+            })
+          }
+        })
+
+        nuxt.hook('vite:configResolved', (config, { isClient }) => {
+          if (isClient) {
+            resolve(config as any)
+          }
+        })
+      })
+      nuxt.ready()
+        .then(() => buildNuxt(nuxt))
+        .catch((err) => {
+          if (!err.toString().includes('_stop_')) {
+            reject(err)
+          }
+        })
+    }),
+    nuxt,
+  }
+}

package/src/runtime/app-setup.ts

@@ -0,0 +1,72 @@
+import type { PublicRuntimeConfig } from '@nuxt/schema'
+import type { App } from 'h3'
+import { createApp } from 'h3'
+import { createFetch } from 'ofetch'
+
+export async function setupNuxtApp(publicConfig: PublicRuntimeConfig) {
+  const win = window as unknown as Window & {
+    __app: App
+    __registry: Set<string>
+    __NUXT__: any
+    $fetch: any
+    fetch: any
+    IntersectionObserver: any
+    Headers: any
+  }
+
+  win.__NUXT__ = {
+    serverRendered: false,
+    config: {
+      public: { ...publicConfig },
+      app: { baseURL: '/' },
+    },
+    data: {},
+    state: {},
+  }
+
+  const app = win.document.createElement('div')
+  // this is a workaround for a happy-dom bug with ids beginning with _
+  app.id = 'nuxt-test'
+  win.document.body.appendChild(app)
+
+  win.IntersectionObserver
+      = win.IntersectionObserver
+        || class IntersectionObserver {
+          observe() {
+          // noop
+          }
+        }
+
+  const h3App = createApp()
+
+  const registry = new Set<string>()
+
+  if (__HST_COLLECT__) {
+    const {
+      toNodeListener,
+    } = await import('h3')
+    const {
+      createCall,
+      createFetch: createLocalFetch,
+    } = await import('unenv/runtime/fetch/index')
+    // @ts-expect-error TODO: fix in h3
+    const localCall = createCall(toNodeListener(h3App))
+    const localFetch = createLocalFetch(localCall, globalThis.fetch)
+
+    win.fetch = (init: string, options?: any) => {
+      if (typeof init === 'string' && registry.has(init)) {
+        init = `/_${init}`
+      }
+      return localFetch(init, options)
+    }
+  }
+
+  win.$fetch = createFetch({ fetch: win.fetch, Headers: win.Headers as any })
+
+  win.__registry = registry
+  win.__app = h3App
+
+  // @ts-expect-error no types
+  const result = await import('#app/entry')
+  await result.default()
+}

package/tsconfig.json

@@ -0,0 +1,40 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    // Volar
+    "jsx": "preserve",
+    "lib": [
+      "ESNext",
+      "DOM"
+    ],
+    "rootDir": "src",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "types": [
+      "node"
+    ],
+    "strictBindCallApply": true,
+    "strictFunctionTypes": true,
+    "alwaysStrict": true,
+    // Strict
+    "noImplicitAny": false,
+    "noImplicitThis": true,
+    "outDir": "dist",
+    "removeComments": false,
+    "sourceMap": false,
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "preserveWatchOutput": true
+  },
+  "include": [
+    "src"
+  ],
+  "exclude": [
+    "node_modules",
+    "generated/**/*",
+    "dist/**/*",
+    "src/**/*.spec.ts"
+  ]
+}