@hzab/vite-config 0.0.2-alpha.0 → 0.0.3-alpha.1

package/dist/index.js

@@ -7,7 +7,7 @@ import { execFileSync } from 'child_process';
 import fs from 'fs';
 import path from 'path';
 import babel from '@rolldown/plugin-babel';
-import fs2 from 'fs/promises';
+import fs2, { rm, readFile, writeFile } from 'fs/promises';
 
 // src/create-app-vite-config.ts
 function resolveCopyPluginOptions(options) {
@@ -16,42 +16,157 @@ function resolveCopyPluginOptions(options) {
 function copyPlugin(options) {
   return viteStaticCopy(resolveCopyPluginOptions(options));
 }
-var HASH_BUILD_DIR_PATTERN = /^(?:[0-9a-f]{12}|local)-(\d{4}-\d{2}-\d{2}-\d{2}-\d{2}-\d{2}|\d+)$/;
-function parseHashTimestamp(value) {
-  if (/^\d+$/.test(value)) return Number(value);
-  const [year = 0, month = 1, day = 1, hour = 0, minute = 0, second = 0] = value.split("-").map(Number);
-  return new Date(year, month - 1, day, hour, minute, second).getTime();
+
+// src/plugins/hash-dir-name.ts
+var tokenPattern = () => /YYYY|SSS|MM|DD|HH|mm|ss|timestamp|hash/g;
+var DATE_TOKEN_WIDTH = { YYYY: 4, MM: 2, DD: 2, HH: 2, mm: 2, ss: 2, SSS: 3 };
+var DATE_TOKEN_SLOT = {
+  YYYY: "year",
+  MM: "month",
+  DD: "day",
+  HH: "hour",
+  mm: "minute",
+  ss: "second",
+  SSS: "millisecond"
+};
+var TIME_TOKENS = ["timestamp", "YYYY", "MM", "DD", "HH", "mm", "ss", "SSS"];
+var AVAILABLE_TOKENS = ["hash", ...TIME_TOKENS];
+var DEFAULT_HASH_DIR_NAME_PATTERN = "hash-timestamp";
+var ILLEGAL_DIR_CHAR_PATTERN = /[\\/:*?"<>|]/;
+var pad = (value, length = 2) => String(value).padStart(length, "0");
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function assertPatternValue(pattern) {
+  if (pattern.trim() === "") {
+    throw new Error("[vite-config] hashDirName must be a non-empty string.");
+  }
 }
-function padTwo(value) {
-  return String(value).padStart(2, "0");
+function assertSafeDirName(dirName, pattern) {
+  const unsafe = ILLEGAL_DIR_CHAR_PATTERN.test(dirName) || dirName.includes("..") || dirName.startsWith(".") || dirName.endsWith(".") || dirName !== dirName.trim();
+  if (unsafe) {
+    throw new Error(
+      `[vite-config] hashDirName "${pattern}" resolves to unsafe directory name "${dirName}".`
+    );
+  }
 }
-function formatHashTimestamp(now, format = "epoch") {
-  if (format !== "datetime") return String(now);
+function expandHashDirName(options) {
+  const { pattern, commitHash, now = Date.now() } = options;
+  assertPatternValue(pattern);
   const date = new Date(now);
-  return [
-    date.getFullYear(),
-    padTwo(date.getMonth() + 1),
-    padTwo(date.getDate()),
-    padTwo(date.getHours()),
-    padTwo(date.getMinutes()),
-    padTwo(date.getSeconds())
-  ].join("-");
-}
-function cleanupOldHashBuilds(deployRoot, currentBuildDir, keep) {
+  const values = {
+    hash: commitHash || "local",
+    timestamp: String(now),
+    YYYY: String(date.getFullYear()),
+    MM: pad(date.getMonth() + 1),
+    DD: pad(date.getDate()),
+    HH: pad(date.getHours()),
+    mm: pad(date.getMinutes()),
+    ss: pad(date.getSeconds()),
+    SSS: pad(date.getMilliseconds(), 3)
+  };
+  let timeMatched = false;
+  const dirName = pattern.replace(tokenPattern(), (token) => {
+    if (TIME_TOKENS.includes(token)) timeMatched = true;
+    return values[token] ?? token;
+  });
+  if (!timeMatched) {
+    throw new Error(
+      `[vite-config] hashDirName "${pattern}" must contain a time token; available tokens: ${AVAILABLE_TOKENS.join(", ")}.`
+    );
+  }
+  assertSafeDirName(dirName, pattern);
+  return dirName;
+}
+function hasTimeToken(pattern) {
+  if (pattern.trim() === "") return false;
+  return [...pattern.matchAll(tokenPattern())].some(
+    (match) => TIME_TOKENS.includes(match[0])
+  );
+}
+function compileHashDirNameMatcher(pattern) {
+  assertPatternValue(pattern);
+  let source = "^";
+  let cursor = 0;
+  let groupIndex = 1;
+  let epochGroup = -1;
+  const dateTokens = [];
+  for (const match of pattern.matchAll(tokenPattern())) {
+    const index = match.index;
+    source += escapeRegExp(pattern.slice(cursor, index));
+    const token = match[0];
+    if (token === "hash") {
+      source += "(?:[0-9a-f]{12}|local)";
+    } else if (token === "timestamp") {
+      source += "(\\d{1,15})";
+      epochGroup = groupIndex;
+      groupIndex += 1;
+    } else {
+      const width = DATE_TOKEN_WIDTH[token];
+      source += `(\\d{${width}})`;
+      dateTokens.push(token);
+      groupIndex += 1;
+    }
+    cursor = index + token.length;
+  }
+  source += `${escapeRegExp(pattern.slice(cursor))}$`;
+  const regex = new RegExp(source);
+  return {
+    regex,
+    parseTimestamp(name) {
+      const matched = regex.exec(name);
+      if (!matched) return void 0;
+      if (epochGroup > 0) {
+        const epoch = matched[epochGroup];
+        return epoch == null ? void 0 : Number(epoch);
+      }
+      if (dateTokens.length === 0) return void 0;
+      const slots = {};
+      dateTokens.forEach((token, position) => {
+        const raw = matched[position + 1];
+        if (raw != null) slots[DATE_TOKEN_SLOT[token]] = Number(raw);
+      });
+      return new Date(
+        slots.year ?? 1970,
+        (slots.month ?? 1) - 1,
+        slots.day ?? 1,
+        slots.hour ?? 0,
+        slots.minute ?? 0,
+        slots.second ?? 0,
+        slots.millisecond ?? 0
+      ).getTime();
+    }
+  };
+}
+var RECENT_BUILD_PROTECT_MS = 5 * 60 * 1e3;
+function cleanupOldHashBuilds(deployRoot, currentBuildDir, keep, matcher) {
+  const now = Date.now();
   const oldBuilds = fs.readdirSync(deployRoot, { withFileTypes: true }).flatMap((entry) => {
     if (!entry.isDirectory() || entry.name === currentBuildDir) return [];
-    const match = HASH_BUILD_DIR_PATTERN.exec(entry.name);
-    return match ? [{ name: entry.name, timestamp: parseHashTimestamp(match[1]) }] : [];
+    const timestamp = matcher.parseTimestamp(entry.name);
+    if (timestamp == null) return [];
+    if (now - timestamp < RECENT_BUILD_PROTECT_MS) return [];
+    return [{ name: entry.name, timestamp }];
   }).sort((left, right) => right.timestamp - left.timestamp || right.name.localeCompare(left.name));
   for (const build of oldBuilds.slice(Math.max(keep - 1, 0))) {
     fs.rmSync(path.join(deployRoot, build.name), { recursive: true });
   }
 }
 function hashDeployPlugin(options) {
-  const { rootDir, buildDirStr, publicPath, cleanup } = options;
+  const { rootDir, buildDirStr, buildDirNamePattern, publicPath, cleanup } = options;
   if (cleanup && (!Number.isInteger(cleanup.keep) || cleanup.keep < 1)) {
     throw new Error("[hash-deploy] cleanup.keep must be an integer greater than or equal to 1.");
   }
+  const resolvedBuildDirNamePattern = buildDirNamePattern ?? DEFAULT_HASH_DIR_NAME_PATTERN;
+  if (cleanup && !hasTimeToken(resolvedBuildDirNamePattern)) {
+    throw new Error("[hash-deploy] cleanup requires a buildDirNamePattern with a time token.");
+  }
+  const cleanupMatcher = compileHashDirNameMatcher(resolvedBuildDirNamePattern);
+  if (cleanup && !cleanupMatcher.regex.test(buildDirStr)) {
+    throw new Error(
+      `[hash-deploy] buildDirStr "${buildDirStr}" does not match buildDirNamePattern "${resolvedBuildDirNamePattern}".`
+    );
+  }
   let outputDir;
   let deployRoot;
   return {
@@ -96,7 +211,7 @@ function hashDeployPlugin(options) {
         const rootHtml = publicPath.startsWith("./") ? sourceHtml.replace(/(\b(?:href|src)\s*=\s*["'])\.\//g, `$1${publicPath}`) : sourceHtml;
         fs.writeFileSync(path.join(deployRoot, "index.html"), rootHtml);
         if (cleanup) {
-          cleanupOldHashBuilds(deployRoot, buildDirStr, cleanup.keep);
+          cleanupOldHashBuilds(deployRoot, buildDirStr, cleanup.keep, cleanupMatcher);
         }
       }
     }
@@ -118,13 +233,21 @@ function createHashBuildDirName(repositoryRootOrNowOrOptions, now = Date.now())
     const {
       repositoryRoot: repositoryRoot2,
       now: optionsNow = Date.now(),
-      timestampFormat = "epoch"
+      hashDirName
     } = repositoryRootOrNowOrOptions;
-    return `${getCommitHash(repositoryRoot2)}-${formatHashTimestamp(optionsNow, timestampFormat)}`;
+    return expandHashDirName({
+      pattern: hashDirName ?? DEFAULT_HASH_DIR_NAME_PATTERN,
+      commitHash: getCommitHash(repositoryRoot2),
+      now: optionsNow
+    });
   }
   const repositoryRoot = typeof repositoryRootOrNowOrOptions === "string" ? repositoryRootOrNowOrOptions : void 0;
   const timestamp = typeof repositoryRootOrNowOrOptions === "number" ? repositoryRootOrNowOrOptions : now;
-  return `${getCommitHash(repositoryRoot)}-${formatHashTimestamp(timestamp)}`;
+  return expandHashDirName({
+    pattern: DEFAULT_HASH_DIR_NAME_PATTERN,
+    commitHash: getCommitHash(repositoryRoot),
+    now: timestamp
+  });
 }
 
 // src/plugins/less-tilde.ts
@@ -303,7 +426,7 @@ function createAppViteConfig(options) {
     useHttps = false,
     openBrowser = true,
     hashDeploy = false,
-    hashTimestamp = "epoch",
+    hashDirName,
     base: baseOption,
     deployRoot: deployRootOption = "dist",
     hashCleanup,
@@ -327,10 +450,19 @@ function createAppViteConfig(options) {
   const isHash = isBuild && Boolean(hashDeploy) && mode !== "development";
   const deployRoot = deployRootOption.replace(/\/+$/, "") || "dist";
   const assetBase = normalizeAssetBase(baseOption);
+  const legacyHashTimestamp = options.hashTimestamp;
+  if (legacyHashTimestamp != null && legacyHashTimestamp !== "epoch") {
+    throw new Error(
+      `[vite-config] hashTimestamp: ${JSON.stringify(
+        legacyHashTimestamp
+      )} has been removed; use hashDirName instead (e.g. "hash-timestamp" or "hash-YYYY-MM-DD-HH-mm-ss").`
+    );
+  }
   const buildDirStr = isHash ? createHashBuildDirName({
     repositoryRoot: repositoryRoot ?? rootDir,
-    timestampFormat: hashTimestamp
+    hashDirName
   }) : "";
+  const buildDirNamePattern = hashDirName ?? DEFAULT_HASH_DIR_NAME_PATTERN;
   const publicPath = isHash ? `${assetBase ?? "./"}${buildDirStr}/` : isBuild ? assetBase ?? "./" : "";
   const htmlPublicPath = isHash && publicPath.startsWith("./") ? "./" : publicPath;
   const isAbsoluteAssetBase = assetBase != null && (assetBase.startsWith("https://") || assetBase.startsWith("http://") || assetBase.startsWith("/"));
@@ -361,6 +493,7 @@ function createAppViteConfig(options) {
       hashDeployPlugin({
         rootDir,
         buildDirStr,
+        buildDirNamePattern,
         publicPath,
         cleanup: hashCleanup
       })
@@ -427,6 +560,29 @@ var DEFAULT_LIBRARY_GLOBALS = {
   "react-dom": "ReactDOM"
 };
 var DEFAULT_LIBRARY_FORMATS = ["umd"];
+function stripCjsSourcemapPlugin() {
+  let outDir = "";
+  return {
+    name: "hzab:strip-cjs-sourcemap",
+    apply: "build",
+    configResolved(config) {
+      outDir = config.build.outDir;
+    },
+    async writeBundle(_options, bundle) {
+      for (const fileName of Object.keys(bundle)) {
+        const file = path.resolve(outDir, fileName);
+        if (fileName.endsWith(".cjs.map")) {
+          await rm(file, { force: true });
+          continue;
+        }
+        if (!fileName.endsWith(".cjs")) continue;
+        const code = await readFile(file, "utf8");
+        const stripped = code.replace(/\n?\/\/# sourceMappingURL=\S+\s*$/u, "\n");
+        if (stripped !== code) await writeFile(file, stripped, "utf8");
+      }
+    }
+  };
+}
 function needsLibraryName(formats) {
   return formats.includes("umd") || formats.includes("iife");
 }
@@ -440,7 +596,11 @@ function resolveLibraryFileName(fileName, formats) {
   if (formats.length === 1) {
     return () => "index.js";
   }
-  return (format) => format === "es" ? "index.js" : `index.${format}.js`;
+  return (format) => {
+    if (format === "es") return "index.js";
+    if (format === "cjs") return "index.cjs";
+    return `index.${format}.js`;
+  };
 }
 function resolveLibraryGlobals(externals, globals) {
   const inferred = {};
@@ -513,7 +673,8 @@ function createLibraryViteConfig(options) {
     ] : [],
     ...isDev && useHttps ? [basicSsl()] : [],
     ...extraPlugins,
-    ...isBuild && (onRun || onDone) ? [lifecyclePlugin({ onRun, onDone })] : []
+    ...isBuild && (onRun || onDone) ? [lifecyclePlugin({ onRun, onDone })] : [],
+    ...isBuild ? [stripCjsSourcemapPlugin()] : []
   ];
   const resolvedExternals = resolveExternals(externalsOption);
   const resolvedGlobals = resolveLibraryGlobals(resolvedExternals, globalsOption);
@@ -540,6 +701,13 @@ function createLibraryViteConfig(options) {
       build: {
         outDir,
         emptyOutDir: true,
+        // 产物随包发布：消费方 webpack 的 devtool 会消费依赖自带的 map，缺失时
+        // DevTools 只能看到缩短标识符后的编译产物（见 docs/src-direct-vs-dist-evaluation.md §7.1）。
+        sourcemap: true,
+        // 降到 ES2018：webpack 4（umi3 线 abt-app）内置 acorn 6 解析到 ES2019 为止，不认 ES2020 的
+        // `?.` / `??`，产物保持默认 target 会让该线直接 Module parse failed。ES2018 是覆盖 acorn 6
+        // 边界的最小目标（对象展开仍保留），见 docs/src-direct-vs-dist-evaluation.md §7.2。
+        target: "es2018",
         lib: {
           entry: path.resolve(rootDir, entry),
           ...name != null && name.trim() !== "" ? { name } : {},