@path-ioc/pack 0.1.2 → 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hanlin Lian
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -15,12 +15,16 @@
   </p>
 </div>
 
+> 💡 **Architectural Positioning & Usage Boundary**  
+> `@path-ioc/pack` is a dedicated Vite build plugin designed to bundle an isolated Mesh module directory into a **distributable standalone npm package / component library**.  
+> **Warning**: This plugin automatically intercepts Vite configuration and forces Library Mode (`build.lib`). **Do NOT unconditionally embed it in standard web application builds (e.g. standard Vite SPA/SSR configs).** It is recommended to use a dedicated packaging config (e.g. `vite.config.pack.ts`) or trigger it via separate packaging scripts.
+
 ---
 
-## Features
+## Core Capabilities
 
 - **Physical Entrypoint Generation**:
-  During Vite builds, automatically scans `src/modules` for physical directories containing `index.ts/tsx` and synthesizes clean on-disk entrypoints (default `.modular-plugin-entry.ts`).
+  During Vite builds, automatically scans `src/modules` for physical directories containing `index.ts/tsx` and synthesizes clean on-disk entrypoints (default `node_modules/.path-ioc/.modular-plugin-entry.ts`);
 - **Full Mesh Registry & Type Exports**:
   Generates unified module import aliases and exports the canonical runtime module registry array `modules`:
   ```typescript
@@ -30,9 +34,11 @@
   ];
   ```
 - **Static Type Mapping Extraction (`sharedMappings`)**:
-  Fills `sharedMappings` and `sharedContainerMappings` to provide accurate type descriptions for cross-package SDKs or microfrontend mesh topologies.
-- **Physical Isolation & Bundler Obfuscation Compatibility**:
-  Generated physical entrypoint files integrate seamlessly into standard npm packaging pipelines, fully compatible with downstream AST transformers and code protection tools.
+  Populates `sharedMappings` and `sharedContainerMappings` arrays to provide accurate type descriptions for cross-package SDKs or microfrontend mesh topologies;
+- **Built-in Obfuscation Protection**:
+  During the `closeBundle` lifecycle, automatically performs deep code obfuscation using `javascript-obfuscator` by default. Can be disabled via environment variable `MODULAR_OBFUSCATE=false`;
+- **Automated Packaging**:
+  Automatically synthesizes package-ready metadata (`package.json`, `index.d.ts`) and triggers `npm pack` in `outDir` to produce distribution `.tgz` tarballs.
 
 ---
 
@@ -48,7 +54,7 @@ npm install -D @path-ioc/pack
 
 ## Quick Start
 
-### Vite Configuration (`vite.config.ts`)
+### Dedicated Packaging Config (`vite.config.pack.ts`)
 
 ```typescript
 import { defineConfig } from "vite";
@@ -61,7 +67,8 @@ export default defineConfig({
   plugins: [
     modularPackPlugin({
       modulesPath: "src/modules",
-      // Optional: Custom on-disk entrypoint path (default: node_modules/.path-ioc/.modular-plugin-entry.ts)
+      outDir: "dist-plugin",
+      // Optional: Custom on-disk entrypoint path
       entryFile: "node_modules/.path-ioc/.modular-plugin-entry.ts",
       sharedMappings,
       sharedContainerMappings,
@@ -70,6 +77,11 @@ export default defineConfig({
 });
 ```
 
+To build and package your mesh bundle:
+```bash
+vite build --config vite.config.pack.ts
+```
+
 ---
 
 ## Configuration Options (`PackPluginOptions`)
@@ -78,11 +90,18 @@ export default defineConfig({
 | :--- | :--- | :--- | :--- |
 | **`modulesPath`** | `string` | `'src/modules'` | Root directory scanned for modular IoC entrypoints. |
 | **`entryFile`** | `string` | `'node_modules/.path-ioc/.modular-plugin-entry.ts'` | Target physical path for the generated entrypoint file. |
+| **`outDir`** | `string` | `'dist-plugin'` | Output directory for the packaged library bundle and npm tarball. |
 | **`sharedMappings`** | `string[]` | `[]` *(optional)* | Reference to an array that receives generated type mapping strings. |
 | **`sharedContainerMappings`** | `string[]` | `[]` *(optional)* | Reference to an array that receives generated container type mapping strings. |
 
 ---
 
+## Environment Variables
+
+- **`MODULAR_OBFUSCATE`**: Set to `false` (e.g. `MODULAR_OBFUSCATE=false vite build`) to disable the default `javascript-obfuscator` pass for debugging or open-source distribution.
+
+---
+
 ## Exported API
 
 ```typescript

package/README.zh-CN.md

@@ -15,12 +15,16 @@
   </p>
 </div>
 
+> 💡 **架构定位与使用边界警告**  
+> `@path-ioc/pack` 是专用于将 Mesh 模块目录打包为**独立发布的 npm 插件包/组件库**的专用 Vite 构建插件。  
+> **警告**：该插件会在构建期自动接管改写 Vite 的 Library 模式（`build.lib`）。**严禁无条件直接写入通用 Web 前端应用（如 SPA/SSR）的主构建配置中。** 推荐通过独立的打包配置（例如 `vite.config.pack.ts`）或专属构建脚本按需触发。
+
 ---
 
 ## 核心特性 (Features)
 
 - **物理入口自动生成 (Physical Entrypoint Generation)**：
-  在 Vite 构建流程中，自动深度扫描 `src/modules` 下所有包含 `index.ts/tsx` 的物理子目录，并在磁盘上自动生成/更新干净的入口文件（默认 `.modular-plugin-entry.ts`）。
+  在 Vite 构建流程中，自动深度扫描 `src/modules` 下所有包含 `index.ts/tsx` 的物理子目录，并在磁盘上自动生成/更新入口文件（默认 `node_modules/.path-ioc/.modular-plugin-entry.ts`）；
 - **Mesh 注册表与类型全导出**：
   自动生成统一的模块导入别名与导出，并导出标准运行期注册表数组 `modules`：
   ```typescript
@@ -30,9 +34,11 @@
   ];
   ```
 - **静态类型映射提取 (`sharedMappings`)**：
-  自动填充 `sharedMappings` 与 `sharedContainerMappings` 集合，为构建跨包 SDK 或微前端网格映射提供准确的类型描述。
-- **物理隔离与代码混淆兼容**：
-  物理生成的入口文件可直接用于 npm 打包流程，完美兼容各类 AST 物理打散与防篡改混淆工具。
+  自动填充 `sharedMappings` 与 `sharedContainerMappings` 集合，为构建跨包 SDK 或微前端网格映射提供准确的类型描述；
+- **内置源码深度混淆保护**：
+  构建结束时（`closeBundle` 生命周期）默认集成 `javascript-obfuscator` 对产物代码进行深度混淆保护，可通过环境变量 `MODULAR_OBFUSCATE=false` 关闭；
+- **交付包全自动打包**：
+  自动生成交付标准的 `package.json` 与 `index.d.ts` 类型声明，并自动在 `outDir` 目录调用 `npm pack` 产出可分发的 `.tgz` 压缩包。
 
 ---
 
@@ -48,7 +54,7 @@ npm install -D @path-ioc/pack
 
 ## 快速上手 (Quick Start)
 
-### Vite 配置 (`vite.config.ts`)
+### 专属 Vite 打包配置 (`vite.config.pack.ts`)
 
 ```typescript
 import { defineConfig } from "vite";
@@ -61,7 +67,8 @@ export default defineConfig({
   plugins: [
     modularPackPlugin({
       modulesPath: "src/modules",
-      // 可选：自定义生成的入口文件路径（默认存放在 node_modules/.path-ioc/.modular-plugin-entry.ts）
+      outDir: "dist-plugin",
+      // 可选：自定义生成的入口文件路径
       entryFile: "node_modules/.path-ioc/.modular-plugin-entry.ts",
       sharedMappings,
       sharedContainerMappings,
@@ -70,6 +77,11 @@ export default defineConfig({
 });
 ```
 
+执行打包命令：
+```bash
+vite build --config vite.config.pack.ts
+```
+
 ---
 
 ## 配置选项 (PackPluginOptions)
@@ -78,11 +90,18 @@ export default defineConfig({
 | :--- | :--- | :--- | :--- |
 | **`modulesPath`** | `string` | `'src/modules'` | 模块扫描的物理根目录路径。 |
 | **`entryFile`** | `string` | `'node_modules/.path-ioc/.modular-plugin-entry.ts'` | 物理生成的入口文件路径。 |
+| **`outDir`** | `string` | `'dist-plugin'` | 构建产物输出与 npm 打包目录。 |
 | **`sharedMappings`** | `string[]` | `[]` *(可选)* | 接收生成的类型映射字符串数组引用。 |
 | **`sharedContainerMappings`** | `string[]` | `[]` *(可选)* | 接收生成的容器类型映射字符串数组引用。 |
 
 ---
 
+## 环境变量 (Environment Variables)
+
+- **`MODULAR_OBFUSCATE`**：设置为 `false`（例如 `MODULAR_OBFUSCATE=false vite build --config vite.config.pack.ts`）可关闭默认的 `javascript-obfuscator` 混淆步骤，便于本地调试或开源包发布。
+
+---
+
 ## 导出的 API
 
 ```typescript

package/dist/index.cjs

@@ -35,21 +35,31 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 var import_node_path = __toESM(require("path"), 1);
 var import_promises = __toESM(require("fs/promises"), 1);
+var import_node_fs = __toESM(require("fs"), 1);
+var import_node_child_process = require("child_process");
+var import_node_util = require("util");
 var import_lodash_es = require("lodash-es");
+var import_javascript_obfuscator = __toESM(require("javascript-obfuscator"), 1);
+var execAsync = (0, import_node_util.promisify)(import_node_child_process.exec);
 function modularPackPlugin({
   modulesPath = "src/modules",
   entryFile = "node_modules/.path-ioc/.modular-plugin-entry.ts",
+  outDir = "dist-plugin",
   sharedMappings = [],
   sharedContainerMappings = []
 } = {}) {
   let projectRoot;
+  let entryFilePath;
+  let outputFullPath;
+  let savedEntryLines = [];
   return {
     name: "vite-plugin-modular-pack",
     enforce: "pre",
     async config(config) {
       projectRoot = import_node_path.default.resolve(config.root || process.cwd());
+      outputFullPath = import_node_path.default.resolve(projectRoot, outDir);
       const modulesRoot = import_node_path.default.resolve(projectRoot, modulesPath);
-      const entryFilePath = import_node_path.default.resolve(projectRoot, entryFile);
+      entryFilePath = import_node_path.default.resolve(projectRoot, entryFile);
       const entryFileDir = import_node_path.default.dirname(entryFilePath);
       await import_promises.default.mkdir(entryFileDir, { recursive: true });
       const absoluteFolders = await searchIndexTsFiles(modulesRoot);
@@ -108,8 +118,156 @@ function modularPackPlugin({
       entryLines.push(runtimeModulesArray.join(",\n"));
       entryLines.push(`];
 `);
+      savedEntryLines = [...entryLines];
       await import_promises.default.writeFile(entryFilePath, entryLines.join("\n"), "utf-8");
       console.log(`\x1B[32m[ModularPack] Generated physical entry file: ${entryFile}\x1B[0m`);
+      if (!config.build) config.build = {};
+      config.build.outDir = outDir;
+      config.build.emptyOutDir = true;
+      config.build.lib = {
+        entry: entryFilePath,
+        formats: ["es"],
+        fileName: () => "index.js"
+      };
+      if (!config.build.rollupOptions) config.build.rollupOptions = {};
+      if (config.build.rollupOptions.input) {
+        delete config.build.rollupOptions.input;
+      }
+      let pkg = {};
+      try {
+        const pkgPath = import_node_path.default.resolve(projectRoot, "package.json");
+        pkg = JSON.parse(import_node_fs.default.readFileSync(pkgPath, "utf-8"));
+      } catch {
+      }
+      const externalDeps = [
+        ...Object.keys(pkg.dependencies || {}),
+        ...Object.keys(pkg.peerDependencies || {})
+      ];
+      const existingExternal = config.build.rollupOptions.external;
+      config.build.rollupOptions.external = (source, importer, isResolved) => {
+        if (source.includes("?worker")) return false;
+        const isExternalDep = externalDeps.includes(source) || externalDeps.some((dep) => source.startsWith(`${dep}/`));
+        if (isExternalDep) return true;
+        if (existingExternal) {
+          if (Array.isArray(existingExternal)) {
+            if (existingExternal.includes(source)) return true;
+          } else if (typeof existingExternal === "function") {
+            if (existingExternal(source, importer, isResolved)) return true;
+          } else if (existingExternal instanceof RegExp) {
+            if (existingExternal.test(source)) return true;
+          }
+        }
+        return false;
+      };
+      if (!config.build.rollupOptions.output) {
+        config.build.rollupOptions.output = {};
+      }
+      if (Array.isArray(config.build.rollupOptions.output)) {
+        config.build.rollupOptions.output.forEach((out) => {
+          out.entryFileNames = "index.js";
+        });
+      } else {
+        config.build.rollupOptions.output.entryFileNames = "index.js";
+      }
+    },
+    async closeBundle() {
+      try {
+        await import_promises.default.access(outputFullPath);
+      } catch {
+        return;
+      }
+      try {
+        const dtsPath = import_node_path.default.resolve(outputFullPath, "index.d.ts");
+        const dtsContent = [
+          `/// <reference types="@path-ioc/unplugin/virtual" />`,
+          ...savedEntryLines.filter((l) => !l.startsWith("//")),
+          `declare global {`,
+          `  interface ModuleMap {`,
+          ...sharedMappings,
+          `  }`,
+          ``,
+          `  interface ModularContainer {`,
+          ...sharedContainerMappings,
+          `  }`,
+          `}`,
+          ``,
+          `export {};`,
+          ``
+        ].join("\n");
+        await import_promises.default.writeFile(dtsPath, dtsContent, "utf-8");
+        console.log(`\x1B[32m[ModularPack] Generated declarations: ${import_node_path.default.relative(projectRoot, dtsPath)}\x1B[0m`);
+      } catch (err) {
+        console.warn("[ModularPack] Failed to generate index.d.ts:", err);
+      }
+      if (process.env.MODULAR_OBFUSCATE !== "false") {
+        try {
+          const jsFiles = await searchJsFiles(outputFullPath);
+          for (const file of jsFiles) {
+            let content = await import_promises.default.readFile(file, "utf-8");
+            content = content.replace(/process\.env\.NODE_ENV/g, "GLOBAL_VITE_PROCESS_ENV_NODE_ENV");
+            content = content.replace(/import\.meta\.env\.MODE/g, "GLOBAL_VITE_IMPORT_META_ENV_MODE");
+            const obfuscationResult = import_javascript_obfuscator.default.obfuscate(content, {
+              compact: true,
+              controlFlowFlattening: false,
+              deadCodeInjection: false,
+              identifierNamesGenerator: "hexadecimal",
+              renameGlobals: false,
+              selfDefending: false,
+              stringArray: true,
+              stringArrayEncoding: ["base64"],
+              transformObjectKeys: true,
+              unicodeEscapeSequence: false,
+              reservedStrings: ["\\.\\./assets/.*\\.js$", "\\./assets/.*\\.js$"]
+            });
+            let obfuscatedCode = obfuscationResult.getObfuscatedCode();
+            obfuscatedCode = obfuscatedCode.replace(/GLOBAL_VITE_PROCESS_ENV_NODE_ENV/g, "process.env.NODE_ENV");
+            obfuscatedCode = obfuscatedCode.replace(/GLOBAL_VITE_IMPORT_META_ENV_MODE/g, "import.meta.env.MODE");
+            await import_promises.default.writeFile(file, obfuscatedCode, "utf-8");
+          }
+          if (jsFiles.length > 0) {
+            console.log(`\x1B[32m[ModularPack] Obfuscated output JS files successfully!\x1B[0m`);
+          }
+        } catch (err) {
+          console.error("[ModularPack] Error during JS obfuscation:", err);
+        }
+      }
+      let pkg = {};
+      try {
+        const pkgPath = import_node_path.default.resolve(projectRoot, "package.json");
+        pkg = JSON.parse(await import_promises.default.readFile(pkgPath, "utf-8"));
+      } catch {
+      }
+      const mergedPeerDeps = {
+        ...pkg.dependencies || {},
+        ...pkg.peerDependencies || {}
+      };
+      const deliveryPkg = {
+        name: pkg.name || "modular-plugin",
+        version: pkg.version || "0.0.1",
+        type: "module",
+        main: "./index.js",
+        module: "./index.js",
+        types: "./index.d.ts",
+        files: ["index.js", "index.d.ts", "assets", "src"],
+        peerDependencies: mergedPeerDeps
+      };
+      try {
+        await import_promises.default.writeFile(
+          import_node_path.default.resolve(outputFullPath, "package.json"),
+          JSON.stringify(deliveryPkg, null, 2),
+          "utf-8"
+        );
+      } catch (err) {
+        console.warn("[ModularPack] Failed to generate delivery package.json:", err);
+      }
+      try {
+        await execAsync("npm pack", { cwd: outputFullPath });
+        console.log(`
+\x1B[32m[ModularPack] Successfully built and packed vendor package! (Version: ${deliveryPkg.version})\x1B[0m
+`);
+      } catch (err) {
+        console.warn(`[ModularPack] Failed to execute 'npm pack' in "${outDir}":`, err);
+      }
     }
   };
 }
@@ -141,6 +299,22 @@ var searchIndexTsFiles = async (rootPath) => {
   }
   return result;
 };
+var searchJsFiles = async (dirPath) => {
+  const result = [];
+  try {
+    const entries = await import_promises.default.readdir(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = import_node_path.default.join(dirPath, entry.name);
+      if (entry.isDirectory()) {
+        result.push(...await searchJsFiles(fullPath));
+      } else if (/\.(js|cjs|mjs)$/.test(entry.name) && !entry.name.includes("worker")) {
+        result.push(fullPath);
+      }
+    }
+  } catch {
+  }
+  return result;
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   modularPackPlugin

package/dist/index.d.cts

@@ -1,12 +1,30 @@
 import { Plugin } from 'vite';
 
 interface PackPluginOptions {
+    /**
+     * Root directory to scan for modules containing index.ts or index.tsx.
+     * @default "src/modules"
+     */
     modulesPath?: string;
+    /**
+     * Destination path for the physical entry file.
+     * @default "node_modules/.path-ioc/.modular-plugin-entry.ts"
+     */
     entryFile?: string;
+    /**
+     * Output directory for the packaged library bundle.
+     * @default "dist-plugin"
+     */
+    outDir?: string;
+    /**
+     * Shared type mappings array reference (optional).
+     */
     sharedMappings?: string[];
+    /**
+     * Shared container type mappings array reference (optional).
+     */
     sharedContainerMappings?: string[];
 }
-type ModularPackPlugin = Pick<Plugin, "name" | "enforce" | "config">;
-declare function modularPackPlugin({ modulesPath, entryFile, sharedMappings, sharedContainerMappings, }?: PackPluginOptions): ModularPackPlugin;
+declare function modularPackPlugin({ modulesPath, entryFile, outDir, sharedMappings, sharedContainerMappings, }?: PackPluginOptions): Plugin;
 
-export { type ModularPackPlugin, type PackPluginOptions, modularPackPlugin };
+export { type PackPluginOptions, modularPackPlugin };

package/dist/index.d.ts

@@ -1,12 +1,30 @@
 import { Plugin } from 'vite';
 
 interface PackPluginOptions {
+    /**
+     * Root directory to scan for modules containing index.ts or index.tsx.
+     * @default "src/modules"
+     */
     modulesPath?: string;
+    /**
+     * Destination path for the physical entry file.
+     * @default "node_modules/.path-ioc/.modular-plugin-entry.ts"
+     */
     entryFile?: string;
+    /**
+     * Output directory for the packaged library bundle.
+     * @default "dist-plugin"
+     */
+    outDir?: string;
+    /**
+     * Shared type mappings array reference (optional).
+     */
     sharedMappings?: string[];
+    /**
+     * Shared container type mappings array reference (optional).
+     */
     sharedContainerMappings?: string[];
 }
-type ModularPackPlugin = Pick<Plugin, "name" | "enforce" | "config">;
-declare function modularPackPlugin({ modulesPath, entryFile, sharedMappings, sharedContainerMappings, }?: PackPluginOptions): ModularPackPlugin;
+declare function modularPackPlugin({ modulesPath, entryFile, outDir, sharedMappings, sharedContainerMappings, }?: PackPluginOptions): Plugin;
 
-export { type ModularPackPlugin, type PackPluginOptions, modularPackPlugin };
+export { type PackPluginOptions, modularPackPlugin };

package/dist/index.js

@@ -1,21 +1,31 @@
 // src/index.ts
 import path from "path";
 import fs from "fs/promises";
+import fsSync from "fs";
+import { exec } from "child_process";
+import { promisify } from "util";
 import { camelCase } from "lodash-es";
+import JavaScriptObfuscator from "javascript-obfuscator";
+var execAsync = promisify(exec);
 function modularPackPlugin({
   modulesPath = "src/modules",
   entryFile = "node_modules/.path-ioc/.modular-plugin-entry.ts",
+  outDir = "dist-plugin",
   sharedMappings = [],
   sharedContainerMappings = []
 } = {}) {
   let projectRoot;
+  let entryFilePath;
+  let outputFullPath;
+  let savedEntryLines = [];
   return {
     name: "vite-plugin-modular-pack",
     enforce: "pre",
     async config(config) {
       projectRoot = path.resolve(config.root || process.cwd());
+      outputFullPath = path.resolve(projectRoot, outDir);
       const modulesRoot = path.resolve(projectRoot, modulesPath);
-      const entryFilePath = path.resolve(projectRoot, entryFile);
+      entryFilePath = path.resolve(projectRoot, entryFile);
       const entryFileDir = path.dirname(entryFilePath);
       await fs.mkdir(entryFileDir, { recursive: true });
       const absoluteFolders = await searchIndexTsFiles(modulesRoot);
@@ -74,8 +84,156 @@ function modularPackPlugin({
       entryLines.push(runtimeModulesArray.join(",\n"));
       entryLines.push(`];
 `);
+      savedEntryLines = [...entryLines];
       await fs.writeFile(entryFilePath, entryLines.join("\n"), "utf-8");
       console.log(`\x1B[32m[ModularPack] Generated physical entry file: ${entryFile}\x1B[0m`);
+      if (!config.build) config.build = {};
+      config.build.outDir = outDir;
+      config.build.emptyOutDir = true;
+      config.build.lib = {
+        entry: entryFilePath,
+        formats: ["es"],
+        fileName: () => "index.js"
+      };
+      if (!config.build.rollupOptions) config.build.rollupOptions = {};
+      if (config.build.rollupOptions.input) {
+        delete config.build.rollupOptions.input;
+      }
+      let pkg = {};
+      try {
+        const pkgPath = path.resolve(projectRoot, "package.json");
+        pkg = JSON.parse(fsSync.readFileSync(pkgPath, "utf-8"));
+      } catch {
+      }
+      const externalDeps = [
+        ...Object.keys(pkg.dependencies || {}),
+        ...Object.keys(pkg.peerDependencies || {})
+      ];
+      const existingExternal = config.build.rollupOptions.external;
+      config.build.rollupOptions.external = (source, importer, isResolved) => {
+        if (source.includes("?worker")) return false;
+        const isExternalDep = externalDeps.includes(source) || externalDeps.some((dep) => source.startsWith(`${dep}/`));
+        if (isExternalDep) return true;
+        if (existingExternal) {
+          if (Array.isArray(existingExternal)) {
+            if (existingExternal.includes(source)) return true;
+          } else if (typeof existingExternal === "function") {
+            if (existingExternal(source, importer, isResolved)) return true;
+          } else if (existingExternal instanceof RegExp) {
+            if (existingExternal.test(source)) return true;
+          }
+        }
+        return false;
+      };
+      if (!config.build.rollupOptions.output) {
+        config.build.rollupOptions.output = {};
+      }
+      if (Array.isArray(config.build.rollupOptions.output)) {
+        config.build.rollupOptions.output.forEach((out) => {
+          out.entryFileNames = "index.js";
+        });
+      } else {
+        config.build.rollupOptions.output.entryFileNames = "index.js";
+      }
+    },
+    async closeBundle() {
+      try {
+        await fs.access(outputFullPath);
+      } catch {
+        return;
+      }
+      try {
+        const dtsPath = path.resolve(outputFullPath, "index.d.ts");
+        const dtsContent = [
+          `/// <reference types="@path-ioc/unplugin/virtual" />`,
+          ...savedEntryLines.filter((l) => !l.startsWith("//")),
+          `declare global {`,
+          `  interface ModuleMap {`,
+          ...sharedMappings,
+          `  }`,
+          ``,
+          `  interface ModularContainer {`,
+          ...sharedContainerMappings,
+          `  }`,
+          `}`,
+          ``,
+          `export {};`,
+          ``
+        ].join("\n");
+        await fs.writeFile(dtsPath, dtsContent, "utf-8");
+        console.log(`\x1B[32m[ModularPack] Generated declarations: ${path.relative(projectRoot, dtsPath)}\x1B[0m`);
+      } catch (err) {
+        console.warn("[ModularPack] Failed to generate index.d.ts:", err);
+      }
+      if (process.env.MODULAR_OBFUSCATE !== "false") {
+        try {
+          const jsFiles = await searchJsFiles(outputFullPath);
+          for (const file of jsFiles) {
+            let content = await fs.readFile(file, "utf-8");
+            content = content.replace(/process\.env\.NODE_ENV/g, "GLOBAL_VITE_PROCESS_ENV_NODE_ENV");
+            content = content.replace(/import\.meta\.env\.MODE/g, "GLOBAL_VITE_IMPORT_META_ENV_MODE");
+            const obfuscationResult = JavaScriptObfuscator.obfuscate(content, {
+              compact: true,
+              controlFlowFlattening: false,
+              deadCodeInjection: false,
+              identifierNamesGenerator: "hexadecimal",
+              renameGlobals: false,
+              selfDefending: false,
+              stringArray: true,
+              stringArrayEncoding: ["base64"],
+              transformObjectKeys: true,
+              unicodeEscapeSequence: false,
+              reservedStrings: ["\\.\\./assets/.*\\.js$", "\\./assets/.*\\.js$"]
+            });
+            let obfuscatedCode = obfuscationResult.getObfuscatedCode();
+            obfuscatedCode = obfuscatedCode.replace(/GLOBAL_VITE_PROCESS_ENV_NODE_ENV/g, "process.env.NODE_ENV");
+            obfuscatedCode = obfuscatedCode.replace(/GLOBAL_VITE_IMPORT_META_ENV_MODE/g, "import.meta.env.MODE");
+            await fs.writeFile(file, obfuscatedCode, "utf-8");
+          }
+          if (jsFiles.length > 0) {
+            console.log(`\x1B[32m[ModularPack] Obfuscated output JS files successfully!\x1B[0m`);
+          }
+        } catch (err) {
+          console.error("[ModularPack] Error during JS obfuscation:", err);
+        }
+      }
+      let pkg = {};
+      try {
+        const pkgPath = path.resolve(projectRoot, "package.json");
+        pkg = JSON.parse(await fs.readFile(pkgPath, "utf-8"));
+      } catch {
+      }
+      const mergedPeerDeps = {
+        ...pkg.dependencies || {},
+        ...pkg.peerDependencies || {}
+      };
+      const deliveryPkg = {
+        name: pkg.name || "modular-plugin",
+        version: pkg.version || "0.0.1",
+        type: "module",
+        main: "./index.js",
+        module: "./index.js",
+        types: "./index.d.ts",
+        files: ["index.js", "index.d.ts", "assets", "src"],
+        peerDependencies: mergedPeerDeps
+      };
+      try {
+        await fs.writeFile(
+          path.resolve(outputFullPath, "package.json"),
+          JSON.stringify(deliveryPkg, null, 2),
+          "utf-8"
+        );
+      } catch (err) {
+        console.warn("[ModularPack] Failed to generate delivery package.json:", err);
+      }
+      try {
+        await execAsync("npm pack", { cwd: outputFullPath });
+        console.log(`
+\x1B[32m[ModularPack] Successfully built and packed vendor package! (Version: ${deliveryPkg.version})\x1B[0m
+`);
+      } catch (err) {
+        console.warn(`[ModularPack] Failed to execute 'npm pack' in "${outDir}":`, err);
+      }
     }
   };
 }
@@ -107,6 +265,22 @@ var searchIndexTsFiles = async (rootPath) => {
   }
   return result;
 };
+var searchJsFiles = async (dirPath) => {
+  const result = [];
+  try {
+    const entries = await fs.readdir(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path.join(dirPath, entry.name);
+      if (entry.isDirectory()) {
+        result.push(...await searchJsFiles(fullPath));
+      } else if (/\.(js|cjs|mjs)$/.test(entry.name) && !entry.name.includes("worker")) {
+        result.push(fullPath);
+      }
+    }
+  } catch {
+  }
+  return result;
+};
 export {
   modularPackPlugin
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@path-ioc/pack",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Mesh registry distribution bundler & obfuscator for Path-IoC",
   "keywords": [
     "ioc",
@@ -50,11 +50,11 @@
     }
   },
   "devDependencies": {
+    "@path-ioc/unplugin": "0.1.4",
     "@types/node": "^20.0.0",
-    "vite": "^8.2.2",
     "tsup": "^8.0.0",
     "typescript": "^5.4.5",
-    "@path-ioc/unplugin": "0.1.2"
+    "vite": "^8.2.2"
   },
   "scripts": {
     "build": "tsup src/index.ts --format cjs,esm --dts",