@malib/gear 0.1.1 → 0.3.0

package/internal.d.ts

@@ -0,0 +1,14 @@
+export * from "./lib/gear";
+export * from "./lib/gearicon";
+export * from "./lib/gearoption";
+export * from "./lib/gearproptype";
+export * from "./lib/gearreq";
+export * from "./lib/geartype";
+export * from "./lib/potential";
+export * from "./lib/potentialgrade";
+export * from "./lib/soul";
+export * from "./lib/logic/bonusstat";
+export * from "./lib/logic/bonusstattype";
+export * from "./lib/logic/enhancement";
+export * from "./lib/logic/scroll";
+export * from "./lib/logic/upgrade";

package/lib/gear.d.ts

@@ -1,10 +1,11 @@
+import { GearIcon } from "./gearicon";
 import { GearOption } from "./gearoption";
 import { GearPropType } from "./gearproptype";
 import { GearReq } from "./gearreq";
 import { GearType } from "./geartype";
 import { Potential } from "./potential";
 import { PotentialGrade } from "./potentialgrade";
-import { SoulSlot } from "./soul";
+import { SoulWeapon } from "./soul";
 /**
  * 장비
  */
@@ -16,9 +17,7 @@ export declare class Gear {
     /** 설명 */
     desc: string;
     /** 아이콘 */
-    icon: number;
-    /** 아이콘 오프셋 */
-    origin: [number, number];
+    icon: GearIcon;
     /** 장비 분류 */
     type: GearType;
     /** 장비 착용 제한 */
@@ -28,7 +27,7 @@ export declare class Gear {
     /**
      * 장비 옵션
      *
-     * 접근할 때는 `options` 대신 `option`을 사용하는 것이 권장됩니다.
+     * 개별 속성 접근 시 이 속성 대신 `option`을 사용하는 것이 권장됩니다.
      */
     options: Map<GearPropType, GearOption>;
     /** 최대 업그레이드 가능 횟수 */
@@ -56,100 +55,98 @@ export declare class Gear {
     /** 에디셔널 잠재옵션 목록 */
     additionalPotentials: Potential[];
     /** 소울 */
-    soulSlot: SoulSlot;
+    soulWeapon: SoulWeapon;
     /**
      * 업그레이드 가능 횟수
      */
     get upgradeCountLeft(): number;
     /**
-     * 현재 옵션과 기본 옵션의 차이를 가중치를 포함하여 계산합니다.
-     * @returns 가중치가 적용된 옵션 차이의 합
+     * 가중치를 포함하여 계산한 현재 옵션과 기본 옵션의 차이
      */
     get diff(): number;
     /**
-     * 장비 옵션을 반환합니다. 존재하지 않는 옵션은 장비에 추가됩니다.
-     * @param type 장비 옵션 종류
-     * @returns 장비 옵션 객체
+     * 지정된 장비 옵션 종류과 연결된 옵션을 가져옵니다.
+     * @param type 장비 옵션 종류.
+     * @returns 장비 옵션 객체. 존재하지 않을 경우 장비에 추가한 뒤 반환합니다.
      */
     option(type: GearPropType): GearOption;
     /**
-     * 장비 속성의 값을 반환합니다.
-     * @param type 장비 속성
-     * @returns 속성의 값; 존재하지 않을 경우 `0`
+     * 지정된 장비 속성 종류과 연결된 값을 가져옵니다.
+     * @param type 장비 속성 종류.
+     * @returns 속성의 값. 장비에 존재하지 않을 경우 추가하지 않고 `0`을 반환합니다.
      */
     getPropValue(type: GearPropType): number;
     /**
-     * 장비 속성의 값을 `boolean` 형식으로 반환합니다.
-     * @param type 장비 속성
-     * @returns 속성이 존재하고 값이 `0` 이상일 경우 `true`; 아닐 경우 `false`
+     * 지정된 장비 속성 종류과 연결된 `boolean` 값을 가져옵니다.
+     * @param type 장비 속성 종류.
+     * @returns 속성이 존재하고 값이 `0` 이상일 경우 `true`; 아닐 경우 `false`.
      */
     getBooleanValue(type: GearPropType): boolean;
     /**
-     * 장비가 주무기인지 여부를 나타내는 `boolean`값을 반환합니다. 블레이드(katara)는 포함되지 않습니다.
-     * @param type 장비 분류
-     * @returns 주무기일 경우 `true`; 아닐 경우 `false`
+     * 장비 분류가 주무기인지 여부를 확인합니다. 블레이드(`katara`)는 포함되지 않습니다.
+     * @param type 장비 분류.
+     * @returns 주무기일 경우 `true`; 아닐 경우 `false`.
      */
     static isWeapon(type: GearType): boolean;
     /**
-     * 장비가 한손무기인지 여부를 나타내는 `boolean`값을 반환합니다. 블레이드(katara)는 포함되지 않습니다.
-     * @param type 장비 분류
-     * @returns 한손무기일 경우 `true`; 아닐 경우 `false`
+     * 장비 분류가 한손무기인지 여부를 확인합니다. 블레이드(`katara`)는 포함되지 않습니다.
+     * @param type 장비 분류.
+     * @returns 한손무기일 경우 `true`; 아닐 경우 `false`.
      */
     static isLeftWeapon(type: GearType): boolean;
     /**
-     * 장비가 두손무기인지 여부를 나타내는 `boolean`값을 반환합니다.
-     * @param type 장비 분류
-     * @returns 두손무기일 경우 `true`; 아닐 경우 `false`
+     * 장비 분류가 두손무기인지 여부를 확인합니다.
+     * @param type 장비 분류.
+     * @returns 두손무기일 경우 `true`; 아닐 경우 `false`.
      */
     static isDoubleHandWeapon(type: GearType): boolean;
     /**
-     * 장비가 보조무기인지 여부를 나타내는 `boolean`값을 반환합니다. 블레이드(katara), 방패류가 포함됩니다.
-     * @param type 장비 분류
-     * @returns 보조무기일 경우 `true`; 아닐 경우 `false`
+     * 장비 분류가 보조무기인지 여부를 확인합니다. 블레이드(`katara`), 방패류가 포함됩니다.
+     * @param type 장비 분류.
+     * @returns 보조무기일 경우 `true`; 아닐 경우 `false`.
      */
     static isSubWeapon(type: GearType): boolean;
     /**
-     * 장비가 방패인지 여부를 나타내는 `boolean`값을 반환합니다.
-     * @param type 장비 분류
-     * @returns 방패일 경우 `true`; 아닐 경우 `false`
+     * 장비 분류가 방패인지 여부를 확인합니다.
+     * @param type 장비 분류.
+     * @returns 방패일 경우 `true`; 아닐 경우 `false`.
      */
     static isShield(type: GearType): boolean;
     /**
-     * 장비가 방어구인지 여부를 나타내는 `boolean`값을 반환합니다. 방패가 포함됩니다.
-     * @param type 장비 분류
-     * @returns 방어구일 경우 `true`; 아닐 경우 `false`
+     * 장비 분류가 방어구인지 여부를 확인합니다. 어깨장식이 포함되지 않고 방패가 포함됩니다.
+     * @param type 장비 분류.
+     * @returns 방어구일 경우 `true`; 아닐 경우 `false`.
      */
     static isArmor(type: GearType): boolean;
     /**
-     * 장비가 장신구인지 여부를 나타내는 `boolean`값을 반환합니다.
-     * @param type 장비 분류
-     * @returns 장신구일 경우 `true`; 아닐 경우 `false`
+     * 장비 분류가 장신구인지 여부를 확인합니다. 어깨장식이 포함됩니다.
+     * @param type 장비 분류.
+     * @returns 장신구일 경우 `true`; 아닐 경우 `false`.
      */
     static isAccessory(type: GearType): boolean;
     /**
-     * 장비가 메카닉 장비인지 여부를 나타내는 `boolean`값을 반환합니다.
-     * @param type 장비 분류
-     * @returns 메카닉 장비일 경우 `true`; 아닐 경우 `false`
+     * 장비 분류가 메카닉 장비인지 여부를 확인합니다.
+     * @param type 장비 분류.
+     * @returns 메카닉 장비일 경우 `true`; 아닐 경우 `false`.
      */
     static isMechanicGear(type: GearType): boolean;
     /**
-     * 장비가 에반 드래곤 장비인지 여부를 나타내는 `boolean`값을 반환합니다.
-     * @param type 장비 분류
-     * @returns 에반 드래곤 장비일 경우 `true`; 아닐 경우 `false`
+     * 장비 분류가 에반 드래곤 장비인지 여부를 확인합니다.
+     * @param type 장비 분류.
+     * @returns 에반 드래곤 장비일 경우 `true`; 아닐 경우 `false`.
      */
     static isDragonGear(type: GearType): boolean;
-    static specialCanPotential(type: GearType): boolean;
     /**
      * 장비 ID로부터 장비 분류를 계산합니다.
-     * @param gearID 장비 ID
-     * @returns 장비 분류
+     * @param gearID 장비 ID.
+     * @returns 장비 분류.
      */
     static getGearType(gearID: number): GearType;
-    static GetGender(gearID: number): number;
     /**
      * 장비의 최대 강화 수치를 계산합니다.
-     * @param gear 장비
-     * @returns 최대 장비 강화 수치
+     * @param gear 계산할 장비.
+     * @returns 장비의 최대 강화 수치.
+     * 최대 업그레이드 가능 횟수가 `0`이거나 `onlyUpgrade` 속성이 존재하거나 메카닉 장비 또는 드래곤 장비일 경우 `0`입니다.
      */
     static getMaxStar(gear: Gear): number;
     private static readonly starData;

package/lib/gearicon.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 장비 아이콘
+ */
+export declare class GearIcon {
+    /** 아이콘 ID */
+    id: number;
+    /** 아이콘 오프셋 */
+    origin: [number, number];
+}

package/lib/gearreq.d.ts

@@ -4,13 +4,13 @@
 export declare class GearReq {
     /** 착용 가능 레벨 */
     level: number;
-    /** REQ STR */
+    /** 착용 가능 STR */
     str: number;
-    /** REQ LUK */
+    /** 착용 가능 LUK */
     luk: number;
-    /** REQ DEX */
+    /** 착용 가능 DEX */
     dex: number;
-    /** REQ INT */
+    /** 착용 가능 INT */
     int: number;
     /** 착용 가능 직업 분류 */
     job: number;

package/lib/logic/bonusstat.d.ts

@@ -1,28 +1,40 @@
 import { Gear } from "../gear";
 import { GearPropType } from "../gearproptype";
 import { BonusStatType } from "./bonusstattype";
+/**
+ * 추가옵션 등급
+ */
 export type BonusStatGrade = 1 | 2 | 3 | 4 | 5 | 6 | 7;
 /**
- * 추가옵션 관련 기능을 제공합니다.
- *
- * - '보스 아레나 엠블렘'은 지원하지 않습니다.
+ * 장비에 1개의 추가옵션을 추가합니다.
+ * @param gear 추가옵션을 추가할 장비.
+ * @param type 추가옵션 스탯 종류.
+ * @param grade 추가옵션 등급. `1`부터 `7`까지의 값입니다.
+ * @returns 추가했을 경우 `true`; 아닐 경우 `false`.
+ * 장비에 부여할 수 없는 추가옵션을 지정했을 경우 `false`를 반환합니다.
+ */
+export declare function addBonusStat(gear: Gear, type: BonusStatType, grade: BonusStatGrade): boolean;
+/**
+ * 장비에 적용된 추가옵션을 초기화합니다.
+ * @param gear 추가옵션을 초기화할 장비.
+ * @returns 항상 초기화에 성공하고 `true`를 반환합니다.
+ */
+export declare function resetBonusStat(gear: Gear): boolean;
+/**
+ * 추가옵션을 계산합니다.
+ * @param gear 추가옵션을 계산할 장비.
+ * @param type 추가옵션 스탯 종류.
+ * @param grade 추가옵션 등급. `1`부터 `7`까지의 값입니다.
+ * @returns 추가옵션이 포함된 `Map`.
+ * 장비에 부여할 수 없는 추가옵션을 지정했을 경우 빈 `Map`을 반환합니다.
+ */
+export declare function getBonusStatOption(gear: Gear, type: BonusStatType, grade: BonusStatGrade): Map<GearPropType, number>;
+/**
+ * 추가옵션 스탯 종류에 따른 값을 계산합니다.
+ * @param gear 추가옵션을 계산할 장비.
+ * @param type 추가옵션 스탯 종류.
+ * @param grade 추가옵션 등급. `1`부터 `7`까지의 값입니다.
+ * @returns 추가옵션 스탯 종류에 따른 값.
+ * 지정한 추가옵션을 적용할 수 없는 경우 `0`을 반환합니다.
  */
-export declare class BonusStatLogic {
-    /**
-     * 장비에 1개의 추가옵션을 추가합니다. 기존에 부여된 추가옵션에 더해집니다.
-     * @param gear 추가옵션을 추가할 장비
-     * @param type 추가옵션 스탯 종류
-     * @param grade 추가옵션 등급; 1~7의 정수
-     * @returns 추가옵션 부여애 성공했을 경우 `true`; 아닐 경우 `false`
-     */
-    addBonusStat(gear: Gear, type: BonusStatType, grade: BonusStatGrade): boolean;
-    /**
-     * 장비에 적용된 추가옵션을 초기화합니다.
-     * @param gear 추가옵션을 초기화할 장비
-     * @returns 추가옵션 초기화에 성공했을 경우 `true`; 아닐 경우 `false`
-     */
-    resetBonusStat(gear: Gear): boolean;
-    getBonusStatOption(gear: Gear, type: BonusStatType, grade: BonusStatGrade): Map<GearPropType, number>;
-    getBonusStatValue(gear: Gear, type: BonusStatType, grade: BonusStatGrade): number;
-    static getGearPropType(type: BonusStatType): GearPropType[];
-}
+export declare function getBonusStatValue(gear: Gear, type: BonusStatType, grade: BonusStatGrade): number;

package/lib/logic/enhancement.d.ts

@@ -1,62 +1,40 @@
 import { Gear } from "../gear";
 /**
- * 장비 강화 관련 기능을 제공합니다.
- *
- * - 스타포스 강화 이후 주문서 수치가 변동될 경우 `recalculate` 함수를 호출해야 합니다.
+ * 장비에 스타포스 강화를 1회 적용합니다.
+ * 업그레이드가 완료되지 않은 장비, 놀라운 장비강화 주문서가 적용된 장비에도 적용할 수 있습니다.
+ * 주문서 수치가 변경될 경우 `recalculate` 함수를 직접 적용해야 합니다.
+ * @param gear 강화를 적용할 장비.
+ * @param ignoreMaxStar 장비의 최대 강화 수치를 초과하여 강화하는지 여부. 기본값은 `false`입니다.
+ * 슈페리얼 장비일 경우 무시합니다.
+ * @returns 적용했을 경우 `true`; 아닐 경우 `false`.
+ * `ignoreMaxStar`가 `false`고 장비의 현재 강화 수치가 최대 강화 수치와 동일하거나,
+ * `ignoreMaxStar`가 `true`고 장비의 현재 강화 수치가 `25`이거나,
+ * 놀라운 장비강화 주문서가 적용된 상태이고 장비의 현재 강화 수치가 `15`일 경우 `false`를 반환합니다.
  */
-export declare class EnhancementLogic {
-    private static readonly MAX_STARFORCE;
-    private static readonly MAX_AMAZING;
-    /**
-     * 장비에 스타포스 강화를 1회 적용합니다.
-     * - 업그레이드가 완료되지 않은 장비, 놀라운 장비강화 주문서가 적용된 장비에도 적용됩니다.
-     * @param gear 강화를 적용할 장비
-     * @param ignoreMaxStar 장비의 최대 강화 수치를 초과하여 강화하는지 여부
-     * - 슈페리얼 장비는 최대 강화 수치를 초과할 수 없음
-     * @returns 성공했을 경우 `true`; 아닐 경우 `false`
-     */
-    addStarforce(gear: Gear, ignoreMaxStar?: boolean): boolean;
-    /**
-     * 슈페리얼 장비에 스타포스 강화를 1회 적용합니다.
-     */
-    private addSuperiorStarforce;
-    /**
-     * 장비에 놀라운 장비강화 주문서를 1회 적용합니다.
-     *
-     * 스타포스가 적용된 장비에도 사용 가능합니다. 슈페리얼 장비에는 적용되지 않습니다.
-     * @param gear 강화를 적용할 장비
-     * @param ignoreMaxStar 장비의 최대 강화 수치 초과로 강화하는 지 여부
-     * - ex) 착용 제한 레벨이 100인 장비는 최대 강화 수치가 8성이지만 `ignoreMaxStar`가 `true`일 경우 15성까지 강화 가능
-     * @param bonus 보너스 스탯 적용 여부
-     * - 방어구(방패 제외): 최대 HP +50
-     * - 장신구: 올스탯 +1~2
-     * - 주무기, 블레이드, 방패: 공격력, 마력 +1
-     * @returns 성공했을 경우 `true`; 아닐 경우 `false`
-     */
-    addAmazingEnhancement(gear: Gear, bonus?: boolean, ignoreMaxStar?: boolean): boolean;
-    /**
-     * 장비 강화를 초기화합니다.
-     * @param 강화를 초기화할 장비
-     * @returns 성공했을 경우 `true`; 아닐 경우 `false`
-     */
-    resetEnhancement(gear: Gear): boolean;
-    /**
-     * 스타포스 강화로 오르는 스탯을 다시 계산합니다.
-     *
-     * 놀라운 장비강화 주문서가 적용된 장비에는 적용되지 않습니다.
-     * @param 스탯을 다시 계산할 장비
-     * @returns 성공했을 경우 `true`; 아닐 경우 `false`
-     */
-    recalculate(gear: Gear): boolean;
-    private static getStatData;
-    private static readonly superiorAttData;
-    private static readonly superiorStatData;
-    private static readonly starforceWeaponAttData;
-    private static readonly starforceAttData;
-    private static readonly starforceStatData;
-    private static readonly amazingAttData;
-    private static readonly amazingStatData;
-    private static readonly starforceGloveBonusAttData;
-    private static readonly starforceMhpData;
-    private static readonly starforceSpeedJumpData;
-}
+export declare function addStarforce(gear: Gear, ignoreMaxStar?: boolean): boolean;
+/**
+ * 장비에 놀라운 장비강화 주문서를 1회 적용합니다.
+ * 업그레이드가 완료되지 않은 장비, 스타포스 강화가 적용된 장비에도 적용할 수 있습니다. 슈페리얼 장비에는 적용할 수 없습니다.
+ * @param gear 강화를 적용할 장비.
+ * @param bonus 보너스 스탯 적용 여부.
+ * 장비 분류가 방어구(방패 제외)일 경우 최대 HP 50, 장신구일 경우 올스탯 1또는 2, 주무기/블레이드/방패일 경우 공격력 및 마력 1을 적용합니다.
+ * @param ignoreMaxStar 장비의 최대 강화 수치를 초과하여 강화하는지 여부. 기본값은 `false`입니다.
+ * @returns 적용했을 경우 `true`; 아닐 경우 `false`.
+ * 슈페리얼 장비거나,
+ * `ignoreMaxStar`가 `false`고 장비의 현재 강화 수치가 최대 강화 수치와 동일하거나,
+ * `ignoreMaxStar`가 `true`고 장비의 현재 강화 수치가 `15`일 경우 `false`를 반환합니다.
+ */
+export declare function addAmazingEnhancement(gear: Gear, bonus?: boolean, ignoreMaxStar?: boolean): boolean;
+/**
+ * 장비 강화를 초기화합니다.
+ * @param 강화를 초기화할 장비.
+ * @returns 초기화했을 경우 `true`; 아닐 경우 `false`.
+ */
+export declare function resetEnhancement(gear: Gear): boolean;
+/**
+ * 스타포스 강화로 오르는 스탯을 다시 계산합니다. 주문서 강화 수치에 변동이 있을 경우 적용해야 합니다.
+ * @param 스탯을 다시 계산할 장비.
+ * @returns 성공했을 경우 `true`; 아닐 경우 `false`.
+ * 놀라운 장비강화 주문서가 적용된 장비일 경우 `false`를 반환합니다.
+ */
+export declare function recalculateStarforce(gear: Gear): boolean;

package/lib/logic/scroll.d.ts

@@ -1,6 +1,12 @@
 import { Gear } from "../gear";
 import { GearPropType } from "../gearproptype";
+/**
+ * 주문의 흔적 성공 확률
+ */
 export type SpellTraceProbability = 100 | 70 | 30 | 15;
+/**
+ * 주문의 흔적 스탯 종류
+ */
 export type SpellTraceStatType = GearPropType.incSTR | GearPropType.incDEX | GearPropType.incINT | GearPropType.incLUK | GearPropType.incAllStat | GearPropType.incMHP;
 /**
  * 주문서
@@ -12,17 +18,12 @@ export declare class Scroll {
     stat: Map<GearPropType, number>;
     constructor(name?: string, stats?: Map<GearPropType, number>);
     /**
-     * 주문의 흔적 `Scroll`을 반환합니다.
-     * @param gear 적용할 장비
-     * @param type 주문의 흔적 스탯 종류; 다음 값 중 하나입니다:
-     *
-     * `GearPropType.incSTR` / `GearPropType.incDEX` /
-     * `GearPropType.incINT` / `GearPropType.incLUK` /
-     * `GearPropType.incAllStat` / `GearPropType.incMHP`
-     * @param probability 주문의 흔적 성공 확률 %; 다음 값 중 하나입니다:
-     *
-     * `100` / `70` / `30` / `15`
-     * @returns 주문의 흔적 `Scroll`; 존재하지 않을 경우 `undefined`
+     * 주문의 흔적 주문서를 생성합니다.
+     * @param gear 주문의 흔적을 적용할 장비.
+     * @param type 주문의 흔적 스탯 종류. `GearPropType` 타입이고
+     * `incSTR` / `incDEX` / `incINT` / `incLUK` / `incAllStat` / `incMHP` 중 하나입니다.
+     * @param probability 주문의 흔적 성공 확률. `100` / `70` / `30` / `15` 중 하나입니다.
+     * @returns 주문의 흔적 주문서. 지정된 장비, 스탯, 확률을 만족하는 주문서가 존재하지 않을 경우 `undefined`를 반환합니다.
      */
     static getSpellTraceScroll(gear: Gear, type: SpellTraceStatType, probability: SpellTraceProbability): Scroll | undefined;
 }

package/lib/logic/upgrade.d.ts

@@ -1,54 +1,47 @@
 import { Gear } from "../gear";
 import { Scroll, SpellTraceProbability, SpellTraceStatType } from "./scroll";
 /**
- * 주문서 업그레이드 관련 기능을 제공합니다.
+ * 장비에 황금망치를 적용합니다.
+ * @param gear 황금망치를 적용할 장비.
+ * @returns 황금망치를 적용했을 경우 `true`; 아닐 경우 `false`.
+ * 장비에 황금망치 적용 불가 속성이 존재하거나 전용 주문서가 존재하거나 이미 황금망치가 적용되었을 경우 `false`를 반환합니다.
  */
-export declare class UpgradeLogic {
-    /**
-     * 장비에 황금망치를 적용합니다.
-     * @param gear 황금망치를 적용할 장비
-     * @returns 황금망치가 적용됐을 경우 `true`; 아닐 경우 `false`
-     */
-    applyGoldHammer(gear: Gear): boolean;
-    /**
-     * 장비에 주문서를 1회 적용합니다.
-     * @param gear 주문서를 적용할 장비
-     * @param scroll 적용할 주문서
-     * @returns 주문서가 적용됐을 경우 `true`; 아닐 경우 `false`
-     */
-    applyScroll(gear: Gear, scroll: Scroll): boolean;
-    /**
-     * 장비에 주문의 흔적 강화를 1회 적용합니다.
-     * @param gear 강화를 적용할 장비
-     * @param type 주문의 흔적 스탯 종류; 다음 값 중 하나입니다:
-     *
-     * `GearPropType.incSTR` / `GearPropType.incDEX` /
-     * `GearPropType.incINT` / `GearPropType.incLUK` /
-     * `GearPropType.incAllStat` / `GearPropType.incMHP`
-     * @param probability 주문의 흔적 성공 확률 %; 다음 값 중 하나입니다:
-     *
-     * `100` / `70` / `30` / `15`
-     * @returns 주문서가 적용됐을 경우 `true`; 아닐 경우 `false`
-     */
-    applySpellTrace(gear: Gear, type: SpellTraceStatType, probability: SpellTraceProbability): boolean;
-    /**
-     * 장비의 업그레이드 가능 횟수를 실패로 1회 감소합니다.
-     * @param gear 감소할 장비
-     * @returns 감소됐을 경우 `true`; 아닐 경우 `false`
-     */
-    addUpgradeFailCount(gear: Gear): boolean;
-    /**
-     * 장비의 실패한 업그레이드 가능 횟수를 1회 복구합니다.
-     * @param gear 복구할 장비
-     * @returns 복구했을 경우 `true`; 아닐 경우 `false`
-     */
-    restoreUpgradeCount(gear: Gear): boolean;
-    /**
-     * 장비의 주문서, 황금망치 관련 속성을 초기화합니다.
-     *
-     * 아크 이노센트와 동일한 효과입니다. 놀라운 장비강화 주문서가 적용된 장비도 적용 가능하지만 오차가 발생할 수 있습니다.
-     * @param gear 초기화할 장비
-     * @returns 초기화했을 경우 `true`; 아닐 경우 `false`
-     */
-    resetUpgrade(gear: Gear): boolean;
-}
+export declare function applyGoldHammer(gear: Gear): boolean;
+/**
+ * 장비에 주문서를 1회 적용합니다.
+ * @param gear 주문서를 적용할 장비.
+ * @param scroll 적용할 주문서.
+ * @returns 주문서를 적용했을 경우 `true`; 아닐 경우 `false`.
+ * 장비에 남은 업그레이드 가능 횟수가 존재하지 않을 경우 `false`를 반환합니다.
+ */
+export declare function applyScroll(gear: Gear, scroll: Scroll): boolean;
+/**
+ * 장비에 주문의 흔적 강화를 1회 적용합니다.
+ * @param gear 주문의 흔적 강화를 적용할 장비.
+ * @param type 주문의 흔적 스탯 종류. `GearPropType` 타입이고
+ * `incSTR` / `incDEX` / `incINT` / `incLUK` / `incAllStat` / `incMHP` 중 하나입니다.
+ * @param probability 주문의 흔적 성공 확률. `100` / `70` / `30` / `15` 중 하나입니다.
+ * @returns 주문서를 적용했을 경우 `true`; 아닐 경우 `false`. 지정된 장비, 스탯, 확률을 만족하는 주문서가 존재하지 않을 경우 `false`를 반환합니다.
+ */
+export declare function applySpellTrace(gear: Gear, type: SpellTraceStatType, probability: SpellTraceProbability): boolean;
+/**
+ * 장비의 업그레이드 복구 가능 횟수를 1회 추가합니다.
+ * @param gear 추가할 장비.
+ * @returns 추가했을 경우 `true`; 아닐 경우 `false`.
+ * 장비에 남은 업그레이드 가능 횟수가 존재하지 않을 경우 `false`를 반환합니다.
+ */
+export declare function addUpgradeFailCount(gear: Gear): boolean;
+/**
+ * 장비의 복구 가능 횟수를 1회 복구합니다.
+ * @param gear 복구할 장비.
+ * @returns 복구했을 경우 `true`; 아닐 경우 `false`.
+ * 장비에 남은 복구 가능 횟수가 존재하지 않을 경우 `false`를 반환합니다.
+ */
+export declare function restoreUpgradeCount(gear: Gear): boolean;
+/**
+ * 장비의 주문서, 옵션, 황금망치 관련 속성을 초기화합니다.
+ * 놀라운 장비강화 주문서로 증가한 옵션에 오차가 발생할 수 있습니다.
+ * @param gear 초기화할 장비.
+ * @returns 항상 초기화에 성공하고 `true`를 반환합니다.
+ */
+export declare function resetUpgrade(gear: Gear): boolean;

package/lib/potential.d.ts

@@ -4,7 +4,7 @@ import { GearType } from "./geartype";
  * 잠재옵션
  */
 export declare class Potential {
-    /** 잠재옵션 ID */
+    /** 잠재옵션 코드 */
     code: number;
     /**
      * 잠재옵션 분류
@@ -24,15 +24,15 @@ export declare class Potential {
     get convertSummary(): string;
     /**
      * 장비의 착용 가능 레벨로부터 잠재옵션의 레벨을 계산합니다.
-     * @param gearReqLevel 장비의 착용 가능 레벨
-     * @returns 잠재옵션 레벨 (1~20)
+     * @param gearReqLevel 장비의 착용 가능 레벨.
+     * @returns 잠재옵션 레벨. 1부터 25까지의 값입니다.
      */
     static getPotentialLevel(gearReqLevel: number): number;
     /**
      * 잠재옵션 분류와 장비 분류를 비교합니다.
-     * @param optionType 잠재옵션 분류
-     * @param gearType 장비 분류
-     * @returns 잠재옵션 분류가 장비 분류에 적용 가능한 경우 `true`; 아닌 경우 `false`
+     * @param optionType 잠재옵션 분류.
+     * @param gearType 장비 분류.
+     * @returns 잠재옵션 분류가 장비 분류에 적용 가능한 경우 `true`; 아닌 경우 `false`.
      */
     static checkOptionType(optionType: number, gearType: GearType): boolean;
 }

package/lib/soul.d.ts

@@ -1,8 +1,9 @@
+import { Gear } from "./gear";
 import { GearPropType } from "./gearproptype";
 /**
  * 소울 웨폰
  */
-export declare class SoulSlot {
+export declare class SoulWeapon {
     /** 소울 인챈트 여부 */
     enchanted: boolean;
     /** 소울 */
@@ -11,7 +12,45 @@ export declare class SoulSlot {
     charge: number;
     /** 소울 충전량으로 증가하는 옵션 */
     chargeOption: Map<GearPropType, number>;
-    constructor();
+    private gear;
+    constructor(gear: Gear);
+    /**
+     * 소울 인챈트를 적용합니다.
+     * @returns 적용했을 경우 `true`; 아닐 경우 `false`.
+     * 이미 소울 인챈트 상태이거나 장비 분류가 무기가 아닐 경우 `false`를 반환합니다.
+     */
+    enchant(): boolean;
+    /**
+     * 소울 인챈트를 해제합니다.
+     * @returns 해제했을 경우 `true`; 아닐 경우 `false`.
+     * 소울 인챈트 상태가 아닐 경우 `false`를 반환합니다.
+     */
+    disenchant(): boolean;
+    /**
+     * 소울을 장착합니다.
+     * 소울 충전량으로 증가하는 옵션을 다시 계산합니다.
+     * 소울 인챈트가 적용된 상태에만 장착됩니다.
+     * @param soul 장착할 소울.
+     * @returns 장착했을 경우 `true`; 아닐 경우 `false`.
+     * 소울 인챈트 상태가 아닐 경우 `false`를 반환합니다.
+     */
+    setSoul(soul: Soul): boolean;
+    /**
+     * 장착된 소울을 제거합니다.
+     * @returns 제거했을 경우 `true`; 아닐 경우 `false`.
+     * 소울 인챈트 상태가 아니거나 장착된 소울이 없을 경우 `false`를 반환합니다.
+     */
+    removeSoul(): boolean;
+    /**
+     * 소울 충전량을 설정합니다.
+     * 소울 충전량으로 증가하는 옵션을 다시 계산합니다.
+     * @param charge 설정할 소울 충전량.
+     * `0`부터 `1000`까지의 값으로 설정할 수 있습니다.
+     * @returns 적용했을 경우 `true`; 아닐 경우 `false`.
+     * 소울 인챈트 상태가 아니거나 설정할 소울 충전량이 0과 1000 사이의 값이 아닐 경우 `false`를 반환합니다.
+     */
+    setCharge(charge: number): boolean;
+    private getChargeAD;
 }
 /**
  * 소울
@@ -24,5 +63,4 @@ export declare class Soul {
     /** 소울 옵션 */
     option: Map<GearPropType, number>;
     multiplier: number;
-    constructor();
 }

package/package.json

@@ -1,5 +1,15 @@
 {
   "name": "@malib/gear",
-  "version": "0.1.1",
-  "type": "module"
+  "version": "0.3.0",
+  "type": "module",
+  "main": "index.js",
+  "module": "index.js",
+  "types": "index.d.ts",
+  "typings": "index.d.ts",
+  "typedoc": {
+    "entryPoint": "./src/index.ts",
+    "readmeFile": "./README.md",
+    "displayName": "gear",
+    "tsconfig": "./tsconfig.lib.json"
+  }
 }