poveste 0.18.2 → 0.19.0

package/README.md

@@ -5,7 +5,9 @@
 Poveste builds a browsable *book* of stories from your components, powered by
 [Vite](https://vite.dev). It is a drop-in fork of
 [histoire](https://github.com/histoire-dev/histoire), covering Vue, Nuxt, Svelte,
-SvelteKit and Quasar — the last of which histoire does not support.
+SvelteKit and Quasar — the last of which histoire does not support. Solid and React
+are supported as renderers only: their stories render, and they have no controls
+panel.
 
 <img src="https://raw.githubusercontent.com/poveste-dev/poveste/main/screenshot.png" alt="A poveste book: the story list, a variant grid, and the controls panel" width="900">
 
@@ -18,6 +20,8 @@ pnpm i -D poveste @poveste/plugin-vue      # Vue 3
 pnpm i -D poveste @poveste/plugin-svelte   # Svelte 5 and SvelteKit
 pnpm i -D poveste @poveste/plugin-nuxt     # Nuxt 4
 pnpm i -D poveste @poveste/plugin-quasar   # Quasar
+pnpm i -D poveste @poveste/plugin-solid    # Solid, renderer only
+pnpm i -D poveste @poveste/plugin-react    # React 19, renderer only
 ```
 
 > **Installed an older version than you expected?** For about a day after a release, pnpm installs the previous one with no error and no hint, and for a plugin that's new in that release, its empty `0.0.1` placeholder. That's pnpm's release-age cooldown, not a broken publish. `package.json` keeps the old `^x.y.z`, so waiting doesn't fix it: install again with `npm`, with `--config.minimum-release-age=0` (kebab-case: pnpm 12.4 ignores the camelCase spelling), or with exact versions.

package/dist/node/bin.js

@@ -84,6 +84,7 @@ program.command('build')
 program.command('preview')
     .describe('preview the built directory')
     .option('-p, --port <port>', 'Listening port of the server')
+    .option('-c, --config <file>', `[string] use specified config file`)
     .option('--open', 'Open in your default browser')
     .option('--host [host]', '[string] specify hostname (omit value or pass `0.0.0.0` to expose to all network interfaces)')
     .action(async (options) => {

package/dist/node/collect/index.js

@@ -6,6 +6,7 @@ import { createPath } from '../tree.js';
 import { escapeRegExp } from '../util/escape-regexp.js';
 import { slash } from '../util/fs.js';
 import { globalsFromDefine } from './define-globals.js';
+import { strayLayoutKeys } from './layout-keys.js';
 import { createModuleServer } from './module-server.js';
 import { createPool } from './pool.js';
 import { INVALIDATE, INVALIDATE_ALL } from './task.js';
@@ -82,6 +83,9 @@ export function useCollectStories(options, ctx) {
                     }
                 }
             }
+            for (const stray of strayLayoutKeys(finalData.layout)) {
+                console.warn(pc.yellow(`⚠️  ${storyFile.path}: ${stray}`));
+            }
             if (!finalData.layout) {
                 finalData.layout = { type: 'single', iframe: true };
             }

package/dist/node/collect/layout-keys.d.ts

@@ -0,0 +1 @@
+export declare function strayLayoutKeys(layout: unknown): string[];

package/dist/node/collect/layout-keys.js

@@ -0,0 +1,33 @@
+/**
+ * The keys of a story's `layout` that its `type` does not read.
+ *
+ * `StoryLayout` is a union, and its two members spell one idea two ways:
+ * `iframe` on a single layout, `iframeGrid` on a grid. A key from the other
+ * member is carried through untouched and read by nothing, so
+ * `{ type: 'grid', iframe: false }` got iframes and nobody was told (#333).
+ */
+const READ_BY = {
+    single: ['iframe', 'isolate'],
+    grid: ['width', 'iframeGrid', 'isolate'],
+};
+/** What the author of a stray key meant, where the other layout has a key for it. */
+const MEANT = {
+    single: { iframeGrid: 'iframe' },
+    grid: { iframe: 'iframeGrid' },
+};
+export function strayLayoutKeys(layout) {
+    if (!layout || typeof layout !== 'object') {
+        return [];
+    }
+    const { type, ...rest } = layout;
+    const read = READ_BY[String(type)];
+    if (!read) {
+        return [`layout.type is ${JSON.stringify(type)}, and a layout is 'single' or 'grid'`];
+    }
+    return Object.keys(rest)
+        .filter(key => !read.includes(key))
+        .map((key) => {
+        const meant = MEANT[String(type)]?.[key];
+        return `layout.${key} is not read by a ${type} layout, so it does nothing${meant ? `: use ${meant}` : ''}`;
+    });
+}

package/dist/node/collect/logger.d.ts

@@ -0,0 +1,12 @@
+import type { Logger } from 'vite';
+/**
+ * The collection server's logger: `base`, less one message.
+ *
+ * Collection runs its modules in Node, through an environment Vite treats as a
+ * browser's. A package's Node build importing `node:http` is then reported as
+ * "externalized for browser compatibility", which is false of where it runs: 25
+ * lines from `ofetch` in a Nuxt book, reading as errors about a build that worked
+ * (#1203). The same line from the book's own server or build is about the
+ * browser, and is left alone.
+ */
+export declare function collectionLogger(base: Logger): Logger;

package/dist/node/collect/logger.js

@@ -0,0 +1,19 @@
+/**
+ * The collection server's logger: `base`, less one message.
+ *
+ * Collection runs its modules in Node, through an environment Vite treats as a
+ * browser's. A package's Node build importing `node:http` is then reported as
+ * "externalized for browser compatibility", which is false of where it runs: 25
+ * lines from `ofetch` in a Nuxt book, reading as errors about a build that worked
+ * (#1203). The same line from the book's own server or build is about the
+ * browser, and is left alone.
+ */
+export function collectionLogger(base) {
+    const quiet = (log) => (message, options) => {
+        if (!message.includes('has been externalized for browser compatibility')) {
+            log(message, options);
+        }
+    };
+    // Assigned onto `base`, not spread from it: `hasWarned` is state its own methods set.
+    return Object.assign(base, { warn: quiet(base.warn.bind(base)), warnOnce: quiet(base.warnOnce.bind(base)) });
+}

package/dist/node/collect/runner.js

@@ -122,7 +122,11 @@ class InteropEvaluator {
                 assigned = true;
             },
         };
-        const run = new AsyncFunction(ssrModuleExportsKey, ssrImportMetaKey, ssrImportKey, ssrDynamicImportKey, ssrExportAllKey, ssrExportNameKey, 'require', 'exports', 'module', '__filename', '__dirname', `"use strict";\n${code}`);
+        // In a block of its own, so a module's top-level `const require = createRequire(…)`
+        // or `const __dirname = …` shadows the parameter of that name. In the function's
+        // own scope it redeclared it, a syntax error that failed every story of the book
+        // (#1301). The closing brace goes on a new line: the code may end in a line comment.
+        const run = new AsyncFunction(ssrModuleExportsKey, ssrImportMetaKey, ssrImportKey, ssrDynamicImportKey, ssrExportAllKey, ssrExportNameKey, 'require', 'exports', 'module', '__filename', '__dirname', `"use strict";{\n${code}\n}`);
         await run(context[ssrModuleExportsKey], context[ssrImportMetaKey], context[ssrImportKey], context[ssrDynamicImportKey], context[ssrExportAllKey], context[ssrExportNameKey], createRequire(filename), cjsExports, moduleProxy, filename, dirname(filename));
     }
     async runExternalModule(file) {

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

@@ -7,11 +7,23 @@
  * neither the flag nor the mistake. A non-numeric value fails the same way.
  */
 export declare function resolvePort(value: unknown, command: string): number | undefined;
+type SocketOptions = Record<string, unknown>;
 /**
- * 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).
+ * The book server's HMR socket settings: whatever the merged config asked for,
+ * minus a port or server of its own, so Vite serves the socket on the book's port
+ * and the browser dials the page's own origin. Vite takes these from `server.ws`
+ * and from the deprecated `server.hmr` alike, so both are cleared.
+ *
+ * A socket on a second port was never routed on StackBlitz, which previews each
+ * port on its own hostname, so a page opened before collection ended waited for
+ * the list on a socket that never connected, and stayed blank (#1245). It is
+ * also how `@nuxt/vite-builder`'s 24678 default made two books collide (#221).
  */
-export declare function hmrPortFor(devPort: number | undefined): number;
+export declare function socketOnBookPort(server: {
+    hmr?: unknown;
+    ws?: unknown;
+}): {
+    hmr: SocketOptions;
+    ws: SocketOptions;
+};
+export {};

package/dist/node/commands/port.js

@@ -22,14 +22,24 @@ export function resolvePort(value, command) {
     }
     return port;
 }
+function withoutOwnPort(options) {
+    if (options === null || typeof options !== 'object') {
+        return {};
+    }
+    const { port: _port, server: _server, ...rest } = options;
+    return rest;
+}
 /**
- * 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).
+ * The book server's HMR socket settings: whatever the merged config asked for,
+ * minus a port or server of its own, so Vite serves the socket on the book's port
+ * and the browser dials the page's own origin. Vite takes these from `server.ws`
+ * and from the deprecated `server.hmr` alike, so both are cleared.
+ *
+ * A socket on a second port was never routed on StackBlitz, which previews each
+ * port on its own hostname, so a page opened before collection ended waited for
+ * the list on a socket that never connected, and stayed blank (#1245). It is
+ * also how `@nuxt/vite-builder`'s 24678 default made two books collide (#221).
  */
-export function hmrPortFor(devPort) {
-    const base = devPort ?? 6006;
-    return base < 45536 ? base + 20000 : base - 20000;
+export function socketOnBookPort(server) {
+    return { hmr: withoutOwnPort(server.hmr), ws: withoutOwnPort(server.ws) };
 }

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

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

package/dist/node/commands/preview.js

@@ -7,7 +7,11 @@ export async function previewCommand(options) {
     // run — so the teardown has to span the command, not one phase of it (#434).
     try {
         const port = resolvePort(options.port, 'preview');
+        // The same file the book was built with: `outDir` is read from it, and
+        // without it a book built with `--config` was looked for in the default
+        // directory and every path answered 404 (#1302).
         const ctx = await createContext({
+            configFile: options.config,
             mode: 'build',
         });
         for (const plugin of ctx.config.plugins) {

package/dist/node/config-validation.d.ts

@@ -11,7 +11,7 @@
  * model the whole surface. Only options whose wrong type fails *inside someone
  * else's code* are listed — the rest fail legibly on their own.
  */
-export type ConfigKind = 'string' | 'boolean' | 'number' | 'string[]' | 'array' | 'object' | 'function';
+export type ConfigKind = 'string' | 'boolean' | 'number' | 'string[]' | 'array' | 'object' | 'function' | 'null';
 /** What the value actually is, in the words the message uses. */
 export declare function describeKind(value: unknown): string;
 export declare function configProblems(config: unknown, configFile: string): string[];

package/dist/node/config-validation.js

@@ -11,6 +11,13 @@ const RULES = [
     { path: 'defaultBackgroundColor', kind: 'string' },
     { path: 'sandboxDarkClass', kind: 'string' },
     { path: 'responsivePresets', kind: 'array' },
+    { path: 'preview', kind: 'object' },
+    { path: 'preview.backgroundColor', kind: 'string' },
+    { path: 'preview.responsiveWidth', kind: ['number', 'null'] },
+    { path: 'preview.responsiveHeight', kind: ['number', 'null'] },
+    { path: 'preview.rotate', kind: 'boolean' },
+    { path: 'preview.checkerboard', kind: 'boolean' },
+    { path: 'preview.textDirection', kind: 'string' },
     { path: 'backgroundPresets', kind: 'array' },
     { path: 'theme.title', kind: 'string' },
     { path: 'theme.lang', kind: 'string' },
@@ -26,6 +33,9 @@ const RULES = [
 ];
 /** What the value actually is, in the words the message uses. */
 export function describeKind(value) {
+    if (value === null) {
+        return 'null';
+    }
     if (Array.isArray(value)) {
         return value.every(item => typeof item === 'string') ? 'string[]' : 'array';
     }
@@ -47,6 +57,8 @@ function matches(value, kind) {
             return typeof value === 'number';
         case 'function':
             return typeof value === 'function';
+        case 'null':
+            return value === null;
         default:
             return false;
     }

package/dist/node/config.d.ts

@@ -7,6 +7,7 @@ export declare function loadConfigFile(configFile: string): Promise<Partial<Pove
 export declare const mergeBuildConfig: import("defu").DefuFn;
 export declare const mergeConfig: import("defu").DefuFn;
 export declare function resolveConfig(cwd: string | undefined, mode: ConfigMode, configFile?: string): Promise<PovesteConfig>;
+export declare function processDefaultConfig(defaultConfig: PovesteConfig, preUserConfig: Partial<PovesteConfig>, mode: ConfigMode, _cwd: string): Promise<PovesteConfig>;
 export declare function processConfig(ctx: Context): Promise<void>;
 export declare function defineConfig(config: Partial<PovesteConfig>): Partial<PovesteConfig>;
 declare module 'vite' {

package/dist/node/config.js

@@ -325,13 +325,18 @@ async function resolveConfigPlugins(config, mode) {
     }
     return config;
 }
-async function processDefaultConfig(defaultConfig, preUserConfig, mode, _cwd) {
+export async function processDefaultConfig(defaultConfig, preUserConfig, mode, _cwd) {
     // Apply plugins
     for (const plugin of [...defaultConfig.plugins, ...preUserConfig.plugins ?? []]) {
         if (plugin.defaultConfig) {
             const result = await plugin.defaultConfig(defaultConfig, mode);
             if (result) {
-                defaultConfig = mergeOnto(result, defaultConfig);
+                // A plugin's story globs add to the defaults: a Solid plugin declaring
+                // `.story.tsx` must not drop `.story.vue` from a book that has both. Only
+                // here. A user's `storyMatch` still replaces, since narrowing is a
+                // legitimate use (#1124).
+                const storyMatch = result.storyMatch && [...new Set([...defaultConfig.storyMatch, ...result.storyMatch])];
+                defaultConfig = mergeOnto(storyMatch ? { ...result, storyMatch } : result, defaultConfig);
             }
         }
     }

package/dist/node/dev-event.d.ts

@@ -0,0 +1,23 @@
+import type { Plugin } from '@poveste/shared';
+/**
+ * Asks each plugin with an `onDevEvent` in turn, and returns the first answer
+ * to an event that wants one. An `on…` event goes to every plugin and answers
+ * nothing.
+ *
+ * A plugin that throws is logged under its name and skipped. Left to the
+ * listener, the rejection went unhandled and exited `poveste dev` (#1170).
+ */
+export declare function answerDevEvent(plugins: Plugin[], event: string, ask: (plugin: Plugin) => unknown): Promise<unknown>;
+export interface DevCommandResult {
+    id: string;
+    error?: string;
+}
+/**
+ * Runs a command's server half and always reports back. Left to the listener, a
+ * `serverAction` that threw (a story file that already exists, a path with no
+ * directory) went unhandled and exited `poveste dev` (#1176).
+ */
+export declare function runDevCommand(commands: {
+    id: string;
+    serverAction?: (params: any) => unknown;
+}[], id: string, params: unknown): Promise<DevCommandResult>;

package/dist/node/dev-event.js

@@ -0,0 +1,42 @@
+import pc from 'picocolors';
+/**
+ * Asks each plugin with an `onDevEvent` in turn, and returns the first answer
+ * to an event that wants one. An `on…` event goes to every plugin and answers
+ * nothing.
+ *
+ * A plugin that throws is logged under its name and skipped. Left to the
+ * listener, the rejection went unhandled and exited `poveste dev` (#1170).
+ */
+export async function answerDevEvent(plugins, event, ask) {
+    for (const plugin of plugins) {
+        if (!plugin.onDevEvent) {
+            continue;
+        }
+        try {
+            const result = await ask(plugin);
+            if (!event.startsWith('on') && result !== undefined) {
+                return result;
+            }
+        }
+        catch (error) {
+            console.error(pc.red(`[Plugin:${plugin.name}]`), `onDevEvent threw on "${event}":`, error);
+        }
+    }
+    return undefined;
+}
+/**
+ * Runs a command's server half and always reports back. Left to the listener, a
+ * `serverAction` that threw (a story file that already exists, a path with no
+ * directory) went unhandled and exited `poveste dev` (#1176).
+ */
+export async function runDevCommand(commands, id, params) {
+    const command = commands.find(c => c.id === id);
+    try {
+        await command?.serverAction?.(params);
+        return { id };
+    }
+    catch (error) {
+        console.error(pc.red(`[poveste] command "${id}" failed:`), error);
+        return { id, error: error instanceof Error ? error.message : String(error) };
+    }
+}

package/dist/node/index.d.ts

@@ -1,6 +1,6 @@
 export { onPovesteCleanup } from './cleanup.js';
 export { defaultColors } from './colors.js';
-export * from './config.js';
+export { configFileNames, defineConfig, getDefaultConfig, loadConfigFile, mergeBuildConfig, mergeConfig, processConfig, resolveConfig, resolveConfigFile, } from './config.js';
 export * from './plugin.js';
 export { getInjectedImport } from './util/vendors.js';
 export * from '@poveste/shared';

package/dist/node/index.js

@@ -2,7 +2,9 @@
 // vendored copies of Vue and the controls from inside that generated code.
 export { onPovesteCleanup } from './cleanup.js';
 export { defaultColors } from './colors.js';
-export * from './config.js';
+// Named, not `export *`: an `export` added to config.ts so a spec can reach a
+// helper would otherwise publish it (#1291).
+export { configFileNames, defineConfig, getDefaultConfig, loadConfigFile, mergeBuildConfig, mergeConfig, processConfig, resolveConfig, resolveConfigFile, } from './config.js';
 export * from './plugin.js';
 export { getInjectedImport } from './util/vendors.js';
 export * from '@poveste/shared';

package/dist/node/server.js

@@ -2,7 +2,8 @@ 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 { socketOnBookPort } from './commands/port.js';
+import { answerDevEvent } from './dev-event.js';
 import { useModuleLoader } from './load.js';
 import { createMarkdownFilesWatcher, onMarkdownFileChange, onMarkdownListChange } from './markdown.js';
 import { DevEventPluginApi, DevPluginApi } from './plugin.js';
@@ -42,14 +43,19 @@ async function startServer(ctx, options, onOpen, close) {
             serverConfig.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).
-            serverConfig.hmr = { port: hmrPortFor(options.port ?? serverConfig.port) };
+            // On the book's own port, never a second one: StackBlitz does not route
+            // it, and `@nuxt/vite-builder`'s default collides between books (#1245,
+            // #221). Post-ordered, because that default is filled in by Nuxt's own
+            // `config` hook.
+            viteConfig.plugins = [...viteConfig.plugins ?? [], {
+                    name: 'poveste:socket-on-book-port',
+                    config: {
+                        order: 'post',
+                        handler(config) {
+                            config.server = { ...config.server, ...socketOnBookPort(config.server ?? {}) };
+                        },
+                    },
+                }];
             if (options.open) {
                 serverConfig.open = true;
             }
@@ -97,15 +103,10 @@ async function startServer(ctx, options, onOpen, close) {
     }
     // Custom dev events
     server.ws.on(`poveste:dev-event`, async ({ event, payload }) => {
-        for (const plugin of ctx.config.plugins) {
-            if (plugin.onDevEvent) {
-                const api = new DevEventPluginApi(ctx, plugin, moduleLoader, event, payload, watches);
-                const result = await plugin.onDevEvent(api);
-                if (!event.startsWith('on') && result !== undefined) {
-                    server.ws.send(`poveste:dev-event-result`, { event, result });
-                    break;
-                }
-            }
+        const result = await answerDevEvent(ctx.config.plugins, event, plugin => plugin.onDevEvent?.(new DevEventPluginApi(ctx, plugin, moduleLoader, event, payload, watches)));
+        // Sent even when nothing answered, so the client's promise settles.
+        if (!event.startsWith('on')) {
+            server.ws.send(`poveste:dev-event-result`, { event, result });
         }
     });
     // Wait for pre-bundling (in `listen()`)

package/dist/node/vendors.d.ts

@@ -37,8 +37,14 @@ export declare function vendoredAliases(dependencies: Record<string, string> | u
  * is the point: `poveste` has no `semver` dependency, a patch release is the wrong
  * place to add one, and a hand-rolled `satisfies` that silently mis-handles a form it
  * was never given is the failure this repo keeps producing. So `^X.Y.Z` with a major
- * of at least 1 is answered, and `^0.x`, a prerelease, a comparator set or anything
- * else returns false and leaves the chrome on the copy it can certainly run.
+ * of at least 1 is answered, and `^0.x`, a comparator set or anything else returns
+ * false and leaves the chrome on the copy it can certainly run.
+ *
+ * A prerelease is answered too, though npm's own caret leaves one out. Refusing it
+ * left the chrome on the vendored Vue while pinia's bare `vue` took the project's
+ * prerelease, which is #1060's split, and the book rendered no story (#1163). So a
+ * prerelease counts when its `X.Y.Z` is above the floor in the same major. One of the
+ * floor itself sorts below the floor, and is refused.
  */
 export declare function satisfiesCaret(version: string | undefined, range: string | undefined): boolean;
 /**

package/dist/node/vendors.js

@@ -69,17 +69,24 @@ export function vendoredAliases(dependencies) {
  * is the point: `poveste` has no `semver` dependency, a patch release is the wrong
  * place to add one, and a hand-rolled `satisfies` that silently mis-handles a form it
  * was never given is the failure this repo keeps producing. So `^X.Y.Z` with a major
- * of at least 1 is answered, and `^0.x`, a prerelease, a comparator set or anything
- * else returns false and leaves the chrome on the copy it can certainly run.
+ * of at least 1 is answered, and `^0.x`, a comparator set or anything else returns
+ * false and leaves the chrome on the copy it can certainly run.
+ *
+ * A prerelease is answered too, though npm's own caret leaves one out. Refusing it
+ * left the chrome on the vendored Vue while pinia's bare `vue` took the project's
+ * prerelease, which is #1060's split, and the book rendered no story (#1163). So a
+ * prerelease counts when its `X.Y.Z` is above the floor in the same major. One of the
+ * floor itself sorts below the floor, and is refused.
  */
 export function satisfiesCaret(version, range) {
     const wanted = /^\^(\d+)\.(\d+)\.(\d+)$/.exec(range ?? '');
-    const have = /^(\d+)\.(\d+)\.(\d+)$/.exec(version ?? '');
+    const have = /^(\d+)\.(\d+)\.(\d+)(-[0-9A-Z.-]+)?$/i.exec(version ?? '');
     if (!wanted || !have) {
         return false;
     }
     const [wantedMajor, wantedMinor, wantedPatch] = wanted.slice(1).map(Number);
-    const [major, minor, patch] = have.slice(1).map(Number);
+    const [major, minor, patch] = have.slice(1, 4).map(Number);
+    const prerelease = have[4] !== undefined;
     // `^0.x` narrows to the minor, and no vendored range uses it. Refuse rather than
     // implement a rule nothing here exercises.
     if (wantedMajor === 0 || wantedMajor === undefined || major === undefined) {
@@ -91,7 +98,7 @@ export function satisfiesCaret(version, range) {
     if (minor !== wantedMinor) {
         return minor > wantedMinor;
     }
-    return patch >= wantedPatch;
+    return prerelease ? patch > wantedPatch : patch >= wantedPatch;
 }
 /**
  * Points the chrome's Vue at the project's, when they are two copies.

package/dist/node/virtual/resolved-stories.js

@@ -33,19 +33,37 @@ ${resolvedStories.map((file, index) => {
 export let files = [${files.map(file => `{${JSON.stringify(file).slice(1, -1)}, component: Comp${file.index}, source: () => import(${jsString(`virtual:story-source:${file.story.id}`)})}`).join(',\n')}]
 export let tree = ${JSON.stringify(makeTree(ctx.config, resolvedStories))}
 export let generation = ${storiesGeneration.get(ctx) ?? 0}
-const handlers = []
+// Every copy of this module on a page shares these. A page can hold two: each
+// importer's URL is stamped when the server serves it, so a list that changes
+// between two of them gives each its own copy, and the one evaluated last takes
+// over the hot update. Kept per copy, the handlers stayed with the other one, and
+// the page applied every update to a list nobody was watching (#1237).
+const shared = import.meta.hot
+  ? (import.meta.hot.data.shared ??= { handlers: [], generation: -Infinity, files, tree })
+  : { handlers: [], generation, files, tree }
+if (generation > shared.generation) {
+  const announce = shared.generation !== -Infinity
+  Object.assign(shared, { generation, files, tree })
+  if (announce) {
+    shared.handlers.forEach(h => h(files, tree))
+  }
+}
 export function onUpdate (cb) {
-  handlers.push(cb)
+  shared.handlers.push(cb)
+  // Registered through a copy the page has already moved past.
+  if (shared.generation > generation) {
+    cb(shared.files, shared.tree)
+  }
 }
 if (import.meta.hot) {
   import.meta.hot.accept(newModule => {
+    // Undefined when the new copy failed to load. The next update carries the list.
+    if (!newModule) {
+      return
+    }
     files = newModule.files
     tree = newModule.tree
     generation = newModule.generation
-    handlers.forEach(h => {
-      h(newModule.files, newModule.tree)
-      newModule.onUpdate(h)
-    })
   })
 }`;
 }

package/dist/node/vite.js

@@ -2,8 +2,10 @@ 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, searchForWorkspaceRoot, } from 'vite';
+import { createLogger, loadConfigFromFile as loadViteConfigFromFile, mergeConfig as mergeViteConfig, normalizePath, searchForWorkspaceRoot, } from 'vite';
 import { APP_PATH, TEMP_PATH } from './alias.js';
+import { collectionLogger } from './collect/logger.js';
+import { runDevCommand } from './dev-event.js';
 import { createMarkdownPlugins } from './markdown.js';
 import { optimizeEntries } from './optimize-entries.js';
 import { notifyStoryChange } from './stories.js';
@@ -146,6 +148,13 @@ export async function getViteConfigWithPlugins(isServer, ctx) {
     }
     plugins.push({
         name: 'poveste-vite-plugin',
+        // Only the core knows which files a book's `storyMatch` makes stories, and a
+        // framework plugin may compile those differently from the components they
+        // import (#1164). Not on `this.meta`: a Rolldown build does not carry what
+        // `options()` sets there into `transform`.
+        api: {
+            isStoryFile: (id) => ctx.storyFiles.some(file => normalizePath(file.path) === id),
+        },
         config(_, { command }) {
             const collapsedVue = isServer || process.env['POVESTE_DEV'] ? {} : collapseVendoredVue({ root: ctx.root });
             return {
@@ -375,11 +384,8 @@ export async function getViteConfigWithPlugins(isServer, ctx) {
         plugins.push({
             name: 'poveste:dev-commands',
             configureServer(server) {
-                server.ws.on('poveste:dev-command', ({ id, params }) => {
-                    const command = ctx.registeredCommands.find(c => c.id === id);
-                    if (command?.serverAction) {
-                        command.serverAction(params);
-                    }
+                server.ws.on('poveste:dev-command', async ({ id, params }) => {
+                    server.ws.send('poveste:dev-command-result', await runDevCommand(ctx.registeredCommands, id, params));
                 });
             },
         });
@@ -447,6 +453,11 @@ export async function getViteConfigWithPlugins(isServer, ctx) {
         configFile: false,
         plugins,
     });
+    if (isServer) {
+        viteConfig.customLogger = collectionLogger(viteConfig.customLogger ?? createLogger(viteConfig.logLevel, {
+            ...viteConfig.clearScreen === undefined ? {} : { allowClearScreen: viteConfig.clearScreen },
+        }));
+    }
     return {
         viteConfig,
         viteConfigFile: userViteConfigFile?.path ?? null,

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "poveste",
   "type": "module",
-  "version": "0.18.2",
-  "description": "Interactive component playgrounds for Vue, Nuxt, Svelte, SvelteKit and Quasar, plus Solid (renderer only) — a drop-in fork of histoire, with Quasar support histoire does not ship.",
+  "version": "0.19.0",
+  "description": "Interactive component playgrounds for Vue, Nuxt, Svelte, SvelteKit and Quasar, plus Solid and React (renderer only) — a drop-in fork of histoire, with Quasar support histoire does not ship.",
   "author": {
     "name": "Sorin Gitlan",
     "url": "https://x.com/50rayn"
@@ -31,6 +31,7 @@
     "sveltekit",
     "solid",
     "solidjs",
+    "react",
     "cli"
   ],
   "publishConfig": {
@@ -77,10 +78,10 @@
   },
   "dependencies": {
     "@11ty/gray-matter": "^3.0.0",
-    "@poveste/app": "^0.18.2",
-    "@poveste/controls": "^0.18.2",
-    "@poveste/shared": "^0.18.2",
-    "@poveste/vendors": "^0.18.2",
+    "@poveste/app": "^0.19.0",
+    "@poveste/controls": "^0.19.0",
+    "@poveste/shared": "^0.19.0",
+    "@poveste/vendors": "^0.19.0",
     "change-case": "^5.4.4",
     "chokidar": "^5.0.0",
     "defu": "^6.1.4",