modelstage 0.5.24 → 0.6.1

package/tool/lib/cubism-core.mjs

@@ -1,122 +0,0 @@
-// ============================================================================
-// tool/lib/cubism-core.mjs —— 在 Node 的 vm 沙箱里跑 Cubism Core（浏览器构建）
-//
-// 为什么需要：生成 motion3 需要 moc3 的**真实参数 Id**（Core 的 parameters.ids）。
-//   纯字符串扫描（moc3NameCandidates）得到的候选名不等于参数 Id：实测用它建 hashLookup
-//   会让绑定哈希全部认不出。Core 是浏览器包（Emscripten），所以要垫一个最小浏览器环境。
-//
-// 沙箱契约（与 spine-runtime.mjs 同思路）：
-//   · 提供 document.currentScript / location / atob / 可应答 data: URI 的 XMLHttpRequest
-//     —— Core 的 Emscripten 外壳用它们取内嵌 base64 的 WASM 初始化数据
-//   · 不提供 process/require：避免它走 Node 分支去 readFileSync 一个 data: URI
-//   · 初始化时机：脚本 eval 完即完成（Emscripten 的 run() 在 eval 末尾），随后自检版本
-//   · 释放：用完必须 model.release() → moc._release()（顺序固定），本模块在 finally 里保证
-//
-// 内存：Core 是 WASM 堆，泄漏会累积。getParameterIds 每次调用都成对释放；
-//   调用方连续处理多个包时 RSS 应保持平稳（导出 CLI 的实测值见文档）。
-// ============================================================================
-
-import fs from 'node:fs';
-import path from 'node:path';
-import vm from 'node:vm';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const ROOT = path.resolve(__dirname, '..', '..');
-
-// Core 的候选路径（项目自带优先；也可用 CUBISM_CORE 指到别处）
-const CORE_CANDIDATES = [
-  path.join(ROOT, 'tool', 'vendor', 'live2dcubismcore.min.js'),
-  process.env.CUBISM_CORE || '',
-].filter(Boolean);
-
-let sandboxCache = null;
-
-/** 最小浏览器垫片 + 加载 Core。只做一次（Core 初始化 ~26ms）。 */
-function getCore() {
-  if (sandboxCache) return sandboxCache;
-  const file = CORE_CANDIDATES.find((p) => fs.existsSync(p));
-  if (!file) throw new Error(`找不到 Cubism Core（试过：${CORE_CANDIDATES.join('、')}）`);
-
-  // Core 的 WASM 初始化数据内嵌为 data: URI，Emscripten 外壳用 XHR 取；这里给个只认 data: 的桩
-  class DataUriXHR {
-    open(_method, url) { this.url = url; }
-    send() {
-      const m = /^data:([^;]*);base64,(.*)$/s.exec(String(this.url));
-      if (!m) throw new Error(`Cubism Core 请求了非 data: URI（${String(this.url).slice(0, 60)}），沙箱不提供网络`);
-      const buf = Buffer.from(m[2], 'base64');
-      this.response = buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);
-      this.responseText = buf.toString('latin1');
-      this.status = 200;
-      this.readyState = 4;
-      if (this.onload) this.onload();
-    }
-    addEventListener() {}
-  }
-
-  const ctx = {
-    console: { log() {}, info() {}, warn() {}, error() {}, debug() {} },
-    WebAssembly, TextDecoder, TextEncoder, ArrayBuffer, Math, Date,
-    setTimeout, clearTimeout,
-    atob: (s) => Buffer.from(s, 'base64').toString('binary'),
-    document: { currentScript: { src: 'http://localhost/live2dcubismcore.min.js' }, addEventListener() {} },
-    XMLHttpRequest: DataUriXHR,
-    location: { href: 'http://localhost/live2dcubismcore.min.js' },
-  };
-  ctx.window = ctx;
-  ctx.self = ctx;
-  ctx.globalThis = ctx;
-  vm.createContext(ctx);
-  vm.runInContext(fs.readFileSync(file, 'utf8'), ctx, { filename: 'live2dcubismcore.min.js' });
-
-  const L = ctx.Live2DCubismCore;
-  if (!L || !L.Moc || !L.Model) throw new Error('Cubism Core 加载后没有 Moc/Model 导出');
-  // 自检：csmGetVersion 返回编码版本（如 67239938 = 4.2.0 的编码），拿不到就说明沙箱里没跑起来
-  const version = L.Version && L.Version.csmGetVersion ? L.Version.csmGetVersion() : null;
-  if (!version) throw new Error('Cubism Core 自检失败：Version.csmGetVersion() 无返回');
-  sandboxCache = { L, version, file, coreEvalMs: 0 };
-  return sandboxCache;
-}
-
-/** Core 版本信息（自检/报告用） */
-export function coreInfo() {
-  const { version, file } = getCore();
-  return { version, file, latestMocVersion: sandboxCache.L.Version.csmGetLatestMocVersion() };
-}
-
-/**
- * 从 moc3 字节取**真实参数 Id**（用完立即释放 model 与 moc）。
- * @param {Uint8Array} moc3
- * @returns {{ids:string[], canvas:{width:number,height:number,ppu:number}, count:number}}
- */
-export function getParameterIds(moc3) {
-  const { L } = getCore();
-  if (!moc3 || !moc3.length) throw new Error('moc3 为空');
-  // Core 需要 ArrayBuffer（不是 Node Buffer 切片）
-  const ab = moc3.buffer.slice(moc3.byteOffset, moc3.byteOffset + moc3.byteLength);
-  let moc = null;
-  let model = null;
-  try {
-    moc = L.Moc.fromArrayBuffer(ab);
-    if (!moc) throw new Error('Moc.fromArrayBuffer 返回 null（moc3 损坏或版本过新）');
-    model = L.Model.fromMoc(moc);
-    if (!model) throw new Error('Model.fromMoc 返回 null');
-    const ids = Array.from(model.parameters.ids);
-    const info = model.canvasinfo;
-    return {
-      ids,
-      count: model.parameters.count,
-      canvas: {
-        width: info.CanvasWidth / info.PixelsPerUnit,
-        height: info.CanvasHeight / info.PixelsPerUnit,
-        ppu: info.PixelsPerUnit,
-      },
-    };
-  } finally {
-    // 释放顺序固定：先 model 再 moc；任一为 null 就跳过，绝不让异常吃掉释放
-    try { if (model) model.release(); } catch { /* 释放失败不掩盖原错误 */ }
-    try { if (moc) moc._release(); } catch { /* 同上 */ }
-  }
-}
-
-export const CORE_PATHS = { ROOT, CORE_CANDIDATES };

package/tool/lib/export-bundle.mjs

@@ -1,328 +0,0 @@
-// ============================================================================
-// tool/lib/export-bundle.mjs —— 把 UnityFS 资源包导出成「标准 Live2D 模型目录」
-//
-// 产出目录（与 AzurLane-Live2D-Viewer 等第三方查看器认可的形态一致）：
-//   <out>/<资源名>/
-//     <资源名>.moc3
-//     <资源名>.physics3.json          （包里没有就跳过）
-//     <资源名>.model3.json            （FileReferences 指向同目录文件）
-//     textures/texture_XX.png         （ETC2/DXT 解码 → RGBA → PNG 真压缩）
-//     export-report.json              （耗时/字节/跳过/警告，便于批量核对）
-//
-// 为什么这样组织：
-//   · 解析/解码/编码全部复用插件里的 lib（同一份实现，避免第二套解析）
-//   · PNG 必须用 encodePngAsync（真 deflate）；encodePng 是 stored 不压缩，4096² 会写 67MB
-//   · 先写 .tmp-<name>-<pid>/ 再 rename，失败/断电不留半成品
-//   · 阶段 1 **不导出 motion3**：生成 motion3 需要 moc3 的真实参数 Id（Cubism Core），
-//     纯 Node 侧拿不到（实测用名字候选建立的 hashLookup 会让 466 条曲线全部 skippedUnknownBinding）
-// ============================================================================
-
-import fs from 'node:fs';
-import path from 'node:path';
-import vm from 'node:vm';
-import zlib from 'node:zlib';
-import { fileURLToPath } from 'node:url';
-import { getParameterIds, coreInfo } from './cubism-core.mjs';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const ROOT = path.resolve(__dirname, '..', '..');
-const LIB_DIR = path.join(ROOT, 'plugins', 'unity-live2d-bundle', 'lib');
-
-// 依赖顺序：errors 最先，model3 最后（组装 model3.json）
-const LIB_ORDER = [
-  'errors.js', 'bytes.js', 'common-strings.js', 'unityfs.js', 'serialized.js', 'typetree.js',
-  'extract.js', 'etc2.js', 'dxt.js', 'texdecode.js', 'png.js', 'anim-to-motion.js', 'model3.js',
-];
-
-let sandbox = null;
-/** 建（或取缓存的）插件库沙箱；PNG 的 deflate/inflate 用 Node 的 zlib 注入 */
-function getLibs() {
-  if (sandbox) return sandbox;
-  const ctx = { console: { log() {}, info() {}, warn() {}, error() {} }, TextDecoder, TextEncoder, setTimeout, clearTimeout };
-  ctx.globalThis = ctx; ctx.window = ctx; ctx.self = ctx;
-  vm.createContext(ctx);
-  for (const rel of LIB_ORDER) {
-    const abs = path.join(LIB_DIR, rel);
-    if (!fs.existsSync(abs)) throw new Error(`导出依赖缺失：${abs}`);
-    vm.runInContext(fs.readFileSync(abs, 'utf8'), ctx, { filename: `ulb-lib/${rel}` });
-  }
-  const NS = ctx.__ULB__;
-  if (NS.png && NS.png.setDeflate) NS.png.setDeflate((u8) => new Uint8Array(zlib.deflateSync(Buffer.from(u8))));
-  if (NS.png && NS.png.setInflate) NS.png.setInflate((u8) => new Uint8Array(zlib.inflateSync(Buffer.from(u8))));
-  sandbox = NS;
-  return sandbox;
-}
-
-/** 递归汇总目录字节数（报告用） */
-function dirBytes(dir) {
-  let total = 0;
-  const walk = (d) => {
-    let es = [];
-    try { es = fs.readdirSync(d, { withFileTypes: true }); } catch { return; }
-    for (const e of es) {
-      const p = path.join(d, e.name);
-      if (e.isDirectory()) walk(p);
-      else { try { total += fs.statSync(p).size; } catch { /* 忽略单个文件 */ } }
-    }
-  };
-  walk(dir);
-  return total;
-}
-
-/**
- * 解析资源包并规划导出（不写盘）。dryRun 也走这一步，保证"将要做什么"与真做一致。
- * @returns {{name, textures:[{name,w,h,format,formatName,supported}], moc3Bytes, physicsBytes, warnings, skippedTextures}}
- */
-export function planExport(bundleBytes) {
-  const NS = getLibs();
-  const E = NS.errors;
-  if (!bundleBytes || !bundleBytes.length) throw E.fail(E.CODES.NO_FILE, '资源包为空或不存在');
-  let sig = '';
-  for (let i = 0; i < Math.min(7, bundleBytes.length); i++) sig += String.fromCharCode(bundleBytes[i]);
-  if (sig !== 'UnityFS') throw E.fail(E.CODES.NOT_UNITYFS, `不是 UnityFS 资源包（signature="${sig.replace(/[^\x20-\x7e]/g, '?')}"）`);
-
-  let parsed, sf, got;
-  try {
-    parsed = NS.unityfs.parse(bundleBytes);
-    const cab = parsed.nodes.find((n) => /^CAB-/.test(n.path));
-    if (!cab) throw E.fail(E.CODES.NO_CAB, '资源包里没有 CAB-* 节点（不是资产包）');
-    const resS = parsed.nodes.find((n) => /\.resS$/.test(n.path));
-    const cabBytes = NS.unityfs.nodeBytes(parsed, cab.path);
-    const resSBytes = resS ? NS.unityfs.nodeBytes(parsed, resS.path) : null;
-    sf = NS.serialized.parse(cabBytes);
-    got = NS.extract.extractAll({ cabBytes, resSBytes, sf, resSBytesForTextures: resSBytes });
-  } catch (e) {
-    if (e && e.code) throw e;
-    throw E.fail(E.CODES.CONTAINER_PARSE, `容器解析失败：${e.message}`);
-  }
-  if (!got.moc3) throw E.fail(E.CODES.MODEL_BUILD, '包里没有 moc3（不是 Live2D 资源包？）');
-
-  const textures = (got.textures || []).map((t) => {
-    const f = NS.texdecode.FORMATS[t.format];
-    return {
-      name: t.name, width: t.width, height: t.height, format: t.format,
-      formatName: f ? f.name : `未知格式 ${t.format}`,
-      supported: !!f,
-    };
-  });
-  return {
-    parsed, sf, got, textures,
-    moc3Bytes: got.moc3,
-    physicsBytes: got.physics3 || null,
-    warnings: [],
-    skippedTextures: textures.filter((t) => !t.supported).map((t) => t.formatName),
-  };
-}
-
-/**
- * 执行导出。
- * @param {object} opts
- *   bundleBytes 资源包字节 | outDir 输出根 | name 资源名 | force 覆盖 | dryRun 只规划
- *   profile 可选（传给 buildModel3，用于 HitAreas 等）
- *   onProgress({stage, ...})
- */
-
-/** 最坏情况产物估算：PNG 压缩后体积 ≤ 原始 RGBA，用它做磁盘检查上界 */
-function estimateBytes(plan) {
-  let raw = 0;
-  for (const t of plan.textures) if (t.supported) raw += t.width * t.height * 4;
-  return raw + plan.moc3Bytes.length + (plan.physicsBytes ? plan.physicsBytes.length : 0);
-}
-
-/**
- * 磁盘余量检查：剩余 < 预估×1.5 直接抛 ULB_ERR_EXPORT_NO_SPACE；
- * 查不到剩余空间（如跨设备/权限）只记 warning，不阻断导出。
- */
-function checkDisk(NS, outRoot, estimate, warnings) {
-  try {
-    let probeDir = outRoot;
-    while (!fs.existsSync(probeDir) && path.dirname(probeDir) !== probeDir) probeDir = path.dirname(probeDir);
-    const st = fs.statfsSync(probeDir);
-    const free = st.bavail * st.bsize;
-    if (free < estimate * 1.5) {
-      throw NS.errors.fail(NS.errors.CODES.EXPORT_NO_SPACE, `磁盘空间不足：需要约 ${(estimate * 1.5 / 1048576).toFixed(0)} MB，剩余 ${(free / 1048576).toFixed(0)} MB`);
-    }
-  } catch (e) {
-    if (e && e.code === NS.errors.CODES.EXPORT_NO_SPACE) throw e;
-    warnings.push(`磁盘剩余空间检查失败（继续导出）：${e.message}`);
-  }
-}
-
-/** 纹理：解码 → PNG（真压缩）→ 写盘；单张失败只记 warning，不中断整包 */
-async function writeTextures(NS, plan, tmpDir, progress, warnings, written) {
-  const rels = [];
-  fs.mkdirSync(path.join(tmpDir, 'textures'), { recursive: true });
-  const resSNode = plan.parsed.nodes.find((n) => /\.resS$/.test(n.path));
-  const resSBytes = resSNode ? NS.unityfs.nodeBytes(plan.parsed, resSNode.path) : null;
-  for (const t of plan.textures) {
-    if (!t.supported) continue;
-    progress({ stage: 'texture', name: t.name, width: t.width, height: t.height });
-    let rgba;
-    try {
-      const texObj = plan.got.textures.find((x) => x.name === t.name);
-      rgba = NS.texdecode.decode(texObj, NS.extract.textureCompressedBytes(texObj, resSBytes), { flipY: true });
-    } catch (e) {
-      warnings.push(`纹理 ${t.name} 解码失败，已跳过：${e.message}`);
-      continue;
-    }
-    const png = await NS.png.encodePngAsync(rgba, t.width, t.height);
-    const rel = `textures/${t.name}.png`;
-    fs.writeFileSync(path.join(tmpDir, rel), png);
-    written.push({ rel, bytes: png.length });
-    rels.push(rel);
-  }
-  return rels;
-}
-
-/**
- * motion3：优先直接落包内原生 motion3；否则用 Cubism Core 的真实参数 Id 建白名单后转换。
- *   转换逻辑全部复用 lib/anim-to-motion.js（含单点曲线补两点），不另写一套。
- * @returns {{defs:Array<{name,url,group}>, curves:{total,emitted,skipped}|null, dropped:number, source:'native'|'converted'}}
- */
-function writeMotions(NS, arg) {
-  const { plan, profile, tmpDir, written, progress } = arg;
-  const native = (plan.got.nativeFiles || []).filter((f) => /motion3\.json$/i.test(f.name));
-  if (native.length) {
-    fs.mkdirSync(path.join(tmpDir, 'motions'), { recursive: true });
-    const defs = [];
-    for (const f of native) {
-      const rel = `motions/${f.name}`;
-      fs.writeFileSync(path.join(tmpDir, rel), f.bytes);
-      written.push({ rel, bytes: f.bytes.length });
-      const base = f.name.replace(/\.motion3\.json$/i, '');
-      defs.push({ name: base, url: rel, group: NS.model3.motionGroupOf(base, profile) });
-    }
-    return { defs, curves: null, dropped: 0, source: 'native' };
-  }
-
-  progress({ stage: 'motions' });
-  const { ids } = getParameterIds(plan.moc3Bytes);
-  const candidates = [...new Set([...NS.extract.moc3NameCandidates(plan.moc3Bytes), ...ids])];
-  const opts = { paramWhitelist: new Set(ids), isLoop: (n) => NS.model3.motionLoops(n, profile) };
-  if (profile && profile.motion) {
-    opts.fadeIn = profile.motion.fadeInTime;
-    opts.fadeOut = profile.motion.fadeOutTime;
-  }
-  const conv = NS.animToMotion.clipsToMotions(plan.sf, candidates, opts);
-  fs.mkdirSync(path.join(tmpDir, 'motions'), { recursive: true });
-  const defs = [];
-  const curves = { total: 0, emitted: 0, skipped: 0 };
-  for (const m of conv.motions) {
-    const text = JSON.stringify(m.json);
-    const rel = `motions/${m.name}.motion3.json`;
-    fs.writeFileSync(path.join(tmpDir, rel), text);
-    written.push({ rel, bytes: Buffer.byteLength(text) });
-    defs.push({ name: m.name, url: rel, group: NS.model3.motionGroupOf(m.name, profile) });
-    curves.total += (m.stats.curvesTotal || 0);
-    curves.emitted += (m.stats.emitted || 0);
-    curves.skipped += (m.stats.skippedUnknownBinding || 0);
-  }
-  return { defs, curves, dropped: (conv.dropped || []).length, source: 'converted' };
-}
-
-/** model3.json：Motions 由 writeMotions 的结果填充；空 Motions 会被删掉（避免部分运行时报错） */
-function writeModel3(NS, arg) {
-  const { name, textureRels, plan, profile, tmpDir, written, motions } = arg;
-  const model3 = NS.model3.buildModel3({
-    mocUrl: `${name}.moc3`,
-    textureUrls: textureRels,
-    physicsUrl: plan.physicsBytes ? `${name}.physics3.json` : null,
-    motions: motions || [],
-    paramNames: [],
-    profile: profile || null,
-  });
-  const refs = model3.FileReferences;
-  if (refs && refs.Motions && !Object.keys(refs.Motions).length) delete refs.Motions;
-  const text = JSON.stringify(model3, null, 2);
-  fs.writeFileSync(path.join(tmpDir, `${name}.model3.json`), text);
-  written.push({ rel: `${name}.model3.json`, bytes: Buffer.byteLength(text) });
-}
-
-/** 报告落盘 + 原子落位（先 rename 到最终目录，保证读者永远看不到半成品） */
-function finalize(arg) {
-  const { name, bundleBytes, t0, written, plan, warnings, tmpDir, finalDir, motions } = arg;
-  const report = {
-    name, bundleBytes, generatedAt: new Date().toISOString(), tookMs: Date.now() - t0,
-    files: written, totalBytes: written.reduce((a, f) => a + f.bytes, 0),
-    textures: plan.textures,
-    motions: {
-      count: (motions.defs || []).length,
-      source: motions.source,
-      dropped: motions.dropped || 0,
-      curves: motions.curves,
-      groups: [...new Set((motions.defs || []).map((d) => d.group))],
-    },
-    cubismCore: coreInfo(),
-    warnings,
-  };
-  const text = JSON.stringify(report, null, 2);
-  fs.writeFileSync(path.join(tmpDir, 'export-report.json'), text);
-  written.push({ rel: 'export-report.json', bytes: Buffer.byteLength(text) });
-  if (fs.existsSync(finalDir)) fs.rmSync(finalDir, { recursive: true, force: true }); // 仅 --force 会走到这
-  fs.renameSync(tmpDir, finalDir);
-}
-
-/**
- * 执行导出（编排：规划 → 磁盘 → dry-run → 已存在 → 写临时目录 → 原子落位）。
- * 具体写盘工作交给 writeTextures / writeMotions / writeModel3 / finalize。
- */
-export async function exportBundle(opts) {
-  const NS = getLibs();
-  const o = opts || {};
-  const t0 = Date.now();
-  const progress = typeof o.onProgress === 'function' ? o.onProgress : () => {};
-  const name = String(o.name || '').trim();
-  if (!name) throw new Error('缺少资源名（name）');
-  const outRoot = path.resolve(o.outDir || path.join(ROOT, 'data', 'export'));
-  const finalDir = path.join(outRoot, name);
-
-  progress({ stage: 'plan' });
-  const plan = planExport(o.bundleBytes);
-  const warnings = [...plan.warnings];
-  if (plan.skippedTextures.length) {
-    warnings.push(`以下纹理格式暂不支持，已跳过（不整体失败）：${[...new Set(plan.skippedTextures)].join('、')}`);
-  }
-  const estimate = estimateBytes(plan);
-  checkDisk(NS, outRoot, estimate, warnings);
-  const textures = plan.textures.map((t) => ({ name: t.name, width: t.width, height: t.height, formatName: t.formatName, supported: t.supported }));
-
-  if (o.dryRun) {
-    return {
-      ok: true, dryRun: true, name, outDir: finalDir, existed: fs.existsSync(finalDir),
-      wouldWrite: [`${name}.moc3`, ...(plan.physicsBytes ? [`${name}.physics3.json`] : []),
-        ...plan.textures.filter((t) => t.supported).map((t) => `textures/${t.name}.png`),
-        'motions/<动作名>.motion3.json', `${name}.model3.json`, 'export-report.json'],
-      textures, estimateBytes: estimate, warnings, ms: Date.now() - t0,
-    };
-  }
-  if (fs.existsSync(finalDir) && !o.force) {
-    return { ok: true, skipped: true, reason: '目标目录已存在（加 --force 覆盖）', name, outDir: finalDir, textures, warnings, ms: Date.now() - t0 };
-  }
-
-  fs.mkdirSync(outRoot, { recursive: true });
-  const tmpDir = path.join(outRoot, `.tmp-${name}-${process.pid}`);
-  fs.rmSync(tmpDir, { recursive: true, force: true });
-  fs.mkdirSync(tmpDir, { recursive: true });
-  const written = [];
-  try {
-    fs.writeFileSync(path.join(tmpDir, `${name}.moc3`), plan.moc3Bytes);
-    written.push({ rel: `${name}.moc3`, bytes: plan.moc3Bytes.length });
-    if (plan.physicsBytes) {
-      fs.writeFileSync(path.join(tmpDir, `${name}.physics3.json`), plan.physicsBytes);
-      written.push({ rel: `${name}.physics3.json`, bytes: plan.physicsBytes.length });
-    }
-    const rels = await writeTextures(NS, plan, tmpDir, progress, warnings, written);
-    const motions = writeMotions(NS, { plan, profile: o.profile, tmpDir, written, progress });
-    writeModel3(NS, { name, textureRels: rels, plan, profile: o.profile, tmpDir, written, motions: motions.defs });
-    finalize({ name, bundleBytes: o.bundleBytes.length, t0, written, plan, warnings, tmpDir, finalDir, motions });
-    return {
-      ok: true, name, outDir: finalDir, files: written.length, totalBytes: dirBytes(finalDir),
-      tookMs: Date.now() - t0, textures, motions: motions.defs.length, curves: motions.curves, warnings,
-    };
-  } catch (e) {
-    try { fs.rmSync(tmpDir, { recursive: true, force: true }); } catch { /* 清理失败不掩盖原错误 */ }
-    throw e;
-  }
-}
-
-export const EXPORT_PATHS = { ROOT, LIB_DIR, LIB_ORDER };

package/tool/lib/spine-runtime.mjs

@@ -1,131 +0,0 @@
-// ============================================================================
-// tool/lib/spine-runtime.mjs —— Spine 运行时源码定位 + 在 Node 里受控加载
-//
-// 为什么要单独一层：Spine 的 .skel/.json 只能由**对应版本**的运行时解析，
-//   而运行时代码是浏览器风格的打包体（会摸 document/window）。这里在 Node 的 vm 沙箱里
-//   垫一个最小 DOM 垫片把它跑起来，只用来做**数据层解析**（不渲染、不碰 WebGL）。
-//
-// 源码来源（按优先级，逐条探测，命中即用）：
-//   ① src/spine-runtimes/spine-webgl-<ver>.js        —— 项目内（该目录不入库）
-//   ② ../spine-runtimes/spine-webgl-<ver>.js         —— 工作区共享
-//   ③ 环境变量 SPINE_RUNTIME_DIR 指定的目录
-//
-// 没有内联兜底：运行时源码必须由外部提供，找不到时显式报错并给修复指引。
-//
-// 懒加载：首次真正要解析某版本时才读源码 + 建沙箱，之后按版本缓存；不在服务启动时加载。
-// ============================================================================
-
-import fs from 'node:fs';
-import path from 'node:path';
-import vm from 'node:vm';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const ROOT = path.resolve(__dirname, '..', '..');
-const WORKSPACE = path.resolve(ROOT, '..');
-
-/**
- * 数据根：与 web.sh / serve.mjs 同一口径（MODELSTAGE_DATA_ROOT 覆盖，缺省项目根）。
- * 下载物落在 <dataRoot>/runtimes/spine/<ver>/spine-webgl-<ver>.js。
- * @returns {string}
- */
-function dataRootDir() {
-  const env = (process.env.MODELSTAGE_DATA_ROOT || '').trim();
-  return env ? path.resolve(env) : ROOT;
-}
-
-/** 运行时源码候选目录（按优先级） */
-const RUNTIME_DIRS = [
-  path.join(ROOT, 'src', 'spine-runtimes'),
-  path.join(WORKSPACE, 'spine-runtimes'),
-  // **末尾追加**（上面两条的既有优先次序不动）：tool/fetch-runtimes.mjs 的下载落点。
-  //   必须放最后 —— "项目自带优先"不能因为引入下载功能而静默失效。
-  path.join(dataRootDir(), 'runtimes', 'spine'),
-];
-
-
-
-const sourceCache = new Map();   // version → { code, origin }
-/**
- * 取某版本的运行时源码。
- * @param {string} version 如 '3.8' / '4.2'
- * @returns {{code:string, origin:string}|null}
- */
-export function getRuntimeSource(version) {
-  if (sourceCache.has(version)) return sourceCache.get(version);
-  let hit = null;
-  for (const dir of RUNTIME_DIRS) {
-    // 两种布局都要认：
-    //   平铺  <dir>/spine-webgl-<ver>.js            —— 项目自带 / 环境变量目录的既有布局
-    //   分版本 <dir>/<ver>/spine-webgl-<ver>.js      —— tool/fetch-runtimes.mjs 的下载布局
-    //      （分版本目录是为了让每个版本各自带 LICENSE 与 SOURCE.json）
-    for (const p of [path.join(dir, `spine-webgl-${version}.js`), path.join(dir, version, `spine-webgl-${version}.js`)]) {
-      if (fs.existsSync(p)) { hit = { code: fs.readFileSync(p, 'utf8'), origin: p }; break; }
-    }
-    if (hit) break;
-  }
-  if (!hit && process.env.SPINE_RUNTIME_DIR) {
-    const p = path.join(process.env.SPINE_RUNTIME_DIR, `spine-webgl-${version}.js`);
-    if (fs.existsSync(p)) hit = { code: fs.readFileSync(p, 'utf8'), origin: p };
-  }
-  sourceCache.set(version, hit);
-  return hit;
-}
-
-/** 可用版本列表（扫描候选目录；平铺与分版本两种布局都算） */
-export function listRuntimeVersions() {
-  const out = new Set();
-  const addFrom = (dir) => {
-    for (const f of fs.readdirSync(dir)) {
-      const m = f.match(/^spine-webgl-(.+)\.js$/);
-      if (m) out.add(m[1]);
-    }
-  };
-  for (const dir of RUNTIME_DIRS) {
-    if (!fs.existsSync(dir)) continue;
-    addFrom(dir);
-    // 分版本子目录（下载布局）也要列出来
-    let subs = [];
-    try { subs = fs.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name); } catch { /* 跳过 */ }
-    for (const sub of subs) {
-      try { addFrom(path.join(dir, sub)); } catch { /* 跳过读不了的子目录 */ }
-    }
-  }
-  return [...out].sort((a, b) => a.localeCompare(b, undefined, { numeric: true }));
-}
-
-const sandboxCache = new Map();   // version → { spine, origin }
-/**
- * 在 vm 沙箱里加载某版本运行时，返回其导出的 spine 对象（懒加载 + 缓存）。
- *   沙箱只垫数据层需要的最小 DOM 能力：createElement 返回带 getContext()=null 的假 canvas，
- *   足以让运行时完成模块初始化，但任何真正的渲染调用都会失败 —— 这正是我们要的边界。
- */
-export function loadRuntime(version) {
-  if (sandboxCache.has(version)) return sandboxCache.get(version);
-  const src = getRuntimeSource(version);
-  if (!src) throw new Error(`没有可用的 Spine ${version} 运行时源码。请任选一种方式提供：SPINE_RUNTIME_DIR 环境变量 / src/spine-runtimes/ / 工作区共享 ../spine-runtimes/`);
-  const sandbox = {
-    console: { log() {}, info() {}, warn() {}, error() {}, debug() {} },
-    performance: { now: () => Date.now() },
-    navigator: { userAgent: 'node-spine-meta' },
-    setTimeout, clearTimeout, setInterval, clearInterval,
-    TextDecoder, TextEncoder,
-    URL, Blob,
-    document: {
-      createElement: () => ({ getContext: () => null, style: {}, addEventListener() {}, width: 0, height: 0 }),
-      addEventListener() {}, removeEventListener() {},
-    },
-    addEventListener() {}, removeEventListener() {},
-  };
-  sandbox.window = sandbox;
-  sandbox.self = sandbox;
-  sandbox.globalThis = sandbox;
-  vm.createContext(sandbox);
-  vm.runInContext(src.code, sandbox, { filename: `spine-${version}.js` });
-  if (!sandbox.spine) throw new Error(`Spine ${version} 运行时加载后没有导出 spine 对象（源码来源：${src.origin}）`);
-  const hit = { spine: sandbox.spine, origin: src.origin };
-  sandboxCache.set(version, hit);
-  return hit;
-}
-
-export const PATHS = { ROOT, WORKSPACE, RUNTIME_DIRS };