@lycoristech/azurdata 0.0.1

package/dist/translate/enums.d.ts

@@ -0,0 +1,34 @@
+import type { StatBlock } from "../schema/output/ship.js";
+/** Maps integer rarity → AzurAPI rarity string */
+export declare const RARITY_MAP: Record<number, "Normal" | "Rare" | "Elite" | "Super Rare" | "Ultra Rare">;
+/**
+ * Resolve a rarity integer to its display string.
+ *
+ * Rules:
+ *   - int === 6 && isResearch && blueprintVersion >= 6  → "Decisive"
+ *   - int === 6 && isResearch                            → "Priority"
+ *   - else                                               → RARITY_MAP[int] || "Normal"
+ */
+export declare function rarityName(rarity: number, isResearch: boolean, blueprintVersion: number | undefined): string;
+/** Nationality int → display string. Matches Azur Lane wiki convention. */
+export declare const NATIONALITY_MAP: Record<number, string>;
+/** Look up a nationality code; falls back to "Universal". */
+export declare function nationalityName(code: number): string;
+/**
+ * Skill type int → AzurAPI color.
+ * 1 = offensive (yellow), 2 = support (pink), 3 = defensive (blue), 0 = unset (pink).
+ */
+export declare const SKILL_COLOR_MAP: Record<number, "red" | "pink" | "gold" | "yellow" | "blue">;
+/** Look up a skill type color; falls back to "pink". */
+export declare function skillColor(type: number): "red" | "pink" | "gold" | "yellow" | "blue";
+/**
+ * Stat index (0..11) → AzurAPI stat field name (on StatBlock).
+ * Only the 10 exposed stats. armor (6) and antisub (11) are intentionally missing.
+ */
+export declare const STAT_INDEX_TO_FIELD: Record<number, keyof StatBlock | undefined>;
+/**
+ * Fleet-tech attribute id → display name.
+ * From attribute_info_by_type.json, but hard-coded to avoid a data lookup per ship.
+ */
+export declare const FLEET_TECH_STAT_MAP: Record<number, string>;
+//# sourceMappingURL=enums.d.ts.map

package/dist/translate/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/translate/enums.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAM1D,kDAAkD;AAClD,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,YAAY,CAOhG,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,OAAO,EACnB,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC,MAAM,CAQR;AAMD,2EAA2E;AAC3E,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA4BlD,CAAC;AAEF,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAMD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAKvF,CAAC;AAEF,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAEpF;AAMD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,SAAS,GAAG,SAAS,CAa3E,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAatD,CAAC"}

package/dist/translate/enums.js

@@ -0,0 +1,126 @@
+// ---------------------------------------------------------------------------
+// Rarity
+// ---------------------------------------------------------------------------
+/** Maps integer rarity → AzurAPI rarity string */
+export const RARITY_MAP = {
+    1: "Normal",
+    2: "Normal",
+    3: "Rare",
+    4: "Elite",
+    5: "Super Rare",
+    6: "Ultra Rare",
+};
+/**
+ * Resolve a rarity integer to its display string.
+ *
+ * Rules:
+ *   - int === 6 && isResearch && blueprintVersion >= 6  → "Decisive"
+ *   - int === 6 && isResearch                            → "Priority"
+ *   - else                                               → RARITY_MAP[int] || "Normal"
+ */
+export function rarityName(rarity, isResearch, blueprintVersion) {
+    if (rarity === 6 && isResearch) {
+        if (blueprintVersion !== undefined && blueprintVersion >= 6) {
+            return "Decisive";
+        }
+        return "Priority";
+    }
+    return RARITY_MAP[rarity] ?? "Normal";
+}
+// ---------------------------------------------------------------------------
+// Nationality
+// ---------------------------------------------------------------------------
+/** Nationality int → display string. Matches Azur Lane wiki convention. */
+export const NATIONALITY_MAP = {
+    0: "Universal",
+    1: "Eagle Union",
+    2: "Royal Navy",
+    3: "Sakura Empire",
+    4: "Iron Blood",
+    5: "Dragon Empery",
+    6: "Sardegna Empire",
+    7: "Northern Parliament",
+    8: "Iris Libre",
+    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",
+};
+/** Look up a nationality code; falls back to "Universal". */
+export function nationalityName(code) {
+    return NATIONALITY_MAP[code] ?? "Universal";
+}
+// ---------------------------------------------------------------------------
+// Skill color
+// ---------------------------------------------------------------------------
+/**
+ * Skill type int → AzurAPI color.
+ * 1 = offensive (yellow), 2 = support (pink), 3 = defensive (blue), 0 = unset (pink).
+ */
+export const SKILL_COLOR_MAP = {
+    0: "pink",
+    1: "yellow",
+    2: "pink",
+    3: "blue",
+};
+/** Look up a skill type color; falls back to "pink". */
+export function skillColor(type) {
+    return SKILL_COLOR_MAP[type] ?? "pink";
+}
+// ---------------------------------------------------------------------------
+// Stat index map
+// ---------------------------------------------------------------------------
+/**
+ * Stat index (0..11) → AzurAPI stat field name (on StatBlock).
+ * Only the 10 exposed stats. armor (6) and antisub (11) are intentionally missing.
+ */
+export const STAT_INDEX_TO_FIELD = {
+    0: "health",
+    1: "firepower",
+    2: "torpedo",
+    3: "antiwar", // AA — keep AzurAPI typo
+    4: "aviation",
+    5: "reload",
+    6: undefined, // armor — not in StatBlock
+    7: "accuracy",
+    8: "evasion",
+    9: "speed",
+    10: "luck",
+    11: undefined, // antisub — not in StatBlock
+};
+// ---------------------------------------------------------------------------
+// Fleet-tech stat map
+// ---------------------------------------------------------------------------
+/**
+ * Fleet-tech attribute id → display name.
+ * From attribute_info_by_type.json, but hard-coded to avoid a data lookup per ship.
+ */
+export const FLEET_TECH_STAT_MAP = {
+    1: "health",
+    2: "firepower",
+    3: "torpedo",
+    4: "antiaircraft",
+    5: "aviation",
+    6: "reload",
+    7: "armor",
+    8: "accuracy",
+    9: "evasion",
+    10: "speed",
+    11: "luck",
+    12: "antisub",
+};
+//# sourceMappingURL=enums.js.map

package/dist/translate/enums.js.map

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

package/dist/translate/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./enums.js";
+export * from "./lookups.js";
+export * from "./strings.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/translate/index.js

@@ -0,0 +1,4 @@
+export * from "./enums.js";
+export * from "./lookups.js";
+export * from "./strings.js";
+//# sourceMappingURL=index.js.map

package/dist/translate/index.js.map

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

package/dist/translate/lookups.d.ts

@@ -0,0 +1,37 @@
+import type { FleetTechShipTemplate, FleetTechShipClass, ShipDataByType, EquipDataByType, SkillDataTemplate, SkillDataDisplay, VoiceActorCn } from "../schema/raw/index.js";
+/** Inputs required to build a Lookups helper. */
+export interface LookupInputs {
+    fleetTechShipTemplate: FleetTechShipTemplate;
+    fleetTechShipClass: FleetTechShipClass;
+    shipDataByType: ShipDataByType;
+    equipDataByType: EquipDataByType;
+    skillDataTemplate: SkillDataTemplate;
+    skillDataDisplay: SkillDataDisplay;
+    voiceActorCn: VoiceActorCn;
+}
+/** Lookup helper object returned by createLookups. */
+export interface Lookups {
+    /**
+     * group_type (string) → class name, e.g. "Edinburgh Class".
+     * Falls back to fallbackFromTagList if no fleet_tech entry is found.
+     */
+    classNameFor(groupType: string, fallbackFromTagList?: string): string;
+    /** type id → hull type pretty name. Fallback: "Unknown". */
+    hullTypeName(typeId: number): string;
+    /**
+     * equipment type id → display name.
+     * "type_name2" preferred, fallback "type_name". Fallback: "Unknown".
+     */
+    equipTypeName(typeId: number): string;
+    /**
+     * skill id → display name.
+     * Prefers skill_data_template.name, fallback skill_data_display.name.
+     * Fallback: `Skill ${id}`.
+     */
+    skillName(id: number): string;
+    /** voice actor code → name, fallback "Unknown". */
+    voiceActorName(code: number): string;
+}
+/** Build a Lookups helper from the raw upstream tables. */
+export declare function createLookups(inputs: LookupInputs): Lookups;
+//# sourceMappingURL=lookups.d.ts.map

package/dist/translate/lookups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookups.d.ts","sourceRoot":"","sources":["../../src/translate/lookups.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACb,MAAM,wBAAwB,CAAC;AAMhC,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,cAAc,EAAE,cAAc,CAAC;IAC/B,eAAe,EAAE,eAAe,CAAC;IACjC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,sDAAsD;AACtD,MAAM,WAAW,OAAO;IACtB;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtE,4DAA4D;IAC5D,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAErC;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtC;;;;OAIG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAE9B,mDAAmD;IACnD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACtC;AAMD,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAoE3D"}

package/dist/translate/lookups.js

@@ -0,0 +1,61 @@
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/** Build a Lookups helper from the raw upstream tables. */
+export function createLookups(inputs) {
+    const { fleetTechShipTemplate, fleetTechShipClass, shipDataByType, equipDataByType, skillDataTemplate, skillDataDisplay, voiceActorCn, } = inputs;
+    // Pre-build a code→name map for voice actors (keyed by `code` field value, not the record key)
+    const voiceActorByCode = new Map();
+    for (const entry of Object.values(voiceActorCn)) {
+        if (entry.code !== undefined && entry.actor_name !== undefined) {
+            voiceActorByCode.set(entry.code, entry.actor_name);
+        }
+    }
+    return {
+        classNameFor(groupType, fallbackFromTagList) {
+            const techEntry = fleetTechShipTemplate[groupType];
+            if (techEntry !== undefined) {
+                const classId = String(techEntry.class);
+                const classEntry = fleetTechShipClass[classId];
+                if (classEntry !== undefined) {
+                    return classEntry.name;
+                }
+            }
+            return fallbackFromTagList ?? "Unknown";
+        },
+        hullTypeName(typeId) {
+            const entry = shipDataByType[String(typeId)];
+            return entry?.type_name ?? "Unknown";
+        },
+        equipTypeName(typeId) {
+            const entry = equipDataByType[String(typeId)];
+            if (entry === undefined)
+                return "Unknown";
+            return entry.type_name2 ?? entry.type_name ?? "Unknown";
+        },
+        skillName(id) {
+            const key = String(id);
+            const templateEntry = skillDataTemplate[key];
+            if (templateEntry?.name !== undefined) {
+                return templateEntry.name;
+            }
+            const displayEntry = skillDataDisplay[key];
+            if (displayEntry?.name !== undefined) {
+                return displayEntry.name;
+            }
+            return `Skill ${id}`;
+        },
+        voiceActorName(code) {
+            // Try the pre-built code→name map first (keyed by the `code` field in each record)
+            const byCode = voiceActorByCode.get(code);
+            if (byCode !== undefined)
+                return byCode;
+            // Also try looking up by record key directly (some files key by code number)
+            const entry = voiceActorCn[String(code)];
+            if (entry?.actor_name !== undefined)
+                return entry.actor_name;
+            return "Unknown";
+        },
+    };
+}
+//# sourceMappingURL=lookups.js.map

package/dist/translate/lookups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookups.js","sourceRoot":"","sources":["../../src/translate/lookups.ts"],"names":[],"mappings":"AAqDA,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAAC,MAAoB;IAChD,MAAM,EACJ,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,GACb,GAAG,MAAM,CAAC;IAEX,+FAA+F;IAC/F,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACnD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAChD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAC/D,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,OAAO;QACL,YAAY,CAAC,SAAiB,EAAE,mBAA4B;YAC1D,MAAM,SAAS,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;YACnD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBACxC,MAAM,UAAU,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;gBAC/C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;oBAC7B,OAAO,UAAU,CAAC,IAAI,CAAC;gBACzB,CAAC;YACH,CAAC;YACD,OAAO,mBAAmB,IAAI,SAAS,CAAC;QAC1C,CAAC;QAED,YAAY,CAAC,MAAc;YACzB,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7C,OAAO,KAAK,EAAE,SAAS,IAAI,SAAS,CAAC;QACvC,CAAC;QAED,aAAa,CAAC,MAAc;YAC1B,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC9C,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC;YAC1C,OAAO,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,SAAS,IAAI,SAAS,CAAC;QAC1D,CAAC;QAED,SAAS,CAAC,EAAU;YAClB,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;YACvB,MAAM,aAAa,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;YAC7C,IAAI,aAAa,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;gBACtC,OAAO,aAAa,CAAC,IAAI,CAAC;YAC5B,CAAC;YACD,MAAM,YAAY,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YAC3C,IAAI,YAAY,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;gBACrC,OAAO,YAAY,CAAC,IAAI,CAAC;YAC3B,CAAC;YACD,OAAO,SAAS,EAAE,EAAE,CAAC;QACvB,CAAC;QAED,cAAc,CAAC,IAAY;YACzB,mFAAmF;YACnF,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,MAAM,CAAC;YAExC,6EAA6E;YAC7E,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACzC,IAAI,KAAK,EAAE,UAAU,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC,UAAU,CAAC;YAE7D,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/translate/strings.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Format a raw skill description by substituting $1, $2, ... placeholders.
+ *
+ * @example
+ *   substitutePlaceholders("Increases DMG by $1 and AoE by $2.", ["25.0%", "3.0%"])
+ *   // → "Increases DMG by 25.0% and AoE by 3.0%."
+ */
+export declare function substitutePlaceholders(raw: string, substitutions: ReadonlyArray<string>): string;
+/**
+ * Extract the max-rank substitution value from a skill's desc_add array.
+ *
+ * The true shape of desc_add is `Array<Array<Array<string | number>>>`:
+ *   - Outer: one entry per placeholder ($N → outer[N-1])
+ *   - Middle: one entry per skill level (length = max_level, usually 10)
+ *   - Inner: a tuple of [current_value, delta] or [value] — we take index 0
+ *
+ * For the max-rank value we take desc_add[n-1][maxLevel-1][0].
+ * If anything looks wrong, we use the last available entry, or "" as a last resort.
+ */
+export declare function extractMaxLevelSubstitutions(descAdd: unknown, maxLevel: number): string[];
+/**
+ * Convert star count 1..6 to a unicode-star string like "★★★★".
+ */
+export declare function starsString(count: number): string;
+/**
+ * Convert an EN ship name to a wiki URL.
+ * e.g. "Belfast" → "https://azurlane.koumakan.jp/wiki/Belfast"
+ */
+export declare function wikiUrlFor(name: string): string;
+/**
+ * Split a limit-break bonus string on "/" or "|" into bullet items. Trim whitespace.
+ *
+ * @example
+ *   splitLimitBreakBonuses("Unlock X/Main gun +5%/+10 FP")
+ *   // → ["Unlock X", "Main gun +5%", "+10 FP"]
+ *
+ * Returns [] for the empty string or for "None".
+ */
+export declare function splitLimitBreakBonuses(raw: string): string[];
+//# sourceMappingURL=strings.d.ts.map

package/dist/translate/strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/translate/strings.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,GACnC,MAAM,CAKR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,CA8BV;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAMD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAMD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAI5D"}

package/dist/translate/strings.js

@@ -0,0 +1,92 @@
+// ---------------------------------------------------------------------------
+// Placeholder substitution
+// ---------------------------------------------------------------------------
+/**
+ * Format a raw skill description by substituting $1, $2, ... placeholders.
+ *
+ * @example
+ *   substitutePlaceholders("Increases DMG by $1 and AoE by $2.", ["25.0%", "3.0%"])
+ *   // → "Increases DMG by 25.0% and AoE by 3.0%."
+ */
+export function substitutePlaceholders(raw, substitutions) {
+    return raw.replace(/\$(\d+)/g, (_match, indexStr) => {
+        const idx = parseInt(indexStr, 10) - 1; // convert 1-based to 0-based
+        return substitutions[idx] ?? _match;
+    });
+}
+/**
+ * Extract the max-rank substitution value from a skill's desc_add array.
+ *
+ * The true shape of desc_add is `Array<Array<Array<string | number>>>`:
+ *   - Outer: one entry per placeholder ($N → outer[N-1])
+ *   - Middle: one entry per skill level (length = max_level, usually 10)
+ *   - Inner: a tuple of [current_value, delta] or [value] — we take index 0
+ *
+ * For the max-rank value we take desc_add[n-1][maxLevel-1][0].
+ * If anything looks wrong, we use the last available entry, or "" as a last resort.
+ */
+export function extractMaxLevelSubstitutions(descAdd, maxLevel) {
+    if (!Array.isArray(descAdd))
+        return [];
+    const result = [];
+    for (const outerEntry of descAdd) {
+        // outerEntry should be an array of per-level arrays
+        if (!Array.isArray(outerEntry) || outerEntry.length === 0) {
+            result.push("");
+            continue;
+        }
+        // Pick the last-level entry, clamped to available entries
+        const levelIndex = Math.min(maxLevel - 1, outerEntry.length - 1);
+        const innerEntry = outerEntry[Math.max(0, levelIndex)];
+        if (!Array.isArray(innerEntry) || innerEntry.length === 0) {
+            result.push("");
+            continue;
+        }
+        const value = innerEntry[0];
+        if (value === null || value === undefined) {
+            result.push("");
+        }
+        else {
+            result.push(String(value));
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Stars
+// ---------------------------------------------------------------------------
+/**
+ * Convert star count 1..6 to a unicode-star string like "★★★★".
+ */
+export function starsString(count) {
+    return "★".repeat(Math.max(0, count));
+}
+// ---------------------------------------------------------------------------
+// Wiki URL
+// ---------------------------------------------------------------------------
+/**
+ * Convert an EN ship name to a wiki URL.
+ * e.g. "Belfast" → "https://azurlane.koumakan.jp/wiki/Belfast"
+ */
+export function wikiUrlFor(name) {
+    return `https://azurlane.koumakan.jp/wiki/${encodeURIComponent(name)}`;
+}
+// ---------------------------------------------------------------------------
+// Limit break bonus string splitting
+// ---------------------------------------------------------------------------
+/**
+ * Split a limit-break bonus string on "/" or "|" into bullet items. Trim whitespace.
+ *
+ * @example
+ *   splitLimitBreakBonuses("Unlock X/Main gun +5%/+10 FP")
+ *   // → ["Unlock X", "Main gun +5%", "+10 FP"]
+ *
+ * Returns [] for the empty string or for "None".
+ */
+export function splitLimitBreakBonuses(raw) {
+    const trimmed = raw.trim();
+    if (trimmed === "" || trimmed === "None")
+        return [];
+    return trimmed.split(/[/|]/).map((s) => s.trim()).filter((s) => s.length > 0);
+}
+//# sourceMappingURL=strings.js.map

package/dist/translate/strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.js","sourceRoot":"","sources":["../../src/translate/strings.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAW,EACX,aAAoC;IAEpC,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,QAAgB,EAAE,EAAE;QAC1D,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,6BAA6B;QACrE,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,4BAA4B,CAC1C,OAAgB,EAChB,QAAgB;IAEhB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,CAAC;QACjC,oDAAoD;QACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChB,SAAS;QACX,CAAC;QAED,0DAA0D;QAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QAEvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChB,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,qCAAqC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;AACzE,CAAC;AAED,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IACpD,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAChF,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@lycoristech/azurdata",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "data"
+  ],
+  "scripts": {
+    "build": "npx tsc -p tsconfig.build.json && npx tsc -p tsconfig.cjs.json && echo\n  '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
+    "build:data": "tsx scripts/build-data.ts",
+    "verify": "tsx scripts/verify.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepare": "tsc -p tsconfig.build.json && tsc -p tsconfig.cjs.json && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json"
+  },
+  "dependencies": {
+    "fuse.js": "^7.0.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.1"
+  }
+}