@lycoristech/azurdata 0.0.1

package/dist/normalize/ship.js

@@ -0,0 +1,369 @@
+import { ShipSchema } from "../schema/output/ship.js";
+import { normalizeIdentity } from "./identity.js";
+import { normalizeStats } from "./stats.js";
+import { normalizeSlots } from "./slots.js";
+import { normalizeSkills } from "./skills.js";
+import { normalizeConstruction } from "./construction.js";
+import { normalizeRetrofit } from "./retrofit.js";
+import { normalizeMisc } from "./misc.js";
+import { normalizeSkins } from "./skins.js";
+function buildIndexes(ctx) {
+    // Build groupByGroupType: scan ship_data_group and index by group_type
+    const groupByGroupType = new Map();
+    for (const row of Object.values(ctx.en.group)) {
+        if (row === undefined)
+            continue;
+        groupByGroupType.set(String(row.group_type), row);
+    }
+    // Build researchGroupTypes: blueprint keys are themselves group_types
+    // (confirmed: all 42 blueprint keys appear as group_type values in ship_data_template)
+    const researchGroupTypes = new Set();
+    const blueprintVersionMap = new Map();
+    for (const [key, bpRow] of Object.entries(ctx.en.blueprint)) {
+        researchGroupTypes.add(key);
+        if (bpRow?.blueprint_version !== undefined) {
+            blueprintVersionMap.set(key, bpRow.blueprint_version);
+        }
+    }
+    return { groupByGroupType, researchGroupTypes, blueprintVersionMap };
+}
+// ---------------------------------------------------------------------------
+// buildShip
+// ---------------------------------------------------------------------------
+export function buildShip(groupType, ctx, indexes) {
+    const idx = indexes ?? buildIndexes(ctx);
+    // -------------------------------------------------------------------------
+    // 1. Resolve LB rows for this group_type
+    // -------------------------------------------------------------------------
+    const rowIds = [];
+    for (const [key, row] of Object.entries(ctx.en.template)) {
+        if (row === undefined)
+            continue;
+        if (String(row.group_type) !== groupType)
+            continue;
+        // Skip 9-prefix rows (promo/alt forms)
+        if (key.startsWith("9"))
+            continue;
+        rowIds.push(key);
+    }
+    if (rowIds.length === 0) {
+        return null;
+    }
+    // Sort by last digit (LB stage suffix: 1/2/3/4)
+    rowIds.sort((a, b) => {
+        const lastA = a[a.length - 1] ?? "0";
+        const lastB = b[b.length - 1] ?? "0";
+        return lastA.localeCompare(lastB);
+    });
+    // lb0RowId = row ending in "1", lb3RowId = row ending in "4"
+    const lb0RowId = rowIds.find((id) => id.endsWith("1")) ?? rowIds[0];
+    const lb3RowId = rowIds.find((id) => id.endsWith("4")) ?? rowIds[rowIds.length - 1];
+    if (lb0RowId === undefined || lb3RowId === undefined) {
+        return null;
+    }
+    // -------------------------------------------------------------------------
+    // 2. Resolve the group row (pre-indexed)
+    // -------------------------------------------------------------------------
+    const groupRow = idx.groupByGroupType.get(groupType);
+    if (groupRow === undefined) {
+        return null;
+    }
+    // -------------------------------------------------------------------------
+    // 3. Determine isResearch and blueprintVersion
+    // -------------------------------------------------------------------------
+    const isResearch = idx.researchGroupTypes.has(groupType);
+    const blueprintVersion = idx.blueprintVersionMap.get(groupType);
+    // -------------------------------------------------------------------------
+    // 4. Determine isEnReleased
+    //    True if the LB3 statistics row has a non-empty, non-Chinese name
+    // -------------------------------------------------------------------------
+    function isLikelyChinese(s) {
+        return /[\u4e00-\u9fff]/.test(s);
+    }
+    const lb3Stats = ctx.en.statistics[lb3RowId];
+    const lb3Name = lb3Stats?.name ?? "";
+    const isEnReleased = lb3Name.trim().length > 0 && !isLikelyChinese(lb3Name);
+    // -------------------------------------------------------------------------
+    // 5. Determine strengthen_id from lb0 template row
+    // -------------------------------------------------------------------------
+    const lb0Template = ctx.en.template[lb0RowId];
+    const strengthenId = lb0Template !== undefined
+        ? String(lb0Template.strengthen_id)
+        : groupType;
+    // ship type from lb3 template
+    const lb3Template = ctx.en.template[lb3RowId];
+    const shipType = lb3Template?.type ?? 0;
+    const starMax = lb3Template?.star_max ?? 6;
+    // initialStar: use rarity (from statistics) for the scrap medal lookup.
+    // AzurAPI historically mapped rarity → ship_data_by_star tier for medals:
+    // rarity 5 (Super Rare) → star 5 → 10 medals.
+    const initialStar = lb3Stats?.rarity ?? starMax;
+    // -------------------------------------------------------------------------
+    // 6. Call each normalizer
+    // -------------------------------------------------------------------------
+    // Identity
+    const identityOutput = normalizeIdentity({
+        groupType,
+        rowIds,
+        en: {
+            template: ctx.en.template,
+            statistics: ctx.en.statistics,
+            group: ctx.en.group,
+            blueprint: ctx.en.blueprint,
+            fleetTechShipTemplate: ctx.en.fleetTechShipTemplate,
+            fleetTechShipClass: ctx.en.fleetTechShipClass,
+            shipDataByType: ctx.en.shipDataByType,
+        },
+        cn: ctx.cn !== undefined ? { statistics: ctx.cn.statistics } : undefined,
+        jp: ctx.jp !== undefined ? { statistics: ctx.jp.statistics } : undefined,
+        isEnReleased,
+        isResearch,
+        blueprintVersion,
+        groupRow,
+        lookups: ctx.lookups,
+    });
+    // Stats
+    const statsOutput = normalizeStats({
+        lb3RowId,
+        groupType,
+        strengthenId,
+        en: {
+            statistics: ctx.en.statistics,
+            strengthen: ctx.en.strengthen,
+            trans: ctx.en.trans,
+            transformDataTemplate: ctx.en.transformDataTemplate,
+        },
+    });
+    // Slots
+    const slots = normalizeSlots({
+        lb0RowId,
+        lb3RowId,
+        template: ctx.en.template,
+        statistics: ctx.en.statistics,
+        lookups: ctx.lookups,
+    });
+    // Skills
+    const skillsOutput = normalizeSkills({
+        rowIds,
+        groupType,
+        en: {
+            template: ctx.en.template,
+            breakout: ctx.en.breakout,
+            skillDataTemplate: ctx.en.skillDataTemplate,
+            skillDataDisplay: ctx.en.skillDataDisplay,
+            trans: ctx.en.trans,
+            transformDataTemplate: ctx.en.transformDataTemplate,
+        },
+    });
+    // Construction
+    const constructionOutput = normalizeConstruction({
+        groupType,
+        groupRow,
+        lb3RowId,
+        shipType,
+        starMax,
+        initialStar,
+        fleetTechShipTemplate: ctx.en.fleetTechShipTemplate,
+        shipDataCreateExchange: ctx.en.exchange,
+        shipDataByType: ctx.en.shipDataByType,
+        shipDataByStar: ctx.en.shipDataByStar,
+        lookups: ctx.lookups,
+        constructionTimeOverride: ctx.overrides?.constructionTimes?.[groupType],
+    });
+    // Retrofit
+    const retrofitOutput = normalizeRetrofit({
+        groupType,
+        groupRow,
+        trans: ctx.en.trans,
+        lookups: ctx.lookups,
+    });
+    // Misc
+    const miscOutput = normalizeMisc({
+        defaultSkinId: `${groupType}0`,
+        skinTemplate: ctx.en.skinTemplate,
+        lookups: ctx.lookups,
+        artistOverride: ctx.overrides?.artists?.[groupType],
+    });
+    // Skins
+    const skinsOutput = normalizeSkins({
+        groupType,
+        skinTemplate: ctx.en.skinTemplate,
+        shopTemplate: ctx.en.shopTemplate,
+        thumbnailBaseUrl: ctx.thumbnailBaseUrl,
+        availablePaintings: ctx.availablePaintings,
+    });
+    // -------------------------------------------------------------------------
+    // 7. Merge all partials into a Ship object
+    // -------------------------------------------------------------------------
+    const shipCandidate = {
+        id: identityOutput.id,
+        names: identityOutput.names,
+        rarity: identityOutput.rarity,
+        stars: identityOutput.stars,
+        thumbnail: identityOutput.thumbnail,
+        class: identityOutput.class,
+        hullType: identityOutput.hullType,
+        nationality: identityOutput.nationality,
+        stats: statsOutput.stats,
+        enhanceValue: statsOutput.enhanceValue,
+        slots,
+        skills: skillsOutput.skills,
+        retrofit: retrofitOutput.retrofit,
+        skins: skinsOutput.skins,
+    };
+    if (identityOutput.wikiUrl !== undefined) {
+        shipCandidate.wikiUrl = identityOutput.wikiUrl;
+    }
+    if (identityOutput.isEnReleased === false) {
+        shipCandidate.isEnReleased = false;
+    }
+    if (skillsOutput.limitBreaks !== undefined) {
+        shipCandidate.limitBreaks = skillsOutput.limitBreaks;
+    }
+    if (constructionOutput.construction !== undefined) {
+        shipCandidate.construction = constructionOutput.construction;
+    }
+    if (constructionOutput.scrapValue !== undefined) {
+        shipCandidate.scrapValue = constructionOutput.scrapValue;
+    }
+    if (constructionOutput.fleetTech !== undefined) {
+        shipCandidate.fleetTech = constructionOutput.fleetTech;
+    }
+    if (constructionOutput.obtainedFrom !== undefined) {
+        shipCandidate.obtainedFrom = constructionOutput.obtainedFrom;
+    }
+    if (retrofitOutput.retrofitHullType !== undefined) {
+        shipCandidate.retrofitHullType = retrofitOutput.retrofitHullType;
+    }
+    if (miscOutput.misc !== undefined) {
+        shipCandidate.misc = miscOutput.misc;
+    }
+    // -------------------------------------------------------------------------
+    // 8. Validate with ShipSchema.parse
+    // -------------------------------------------------------------------------
+    const parseResult = ShipSchema.safeParse(shipCandidate);
+    if (!parseResult.success) {
+        console.error(`[buildShip] ShipSchema.parse failed for group_type="${groupType}":`, parseResult.error.message);
+        return null;
+    }
+    return parseResult.data;
+}
+// ---------------------------------------------------------------------------
+// buildAllShips
+// ---------------------------------------------------------------------------
+export 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
+    const groupTypeSet = new Set();
+    for (const [key, row] of Object.entries(ctx.en.template)) {
+        if (row === undefined)
+            continue;
+        if (key.startsWith("9"))
+            continue;
+        groupTypeSet.add(String(row.group_type));
+    }
+    const ships = [];
+    let failCount = 0;
+    for (const groupType of groupTypeSet) {
+        try {
+            const ship = buildShip(groupType, ctx, indexes);
+            if (ship !== null) {
+                ships.push(ship);
+            }
+        }
+        catch (err) {
+            failCount++;
+            console.error(`[buildAllShips] Unexpected error for group_type="${groupType}":`, err instanceof Error ? err.message : String(err));
+        }
+    }
+    if (failCount > 0) {
+        console.warn(`[buildAllShips] ${failCount} ships threw unexpected errors and were skipped.`);
+    }
+    // Sort by id numerically
+    ships.sort((a, b) => Number(a.id) - Number(b.id));
+    return ships;
+}
+// ---------------------------------------------------------------------------
+// createBuildContext
+// ---------------------------------------------------------------------------
+/**
+ * Create a BuildContext by loading all EN raw tables plus optional CN/JP overlays.
+ * This is a convenience function for scripts/build-data.ts.
+ */
+export async function createBuildContext(options) {
+    const { loadShipDataTemplate, loadShipDataStatistics, loadShipDataBreakout, loadShipDataStrengthen, loadShipDataBlueprint, loadShipDataTrans, loadShipDataGroup, loadShipSkinTemplate, loadShopTemplate, loadShipDataCreateExchange, loadShipDataByType, loadShipDataByStar, loadFleetTechShipTemplate, loadFleetTechShipClass, loadSkillDataTemplate, loadSkillDataDisplay, loadTransformDataTemplate, loadEquipDataByType, loadVoiceActorCn, loadAttributeInfoByType, } = await import("../ingest/files.js");
+    const { createLookups } = await import("../translate/lookups.js");
+    const enTemplate = loadShipDataTemplate("EN");
+    const enStatistics = loadShipDataStatistics("EN");
+    const enBreakout = loadShipDataBreakout("EN");
+    const enStrengthen = loadShipDataStrengthen("EN");
+    const enBlueprint = loadShipDataBlueprint("EN");
+    const enTrans = loadShipDataTrans("EN");
+    const enGroup = loadShipDataGroup("EN");
+    const enSkinTemplate = loadShipSkinTemplate("EN");
+    const enShopTemplate = loadShopTemplate("EN");
+    const enExchange = loadShipDataCreateExchange("EN");
+    const enShipDataByType = loadShipDataByType("EN");
+    const enShipDataByStar = loadShipDataByStar("EN");
+    const enFleetTechShipTemplate = loadFleetTechShipTemplate("EN");
+    const enFleetTechShipClass = loadFleetTechShipClass("EN");
+    const enSkillDataTemplate = loadSkillDataTemplate("EN");
+    const enSkillDataDisplay = loadSkillDataDisplay("EN");
+    const enTransformDataTemplate = loadTransformDataTemplate("EN");
+    const enEquipDataByType = loadEquipDataByType("EN");
+    const enVoiceActorCn = loadVoiceActorCn("EN");
+    const enAttributeInfoByType = loadAttributeInfoByType("EN");
+    const lookups = createLookups({
+        fleetTechShipTemplate: enFleetTechShipTemplate,
+        fleetTechShipClass: enFleetTechShipClass,
+        shipDataByType: enShipDataByType,
+        equipDataByType: enEquipDataByType,
+        skillDataTemplate: enSkillDataTemplate,
+        skillDataDisplay: enSkillDataDisplay,
+        voiceActorCn: enVoiceActorCn,
+    });
+    let cn;
+    if (options?.loadCn === true) {
+        const cnStats = loadShipDataStatistics("CN");
+        const cnGroup = loadShipDataGroup("CN");
+        const cnTemplate = loadShipDataTemplate("CN");
+        cn = { statistics: cnStats, group: cnGroup, template: cnTemplate };
+    }
+    let jp;
+    if (options?.loadJp === true) {
+        const jpStats = loadShipDataStatistics("JP");
+        jp = { statistics: jpStats };
+    }
+    return {
+        region: "EN",
+        en: {
+            template: enTemplate,
+            statistics: enStatistics,
+            breakout: enBreakout,
+            strengthen: enStrengthen,
+            blueprint: enBlueprint,
+            trans: enTrans,
+            group: enGroup,
+            skinTemplate: enSkinTemplate,
+            shopTemplate: enShopTemplate,
+            exchange: enExchange,
+            shipDataByType: enShipDataByType,
+            shipDataByStar: enShipDataByStar,
+            fleetTechShipTemplate: enFleetTechShipTemplate,
+            fleetTechShipClass: enFleetTechShipClass,
+            skillDataTemplate: enSkillDataTemplate,
+            skillDataDisplay: enSkillDataDisplay,
+            transformDataTemplate: enTransformDataTemplate,
+            equipDataByType: enEquipDataByType,
+            voiceActorCn: enVoiceActorCn,
+            attributeInfoByType: enAttributeInfoByType,
+        },
+        cn,
+        jp,
+        overrides: options?.overrides,
+        thumbnailBaseUrl: options?.thumbnailBaseUrl,
+        lookups,
+    };
+}
+//# sourceMappingURL=ship.js.map

package/dist/normalize/ship.js.map

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

package/dist/normalize/skills.d.ts

@@ -0,0 +1,20 @@
+import type { Ship } from "../schema/output/ship.js";
+import type { ShipDataTemplate, ShipDataBreakout, SkillDataTemplate, SkillDataDisplay, ShipDataTrans, TransformDataTemplate } from "../schema/raw/index.js";
+export interface SkillsInputs {
+    rowIds: string[];
+    en: {
+        template: ShipDataTemplate;
+        breakout: ShipDataBreakout;
+        skillDataTemplate: SkillDataTemplate;
+        skillDataDisplay: SkillDataDisplay;
+        trans?: ShipDataTrans;
+        transformDataTemplate?: TransformDataTemplate;
+    };
+    groupType: string;
+}
+export interface SkillsOutput {
+    skills: Ship["skills"];
+    limitBreaks?: Ship["limitBreaks"];
+}
+export declare function normalizeSkills(inputs: SkillsInputs): SkillsOutput;
+//# sourceMappingURL=skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/normalize/skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAYhC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,EAAE,EAAE;QACF,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,iBAAiB,EAAE,iBAAiB,CAAC;QACrC,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,KAAK,CAAC,EAAE,aAAa,CAAC;QACtB,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;KAC/C,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,WAAW,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;CACnC;AAsDD,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CA8KlE"}

package/dist/normalize/skills.js

@@ -0,0 +1,192 @@
+import { skillColor } from "../translate/enums.js";
+import { extractMaxLevelSubstitutions, substitutePlaceholders, splitLimitBreakBonuses, } from "../translate/strings.js";
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Strip trailing Roman numeral suffix (Ⅰ–Ⅴ or ASCII I/II/III/IV/V) from a skill
+ * name, returning just the "root" portion for comparison purposes.
+ *
+ * Examples:
+ *   "All Out Assault Ⅰ"    → "All Out Assault"
+ *   "All Out Assault Ⅱ"    → "All Out Assault"
+ *   "Smokescreen: Light Cruisers" → "Smokescreen: Light Cruisers"
+ *   "Burn Order"            → "Burn Order"
+ */
+function rootSkillName(name) {
+    // Trim Unicode Roman numerals (Ⅰ Ⅱ Ⅲ Ⅳ Ⅴ Ⅵ Ⅶ Ⅷ Ⅸ Ⅹ) and ASCII (I–X variants)
+    // at end of string, optionally preceded by a colon/period and more text.
+    return name
+        .replace(/\s+[ⅠⅡⅢⅣⅤⅥⅦⅧⅨⅩiIvVxX]+(?:[:.][^\s]*)*\s*$/, "")
+        .trim();
+}
+/**
+ * Normalize a `skill_id` value (number | number[] | undefined) to a number[].
+ */
+function normalizeSkillIdList(raw) {
+    if (raw === undefined)
+        return [];
+    if (Array.isArray(raw))
+        return raw;
+    return [raw];
+}
+/**
+ * Build the description string for a skill.
+ */
+function buildDescription(skillTemplate, idStr) {
+    const row = skillTemplate[idStr];
+    if (row === undefined)
+        return "";
+    const rawDesc = row.desc;
+    if (rawDesc === undefined || rawDesc === "")
+        return "";
+    const substitutions = extractMaxLevelSubstitutions(row.desc_add, row.max_level ?? 10);
+    return substitutePlaceholders(rawDesc, substitutions);
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+export function normalizeSkills(inputs) {
+    const { rowIds, en, groupType } = inputs;
+    const { template, breakout, skillDataTemplate, skillDataDisplay, trans, transformDataTemplate, } = en;
+    // -------------------------------------------------------------------------
+    // 1. Resolve the LB3 row ID (the row whose key ends with "4", or last entry).
+    // -------------------------------------------------------------------------
+    const lb3RowId = rowIds.find((id) => id.endsWith("4")) ?? rowIds[rowIds.length - 1] ?? groupType;
+    // -------------------------------------------------------------------------
+    // 2. Get the base skill ID list from the LB3 row.
+    // -------------------------------------------------------------------------
+    const lb3Template = template[lb3RowId];
+    const baseSkillIds = lb3Template?.buff_list_display ?? [];
+    // -------------------------------------------------------------------------
+    // 3. Apply retrofit skill upgrades (if any).
+    //
+    // TODO: The retrofit skill-upgrade/replace logic is a best-effort
+    // approximation.  AzurAPI's historical output was inconsistent here; some
+    // versions replaced the base skill, others appended.  The implementation
+    // below attempts a root-name match and replaces when found, otherwise
+    // appends.  If this causes issues, simplify to just using `baseSkillIds`
+    // directly.
+    // -------------------------------------------------------------------------
+    let finalSkillIds = [...baseSkillIds];
+    if (trans !== undefined && transformDataTemplate !== undefined) {
+        const transRow = trans[groupType];
+        if (transRow !== undefined) {
+            // Collect all retrofit skill IDs: from trans.skill_id + each transform node's skill_id
+            const retrofitSkillIds = new Set();
+            // From the top-level trans row
+            const topSkillIds = normalizeSkillIdList(transRow.skill_id);
+            for (const sid of topSkillIds) {
+                if (sid !== 0)
+                    retrofitSkillIds.add(sid);
+            }
+            // From each transform_data_template node referenced in transform_list
+            const seenTransformIds = new Set();
+            for (const outerList of transRow.transform_list) {
+                for (const pair of outerList) {
+                    const transformId = pair[1];
+                    if (transformId === undefined || seenTransformIds.has(transformId))
+                        continue;
+                    seenTransformIds.add(transformId);
+                    const tRow = transformDataTemplate[String(transformId)];
+                    if (tRow === undefined)
+                        continue;
+                    const tSkillIds = normalizeSkillIdList(tRow.skill_id);
+                    for (const sid of tSkillIds) {
+                        if (sid !== 0)
+                            retrofitSkillIds.add(sid);
+                    }
+                }
+            }
+            // Merge retrofit skills: replace base skill if root names match, else append
+            for (const retrofitId of retrofitSkillIds) {
+                const retrofitRow = skillDataTemplate[String(retrofitId)];
+                if (retrofitRow === undefined)
+                    continue;
+                const retrofitName = retrofitRow.name;
+                if (retrofitName === undefined)
+                    continue;
+                const retrofitRoot = rootSkillName(retrofitName);
+                // Try to find a base skill with the same root name
+                let replaced = false;
+                for (let i = 0; i < finalSkillIds.length; i++) {
+                    const baseId = finalSkillIds[i];
+                    if (baseId === undefined)
+                        continue;
+                    const baseRow = skillDataTemplate[String(baseId)];
+                    if (baseRow === undefined)
+                        continue;
+                    const baseName = baseRow.name;
+                    if (baseName === undefined)
+                        continue;
+                    const baseRoot = rootSkillName(baseName);
+                    if (baseRoot === retrofitRoot && baseRoot.length > 0) {
+                        finalSkillIds[i] = retrofitId;
+                        replaced = true;
+                        break;
+                    }
+                }
+                if (!replaced) {
+                    // No matching base skill — append if not already present
+                    if (!finalSkillIds.includes(retrofitId)) {
+                        finalSkillIds.push(retrofitId);
+                    }
+                }
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // 4. Build skill objects.
+    // -------------------------------------------------------------------------
+    const skills = [];
+    for (const skillId of finalSkillIds) {
+        const idStr = String(skillId);
+        const skillRow = skillDataTemplate[idStr];
+        const displayRow = skillDataDisplay[idStr];
+        // Resolve name: prefer skill_data_template, fallback to skill_data_display
+        let nameEn = skillRow?.name ?? displayRow?.name;
+        if (nameEn === undefined || nameEn.trim() === "") {
+            // No name at all — skip this skill
+            console.warn(`normalizeSkills: skill ID ${skillId} has no name in skill_data_template or skill_data_display — skipping (group_type ${groupType})`);
+            continue;
+        }
+        nameEn = nameEn.trim();
+        const type = skillRow?.type ?? 0;
+        const color = skillColor(type);
+        const description = buildDescription(skillDataTemplate, idStr);
+        skills.push({
+            color,
+            names: { en: nameEn },
+            description,
+        });
+    }
+    // -------------------------------------------------------------------------
+    // 5. Build limit breaks.
+    //
+    // rowIds[0..2] correspond to LB1/LB2/LB3 source rows.
+    // The terminal row (index 3, ending in "4") has breakout_view: "None" → skip.
+    // -------------------------------------------------------------------------
+    // We want the first THREE non-terminal rows: rowIds[0], [1], [2]
+    const limitBreaks = [];
+    for (let i = 0; i < 3; i++) {
+        const rowId = rowIds[i];
+        if (rowId === undefined) {
+            // Fewer than 3 rows — some ships (e.g. META 4-star ships) may have fewer LB stages
+            continue;
+        }
+        const breakoutRow = breakout[rowId];
+        if (breakoutRow === undefined) {
+            // Row missing from breakout table — skip
+            continue;
+        }
+        const bonuses = splitLimitBreakBonuses(breakoutRow.breakout_view);
+        limitBreaks.push(bonuses);
+    }
+    // If all three limit-break arrays are empty/absent, omit the field
+    const hasLimitBreaks = limitBreaks.length > 0 && limitBreaks.some((lb) => lb.length > 0);
+    return {
+        skills,
+        limitBreaks: hasLimitBreaks ? limitBreaks : undefined,
+    };
+}
+//# sourceMappingURL=skills.js.map

package/dist/normalize/skills.js.map

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

package/dist/normalize/skins.d.ts

@@ -0,0 +1,14 @@
+import type { Ship } from "../schema/output/ship.js";
+import type { ShipSkinTemplate, ShopTemplate } from "../schema/raw/index.js";
+export interface SkinsInputs {
+    groupType: string;
+    skinTemplate: ShipSkinTemplate;
+    shopTemplate: ShopTemplate;
+    thumbnailBaseUrl?: string;
+    /** Set of available painting filenames (lowercase, no extension) for variant lookup. */
+    availablePaintings?: Set<string>;
+}
+export declare function normalizeSkins(inputs: SkinsInputs): {
+    skins: Ship["skins"];
+};
+//# sourceMappingURL=skins.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skins.d.ts","sourceRoot":"","sources":["../../src/normalize/skins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACb,MAAM,wBAAwB,CAAC;AAOhC,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wFAAwF;IACxF,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAClC;AAsED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;CAAE,CAuF5E"}