poveste 0.19.0 → 0.19.1

package/README.md

@@ -16,17 +16,17 @@ panel.
 Install `poveste` alongside the plugin for your framework:
 
 ```shell
-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
+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-vue @poveste/plugin-nuxt     # Nuxt 4
+pnpm i -D poveste @poveste/plugin-vue @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.
 
-Then create a `poveste.config.ts` in your project root:
+Then create a `poveste.config.ts` in your project root. For a Vue project it is this:
 
 ```ts
 import { HstVue } from '@poveste/plugin-vue'
@@ -39,6 +39,8 @@ export default defineConfig({
 })
 ```
 
+Every other framework uses its own plugin, and Quasar also needs a setup file, so take the config from its guide: [Svelte](https://poveste.dev/guide/svelte/getting-started), [SvelteKit](https://poveste.dev/guide/sveltekit/getting-started), [Nuxt](https://poveste.dev/guide/nuxt/getting-started), [Quasar](https://poveste.dev/guide/quasar/getting-started), [Solid](https://poveste.dev/guide/solid/getting-started) or [React](https://poveste.dev/guide/react/getting-started).
+
 ## Commands
 
 | | |

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

@@ -30,5 +30,12 @@ export type Invoke = (name: string, data: unknown[]) => Promise<unknown>;
  * that branch, and no id or file in either book carried the prefix.
  */
 export declare function filenameOf(module: Readonly<EvaluatedModuleNode>, root: string): string;
+/**
+ * The keys an externalised module added to `globalThis` when Node ran it. Node
+ * caches that module, so once a worker's reset deletes them nothing installs them
+ * again. Vue's development build sets `__VUE_HMR_RUNTIME__` this way, and a story
+ * compiled with HMR code reads it at its top level (#1320).
+ */
+export declare const globalsFromExternals: Set<string>;
 /** A runner over a module server, reached through `invoke`. `root` is the Vite root. */
 export declare function createRunner(invoke: Invoke, root: string, evaluatedModules?: EvaluatedModules): ModuleRunner;

package/dist/node/collect/runner.js

@@ -67,6 +67,25 @@ export function filenameOf(module, root) {
     }
     return join(root, 'virtual-module');
 }
+/**
+ * The keys an externalised module added to `globalThis` when Node ran it. Node
+ * caches that module, so once a worker's reset deletes them nothing installs them
+ * again. Vue's development build sets `__VUE_HMR_RUNTIME__` this way, and a story
+ * compiled with HMR code reads it at its top level (#1320).
+ */
+export const globalsFromExternals = new Set();
+const ranExternals = new Set();
+async function importRecordingGlobals(file) {
+    const before = new Set(Object.keys(globalThis));
+    const imported = await import(file);
+    ranExternals.add(file);
+    for (const key of Object.keys(globalThis)) {
+        if (!before.has(key)) {
+            globalsFromExternals.add(key);
+        }
+    }
+    return imported;
+}
 /** As vite-node did: a CJS package's named exports are read through its default. */
 class InteropEvaluator {
     root;
@@ -130,7 +149,7 @@ class InteropEvaluator {
         await run(context[ssrModuleExportsKey], context[ssrImportMetaKey], context[ssrImportKey], context[ssrDynamicImportKey], context[ssrExportAllKey], context[ssrExportNameKey], createRequire(filename), cjsExports, moduleProxy, filename, dirname(filename));
     }
     async runExternalModule(file) {
-        const imported = await import(file);
+        const imported = ranExternals.has(file) ? await import(file) : await importRecordingGlobals(file);
         if (file.endsWith('.mjs') || !('default' in imported)) {
             return imported;
         }

package/dist/node/collect/worker.js

@@ -6,7 +6,7 @@ import pc from 'picocolors';
 import { EvaluatedModules } from 'vite/module-runner';
 import { createDomEnv, resetDomEnv } from '../dom/env.js';
 import { invokeOver } from './rpc.js';
-import { createRunner } from './runner.js';
+import { createRunner, globalsFromExternals } from './runner.js';
 import { serveTasks } from './task.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const _evaluatedModules = new EvaluatedModules();
@@ -63,7 +63,7 @@ async function collect(payload) {
     // belongs to one server, so every task it is sent carries that server's root.
     const runner = _runner ?? (_runner = createRunner((name, data) => _invoke(name, data), payload.root, _evaluatedModules));
     if (_domEnv) {
-        resetDomEnv(_domEnv);
+        resetDomEnv(_domEnv, globalsFromExternals);
     }
     else {
         _domEnv = createDomEnv();

package/dist/node/dom/env.d.ts

@@ -6,4 +6,4 @@ export declare function createDomEnv(): {
     storages: Storage[];
 };
 /** Returns a reused environment to the state a fresh one would have been in. */
-export declare function resetDomEnv(env: Pick<ReturnType<typeof createDomEnv>, 'window' | 'pristineKeys' | 'storages'>): void;
+export declare function resetDomEnv(env: Pick<ReturnType<typeof createDomEnv>, 'window' | 'pristineKeys' | 'storages'>, kept?: ReadonlySet<string>): void;

package/dist/node/dom/env.js

@@ -134,7 +134,7 @@ export function createDomEnv() {
     };
 }
 /** Returns a reused environment to the state a fresh one would have been in. */
-export function resetDomEnv(env) {
+export function resetDomEnv(env, kept = new Set()) {
     const doc = env.window.document;
     for (const el of [doc.documentElement, doc.head, doc.body]) {
         if (!el)
@@ -149,8 +149,9 @@ export function resetDomEnv(env) {
         storage.clear();
     }
     // Additions only: the modules that installed the rest are cached, not re-run.
+    // So are the ones that installed `kept`, after this environment was made.
     for (const key of Object.keys(globalThis)) {
-        if (!env.pristineKeys.has(key)) {
+        if (!env.pristineKeys.has(key) && !kept.has(key)) {
             delete globalThis[key];
         }
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "poveste",
   "type": "module",
-  "version": "0.19.0",
+  "version": "0.19.1",
   "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",
@@ -78,10 +78,10 @@
   },
   "dependencies": {
     "@11ty/gray-matter": "^3.0.0",
-    "@poveste/app": "^0.19.0",
-    "@poveste/controls": "^0.19.0",
-    "@poveste/shared": "^0.19.0",
-    "@poveste/vendors": "^0.19.0",
+    "@poveste/app": "^0.19.1",
+    "@poveste/controls": "^0.19.1",
+    "@poveste/shared": "^0.19.1",
+    "@poveste/vendors": "^0.19.1",
     "change-case": "^5.4.4",
     "chokidar": "^5.0.0",
     "defu": "^6.1.4",