@path-ioc/pack 0.1.1

package/README.md

@@ -0,0 +1,93 @@
+<div align="center">
+  <h1>@path-ioc/pack</h1>
+  <p><b>Mesh Registry Distribution Bundler for Path-IoC</b></p>
+  <p>专为微前端、组件库分发与 Mesh 网格化依赖设计的物理打包与发布构建插件</p>
+
+  <p>
+    <a href="https://www.npmjs.com/package/@path-ioc/pack"><img src="https://img.shields.io/npm/v/@path-ioc/pack.svg" alt="NPM version"></a>
+    <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/npm/l/@path-ioc/pack.svg" alt="License"></a>
+    <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-5.0+-3178C6?logo=typescript&logoColor=white" alt="TypeScript"></a>
+    <a href="https://vite.dev"><img src="https://img.shields.io/badge/powered%20by-Vite-646CFF?logo=vite&logoColor=white" alt="Vite"></a>
+  </p>
+</div>
+
+---
+
+## 核心特性 (Features)
+
+- **物理入口自动生成 (Physical Entrypoint Generation)**：
+  在 Vite 构建流程中，自动深度扫描 `src/modules` 下所有包含 `index.ts/tsx` 的物理子目录，并在磁盘上自动生成/更新干净的入口文件（默认 `.modular-plugin-entry.ts`）。
+- **Mesh 注册表与类型全导出**：
+  自动生成统一的模块导入别名与导出，并导出标准运行期注册表数组 `modules`：
+  ```typescript
+  export const modules = [
+    { key: "/math/add", module: _Modular_Mod_0 },
+    { key: "/math/isEven", module: _Modular_Mod_1 },
+  ];
+  ```
+- **静态类型映射提取 (`sharedMappings`)**：
+  自动填充 `sharedMappings` 与 `sharedContainerMappings` 集合，为构建跨包 SDK 或微前端网格映射提供准确的类型描述。
+- **物理隔离与代码混淆兼容**：
+  物理生成的入口文件可直接用于 npm 打包流程，完美兼容各类 AST 物理打散与防篡改混淆工具。
+
+---
+
+## 安装 (Installation)
+
+```bash
+pnpm add -D @path-ioc/pack
+# 或
+npm install -D @path-ioc/pack
+```
+
+---
+
+## 快速上手 (Quick Start)
+
+### Vite 配置 (`vite.config.ts`)
+
+```typescript
+import { defineConfig } from "vite";
+import { modularPackPlugin } from "@path-ioc/pack";
+
+const sharedMappings: string[] = [];
+const sharedContainerMappings: string[] = [];
+
+export default defineConfig({
+  plugins: [
+    modularPackPlugin({
+      modulesPath: "src/modules",
+      // 可选：自定义生成的入口文件路径（默认存放在 node_modules/.path-ioc/.modular-plugin-entry.ts）
+      entryFile: "node_modules/.path-ioc/.modular-plugin-entry.ts",
+      sharedMappings,
+      sharedContainerMappings,
+    }),
+  ],
+});
+```
+
+---
+
+## 配置选项 (PackPluginOptions)
+
+| 配置项 | 类型 | 默认值 | 描述 |
+| :--- | :--- | :--- | :--- |
+| **`modulesPath`** | `string` | `'src/modules'` | 模块扫描的物理根目录路径。 |
+| **`entryFile`** | `string` | `'node_modules/.path-ioc/.modular-plugin-entry.ts'` | 物理生成的入口文件路径。 |
+| **`sharedMappings`** | `string[]` | `[]` *(可选)* | 接收生成的类型映射字符串数组引用。 |
+| **`sharedContainerMappings`** | `string[]` | `[]` *(可选)* | 接收生成的容器类型映射字符串数组引用。 |
+
+---
+
+## 导出的 API
+
+```typescript
+import { modularPackPlugin, type PackPluginOptions } from "@path-ioc/pack";
+```
+
+---
+
+## 开源协议 (License)
+
+Released under the [MIT License](./LICENSE).  
+Copyright © 2026 [Path-IoC Organization](https://github.com/path-ioc) & Lian HanLin.

package/dist/index.cjs

@@ -0,0 +1,147 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  modularPackPlugin: () => modularPackPlugin
+});
+module.exports = __toCommonJS(index_exports);
+var import_node_path = __toESM(require("path"), 1);
+var import_promises = __toESM(require("fs/promises"), 1);
+var import_lodash_es = require("lodash-es");
+function modularPackPlugin({
+  modulesPath = "src/modules",
+  entryFile = "node_modules/.path-ioc/.modular-plugin-entry.ts",
+  sharedMappings = [],
+  sharedContainerMappings = []
+} = {}) {
+  let projectRoot;
+  return {
+    name: "vite-plugin-modular-pack",
+    enforce: "pre",
+    async config(config) {
+      projectRoot = import_node_path.default.resolve(config.root || process.cwd());
+      const modulesRoot = import_node_path.default.resolve(projectRoot, modulesPath);
+      const 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);
+      const entryLines = [];
+      const runtimeModulesArray = [];
+      sharedMappings.length = 0;
+      sharedContainerMappings.length = 0;
+      const moduleFullNames = [];
+      const moduleNames = [];
+      const aliases = [];
+      const shortNameCountMap = /* @__PURE__ */ new Map();
+      absoluteFolders.forEach((absolutePath, index) => {
+        const dirPath = import_node_path.default.dirname(absolutePath);
+        let importRelPath = import_node_path.default.relative(entryFileDir, dirPath).replace(/\\/g, "/");
+        if (!importRelPath.startsWith(".")) {
+          importRelPath = "./" + importRelPath;
+        }
+        const logicalPath = import_node_path.default.relative(modulesRoot, dirPath).replace(/\\/g, "/");
+        const folderName = logicalPath.split("/").pop();
+        if (!folderName) return;
+        const moduleName = folderName.charAt(0) + (0, import_lodash_es.camelCase)(folderName).slice(1);
+        const logicalDir = logicalPath.substring(0, logicalPath.lastIndexOf(folderName));
+        const moduleFullName = `/${logicalDir}${moduleName}`;
+        const alias = `_Modular_Mod_${index}`;
+        entryLines.push(`import * as ${alias} from '${importRelPath}/index';`);
+        entryLines.push(`export { ${alias} };`);
+        moduleFullNames.push(moduleFullName);
+        moduleNames.push(moduleName);
+        aliases.push(alias);
+        if (!shortNameCountMap.has(moduleName)) {
+          shortNameCountMap.set(moduleName, [moduleFullName]);
+        } else {
+          shortNameCountMap.get(moduleName).push(moduleFullName);
+        }
+        runtimeModulesArray.push(`  { key: "${moduleFullName}", module: ${alias} }`);
+      });
+      const namePushedSet = /* @__PURE__ */ new Set();
+      moduleFullNames.forEach((moduleFullName, i) => {
+        const alias = aliases[i];
+        const moduleName = moduleNames[i];
+        if (!namePushedSet.has(moduleFullName)) {
+          namePushedSet.add(moduleFullName);
+          sharedMappings.push(`    "${moduleFullName}": typeof ${alias};`);
+          sharedContainerMappings.push(`    "${moduleFullName}": Awaited<ReturnType<typeof ${alias}["main"]>>;`);
+        }
+        const countList = shortNameCountMap.get(moduleName);
+        if (countList && countList.length === 1 && !namePushedSet.has(moduleName)) {
+          namePushedSet.add(moduleName);
+          sharedMappings.push(`    "${moduleName}": typeof ${alias};`);
+          sharedContainerMappings.push(`    "${moduleName}": Awaited<ReturnType<typeof ${alias}["main"]>>;`);
+        }
+      });
+      entryLines.push(`
+// --- Runtime Exports ---`);
+      entryLines.push(`export const modules = [`);
+      entryLines.push(runtimeModulesArray.join(",\n"));
+      entryLines.push(`];
+`);
+      await import_promises.default.writeFile(entryFilePath, entryLines.join("\n"), "utf-8");
+      console.log(`\x1B[32m[ModularPack] Generated physical entry file: ${entryFile}\x1B[0m`);
+    }
+  };
+}
+var searchIndexTsFiles = async (rootPath) => {
+  try {
+    await import_promises.default.access(rootPath);
+  } catch {
+    return [];
+  }
+  const dirsToScan = [rootPath];
+  const result = [];
+  while (dirsToScan.length > 0) {
+    const currentDir = dirsToScan.shift();
+    if (!currentDir) continue;
+    try {
+      const entries = await import_promises.default.readdir(currentDir);
+      for (const entry of entries) {
+        if (entry === "node_modules" || entry.startsWith(".")) continue;
+        const fullPath = import_node_path.default.join(currentDir, entry);
+        const stats = await import_promises.default.stat(fullPath);
+        if (stats.isDirectory()) {
+          dirsToScan.push(fullPath);
+        } else if (["index.ts", "index.tsx"].includes(entry)) {
+          result.push(fullPath);
+        }
+      }
+    } catch (e) {
+    }
+  }
+  return result;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  modularPackPlugin
+});

package/dist/index.d.cts

@@ -0,0 +1,12 @@
+import { Plugin } from 'vite';
+
+interface PackPluginOptions {
+    modulesPath?: string;
+    entryFile?: string;
+    sharedMappings?: string[];
+    sharedContainerMappings?: string[];
+}
+type ModularPackPlugin = Pick<Plugin, "name" | "enforce" | "config">;
+declare function modularPackPlugin({ modulesPath, entryFile, sharedMappings, sharedContainerMappings, }?: PackPluginOptions): ModularPackPlugin;
+
+export { type ModularPackPlugin, type PackPluginOptions, modularPackPlugin };

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { Plugin } from 'vite';
+
+interface PackPluginOptions {
+    modulesPath?: string;
+    entryFile?: string;
+    sharedMappings?: string[];
+    sharedContainerMappings?: string[];
+}
+type ModularPackPlugin = Pick<Plugin, "name" | "enforce" | "config">;
+declare function modularPackPlugin({ modulesPath, entryFile, sharedMappings, sharedContainerMappings, }?: PackPluginOptions): ModularPackPlugin;
+
+export { type ModularPackPlugin, type PackPluginOptions, modularPackPlugin };

package/dist/index.js

@@ -0,0 +1,112 @@
+// src/index.ts
+import path from "path";
+import fs from "fs/promises";
+import { camelCase } from "lodash-es";
+function modularPackPlugin({
+  modulesPath = "src/modules",
+  entryFile = "node_modules/.path-ioc/.modular-plugin-entry.ts",
+  sharedMappings = [],
+  sharedContainerMappings = []
+} = {}) {
+  let projectRoot;
+  return {
+    name: "vite-plugin-modular-pack",
+    enforce: "pre",
+    async config(config) {
+      projectRoot = path.resolve(config.root || process.cwd());
+      const modulesRoot = path.resolve(projectRoot, modulesPath);
+      const entryFilePath = path.resolve(projectRoot, entryFile);
+      const entryFileDir = path.dirname(entryFilePath);
+      await fs.mkdir(entryFileDir, { recursive: true });
+      const absoluteFolders = await searchIndexTsFiles(modulesRoot);
+      const entryLines = [];
+      const runtimeModulesArray = [];
+      sharedMappings.length = 0;
+      sharedContainerMappings.length = 0;
+      const moduleFullNames = [];
+      const moduleNames = [];
+      const aliases = [];
+      const shortNameCountMap = /* @__PURE__ */ new Map();
+      absoluteFolders.forEach((absolutePath, index) => {
+        const dirPath = path.dirname(absolutePath);
+        let importRelPath = path.relative(entryFileDir, dirPath).replace(/\\/g, "/");
+        if (!importRelPath.startsWith(".")) {
+          importRelPath = "./" + importRelPath;
+        }
+        const logicalPath = path.relative(modulesRoot, dirPath).replace(/\\/g, "/");
+        const folderName = logicalPath.split("/").pop();
+        if (!folderName) return;
+        const moduleName = folderName.charAt(0) + camelCase(folderName).slice(1);
+        const logicalDir = logicalPath.substring(0, logicalPath.lastIndexOf(folderName));
+        const moduleFullName = `/${logicalDir}${moduleName}`;
+        const alias = `_Modular_Mod_${index}`;
+        entryLines.push(`import * as ${alias} from '${importRelPath}/index';`);
+        entryLines.push(`export { ${alias} };`);
+        moduleFullNames.push(moduleFullName);
+        moduleNames.push(moduleName);
+        aliases.push(alias);
+        if (!shortNameCountMap.has(moduleName)) {
+          shortNameCountMap.set(moduleName, [moduleFullName]);
+        } else {
+          shortNameCountMap.get(moduleName).push(moduleFullName);
+        }
+        runtimeModulesArray.push(`  { key: "${moduleFullName}", module: ${alias} }`);
+      });
+      const namePushedSet = /* @__PURE__ */ new Set();
+      moduleFullNames.forEach((moduleFullName, i) => {
+        const alias = aliases[i];
+        const moduleName = moduleNames[i];
+        if (!namePushedSet.has(moduleFullName)) {
+          namePushedSet.add(moduleFullName);
+          sharedMappings.push(`    "${moduleFullName}": typeof ${alias};`);
+          sharedContainerMappings.push(`    "${moduleFullName}": Awaited<ReturnType<typeof ${alias}["main"]>>;`);
+        }
+        const countList = shortNameCountMap.get(moduleName);
+        if (countList && countList.length === 1 && !namePushedSet.has(moduleName)) {
+          namePushedSet.add(moduleName);
+          sharedMappings.push(`    "${moduleName}": typeof ${alias};`);
+          sharedContainerMappings.push(`    "${moduleName}": Awaited<ReturnType<typeof ${alias}["main"]>>;`);
+        }
+      });
+      entryLines.push(`
+// --- Runtime Exports ---`);
+      entryLines.push(`export const modules = [`);
+      entryLines.push(runtimeModulesArray.join(",\n"));
+      entryLines.push(`];
+`);
+      await fs.writeFile(entryFilePath, entryLines.join("\n"), "utf-8");
+      console.log(`\x1B[32m[ModularPack] Generated physical entry file: ${entryFile}\x1B[0m`);
+    }
+  };
+}
+var searchIndexTsFiles = async (rootPath) => {
+  try {
+    await fs.access(rootPath);
+  } catch {
+    return [];
+  }
+  const dirsToScan = [rootPath];
+  const result = [];
+  while (dirsToScan.length > 0) {
+    const currentDir = dirsToScan.shift();
+    if (!currentDir) continue;
+    try {
+      const entries = await fs.readdir(currentDir);
+      for (const entry of entries) {
+        if (entry === "node_modules" || entry.startsWith(".")) continue;
+        const fullPath = path.join(currentDir, entry);
+        const stats = await fs.stat(fullPath);
+        if (stats.isDirectory()) {
+          dirsToScan.push(fullPath);
+        } else if (["index.ts", "index.tsx"].includes(entry)) {
+          result.push(fullPath);
+        }
+      }
+    } catch (e) {
+    }
+  }
+  return result;
+};
+export {
+  modularPackPlugin
+};

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@path-ioc/pack",
+  "version": "0.1.1",
+  "description": "Mesh registry distribution bundler & obfuscator for Path-IoC",
+  "keywords": [
+    "ioc",
+    "bundler",
+    "obfuscator",
+    "distribution",
+    "vite-plugin"
+  ],
+  "homepage": "https://path-ioc.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/path-ioc/path-ioc.git",
+    "directory": "packages/pack"
+  },
+  "bugs": {
+    "url": "https://github.com/path-ioc/path-ioc/issues"
+  },
+  "author": "Lian HanLin",
+  "license": "MIT",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "javascript-obfuscator": "^4.1.0",
+    "lodash-es": "^4.17.21"
+  },
+  "peerDependencies": {
+    "vite": "*"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "vite": "^8.2.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.5",
+    "@path-ioc/unplugin": "0.1.1"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch"
+  }
+}