@malib/gear 0.14.0 → 0.15.1

package/internal.d.ts

@@ -12,6 +12,12 @@ export * from "./lib/logic/exceptional";
 export * from "./lib/logic/exceptionalparts";
 export * from "./lib/logic/scroll";
 export * from "./lib/logic/upgrade";
+export * from "./lib/create/interfaces/gear";
+export * from "./lib/create/interfaces/itemoption";
+export * from "./lib/create/interfaces/soul";
+export * from "./lib/create/create-gear";
+export * from "./lib/create/create-potential";
+export * from "./lib/create/create-soul";
 export * from "./lib/migrate/migrate";
 export * from "./lib/serialize/fromplain";
 export * from "./lib/serialize/interface";

package/lib/create/create-gear.d.ts

@@ -0,0 +1,38 @@
+import { Gear, Potential } from "../..";
+import { IPotentialRepository } from "./create-potential";
+import { GearData, GearDataMap } from "./interfaces/gear";
+/**
+ * 장비 정보로부터 장비를 생성합니다.
+ * @param node 장비 정보 노드.
+ * @param id 장비 아이템 ID.
+ * @param getPotentialFunc 코드에 해당하는 잠재능력을 반환하는 함수.
+ * @returns 아이템 정보에 해당하는 장비.
+ */
+export declare function createGearFromNode(node: GearData, id: number, getPotentialFunc: (code: number, potentialLevel: number) => Potential | undefined): Gear;
+export interface IGearRepository {
+    ids(): number[];
+    createGearFromId(id: number): Gear | undefined;
+}
+export declare class GearRepository implements IGearRepository {
+    /**
+     * KMS 장비 정보
+     */
+    private gears;
+    private potentialRepository;
+    /**
+     * @param gears KMS 장비 정보
+     * @param
+     */
+    constructor(gears: GearDataMap, potentialRepository: IPotentialRepository);
+    /**
+     * 아이템 ID 목록을 반환합니다.
+     * @returns 아이템 ID 목록
+     */
+    ids(): number[];
+    /**
+     * 아이템 ID로부터 장비를 생성합니다.
+     * @param id 장비 아이템 ID.
+     * @returns 아이템 ID에 해당하는 장비. 장비가 존재하지 않을 경우 `undefined`를 반환합니다.
+     */
+    createGearFromId(id: number): Gear | undefined;
+}

package/lib/create/create-potential.d.ts

@@ -0,0 +1,32 @@
+import { Potential } from "../..";
+import { ItemOption, ItemOptionMap } from "./interfaces/itemoption";
+/**
+ * 잠재옵션 정보로부터 잠재옵션을 생성합니다.
+ * 잠재옵션에 `incDAMr` 속성과 `boss` 속성이 존재할 경우 `incBDR` 속성으로 대체됩니다.
+ * @param node 잠재옵션 정보 노드.
+ * @param code 잠재옵션 코드.
+ * @param potentialLevel 장비의 착용 가능 레벨로 계산되는 잠재옵션 레벨. `1`부터 `25`까지의 값입니다.
+ * @returns 정보에 해당하는 잠재옵션.
+ */
+export declare function createPotentialFromNode(node: ItemOption, code: number, potentialLevel: number): Potential;
+export interface IPotentialRepository {
+    createPotentialFromCode(code: number, potentialLevel: number): Potential | undefined;
+}
+export declare class PotentialRepository implements IPotentialRepository {
+    /**
+     * KMS 잠재옵션 정보
+     */
+    private itemOptions;
+    /**
+     * @param itemOptions KMS 잠재옵션 정보
+     */
+    constructor(itemOptions: ItemOptionMap);
+    /**
+     * 잠재옵션 코드로부터 잠재옵션을 생성합니다.
+     * 잠재옵션에 `incDAMr` 속성과 `boss` 속성이 존재할 경우 `incBDR` 속성으로 대체됩니다.
+     * @param code 잠재옵션 코드.
+     * @param potentialLevel 장비의 착용 가능 레벨로 계산되는 잠재옵션 레벨. `1`부터 `25`까지의 값입니다.
+     * @returns 코드에 해당하는 잠재옵션. 존재하지 않을 경우 `undefined`를 반환합니다.
+     */
+    createPotentialFromCode(code: number, potentialLevel: number): Potential | undefined;
+}

package/lib/create/create-soul.d.ts

@@ -0,0 +1,56 @@
+import { Soul } from "../..";
+import { SoulData, SoulDataMap } from "./interfaces/soul";
+/**
+ * 위대한 소울 옵션 종류
+ */
+export declare enum MagnificentSoulOptionType {
+    /** 공격력, 공격력% */
+    PAD = "PAD",
+    /** 마력, 마력% */
+    MAD = "MAD",
+    /** 올스탯, 올스탯% */
+    allStat = "allStat",
+    /** 최대 HP */
+    MHP = "MHP",
+    /** 크리티컬 확률 */
+    cr = "cr",
+    /** 보스 데미지 */
+    bdR = "bdR",
+    /** 방어율 무시 */
+    imdR = "imdR"
+}
+/**
+ * 소울 정보로부터 소울을 생성합니다.
+ * @param node 소울 정보.
+ * @param type 위대한 소울 옵션 종류. 기본값은 `PAD`입니다.
+ * 위대한 소울이 아닐 경우 무시합니다.
+ * @returns 정보에 해당하는 소울.
+ */
+export declare function createSoulFromNode(node: SoulData, type?: MagnificentSoulOptionType): Soul;
+export interface ISoulRepository {
+    ids(): number[];
+    createSoulFromId(id: number, ...args: unknown[]): Soul | undefined;
+}
+export declare class SoulRepository implements ISoulRepository {
+    /**
+     * KMS 소울 정보
+     */
+    private souls;
+    /**
+     * @param souls KMS 소울 정보
+     */
+    constructor(souls: SoulDataMap);
+    /**
+     * 소울 ID 목록을 반환합니다.
+     * @returns 소울 ID 목록
+     */
+    ids(): number[];
+    /**
+     * 소울 ID로부터 소울를 생성합니다.
+     * @param id 소울 ID.
+     * @param type 위대한 소울 옵션 종류. 기본값은 `PAD`입니다.
+     * 위대한 소울이 아닐 경우 무시합니다.
+     * @returns 정보에 해당하는 소울. 존재하지 않을 경우 `undefined`를 반환합니다.
+     */
+    createSoulFromId(id: number, type?: MagnificentSoulOptionType): Soul | undefined;
+}

package/lib/create/interfaces/gear.d.ts

@@ -0,0 +1,27 @@
+export interface GearDataMap {
+    [gearID: string]: GearData;
+}
+export interface GearData {
+    name: string;
+    desc?: string;
+    icon: number;
+    req?: GearReqData;
+    props?: Record<string, number>;
+    options?: Record<string, number>;
+    tuc?: number;
+    etuc?: number;
+    pots?: SpecialOptionData[];
+}
+export interface GearReqData {
+    level: number;
+    str?: number;
+    luk?: number;
+    dex?: number;
+    int?: number;
+    job?: number;
+    specJob?: number;
+}
+export interface SpecialOptionData {
+    option: number;
+    level: number;
+}

package/lib/create/interfaces/itemoption.d.ts

@@ -0,0 +1,13 @@
+export interface ItemOptionMap {
+    [gearID: string]: ItemOption;
+}
+export interface ItemOption {
+    optionType?: number;
+    reqLevel?: number;
+    string: string;
+    level: {
+        [level: number]: {
+            [name: string]: number | string;
+        };
+    };
+}

package/lib/create/interfaces/soul.d.ts

@@ -0,0 +1,17 @@
+export interface SoulDataMap {
+    [soulID: string]: SoulData;
+}
+export interface SoulData {
+    name: string;
+    skill: string;
+    multiplier: number;
+    magnificent?: boolean;
+    option?: SoulOption;
+    options?: MagnificentSoulOption;
+}
+export interface SoulOption {
+    [type: string]: number;
+}
+export interface MagnificentSoulOption {
+    [magnificentType: string]: SoulOption;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@malib/gear",
-  "version": "0.14.0",
+  "version": "0.15.1",
   "type": "module",
   "main": "index.js",
   "module": "index.js",