@moostjs/vite 0.5.29 → 0.5.31

package/dist/index.cjs

@@ -1,4 +1,3 @@
-"use strict";
 //#region rolldown:runtime
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -22,21 +21,56 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-const moost = __toESM(require("moost"));
+const magic_string = __toESM(require("magic-string"));
 const node_fs = __toESM(require("node:fs"));
 const node_module = __toESM(require("node:module"));
+const moost = __toESM(require("moost"));
+
+//#region packages/vite/src/utils.ts
+const PLUGIN_NAME = "moost-vite";
+/**
+* Recursively gathers all importer modules upstream from a given module.
+*
+* @param {EnvironmentModuleNode | undefined} moduleNode - The starting module node.
+* @param {Set<EnvironmentModuleNode>} [visited] - A set of visited modules to avoid duplicates.
+* @returns {Set<EnvironmentModuleNode>} A set containing all discovered importer modules (including the start node).
+*/ function gatherAllImporters(moduleNode, visited = /* @__PURE__ */ new Set()) {
+	if (!moduleNode) return visited;
+	if (visited.has(moduleNode)) return visited;
+	visited.add(moduleNode);
+	if (moduleNode.importers) for (const importer of moduleNode.importers) gatherAllImporters(importer, visited);
+	return visited;
+}
+const logger = new moost.EventLogger("", { level: 99 }).createTopic("\x1B[2m\x1B[36m" + PLUGIN_NAME);
+function getLogger() {
+	return logger;
+}
+function getExternals({ node, workspace }) {
+	const pkg = JSON.parse((0, node_fs.readFileSync)("package.json", "utf8").toString());
+	const externals = workspace ? Object.keys(pkg.dependencies || {}) : Object.entries(pkg.dependencies || {}).filter(([key, ver]) => !ver.startsWith("workspace:")).map((i) => i[0]);
+	if (node) externals.push(...node_module.builtinModules, ...node_module.builtinModules.map((m) => `node:${m}`));
+	return externals;
+}
 
+//#endregion
 //#region packages/vite/src/adapter-detector.ts
-function createAdapterDetector(adapter, onInit) {
+/**
+* Creates an adapter detector for a specific adapter type.
+* @param adapter
+* @param onInit
+* @returns
+*/ function createAdapterDetector(adapter, onInit) {
 	return {
 		detected: false,
-		regex: new RegExp(`from\\s+["'](@moostjs\\/event-${adapter})["']`),
+		regex: /* @__PURE__ */ new RegExp(`from\\s+["'](@moostjs\\/event-${adapter})["']`),
 		constructor: null,
 		async init() {
 			this.detected = true;
 			const module$1 = await import(`@moostjs/event-${adapter}`);
-			this.constructor = module$1[`Moost${adapter.charAt(0).toUpperCase() + adapter.slice(1)}`];
-			if (onInit) onInit(this.constructor);
+			const constructorName$1 = `Moost${adapter.charAt(0).toUpperCase() + adapter.slice(1)}`;
+			getLogger().log(`🔍 Extracting Adapter "${constructorName$1}"`);
+			this.constructor = module$1[constructorName$1];
+			if (onInit && this.constructor) onInit(this.constructor);
 		},
 		compare(c) {
 			if (this.detected && this.constructor) return this.constructor === c || c instanceof this.constructor || c.prototype instanceof this.constructor;
@@ -99,7 +133,7 @@ function _define_property(obj, key, value) {
 	* @param {(item: TItem) => void} logRemovedItem - A callback that logs
 	*        removed items (presumably by striking them out).
 	*/ endRecording(logRemovedItem) {
-		const newMap = new Map();
+		const newMap = /* @__PURE__ */ new Map();
 		for (const item of this.newItems) {
 			const flat = flattenItem(item);
 			newMap.set(flat, item);
@@ -113,7 +147,7 @@ function _define_property(obj, key, value) {
 		/**
 		* A map of flattenItem() => TItem
 		* representing the previous cycle's known handlers.
-		*/ _define_property(this, "oldMap", new Map());
+		*/ _define_property(this, "oldMap", /* @__PURE__ */ new Map());
 		/**
 		* The handlers discovered in the current cycle,
 		* awaiting finalization.
@@ -125,7 +159,12 @@ function _define_property(obj, key, value) {
 * A reference to a shared LogsStorage instance that persists
 * across init cycles in dev mode.
 */ let logsStorage;
-function patchMoostHandlerLogging() {
+/**
+* Patches Moost’s .init() and .logMappedHandler() methods so that, during dev:
+* - Only newly added handlers are logged normally.
+* - Removed handlers are logged/stroked out to indicate removal.
+* - Prevents repeated logs from flooding the console across multiple hot reloads.
+*/ function patchMoostHandlerLogging() {
 	const origInit = moost.Moost.prototype.init;
 	/**
 	* Monkey-patch Moost.init:
@@ -155,30 +194,13 @@ function patchMoostHandlerLogging() {
 	};
 }
 
-//#endregion
-//#region packages/vite/src/utils.ts
-const PLUGIN_NAME = "moost-vite";
-function gatherAllImporters(moduleNode, visited = new Set()) {
-	if (!moduleNode) return visited;
-	if (visited.has(moduleNode)) return visited;
-	visited.add(moduleNode);
-	if (moduleNode.importers) for (const importer of moduleNode.importers) gatherAllImporters(importer, visited);
-	return visited;
-}
-const logger = new moost.EventLogger("", { level: 99 }).createTopic("\x1B[2m\x1B[36m" + PLUGIN_NAME);
-function getLogger() {
-	return logger;
-}
-function getExternals({ node, workspace }) {
-	const pkg = JSON.parse((0, node_fs.readFileSync)("package.json", "utf8").toString());
-	const externals = workspace ? Object.keys(pkg.dependencies || {}) : Object.entries(pkg.dependencies || {}).filter(([key, ver]) => !ver.startsWith("workspace:")).map((i) => i[0]);
-	if (node) externals.push(...node_module.builtinModules, ...node_module.builtinModules.map((m) => `node:${m}`));
-	return externals;
-}
-
 //#endregion
 //#region packages/vite/src/restart-cleanup.ts
-function moostRestartCleanup(adapters, onEject, cleanupInstances) {
+/**
+* Clean up Moost’s global containers and optionally remove specific instances from the registry.
+*
+* @param {Set<string>} [cleanupInstances] A set of module IDs to remove from the registry.
+*/ function moostRestartCleanup(adapters, onEject, cleanupInstances) {
 	const logger$1 = getLogger();
 	const infact = (0, moost.getMoostInfact)();
 	const { registry, scopes } = infact;
@@ -220,7 +242,7 @@ function moostRestartCleanup(adapters, onEject, cleanupInstances) {
 }
 function clearDependantRegistry(registry, onEject) {
 	const logger$1 = getLogger();
-	const objSet = new Set();
+	const objSet = /* @__PURE__ */ new Set();
 	let somethingIsDeleted = true;
 	while (somethingIsDeleted) {
 		somethingIsDeleted = false;
@@ -245,7 +267,7 @@ function scanParams(instance, cb) {
 	const mate = (0, moost.getMoostMate)();
 	const params = mate.read(instance)?.params;
 	if (params?.length) for (const param of params) {
-		if (param.type === undefined || [
+		if (param.type === void 0 || [
 			Array,
 			String,
 			Number,
@@ -263,13 +285,33 @@ function constructorName(i) {
 //#region packages/vite/src/moost-vite.ts
 /** Regex checks */ const REG_HAS_EXPORT_CLASS = /(^\s*@(Injectable|Controller)\()/m;
 const REG_REPLACE_EXPORT_CLASS = /(^\s*@(Injectable|Controller)\()/gm;
-function moostVite(options) {
+/**
+* The main Vite plugin for integrating Moost applications.
+*
+* Features:
+* - **Adapter Detection**: Detects Moost adapter usage (`http`, `cli`, `wf`) and applies relevant configurations.
+* - **Dev Mode Middleware**:
+*   - Patches `MoostHttp.prototype.listen` to register a custom middleware for serving the app via Vite's dev server instead of binding to a port.
+*   - Handles Moost state cleanup and hot module replacement (HMR) during development.
+* - **Class Tracking**: Injects a `__VITE_ID()` decorator into exported classes to enable tracking and cleanup during hot reloads.
+* - **Externals Support**:
+*   - Allows marking Node.js built-in modules and dependencies from `package.json` (optionally excluding workspace dependencies) as external during builds.
+*   - Configured via the `externals` option, which helps reduce bundle size and ensures compatibility with runtime environments.
+* - **Build and Test Friendly**:
+*   - Avoids interfering with Vitest runs by skipping dev-specific behaviors during tests.
+*   - Ensures proper SSR entry setup and Rollup configurations for production builds.
+*
+* @param {TMoostViteDevOptions} options - Configuration options for the Moost Vite plugin.
+* @returns {PluginOption} The configured Vite plugin.
+*/ function moostVite(options) {
 	const isTest = process.env.NODE_ENV === "test";
 	const isProd = process.env.NODE_ENV === "production";
+	const externals = options.externals ?? true;
 	let moostMiddleware = null;
 	const adapters = isTest ? [] : [
 		createAdapterDetector("http", (MoostHttp) => {
 			MoostHttp.prototype.listen = function(...args) {
+				logger$1.log("🔌 \x1B[2mOvertaking HTTP.listen");
 				moostMiddleware = this.getServerCb();
 				setTimeout(() => {
 					args.filter((a) => typeof a === "function").forEach((a) => a());
@@ -288,14 +330,14 @@ function moostVite(options) {
 		enforce: "pre",
 		config(cfg) {
 			const entry = cfg.build?.rollupOptions?.input || options.entry;
-			const outfile = typeof entry === "string" ? entry.split("/").pop().replace(/\.ts$/, ".js") : undefined;
+			const outfile = typeof entry === "string" ? entry.split("/").pop().replace(/\.ts$/, ".js") : void 0;
 			return {
 				server: {
 					port: cfg.server?.port || options.port || 3e3,
 					host: cfg.server?.host || options.host
 				},
 				optimizeDeps: {
-					noDiscovery: cfg.optimizeDeps?.noDiscovery === undefined ? true : cfg.optimizeDeps.noDiscovery,
+					noDiscovery: cfg.optimizeDeps?.noDiscovery === void 0 ? true : cfg.optimizeDeps.noDiscovery,
 					exclude: cfg.optimizeDeps?.exclude || ["@swc/core"]
 				},
 				build: {
@@ -303,15 +345,15 @@ function moostVite(options) {
 					outDir: cfg.build?.outDir || options.outDir || "dist",
 					ssr: cfg.build?.ssr ?? true,
 					minify: cfg.build?.minify || false,
+					sourcemap: !!(options.sourcemap ?? true),
 					rollupOptions: {
-						external: isTest ? cfg.build?.rollupOptions?.external : cfg.build?.rollupOptions?.external || (options.externals === false ? [] : getExternals({
-							node: Boolean(options.externals === true || options.externals?.node),
-							workspace: Boolean(options.externals === true || options.externals?.workspace)
+						external: isTest ? cfg.build?.rollupOptions?.external : cfg.build?.rollupOptions?.external || (externals === false ? [] : getExternals({
+							node: Boolean(externals === true || externals?.node),
+							workspace: Boolean(externals === true || externals?.workspace)
 						})),
 						input: entry,
 						output: {
 							format: options.format,
-							sourcemap: !!(options.sourcemap ?? true),
 							entryFileNames: outfile,
 							...cfg.build?.rollupOptions?.output
 						}
@@ -320,25 +362,33 @@ function moostVite(options) {
 			};
 		},
 		async transform(code, id) {
-			if (!id.endsWith(".ts")) return code;
+			if (!id.endsWith(".ts")) return null;
 			for (const adapter of adapters) if (!adapter.detected && adapter.regex.test(code)) await adapter.init();
 			if (REG_HAS_EXPORT_CLASS.test(code)) {
-				code = code.replace(REG_REPLACE_EXPORT_CLASS, "\n@__VITE_ID(import.meta.filename)\n$1");
-				code = `import { __VITE_ID } from 'virtual:vite-id'\n\n${code}`;
+				const s = new magic_string.default(code);
+				s.replace(REG_REPLACE_EXPORT_CLASS, "\n@__VITE_ID(import.meta.filename)\n$1");
+				s.prepend(`import { __VITE_ID } from 'virtual:vite-id'\n\n`);
+				return {
+					code: s.toString(),
+					map: s.generateMap({ hires: true })
+				};
 			}
-			return code;
+			return null;
 		},
 		resolveId(id) {
 			if (id === "virtual:vite-id") return "\0virtual:vite-id";
 		},
 		load(id) {
-			if (id === "\0virtual:vite-id") return `
+			if (id === "\0virtual:vite-id") return {
+				code: `
           import { getMoostMate } from "moost";
           const mate = getMoostMate();
           export function __VITE_ID(id) {
             return mate.decorate("__vite_id", id)
           }
-        `;
+        `,
+				map: null
+			};
 		},
 		async configureServer(server) {
 			moostRestartCleanup(adapters, options.onEject);
@@ -361,7 +411,7 @@ function moostVite(options) {
 				const modules = this.environment.moduleGraph.getModulesByFile(file);
 				if (modules) {
 					logger$1.debug(`🔃 Hot update: ${file}`);
-					const cleanupInstances = new Set();
+					const cleanupInstances = /* @__PURE__ */ new Set();
 					for (const mod of modules) {
 						const allImporters = gatherAllImporters(mod);
 						for (const impModule of allImporters) if (impModule.id) cleanupInstances.add(impModule.id);
@@ -386,4 +436,4 @@ function moostVite(options) {
 }
 
 //#endregion
-exports.moostVite = moostVite
+exports.moostVite = moostVite;

package/dist/index.d.ts

@@ -1,18 +1,90 @@
-import { Plugin } from 'vite';
+import { PluginOption } from 'vite';
 
 interface TMoostViteDevOptions {
+    /**
+     * The entry file for the application.
+     * This file serves as the main entry point for the build process and SSR server.
+     *
+     * Example: './src/main.ts'
+     */
     entry: string;
+    /**
+     * The port number for the Vite dev server.
+     *
+     * Default: `3000`.
+     */
     port?: number;
+    /**
+     * The hostname or IP address for the Vite dev server.
+     * If not specified, defaults to `'localhost'`.
+     *
+     * Example: '0.0.0.0'
+     */
     host?: string;
+    /**
+     * The output directory for the build artifacts.
+     *
+     * Default to: `'dist'`.
+     */
     outDir?: string;
+    /**
+     * The output format for the build artifacts.
+     * - `'cjs'`: CommonJS, suitable for Node.js environments.
+     * - `'esm'`: ES Module, suitable for modern environments.
+     *
+     * Default: `'esm'`.
+     */
     format?: 'cjs' | 'esm';
+    /**
+     * Whether to generate source maps for the build output.
+     * Source maps are useful for debugging purposes by mapping minified code back to the original source.
+     *
+     * Default: `true`.
+     */
     sourcemap?: boolean;
+    /**
+     * Configuration for defining external dependencies during the build process.
+     *
+     * This helps in excluding certain modules from the bundled output, reducing the bundle size and
+     * allowing them to be resolved at runtime instead.
+     *
+     * Default: `true`.
+     */
     externals?: {
+        /**
+         * Whether to exclude Node.js built-in modules (e.g., `fs`, `path`, `node:fs`) from the build output.
+         * If `true`, all Node.js built-ins will be marked as external.
+         * Default: `false`.
+         */
         node?: boolean;
+        /**
+         * Whether to exclude workspace dependencies (e.g., packages marked with `workspace:*` in `package.json`) from the build output.
+         * If `true`, all workspace dependencies will be marked as external.
+         * Default: `false`.
+         */
         workspace?: boolean;
     } | boolean;
     onEject?: (instance: object, dependency: Function) => boolean;
 }
-declare function moostVite(options: TMoostViteDevOptions): Plugin;
+/**
+ * The main Vite plugin for integrating Moost applications.
+ *
+ * Features:
+ * - **Adapter Detection**: Detects Moost adapter usage (`http`, `cli`, `wf`) and applies relevant configurations.
+ * - **Dev Mode Middleware**:
+ *   - Patches `MoostHttp.prototype.listen` to register a custom middleware for serving the app via Vite's dev server instead of binding to a port.
+ *   - Handles Moost state cleanup and hot module replacement (HMR) during development.
+ * - **Class Tracking**: Injects a `__VITE_ID()` decorator into exported classes to enable tracking and cleanup during hot reloads.
+ * - **Externals Support**:
+ *   - Allows marking Node.js built-in modules and dependencies from `package.json` (optionally excluding workspace dependencies) as external during builds.
+ *   - Configured via the `externals` option, which helps reduce bundle size and ensures compatibility with runtime environments.
+ * - **Build and Test Friendly**:
+ *   - Avoids interfering with Vitest runs by skipping dev-specific behaviors during tests.
+ *   - Ensures proper SSR entry setup and Rollup configurations for production builds.
+ *
+ * @param {TMoostViteDevOptions} options - Configuration options for the Moost Vite plugin.
+ * @returns {PluginOption} The configured Vite plugin.
+ */
+declare function moostVite(options: TMoostViteDevOptions): PluginOption;
 
 export { moostVite };

package/dist/index.mjs

@@ -1,18 +1,53 @@
-import { EventLogger, Moost, clearGlobalWooks, getMoostInfact, getMoostMate } from "moost";
+import MagicString from "magic-string";
 import { readFileSync } from "node:fs";
 import { builtinModules } from "node:module";
+import { EventLogger, Moost, clearGlobalWooks, getMoostInfact, getMoostMate } from "moost";
+
+//#region packages/vite/src/utils.ts
+const PLUGIN_NAME = "moost-vite";
+/**
+* Recursively gathers all importer modules upstream from a given module.
+*
+* @param {EnvironmentModuleNode | undefined} moduleNode - The starting module node.
+* @param {Set<EnvironmentModuleNode>} [visited] - A set of visited modules to avoid duplicates.
+* @returns {Set<EnvironmentModuleNode>} A set containing all discovered importer modules (including the start node).
+*/ function gatherAllImporters(moduleNode, visited = /* @__PURE__ */ new Set()) {
+	if (!moduleNode) return visited;
+	if (visited.has(moduleNode)) return visited;
+	visited.add(moduleNode);
+	if (moduleNode.importers) for (const importer of moduleNode.importers) gatherAllImporters(importer, visited);
+	return visited;
+}
+const logger = new EventLogger("", { level: 99 }).createTopic("\x1B[2m\x1B[36m" + PLUGIN_NAME);
+function getLogger() {
+	return logger;
+}
+function getExternals({ node, workspace }) {
+	const pkg = JSON.parse(readFileSync("package.json", "utf8").toString());
+	const externals = workspace ? Object.keys(pkg.dependencies || {}) : Object.entries(pkg.dependencies || {}).filter(([key, ver]) => !ver.startsWith("workspace:")).map((i) => i[0]);
+	if (node) externals.push(...builtinModules, ...builtinModules.map((m) => `node:${m}`));
+	return externals;
+}
 
+//#endregion
 //#region packages/vite/src/adapter-detector.ts
-function createAdapterDetector(adapter, onInit) {
+/**
+* Creates an adapter detector for a specific adapter type.
+* @param adapter
+* @param onInit
+* @returns
+*/ function createAdapterDetector(adapter, onInit) {
 	return {
 		detected: false,
-		regex: new RegExp(`from\\s+["'](@moostjs\\/event-${adapter})["']`),
+		regex: /* @__PURE__ */ new RegExp(`from\\s+["'](@moostjs\\/event-${adapter})["']`),
 		constructor: null,
 		async init() {
 			this.detected = true;
 			const module = await import(`@moostjs/event-${adapter}`);
-			this.constructor = module[`Moost${adapter.charAt(0).toUpperCase() + adapter.slice(1)}`];
-			if (onInit) onInit(this.constructor);
+			const constructorName$1 = `Moost${adapter.charAt(0).toUpperCase() + adapter.slice(1)}`;
+			getLogger().log(`🔍 Extracting Adapter "${constructorName$1}"`);
+			this.constructor = module[constructorName$1];
+			if (onInit && this.constructor) onInit(this.constructor);
 		},
 		compare(c) {
 			if (this.detected && this.constructor) return this.constructor === c || c instanceof this.constructor || c.prototype instanceof this.constructor;
@@ -75,7 +110,7 @@ function _define_property(obj, key, value) {
 	* @param {(item: TItem) => void} logRemovedItem - A callback that logs
 	*        removed items (presumably by striking them out).
 	*/ endRecording(logRemovedItem) {
-		const newMap = new Map();
+		const newMap = /* @__PURE__ */ new Map();
 		for (const item of this.newItems) {
 			const flat = flattenItem(item);
 			newMap.set(flat, item);
@@ -89,7 +124,7 @@ function _define_property(obj, key, value) {
 		/**
 		* A map of flattenItem() => TItem
 		* representing the previous cycle's known handlers.
-		*/ _define_property(this, "oldMap", new Map());
+		*/ _define_property(this, "oldMap", /* @__PURE__ */ new Map());
 		/**
 		* The handlers discovered in the current cycle,
 		* awaiting finalization.
@@ -101,7 +136,12 @@ function _define_property(obj, key, value) {
 * A reference to a shared LogsStorage instance that persists
 * across init cycles in dev mode.
 */ let logsStorage;
-function patchMoostHandlerLogging() {
+/**
+* Patches Moost’s .init() and .logMappedHandler() methods so that, during dev:
+* - Only newly added handlers are logged normally.
+* - Removed handlers are logged/stroked out to indicate removal.
+* - Prevents repeated logs from flooding the console across multiple hot reloads.
+*/ function patchMoostHandlerLogging() {
 	const origInit = Moost.prototype.init;
 	/**
 	* Monkey-patch Moost.init:
@@ -131,30 +171,13 @@ function patchMoostHandlerLogging() {
 	};
 }
 
-//#endregion
-//#region packages/vite/src/utils.ts
-const PLUGIN_NAME = "moost-vite";
-function gatherAllImporters(moduleNode, visited = new Set()) {
-	if (!moduleNode) return visited;
-	if (visited.has(moduleNode)) return visited;
-	visited.add(moduleNode);
-	if (moduleNode.importers) for (const importer of moduleNode.importers) gatherAllImporters(importer, visited);
-	return visited;
-}
-const logger = new EventLogger("", { level: 99 }).createTopic("\x1B[2m\x1B[36m" + PLUGIN_NAME);
-function getLogger() {
-	return logger;
-}
-function getExternals({ node, workspace }) {
-	const pkg = JSON.parse(readFileSync("package.json", "utf8").toString());
-	const externals = workspace ? Object.keys(pkg.dependencies || {}) : Object.entries(pkg.dependencies || {}).filter(([key, ver]) => !ver.startsWith("workspace:")).map((i) => i[0]);
-	if (node) externals.push(...builtinModules, ...builtinModules.map((m) => `node:${m}`));
-	return externals;
-}
-
 //#endregion
 //#region packages/vite/src/restart-cleanup.ts
-function moostRestartCleanup(adapters, onEject, cleanupInstances) {
+/**
+* Clean up Moost’s global containers and optionally remove specific instances from the registry.
+*
+* @param {Set<string>} [cleanupInstances] A set of module IDs to remove from the registry.
+*/ function moostRestartCleanup(adapters, onEject, cleanupInstances) {
 	const logger$1 = getLogger();
 	const infact = getMoostInfact();
 	const { registry, scopes } = infact;
@@ -196,7 +219,7 @@ function moostRestartCleanup(adapters, onEject, cleanupInstances) {
 }
 function clearDependantRegistry(registry, onEject) {
 	const logger$1 = getLogger();
-	const objSet = new Set();
+	const objSet = /* @__PURE__ */ new Set();
 	let somethingIsDeleted = true;
 	while (somethingIsDeleted) {
 		somethingIsDeleted = false;
@@ -221,7 +244,7 @@ function scanParams(instance, cb) {
 	const mate = getMoostMate();
 	const params = mate.read(instance)?.params;
 	if (params?.length) for (const param of params) {
-		if (param.type === undefined || [
+		if (param.type === void 0 || [
 			Array,
 			String,
 			Number,
@@ -239,13 +262,33 @@ function constructorName(i) {
 //#region packages/vite/src/moost-vite.ts
 /** Regex checks */ const REG_HAS_EXPORT_CLASS = /(^\s*@(Injectable|Controller)\()/m;
 const REG_REPLACE_EXPORT_CLASS = /(^\s*@(Injectable|Controller)\()/gm;
-function moostVite(options) {
+/**
+* The main Vite plugin for integrating Moost applications.
+*
+* Features:
+* - **Adapter Detection**: Detects Moost adapter usage (`http`, `cli`, `wf`) and applies relevant configurations.
+* - **Dev Mode Middleware**:
+*   - Patches `MoostHttp.prototype.listen` to register a custom middleware for serving the app via Vite's dev server instead of binding to a port.
+*   - Handles Moost state cleanup and hot module replacement (HMR) during development.
+* - **Class Tracking**: Injects a `__VITE_ID()` decorator into exported classes to enable tracking and cleanup during hot reloads.
+* - **Externals Support**:
+*   - Allows marking Node.js built-in modules and dependencies from `package.json` (optionally excluding workspace dependencies) as external during builds.
+*   - Configured via the `externals` option, which helps reduce bundle size and ensures compatibility with runtime environments.
+* - **Build and Test Friendly**:
+*   - Avoids interfering with Vitest runs by skipping dev-specific behaviors during tests.
+*   - Ensures proper SSR entry setup and Rollup configurations for production builds.
+*
+* @param {TMoostViteDevOptions} options - Configuration options for the Moost Vite plugin.
+* @returns {PluginOption} The configured Vite plugin.
+*/ function moostVite(options) {
 	const isTest = false;
 	const isProd = false;
+	const externals = options.externals ?? true;
 	let moostMiddleware = null;
 	const adapters = isTest ? [] : [
 		createAdapterDetector("http", (MoostHttp) => {
 			MoostHttp.prototype.listen = function(...args) {
+				logger$1.log("🔌 \x1B[2mOvertaking HTTP.listen");
 				moostMiddleware = this.getServerCb();
 				setTimeout(() => {
 					args.filter((a) => typeof a === "function").forEach((a) => a());
@@ -264,14 +307,14 @@ function moostVite(options) {
 		enforce: "pre",
 		config(cfg) {
 			const entry = cfg.build?.rollupOptions?.input || options.entry;
-			const outfile = typeof entry === "string" ? entry.split("/").pop().replace(/\.ts$/, ".js") : undefined;
+			const outfile = typeof entry === "string" ? entry.split("/").pop().replace(/\.ts$/, ".js") : void 0;
 			return {
 				server: {
 					port: cfg.server?.port || options.port || 3e3,
 					host: cfg.server?.host || options.host
 				},
 				optimizeDeps: {
-					noDiscovery: cfg.optimizeDeps?.noDiscovery === undefined ? true : cfg.optimizeDeps.noDiscovery,
+					noDiscovery: cfg.optimizeDeps?.noDiscovery === void 0 ? true : cfg.optimizeDeps.noDiscovery,
 					exclude: cfg.optimizeDeps?.exclude || ["@swc/core"]
 				},
 				build: {
@@ -279,15 +322,15 @@ function moostVite(options) {
 					outDir: cfg.build?.outDir || options.outDir || "dist",
 					ssr: cfg.build?.ssr ?? true,
 					minify: cfg.build?.minify || false,
+					sourcemap: !!(options.sourcemap ?? true),
 					rollupOptions: {
-						external: isTest ? cfg.build?.rollupOptions?.external : cfg.build?.rollupOptions?.external || (options.externals === false ? [] : getExternals({
-							node: Boolean(options.externals === true || options.externals?.node),
-							workspace: Boolean(options.externals === true || options.externals?.workspace)
+						external: isTest ? cfg.build?.rollupOptions?.external : cfg.build?.rollupOptions?.external || (externals === false ? [] : getExternals({
+							node: Boolean(externals === true || externals?.node),
+							workspace: Boolean(externals === true || externals?.workspace)
 						})),
 						input: entry,
 						output: {
 							format: options.format,
-							sourcemap: !!(options.sourcemap ?? true),
 							entryFileNames: outfile,
 							...cfg.build?.rollupOptions?.output
 						}
@@ -296,25 +339,33 @@ function moostVite(options) {
 			};
 		},
 		async transform(code, id) {
-			if (!id.endsWith(".ts")) return code;
+			if (!id.endsWith(".ts")) return null;
 			for (const adapter of adapters) if (!adapter.detected && adapter.regex.test(code)) await adapter.init();
 			if (REG_HAS_EXPORT_CLASS.test(code)) {
-				code = code.replace(REG_REPLACE_EXPORT_CLASS, "\n@__VITE_ID(import.meta.filename)\n$1");
-				code = `import { __VITE_ID } from 'virtual:vite-id'\n\n${code}`;
+				const s = new MagicString(code);
+				s.replace(REG_REPLACE_EXPORT_CLASS, "\n@__VITE_ID(import.meta.filename)\n$1");
+				s.prepend(`import { __VITE_ID } from 'virtual:vite-id'\n\n`);
+				return {
+					code: s.toString(),
+					map: s.generateMap({ hires: true })
+				};
 			}
-			return code;
+			return null;
 		},
 		resolveId(id) {
 			if (id === "virtual:vite-id") return "\0virtual:vite-id";
 		},
 		load(id) {
-			if (id === "\0virtual:vite-id") return `
+			if (id === "\0virtual:vite-id") return {
+				code: `
           import { getMoostMate } from "moost";
           const mate = getMoostMate();
           export function __VITE_ID(id) {
             return mate.decorate("__vite_id", id)
           }
-        `;
+        `,
+				map: null
+			};
 		},
 		async configureServer(server) {
 			moostRestartCleanup(adapters, options.onEject);
@@ -337,7 +388,7 @@ function moostVite(options) {
 				const modules = this.environment.moduleGraph.getModulesByFile(file);
 				if (modules) {
 					logger$1.debug(`🔃 Hot update: ${file}`);
-					const cleanupInstances = new Set();
+					const cleanupInstances = /* @__PURE__ */ new Set();
 					for (const mod of modules) {
 						const allImporters = gatherAllImporters(mod);
 						for (const impModule of allImporters) if (impModule.id) cleanupInstances.add(impModule.id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moostjs/vite",
-  "version": "0.5.29",
+  "version": "0.5.31",
   "description": "Vite Dev plugin for moostjs",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -38,12 +38,15 @@
   },
   "homepage": "https://github.com/moostjs/moostjs/tree/main/packages/vite#readme",
   "peerDependencies": {
-    "vite": "^6.0.5",
-    "moost": "^0.5.29",
-    "@moostjs/event-http": "^0.5.29"
+    "vite": "^7.0.0",
+    "@moostjs/event-http": "^0.5.31",
+    "moost": "^0.5.31"
   },
   "devDependencies": {
-    "vitest": "^3.0.5"
+    "vitest": "3.2.4"
+  },
+  "dependencies": {
+    "magic-string": "^0.30.17"
   },
   "scripts": {
     "pub": "pnpm publish --access public",