poveste 0.5.3 → 0.6.1

package/dist/node/bin.js

@@ -4,7 +4,7 @@ import { dirname, resolve } from 'pathe';
 import sade from 'sade';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const { version } = JSON.parse(fs.readFileSync(resolve(__dirname, '../../package.json'), 'utf8'));
-process.env.NODE_ENV = 'development';
+process.env.NODE_ENV = process.argv.includes('build') || process.argv.includes('preview') ? 'production' : 'development';
 process.env.HISTOIRE = 'true';
 process.env.POVESTE = 'true';
 const program = sade('poveste');

package/dist/node/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/node/build.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAqC3C,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,iBA6NvC"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/node/build.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAuD3C,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,iBA6OvC"}

package/dist/node/build.js

@@ -18,6 +18,23 @@ import { getViteConfigWithPlugins } from './vite.js';
 const PRELOAD_MODULES = [
     'vendor',
 ];
+// Kept out of the shared `vendor` chunk because only the app UI imports them,
+// while `vendor` is imported by the sandbox too.
+//
+// Shiki is the source panel's syntax highlighter: 386 grammars and 60 themes,
+// and it was the bulk of an 11.5 MB `vendor`. The sandbox entry pulls seven Vue
+// exports from that chunk and nothing else, but a grid renders one sandbox
+// iframe per cell and each iframe is its own realm — so every cell parsed and
+// executed all 11.5 MB again, with the HTTP cache saving only the download.
+// That was 34% of a scroll profile spent in top-level vendor evaluation (#103).
+//
+// They go to a chunk of their own rather than being left to Rollup: leaving
+// placement automatic emitted one chunk per grammar — 402 assets — and tripled
+// the blocking time it was meant to cut.
+const APP_ONLY_VENDORS = [
+    /[\\/]node_modules[\\/]shiki[\\/]/,
+    /[\\/]node_modules[\\/]@shikijs[\\/]/,
+];
 const PREFETCHED_MODULES = [
     'StoryView',
     'reactivity',
@@ -122,7 +139,21 @@ export async function build(ctx) {
             // Force chunk strategy
             config.build.rollupOptions.output = {
                 manualChunks(id) {
+                    // Vite's runtime helpers (`\0vite/preload-helper.js` and friends) are
+                    // virtual modules, so the node_modules routing below never sees them
+                    // and their placement is left to the bundler — which parked
+                    // `__vitePreload` inside the 10 MB `highlighter` chunk. Every chunk
+                    // importing the helper then statically imported the whole highlighter,
+                    // and the sandbox was back to evaluating it once per grid cell (#197),
+                    // undoing exactly what `APP_ONLY_VENDORS` is for. Pin them somewhere
+                    // harmless instead of leaving the choice to chunking heuristics.
+                    if (id.replace(/^\0/, '').startsWith('vite/')) {
+                        return 'app-runtime';
+                    }
                     if (!id.includes('@poveste/app') && id.includes('node_modules')) {
+                        if (APP_ONLY_VENDORS.some(test => test.test(id))) {
+                            return 'highlighter';
+                        }
                         for (const test of ctx.config.build?.excludeFromVendorsChunk ?? []) {
                             if ((typeof test === 'string' && id.includes(test)) || (test instanceof RegExp && test.test(id))) {
                                 // Excluded from vendor chunk

package/dist/node/builtin-plugins/pinceau-tokens.js

@@ -57,8 +57,8 @@ export function pinceauTokens(_options = {}) {
 }
 function storyTemplate(pinceauConfig) {
     pinceauConfig = pinceauConfig?.theme || pinceauConfig?.default?.theme || {};
-    return `import 'poveste-style'
-import './style.css'
+    // No `import 'poveste-style'` — see the tailwind plugin's template (#219).
+    return `import './style.css'
 import { createApp, h, markRaw, ref } from ${getInjectedImport('@poveste/vendors/vue')}
 import {
   HstColorShades,

package/dist/node/commands/port.d.ts

@@ -7,4 +7,12 @@
  * neither the flag nor the mistake. A non-numeric value fails the same way.
  */
 export declare function resolvePort(value: unknown, command: string): number | undefined;
+/**
+ * The HMR socket port for a book served on `devPort`. Derived from the dev port
+ * so each concurrent dev server's socket is as distinct as its book port (#175),
+ * offset clear of the usual dev-port range and wrapped so it stays a valid port
+ * for an unusually high `--port`. `@nuxt/vite-builder` otherwise pins every
+ * server to the framework default (24678), a constant that collides (#221).
+ */
+export declare function hmrPortFor(devPort: number | undefined): number;
 //# sourceMappingURL=port.d.ts.map

package/dist/node/commands/port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../../src/node/commands/port.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAoB/E"}
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../../src/node/commands/port.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAoB/E;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG9D"}

package/dist/node/commands/port.js

@@ -22,3 +22,14 @@ export function resolvePort(value, command) {
     }
     return port;
 }
+/**
+ * The HMR socket port for a book served on `devPort`. Derived from the dev port
+ * so each concurrent dev server's socket is as distinct as its book port (#175),
+ * offset clear of the usual dev-port range and wrapped so it stays a valid port
+ * for an unusually high `--port`. `@nuxt/vite-builder` otherwise pins every
+ * server to the framework default (24678), a constant that collides (#221).
+ */
+export function hmrPortFor(devPort) {
+    const base = devPort ?? 6006;
+    return base < 45536 ? base + 20000 : base - 20000;
+}

package/dist/node/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/node/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAEV,aAAa,EAEd,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAkB3C,wBAAgB,gBAAgB,IAAI,aAAa,CA2HhD;AAED,eAAO,MAAM,eAAe,UAU3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ1F;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAexF;AAED,eAAO,MAAM,gBAAgB,uBAK3B,CAAA;AAEF,eAAO,MAAM,WAAW,uBA8DtB,CAAA;AAEF,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAsB,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAgB7H;AA2BD,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,iBAoE/C;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,0BAE1D;AAED,OAAO,QAAQ,MAAM,CAAC;IACpB,UAAU,UAAU;QAClB;;WAEG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;QAChC;;WAEG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;KAClC;CACF"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/node/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAEV,aAAa,EAEd,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAiB3C,wBAAgB,gBAAgB,IAAI,aAAa,CA0HhD;AAED,eAAO,MAAM,eAAe,UAU3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ1F;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAexF;AAED,eAAO,MAAM,gBAAgB,uBAK3B,CAAA;AAEF,eAAO,MAAM,WAAW,uBAwEtB,CAAA;AAEF,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAsB,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAgB7H;AA2BD,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,iBAoE/C;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,0BAE1D;AAED,OAAO,QAAQ,MAAM,CAAC;IACpB,UAAU,UAAU;QAClB;;WAEG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;QAChC;;WAEG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;KAClC;CACF"}

package/dist/node/config.js

@@ -5,7 +5,6 @@ import { createJiti } from 'jiti';
 import path from 'pathe';
 import pc from 'picocolors';
 import { mergeConfig as mergeViteConfig, resolveConfig as resolveViteConfig, } from 'vite';
-import { tailwindTokens } from './builtin-plugins/tailwind-tokens.js';
 import { vanillaSupport } from './builtin-plugins/vanilla-support/plugin.js';
 import { defaultColors } from './colors.js';
 import { findUp } from './util/find-up.js';
@@ -14,7 +13,6 @@ export function getDefaultConfig() {
     return {
         plugins: [
             vanillaSupport(),
-            tailwindTokens(),
         ],
         outDir: '.poveste/dist',
         storyMatch: [
@@ -224,6 +222,15 @@ export const mergeConfig = createDefu((obj, key, value) => {
         obj[key] = mergeBuildConfig(obj[key], value);
         return true;
     }
+    // An ignore list adds to the defaults rather than replacing them. Under the
+    // replace rule below, `storyIgnored: ['**/fixtures/**']` silently dropped
+    // `**/node_modules/**`, and the watchers then crawled the pnpm store until
+    // the build died with EMFILE (#244). `storyMatch` stays on the replace rule:
+    // narrowing it is a legitimate use.
+    if (obj[key] && key === 'storyIgnored') {
+        obj[key] = [...new Set([...obj[key], ...value])];
+        return true;
+    }
     // By default, arrays should be replaced
     if (obj[key] && Array.isArray(obj[key])) {
         obj[key] = value;

package/dist/node/index.d.ts

@@ -1,5 +1,6 @@
 export { defaultColors } from './colors.js';
 export * from './config.js';
 export * from './plugin.js';
+export { getInjectedImport } from './util/vendors.js';
 export * from '@poveste/shared';
 //# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAG3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,cAAc,iBAAiB,CAAA"}

package/dist/node/index.js

@@ -1,4 +1,7 @@
 export { defaultColors } from './colors.js';
 export * from './config.js';
 export * from './plugin.js';
+// A plugin that generates story source needs to reference poveste's own
+// vendored copies of Vue and the controls from inside that generated code.
+export { getInjectedImport } from './util/vendors.js';
 export * from '@poveste/shared';

package/dist/node/markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/node/markdown.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAA;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAK3C,OAAO,UAAU,MAAM,aAAa,CAAA;AAapC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,OAAO,QAE1D;AAyBD,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,OAAO,uBA0ExD;AAaD,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,OAAO,8BAqBvD;AAED,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,OAAO;;GAgI5D;AAED,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAA"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/node/markdown.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAA;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAK3C,OAAO,UAAU,MAAM,aAAa,CAAA;AAapC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,OAAO,QAE1D;AAyBD,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,OAAO,uBA0ExD;AAaD,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,OAAO,8BAqBvD;AAED,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,OAAO;;GAuH5D;AAED,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAA"}

package/dist/node/markdown.js

@@ -6,12 +6,12 @@ import MarkdownIt from 'markdown-it';
 import anchor from 'markdown-it-anchor';
 import attrs from 'markdown-it-attrs';
 import { full as emoji } from 'markdown-it-emoji';
-import micromatch from 'micromatch';
 import path from 'pathe';
 import pc from 'picocolors';
 import { bundledLanguages, createHighlighter } from 'shiki';
 import { addStory, notifyStoryChange, removeStory } from './stories.js';
 import { slugify } from './util/slugify.js';
+import { createWatchIgnore } from './util/watch-ignore.js';
 const onMarkdownListChangeHandlers = [];
 export function onMarkdownListChange(handler) {
     onMarkdownListChangeHandlers.push(handler);
@@ -136,15 +136,7 @@ export async function createMarkdownFilesWatcher(ctx) {
     const md = await createMarkdownRendererWithPlugins(ctx);
     const watcher = chokidar.watch('.', {
         cwd: ctx.root,
-        ignored: (path, stats) => {
-            if (ctx.config.storyIgnored.some(pattern => micromatch.isMatch(path, pattern))) {
-                return true;
-            }
-            if (micromatch.isMatch(path, '**/*.story.md')) {
-                return false;
-            }
-            return stats?.isFile();
-        },
+        ignored: createWatchIgnore(ctx.config.storyIgnored, ['**/*.story.md']),
     });
     /**
      * Initial scan is complete.

package/dist/node/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/node/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAa3C,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACxB;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,mBAAwB;;;;GA6NjF"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/node/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAc3C,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACxB;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,mBAAwB;;;;GA4OjF"}

package/dist/node/server.js

@@ -2,6 +2,7 @@ import { performance } from 'node:perf_hooks';
 import pc from 'picocolors';
 import { createServer as createViteServer, mergeConfig as mergeViteConfig } from 'vite';
 import { useCollectStories } from './collect/index.js';
+import { hmrPortFor } from './commands/port.js';
 import { useModuleLoader } from './load.js';
 import { createMarkdownFilesWatcher, onMarkdownListChange } from './markdown.js';
 import { DevEventPluginApi, DevPluginApi } from './plugin.js';
@@ -12,7 +13,21 @@ import { getViteConfigWithPlugins } from './vite.js';
 export async function createServer(ctx, options = {}) {
     const getViteServer = async (collecting) => {
         const { viteConfig, viteConfigFile } = await getViteConfigWithPlugins(collecting, ctx);
-        if (!collecting) {
+        if (collecting) {
+            // The collection server drives vite-node and has no browser, so it needs
+            // no HMR socket. Left enabled, `@nuxt/vite-builder` gives it one on the
+            // framework default port (24678) — see the book server below.
+            viteConfig.server.hmr = false;
+        }
+        else {
+            // `@nuxt/vite-builder` pins the HMR socket to the constant 24678 on every
+            // server it configures, so two poveste dev servers on different `--port`s
+            // collide on it and the second silently loses HMR (#221). It only does
+            // this when `server.hmr` carries no port of its own (it fills the gap with
+            // `defu`), so pin the socket to a port derived from this book's `--port`,
+            // before the config is resolved: each dev server then owns a distinct one
+            // (#175).
+            viteConfig.server.hmr = { port: hmrPortFor(options.port ?? viteConfig.server.port) };
             if (options.open) {
                 viteConfig.server.open = true;
             }

package/dist/node/stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stories.d.ts","sourceRoot":"","sources":["../../src/node/stories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAO3C,KAAK,kBAAkB,GAAG,CAAC,IAAI,CAAC,EAAE,eAAe,KAAK,OAAO,CAAA;AAG7D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,kBAAkB,QAExD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,eAAe,QAIvD;AAED,KAAK,sBAAsB,GAAG,MAAM,OAAO,CAAA;AAG3C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,sBAAsB,QAEhE;AAED,wBAAgB,qBAAqB,SAIpC;AAID,wBAAsB,YAAY,CAAC,UAAU,EAAE,OAAO,yCA0CrD;AAMD,wBAAgB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,mBA0C5E;AAED,wBAAgB,WAAW,CAAC,gBAAgB,EAAE,MAAM,QAInD;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,OAAO,iBAWvD"}
+{"version":3,"file":"stories.d.ts","sourceRoot":"","sources":["../../src/node/stories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAQ3C,KAAK,kBAAkB,GAAG,CAAC,IAAI,CAAC,EAAE,eAAe,KAAK,OAAO,CAAA;AAG7D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,kBAAkB,QAExD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,eAAe,QAIvD;AAED,KAAK,sBAAsB,GAAG,MAAM,OAAO,CAAA;AAG3C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,sBAAsB,QAEhE;AAED,wBAAgB,qBAAqB,SAIpC;AAID,wBAAsB,YAAY,CAAC,UAAU,EAAE,OAAO,yCAgCrD;AAMD,wBAAgB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,mBA0C5E;AAED,wBAAgB,WAAW,CAAC,gBAAgB,EAAE,MAAM,QAInD;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,OAAO,iBAWvD"}

package/dist/node/stories.js

@@ -3,6 +3,7 @@ import chokidar from 'chokidar';
 import { globby } from 'globby';
 import micromatch from 'micromatch';
 import { basename, resolve } from 'pathe';
+import { createWatchIgnore } from './util/watch-ignore.js';
 const storyChangeHandlers = [];
 /**
  * Called when a new story is added or modified. Collecting should be done.
@@ -44,16 +45,7 @@ export async function watchStories(newContext) {
     });
     const watcher = chokidar.watch(baseWatchPaths, {
         cwd: context.root,
-        ignored: (path, stats) => {
-            if (resolvedStoryIgnored.some(pattern => micromatch.isMatch(path, pattern))) {
-                return true;
-            }
-            if (resolveStoryMatch.some(pattern => micromatch.isMatch(path, pattern))) {
-                return false;
-            }
-            // Allow directories to be traversed, only ignore files that don't match
-            return stats?.isFile() ?? false;
-        },
+        ignored: createWatchIgnore(resolvedStoryIgnored, resolveStoryMatch),
     });
     watcher
         .on('add', (file) => {

package/dist/node/util/watch-ignore.d.ts

@@ -0,0 +1,3 @@
+import type { Stats } from 'node:fs';
+export declare function createWatchIgnore(ignored: string[], included: string[]): (path: string, stats?: Stats) => boolean;
+//# sourceMappingURL=watch-ignore.d.ts.map

package/dist/node/util/watch-ignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-ignore.d.ts","sourceRoot":"","sources":["../../../src/node/util/watch-ignore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAMpC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,UACvD,MAAM,UAAU,KAAK,KAAG,OAAO,CAK9C"}

package/dist/node/util/watch-ignore.js

@@ -0,0 +1,12 @@
+import micromatch from 'micromatch';
+// chokidar 4 passes absolute paths, so `**` must cross dot segments (`.claude/`, `node_modules/.pnpm`).
+const options = { dot: true };
+export function createWatchIgnore(ignored, included) {
+    return (path, stats) => {
+        if (micromatch.isMatch(path, ignored, options))
+            return true;
+        if (micromatch.isMatch(path, included, options))
+            return false;
+        return stats?.isFile() ?? false;
+    };
+}

package/dist/node/virtual/resolved-generated-global-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolved-generated-global-setup.d.ts","sourceRoot":"","sources":["../../../src/node/virtual/resolved-generated-global-setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAI5C,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,UAoBxD"}
+{"version":3,"file":"resolved-generated-global-setup.d.ts","sourceRoot":"","sources":["../../../src/node/virtual/resolved-generated-global-setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAI5C,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,UA4BxD"}

package/dist/node/virtual/resolved-generated-global-setup.js

@@ -1,20 +1,28 @@
 import { GENERATED_SETUP_CODE } from './index.js';
-import { declareEmptySetupFns, getSetupFnNames, ID_SEPARATOR } from './util.js';
+import { declareEmptySetupFns, getSetupFnGroups, ID_SEPARATOR } from './util.js';
 export function resolvedGeneratedGlobalSetup(ctx) {
     if (ctx.config.setupCode) {
+        const groups = getSetupFnGroups(ctx);
+        const canonicals = new Set(groups.map(g => g.canonical));
         return [
             // Import
             `${ctx.config.setupCode.map((c, index) => `import * as setup_${index} from '${GENERATED_SETUP_CODE}${ID_SEPARATOR}${index}'`).join('\n')}`,
             // List
             `const setupList = [${ctx.config.setupCode.map((c, index) => `setup_${index}`).join(', ')}]`,
-            // Setups
-            ...getSetupFnNames(ctx).map(fnName => `export async function ${fnName} (payload) {
+            // Setups: one real function per plugin, under its canonical name only.
+            ...groups.map(g => `export async function ${g.canonical} (payload) {
         for (const setup of setupList) {
-          if (setup?.${fnName}) {
-            await setup.${fnName}(payload)
+          if (setup?.${g.canonical}) {
+            await setup.${g.canonical}(payload)
           }
         }
       }`),
+            // Aliases are declared `undefined`, not emitted as functions: only the
+            // canonical hook is callable, so `getSetupHook` sees one hook in our own
+            // generated module rather than warning that it exports two aliases (#231).
+            ...[...new Set(groups.flatMap(g => g.aliases))]
+                .filter(name => !canonicals.has(name))
+                .map(name => `export const ${name} = undefined`),
         ].join('\n');
     }
     else {

package/dist/node/virtual/util.d.ts

@@ -5,6 +5,17 @@ export declare const ID_SEPARATOR = "__-__";
  * `setupVanilla`, `setupVue3`, `setupSvelte4`.
  */
 export declare function getSetupFnNames(ctx: Context): string[];
+/**
+ * Setup hooks grouped by the plugin that contributes them, canonical name first.
+ * A plugin's `setupFn` lists one hook under several names — `['setupVue3',
+ * 'setupVue']` is a single hook whose established name is `setupVue3` and whose
+ * alias is `setupVue`. The first is canonical; the rest are aliases kept so
+ * older setup files still resolve.
+ */
+export declare function getSetupFnGroups(ctx: Context): {
+    canonical: string;
+    aliases: string[];
+}[];
 /**
  * Declares the setup hooks as named exports set to `undefined`.
  *

package/dist/node/virtual/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/node/virtual/util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,eAAO,MAAM,YAAY,UAAU,CAAA;AAEnC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,YAE3C;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,UAEhD;AAED,eAAO,MAAM,gBAAgB,UAE5B,CAAA"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/node/virtual/util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,eAAO,MAAM,YAAY,UAAU,CAAA;AAEnC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,YAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO;;;IAK5C;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,UAEhD;AAED,eAAO,MAAM,gBAAgB,UAE5B,CAAA"}

package/dist/node/virtual/util.js

@@ -6,6 +6,19 @@ export const ID_SEPARATOR = '__-__';
 export function getSetupFnNames(ctx) {
     return [...new Set(ctx.supportPlugins.flatMap(p => p.setupFn))];
 }
+/**
+ * Setup hooks grouped by the plugin that contributes them, canonical name first.
+ * A plugin's `setupFn` lists one hook under several names — `['setupVue3',
+ * 'setupVue']` is a single hook whose established name is `setupVue3` and whose
+ * alias is `setupVue`. The first is canonical; the rest are aliases kept so
+ * older setup files still resolve.
+ */
+export function getSetupFnGroups(ctx) {
+    return ctx.supportPlugins.map((p) => {
+        const names = typeof p.setupFn === 'string' ? [p.setupFn] : p.setupFn;
+        return { canonical: names[0], aliases: names.slice(1) };
+    });
+}
 /**
  * Declares the setup hooks as named exports set to `undefined`.
  *

package/dist/node/vite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../src/node/vite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,MAAM,CAAA;AACb,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAsB3C,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,yBAmClF;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,YAAY,CAAA;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAqW9G"}
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../src/node/vite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,MAAM,CAAA;AACb,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAuB3C,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,yBAmClF;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,YAAY,CAAA;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA+W9G"}

package/dist/node/vite.js

@@ -2,7 +2,7 @@ import { existsSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { lookup as lookupMime } from 'mrmime';
 import { dirname, join, relative } from 'pathe';
-import { loadConfigFromFile as loadViteConfigFromFile, mergeConfig as mergeViteConfig, } from 'vite';
+import { loadConfigFromFile as loadViteConfigFromFile, mergeConfig as mergeViteConfig, searchForWorkspaceRoot, } from 'vite';
 import { APP_PATH, TEMP_PATH } from './alias.js';
 import { createMarkdownPlugins } from './markdown.js';
 import { notifyStoryChange } from './stories.js';
@@ -140,6 +140,10 @@ export async function getViteConfigWithPlugins(isServer, ctx) {
                             TEMP_PATH,
                             ctx.resolvedViteConfig.root,
                             process.cwd(),
+                            // Vite's own default, which setting `allow` at all replaces. In a
+                            // workspace the app's deps resolve above the project — the
+                            // bundled font under the root `node_modules` was refused (#252).
+                            searchForWorkspaceRoot(process.cwd()),
                             ...supportPluginAllowPaths,
                             ...process.env.POVESTE_DEV
                                 ? [
@@ -156,7 +160,13 @@ export async function getViteConfigWithPlugins(isServer, ctx) {
                 define: {
                     // We need to force this to be able to use `devtoolsRawSetupState`
                     '__VUE_PROD_DEVTOOLS__': 'true',
-                    // Disable warnings
+                    // Vue's esm-bundler build expects every feature flag to be injected;
+                    // in a production build an undefined one logs a warning per realm.
+                    '__VUE_OPTIONS_API__': 'true',
+                    '__VUE_PROD_HYDRATION_MISMATCH_DETAILS__': 'false',
+                    // `bin.ts` sets this per command: development for `dev`, production
+                    // for `build` and `preview`. Every built book used to ship the
+                    // development build of Vue, Pinia, vue-router and VueUse.
                     'process.env.NODE_ENV': JSON.stringify(isServer ? 'production' : process.env.NODE_ENV ?? 'development'),
                     ...!isServer
                         ? {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "poveste",
   "type": "module",
-  "version": "0.5.3",
+  "version": "0.6.1",
   "description": "A fast story book powered by Vite",
   "author": {
     "name": "Sorin Gitlan"
@@ -68,10 +68,10 @@
     "sirv": "^3.0.0",
     "unhead": "^3.1.0",
     "vite-node": "^6.0.0",
-    "@poveste/app": "^0.5.3",
-    "@poveste/shared": "^0.5.3",
-    "@poveste/controls": "^0.5.3",
-    "@poveste/vendors": "^0.5.3"
+    "@poveste/app": "^0.6.1",
+    "@poveste/vendors": "^0.6.1",
+    "@poveste/controls": "^0.6.1",
+    "@poveste/shared": "^0.6.1"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",

package/src/node/__tests__/config.spec.ts

@@ -0,0 +1,25 @@
+import { describe, expect, it } from 'vitest'
+import { getDefaultConfig, mergeConfig } from '../config.js'
+
+// `mergeConfig(user, defaults)`: defu-style, the first argument wins.
+describe('mergeConfig', () => {
+  it('adds user storyIgnored patterns to the defaults instead of replacing them', () => {
+    const merged = mergeConfig({ storyIgnored: ['**/fixtures/**'] }, getDefaultConfig())
+
+    expect(merged.storyIgnored).toEqual(expect.arrayContaining(['**/node_modules/**', '**/dist/**', '**/fixtures/**']))
+  })
+
+  it('does not duplicate a default a user spelled out again', () => {
+    const merged = mergeConfig({ storyIgnored: ['**/node_modules/**', '**/fixtures/**'] }, getDefaultConfig())
+
+    expect(merged.storyIgnored.filter(p => p === '**/node_modules/**')).toHaveLength(1)
+  })
+
+  // Narrowing the match is a real use — `src/**/*.story.vue` to skip binary
+  // folders — so the replace rule is the right one there.
+  it('still lets a user narrow storyMatch', () => {
+    const merged = mergeConfig({ storyMatch: ['src/**/*.story.vue'] }, getDefaultConfig())
+
+    expect(merged.storyMatch).toEqual(['src/**/*.story.vue'])
+  })
+})

package/src/node/__tests__/port.spec.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest'
-import { resolvePort } from '../commands/port.js'
+import { hmrPortFor, resolvePort } from '../commands/port.js'
 
 describe('resolvePort', () => {
   it('returns undefined when the flag was not passed', () => {
@@ -31,3 +31,35 @@ describe('resolvePort', () => {
     expect(() => resolvePort(true, 'dev')).toThrow(/poveste dev --port 6006/)
   })
 })
+
+// `@nuxt/vite-builder` otherwise pins every server's HMR socket to the constant
+// 24678, so two dev servers on different `--port`s collide and the second
+// silently loses HMR (#221). The socket has to be as unique as the book port.
+describe('hmrPortFor', () => {
+  it('derives a port distinct from the dev port', () => {
+    expect(hmrPortFor(6006)).not.toBe(6006)
+  })
+
+  it('gives distinct dev ports distinct sockets', () => {
+    expect(hmrPortFor(4567)).not.toBe(hmrPortFor(4568))
+  })
+
+  it('never lands on the framework default that collides', () => {
+    for (const p of [4567, 4568, 6006, 8080]) {
+      expect(hmrPortFor(p)).not.toBe(24678)
+    }
+  })
+
+  it('stays within the valid port range, even for a high dev port', () => {
+    for (const p of [1024, 6006, 45535, 45536, 65535]) {
+      const hmr = hmrPortFor(p)
+      expect(hmr).toBeGreaterThanOrEqual(0)
+      expect(hmr).toBeLessThanOrEqual(65535)
+      expect(hmr).not.toBe(p)
+    }
+  })
+
+  it('falls back to the default dev port when none was given', () => {
+    expect(hmrPortFor(undefined)).toBe(hmrPortFor(6006))
+  })
+})

package/src/node/__tests__/virtual-setup.spec.ts

@@ -29,13 +29,23 @@ describe('virtual setup modules', () => {
       }
     })
 
-    it('should export a real hook per support plugin when there is setup code', () => {
+    it('exports each plugin\'s canonical hook as a real function when there is setup code', () => {
       const code = resolvedGeneratedGlobalSetup(contextFactory({ setupCode: ['export function setupVue3() {}'] }))
 
-      for (const fnName of SETUP_FN_NAMES) {
-        expect(code).toContain(`export async function ${fnName} (payload)`)
+      for (const canonical of ['setupVanilla', 'setupVue3', 'setupSvelte4']) {
+        expect(code).toContain(`export async function ${canonical} (payload)`)
       }
     })
+
+    // setupSvelte5 is an alias of setupSvelte4. Emitting both as functions made
+    // getSetupHook see two interchangeable hooks in poveste's own generated
+    // module and warn once per story (#231).
+    it('declares alias hooks undefined rather than as functions', () => {
+      const code = resolvedGeneratedGlobalSetup(contextFactory({ setupCode: ['export function setupVue3() {}'] }))
+
+      expect(code).toContain('export const setupSvelte5 = undefined')
+      expect(code).not.toContain('export async function setupSvelte5 (payload)')
+    })
   })
 
   describe('noop', () => {

package/src/node/__tests__/watch-ignore.spec.ts

@@ -0,0 +1,33 @@
+import type { Stats } from 'node:fs'
+import { describe, expect, it } from 'vitest'
+import { createWatchIgnore } from '../util/watch-ignore.js'
+
+const file = { isFile: () => true } as Stats
+const dir = { isFile: () => false } as Stats
+
+describe('createWatchIgnore', () => {
+  const root = '/repo/.claude/worktrees/feature/examples/vue3'
+  const ignored = createWatchIgnore(['**/node_modules/**', '**/dist/**'], ['**/*.story.md'])
+
+  it('ignores storyIgnored paths when the root sits under a dot directory', () => {
+    expect(ignored(`${root}/node_modules/foo/index.js`, file)).toBe(true)
+    expect(ignored(`${root}/node_modules/.pnpm/foo/node_modules/bar`, dir)).toBe(true)
+    expect(ignored(`${root}/dist/index.html`, file)).toBe(true)
+  })
+
+  it('keeps included files when the root sits under a dot directory', () => {
+    expect(ignored(`${root}/src/Button.story.md`, file)).toBe(false)
+  })
+
+  it('traverses directories and skips other files', () => {
+    expect(ignored(`${root}/src`, dir)).toBe(false)
+    expect(ignored(`${root}/src/Button.vue`, file)).toBe(true)
+    expect(ignored(`${root}/src/Button.vue`)).toBe(false)
+  })
+
+  it('matches patterns resolved to absolute paths', () => {
+    const resolved = createWatchIgnore([`${root}/**/node_modules/**`], [`${root}/**/*.story.vue`])
+    expect(resolved(`${root}/node_modules/.pnpm/foo/node_modules/bar/index.js`, file)).toBe(true)
+    expect(resolved(`${root}/src/Button.story.vue`, file)).toBe(false)
+  })
+})

package/src/node/bin.ts

@@ -7,7 +7,7 @@ const __dirname = dirname(fileURLToPath(import.meta.url))
 
 const { version } = JSON.parse(fs.readFileSync(resolve(__dirname, '../../package.json'), 'utf8'))
 
-process.env.NODE_ENV = 'development'
+process.env.NODE_ENV = process.argv.includes('build') || process.argv.includes('preview') ? 'production' : 'development'
 process.env.HISTOIRE = 'true'
 process.env.POVESTE = 'true'