@vercube/vite 1.1.0 → 1.1.2

package/README.md

@@ -73,12 +73,25 @@ node dist/index.mjs   # runs the built server
 
 ## Options
 
-| Option      | Type       | Default         | Description                                                                                                       |
-| ----------- | ---------- | --------------- | ----------------------------------------------------------------------------------------------------------------- |
-| `rootDir`   | `string`   | Vite `root`     | Project root used to resolve `scanDirs` and `setupFile`.                                                          |
-| `scanDirs`  | `string[]` | `['src']`       | Directories scanned (recursively) for `@Controller` and `@Injectable` classes.                                    |
-| `setupFile` | `string`   | `undefined`     | Module whose default export `(app: App) => void \| Promise<void>` runs as `createApp`'s setup hook (before init). |
-| `runner`    | `string`   | `'node-worker'` | The `env-runner` runner used to execute server code in dev.                                                       |
+| Option       | Type                   | Default         | Description                                                                                                       |
+| ------------ | ---------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------- |
+| `rootDir`    | `string`               | Vite `root`     | Project root used to resolve `scanDirs` and `setupFile`.                                                          |
+| `scanDirs`   | `string[]`             | `['src']`       | Directories scanned (recursively) for `@Controller` and `@Injectable` classes.                                    |
+| `setupFile`  | `string`               | `undefined`     | Module whose default export `(app: App) => void \| Promise<void>` runs as `createApp`'s setup hook (before init). |
+| `runner`     | `string`               | `'node-worker'` | The `env-runner` runner used to execute server code in dev.                                                       |
+| `noExternal` | `(string \| RegExp)[]` | `undefined`     | Extra dev `resolve.noExternal` patterns merged after `@vercube/*` (see below).                                    |
+
+### Dev `noExternal`
+
+In dev, Vercube keeps `@vercube/*` inside Vite's module graph so class-reference DI tokens are not loaded twice. If a dependency imports `@vercube/core` from its published `dist` while your app imports it through Vite, inject tokens such as `RequestContext` will not match.
+
+Add those packages via `noExternal`:
+
+```ts
+vercube({
+  noExternal: [/^@org\//],
+});
+```
 
 ## Setup file
 

package/dist/index.d.mts

@@ -33,6 +33,18 @@ interface VercubePluginConfig {
    * Defaults to `node-worker`.
    */
   runner?: string;
+  /**
+   * Additional package patterns passed to the Vercube environment's dev
+   * `resolve.noExternal`. They are merged after the built-in `@vercube/*`
+   * defaults so class-reference DI tokens are not duplicated in the module graph.
+   *
+   * Use this for workspace packages (for example `@org/*`) that import
+   * `@vercube/core` and register Vercube DI tokens.
+   *
+   * @example
+   * vercube({ noExternal: [/^@org\//] })
+   */
+  noExternal?: (string | RegExp)[];
 }
 /**
  * Internal plugin context shared across the plugin's sub-plugins and hooks.

package/dist/index.mjs

@@ -11,12 +11,24 @@ const devWorker = resolve(resolve(dirname(fileURLToPath(import.meta.url)), "runt
 //#endregion
 //#region src/env.ts
 /**
-* Dev-only `resolve.noExternal` patterns. Only `@vercube/*` must stay in Vite's
-* module graph so class-reference DI tokens are not duplicated; other deps (e.g.
-* CJS-only `dotenv`) are left external and loaded via native `import()`.
+* Default dev-only `resolve.noExternal` patterns. `@vercube/*` must stay in
+* Vite's module graph so class-reference DI tokens are not duplicated; other
+* deps (e.g. CJS-only `dotenv`) are left external and loaded via native
+* `import()`.
 */
 const DEV_NO_EXTERNAL = [/^@vercube\//];
 /**
+* Resolves the full dev `noExternal` list for the Vercube environment by
+* merging {@link DEV_NO_EXTERNAL} with optional plugin patterns.
+*
+* @param extra - Additional patterns from {@link VercubePluginConfig.noExternal}.
+* @returns Patterns for `resolve.noExternal` in dev.
+*/
+function resolveDevNoExternal(extra) {
+	if (!extra?.length) return DEV_NO_EXTERNAL;
+	return [...DEV_NO_EXTERNAL, ...extra];
+}
+/**
 * The custom message event used to tell the worker which entry an environment loads.
 */
 const VITE_ENV_EVENT = "vercube:vite-env";
@@ -33,7 +45,7 @@ const VITE_ENV_EVENT = "vercube:vite-env";
 function createVercubeEnvironment(ctx) {
 	return {
 		consumer: "server",
-		resolve: ctx.dev ? { noExternal: DEV_NO_EXTERNAL } : {},
+		resolve: ctx.dev ? { noExternal: resolveDevNoExternal(ctx.pluginConfig.noExternal) } : {},
 		build: {
 			outDir: resolve(ctx.root, "dist"),
 			emptyOutDir: false,
@@ -104,14 +116,16 @@ function getEnvRunner(ctx) {
 }
 /**
 * Returns true for bare module specifiers (npm/workspace packages), which the
-* production build externalizes. Relative paths, absolute paths and virtual
-* (`\0`-prefixed) ids are bundled.
+* production build externalizes. Relative paths, absolute paths, virtual
+* (`\0`-prefixed) ids, Vite path aliases (`@/…`), and bundler helper runtimes
+* are bundled.
 *
 * @param id - The import specifier to classify.
 * @returns Whether the specifier is a bare dependency.
 */
 function isBareSpecifier(id) {
 	if (id.startsWith("\0") || id.startsWith(".") || isAbsolute(id)) return false;
+	if (id.startsWith("@/") || id.startsWith("@oxc-project/")) return false;
 	return true;
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercube/vite",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Vite plugin integrating Vercube with the Vite Environment API",
   "repository": {
     "type": "git",
@@ -36,7 +36,7 @@
     "pathe": "2.0.3",
     "rou3": "0.8.1",
     "srvx": "0.11.17",
-    "@vercube/scan": "1.1.0"
+    "@vercube/scan": "1.1.2"
   },
   "peerDependencies": {
     "vite": "^8.0.0"