@malib/gear 1.0.0-next.3 → 1.0.0-next.5

package/dist/lib/data/GearAttributeData.d.ts

@@ -10,36 +10,40 @@ export interface GearAttributeData {
     onlyEquip?: boolean;
     /** 월드 내 나의 캐릭터 간 이동 가능 여부 */
     share?: GearShare;
-    /** 황금망치 사용 불가 */
-    blockGoldenHammer?: boolean;
     /** 슈페리얼 */
     superior?: boolean;
     /** 공격 속도 */
     attackSpeed?: number;
-    /** 강화불가 */
-    cannotUpgrade?: boolean;
+    /** 주문서 강화 가능 여부 */
+    canScroll?: GearCapability;
+    /** 스타포스 강화 가능 여부 */
+    canStarforce?: GearCapability;
     /** 추가 옵션 설정 가능 여부 */
-    canAddOption?: AddOptionCan;
+    canAddOption?: GearCapability;
     /** 잠재능력 설정 가능 여부 */
-    canPotential?: PotentialCan;
+    canPotential?: GearCapability;
     /** 에디셔널 잠재능력 설정 가능 여부 */
-    canAdditionalPotential?: PotentialCan;
+    canAdditionalPotential?: GearCapability;
     /** 스페셜 아이템 여부 */
     specialGrade?: boolean;
-    /** 착용 레벨 증가 */
-    reqLevelIncrease?: number;
     /** 카르마의 가위 사용 가능 여부 */
     cuttable?: GearCuttable;
     /** 가위 사용 가능 횟수 */
     cuttableCount?: number;
+    /** 최대 가위 사용 가능 횟수 */
+    totalCuttableCount?: number;
     /** 쉐어 네임 텍을 사용 가능 여부 */
     accountShareTag?: boolean;
+    /** 세트 효과 ID */
+    setItemId?: number;
     /** 럭키 아이템 */
     lucky?: boolean;
     /** 장착 시 획득 경험치 */
     incline?: Partial<GearIncline>;
     /** 보스 드롭 여부 */
     bossReward?: boolean;
+    /** 사용 가능 스킬 */
+    skills?: string[];
     /** 성장 경험치 */
     growthExp?: number;
     /** 성장 레벨 */
@@ -63,23 +67,13 @@ export declare enum GearShare {
     /** 월드 내 나의 캐릭터 간 1회 이동 가능 (이동 후 교환불가) */
     AccountSharableOnce = 2
 }
-export declare enum AddOptionCan {
-    /** 없음 (장비 분류를 따름) */
-    None = 0,
-    /** 설정 가능 */
-    Can = 1,
+export declare enum GearCapability {
     /** 설정 불가 */
-    Cannot = 2
-}
-export declare enum PotentialCan {
-    /** 없음 (장비 분류를 따름) */
-    None = 0,
+    Cannot = 0,
     /** 설정 가능 */
     Can = 1,
-    /** 설정 불가 */
-    Cannot = 2,
     /** 재설정 불가 */
-    Fixed = 3
+    Fixed = 2
 }
 export declare enum GearCuttable {
     /** 없음 */

package/dist/lib/data/GearData.d.ts

@@ -1,4 +1,4 @@
-import { AddOptionGrade, AddOptionType } from '../enhance/addOption';
+import { AddOptionData } from './AddOptionData';
 import { GearAttributeData } from './GearAttributeData';
 import { GearOption } from './GearOption';
 import { GearType } from './GearType';
@@ -33,18 +33,16 @@ export interface GearData {
     upgradeOption?: Partial<GearUpgradeOption>;
     /** 장비 스타포스 옵션 */
     starforceOption?: Partial<GearStarforceOption>;
+    /** 추가 옵션 목록 */
+    addOptions?: AddOptionData[];
     /** 업그레이드 횟수 */
     scrollUpgradeCount?: number;
     /** 복구 가능 횟수 */
     scrollResilienceCount?: number;
     /** 업그레이드 가능 횟수 */
     scrollUpgradeableCount?: number;
-    /** 황금 망치 재련 적용 */
-    goldenHammer?: number;
     /** 강화 단계 */
     star?: number;
-    /** 최대 강화 단계 */
-    maxStar?: number;
     /** 놀라운 장비 강화 주문서 사용 여부 */
     starScroll?: boolean;
     /** 소울 웨폰 정보 */
@@ -76,8 +74,6 @@ export interface GearMetadata {
     id: number;
     /** 장비 정보 버전 */
     version: 1;
-    /** 추가 옵션 적용 기록 */
-    add: [AddOptionType, AddOptionGrade][];
 }
 /**
  * 장비 외형 정보
@@ -94,14 +90,8 @@ export interface GearShapeData {
 export interface GearReqData {
     /** 착용 가능 레벨 */
     level?: number;
-    /** 착용 가능 STR */
-    str?: number;
-    /** 착용 가능 LUK */
-    luk?: number;
-    /** 착용 가능 DEX */
-    dex?: number;
-    /** 착용 가능 INT */
-    int?: number;
+    /** 착용 가능 레벨 증가 */
+    levelIncrease?: number;
     /** 착용 가능 직업 분류 */
     job?: number;
     /** 착용 가능 직업 */
@@ -110,7 +100,7 @@ export interface GearReqData {
 /**
  * 장비 기본 옵션
  */
-export type GearBaseOption = Pick<GearOption, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'maxHpRate' | 'maxMpRate' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump' | 'bossDamage' | 'ignoreMonsterArmor' | 'allStat' | 'damage' | 'reqLevelDecrease'>;
+export type GearBaseOption = Pick<GearOption, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'maxHpRate' | 'maxMpRate' | 'maxDemonForce' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump' | 'bossDamage' | 'ignoreMonsterArmor' | 'allStat' | 'damage' | 'reqLevelDecrease'>;
 /**
  * 장비 추가 옵션
  */

package/dist/lib/data/GearOption.d.ts

@@ -44,8 +44,6 @@ export interface GearOption {
     speed: number;
     /** 점프력 */
     jump: number;
-    /** %의 확률로 넉백 */
-    knockback: number;
     /** 보스 공격 시 데미지 증가(%) */
     bossDamage: number;
     /** 일반 몬스터 데미지(%) */

package/dist/lib/data/PotentialData.d.ts

@@ -1,8 +1,14 @@
 import { GearOption } from './GearOption';
+import { PotentialGrade } from './PotentialGrade';
+/**
+ * 잠재옵션 정보
+ */
 export interface PotentialData {
+    /** 잠재능력 등급 */
+    grade: PotentialGrade;
     /** 장비에 표시되는 이름 */
-    title: string;
+    summary: string;
     /** 잠재능력 옵션 */
     option: Partial<PotentialOption>;
 }
-export type PotentialOption = Pick<GearOption, 'str' | 'dex' | 'int' | 'luk' | 'strRate' | 'dexRate' | 'intRate' | 'lukRate' | 'maxHp' | 'maxMp' | 'maxHpRate' | 'maxMpRate' | 'attackPower' | 'magicPower' | 'attackPowerRate' | 'magicPowerRate' | 'armor' | 'armorRate' | 'speed' | 'jump' | 'bossDamage' | 'ignoreMonsterArmor' | 'damage' | 'criticalRate' | 'criticalDamage' | 'cooltimeReduce' | 'strLv' | 'dexLv' | 'intLv' | 'lukLv'>;
+export type PotentialOption = Pick<GearOption, 'str' | 'dex' | 'int' | 'luk' | 'strRate' | 'dexRate' | 'intRate' | 'lukRate' | 'maxHp' | 'maxMp' | 'maxHpRate' | 'maxMpRate' | 'attackPower' | 'magicPower' | 'attackPowerRate' | 'magicPowerRate' | 'armor' | 'armorRate' | 'speed' | 'jump' | 'bossDamage' | 'normalDamage' | 'ignoreMonsterArmor' | 'damage' | 'criticalRate' | 'criticalDamage' | 'cooltimeReduce' | 'strLv' | 'dexLv' | 'intLv' | 'lukLv'>;

package/dist/lib/data/index.d.ts

@@ -1,3 +1,4 @@
+export * from './AddOptionData';
 export * from './GearAttributeData';
 export * from './GearData';
 export * from './GearOption';

package/dist/lib/enhance/addOption.d.ts

@@ -1,78 +1,67 @@
-import { GearAddOption, GearType } from '../data';
+import { AddOptionGrade, AddOptionType, GearAddOption, GearType } from '../data';
 import { Gear } from '../Gear';
-export declare enum AddOptionType {
-    /** STR */
-    str = "str",
-    /** DEX */
-    dex = "dex",
-    /** INT */
-    int = "int",
-    /** LUK */
-    luk = "luk",
-    /** STR, DEX */
-    str_dex = "str&dex",
-    /** STR, INT */
-    str_int = "str&int",
-    /** STR, LUK */
-    str_luk = "str&luk",
-    /** DEX, INT */
-    dex_int = "dex&int",
-    /** DEX, LUK */
-    dex_luk = "dex&luk",
-    /** INT, LUK */
-    int_luk = "int&luk",
-    /** 최대 HP */
-    maxHp = "maxHp",
-    /** 최대 MP */
-    maxMp = "maxMp",
-    /** 공격력 */
-    attackPower = "attackPower",
-    /** 마력 */
-    magicPower = "magicPower",
-    /** 방어력 */
-    armor = "armor",
-    /** 이동속도 */
-    speed = "speed",
-    /** 점프력 */
-    jump = "jump",
-    /** 보스 공격 시 데미지 증가(%) */
-    bossDamage = "bossDamage",
-    /** 데미지(%) */
-    damage = "damage",
-    /** 올스탯(%) */
-    allStat = "allStat",
-    /** 착용 레벨 감소 */
-    reqLevelDecrease = "reqLevelDecrease"
-}
-export type AddOptionGrade = 1 | 2 | 3 | 4 | 5 | 6 | 7;
+import { ReadonlyGear } from '../ReadonlyGear';
 /**
- * 추가 옵션을 지원하는 장비 분류인지 확인합니다.
- * @param gearType 확인할 장비.
+ * 장비가 추가 옵션을 지원하는지 확인합니다.
+ * @param gear 확인할 장비.
  * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
  */
-export declare function supportsAddOption(gearType: GearType): boolean;
+export declare function supportsAddOption(gear: ReadonlyGear): boolean;
+/**
+ * 장비에 추가 옵션을 적용할 수 있는 상태인지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+export declare function canApplyAddOption(gear: ReadonlyGear): boolean;
+/**
+ * 장비에 추가 옵션을 적용합니다.
+ * @param gear 적용할 장비.
+ * @param type 추가 옵션 종류.
+ * @param grade 추가 옵션 단계.
+ *
+ * @throws {@link TypeError}
+ * 추가 옵션을 적용할 수 없는 상태의 장비일 경우.
+ *
+ * @throws {@link TypeError}
+ * 장비에 부여할 수 없는 추가 옵션을 지정했을 경우.
+ */
+export declare function applyAddOption(gear: Gear, type: AddOptionType, grade: AddOptionGrade): void;
+/**
+ * 추가 옵션을 초기화할 수 있는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 초기화할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+export declare function canResetAddOption(gear: ReadonlyGear): boolean;
+/**
+ * 장비의 추가 옵션을 초기화합니다.
+ * @param gear 초기화할 장비.
+ *
+ * @throws {@link TypeError}
+ * 추가 옵션을 초기화할 수 없는 상태의 장비일 경우.
+ */
+export declare function resetAddOption(gear: Gear): void;
 /**
  * 장비에 적용되는 추가 옵션을 계산합니다.
  * @param gear 추가옵션을 계산할 장비.
  * @param type 추가 옵션 종류.
- * @param grade 추가 옵션 등급.
- * @returns 추가 옵션 종류 및 등급에 해당하는 옵션.
+ * @param grade 추가 옵션 단계.
+ * @returns 추가 옵션 종류 및 단계에 해당하는 옵션.
  *
  * @throws {@link TypeError}
  * 장비에 부여할 수 없는 추가 옵션을 지정했을 경우.
  */
-export declare function getAddOption(gear: Gear, type: AddOptionType, grade: AddOptionGrade): Partial<GearAddOption>;
+export declare function getAddOption(gear: ReadonlyGear, type: AddOptionType, grade: AddOptionGrade): Partial<GearAddOption>;
 /**
  * 장비에 적용되는 추가 옵션 종류에 따른 값을 계산합니다.
  * @param gear 추가옵션을 계산할 장비.
  * @param type 추가 옵션 종류.
- * @param grade 추가 옵션 등급.
+ * @param grade 추가 옵션 단계.
  * @returns 추가 옵션 값.
  *
  * @throws {@link TypeError}
  * 장비에 부여할 수 없는 추가 옵션을 지정했을 경우.
  */
-export declare function getAddOptionValue(gear: Gear, type: AddOptionType, grade: AddOptionGrade): number;
+export declare function getAddOptionValue(gear: ReadonlyGear, type: AddOptionType, grade: AddOptionGrade): number;
 export interface AddOptionContext {
     type: AddOptionType;
     reqLevel: number;

package/dist/lib/enhance/exceptional.d.ts

@@ -1,5 +1,6 @@
 import { GearUpgradeOption } from '../data';
 import { Gear } from '../Gear';
+import { ReadonlyGear } from '../ReadonlyGear';
 /**
  * 익셉셔널 해머
  */
@@ -16,13 +17,13 @@ export interface ExceptionalHammer {
  * @param gear 확인할 장비.
  * @returns 지원할 경우 `true`; 아닐 경우 `false`.
  */
-export declare function supportsExceptional(gear: Gear): boolean;
+export declare function supportsExceptional(gear: ReadonlyGear): boolean;
 /**
  * 장비에 익셉셔널 강화를 적용할 수 있는 상태인지 여부를 확인합니다.
  * @param gear 확인할 장비.
  * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
  */
-export declare function canApplyExceptional(gear: Gear): boolean;
+export declare function canApplyExceptional(gear: ReadonlyGear): boolean;
 /**
  * 장비에 익셉셔널 강화를 적용합니다.
  * @param gear 적용할 장비.
@@ -37,7 +38,7 @@ export declare function applyExceptional(gear: Gear, exceptionalHammer: Exceptio
  * @param gear 확인할 장비.
  * @returns 초기화할 수 있을 경우 `true`; 아닐 경우 `false`.
  */
-export declare function canResetExceptional(gear: Gear): boolean;
+export declare function canResetExceptional(gear: ReadonlyGear): boolean;
 /**
  * 장비의 익셉셔널 강화를 초기화합니다.
  * @param gear 초기화할 장비.

package/dist/lib/enhance/potential.d.ts

@@ -0,0 +1,84 @@
+import { PotentialData, PotentialGrade, PotentialOption } from '../data';
+import { Gear } from '../Gear';
+import { ReadonlyGear } from '../ReadonlyGear';
+/**
+ * 잠재옵션 (읽기 전용)
+ */
+export interface ReadonlyPotential extends Readonly<PotentialData> {
+    /** 잠재능력 옵션 */
+    option: Readonly<PotentialOption>;
+}
+/**
+ * 장비가 잠재능력을 지원하는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 지원할 경우 `true`; 아닐 경우 `false`.
+ */
+export declare function supportsPotential(gear: ReadonlyGear): boolean;
+/**
+ * 장비의 잠재능력을 설정할 수 있는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 설정할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+export declare function canSetPotential(gear: ReadonlyGear): boolean;
+/**
+ * 장비의 잠재능력을 설정합니다.
+ * @param gear 설정할 장비.
+ * @param grade 잠재능력 등급.
+ * @param options 잠재옵션 목록.
+ *
+ * @throws {@link TypeError}
+ * 잠재능력을 설정할 수 없는 장비일 경우.
+ *
+ * @throws {@link TypeError}
+ * 설정하려는 잠재능력 등급이 Normal일 경우.
+ *
+ * @throws {@link TypeError}
+ * 잘못된 잠재옵션 목록을 지정했을 경우.
+ */
+export declare function setPotential(gear: Gear, grade: PotentialGrade, options: PotentialData[]): void;
+/**
+ * 장비의 잠재능력을 초기화합니다.
+ *
+ * 에디셔널 잠재능력은 변경되지 않습니다.
+ * @param gear 초기화할 장비.
+ *
+ * @throws {@link TypeError}
+ * 잠재능력을 초기화할 수 없는 장비일 경우.
+ */
+export declare function resetPotential(gear: Gear): void;
+/**
+ * 장비가 에디셔널 잠재능력을 지원하는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 지원할 경우 `true`; 아닐 경우 `false`.
+ */
+export declare function supportsAdditionalPotential(gear: ReadonlyGear): boolean;
+/**
+ * 장비의 에디셔널 잠재능력을 설정할 수 있는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 설정할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+export declare function canSetAdditionalPotential(gear: ReadonlyGear): boolean;
+/**
+ * 장비의 에디셔널 잠재능력을 설정합니다.
+ * @param gear 설정할 장비.
+ * @param grade 에디셔널 잠재능력 등급.
+ * @param options 에디셔널 잠재옵션 목록.
+ *
+ * @throws {@link TypeError}
+ * 에디셔널 잠재능력을 설정할 수 없는 장비일 경우.
+ *
+ * @throws {@link TypeError}
+ * 설정하려는 에디셔널 잠재능력 등급이 Normal일 경우.
+ *
+ * @throws {@link TypeError}
+ * 잘못된 에디셔널 잠재옵션 목록을 지정했을 경우.
+ */
+export declare function setAdditionalPotential(gear: Gear, grade: PotentialGrade, options: PotentialData[]): void;
+/**
+ * 장비의 에디셔널 잠재능력을 초기화합니다.
+ * @param gear 초기화할 장비.
+ *
+ * @throws {@link TypeError}
+ * 에디셔널 잠재능력을 초기화할 수 없는 장비일 경우.
+ */
+export declare function resetAdditionalPotential(gear: Gear): void;

package/dist/lib/{soulSlot.d.ts → enhance/soulSlot.d.ts}

@@ -1,17 +1,18 @@
-import { SoulData } from './data';
-import { Gear } from './Gear';
+import { SoulData } from '../data';
+import { Gear } from '../Gear';
+import { ReadonlyGear } from '../ReadonlyGear';
 /**
  * 장비가 소울웨폰을 지원하는지 여부를 확인합니다.
  * @param gear 확인할 장비.
  * @returns 지원할 경우 `true`; 아닐 경우 `false`.
  */
-export declare function supportsSoul(gear: Gear): boolean;
+export declare function supportsSoul(gear: ReadonlyGear): boolean;
 /**
  * 장비에 소울 인챈터를 적용할 수 있는 상태인지 여부를 확인합니다.
  * @param gear 확인할 장비.
  * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
  */
-export declare function canApplySoulEnchant(gear: Gear): boolean;
+export declare function canApplySoulEnchant(gear: ReadonlyGear): boolean;
 /**
  * 장비에 소울 인챈터를 적용합니다.
  * @param gear 적용할 장비.
@@ -25,7 +26,7 @@ export declare function applySoulEnchant(gear: Gear): void;
  * @param gear 확인할 장비.
  * @returns 장착할 수 있을 경우 `true`; 아닐 경우 `false`.
  */
-export declare function canSetSoul(gear: Gear): boolean;
+export declare function canSetSoul(gear: ReadonlyGear): boolean;
 /**
  * 장비에 소울을 장착합니다.
  * @param gear 대상 장비.
@@ -40,7 +41,7 @@ export declare function setSoul(gear: Gear, soul: SoulData): void;
  * @param gear 확인할 장비.
  * @returns 설정할 수 있을 경우 `true`; 아닐 경우 `false`.
  */
-export declare function canSetSoulCharge(gear: Gear): boolean;
+export declare function canSetSoulCharge(gear: ReadonlyGear): boolean;
 /**
  * 장비의 소울 충전량을 설정합니다.
  * @param gear 대상 장비.

package/dist/lib/enhance/spellTrace.d.ts

@@ -1,4 +1,5 @@
 import { Gear } from '../Gear';
+import { ReadonlyGear } from '../ReadonlyGear';
 import { Scroll } from './upgrade';
 /**
  * 주문의 흔적 종류
@@ -51,9 +52,9 @@ export declare function applySpellTrace(gear: Gear, type: SpellTraceType, rate:
  * @throws {@link TypeError}
  * 주문의 흔적을 장비에 적용할 수 없는 경우.
  */
-export declare function getSpellTraceScroll(gear: Gear, type: SpellTraceType, rate: SpellTraceRate): SpellTrace;
-export declare function _getWeaponSpellTrace(gear: Gear, type: SpellTraceType, rate: SpellTraceRate): SpellTrace;
-export declare function _getGloveSpellTrace(gear: Gear, type: SpellTraceType, rate: SpellTraceRate): SpellTrace;
-export declare function _getArmorSpellTrace(gear: Gear, type: SpellTraceType, rate: SpellTraceRate): SpellTrace;
-export declare function _getAccSpellTrace(gear: Gear, type: SpellTraceType, rate: SpellTraceRate): SpellTrace;
-export declare function _getHeartSpellTrace(gear: Gear, type: SpellTraceType, rate: SpellTraceRate): SpellTrace;
+export declare function getSpellTraceScroll(gear: ReadonlyGear, type: SpellTraceType, rate: SpellTraceRate): SpellTrace;
+export declare function _getWeaponSpellTrace(gear: ReadonlyGear, type: SpellTraceType, rate: SpellTraceRate): SpellTrace;
+export declare function _getGloveSpellTrace(gear: ReadonlyGear, type: SpellTraceType, rate: SpellTraceRate): SpellTrace;
+export declare function _getArmorSpellTrace(gear: ReadonlyGear, type: SpellTraceType, rate: SpellTraceRate): SpellTrace;
+export declare function _getAccSpellTrace(gear: ReadonlyGear, type: SpellTraceType, rate: SpellTraceRate): SpellTrace;
+export declare function _getHeartSpellTrace(gear: ReadonlyGear, type: SpellTraceType, rate: SpellTraceRate): SpellTrace;

package/dist/lib/enhance/starforce.d.ts

@@ -1,5 +1,6 @@
 import { Gear } from '../Gear';
-export declare const MAX_STARFORCE = 25;
+import { ReadonlyGear } from '../ReadonlyGear';
+export declare const MAX_STARFORCE = 30;
 export declare const MAX_STARSCROLL = 15;
 export declare const MAX_SUPERIOR = 15;
 export declare const MAX_REQLEVEL_STARSCROLL = 150;
@@ -8,7 +9,7 @@ export declare const MAX_REQLEVEL_STARSCROLL = 150;
  * @param gear 확인할 장비.
  * @returns 지원할 경우 `true`; 아닐 경우 `false`.
  */
-export declare function supportsStarforce(gear: Gear): boolean;
+export declare function supportsStarforce(gear: ReadonlyGear): boolean;
 /**
  * 장비에 스타포스 강화를 적용할 수 있는 상태인지 여부를 확인합니다.
  *
@@ -17,7 +18,7 @@ export declare function supportsStarforce(gear: Gear): boolean;
  * @param exceedMaxStar 장비의 최대 강화 단계를 초과하여 강화할 지 여부.
  * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
  */
-export declare function canStarforce(gear: Gear, exceedMaxStar?: boolean): boolean;
+export declare function canStarforce(gear: ReadonlyGear, exceedMaxStar?: boolean): boolean;
 /**
  * 장비에 스타포스 강화를 1회 적용합니다.
  *
@@ -39,7 +40,7 @@ export declare function starforce(gear: Gear, exceedMaxStar?: boolean): void;
  * @param exceedMaxStar 장비의 최대 강화 단계를 초과하여 강화할 지 여부.
  * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
  */
-export declare function canStarScroll(gear: Gear, exceedMaxStar?: boolean): boolean;
+export declare function canStarScroll(gear: ReadonlyGear, exceedMaxStar?: boolean): boolean;
 /**
  * 장비에 놀라운 장비 강화 주문서를 1회 적용합니다.
  *
@@ -64,7 +65,7 @@ export declare function starScroll(gear: Gear, bonus?: boolean, exceedMaxStar?:
  * @param gear 확인할 장비.
  * @returns 초기화할 수 있을 경우 `true`; 아닐 경우 `false`.
  */
-export declare function canResetStarforce(gear: Gear): boolean;
+export declare function canResetStarforce(gear: ReadonlyGear): boolean;
 /**
  * 장비의 스타포스 강화를 초기화합니다.
  * @param gear 초기화할 장비.
@@ -73,3 +74,11 @@ export declare function canResetStarforce(gear: Gear): boolean;
  * 스타포스 강화를 초기화할 수 없는 장비일 경우.
  */
 export declare function resetStarforce(gear: Gear): void;
+/**
+ * 장비의 최대 스타포스 강화를 계산합니다.
+ *
+ * 놀라운 장비 강화 주문서가 사용되었을 경우 최대 `15`입니다.
+ * @param gear 계산할 장비.
+ * @returns 장비의 최대 스타포스 강화.
+ */
+export declare function getMaxStar(gear: ReadonlyGear): number;

package/dist/lib/enhance/upgrade.d.ts

@@ -1,5 +1,6 @@
 import { GearUpgradeOption } from '../data';
 import { Gear } from '../Gear';
+import { ReadonlyGear } from '../ReadonlyGear';
 /**
  * 주문서
  */
@@ -16,27 +17,13 @@ export interface Scroll {
  * @param gear 확인할 장비.
  * @returns 지원할 경우 `true`; 아닐 경우 `false`.
  */
-export declare function supportsUpgrade(gear: Gear): boolean;
-/**
- * 장비에 황금 망치를 적용할 수 있는 상태인지 여부를 확인합니다.
- * @param gear 확인할 장비.
- * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
- */
-export declare function canGoldenHammer(gear: Gear): boolean;
-/**
- * 장비에 황금 망치를 적용합니다.
- * @param gear 적용할 장비.
- *
- * @throws {@link TypeError}
- * 황금 망치를 적용할 수 없는 상태의 장비일 경우.
- */
-export declare function applyGoldenHammer(gear: Gear): void;
+export declare function supportsUpgrade(gear: ReadonlyGear): boolean;
 /**
  * 장비에 주문서 실패를 적용할 수 있는 상태인지 여부를 확인합니다.
  * @param gear 확인할 장비.
  * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
  */
-export declare function canFailScroll(gear: Gear): boolean;
+export declare function canFailScroll(gear: ReadonlyGear): boolean;
 /**
  * 장비에 주문서 실패를 적용합니다.
  * @param gear 적용할 장비.
@@ -50,7 +37,7 @@ export declare function failScroll(gear: Gear): void;
  * @param gear 확인할 장비.
  * @returns 복구할 수 있을 경우 `true`; 아닐 경우 `false`.
  */
-export declare function canResileScroll(gear: Gear): boolean;
+export declare function canResileScroll(gear: ReadonlyGear): boolean;
 /**
  * 장비의 주문서 실패로 차감된 업그레이드 가능 횟수를 1회 복구합니다.
  * @param gear 복구할 장비.
@@ -64,7 +51,7 @@ export declare function resileScroll(gear: Gear): void;
  * @param gear 확인할 장비.
  * @returns 초기화할 수 있을 경우 `true`; 아닐 경우 `false`.
  */
-export declare function canResetUpgrade(gear: Gear): boolean;
+export declare function canResetUpgrade(gear: ReadonlyGear): boolean;
 /**
  * 장비의 주문서 강화를 초기화합니다.
  * @param gear 초기화할 장비.
@@ -78,7 +65,7 @@ export declare function resetUpgrade(gear: Gear): void;
  * @param gear 확인할 장비.
  * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
  */
-export declare function canApplyScroll(gear: Gear): boolean;
+export declare function canApplyScroll(gear: ReadonlyGear): boolean;
 /**
  * 장비에 주문서를 적용합니다.
  * @param gear 적용할 장비.

package/dist/lib/errors.d.ts

@@ -1,4 +1,6 @@
 export declare const enum ErrorMessage {
+    AddOption_InvalidApplyGear = "\uCD94\uAC00 \uC635\uC158\uC744 \uC801\uC6A9\uD560 \uC218 \uC5C6\uB294 \uC0C1\uD0DC\uC758 \uC7A5\uBE44\uC785\uB2C8\uB2E4.",
+    AddOption_InvalidResetGear = "\uCD94\uAC00 \uC635\uC158\uC744 \uCD08\uAE30\uD654\uD560 \uC218 \uC5C6\uB294 \uC0C1\uD0DC\uC758 \uC7A5\uBE44\uC785\uB2C8\uB2E4.",
     AddOption_InvalidAttackPowerGear = "\uACF5\uACA9\uB825/\uB9C8\uB825 \uCD94\uAC00 \uC635\uC158\uC740 \uCC29\uC6A9 \uAC00\uB2A5 \uB808\uBCA8 60 \uC774\uC0C1\uC758 \uBB34\uAE30 \uC7A5\uBE44\uC5D0\uB9CC \uBD80\uC5EC\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.",
     AddOption_UnknownLongSwordGear = "\uACF5\uACA9\uB825/\uB9C8\uB825 \uCD94\uAC00 \uC635\uC158\uC744 \uBD80\uC5EC\uD560 \uC218 \uC5C6\uB294 \uD0DC\uB3C4 \uC7A5\uBE44\uC785\uB2C8\uB2E4. (Please submit issue with the gear info)",
     AddOption_InvalidSpeedGear = "\uC774\uB3D9\uC18D\uB3C4 \uCD94\uAC00 \uC635\uC158\uC740 \uBB34\uAE30\uAC00 \uC544\uB2CC \uC7A5\uBE44\uC5D0\uB9CC \uBD80\uC5EC\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.",
@@ -18,6 +20,12 @@ export declare const enum ErrorMessage {
     Starforce_InvalidReqLevelGear = "\uC7A5\uBE44\uC758 \uCC29\uC6A9 \uAC00\uB2A5 \uB808\uBCA8\uC740 0 \uC774\uC0C1\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.",
     StarScroll_InvalidStarScrollGear = "\uB180\uB77C\uC6B4 \uC7A5\uBE44 \uAC15\uD654 \uC8FC\uBB38\uC11C\uB97C \uC801\uC6A9\uD560 \uC218 \uC5C6\uB294 \uC0C1\uD0DC\uC758 \uC7A5\uBE44\uC785\uB2C8\uB2E4.",
     Starforce_InvalidResetGear = "\uC2A4\uD0C0\uD3EC\uC2A4 \uAC15\uD654\uB97C \uCD08\uAE30\uD654\uD560 \uC218 \uC5C6\uB294 \uC7A5\uBE44\uC785\uB2C8\uB2E4.",
+    Potential_InvalidPotentialGear = "\uC7A0\uC7AC\uB2A5\uB825\uC744 \uC801\uC6A9\uD560 \uC218 \uC5C6\uB294 \uC0C1\uD0DC\uC758 \uC7A5\uBE44\uC785\uB2C8\uB2E4.",
+    Potential_InvalidPotentialOptions = "\uC7A0\uC7AC\uC635\uC158 \uAC1C\uC218\uB294 1\uAC1C\uC5D0\uC11C 3\uAC1C \uC0AC\uC774\uC5EC\uC57C \uD569\uB2C8\uB2E4.",
+    Potential_InvalidPotentialGrade = "\uC7A0\uC7AC\uB2A5\uB825 \uB4F1\uAE09\uC744 Normal\uB85C \uC124\uC815\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. (\uC7A0\uC7AC\uB2A5\uB825\uC744 \uCD08\uAE30\uD654\uD558\uB824\uBA74 resetPotential\uC744 \uC0AC\uC6A9\uD558\uC138\uC694.)",
+    Potential_InvalidAdditionalPotentialGear = "\uC5D0\uB514\uC154\uB110 \uC7A0\uC7AC\uB2A5\uB825\uC744 \uC801\uC6A9\uD560 \uC218 \uC5C6\uB294 \uC0C1\uD0DC\uC758 \uC7A5\uBE44\uC785\uB2C8\uB2E4.",
+    Potential_InvalidAdditionalPotentialOptions = "\uC5D0\uB514\uC154\uB110 \uC7A0\uC7AC\uC635\uC158 \uAC1C\uC218\uB294 1\uAC1C\uC5D0\uC11C 3\uAC1C \uC0AC\uC774\uC5EC\uC57C \uD569\uB2C8\uB2E4.",
+    Potential_InvalidAdditionalPotentialGrade = "\uC5D0\uB514\uC154\uB110 \uC7A0\uC7AC\uB2A5\uB825 \uB4F1\uAE09\uC744 Normal\uB85C \uC124\uC815\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. (\uC5D0\uB514\uC154\uB110 \uC7A0\uC7AC\uB2A5\uB825\uC744 \uCD08\uAE30\uD654\uD558\uB824\uBA74 resetAdditionalPotential\uC744 \uC0AC\uC6A9\uD558\uC138\uC694.)",
     Soul_SetSoulUnenchanted = "\uC18C\uC6B8\uC6E8\uD3F0 \uC0C1\uD0DC\uC758 \uC7A5\uBE44\uC5D0\uB9CC \uC18C\uC6B8\uC744 \uC7A5\uCC29\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.",
     Soul_SetChargeUnenchanted = "\uC18C\uC6B8\uC6E8\uD3F0 \uC0C1\uD0DC\uC758 \uC7A5\uBE44\uB9CC \uC18C\uC6B8 \uCDA9\uC804\uB7C9\uC744 \uBCC0\uACBD\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.",
     Soul_InvalidSoulCharge = "\uC18C\uC6B8 \uCDA9\uC804\uB7C9\uC740 0 \uC774\uC0C1 1000 \uC774\uD558\uC758 \uAC12\uC73C\uB85C\uB9CC \uBCC0\uACBD\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.",

package/dist/lib/gearOption.d.ts

@@ -7,3 +7,5 @@ import { GearOption } from './data';
  * @returns 장비 옵션 프록시.
  */
 export declare function toGearOption(option: Partial<GearOption>): GearOption;
+export declare function addOptions(option: Partial<GearOption>, ...options: Partial<GearOption>[]): void;
+export declare function sumOptions(...options: Partial<GearOption>[]): Partial<GearOption>;

package/dist/lib/test/exceptionalFixture.d.ts

@@ -0,0 +1,2 @@
+import { ExceptionalHammer } from '../enhance/exceptional';
+export declare function createExceptional(data?: Partial<ExceptionalHammer>): ExceptionalHammer;

package/dist/lib/test/gearFixture.d.ts

@@ -0,0 +1,13 @@
+import { GearData } from '../data';
+import { Gear } from '../Gear';
+import { ReadonlyGear } from '../ReadonlyGear';
+import { resources } from './gearFixtureResources';
+import { Patch } from './gearPatch';
+type GearNames = keyof typeof resources;
+export type CreateGearParams = [name?: GearNames, patches?: Patch[]] | [data: Partial<GearData>] | [name: GearNames, data: Partial<GearData>, patches?: Patch[]];
+export declare function createGear(name?: GearNames, patches?: Patch[]): Gear;
+export declare function createGear(data: Partial<GearData>): Gear;
+export declare function createGear(name: GearNames, data: Partial<GearData>, patches?: Patch[]): Gear;
+export declare function createReadonlyGear(name?: GearNames, data?: Partial<GearData>): ReadonlyGear;
+export declare function createReadonlyGear(data: Partial<GearData>): ReadonlyGear;
+export {};