@lycoristech/azurapi 0.1.1 → 0.1.3

package/data/version.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-10-05T03:53:22.456Z",
-  "shipCount": 752,
+  "generatedAt": "2026-10-11T04:44:04.078Z",
+  "shipCount": 889,
   "schemaVersion": "0.0.1"
 }

package/dist/cjs/client/AzurData.js

@@ -6,12 +6,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AzurData = void 0;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
+const node_url_1 = require("node:url");
 const ships_js_1 = require("./ships.js");
 const fetcher_js_1 = require("./fetcher.js");
+/**
+ * Path of this source file as seen in a stack trace: a file:// URL under ESM,
+ * a plain path under CJS. This file is compiled to both formats from one
+ * source, so `import.meta.url` cannot be written here (it is a syntax error
+ * in the CJS build), and `__dirname` only exists in CJS.
+ */
+function thisFileFromStack() {
+    const stack = new Error().stack ?? "";
+    for (const line of stack.split("\n").slice(1)) {
+        const m = line.match(/\(?((?:file:\/\/)?\/[^):]+?\.[cm]?[jt]s):\d+:\d+\)?$/);
+        if (m?.[1] !== undefined)
+            return m[1].startsWith("file://") ? (0, node_url_1.fileURLToPath)(m[1]) : m[1];
+    }
+    return undefined;
+}
 function resolveThisDir() {
-    // CJS: __dirname is injected by Node
-    // ESM under tsx/ts-node: __dirname is polyfilled
-    // Pure ESM: falls back to cwd
     try {
         // eslint-disable-next-line @typescript-eslint/ban-ts-comment
         // @ts-ignore __dirname exists in CJS but not in ESM type defs
@@ -19,7 +32,10 @@ function resolveThisDir() {
             return __dirname; // eslint-disable-line no-undef
     }
     catch { /* not CJS */ }
-    return process.cwd();
+    const file = thisFileFromStack();
+    if (file !== undefined)
+        return node_path_1.default.dirname(file);
+    return process.cwd(); // last resort; resolveDefaultDataPath walks up from here
 }
 class AzurData {
     ships;

package/dist/cjs/client/ships.js

@@ -4,7 +4,44 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Ships = void 0;
+exports.isCloseName = isCloseName;
 const fuse_js_1 = __importDefault(require("fuse.js"));
+/** Optimal-string-alignment distance (Levenshtein + adjacent transposition). */
+function editDistance(a, b) {
+    const rows = a.length + 1, cols = b.length + 1;
+    const d = Array.from({ length: rows }, (_, i) => Array.from({ length: cols }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
+    for (let i = 1; i < rows; i++) {
+        for (let j = 1; j < cols; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            d[i][j] = Math.min(d[i - 1][j] + 1, d[i][j - 1] + 1, d[i - 1][j - 1] + cost);
+            if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
+                d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + 1);
+            }
+        }
+    }
+    return d[rows - 1][cols - 1];
+}
+/**
+ * True when `query` is a prefix of one of the ship's names (3+ chars) or within
+ * typo distance of one: 1 edit for 4-5 chars, 2 edits for 6+. Shorter queries
+ * never fuzzy-match; they must hit an id or a name exactly.
+ */
+function isCloseName(query, ship) {
+    const q = query.trim().toLowerCase();
+    if (q.length < 3)
+        return false;
+    const maxEdits = q.length >= 6 ? 2 : q.length >= 4 ? 1 : 0;
+    for (const raw of Object.values(ship.names)) {
+        if (typeof raw !== "string")
+            continue;
+        const n = raw.toLowerCase();
+        if (n.startsWith(q))
+            return true;
+        if (maxEdits > 0 && Math.abs(n.length - q.length) <= maxEdits && editDistance(q, n) <= maxEdits)
+            return true;
+    }
+    return false;
+}
 class Ships {
     data;
     idMap;
@@ -45,10 +82,13 @@ class Ships {
         const ciId = ciIdMap[lower];
         if (ciId && this.data[ciId])
             return this.data[ciId];
-        // 4. Fuse.js fuzzy
+        // 4. Fuse.js fuzzy, but only for a typo-level edit distance or a name prefix.
+        //    Fuse scores substrings as perfect matches ("22" -> U-522 at 0.000, "Kuon"
+        //    -> Kronshtadt at 0.003), which a lookup must not return.
         const results = this.fuse.search(nameOrId, { limit: 1 });
-        if (results.length > 0 && results[0].score !== undefined && results[0].score < 0.5) {
-            return results[0].item;
+        const hit = results[0];
+        if (hit !== undefined && hit.score !== undefined && hit.score < 0.5 && isCloseName(nameOrId, hit.item)) {
+            return hit.item;
         }
         return undefined;
     }

package/dist/cjs/normalize/identity.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveThumbnail = resolveThumbnail;
 exports.normalizeIdentity = normalizeIdentity;
 const config_js_1 = require("../config.js");
 const enums_js_1 = require("../translate/enums.js");
@@ -11,11 +12,33 @@ const strings_js_1 = require("../translate/strings.js");
 function isLikelyChinese(s) {
     return /[\u4e00-\u9fff]/.test(s);
 }
+/**
+ * Pick the thumbnail filename stem for a ship.
+ *
+ * Shipyard icons in azurlane-images are named after the texture inside the
+ * bundle: historically the numeric group id (20212.png), but newer bundles use
+ * the skin's painting name (weikesibao.png, z14.png, 2B.png). Prefer the id so
+ * existing URLs stay stable, fall back to the default skin's painting name, and
+ * keep the id when nothing is known (no images clone at build time).
+ */
+function resolveThumbnail(groupType, defaultPainting, available) {
+    if (available === undefined)
+        return groupType;
+    const byId = available.get(groupType.toLowerCase());
+    if (byId !== undefined)
+        return byId;
+    if (defaultPainting !== undefined) {
+        const byPainting = available.get(defaultPainting.toLowerCase());
+        if (byPainting !== undefined)
+            return byPainting;
+    }
+    return groupType;
+}
 // ---------------------------------------------------------------------------
 // Main
 // ---------------------------------------------------------------------------
 function normalizeIdentity(inputs) {
-    const { groupType, rowIds, en, cn, jp, isEnReleased, isResearch, groupRow, lookups, } = inputs;
+    const { groupType, rowIds, en, cn, jp, isEnReleased, isResearch, groupRow, lookups, availableThumbnails, } = inputs;
     // ------------------------------------------------------------------
     // Resolve the LB3 row ID — the row whose key ends with "4", or last entry.
     // ------------------------------------------------------------------
@@ -35,11 +58,12 @@ function normalizeIdentity(inputs) {
     let nameEn;
     const rawName = enStats.name;
     const rawEnglishName = enStats.english_name;
+    // Names are trimmed: upstream has trailing spaces on ~40 rows ("Foch ", "Le Malin μ ", ...)
     if (!isLikelyChinese(rawName) && rawName.trim().length > 0) {
-        nameEn = rawName;
+        nameEn = rawName.trim();
     }
     else if (rawEnglishName !== undefined && rawEnglishName.trim().length > 0 && !isLikelyChinese(rawEnglishName)) {
-        nameEn = rawEnglishName;
+        nameEn = rawEnglishName.trim();
     }
     // else: both are Chinese/empty → nameEn stays undefined
     // CN name: from cn.statistics matching row if it looks Chinese; else fall back
@@ -48,22 +72,22 @@ function normalizeIdentity(inputs) {
     if (cn !== undefined) {
         const cnStats = cn.statistics[lb3RowId];
         if (cnStats !== undefined && cnStats.name.trim().length > 0 && isLikelyChinese(cnStats.name)) {
-            nameCn = cnStats.name;
+            nameCn = cnStats.name.trim();
         }
     }
     if (nameCn === undefined && isLikelyChinese(rawName)) {
-        nameCn = rawName;
+        nameCn = rawName.trim();
     }
     // JP name: from jp.statistics matching row if provided
     let nameJp;
     if (jp !== undefined) {
         const jpStats = jp.statistics[lb3RowId];
         if (jpStats !== undefined && jpStats.name.trim().length > 0) {
-            nameJp = jpStats.name;
+            nameJp = jpStats.name.trim();
         }
     }
     // Code: english_name from EN statistics
-    const nameCode = rawEnglishName !== undefined && rawEnglishName.trim().length > 0 ? rawEnglishName : undefined;
+    const nameCode = rawEnglishName !== undefined && rawEnglishName.trim().length > 0 ? rawEnglishName.trim() : undefined;
     const names = {};
     if (nameEn !== undefined)
         names.en = nameEn;
@@ -98,7 +122,10 @@ function normalizeIdentity(inputs) {
     // ------------------------------------------------------------------
     // Nationality
     // ------------------------------------------------------------------
-    const nationality = (0, enums_js_1.nationalityName)(groupRow.nationality);
+    // The per-ship statistics row is authoritative; ship_data_group is the fallback.
+    // They disagree for exactly one ship in EN 9.3.384: Musashi-chan (30517), where the
+    // group row says Iron Blood and the ship row says Sakura Empire.
+    const nationality = (0, enums_js_1.nationalityName)(enStats.nationality ?? groupRow.nationality);
     // ------------------------------------------------------------------
     // Wiki URL
     // ------------------------------------------------------------------
@@ -106,7 +133,8 @@ function normalizeIdentity(inputs) {
     // ------------------------------------------------------------------
     // Thumbnail (shipyard icon from azurlane-images repo)
     // ------------------------------------------------------------------
-    const thumbnail = `${config_js_1.THUMBNAILS_URL}/${groupType}.png`;
+    const defaultPainting = en.skinTemplate?.[`${groupType}0`]?.painting;
+    const thumbnail = `${config_js_1.THUMBNAILS_URL}/${resolveThumbnail(groupType, defaultPainting, availableThumbnails)}.png`;
     // ------------------------------------------------------------------
     // Build output
     // ------------------------------------------------------------------

package/dist/cjs/normalize/ship.js

@@ -33,6 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLimitBreakRow = isLimitBreakRow;
 exports.buildShip = buildShip;
 exports.buildAllShips = buildAllShips;
 exports.createBuildContext = createBuildContext;
@@ -45,6 +46,26 @@ const construction_js_1 = require("./construction.js");
 const retrofit_js_1 = require("./retrofit.js");
 const misc_js_1 = require("./misc.js");
 const skins_js_1 = require("./skins.js");
+// ---------------------------------------------------------------------------
+// Limit-break row detection
+// ---------------------------------------------------------------------------
+/**
+ * True when `key` is one of a group's real limit-break rows: the group_type
+ * followed by a single LB digit (1-4), e.g. 20212 -> 202121..202124.
+ *
+ * Anything else is an alt/promo form of a ship that also has real LB rows
+ * (the 900xxx block: 900004 -> Suffolk, 900465 -> Adventure Galley, ...).
+ *
+ * Do NOT filter on a "9" prefix instead: Vichya Dominion (9xxxx), Tempesta
+ * (960xxx) and META (97xxxx) ships all have their real LB rows at 9-prefixed
+ * ids. That heuristic silently dropped all 99 of them (issue #2).
+ */
+function isLimitBreakRow(key, groupType) {
+    if (key.length !== groupType.length + 1 || !key.startsWith(groupType))
+        return false;
+    const lb = key[key.length - 1];
+    return lb === "1" || lb === "2" || lb === "3" || lb === "4";
+}
 function buildIndexes(ctx) {
     // Build groupByGroupType: scan ship_data_group and index by group_type
     const groupByGroupType = new Map();
@@ -75,8 +96,8 @@ function buildShip(groupType, ctx, indexes) {
             continue;
         if (String(row.group_type) !== groupType)
             continue;
-        // Skip 9-prefix rows (promo/alt forms)
-        if (key.startsWith("9"))
+        // Keep only the real LB rows; skips the 900xxx alt/promo forms
+        if (!isLimitBreakRow(key, groupType))
             continue;
         rowIds.push(key);
     }
@@ -146,7 +167,9 @@ function buildShip(groupType, ctx, indexes) {
             fleetTechShipTemplate: ctx.en.fleetTechShipTemplate,
             fleetTechShipClass: ctx.en.fleetTechShipClass,
             shipDataByType: ctx.en.shipDataByType,
+            skinTemplate: ctx.en.skinTemplate,
         },
+        availableThumbnails: ctx.availableThumbnails,
         cn: ctx.cn !== undefined ? { statistics: ctx.cn.statistics } : undefined,
         jp: ctx.jp !== undefined ? { statistics: ctx.jp.statistics } : undefined,
         isEnReleased,
@@ -289,14 +312,16 @@ function buildShip(groupType, ctx, indexes) {
 function buildAllShips(ctx) {
     // Pre-build shared indexes once for O(n) total cost
     const indexes = buildIndexes(ctx);
-    // Collect all unique group_types from EN template, excluding 9-prefix rows
+    // Collect all unique group_types that have real LB rows in the EN template
+    // (alt/promo 900xxx rows are ignored; see isLimitBreakRow)
     const groupTypeSet = new Set();
     for (const [key, row] of Object.entries(ctx.en.template)) {
         if (row === undefined)
             continue;
-        if (key.startsWith("9"))
+        const groupType = String(row.group_type);
+        if (!isLimitBreakRow(key, groupType))
             continue;
-        groupTypeSet.add(String(row.group_type));
+        groupTypeSet.add(groupType);
     }
     const ships = [];
     let failCount = 0;

package/dist/cjs/output/writeIdMap.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildIdMap = buildIdMap;
 exports.writeIdMap = writeIdMap;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
@@ -10,27 +11,33 @@ const path_1 = __importDefault(require("path"));
 // writeIdMap
 // ---------------------------------------------------------------------------
 /**
- * Write a name/alias → canonical id map to disk.
+ * Build the name/alias → canonical id map.
  *
  * Shape: Record<string, string>
  *
  * For each ship: emits names.en → id, names.cn → id, names.jp → id, names.code → id
  * For each groupRow: emits padded code → group_type string (legacy AzurAPI lookup)
  *
- * Last-writer-wins for duplicate names.
+ * Collisions: first-writer-wins, with ships visited in ascending numeric id order.
+ * Core factions have 5-digit ids, META 6-digit (97xxxx) and collabs 7-digit, so a
+ * shared display name resolves to the core-faction ship: "Enterprise" → USS
+ * Enterprise (10706) not HMS Enterprise (20232), "Neptune" → HMS Neptune (29901)
+ * not the Neptunia collab (1010001), likewise Fubuki and Kasumi. The other ship
+ * stays reachable through its names.code ("HMS Enterprise", "HDN Neptune", ...)
+ * or its id. Code names never shadow another ship's display name.
  */
-function writeIdMap(ships, groupRows, outputPath = "data/id-map.json") {
+function buildIdMap(ships, groupRows) {
     const map = {};
+    const ordered = [...ships].sort((a, b) => Number(a.id) - Number(b.id));
     // Collect all EN names first so we don't let names.code overwrite a real ship name
     const enNames = new Set();
-    for (const ship of ships) {
+    for (const ship of ordered) {
         if (ship.names.en !== undefined)
             enNames.add(ship.names.en);
     }
-    // Per-ship name entries (first-writer-wins for code names to avoid collisions)
-    for (const ship of ships) {
+    for (const ship of ordered) {
         const { id, names } = ship;
-        if (names.en !== undefined)
+        if (names.en !== undefined && !(names.en in map))
             map[names.en] = id;
         if (names.cn !== undefined && !(names.cn in map))
             map[names.cn] = id;
@@ -45,7 +52,11 @@ function writeIdMap(ships, groupRows, outputPath = "data/id-map.json") {
         const paddedCode = String(row.code).padStart(3, "0");
         map[paddedCode] = String(row.group_type);
     }
-    const json = JSON.stringify(map, null, 2);
+    return map;
+}
+/** Write the id map (see buildIdMap) to disk. */
+function writeIdMap(ships, groupRows, outputPath = "data/id-map.json") {
+    const json = JSON.stringify(buildIdMap(ships, groupRows), null, 2);
     const dir = path_1.default.dirname(path_1.default.resolve(outputPath));
     fs_1.default.mkdirSync(dir, { recursive: true });
     fs_1.default.writeFileSync(outputPath, json, "utf-8");

package/dist/cjs/translate/enums.js

@@ -36,7 +36,14 @@ function rarityName(rarity, isResearch) {
 // ---------------------------------------------------------------------------
 // Nationality
 // ---------------------------------------------------------------------------
-/** Nationality int → display string. Matches Azur Lane wiki convention. */
+/**
+ * Nationality int → display string. Matches Azur Lane wiki convention.
+ *
+ * Codes verified against upstream ship_data_group.json + ship_data_statistics.json
+ * (AzurLaneTools/AzurLaneData 4cca5c24, 2026-05-08) and the game's own faction list in
+ * sharecfgdata/gametip.lua (EN 9.3.384); see tests/translate/enums.test.ts.
+ * Each collab has its own code from 101 upward, in release order.
+ */
 exports.NATIONALITY_MAP = {
     0: "Universal",
     1: "Eagle Union",
@@ -50,21 +57,26 @@ exports.NATIONALITY_MAP = {
     9: "Vichya Dominion",
     10: "Iris Orthodoxy",
     11: "Kingdom of Tulipa",
-    96: "Universal",
-    97: "Tempesta",
-    98: "Universal",
-    101: "META",
-    102: "Universal",
-    103: "Universal",
-    104: "Universal",
-    105: "Neptunia",
-    106: "KizunaAI",
-    107: "Hololive",
-    108: "Venus Vacation",
-    109: "The Idolmaster",
-    110: "SSSS",
-    111: "Atelier Ryza",
-    112: "Senran Kagura",
+    12: "Liga de Pedrería", // Valparaíso (new faction, EN 9.3.384)
+    96: "Tempesta", // MOT Royal Fortune, Golden Hind, ...
+    97: "META", // Hunter.META, Fortune.META, ...
+    98: "Universal", // Bulins
+    101: "Neptunia", // HDN Neptune, Noire, Blanc, ...
+    102: "Bilibili", // 22, 33 (CN only)
+    103: "Utawarerumono", // Kuon, Nekone, Rurutie, ... (CN/JP only)
+    104: "KizunaAI",
+    105: "Hololive", // Shirakami Fubuki, Tokino Sora, ...
+    106: "Venus Vacation", // Marie Rose, Honoka, ...
+    107: "The Idolmaster", // Haruka Amami, ...
+    108: "SSSS", // Rikka Takarada, ...
+    109: "Atelier Ryza", // Reisalin Stout, ...
+    110: "Senran Kagura", // Asuka, Ikaruga, ...
+    111: "To LOVE-Ru", // Lala Satalin Deviluke, ...
+    112: "Black Rock Shooter", // BLACK★ROCK SHOOTER, DEAD MASTER
+    113: "Atelier Yumia", // Yumia Liessfeldt, ...
+    114: "DanMachi", // Hestia, Ryu Lion
+    115: "Date A Live", // Tohka Yatogami, ...
+    117: "NieR:Automata", // A2, 2B (EN 9.3.384)
 };
 /** Look up a nationality code; falls back to "Universal". */
 function nationalityName(code) {

package/dist/client/AzurData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AzurData.d.ts","sourceRoot":"","sources":["../../src/client/AzurData.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAGlE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAcD,qBAAa,QAAQ;IACnB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB,iEAAiE;gBACrD,OAAO,GAAE,eAAoB;IAWzC;;;;;;;OAOG;WACU,IAAI,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmBvE,OAAO,CAAC,MAAM,CAAC,sBAAsB;CAUtC"}
+{"version":3,"file":"AzurData.d.ts","sourceRoot":"","sources":["../../src/client/AzurData.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAGlE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA4BD,qBAAa,QAAQ;IACnB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB,iEAAiE;gBACrD,OAAO,GAAE,eAAoB;IAWzC;;;;;;;OAOG;WACU,IAAI,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmBvE,OAAO,CAAC,MAAM,CAAC,sBAAsB;CAUtC"}

package/dist/client/AzurData.js

@@ -1,11 +1,24 @@
 import fs from "node:fs";
 import path from "node:path";
+import { fileURLToPath } from "node:url";
 import { Ships } from "./ships.js";
 import { fetchLatestData } from "./fetcher.js";
+/**
+ * Path of this source file as seen in a stack trace: a file:// URL under ESM,
+ * a plain path under CJS. This file is compiled to both formats from one
+ * source, so `import.meta.url` cannot be written here (it is a syntax error
+ * in the CJS build), and `__dirname` only exists in CJS.
+ */
+function thisFileFromStack() {
+    const stack = new Error().stack ?? "";
+    for (const line of stack.split("\n").slice(1)) {
+        const m = line.match(/\(?((?:file:\/\/)?\/[^):]+?\.[cm]?[jt]s):\d+:\d+\)?$/);
+        if (m?.[1] !== undefined)
+            return m[1].startsWith("file://") ? fileURLToPath(m[1]) : m[1];
+    }
+    return undefined;
+}
 function resolveThisDir() {
-    // CJS: __dirname is injected by Node
-    // ESM under tsx/ts-node: __dirname is polyfilled
-    // Pure ESM: falls back to cwd
     try {
         // eslint-disable-next-line @typescript-eslint/ban-ts-comment
         // @ts-ignore __dirname exists in CJS but not in ESM type defs
@@ -13,7 +26,10 @@ function resolveThisDir() {
             return __dirname; // eslint-disable-line no-undef
     }
     catch { /* not CJS */ }
-    return process.cwd();
+    const file = thisFileFromStack();
+    if (file !== undefined)
+        return path.dirname(file);
+    return process.cwd(); // last resort; resolveDefaultDataPath walks up from here
 }
 export class AzurData {
     ships;

package/dist/client/AzurData.js.map

@@ -1 +1 @@
-{"version":3,"file":"AzurData.js","sourceRoot":"","sources":["../../src/client/AzurData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,eAAe,EAAqB,MAAM,cAAc,CAAC;AAYlE,SAAS,cAAc;IACrB,qCAAqC;IACrC,iDAAiD;IACjD,8BAA8B;IAC9B,IAAI,CAAC;QACH,6DAA6D;QAC7D,8DAA8D;QAC9D,IAAI,OAAO,SAAS,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC,CAAC,+BAA+B;IACtF,CAAC;IAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;IACzB,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,OAAO,QAAQ;IACV,KAAK,CAAQ;IAEtB,iEAAiE;IACjE,YAAY,UAA2B,EAAE;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC,sBAAsB,EAAE,CAAC;QACtE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAC1B,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAClC,CAAC;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAC1B,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CACjC,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAA+B,EAAE;QACjD,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,SAAS,EAAE,GAAG,OAAO,CAAC;QAErD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;YACjD,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAa,CAAC;gBAC9D,QAA6B,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC;oBAC/C,IAAI,EAAE,OAAO,CAAC,KAAK;oBACnB,KAAK,EAAE,OAAO,CAAC,KAAK;iBACrB,CAAC,CAAC;gBACH,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,OAAO,IAAI,QAAQ,EAAE,CAAC;IACxB,CAAC;IAEO,MAAM,CAAC,sBAAsB;QACnC,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;QACjC,IAAI,SAAS,GAAG,OAAO,CAAC;QACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;gBAAE,OAAO,QAAQ,CAAC;YACtE,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;CACF"}
+{"version":3,"file":"AzurData.js","sourceRoot":"","sources":["../../src/client/AzurData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,eAAe,EAAqB,MAAM,cAAc,CAAC;AAYlE;;;;;GAKG;AACH,SAAS,iBAAiB;IACxB,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC7E,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,6DAA6D;QAC7D,8DAA8D;QAC9D,IAAI,OAAO,SAAS,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC,CAAC,+BAA+B;IACtF,CAAC;IAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;IACjC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,yDAAyD;AACjF,CAAC;AAED,MAAM,OAAO,QAAQ;IACV,KAAK,CAAQ;IAEtB,iEAAiE;IACjE,YAAY,UAA2B,EAAE;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC,sBAAsB,EAAE,CAAC;QACtE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAC1B,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAClC,CAAC;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAC1B,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CACjC,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAA+B,EAAE;QACjD,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,SAAS,EAAE,GAAG,OAAO,CAAC;QAErD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;YACjD,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAa,CAAC;gBAC9D,QAA6B,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC;oBAC/C,IAAI,EAAE,OAAO,CAAC,KAAK;oBACnB,KAAK,EAAE,OAAO,CAAC,KAAK;iBACrB,CAAC,CAAC;gBACH,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,OAAO,IAAI,QAAQ,EAAE,CAAC;IACxB,CAAC;IAEO,MAAM,CAAC,sBAAsB;QACnC,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;QACjC,IAAI,SAAS,GAAG,OAAO,CAAC;QACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;gBAAE,OAAO,QAAQ,CAAC;YACtE,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/client/ships.d.ts

@@ -4,6 +4,12 @@ export interface ShipsOptions {
     idMap: Record<string, string>;
     fuseThreshold?: number;
 }
+/**
+ * True when `query` is a prefix of one of the ship's names (3+ chars) or within
+ * typo distance of one: 1 edit for 4-5 chars, 2 edits for 6+. Shorter queries
+ * never fuzzy-match; they must hit an id or a name exactly.
+ */
+export declare function isCloseName(query: string, ship: Ship): boolean;
 export declare class Ships {
     private readonly data;
     private readonly idMap;

package/dist/client/ships.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ships.d.ts","sourceRoot":"","sources":["../../src/client/ships.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,OAAO,EAAE,YAAY;IAoBjC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAyBvC,OAAO,CAAC,QAAQ,CAAC,CAAyB;IAC1C,OAAO,CAAC,UAAU;IAUlB,MAAM,IAAI,IAAI,EAAE;IAIhB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC,KAAK,IAAI,MAAM;IAKf,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,IAAI,EAAE;CAI1C"}
+{"version":3,"file":"ships.d.ts","sourceRoot":"","sources":["../../src/client/ships.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAkBD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAW9D;AAED,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,OAAO,EAAE,YAAY;IAoBjC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IA4BvC,OAAO,CAAC,QAAQ,CAAC,CAAyB;IAC1C,OAAO,CAAC,UAAU;IAUlB,MAAM,IAAI,IAAI,EAAE;IAIhB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC,KAAK,IAAI,MAAM;IAKf,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,IAAI,EAAE;CAI1C"}

package/dist/client/ships.js

@@ -1,4 +1,40 @@
 import Fuse from "fuse.js";
+/** Optimal-string-alignment distance (Levenshtein + adjacent transposition). */
+function editDistance(a, b) {
+    const rows = a.length + 1, cols = b.length + 1;
+    const d = Array.from({ length: rows }, (_, i) => Array.from({ length: cols }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
+    for (let i = 1; i < rows; i++) {
+        for (let j = 1; j < cols; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            d[i][j] = Math.min(d[i - 1][j] + 1, d[i][j - 1] + 1, d[i - 1][j - 1] + cost);
+            if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
+                d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + 1);
+            }
+        }
+    }
+    return d[rows - 1][cols - 1];
+}
+/**
+ * True when `query` is a prefix of one of the ship's names (3+ chars) or within
+ * typo distance of one: 1 edit for 4-5 chars, 2 edits for 6+. Shorter queries
+ * never fuzzy-match; they must hit an id or a name exactly.
+ */
+export function isCloseName(query, ship) {
+    const q = query.trim().toLowerCase();
+    if (q.length < 3)
+        return false;
+    const maxEdits = q.length >= 6 ? 2 : q.length >= 4 ? 1 : 0;
+    for (const raw of Object.values(ship.names)) {
+        if (typeof raw !== "string")
+            continue;
+        const n = raw.toLowerCase();
+        if (n.startsWith(q))
+            return true;
+        if (maxEdits > 0 && Math.abs(n.length - q.length) <= maxEdits && editDistance(q, n) <= maxEdits)
+            return true;
+    }
+    return false;
+}
 export class Ships {
     data;
     idMap;
@@ -39,10 +75,13 @@ export class Ships {
         const ciId = ciIdMap[lower];
         if (ciId && this.data[ciId])
             return this.data[ciId];
-        // 4. Fuse.js fuzzy
+        // 4. Fuse.js fuzzy, but only for a typo-level edit distance or a name prefix.
+        //    Fuse scores substrings as perfect matches ("22" -> U-522 at 0.000, "Kuon"
+        //    -> Kronshtadt at 0.003), which a lookup must not return.
         const results = this.fuse.search(nameOrId, { limit: 1 });
-        if (results.length > 0 && results[0].score !== undefined && results[0].score < 0.5) {
-            return results[0].item;
+        const hit = results[0];
+        if (hit !== undefined && hit.score !== undefined && hit.score < 0.5 && isCloseName(nameOrId, hit.item)) {
+            return hit.item;
         }
         return undefined;
     }

package/dist/client/ships.js.map

@@ -1 +1 @@
-{"version":3,"file":"ships.js","sourceRoot":"","sources":["../../src/client/ships.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ships.js","sourceRoot":"","sources":["../../src/client/ships.ts"],"names":[],"mappings":"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"}

package/dist/normalize/identity.d.ts

@@ -1,5 +1,5 @@
 import type { Ship } from "../schema/output/ship.js";
-import type { ShipDataTemplate, ShipDataStatistics, ShipDataGroup, ShipDataBlueprint, FleetTechShipTemplate, FleetTechShipClass, ShipDataByType, ShipDataGroupValue } from "../schema/raw/index.js";
+import type { ShipDataTemplate, ShipDataStatistics, ShipDataGroup, ShipDataBlueprint, FleetTechShipTemplate, FleetTechShipClass, ShipDataByType, ShipDataGroupValue, ShipSkinTemplate } from "../schema/raw/index.js";
 import type { Lookups } from "../translate/lookups.js";
 export interface IdentityInputs {
     groupType: string;
@@ -13,7 +13,14 @@ export interface IdentityInputs {
         fleetTechShipTemplate: FleetTechShipTemplate;
         fleetTechShipClass: FleetTechShipClass;
         shipDataByType: ShipDataByType;
+        /** Needed to resolve the thumbnail by the default skin's painting name. */
+        skinTemplate?: ShipSkinTemplate;
     };
+    /**
+     * Thumbnail files present in the images repo: lowercase stem -> actual filename stem.
+     * When given, the thumbnail URL only points at a file that exists (see resolveThumbnail).
+     */
+    availableThumbnails?: Map<string, string>;
     cn?: {
         statistics: ShipDataStatistics;
     };
@@ -41,5 +48,15 @@ export interface IdentityOutput {
     thumbnail: string;
     isEnReleased?: boolean;
 }
+/**
+ * Pick the thumbnail filename stem for a ship.
+ *
+ * Shipyard icons in azurlane-images are named after the texture inside the
+ * bundle: historically the numeric group id (20212.png), but newer bundles use
+ * the skin's painting name (weikesibao.png, z14.png, 2B.png). Prefer the id so
+ * existing URLs stay stable, fall back to the default skin's painting name, and
+ * keep the id when nothing is known (no images clone at build time).
+ */
+export declare function resolveThumbnail(groupType: string, defaultPainting: string | undefined, available: Map<string, string> | undefined): string;
 export declare function normalizeIdentity(inputs: IdentityInputs): IdentityOutput;
 //# sourceMappingURL=identity.d.ts.map

package/dist/normalize/identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/normalize/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAQvD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,EAAE,EAAE;QACF,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,UAAU,EAAE,kBAAkB,CAAC;QAC/B,KAAK,EAAE,aAAa,CAAC;QACrB,SAAS,EAAE,iBAAiB,CAAC;QAC7B,qBAAqB,EAAE,qBAAqB,CAAC;QAC7C,kBAAkB,EAAE,kBAAkB,CAAC;QACvC,cAAc,EAAE,cAAc,CAAC;KAChC,CAAC;IACF,EAAE,CAAC,EAAE;QACH,UAAU,EAAE,kBAAkB,CAAC;KAChC,CAAC;IACF,EAAE,CAAC,EAAE;QACH,UAAU,EAAE,kBAAkB,CAAC;KAChC,CAAC;IACF,wDAAwD;IACxD,YAAY,EAAE,OAAO,CAAC;IACtB,oEAAoE;IACpE,UAAU,EAAE,OAAO,CAAC;IACpB,mFAAmF;IACnF,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAeD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAgJxE"}
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/normalize/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAQvD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,EAAE,EAAE;QACF,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,UAAU,EAAE,kBAAkB,CAAC;QAC/B,KAAK,EAAE,aAAa,CAAC;QACrB,SAAS,EAAE,iBAAiB,CAAC;QAC7B,qBAAqB,EAAE,qBAAqB,CAAC;QAC7C,kBAAkB,EAAE,kBAAkB,CAAC;QACvC,cAAc,EAAE,cAAc,CAAC;QAC/B,2EAA2E;QAC3E,YAAY,CAAC,EAAE,gBAAgB,CAAC;KACjC,CAAC;IACF;;;OAGG;IACH,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,EAAE,CAAC,EAAE;QACH,UAAU,EAAE,kBAAkB,CAAC;KAChC,CAAC;IACF,EAAE,CAAC,EAAE;QACH,UAAU,EAAE,kBAAkB,CAAC;KAChC,CAAC;IACF,wDAAwD;IACxD,YAAY,EAAE,OAAO,CAAC;IACtB,oEAAoE;IACpE,UAAU,EAAE,OAAO,CAAC;IACpB,mFAAmF;IACnF,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAWD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GACzC,MAAM,CASR;AAMD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAsJxE"}