@gmvjs/dunia1 0.0.0-stage → 0.1.0

package/dist/realtree.js

@@ -0,0 +1,127 @@
+const isRealTree = (u) => {
+  if (u.length < 160) return false;
+  const dv = new DataView(u.buffer, u.byteOffset, u.byteLength);
+  if (dv.getUint32(8, true) !== 136) return false;
+  const s = new TextDecoder("latin1").decode(u.subarray(24, 136));
+  return /realtrees?\\/i.test(s);
+};
+function parseRealTree(u) {
+  if (!isRealTree(u)) throw new Error("Не RealTree");
+  const dv = new DataView(u.buffer, u.byteOffset, u.byteLength), dl = dv.getUint32(20, true);
+  let e = u.indexOf(0, 24);
+  if (e < 0 || e > 136) e = 136;
+  const path = new TextDecoder("latin1").decode(u.subarray(24, e));
+  const dataEnd = Math.min(u.length, 136 + dl);
+  let minPtr = Infinity;
+  const hdr = Array.from({ length: 12 }, (_, i) => dv.getUint32(280 + i * 4, true));
+  for (const i of [5, 6, 8, 9, 11]) if (hdr[i] > 65536) minPtr = Math.min(minPtr, hdr[i]);
+  for (let o = 136; o + 4 <= dataEnd; o += 4) {
+    const v = dv.getUint32(o, true);
+    if (v >= 16777216 && v < minPtr && (v & 4294901760) === (minPtr & 4294901760)) minPtr = v;
+  }
+  if (!Number.isFinite(minPtr)) throw new Error("RealTree: нет указателей");
+  const base = minPtr - 864, off = (p) => p - base + 136;
+  const [nNodes, pNodes, nCards, pCards] = [hdr[4], hdr[5], hdr[10], hdr[11]];
+  const branches = [];
+  let cur = null, height = 0;
+  for (let r = 0; r < nNodes; r++) {
+    const o = off(pNodes) + r * 76;
+    if (o < 136 || o + 76 > dataEnd) break;
+    const x = dv.getFloat32(o + 52, true), y = dv.getFloat32(o + 56, true), z = dv.getFloat32(o + 60, true), tip = dv.getUint32(o + 64, true), sc = dv.getFloat32(o + 68, true);
+    if (tip > 1e5 || ![x, y, z, sc].every(Number.isFinite) || Math.max(Math.abs(x), Math.abs(y), Math.abs(z)) > 1e3) break;
+    if (!cur || tip > cur.tips[cur.tips.length - 1]) {
+      cur = { pts: [], tips: [], scale: sc > 0 && sc < 10 ? sc : 1 };
+      branches.push(cur);
+    }
+    cur.pts.push([x, y, z]);
+    cur.tips.push(tip);
+    height = Math.max(height, z);
+  }
+  const cards = [];
+  for (let i = 0; i < nCards; i++) {
+    const o = off(pCards) + i * 92;
+    if (o < 136 || o + 92 > dataEnd) break;
+    const f = (k) => dv.getFloat32(o + k, true);
+    const n = [f(20), f(24), f(28)], a = [f(68), f(72), f(76)];
+    if (![...n, ...a].every(Number.isFinite) || Math.hypot(...a) > 50) continue;
+    if (Math.hypot(...a) > 1e-3) cards.push({ n, a });
+  }
+  const materials = [];
+  const tail = new TextDecoder("latin1").decode(u.subarray(dataEnd, Math.min(u.length, dataEnd + 4096)));
+  for (const m of tail.matchAll(/graphics\\[\w\\ .-]+?\.mlm/gi)) materials.push(m[0]);
+  return { path, branches: branches.filter((b) => b.pts.length >= 2), cards, materials, height };
+}
+const LEAF_SCALE = 0.7, TAPER = 1.1;
+const sub = (a, b) => [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
+const cross = (a, b) => [a[1] * b[2] - a[2] * b[1], a[2] * b[0] - a[0] * b[2], a[0] * b[1] - a[1] * b[0]];
+const norm = (a) => {
+  const l = Math.hypot(a[0], a[1], a[2]) || 1;
+  return [a[0] / l, a[1] / l, a[2] / l];
+};
+function realTreeMeshes(t, bark, leaf, sides = 4) {
+  const R0 = Math.max(0.02, t.height * 0.025);
+  const P = [], N = [], U = [], I = [];
+  for (const b of t.branches) {
+    const t0 = b.tips[0] + 1, first = P.length / 3;
+    let len = 0;
+    b.pts.forEach((p, i) => {
+      const d = norm(sub(b.pts[Math.min(i + 1, b.pts.length - 1)], b.pts[Math.max(i - 1, 0)]));
+      const up = Math.abs(d[2]) < 0.9 ? [0, 0, 1] : [1, 0, 0], s1 = norm(cross(d, up)), s2 = cross(d, s1);
+      const r = R0 * b.scale * Math.max(0.15, Math.pow((b.tips[i] + 1) / t0, TAPER));
+      if (i) len += Math.hypot(...sub(p, b.pts[i - 1]));
+      for (let k = 0; k <= sides; k++) {
+        const a = k / sides * Math.PI * 2, c = Math.cos(a), s = Math.sin(a);
+        const nx = s1[0] * c + s2[0] * s, ny = s1[1] * c + s2[1] * s, nz = s1[2] * c + s2[2] * s;
+        P.push(p[0] + nx * r, p[1] + ny * r, p[2] + nz * r);
+        N.push(nx, ny, nz);
+        U.push(k / sides, len);
+      }
+    });
+    for (let i = 0; i + 1 < b.pts.length; i++) for (let k = 0; k < sides; k++) {
+      const a = first + i * (sides + 1) + k, c = a + sides + 1;
+      I.push(a, c, a + 1, a + 1, c, c + 1);
+    }
+  }
+  const out = [];
+  const mk = (name, m, p, n, uv, idx, alpha) => ({
+    name,
+    texture: m.texture,
+    material: m.material,
+    normalMap: m.normal,
+    vertexCount: p.length / 3,
+    pos: Float32Array.from(p),
+    nor: Float32Array.from(n),
+    uv: Float32Array.from(uv),
+    bone: new Float32Array(0),
+    weight: new Float32Array(0),
+    indices: p.length / 3 > 65535 ? Uint32Array.from(idx) : Uint16Array.from(idx),
+    skinned: false,
+    ...alpha ? { alphaTest: true } : {}
+  });
+  if (I.length) out.push(mk("RealTree · ветви (приближённо)", bark, P, N, U, I, false));
+  if (t.cards.length) {
+    const LP = [], LN = [], LU = [], LI = [];
+    let k = 0;
+    t.branches.forEach((b, bi) => {
+      if (bi === 0 && t.branches.length > 1) return;
+      for (const at of [b.pts.length - 1, Math.floor(b.pts.length / 2)]) {
+        const c = b.pts[at], card = t.cards[k++ % t.cards.length], A = card.a.map((v) => v * LEAF_SCALE), n = norm(card.n), B = cross(n, A);
+        const v0 = LP.length / 3;
+        for (const [sa, sb, u, v] of [[-1, -1, 0, 1], [1, -1, 1, 1], [1, 1, 1, 0], [-1, 1, 0, 0]]) {
+          LP.push(c[0] + A[0] * sa + B[0] * sb, c[1] + A[1] * sa + B[1] * sb, c[2] + A[2] * sa + B[2] * sb);
+          LN.push(n[0], n[1], n[2]);
+          LU.push(u, v);
+        }
+        LI.push(v0, v0 + 1, v0 + 2, v0, v0 + 2, v0 + 3);
+      }
+    });
+    if (LI.length) out.push(mk("RealTree · листва (приближённо)", leaf, LP, LN, LU, LI, true));
+  }
+  return out;
+}
+export {
+  isRealTree,
+  parseRealTree,
+  realTreeMeshes
+};
+//# sourceMappingURL=realtree.js.map

package/dist/realtree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtree.js","sources":["../src/realtree.ts"],"sourcesContent":["// Деревья и кусты RealTree (Far Cry 2): в архиве — по хешу пути, имени нет; внутри — путь «…\\Realtrees\\RT_*.rta».\n// Файл: u32 размер, u32 размер Havok-части, u32 136 (начало данных), 0, 0, u32 размер данных; с 24 — путь; с 136 — дамп\n// памяти редактора (указатели — адреса; база — наименьший указатель − 0x360), после данных — список материалов (.mlm,\n// читаются как .xbm: кора «RealtreeTrunk» и листва), затем — Havok (коллизия).\n// Заголовок в 0x118: u32, u32, f32, u32 уровней ветвей, u32 узлов, ptr узлов, ptr, u32 ветвей, ptr, ptr параметров,\n// u32 карточек листвы, ptr карточек.\n// Узел (76 байт; поля со смещением 52 от начала записи): позиция f32×3, u32 — узлов до конца ветви (у начала ветви\n// больше, чем у предыдущего узла — так ветви делятся), f32 масштаб уровня (ствол 1 или 2, ветви 0.5).\n// Карточка листвы (92 байта): f32 размер с 16, нормаль с 20, касательная с 32, ось полукарточки с 68 (её длина = размер).\n// Сетку дерева игра строит сама по параметрам ветвей — здесь приближение: ветви — трубки по узлам, листва — карточки\n// шаблонов у концов ветвей.\nimport type { Mesh } from '@gmvjs/core/types';\n\nexport interface RealTree { path: string; branches: Array<{ pts: number[][]; tips: number[]; scale: number }>; cards: Array<{ n: number[]; a: number[] }>; materials: string[]; height: number }\n\nexport const isRealTree = (u: Uint8Array): boolean => {\n  if (u.length < 160) return false;\n  const dv = new DataView(u.buffer, u.byteOffset, u.byteLength);\n  if (dv.getUint32(8, true) !== 136) return false;\n  const s = new TextDecoder('latin1').decode(u.subarray(24, 136));\n  return /realtrees?\\\\/i.test(s);\n};\n\nexport function parseRealTree(u: Uint8Array): RealTree {\n  if (!isRealTree(u)) throw new Error('Не RealTree');\n  const dv = new DataView(u.buffer, u.byteOffset, u.byteLength), dl = dv.getUint32(20, true);\n  let e = u.indexOf(0, 24); if (e < 0 || e > 136) e = 136;\n  const path = new TextDecoder('latin1').decode(u.subarray(24, e));\n  const dataEnd = Math.min(u.length, 136 + dl);\n  // база указателей: наименьший указатель-адрес в данных − 0x360 (первая структура после заголовка)\n  let minPtr = Infinity;\n  const hdr = Array.from({ length: 12 }, (_, i) => dv.getUint32(0x118 + i * 4, true));\n  for (const i of [5, 6, 8, 9, 11]) if (hdr[i]! > 0x10000) minPtr = Math.min(minPtr, hdr[i]!);\n  for (let o = 136; o + 4 <= dataEnd; o += 4) { const v = dv.getUint32(o, true); if (v >= 0x01000000 && v < minPtr && (v & 0xffff0000) === (minPtr & 0xffff0000)) minPtr = v; }\n  if (!Number.isFinite(minPtr)) throw new Error('RealTree: нет указателей');\n  const base = minPtr - 0x360, off = (p: number) => p - base + 0x88;\n  const [nNodes, pNodes, nCards, pCards] = [hdr[4]!, hdr[5]!, hdr[10]!, hdr[11]!];\n  const branches: RealTree['branches'] = [];\n  let cur: RealTree['branches'][number] | null = null, height = 0;\n  for (let r = 0; r < nNodes; r++) {\n    const o = off(pNodes) + r * 76;\n    if (o < 136 || o + 76 > dataEnd) break;\n    const x = dv.getFloat32(o + 52, true), y = dv.getFloat32(o + 56, true), z = dv.getFloat32(o + 60, true), tip = dv.getUint32(o + 64, true), sc = dv.getFloat32(o + 68, true);\n    if (tip > 100000 || ![x, y, z, sc].every(Number.isFinite) || Math.max(Math.abs(x), Math.abs(y), Math.abs(z)) > 1000) break;\n    if (!cur || tip > cur.tips[cur.tips.length - 1]!) { cur = { pts: [], tips: [], scale: sc > 0 && sc < 10 ? sc : 1 }; branches.push(cur); }\n    cur.pts.push([x, y, z]); cur.tips.push(tip);\n    height = Math.max(height, z);\n  }\n  const cards: RealTree['cards'] = [];\n  for (let i = 0; i < nCards; i++) {\n    const o = off(pCards) + i * 92;\n    if (o < 136 || o + 92 > dataEnd) break;\n    const f = (k: number) => dv.getFloat32(o + k, true);\n    const n = [f(20), f(24), f(28)], a = [f(68), f(72), f(76)];\n    if (![...n, ...a].every(Number.isFinite) || Math.hypot(...a) > 50) continue;\n    if (Math.hypot(...a) > 1e-3) cards.push({ n, a });\n  }\n  // материалы: строки «…\\.mlm» после данных\n  const materials: string[] = [];\n  const tail = new TextDecoder('latin1').decode(u.subarray(dataEnd, Math.min(u.length, dataEnd + 4096)));\n  for (const m of tail.matchAll(/graphics\\\\[\\w\\\\ .-]+?\\.mlm/gi)) materials.push(m[0]);\n  return { path, branches: branches.filter((b) => b.pts.length >= 2), cards, materials, height };\n}\n\n/** Масштаб карточек листвы и показатель сужения ветвей (подобраны на глаз по кустам и фикусу). */\nconst LEAF_SCALE = 0.7, TAPER = 1.1;\n\nconst sub = (a: number[], b: number[]) => [a[0]! - b[0]!, a[1]! - b[1]!, a[2]! - b[2]!];\nconst cross = (a: number[], b: number[]) => [a[1]! * b[2]! - a[2]! * b[1]!, a[2]! * b[0]! - a[0]! * b[2]!, a[0]! * b[1]! - a[1]! * b[0]!];\nconst norm = (a: number[]) => { const l = Math.hypot(a[0]!, a[1]!, a[2]!) || 1; return [a[0]! / l, a[1]! / l, a[2]! / l]; };\n\n/** Приближённая сетка: ветви — трубки (sides граней), листва — карточки у концов ветвей; bark/leaf — пути материалов .xbm. */\nexport function realTreeMeshes(t: RealTree, bark: { material?: string; texture: string; normal?: string }, leaf: { material?: string; texture: string; normal?: string }, sides = 4): Mesh[] {\n  const R0 = Math.max(0.02, t.height * 0.025);\n  const P: number[] = [], N: number[] = [], U: number[] = [], I: number[] = [];\n  for (const b of t.branches) {\n    const t0 = b.tips[0]! + 1, first = P.length / 3;\n    let len = 0;\n    b.pts.forEach((p, i) => {\n      const d = norm(sub(b.pts[Math.min(i + 1, b.pts.length - 1)]!, b.pts[Math.max(i - 1, 0)]!));\n      const up = Math.abs(d[2]!) < 0.9 ? [0, 0, 1] : [1, 0, 0], s1 = norm(cross(d, up)), s2 = cross(d, s1);\n      const r = R0 * b.scale * Math.max(0.15, Math.pow((b.tips[i]! + 1) / t0, TAPER));\n      if (i) len += Math.hypot(...sub(p, b.pts[i - 1]!));\n      for (let k = 0; k <= sides; k++) {\n        const a = (k / sides) * Math.PI * 2, c = Math.cos(a), s = Math.sin(a);\n        const nx = s1[0]! * c + s2[0]! * s, ny = s1[1]! * c + s2[1]! * s, nz = s1[2]! * c + s2[2]! * s;\n        P.push(p[0]! + nx * r, p[1]! + ny * r, p[2]! + nz * r); N.push(nx, ny, nz); U.push(k / sides, len);\n      }\n    });\n    for (let i = 0; i + 1 < b.pts.length; i++) for (let k = 0; k < sides; k++) {\n      const a = first + i * (sides + 1) + k, c = a + sides + 1;\n      I.push(a, c, a + 1, a + 1, c, c + 1);\n    }\n  }\n  const out: Mesh[] = [];\n  const mk = (name: string, m: { material?: string; texture: string; normal?: string }, p: number[], n: number[], uv: number[], idx: number[], alpha: boolean): Mesh => ({\n    name, texture: m.texture, material: m.material, normalMap: m.normal, vertexCount: p.length / 3, pos: Float32Array.from(p), nor: Float32Array.from(n), uv: Float32Array.from(uv),\n    bone: new Float32Array(0), weight: new Float32Array(0), indices: p.length / 3 > 65535 ? Uint32Array.from(idx) : Uint16Array.from(idx), skinned: false, ...(alpha ? { alphaTest: true } : {}),\n  });\n  if (I.length) out.push(mk('RealTree · ветви (приближённо)', bark, P, N, U, I, false));\n  // листва: у конца каждой ветви (кроме ствола) и у её середины — карточка шаблона (по кругу)\n  if (t.cards.length) {\n    const LP: number[] = [], LN: number[] = [], LU: number[] = [], LI: number[] = [];\n    let k = 0;\n    t.branches.forEach((b, bi) => {\n      if (bi === 0 && t.branches.length > 1) return;\n      for (const at of [b.pts.length - 1, Math.floor(b.pts.length / 2)]) {\n        // карточка сужена (шаблон — полуразмер облака листвы, у концов ветвей оно меньше)\n        const c = b.pts[at]!, card = t.cards[k++ % t.cards.length]!, A = card.a.map((v) => v * LEAF_SCALE), n = norm(card.n), B = cross(n, A);\n        const v0 = LP.length / 3;\n        for (const [sa, sb, u, v] of [[-1, -1, 0, 1], [1, -1, 1, 1], [1, 1, 1, 0], [-1, 1, 0, 0]] as const) {\n          LP.push(c[0]! + A[0]! * sa + B[0]! * sb, c[1]! + A[1]! * sa + B[1]! * sb, c[2]! + A[2]! * sa + B[2]! * sb); LN.push(n[0]!, n[1]!, n[2]!); LU.push(u, v);\n        }\n        LI.push(v0, v0 + 1, v0 + 2, v0, v0 + 2, v0 + 3);\n      }\n    });\n    if (LI.length) out.push(mk('RealTree · листва (приближённо)', leaf, LP, LN, LU, LI, true));\n  }\n  return out;\n}\n"],"names":[],"mappings":"AAeO,MAAM,aAAa,CAAC,MAA2B;AACpD,MAAI,EAAE,SAAS,IAAK,QAAO;AAC3B,QAAM,KAAK,IAAI,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU;AAC5D,MAAI,GAAG,UAAU,GAAG,IAAI,MAAM,IAAK,QAAO;AAC1C,QAAM,IAAI,IAAI,YAAY,QAAQ,EAAE,OAAO,EAAE,SAAS,IAAI,GAAG,CAAC;AAC9D,SAAO,gBAAgB,KAAK,CAAC;AAC/B;AAEO,SAAS,cAAc,GAAyB;AACrD,MAAI,CAAC,WAAW,CAAC,EAAG,OAAM,IAAI,MAAM,aAAa;AACjD,QAAM,KAAK,IAAI,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,GAAG,KAAK,GAAG,UAAU,IAAI,IAAI;AACzF,MAAI,IAAI,EAAE,QAAQ,GAAG,EAAE;AAAG,MAAI,IAAI,KAAK,IAAI,IAAK,KAAI;AACpD,QAAM,OAAO,IAAI,YAAY,QAAQ,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC,CAAC;AAC/D,QAAM,UAAU,KAAK,IAAI,EAAE,QAAQ,MAAM,EAAE;AAE3C,MAAI,SAAS;AACb,QAAM,MAAM,MAAM,KAAK,EAAE,QAAQ,MAAM,CAAC,GAAG,MAAM,GAAG,UAAU,MAAQ,IAAI,GAAG,IAAI,CAAC;AAClF,aAAW,KAAK,CAAC,GAAG,GAAG,GAAG,GAAG,EAAE,EAAG,KAAI,IAAI,CAAC,IAAK,MAAS,UAAS,KAAK,IAAI,QAAQ,IAAI,CAAC,CAAE;AAC1F,WAAS,IAAI,KAAK,IAAI,KAAK,SAAS,KAAK,GAAG;AAAE,UAAM,IAAI,GAAG,UAAU,GAAG,IAAI;AAAG,QAAI,KAAK,YAAc,IAAI,WAAW,IAAI,iBAAiB,SAAS,YAAa,UAAS;AAAA,EAAG;AAC5K,MAAI,CAAC,OAAO,SAAS,MAAM,EAAG,OAAM,IAAI,MAAM,0BAA0B;AACxE,QAAM,OAAO,SAAS,KAAO,MAAM,CAAC,MAAc,IAAI,OAAO;AAC7D,QAAM,CAAC,QAAQ,QAAQ,QAAQ,MAAM,IAAI,CAAC,IAAI,CAAC,GAAI,IAAI,CAAC,GAAI,IAAI,EAAE,GAAI,IAAI,EAAE,CAAE;AAC9E,QAAM,WAAiC,CAAA;AACvC,MAAI,MAA2C,MAAM,SAAS;AAC9D,WAAS,IAAI,GAAG,IAAI,QAAQ,KAAK;AAC/B,UAAM,IAAI,IAAI,MAAM,IAAI,IAAI;AAC5B,QAAI,IAAI,OAAO,IAAI,KAAK,QAAS;AACjC,UAAM,IAAI,GAAG,WAAW,IAAI,IAAI,IAAI,GAAG,IAAI,GAAG,WAAW,IAAI,IAAI,IAAI,GAAG,IAAI,GAAG,WAAW,IAAI,IAAI,IAAI,GAAG,MAAM,GAAG,UAAU,IAAI,IAAI,IAAI,GAAG,KAAK,GAAG,WAAW,IAAI,IAAI,IAAI;AAC1K,QAAI,MAAM,OAAU,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,EAAE,MAAM,OAAO,QAAQ,KAAK,KAAK,IAAI,KAAK,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,IAAI,IAAM;AACrH,QAAI,CAAC,OAAO,MAAM,IAAI,KAAK,IAAI,KAAK,SAAS,CAAC,GAAI;AAAE,YAAM,EAAE,KAAK,IAAI,MAAM,CAAA,GAAI,OAAO,KAAK,KAAK,KAAK,KAAK,KAAK,EAAA;AAAK,eAAS,KAAK,GAAG;AAAA,IAAG;AACxI,QAAI,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;AAAG,QAAI,KAAK,KAAK,GAAG;AAC1C,aAAS,KAAK,IAAI,QAAQ,CAAC;AAAA,EAC7B;AACA,QAAM,QAA2B,CAAA;AACjC,WAAS,IAAI,GAAG,IAAI,QAAQ,KAAK;AAC/B,UAAM,IAAI,IAAI,MAAM,IAAI,IAAI;AAC5B,QAAI,IAAI,OAAO,IAAI,KAAK,QAAS;AACjC,UAAM,IAAI,CAAC,MAAc,GAAG,WAAW,IAAI,GAAG,IAAI;AAClD,UAAM,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC;AACzD,QAAI,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,MAAM,OAAO,QAAQ,KAAK,KAAK,MAAM,GAAG,CAAC,IAAI,GAAI;AACnE,QAAI,KAAK,MAAM,GAAG,CAAC,IAAI,KAAM,OAAM,KAAK,EAAE,GAAG,GAAG;AAAA,EAClD;AAEA,QAAM,YAAsB,CAAA;AAC5B,QAAM,OAAO,IAAI,YAAY,QAAQ,EAAE,OAAO,EAAE,SAAS,SAAS,KAAK,IAAI,EAAE,QAAQ,UAAU,IAAI,CAAC,CAAC;AACrG,aAAW,KAAK,KAAK,SAAS,8BAA8B,EAAG,WAAU,KAAK,EAAE,CAAC,CAAC;AAClF,SAAO,EAAE,MAAM,UAAU,SAAS,OAAO,CAAC,MAAM,EAAE,IAAI,UAAU,CAAC,GAAG,OAAO,WAAW,OAAA;AACxF;AAGA,MAAM,aAAa,KAAK,QAAQ;AAEhC,MAAM,MAAM,CAAC,GAAa,MAAgB,CAAC,EAAE,CAAC,IAAK,EAAE,CAAC,GAAI,EAAE,CAAC,IAAK,EAAE,CAAC,GAAI,EAAE,CAAC,IAAK,EAAE,CAAC,CAAE;AACtF,MAAM,QAAQ,CAAC,GAAa,MAAgB,CAAC,EAAE,CAAC,IAAK,EAAE,CAAC,IAAK,EAAE,CAAC,IAAK,EAAE,CAAC,GAAI,EAAE,CAAC,IAAK,EAAE,CAAC,IAAK,EAAE,CAAC,IAAK,EAAE,CAAC,GAAI,EAAE,CAAC,IAAK,EAAE,CAAC,IAAK,EAAE,CAAC,IAAK,EAAE,CAAC,CAAE;AACxI,MAAM,OAAO,CAAC,MAAgB;AAAE,QAAM,IAAI,KAAK,MAAM,EAAE,CAAC,GAAI,EAAE,CAAC,GAAI,EAAE,CAAC,CAAE,KAAK;AAAG,SAAO,CAAC,EAAE,CAAC,IAAK,GAAG,EAAE,CAAC,IAAK,GAAG,EAAE,CAAC,IAAK,CAAC;AAAG;AAGnH,SAAS,eAAe,GAAa,MAA+D,MAA+D,QAAQ,GAAW;AAC3L,QAAM,KAAK,KAAK,IAAI,MAAM,EAAE,SAAS,KAAK;AAC1C,QAAM,IAAc,CAAA,GAAI,IAAc,CAAA,GAAI,IAAc,CAAA,GAAI,IAAc,CAAA;AAC1E,aAAW,KAAK,EAAE,UAAU;AAC1B,UAAM,KAAK,EAAE,KAAK,CAAC,IAAK,GAAG,QAAQ,EAAE,SAAS;AAC9C,QAAI,MAAM;AACV,MAAE,IAAI,QAAQ,CAAC,GAAG,MAAM;AACtB,YAAM,IAAI,KAAK,IAAI,EAAE,IAAI,KAAK,IAAI,IAAI,GAAG,EAAE,IAAI,SAAS,CAAC,CAAC,GAAI,EAAE,IAAI,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAE,CAAC;AACzF,YAAM,KAAK,KAAK,IAAI,EAAE,CAAC,CAAE,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,KAAK,KAAK,MAAM,GAAG,EAAE,CAAC,GAAG,KAAK,MAAM,GAAG,EAAE;AACnG,YAAM,IAAI,KAAK,EAAE,QAAQ,KAAK,IAAI,MAAM,KAAK,KAAK,EAAE,KAAK,CAAC,IAAK,KAAK,IAAI,KAAK,CAAC;AAC9E,UAAI,EAAG,QAAO,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,IAAI,IAAI,CAAC,CAAE,CAAC;AACjD,eAAS,IAAI,GAAG,KAAK,OAAO,KAAK;AAC/B,cAAM,IAAK,IAAI,QAAS,KAAK,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;AACpE,cAAM,KAAK,GAAG,CAAC,IAAK,IAAI,GAAG,CAAC,IAAK,GAAG,KAAK,GAAG,CAAC,IAAK,IAAI,GAAG,CAAC,IAAK,GAAG,KAAK,GAAG,CAAC,IAAK,IAAI,GAAG,CAAC,IAAK;AAC7F,UAAE,KAAK,EAAE,CAAC,IAAK,KAAK,GAAG,EAAE,CAAC,IAAK,KAAK,GAAG,EAAE,CAAC,IAAK,KAAK,CAAC;AAAG,UAAE,KAAK,IAAI,IAAI,EAAE;AAAG,UAAE,KAAK,IAAI,OAAO,GAAG;AAAA,MACnG;AAAA,IACF,CAAC;AACD,aAAS,IAAI,GAAG,IAAI,IAAI,EAAE,IAAI,QAAQ,IAAK,UAAS,IAAI,GAAG,IAAI,OAAO,KAAK;AACzE,YAAM,IAAI,QAAQ,KAAK,QAAQ,KAAK,GAAG,IAAI,IAAI,QAAQ;AACvD,QAAE,KAAK,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,GAAG,IAAI,CAAC;AAAA,IACrC;AAAA,EACF;AACA,QAAM,MAAc,CAAA;AACpB,QAAM,KAAK,CAAC,MAAc,GAA4D,GAAa,GAAa,IAAc,KAAe,WAA0B;AAAA,IACrK;AAAA,IAAM,SAAS,EAAE;AAAA,IAAS,UAAU,EAAE;AAAA,IAAU,WAAW,EAAE;AAAA,IAAQ,aAAa,EAAE,SAAS;AAAA,IAAG,KAAK,aAAa,KAAK,CAAC;AAAA,IAAG,KAAK,aAAa,KAAK,CAAC;AAAA,IAAG,IAAI,aAAa,KAAK,EAAE;AAAA,IAC9K,MAAM,IAAI,aAAa,CAAC;AAAA,IAAG,QAAQ,IAAI,aAAa,CAAC;AAAA,IAAG,SAAS,EAAE,SAAS,IAAI,QAAQ,YAAY,KAAK,GAAG,IAAI,YAAY,KAAK,GAAG;AAAA,IAAG,SAAS;AAAA,IAAO,GAAI,QAAQ,EAAE,WAAW,SAAS,CAAA;AAAA,EAAC;AAE5L,MAAI,EAAE,OAAQ,KAAI,KAAK,GAAG,kCAAkC,MAAM,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC;AAEpF,MAAI,EAAE,MAAM,QAAQ;AAClB,UAAM,KAAe,CAAA,GAAI,KAAe,CAAA,GAAI,KAAe,CAAA,GAAI,KAAe,CAAA;AAC9E,QAAI,IAAI;AACR,MAAE,SAAS,QAAQ,CAAC,GAAG,OAAO;AAC5B,UAAI,OAAO,KAAK,EAAE,SAAS,SAAS,EAAG;AACvC,iBAAW,MAAM,CAAC,EAAE,IAAI,SAAS,GAAG,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,CAAC,GAAG;AAEjE,cAAM,IAAI,EAAE,IAAI,EAAE,GAAI,OAAO,EAAE,MAAM,MAAM,EAAE,MAAM,MAAM,GAAI,IAAI,KAAK,EAAE,IAAI,CAAC,MAAM,IAAI,UAAU,GAAG,IAAI,KAAK,KAAK,CAAC,GAAG,IAAI,MAAM,GAAG,CAAC;AACpI,cAAM,KAAK,GAAG,SAAS;AACvB,mBAAW,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,GAAY;AAClG,aAAG,KAAK,EAAE,CAAC,IAAK,EAAE,CAAC,IAAK,KAAK,EAAE,CAAC,IAAK,IAAI,EAAE,CAAC,IAAK,EAAE,CAAC,IAAK,KAAK,EAAE,CAAC,IAAK,IAAI,EAAE,CAAC,IAAK,EAAE,CAAC,IAAK,KAAK,EAAE,CAAC,IAAK,EAAE;AAAG,aAAG,KAAK,EAAE,CAAC,GAAI,EAAE,CAAC,GAAI,EAAE,CAAC,CAAE;AAAG,aAAG,KAAK,GAAG,CAAC;AAAA,QACxJ;AACA,WAAG,KAAK,IAAI,KAAK,GAAG,KAAK,GAAG,IAAI,KAAK,GAAG,KAAK,CAAC;AAAA,MAChD;AAAA,IACF,CAAC;AACD,QAAI,GAAG,OAAQ,KAAI,KAAK,GAAG,mCAAmC,MAAM,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC;AAAA,EAC3F;AACA,SAAO;AACT;"}

package/dist/rml.d.ts

@@ -0,0 +1,15 @@
+export interface RmlNode {
+    name: string;
+    value: string;
+    attrs: Record<string, string>;
+    children: RmlNode[];
+}
+export declare function parseRml(u: Uint8Array): RmlNode;
+export declare const rmlChild: (n: RmlNode | undefined, name: string) => RmlNode | undefined;
+export declare const rmlAll: (n: RmlNode | undefined, name: string) => RmlNode[];
+/** Элементы XML по порядку (двоичный XML Dunia или текстовый — как в worlds/tmpla): имя, атрибуты, глубина. */
+export declare function xmlElements(u: Uint8Array): Array<{
+    name: string;
+    attrs: Record<string, string>;
+    depth: number;
+}>;

package/dist/rml.js

@@ -0,0 +1,77 @@
+function parseRml(u) {
+  if (u.length < 5 || u[0] !== 0) throw new Error("Не двоичный XML Dunia");
+  const dv = new DataView(u.buffer, u.byteOffset, u.byteLength);
+  let p = 2;
+  const pk = () => {
+    if (p >= u.length) throw new Error("Двоичный XML обрезан");
+    const b = u[p++];
+    if (b < 254) return b;
+    if (b === 254 || p + 4 > u.length) throw new Error("Двоичный XML: неверное число");
+    const v = dv.getUint32(p, true);
+    p += 4;
+    return v;
+  };
+  const stSize = pk();
+  pk();
+  pk();
+  const node = (depth) => {
+    if (depth > 256) throw new Error("Двоичный XML: слишком глубоко");
+    const n = pk(), v = pk(), ac = pk(), cc = pk();
+    const a = [];
+    for (let i = 0; i < ac; i++) {
+      pk();
+      a.push([pk(), pk()]);
+    }
+    const c = [];
+    for (let i = 0; i < cc; i++) c.push(node(depth + 1));
+    return { n, v, a, c };
+  };
+  const raw = node(0);
+  if (p + stSize > u.length) throw new Error("Двоичный XML: таблица строк обрезана");
+  const st = u.subarray(p, p + stSize), dec = new TextDecoder("utf-8"), cache = /* @__PURE__ */ new Map();
+  const s = (i) => {
+    let r = cache.get(i);
+    if (r === void 0) {
+      let e = st.indexOf(0, i);
+      if (e < 0) e = st.length;
+      r = dec.decode(st.subarray(i, e));
+      cache.set(i, r);
+    }
+    return r;
+  };
+  const conv = (r) => ({ name: s(r.n), value: s(r.v), attrs: Object.fromEntries(r.a.map(([k, v]) => [s(k), s(v)])), children: r.c.map(conv) });
+  return conv(raw);
+}
+const rmlChild = (n, name) => n?.children.find((c) => c.name === name);
+const rmlAll = (n, name) => n?.children.filter((c) => c.name === name) ?? [];
+function xmlElements(u) {
+  const out = [];
+  if (u[0] === 0) {
+    const walk = (n, d) => {
+      out.push({ name: n.name, attrs: n.attrs, depth: d });
+      for (const c of n.children) walk(c, d + 1);
+    };
+    walk(parseRml(u), 0);
+    return out;
+  }
+  const text = new TextDecoder("utf-8").decode(u);
+  let depth = 0;
+  for (const m of text.matchAll(/<(\/?)([A-Za-z_][\w.-]*)([^>]*?)(\/?)>/g)) {
+    if (m[1]) {
+      depth--;
+      continue;
+    }
+    const attrs = {};
+    for (const a of m[3].matchAll(/([\w.:-]+)\s*=\s*"([^"]*)"/g)) attrs[a[1]] = a[2].replace(/&quot;/g, '"').replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
+    out.push({ name: m[2], attrs, depth });
+    if (!m[4]) depth++;
+  }
+  return out;
+}
+export {
+  parseRml,
+  rmlAll,
+  rmlChild,
+  xmlElements
+};
+//# sourceMappingURL=rml.js.map

package/dist/rml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rml.js","sources":["../src/rml.ts"],"sourcesContent":["// Двоичный XML Dunia (XmlResourceFile: worlds/<мир>/generated/<мир>.game.xml и др.).\n// u8 0, u8 ?, затем упакованные u32 (u8 < 0xFE или 0xFF + u32): размер таблицы строк, число узлов, число атрибутов;\n// узел: имя, значение (смещения в таблице строк), число атрибутов, число детей; атрибут: 0, имя, значение; дети — подряд.\n// После дерева — таблица строк (UTF-8, через \\0); имена и значения — смещения в ней.\n\nexport interface RmlNode { name: string; value: string; attrs: Record<string, string>; children: RmlNode[] }\n\nexport function parseRml(u: Uint8Array): RmlNode {\n  if (u.length < 5 || u[0] !== 0) throw new Error('Не двоичный XML Dunia');\n  const dv = new DataView(u.buffer, u.byteOffset, u.byteLength);\n  let p = 2;\n  const pk = () => {\n    if (p >= u.length) throw new Error('Двоичный XML обрезан');\n    const b = u[p++]!;\n    if (b < 0xfe) return b;\n    if (b === 0xfe || p + 4 > u.length) throw new Error('Двоичный XML: неверное число');\n    const v = dv.getUint32(p, true); p += 4; return v;\n  };\n  const stSize = pk(); pk(); pk();\n  type Raw = { n: number; v: number; a: Array<[number, number]>; c: Raw[] };\n  const node = (depth: number): Raw => {\n    if (depth > 256) throw new Error('Двоичный XML: слишком глубоко');\n    const n = pk(), v = pk(), ac = pk(), cc = pk();\n    const a: Array<[number, number]> = [];\n    for (let i = 0; i < ac; i++) { pk(); a.push([pk(), pk()]); }\n    const c: Raw[] = [];\n    for (let i = 0; i < cc; i++) c.push(node(depth + 1));\n    return { n, v, a, c };\n  };\n  const raw = node(0);\n  if (p + stSize > u.length) throw new Error('Двоичный XML: таблица строк обрезана');\n  const st = u.subarray(p, p + stSize), dec = new TextDecoder('utf-8'), cache = new Map<number, string>();\n  const s = (i: number) => {\n    let r = cache.get(i);\n    if (r === undefined) { let e = st.indexOf(0, i); if (e < 0) e = st.length; r = dec.decode(st.subarray(i, e)); cache.set(i, r); }\n    return r;\n  };\n  const conv = (r: Raw): RmlNode => ({ name: s(r.n), value: s(r.v), attrs: Object.fromEntries(r.a.map(([k, v]) => [s(k), s(v)])), children: r.c.map(conv) });\n  return conv(raw);\n}\n\nexport const rmlChild = (n: RmlNode | undefined, name: string): RmlNode | undefined => n?.children.find((c) => c.name === name);\nexport const rmlAll = (n: RmlNode | undefined, name: string): RmlNode[] => n?.children.filter((c) => c.name === name) ?? [];\n\n/** Элементы XML по порядку (двоичный XML Dunia или текстовый — как в worlds/tmpla): имя, атрибуты, глубина. */\nexport function xmlElements(u: Uint8Array): Array<{ name: string; attrs: Record<string, string>; depth: number }> {\n  const out: Array<{ name: string; attrs: Record<string, string>; depth: number }> = [];\n  if (u[0] === 0) {\n    const walk = (n: RmlNode, d: number) => { out.push({ name: n.name, attrs: n.attrs, depth: d }); for (const c of n.children) walk(c, d + 1); };\n    walk(parseRml(u), 0);\n    return out;\n  }\n  const text = new TextDecoder('utf-8').decode(u);\n  let depth = 0;\n  for (const m of text.matchAll(/<(\\/?)([A-Za-z_][\\w.-]*)([^>]*?)(\\/?)>/g)) {\n    if (m[1]) { depth--; continue; }\n    const attrs: Record<string, string> = {};\n    for (const a of m[3]!.matchAll(/([\\w.:-]+)\\s*=\\s*\"([^\"]*)\"/g)) attrs[a[1]!] = a[2]!.replace(/&quot;/g, '\"').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&amp;/g, '&');\n    out.push({ name: m[2]!, attrs, depth });\n    if (!m[4]) depth++;\n  }\n  return out;\n}\n"],"names":[],"mappings":"AAOO,SAAS,SAAS,GAAwB;AAC/C,MAAI,EAAE,SAAS,KAAK,EAAE,CAAC,MAAM,EAAG,OAAM,IAAI,MAAM,uBAAuB;AACvE,QAAM,KAAK,IAAI,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU;AAC5D,MAAI,IAAI;AACR,QAAM,KAAK,MAAM;AACf,QAAI,KAAK,EAAE,OAAQ,OAAM,IAAI,MAAM,sBAAsB;AACzD,UAAM,IAAI,EAAE,GAAG;AACf,QAAI,IAAI,IAAM,QAAO;AACrB,QAAI,MAAM,OAAQ,IAAI,IAAI,EAAE,OAAQ,OAAM,IAAI,MAAM,8BAA8B;AAClF,UAAM,IAAI,GAAG,UAAU,GAAG,IAAI;AAAG,SAAK;AAAG,WAAO;AAAA,EAClD;AACA,QAAM,SAAS,GAAA;AAAM,KAAA;AAAM,KAAA;AAE3B,QAAM,OAAO,CAAC,UAAuB;AACnC,QAAI,QAAQ,IAAK,OAAM,IAAI,MAAM,+BAA+B;AAChE,UAAM,IAAI,GAAA,GAAM,IAAI,MAAM,KAAK,GAAA,GAAM,KAAK,GAAA;AAC1C,UAAM,IAA6B,CAAA;AACnC,aAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AAAE,SAAA;AAAM,QAAE,KAAK,CAAC,GAAA,GAAM,GAAA,CAAI,CAAC;AAAA,IAAG;AAC3D,UAAM,IAAW,CAAA;AACjB,aAAS,IAAI,GAAG,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;AACnD,WAAO,EAAE,GAAG,GAAG,GAAG,EAAA;AAAA,EACpB;AACA,QAAM,MAAM,KAAK,CAAC;AAClB,MAAI,IAAI,SAAS,EAAE,OAAQ,OAAM,IAAI,MAAM,sCAAsC;AACjF,QAAM,KAAK,EAAE,SAAS,GAAG,IAAI,MAAM,GAAG,MAAM,IAAI,YAAY,OAAO,GAAG,4BAAY,IAAA;AAClF,QAAM,IAAI,CAAC,MAAc;AACvB,QAAI,IAAI,MAAM,IAAI,CAAC;AACnB,QAAI,MAAM,QAAW;AAAE,UAAI,IAAI,GAAG,QAAQ,GAAG,CAAC;AAAG,UAAI,IAAI,EAAG,KAAI,GAAG;AAAQ,UAAI,IAAI,OAAO,GAAG,SAAS,GAAG,CAAC,CAAC;AAAG,YAAM,IAAI,GAAG,CAAC;AAAA,IAAG;AAC/H,WAAO;AAAA,EACT;AACA,QAAM,OAAO,CAAC,OAAqB,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,OAAO,YAAY,EAAE,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,EAAE,EAAE,IAAI,IAAI;AACtJ,SAAO,KAAK,GAAG;AACjB;AAEO,MAAM,WAAW,CAAC,GAAwB,SAAsC,GAAG,SAAS,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI;AACvH,MAAM,SAAS,CAAC,GAAwB,SAA4B,GAAG,SAAS,OAAO,CAAC,MAAM,EAAE,SAAS,IAAI,KAAK,CAAA;AAGlH,SAAS,YAAY,GAAsF;AAChH,QAAM,MAA6E,CAAA;AACnF,MAAI,EAAE,CAAC,MAAM,GAAG;AACd,UAAM,OAAO,CAAC,GAAY,MAAc;AAAE,UAAI,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,EAAE,OAAO,OAAO,EAAA,CAAG;AAAG,iBAAW,KAAK,EAAE,SAAU,MAAK,GAAG,IAAI,CAAC;AAAA,IAAG;AAC5I,SAAK,SAAS,CAAC,GAAG,CAAC;AACnB,WAAO;AAAA,EACT;AACA,QAAM,OAAO,IAAI,YAAY,OAAO,EAAE,OAAO,CAAC;AAC9C,MAAI,QAAQ;AACZ,aAAW,KAAK,KAAK,SAAS,yCAAyC,GAAG;AACxE,QAAI,EAAE,CAAC,GAAG;AAAE;AAAS;AAAA,IAAU;AAC/B,UAAM,QAAgC,CAAA;AACtC,eAAW,KAAK,EAAE,CAAC,EAAG,SAAS,6BAA6B,EAAG,OAAM,EAAE,CAAC,CAAE,IAAI,EAAE,CAAC,EAAG,QAAQ,WAAW,GAAG,EAAE,QAAQ,SAAS,GAAG,EAAE,QAAQ,SAAS,GAAG,EAAE,QAAQ,UAAU,GAAG;AAC7K,QAAI,KAAK,EAAE,MAAM,EAAE,CAAC,GAAI,OAAO,OAAO;AACtC,QAAI,CAAC,EAAE,CAAC,EAAG;AAAA,EACb;AACA,SAAO;AACT;"}

package/dist/xbg.d.ts

@@ -0,0 +1,115 @@
+import type { LoadContext } from '@gmvjs/core/plugin';
+import { type SkeletonNode } from '@gmvjs/core/skeleton';
+import type { Archive, Mesh, Model, NodeMotion, VFile } from '@gmvjs/core/types';
+interface Chunk {
+    tag: string;
+    at: number;
+    size: number;
+    data: number;
+    dsize: number;
+    kids: Chunk[];
+}
+export declare function readChunks(u: Uint8Array): Chunk[];
+export interface XbgNode {
+    name: string;
+    parent: number;
+    rot: number[];
+    pos: number[];
+    scale: number[];
+}
+export interface XbgCluster {
+    mat: number;
+    tris: number;
+    palette: number[];
+}
+export interface XbgPrim {
+    buffer: number;
+    part: number;
+    cluster: number;
+    firstIndex: number;
+    lastVertex: number;
+    firstVertex: number;
+}
+/** Вершинный буфер LOD: формат, шаг, число вершин, смещение в общих данных вершин LOD. */
+export interface XbgBuffer {
+    format: number;
+    stride: number;
+    vcount: number;
+    base: number;
+}
+export interface XbgLod {
+    dist: number;
+    buffers: XbgBuffer[];
+    prims: XbgPrim[];
+    vAt: number;
+    iAt: number;
+    icount: number;
+}
+export interface Xbg {
+    materials: string[];
+    nodes: XbgNode[];
+    parts: Array<{
+        name: string;
+        lod: number;
+        node: number;
+    }>;
+    clusters: XbgCluster[][];
+    lods: XbgLod[];
+    pcmp: [number, number];
+    ucmp: [number, number];
+    u: Uint8Array;
+    /** Кости анимации (O2BM): обратные bind-матрицы (column-major) по порядку костей. */
+    o2bm: Float64Array[];
+}
+export declare function parseXbg(u: Uint8Array): Xbg;
+export interface XbmMaterial {
+    name: string;
+    shader: string;
+    textures: Record<string, string>;
+}
+export declare function parseXbm(u: Uint8Array): XbmMaterial;
+/**
+ * «Киты» персонажей (merc_kit, мультиплеерные классы, female_civilian_kit): все сменные части лежат в одной модели.
+ * По умолчанию видна одна часть на слот (голова и глаза к ней, тело её расы, волосы, верх, низ, обувь; «без шапки»,
+ * «без очков», «без снаряжения», если такие есть), «DUMMY…» скрыты. Возвращает имена частей, которые скрыть.
+ */
+export declare function kitHiddenParts(names: readonly string[]): Set<string>;
+/**
+ * Кости анимации -> узлы. Кость i списка O2BM — узел, чья мировая поза совпадает с позой кости с точностью до общего
+ * преобразования T (у животных T = 1; у людей кости O2BM — от таза в начале координат, повернуты на 90° вокруг Z).
+ * T ищется перебором узла для кости 0. В списке нет «…Nub», корня и частей, поэтому номера не совпадают с NODE.
+ * Возвращает узлы (−1 — не найден) и T (кадр анимации -> мир модели).
+ */
+export declare function o2bmNodes(x: Xbg): {
+    nodes: number[];
+    frame: Float64Array;
+};
+/**
+ * Иерархия как в скелете анимаций: вспомогательные кости (колени, локти) в модели висят на тазу, а в .skeleton — на
+ * бедре/плече; без переподвешивания они не следуют за конечностью. Bind-поза сохраняется. parentOf — имя родителя по имени кости.
+ */
+export declare function reparentNodes(sn: SkeletonNode[], parentOf: ReadonlyMap<string, string>): SkeletonNode[];
+/**
+ * Узлы скелета: позы узлов — в пространстве родителя. frame — кадр вершин скиновых мешей: у людей вершины записаны
+ * в кадре костей O2BM (таз в начале координат), а узлы — в кадре модели; offset = (мировая bind-поза узла)⁻¹ · frame.
+ */
+export declare function xbgSkeletonNodes(nodes: XbgNode[], frame?: ArrayLike<number>): SkeletonNode[];
+/**
+ * Скелет анимаций модели: «<имя модели>_ref.skeleton» рядом, затем вверх по папкам — «hips_ref.skeleton»,
+ * «pelvis_ref.skeleton», «_common\\pelvis_ref.skeleton»; для людей вне graphics\\characters (actors) — общий скелет людей.
+ */
+export declare function skeletonCandidates(modelPath: string, human?: boolean): string[];
+/** Меши ближнего LOD модели .xbg (с материалами .xbm из архива); matCache — общий кэш материалов (для уровней). */
+export declare function xbgMeshes(u: Uint8Array, arc: Archive | null, matCache?: Map<string, Promise<XbmMaterial | null>>, lodIndex?: number, parsed?: Xbg): Promise<{
+    x: Xbg;
+    lod: XbgLod;
+    meshes: Mesh[];
+    skinned: boolean;
+    missing: string[];
+}>;
+/** Скиновые меши в bind-позе как статика (для уровней): вершины через матрицы скина узлов модели. */
+export declare function bakeBindPose(x: Xbg, meshes: Mesh[]): Mesh[];
+export declare function loadXbg(main: VFile, ctx: LoadContext): Promise<Model>;
+/** Анимации для модели (данные — при выборе): все .mab в папке скелета и глубже. */
+export declare function listMabMotions(model: Model, archive: Archive): NodeMotion[];
+export {};