@gmvjs/core 0.1.0 → 0.1.1

package/dist/scene.d.ts

@@ -2,24 +2,24 @@ import type { Model } from './types';
 export interface SceneNode {
     id: string;
     name: string;
-    /** group — папка; mesh — меш модели; instance — экземпляр объекта сцены. */
+    /** group: a folder; mesh: a model mesh; instance: a scene object instance. */
     kind: 'group' | 'mesh' | 'instance';
     mesh?: number;
     instance?: number;
-    /** Подпись справа (число треугольников, модель экземпляра). */
+    /** Right-hand label (triangle count, instance model). */
     note?: string;
     children?: SceneNode[];
 }
 /**
- * Дерево слоёв: для сцены с экземплярами — «Геометрия» (меши без экземпляров) и «Объекты» по группам (классам);
- * для обычной модели — меши.
+ * Layer tree: for a scene with instances, "Geometry" (meshes without instances) and "Objects" by group (class);
+ * for a regular model, the meshes.
  */
 export declare function sceneTree(model: Model): SceneNode[];
-/** Все узлы-листья под узлом (меши и экземпляры). */
+/** All leaf nodes under a node (meshes and instances). */
 export declare function sceneLeaves(n: SceneNode): SceneNode[];
 /**
- * Переписать вершины и индексы экземпляра в слитых мешах по его позе (после поворота).
- * Возвращает изменённые диапазоны вершин — их нужно перезалить в рендерер.
+ * Rewrite an instance's vertices and indices in the merged meshes from its pose (after rotation).
+ * Returns the changed vertex ranges; they must be re-uploaded to the renderer.
  */
 export declare function applyPlacement(model: Model, index: number): Array<{
     mesh: number;
@@ -28,22 +28,22 @@ export declare function applyPlacement(model: Model, index: number): Array<{
     iStart: number;
     iCount: number;
 }>;
-/** Повернуть экземпляр вокруг вертикали модели (ось Y) через его начало координат: R' = R·Ry(угол). */
+/** Rotate an instance about the model's vertical axis (Y) through its origin: R' = R·Ry(angle). */
 export declare function rotatePlacement(model: Model, index: number, angle: number): ReturnType<typeof applyPlacement>;
-/** Сдвинуть экземпляр на (dx, dy, dz) в координатах модели. */
+/** Move an instance by (dx, dy, dz) in model coordinates. */
 export declare function translatePlacement(model: Model, index: number, d: ArrayLike<number>): ReturnType<typeof applyPlacement>;
-/** Индексы меша без скрытых экземпляров (для экспорта и выбора). */
+/** Mesh indices without hidden instances (for export and picking). */
 export declare function visibleIndices(model: Model, mesh: number): Uint32Array;
-/** Экземпляр, которому принадлежит треугольник (по первому индексу треугольника), или −1. */
+/** Instance a triangle belongs to (by the triangle's first index), or −1. */
 export declare function instanceAt(model: Model, mesh: number, index: number): number;
 export interface RayHit {
-    mesh: number; /** Номер первого индекса треугольника. */
+    mesh: number; /** Index of the triangle's first index. */
     index: number;
     t: number;
 }
 /**
- * Ближайший треугольник на луче (в координатах модели, без скелетной позы).
- * skip — меши, которые не участвуют (скрытые); clipY — срез сверху (по высоте в координатах модели, если задано).
+ * Nearest triangle along a ray (in model coordinates, without the skeletal pose).
+ * skip: meshes that do not take part (hidden); clipY: a cut from above (by height in model coordinates, if set).
  */
 export declare function pickRay(model: Model, origin: ArrayLike<number>, dir: ArrayLike<number>, opts?: {
     skip?: (mesh: number) => boolean;

package/dist/scene.js.map

@@ -1 +1 @@
-{"version":3,"file":"scene.js","sources":["../src/scene.ts"],"sourcesContent":["// Сцена модели для интерфейса: дерево слоёв, видимость и поворот экземпляров, выбор треугольника лучом.\nimport { tr } from './i18n';\nimport type { InstancePlacement, Model } from './types';\n\nexport interface SceneNode {\n  id: string;\n  name: string;\n  /** group — папка; mesh — меш модели; instance — экземпляр объекта сцены. */\n  kind: 'group' | 'mesh' | 'instance';\n  mesh?: number;\n  instance?: number;\n  /** Подпись справа (число треугольников, модель экземпляра). */\n  note?: string;\n  children?: SceneNode[];\n}\n\nconst tris = (model: Model, i: number) => Math.floor(model.meshes[i]!.indices.length / 3);\n\n/**\n * Дерево слоёв: для сцены с экземплярами — «Геометрия» (меши без экземпляров) и «Объекты» по группам (классам);\n * для обычной модели — меши.\n */\nexport function sceneTree(model: Model): SceneNode[] {\n  const inst = model.instances, instMeshes = new Set(inst?.meshes ?? []);\n  const meshNode = (i: number): SceneNode => ({ id: `m${i}`, name: model.meshes[i]!.name || tr('scene.mesh', { i }), kind: 'mesh', mesh: i, note: tr('scene.tris', { n: tris(model, i) }) });\n  const plain = model.meshes.map((_, i) => i).filter((i) => !instMeshes.has(i));\n  if (!inst?.placements.length) return [{ id: 'model', name: tr('scene.model'), kind: 'group', note: tr('scene.meshes', { n: plain.length }), children: plain.map(meshNode) }];\n  const groups = new Map<string, number[]>();\n  inst.placements.forEach((p, i) => { const g = p.group || tr('scene.otherObjects'); (groups.get(g) ?? groups.set(g, []).get(g)!).push(i); });\n  const protoTris = (p: InstancePlacement) => inst.protos[p.proto]!.parts.reduce((a, x) => a + Math.floor(x.indices.length / 3), 0);\n  return [\n    { id: 'geom', name: tr('scene.geometry'), kind: 'group', note: tr('scene.meshes', { n: plain.length }), children: plain.map(meshNode) },\n    {\n      id: 'objects', name: tr('scene.objects'), kind: 'group', note: String(inst.placements.length),\n      children: [...groups].sort((a, b) => b[1].length - a[1].length).map(([g, list]) => ({\n        id: `g:${g}`, name: g, kind: 'group' as const, note: String(list.length),\n        children: list.map((i) => {\n          const p = inst.placements[i]!, proto = inst.protos[p.proto]!;\n          return { id: `i${i}`, name: p.name, kind: 'instance' as const, instance: i, note: `${proto.name.split('/').pop()} · ${tr('scene.tris', { n: protoTris(p) })}` };\n        }),\n      })),\n    },\n  ];\n}\n\n/** Все узлы-листья под узлом (меши и экземпляры). */\nexport function sceneLeaves(n: SceneNode): SceneNode[] {\n  return n.kind === 'group' ? (n.children ?? []).flatMap(sceneLeaves) : [n];\n}\n\n/**\n * Переписать вершины и индексы экземпляра в слитых мешах по его позе (после поворота).\n * Возвращает изменённые диапазоны вершин — их нужно перезалить в рендерер.\n */\nexport function applyPlacement(model: Model, index: number): Array<{ mesh: number; vStart: number; vCount: number; iStart: number; iCount: number }> {\n  const inst = model.instances, p = inst?.placements[index];\n  if (!inst || !p?.ranges) return [];\n  const M = p.pose, proto = inst.protos[p.proto]!;\n  const det = M[0]! * (M[5]! * M[10]! - M[6]! * M[9]!) - M[1]! * (M[4]! * M[10]! - M[6]! * M[8]!) + M[2]! * (M[4]! * M[9]! - M[5]! * M[8]!);\n  for (const r of p.ranges) {\n    const part = proto.parts[r.part], m = model.meshes[r.mesh];\n    if (!part || !m) continue;\n    for (let v = 0; v < r.vCount; v++) {\n      const x = part.pos[v * 3]!, y = part.pos[v * 3 + 1]!, z = part.pos[v * 3 + 2]!, o = (r.vStart + v) * 3;\n      m.pos[o] = x * M[0]! + y * M[4]! + z * M[8]! + M[12]!;\n      m.pos[o + 1] = x * M[1]! + y * M[5]! + z * M[9]! + M[13]!;\n      m.pos[o + 2] = x * M[2]! + y * M[6]! + z * M[10]! + M[14]!;\n      const a = part.nor[v * 3]!, b = part.nor[v * 3 + 1]!, c = part.nor[v * 3 + 2]!;\n      const nx = a * M[0]! + b * M[4]! + c * M[8]!, ny = a * M[1]! + b * M[5]! + c * M[9]!, nz = a * M[2]! + b * M[6]! + c * M[10]!, l = Math.hypot(nx, ny, nz) || 1;\n      m.nor[o] = nx / l; m.nor[o + 1] = ny / l; m.nor[o + 2] = nz / l;\n    }\n    for (let t = 0; t + 2 < r.iCount; t += 3) {\n      const a = part.indices[t]!, b = part.indices[t + 1]!, c = part.indices[t + 2]!, o = r.iStart + t;\n      m.indices[o] = r.vStart + a;\n      m.indices[o + 1] = r.vStart + (det < 0 ? c : b);\n      m.indices[o + 2] = r.vStart + (det < 0 ? b : c);\n    }\n  }\n  return p.ranges.map((r) => ({ mesh: r.mesh, vStart: r.vStart, vCount: r.vCount, iStart: r.iStart, iCount: r.iCount }));\n}\n\n/** Повернуть экземпляр вокруг вертикали модели (ось Y) через его начало координат: R' = R·Ry(угол). */\nexport function rotatePlacement(model: Model, index: number, angle: number): ReturnType<typeof applyPlacement> {\n  const p = model.instances?.placements[index];\n  if (!p) return [];\n  const c = Math.cos(angle), s = Math.sin(angle), M = p.pose;\n  for (let row = 0; row < 3; row++) {\n    const x = M[row * 4]!, z = M[row * 4 + 2]!;\n    // строка × Ry: x' = x·c − z·s, z' = x·s + z·c\n    M[row * 4] = x * c - z * s;\n    M[row * 4 + 2] = x * s + z * c;\n  }\n  return applyPlacement(model, index);\n}\n\n/** Сдвинуть экземпляр на (dx, dy, dz) в координатах модели. */\nexport function translatePlacement(model: Model, index: number, d: ArrayLike<number>): ReturnType<typeof applyPlacement> {\n  const p = model.instances?.placements[index];\n  if (!p) return [];\n  p.pose[12] = p.pose[12]! + d[0]!; p.pose[13] = p.pose[13]! + d[1]!; p.pose[14] = p.pose[14]! + d[2]!;\n  return applyPlacement(model, index);\n}\n\n/** Индексы меша без скрытых экземпляров (для экспорта и выбора). */\nexport function visibleIndices(model: Model, mesh: number): Uint32Array {\n  const src = model.meshes[mesh]!.indices, hidden = model.instances?.placements.filter((p) => p.hidden && p.ranges?.some((r) => r.mesh === mesh));\n  if (!hidden?.length) return Uint32Array.from(src);\n  const mask = new Uint8Array(src.length);\n  for (const p of hidden) for (const r of p.ranges!) if (r.mesh === mesh) mask.fill(1, r.iStart, r.iStart + r.iCount);\n  const out: number[] = [];\n  for (let i = 0; i + 2 < src.length; i += 3) if (!mask[i]) out.push(src[i]!, src[i + 1]!, src[i + 2]!);\n  return Uint32Array.from(out);\n}\n\n/** Экземпляр, которому принадлежит треугольник (по первому индексу треугольника), или −1. */\nexport function instanceAt(model: Model, mesh: number, index: number): number {\n  const pl = model.instances?.placements;\n  if (!pl) return -1;\n  for (let i = 0; i < pl.length; i++) for (const r of pl[i]!.ranges ?? []) if (r.mesh === mesh && index >= r.iStart && index < r.iStart + r.iCount) return i;\n  return -1;\n}\n\nexport interface RayHit { mesh: number; /** Номер первого индекса треугольника. */ index: number; t: number }\n\n/**\n * Ближайший треугольник на луче (в координатах модели, без скелетной позы).\n * skip — меши, которые не участвуют (скрытые); clipY — срез сверху (по высоте в координатах модели, если задано).\n */\nexport function pickRay(model: Model, origin: ArrayLike<number>, dir: ArrayLike<number>, opts: { skip?: (mesh: number) => boolean; indices?: (mesh: number) => ArrayLike<number>; clip?: (x: number, y: number, z: number) => boolean } = {}): RayHit | null {\n  const [ox, oy, oz] = [origin[0]!, origin[1]!, origin[2]!], [dx, dy, dz] = [dir[0]!, dir[1]!, dir[2]!];\n  let best: RayHit | null = null, bestT = Infinity;\n  model.meshes.forEach((m, mi) => {\n    if (opts.skip?.(mi)) return;\n    const P = m.pos, I = opts.indices?.(mi) ?? m.indices;\n    for (let t = 0; t + 2 < I.length; t += 3) {\n      const a = I[t]! * 3, b = I[t + 1]! * 3, c = I[t + 2]! * 3;\n      if (a === b && b === c) continue; // скрытый (вырожденный) треугольник\n      const ax = P[a]!, ay = P[a + 1]!, az = P[a + 2]!;\n      const e1x = P[b]! - ax, e1y = P[b + 1]! - ay, e1z = P[b + 2]! - az, e2x = P[c]! - ax, e2y = P[c + 1]! - ay, e2z = P[c + 2]! - az;\n      const px = dy * e2z - dz * e2y, py = dz * e2x - dx * e2z, pz = dx * e2y - dy * e2x, det = e1x * px + e1y * py + e1z * pz;\n      if (Math.abs(det) < 1e-12) continue;\n      const inv = 1 / det, tx = ox - ax, ty = oy - ay, tz = oz - az, u = (tx * px + ty * py + tz * pz) * inv;\n      if (u < 0 || u > 1) continue;\n      const qx = ty * e1z - tz * e1y, qy = tz * e1x - tx * e1z, qz = tx * e1y - ty * e1x, v = (dx * qx + dy * qy + dz * qz) * inv;\n      if (v < 0 || u + v > 1) continue;\n      const d = (e2x * qx + e2y * qy + e2z * qz) * inv;\n      if (d <= 0 || d >= bestT) continue;\n      if (opts.clip && opts.clip(ox + dx * d, oy + dy * d, oz + dz * d)) continue;\n      bestT = d; best = { mesh: mi, index: t, t: d };\n    }\n  });\n  return best;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"scene.js","sources":["../src/scene.ts"],"sourcesContent":["// Model scene for the UI: layer tree, instance visibility and rotation, ray picking of triangles.\nimport { tr } from './i18n';\nimport type { InstancePlacement, Model } from './types';\n\nexport interface SceneNode {\n  id: string;\n  name: string;\n  /** group: a folder; mesh: a model mesh; instance: a scene object instance. */\n  kind: 'group' | 'mesh' | 'instance';\n  mesh?: number;\n  instance?: number;\n  /** Right-hand label (triangle count, instance model). */\n  note?: string;\n  children?: SceneNode[];\n}\n\nconst tris = (model: Model, i: number) => Math.floor(model.meshes[i]!.indices.length / 3);\n\n/**\n * Layer tree: for a scene with instances, \"Geometry\" (meshes without instances) and \"Objects\" by group (class);\n * for a regular model, the meshes.\n */\nexport function sceneTree(model: Model): SceneNode[] {\n  const inst = model.instances, instMeshes = new Set(inst?.meshes ?? []);\n  const meshNode = (i: number): SceneNode => ({ id: `m${i}`, name: model.meshes[i]!.name || tr('scene.mesh', { i }), kind: 'mesh', mesh: i, note: tr('scene.tris', { n: tris(model, i) }) });\n  const plain = model.meshes.map((_, i) => i).filter((i) => !instMeshes.has(i));\n  if (!inst?.placements.length) return [{ id: 'model', name: tr('scene.model'), kind: 'group', note: tr('scene.meshes', { n: plain.length }), children: plain.map(meshNode) }];\n  const groups = new Map<string, number[]>();\n  inst.placements.forEach((p, i) => { const g = p.group || tr('scene.otherObjects'); (groups.get(g) ?? groups.set(g, []).get(g)!).push(i); });\n  const protoTris = (p: InstancePlacement) => inst.protos[p.proto]!.parts.reduce((a, x) => a + Math.floor(x.indices.length / 3), 0);\n  return [\n    { id: 'geom', name: tr('scene.geometry'), kind: 'group', note: tr('scene.meshes', { n: plain.length }), children: plain.map(meshNode) },\n    {\n      id: 'objects', name: tr('scene.objects'), kind: 'group', note: String(inst.placements.length),\n      children: [...groups].sort((a, b) => b[1].length - a[1].length).map(([g, list]) => ({\n        id: `g:${g}`, name: g, kind: 'group' as const, note: String(list.length),\n        children: list.map((i) => {\n          const p = inst.placements[i]!, proto = inst.protos[p.proto]!;\n          return { id: `i${i}`, name: p.name, kind: 'instance' as const, instance: i, note: `${proto.name.split('/').pop()} · ${tr('scene.tris', { n: protoTris(p) })}` };\n        }),\n      })),\n    },\n  ];\n}\n\n/** All leaf nodes under a node (meshes and instances). */\nexport function sceneLeaves(n: SceneNode): SceneNode[] {\n  return n.kind === 'group' ? (n.children ?? []).flatMap(sceneLeaves) : [n];\n}\n\n/**\n * Rewrite an instance's vertices and indices in the merged meshes from its pose (after rotation).\n * Returns the changed vertex ranges; they must be re-uploaded to the renderer.\n */\nexport function applyPlacement(model: Model, index: number): Array<{ mesh: number; vStart: number; vCount: number; iStart: number; iCount: number }> {\n  const inst = model.instances, p = inst?.placements[index];\n  if (!inst || !p?.ranges) return [];\n  const M = p.pose, proto = inst.protos[p.proto]!;\n  const det = M[0]! * (M[5]! * M[10]! - M[6]! * M[9]!) - M[1]! * (M[4]! * M[10]! - M[6]! * M[8]!) + M[2]! * (M[4]! * M[9]! - M[5]! * M[8]!);\n  for (const r of p.ranges) {\n    const part = proto.parts[r.part], m = model.meshes[r.mesh];\n    if (!part || !m) continue;\n    for (let v = 0; v < r.vCount; v++) {\n      const x = part.pos[v * 3]!, y = part.pos[v * 3 + 1]!, z = part.pos[v * 3 + 2]!, o = (r.vStart + v) * 3;\n      m.pos[o] = x * M[0]! + y * M[4]! + z * M[8]! + M[12]!;\n      m.pos[o + 1] = x * M[1]! + y * M[5]! + z * M[9]! + M[13]!;\n      m.pos[o + 2] = x * M[2]! + y * M[6]! + z * M[10]! + M[14]!;\n      const a = part.nor[v * 3]!, b = part.nor[v * 3 + 1]!, c = part.nor[v * 3 + 2]!;\n      const nx = a * M[0]! + b * M[4]! + c * M[8]!, ny = a * M[1]! + b * M[5]! + c * M[9]!, nz = a * M[2]! + b * M[6]! + c * M[10]!, l = Math.hypot(nx, ny, nz) || 1;\n      m.nor[o] = nx / l; m.nor[o + 1] = ny / l; m.nor[o + 2] = nz / l;\n    }\n    for (let t = 0; t + 2 < r.iCount; t += 3) {\n      const a = part.indices[t]!, b = part.indices[t + 1]!, c = part.indices[t + 2]!, o = r.iStart + t;\n      m.indices[o] = r.vStart + a;\n      m.indices[o + 1] = r.vStart + (det < 0 ? c : b);\n      m.indices[o + 2] = r.vStart + (det < 0 ? b : c);\n    }\n  }\n  return p.ranges.map((r) => ({ mesh: r.mesh, vStart: r.vStart, vCount: r.vCount, iStart: r.iStart, iCount: r.iCount }));\n}\n\n/** Rotate an instance about the model's vertical axis (Y) through its origin: R' = R·Ry(angle). */\nexport function rotatePlacement(model: Model, index: number, angle: number): ReturnType<typeof applyPlacement> {\n  const p = model.instances?.placements[index];\n  if (!p) return [];\n  const c = Math.cos(angle), s = Math.sin(angle), M = p.pose;\n  for (let row = 0; row < 3; row++) {\n    const x = M[row * 4]!, z = M[row * 4 + 2]!;\n    // row × Ry: x' = x·c − z·s, z' = x·s + z·c\n    M[row * 4] = x * c - z * s;\n    M[row * 4 + 2] = x * s + z * c;\n  }\n  return applyPlacement(model, index);\n}\n\n/** Move an instance by (dx, dy, dz) in model coordinates. */\nexport function translatePlacement(model: Model, index: number, d: ArrayLike<number>): ReturnType<typeof applyPlacement> {\n  const p = model.instances?.placements[index];\n  if (!p) return [];\n  p.pose[12] = p.pose[12]! + d[0]!; p.pose[13] = p.pose[13]! + d[1]!; p.pose[14] = p.pose[14]! + d[2]!;\n  return applyPlacement(model, index);\n}\n\n/** Mesh indices without hidden instances (for export and picking). */\nexport function visibleIndices(model: Model, mesh: number): Uint32Array {\n  const src = model.meshes[mesh]!.indices, hidden = model.instances?.placements.filter((p) => p.hidden && p.ranges?.some((r) => r.mesh === mesh));\n  if (!hidden?.length) return Uint32Array.from(src);\n  const mask = new Uint8Array(src.length);\n  for (const p of hidden) for (const r of p.ranges!) if (r.mesh === mesh) mask.fill(1, r.iStart, r.iStart + r.iCount);\n  const out: number[] = [];\n  for (let i = 0; i + 2 < src.length; i += 3) if (!mask[i]) out.push(src[i]!, src[i + 1]!, src[i + 2]!);\n  return Uint32Array.from(out);\n}\n\n/** Instance a triangle belongs to (by the triangle's first index), or −1. */\nexport function instanceAt(model: Model, mesh: number, index: number): number {\n  const pl = model.instances?.placements;\n  if (!pl) return -1;\n  for (let i = 0; i < pl.length; i++) for (const r of pl[i]!.ranges ?? []) if (r.mesh === mesh && index >= r.iStart && index < r.iStart + r.iCount) return i;\n  return -1;\n}\n\nexport interface RayHit { mesh: number; /** Index of the triangle's first index. */ index: number; t: number }\n\n/**\n * Nearest triangle along a ray (in model coordinates, without the skeletal pose).\n * skip: meshes that do not take part (hidden); clipY: a cut from above (by height in model coordinates, if set).\n */\nexport function pickRay(model: Model, origin: ArrayLike<number>, dir: ArrayLike<number>, opts: { skip?: (mesh: number) => boolean; indices?: (mesh: number) => ArrayLike<number>; clip?: (x: number, y: number, z: number) => boolean } = {}): RayHit | null {\n  const [ox, oy, oz] = [origin[0]!, origin[1]!, origin[2]!], [dx, dy, dz] = [dir[0]!, dir[1]!, dir[2]!];\n  let best: RayHit | null = null, bestT = Infinity;\n  model.meshes.forEach((m, mi) => {\n    if (opts.skip?.(mi)) return;\n    const P = m.pos, I = opts.indices?.(mi) ?? m.indices;\n    for (let t = 0; t + 2 < I.length; t += 3) {\n      const a = I[t]! * 3, b = I[t + 1]! * 3, c = I[t + 2]! * 3;\n      if (a === b && b === c) continue; // hidden (degenerate) triangle\n      const ax = P[a]!, ay = P[a + 1]!, az = P[a + 2]!;\n      const e1x = P[b]! - ax, e1y = P[b + 1]! - ay, e1z = P[b + 2]! - az, e2x = P[c]! - ax, e2y = P[c + 1]! - ay, e2z = P[c + 2]! - az;\n      const px = dy * e2z - dz * e2y, py = dz * e2x - dx * e2z, pz = dx * e2y - dy * e2x, det = e1x * px + e1y * py + e1z * pz;\n      if (Math.abs(det) < 1e-12) continue;\n      const inv = 1 / det, tx = ox - ax, ty = oy - ay, tz = oz - az, u = (tx * px + ty * py + tz * pz) * inv;\n      if (u < 0 || u > 1) continue;\n      const qx = ty * e1z - tz * e1y, qy = tz * e1x - tx * e1z, qz = tx * e1y - ty * e1x, v = (dx * qx + dy * qy + dz * qz) * inv;\n      if (v < 0 || u + v > 1) continue;\n      const d = (e2x * qx + e2y * qy + e2z * qz) * inv;\n      if (d <= 0 || d >= bestT) continue;\n      if (opts.clip && opts.clip(ox + dx * d, oy + dy * d, oz + dz * d)) continue;\n      bestT = d; best = { mesh: mi, index: t, t: d };\n    }\n  });\n  return best;\n}\n"],"names":[],"mappings":"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"}

package/dist/session.d.ts

@@ -9,7 +9,7 @@ export interface SessionEvents {
         error: boolean;
     };
     preset: GamePreset;
-    /** keepView — та же модель с другими Model.options: камеру не сбрасывать. */
+    /** keepView: the same model with other Model.options, do not reset the camera. */
     model: {
         model: Model;
         main: VFile;
@@ -18,9 +18,9 @@ export interface SessionEvents {
     };
     motions: Motion[];
     archives: Archive[];
-    /** Набор доступных текстур изменился — стоит заново применить текстуры. */
+    /** The set of available textures changed: textures should be applied again. */
     textures: void;
-    /** Долгая операция: текст и, если известно, сколько сделано из скольких; null — закончена. */
+    /** Long operation: text and, if known, how much of how much is done; null means finished. */
     progress: {
         text: string;
         done?: number;
@@ -31,15 +31,15 @@ type Listener<T> = (payload: T) => void;
 export interface TextureResult {
     meshIndex: number;
     image: DecodedImage | null;
-    /** Подпись для списка мешей: «512×512», «нет файла», «ошибка: …». */
+    /** Label for the mesh list: "512×512", "no file", "error: …". */
     label: string;
     ok: boolean;
-    /** Путь найденного файла (для поиска карты нормалей рядом). */
+    /** Path of the found file (to look for a normal map next to it). */
     source?: string;
 }
 export interface SurfaceResult {
     meshIndex: number;
-    /** Сведённая карта: R — AO, G — шероховатость, B — металличность, A — блик. */
+    /** Combined map: R = AO, G = roughness, B = metalness, A = specular. */
     image: DecodedImage | null;
     label: string;
     ok: boolean;
@@ -58,7 +58,7 @@ export interface ArchiveItem {
 export declare class ViewerSession {
     readonly registry: Registry;
     readonly archives: Archive[];
-    /** Файлы-спутники архивов, выбранные раньше (XR_3DA.exe — ключ архивов ТЧ, .dir к IMG): передаются архивам при открытии. */
+    /** Archive companion files selected earlier (XR_3DA.exe = SoC archive key, .dir for IMG): passed to archives when they are opened. */
     readonly companions: BlobFile[];
     readonly textures: TextureLibrary;
     preset: GamePreset;
@@ -66,14 +66,14 @@ export declare class ViewerSession {
     format: FormatPlugin | null;
     main: VFile | null;
     readonly motions: Motion[];
-    /** Последняя неудачная загрузка (для кнопки «Скопировать диагностику»). */
+    /** Last failed load (for the "Copy diagnostics" button). */
     lastFailure: {
         file: VFile;
         format: string;
         error: string;
     } | null;
     private readonly overrides;
-    /** Карты движка (resolveMaps) по имени текстуры меша. */
+    /** Engine maps (resolveMaps) by mesh texture name. */
     private readonly mapsCache;
     private engineMaps;
     private readonly listeners;
@@ -81,73 +81,73 @@ export declare class ViewerSession {
     on<K extends keyof SessionEvents>(type: K, fn: Listener<SessionEvents[K]>): () => void;
     private emit;
     private status;
-    /** Сообщить о ходе долгой операции (для полосы прогресса); без аргументов — операция закончена. */
+    /** Report progress of a long operation (for the progress bar); without arguments the operation is finished. */
     private progress;
-    /** Дать браузеру перерисовать полосу прогресса перед тяжёлым синхронным шагом. */
+    /** Let the browser repaint the progress bar before a heavy synchronous step. */
     private yieldUI;
     setPreset(id: string): GamePreset;
     get modelExtensions(): string[];
     get motionExtensions(): string[];
-    /** Разложить набор файлов: архивы, словари текстур, картинки, анимации, модель. */
+    /** Sort a set of files into archives, texture dictionaries, images, animations and the model. */
     addFiles(input: Iterable<BlobFile>): Promise<void>;
     /**
-     * Открыть архивы. Файл, который не читается (не архив — например, зашифрованные a3.Arch01 F.E.A.R. Online, — повреждён),
-     * пропускается — остальные открываются;
-     * в строке состояния — сколько открыто и что пропущено.
+     * Open archives. A file that cannot be read (not an archive, for example the encrypted F.E.A.R. Online a3.Arch01, or damaged)
+     * is skipped and the rest are opened;
+     * the status line tells how many were opened and what was skipped.
      */
     addArchives(files: readonly BlobFile[]): Promise<void>;
-    /** «Папка игры» с полосой прогресса: индекс строится кусками, интерфейс не замирает (сотни тысяч файлов). */
+    /** "Game folder" with a progress bar: the index is built in chunks so the UI does not freeze (hundreds of thousands of files). */
     addFolderAsync(files: readonly BlobFile[]): Promise<Archive>;
-    /** «Папка игры»: индексирует файлы без чтения. */
+    /** "Game folder": indexes files without reading them. */
     addFolder(files: readonly BlobFile[]): Archive;
     /**
-     * Архивы внутри «Папки игры», которые движок просит открывать сразу (ArchivePlugin.openFromFolder): F.E.A.R. Online — *.arch01.
-     * Возвращает число открытых архивов.
+     * Archives inside the "Game folder" that the engine asks to open right away (ArchivePlugin.openFromFolder): F.E.A.R. Online *.arch01.
+     * Returns the number of opened archives.
      */
     openFolderArchives(folder: Archive): Promise<number>;
     private archivesChanged;
     addTextures(files: readonly BlobFile[]): void;
     addTextureDictionary(file: VFile | BlobFile): Promise<void>;
-    /** Выбрать основной файл (автоопределение) и загрузить модель. */
-    /** Файлы и выборы последней загрузки — для setModelOption. */
+    /** Pick the main file (format detection) and load the model. */
+    /** Files and choices of the last load, for setModelOption. */
     private lastLoad;
-    /** Сменить выбор модели (Model.options) и пересобрать её из тех же файлов. */
+    /** Change a model choice (Model.options) and rebuild it from the same files. */
     setModelOption(id: string, value: string): Promise<Model | null>;
     loadModel(files: ReadonlyArray<VFile | BlobFile>, options?: Record<string, string>, keepView?: boolean): Promise<Model | null>;
     private loadContext;
     private afterLoadContext;
-    /** Добавить внешние анимации к загруженной модели. */
+    /** Add external animations to the loaded model. */
     loadMotions(file: VFile | BlobFile): Promise<Motion[]>;
     setTextureOverride(meshIndex: number, file: VFile | BlobFile): void;
-    /** Найти и декодировать текстуру меша. */
-    /** Файл текстуры меша (тот же поиск, что у resolveTexture): для выгрузки исходных байтов, например DDS. */
+    /** Find and decode a mesh texture. */
+    /** Mesh texture file (the same lookup as resolveTexture): for exporting the source bytes, for example DDS. */
     textureSource(i: number): Promise<TextureSource | null>;
     private findTextureSource;
     resolveTexture(i: number): Promise<TextureResult>;
     /**
-     * Карта нормалей меша: встроенная → указанная моделью/материалом → по имени диффузной (_co→_nohq, __d→__n_d, _diff→_normal, _d→_n…).
-     * Найденная картинка проверяется на «похожесть» на нормали и упаковку (RGB, RG/BC5, AG/DXT5nm).
+     * Mesh normal map: embedded → named by the model/material → derived from the diffuse name (_co→_nohq, __d→__n_d, _diff→_normal, _d→_n…).
+     * A found image is checked for looking like a normal map and for its packing (RGB, RG/BC5, AG/DXT5nm).
      */
     resolveNormal(i: number, diffuse?: string): Promise<NormalResult>;
     /**
-     * PBR-поверхность меша: из материала (mesh.surface) или упакованные карты по имени диффузной (_orm, _rma, _smdi…).
-     * Карты сводятся в одну текстуру (composeSurface); нет карт, но есть множители — текстура 1×1.
+     * Mesh PBR surface: from the material (mesh.surface) or packed maps derived from the diffuse name (_orm, _rma, _smdi…).
+     * Maps are combined into one texture (composeSurface); with no maps but with multipliers, a 1×1 texture.
      */
     resolveSurface(i: number, diffuse?: string): Promise<SurfaceResult>;
     /**
-     * Последняя попытка: картинка в папке модели. Имя совпадает с материалом, или «skin.*» (Quake II rerelease: md5/skin.png),
-     * или это единственная картинка в папке (без карт *_glow/_n/_s/_normal/_spec).
+     * Last resort: an image in the model folder. Its name matches the material, or "skin.*" (Quake II rerelease: md5/skin.png),
+     * or it is the only image in the folder (excluding *_glow/_n/_s/_normal/_spec maps).
      */
     private sameFolderTexture;
-    /** Модели и анимации текущего пресета во всех архивах. */
+    /** Models and animations of the current preset in all archives. */
     archiveModels(filter?: string, limit?: number): {
         items: ArchiveItem[];
         total: number;
     };
-    /** Открыть запись архива: анимацию — добавить, модель — загрузить. */
+    /** Open an archive entry: add an animation, load a model. */
     openEntry(item: ArchiveItem): Promise<void>;
 }
 export declare const errMsg: (e: unknown) => string;
-/** Анимации из той же папки архива, что и модель (Doom 3: *.md5anim рядом с *.md5mesh). */
+/** Animations from the same archive folder as the model (Doom 3: *.md5anim next to *.md5mesh). */
 export declare function loadSameDirMotions(ctx: AfterLoadContext, ext: string): Promise<number>;
 export {};

package/dist/session.js

@@ -15,7 +15,7 @@ class ViewerSession {
   }
   registry;
   archives = [];
-  /** Файлы-спутники архивов, выбранные раньше (XR_3DA.exe — ключ архивов ТЧ, .dir к IMG): передаются архивам при открытии. */
+  /** Archive companion files selected earlier (XR_3DA.exe = SoC archive key, .dir for IMG): passed to archives when they are opened. */
   companions = [];
   textures;
   preset;
@@ -23,10 +23,10 @@ class ViewerSession {
   format = null;
   main = null;
   motions = [];
-  /** Последняя неудачная загрузка (для кнопки «Скопировать диагностику»). */
+  /** Last failed load (for the "Copy diagnostics" button). */
   lastFailure = null;
   overrides = /* @__PURE__ */ new Map();
-  /** Карты движка (resolveMaps) по имени текстуры меша. */
+  /** Engine maps (resolveMaps) by mesh texture name. */
   mapsCache = /* @__PURE__ */ new Map();
   engineMaps(mesh) {
     const fmt = this.format, model = this.model;
@@ -43,7 +43,7 @@ class ViewerSession {
     return p;
   }
   listeners = /* @__PURE__ */ new Map();
-  // ---------- события ----------
+  // ---------- events ----------
   on(type, fn) {
     let set = this.listeners.get(type);
     if (!set) this.listeners.set(type, set = /* @__PURE__ */ new Set());
@@ -56,15 +56,15 @@ class ViewerSession {
   status(text, error = false) {
     this.emit("status", { text, error });
   }
-  /** Сообщить о ходе долгой операции (для полосы прогресса); без аргументов — операция закончена. */
+  /** Report progress of a long operation (for the progress bar); without arguments the operation is finished. */
   progress(text, done, total) {
     this.emit("progress", text === void 0 ? null : { text, done, total });
   }
-  /** Дать браузеру перерисовать полосу прогресса перед тяжёлым синхронным шагом. */
+  /** Let the browser repaint the progress bar before a heavy synchronous step. */
   yieldUI() {
     return new Promise((r) => setTimeout(r, 0));
   }
-  // ---------- пресет ----------
+  // ---------- preset ----------
   setPreset(id) {
     const p = this.registry.game(id) ?? this.registry.games[0];
     this.preset = p;
@@ -78,8 +78,8 @@ class ViewerSession {
     const m = this.registry.presetMotionExtensions(this.preset);
     return this.preset.ui?.motionAny ? [.../* @__PURE__ */ new Set([...m, ...this.modelExtensions])] : m;
   }
-  // ---------- приём файлов ----------
-  /** Разложить набор файлов: архивы, словари текстур, картинки, анимации, модель. */
+  // ---------- receiving files ----------
+  /** Sort a set of files into archives, texture dictionaries, images, animations and the model. */
   async addFiles(input) {
     const files = Array.from(input), reg = this.registry;
     const motionExts = this.registry.motionOnlyExtensions;
@@ -95,9 +95,9 @@ class ViewerSession {
     for (const f of mot) await this.loadMotions(f);
   }
   /**
-   * Открыть архивы. Файл, который не читается (не архив — например, зашифрованные a3.Arch01 F.E.A.R. Online, — повреждён),
-   * пропускается — остальные открываются;
-   * в строке состояния — сколько открыто и что пропущено.
+   * Open archives. A file that cannot be read (not an archive, for example the encrypted F.E.A.R. Online a3.Arch01, or damaged)
+   * is skipped and the rest are opened;
+   * the status line tells how many were opened and what was skipped.
    */
   async addArchives(files) {
     const skipped = [];
@@ -135,7 +135,7 @@ class ViewerSession {
       if (!opened) this.status(tr("session.archiveError", { error: skipped.slice(0, 3).join("; ") }), true);
     } else this.archivesChanged(tr("session.archives", { n: this.archives.length }));
   }
-  /** «Папка игры» с полосой прогресса: индекс строится кусками, интерфейс не замирает (сотни тысяч файлов). */
+  /** "Game folder" with a progress bar: the index is built in chunks so the UI does not freeze (hundreds of thousands of files). */
   async addFolderAsync(files) {
     try {
       const a = await openFolderAsync(files, (done, total) => this.progress(tr("session.indexing", { n: total }), done, total));
@@ -148,7 +148,7 @@ class ViewerSession {
       this.progress();
     }
   }
-  /** «Папка игры»: индексирует файлы без чтения. */
+  /** "Game folder": indexes files without reading them. */
   addFolder(files) {
     const a = openFolder(files);
     this.archives.push(a);
@@ -156,8 +156,8 @@ class ViewerSession {
     return a;
   }
   /**
-   * Архивы внутри «Папки игры», которые движок просит открывать сразу (ArchivePlugin.openFromFolder): F.E.A.R. Online — *.arch01.
-   * Возвращает число открытых архивов.
+   * Archives inside the "Game folder" that the engine asks to open right away (ArchivePlugin.openFromFolder): F.E.A.R. Online *.arch01.
+   * Returns the number of opened archives.
    */
   async openFolderArchives(folder) {
     if (!folder.blobOf) return 0;
@@ -212,11 +212,11 @@ class ViewerSession {
       this.status(tr("session.dictError", { id: plugin.id.toUpperCase(), error: errMsg(e) }), true);
     }
   }
-  // ---------- модель ----------
-  /** Выбрать основной файл (автоопределение) и загрузить модель. */
-  /** Файлы и выборы последней загрузки — для setModelOption. */
+  // ---------- model ----------
+  /** Pick the main file (format detection) and load the model. */
+  /** Files and choices of the last load, for setModelOption. */
   lastLoad = null;
-  /** Сменить выбор модели (Model.options) и пересобрать её из тех же файлов. */
+  /** Change a model choice (Model.options) and rebuild it from the same files. */
   async setModelOption(id, value) {
     if (!this.lastLoad || !this.main) return null;
     const options = { ...this.lastLoad.options, [id]: value };
@@ -316,7 +316,7 @@ class ViewerSession {
       addTextureDictionary: (file) => this.addTextureDictionary(file)
     };
   }
-  /** Добавить внешние анимации к загруженной модели. */
+  /** Add external animations to the loaded model. */
   async loadMotions(file) {
     if (!this.model?.loadMotions) {
       this.status(tr("session.noMotionModel"), true);
@@ -334,12 +334,12 @@ class ViewerSession {
       return [];
     }
   }
-  // ---------- текстуры ----------
+  // ---------- textures ----------
   setTextureOverride(meshIndex, file) {
     this.overrides.set(meshIndex, file);
   }
-  /** Найти и декодировать текстуру меша. */
-  /** Файл текстуры меша (тот же поиск, что у resolveTexture): для выгрузки исходных байтов, например DDS. */
+  /** Find and decode a mesh texture. */
+  /** Mesh texture file (the same lookup as resolveTexture): for exporting the source bytes, for example DDS. */
   async textureSource(i) {
     const model = this.model, mesh = model?.meshes[i];
     if (!model || !mesh) return null;
@@ -380,8 +380,8 @@ class ViewerSession {
     }
   }
   /**
-   * Карта нормалей меша: встроенная → указанная моделью/материалом → по имени диффузной (_co→_nohq, __d→__n_d, _diff→_normal, _d→_n…).
-   * Найденная картинка проверяется на «похожесть» на нормали и упаковку (RGB, RG/BC5, AG/DXT5nm).
+   * Mesh normal map: embedded → named by the model/material → derived from the diffuse name (_co→_nohq, __d→__n_d, _diff→_normal, _d→_n…).
+   * A found image is checked for looking like a normal map and for its packing (RGB, RG/BC5, AG/DXT5nm).
    */
   async resolveNormal(i, diffuse) {
     const mesh = this.model?.meshes[i], none = { meshIndex: i, image: null, packing: "rgb", label: "", ok: false };
@@ -410,8 +410,8 @@ class ViewerSession {
     return mesh.normalMap ? { ...none, label: tr("tex.normalNoFile") } : none;
   }
   /**
-   * PBR-поверхность меша: из материала (mesh.surface) или упакованные карты по имени диффузной (_orm, _rma, _smdi…).
-   * Карты сводятся в одну текстуру (composeSurface); нет карт, но есть множители — текстура 1×1.
+   * Mesh PBR surface: from the material (mesh.surface) or packed maps derived from the diffuse name (_orm, _rma, _smdi…).
+   * Maps are combined into one texture (composeSurface); with no maps but with multipliers, a 1×1 texture.
    */
   async resolveSurface(i, diffuse) {
     const mesh = this.model?.meshes[i], none = { meshIndex: i, image: null, label: "", ok: false };
@@ -439,8 +439,8 @@ class ViewerSession {
     return none;
   }
   /**
-   * Последняя попытка: картинка в папке модели. Имя совпадает с материалом, или «skin.*» (Quake II rerelease: md5/skin.png),
-   * или это единственная картинка в папке (без карт *_glow/_n/_s/_normal/_spec).
+   * Last resort: an image in the model folder. Its name matches the material, or "skin.*" (Quake II rerelease: md5/skin.png),
+   * or it is the only image in the folder (excluding *_glow/_n/_s/_normal/_spec maps).
    */
   sameFolderTexture(texture) {
     const main = this.main;
@@ -451,8 +451,8 @@ class ViewerSession {
     const pick = imgs.find((e) => stem(e.path) === want) ?? imgs.find((e) => stem(e.path) === "skin") ?? (imgs.length === 1 ? imgs[0] : void 0);
     return pick ? main.archive.fileOf(pick) : null;
   }
-  // ---------- содержимое архивов ----------
-  /** Модели и анимации текущего пресета во всех архивах. */
+  // ---------- archive contents ----------
+  /** Models and animations of the current preset in all archives. */
   archiveModels(filter = "", limit = 400) {
     const exts = [...this.modelExtensions, ...this.motionExtensions].map((x) => "." + x), q = filter.trim().toLowerCase();
     const items = [];
@@ -466,7 +466,7 @@ class ViewerSession {
       }
     return { items, total };
   }
-  /** Открыть запись архива: анимацию — добавить, модель — загрузить. */
+  /** Open an archive entry: add an animation, load a model. */
   async openEntry(item) {
     const f = item.archive.fileOf(item.entry), ext = extOf(item.entry.path);
     if (this.registry.presetMotionExtensions(this.preset).includes(ext) && !this.modelExtensions.includes(ext)) await this.loadMotions(f);