@infly/libs 2.0.49 → 2.0.51

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infly/libs",
-  "version": "2.0.49",
+  "version": "2.0.51",
   "description": "不受前端框架限制的独立工具库",
   "main": "index.js",
   "types": "index.d.ts",
@@ -8,12 +8,16 @@
     "index.js",
     "bin/",
     "compat/",
+    "core/",
+    "cli/",
     "adapters/vue2/",
+    "adapters/webpack/",
     "build/",
     "module/",
     "script/git-automation/",
     "script/index.js",
-    "tools/",
+    "release/",
+    "workspace/",
     "README.md",
     "LICENSE",
     "!**/*.test.js",
@@ -39,11 +43,21 @@
   },
   "exports": {
     ".": "./index.js",
+    "./build": "./build/index.js",
+    "./concurrency": "./core/async/concurrency.js",
+    "./progress": "./cli/progress.js",
+    "./npm-release": "./release/npm-plan.js",
+    "./workspace-packages": "./workspace/packages.js",
+    "./workspace-config": "./workspace/config.js",
+    "./cli/project-command": "./cli/project-command.js",
+    "./cli/select-option": "./cli/select-option.js",
+    "./adapters/webpack/auto-export": "./adapters/webpack/auto-export.js",
+    "./git/configure": "./script/git-automation/git-configure.js",
+    "./git/submodule-status": "./script/git-automation/submodule-status.js",
+    "./git/submodules": "./script/git-automation/submodule-utils.js",
     "./adapters/vue2/*": "./adapters/vue2/*",
-    "./adapters/vue2/build/*": "./adapters/vue2/build/*",
     "./module/*": "./module/*",
     "./store/*": "./adapters/vue2/store/*",
-    "./tools/*": "./tools/*",
     "./build/*": "./build/*",
     "./build/build-utils/*": "./build/build-utils/*",
     "./script/git-automation/*": "./script/git-automation/*"
@@ -60,7 +74,7 @@
   "author": "Kahal",
   "license": "ISC",
   "dependencies": {
-    "@infly/ts-libs": "workspace:*",
+    "@infly/ts-libs": "^0.1.12",
     "connect": "^3.7.0",
     "dotenv": "16.6.1",
     "enquirer": "^2.4.1",

package/release/npm-plan.js

@@ -0,0 +1,51 @@
+// 无副作用的 npm 稳定版本与发布计划计算。
+function parseStableVersion(version) {
+  const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(String(version));
+  if (!match) throw new Error(`不支持的版本号: ${version}`);
+  return match.slice(1).map(Number);
+}
+
+function bumpPatch(version) {
+  const parts = parseStableVersion(version);
+  parts[2] += 1;
+  return parts.join(".");
+}
+
+function compareVersions(left, right) {
+  const a = parseStableVersion(left);
+  const b = parseStableVersion(right);
+  for (let index = 0; index < 3; index += 1) {
+    if (a[index] !== b[index]) return a[index] > b[index] ? 1 : -1;
+  }
+  return 0;
+}
+
+function buildReleasePlan(packages, registryVersions, options = {}) {
+  const prepared = Boolean(options.prepared);
+  return packages.map((pkg) => {
+    const registryVersion = registryVersions[pkg.name];
+    // registryVersion 为空表示包从未发布（npm view 404），按首次发布处理：
+    // 直接发布本地版本，不做 patch bump，也无需写回 package.json
+    if (!registryVersion) {
+      return {
+        ...pkg,
+        registryVersion: null,
+        targetVersion: pkg.version,
+        needsVersionWrite: false,
+        isFirstRelease: true,
+      };
+    }
+    const comparison = compareVersions(pkg.version, registryVersion);
+    if (comparison < 0) {
+      throw new Error(`${pkg.name} 本地版本 ${pkg.version} 落后于 npm ${registryVersion}`);
+    }
+    return {
+      ...pkg,
+      registryVersion,
+      targetVersion: comparison === 0 && !prepared ? bumpPatch(pkg.version) : pkg.version,
+      needsVersionWrite: comparison === 0 && !prepared,
+    };
+  });
+}
+
+module.exports = { buildReleasePlan, bumpPatch, compareVersions, parseStableVersion };

package/script/git-automation/submodule-utils.js

@@ -1,18 +1,22 @@
-const fs = require("fs");
-
-/**
- * 从 .gitmodules 中解析所有子模块路径
- */
-function parseGitmodulesPaths(rootDir) {
-  const p = require("path").join(rootDir, ".gitmodules");
-  if (!fs.existsSync(p)) return [];
-  const content = fs.readFileSync(p, "utf8");
-  const paths = [];
-  content.split(/\[submodule/).forEach((block) => {
-    const m = block.match(/path\s*=\s*(.+)/);
-    if (m) paths.push(m[1].trim());
-  });
-  return paths;
-}
-
-module.exports = { parseGitmodulesPaths };
+const fs = require("fs");
+
+function normalizeRelativePath(value) {
+  return String(value).replace(/\\/g, "/");
+}
+
+/**
+ * 从 .gitmodules 中解析所有子模块路径
+ */
+function parseGitmodulesPaths(rootDir) {
+  const p = require("path").join(rootDir, ".gitmodules");
+  if (!fs.existsSync(p)) return [];
+  const content = fs.readFileSync(p, "utf8");
+  const paths = [];
+  content.split(/\[submodule/).forEach((block) => {
+    const m = block.match(/path\s*=\s*(.+)/);
+    if (m) paths.push(m[1].trim());
+  });
+  return paths;
+}
+
+module.exports = { normalizeRelativePath, parseGitmodulesPaths };

package/{tools/workspace-config.js → workspace/config.js}

@@ -1,145 +1,146 @@
-const fs = require("fs");
-const path = require("path");
-const YAML = require("yaml");
-
-function readJson(filePath) {
-  return JSON.parse(fs.readFileSync(filePath, "utf8"));
-}
-
-function readWorkspaceList(content, sectionName) {
-  let workspaceConfig;
-
-  try {
-    workspaceConfig = YAML.parse(content);
-  } catch (error) {
-    throw new Error(`无法解析 pnpm-workspace.yaml: ${error.message}`, { cause: error });
-  }
-
-  if (workspaceConfig == null) {
-    return [];
-  }
-
-  if (typeof workspaceConfig !== "object" || Array.isArray(workspaceConfig)) {
-    throw new TypeError("pnpm-workspace.yaml 的根节点必须是对象");
-  }
-
-  const patterns = workspaceConfig[sectionName];
-
-  if (patterns == null) {
-    return [];
-  }
-
-  if (
-    !Array.isArray(patterns)
-    || patterns.some((pattern) => typeof pattern !== "string" || pattern.trim().length === 0)
-  ) {
-    throw new TypeError(`pnpm-workspace.yaml 的 ${sectionName} 必须是非空字符串数组`);
-  }
-
-  return patterns;
-}
-
-function readWorkspaceSection(workspaceFile, sectionName) {
-  return readWorkspaceList(fs.readFileSync(workspaceFile, "utf8"), sectionName);
-}
-
-function readWorkspaceSectionWithFallback(workspaceFile, sectionName, fallbackSectionName) {
-  const patterns = readWorkspaceSection(workspaceFile, sectionName);
-
-  if (patterns.length > 0) {
-    return patterns;
-  }
-
-  return readWorkspaceSection(workspaceFile, fallbackSectionName);
-}
-
-function expandWorkspacePattern(rootDir, pattern) {
-  const normalizedPattern = pattern.replace(/\\/g, "/");
-
-  if (!normalizedPattern.includes("*")) {
-    return [path.join(rootDir, normalizedPattern)];
-  }
-
-  const starIndex = normalizedPattern.indexOf("*");
-  const basePart = normalizedPattern.slice(0, starIndex);
-  const suffixPart = normalizedPattern.slice(starIndex + 1);
-  const baseDir = path.join(rootDir, basePart);
-
-  if (!fs.existsSync(baseDir)) {
-    return [];
-  }
-
-  const suffixIsNamePattern = suffixPart && !suffixPart.startsWith("/");
-
-  return fs
-    .readdirSync(baseDir, { withFileTypes: true })
-    .filter((entry) => entry.isDirectory())
-    .filter((entry) => !suffixIsNamePattern || entry.name.endsWith(suffixPart))
-    .map((entry) => (suffixIsNamePattern
-      ? path.join(baseDir, entry.name)
-      : path.join(baseDir, entry.name, suffixPart)))
-    .filter((packageDir) => fs.existsSync(path.join(packageDir, "package.json")));
-}
-
-function getWorkspacePackages(rootDir, workspaceFile, sectionName, fallbackSectionName, scriptName) {
-  const patterns = fallbackSectionName
-    ? readWorkspaceSectionWithFallback(workspaceFile, sectionName, fallbackSectionName)
-    : readWorkspaceSection(workspaceFile, sectionName);
-  const included = new Set();
-  patterns.forEach((pattern) => {
-    const excluded = pattern.startsWith("!");
-    const resolvedPattern = excluded ? pattern.slice(1) : pattern;
-    expandWorkspacePattern(rootDir, resolvedPattern).forEach((packageDir) => {
-      const resolvedDir = path.resolve(packageDir);
-      if (excluded) included.delete(resolvedDir);
-      else included.add(resolvedDir);
-    });
-  });
-  const packageDirs = [...included];
-  const seen = new Set();
-
-  return packageDirs
-    .map((packageDir) => {
-      const packageJsonPath = path.join(packageDir, "package.json");
-
-      if (!fs.existsSync(packageJsonPath)) {
-        return null;
-      }
-
-      const packageJson = readJson(packageJsonPath);
-      const scripts = packageJson.scripts || {};
-
-      if (!packageJson.name || seen.has(packageJson.name) || (scriptName && !scripts[scriptName])) {
-        return null;
-      }
-
-      seen.add(packageJson.name);
-
-      return {
-        name: packageJson.name,
-        dir: path.relative(rootDir, packageDir),
-        packageJson,
-      };
-    })
-    .filter(Boolean);
-}
-
-function toTurboFilter(value) {
-  const normalized = value.replace(/\\/g, "/");
-
-  if (normalized.includes("/") && !normalized.startsWith("./") && !normalized.startsWith("../")) {
-    return `./${normalized}`;
-  }
-
-  return normalized;
-}
-
-module.exports = {
-  expandWorkspacePattern,
-  getWorkspacePackages,
-  readJson,
-  readWorkspaceList,
-  readWorkspaceSection,
-  readWorkspaceSectionWithFallback,
-  toTurboFilter,
-};
+// workspace 配置读取与模式展开。
+const fs = require("fs");
+const path = require("path");
+const YAML = require("yaml");
+
+function readJson(filePath) {
+  return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+
+function readWorkspaceList(content, sectionName) {
+  let workspaceConfig;
+
+  try {
+    workspaceConfig = YAML.parse(content);
+  } catch (error) {
+    throw new Error(`无法解析 pnpm-workspace.yaml: ${error.message}`, { cause: error });
+  }
+
+  if (workspaceConfig == null) {
+    return [];
+  }
+
+  if (typeof workspaceConfig !== "object" || Array.isArray(workspaceConfig)) {
+    throw new TypeError("pnpm-workspace.yaml 的根节点必须是对象");
+  }
+
+  const patterns = workspaceConfig[sectionName];
+
+  if (patterns == null) {
+    return [];
+  }
+
+  if (
+    !Array.isArray(patterns)
+    || patterns.some((pattern) => typeof pattern !== "string" || pattern.trim().length === 0)
+  ) {
+    throw new TypeError(`pnpm-workspace.yaml 的 ${sectionName} 必须是非空字符串数组`);
+  }
+
+  return patterns;
+}
+
+function readWorkspaceSection(workspaceFile, sectionName) {
+  return readWorkspaceList(fs.readFileSync(workspaceFile, "utf8"), sectionName);
+}
+
+function readWorkspaceSectionWithFallback(workspaceFile, sectionName, fallbackSectionName) {
+  const patterns = readWorkspaceSection(workspaceFile, sectionName);
+
+  if (patterns.length > 0) {
+    return patterns;
+  }
+
+  return readWorkspaceSection(workspaceFile, fallbackSectionName);
+}
+
+function expandWorkspacePattern(rootDir, pattern) {
+  const normalizedPattern = pattern.replace(/\\/g, "/");
+
+  if (!normalizedPattern.includes("*")) {
+    return [path.join(rootDir, normalizedPattern)];
+  }
+
+  const starIndex = normalizedPattern.indexOf("*");
+  const basePart = normalizedPattern.slice(0, starIndex);
+  const suffixPart = normalizedPattern.slice(starIndex + 1);
+  const baseDir = path.join(rootDir, basePart);
+
+  if (!fs.existsSync(baseDir)) {
+    return [];
+  }
+
+  const suffixIsNamePattern = suffixPart && !suffixPart.startsWith("/");
+
+  return fs
+    .readdirSync(baseDir, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .filter((entry) => !suffixIsNamePattern || entry.name.endsWith(suffixPart))
+    .map((entry) => (suffixIsNamePattern
+      ? path.join(baseDir, entry.name)
+      : path.join(baseDir, entry.name, suffixPart)))
+    .filter((packageDir) => fs.existsSync(path.join(packageDir, "package.json")));
+}
+
+function getWorkspacePackages(rootDir, workspaceFile, sectionName, fallbackSectionName, scriptName) {
+  const patterns = fallbackSectionName
+    ? readWorkspaceSectionWithFallback(workspaceFile, sectionName, fallbackSectionName)
+    : readWorkspaceSection(workspaceFile, sectionName);
+  const included = new Set();
+  patterns.forEach((pattern) => {
+    const excluded = pattern.startsWith("!");
+    const resolvedPattern = excluded ? pattern.slice(1) : pattern;
+    expandWorkspacePattern(rootDir, resolvedPattern).forEach((packageDir) => {
+      const resolvedDir = path.resolve(packageDir);
+      if (excluded) included.delete(resolvedDir);
+      else included.add(resolvedDir);
+    });
+  });
+  const packageDirs = [...included];
+  const seen = new Set();
+
+  return packageDirs
+    .map((packageDir) => {
+      const packageJsonPath = path.join(packageDir, "package.json");
+
+      if (!fs.existsSync(packageJsonPath)) {
+        return null;
+      }
+
+      const packageJson = readJson(packageJsonPath);
+      const scripts = packageJson.scripts || {};
+
+      if (!packageJson.name || seen.has(packageJson.name) || (scriptName && !scripts[scriptName])) {
+        return null;
+      }
+
+      seen.add(packageJson.name);
+
+      return {
+        name: packageJson.name,
+        dir: path.relative(rootDir, packageDir),
+        packageJson,
+      };
+    })
+    .filter(Boolean);
+}
+
+function toTurboFilter(value) {
+  const normalized = value.replace(/\\/g, "/");
+
+  if (normalized.includes("/") && !normalized.startsWith("./") && !normalized.startsWith("../")) {
+    return `./${normalized}`;
+  }
+
+  return normalized;
+}
+
+module.exports = {
+  expandWorkspacePattern,
+  getWorkspacePackages,
+  readJson,
+  readWorkspaceList,
+  readWorkspaceSection,
+  readWorkspaceSectionWithFallback,
+  toTurboFilter,
+};

package/workspace/packages.js

@@ -0,0 +1,91 @@
+// workspace 包发现、依赖图与变更影响计算。
+const fs = require("node:fs");
+const path = require("node:path");
+
+const DEPENDENCY_SECTIONS = [
+  "dependencies",
+  "devDependencies",
+  "peerDependencies",
+  "optionalDependencies",
+];
+
+function normalizeWorkspacePath(filePath) {
+  return String(filePath || "").replace(/\\/g, "/").replace(/^\.\//, "");
+}
+
+function discoverWorkspacePackages(rootDir, options = {}) {
+  const packagesDirectory = options.packagesDirectory || "packages";
+  const packagesDir = path.join(rootDir, packagesDirectory);
+  const include = options.include || (() => true);
+
+  const packages = fs.readdirSync(packagesDir, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => {
+      const directoryPath = path.join(packagesDir, entry.name);
+      const manifestPath = path.join(directoryPath, "package.json");
+      if (!fs.existsSync(manifestPath)) return null;
+      const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+      const pkg = {
+        dir: entry.name,
+        directoryPath,
+        manifest,
+        manifestPath,
+        name: manifest.name,
+        relativeDir: normalizeWorkspacePath(path.join(packagesDirectory, entry.name)),
+        version: manifest.version,
+      };
+      return include(pkg) ? pkg : null;
+    })
+    .filter(Boolean);
+  return options.sort === false
+    ? packages
+    : packages.sort((left, right) => left.relativeDir.localeCompare(right.relativeDir));
+}
+
+function getInternalDependencies(pkg, packageNames) {
+  const dependencies = new Set();
+  for (const section of DEPENDENCY_SECTIONS) {
+    for (const dependencyName of Object.keys(pkg.manifest?.[section] || {})) {
+      if (packageNames.has(dependencyName)) dependencies.add(dependencyName);
+    }
+  }
+  return dependencies;
+}
+
+function selectAffectedWorkspacePackages(changedPaths, packages, options = {}) {
+  const normalizedPaths = changedPaths.map(normalizeWorkspacePath).filter(Boolean);
+  const isGlobalChange = options.isGlobalChange || (() => false);
+  if (normalizedPaths.some(isGlobalChange)) return [...packages];
+
+  const selectedNames = new Set();
+  for (const pkg of packages) {
+    const relativeDir = normalizeWorkspacePath(pkg.relativeDir || `packages/${pkg.dir}`);
+    if (normalizedPaths.some((filePath) => filePath.startsWith(`${relativeDir}/`))) {
+      selectedNames.add(pkg.name);
+    }
+  }
+
+  const packageNames = new Set(packages.map((pkg) => pkg.name));
+  let changed = true;
+  while (changed) {
+    changed = false;
+    for (const pkg of packages) {
+      if (selectedNames.has(pkg.name)) continue;
+      const dependencies = getInternalDependencies(pkg, packageNames);
+      if ([...dependencies].some((dependency) => selectedNames.has(dependency))) {
+        selectedNames.add(pkg.name);
+        changed = true;
+      }
+    }
+  }
+
+  return packages.filter((pkg) => selectedNames.has(pkg.name));
+}
+
+module.exports = {
+  DEPENDENCY_SECTIONS,
+  discoverWorkspacePackages,
+  getInternalDependencies,
+  normalizeWorkspacePath,
+  selectAffectedWorkspacePackages,
+};

package/adapters/vue2/vite/index.js

@@ -1,95 +0,0 @@
-const fs = require("node:fs");
-const path = require("node:path");
-
-function findAdminMonorepoRoot(startDir = process.cwd()) {
-  let directory = path.resolve(startDir);
-  for (;;) {
-    if (
-      fs.existsSync(path.join(directory, "pnpm-workspace.yaml"))
-      && fs.existsSync(path.join(directory, "configs/vite-configs/registry.js"))
-    ) return directory;
-    const parent = path.dirname(directory);
-    if (parent === directory) return null;
-    directory = parent;
-  }
-}
-
-function resolveAppScssImport(importPath, importer, appRoot) {
-  const cleanImporter = importer.replace(/[?#].*$/, "");
-  if (importPath.startsWith("@/")) {
-    return path.resolve(appRoot, "src", importPath.slice(2));
-  }
-  if (importPath.startsWith("./") || importPath.startsWith("../")) {
-    return path.resolve(path.dirname(cleanImporter), importPath);
-  }
-  if (path.isAbsolute(importPath)) return path.resolve(importPath);
-  return null;
-}
-
-function transformScssExportImports(code, importer, options) {
-  const { appRoot, readFile = (file) => fs.readFileSync(file, "utf8") } = options;
-  return code.replace(
-    /import\s+([\w$]+)\s+from\s+(["'])([^"'?]+\.scss)\2\s*;?/g,
-    (statement, binding, quote, importPath) => {
-      const resolved = resolveAppScssImport(importPath, importer, appRoot);
-      if (!resolved) return statement;
-      let scss;
-      try {
-        scss = readFile(resolved);
-      } catch (_) {
-        return statement;
-      }
-      if (typeof scss !== "string") return statement;
-      const exportBlock = scss.match(/:export\s*\{([\s\S]*?)\}/);
-      if (!exportBlock) return statement;
-
-      const variables = new Map();
-      for (const match of scss.matchAll(/^\s*\$([\w-]+)\s*:\s*([^;]+);/gm)) {
-        variables.set(match[1], match[2].trim());
-      }
-      const exported = {};
-      for (const match of exportBlock[1].matchAll(/([\w-]+)\s*:\s*([^;]+);/g)) {
-        const rawValue = match[2].trim();
-        const variableName = rawValue.match(/^\$([\w-]+)$/);
-        exported[match[1]] = variableName && variables.has(variableName[1])
-          ? variables.get(variableName[1])
-          : rawValue;
-      }
-      return `import ${quote}${importPath}${quote};\nconst ${binding} = ${JSON.stringify(exported)};`;
-    },
-  );
-}
-
-function createScssExportCompatPlugin(appRoot) {
-  return {
-    name: "infly-vue2:scss-export-compat",
-    enforce: "pre",
-    transform(code, id) {
-      if (
-        id.includes("node_modules")
-        || (!id.includes(".vue") && !/\.[cm]?[jt]sx?(?:[?#].*)?$/.test(id))
-        || !/import\s+[\w$]+\s+from\s+["'][^"']+\.scss["']/.test(code)
-      ) return null;
-      const transformed = transformScssExportImports(code, id, { appRoot });
-      return transformed === code ? null : { code: transformed, map: null };
-    },
-  };
-}
-
-function addAppRootSassLoadPath(css, appRoot) {
-  if (!css.preprocessorOptions) css.preprocessorOptions = {};
-  if (!css.preprocessorOptions.scss) css.preprocessorOptions.scss = {};
-  const loadPaths = css.preprocessorOptions.scss.loadPaths || [];
-  const resolvedAppRoot = path.resolve(appRoot);
-  css.preprocessorOptions.scss.loadPaths = loadPaths.includes(resolvedAppRoot)
-    ? loadPaths
-    : [...loadPaths, resolvedAppRoot];
-  return css;
-}
-
-module.exports = {
-  addAppRootSassLoadPath,
-  findAdminMonorepoRoot,
-  transformScssExportImports,
-  createScssExportCompatPlugin,
-};

package/adapters/vue2/vite/jest.config.js

@@ -1,11 +0,0 @@
-module.exports = {
-  moduleFileExtensions: ["js", "json", "vue"],
-  moduleNameMapper: {
-    "^@/(.*)$": "<rootDir>/src/$1",
-  },
-  testEnvironment: "jsdom",
-  transform: {
-    "^.+\\.js$": "babel-jest",
-    ".*\\.(vue)$": "@vue/vue2-jest",
-  },
-};