@poveste/plugin-nuxt 0.14.0 → 0.16.0

package/README.md

@@ -19,5 +19,5 @@ export default defineConfig({
 })
 ```
 
-[Nuxt guide](https://poveste.dev/guide/vue/getting-started.html#nuxt) ·
+[Nuxt guide](https://poveste.dev/guide/nuxt/getting-started) ·
 [Documentation](https://poveste.dev)

package/dist/index.js

@@ -48,8 +48,8 @@ export function HstNuxt(options = {}) {
     }
     return {
         name: '@poveste/plugin-nuxt',
-        async defaultConfig() {
-            const nuxtViteConfig = await useNuxtViteConfig([...DEFAULT_EXCLUDED_PLUGINS, ...(options.excludePlugins ?? [])]);
+        async defaultConfig(_defaultConfig, mode) {
+            const nuxtViteConfig = await useNuxtViteConfig([...DEFAULT_EXCLUDED_PLUGINS, ...(options.excludePlugins ?? [])], mode === 'build');
             const { viteConfig } = nuxtViteConfig;
             nuxt = nuxtViteConfig.nuxt;
             // Registered here rather than in a command hook: this instance exists from
@@ -60,7 +60,7 @@ export function HstNuxt(options = {}) {
             return {
                 vite: {
                     server: {
-                        watch: viteConfig.server.watch,
+                        ...viteConfig.server.watch !== undefined ? { watch: viteConfig.server.watch } : {},
                         fs: {
                             allow: viteConfig.server.fs.allow,
                         },
@@ -94,7 +94,7 @@ export function HstNuxt(options = {}) {
                     optimizeDeps: {
                         ...viteConfig.optimizeDeps,
                         exclude: [
-                            ...viteConfig.optimizeDeps.exclude,
+                            ...viteConfig.optimizeDeps.exclude ?? [],
                             '@poveste/plugin-nuxt',
                         ],
                     },
@@ -102,6 +102,11 @@ export function HstNuxt(options = {}) {
                     vue: viteConfig.vue,
                     logLevel: 'info',
                 },
+                // The generated hook keeps the canonical name. `getSetupFnGroups` treats
+                // `setupFn[0]` as canonical and only that name is re-exported from the
+                // generated setup module, so an unnumbered `setupVue` here resolves to
+                // nothing and every Nuxt story loses its app setup — three `render-story`
+                // specs fail (#157).
                 setupCode: [
                     `${nuxt.options.css.map(file => `import '${file}'`).join('\n')}`,
                     `import { setupNuxtApp } from '@poveste/plugin-nuxt/dist/runtime/app-setup.js'
@@ -135,7 +140,7 @@ export async function setupVue3 () {
         },
     };
 }
-async function useNuxtViteConfig(excludePlugins) {
+async function useNuxtViteConfig(excludePlugins, isBuild) {
     const { loadNuxt, buildNuxt } = await import('@nuxt/kit');
     const nuxt = await loadNuxt({
         // cwd: process.cwd(),
@@ -150,6 +155,12 @@ async function useNuxtViteConfig(excludePlugins) {
             ssr: false,
             experimental: {
                 appManifest: false,
+                // A build has nothing to watch for. Nuxt's default watchers are started
+                // by `buildNuxt`, keep multiplying after `_stop_` aborts it, and survive
+                // `nuxt.close()`, so a failed build hung on ~115 `FSEventWrap` handles
+                // (#434). `builder` attaches to the Vite dev server instead, which this
+                // instance never creates.
+                ...isBuild ? { watcher: 'builder' } : {},
             },
             app: {
                 rootId: 'nuxt-test',
@@ -164,7 +175,7 @@ async function useNuxtViteConfig(excludePlugins) {
         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' }, { src: join(runtimeDir, 'tolerant-plugins.mjs'), filename: 'poveste/tolerant-plugins.mjs' });
+    nuxt.options.build.templates.push({ src: join(runtimeDir, 'components.mjs'), filename: 'poveste/components.mjs' }, { src: join(runtimeDir, 'tolerant-plugins.mjs'), filename: 'poveste/tolerant-plugins.mjs' });
     // Drop the sandbox-incompatible client plugins named by `excludePlugins`, so
     // they don't 500 the story iframe on entry boot. See DEFAULT_EXCLUDED_PLUGINS.
     nuxt.hook('app:resolve', (app) => {
@@ -188,20 +199,20 @@ async function useNuxtViteConfig(excludePlugins) {
             template.getContents = async (ctx) => wrapPluginsForTolerantBoot(await original(ctx));
         }
     });
+    // `useNuxtApp` was stubbed here until #439, which cost every story the real
+    // one: `$config` read as undefined and a value a plugin provided was
+    // unreachable, which is the case histoire#666 was about. The polyfills stay —
+    // they are dropped from the `#app` presets and deliberately not replaced.
     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)));
+                appPreset.imports = appPreset.imports.filter(i => typeof i !== 'string' || !polyfills.includes(i));
             }
         }
-        presets.push({
-            from: '#build/poveste/composables.mjs',
-            imports: stubbedComposables,
-        });
     });
     return {
+        // Captured from `vite:configResolved`, so it is the resolved config.
         viteConfig: await new Promise((resolve, reject) => {
             nuxt.hook('modules:done', () => {
                 nuxt.hook('components:extend', (components) => {
@@ -214,6 +225,7 @@ async function useNuxtViteConfig(excludePlugins) {
                 });
                 nuxt.hook('vite:configResolved', (config, { isClient }) => {
                     if (isClient) {
+                        // Nuxt types the hook argument as its user config; at this hook it is resolved.
                         resolve(config);
                         // The resolved config is all this instance is for. Left running,
                         // `buildNuxt` goes on to build the Nuxt client, start Nitro and

package/dist/runtime/app-setup.js

@@ -25,11 +25,8 @@ export async function setupNuxtApp(publicConfig) {
     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);
+        const { createLocalFetch } = await import('./local-fetch.js');
+        const localFetch = createLocalFetch(h3App);
         win.fetch = (init, options) => {
             if (typeof init === 'string' && registry.has(init)) {
                 init = `/_${init}`;

package/dist/runtime/local-fetch.d.ts

@@ -0,0 +1,14 @@
+import type { App } from 'h3';
+/**
+ * A `fetch` that answers a path from the in-memory h3 app and sends any other
+ * URL to the real `fetch`.
+ *
+ * unenv 1 provided this as `createCall` and `createFetch`, and unenv 2 removed
+ * both (#74). An h3 app already answers a web `Request` through `toWebHandler`,
+ * so no Node request and response shims are needed to reach it. The rule for
+ * what stays local is unenv's: a URL starting with `/`, except a protocol-
+ * relative one — `//cdn.example.com/x` starts with a slash and names another
+ * host, and answering it here would return this app's 404 for a resource that
+ * exists on the network.
+ */
+export declare function createLocalFetch(app: App, fallback?: typeof fetch): (input: string | URL, init?: RequestInit) => Promise<Response>;

package/dist/runtime/local-fetch.js

@@ -0,0 +1,23 @@
+import { toWebHandler } from 'h3';
+/**
+ * A `fetch` that answers a path from the in-memory h3 app and sends any other
+ * URL to the real `fetch`.
+ *
+ * unenv 1 provided this as `createCall` and `createFetch`, and unenv 2 removed
+ * both (#74). An h3 app already answers a web `Request` through `toWebHandler`,
+ * so no Node request and response shims are needed to reach it. The rule for
+ * what stays local is unenv's: a URL starting with `/`, except a protocol-
+ * relative one — `//cdn.example.com/x` starts with a slash and names another
+ * host, and answering it here would return this app's 404 for a resource that
+ * exists on the network.
+ */
+export function createLocalFetch(app, fallback = globalThis.fetch) {
+    const handle = toWebHandler(app);
+    return (input, init) => {
+        const url = input.toString();
+        if (!url.startsWith('/') || url.startsWith('//')) {
+            return fallback(url, init);
+        }
+        return handle(new Request(new URL(url, 'http://localhost'), init));
+    };
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@poveste/plugin-nuxt",
   "type": "module",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Poveste plugin to integrate with Nuxt 4",
   "author": {
     "name": "Sorin Gitlan",
@@ -46,27 +46,26 @@
     "runtime"
   ],
   "engines": {
-    "node": "^22.22.2 || ^24.15.0 || >=26.0.0"
+    "node": ">=22.22.2"
   },
   "peerDependencies": {
-    "@poveste/plugin-vue": "^0.14.0",
+    "@poveste/plugin-vue": "^0.16.0",
     "nuxt": "^4.5.0",
-    "poveste": "^0.14.0"
+    "poveste": "^0.16.0"
   },
   "dependencies": {
     "@nuxt/kit": "^4.5.2",
     "@rollup/plugin-replace": "^6.0.1",
     "h3": "^1.13.0",
-    "ofetch": "^1.4.1",
-    "unenv": "^1.10.0"
+    "ofetch": "^1.4.1"
   },
   "devDependencies": {
     "@nuxt/schema": "^4.5.2",
-    "@types/node": "^22.10.1",
-    "poveste": "0.14.0",
-    "typescript": "5.6.3",
-    "vite": "^8.2.0",
-    "vitest": "^5.0.0"
+    "@types/node": "^26.6.3",
+    "poveste": "0.16.0",
+    "typescript": "6.0.3",
+    "vite": "^8.3.1",
+    "vitest": "^5.0.2"
   },
   "scripts": {
     "build": "rimraf dist && tsc -d",

package/runtime/composables.mjs

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