@lycoristech/azurdata 0.0.1

package/dist/client/ships.js

@@ -0,0 +1,74 @@
+import Fuse from "fuse.js";
+export class Ships {
+    data;
+    idMap;
+    fuse;
+    constructor(options) {
+        this.data = options.data;
+        this.idMap = options.idMap;
+        this.fuse = new Fuse(Object.values(options.data), {
+            keys: [
+                { name: "names.en", weight: 3 },
+                { name: "names.code", weight: 2 },
+                { name: "names.jp", weight: 1 },
+                { name: "names.cn", weight: 1 },
+            ],
+            threshold: options.fuseThreshold ?? 0.4,
+            includeScore: true,
+        });
+    }
+    // Primary getter. Accepts:
+    //   - canonical group_type: "20212"
+    //   - legacy 3-digit code: "115" (via idMap)
+    //   - any name in idMap (case-insensitive)
+    //   - fuzzy match via fuse.js
+    get(nameOrId) {
+        if (typeof nameOrId !== "string" || nameOrId.length === 0)
+            return undefined;
+        // 1. Direct id hit
+        if (this.data[nameOrId])
+            return this.data[nameOrId];
+        // 2. Exact id-map hit (case sensitive first)
+        const directId = this.idMap[nameOrId];
+        if (directId && this.data[directId])
+            return this.data[directId];
+        // 3. Case-insensitive id-map hit
+        // Build a lowercased copy lazily
+        const lower = nameOrId.toLowerCase();
+        const ciIdMap = this.getCiIdMap();
+        const ciId = ciIdMap[lower];
+        if (ciId && this.data[ciId])
+            return this.data[ciId];
+        // 4. Fuse.js fuzzy
+        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;
+        }
+        return undefined;
+    }
+    _ciIdMap;
+    getCiIdMap() {
+        if (!this._ciIdMap) {
+            this._ciIdMap = {};
+            for (const [k, v] of Object.entries(this.idMap)) {
+                this._ciIdMap[k.toLowerCase()] = v;
+            }
+        }
+        return this._ciIdMap;
+    }
+    getAll() {
+        return Object.values(this.data);
+    }
+    getById(id) {
+        return this.data[id];
+    }
+    count() {
+        return Object.keys(this.data).length;
+    }
+    // Search multiple matches
+    search(query, limit = 10) {
+        const results = this.fuse.search(query, { limit });
+        return results.map(r => r.item);
+    }
+}
+//# sourceMappingURL=ships.js.map

package/dist/client/ships.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+export declare const IMAGE_BASE_URL = "https://raw.githubusercontent.com/iujab/azurlane-images/main";
+export declare const PAINTINGS_URL = "https://raw.githubusercontent.com/iujab/azurlane-images/main/paintings";
+export declare const THUMBNAILS_URL = "https://raw.githubusercontent.com/iujab/azurlane-images/main/thumbnails";
+export declare const DATA_BASE_URL = "https://raw.githubusercontent.com/iujab/AzurAPI/main/data";
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,iEAAqF,CAAC;AACjH,eAAO,MAAM,aAAa,2EAAgC,CAAC;AAC3D,eAAO,MAAM,cAAc,4EAAiC,CAAC;AAI7D,eAAO,MAAM,aAAa,8DAAwF,CAAC"}

package/dist/config.js

@@ -0,0 +1,12 @@
+// Central config for GitHub URLs.
+const GITHUB_USER = "iujab";
+const GITHUB_BRANCH = "main";
+// Image URLs (azurlane-images repo)
+const IMAGES_REPO = "azurlane-images";
+export const IMAGE_BASE_URL = `https://raw.githubusercontent.com/${GITHUB_USER}/${IMAGES_REPO}/${GITHUB_BRANCH}`;
+export const PAINTINGS_URL = `${IMAGE_BASE_URL}/paintings`;
+export const THUMBNAILS_URL = `${IMAGE_BASE_URL}/thumbnails`;
+// Data URLs (azurdata repo — for runtime fetch)
+const DATA_REPO = "AzurAPI";
+export const DATA_BASE_URL = `https://raw.githubusercontent.com/${GITHUB_USER}/${DATA_REPO}/${GITHUB_BRANCH}/data`;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,MAAM,WAAW,GAAG,OAAO,CAAC;AAC5B,MAAM,aAAa,GAAG,MAAM,CAAC;AAE7B,oCAAoC;AACpC,MAAM,WAAW,GAAG,iBAAiB,CAAC;AACtC,MAAM,CAAC,MAAM,cAAc,GAAG,qCAAqC,WAAW,IAAI,WAAW,IAAI,aAAa,EAAE,CAAC;AACjH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,cAAc,YAAY,CAAC;AAC3D,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,cAAc,aAAa,CAAC;AAE7D,gDAAgD;AAChD,MAAM,SAAS,GAAG,SAAS,CAAC;AAC5B,MAAM,CAAC,MAAM,aAAa,GAAG,qCAAqC,WAAW,IAAI,SAAS,IAAI,aAAa,OAAO,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { AzurData, type AzurDataOptions, type AzurDataInitOptions, Ships, type ShipsOptions, type FetchOptions } from "./client/index.js";
+export type { Ship, StatBlock, ShipListEntry } from "./schema/output/ship.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,mBAAmB,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC1I,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { AzurData, Ships } from "./client/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAkD,KAAK,EAAwC,MAAM,mBAAmB,CAAC"}

package/dist/ingest/files.d.ts

@@ -0,0 +1,25 @@
+import { type ShipDataTemplate, type ShipDataStatistics, type ShipDataBreakout, type ShipSkinWords, type ShipDataStrengthen, type ShipDataBlueprint, type ShipDataTrans, type ShipDataGroup, type ShipSkinTemplate, type TransformDataTemplate, type FleetTechShipTemplate, type FleetTechShipClass, type FleetTechGroup, type ShipDataByType, type ShipDataByStar, type SkillDataTemplate, type SkillDataDisplay, type ShopTemplate, type VoiceActorCn, type EquipDataByType, type ShipDataCreateExchange, type AttributeInfoByType } from "../schema/raw/index.js";
+import { type Region } from "./upstream.js";
+export declare function loadShipDataTemplate(region?: Region): ShipDataTemplate;
+export declare function loadShipDataStatistics(region?: Region): ShipDataStatistics;
+export declare function loadShipDataBreakout(region?: Region): ShipDataBreakout;
+export declare function loadShipSkinWords(region?: Region): ShipSkinWords;
+export declare function loadShopTemplate(region?: Region): ShopTemplate;
+export declare function loadShipDataStrengthen(region?: Region): ShipDataStrengthen;
+export declare function loadShipDataBlueprint(region?: Region): ShipDataBlueprint;
+export declare function loadShipDataTrans(region?: Region): ShipDataTrans;
+export declare function loadShipDataGroup(region?: Region): ShipDataGroup;
+export declare function loadShipSkinTemplate(region?: Region): ShipSkinTemplate;
+export declare function loadTransformDataTemplate(region?: Region): TransformDataTemplate;
+export declare function loadFleetTechShipTemplate(region?: Region): FleetTechShipTemplate;
+export declare function loadFleetTechShipClass(region?: Region): FleetTechShipClass;
+export declare function loadFleetTechGroup(region?: Region): FleetTechGroup;
+export declare function loadShipDataByType(region?: Region): ShipDataByType;
+export declare function loadShipDataByStar(region?: Region): ShipDataByStar;
+export declare function loadSkillDataTemplate(region?: Region): SkillDataTemplate;
+export declare function loadSkillDataDisplay(region?: Region): SkillDataDisplay;
+export declare function loadVoiceActorCn(region?: Region): VoiceActorCn;
+export declare function loadEquipDataByType(region?: Region): EquipDataByType;
+export declare function loadShipDataCreateExchange(region?: Region): ShipDataCreateExchange;
+export declare function loadAttributeInfoByType(region?: Region): AttributeInfoByType;
+//# sourceMappingURL=files.d.ts.map

package/dist/ingest/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/ingest/files.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,gBAAgB,EAErB,KAAK,kBAAkB,EAEvB,KAAK,gBAAgB,EAErB,KAAK,aAAa,EAElB,KAAK,kBAAkB,EAEvB,KAAK,iBAAiB,EAEtB,KAAK,aAAa,EAElB,KAAK,aAAa,EAElB,KAAK,gBAAgB,EAErB,KAAK,qBAAqB,EAE1B,KAAK,qBAAqB,EAE1B,KAAK,kBAAkB,EAEvB,KAAK,cAAc,EAEnB,KAAK,cAAc,EAEnB,KAAK,cAAc,EAEnB,KAAK,iBAAiB,EAEtB,KAAK,gBAAgB,EAErB,KAAK,YAAY,EAEjB,KAAK,YAAY,EAEjB,KAAK,eAAe,EAEpB,KAAK,sBAAsB,EAE3B,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AA8CxD,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,MAAa,GAAG,gBAAgB,CAK5E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,GAAE,MAAa,GAAG,kBAAkB,CAKhF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,MAAa,GAAG,gBAAgB,CAK5E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,MAAa,GAAG,aAAa,CAKtE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,MAAa,GAAG,YAAY,CAKpE;AAMD,wBAAgB,sBAAsB,CAAC,MAAM,GAAE,MAAa,GAAG,kBAAkB,CAKhF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,MAAa,GAAG,iBAAiB,CAK9E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,MAAa,GAAG,aAAa,CAKtE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,MAAa,GAAG,aAAa,CAKtE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,MAAa,GAAG,gBAAgB,CAK5E;AAED,wBAAgB,yBAAyB,CAAC,MAAM,GAAE,MAAa,GAAG,qBAAqB,CAKtF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,GAAE,MAAa,GAAG,qBAAqB,CAKtF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,GAAE,MAAa,GAAG,kBAAkB,CAKhF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,MAAa,GAAG,cAAc,CAKxE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,MAAa,GAAG,cAAc,CAKxE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,MAAa,GAAG,cAAc,CAKxE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,MAAa,GAAG,iBAAiB,CAK9E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,MAAa,GAAG,gBAAgB,CAK5E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,MAAa,GAAG,YAAY,CAKpE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,MAAa,GAAG,eAAe,CAK1E;AAED,wBAAgB,0BAA0B,CAAC,MAAM,GAAE,MAAa,GAAG,sBAAsB,CAKxF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,GAAE,MAAa,GAAG,mBAAmB,CAKlF"}

package/dist/ingest/files.js

@@ -0,0 +1,108 @@
+import fs from "fs";
+import { ShipDataTemplateSchema, ShipDataStatisticsSchema, ShipDataBreakoutSchema, ShipSkinWordsSchema, ShipDataStrengthenSchema, ShipDataBlueprintSchema, ShipDataTransSchema, ShipDataGroupSchema, ShipSkinTemplateSchema, TransformDataTemplateSchema, FleetTechShipTemplateSchema, FleetTechShipClassSchema, FleetTechGroupSchema, ShipDataByTypeSchema, ShipDataByStarSchema, SkillDataTemplateSchema, SkillDataDisplaySchema, ShopTemplateSchema, VoiceActorCnSchema, EquipDataByTypeSchema, ShipDataCreateExchangeSchema, AttributeInfoByTypeSchema, } from "../schema/raw/index.js";
+import { regionPath } from "./upstream.js";
+function readJsonFile(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, "utf-8");
+        const parsed = JSON.parse(raw);
+        // Many upstream files have an "all" key containing an array of IDs
+        // (an index listing all record keys). Strip it before validation.
+        if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+            const obj = parsed;
+            if ("all" in obj && Array.isArray(obj["all"])) {
+                const { all: _all, ...rest } = obj;
+                return rest;
+            }
+        }
+        return parsed;
+    }
+    catch {
+        // File missing or unreadable — treat as empty
+        return {};
+    }
+}
+function loadFile(schema, filePath) {
+    const data = readJsonFile(filePath);
+    // Empty object stub — return as-is (valid empty record)
+    if (data !== null && typeof data === "object" && !Array.isArray(data) && Object.keys(data).length === 0) {
+        return {};
+    }
+    const result = schema.safeParse(data);
+    if (!result.success) {
+        throw new Error(`Zod parse failed for file: ${filePath}\n${result.error.message}`);
+    }
+    return result.data;
+}
+// ---------------------------------------------------------------------------
+// sharecfgdata/ files
+// ---------------------------------------------------------------------------
+export function loadShipDataTemplate(region = "EN") {
+    return loadFile(ShipDataTemplateSchema, regionPath(region, "sharecfgdata", "ship_data_template.json"));
+}
+export function loadShipDataStatistics(region = "EN") {
+    return loadFile(ShipDataStatisticsSchema, regionPath(region, "sharecfgdata", "ship_data_statistics.json"));
+}
+export function loadShipDataBreakout(region = "EN") {
+    return loadFile(ShipDataBreakoutSchema, regionPath(region, "sharecfgdata", "ship_data_breakout.json"));
+}
+export function loadShipSkinWords(region = "EN") {
+    return loadFile(ShipSkinWordsSchema, regionPath(region, "sharecfgdata", "ship_skin_words.json"));
+}
+export function loadShopTemplate(region = "EN") {
+    return loadFile(ShopTemplateSchema, regionPath(region, "sharecfgdata", "shop_template.json"));
+}
+// ---------------------------------------------------------------------------
+// ShareCfg/ files
+// ---------------------------------------------------------------------------
+export function loadShipDataStrengthen(region = "EN") {
+    return loadFile(ShipDataStrengthenSchema, regionPath(region, "ShareCfg", "ship_data_strengthen.json"));
+}
+export function loadShipDataBlueprint(region = "EN") {
+    return loadFile(ShipDataBlueprintSchema, regionPath(region, "ShareCfg", "ship_data_blueprint.json"));
+}
+export function loadShipDataTrans(region = "EN") {
+    return loadFile(ShipDataTransSchema, regionPath(region, "ShareCfg", "ship_data_trans.json"));
+}
+export function loadShipDataGroup(region = "EN") {
+    return loadFile(ShipDataGroupSchema, regionPath(region, "ShareCfg", "ship_data_group.json"));
+}
+export function loadShipSkinTemplate(region = "EN") {
+    return loadFile(ShipSkinTemplateSchema, regionPath(region, "ShareCfg", "ship_skin_template.json"));
+}
+export function loadTransformDataTemplate(region = "EN") {
+    return loadFile(TransformDataTemplateSchema, regionPath(region, "ShareCfg", "transform_data_template.json"));
+}
+export function loadFleetTechShipTemplate(region = "EN") {
+    return loadFile(FleetTechShipTemplateSchema, regionPath(region, "ShareCfg", "fleet_tech_ship_template.json"));
+}
+export function loadFleetTechShipClass(region = "EN") {
+    return loadFile(FleetTechShipClassSchema, regionPath(region, "ShareCfg", "fleet_tech_ship_class.json"));
+}
+export function loadFleetTechGroup(region = "EN") {
+    return loadFile(FleetTechGroupSchema, regionPath(region, "ShareCfg", "fleet_tech_group.json"));
+}
+export function loadShipDataByType(region = "EN") {
+    return loadFile(ShipDataByTypeSchema, regionPath(region, "ShareCfg", "ship_data_by_type.json"));
+}
+export function loadShipDataByStar(region = "EN") {
+    return loadFile(ShipDataByStarSchema, regionPath(region, "ShareCfg", "ship_data_by_star.json"));
+}
+export function loadSkillDataTemplate(region = "EN") {
+    return loadFile(SkillDataTemplateSchema, regionPath(region, "ShareCfg", "skill_data_template.json"));
+}
+export function loadSkillDataDisplay(region = "EN") {
+    return loadFile(SkillDataDisplaySchema, regionPath(region, "ShareCfg", "skill_data_display.json"));
+}
+export function loadVoiceActorCn(region = "EN") {
+    return loadFile(VoiceActorCnSchema, regionPath(region, "ShareCfg", "voice_actor_CN.json"));
+}
+export function loadEquipDataByType(region = "EN") {
+    return loadFile(EquipDataByTypeSchema, regionPath(region, "ShareCfg", "equip_data_by_type.json"));
+}
+export function loadShipDataCreateExchange(region = "EN") {
+    return loadFile(ShipDataCreateExchangeSchema, regionPath(region, "ShareCfg", "ship_data_create_exchange.json"));
+}
+export function loadAttributeInfoByType(region = "EN") {
+    return loadFile(AttributeInfoByTypeSchema, regionPath(region, "ShareCfg", "attribute_info_by_type.json"));
+}
+//# sourceMappingURL=files.js.map

package/dist/ingest/files.js.map

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

package/dist/ingest/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./upstream.js";
+export * from "./files.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ingest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ingest/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/ingest/index.js

@@ -0,0 +1,3 @@
+export * from "./upstream.js";
+export * from "./files.js";
+//# sourceMappingURL=index.js.map

package/dist/ingest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ingest/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/ingest/upstream.d.ts

@@ -0,0 +1,4 @@
+export declare const UPSTREAM_ROOT: string;
+export type Region = "EN" | "CN" | "JP" | "KR" | "TW";
+export declare function regionPath(region: Region, ...segments: string[]): string;
+//# sourceMappingURL=upstream.d.ts.map

package/dist/ingest/upstream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstream.d.ts","sourceRoot":"","sources":["../../src/ingest/upstream.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,QAAwD,CAAC;AAEnF,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEtD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAExE"}

package/dist/ingest/upstream.js

@@ -0,0 +1,6 @@
+import path from "path";
+export const UPSTREAM_ROOT = path.resolve(process.cwd(), "upstream/azurlane-data");
+export function regionPath(region, ...segments) {
+    return path.join(UPSTREAM_ROOT, region, ...segments);
+}
+//# sourceMappingURL=upstream.js.map

package/dist/ingest/upstream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstream.js","sourceRoot":"","sources":["../../src/ingest/upstream.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,wBAAwB,CAAC,CAAC;AAInF,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,GAAG,QAAkB;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC;AACvD,CAAC"}

package/dist/normalize/construction.d.ts

@@ -0,0 +1,30 @@
+import type { Ship } from "../schema/output/ship.js";
+import type { ShipDataGroupValue, FleetTechShipTemplate, ShipDataCreateExchange, ShipDataByType, ShipDataByStar } from "../schema/raw/index.js";
+import type { Lookups } from "../translate/lookups.js";
+export interface ConstructionInputs {
+    groupType: string;
+    /** Pre-resolved ship_data_group row */
+    groupRow: ShipDataGroupValue;
+    lb3RowId: string;
+    /** from ship_data_template[lb3].type */
+    shipType: number;
+    /** star_max from template */
+    starMax: number;
+    /** star count at LB0 — used for medal scrap calculation */
+    initialStar: number;
+    fleetTechShipTemplate: FleetTechShipTemplate;
+    shipDataCreateExchange: ShipDataCreateExchange;
+    shipDataByType: ShipDataByType;
+    shipDataByStar: ShipDataByStar;
+    lookups: Lookups;
+    /** Optional seed from data/overrides/construction-times.json */
+    constructionTimeOverride?: string;
+}
+export interface ConstructionOutput {
+    construction?: Ship["construction"];
+    scrapValue?: Ship["scrapValue"];
+    fleetTech?: Ship["fleetTech"];
+    obtainedFrom?: Ship["obtainedFrom"];
+}
+export declare function normalizeConstruction(inputs: ConstructionInputs): ConstructionOutput;
+//# sourceMappingURL=construction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"construction.d.ts","sourceRoot":"","sources":["../../src/normalize/construction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,cAAc,EACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAOvD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9B,YAAY,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;CACrC;AAkBD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAyNpF"}

package/dist/normalize/construction.js

@@ -0,0 +1,184 @@
+import { FLEET_TECH_STAT_MAP } from "../translate/enums.js";
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Flatten all string tokens from a description entry tuple.
+ * description entries are [string, unknown, number?] tuples.
+ */
+function descEntryText(entry) {
+    return entry[0];
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+export function normalizeConstruction(inputs) {
+    const { groupType, groupRow, lb3RowId, shipType, initialStar, fleetTechShipTemplate, shipDataCreateExchange, shipDataByType, shipDataByStar, lookups, constructionTimeOverride, } = inputs;
+    const result = {};
+    // -------------------------------------------------------------------------
+    // 1. construction.availableIn
+    // -------------------------------------------------------------------------
+    const descriptions = groupRow.description ?? [];
+    let lightFlag = false;
+    let heavyFlag = false;
+    let aviationFlag = false;
+    let limitedFlag = false;
+    for (const entry of descriptions) {
+        const text = descEntryText(entry);
+        const lower = text.toLowerCase();
+        if (lower.includes("light construction") ||
+            (lower.includes("light") && lower.includes("construction"))) {
+            lightFlag = true;
+        }
+        if (lower.includes("heavy construction") ||
+            (lower.includes("heavy") && lower.includes("construction"))) {
+            heavyFlag = true;
+        }
+        if (lower.includes("special construction") ||
+            (lower.includes("aviation") && lower.includes("construction"))) {
+            aviationFlag = true;
+        }
+        if (lower.startsWith("event:") ||
+            lower === "limited build") {
+            limitedFlag = true;
+        }
+    }
+    // exchange: true if lb3RowId appears as a value in any exchange_ship_id array
+    let exchangeFlag = false;
+    const lb3RowIdNum = Number(lb3RowId);
+    for (const exchangeRow of Object.values(shipDataCreateExchange)) {
+        if (exchangeRow === undefined)
+            continue;
+        const ids = exchangeRow.exchange_ship_id ?? [];
+        if (ids.includes(lb3RowIdNum)) {
+            exchangeFlag = true;
+            break;
+        }
+    }
+    const anyAvailableIn = lightFlag || heavyFlag || aviationFlag || limitedFlag || exchangeFlag;
+    const hasConstructionTime = constructionTimeOverride !== undefined;
+    if (anyAvailableIn || hasConstructionTime) {
+        const availableIn = anyAvailableIn
+            ? {
+                light: lightFlag,
+                heavy: heavyFlag,
+                aviation: aviationFlag,
+                limited: limitedFlag,
+                exchange: exchangeFlag,
+            }
+            : undefined;
+        result.construction = {
+            ...(hasConstructionTime ? { constructionTime: constructionTimeOverride } : {}),
+            ...(availableIn !== undefined ? { availableIn } : {}),
+        };
+    }
+    // -------------------------------------------------------------------------
+    // 2. scrapValue
+    // -------------------------------------------------------------------------
+    const typeRow = shipDataByType[String(shipType)];
+    const goldRatio = typeRow?.distory_resource_gold_ratio ?? 0;
+    const fixGold = typeRow?.fix_resource_gold ?? 0;
+    const coin = Math.floor(goldRatio * 120 + fixGold);
+    // medal: from ship_data_by_star[initialStar].destory_item — find item_id === 15001
+    const starRow = shipDataByStar[String(initialStar)];
+    const destroyItems = starRow?.destory_item ?? [];
+    let medal = 0;
+    for (const [, itemId, qty] of destroyItems) {
+        if (itemId === 15001) {
+            medal = qty;
+            break;
+        }
+    }
+    if (coin > 0 || medal > 0) {
+        result.scrapValue = { coin, oil: 0, medal };
+    }
+    // -------------------------------------------------------------------------
+    // 3. fleetTech
+    // -------------------------------------------------------------------------
+    const techRow = fleetTechShipTemplate[groupType];
+    if (techRow !== undefined) {
+        const collection = techRow.pt_get;
+        const maxLimitBreak = techRow.pt_upgrage;
+        const maxLevel = techRow.pt_level;
+        const total = collection + maxLimitBreak + maxLevel;
+        const techPoints = {
+            collection,
+            maxLimitBreak,
+            maxLevel,
+            total,
+        };
+        // collection bonus
+        let collectionBonus;
+        if (techRow.add_get_attr !== 0 && techRow.add_get_value !== 0) {
+            collectionBonus = {
+                stat: FLEET_TECH_STAT_MAP[techRow.add_get_attr] ?? "unknown",
+                bonus: techRow.add_get_value,
+                applicable: techRow.add_get_shiptype.map((id) => lookups.hullTypeName(id)),
+            };
+        }
+        // maxLevel bonus
+        let maxLevelBonus;
+        if (techRow.add_level_attr !== 0 && techRow.add_level_value !== 0) {
+            maxLevelBonus = {
+                stat: FLEET_TECH_STAT_MAP[techRow.add_level_attr] ?? "unknown",
+                bonus: techRow.add_level_value,
+                applicable: techRow.add_level_shiptype.map((id) => lookups.hullTypeName(id)),
+            };
+        }
+        result.fleetTech = {
+            techPoints,
+            statsBonus: {
+                ...(collectionBonus !== undefined ? { collection: collectionBonus } : {}),
+                ...(maxLevelBonus !== undefined ? { maxLevel: maxLevelBonus } : {}),
+            },
+        };
+    }
+    // -------------------------------------------------------------------------
+    // 4. obtainedFrom
+    // -------------------------------------------------------------------------
+    const mapPrefixes = ["explore chapter", "exploring stage"];
+    const fromMaps = [];
+    let firstNonMapText;
+    for (const entry of descriptions) {
+        const text = descEntryText(entry);
+        const lower = text.toLowerCase();
+        const isMap = mapPrefixes.some((prefix) => lower.startsWith(prefix));
+        if (isMap) {
+            // Extract the stage code using a regex: match Chapter/Stage followed by digits/dashes
+            const match = /\b(?:Chapter|Stage)\s+([0-9\-SEX\s]+)/i.exec(text);
+            if (match !== null && match[1] !== undefined) {
+                fromMaps.push(`Chapter ${match[1].trim()}`);
+            }
+            else {
+                // Fallback: take last whitespace-separated token
+                const tokens = text.trim().split(/\s+/);
+                const last = tokens[tokens.length - 1];
+                if (last !== undefined) {
+                    fromMaps.push(last);
+                }
+            }
+        }
+        else if (firstNonMapText === undefined) {
+            firstNonMapText = text;
+        }
+    }
+    let obtainedFromStr;
+    if (firstNonMapText !== undefined) {
+        obtainedFromStr = firstNonMapText;
+    }
+    else if (fromMaps.length > 0) {
+        obtainedFromStr = "Map Drop";
+    }
+    else {
+        obtainedFromStr = "Unknown";
+    }
+    const shouldEmitObtainedFrom = fromMaps.length > 0 || obtainedFromStr !== "Unknown";
+    if (shouldEmitObtainedFrom) {
+        result.obtainedFrom = {
+            ...(fromMaps.length > 0 ? { fromMaps } : {}),
+            obtainedFrom: obtainedFromStr,
+        };
+    }
+    return result;
+}
+//# sourceMappingURL=construction.js.map

package/dist/normalize/construction.js.map

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

package/dist/normalize/identity.d.ts

@@ -0,0 +1,47 @@
+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 { Lookups } from "../translate/lookups.js";
+export interface IdentityInputs {
+    groupType: string;
+    /** The LB0..LB3 row IDs for this group. Primary row is the max-LB one (suffix 4). */
+    rowIds: string[];
+    en: {
+        template: ShipDataTemplate;
+        statistics: ShipDataStatistics;
+        group: ShipDataGroup;
+        blueprint: ShipDataBlueprint;
+        fleetTechShipTemplate: FleetTechShipTemplate;
+        fleetTechShipClass: FleetTechShipClass;
+        shipDataByType: ShipDataByType;
+    };
+    cn?: {
+        statistics: ShipDataStatistics;
+    };
+    jp?: {
+        statistics: ShipDataStatistics;
+    };
+    /** Caller determines whether the group exists in EN. */
+    isEnReleased: boolean;
+    /** Whether this ship belongs to the research/blueprint category. */
+    isResearch: boolean;
+    /** blueprint_version value for research ships (drives Decisive vs Priority). */
+    blueprintVersion?: number;
+    /** Pre-resolved group row from ship_data_group (caller looks up by group_type). */
+    groupRow: ShipDataGroupValue;
+    /** Lookups helper for class/hull/equip name resolution. */
+    lookups: Lookups;
+}
+export interface IdentityOutput {
+    id: string;
+    names: Ship["names"];
+    rarity: Ship["rarity"];
+    stars: Ship["stars"];
+    class: string;
+    hullType: string;
+    nationality: string;
+    wikiUrl?: string;
+    thumbnail: string;
+    isEnReleased?: boolean;
+}
+export declare function normalizeIdentity(inputs: IdentityInputs): IdentityOutput;
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +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,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,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,CAiJxE"}