@moostjs/vite 0.6.42 → 0.6.43

package/README.md

@@ -222,6 +222,8 @@ The guard works in one direction only, and the runtime is not the only package t
 
 After the SSR build the plugin checks for exactly that: it compares the packages inlined into `dist/server` with the bare imports left in it and warns when any externalized package (or one of its transitive dependencies) depends on a bundled watched package — `moost` / `@moostjs/*` / `@wooksjs/*` / `wooks` / `@atscript/*` by default — naming the package and the fix. `ssrExternalCheck: { packages: ['some-registry-lib', '@acme/', /^my-lib-/] }` watches more (exact name, scope prefix, `RegExp`); `ssrExternalCheck: false` silences it. The symptoms of a split are `TypeError: Cannot read properties of undefined (reading 'headers')` (or any header name) from inside a composable, and an empty table where a managed view was declared — production only. Source-level tests share one module graph and cannot see it: verify on the installed build. Full explanation and a manual verification recipe: [SSR Bundle Size](https://moost.org/webapp/vite#ssr-bundle-size).
 
+**Dev server.** In `vite serve`, installed `moost` / `@moostjs/*` / `@wooksjs/*` are loaded natively by Node, so the app and any library importing them on its own (e.g. `@atscript/moost-db` resolving `MoostHttp` through DI) share one copy. Don't put the runtime in `ssr.noExternal` for dev, and list a linked workspace copy of it in `ssr.external`; the plugin warns at startup when a natively loaded package depends on a watched package Vite's SSR module runner inlines (same `ssrExternalCheck` option). Up to 0.6.42 such libraries failed with `Class is not Injectable` in dev unless listed in `ssr.noExternal` — drop that workaround after upgrading. Details: [Dev server: one runtime copy](https://moost.org/webapp/vite#dev-server-one-runtime-copy).
+
 ## SSR Local Fetch
 
 When `ssrFetch` is enabled (default: `true`), the plugin patches `globalThis.fetch` so that local paths are routed in-process through Moost instead of making a real HTTP request. This is useful for SSR where server-side code fetches from its own API:
@@ -249,26 +251,26 @@ The plugin injects a `__VITE_ID` decorator on `@Injectable` and `@Controller` cl
 
 ## Options
 
-| Option             | Type                                             | Default                | Description                                                                                                                                                                                                                                      |
-| ------------------ | ------------------------------------------------ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `entry`            | `string`                                         | —                      | Application entry file (required)                                                                                                                                                                                                                |
-| `port`             | `number`                                         | `3000`                 | Dev server port (backend mode only)                                                                                                                                                                                                              |
-| `host`             | `string`                                         | `'localhost'`          | Dev server host (backend mode only)                                                                                                                                                                                                              |
-| `outDir`           | `string`                                         | `'dist'`               | Build output directory (backend mode only)                                                                                                                                                                                                       |
-| `format`           | `'cjs' \| 'esm'`                                 | `'esm'`                | Output module format (backend mode only)                                                                                                                                                                                                         |
-| `sourcemap`        | `boolean`                                        | `true`                 | Generate source maps (both modes; in middleware mode applies to the `dist/server` SSR build)                                                                                                                                                     |
-| `externals`        | `boolean \| object`                              | `true`                 | Configure external dependencies (backend mode only)                                                                                                                                                                                              |
-| `onEject`          | `function`                                       | —                      | Hook to control DI instance ejection during HMR                                                                                                                                                                                                  |
-| `ssrFetch`         | `boolean`                                        | `true`                 | Enable local fetch interception for SSR                                                                                                                                                                                                          |
-| `middleware`       | `boolean`                                        | `false`                | Run Moost as Connect middleware (Vite serves frontend)                                                                                                                                                                                           |
-| `prefix`           | `string`                                         | `'/api'` (prod server) | URL prefix filter for middleware mode (e.g. `'/api'`); the production server defaults to `'/api'` when omitted                                                                                                                                   |
-| `ssrEntry`         | `string`                                         | —                      | Vue/React SSR entry module (e.g. `'/src/entry-server.ts'`)                                                                                                                                                                                       |
-| `ssrOutlet`        | `string`                                         | `'<!--ssr-outlet-->'`  | HTML placeholder for SSR-rendered content                                                                                                                                                                                                        |
-| `ssrState`         | `string`                                         | `'<!--ssr-state-->'`   | HTML placeholder for SSR state transfer script                                                                                                                                                                                                   |
-| `ssrHead`          | `string`                                         | `'<!--ssr-head-->'`    | HTML placeholder for SSR-rendered `<head>` tags (place inside `<head>`)                                                                                                                                                                          |
-| `serverEntry`      | `string`                                         | —                      | Custom production server entry file (e.g. `'./server.ts'`)                                                                                                                                                                                       |
-| `ssrExternal`      | `string[]`                                       | —                      | Packages to keep external in the SSR build (middleware mode, `vite build` only). Concatenated with `cfg.ssr.external`. See [SSR Bundle Size](#ssr-bundle-size).                                                                                  |
-| `ssrExternalCheck` | `boolean \| { packages?: (string \| RegExp)[] }` | `true`                 | Warn after the middleware-mode SSR build when an externalized package depends on a bundled shared-state package (`moost`, `@moostjs/*`, `wooks`, `@wooksjs/*`, `@atscript/*`); `packages` watches more. See [SSR Bundle Size](#ssr-bundle-size). |
+| Option             | Type                                             | Default                | Description                                                                                                                                                                                                                                                                                                                                                 |
+| ------------------ | ------------------------------------------------ | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `entry`            | `string`                                         | —                      | Application entry file (required)                                                                                                                                                                                                                                                                                                                           |
+| `port`             | `number`                                         | `3000`                 | Dev server port (backend mode only)                                                                                                                                                                                                                                                                                                                         |
+| `host`             | `string`                                         | `'localhost'`          | Dev server host (backend mode only)                                                                                                                                                                                                                                                                                                                         |
+| `outDir`           | `string`                                         | `'dist'`               | Build output directory (backend mode only)                                                                                                                                                                                                                                                                                                                  |
+| `format`           | `'cjs' \| 'esm'`                                 | `'esm'`                | Output module format (backend mode only)                                                                                                                                                                                                                                                                                                                    |
+| `sourcemap`        | `boolean`                                        | `true`                 | Generate source maps (both modes; in middleware mode applies to the `dist/server` SSR build)                                                                                                                                                                                                                                                                |
+| `externals`        | `boolean \| object`                              | `true`                 | Configure external dependencies (backend mode only)                                                                                                                                                                                                                                                                                                         |
+| `onEject`          | `function`                                       | —                      | Hook to control DI instance ejection during HMR                                                                                                                                                                                                                                                                                                             |
+| `ssrFetch`         | `boolean`                                        | `true`                 | Enable local fetch interception for SSR                                                                                                                                                                                                                                                                                                                     |
+| `middleware`       | `boolean`                                        | `false`                | Run Moost as Connect middleware (Vite serves frontend)                                                                                                                                                                                                                                                                                                      |
+| `prefix`           | `string`                                         | `'/api'` (prod server) | URL prefix filter for middleware mode (e.g. `'/api'`); the production server defaults to `'/api'` when omitted                                                                                                                                                                                                                                              |
+| `ssrEntry`         | `string`                                         | —                      | Vue/React SSR entry module (e.g. `'/src/entry-server.ts'`)                                                                                                                                                                                                                                                                                                  |
+| `ssrOutlet`        | `string`                                         | `'<!--ssr-outlet-->'`  | HTML placeholder for SSR-rendered content                                                                                                                                                                                                                                                                                                                   |
+| `ssrState`         | `string`                                         | `'<!--ssr-state-->'`   | HTML placeholder for SSR state transfer script                                                                                                                                                                                                                                                                                                              |
+| `ssrHead`          | `string`                                         | `'<!--ssr-head-->'`    | HTML placeholder for SSR-rendered `<head>` tags (place inside `<head>`)                                                                                                                                                                                                                                                                                     |
+| `serverEntry`      | `string`                                         | —                      | Custom production server entry file (e.g. `'./server.ts'`)                                                                                                                                                                                                                                                                                                  |
+| `ssrExternal`      | `string[]`                                       | —                      | Packages to keep external in the SSR build (middleware mode, `vite build` only). Concatenated with `cfg.ssr.external`. See [SSR Bundle Size](#ssr-bundle-size).                                                                                                                                                                                             |
+| `ssrExternalCheck` | `boolean \| { packages?: (string \| RegExp)[] }` | `true`                 | Warn after the middleware-mode SSR build when an externalized package depends on a bundled shared-state package (`moost`, `@moostjs/*`, `wooks`, `@wooksjs/*`, `@prostojs/infact`/`mate`, `@atscript/*`), and at dev-server startup when one depends on a package the SSR runner inlines; `packages` watches more. See [SSR Bundle Size](#ssr-bundle-size). |
 
 Options marked "backend mode only" are ignored when `middleware: true` — the user's `vite.config.ts` controls build/server configuration in middleware mode.
 

package/dist/index.cjs

@@ -142,6 +142,12 @@ function getExternals({ node, workspace }) {
 
 //#endregion
 //#region packages/vite/src/adapter-detector.ts
+/** Id prefix of the virtual modules re-exporting an adapter package (`virtual:moost-adapter/http`). */ const ADAPTER_VIRTUAL_PREFIX = "virtual:moost-adapter/";
+/** Source of a resolved (`\0`-prefixed) adapter virtual module, or `undefined` for any other id. */ function loadAdapterVirtualModule(id) {
+	if (!id.startsWith(`\0${ADAPTER_VIRTUAL_PREFIX}`)) return;
+	const adapter = id.slice(23);
+	return `export * from ${JSON.stringify(`@moostjs/event-${adapter}`)}\n`;
+}
 /**
 * Creates an adapter detector for a specific adapter type.
 * @param adapter
@@ -156,7 +162,7 @@ function getExternals({ node, workspace }) {
 		async init() {
 			this.detected = true;
 			const moduleId = `@moostjs/event-${adapter}`;
-			const module = this.ssrLoadModule ? await this.ssrLoadModule(moduleId) : await import(moduleId);
+			const module = this.ssrLoadModule ? await this.ssrLoadModule(`${ADAPTER_VIRTUAL_PREFIX}${adapter}`) : await import(moduleId);
 			const constructorName = `Moost${adapter.charAt(0).toUpperCase() + adapter.slice(1)}`;
 			getLogger().log(`🔍 Extracting Adapter "${constructorName}"`);
 			this.constructor = module[constructorName];
@@ -460,15 +466,24 @@ function constructorName(i) {
 	/^wooks($|\/)/
 ];
 /**
-* Packages the build check watches by default: the moost/wooks runtime plus the
-* `@atscript/*` family. All of them keep module-level state — Symbol slot keys,
-* DI/model registries, class identity used by `instanceof` — so a second copy
-* loaded by Node breaks lookups that the bundled copy filled in.
+* The `ssr.noExternal` entry the plugin always adds, so the `define:`
+* substitutions in `prod-server.mjs` land.
+*/ const PLUGIN_NO_EXTERNAL = /^@moostjs\/vite($|\/)/;
+/**
+* Packages the split checks watch by default: the moost/wooks runtime, the DI
+* and metadata containers under it (`@prostojs/infact`, `@prostojs/mate`) and
+* the `@atscript/*` family. All of them keep module-level state — Symbol slot
+* keys, DI/model registries, class identity used by `instanceof` — so a second
+* copy loaded by Node breaks lookups that the other copy filled in.
 *
 * This is deliberately wider than {@link RUNTIME_PACKAGE_PATTERNS}: the guard
-* that force-bundles packages covers the runtime only, while the check merely
-* reports what the output shows.
-*/ const SHARED_STATE_PACKAGE_PATTERNS = [...RUNTIME_PACKAGE_PATTERNS, /^@atscript\//];
+* that force-bundles packages covers the runtime only, while the checks merely
+* report what the build output / dev config shows.
+*/ const SHARED_STATE_PACKAGE_PATTERNS = [
+	...RUNTIME_PACKAGE_PATTERNS,
+	/^@prostojs\/(infact|mate)($|\/)/,
+	/^@atscript\//
+];
 function escapeRegExp(input) {
 	return input.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -596,22 +611,120 @@ function readPkgJson(dir) {
 	}
 	return found;
 }
-/** Human-readable build warning for {@link findSplitPackages} results. */ function formatSplitPackagesWarning(splits) {
-	const lines = splits.map((s) => {
+/** One warning line per split: the consumer, its external chain and its split deps (tagged `label`). */ function formatSplitLines(splits, label) {
+	return splits.map((s) => {
 		const chain = s.via.length > 0 ? ` (loaded via external ${s.via.join(" → ")})` : "";
-		const deps = s.splitDeps.map((d) => `${d} (bundled)`).join(", ");
+		const deps = s.splitDeps.map((d) => `${d} (${label})`).join(", ");
 		return `  - ${s.name}${chain} depends on ${deps}`;
 	});
+}
+/** Human-readable build warning for {@link findSplitPackages} results. */ function formatSplitPackagesWarning(splits) {
 	const direct = [...new Set(splits.map((s) => s.via.length > 0 ? s.via[0] : s.name))];
 	return [
 		"These externalized packages depend on packages that are bundled into dist/server, so Node will load a second copy of them from node_modules:",
-		...lines,
+		...formatSplitLines(splits, "bundled"),
 		"Two copies of a package split its module state — event-context slots, DI registries and class identity (instanceof) stop matching across the boundary, in production only. Symptoms: \"Cannot read properties of undefined (reading 'headers')\" inside a wooks composable, or a database adapter creating an empty table where a managed view was declared.",
 		`Fix: keep each shared package and everything that depends on it on the same side — add ${direct.map((d) => `'${d}'`).join(", ")} to ssr.noExternal (or drop them from ssr.external / ssrExternal), or externalize the whole family (for example every @atscript/* package, or the whole moost/wooks runtime) via ssr.external.`,
 		"Set ssrExternalCheck: false in moostVite() to silence this check, or ssrExternalCheck: { packages: [...] } to watch more packages."
 	].join("\n");
 }
 
+//#endregion
+//#region packages/vite/src/ssr-externals-dev-check.ts
+const toArray = (v) => Array.isArray(v) ? v : [v];
+/** A `noExternal` string entry is a glob over package names (`@acme/*`), as in Vite's filter. */ function globToRegExp(glob) {
+	const source = glob.split("**").map((part) => part.split("*").map((chunk) => escapeRegExp(chunk)).join("[^/]*")).join(".*");
+	return new RegExp(`^${source}$`);
+}
+/**
+* Whether Vite's dev SSR module runner evaluates its own copy of a package —
+* mirroring Vite's externalization rules for bare imports: listed in `external`
+* → external; matched by `noExternal` → inlined; otherwise external when it
+* resolves into `node_modules`, inlined when it is linked (a workspace package
+* outside `node_modules`). Packages that do not resolve from `root` count as
+* external — the runner never loads them.
+*/ function createDevInlineCheck(root, config) {
+	const { external = [], noExternal = [] } = config;
+	const noExternalPatterns = typeof noExternal === "boolean" ? [] : toArray(noExternal).map((p) => p instanceof RegExp ? p : globToRegExp(p));
+	const cache = /* @__PURE__ */ new Map();
+	const decide = (name) => {
+		if (external !== true && external.includes(name)) return false;
+		if (typeof noExternal === "boolean") return noExternal;
+		if (noExternalPatterns.some((re) => re.test(name))) return true;
+		if (external === true) return false;
+		const dir = findPackageDir(name, root);
+		return dir !== void 0 && !dir.replaceAll("\\", "/").includes("/node_modules/");
+	};
+	return (name) => {
+		let inlined = cache.get(name);
+		if (inlined === void 0) {
+			inlined = decide(name);
+			cache.set(name, inlined);
+		}
+		return inlined;
+	};
+}
+/** Package names `root` depends on directly, from every dependency group of its package.json. */ function rootDependencies(root) {
+	const pkg = readPkgJson(root);
+	if (!pkg) return [];
+	const names = /* @__PURE__ */ new Set();
+	for (const group of [
+		pkg.dependencies,
+		pkg.devDependencies,
+		pkg.peerDependencies,
+		pkg.optionalDependencies
+	]) for (const dep of Object.keys(group ?? {})) names.add(dep);
+	return [...names];
+}
+/** Is `entry` (a `noExternal` entry) the plugin's own (`PLUGIN_NO_EXTERNAL`)? */ const isPluginOwnEntry = (entry) => entry instanceof RegExp && entry.source === PLUGIN_NO_EXTERNAL.source;
+/**
+* The dev-server counterpart of {@link findSplitPackages}. In `vite serve` the
+* SSR module runner evaluates app code and every *inlined* dependency, while
+* Node loads every *externalized* one natively. When an external package
+* depends on a watched package the runner inlines (forced by `ssr.noExternal`,
+* or a linked workspace package), the two sides run separate copies of it —
+* the same split as in production, only in dev.
+*
+* The externals walked are the root package's direct dependencies the runner
+* does not inline (and their dependency trees). The plugin itself is always
+* loaded by Node and works on Node's `moost` (DI cleanup on reload, init
+* capture), so an inlined `moost` is reported against `@moostjs/vite` too.
+*
+* Skips the walk when nothing watched can be inlined: no `noExternal` entry
+* beyond the plugin's own, and no watched direct dependency that is linked.
+*/ function findDevSplitPackages(opts) {
+	const patterns = opts.patterns ?? SHARED_STATE_PACKAGE_PATTERNS;
+	const isInlined = createDevInlineCheck(opts.root, opts.config);
+	const isInlinedWatched = (name) => !PLUGIN_NO_EXTERNAL.test(name) && patterns.some((re) => re.test(name)) && isInlined(name);
+	const deps = rootDependencies(opts.root);
+	const { noExternal = [] } = opts.config;
+	if (!(noExternal === true || typeof noExternal !== "boolean" && toArray(noExternal).some((e) => !isPluginOwnEntry(e))) && !deps.some((dep) => isInlinedWatched(dep))) return [];
+	const found = findSplitPackages({
+		root: opts.root,
+		externalIds: deps.filter((dep) => !isInlined(dep)),
+		bundledPackages: { has: isInlinedWatched },
+		patterns
+	});
+	if (isInlined("moost") && findPackageDir("moost", opts.root)) found.unshift({
+		name: "@moostjs/vite",
+		via: [],
+		splitDeps: ["moost"]
+	});
+	return found;
+}
+/** Human-readable dev-server warning for {@link findDevSplitPackages} results. */ function formatDevSplitPackagesWarning(splits) {
+	const inlined = [...new Set(splits.flatMap((s) => s.splitDeps))];
+	const consumers = [...new Set(splits.map((s) => s.via.length > 0 ? s.via[0] : s.name).filter((n) => n !== "@moostjs/vite"))];
+	const addConsumers = consumers.length > 0 ? `, or add ${consumers.map((d) => `'${d}'`).join(", ")} to ssr.noExternal so the runner evaluates those as well` : "";
+	return [
+		"These packages are loaded natively by Node in dev, but depend on packages Vite's SSR module runner evaluates its own copy of (ssr.noExternal, or a linked workspace package):",
+		...formatSplitLines(splits, "inlined"),
+		"Two copies of a package split its module state — class identity (\"Class is not Injectable\" when a library resolves an adapter through DI), DI registries and event-context slots stop matching across the boundary.",
+		`Fix: let Vite externalize ${inlined.map((d) => `'${d}'`).join(", ")} in dev (remove it from ssr.noExternal; list a linked workspace package in ssr.external)${addConsumers}.`,
+		"Set ssrExternalCheck: false in moostVite() to silence this check."
+	].join("\n");
+}
+
 //#endregion
 //#region packages/vite/src/moost-vite.ts
 /**
@@ -682,6 +795,7 @@ function moostVite(options) {
 	const ssrOutlet = options.ssrOutlet || DEFAULT_SSR_OUTLET;
 	const ssrState = options.ssrState || DEFAULT_SSR_STATE;
 	const ssrHead = options.ssrHead || DEFAULT_SSR_HEAD;
+	const splitCheckPatterns = compilePackagePatterns(typeof options.ssrExternalCheck === "object" ? options.ssrExternalCheck.packages : void 0);
 	/**
 	* Boot-identity stamps (dev-only "mongrel state" diagnostic — a stale pipeline
 	* presents as security middleware silently switched off). `bootGeneration` is
@@ -846,9 +960,8 @@ function moostVite(options) {
 				}
 				const outDir = cfg.build?.outDir || "dist";
 				const isBuild = env.command === "build";
-				const ourPlugin = /^@moostjs\/vite($|\/)/;
 				const userNoExternal = cfg.ssr?.noExternal;
-				let ssrNoExternal = userNoExternal === true ? true : userNoExternal !== void 0 ? [...Array.isArray(userNoExternal) ? userNoExternal : [userNoExternal], ourPlugin] : isBuild ? true : [ourPlugin];
+				let ssrNoExternal = userNoExternal === true ? true : userNoExternal !== void 0 ? [...Array.isArray(userNoExternal) ? userNoExternal : [userNoExternal], PLUGIN_NO_EXTERNAL] : isBuild ? true : [PLUGIN_NO_EXTERNAL];
 				const userExternal = cfg.ssr?.external;
 				const ssrExternal = isBuild ? [...Array.isArray(userExternal) ? userExternal : [], ...options.ssrExternal ?? []] : void 0;
 				runtimeExternalized = (ssrExternal ?? []).some((e) => typeof e === "string" && RUNTIME_PACKAGE_PATTERNS.some((re) => re.test(e)));
@@ -939,7 +1052,7 @@ function moostVite(options) {
 				root: cfg.root,
 				externalIds,
 				bundledPackages,
-				patterns: compilePackagePatterns(typeof options.ssrExternalCheck === "object" ? options.ssrExternalCheck.packages : void 0)
+				patterns: splitCheckPatterns
 			});
 			if (splits.length > 0) cfg.logger.warn(`\n[${PLUGIN_NAME}] ${formatSplitPackagesWarning(splits)}\n`);
 		},
@@ -958,9 +1071,14 @@ function moostVite(options) {
 			return null;
 		},
 		resolveId(id) {
-			if (id === "virtual:vite-id") return "\0virtual:vite-id";
+			if (id === "virtual:vite-id" || id.startsWith(ADAPTER_VIRTUAL_PREFIX)) return `\0${id}`;
 		},
 		load(id) {
+			const adapterModule = loadAdapterVirtualModule(id);
+			if (adapterModule !== void 0) return {
+				code: adapterModule,
+				map: null
+			};
 			if (id === "\0virtual:vite-id") return {
 				code: `
           import { getMoostMate } from "moost";
@@ -1010,6 +1128,14 @@ function moostVite(options) {
 					await reloadPromise;
 				}
 			};
+			if (options.ssrExternalCheck !== false) {
+				const splits = findDevSplitPackages({
+					root: server.config.root,
+					config: server.environments.ssr.config.resolve,
+					patterns: splitCheckPatterns
+				});
+				if (splits.length > 0) server.config.logger.warn(`\n[${PLUGIN_NAME}] ${formatDevSplitPackagesWarning(splits)}\n`);
+			}
 			for (const adapter of adapters) adapter.ssrLoadModule = ssrImport;
 			await prepareBoot(EJECT_ALL);
 			await ssrImport(options.entry);

package/dist/index.d.ts

@@ -170,11 +170,15 @@ interface TMoostViteDevOptions {
      * (`vite serve`) is unaffected: Vite's default externalizer continues
      * to handle node_modules, which is required so CJS-only packages like
      * `@vue/server-renderer` can be loaded by Node's ESM/CJS interop
-     * instead of evaluated by Vite's ESM-only SSR module runner.
+     * instead of evaluated by Vite's ESM-only SSR module runner. It also keeps
+     * the moost/wooks runtime a single (Node-loaded) copy shared by app code and
+     * natively loaded dependencies — don't put the runtime in `ssr.noExternal`
+     * for dev.
      */
     ssrExternal?: string[];
     /**
-     * Verify the production SSR build for split shared-state packages.
+     * Verify the SSR module graph for split shared-state packages — in the
+     * production build and on the dev server.
      *
      * After the middleware-mode `vite build`, the plugin compares what ended up
      * inside `dist/server` (the bundled packages) with the bare imports left in
@@ -184,12 +188,18 @@ interface TMoostViteDevOptions {
      * and `instanceof` checks stop matching in production only — so the build
      * prints a warning naming the package and the fix.
      *
-     * Watched by default: `moost`, `@moostjs/*`, `wooks`, `@wooksjs/*` and
-     * `@atscript/*`. Pass `{ packages: [...] }` to watch more: an exact package
-     * name (`'lodash'`), a scope/prefix ending with `/` (`'@acme/'`), or a
-     * `RegExp`.
+     * On `vite serve` (both modes) the same walk runs against the dev SSR config:
+     * an externalized dependency (loaded natively by Node) that depends on a
+     * watched package the SSR module runner inlines — forced by `ssr.noExternal`,
+     * or a linked workspace package — gets a second copy in dev, and the server
+     * prints a warning at startup.
      *
-     * Default: `true`. Set `false` to silence the check.
+     * Watched by default: `moost`, `@moostjs/*`, `wooks`, `@wooksjs/*`,
+     * `@prostojs/infact`, `@prostojs/mate` and `@atscript/*`. Pass
+     * `{ packages: [...] }` to watch more: an exact package name (`'lodash'`), a
+     * scope/prefix ending with `/` (`'@acme/'`), or a `RegExp`.
+     *
+     * Default: `true`. Set `false` to silence both checks.
      */
     ssrExternalCheck?: boolean | TSSRExternalCheckOptions;
 }

package/dist/index.mjs

@@ -113,6 +113,12 @@ function getExternals({ node, workspace }) {
 
 //#endregion
 //#region packages/vite/src/adapter-detector.ts
+/** Id prefix of the virtual modules re-exporting an adapter package (`virtual:moost-adapter/http`). */ const ADAPTER_VIRTUAL_PREFIX = "virtual:moost-adapter/";
+/** Source of a resolved (`\0`-prefixed) adapter virtual module, or `undefined` for any other id. */ function loadAdapterVirtualModule(id) {
+	if (!id.startsWith(`\0${ADAPTER_VIRTUAL_PREFIX}`)) return;
+	const adapter = id.slice(23);
+	return `export * from ${JSON.stringify(`@moostjs/event-${adapter}`)}\n`;
+}
 /**
 * Creates an adapter detector for a specific adapter type.
 * @param adapter
@@ -127,7 +133,7 @@ function getExternals({ node, workspace }) {
 		async init() {
 			this.detected = true;
 			const moduleId = `@moostjs/event-${adapter}`;
-			const module = this.ssrLoadModule ? await this.ssrLoadModule(moduleId) : await import(moduleId);
+			const module = this.ssrLoadModule ? await this.ssrLoadModule(`${ADAPTER_VIRTUAL_PREFIX}${adapter}`) : await import(moduleId);
 			const constructorName = `Moost${adapter.charAt(0).toUpperCase() + adapter.slice(1)}`;
 			getLogger().log(`🔍 Extracting Adapter "${constructorName}"`);
 			this.constructor = module[constructorName];
@@ -431,15 +437,24 @@ function constructorName(i) {
 	/^wooks($|\/)/
 ];
 /**
-* Packages the build check watches by default: the moost/wooks runtime plus the
-* `@atscript/*` family. All of them keep module-level state — Symbol slot keys,
-* DI/model registries, class identity used by `instanceof` — so a second copy
-* loaded by Node breaks lookups that the bundled copy filled in.
+* The `ssr.noExternal` entry the plugin always adds, so the `define:`
+* substitutions in `prod-server.mjs` land.
+*/ const PLUGIN_NO_EXTERNAL = /^@moostjs\/vite($|\/)/;
+/**
+* Packages the split checks watch by default: the moost/wooks runtime, the DI
+* and metadata containers under it (`@prostojs/infact`, `@prostojs/mate`) and
+* the `@atscript/*` family. All of them keep module-level state — Symbol slot
+* keys, DI/model registries, class identity used by `instanceof` — so a second
+* copy loaded by Node breaks lookups that the other copy filled in.
 *
 * This is deliberately wider than {@link RUNTIME_PACKAGE_PATTERNS}: the guard
-* that force-bundles packages covers the runtime only, while the check merely
-* reports what the output shows.
-*/ const SHARED_STATE_PACKAGE_PATTERNS = [...RUNTIME_PACKAGE_PATTERNS, /^@atscript\//];
+* that force-bundles packages covers the runtime only, while the checks merely
+* report what the build output / dev config shows.
+*/ const SHARED_STATE_PACKAGE_PATTERNS = [
+	...RUNTIME_PACKAGE_PATTERNS,
+	/^@prostojs\/(infact|mate)($|\/)/,
+	/^@atscript\//
+];
 function escapeRegExp(input) {
 	return input.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -567,22 +582,120 @@ function readPkgJson(dir) {
 	}
 	return found;
 }
-/** Human-readable build warning for {@link findSplitPackages} results. */ function formatSplitPackagesWarning(splits) {
-	const lines = splits.map((s) => {
+/** One warning line per split: the consumer, its external chain and its split deps (tagged `label`). */ function formatSplitLines(splits, label) {
+	return splits.map((s) => {
 		const chain = s.via.length > 0 ? ` (loaded via external ${s.via.join(" → ")})` : "";
-		const deps = s.splitDeps.map((d) => `${d} (bundled)`).join(", ");
+		const deps = s.splitDeps.map((d) => `${d} (${label})`).join(", ");
 		return `  - ${s.name}${chain} depends on ${deps}`;
 	});
+}
+/** Human-readable build warning for {@link findSplitPackages} results. */ function formatSplitPackagesWarning(splits) {
 	const direct = [...new Set(splits.map((s) => s.via.length > 0 ? s.via[0] : s.name))];
 	return [
 		"These externalized packages depend on packages that are bundled into dist/server, so Node will load a second copy of them from node_modules:",
-		...lines,
+		...formatSplitLines(splits, "bundled"),
 		"Two copies of a package split its module state — event-context slots, DI registries and class identity (instanceof) stop matching across the boundary, in production only. Symptoms: \"Cannot read properties of undefined (reading 'headers')\" inside a wooks composable, or a database adapter creating an empty table where a managed view was declared.",
 		`Fix: keep each shared package and everything that depends on it on the same side — add ${direct.map((d) => `'${d}'`).join(", ")} to ssr.noExternal (or drop them from ssr.external / ssrExternal), or externalize the whole family (for example every @atscript/* package, or the whole moost/wooks runtime) via ssr.external.`,
 		"Set ssrExternalCheck: false in moostVite() to silence this check, or ssrExternalCheck: { packages: [...] } to watch more packages."
 	].join("\n");
 }
 
+//#endregion
+//#region packages/vite/src/ssr-externals-dev-check.ts
+const toArray = (v) => Array.isArray(v) ? v : [v];
+/** A `noExternal` string entry is a glob over package names (`@acme/*`), as in Vite's filter. */ function globToRegExp(glob) {
+	const source = glob.split("**").map((part) => part.split("*").map((chunk) => escapeRegExp(chunk)).join("[^/]*")).join(".*");
+	return new RegExp(`^${source}$`);
+}
+/**
+* Whether Vite's dev SSR module runner evaluates its own copy of a package —
+* mirroring Vite's externalization rules for bare imports: listed in `external`
+* → external; matched by `noExternal` → inlined; otherwise external when it
+* resolves into `node_modules`, inlined when it is linked (a workspace package
+* outside `node_modules`). Packages that do not resolve from `root` count as
+* external — the runner never loads them.
+*/ function createDevInlineCheck(root, config) {
+	const { external = [], noExternal = [] } = config;
+	const noExternalPatterns = typeof noExternal === "boolean" ? [] : toArray(noExternal).map((p) => p instanceof RegExp ? p : globToRegExp(p));
+	const cache = /* @__PURE__ */ new Map();
+	const decide = (name) => {
+		if (external !== true && external.includes(name)) return false;
+		if (typeof noExternal === "boolean") return noExternal;
+		if (noExternalPatterns.some((re) => re.test(name))) return true;
+		if (external === true) return false;
+		const dir = findPackageDir(name, root);
+		return dir !== void 0 && !dir.replaceAll("\\", "/").includes("/node_modules/");
+	};
+	return (name) => {
+		let inlined = cache.get(name);
+		if (inlined === void 0) {
+			inlined = decide(name);
+			cache.set(name, inlined);
+		}
+		return inlined;
+	};
+}
+/** Package names `root` depends on directly, from every dependency group of its package.json. */ function rootDependencies(root) {
+	const pkg = readPkgJson(root);
+	if (!pkg) return [];
+	const names = /* @__PURE__ */ new Set();
+	for (const group of [
+		pkg.dependencies,
+		pkg.devDependencies,
+		pkg.peerDependencies,
+		pkg.optionalDependencies
+	]) for (const dep of Object.keys(group ?? {})) names.add(dep);
+	return [...names];
+}
+/** Is `entry` (a `noExternal` entry) the plugin's own (`PLUGIN_NO_EXTERNAL`)? */ const isPluginOwnEntry = (entry) => entry instanceof RegExp && entry.source === PLUGIN_NO_EXTERNAL.source;
+/**
+* The dev-server counterpart of {@link findSplitPackages}. In `vite serve` the
+* SSR module runner evaluates app code and every *inlined* dependency, while
+* Node loads every *externalized* one natively. When an external package
+* depends on a watched package the runner inlines (forced by `ssr.noExternal`,
+* or a linked workspace package), the two sides run separate copies of it —
+* the same split as in production, only in dev.
+*
+* The externals walked are the root package's direct dependencies the runner
+* does not inline (and their dependency trees). The plugin itself is always
+* loaded by Node and works on Node's `moost` (DI cleanup on reload, init
+* capture), so an inlined `moost` is reported against `@moostjs/vite` too.
+*
+* Skips the walk when nothing watched can be inlined: no `noExternal` entry
+* beyond the plugin's own, and no watched direct dependency that is linked.
+*/ function findDevSplitPackages(opts) {
+	const patterns = opts.patterns ?? SHARED_STATE_PACKAGE_PATTERNS;
+	const isInlined = createDevInlineCheck(opts.root, opts.config);
+	const isInlinedWatched = (name) => !PLUGIN_NO_EXTERNAL.test(name) && patterns.some((re) => re.test(name)) && isInlined(name);
+	const deps = rootDependencies(opts.root);
+	const { noExternal = [] } = opts.config;
+	if (!(noExternal === true || typeof noExternal !== "boolean" && toArray(noExternal).some((e) => !isPluginOwnEntry(e))) && !deps.some((dep) => isInlinedWatched(dep))) return [];
+	const found = findSplitPackages({
+		root: opts.root,
+		externalIds: deps.filter((dep) => !isInlined(dep)),
+		bundledPackages: { has: isInlinedWatched },
+		patterns
+	});
+	if (isInlined("moost") && findPackageDir("moost", opts.root)) found.unshift({
+		name: "@moostjs/vite",
+		via: [],
+		splitDeps: ["moost"]
+	});
+	return found;
+}
+/** Human-readable dev-server warning for {@link findDevSplitPackages} results. */ function formatDevSplitPackagesWarning(splits) {
+	const inlined = [...new Set(splits.flatMap((s) => s.splitDeps))];
+	const consumers = [...new Set(splits.map((s) => s.via.length > 0 ? s.via[0] : s.name).filter((n) => n !== "@moostjs/vite"))];
+	const addConsumers = consumers.length > 0 ? `, or add ${consumers.map((d) => `'${d}'`).join(", ")} to ssr.noExternal so the runner evaluates those as well` : "";
+	return [
+		"These packages are loaded natively by Node in dev, but depend on packages Vite's SSR module runner evaluates its own copy of (ssr.noExternal, or a linked workspace package):",
+		...formatSplitLines(splits, "inlined"),
+		"Two copies of a package split its module state — class identity (\"Class is not Injectable\" when a library resolves an adapter through DI), DI registries and event-context slots stop matching across the boundary.",
+		`Fix: let Vite externalize ${inlined.map((d) => `'${d}'`).join(", ")} in dev (remove it from ssr.noExternal; list a linked workspace package in ssr.external)${addConsumers}.`,
+		"Set ssrExternalCheck: false in moostVite() to silence this check."
+	].join("\n");
+}
+
 //#endregion
 //#region packages/vite/src/moost-vite.ts
 /**
@@ -651,6 +764,7 @@ function moostVite(options) {
 	const ssrOutlet = options.ssrOutlet || DEFAULT_SSR_OUTLET;
 	const ssrState = options.ssrState || DEFAULT_SSR_STATE;
 	const ssrHead = options.ssrHead || DEFAULT_SSR_HEAD;
+	const splitCheckPatterns = compilePackagePatterns(typeof options.ssrExternalCheck === "object" ? options.ssrExternalCheck.packages : void 0);
 	/**
 	* Boot-identity stamps (dev-only "mongrel state" diagnostic — a stale pipeline
 	* presents as security middleware silently switched off). `bootGeneration` is
@@ -815,9 +929,8 @@ function moostVite(options) {
 				}
 				const outDir = cfg.build?.outDir || "dist";
 				const isBuild = env.command === "build";
-				const ourPlugin = /^@moostjs\/vite($|\/)/;
 				const userNoExternal = cfg.ssr?.noExternal;
-				let ssrNoExternal = userNoExternal === true ? true : userNoExternal !== void 0 ? [...Array.isArray(userNoExternal) ? userNoExternal : [userNoExternal], ourPlugin] : isBuild ? true : [ourPlugin];
+				let ssrNoExternal = userNoExternal === true ? true : userNoExternal !== void 0 ? [...Array.isArray(userNoExternal) ? userNoExternal : [userNoExternal], PLUGIN_NO_EXTERNAL] : isBuild ? true : [PLUGIN_NO_EXTERNAL];
 				const userExternal = cfg.ssr?.external;
 				const ssrExternal = isBuild ? [...Array.isArray(userExternal) ? userExternal : [], ...options.ssrExternal ?? []] : void 0;
 				runtimeExternalized = (ssrExternal ?? []).some((e) => typeof e === "string" && RUNTIME_PACKAGE_PATTERNS.some((re) => re.test(e)));
@@ -908,7 +1021,7 @@ function moostVite(options) {
 				root: cfg.root,
 				externalIds,
 				bundledPackages,
-				patterns: compilePackagePatterns(typeof options.ssrExternalCheck === "object" ? options.ssrExternalCheck.packages : void 0)
+				patterns: splitCheckPatterns
 			});
 			if (splits.length > 0) cfg.logger.warn(`\n[${PLUGIN_NAME}] ${formatSplitPackagesWarning(splits)}\n`);
 		},
@@ -927,9 +1040,14 @@ function moostVite(options) {
 			return null;
 		},
 		resolveId(id) {
-			if (id === "virtual:vite-id") return "\0virtual:vite-id";
+			if (id === "virtual:vite-id" || id.startsWith(ADAPTER_VIRTUAL_PREFIX)) return `\0${id}`;
 		},
 		load(id) {
+			const adapterModule = loadAdapterVirtualModule(id);
+			if (adapterModule !== void 0) return {
+				code: adapterModule,
+				map: null
+			};
 			if (id === "\0virtual:vite-id") return {
 				code: `
           import { getMoostMate } from "moost";
@@ -979,6 +1097,14 @@ function moostVite(options) {
 					await reloadPromise;
 				}
 			};
+			if (options.ssrExternalCheck !== false) {
+				const splits = findDevSplitPackages({
+					root: server.config.root,
+					config: server.environments.ssr.config.resolve,
+					patterns: splitCheckPatterns
+				});
+				if (splits.length > 0) server.config.logger.warn(`\n[${PLUGIN_NAME}] ${formatDevSplitPackagesWarning(splits)}\n`);
+			}
 			for (const adapter of adapters) adapter.ssrLoadModule = ssrImport;
 			await prepareBoot(EJECT_ALL);
 			await ssrImport(options.entry);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moostjs/vite",
-  "version": "0.6.42",
+  "version": "0.6.43",
   "description": "Vite Dev plugin for moostjs",
   "keywords": [
     "composables",
@@ -58,8 +58,8 @@
   "peerDependencies": {
     "sirv": "^3.0.0",
     "vite": "^8.0.0",
-    "@moostjs/event-http": "^0.6.42",
-    "moost": "^0.6.42"
+    "@moostjs/event-http": "^0.6.43",
+    "moost": "^0.6.43"
   },
   "peerDependenciesMeta": {
     "sirv": {