poveste 0.5.2 → 0.6.0

package/dist/node/bin.js

@@ -4,8 +4,9 @@ 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');
 program.version(version);
 program.command('dev')

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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pinceau-tokens.d.ts","sourceRoot":"","sources":["../../../src/node/builtin-plugins/pinceau-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAA;AAI5D,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACjC,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,wBAAgB,aAAa,CAAC,QAAQ,GAAE,oBAAyB,GAAG,MAAM,CA2DzE"}
+{"version":3,"file":"pinceau-tokens.d.ts","sourceRoot":"","sources":["../../../src/node/builtin-plugins/pinceau-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAA;AAI5D,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACjC,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,wBAAgB,aAAa,CAAC,QAAQ,GAAE,oBAAyB,GAAG,MAAM,CA6DzE"}

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

@@ -41,7 +41,8 @@ export function pinceauTokens(_options = {}) {
                 });
             }
         },
-        onDev(api, onCleanup) {
+        async onDev(api, onCleanup) {
+            await generate(api);
             const watcher = api.watcher.watch(themePath)
                 .on('change', () => generate(api))
                 .on('add', () => generate(api));
@@ -56,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/dev.d.ts

@@ -1,5 +1,5 @@
 export interface DevOptions {
-    port: number;
+    port?: number | string;
     open?: boolean;
     host?: string | boolean;
     config?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/node/commands/dev.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,iBAoDnD"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/node/commands/dev.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,iBAsDnD"}

package/dist/node/commands/dev.js

@@ -3,7 +3,9 @@ import pc from 'picocolors';
 import { resolveConfigFile } from '../config.js';
 import { createContext } from '../context.js';
 import { createServer } from '../server.js';
+import { resolvePort } from './port.js';
 export async function devCommand(options) {
+    const port = resolvePort(options.port, 'dev');
     let stop;
     async function start() {
         const ctx = await createContext({
@@ -11,7 +13,7 @@ export async function devCommand(options) {
             mode: 'dev',
         });
         const { server, viteConfigFile, close } = await createServer(ctx, {
-            port: options.port,
+            port,
             open: options.open,
             host: options.host,
         });

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

@@ -0,0 +1,18 @@
+/**
+ * Reads a `--port` value off the parsed CLI options.
+ *
+ * sade declares the flag as taking a value but does not enforce one, so
+ * `poveste preview --port` arrives as the boolean `true` and reaches node's
+ * listen validation, which rejects it with `ERR_INVALID_ARG_VALUE` and names
+ * 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

@@ -0,0 +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;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG9D"}

package/dist/node/commands/port.js

@@ -0,0 +1,35 @@
+/**
+ * Reads a `--port` value off the parsed CLI options.
+ *
+ * sade declares the flag as taking a value but does not enforce one, so
+ * `poveste preview --port` arrives as the boolean `true` and reaches node's
+ * listen validation, which rejects it with `ERR_INVALID_ARG_VALUE` and names
+ * neither the flag nor the mistake. A non-numeric value fails the same way.
+ */
+export function resolvePort(value, command) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    // Checked by type, not by coercion: a valueless flag arrives as `true`, and
+    // `Number(true)` is 1, a valid port that would bind to a privileged one.
+    const port = typeof value === 'number'
+        ? value
+        : typeof value === 'string' && value.trim() !== ''
+            ? Number(value)
+            : Number.NaN;
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        throw new TypeError(`--port needs a number between 0 and 65535, got ${JSON.stringify(value)}. Try \`poveste ${command} --port 6006\`.`);
+    }
+    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/commands/preview.d.ts

@@ -1,5 +1,5 @@
 export interface PreviewOptions {
-    port?: number;
+    port?: number | string;
     host?: string | boolean;
     open?: boolean;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../../src/node/commands/preview.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,iBAiB3D"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../../src/node/commands/preview.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,iBAmB3D"}

package/dist/node/commands/preview.js

@@ -1,6 +1,8 @@
 import { createContext } from '../context.js';
 import { startPreview } from '../preview.js';
+import { resolvePort } from './port.js';
 export async function previewCommand(options) {
+    const port = resolvePort(options.port, 'preview');
     const ctx = await createContext({
         mode: 'build',
     });
@@ -10,7 +12,7 @@ export async function previewCommand(options) {
         }
     }
     const { printUrls } = await startPreview({
-        port: options.port,
+        port,
         host: options.host,
         open: options.open,
     }, ctx);

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,CA4HhD;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: [
@@ -110,7 +108,6 @@ export function getDefaultConfig() {
                 contrastColor: '#eee',
             },
         ],
-        sandboxDarkClass: 'dark',
         routerMode: 'history',
         build: {
             excludeFromVendorsChunk: [],
@@ -225,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/preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/node/preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAG3C,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAwBrG"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/node/preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAG3C,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA6BrG"}

package/dist/node/preview.js

@@ -12,7 +12,12 @@ export async function startPreview(options, ctx) {
             port,
             host: options.host,
             open: options.open,
-            strictPort: false,
+            // A port asked for by name has to be that port or nothing. Moving to the
+            // next free one serves the book where nobody is looking, and lands it on
+            // whatever example owns that number, whose suite then adopts it (#175).
+            // Without an explicit port there is no such expectation, and `build`'s
+            // internal preview reads the port back off the server.
+            strictPort: options.port != null,
         },
     });
     const baseUrl = server.resolvedUrls?.local[0] ?? `http://localhost:${port}${ctx.resolvedViteConfig.base}`;

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;;;;GAsNjF"}
+{"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,13 +13,33 @@ 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;
             }
             if (options.host) {
                 viteConfig.server.host = options.host;
             }
+            // Same rule as `preview`: a port asked for by name is that port or
+            // nothing. Floating to the next free one hands back a server nobody asked
+            // for, and whoever opens the port they typed reads a different book.
+            if (options.port != null) {
+                viteConfig.server.strictPort = true;
+            }
         }
         const server = await createViteServer(mergeViteConfig(viteConfig, {
             optimizeDeps: { include: viteConfig.optimizeDeps?.include ?? [], noDiscovery: collecting },

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.2",
+  "version": "0.6.0",
   "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.2",
-    "@poveste/controls": "^0.5.2",
-    "@poveste/shared": "^0.5.2",
-    "@poveste/vendors": "^0.5.2"
+    "@poveste/controls": "^0.6.0",
+    "@poveste/app": "^0.6.0",
+    "@poveste/shared": "^0.6.0",
+    "@poveste/vendors": "^0.6.0"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",