@gmvjs/core 0.1.0 → 0.1.1

package/dist/types.d.ts

@@ -4,7 +4,7 @@ export interface Bounds {
     min: number[];
     max: number[];
 }
-/** Декодированная текстура: либо RGBA-пиксели, либо ImageBitmap (PNG/JPG через браузер). */
+/** Decoded texture: either RGBA pixels or an ImageBitmap (PNG/JPG via the browser). */
 export interface DecodedImage {
     width: number;
     height: number;
@@ -12,20 +12,20 @@ export interface DecodedImage {
     bitmap?: ImageBitmap;
     name?: string;
 }
-/** Источник байтов, который можно открыть как архив (File в браузере, Blob с именем в Node). */
+/** A byte source that can be opened as an archive (File in the browser, a named Blob in Node). */
 export type BlobFile = Blob & {
     readonly name: string;
     readonly webkitRelativePath?: string;
 };
-/** «Файл-подобный» объект: обычный File, запись архива или уже декодированная текстура. */
+/** File-like object: a regular File, an archive entry or an already decoded texture. */
 export interface VFile {
     readonly name: string;
-    /** Путь внутри архива / папки (нижний регистр, «/»). */
+    /** Path inside an archive / folder (lower case, "/"). */
     readonly path?: string;
     readonly archive?: Archive;
     readonly webkitRelativePath?: string;
     arrayBuffer(): Promise<ArrayBuffer>;
-    /** Если задано — это уже декодированная картинка (например, из TXD). */
+    /** If set, this is an already decoded image (for example from a TXD). */
     readonly decoded?: DecodedImage;
 }
 export interface ArchiveEntry {
@@ -34,33 +34,33 @@ export interface ArchiveEntry {
 }
 export interface Archive {
     readonly name: string;
-    /** id плагина архива: 'zip', 'bsa', 'folder'… */
+    /** Archive plugin id: 'zip', 'bsa', 'folder'… */
     readonly kind: string;
     readonly version: number;
     readonly entries: ArchiveEntry[];
-    /** Полный путь -> запись. */
+    /** Full path -> entry. */
     readonly index: Map<string, ArchiveEntry>;
-    /** Путь без расширения -> запись текстуры. */
+    /** Path without extension -> texture entry. */
     readonly byKey: Map<string, ArchiveEntry>;
-    /** Имя файла -> запись (для «Папки игры»). */
+    /** File name -> entry (for the "Game folder"). */
     readonly byBase?: Map<string, ArchiveEntry>;
     lookup(path: string): ArchiveEntry | null;
     read(entry: ArchiveEntry): Promise<Uint8Array>;
     fileOf(entry: ArchiveEntry): VFile;
-    /** Исходный файл записи (только «Папка игры»): чтобы открыть лежащий в папке архив. */
+    /** Source file of the entry ("Game folder" only): to open an archive lying in the folder. */
     blobOf?(entry: ArchiveEntry): BlobFile | null;
-    /** Текстура по точному пути из модели, даже если её нет в списке (архивы с именами-хешами: Far Cry 2). */
+    /** Texture at the exact path from the model, even if it is not in the list (archives with hashed names: Far Cry 2). */
     findTexture?(path: string): ArchiveEntry | null;
 }
-/** Канал карты: путь/имя файла и номер канала (0 R, 1 G, 2 B, 3 A). */
+/** Map channel: path/file name and channel number (0 R, 1 G, 2 B, 3 A). */
 export interface ChannelRef {
     map: string;
     channel: 0 | 1 | 2 | 3;
     image?: DecodedImage;
 }
 /**
- * Поверхность для PBR. Схема metal/rough (glTF, BeamNG, SnowRunner) или spec/gloss (Arma _smdi, MudRunner __s_d):
- * gloss = 1 − roughness, specular — сила блика неметалла.
+ * PBR surface. The metal/rough scheme (glTF, BeamNG, SnowRunner) or spec/gloss (Arma _smdi, MudRunner __s_d):
+ * gloss = 1 − roughness, specular is the non-metal specular strength.
  */
 export interface SurfaceInfo {
     roughness?: ChannelRef;
@@ -70,156 +70,156 @@ export interface SurfaceInfo {
     specular?: ChannelRef;
     roughnessFactor?: number;
     metallicFactor?: number;
-    /** Сила блика без карты (0..1; 0.5 ≈ F0 0.04). */
+    /** Specular strength without a map (0..1; 0.5 ≈ F0 0.04). */
     specularFactor?: number;
-    /** Откуда взято (для подписи): «BeamNG», «Arma _smdi»… */
+    /** Where it came from (for the label): "BeamNG", "Arma _smdi"… */
     source?: string;
 }
 export interface Mesh {
     name: string;
-    /** Имя текстуры/материала, как записано в модели. */
+    /** Texture/material name as written in the model. */
     texture: string;
     shader?: string;
-    /** Имя материала (assimp/HPL). */
+    /** Material name (assimp/HPL). */
     material?: string;
     vertexCount: number;
     pos: Float32Array;
     nor: Float32Array;
     uv: Float32Array;
-    /** 4 индекса костей на вершину (float — для атрибутов WebGL). */
+    /** 4 bone indices per vertex (float, for WebGL attributes). */
     bone: Float32Array;
     weight: Float32Array;
     indices: Uint16Array | Uint32Array;
     skinned: boolean;
-    /** Цвет без текстуры (RenderWare). */
+    /** Color without a texture (RenderWare). */
     color?: number[];
-    /** Встроенная текстура (Quake MDL, GoldSrc). */
+    /** Embedded texture (Quake MDL, GoldSrc). */
     image?: DecodedImage;
-    /** Покадровая вершинная анимация: pos/nor меняются на месте. */
+    /** Per-frame vertex animation: pos/nor change in place. */
     dynamic?: boolean;
     frames?: {
         pos: Float32Array[];
         nor: Float32Array[];
     };
-    /** Кандидаты путей материалов (Source .vmt). */
+    /** Candidate material paths (Source .vmt). */
     materialPaths?: string[];
-    /** Номер подматериала (CryEngine). */
+    /** Submaterial number (CryEngine). */
     matId?: number;
-    /** Карта нормалей, как она записана в модели или материале (путь/имя); пусто — ищется по имени диффузной. */
+    /** Normal map as written in the model or material (path/name); empty means it is looked up from the diffuse name. */
     normalMap?: string;
-    /** Встроенная карта нормалей. */
+    /** Embedded normal map. */
     normalImage?: DecodedImage;
-    /** PBR-поверхность: шероховатость, металличность, AO, блик (карты и множители). */
+    /** PBR surface: roughness, metalness, AO, specular (maps and multipliers). */
     surface?: SurfaceInfo;
-    /** Прозрачность по альфе текстуры «вырезанием» (решётки, листва, наклейки) — независимо от общего переключателя. */
+    /** Alpha-tested transparency from the texture alpha (grates, foliage, decals), independent of the global toggle. */
     alphaTest?: boolean;
-    /** Служебная геометрия (световые плоскости, экраны-рендер-цели): по умолчанию скрыта. */
+    /** Helper geometry (light planes, render-target screens): hidden by default. */
     defaultHidden?: boolean;
-    /** Второй набор UV — координаты в карте освещения (Model.lightmap). */
+    /** Second UV set: coordinates in the lightmap (Model.lightmap). */
     uv2?: Float32Array;
-    /** Прозрачность по вершинам (0..1): слой ландшафта поверх основы — рисуется после непрозрачных мешей, с наложением. */
+    /** Per-vertex opacity (0..1): a terrain layer over the base, drawn after opaque meshes with blending. */
     vertexAlpha?: Float32Array;
-    /** Запечённое освещение по вершинам: RGB(A) байтами, 128 — без изменений (умножение ×2, как у Black Box). */
+    /** Baked per-vertex lighting: RGB(A) bytes, 128 = unchanged (×2 multiplication, as in Black Box). */
     vertexShade?: Uint8Array;
     /**
-     * Карта слоёв ландшафта (номер слоя Model.terrainLayers на тексель, по UV меша 0..1): вблизи вместо одной цветовой
-     * карты (image) рисуются повторяющиеся текстуры слоёв, подкрашенные ею.
+     * Terrain layer map (a Model.terrainLayers layer number per texel, over the mesh UV 0..1): up close, instead of a single color
+     * map (image), repeating layer textures tinted by it are drawn.
      */
     terrainIndex?: {
         width: number;
         height: number;
         data: Uint8Array;
     };
-    /** Отражение и преломление по экрану (вода, преломляющее стекло Source): рисуется после сцены по её снимку. */
+    /** Screen-space reflection and refraction (water, Source refracting glass): drawn after the scene from its snapshot. */
     screenFx?: ScreenFx;
 }
-/** Параметры экранной поверхности: вода (плоское отражение, преломление, туман по глубине) или стекло (преломление). */
+/** Screen surface parameters: water (planar reflection, refraction, depth fog) or glass (refraction). */
 export interface ScreenFx {
     kind: 'water' | 'glass';
-    /** Плоскость поверхности в координатах модели: n·p = d (для отражения воды). */
+    /** Surface plane in model coordinates: n·p = d (for water reflection). */
     plane?: [number, number, number, number];
-    /** Цвет преломления (то, что под водой / за стеклом) и отражения (у стекла — блик окружения $envmaptint), 0..1. */
+    /** Refraction color (what is under water / behind glass) and reflection color (for glass, the $envmaptint environment highlight), 0..1. */
     refractTint: number[];
     reflectTint?: number[];
-    /** Сила искажения по карте нормалей: доля экрана. */
+    /** Distortion strength from the normal map: a fraction of the screen. */
     refract: number;
     reflect?: number;
-    /** Туман под водой: цвет 0..1, начало и конец в единицах модели. */
+    /** Underwater fog: color 0..1, start and end in model units. */
     fog?: {
         color: number[];
         start: number;
         end: number;
     };
-    /** Сдвиг карты нормалей во времени (UV/сек). */
+    /** Normal map scrolling over time (UV/sec). */
     scroll?: [number, number];
-    /** Без поддержки: цвет и непрозрачность полупрозрачного слоя. */
+    /** Without support: color and opacity of a translucent layer. */
     fallback: {
         color: number[];
         opacity: number;
     };
 }
-/** Слои поверхности ландшафта: текстуры одного размера и параметры показа. */
+/** Terrain surface layers: textures of one size and display parameters. */
 export interface TerrainLayers {
-    /** Текстуры слоёв (одного размера, степень двойки). */
+    /** Layer textures (one size, power of two). */
     images: DecodedImage[];
-    /** Период повтора текстуры в единицах модели (по X и Z координат меша). */
+    /** Texture repeat period in model units (along the mesh X and Z coordinates). */
     period: number[];
-    /** 0..1: насколько слой подкрашивается цветовой картой меша. */
+    /** 0..1: how much the layer is tinted by the mesh color map. */
     tint: number[];
-    /** Средний цвет текстуры слоя (0..1) — для подкраски. */
+    /** Average color of the layer texture (0..1), for tinting. */
     mean: Array<[number, number, number]>;
-    /** Дальность, на которой слои переходят в цветовую карту. */
+    /** Distance at which layers fade into the color map. */
     fade: number;
-    /** Нормали слоёв (тот же размер, что images): RG — XY касательной нормали (DirectX), A — AO. */
+    /** Layer normals (same size as images): RG = XY of the tangent normal (DirectX), A = AO. */
     normals?: DecodedImage[];
-    /** Средний масштаб: текстуры изменчивости (свой размер), период, сила, средний цвет. */
+    /** Medium scale: variation textures (own size), period, strength, average color. */
     middle?: DecodedImage[];
     midPeriod?: number[];
     midBlend?: number[];
     midMean?: Array<[number, number, number]>;
-    /** Имена (для сведений). */
+    /** Names (for details). */
     names?: string[];
 }
-/** Запечённое освещение уровня (одна карта на модель): яркость в R, UV — Mesh.uv2. */
+/** Baked level lighting (one map per model): brightness in R, UV is Mesh.uv2. */
 export interface Lightmap {
     width: number;
     height: number;
-    /** Яркость, 1 байт на пиксель (или RGB, 3 байта, при rgb). */
+    /** Brightness, 1 byte per pixel (or RGB, 3 bytes, with rgb). */
     data: Uint8Array;
-    /** Цветная карта (Source): RGB8. */
+    /** Color map (Source): RGB8. */
     rgb?: boolean;
-    /** Множитель яркости при показе. */
+    /** Brightness multiplier for display. */
     scale?: number;
     /**
-     * Карты освещения по трём направлениям базиса рельефа Source (bump lightmaps), тот же формат и раскладка, что data:
-     * свет смешивается по нормали из карты нормалей. У граней без рельефа — копия data.
+     * Lightmaps for the three directions of the Source bump basis (bump lightmaps), same format and layout as data:
+     * light is blended by the normal from the normal map. Faces without bump get a copy of data.
      */
     bump?: [Uint8Array, Uint8Array, Uint8Array];
 }
-/** Ключи анимации assimp-стиля: [время, значение]. */
+/** assimp-style animation keys: [time, value]. */
 export type Keys<T> = Array<[number, T]>;
 export interface NodeChannel {
     pos: Keys<number[]> | null;
     rot: Keys<number[]> | null;
     scl: Keys<number[]> | null;
-    /** Аддитивная дорожка как смещение (перенос + поворот [w,x,y,z]) — применяется так, когда анимация — слой поверх другой. */
+    /** Additive track as an offset (translation + rotation [w,x,y,z]): applied this way when the animation is a layer over another. */
     add?: {
         pos: Keys<number[]> | null;
         rot: Keys<number[]> | null;
     };
 }
-/** Слой поверх основной анимации узлов: аддитивные каналы складываются, остальные заменяют позу (в пределах маски). */
+/** Layer over the main node animation: additive channels are added, others replace the pose (within the mask). */
 export interface NodeLayer {
     motion: NodeMotion;
-    /** Постоянный кадр слоя (поза прицеливания — средний кадр сетки направлений); нет — играет по времени. */
+    /** Fixed frame of the layer (aim pose: the middle frame of the direction grid); none means it plays over time. */
     frame?: number;
-    /** Номера узлов, которые слой может менять; нет — все. */
+    /** Node numbers the layer may change; none means all. */
     mask?: ReadonlySet<number>;
-    /** Только дополнять: узлы, у которых есть канал в основной анимации, слой не трогает (хват оружия у NPC — свой). */
+    /** Only complement: the layer does not touch nodes that have a channel in the main animation (NPC weapon grip is its own). */
     fill?: boolean;
     /**
-     * Слой — сетка поз (кадр = строка·cols + столбец), например направления прицела: x — столбец, y — строка
-     * (дробные: смешиваются 4 соседних кадра). Перекрывает frame.
+     * The layer is a pose grid (frame = row·cols + column), for example aim directions: x is the column, y the row
+     * (fractional: 4 neighbouring frames are blended). Overrides frame.
      */
     grid?: {
         cols: number;
@@ -230,32 +230,32 @@ export interface NodeLayer {
 }
 export interface MotionBase {
     name: string;
-    /** Длительность, сек. */
+    /** Duration, seconds. */
     duration: number;
-    /** Число кадров (для подписи в списке). */
+    /** Frame count (for the list label). */
     frames?: number;
-    /** Откуда анимация: 'model' или имя файла. */
+    /** Where the animation comes from: 'model' or a file name. */
     source?: string;
-    /** Анимация из длинного списка (Metro: тысячи файлов): данные читаются при выборе. */
+    /** Animation from a long list (Metro: thousands of files): data is read on selection. */
     load?(): Promise<Motion>;
 }
-/** Анимация узлов (assimp, NIF, MD5, PSA, Cast, GoldSrc). */
+/** Node animation (assimp, NIF, MD5, PSA, Cast, GoldSrc). */
 export interface NodeMotion extends MotionBase {
     kind: 'node';
     tps: number;
     chan: Map<number, NodeChannel>;
-    /** Слои поверх (прицеливание, дыхание). */
+    /** Layers on top (aiming, breathing). */
     layers?: NodeLayer[];
-    /** Анимации, которые можно положить слоем (для выбора в интерфейсе; могут загружаться при выборе). */
+    /** Animations that can be used as a layer (for selection in the UI; may be loaded on selection). */
     layerPool?: NodeMotion[];
-    /** Имена из layerPool, подобранные слоем по умолчанию. */
+    /** Names from layerPool picked as the default layer. */
     layerAuto?: string[];
     /**
-     * Смешивание анимаций по параметрам (последовательности Source: направление движения): сетка cols×rows анимаций
-     * (индекс — строка·cols + столбец), x/y — дробное положение; фаза общая — анимации разной длины идут в такт.
+     * Parametric animation blending (Source sequences: movement direction): a cols×rows grid of animations
+     * (index = row·cols + column), x/y are fractional positions; the phase is shared, so animations of different length stay in step.
      */
     blend?: NodeBlend;
-    /** Как класть эту анимацию слоем (кадр, маска) — задаёт движок. */
+    /** How to apply this animation as a layer (frame, mask): set by the engine. */
     asLayer?: (m: NodeMotion) => Omit<NodeLayer, 'motion'>;
 }
 export interface NodeBlend {
@@ -264,14 +264,14 @@ export interface NodeBlend {
     rows: number;
     x: number;
     y: number;
-    /** Параметры по осям (для подписи ползунка): имя и значения на краях сетки. */
+    /** Axis parameters (for the slider label): name and values at the grid edges. */
     params?: Array<{
         name: string;
         start: number;
         end: number;
     }>;
 }
-/** Покадровая вершинная анимация (MD2/MD3/MDL). */
+/** Per-frame vertex animation (MD2/MD3/MDL). */
 export interface VertexMotion extends MotionBase {
     kind: 'vertex';
     start: number;
@@ -279,15 +279,15 @@ export interface VertexMotion extends MotionBase {
     fps: number;
 }
 /**
- * Виды анимаций по полю kind. Движок добавляет свой вид расширением интерфейса, например
- * `declare module '@gmvjs/core/types' { interface MotionKinds { xray: XrayMotion } }` — и сужение по `m.kind` продолжает работать.
+ * Animation kinds by the kind field. An engine adds its own kind by extending the interface, for example
+ * `declare module '@gmvjs/core/types' { interface MotionKinds { xray: XrayMotion } }`, and narrowing by `m.kind` keeps working.
  */
 export interface MotionKinds {
     node: NodeMotion;
     vertex: VertexMotion;
 }
 export type Motion = MotionKinds[keyof MotionKinds];
-/** Скелет, который умеет считать позу. Матрицы — column-major Float32, 16 на кость. */
+/** A skeleton that can compute a pose. Matrices are column-major Float32, 16 per bone. */
 export interface SkeletonRuntime {
     readonly n: number;
     readonly parent: number[];
@@ -296,11 +296,11 @@ export interface SkeletonRuntime {
     readonly skinV: Float32Array[];
     pose(motion: Motion | null, time: number, loop: boolean, invert?: boolean): void;
 }
-/** Сцена из повторяющихся моделей (объекты уровня): для экспорта ссылками вместо слитой геометрии. */
+/** Scene of repeated models (level objects): for exporting as references instead of merged geometry. */
 export interface InstancedScene {
-    /** Номера мешей модели, собранных из экземпляров (при экспорте заменяются ссылками). */
+    /** Numbers of model meshes built from instances (replaced by references on export). */
     meshes: number[];
-    /** Прототипы: части с номером меша модели, по которому берутся текстура и материал. */
+    /** Prototypes: parts with the model mesh number used for texture and material. */
     protos: Array<{
         name: string;
         parts: Array<{
@@ -311,10 +311,10 @@ export interface InstancedScene {
             indices: Uint32Array;
         }>;
     }>;
-    /** Поза — матрица 4×4 по строкам (вектор-строка × M, перенос в последней строке), в координатах модели. */
+    /** Pose: 4×4 matrix by rows (row vector × M, translation in the last row), in model coordinates. */
     placements: InstancePlacement[];
 }
-/** Где лежит часть экземпляра в слитом меше: номер меша, вершины и индексы. */
+/** Where an instance part lives in the merged mesh: mesh number, vertices and indices. */
 export interface PlacementRange {
     mesh: number;
     part: number;
@@ -327,14 +327,14 @@ export interface InstancePlacement {
     proto: number;
     name: string;
     pose: number[];
-    /** Группа в слоях сцены (класс объекта: STATICPROP, O_ENTITY…). */
+    /** Group in the scene layers (object class: STATICPROP, O_ENTITY…). */
     group?: string;
-    /** Скрыт пользователем: не рисуется и не выгружается. */
+    /** Hidden by the user: not drawn and not exported. */
     hidden?: boolean;
-    /** Части в слитых мешах (для скрытия, подсветки, выбора и поворота). */
+    /** Parts in merged meshes (for hiding, highlighting, picking and rotation). */
     ranges?: PlacementRange[];
 }
-/** Выбор для пересборки модели: id, подпись, варианты и текущее значение. */
+/** A choice for rebuilding the model: id, label, options and current value. */
 export interface ModelOption {
     id: string;
     label: string;
@@ -346,38 +346,38 @@ export interface ModelOption {
 }
 export interface Model {
     meshes: Mesh[];
-    /** Экземпляры моделей внутри сцены (Metro level.bin). */
+    /** Model instances inside the scene (Metro level.bin). */
     instances?: InstancedScene;
-    /** Карта освещения уровня (Metro level.lmap_pc). */
+    /** Level lightmap (Metro level.lmap_pc). */
     lightmap?: Lightmap;
-    /** Слои поверхности ландшафта (Mesh.terrainIndex). */
+    /** Terrain surface layers (Mesh.terrainIndex). */
     terrainLayers?: TerrainLayers;
     skeleton: SkeletonRuntime | null;
     motions: Motion[];
     bounds: Bounds;
-    /** Левосторонняя система (X-Ray): отразить Z при показе. */
+    /** Left-handed system (X-Ray): mirror Z for display. */
     flipZ?: boolean;
     defaultZUp?: boolean;
     cameraYaw?: number;
-    /** Строки для панели «Сведения». */
+    /** Lines for the "Details" panel. */
     info: string[];
-    /** Вершинная анимация: обновить pos/nor мешей на время t. */
+    /** Vertex animation: update mesh pos/nor for time t. */
     animate?(motion: Motion | null, t: number, loop: boolean): void;
-    /** Подбор знака кватернионов для анимации. */
+    /** Quaternion sign fitting for the animation. */
     detectInvert?(motion: Motion): boolean;
-    /** Загрузка внешних анимаций (.omf/.psa/.md5anim/.cast). */
+    /** Loading external animations (.omf/.psa/.md5anim/.cast). */
     loadMotions?(file: VFile): Promise<Motion[]>;
-    /** Произвольные данные для резолверов текстур (имя .mtl и т. п.). */
+    /** Arbitrary data for texture resolvers (.mtl name and the like). */
     meta?: Record<string, unknown>;
     /**
-     * Настройки вида, которые формат умеет пересобрать (диски, винил, цвет окраски NFS World): список выборов с текущим
-     * значением. Смена значения — повторная загрузка с LoadContext.options (камера сохраняется).
+     * View settings the format can rebuild (wheels, vinyl, NFS World paint color): a list of choices with their current
+     * value. Changing a value reloads with LoadContext.options (the camera is kept).
      */
     options?: ModelOption[];
-    /** Направление зелёного канала карт нормалей игры: 'dx' (Y вниз, Direct3D — по умолчанию) или 'gl' (Y вверх). */
+    /** Green channel direction of the game's normal maps: 'dx' (Y down, Direct3D, the default) or 'gl' (Y up). */
     normalY?: 'gl' | 'dx';
 }
-/** Ошибка «файл содержит только анимацию» — сессия попробует добавить его как анимацию. */
+/** "The file contains only an animation" error: the session will try to add it as an animation. */
 export declare class MotionOnlyError extends Error {
     readonly motionOnly = true;
 }

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../src/types.ts"],"sourcesContent":["// Публичные типы ядра gmv. Ядро не зависит от DOM: работает в странице, в Worker и в Node (тесты).\n\nexport type Vec3 = [number, number, number];\nexport type Quat = [number, number, number, number]; // [w, x, y, z]\n\nexport interface Bounds {\n  min: number[];\n  max: number[];\n}\n\n/** Декодированная текстура: либо RGBA-пиксели, либо ImageBitmap (PNG/JPG через браузер). */\nexport interface DecodedImage {\n  width: number;\n  height: number;\n  rgba?: Uint8Array;\n  bitmap?: ImageBitmap;\n  name?: string;\n}\n\n/** Источник байтов, который можно открыть как архив (File в браузере, Blob с именем в Node). */\nexport type BlobFile = Blob & { readonly name: string; readonly webkitRelativePath?: string };\n\n/** «Файл-подобный» объект: обычный File, запись архива или уже декодированная текстура. */\nexport interface VFile {\n  readonly name: string;\n  /** Путь внутри архива / папки (нижний регистр, «/»). */\n  readonly path?: string;\n  readonly archive?: Archive;\n  readonly webkitRelativePath?: string;\n  arrayBuffer(): Promise<ArrayBuffer>;\n  /** Если задано — это уже декодированная картинка (например, из TXD). */\n  readonly decoded?: DecodedImage;\n}\n\nexport interface ArchiveEntry {\n  path: string;\n  size?: number;\n}\n\nexport interface Archive {\n  readonly name: string;\n  /** id плагина архива: 'zip', 'bsa', 'folder'… */\n  readonly kind: string;\n  readonly version: number;\n  readonly entries: ArchiveEntry[];\n  /** Полный путь -> запись. */\n  readonly index: Map<string, ArchiveEntry>;\n  /** Путь без расширения -> запись текстуры. */\n  readonly byKey: Map<string, ArchiveEntry>;\n  /** Имя файла -> запись (для «Папки игры»). */\n  readonly byBase?: Map<string, ArchiveEntry>;\n  lookup(path: string): ArchiveEntry | null;\n  read(entry: ArchiveEntry): Promise<Uint8Array>;\n  fileOf(entry: ArchiveEntry): VFile;\n  /** Исходный файл записи (только «Папка игры»): чтобы открыть лежащий в папке архив. */\n  blobOf?(entry: ArchiveEntry): BlobFile | null;\n  /** Текстура по точному пути из модели, даже если её нет в списке (архивы с именами-хешами: Far Cry 2). */\n  findTexture?(path: string): ArchiveEntry | null;\n}\n\n/** Канал карты: путь/имя файла и номер канала (0 R, 1 G, 2 B, 3 A). */\nexport interface ChannelRef { map: string; channel: 0 | 1 | 2 | 3; image?: DecodedImage }\n/**\n * Поверхность для PBR. Схема metal/rough (glTF, BeamNG, SnowRunner) или spec/gloss (Arma _smdi, MudRunner __s_d):\n * gloss = 1 − roughness, specular — сила блика неметалла.\n */\nexport interface SurfaceInfo {\n  roughness?: ChannelRef;\n  gloss?: ChannelRef;\n  metallic?: ChannelRef;\n  ao?: ChannelRef;\n  specular?: ChannelRef;\n  roughnessFactor?: number;\n  metallicFactor?: number;\n  /** Сила блика без карты (0..1; 0.5 ≈ F0 0.04). */\n  specularFactor?: number;\n  /** Откуда взято (для подписи): «BeamNG», «Arma _smdi»… */\n  source?: string;\n}\n\nexport interface Mesh {\n  name: string;\n  /** Имя текстуры/материала, как записано в модели. */\n  texture: string;\n  shader?: string;\n  /** Имя материала (assimp/HPL). */\n  material?: string;\n  vertexCount: number;\n  pos: Float32Array;\n  nor: Float32Array;\n  uv: Float32Array;\n  /** 4 индекса костей на вершину (float — для атрибутов WebGL). */\n  bone: Float32Array;\n  weight: Float32Array;\n  indices: Uint16Array | Uint32Array;\n  skinned: boolean;\n  /** Цвет без текстуры (RenderWare). */\n  color?: number[];\n  /** Встроенная текстура (Quake MDL, GoldSrc). */\n  image?: DecodedImage;\n  /** Покадровая вершинная анимация: pos/nor меняются на месте. */\n  dynamic?: boolean;\n  frames?: { pos: Float32Array[]; nor: Float32Array[] };\n  /** Кандидаты путей материалов (Source .vmt). */\n  materialPaths?: string[];\n  /** Номер подматериала (CryEngine). */\n  matId?: number;\n  /** Карта нормалей, как она записана в модели или материале (путь/имя); пусто — ищется по имени диффузной. */\n  normalMap?: string;\n  /** Встроенная карта нормалей. */\n  normalImage?: DecodedImage;\n  /** PBR-поверхность: шероховатость, металличность, AO, блик (карты и множители). */\n  surface?: SurfaceInfo;\n  /** Прозрачность по альфе текстуры «вырезанием» (решётки, листва, наклейки) — независимо от общего переключателя. */\n  alphaTest?: boolean;\n  /** Служебная геометрия (световые плоскости, экраны-рендер-цели): по умолчанию скрыта. */\n  defaultHidden?: boolean;\n  /** Второй набор UV — координаты в карте освещения (Model.lightmap). */\n  uv2?: Float32Array;\n  /** Прозрачность по вершинам (0..1): слой ландшафта поверх основы — рисуется после непрозрачных мешей, с наложением. */\n  vertexAlpha?: Float32Array;\n  /** Запечённое освещение по вершинам: RGB(A) байтами, 128 — без изменений (умножение ×2, как у Black Box). */\n  vertexShade?: Uint8Array;\n  /**\n   * Карта слоёв ландшафта (номер слоя Model.terrainLayers на тексель, по UV меша 0..1): вблизи вместо одной цветовой\n   * карты (image) рисуются повторяющиеся текстуры слоёв, подкрашенные ею.\n   */\n  terrainIndex?: { width: number; height: number; data: Uint8Array };\n  /** Отражение и преломление по экрану (вода, преломляющее стекло Source): рисуется после сцены по её снимку. */\n  screenFx?: ScreenFx;\n}\n\n/** Параметры экранной поверхности: вода (плоское отражение, преломление, туман по глубине) или стекло (преломление). */\nexport interface ScreenFx {\n  kind: 'water' | 'glass';\n  /** Плоскость поверхности в координатах модели: n·p = d (для отражения воды). */\n  plane?: [number, number, number, number];\n  /** Цвет преломления (то, что под водой / за стеклом) и отражения (у стекла — блик окружения $envmaptint), 0..1. */\n  refractTint: number[];\n  reflectTint?: number[];\n  /** Сила искажения по карте нормалей: доля экрана. */\n  refract: number;\n  reflect?: number;\n  /** Туман под водой: цвет 0..1, начало и конец в единицах модели. */\n  fog?: { color: number[]; start: number; end: number };\n  /** Сдвиг карты нормалей во времени (UV/сек). */\n  scroll?: [number, number];\n  /** Без поддержки: цвет и непрозрачность полупрозрачного слоя. */\n  fallback: { color: number[]; opacity: number };\n}\n\n/** Слои поверхности ландшафта: текстуры одного размера и параметры показа. */\nexport interface TerrainLayers {\n  /** Текстуры слоёв (одного размера, степень двойки). */\n  images: DecodedImage[];\n  /** Период повтора текстуры в единицах модели (по X и Z координат меша). */\n  period: number[];\n  /** 0..1: насколько слой подкрашивается цветовой картой меша. */\n  tint: number[];\n  /** Средний цвет текстуры слоя (0..1) — для подкраски. */\n  mean: Array<[number, number, number]>;\n  /** Дальность, на которой слои переходят в цветовую карту. */\n  fade: number;\n  /** Нормали слоёв (тот же размер, что images): RG — XY касательной нормали (DirectX), A — AO. */\n  normals?: DecodedImage[];\n  /** Средний масштаб: текстуры изменчивости (свой размер), период, сила, средний цвет. */\n  middle?: DecodedImage[];\n  midPeriod?: number[];\n  midBlend?: number[];\n  midMean?: Array<[number, number, number]>;\n  /** Имена (для сведений). */\n  names?: string[];\n}\n\n/** Запечённое освещение уровня (одна карта на модель): яркость в R, UV — Mesh.uv2. */\nexport interface Lightmap {\n  width: number;\n  height: number;\n  /** Яркость, 1 байт на пиксель (или RGB, 3 байта, при rgb). */\n  data: Uint8Array;\n  /** Цветная карта (Source): RGB8. */\n  rgb?: boolean;\n  /** Множитель яркости при показе. */\n  scale?: number;\n  /**\n   * Карты освещения по трём направлениям базиса рельефа Source (bump lightmaps), тот же формат и раскладка, что data:\n   * свет смешивается по нормали из карты нормалей. У граней без рельефа — копия data.\n   */\n  bump?: [Uint8Array, Uint8Array, Uint8Array];\n}\n\n/** Ключи анимации assimp-стиля: [время, значение]. */\nexport type Keys<T> = Array<[number, T]>;\nexport interface NodeChannel {\n  pos: Keys<number[]> | null;\n  rot: Keys<number[]> | null;\n  scl: Keys<number[]> | null;\n  /** Аддитивная дорожка как смещение (перенос + поворот [w,x,y,z]) — применяется так, когда анимация — слой поверх другой. */\n  add?: { pos: Keys<number[]> | null; rot: Keys<number[]> | null };\n}\n\n/** Слой поверх основной анимации узлов: аддитивные каналы складываются, остальные заменяют позу (в пределах маски). */\nexport interface NodeLayer {\n  motion: NodeMotion;\n  /** Постоянный кадр слоя (поза прицеливания — средний кадр сетки направлений); нет — играет по времени. */\n  frame?: number;\n  /** Номера узлов, которые слой может менять; нет — все. */\n  mask?: ReadonlySet<number>;\n  /** Только дополнять: узлы, у которых есть канал в основной анимации, слой не трогает (хват оружия у NPC — свой). */\n  fill?: boolean;\n  /**\n   * Слой — сетка поз (кадр = строка·cols + столбец), например направления прицела: x — столбец, y — строка\n   * (дробные: смешиваются 4 соседних кадра). Перекрывает frame.\n   */\n  grid?: { cols: number; rows: number; x: number; y: number };\n}\n\nexport interface MotionBase {\n  name: string;\n  /** Длительность, сек. */\n  duration: number;\n  /** Число кадров (для подписи в списке). */\n  frames?: number;\n  /** Откуда анимация: 'model' или имя файла. */\n  source?: string;\n  /** Анимация из длинного списка (Metro: тысячи файлов): данные читаются при выборе. */\n  load?(): Promise<Motion>;\n}\n/** Анимация узлов (assimp, NIF, MD5, PSA, Cast, GoldSrc). */\nexport interface NodeMotion extends MotionBase {\n  kind: 'node';\n  tps: number;\n  chan: Map<number, NodeChannel>;\n  /** Слои поверх (прицеливание, дыхание). */\n  layers?: NodeLayer[];\n  /** Анимации, которые можно положить слоем (для выбора в интерфейсе; могут загружаться при выборе). */\n  layerPool?: NodeMotion[];\n  /** Имена из layerPool, подобранные слоем по умолчанию. */\n  layerAuto?: string[];\n  /**\n   * Смешивание анимаций по параметрам (последовательности Source: направление движения): сетка cols×rows анимаций\n   * (индекс — строка·cols + столбец), x/y — дробное положение; фаза общая — анимации разной длины идут в такт.\n   */\n  blend?: NodeBlend;\n  /** Как класть эту анимацию слоем (кадр, маска) — задаёт движок. */\n  asLayer?: (m: NodeMotion) => Omit<NodeLayer, 'motion'>;\n}\nexport interface NodeBlend {\n  motions: NodeMotion[];\n  cols: number;\n  rows: number;\n  x: number;\n  y: number;\n  /** Параметры по осям (для подписи ползунка): имя и значения на краях сетки. */\n  params?: Array<{ name: string; start: number; end: number }>;\n}\n/** Покадровая вершинная анимация (MD2/MD3/MDL). */\nexport interface VertexMotion extends MotionBase {\n  kind: 'vertex';\n  start: number;\n  count: number;\n  fps: number;\n}\n/**\n * Виды анимаций по полю kind. Движок добавляет свой вид расширением интерфейса, например\n * `declare module '@gmvjs/core/types' { interface MotionKinds { xray: XrayMotion } }` — и сужение по `m.kind` продолжает работать.\n */\nexport interface MotionKinds { node: NodeMotion; vertex: VertexMotion }\nexport type Motion = MotionKinds[keyof MotionKinds];\n\n/** Скелет, который умеет считать позу. Матрицы — column-major Float32, 16 на кость. */\nexport interface SkeletonRuntime {\n  readonly n: number;\n  readonly parent: number[];\n  readonly skin: Float32Array;\n  readonly worldV: Float32Array[];\n  readonly skinV: Float32Array[];\n  pose(motion: Motion | null, time: number, loop: boolean, invert?: boolean): void;\n}\n\n/** Сцена из повторяющихся моделей (объекты уровня): для экспорта ссылками вместо слитой геометрии. */\nexport interface InstancedScene {\n  /** Номера мешей модели, собранных из экземпляров (при экспорте заменяются ссылками). */\n  meshes: number[];\n  /** Прототипы: части с номером меша модели, по которому берутся текстура и материал. */\n  protos: Array<{ name: string; parts: Array<{ mesh: number; pos: Float32Array; nor: Float32Array; uv: Float32Array; indices: Uint32Array }> }>;\n  /** Поза — матрица 4×4 по строкам (вектор-строка × M, перенос в последней строке), в координатах модели. */\n  placements: InstancePlacement[];\n}\n\n/** Где лежит часть экземпляра в слитом меше: номер меша, вершины и индексы. */\nexport interface PlacementRange { mesh: number; part: number; vStart: number; vCount: number; iStart: number; iCount: number }\n\nexport interface InstancePlacement {\n  proto: number;\n  name: string;\n  pose: number[];\n  /** Группа в слоях сцены (класс объекта: STATICPROP, O_ENTITY…). */\n  group?: string;\n  /** Скрыт пользователем: не рисуется и не выгружается. */\n  hidden?: boolean;\n  /** Части в слитых мешах (для скрытия, подсветки, выбора и поворота). */\n  ranges?: PlacementRange[];\n}\n\n/** Выбор для пересборки модели: id, подпись, варианты и текущее значение. */\nexport interface ModelOption { id: string; label: string; values: Array<{ id: string; label: string }>; value: string }\n\nexport interface Model {\n  meshes: Mesh[];\n  /** Экземпляры моделей внутри сцены (Metro level.bin). */\n  instances?: InstancedScene;\n  /** Карта освещения уровня (Metro level.lmap_pc). */\n  lightmap?: Lightmap;\n  /** Слои поверхности ландшафта (Mesh.terrainIndex). */\n  terrainLayers?: TerrainLayers;\n  skeleton: SkeletonRuntime | null;\n  motions: Motion[];\n  bounds: Bounds;\n  /** Левосторонняя система (X-Ray): отразить Z при показе. */\n  flipZ?: boolean;\n  defaultZUp?: boolean;\n  cameraYaw?: number;\n  /** Строки для панели «Сведения». */\n  info: string[];\n  /** Вершинная анимация: обновить pos/nor мешей на время t. */\n  animate?(motion: Motion | null, t: number, loop: boolean): void;\n  /** Подбор знака кватернионов для анимации. */\n  detectInvert?(motion: Motion): boolean;\n  /** Загрузка внешних анимаций (.omf/.psa/.md5anim/.cast). */\n  loadMotions?(file: VFile): Promise<Motion[]>;\n  /** Произвольные данные для резолверов текстур (имя .mtl и т. п.). */\n  meta?: Record<string, unknown>;\n  /**\n   * Настройки вида, которые формат умеет пересобрать (диски, винил, цвет окраски NFS World): список выборов с текущим\n   * значением. Смена значения — повторная загрузка с LoadContext.options (камера сохраняется).\n   */\n  options?: ModelOption[];\n  /** Направление зелёного канала карт нормалей игры: 'dx' (Y вниз, Direct3D — по умолчанию) или 'gl' (Y вверх). */\n  normalY?: 'gl' | 'dx';\n}\n\n/** Ошибка «файл содержит только анимацию» — сессия попробует добавить его как анимацию. */\nexport class MotionOnlyError extends Error {\n  readonly motionOnly = true;\n}\n"],"names":[],"mappings":"AAuVO,MAAM,wBAAwB,MAAM;AAAA,EAChC,aAAa;AACxB;"}
+{"version":3,"file":"types.js","sources":["../src/types.ts"],"sourcesContent":["// Public types of the gmv core. The core does not depend on the DOM: it runs in a page, in a Worker and in Node (tests).\n\nexport type Vec3 = [number, number, number];\nexport type Quat = [number, number, number, number]; // [w, x, y, z]\n\nexport interface Bounds {\n  min: number[];\n  max: number[];\n}\n\n/** Decoded texture: either RGBA pixels or an ImageBitmap (PNG/JPG via the browser). */\nexport interface DecodedImage {\n  width: number;\n  height: number;\n  rgba?: Uint8Array;\n  bitmap?: ImageBitmap;\n  name?: string;\n}\n\n/** A byte source that can be opened as an archive (File in the browser, a named Blob in Node). */\nexport type BlobFile = Blob & { readonly name: string; readonly webkitRelativePath?: string };\n\n/** File-like object: a regular File, an archive entry or an already decoded texture. */\nexport interface VFile {\n  readonly name: string;\n  /** Path inside an archive / folder (lower case, \"/\"). */\n  readonly path?: string;\n  readonly archive?: Archive;\n  readonly webkitRelativePath?: string;\n  arrayBuffer(): Promise<ArrayBuffer>;\n  /** If set, this is an already decoded image (for example from a TXD). */\n  readonly decoded?: DecodedImage;\n}\n\nexport interface ArchiveEntry {\n  path: string;\n  size?: number;\n}\n\nexport interface Archive {\n  readonly name: string;\n  /** Archive plugin id: 'zip', 'bsa', 'folder'… */\n  readonly kind: string;\n  readonly version: number;\n  readonly entries: ArchiveEntry[];\n  /** Full path -> entry. */\n  readonly index: Map<string, ArchiveEntry>;\n  /** Path without extension -> texture entry. */\n  readonly byKey: Map<string, ArchiveEntry>;\n  /** File name -> entry (for the \"Game folder\"). */\n  readonly byBase?: Map<string, ArchiveEntry>;\n  lookup(path: string): ArchiveEntry | null;\n  read(entry: ArchiveEntry): Promise<Uint8Array>;\n  fileOf(entry: ArchiveEntry): VFile;\n  /** Source file of the entry (\"Game folder\" only): to open an archive lying in the folder. */\n  blobOf?(entry: ArchiveEntry): BlobFile | null;\n  /** Texture at the exact path from the model, even if it is not in the list (archives with hashed names: Far Cry 2). */\n  findTexture?(path: string): ArchiveEntry | null;\n}\n\n/** Map channel: path/file name and channel number (0 R, 1 G, 2 B, 3 A). */\nexport interface ChannelRef { map: string; channel: 0 | 1 | 2 | 3; image?: DecodedImage }\n/**\n * PBR surface. The metal/rough scheme (glTF, BeamNG, SnowRunner) or spec/gloss (Arma _smdi, MudRunner __s_d):\n * gloss = 1 − roughness, specular is the non-metal specular strength.\n */\nexport interface SurfaceInfo {\n  roughness?: ChannelRef;\n  gloss?: ChannelRef;\n  metallic?: ChannelRef;\n  ao?: ChannelRef;\n  specular?: ChannelRef;\n  roughnessFactor?: number;\n  metallicFactor?: number;\n  /** Specular strength without a map (0..1; 0.5 ≈ F0 0.04). */\n  specularFactor?: number;\n  /** Where it came from (for the label): \"BeamNG\", \"Arma _smdi\"… */\n  source?: string;\n}\n\nexport interface Mesh {\n  name: string;\n  /** Texture/material name as written in the model. */\n  texture: string;\n  shader?: string;\n  /** Material name (assimp/HPL). */\n  material?: string;\n  vertexCount: number;\n  pos: Float32Array;\n  nor: Float32Array;\n  uv: Float32Array;\n  /** 4 bone indices per vertex (float, for WebGL attributes). */\n  bone: Float32Array;\n  weight: Float32Array;\n  indices: Uint16Array | Uint32Array;\n  skinned: boolean;\n  /** Color without a texture (RenderWare). */\n  color?: number[];\n  /** Embedded texture (Quake MDL, GoldSrc). */\n  image?: DecodedImage;\n  /** Per-frame vertex animation: pos/nor change in place. */\n  dynamic?: boolean;\n  frames?: { pos: Float32Array[]; nor: Float32Array[] };\n  /** Candidate material paths (Source .vmt). */\n  materialPaths?: string[];\n  /** Submaterial number (CryEngine). */\n  matId?: number;\n  /** Normal map as written in the model or material (path/name); empty means it is looked up from the diffuse name. */\n  normalMap?: string;\n  /** Embedded normal map. */\n  normalImage?: DecodedImage;\n  /** PBR surface: roughness, metalness, AO, specular (maps and multipliers). */\n  surface?: SurfaceInfo;\n  /** Alpha-tested transparency from the texture alpha (grates, foliage, decals), independent of the global toggle. */\n  alphaTest?: boolean;\n  /** Helper geometry (light planes, render-target screens): hidden by default. */\n  defaultHidden?: boolean;\n  /** Second UV set: coordinates in the lightmap (Model.lightmap). */\n  uv2?: Float32Array;\n  /** Per-vertex opacity (0..1): a terrain layer over the base, drawn after opaque meshes with blending. */\n  vertexAlpha?: Float32Array;\n  /** Baked per-vertex lighting: RGB(A) bytes, 128 = unchanged (×2 multiplication, as in Black Box). */\n  vertexShade?: Uint8Array;\n  /**\n   * Terrain layer map (a Model.terrainLayers layer number per texel, over the mesh UV 0..1): up close, instead of a single color\n   * map (image), repeating layer textures tinted by it are drawn.\n   */\n  terrainIndex?: { width: number; height: number; data: Uint8Array };\n  /** Screen-space reflection and refraction (water, Source refracting glass): drawn after the scene from its snapshot. */\n  screenFx?: ScreenFx;\n}\n\n/** Screen surface parameters: water (planar reflection, refraction, depth fog) or glass (refraction). */\nexport interface ScreenFx {\n  kind: 'water' | 'glass';\n  /** Surface plane in model coordinates: n·p = d (for water reflection). */\n  plane?: [number, number, number, number];\n  /** Refraction color (what is under water / behind glass) and reflection color (for glass, the $envmaptint environment highlight), 0..1. */\n  refractTint: number[];\n  reflectTint?: number[];\n  /** Distortion strength from the normal map: a fraction of the screen. */\n  refract: number;\n  reflect?: number;\n  /** Underwater fog: color 0..1, start and end in model units. */\n  fog?: { color: number[]; start: number; end: number };\n  /** Normal map scrolling over time (UV/sec). */\n  scroll?: [number, number];\n  /** Without support: color and opacity of a translucent layer. */\n  fallback: { color: number[]; opacity: number };\n}\n\n/** Terrain surface layers: textures of one size and display parameters. */\nexport interface TerrainLayers {\n  /** Layer textures (one size, power of two). */\n  images: DecodedImage[];\n  /** Texture repeat period in model units (along the mesh X and Z coordinates). */\n  period: number[];\n  /** 0..1: how much the layer is tinted by the mesh color map. */\n  tint: number[];\n  /** Average color of the layer texture (0..1), for tinting. */\n  mean: Array<[number, number, number]>;\n  /** Distance at which layers fade into the color map. */\n  fade: number;\n  /** Layer normals (same size as images): RG = XY of the tangent normal (DirectX), A = AO. */\n  normals?: DecodedImage[];\n  /** Medium scale: variation textures (own size), period, strength, average color. */\n  middle?: DecodedImage[];\n  midPeriod?: number[];\n  midBlend?: number[];\n  midMean?: Array<[number, number, number]>;\n  /** Names (for details). */\n  names?: string[];\n}\n\n/** Baked level lighting (one map per model): brightness in R, UV is Mesh.uv2. */\nexport interface Lightmap {\n  width: number;\n  height: number;\n  /** Brightness, 1 byte per pixel (or RGB, 3 bytes, with rgb). */\n  data: Uint8Array;\n  /** Color map (Source): RGB8. */\n  rgb?: boolean;\n  /** Brightness multiplier for display. */\n  scale?: number;\n  /**\n   * Lightmaps for the three directions of the Source bump basis (bump lightmaps), same format and layout as data:\n   * light is blended by the normal from the normal map. Faces without bump get a copy of data.\n   */\n  bump?: [Uint8Array, Uint8Array, Uint8Array];\n}\n\n/** assimp-style animation keys: [time, value]. */\nexport type Keys<T> = Array<[number, T]>;\nexport interface NodeChannel {\n  pos: Keys<number[]> | null;\n  rot: Keys<number[]> | null;\n  scl: Keys<number[]> | null;\n  /** Additive track as an offset (translation + rotation [w,x,y,z]): applied this way when the animation is a layer over another. */\n  add?: { pos: Keys<number[]> | null; rot: Keys<number[]> | null };\n}\n\n/** Layer over the main node animation: additive channels are added, others replace the pose (within the mask). */\nexport interface NodeLayer {\n  motion: NodeMotion;\n  /** Fixed frame of the layer (aim pose: the middle frame of the direction grid); none means it plays over time. */\n  frame?: number;\n  /** Node numbers the layer may change; none means all. */\n  mask?: ReadonlySet<number>;\n  /** Only complement: the layer does not touch nodes that have a channel in the main animation (NPC weapon grip is its own). */\n  fill?: boolean;\n  /**\n   * The layer is a pose grid (frame = row·cols + column), for example aim directions: x is the column, y the row\n   * (fractional: 4 neighbouring frames are blended). Overrides frame.\n   */\n  grid?: { cols: number; rows: number; x: number; y: number };\n}\n\nexport interface MotionBase {\n  name: string;\n  /** Duration, seconds. */\n  duration: number;\n  /** Frame count (for the list label). */\n  frames?: number;\n  /** Where the animation comes from: 'model' or a file name. */\n  source?: string;\n  /** Animation from a long list (Metro: thousands of files): data is read on selection. */\n  load?(): Promise<Motion>;\n}\n/** Node animation (assimp, NIF, MD5, PSA, Cast, GoldSrc). */\nexport interface NodeMotion extends MotionBase {\n  kind: 'node';\n  tps: number;\n  chan: Map<number, NodeChannel>;\n  /** Layers on top (aiming, breathing). */\n  layers?: NodeLayer[];\n  /** Animations that can be used as a layer (for selection in the UI; may be loaded on selection). */\n  layerPool?: NodeMotion[];\n  /** Names from layerPool picked as the default layer. */\n  layerAuto?: string[];\n  /**\n   * Parametric animation blending (Source sequences: movement direction): a cols×rows grid of animations\n   * (index = row·cols + column), x/y are fractional positions; the phase is shared, so animations of different length stay in step.\n   */\n  blend?: NodeBlend;\n  /** How to apply this animation as a layer (frame, mask): set by the engine. */\n  asLayer?: (m: NodeMotion) => Omit<NodeLayer, 'motion'>;\n}\nexport interface NodeBlend {\n  motions: NodeMotion[];\n  cols: number;\n  rows: number;\n  x: number;\n  y: number;\n  /** Axis parameters (for the slider label): name and values at the grid edges. */\n  params?: Array<{ name: string; start: number; end: number }>;\n}\n/** Per-frame vertex animation (MD2/MD3/MDL). */\nexport interface VertexMotion extends MotionBase {\n  kind: 'vertex';\n  start: number;\n  count: number;\n  fps: number;\n}\n/**\n * Animation kinds by the kind field. An engine adds its own kind by extending the interface, for example\n * `declare module '@gmvjs/core/types' { interface MotionKinds { xray: XrayMotion } }`, and narrowing by `m.kind` keeps working.\n */\nexport interface MotionKinds { node: NodeMotion; vertex: VertexMotion }\nexport type Motion = MotionKinds[keyof MotionKinds];\n\n/** A skeleton that can compute a pose. Matrices are column-major Float32, 16 per bone. */\nexport interface SkeletonRuntime {\n  readonly n: number;\n  readonly parent: number[];\n  readonly skin: Float32Array;\n  readonly worldV: Float32Array[];\n  readonly skinV: Float32Array[];\n  pose(motion: Motion | null, time: number, loop: boolean, invert?: boolean): void;\n}\n\n/** Scene of repeated models (level objects): for exporting as references instead of merged geometry. */\nexport interface InstancedScene {\n  /** Numbers of model meshes built from instances (replaced by references on export). */\n  meshes: number[];\n  /** Prototypes: parts with the model mesh number used for texture and material. */\n  protos: Array<{ name: string; parts: Array<{ mesh: number; pos: Float32Array; nor: Float32Array; uv: Float32Array; indices: Uint32Array }> }>;\n  /** Pose: 4×4 matrix by rows (row vector × M, translation in the last row), in model coordinates. */\n  placements: InstancePlacement[];\n}\n\n/** Where an instance part lives in the merged mesh: mesh number, vertices and indices. */\nexport interface PlacementRange { mesh: number; part: number; vStart: number; vCount: number; iStart: number; iCount: number }\n\nexport interface InstancePlacement {\n  proto: number;\n  name: string;\n  pose: number[];\n  /** Group in the scene layers (object class: STATICPROP, O_ENTITY…). */\n  group?: string;\n  /** Hidden by the user: not drawn and not exported. */\n  hidden?: boolean;\n  /** Parts in merged meshes (for hiding, highlighting, picking and rotation). */\n  ranges?: PlacementRange[];\n}\n\n/** A choice for rebuilding the model: id, label, options and current value. */\nexport interface ModelOption { id: string; label: string; values: Array<{ id: string; label: string }>; value: string }\n\nexport interface Model {\n  meshes: Mesh[];\n  /** Model instances inside the scene (Metro level.bin). */\n  instances?: InstancedScene;\n  /** Level lightmap (Metro level.lmap_pc). */\n  lightmap?: Lightmap;\n  /** Terrain surface layers (Mesh.terrainIndex). */\n  terrainLayers?: TerrainLayers;\n  skeleton: SkeletonRuntime | null;\n  motions: Motion[];\n  bounds: Bounds;\n  /** Left-handed system (X-Ray): mirror Z for display. */\n  flipZ?: boolean;\n  defaultZUp?: boolean;\n  cameraYaw?: number;\n  /** Lines for the \"Details\" panel. */\n  info: string[];\n  /** Vertex animation: update mesh pos/nor for time t. */\n  animate?(motion: Motion | null, t: number, loop: boolean): void;\n  /** Quaternion sign fitting for the animation. */\n  detectInvert?(motion: Motion): boolean;\n  /** Loading external animations (.omf/.psa/.md5anim/.cast). */\n  loadMotions?(file: VFile): Promise<Motion[]>;\n  /** Arbitrary data for texture resolvers (.mtl name and the like). */\n  meta?: Record<string, unknown>;\n  /**\n   * View settings the format can rebuild (wheels, vinyl, NFS World paint color): a list of choices with their current\n   * value. Changing a value reloads with LoadContext.options (the camera is kept).\n   */\n  options?: ModelOption[];\n  /** Green channel direction of the game's normal maps: 'dx' (Y down, Direct3D, the default) or 'gl' (Y up). */\n  normalY?: 'gl' | 'dx';\n}\n\n/** \"The file contains only an animation\" error: the session will try to add it as an animation. */\nexport class MotionOnlyError extends Error {\n  readonly motionOnly = true;\n}\n"],"names":[],"mappings":"AAuVO,MAAM,wBAAwB,MAAM;AAAA,EAChC,aAAa;AACxB;"}

package/dist/writers/dds.d.ts

@@ -4,5 +4,5 @@ export declare function encodeDdsRgba(img: {
     height: number;
     rgba: Uint8Array;
 }, mips?: boolean): Uint8Array;
-/** Есть ли в картинке полупрозрачные пиксели. */
+/** Whether the image has semi-transparent pixels. */
 export declare function hasAlpha(img: DecodedImage): boolean;

package/dist/writers/dds.js.map

@@ -1 +1 @@
-{"version":3,"file":"dds.js","sources":["../../src/writers/dds.ts"],"sourcesContent":["// DDS без сжатия (A8R8G8B8) с цепочкой mip-уровней (усреднение 2×2). Читается DirectX, движками и редакторами.\nimport type { DecodedImage } from '../types';\n\nexport function encodeDdsRgba(img: { width: number; height: number; rgba: Uint8Array }, mips = true): Uint8Array {\n  const levels: Array<{ w: number; h: number; px: Uint8Array }> = [{ w: img.width, h: img.height, px: img.rgba }];\n  while (mips) {\n    const { w, h, px } = levels[levels.length - 1]!;\n    if (w === 1 && h === 1) break;\n    const nw = Math.max(1, w >> 1), nh = Math.max(1, h >> 1), out = new Uint8Array(nw * nh * 4);\n    for (let y = 0; y < nh; y++) for (let x = 0; x < nw; x++) for (let c = 0; c < 4; c++) {\n      let s = 0, n = 0;\n      for (const [dx, dy] of [[0, 0], [1, 0], [0, 1], [1, 1]]) { const sx = Math.min(w - 1, x * 2 + dx!), sy = Math.min(h - 1, y * 2 + dy!); s += px[(sy * w + sx) * 4 + c]!; n++; }\n      out[(y * nw + x) * 4 + c] = Math.round(s / n);\n    }\n    levels.push({ w: nw, h: nh, px: out });\n  }\n  const size = levels.reduce((a, l) => a + l.w * l.h * 4, 0), u = new Uint8Array(128 + size), dv = new DataView(u.buffer);\n  dv.setUint32(0, 0x20534444, true); dv.setUint32(4, 124, true);\n  dv.setUint32(8, 0x1 | 0x2 | 0x4 | 0x1000 | 0x8 | (levels.length > 1 ? 0x20000 : 0), true); // CAPS|HEIGHT|WIDTH|PIXELFORMAT|PITCH|MIPMAPCOUNT\n  dv.setUint32(12, img.height, true); dv.setUint32(16, img.width, true); dv.setUint32(20, img.width * 4, true);\n  dv.setUint32(28, levels.length, true);\n  dv.setUint32(76, 32, true); dv.setUint32(80, 0x41, true); dv.setUint32(88, 32, true); // RGB | ALPHAPIXELS, 32 бита\n  dv.setUint32(92, 0x00ff0000, true); dv.setUint32(96, 0x0000ff00, true); dv.setUint32(100, 0x000000ff, true); dv.setUint32(104, 0xff000000, true);\n  dv.setUint32(108, 0x1000 | (levels.length > 1 ? 0x400008 : 0), true); // TEXTURE | MIPMAP | COMPLEX\n  let p = 128;\n  for (const l of levels) for (let i = 0; i < l.w * l.h; i++) { u[p++] = l.px[i * 4 + 2]!; u[p++] = l.px[i * 4 + 1]!; u[p++] = l.px[i * 4]!; u[p++] = l.px[i * 4 + 3]!; }\n  return u;\n}\n\n/** Есть ли в картинке полупрозрачные пиксели. */\nexport function hasAlpha(img: DecodedImage): boolean {\n  const d = img.rgba;\n  if (!d) return false;\n  for (let i = 3; i < d.length; i += 16) if (d[i]! < 250) return true;\n  return false;\n}\n"],"names":[],"mappings":"AAGO,SAAS,cAAc,KAA0D,OAAO,MAAkB;AAC/G,QAAM,SAA0D,CAAC,EAAE,GAAG,IAAI,OAAO,GAAG,IAAI,QAAQ,IAAI,IAAI,KAAA,CAAM;AAC9G,SAAO,MAAM;AACX,UAAM,EAAE,GAAG,GAAG,GAAA,IAAO,OAAO,OAAO,SAAS,CAAC;AAC7C,QAAI,MAAM,KAAK,MAAM,EAAG;AACxB,UAAM,KAAK,KAAK,IAAI,GAAG,KAAK,CAAC,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,CAAC,GAAG,MAAM,IAAI,WAAW,KAAK,KAAK,CAAC;AAC1F,aAAS,IAAI,GAAG,IAAI,IAAI,cAAc,IAAI,GAAG,IAAI,IAAI,IAAK,UAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AACpF,UAAI,IAAI,GAAG,IAAI;AACf,iBAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG;AAAE,cAAM,KAAK,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,EAAG,GAAG,KAAK,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,EAAG;AAAG,aAAK,IAAI,KAAK,IAAI,MAAM,IAAI,CAAC;AAAI;AAAA,MAAK;AAC7K,WAAK,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC;AAAA,IAC9C;AACA,WAAO,KAAK,EAAE,GAAG,IAAI,GAAG,IAAI,IAAI,KAAK;AAAA,EACvC;AACA,QAAM,OAAO,OAAO,OAAO,CAAC,GAAG,MAAM,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,GAAG,IAAI,IAAI,WAAW,MAAM,IAAI,GAAG,KAAK,IAAI,SAAS,EAAE,MAAM;AACtH,KAAG,UAAU,GAAG,WAAY,IAAI;AAAG,KAAG,UAAU,GAAG,KAAK,IAAI;AAC5D,KAAG,UAAU,GAAG,IAAM,IAAM,IAAM,OAAS,KAAO,OAAO,SAAS,IAAI,SAAU,IAAI,IAAI;AACxF,KAAG,UAAU,IAAI,IAAI,QAAQ,IAAI;AAAG,KAAG,UAAU,IAAI,IAAI,OAAO,IAAI;AAAG,KAAG,UAAU,IAAI,IAAI,QAAQ,GAAG,IAAI;AAC3G,KAAG,UAAU,IAAI,OAAO,QAAQ,IAAI;AACpC,KAAG,UAAU,IAAI,IAAI,IAAI;AAAG,KAAG,UAAU,IAAI,IAAM,IAAI;AAAG,KAAG,UAAU,IAAI,IAAI,IAAI;AACnF,KAAG,UAAU,IAAI,UAAY,IAAI;AAAG,KAAG,UAAU,IAAI,OAAY,IAAI;AAAG,KAAG,UAAU,KAAK,KAAY,IAAI;AAAG,KAAG,UAAU,KAAK,YAAY,IAAI;AAC/I,KAAG,UAAU,KAAK,QAAU,OAAO,SAAS,IAAI,UAAW,IAAI,IAAI;AACnE,MAAI,IAAI;AACR,aAAW,KAAK,OAAQ,UAAS,IAAI,GAAG,IAAI,EAAE,IAAI,EAAE,GAAG,KAAK;AAAE,MAAE,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC;AAAI,MAAE,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC;AAAI,MAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;AAAI,MAAE,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC;AAAA,EAAI;AACtK,SAAO;AACT;AAGO,SAAS,SAAS,KAA4B;AACnD,QAAM,IAAI,IAAI;AACd,MAAI,CAAC,EAAG,QAAO;AACf,WAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK,GAAI,KAAI,EAAE,CAAC,IAAK,IAAK,QAAO;AAC/D,SAAO;AACT;"}
+{"version":3,"file":"dds.js","sources":["../../src/writers/dds.ts"],"sourcesContent":["// Uncompressed DDS (A8R8G8B8) with a mip chain (2×2 averaging). Readable by DirectX, engines and editors.\nimport type { DecodedImage } from '../types';\n\nexport function encodeDdsRgba(img: { width: number; height: number; rgba: Uint8Array }, mips = true): Uint8Array {\n  const levels: Array<{ w: number; h: number; px: Uint8Array }> = [{ w: img.width, h: img.height, px: img.rgba }];\n  while (mips) {\n    const { w, h, px } = levels[levels.length - 1]!;\n    if (w === 1 && h === 1) break;\n    const nw = Math.max(1, w >> 1), nh = Math.max(1, h >> 1), out = new Uint8Array(nw * nh * 4);\n    for (let y = 0; y < nh; y++) for (let x = 0; x < nw; x++) for (let c = 0; c < 4; c++) {\n      let s = 0, n = 0;\n      for (const [dx, dy] of [[0, 0], [1, 0], [0, 1], [1, 1]]) { const sx = Math.min(w - 1, x * 2 + dx!), sy = Math.min(h - 1, y * 2 + dy!); s += px[(sy * w + sx) * 4 + c]!; n++; }\n      out[(y * nw + x) * 4 + c] = Math.round(s / n);\n    }\n    levels.push({ w: nw, h: nh, px: out });\n  }\n  const size = levels.reduce((a, l) => a + l.w * l.h * 4, 0), u = new Uint8Array(128 + size), dv = new DataView(u.buffer);\n  dv.setUint32(0, 0x20534444, true); dv.setUint32(4, 124, true);\n  dv.setUint32(8, 0x1 | 0x2 | 0x4 | 0x1000 | 0x8 | (levels.length > 1 ? 0x20000 : 0), true); // CAPS|HEIGHT|WIDTH|PIXELFORMAT|PITCH|MIPMAPCOUNT\n  dv.setUint32(12, img.height, true); dv.setUint32(16, img.width, true); dv.setUint32(20, img.width * 4, true);\n  dv.setUint32(28, levels.length, true);\n  dv.setUint32(76, 32, true); dv.setUint32(80, 0x41, true); dv.setUint32(88, 32, true); // RGB | ALPHAPIXELS, 32 bits\n  dv.setUint32(92, 0x00ff0000, true); dv.setUint32(96, 0x0000ff00, true); dv.setUint32(100, 0x000000ff, true); dv.setUint32(104, 0xff000000, true);\n  dv.setUint32(108, 0x1000 | (levels.length > 1 ? 0x400008 : 0), true); // TEXTURE | MIPMAP | COMPLEX\n  let p = 128;\n  for (const l of levels) for (let i = 0; i < l.w * l.h; i++) { u[p++] = l.px[i * 4 + 2]!; u[p++] = l.px[i * 4 + 1]!; u[p++] = l.px[i * 4]!; u[p++] = l.px[i * 4 + 3]!; }\n  return u;\n}\n\n/** Whether the image has semi-transparent pixels. */\nexport function hasAlpha(img: DecodedImage): boolean {\n  const d = img.rgba;\n  if (!d) return false;\n  for (let i = 3; i < d.length; i += 16) if (d[i]! < 250) return true;\n  return false;\n}\n"],"names":[],"mappings":"AAGO,SAAS,cAAc,KAA0D,OAAO,MAAkB;AAC/G,QAAM,SAA0D,CAAC,EAAE,GAAG,IAAI,OAAO,GAAG,IAAI,QAAQ,IAAI,IAAI,KAAA,CAAM;AAC9G,SAAO,MAAM;AACX,UAAM,EAAE,GAAG,GAAG,GAAA,IAAO,OAAO,OAAO,SAAS,CAAC;AAC7C,QAAI,MAAM,KAAK,MAAM,EAAG;AACxB,UAAM,KAAK,KAAK,IAAI,GAAG,KAAK,CAAC,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,CAAC,GAAG,MAAM,IAAI,WAAW,KAAK,KAAK,CAAC;AAC1F,aAAS,IAAI,GAAG,IAAI,IAAI,cAAc,IAAI,GAAG,IAAI,IAAI,IAAK,UAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AACpF,UAAI,IAAI,GAAG,IAAI;AACf,iBAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG;AAAE,cAAM,KAAK,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,EAAG,GAAG,KAAK,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,EAAG;AAAG,aAAK,IAAI,KAAK,IAAI,MAAM,IAAI,CAAC;AAAI;AAAA,MAAK;AAC7K,WAAK,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC;AAAA,IAC9C;AACA,WAAO,KAAK,EAAE,GAAG,IAAI,GAAG,IAAI,IAAI,KAAK;AAAA,EACvC;AACA,QAAM,OAAO,OAAO,OAAO,CAAC,GAAG,MAAM,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,GAAG,IAAI,IAAI,WAAW,MAAM,IAAI,GAAG,KAAK,IAAI,SAAS,EAAE,MAAM;AACtH,KAAG,UAAU,GAAG,WAAY,IAAI;AAAG,KAAG,UAAU,GAAG,KAAK,IAAI;AAC5D,KAAG,UAAU,GAAG,IAAM,IAAM,IAAM,OAAS,KAAO,OAAO,SAAS,IAAI,SAAU,IAAI,IAAI;AACxF,KAAG,UAAU,IAAI,IAAI,QAAQ,IAAI;AAAG,KAAG,UAAU,IAAI,IAAI,OAAO,IAAI;AAAG,KAAG,UAAU,IAAI,IAAI,QAAQ,GAAG,IAAI;AAC3G,KAAG,UAAU,IAAI,OAAO,QAAQ,IAAI;AACpC,KAAG,UAAU,IAAI,IAAI,IAAI;AAAG,KAAG,UAAU,IAAI,IAAM,IAAI;AAAG,KAAG,UAAU,IAAI,IAAI,IAAI;AACnF,KAAG,UAAU,IAAI,UAAY,IAAI;AAAG,KAAG,UAAU,IAAI,OAAY,IAAI;AAAG,KAAG,UAAU,KAAK,KAAY,IAAI;AAAG,KAAG,UAAU,KAAK,YAAY,IAAI;AAC/I,KAAG,UAAU,KAAK,QAAU,OAAO,SAAS,IAAI,UAAW,IAAI,IAAI;AACnE,MAAI,IAAI;AACR,aAAW,KAAK,OAAQ,UAAS,IAAI,GAAG,IAAI,EAAE,IAAI,EAAE,GAAG,KAAK;AAAE,MAAE,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC;AAAI,MAAE,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC;AAAI,MAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;AAAI,MAAE,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC;AAAA,EAAI;AACtK,SAAO;AACT;AAGO,SAAS,SAAS,KAA4B;AACnD,QAAM,IAAI,IAAI;AACd,MAAI,CAAC,EAAG,QAAO;AACf,WAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK,GAAI,KAAI,EAAE,CAAC,IAAK,IAAK,QAAO;AAC/D,SAAO;AACT;"}