@sfmc-bds/bds-tools 0.1.0 → 0.2.0-beta.1

package/dist/world-packs.js

@@ -0,0 +1,509 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { copyDirAsync, readJsonFile, Utf8BomError } from "./fsx.js";
+import {
+  bdsWorldLevelDir,
+  bdsWorldsDir,
+  disablePackInWorld,
+  enablePackInWorld,
+  readPackManifestHeader,
+  readWorldPackList,
+  readWorldPackListResult
+} from "./pack-manager.js";
+import { extractZipFileToDir } from "./zipx.js";
+const ARCHIVE_EXTS = [".zip", ".mcpack", ".mcaddon"];
+function formatWorldPackFolderName(rawName, kind) {
+  let s = String(rawName ?? "");
+  s = s.replace(/§[0-9a-zA-Z]/g, "");
+  s = s.replace(/\.(zip|mcpack|mcaddon)$/i, "");
+  s = s.replace(/\s+/g, " ").trim();
+  if (!s) s = "pack";
+  const prefix = kind === "resource" ? "[RP]" : "[BP]";
+  if (s.startsWith("[RP]") || s.startsWith("[BP]")) return s;
+  return `${prefix} ${s}`;
+}
+function stripWorldPackFolderPrefix(rawName) {
+  return String(rawName ?? "").replace(/^\[BP\]\s*/i, "").replace(/^\[RP\]\s*/i, "").replace(/\.(zip|mcpack|mcaddon)$/i, "").replace(/\s+/g, " ").trim();
+}
+function isGenericPackFolderStem(rawName) {
+  const s = stripWorldPackFolderPrefix(rawName);
+  if (!s) return true;
+  if (s.length <= 2) return true;
+  return /^(bp|rp|b|r|pack|packs|behavior|behaviours?|resource|resources)$/i.test(s);
+}
+function choosePackInstallFolderName(opts) {
+  const hint = opts.hint && opts.hint.trim() || "";
+  const preferred = isGenericPackFolderStem(hint) ? opts.info.name || hint || "pack" : hint;
+  let folderName = formatWorldPackFolderName(preferred, opts.info.kind);
+  const allow = opts.allowFolderName ? path.basename(opts.allowFolderName) : null;
+  if (allow && folderName === allow) return folderName;
+  const taken = new Set(
+    listPackDirsIn(opts.destParent).map((d) => path.basename(d)).filter((n) => n !== allow)
+  );
+  if (!taken.has(folderName)) return folderName;
+  const withUuid = formatWorldPackFolderName(
+    `${stripWorldPackFolderPrefix(preferred)} ${opts.info.uuid.slice(0, 8)}`,
+    opts.info.kind
+  );
+  if (!taken.has(withUuid)) return withUuid;
+  let i = 2;
+  while (taken.has(`${withUuid}_${i}`)) i++;
+  return `${withUuid}_${i}`;
+}
+function detectPackKindFromManifest(raw) {
+  const types = (raw.modules ?? []).map((m) => String(m.type ?? "").toLowerCase());
+  if (types.includes("resources")) return "resource";
+  if (types.some((t) => t === "script" || t === "data" || t === "javascript")) return "behavior";
+  return null;
+}
+function readPackManifestInfo(packDir) {
+  const file = path.join(packDir, "manifest.json");
+  if (!fs.existsSync(file)) return null;
+  try {
+    const raw = readJsonFile(file);
+    const kind = detectPackKindFromManifest(raw);
+    const uuid = raw.header?.uuid;
+    const ver = raw.header?.version;
+    const name = raw.header?.name;
+    if (!kind || typeof uuid !== "string" || !Array.isArray(ver) || ver.length < 3) return null;
+    if (typeof name !== "string" || !name) return null;
+    const version = [Number(ver[0]), Number(ver[1]), Number(ver[2])];
+    const description = raw.header?.description;
+    return {
+      name,
+      uuid,
+      version,
+      kind,
+      ...typeof description === "string" ? { description } : {}
+    };
+  } catch (e) {
+    if (e instanceof Utf8BomError) throw e;
+    return null;
+  }
+}
+function discoverPackRoots(root, opts) {
+  const maxDepth = opts?.maxDepth ?? 2;
+  const out = [];
+  const abs = path.resolve(root);
+  if (!fs.existsSync(abs)) return out;
+  function walk(dir, depth) {
+    const manifest = path.join(dir, "manifest.json");
+    if (fs.existsSync(manifest) && fs.statSync(manifest).isFile()) {
+      out.push(dir);
+      return;
+    }
+    if (depth >= maxDepth) return;
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const e of entries) {
+      if (!e.isDirectory()) continue;
+      if (e.name.startsWith(".") || e.name === "node_modules") continue;
+      walk(path.join(dir, e.name), depth + 1);
+    }
+  }
+  const st = fs.statSync(abs);
+  if (st.isDirectory()) walk(abs, 0);
+  return out;
+}
+function isPackArchive(filePath) {
+  const lower = filePath.toLowerCase();
+  return ARCHIVE_EXTS.some((ext) => lower.endsWith(ext));
+}
+function archiveStem(filePath) {
+  const base = path.basename(filePath);
+  const lower = base.toLowerCase();
+  for (const ext of ARCHIVE_EXTS) {
+    if (lower.endsWith(ext)) return base.slice(0, -ext.length);
+  }
+  return path.parse(base).name;
+}
+function uniqueSiblingExtractDir(archivePath) {
+  const parent = path.dirname(archivePath);
+  let dest = path.join(parent, archiveStem(archivePath) || "pack");
+  if (!fs.existsSync(dest)) return dest;
+  let i = 2;
+  while (fs.existsSync(`${dest}_${i}`)) i++;
+  return `${dest}_${i}`;
+}
+function listPackArchiveFiles(root, opts) {
+  const maxDepth = opts?.maxDepth ?? 4;
+  const out = [];
+  const abs = path.resolve(root);
+  if (!fs.existsSync(abs) || !fs.statSync(abs).isDirectory()) return out;
+  function walk(dir, depth) {
+    if (fs.existsSync(path.join(dir, "manifest.json"))) return;
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const e of entries) {
+      if (e.name.startsWith(".") || e.name === "node_modules") continue;
+      const full = path.join(dir, e.name);
+      if (e.isFile() && isPackArchive(full)) {
+        out.push(full);
+        continue;
+      }
+      if (e.isDirectory() && depth < maxDepth) walk(full, depth + 1);
+    }
+  }
+  walk(abs, 0);
+  return out;
+}
+async function expandNestedArchivesInPlace(workDir, opts) {
+  const maxRounds = opts?.maxRounds ?? 3;
+  const maxScanDepth = opts?.maxScanDepth ?? 4;
+  let expanded = 0;
+  for (let round = 0; round < maxRounds; round++) {
+    const archives = listPackArchiveFiles(workDir, { maxDepth: maxScanDepth });
+    if (archives.length === 0) break;
+    for (const arch of archives) {
+      const dest = uniqueSiblingExtractDir(arch);
+      await fs.promises.mkdir(dest, { recursive: true });
+      await extractZipFileToDir(arch, dest);
+      await fs.promises.unlink(arch);
+      expanded++;
+    }
+  }
+  return expanded;
+}
+async function resolvePackRoots(src, opts) {
+  const maxDirDepth = opts?.maxDirDepth ?? 4;
+  const maxArchiveRounds = opts?.maxArchiveRounds ?? 3;
+  const temps = [];
+  const dispose = () => {
+    for (const d of temps.splice(0, temps.length)) {
+      try {
+        fs.rmSync(d, { recursive: true, force: true });
+      } catch {
+      }
+    }
+  };
+  const abs = path.resolve(src);
+  if (!fs.existsSync(abs)) return { roots: [], dispose };
+  try {
+    const st = fs.statSync(abs);
+    if (st.isFile()) {
+      if (!isPackArchive(abs)) return { roots: [], dispose };
+      const tmp = await extractArchiveToTemp(abs);
+      temps.push(tmp);
+      await expandNestedArchivesInPlace(tmp, {
+        maxRounds: maxArchiveRounds,
+        maxScanDepth: maxDirDepth
+      });
+      return { roots: discoverPackRoots(tmp, { maxDepth: maxDirDepth }), dispose };
+    }
+    if (!st.isDirectory()) return { roots: [], dispose };
+    const nestedArchives = listPackArchiveFiles(abs, { maxDepth: maxDirDepth });
+    if (nestedArchives.length === 0) {
+      return { roots: discoverPackRoots(abs, { maxDepth: maxDirDepth }), dispose };
+    }
+    const roots = discoverPackRoots(abs, { maxDepth: maxDirDepth });
+    const seen = new Set(roots.map((r) => path.resolve(r)));
+    for (const arch of nestedArchives) {
+      const tmp = await extractArchiveToTemp(arch);
+      temps.push(tmp);
+      await expandNestedArchivesInPlace(tmp, {
+        maxRounds: maxArchiveRounds,
+        maxScanDepth: maxDirDepth
+      });
+      for (const r of discoverPackRoots(tmp, { maxDepth: maxDirDepth })) {
+        const key = path.resolve(r);
+        if (seen.has(key)) continue;
+        seen.add(key);
+        roots.push(r);
+      }
+    }
+    return { roots, dispose };
+  } catch (e) {
+    dispose();
+    throw e;
+  }
+}
+async function extractArchiveToTemp(filePath) {
+  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), "sfmc-pack-"));
+  await extractZipFileToDir(filePath, tmp);
+  return tmp;
+}
+function listPackDirsIn(parent) {
+  if (!fs.existsSync(parent)) return [];
+  const out = [];
+  for (const e of fs.readdirSync(parent, { withFileTypes: true })) {
+    if (!e.isDirectory()) continue;
+    const dir = path.join(parent, e.name);
+    if (fs.existsSync(path.join(dir, "manifest.json"))) out.push(dir);
+  }
+  return out;
+}
+function listInstalledWorldPacks(bdsRoot, levelName) {
+  const worldRoot = bdsWorldLevelDir(bdsRoot, levelName);
+  const worldsDir = bdsWorldsDir(bdsRoot);
+  const result = [];
+  for (const kind of ["behavior", "resource"]) {
+    const parent = path.join(
+      worldRoot,
+      kind === "behavior" ? "behavior_packs" : "resource_packs"
+    );
+    const enabledList = readWorldPackList(worldsDir, levelName, kind);
+    const enabledMap = new Map(enabledList.map((e) => [e.pack_id, e.version]));
+    for (const dir of listPackDirsIn(parent)) {
+      let info = null;
+      try {
+        info = readPackManifestInfo(dir);
+      } catch (e) {
+        if (e instanceof Utf8BomError) continue;
+        throw e;
+      }
+      if (!info || info.kind !== kind) {
+        let header;
+        try {
+          header = readPackManifestHeader(dir);
+        } catch (e) {
+          if (e instanceof Utf8BomError) continue;
+          throw e;
+        }
+        if (!header) continue;
+        result.push({
+          kind,
+          folderName: path.basename(dir),
+          dir,
+          name: path.basename(dir),
+          uuid: header.uuid,
+          version: header.version,
+          enabled: enabledMap.has(header.uuid)
+        });
+        continue;
+      }
+      result.push({
+        kind: info.kind,
+        folderName: path.basename(dir),
+        dir,
+        name: info.name,
+        uuid: info.uuid,
+        version: info.version,
+        enabled: enabledMap.has(info.uuid)
+      });
+    }
+  }
+  return result;
+}
+function bumpPackPatchVersion(packDir) {
+  const file = path.join(packDir, "manifest.json");
+  if (!fs.existsSync(file)) throw new Error(`manifest.json missing: ${packDir}`);
+  const raw = readJsonFile(file);
+  const ver = raw.header?.version;
+  if (!Array.isArray(ver) || ver.length < 3) throw new Error(`invalid header.version in ${file}`);
+  const next = [Number(ver[0]), Number(ver[1]), Number(ver[2]) + 1];
+  return writePackHeaderVersion(packDir, next);
+}
+function writePackHeaderVersion(packDir, next) {
+  const file = path.join(packDir, "manifest.json");
+  if (!fs.existsSync(file)) throw new Error(`manifest.json missing: ${packDir}`);
+  const raw = readJsonFile(file);
+  if (!raw.header) raw.header = {};
+  raw.header.version = next;
+  if (Array.isArray(raw.modules)) {
+    for (const m of raw.modules) {
+      if (Array.isArray(m.version) && m.version.length >= 3) {
+        m.version = [Number(m.version[0]), Number(m.version[1]), next[2]];
+      }
+    }
+  }
+  fs.writeFileSync(file, `${JSON.stringify(raw, null, 2)}
+`, "utf8");
+  return next;
+}
+function readPackDependencyUuids(packDir) {
+  const file = path.join(packDir, "manifest.json");
+  if (!fs.existsSync(file)) return [];
+  try {
+    const raw = readJsonFile(file);
+    return (raw.dependencies ?? []).map((d) => d.uuid).filter((u) => typeof u === "string" && u.length > 0);
+  } catch (e) {
+    if (e instanceof Utf8BomError) throw e;
+    return [];
+  }
+}
+function compareSemVer3(a, b) {
+  for (let i = 0; i < 3; i++) {
+    const d = a[i] - b[i];
+    if (d !== 0) return d;
+  }
+  return 0;
+}
+function maxSemVer3(a, b) {
+  return compareSemVer3(a, b) >= 0 ? a : b;
+}
+function bumpSemVer3(v, component) {
+  return component === "minor" ? [v[0], v[1] + 1, 0] : [v[0], v[1], v[2] + 1];
+}
+function nextEnabledVersion(remote, previous, component = "patch") {
+  return bumpSemVer3(maxSemVer3(remote, previous), component);
+}
+function ensureVersionGreaterThan(packDir, previous, component = "patch") {
+  const info = readPackManifestInfo(packDir);
+  if (!info) throw new Error(`cannot read pack version: ${packDir}`);
+  const next = nextEnabledVersion(info.version, previous, component);
+  return writePackHeaderVersion(packDir, next);
+}
+async function installPackDirectory(opts) {
+  let info;
+  try {
+    info = readPackManifestInfo(opts.srcDir);
+  } catch (e) {
+    if (e instanceof Utf8BomError) {
+      return { ok: false, reason: e.message };
+    }
+    throw e;
+  }
+  if (!info) {
+    return { ok: false, reason: "invalid or unrecognized manifest.json" };
+  }
+  await fs.promises.mkdir(opts.destParent, { recursive: true });
+  let conflictDir = null;
+  let conflictExisting = null;
+  for (const dir of listPackDirsIn(opts.destParent)) {
+    let existing = null;
+    try {
+      existing = readPackManifestInfo(dir);
+    } catch (e) {
+      if (!(e instanceof Utf8BomError)) throw e;
+    }
+    if (existing && existing.uuid === info.uuid) {
+      conflictDir = dir;
+      conflictExisting = existing;
+      break;
+    }
+  }
+  const folderName = choosePackInstallFolderName({
+    hint: opts.folderName ?? path.basename(opts.srcDir),
+    info,
+    destParent: opts.destParent,
+    ...conflictDir ? { allowFolderName: path.basename(conflictDir) } : {}
+  });
+  if (conflictDir && !opts.force) {
+    return {
+      ok: false,
+      skipped: true,
+      reason: "conflict",
+      conflict: {
+        existing: { ...conflictExisting ?? info, dir: conflictDir },
+        incoming: info
+      }
+    };
+  }
+  const destDir = path.join(opts.destParent, folderName);
+  if (conflictDir && path.resolve(conflictDir) !== path.resolve(destDir)) {
+    await fs.promises.rm(conflictDir, { recursive: true, force: true });
+  }
+  if (fs.existsSync(destDir)) {
+    await fs.promises.rm(destDir, { recursive: true, force: true });
+  }
+  await copyDirAsync(opts.srcDir, destDir);
+  return { ok: true, destDir, folderName, info };
+}
+async function enableInstalledPack(opts) {
+  await enablePackInWorld({
+    worldsDir: bdsWorldsDir(opts.bdsRoot),
+    levelName: opts.levelName,
+    kind: opts.info.kind,
+    packUuid: opts.info.uuid,
+    version: opts.info.version
+  });
+}
+async function disableInstalledPack(opts) {
+  await disablePackInWorld({
+    worldsDir: bdsWorldsDir(opts.bdsRoot),
+    levelName: opts.levelName,
+    kind: opts.kind,
+    packUuid: opts.packUuid,
+    version: opts.version
+  });
+}
+async function uninstallInstalledPack(opts) {
+  await disableInstalledPack({
+    bdsRoot: opts.bdsRoot,
+    levelName: opts.levelName,
+    kind: opts.pack.kind,
+    packUuid: opts.pack.uuid,
+    version: opts.pack.version
+  });
+  if (!fs.existsSync(opts.pack.dir)) {
+    return { action: "missing" };
+  }
+  const trashDir = opts.trashDir?.trim() || null;
+  if (trashDir) {
+    await fs.promises.mkdir(trashDir, { recursive: true });
+    const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+    let dest = path.join(trashDir, opts.pack.folderName);
+    if (fs.existsSync(dest)) {
+      dest = path.join(trashDir, `${opts.pack.folderName}-${stamp}`);
+    }
+    try {
+      await fs.promises.rename(opts.pack.dir, dest);
+    } catch {
+      await copyDirAsync(opts.pack.dir, dest);
+      await fs.promises.rm(opts.pack.dir, { recursive: true, force: true });
+    }
+    return { action: "trashed", dest };
+  }
+  await fs.promises.rm(opts.pack.dir, { recursive: true, force: true });
+  return { action: "deleted" };
+}
+function worldPackParentDir(bdsRoot, levelName, kind) {
+  return path.join(
+    bdsWorldLevelDir(bdsRoot, levelName),
+    kind === "behavior" ? "behavior_packs" : "resource_packs"
+  );
+}
+function listWorldEnableEntries(bdsRoot, levelName, kind) {
+  return listWorldEnableListResult(bdsRoot, levelName, kind).entries;
+}
+function listWorldEnableListResult(bdsRoot, levelName, kind) {
+  return readWorldPackListResult(bdsWorldsDir(bdsRoot), levelName, kind);
+}
+function findInstalledPackById(packs, id) {
+  const q = id.trim().toLowerCase();
+  return packs.find(
+    (p) => p.uuid.toLowerCase() === q || p.folderName.toLowerCase() === q || p.name.toLowerCase() === q || p.folderName.toLowerCase().includes(q) || p.name.toLowerCase().includes(q)
+  ) ?? null;
+}
+export {
+  Utf8BomError,
+  bumpPackPatchVersion,
+  bumpSemVer3,
+  choosePackInstallFolderName,
+  compareSemVer3,
+  detectPackKindFromManifest,
+  disableInstalledPack,
+  discoverPackRoots,
+  enableInstalledPack,
+  ensureVersionGreaterThan,
+  expandNestedArchivesInPlace,
+  extractArchiveToTemp,
+  findInstalledPackById,
+  formatWorldPackFolderName,
+  installPackDirectory,
+  isGenericPackFolderStem,
+  isPackArchive,
+  listInstalledWorldPacks,
+  listPackArchiveFiles,
+  listWorldEnableEntries,
+  listWorldEnableListResult,
+  maxSemVer3,
+  nextEnabledVersion,
+  readPackDependencyUuids,
+  readPackManifestInfo,
+  resolvePackRoots,
+  stripWorldPackFolderPrefix,
+  uninstallInstalledPack,
+  worldPackParentDir,
+  writePackHeaderVersion
+};
+//# sourceMappingURL=world-packs.js.map

package/dist/world-packs.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/world-packs.ts"],
+  "sourcesContent": ["/**\n * world-packs.ts \u2014 \u901A\u7528\u4E16\u754C BP/RP \u53D1\u73B0 / \u5B89\u88C5 / bump\uFF08\u975E SFMC \u6A21\u5757\u805A\u5408\uFF09\n */\nimport fs from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { copyDirAsync, readJsonFile, Utf8BomError } from \"./fsx.js\";\nimport {\n  bdsWorldLevelDir,\n  bdsWorldsDir,\n  disablePackInWorld,\n  enablePackInWorld,\n  readPackManifestHeader,\n  readWorldPackList,\n  readWorldPackListResult,\n  type WorldPackListReadResult,\n} from \"./pack-manager.js\";\nimport { extractZipFileToDir } from \"./zipx.js\";\n\nexport type WorldPackKind = \"behavior\" | \"resource\";\n\nexport interface PackManifestInfo {\n  name: string;\n  uuid: string;\n  version: [number, number, number];\n  kind: WorldPackKind;\n  description?: string;\n}\n\nexport interface InstalledWorldPack {\n  kind: WorldPackKind;\n  folderName: string;\n  dir: string;\n  name: string;\n  uuid: string;\n  version: [number, number, number];\n  enabled: boolean;\n}\n\nconst ARCHIVE_EXTS = [\".zip\", \".mcpack\", \".mcaddon\"] as const;\n\n/** \u6EE4\u6389 \u00A7x\uFF08Minecraft \u683C\u5F0F\u7801\uFF09\u3001\u6B8B\u4F59\u538B\u7F29\u540E\u7F00\uFF0C\u52A0 [BP]/[RP] \u524D\u7F00 */\nexport function formatWorldPackFolderName(rawName: string, kind: WorldPackKind): string {\n  let s = String(rawName ?? \"\");\n  s = s.replace(/\u00A7[0-9a-zA-Z]/g, \"\");\n  s = s.replace(/\\.(zip|mcpack|mcaddon)$/i, \"\");\n  s = s.replace(/\\s+/g, \" \").trim();\n  if (!s) s = \"pack\";\n  const prefix = kind === \"resource\" ? \"[RP]\" : \"[BP]\";\n  if (s.startsWith(\"[RP]\") || s.startsWith(\"[BP]\")) return s;\n  return `${prefix} ${s}`;\n}\n\n/** \u53BB\u6389\u5DF2\u6709 [BP]/[RP] \u524D\u7F00\uFF0C\u5F97\u5230\u6587\u4EF6\u5939\u540D\u4E3B\u5E72 */\nexport function stripWorldPackFolderPrefix(rawName: string): string {\n  return String(rawName ?? \"\")\n    .replace(/^\\[BP\\]\\s*/i, \"\")\n    .replace(/^\\[RP\\]\\s*/i, \"\")\n    .replace(/\\.(zip|mcpack|mcaddon)$/i, \"\")\n    .replace(/\\s+/g, \" \")\n    .trim();\n}\n\n/**\n * \u5F52\u6863\u5185\u5E38\u89C1\u5360\u4F4D\u76EE\u5F55\u540D\uFF08B / R / BP / RP\uFF09\u8FC7\u77ED\u6216\u8FC7\u6CDB\uFF0C\u4E0D\u80FD\u4F5C\u4E3A\u4E16\u754C\u76EE\u5F55\u540D\uFF0C\n * \u5426\u5219\u4E0D\u540C\u5305\u4F1A\u649E\u5230\u540C\u4E00\u8DEF\u5F84\u5E76\u88AB\u8BEF\u5224\u4E3A\u300C\u8986\u76D6\u300D\u3002\n */\nexport function isGenericPackFolderStem(rawName: string): boolean {\n  const s = stripWorldPackFolderPrefix(rawName);\n  if (!s) return true;\n  if (s.length <= 2) return true;\n  return /^(bp|rp|b|r|pack|packs|behavior|behaviours?|resource|resources)$/i.test(s);\n}\n\n/**\n * \u9009\u5B9A\u5B89\u88C5\u6587\u4EF6\u5939\u540D\uFF1Ahint \u8FC7\u6CDB\u65F6\u6539\u7528 manifest.name\uFF1B\u518D\u4E0E dest \u5185\u5DF2\u6709\u76EE\u5F55\u907F\u8BA9\uFF08\u4E0D\u540C uuid \u4E0D\u4E92\u76F8\u8986\u76D6\uFF09\u3002\n */\nexport function choosePackInstallFolderName(opts: {\n  hint?: string;\n  info: PackManifestInfo;\n  destParent: string;\n  /** \u540C uuid \u66F4\u65B0\u65F6\u5141\u8BB8\u5360\u7528\u7684\u5DF2\u6709\u76EE\u5F55\u540D\uFF08\u4E0D\u89E6\u53D1\u907F\u8BA9\uFF09 */\n  allowFolderName?: string;\n}): string {\n  const hint = (opts.hint && opts.hint.trim()) || \"\";\n  const preferred = isGenericPackFolderStem(hint) ? opts.info.name || hint || \"pack\" : hint;\n  let folderName = formatWorldPackFolderName(preferred, opts.info.kind);\n  const allow = opts.allowFolderName ? path.basename(opts.allowFolderName) : null;\n  if (allow && folderName === allow) return folderName;\n\n  const taken = new Set(\n    listPackDirsIn(opts.destParent)\n      .map((d) => path.basename(d))\n      .filter((n) => n !== allow)\n  );\n  if (!taken.has(folderName)) return folderName;\n\n  /* \u540C\u540D\u4E0D\u540C\u5305\uFF1Amanifest \u540D + uuid \u524D\u7F00\uFF1B\u4ECD\u649E\u5219\u9012\u589E */\n  const withUuid = formatWorldPackFolderName(\n    `${stripWorldPackFolderPrefix(preferred)} ${opts.info.uuid.slice(0, 8)}`,\n    opts.info.kind\n  );\n  if (!taken.has(withUuid)) return withUuid;\n  let i = 2;\n  while (taken.has(`${withUuid}_${i}`)) i++;\n  return `${withUuid}_${i}`;\n}\n\n/** \u6839\u636E manifest modules[].type \u5224\u5B9A BP / RP */\nexport function detectPackKindFromManifest(raw: {\n  modules?: Array<{ type?: string }>;\n}): WorldPackKind | null {\n  const types = (raw.modules ?? []).map((m) => String(m.type ?? \"\").toLowerCase());\n  if (types.includes(\"resources\")) return \"resource\";\n  if (types.some((t) => t === \"script\" || t === \"data\" || t === \"javascript\")) return \"behavior\";\n  return null;\n}\n\nexport function readPackManifestInfo(packDir: string): PackManifestInfo | null {\n  const file = path.join(packDir, \"manifest.json\");\n  if (!fs.existsSync(file)) return null;\n  try {\n    const raw = readJsonFile<{\n      header?: { name?: string; uuid?: string; version?: number[]; description?: string };\n      modules?: Array<{ type?: string }>;\n    }>(file);\n    const kind = detectPackKindFromManifest(raw);\n    const uuid = raw.header?.uuid;\n    const ver = raw.header?.version;\n    const name = raw.header?.name;\n    if (!kind || typeof uuid !== \"string\" || !Array.isArray(ver) || ver.length < 3) return null;\n    if (typeof name !== \"string\" || !name) return null;\n    const version: [number, number, number] = [Number(ver[0]), Number(ver[1]), Number(ver[2])];\n    const description = raw.header?.description;\n    return {\n      name,\n      uuid,\n      version,\n      kind,\n      ...(typeof description === \"string\" ? { description } : {}),\n    };\n  } catch (e) {\n    /* BOM \u5FC5\u987B\u4E0A\u629B\uFF0C\u7531\u5B89\u88C5\u5C42\u6253\u660E\u786E\u9519\u8BEF\uFF1B\u5176\u5B83\u89E3\u6790\u5931\u8D25\u4ECD\u8FD4\u56DE null */\n    if (e instanceof Utf8BomError) throw e;\n    return null;\n  }\n}\n\nexport { Utf8BomError };\n\n/** \u6DF1\u5EA6\u4F18\u5148\u627E\u542B manifest.json \u7684\u5305\u6839\uFF08\u9ED8\u8BA4 maxDepth=2\uFF0Croot \u81EA\u8EAB\u4E3A depth 0\uFF09 */\nexport function discoverPackRoots(root: string, opts?: { maxDepth?: number }): string[] {\n  const maxDepth = opts?.maxDepth ?? 2;\n  const out: string[] = [];\n  const abs = path.resolve(root);\n  if (!fs.existsSync(abs)) return out;\n\n  function walk(dir: string, depth: number): void {\n    const manifest = path.join(dir, \"manifest.json\");\n    if (fs.existsSync(manifest) && fs.statSync(manifest).isFile()) {\n      out.push(dir);\n      return; // \u5305\u6839\u4E0D\u518D\u4E0B\u94BB\n    }\n    if (depth >= maxDepth) return;\n    let entries;\n    try {\n      entries = fs.readdirSync(dir, { withFileTypes: true });\n    } catch {\n      return;\n    }\n    for (const e of entries) {\n      if (!e.isDirectory()) continue;\n      if (e.name.startsWith(\".\") || e.name === \"node_modules\") continue;\n      walk(path.join(dir, e.name), depth + 1);\n    }\n  }\n\n  const st = fs.statSync(abs);\n  if (st.isDirectory()) walk(abs, 0);\n  return out;\n}\n\nexport function isPackArchive(filePath: string): boolean {\n  const lower = filePath.toLowerCase();\n  return ARCHIVE_EXTS.some((ext) => lower.endsWith(ext));\n}\n\n/** \u53BB\u6389 .zip/.mcpack/.mcaddon \u540E\u7F00\u5F97\u5230 stem */\nfunction archiveStem(filePath: string): string {\n  const base = path.basename(filePath);\n  const lower = base.toLowerCase();\n  for (const ext of ARCHIVE_EXTS) {\n    if (lower.endsWith(ext)) return base.slice(0, -ext.length);\n  }\n  return path.parse(base).name;\n}\n\n/** \u5F52\u6863\u89E3\u538B\u76EE\u6807\uFF1A\u540C\u7EA7 stem \u76EE\u5F55\uFF1B\u91CD\u540D\u5219\u52A0 _2/_3\u2026 */\nfunction uniqueSiblingExtractDir(archivePath: string): string {\n  const parent = path.dirname(archivePath);\n  let dest = path.join(parent, archiveStem(archivePath) || \"pack\");\n  if (!fs.existsSync(dest)) return dest;\n  let i = 2;\n  while (fs.existsSync(`${dest}_${i}`)) i++;\n  return `${dest}_${i}`;\n}\n\n/**\n * \u5217\u51FA\u76EE\u5F55\u6811\u5185\u7684\u5305\u5F52\u6863\u6587\u4EF6\u3002\n * \u5DF2\u662F\u5305\u6839\uFF08\u542B manifest.json\uFF09\u7684\u76EE\u5F55\u4E0D\u518D\u4E0B\u94BB\uFF0C\u907F\u514D\u8BEF\u89E3\u538B\u5305\u5185\u8D44\u6E90\u3002\n */\nexport function listPackArchiveFiles(root: string, opts?: { maxDepth?: number }): string[] {\n  const maxDepth = opts?.maxDepth ?? 4;\n  const out: string[] = [];\n  const abs = path.resolve(root);\n  if (!fs.existsSync(abs) || !fs.statSync(abs).isDirectory()) return out;\n\n  function walk(dir: string, depth: number): void {\n    if (fs.existsSync(path.join(dir, \"manifest.json\"))) return;\n    let entries;\n    try {\n      entries = fs.readdirSync(dir, { withFileTypes: true });\n    } catch {\n      return;\n    }\n    for (const e of entries) {\n      if (e.name.startsWith(\".\") || e.name === \"node_modules\") continue;\n      const full = path.join(dir, e.name);\n      if (e.isFile() && isPackArchive(full)) {\n        out.push(full);\n        continue;\n      }\n      if (e.isDirectory() && depth < maxDepth) walk(full, depth + 1);\n    }\n  }\n\n  walk(abs, 0);\n  return out;\n}\n\n/**\n * \u5728\u4E34\u65F6\u6811\u5185\u539F\u5730\u5C55\u5F00\u5D4C\u5957\u5F52\u6863\uFF1A\u89E3\u538B\u5230\u540C\u7EA7\u76EE\u5F55\u5E76\u5220\u9664\u5F52\u6863\u6587\u4EF6\uFF0C\u591A\u8F6E\u76F4\u81F3\u6CA1\u6709\u65B0\u5F52\u6863\u3002\n * \u4EC5\u5E94\u5BF9\u6211\u4EEC\u81EA\u5DF1\u7684 staging\uFF0C\u7981\u6B62\u7528\u4E8E\u7528\u6237 inbox \u539F\u76EE\u5F55\u3002\n */\nexport async function expandNestedArchivesInPlace(\n  workDir: string,\n  opts?: { maxRounds?: number; maxScanDepth?: number }\n): Promise<number> {\n  const maxRounds = opts?.maxRounds ?? 3;\n  const maxScanDepth = opts?.maxScanDepth ?? 4;\n  let expanded = 0;\n  for (let round = 0; round < maxRounds; round++) {\n    const archives = listPackArchiveFiles(workDir, { maxDepth: maxScanDepth });\n    if (archives.length === 0) break;\n    for (const arch of archives) {\n      const dest = uniqueSiblingExtractDir(arch);\n      await fs.promises.mkdir(dest, { recursive: true });\n      await extractZipFileToDir(arch, dest);\n      await fs.promises.unlink(arch);\n      expanded++;\n    }\n  }\n  return expanded;\n}\n\nexport type ResolvePackRootsResult = {\n  roots: string[];\n  /** \u6E05\u7406\u672C\u8F6E\u521B\u5EFA\u7684\u5168\u90E8\u4E34\u65F6\u76EE\u5F55\uFF08\u53EF\u5B89\u5168\u591A\u6B21\u8C03\u7528\uFF09 */\n  dispose: () => void;\n};\n\n/**\n * \u7EDF\u4E00\u5305\u6839\u89E3\u6790\uFF1A\u76EE\u5F55 / \u9876\u5C42\u5F52\u6863 / \u5D4C\u5957 .mcpack|.zip|.mcaddon\u3002\n * \u89C4\u5219\uFF1A\u5148\u5C55\u5F00\u5F52\u6863\u4E3A\u76EE\u5F55\u6811\uFF0C\u518D\u53EA\u8BA4\u542B manifest.json \u7684\u76EE\u5F55\u4E3A\u5305\u6839\u3002\n * \u7528\u6237\u76EE\u5F55\u5185\u7684\u5D4C\u5957\u5F52\u6863\u89E3\u5230\u72EC\u7ACB temp\uFF0C\u4E0D\u4FEE\u6539\u539F\u76EE\u5F55\u3002\n */\nexport async function resolvePackRoots(\n  src: string,\n  opts?: { maxDirDepth?: number; maxArchiveRounds?: number }\n): Promise<ResolvePackRootsResult> {\n  const maxDirDepth = opts?.maxDirDepth ?? 4;\n  const maxArchiveRounds = opts?.maxArchiveRounds ?? 3;\n  const temps: string[] = [];\n  const dispose = (): void => {\n    for (const d of temps.splice(0, temps.length)) {\n      try {\n        fs.rmSync(d, { recursive: true, force: true });\n      } catch {\n        /* ignore */\n      }\n    }\n  };\n\n  const abs = path.resolve(src);\n  if (!fs.existsSync(abs)) return { roots: [], dispose };\n\n  try {\n    const st = fs.statSync(abs);\n    if (st.isFile()) {\n      if (!isPackArchive(abs)) return { roots: [], dispose };\n      const tmp = await extractArchiveToTemp(abs);\n      temps.push(tmp);\n      await expandNestedArchivesInPlace(tmp, {\n        maxRounds: maxArchiveRounds,\n        maxScanDepth: maxDirDepth,\n      });\n      return { roots: discoverPackRoots(tmp, { maxDepth: maxDirDepth }), dispose };\n    }\n\n    if (!st.isDirectory()) return { roots: [], dispose };\n\n    const nestedArchives = listPackArchiveFiles(abs, { maxDepth: maxDirDepth });\n    if (nestedArchives.length === 0) {\n      return { roots: discoverPackRoots(abs, { maxDepth: maxDirDepth }), dispose };\n    }\n\n    /* \u76EE\u5F55\u5305\u6839 + \u5404\u5D4C\u5957\u5F52\u6863\u5404\u81EA\u89E3\u5230 temp\uFF08\u4E0D\u6539\u7528\u6237\u76EE\u5F55\uFF09 */\n    const roots = discoverPackRoots(abs, { maxDepth: maxDirDepth });\n    const seen = new Set(roots.map((r) => path.resolve(r)));\n    for (const arch of nestedArchives) {\n      const tmp = await extractArchiveToTemp(arch);\n      temps.push(tmp);\n      await expandNestedArchivesInPlace(tmp, {\n        maxRounds: maxArchiveRounds,\n        maxScanDepth: maxDirDepth,\n      });\n      for (const r of discoverPackRoots(tmp, { maxDepth: maxDirDepth })) {\n        const key = path.resolve(r);\n        if (seen.has(key)) continue;\n        seen.add(key);\n        roots.push(r);\n      }\n    }\n    return { roots, dispose };\n  } catch (e) {\n    dispose();\n    throw e;\n  }\n}\n\n/** \u89E3\u538B zip/mcpack/mcaddon \u5230\u4E34\u65F6\u76EE\u5F55\uFF0C\u8FD4\u56DE\u8BE5\u76EE\u5F55\uFF08\u7ECF zipx \u9632 zip-slip\uFF09 */\nexport async function extractArchiveToTemp(filePath: string): Promise<string> {\n  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), \"sfmc-pack-\"));\n  await extractZipFileToDir(filePath, tmp);\n  return tmp;\n}\n\nfunction listPackDirsIn(parent: string): string[] {\n  if (!fs.existsSync(parent)) return [];\n  const out: string[] = [];\n  for (const e of fs.readdirSync(parent, { withFileTypes: true })) {\n    if (!e.isDirectory()) continue;\n    const dir = path.join(parent, e.name);\n    if (fs.existsSync(path.join(dir, \"manifest.json\"))) out.push(dir);\n  }\n  return out;\n}\n\n/** \u626B\u63CF\u4E16\u754C\u5185\u5DF2\u5B89\u88C5 BP/RP \u76EE\u5F55 */\nexport function listInstalledWorldPacks(bdsRoot: string, levelName: string): InstalledWorldPack[] {\n  const worldRoot = bdsWorldLevelDir(bdsRoot, levelName);\n  const worldsDir = bdsWorldsDir(bdsRoot);\n  const result: InstalledWorldPack[] = [];\n\n  for (const kind of [\"behavior\", \"resource\"] as const) {\n    const parent = path.join(\n      worldRoot,\n      kind === \"behavior\" ? \"behavior_packs\" : \"resource_packs\"\n    );\n    const enabledList = readWorldPackList(worldsDir, levelName, kind);\n    const enabledMap = new Map(enabledList.map((e) => [e.pack_id, e.version] as const));\n\n    for (const dir of listPackDirsIn(parent)) {\n      let info: PackManifestInfo | null = null;\n      try {\n        info = readPackManifestInfo(dir);\n      } catch (e) {\n        /* \u5DF2\u88C5\u76EE\u5F55\u82E5\u542B BOM\uFF1A\u8DF3\u8FC7\u8BE5\u9879\uFF0C\u907F\u514D list \u6574\u8868\u70B8\u6389\uFF1B\u5B89\u88C5\u8DEF\u5F84\u4F1A\u5355\u72EC\u62A5\u9519 */\n        if (e instanceof Utf8BomError) continue;\n        throw e;\n      }\n      if (!info || info.kind !== kind) {\n        // \u4ECD\u5C1D\u8BD5\u7528 header \u5C55\u793A\uFF08enabled \u4E0E\u6B63\u5E38\u8DEF\u5F84\u540C\u5951\u7EA6\uFF1Aenable-list \u542B uuid \u2192 LSP\uFF09\n        let header;\n        try {\n          header = readPackManifestHeader(dir);\n        } catch (e) {\n          if (e instanceof Utf8BomError) continue;\n          throw e;\n        }\n        if (!header) continue;\n        result.push({\n          kind,\n          folderName: path.basename(dir),\n          dir,\n          name: path.basename(dir),\n          uuid: header.uuid,\n          version: header.version,\n          enabled: enabledMap.has(header.uuid),\n        });\n        continue;\n      }\n      result.push({\n        kind: info.kind,\n        folderName: path.basename(dir),\n        dir,\n        name: info.name,\n        uuid: info.uuid,\n        version: info.version,\n        enabled: enabledMap.has(info.uuid),\n      });\n    }\n  }\n  return result;\n}\n\n/** RP/BP \u7B2C\u4E09\u4F4D\u7248\u672C +1\uFF0C\u5199\u56DE manifest */\nexport function bumpPackPatchVersion(packDir: string): [number, number, number] {\n  const file = path.join(packDir, \"manifest.json\");\n  if (!fs.existsSync(file)) throw new Error(`manifest.json missing: ${packDir}`);\n  const raw = readJsonFile<{\n    header?: { version?: number[] };\n    modules?: Array<{ version?: number[] }>;\n  }>(file);\n  const ver = raw.header?.version;\n  if (!Array.isArray(ver) || ver.length < 3) throw new Error(`invalid header.version in ${file}`);\n  const next: [number, number, number] = [Number(ver[0]), Number(ver[1]), Number(ver[2]) + 1];\n  return writePackHeaderVersion(packDir, next);\n}\n\n/** \u5199\u5165 header.version\uFF08\u5E76\u540C\u6B65 modules[].version \u7684 patch\uFF09 */\nexport function writePackHeaderVersion(\n  packDir: string,\n  next: [number, number, number]\n): [number, number, number] {\n  const file = path.join(packDir, \"manifest.json\");\n  if (!fs.existsSync(file)) throw new Error(`manifest.json missing: ${packDir}`);\n  const raw = readJsonFile<{\n    header?: { version?: number[] };\n    modules?: Array<{ version?: number[] }>;\n  }>(file);\n  if (!raw.header) raw.header = {};\n  raw.header.version = next;\n  if (Array.isArray(raw.modules)) {\n    for (const m of raw.modules) {\n      if (Array.isArray(m.version) && m.version.length >= 3) {\n        m.version = [Number(m.version[0]), Number(m.version[1]), next[2]];\n      }\n    }\n  }\n  fs.writeFileSync(file, `${JSON.stringify(raw, null, 2)}\\n`, \"utf8\");\n  return next;\n}\n\n/** \u8BFB\u53D6 BP manifest \u4E2D\u4F9D\u8D56\u7684\u8D44\u6E90\u5305 uuid\uFF08\u975E @minecraft \u6A21\u5757\uFF09 */\nexport function readPackDependencyUuids(packDir: string): string[] {\n  const file = path.join(packDir, \"manifest.json\");\n  if (!fs.existsSync(file)) return [];\n  try {\n    const raw = readJsonFile<{\n      dependencies?: Array<{ uuid?: string; module_name?: string }>;\n    }>(file);\n    return (raw.dependencies ?? [])\n      .map((d) => d.uuid)\n      .filter((u): u is string => typeof u === \"string\" && u.length > 0);\n  } catch (e) {\n    if (e instanceof Utf8BomError) throw e;\n    return [];\n  }\n}\n\n/** \u6BD4\u8F83 SemVer \u4E09\u5143\u7EC4\uFF1Ba>b \u6B63\uFF0Ca<b \u8D1F\uFF0C\u76F8\u7B49 0 */\nexport function compareSemVer3(\n  a: [number, number, number],\n  b: [number, number, number]\n): number {\n  for (let i = 0; i < 3; i++) {\n    const d = a[i]! - b[i]!;\n    if (d !== 0) return d;\n  }\n  return 0;\n}\n\n/** \u53D6\u8F83\u5927\u7684 SemVer \u4E09\u5143\u7EC4 */\nexport function maxSemVer3(\n  a: [number, number, number],\n  b: [number, number, number]\n): [number, number, number] {\n  return compareSemVer3(a, b) >= 0 ? a : b;\n}\n\n/** \u6309 component \u62AC\u4E00\u7EA7 */\nexport function bumpSemVer3(\n  v: [number, number, number],\n  component: \"patch\" | \"minor\"\n): [number, number, number] {\n  return component === \"minor\" ? [v[0], v[1] + 1, 0] : [v[0], v[1], v[2] + 1];\n}\n\n/**\n * \u8FDB\u670D\u542F\u7528\u7248\u672C\uFF1Amax(\u8FDC\u7A0B/\u65B0\u5305, \u65E7\u542F\u7528) \u518D\u62AC\u4E00\u7EA7\u3002\n * \u5355\u4E00\u89C4\u5219\uFF0C\u7981\u6B62 while \u8FFD\u8D76\uFF08\u4F5C\u8005\u4E71\u5199\u9AD8\u7248\u672C\u5982 [1,21,100] \u65F6\u4E5F\u80FD\u4E00\u6B21\u7B97\u5B8C\uFF09\u3002\n */\nexport function nextEnabledVersion(\n  remote: [number, number, number],\n  previous: [number, number, number],\n  component: \"patch\" | \"minor\" = \"patch\"\n): [number, number, number] {\n  return bumpSemVer3(maxSemVer3(remote, previous), component);\n}\n\n/**\n * \u5C06\u5305\u76EE\u5F55 manifest \u62AC\u5230 nextEnabledVersion(\u5F53\u524D, previous)\u3002\n * previous \u4E00\u822C\u4E3A\u66F4\u65B0\u524D\u5DF2\u5B89\u88C5 RP / \u4E16\u754C enable \u5217\u8868\u4E2D\u7684\u7248\u672C\u3002\n */\nexport function ensureVersionGreaterThan(\n  packDir: string,\n  previous: [number, number, number],\n  component: \"patch\" | \"minor\" = \"patch\"\n): [number, number, number] {\n  const info = readPackManifestInfo(packDir);\n  if (!info) throw new Error(`cannot read pack version: ${packDir}`);\n  const next = nextEnabledVersion(info.version, previous, component);\n  return writePackHeaderVersion(packDir, next);\n}\n\nexport interface InstallPackResult {\n  ok: boolean;\n  skipped?: boolean;\n  reason?: string;\n  destDir?: string;\n  folderName?: string;\n  info?: PackManifestInfo;\n  conflict?: { existing: PackManifestInfo & { dir: string }; incoming: PackManifestInfo };\n}\n\n/**\n * \u5C06\u5305\u76EE\u5F55\u5B89\u88C5\u5230 destParent\uFF08behavior_packs \u6216 resource_packs\uFF09\u3002\n * force=true \u65F6\u8986\u76D6\u300C\u540C uuid\u300D\u51B2\u7A81\uFF1B\u540C\u540D\u4E0D\u540C uuid \u4F1A\u81EA\u52A8\u6362\u6587\u4EF6\u5939\u540D\uFF0C\u4E0D\u5220\u522B\u4EBA\u7684\u5305\u3002\n */\nexport async function installPackDirectory(opts: {\n  srcDir: string;\n  destParent: string;\n  folderName?: string;\n  force?: boolean;\n}): Promise<InstallPackResult> {\n  let info: PackManifestInfo | null;\n  try {\n    info = readPackManifestInfo(opts.srcDir);\n  } catch (e) {\n    if (e instanceof Utf8BomError) {\n      return { ok: false, reason: e.message };\n    }\n    throw e;\n  }\n  if (!info) {\n    return { ok: false, reason: \"invalid or unrecognized manifest.json\" };\n  }\n\n  await fs.promises.mkdir(opts.destParent, { recursive: true });\n\n  /* \u4EC5\u540C uuid \u89C6\u4E3A\u53EF\u8986\u76D6\u51B2\u7A81\uFF1B\u540C\u540D\u4E0D\u540C\u5305\u7531 choosePackInstallFolderName \u907F\u8BA9 */\n  let conflictDir: string | null = null;\n  let conflictExisting: PackManifestInfo | null = null;\n  for (const dir of listPackDirsIn(opts.destParent)) {\n    let existing: PackManifestInfo | null = null;\n    try {\n      existing = readPackManifestInfo(dir);\n    } catch (e) {\n      if (!(e instanceof Utf8BomError)) throw e;\n    }\n    if (existing && existing.uuid === info.uuid) {\n      conflictDir = dir;\n      conflictExisting = existing;\n      break;\n    }\n  }\n\n  const folderName = choosePackInstallFolderName({\n    hint: opts.folderName ?? path.basename(opts.srcDir),\n    info,\n    destParent: opts.destParent,\n    ...(conflictDir ? { allowFolderName: path.basename(conflictDir) } : {}),\n  });\n\n  if (conflictDir && !opts.force) {\n    return {\n      ok: false,\n      skipped: true,\n      reason: \"conflict\",\n      conflict: {\n        existing: { ...(conflictExisting ?? info), dir: conflictDir },\n        incoming: info,\n      },\n    };\n  }\n\n  const destDir = path.join(opts.destParent, folderName);\n  if (conflictDir && path.resolve(conflictDir) !== path.resolve(destDir)) {\n    await fs.promises.rm(conflictDir, { recursive: true, force: true });\n  }\n  if (fs.existsSync(destDir)) {\n    await fs.promises.rm(destDir, { recursive: true, force: true });\n  }\n  await copyDirAsync(opts.srcDir, destDir);\n  return { ok: true, destDir, folderName, info };\n}\n\n/** \u5B89\u88C5\u540E\u5199\u5165\u4E16\u754C enable \u6E05\u5355 */\nexport async function enableInstalledPack(opts: {\n  bdsRoot: string;\n  levelName: string;\n  info: PackManifestInfo;\n}): Promise<void> {\n  await enablePackInWorld({\n    worldsDir: bdsWorldsDir(opts.bdsRoot),\n    levelName: opts.levelName,\n    kind: opts.info.kind,\n    packUuid: opts.info.uuid,\n    version: opts.info.version,\n  });\n}\n\n/** \u4ECE\u4E16\u754C enable \u6E05\u5355\u79FB\u9664 */\nexport async function disableInstalledPack(opts: {\n  bdsRoot: string;\n  levelName: string;\n  kind: WorldPackKind;\n  packUuid: string;\n  version: [number, number, number];\n}): Promise<void> {\n  await disablePackInWorld({\n    worldsDir: bdsWorldsDir(opts.bdsRoot),\n    levelName: opts.levelName,\n    kind: opts.kind,\n    packUuid: opts.packUuid,\n    version: opts.version,\n  });\n}\n\nexport type UninstallPackResult =\n  | { action: \"trashed\"; dest: string }\n  | { action: \"deleted\" }\n  | { action: \"missing\" };\n\nexport type UninstallPackAction = UninstallPackResult[\"action\"];\n\n/**\n * \u5378\u8F7D\u5DF2\u5B89\u88C5\u4E16\u754C\u5305\uFF1A\u5148 disable enable-list\uFF0C\u518D\u79FB\u5165 trashDir \u6216\u76F4\u63A5\u5220\u9664\u76EE\u5F55\u3002\n * trashDir \u8DE8\u76D8\u7B26\u65F6 fallback \u4E3A copy + rm\u3002\n */\nexport async function uninstallInstalledPack(opts: {\n  bdsRoot: string;\n  levelName: string;\n  pack: InstalledWorldPack;\n  /** \u63D0\u4F9B\u5219\u79FB\u5165\u8BE5\u76EE\u5F55\uFF1Bnull/\u7701\u7565\u5219\u76F4\u63A5\u5220\u9664 */\n  trashDir?: string | null;\n}): Promise<UninstallPackResult> {\n  await disableInstalledPack({\n    bdsRoot: opts.bdsRoot,\n    levelName: opts.levelName,\n    kind: opts.pack.kind,\n    packUuid: opts.pack.uuid,\n    version: opts.pack.version,\n  });\n\n  if (!fs.existsSync(opts.pack.dir)) {\n    return { action: \"missing\" };\n  }\n\n  const trashDir = opts.trashDir?.trim() || null;\n  if (trashDir) {\n    await fs.promises.mkdir(trashDir, { recursive: true });\n    const stamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n    let dest = path.join(trashDir, opts.pack.folderName);\n    if (fs.existsSync(dest)) {\n      dest = path.join(trashDir, `${opts.pack.folderName}-${stamp}`);\n    }\n    try {\n      await fs.promises.rename(opts.pack.dir, dest);\n    } catch {\n      await copyDirAsync(opts.pack.dir, dest);\n      await fs.promises.rm(opts.pack.dir, { recursive: true, force: true });\n    }\n    return { action: \"trashed\", dest };\n  }\n\n  await fs.promises.rm(opts.pack.dir, { recursive: true, force: true });\n  return { action: \"deleted\" };\n}\n\nexport function worldPackParentDir(\n  bdsRoot: string,\n  levelName: string,\n  kind: WorldPackKind\n): string {\n  return path.join(\n    bdsWorldLevelDir(bdsRoot, levelName),\n    kind === \"behavior\" ? \"behavior_packs\" : \"resource_packs\"\n  );\n}\n\n/** \u4E16\u754C enable-list \u6743\u5A01\u8BFB\u53D6 \u2014 \u59D4\u6258 pack-manager\uFF08\u4F9B doctor \u7B49\uFF0C\u907F\u514D\u786C\u7F16\u7801\u6587\u4EF6\u540D\uFF09 */\nexport function listWorldEnableEntries(\n  bdsRoot: string,\n  levelName: string,\n  kind: WorldPackKind\n): Array<{ pack_id: string; version: [number, number, number] }> {\n  return listWorldEnableListResult(bdsRoot, levelName, kind).entries;\n}\n\n/** \u542B parseFail \u4FE1\u53F7\u7684 enable-list \u5FEB\u7167\uFF08doctor \u7528\uFF1B\u4E0D\u66B4\u9732 JSON \u8DEF\u5F84\u6784\u9020\u7EC6\u8282\uFF09 */\nexport function listWorldEnableListResult(\n  bdsRoot: string,\n  levelName: string,\n  kind: WorldPackKind\n): WorldPackListReadResult {\n  return readWorldPackListResult(bdsWorldsDir(bdsRoot), levelName, kind);\n}\n\nexport function findInstalledPackById(\n  packs: InstalledWorldPack[],\n  id: string\n): InstalledWorldPack | null {\n  const q = id.trim().toLowerCase();\n  return (\n    packs.find(\n      (p) =>\n        p.uuid.toLowerCase() === q ||\n        p.folderName.toLowerCase() === q ||\n        p.name.toLowerCase() === q ||\n        p.folderName.toLowerCase().includes(q) ||\n        p.name.toLowerCase().includes(q)\n    ) ?? null\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/zipx.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 将 zip 条目名解析为 destRoot 下的绝对路径。
+ * 拒绝 `..`、绝对路径（含前导 `/`、盘符）、以及 resolve 后逃逸 destRoot 的条目。
+ */
+export declare function resolveSafeZipEntryPath(destRoot: string, entryName: string): string;
+/** 将 zip Buffer 解压到 destDir（已存在则写入其下）。 */
+export declare function extractZipBufferToDir(data: Buffer, destDir: string): Promise<void>;
+/** 从磁盘 zip 文件解压到 destDir。 */
+export declare function extractZipFileToDir(zipPath: string, destDir: string): Promise<void>;
+//# sourceMappingURL=zipx.d.ts.map

package/dist/zipx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipx.d.ts","sourceRoot":"","sources":["../src/zipx.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAiBnF;AAED,0CAA0C;AAC1C,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAexF;AAED,6BAA6B;AAC7B,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzF"}

package/dist/zipx.js

@@ -0,0 +1,48 @@
+import fs from "node:fs";
+import path from "node:path";
+import JSZip from "jszip";
+function resolveSafeZipEntryPath(destRoot, entryName) {
+  const raw = String(entryName ?? "").replace(/\\/g, "/");
+  if (!raw || raw.includes("..") || raw.startsWith("/") || /^[a-zA-Z]:/.test(raw)) {
+    throw new Error(`unsafe zip entry path: ${entryName}`);
+  }
+  const parts = raw.replace(/\/$/, "").split("/").filter(Boolean);
+  if (parts.length === 0) {
+    throw new Error(`unsafe zip entry path: ${entryName}`);
+  }
+  const rootResolved = path.resolve(destRoot);
+  const out = path.resolve(rootResolved, ...parts);
+  const rootPrefix = rootResolved.endsWith(path.sep) ? rootResolved : rootResolved + path.sep;
+  if (out !== rootResolved && !out.startsWith(rootPrefix)) {
+    throw new Error(`zip entry escapes dest: ${entryName}`);
+  }
+  return out;
+}
+async function extractZipBufferToDir(data, destDir) {
+  const zip = await JSZip.loadAsync(data);
+  await fs.promises.mkdir(destDir, { recursive: true });
+  for (const name of Object.keys(zip.files)) {
+    const entry = zip.files[name];
+    if (!entry) continue;
+    const out = resolveSafeZipEntryPath(destDir, name);
+    if (entry.dir || name.endsWith("/") || name.endsWith("\\")) {
+      await fs.promises.mkdir(out, { recursive: true });
+      continue;
+    }
+    await fs.promises.mkdir(path.dirname(out), { recursive: true });
+    const buf = await entry.async("nodebuffer");
+    await fs.promises.writeFile(out, buf);
+  }
+}
+async function extractZipFileToDir(zipPath, destDir) {
+  const abs = path.resolve(zipPath);
+  if (!fs.existsSync(abs)) throw new Error(`archive not found: ${abs}`);
+  const data = await fs.promises.readFile(abs);
+  await extractZipBufferToDir(data, destDir);
+}
+export {
+  extractZipBufferToDir,
+  extractZipFileToDir,
+  resolveSafeZipEntryPath
+};
+//# sourceMappingURL=zipx.js.map