@gmvjs/core 0.1.0 → 0.1.1

package/dist/plugin.d.ts

@@ -1,17 +1,17 @@
 import type { Archive, BlobFile, DecodedImage, Mesh, Model, Motion, VFile } from './types';
 import type { TextureLibrary, TextureSource } from './textures';
-/** Степень готовности (для значка в интерфейсе). */
+/** Readiness level (for the badge in the UI). */
 export type SupportStatus = 'stable' | 'beta' | 'bridge';
 export interface LoadContext {
-    /** Все файлы, выбранные вместе с основным (.mtl, .bin, .vvd…). */
+    /** All files selected together with the main one (.mtl, .bin, .vvd…). */
     readonly files: readonly VFile[];
-    /** Открытые архивы и папки. */
+    /** Open archives and folders. */
     readonly archives: readonly Archive[];
-    /** Найти соседний файл: среди выбранных, затем в той же папке архива. */
+    /** Find a neighbouring file: among the selected ones, then in the same archive folder. */
     sibling(name: string): Promise<ArrayBuffer | null>;
-    /** Прочитать файл архива по полному пути (первый найденный). */
+    /** Read an archive file by full path (first match). */
     readPath(path: string): Promise<Uint8Array | null>;
-    /** Значения Model.options, выбранные пользователем (повторная загрузка с другими дисками, винилом…). */
+    /** Model.options values chosen by the user (reloading with other wheels, vinyl…). */
     readonly options?: Readonly<Record<string, string>>;
 }
 export interface AfterLoadContext {
@@ -22,34 +22,34 @@ export interface AfterLoadContext {
     addTextureDictionary(file: VFile): Promise<void>;
 }
 export interface FormatPlugin {
-    /** Уникальный id: '<движок>-<формат>', например 'xray-ogf'. */
+    /** Unique id: '<engine>-<format>', for example 'xray-ogf'. */
     id: string;
     title: string;
     engine: string;
-    /** Расширения без точки, нижний регистр. */
+    /** Extensions without the dot, lower case. */
     extensions: string[];
-    /** Файлы без расширения, которые открывает формат (по пути в архиве/папке), например «media/meshcache/…». */
+    /** Extensionless files the format opens (by path in an archive/folder), for example "media/meshcache/…". */
     pathPattern?: RegExp;
-    /** Расширения внешних анимаций, которые принимает модель этого формата. */
+    /** Extensions of external animations a model of this format accepts. */
     motionExtensions?: string[];
     status?: SupportStatus;
     /**
-     * Уверенность 0..1 по первым 256 байтам файла. 0 — точно не этот формат.
-     * Не задано — формат определяется только по расширению.
+     * Confidence 0..1 from the first 256 bytes of the file. 0 means definitely not this format.
+     * Not set: the format is detected by extension only.
      */
     sniff?(head: Uint8Array, name: string): number;
     load(main: VFile, ctx: LoadContext): Promise<Model>;
-    /** Поиск текстуры меша по правилам движка (материалы .vmt/.mtr/.mtl…). */
+    /** Find a mesh texture using the engine's rules (.vmt/.mtr/.mtl materials…). */
     resolveTexture?(mesh: Mesh, model: Model, lib: TextureLibrary): Promise<TextureSource | null>;
     /**
-     * Карты меша по правилам движка, если они не лежат отдельными файлами нормалей/PBR (Metro: «_bump» — высота и блик,
-     * нормали считаются из высоты). Возвращает готовые картинки.
+     * Mesh maps by the engine's rules when they are not separate normal/PBR files (Metro: "_bump" holds height and specular,
+     * normals are computed from height). Returns ready images.
      */
     resolveMaps?(mesh: Mesh, model: Model, lib: TextureLibrary): Promise<EngineMaps | null>;
-    /** Подгрузка сопутствующих файлов после загрузки (одноимённый .txd, анимации из папки…). */
+    /** Load companion files after loading (a same-named .txd, animations from the folder…). */
     afterLoad?(ctx: AfterLoadContext): Promise<void>;
 }
-/** Карты, собранные движком: нормали (касательное пространство, Y как в DirectX) и PBR-поверхность (R AO, G шероховатость, B металл, A блик). */
+/** Maps assembled by the engine: normals (tangent space, Y as in DirectX) and the PBR surface (R AO, G roughness, B metal, A specular). */
 export interface EngineMaps {
     normal?: {
         image: DecodedImage;
@@ -66,17 +66,17 @@ export interface ArchivePlugin {
     title: string;
     engine: string;
     extensions: string[];
-    /** Расширения файлов-спутников (.dir для IMG, части VPK), которые не открываются сами по себе. */
+    /** Extensions of companion files (.dir for IMG, VPK parts) that are not opened on their own. */
     companionExtensions?: string[];
-    /** Открывать такие архивы автоматически, когда выбрана «Папка игры» (F.E.A.R. Online: десятки *.arch01 рядом с Game/). */
+    /** Open such archives automatically when a "Game folder" is chosen (F.E.A.R. Online: dozens of *.arch01 next to Game/). */
     openFromFolder?: boolean | ((head: Uint8Array, name: string) => boolean);
     sniff?(head: Uint8Array, name: string): number;
-    /** null — файл является частью другого архива (например, *_001.vpk) и пропускается. */
+    /** null: the file is part of another archive (for example *_001.vpk) and is skipped. */
     open(file: BlobFile, siblings: readonly BlobFile[]): Promise<Archive | null>;
 }
 /**
- * Поиск текстуры по имени материала через файлы материалов движка (.mtr, .mat…), независимо от формата модели.
- * Срабатывает, когда собственный поиск формата ничего не нашёл: например, .lwo/.ase из Doom 3 через assimp + .mtr из pk4.
+ * Texture lookup by material name through the engine's material files (.mtr, .mat…), regardless of the model format.
+ * Used when the format's own lookup found nothing: for example .lwo/.ase from Doom 3 via assimp + .mtr from pk4.
  */
 export interface MaterialResolver {
     id: string;
@@ -93,49 +93,49 @@ export interface TextureDictionaryResult {
     }>;
     errors: string[];
 }
-/** Файл-словарь текстур (RenderWare .txd). */
+/** Texture dictionary file (RenderWare .txd). */
 export interface TextureDictionaryPlugin {
     id: string;
     extensions: string[];
     parse(buf: ArrayBuffer): TextureDictionaryResult | Promise<TextureDictionaryResult>;
 }
-/** Настройки интерфейса для пресета игры. */
+/** UI settings for a game preset. */
 export interface PresetUi {
-    /** Показать кнопку «Открыть архив…». */
+    /** Show the "Open archive…" button. */
     archives?: boolean;
     archiveExts?: string[];
     archiveLabel?: string;
-    /** Кнопка внешней анимации. */
+    /** External animation button. */
     motionLabel?: string;
-    /** Внешняя анимация имеет то же расширение, что и модель (.cast). */
+    /** The external animation has the same extension as the model (.cast). */
     motionAny?: boolean;
-    /** Переключатель «Z вверх». */
+    /** "Z up" toggle. */
     zUp?: boolean;
-    /** Переключатель «инвертировать вращение». */
+    /** "Invert rotation" toggle. */
     invertQuat?: boolean;
 }
 export interface GamePreset {
     id: string;
-    /** Группа в списке: «Игры», «Форматы (assimp)»… */
+    /** Group in the list: "Games", "Formats (assimp)"… */
     group: string;
     title: string;
     engine: string;
-    /** id форматов, которые открывает пресет. */
+    /** Ids of the formats the preset opens. */
     formats: string[];
-    /** Ограничить расширения моделей (по умолчанию — все расширения форматов). */
+    /** Restrict model extensions (default: all format extensions). */
     extensions?: string[];
     hint?: string;
     status?: SupportStatus;
     ui?: PresetUi;
-    /** Файлы-маркеры игры для автоопределения по папке. */
+    /** Game marker files for detection by folder. */
     markers?: string[];
 }
-/** Поле настроек экспорта (рисуется в окне экспорта). */
+/** Export settings field (drawn in the export dialog). */
 export interface ExportField {
     id: string;
     label: string;
     type: 'text' | 'number' | 'checkbox' | 'select';
-    /** Значение по умолчанию; функция — по модели и имени файла. */
+    /** Default value; a function receives the model and file name. */
     default?: string | number | boolean | ((model: Model, baseName: string) => string | number | boolean);
     placeholder?: string;
     hint?: string;
@@ -145,47 +145,47 @@ export interface ExportField {
     }>;
     min?: number;
     step?: number;
-    /** Показывать поле только для таких моделей (например, «объекты ссылками» — у сцен с экземплярами). */
+    /** Show the field only for such models (for example "objects as references" for scenes with instances). */
     when?(model: Model): boolean;
 }
 export type ExportValues = Record<string, string | number | boolean>;
-/** Текстура меша для писателя: исходный DDS (копируется как есть) или декодированная картинка. */
+/** Mesh texture for a writer: the source DDS (copied as is) or a decoded image. */
 export interface ExportTexture {
     name: string;
     dds?: Uint8Array;
     image?: DecodedImage | null;
 }
 export interface ExportContext {
-    /** Пресет и движок, из которых открыта модель. */
+    /** Preset and engine the model was opened from. */
     preset: GamePreset;
     sourceEngine: string;
-    /** Имя исходного файла без расширения. */
+    /** Source file name without extension. */
     baseName: string;
-    /** Скрытые пользователем меши. */
+    /** Meshes hidden by the user. */
     hidden: ReadonlySet<number>;
     texture(meshIndex: number): Promise<ExportTexture | null>;
 }
 export interface ExportResult {
     files: Map<string, Uint8Array>;
     report: string[];
-    /** Имя архива для скачивания (без .zip). */
+    /** Name of the archive to download (without .zip). */
     name: string;
 }
-/** Куда можно выгрузить загруженную модель: целевой движок/формат и его настройки. */
+/** Where a loaded model can be exported: the target engine/format and its settings. */
 export interface ExporterPlugin {
     id: string;
-    /** Короткое название («X-Ray SDK 0.7 (ЗП)»). */
+    /** Short name ("X-Ray SDK 0.7 (CoP)"). */
     title: string;
-    /** Что получится и как этим пользоваться. */
+    /** What you get and how to use it. */
     description: string;
-    /** Целевой движок (id) или формат («obj»). */
+    /** Target engine (id) or format ("obj"). */
     target: string;
     /**
-     * Движки-источники, для которых выгрузка предназначена; не задано — подходит любая модель.
-     * Совпадение с движком открытой модели поднимает вариант в начало списка.
+     * Source engines the export is intended for; not set: any model fits.
+     * A match with the open model's engine moves the option to the top of the list.
      */
     from?: string[];
-    /** Только из перечисленных движков (иначе вариант не показывается). */
+    /** Only from the listed engines (otherwise the option is not shown). */
     onlyFrom?: boolean;
     fields: ExportField[];
     accepts?(model: Model): boolean;
@@ -195,23 +195,23 @@ export interface EnginePlugin {
     id: string;
     title: string;
     formats?: FormatPlugin[];
-    /** Выгрузка в формат этого движка. */
+    /** Export to this engine's format. */
     exporters?: ExporterPlugin[];
     archives?: ArchivePlugin[];
     codecs?: ImageCodec[];
     dictionaries?: TextureDictionaryPlugin[];
     materials?: MaterialResolver[];
     games?: GamePreset[];
-    /** Направление зелёного канала карт нормалей движка: 'gl' (Y вверх: id Tech, OpenGL-игры) или 'dx' (по умолчанию). */
+    /** Green channel direction of the engine's normal maps: 'gl' (Y up: id Tech, OpenGL games) or 'dx' (default). */
     normalY?: 'gl' | 'dx';
-    /** Тексты на других языках (русские — в полях самих плагинов). Реестр подключает их вместе с движком. */
+    /** Texts in other languages (Russian ones are in the plugins' own fields). The registry attaches them with the engine. */
     i18n?: {
         en?: EngineTexts;
     };
-    /** Срез движка по играм (pickGames): полный движок, из которого он получен. */
+    /** Engine slice by games (pickGames): the full engine it was taken from. */
     base?: EnginePlugin;
 }
-/** Тексты движка на одном языке: название, группы пресетов, пресеты и варианты выгрузки по id. */
+/** Engine texts in one language: name, preset groups, presets and export options by id. */
 export interface EngineTexts {
     title?: string;
     groups?: Record<string, string>;
@@ -231,11 +231,11 @@ export interface EngineTexts {
         }>;
     }>;
 }
-/** Помощник для объявления движка с проверкой типов. */
+/** Helper for declaring an engine with type checking. */
 export declare const defineEngine: (e: EnginePlugin) => EnginePlugin;
 /**
- * Движок, ограниченный выбранными играми: их пресеты и форматы, на которые они ссылаются (архивы, кодеки, словари,
- * материалы и выгрузка — все). Так устроены подпути пакетов движков (`@gmvjs/xray-v1/cop`). Два среза одного движка
- * в одном реестре объединяются.
+ * An engine limited to the chosen games: their presets and the formats they reference (archives, codecs, dictionaries,
+ * materials and export: all of them). This is how engine package subpaths work (`@gmvjs/xray-v1/cop`). Two slices of one engine
+ * in the same registry are merged.
  */
 export declare function pickGames(engine: EnginePlugin, ...ids: string[]): EnginePlugin;

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["../src/plugin.ts"],"sourcesContent":["// Интерфейс расширения: движок = набор плагинов форматов, архивов, кодеков текстур и пресетов игр.\nimport type { Archive, BlobFile, DecodedImage, Mesh, Model, Motion, VFile } from './types';\nimport type { TextureLibrary, TextureSource } from './textures';\n\n/** Степень готовности (для значка в интерфейсе). */\nexport type SupportStatus = 'stable' | 'beta' | 'bridge';\n\nexport interface LoadContext {\n  /** Все файлы, выбранные вместе с основным (.mtl, .bin, .vvd…). */\n  readonly files: readonly VFile[];\n  /** Открытые архивы и папки. */\n  readonly archives: readonly Archive[];\n  /** Найти соседний файл: среди выбранных, затем в той же папке архива. */\n  sibling(name: string): Promise<ArrayBuffer | null>;\n  /** Прочитать файл архива по полному пути (первый найденный). */\n  readPath(path: string): Promise<Uint8Array | null>;\n  /** Значения Model.options, выбранные пользователем (повторная загрузка с другими дисками, винилом…). */\n  readonly options?: Readonly<Record<string, string>>;\n}\n\nexport interface AfterLoadContext {\n  readonly main: VFile;\n  readonly model: Model;\n  readonly textures: TextureLibrary;\n  addMotions(list: Motion[], source: string): void;\n  addTextureDictionary(file: VFile): Promise<void>;\n}\n\nexport interface FormatPlugin {\n  /** Уникальный id: '<движок>-<формат>', например 'xray-ogf'. */\n  id: string;\n  title: string;\n  engine: string;\n  /** Расширения без точки, нижний регистр. */\n  extensions: string[];\n  /** Файлы без расширения, которые открывает формат (по пути в архиве/папке), например «media/meshcache/…». */\n  pathPattern?: RegExp;\n  /** Расширения внешних анимаций, которые принимает модель этого формата. */\n  motionExtensions?: string[];\n  status?: SupportStatus;\n  /**\n   * Уверенность 0..1 по первым 256 байтам файла. 0 — точно не этот формат.\n   * Не задано — формат определяется только по расширению.\n   */\n  sniff?(head: Uint8Array, name: string): number;\n  load(main: VFile, ctx: LoadContext): Promise<Model>;\n  /** Поиск текстуры меша по правилам движка (материалы .vmt/.mtr/.mtl…). */\n  resolveTexture?(mesh: Mesh, model: Model, lib: TextureLibrary): Promise<TextureSource | null>;\n  /**\n   * Карты меша по правилам движка, если они не лежат отдельными файлами нормалей/PBR (Metro: «_bump» — высота и блик,\n   * нормали считаются из высоты). Возвращает готовые картинки.\n   */\n  resolveMaps?(mesh: Mesh, model: Model, lib: TextureLibrary): Promise<EngineMaps | null>;\n  /** Подгрузка сопутствующих файлов после загрузки (одноимённый .txd, анимации из папки…). */\n  afterLoad?(ctx: AfterLoadContext): Promise<void>;\n}\n\n/** Карты, собранные движком: нормали (касательное пространство, Y как в DirectX) и PBR-поверхность (R AO, G шероховатость, B металл, A блик). */\nexport interface EngineMaps {\n  normal?: { image: DecodedImage; packing?: 'rgb' | 'rg' | 'ag'; label?: string };\n  surface?: { image: DecodedImage; label?: string };\n}\n\nexport interface ArchivePlugin {\n  id: string;\n  title: string;\n  engine: string;\n  extensions: string[];\n  /** Расширения файлов-спутников (.dir для IMG, части VPK), которые не открываются сами по себе. */\n  companionExtensions?: string[];\n  /** Открывать такие архивы автоматически, когда выбрана «Папка игры» (F.E.A.R. Online: десятки *.arch01 рядом с Game/). */\n  openFromFolder?: boolean | ((head: Uint8Array, name: string) => boolean);\n  sniff?(head: Uint8Array, name: string): number;\n  /** null — файл является частью другого архива (например, *_001.vpk) и пропускается. */\n  open(file: BlobFile, siblings: readonly BlobFile[]): Promise<Archive | null>;\n}\n\n/**\n * Поиск текстуры по имени материала через файлы материалов движка (.mtr, .mat…), независимо от формата модели.\n * Срабатывает, когда собственный поиск формата ничего не нашёл: например, .lwo/.ase из Doom 3 через assimp + .mtr из pk4.\n */\nexport interface MaterialResolver {\n  id: string;\n  resolve(mesh: Mesh, lib: TextureLibrary): Promise<TextureSource | null>;\n}\n\nexport interface ImageCodec {\n  id: string;\n  extensions: string[];\n  decode(buf: ArrayBuffer, name: string): DecodedImage | Promise<DecodedImage>;\n}\n\nexport interface TextureDictionaryResult {\n  textures: Array<DecodedImage & { name: string }>;\n  errors: string[];\n}\n/** Файл-словарь текстур (RenderWare .txd). */\nexport interface TextureDictionaryPlugin {\n  id: string;\n  extensions: string[];\n  parse(buf: ArrayBuffer): TextureDictionaryResult | Promise<TextureDictionaryResult>;\n}\n\n/** Настройки интерфейса для пресета игры. */\nexport interface PresetUi {\n  /** Показать кнопку «Открыть архив…». */\n  archives?: boolean;\n  archiveExts?: string[];\n  archiveLabel?: string;\n  /** Кнопка внешней анимации. */\n  motionLabel?: string;\n  /** Внешняя анимация имеет то же расширение, что и модель (.cast). */\n  motionAny?: boolean;\n  /** Переключатель «Z вверх». */\n  zUp?: boolean;\n  /** Переключатель «инвертировать вращение». */\n  invertQuat?: boolean;\n}\n\nexport interface GamePreset {\n  id: string;\n  /** Группа в списке: «Игры», «Форматы (assimp)»… */\n  group: string;\n  title: string;\n  engine: string;\n  /** id форматов, которые открывает пресет. */\n  formats: string[];\n  /** Ограничить расширения моделей (по умолчанию — все расширения форматов). */\n  extensions?: string[];\n  hint?: string;\n  status?: SupportStatus;\n  ui?: PresetUi;\n  /** Файлы-маркеры игры для автоопределения по папке. */\n  markers?: string[];\n}\n\n/** Поле настроек экспорта (рисуется в окне экспорта). */\nexport interface ExportField {\n  id: string;\n  label: string;\n  type: 'text' | 'number' | 'checkbox' | 'select';\n  /** Значение по умолчанию; функция — по модели и имени файла. */\n  default?: string | number | boolean | ((model: Model, baseName: string) => string | number | boolean);\n  placeholder?: string;\n  hint?: string;\n  options?: Array<{ value: string; label: string }>;\n  min?: number;\n  step?: number;\n  /** Показывать поле только для таких моделей (например, «объекты ссылками» — у сцен с экземплярами). */\n  when?(model: Model): boolean;\n}\nexport type ExportValues = Record<string, string | number | boolean>;\n\n/** Текстура меша для писателя: исходный DDS (копируется как есть) или декодированная картинка. */\nexport interface ExportTexture { name: string; dds?: Uint8Array; image?: DecodedImage | null }\n\nexport interface ExportContext {\n  /** Пресет и движок, из которых открыта модель. */\n  preset: GamePreset;\n  sourceEngine: string;\n  /** Имя исходного файла без расширения. */\n  baseName: string;\n  /** Скрытые пользователем меши. */\n  hidden: ReadonlySet<number>;\n  texture(meshIndex: number): Promise<ExportTexture | null>;\n}\nexport interface ExportResult {\n  files: Map<string, Uint8Array>;\n  report: string[];\n  /** Имя архива для скачивания (без .zip). */\n  name: string;\n}\n\n/** Куда можно выгрузить загруженную модель: целевой движок/формат и его настройки. */\nexport interface ExporterPlugin {\n  id: string;\n  /** Короткое название («X-Ray SDK 0.7 (ЗП)»). */\n  title: string;\n  /** Что получится и как этим пользоваться. */\n  description: string;\n  /** Целевой движок (id) или формат («obj»). */\n  target: string;\n  /**\n   * Движки-источники, для которых выгрузка предназначена; не задано — подходит любая модель.\n   * Совпадение с движком открытой модели поднимает вариант в начало списка.\n   */\n  from?: string[];\n  /** Только из перечисленных движков (иначе вариант не показывается). */\n  onlyFrom?: boolean;\n  fields: ExportField[];\n  accepts?(model: Model): boolean;\n  run(model: Model, values: ExportValues, ctx: ExportContext): Promise<ExportResult>;\n}\n\nexport interface EnginePlugin {\n  id: string;\n  title: string;\n  formats?: FormatPlugin[];\n  /** Выгрузка в формат этого движка. */\n  exporters?: ExporterPlugin[];\n  archives?: ArchivePlugin[];\n  codecs?: ImageCodec[];\n  dictionaries?: TextureDictionaryPlugin[];\n  materials?: MaterialResolver[];\n  games?: GamePreset[];\n  /** Направление зелёного канала карт нормалей движка: 'gl' (Y вверх: id Tech, OpenGL-игры) или 'dx' (по умолчанию). */\n  normalY?: 'gl' | 'dx';\n  /** Тексты на других языках (русские — в полях самих плагинов). Реестр подключает их вместе с движком. */\n  i18n?: { en?: EngineTexts };\n  /** Срез движка по играм (pickGames): полный движок, из которого он получен. */\n  base?: EnginePlugin;\n}\n\n/** Тексты движка на одном языке: название, группы пресетов, пресеты и варианты выгрузки по id. */\nexport interface EngineTexts {\n  title?: string;\n  groups?: Record<string, string>;\n  presets?: Record<string, { title?: string; hint?: string; archiveLabel?: string; motionLabel?: string }>;\n  exporters?: Record<string, { title?: string; description?: string; fields?: Record<string, { label?: string; hint?: string; placeholder?: string }> }>;\n}\n\n/** Помощник для объявления движка с проверкой типов. */\nexport const defineEngine = (e: EnginePlugin): EnginePlugin => e;\n\n/**\n * Движок, ограниченный выбранными играми: их пресеты и форматы, на которые они ссылаются (архивы, кодеки, словари,\n * материалы и выгрузка — все). Так устроены подпути пакетов движков (`@gmvjs/xray-v1/cop`). Два среза одного движка\n * в одном реестре объединяются.\n */\nexport function pickGames(engine: EnginePlugin, ...ids: string[]): EnginePlugin {\n  const base = engine.base ?? engine;\n  const games = (base.games ?? []).filter((g) => ids.includes(g.id));\n  const missing = ids.filter((id) => !games.some((g) => g.id === id));\n  if (missing.length) throw new Error(`gmv: в движке ${base.id} нет пресетов ${missing.join(', ')}`);\n  const used = new Set(games.flatMap((g) => g.formats));\n  return { ...base, base, games, formats: (base.formats ?? []).filter((f) => used.has(f.id)) };\n}\n"],"names":[],"mappings":"AA8NO,MAAM,eAAe,CAAC,MAAkC;AAOxD,SAAS,UAAU,WAAyB,KAA6B;AAC9E,QAAM,OAAO,OAAO,QAAQ;AAC5B,QAAM,SAAS,KAAK,SAAS,CAAA,GAAI,OAAO,CAAC,MAAM,IAAI,SAAS,EAAE,EAAE,CAAC;AACjE,QAAM,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;AAClE,MAAI,QAAQ,OAAQ,OAAM,IAAI,MAAM,iBAAiB,KAAK,EAAE,iBAAiB,QAAQ,KAAK,IAAI,CAAC,EAAE;AACjG,QAAM,OAAO,IAAI,IAAI,MAAM,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;AACpD,SAAO,EAAE,GAAG,MAAM,MAAM,OAAO,UAAU,KAAK,WAAW,CAAA,GAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,EAAE,CAAC,EAAA;AAC3F;"}
+{"version":3,"file":"plugin.js","sources":["../src/plugin.ts"],"sourcesContent":["// Extension interface: an engine is a set of plugins for formats, archives, texture codecs and game presets.\nimport type { Archive, BlobFile, DecodedImage, Mesh, Model, Motion, VFile } from './types';\nimport type { TextureLibrary, TextureSource } from './textures';\n\n/** Readiness level (for the badge in the UI). */\nexport type SupportStatus = 'stable' | 'beta' | 'bridge';\n\nexport interface LoadContext {\n  /** All files selected together with the main one (.mtl, .bin, .vvd…). */\n  readonly files: readonly VFile[];\n  /** Open archives and folders. */\n  readonly archives: readonly Archive[];\n  /** Find a neighbouring file: among the selected ones, then in the same archive folder. */\n  sibling(name: string): Promise<ArrayBuffer | null>;\n  /** Read an archive file by full path (first match). */\n  readPath(path: string): Promise<Uint8Array | null>;\n  /** Model.options values chosen by the user (reloading with other wheels, vinyl…). */\n  readonly options?: Readonly<Record<string, string>>;\n}\n\nexport interface AfterLoadContext {\n  readonly main: VFile;\n  readonly model: Model;\n  readonly textures: TextureLibrary;\n  addMotions(list: Motion[], source: string): void;\n  addTextureDictionary(file: VFile): Promise<void>;\n}\n\nexport interface FormatPlugin {\n  /** Unique id: '<engine>-<format>', for example 'xray-ogf'. */\n  id: string;\n  title: string;\n  engine: string;\n  /** Extensions without the dot, lower case. */\n  extensions: string[];\n  /** Extensionless files the format opens (by path in an archive/folder), for example \"media/meshcache/…\". */\n  pathPattern?: RegExp;\n  /** Extensions of external animations a model of this format accepts. */\n  motionExtensions?: string[];\n  status?: SupportStatus;\n  /**\n   * Confidence 0..1 from the first 256 bytes of the file. 0 means definitely not this format.\n   * Not set: the format is detected by extension only.\n   */\n  sniff?(head: Uint8Array, name: string): number;\n  load(main: VFile, ctx: LoadContext): Promise<Model>;\n  /** Find a mesh texture using the engine's rules (.vmt/.mtr/.mtl materials…). */\n  resolveTexture?(mesh: Mesh, model: Model, lib: TextureLibrary): Promise<TextureSource | null>;\n  /**\n   * Mesh maps by the engine's rules when they are not separate normal/PBR files (Metro: \"_bump\" holds height and specular,\n   * normals are computed from height). Returns ready images.\n   */\n  resolveMaps?(mesh: Mesh, model: Model, lib: TextureLibrary): Promise<EngineMaps | null>;\n  /** Load companion files after loading (a same-named .txd, animations from the folder…). */\n  afterLoad?(ctx: AfterLoadContext): Promise<void>;\n}\n\n/** Maps assembled by the engine: normals (tangent space, Y as in DirectX) and the PBR surface (R AO, G roughness, B metal, A specular). */\nexport interface EngineMaps {\n  normal?: { image: DecodedImage; packing?: 'rgb' | 'rg' | 'ag'; label?: string };\n  surface?: { image: DecodedImage; label?: string };\n}\n\nexport interface ArchivePlugin {\n  id: string;\n  title: string;\n  engine: string;\n  extensions: string[];\n  /** Extensions of companion files (.dir for IMG, VPK parts) that are not opened on their own. */\n  companionExtensions?: string[];\n  /** Open such archives automatically when a \"Game folder\" is chosen (F.E.A.R. Online: dozens of *.arch01 next to Game/). */\n  openFromFolder?: boolean | ((head: Uint8Array, name: string) => boolean);\n  sniff?(head: Uint8Array, name: string): number;\n  /** null: the file is part of another archive (for example *_001.vpk) and is skipped. */\n  open(file: BlobFile, siblings: readonly BlobFile[]): Promise<Archive | null>;\n}\n\n/**\n * Texture lookup by material name through the engine's material files (.mtr, .mat…), regardless of the model format.\n * Used when the format's own lookup found nothing: for example .lwo/.ase from Doom 3 via assimp + .mtr from pk4.\n */\nexport interface MaterialResolver {\n  id: string;\n  resolve(mesh: Mesh, lib: TextureLibrary): Promise<TextureSource | null>;\n}\n\nexport interface ImageCodec {\n  id: string;\n  extensions: string[];\n  decode(buf: ArrayBuffer, name: string): DecodedImage | Promise<DecodedImage>;\n}\n\nexport interface TextureDictionaryResult {\n  textures: Array<DecodedImage & { name: string }>;\n  errors: string[];\n}\n/** Texture dictionary file (RenderWare .txd). */\nexport interface TextureDictionaryPlugin {\n  id: string;\n  extensions: string[];\n  parse(buf: ArrayBuffer): TextureDictionaryResult | Promise<TextureDictionaryResult>;\n}\n\n/** UI settings for a game preset. */\nexport interface PresetUi {\n  /** Show the \"Open archive…\" button. */\n  archives?: boolean;\n  archiveExts?: string[];\n  archiveLabel?: string;\n  /** External animation button. */\n  motionLabel?: string;\n  /** The external animation has the same extension as the model (.cast). */\n  motionAny?: boolean;\n  /** \"Z up\" toggle. */\n  zUp?: boolean;\n  /** \"Invert rotation\" toggle. */\n  invertQuat?: boolean;\n}\n\nexport interface GamePreset {\n  id: string;\n  /** Group in the list: \"Games\", \"Formats (assimp)\"… */\n  group: string;\n  title: string;\n  engine: string;\n  /** Ids of the formats the preset opens. */\n  formats: string[];\n  /** Restrict model extensions (default: all format extensions). */\n  extensions?: string[];\n  hint?: string;\n  status?: SupportStatus;\n  ui?: PresetUi;\n  /** Game marker files for detection by folder. */\n  markers?: string[];\n}\n\n/** Export settings field (drawn in the export dialog). */\nexport interface ExportField {\n  id: string;\n  label: string;\n  type: 'text' | 'number' | 'checkbox' | 'select';\n  /** Default value; a function receives the model and file name. */\n  default?: string | number | boolean | ((model: Model, baseName: string) => string | number | boolean);\n  placeholder?: string;\n  hint?: string;\n  options?: Array<{ value: string; label: string }>;\n  min?: number;\n  step?: number;\n  /** Show the field only for such models (for example \"objects as references\" for scenes with instances). */\n  when?(model: Model): boolean;\n}\nexport type ExportValues = Record<string, string | number | boolean>;\n\n/** Mesh texture for a writer: the source DDS (copied as is) or a decoded image. */\nexport interface ExportTexture { name: string; dds?: Uint8Array; image?: DecodedImage | null }\n\nexport interface ExportContext {\n  /** Preset and engine the model was opened from. */\n  preset: GamePreset;\n  sourceEngine: string;\n  /** Source file name without extension. */\n  baseName: string;\n  /** Meshes hidden by the user. */\n  hidden: ReadonlySet<number>;\n  texture(meshIndex: number): Promise<ExportTexture | null>;\n}\nexport interface ExportResult {\n  files: Map<string, Uint8Array>;\n  report: string[];\n  /** Name of the archive to download (without .zip). */\n  name: string;\n}\n\n/** Where a loaded model can be exported: the target engine/format and its settings. */\nexport interface ExporterPlugin {\n  id: string;\n  /** Short name (\"X-Ray SDK 0.7 (CoP)\"). */\n  title: string;\n  /** What you get and how to use it. */\n  description: string;\n  /** Target engine (id) or format (\"obj\"). */\n  target: string;\n  /**\n   * Source engines the export is intended for; not set: any model fits.\n   * A match with the open model's engine moves the option to the top of the list.\n   */\n  from?: string[];\n  /** Only from the listed engines (otherwise the option is not shown). */\n  onlyFrom?: boolean;\n  fields: ExportField[];\n  accepts?(model: Model): boolean;\n  run(model: Model, values: ExportValues, ctx: ExportContext): Promise<ExportResult>;\n}\n\nexport interface EnginePlugin {\n  id: string;\n  title: string;\n  formats?: FormatPlugin[];\n  /** Export to this engine's format. */\n  exporters?: ExporterPlugin[];\n  archives?: ArchivePlugin[];\n  codecs?: ImageCodec[];\n  dictionaries?: TextureDictionaryPlugin[];\n  materials?: MaterialResolver[];\n  games?: GamePreset[];\n  /** Green channel direction of the engine's normal maps: 'gl' (Y up: id Tech, OpenGL games) or 'dx' (default). */\n  normalY?: 'gl' | 'dx';\n  /** Texts in other languages (Russian ones are in the plugins' own fields). The registry attaches them with the engine. */\n  i18n?: { en?: EngineTexts };\n  /** Engine slice by games (pickGames): the full engine it was taken from. */\n  base?: EnginePlugin;\n}\n\n/** Engine texts in one language: name, preset groups, presets and export options by id. */\nexport interface EngineTexts {\n  title?: string;\n  groups?: Record<string, string>;\n  presets?: Record<string, { title?: string; hint?: string; archiveLabel?: string; motionLabel?: string }>;\n  exporters?: Record<string, { title?: string; description?: string; fields?: Record<string, { label?: string; hint?: string; placeholder?: string }> }>;\n}\n\n/** Helper for declaring an engine with type checking. */\nexport const defineEngine = (e: EnginePlugin): EnginePlugin => e;\n\n/**\n * An engine limited to the chosen games: their presets and the formats they reference (archives, codecs, dictionaries,\n * materials and export: all of them). This is how engine package subpaths work (`@gmvjs/xray-v1/cop`). Two slices of one engine\n * in the same registry are merged.\n */\nexport function pickGames(engine: EnginePlugin, ...ids: string[]): EnginePlugin {\n  const base = engine.base ?? engine;\n  const games = (base.games ?? []).filter((g) => ids.includes(g.id));\n  const missing = ids.filter((id) => !games.some((g) => g.id === id));\n  if (missing.length) throw new Error(`gmv: в движке ${base.id} нет пресетов ${missing.join(', ')}`);\n  const used = new Set(games.flatMap((g) => g.formats));\n  return { ...base, base, games, formats: (base.formats ?? []).filter((f) => used.has(f.id)) };\n}\n"],"names":[],"mappings":"AA8NO,MAAM,eAAe,CAAC,MAAkC;AAOxD,SAAS,UAAU,WAAyB,KAA6B;AAC9E,QAAM,OAAO,OAAO,QAAQ;AAC5B,QAAM,SAAS,KAAK,SAAS,CAAA,GAAI,OAAO,CAAC,MAAM,IAAI,SAAS,EAAE,EAAE,CAAC;AACjE,QAAM,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;AAClE,MAAI,QAAQ,OAAQ,OAAM,IAAI,MAAM,iBAAiB,KAAK,EAAE,iBAAiB,QAAQ,KAAK,IAAI,CAAC,EAAE;AACjG,QAAM,OAAO,IAAI,IAAI,MAAM,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;AACpD,SAAO,EAAE,GAAG,MAAM,MAAM,OAAO,UAAU,KAAK,WAAW,CAAA,GAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,EAAE,CAAC,EAAA;AAC3F;"}

package/dist/registry.d.ts

@@ -5,7 +5,7 @@ export interface Detection {
     format: FormatPlugin;
     /** 0..1 */
     confidence: number;
-    /** Все кандидаты по убыванию уверенности (для выбора из 2–3 вариантов). */
+    /** All candidates by descending confidence (for choosing among 2–3 options). */
     candidates: Array<{
         format: FormatPlugin;
         confidence: number;
@@ -21,10 +21,10 @@ export declare class Registry implements ImageDecoder {
     readonly materials: MaterialResolver[];
     readonly exporters: ExporterPlugin[];
     constructor(engines?: readonly EnginePlugin[]);
-    /** Подключить движок. Повторное подключение с тем же id заменяет плагины. */
+    /** Attach an engine. Attaching again with the same id replaces its plugins. */
     use(engine: EnginePlugin): this;
     remove(engineId: string): void;
-    /** Варианты выгрузки модели, открытой из движка sourceEngine: сначала предназначенные для него, затем общие. */
+    /** Export options for a model opened from engine sourceEngine: those intended for it first, then general ones. */
     exportersFor(model: Model, sourceEngine: string): Array<{
         exporter: ExporterPlugin;
         recommended: boolean;
@@ -32,32 +32,32 @@ export declare class Registry implements ImageDecoder {
     format(id: string): FormatPlugin | undefined;
     game(id: string): GamePreset | undefined;
     engine(id: string): EnginePlugin | undefined;
-    /** Есть ли в реестре хотя бы один формат пресета (мост через assimp без @gmvjs/assimp — нет). */
+    /** Whether the registry has at least one of the preset's formats (an assimp bridge without @gmvjs/assimp does not). */
     presetAvailable(p: GamePreset): boolean;
-    /** Расширения моделей пресета. */
+    /** Model extensions of the preset. */
     presetExtensions(p: GamePreset): string[];
-    /** Расширения внешних анимаций пресета. */
+    /** External animation extensions of the preset. */
     presetMotionExtensions(p: GamePreset): string[];
-    /** Первый пресет, открывающий формат. */
+    /** First preset that opens the format. */
     presetForFormat(formatId: string, fileName?: string): GamePreset | undefined;
-    /** Расширения, которые бывают только у внешних анимаций (.omf, .psa, .md5anim), а не у моделей. */
+    /** Extensions found only on external animations (.omf, .psa, .md5anim), never on models. */
     get motionOnlyExtensions(): string[];
     get modelExtensions(): string[];
-    /** Модель по шаблону пути (MeshCache без расширения, classes/trucks/*.xml); formats — ограничить форматами пресета. */
+    /** Model by path pattern (extensionless MeshCache, classes/trucks/*.xml); formats limits it to the preset's formats. */
     isPathModel(path: string, formats?: readonly string[]): boolean;
     archiveExtensions(): string[];
     isArchive(name: string): boolean;
     dictionaryFor(name: string): TextureDictionaryPlugin | undefined;
     codecFor(name: string): ImageCodec | undefined;
-    /** Картинка ли это (по расширению): кодеки плагинов + форматы браузера. */
+    /** Whether this is an image (by extension): plugin codecs + browser formats. */
     isImage(name: string): boolean;
-    /** Плагин архива для файла: по расширению, при неоднозначности — по сигнатуре. */
+    /** Archive plugin for a file: by extension, by signature when ambiguous. */
     archiveFor(file: BlobFile): Promise<ArchivePlugin | null>;
     /**
-     * Определить формат модели: кандидаты по расширению, уточнение по сигнатуре,
-     * бонус форматам предпочитаемого пресета. Без расширения — перебор всех сигнатур.
+     * Detect the model format: candidates by extension, refined by signature,
+     * with a bonus for the preferred preset's formats. Without an extension all signatures are tried.
      */
     detect(file: VFile | BlobFile, prefer?: readonly string[]): Promise<Detection | null>;
-    /** Декодировать картинку: кодеки плагинов, затем createImageBitmap браузера. */
+    /** Decode an image: plugin codecs, then the browser's createImageBitmap. */
     decodeImage(file: VFile): Promise<DecodedImage>;
 }

package/dist/registry.js

@@ -13,7 +13,7 @@ class Registry {
   constructor(engines = []) {
     for (const e of engines) this.use(e);
   }
-  /** Подключить движок. Повторное подключение с тем же id заменяет плагины. */
+  /** Attach an engine. Attaching again with the same id replaces its plugins. */
   use(engine) {
     const old = this.engines.findIndex((e) => e.id === engine.id);
     if (old >= 0) {
@@ -57,7 +57,7 @@ class Registry {
     drop(this.materials, e.materials);
     drop(this.exporters, e.exporters);
   }
-  /** Варианты выгрузки модели, открытой из движка sourceEngine: сначала предназначенные для него, затем общие. */
+  /** Export options for a model opened from engine sourceEngine: those intended for it first, then general ones. */
   exportersFor(model, sourceEngine) {
     return this.exporters.filter((x) => (!x.onlyFrom || x.from?.includes(sourceEngine)) && (!x.accepts || x.accepts(model))).map((exporter) => ({ exporter, recommended: !!exporter.from?.includes(sourceEngine) })).sort((a, b) => Number(b.recommended) - Number(a.recommended));
   }
@@ -70,25 +70,25 @@ class Registry {
   engine(id) {
     return this.engines.find((e) => e.id === id);
   }
-  /** Есть ли в реестре хотя бы один формат пресета (мост через assimp без @gmvjs/assimp — нет). */
+  /** Whether the registry has at least one of the preset's formats (an assimp bridge without @gmvjs/assimp does not). */
   presetAvailable(p) {
     return p.formats.some((id) => !!this.format(id));
   }
-  /** Расширения моделей пресета. */
+  /** Model extensions of the preset. */
   presetExtensions(p) {
     if (p.extensions) return p.extensions;
     return [...new Set(p.formats.flatMap((id) => this.format(id)?.extensions ?? []))];
   }
-  /** Расширения внешних анимаций пресета. */
+  /** External animation extensions of the preset. */
   presetMotionExtensions(p) {
     return [...new Set(p.formats.flatMap((id) => this.format(id)?.motionExtensions ?? []))];
   }
-  /** Первый пресет, открывающий формат. */
+  /** First preset that opens the format. */
   presetForFormat(formatId, fileName) {
     const ext = fileName ? extOf(fileName) : "";
     return ext && this.games.find((g) => g.formats.includes(formatId) && this.presetExtensions(g).includes(ext)) || this.games.find((g) => g.formats.includes(formatId));
   }
-  /** Расширения, которые бывают только у внешних анимаций (.omf, .psa, .md5anim), а не у моделей. */
+  /** Extensions found only on external animations (.omf, .psa, .md5anim), never on models. */
   get motionOnlyExtensions() {
     const models = new Set(this.formats.flatMap((f) => f.extensions));
     return [...new Set(this.formats.flatMap((f) => f.motionExtensions ?? []))].filter((e) => !models.has(e));
@@ -96,7 +96,7 @@ class Registry {
   get modelExtensions() {
     return [...new Set(this.formats.flatMap((f) => [...f.extensions, ...f.motionExtensions ?? []]))];
   }
-  /** Модель по шаблону пути (MeshCache без расширения, classes/trucks/*.xml); formats — ограничить форматами пресета. */
+  /** Model by path pattern (extensionless MeshCache, classes/trucks/*.xml); formats limits it to the preset's formats. */
   isPathModel(path, formats) {
     return this.formats.some((f) => f.pathPattern?.test(path) && (!formats || formats.includes(f.id)));
   }
@@ -114,11 +114,11 @@ class Registry {
     const ext = extOf(name);
     return this.codecs.find((c) => c.extensions.includes(ext));
   }
-  /** Картинка ли это (по расширению): кодеки плагинов + форматы браузера. */
+  /** Whether this is an image (by extension): plugin codecs + browser formats. */
   isImage(name) {
     return !!this.codecFor(name) || /\.(png|jpe?g|bmp|webp|gif)$/i.test(name);
   }
-  /** Плагин архива для файла: по расширению, при неоднозначности — по сигнатуре. */
+  /** Archive plugin for a file: by extension, by signature when ambiguous. */
   async archiveFor(file) {
     const ext = extOf(file.name), cands = this.archives.filter((a) => a.extensions.includes(ext));
     if (cands.length <= 1) return cands[0] ?? null;
@@ -134,8 +134,8 @@ class Registry {
     return score > 0 ? best : cands.find((a) => a.id === "zip") ?? null;
   }
   /**
-   * Определить формат модели: кандидаты по расширению, уточнение по сигнатуре,
-   * бонус форматам предпочитаемого пресета. Без расширения — перебор всех сигнатур.
+   * Detect the model format: candidates by extension, refined by signature,
+   * with a bonus for the preferred preset's formats. Without an extension all signatures are tried.
    */
   async detect(file, prefer = []) {
     const ext = extOf(file.name);
@@ -158,7 +158,7 @@ class Registry {
     if (!scored.length) return null;
     return { format: scored[0].format, confidence: scored[0].confidence, candidates: scored };
   }
-  /** Декодировать картинку: кодеки плагинов, затем createImageBitmap браузера. */
+  /** Decode an image: plugin codecs, then the browser's createImageBitmap. */
   async decodeImage(file) {
     if (file.decoded) return file.decoded;
     const buf = await file.arrayBuffer(), codec = this.codecFor(file.name);

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sources":["../src/registry.ts"],"sourcesContent":["// Реестр плагинов: движки -> форматы, архивы, кодеки, словари текстур, пресеты игр. Автоопределение формата.\nimport { extOf, readHead } from './binary';\nimport { pickGames, type ArchivePlugin, type EnginePlugin, type ExporterPlugin, type FormatPlugin, type GamePreset, type ImageCodec, type MaterialResolver, type TextureDictionaryPlugin } from './plugin';\nimport { registerTexts } from './i18n';\nimport type { BlobFile, DecodedImage, Model, VFile } from './types';\nimport type { ImageDecoder } from './textures';\n\nexport interface Detection {\n  format: FormatPlugin;\n  /** 0..1 */\n  confidence: number;\n  /** Все кандидаты по убыванию уверенности (для выбора из 2–3 вариантов). */\n  candidates: Array<{ format: FormatPlugin; confidence: number }>;\n}\n\nexport class Registry implements ImageDecoder {\n  readonly engines: EnginePlugin[] = [];\n  readonly formats: FormatPlugin[] = [];\n  readonly archives: ArchivePlugin[] = [];\n  readonly codecs: ImageCodec[] = [];\n  readonly dictionaries: TextureDictionaryPlugin[] = [];\n  readonly games: GamePreset[] = [];\n  readonly materials: MaterialResolver[] = [];\n  readonly exporters: ExporterPlugin[] = [];\n\n  constructor(engines: readonly EnginePlugin[] = []) {\n    for (const e of engines) this.use(e);\n  }\n\n  /** Подключить движок. Повторное подключение с тем же id заменяет плагины. */\n  use(engine: EnginePlugin): this {\n    const old = this.engines.findIndex((e) => e.id === engine.id);\n    if (old >= 0) {\n      // второй срез того же движка (подпуть другой игры): игры объединяются\n      const prev = this.engines[old]!, base = engine.base ?? engine;\n      if (prev.base && engine.base && prev.base === engine.base) engine = pickGames(base, ...new Set([...(prev.games ?? []), ...(engine.games ?? [])].map((g) => g.id)));\n      this.remove(engine.id);\n    }\n    registerTexts(engine);\n    this.engines.push(engine);\n    const add = <T extends { id: string }>(list: T[], items: readonly T[] | undefined, kind: string) => {\n      for (const it of items ?? []) {\n        if (list.some((x) => x.id === it.id)) throw new Error(`gmv: ${kind} с id «${it.id}» уже зарегистрирован`);\n        list.push(it);\n      }\n    };\n    add(this.formats, engine.formats, 'формат');\n    add(this.archives, engine.archives, 'архив');\n    add(this.codecs, engine.codecs, 'кодек');\n    add(this.dictionaries, engine.dictionaries, 'словарь');\n    add(this.games, engine.games, 'пресет');\n    add(this.materials, engine.materials, 'материалы');\n    add(this.exporters, engine.exporters, 'экспорт');\n    return this;\n  }\n\n  remove(engineId: string): void {\n    const i = this.engines.findIndex((e) => e.id === engineId);\n    if (i < 0) return;\n    const e = this.engines[i]!;\n    this.engines.splice(i, 1);\n    const drop = <T>(list: T[], items: readonly T[] | undefined) => {\n      for (const it of items ?? []) { const k = list.indexOf(it); if (k >= 0) list.splice(k, 1); }\n    };\n    drop(this.formats, e.formats);\n    drop(this.archives, e.archives);\n    drop(this.codecs, e.codecs);\n    drop(this.dictionaries, e.dictionaries);\n    drop(this.games, e.games);\n    drop(this.materials, e.materials);\n    drop(this.exporters, e.exporters);\n  }\n\n  /** Варианты выгрузки модели, открытой из движка sourceEngine: сначала предназначенные для него, затем общие. */\n  exportersFor(model: Model, sourceEngine: string): Array<{ exporter: ExporterPlugin; recommended: boolean }> {\n    return this.exporters\n      .filter((x) => (!x.onlyFrom || x.from?.includes(sourceEngine)) && (!x.accepts || x.accepts(model)))\n      .map((exporter) => ({ exporter, recommended: !!exporter.from?.includes(sourceEngine) }))\n      .sort((a, b) => Number(b.recommended) - Number(a.recommended));\n  }\n\n  format(id: string): FormatPlugin | undefined { return this.formats.find((f) => f.id === id); }\n  game(id: string): GamePreset | undefined { return this.games.find((g) => g.id === id); }\n  engine(id: string): EnginePlugin | undefined { return this.engines.find((e) => e.id === id); }\n\n  /** Есть ли в реестре хотя бы один формат пресета (мост через assimp без @gmvjs/assimp — нет). */\n  presetAvailable(p: GamePreset): boolean { return p.formats.some((id) => !!this.format(id)); }\n  /** Расширения моделей пресета. */\n  presetExtensions(p: GamePreset): string[] {\n    if (p.extensions) return p.extensions;\n    return [...new Set(p.formats.flatMap((id) => this.format(id)?.extensions ?? []))];\n  }\n  /** Расширения внешних анимаций пресета. */\n  presetMotionExtensions(p: GamePreset): string[] {\n    return [...new Set(p.formats.flatMap((id) => this.format(id)?.motionExtensions ?? []))];\n  }\n  /** Первый пресет, открывающий формат. */\n  presetForFormat(formatId: string, fileName?: string): GamePreset | undefined {\n    const ext = fileName ? extOf(fileName) : '';\n    return (ext && this.games.find((g) => g.formats.includes(formatId) && this.presetExtensions(g).includes(ext))) || this.games.find((g) => g.formats.includes(formatId));\n  }\n  /** Расширения, которые бывают только у внешних анимаций (.omf, .psa, .md5anim), а не у моделей. */\n  get motionOnlyExtensions(): string[] {\n    const models = new Set(this.formats.flatMap((f) => f.extensions));\n    return [...new Set(this.formats.flatMap((f) => f.motionExtensions ?? []))].filter((e) => !models.has(e));\n  }\n  get modelExtensions(): string[] {\n    return [...new Set(this.formats.flatMap((f) => [...f.extensions, ...(f.motionExtensions ?? [])]))];\n  }\n\n  /** Модель по шаблону пути (MeshCache без расширения, classes/trucks/*.xml); formats — ограничить форматами пресета. */\n  isPathModel(path: string, formats?: readonly string[]): boolean {\n    return this.formats.some((f) => f.pathPattern?.test(path) && (!formats || formats.includes(f.id)));\n  }\n\n  archiveExtensions(): string[] {\n    return [...new Set(this.archives.flatMap((a) => [...a.extensions, ...(a.companionExtensions ?? [])]))];\n  }\n  isArchive(name: string): boolean { return this.archiveExtensions().includes(extOf(name)); }\n  dictionaryFor(name: string): TextureDictionaryPlugin | undefined {\n    const ext = extOf(name);\n    return this.dictionaries.find((d) => d.extensions.includes(ext));\n  }\n  codecFor(name: string): ImageCodec | undefined {\n    const ext = extOf(name);\n    return this.codecs.find((c) => c.extensions.includes(ext));\n  }\n  /** Картинка ли это (по расширению): кодеки плагинов + форматы браузера. */\n  isImage(name: string): boolean {\n    return !!this.codecFor(name) || /\\.(png|jpe?g|bmp|webp|gif)$/i.test(name);\n  }\n\n  /** Плагин архива для файла: по расширению, при неоднозначности — по сигнатуре. */\n  async archiveFor(file: BlobFile): Promise<ArchivePlugin | null> {\n    const ext = extOf(file.name), cands = this.archives.filter((a) => a.extensions.includes(ext));\n    if (cands.length <= 1) return cands[0] ?? null;\n    const head = await readHead(file, 64);\n    let best: ArchivePlugin | null = null, score = -1;\n    for (const a of cands) {\n      const s = a.sniff ? a.sniff(head, file.name) : 0.1;\n      if (s > score) { score = s; best = a; }\n    }\n    // сигнатура не узнана: ZIP читается с конца файла (каталог), поэтому он — запасной вариант, как в v11\n    return score > 0 ? best : cands.find((a) => a.id === 'zip') ?? null;\n  }\n\n  /**\n   * Определить формат модели: кандидаты по расширению, уточнение по сигнатуре,\n   * бонус форматам предпочитаемого пресета. Без расширения — перебор всех сигнатур.\n   */\n  async detect(file: VFile | BlobFile, prefer: readonly string[] = []): Promise<Detection | null> {\n    const ext = extOf(file.name);\n    let cands = this.formats.filter((f) => f.extensions.includes(ext));\n    const byMagicOnly = !cands.length;\n    if (byMagicOnly) cands = this.formats.filter((f) => f.sniff);\n    if (!cands.length) return null;\n    // сигнатуру проверяем всегда, когда кандидат её умеет: иначе текстовый Doom 3 .skin уходит в CryEngine .skin\n    const needHead = byMagicOnly || cands.some((c) => c.sniff);\n    const head = needHead ? await readHead(file, 256) : null;\n    const scored = cands\n      .map((format) => {\n        let c = byMagicOnly ? 0 : 0.5;\n        if (head && format.sniff) {\n          const s = format.sniff(head, file.name);\n          if (s <= 0) return { format, confidence: 0 };\n          c += (byMagicOnly ? 1 : 0.5) * s;\n        }\n        if (prefer.includes(format.id)) c += 0.25;\n        return { format, confidence: Math.min(1, c), rank: c };\n      })\n      .filter((x) => x.confidence > (byMagicOnly ? 0.6 : 0))\n      // порядок — по оценке без потолка 1: при равной сигнатуре решает пресет (PSK одинаков у Unreal 1–5)\n      .sort((a, b) => (b.rank ?? 0) - (a.rank ?? 0))\n      .map(({ format, confidence }) => ({ format, confidence }));\n    if (!scored.length) return null;\n    return { format: scored[0]!.format, confidence: scored[0]!.confidence, candidates: scored };\n  }\n\n  /** Декодировать картинку: кодеки плагинов, затем createImageBitmap браузера. */\n  async decodeImage(file: VFile): Promise<DecodedImage> {\n    if (file.decoded) return file.decoded;\n    const buf = await file.arrayBuffer(), codec = this.codecFor(file.name);\n    if (codec) return codec.decode(buf, file.name);\n    if (typeof createImageBitmap !== 'function') throw new Error(`нет декодера для ${file.name}`);\n    const bitmap = await createImageBitmap(new Blob([buf]), { premultiplyAlpha: 'none', colorSpaceConversion: 'none' });\n    return { bitmap, width: bitmap.width, height: bitmap.height };\n  }\n}\n"],"names":["e"],"mappings":"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"}
+{"version":3,"file":"registry.js","sources":["../src/registry.ts"],"sourcesContent":["// Plugin registry: engines -> formats, archives, codecs, texture dictionaries, game presets. Format detection.\nimport { extOf, readHead } from './binary';\nimport { pickGames, type ArchivePlugin, type EnginePlugin, type ExporterPlugin, type FormatPlugin, type GamePreset, type ImageCodec, type MaterialResolver, type TextureDictionaryPlugin } from './plugin';\nimport { registerTexts } from './i18n';\nimport type { BlobFile, DecodedImage, Model, VFile } from './types';\nimport type { ImageDecoder } from './textures';\n\nexport interface Detection {\n  format: FormatPlugin;\n  /** 0..1 */\n  confidence: number;\n  /** All candidates by descending confidence (for choosing among 2–3 options). */\n  candidates: Array<{ format: FormatPlugin; confidence: number }>;\n}\n\nexport class Registry implements ImageDecoder {\n  readonly engines: EnginePlugin[] = [];\n  readonly formats: FormatPlugin[] = [];\n  readonly archives: ArchivePlugin[] = [];\n  readonly codecs: ImageCodec[] = [];\n  readonly dictionaries: TextureDictionaryPlugin[] = [];\n  readonly games: GamePreset[] = [];\n  readonly materials: MaterialResolver[] = [];\n  readonly exporters: ExporterPlugin[] = [];\n\n  constructor(engines: readonly EnginePlugin[] = []) {\n    for (const e of engines) this.use(e);\n  }\n\n  /** Attach an engine. Attaching again with the same id replaces its plugins. */\n  use(engine: EnginePlugin): this {\n    const old = this.engines.findIndex((e) => e.id === engine.id);\n    if (old >= 0) {\n      // a second slice of the same engine (another game's subpath): games are merged\n      const prev = this.engines[old]!, base = engine.base ?? engine;\n      if (prev.base && engine.base && prev.base === engine.base) engine = pickGames(base, ...new Set([...(prev.games ?? []), ...(engine.games ?? [])].map((g) => g.id)));\n      this.remove(engine.id);\n    }\n    registerTexts(engine);\n    this.engines.push(engine);\n    const add = <T extends { id: string }>(list: T[], items: readonly T[] | undefined, kind: string) => {\n      for (const it of items ?? []) {\n        if (list.some((x) => x.id === it.id)) throw new Error(`gmv: ${kind} с id «${it.id}» уже зарегистрирован`);\n        list.push(it);\n      }\n    };\n    add(this.formats, engine.formats, 'формат');\n    add(this.archives, engine.archives, 'архив');\n    add(this.codecs, engine.codecs, 'кодек');\n    add(this.dictionaries, engine.dictionaries, 'словарь');\n    add(this.games, engine.games, 'пресет');\n    add(this.materials, engine.materials, 'материалы');\n    add(this.exporters, engine.exporters, 'экспорт');\n    return this;\n  }\n\n  remove(engineId: string): void {\n    const i = this.engines.findIndex((e) => e.id === engineId);\n    if (i < 0) return;\n    const e = this.engines[i]!;\n    this.engines.splice(i, 1);\n    const drop = <T>(list: T[], items: readonly T[] | undefined) => {\n      for (const it of items ?? []) { const k = list.indexOf(it); if (k >= 0) list.splice(k, 1); }\n    };\n    drop(this.formats, e.formats);\n    drop(this.archives, e.archives);\n    drop(this.codecs, e.codecs);\n    drop(this.dictionaries, e.dictionaries);\n    drop(this.games, e.games);\n    drop(this.materials, e.materials);\n    drop(this.exporters, e.exporters);\n  }\n\n  /** Export options for a model opened from engine sourceEngine: those intended for it first, then general ones. */\n  exportersFor(model: Model, sourceEngine: string): Array<{ exporter: ExporterPlugin; recommended: boolean }> {\n    return this.exporters\n      .filter((x) => (!x.onlyFrom || x.from?.includes(sourceEngine)) && (!x.accepts || x.accepts(model)))\n      .map((exporter) => ({ exporter, recommended: !!exporter.from?.includes(sourceEngine) }))\n      .sort((a, b) => Number(b.recommended) - Number(a.recommended));\n  }\n\n  format(id: string): FormatPlugin | undefined { return this.formats.find((f) => f.id === id); }\n  game(id: string): GamePreset | undefined { return this.games.find((g) => g.id === id); }\n  engine(id: string): EnginePlugin | undefined { return this.engines.find((e) => e.id === id); }\n\n  /** Whether the registry has at least one of the preset's formats (an assimp bridge without @gmvjs/assimp does not). */\n  presetAvailable(p: GamePreset): boolean { return p.formats.some((id) => !!this.format(id)); }\n  /** Model extensions of the preset. */\n  presetExtensions(p: GamePreset): string[] {\n    if (p.extensions) return p.extensions;\n    return [...new Set(p.formats.flatMap((id) => this.format(id)?.extensions ?? []))];\n  }\n  /** External animation extensions of the preset. */\n  presetMotionExtensions(p: GamePreset): string[] {\n    return [...new Set(p.formats.flatMap((id) => this.format(id)?.motionExtensions ?? []))];\n  }\n  /** First preset that opens the format. */\n  presetForFormat(formatId: string, fileName?: string): GamePreset | undefined {\n    const ext = fileName ? extOf(fileName) : '';\n    return (ext && this.games.find((g) => g.formats.includes(formatId) && this.presetExtensions(g).includes(ext))) || this.games.find((g) => g.formats.includes(formatId));\n  }\n  /** Extensions found only on external animations (.omf, .psa, .md5anim), never on models. */\n  get motionOnlyExtensions(): string[] {\n    const models = new Set(this.formats.flatMap((f) => f.extensions));\n    return [...new Set(this.formats.flatMap((f) => f.motionExtensions ?? []))].filter((e) => !models.has(e));\n  }\n  get modelExtensions(): string[] {\n    return [...new Set(this.formats.flatMap((f) => [...f.extensions, ...(f.motionExtensions ?? [])]))];\n  }\n\n  /** Model by path pattern (extensionless MeshCache, classes/trucks/*.xml); formats limits it to the preset's formats. */\n  isPathModel(path: string, formats?: readonly string[]): boolean {\n    return this.formats.some((f) => f.pathPattern?.test(path) && (!formats || formats.includes(f.id)));\n  }\n\n  archiveExtensions(): string[] {\n    return [...new Set(this.archives.flatMap((a) => [...a.extensions, ...(a.companionExtensions ?? [])]))];\n  }\n  isArchive(name: string): boolean { return this.archiveExtensions().includes(extOf(name)); }\n  dictionaryFor(name: string): TextureDictionaryPlugin | undefined {\n    const ext = extOf(name);\n    return this.dictionaries.find((d) => d.extensions.includes(ext));\n  }\n  codecFor(name: string): ImageCodec | undefined {\n    const ext = extOf(name);\n    return this.codecs.find((c) => c.extensions.includes(ext));\n  }\n  /** Whether this is an image (by extension): plugin codecs + browser formats. */\n  isImage(name: string): boolean {\n    return !!this.codecFor(name) || /\\.(png|jpe?g|bmp|webp|gif)$/i.test(name);\n  }\n\n  /** Archive plugin for a file: by extension, by signature when ambiguous. */\n  async archiveFor(file: BlobFile): Promise<ArchivePlugin | null> {\n    const ext = extOf(file.name), cands = this.archives.filter((a) => a.extensions.includes(ext));\n    if (cands.length <= 1) return cands[0] ?? null;\n    const head = await readHead(file, 64);\n    let best: ArchivePlugin | null = null, score = -1;\n    for (const a of cands) {\n      const s = a.sniff ? a.sniff(head, file.name) : 0.1;\n      if (s > score) { score = s; best = a; }\n    }\n    // signature not recognized: ZIP is read from the end of the file (directory), so it is the fallback, as in v11\n    return score > 0 ? best : cands.find((a) => a.id === 'zip') ?? null;\n  }\n\n  /**\n   * Detect the model format: candidates by extension, refined by signature,\n   * with a bonus for the preferred preset's formats. Without an extension all signatures are tried.\n   */\n  async detect(file: VFile | BlobFile, prefer: readonly string[] = []): Promise<Detection | null> {\n    const ext = extOf(file.name);\n    let cands = this.formats.filter((f) => f.extensions.includes(ext));\n    const byMagicOnly = !cands.length;\n    if (byMagicOnly) cands = this.formats.filter((f) => f.sniff);\n    if (!cands.length) return null;\n    // always check the signature when a candidate supports it: otherwise a text Doom 3 .skin goes to CryEngine .skin\n    const needHead = byMagicOnly || cands.some((c) => c.sniff);\n    const head = needHead ? await readHead(file, 256) : null;\n    const scored = cands\n      .map((format) => {\n        let c = byMagicOnly ? 0 : 0.5;\n        if (head && format.sniff) {\n          const s = format.sniff(head, file.name);\n          if (s <= 0) return { format, confidence: 0 };\n          c += (byMagicOnly ? 1 : 0.5) * s;\n        }\n        if (prefer.includes(format.id)) c += 0.25;\n        return { format, confidence: Math.min(1, c), rank: c };\n      })\n      .filter((x) => x.confidence > (byMagicOnly ? 0.6 : 0))\n      // order by the uncapped score: with an equal signature the preset decides (PSK is the same in Unreal 1–5)\n      .sort((a, b) => (b.rank ?? 0) - (a.rank ?? 0))\n      .map(({ format, confidence }) => ({ format, confidence }));\n    if (!scored.length) return null;\n    return { format: scored[0]!.format, confidence: scored[0]!.confidence, candidates: scored };\n  }\n\n  /** Decode an image: plugin codecs, then the browser's createImageBitmap. */\n  async decodeImage(file: VFile): Promise<DecodedImage> {\n    if (file.decoded) return file.decoded;\n    const buf = await file.arrayBuffer(), codec = this.codecFor(file.name);\n    if (codec) return codec.decode(buf, file.name);\n    if (typeof createImageBitmap !== 'function') throw new Error(`нет декодера для ${file.name}`);\n    const bitmap = await createImageBitmap(new Blob([buf]), { premultiplyAlpha: 'none', colorSpaceConversion: 'none' });\n    return { bitmap, width: bitmap.width, height: bitmap.height };\n  }\n}\n"],"names":["e"],"mappings":"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"}