@malib/gear 1.0.0-next.8 → 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,1863 @@
+//#region src/lib/data/AddOptionData.d.ts
+/**
+ * 추가 옵션 종류
+ */
+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"
+}
+/**
+ * 추가 옵션 단계
+ */
+type AddOptionGrade = 1 | 2 | 3 | 4 | 5 | 6 | 7;
+/**
+ * 추가 옵션 정보
+ */
+interface AddOptionData {
+  /** 추가 옵션 종류 */
+  type: AddOptionType;
+  /** 추가 옵션 단계 */
+  grade: AddOptionGrade;
+  /** 추가 옵션 수치 */
+  value: number;
+}
+//#endregion
+//#region src/lib/data/GearAttributeData.d.ts
+/**
+ * 장비 속성 정보
+ */
+interface GearAttributeData {
+  /** 고유 아이템 */
+  only?: boolean;
+  /** 교환 가능 여부 */
+  trade?: GearTrade;
+  /** 고유장착 아이템 */
+  onlyEquip?: boolean;
+  /** 월드 내 나의 캐릭터 간 이동 가능 여부 */
+  share?: GearShare;
+  /** 슈페리얼 */
+  superior?: boolean;
+  /** 공격 속도 */
+  attackSpeed?: number;
+  /** 주문서 강화 가능 여부 */
+  canScroll?: GearCapability;
+  /** 스타포스 강화 가능 여부 */
+  canStarforce?: GearCapability;
+  /** 추가 옵션 설정 가능 여부 */
+  canAddOption?: GearCapability;
+  /** 잠재능력 설정 가능 여부 */
+  canPotential?: GearCapability;
+  /** 에디셔널 잠재능력 설정 가능 여부 */
+  canAdditionalPotential?: GearCapability;
+  /** 스페셜 아이템 여부 */
+  specialGrade?: boolean;
+  /** 최대 스타포스 강화 단계 */
+  fixedMaxStar?: number;
+  /** 카르마의 가위 사용 가능 여부 */
+  cuttable?: GearCuttable;
+  /** 가위 사용 가능 횟수 */
+  cuttableCount?: number;
+  /** 최대 가위 사용 가능 횟수 */
+  totalCuttableCount?: number;
+  /** 쉐어 네임 텍을 사용 가능 여부 */
+  accountShareTag?: boolean;
+  /** 훈장 신비의 모루 사용 불가 여부 */
+  noShapeChange?: boolean;
+  /** 세트 효과 ID */
+  setItemId?: number;
+  /** 럭키 아이템 */
+  lucky?: boolean;
+  /** 장착 시 획득 경험치 */
+  incline?: Partial<GearIncline>;
+  /** 보스 드롭 여부 */
+  bossReward?: boolean;
+  /** 사용 가능 스킬 */
+  skills?: string[];
+  /** 성장 경험치 */
+  growthExp?: number;
+  /** 성장 레벨 */
+  growthLevel?: number;
+  /** 장비 유효 기간(KST) */
+  dateExpire?: string;
+}
+declare enum GearTrade {
+  /** 교환 가능 */
+  Tradeable = 0,
+  /** 교환 불가 */
+  TradeBlock = 1,
+  /** 장착 시 교환 불가 */
+  EquipTradeBlock = 2,
+  /** 1회 교환 가능 */
+  TradeOnce = 3
+}
+declare enum GearShare {
+  /** 없음 */
+  None = 0,
+  /** 월드 내 나의 캐릭터 간 이동 가능 */
+  AccountSharable = 1,
+  /** 월드 내 나의 캐릭터 간 1회 이동 가능 (이동 후 교환불가) */
+  AccountSharableOnce = 2
+}
+declare enum GearCapability {
+  /** 설정 불가 */
+  Cannot = 0,
+  /** 설정 가능 */
+  Can = 1,
+  /** 재설정 불가 */
+  Fixed = 2
+}
+declare enum GearCuttable {
+  /** 없음 */
+  None = 0,
+  /** 카르마의 가위 또는 실버 카르마의 가위를 사용하면 1회 교환이 가능하게 할 수 있습니다. */
+  Silver = 1,
+  /** 플래티넘 카르마의 가위를 사용하면 1회 교환이 가능하게 할 수 있습니다. */
+  Platinum = 2
+}
+interface GearIncline {
+  /** 카리스마 */
+  charisma: number;
+  /** 통찰력 */
+  insight: number;
+  /** 의지 */
+  will: number;
+  /** 손재주 */
+  craft: number;
+  /** 감성 */
+  sense: number;
+  /** 매력 */
+  charm: number;
+}
+//#endregion
+//#region src/lib/data/GearOption.d.ts
+/**
+ * 장비 옵션
+ */
+interface GearOption {
+  /** STR */
+  str: number;
+  /** DEX */
+  dex: number;
+  /** INT */
+  int: number;
+  /** LUK */
+  luk: number;
+  /** STR(%) */
+  strRate: number;
+  /** DEX(%) */
+  dexRate: number;
+  /** INT(%) */
+  intRate: number;
+  /** LUK(%) */
+  lukRate: number;
+  /** 최대 HP */
+  maxHp: number;
+  /** 최대 MP */
+  maxMp: number;
+  /** 최대 HP(%) */
+  maxHpRate: number;
+  /** 최대 MP(%) */
+  maxMpRate: number;
+  /** MaxDF */
+  maxDemonForce: number;
+  /** 공격력 */
+  attackPower: number;
+  /** 마력 */
+  magicPower: number;
+  /** 공격력(%) */
+  attackPowerRate: number;
+  /** 마력(%) */
+  magicPowerRate: number;
+  /** 방어력 */
+  armor: number;
+  /** 방어력(%) */
+  armorRate: number;
+  /** 이동속도 */
+  speed: number;
+  /** 점프력 */
+  jump: number;
+  /** 보스 공격 시 데미지 증가(%) */
+  bossDamage: number;
+  /** 일반 몬스터 데미지(%) */
+  normalDamage: number;
+  /** 몬스터 방어율 무시(%) */
+  ignoreMonsterArmor: number;
+  /** 올스탯(%) */
+  allStat: number;
+  /** 데미지(%) */
+  damage: number;
+  /** 착용 레벨 감소 */
+  reqLevelDecrease: number;
+  /** 크리티컬 확률(%) */
+  criticalRate: number;
+  /** 크리티컬 데미지(%) */
+  criticalDamage: number;
+  /** 재사용 대기시간 감소 (초) */
+  cooltimeReduce: number;
+  /** 캐릭터 기준 9레벨 당 STR */
+  strLv: number;
+  /** 캐릭터 기준 9레벨 당 DEX */
+  dexLv: number;
+  /** 캐릭터 기준 9레벨 당 INT */
+  intLv: number;
+  /** 캐릭터 기준 9레벨 당 LUK */
+  lukLv: number;
+}
+//#endregion
+//#region src/lib/data/GearType.d.ts
+declare enum GearType {
+  /** 모자 */
+  cap = 100,
+  /** 얼굴장식 */
+  faceAccessory = 101,
+  /** 눈장식 */
+  eyeAccessory = 102,
+  /** 귀고리 */
+  earrings = 103,
+  /** 상의 */
+  coat = 104,
+  /** 한벌옷 */
+  longcoat = 105,
+  /** 하의 */
+  pants = 106,
+  /** 신발 */
+  shoes = 107,
+  /** 장갑 */
+  glove = 108,
+  /** 망토 */
+  cape = 110,
+  /** 반지 */
+  ring = 111,
+  /** 펜던트 */
+  pendant = 112,
+  /** 벨트 */
+  belt = 113,
+  /** 훈장 */
+  medal = 114,
+  /** 어깨장식 */
+  shoulder = 115,
+  /** 포켓 아이템 */
+  pocket = 116,
+  /** 뱃지 */
+  badge = 118,
+  /** 안드로이드 */
+  android = 166,
+  /** 기계 심장 */
+  machineHeart = 167,
+  /** 방패 */
+  shield = 109,
+  /** 엠블렘 */
+  emblem = 119,
+  /** 파워소스 */
+  powerSource = 119020,
+  /** 샤이닝 로드 */
+  shiningRod = 1212,
+  /** 튜너 */
+  tuner = 1213,
+  /** 브레스 슈터 */
+  breathShooter = 1214,
+  /** 장검 */
+  longSword2 = 1215,
+  /** 소울 슈터 */
+  soulShooter = 122,
+  /** 데스페라도 */
+  desperado = 123,
+  /** 에너지소드 */
+  energySword = 124,
+  /** ESP 리미터 */
+  espLimiter = 126,
+  /** 체인 (카데나) */
+  chain = 127,
+  /** 매직 건틀렛 */
+  magicGauntlet = 128,
+  /** 부채 (호영) */
+  ritualFan = 129,
+  /** 한손검 */
+  ohSword = 130,
+  /** 한손도끼 */
+  ohAxe = 131,
+  /** 한손둔기 */
+  ohBlunt = 132,
+  /** 단검 */
+  dagger = 133,
+  /** 블레이드 */
+  katara = 134,
+  /** 케인 */
+  cane = 136,
+  /** 완드 */
+  wand = 137,
+  /** 스태프 */
+  staff = 138,
+  /** 두손검 */
+  thSword = 140,
+  /** 차크람 */
+  chakram = 1404,
+  /** 두손도끼 */
+  thAxe = 141,
+  /** 두손둔기 */
+  thBlunt = 142,
+  /** 창 */
+  spear = 143,
+  /** 폴암 */
+  polearm = 144,
+  /** 활 */
+  bow = 145,
+  /** 석궁 */
+  crossbow = 146,
+  /** 아대 */
+  claw = 147,
+  /** 너클 */
+  knuckle = 148,
+  /** 건 */
+  gun = 149,
+  /** 삽 */
+  shovel = 150,
+  /** 곡괭이 */
+  pickaxe = 151,
+  /** 듀얼 보우건 */
+  dualBowguns = 152,
+  /** 핸드캐논 */
+  handCannon = 153,
+  /** 대검 */
+  heavySword = 156,
+  /** 태도 */
+  longSword = 157,
+  /** 건틀렛 리볼버 */
+  gauntletRevolver = 158,
+  /** 에인션트 보우 */
+  ancientBow = 159,
+  /** 소울실드 */
+  soulShield = 1098,
+  /** 포스실드 */
+  demonShield = 1099,
+  /** 마법화살 */
+  magicArrow = 135200,
+  /** 카드 */
+  card = 135210,
+  /** 메달 */
+  medallion = 135220,
+  /** 로자리오 */
+  rosary = 135221,
+  /** 쇠사슬 */
+  ironChain = 135222,
+  /** 마도서 (불,독) */
+  magicBook1 = 135223,
+  /** 마도서 (얼음,번개) */
+  magicBook2 = 135224,
+  /** 마도서 (비숍) */
+  magicBook3 = 135225,
+  /** 화살깃 */
+  arrowFletching = 135226,
+  /** 활골무 */
+  bowThimble = 135227,
+  /** 단검용 검집 */
+  daggerScabbard = 135228,
+  /** 부적 */
+  charm = 135229,
+  /** 오브 */
+  orb = 135240,
+  /** 용의 정수 */
+  dragonEssence = 135250,
+  /** 소울링 */
+  soulRing = 135260,
+  /** 매그넘 */
+  magnum = 135270,
+  /** 리스트밴드 */
+  wristBand = 135290,
+  /** 조준기 */
+  farSight = 135291,
+  /** 화약통 */
+  powderKeg = 135292,
+  /** 무게추 */
+  mass = 135293,
+  /** 문서 */
+  document = 135294,
+  /** 마법구슬 */
+  magicMarble = 135295,
+  /** 화살촉 */
+  arrowhead = 135296,
+  /** 보석 (시그너스) */
+  jewel = 135297,
+  /** 화약통 2 */
+  powderKeg2 = 135298,
+  /** 컨트롤러 */
+  controller = 135300,
+  /** 여우구슬 */
+  foxMarble = 135310,
+  /** 체스피스 */
+  chessPiece = 135320,
+  /** 무기 전송장치 */
+  transmitter = 135330,
+  /** 장약 */
+  charge = 135340,
+  /** 매직윙 */
+  magicWing = 135350,
+  /** 패스 오브 어비스 */
+  pathOfAbyss = 135360,
+  /** 렐릭 */
+  relic = 135370,
+  /** 선추 */
+  fanTassel = 135380,
+  /** 브레이슬릿 */
+  bracelet = 135400,
+  /** 웨폰 벨트 */
+  weaponBelt = 135401,
+  /** 노리개 */
+  ornament = 135402,
+  /** 헥스시커 */
+  hexSeeker = 135403,
+  /** 여의보주 */
+  sacredJewel = 135404,
+  /** 펫장비 */
+  petEquip = 180,
+  /** 메카닉 엔진 */
+  machineEngine = 161,
+  /** 메카닉 암 */
+  machineArms = 162,
+  /** 메카닉 레그 */
+  machineLegs = 163,
+  /** 메카닉 프레임 */
+  machineBody = 164,
+  /** 메카닉 트렌지스터 */
+  machineTransistors = 165,
+  /** 모래시계 */
+  hourGlass = 17237,
+  /** 드래곤 모자 */
+  dragonMask = 194,
+  /** 드래곤 펜던트 */
+  dragonPendant = 195,
+  /** 드래곤 날개장식 */
+  dragonWings = 196,
+  /** 드래곤 꼬리장식 */
+  dragonTail = 197
+}
+//#endregion
+//#region src/lib/data/PotentialGrade.d.ts
+declare enum PotentialGrade {
+  Normal = 0,
+  Rare = 1,
+  Epic = 2,
+  Unique = 3,
+  Legendary = 4
+}
+//#endregion
+//#region src/lib/data/PotentialData.d.ts
+/**
+ * 잠재옵션 정보
+ */
+interface PotentialData {
+  /** 잠재능력 ID */
+  id?: number;
+  /** 잠재능력 등급 */
+  grade: PotentialGrade;
+  /** 장비에 표시되는 이름 */
+  summary: string;
+  /** 잠재능력 옵션 */
+  option: Partial<PotentialOption>;
+}
+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'>;
+//#endregion
+//#region src/lib/data/SoulSlotData.d.ts
+/**
+ * 소울 웨폰 정보
+ */
+interface SoulSlotData {
+  /** 소울 아이템 */
+  soul?: SoulData;
+  /** 소울 충전량 */
+  charge?: number;
+  /** 소울 충전 옵션 */
+  chargeOption?: Partial<SoulChargeOption>;
+}
+/**
+ * 소울 정보
+ */
+interface SoulData {
+  /** 소울 명 */
+  name: string;
+  /** 소울 스킬 명 */
+  skill: string;
+  /** 소울 옵션 */
+  option: Partial<SoulOption>;
+  /** 소울 충전 옵션 배율 */
+  chargeFactor?: 1 | 2;
+}
+/**
+ * 소울 정보 (읽기 전용)
+ */
+type ReadonlySoulData = Readonly<Omit<SoulData, 'option'> & {
+  option: Readonly<SoulOption>;
+}>;
+/**
+ * 소울 충전 옵션
+ */
+type SoulChargeOption = Pick<GearOption, 'attackPower' | 'magicPower'>;
+/**
+ * 소울 옵션
+ */
+type SoulOption = Pick<GearOption, 'str' | 'dex' | 'int' | 'luk' | 'strRate' | 'dexRate' | 'intRate' | 'lukRate' | 'attackPower' | 'magicPower' | 'attackPowerRate' | 'magicPowerRate' | 'maxHp' | 'maxMp' | 'criticalRate' | 'ignoreMonsterArmor' | 'bossDamage'>;
+//#endregion
+//#region src/lib/data/GearData.d.ts
+declare const VERSION = 3;
+/**
+ * 장비 정보
+ */
+interface GearData {
+  /** 장비 정보 버전 */
+  version: typeof VERSION;
+  /** 아이템 ID */
+  id: number;
+  /** 장비명 */
+  name: string;
+  /** 장비 설명 */
+  desc?: string;
+  /** 장비 아이콘 */
+  icon: string;
+  /** 장비 외형 */
+  shape?: GearShapeData;
+  /** 이름 새기기 */
+  itemTag?: string;
+  /** 장비 분류 */
+  type: GearType;
+  /** 장비 착용 제한 */
+  req: GearReqData;
+  /** 장비 속성 */
+  attributes: GearAttributeData;
+  /** 장비 기본 옵션 */
+  baseOption?: Partial<GearBaseOption>;
+  /** 장비 추가 옵션 */
+  addOption?: Partial<GearAddOption>;
+  /** 장비 주문서 강화 옵션 */
+  upgradeOption?: Partial<GearUpgradeOption>;
+  /** 장비 스타포스 옵션 */
+  starforceOption?: Partial<GearStarforceOption>;
+  /** 추가 옵션 목록 */
+  addOptions?: AddOptionData[];
+  /** 업그레이드 횟수 */
+  scrollUpgradeCount?: number;
+  /** 복구 가능 횟수 */
+  scrollResilienceCount?: number;
+  /** 업그레이드 가능 횟수 */
+  scrollUpgradeableCount?: number;
+  /** 강화 단계 */
+  star?: number;
+  /** 놀라운 장비 강화 주문서 사용 여부 */
+  starScroll?: boolean;
+  /** 소울 웨폰 정보 */
+  soulSlot?: SoulSlotData;
+  /** 잠재능력 등급 */
+  potentialGrade?: PotentialGrade;
+  /** 잠재능력 목록 */
+  potentials?: PotentialData[];
+  /** 에디셔널 잠재능력 등급 */
+  additionalPotentialGrade?: PotentialGrade;
+  /** 에디셔널 잠재능력 목록 */
+  additionalPotentials?: PotentialData[];
+  /** 장비 익셉셔널 옵션 */
+  exceptionalOption?: Partial<GearExceptionalOption>;
+  /** 익셉셔널 강화 횟수 */
+  exceptionalUpgradeCount?: number;
+  /** 익셉셔널 강화 가능 횟수 */
+  exceptionalUpgradeableCount?: number;
+}
+/**
+ * 장비 외형 정보
+ */
+interface GearShapeData {
+  /** 장비 외형 이름 */
+  name: string;
+  /** 장비 외형 아이콘 */
+  icon: string;
+}
+/**
+ * 장비 착용 제한 정보
+ */
+interface GearReqData {
+  /** 착용 가능 레벨 */
+  level?: number;
+  /** 착용 가능 레벨 증가 */
+  levelIncrease?: number;
+  /** 착용 가능 직업 분류 */
+  job?: number;
+  /** 착용 가능 직업 */
+  class?: number[];
+  /** 착용 가능 성별 */
+  gender?: GearGender;
+}
+/**
+ * 착용 가능 성별
+ */
+declare enum GearGender {
+  /** 남 */
+  Male = 0,
+  /** 여 */
+  Female = 1
+}
+/**
+ * 장비 기본 옵션
+ */
+type GearBaseOption = Pick<GearOption, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'maxHpRate' | 'maxMpRate' | 'maxDemonForce' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump' | 'bossDamage' | 'ignoreMonsterArmor' | 'allStat' | 'damage' | 'reqLevelDecrease'>;
+/**
+ * 장비 추가 옵션
+ */
+type GearAddOption = Pick<GearBaseOption, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump' | 'bossDamage' | 'allStat' | 'damage' | 'reqLevelDecrease'>;
+/**
+ * 장비 주문서 옵션
+ */
+type GearUpgradeOption = Pick<GearBaseOption, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump'>;
+/**
+ * 장비 스타포스 옵션
+ */
+type GearStarforceOption = Pick<GearBaseOption, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump'>;
+/**
+ * 장비 익셉셔널 옵션
+ */
+type GearExceptionalOption = Pick<GearBaseOption, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'attackPower' | 'magicPower'>;
+//#endregion
+//#region src/lib/enhance/potential.d.ts
+/**
+ * 잠재옵션 (읽기 전용)
+ */
+interface ReadonlyPotential extends Readonly<PotentialData> {
+  /** 잠재능력 옵션 */
+  option: Readonly<PotentialOption>;
+}
+/**
+ * 장비가 잠재능력을 지원하는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 지원할 경우 `true`; 아닐 경우 `false`.
+ */
+declare function supportsPotential(gear: ReadonlyGear): boolean;
+/**
+ * 장비의 잠재능력을 설정할 수 있는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 설정할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function canSetPotential(gear: ReadonlyGear): boolean;
+/**
+ * 장비의 잠재능력을 설정합니다.
+ * @param gear 설정할 장비.
+ * @param grade 잠재능력 등급.
+ * @param options 잠재옵션 목록.
+ *
+ * @throws {@link GearError}
+ * 잠재능력을 설정할 수 없는 장비일 경우.
+ *
+ * @throws {@link RangeError}
+ * 설정하려는 잠재능력 등급이 Normal일 경우.
+ *
+ * @throws {@link TypeError}
+ * 잘못된 잠재옵션 목록을 지정했을 경우.
+ */
+declare function setPotential(gear: Gear, grade: PotentialGrade, options: PotentialData[]): void;
+/**
+ * 장비의 잠재능력을 초기화합니다.
+ *
+ * 에디셔널 잠재능력은 변경되지 않습니다.
+ * @param gear 초기화할 장비.
+ *
+ * @throws {@link GearError}
+ * 잠재능력을 초기화할 수 없는 장비일 경우.
+ */
+declare function resetPotential(gear: Gear): void;
+/**
+ * 장비가 에디셔널 잠재능력을 지원하는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 지원할 경우 `true`; 아닐 경우 `false`.
+ */
+declare function supportsAdditionalPotential(gear: ReadonlyGear): boolean;
+/**
+ * 장비의 에디셔널 잠재능력을 설정할 수 있는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 설정할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function canSetAdditionalPotential(gear: ReadonlyGear): boolean;
+/**
+ * 장비의 에디셔널 잠재능력을 설정합니다.
+ * @param gear 설정할 장비.
+ * @param grade 에디셔널 잠재능력 등급.
+ * @param options 에디셔널 잠재옵션 목록.
+ *
+ * @throws {@link GearError}
+ * 에디셔널 잠재능력을 설정할 수 없는 장비일 경우.
+ *
+ * @throws {@link RangeError}
+ * 설정하려는 에디셔널 잠재능력 등급이 Normal일 경우.
+ *
+ * @throws {@link GearError}
+ * 잘못된 에디셔널 잠재옵션 목록을 지정했을 경우.
+ */
+declare function setAdditionalPotential(gear: Gear, grade: PotentialGrade, options: PotentialData[]): void;
+/**
+ * 장비의 에디셔널 잠재능력을 초기화합니다.
+ * @param gear 초기화할 장비.
+ *
+ * @throws {@link GearError}
+ * 에디셔널 잠재능력을 초기화할 수 없는 장비일 경우.
+ */
+declare function resetAdditionalPotential(gear: Gear): void;
+//#endregion
+//#region src/lib/GearAttribute.d.ts
+type OptionalProperty = 'attackSpeed' | 'cuttableCount' | 'totalCuttableCount' | 'setItemId' | 'growthExp' | 'growthLevel' | 'dateExpire' | 'fixedMaxStar';
+type _GearAttribute = Omit<Omit<Required<GearAttributeData>, OptionalProperty> & Pick<GearAttributeData, OptionalProperty>, 'skills'> & {
+  skills: readonly string[];
+};
+declare class GearAttribute implements _GearAttribute {
+  /** 장비 속성 정보 */
+  data: GearAttributeData;
+  constructor(data: GearAttributeData);
+  /** 고유 아이템 */
+  get only(): boolean;
+  /** 교환 가능 여부 */
+  get trade(): GearTrade;
+  set trade(value: GearTrade);
+  /** 고유장착 아이템 */
+  get onlyEquip(): boolean;
+  /** 월드 내 나의 캐릭터 간 이동 가능 여부 */
+  get share(): GearShare;
+  /** 슈페리얼 */
+  get superior(): boolean;
+  /** 공격 속도 */
+  get attackSpeed(): number | undefined;
+  /** 주문서 강화 가능 여부 */
+  get canScroll(): GearCapability;
+  /** 스타포스 강화 가능 여부 */
+  get canStarforce(): GearCapability;
+  /** 추가옵션 설정 가능 여부 */
+  get canAddOption(): GearCapability;
+  /** 잠재능력 설정 가능 여부 */
+  get canPotential(): GearCapability;
+  /** 에디셔널 잠재능력 설정 가능 여부 */
+  get canAdditionalPotential(): GearCapability;
+  /** 스페셜 아이템 여부 */
+  get specialGrade(): boolean;
+  /** 최대 스타포스 강화 단계 */
+  get fixedMaxStar(): number | undefined;
+  /** 카르마의 가위 사용 가능 여부 */
+  get cuttable(): GearCuttable;
+  /** 가위 사용 가능 횟수 */
+  get cuttableCount(): number | undefined;
+  set cuttableCount(value: number | undefined);
+  /** 최대 가위 사용 가능 횟수 */
+  get totalCuttableCount(): number | undefined;
+  /** 쉐어 네임 텍을 사용 가능 여부 */
+  get accountShareTag(): boolean;
+  /** 훈장 신비의 모루 사용 불가 여부 */
+  get noShapeChange(): boolean;
+  /** 세트 효과 ID */
+  get setItemId(): number | undefined;
+  /** 럭키 아이템 */
+  get lucky(): boolean;
+  /** 장착 시 획득 경험치 */
+  get incline(): Readonly<GearIncline>;
+  set incline(value: Partial<GearIncline>);
+  /** 보스 드롭 여부 */
+  get bossReward(): boolean;
+  /** 사용 가능 스킬 */
+  get skills(): readonly string[];
+  /** 성장 경험치 */
+  get growthExp(): number | undefined;
+  set growthExp(value: number | undefined);
+  /** 성장 레벨 */
+  get growthLevel(): number | undefined;
+  set growthLevel(value: number | undefined);
+  /** 장비 유효 기간(KST) */
+  get dateExpire(): string | undefined;
+  set dateExpire(value: string | undefined);
+}
+//#endregion
+//#region src/lib/GearReq.d.ts
+/**
+ * 장비 착용 제한
+ */
+declare class GearReq implements GearReqData {
+  /**
+   * 장비 착용 제한 정보
+   */
+  data: GearReqData;
+  /**
+   * 장비 착용 제한 정보를 참조하는 장비 착용 제한 인스턴스를 생성합니다.
+   */
+  constructor(data: GearReqData);
+  /**
+   * 기본 착용 가능 레벨
+   */
+  get level(): number;
+  /**
+   * 착용 가능 레벨 증가
+   */
+  get levelIncrease(): number;
+  /**
+   * 착용 가능 직업 분류
+   * */
+  get job(): number;
+  /**
+   * 착용 가능 직업
+   */
+  get class(): number[];
+  /**
+   * 착용 가능 성별
+   */
+  get gender(): GearGender | undefined;
+  /**
+   * 초보자 및 전 직업 착용 가능 여부를 계산합니다.
+   * @returns 착용할 수 있을 경우 `true`; 아닐 경우 `false`.
+   */
+  beginner(): boolean;
+  /**
+   * 전사 착용 가능 여부를 계산합니다.
+   * @returns 착용할 수 있을 경우 `true`; 아닐 경우 `false`.
+   */
+  warrior(): boolean;
+  /**
+   * 마법사 착용 가능 여부를 계산합니다.
+   * @returns 착용할 수 있을 경우 `true`; 아닐 경우 `false`.
+   */
+  magician(): boolean;
+  /**
+   * 궁수 착용 가능 여부를 계산합니다.
+   * @returns 착용할 수 있을 경우 `true`; 아닐 경우 `false`.
+   */
+  bowman(): boolean;
+  /**
+   * 도적 착용 가능 여부를 계산합니다.
+   * @returns 착용할 수 있을 경우 `true`; 아닐 경우 `false`.
+   */
+  thief(): boolean;
+  /**
+   * 해적 착용 가능 여부를 계산합니다.
+   * @returns 착용할 수 있을 경우 `true`; 아닐 경우 `false`.
+   */
+  pirate(): boolean;
+}
+//#endregion
+//#region src/lib/ReadonlyGear.d.ts
+type _Gear = Omit<GearData, 'attributes' | 'potentials' | 'additionalPotentials' | 'addOptions'> & {
+  attributes: GearAttribute;
+  addOptions: readonly Readonly<AddOptionData>[];
+  potentials: readonly ReadonlyPotential[];
+  additionalPotentials: readonly ReadonlyPotential[];
+};
+/**
+ * 장비 (읽기 전용)
+ *
+ * 생성자에 전달된 장비 정보와 `data` 속성 간에 엄격한 동등(`===`)을 보장합니다.
+ *
+ * 장비 정보의 모든 속성에 대해 읽기 전용 속성을 제공합니다.
+ */
+declare class ReadonlyGear implements _Gear {
+  /** 장비 정보 */
+  protected readonly _data: Readonly<GearData>;
+  /**
+   * 장비 정보를 참조하는 장비 인스턴스를 생성합니다.
+   * @param data 장비 정보.
+   *
+   * @throws {@link GearError}
+   * 지원하지 않는 장비 정보 버전일 경우.
+   */
+  constructor(data: GearData);
+  /**
+   * 장비 정보
+   */
+  get data(): Readonly<GearData>;
+  /**
+   * 장비 정보 버전
+   */
+  get version(): typeof VERSION;
+  /**
+   * 장비 ID
+   */
+  get id(): number;
+  /**
+   * 장비명
+   */
+  get name(): string;
+  /**
+   * 장비 아이콘
+   */
+  get icon(): string;
+  /**
+   * 장비 설명
+   */
+  get desc(): string | undefined;
+  /**
+   * 장비 외형
+   */
+  get shape(): Readonly<GearShapeData> | undefined;
+  /**
+   * 장비 외형 아이콘
+   *
+   * 장비 외형이 설정되었을 경우 장비 외형 아이콘, 그렇지 않을 경우 장비 아이콘.
+   */
+  get shapeIcon(): string;
+  /**
+   * 이름 새기기
+   */
+  get itemTag(): string | undefined;
+  /**
+   * 장비 분류
+   */
+  get type(): GearType;
+  /**
+   * 장비 착용 제한
+   */
+  get req(): GearReq;
+  /**
+   * 장비 속성
+   */
+  get attributes(): GearAttribute;
+  /**
+   * 장비 최종 옵션
+   *
+   * 기본 옵션, 추가 옵션, 주문서 옵션, 스타포스 옵션의 합.
+   *
+   * 익셉셔널 옵션은 미포함.
+   */
+  get totalOption(): Readonly<GearBaseOption & GearAddOption & GearUpgradeOption & GearStarforceOption>;
+  /**
+   * 장비 순수 옵션
+   */
+  get baseOption(): Readonly<GearBaseOption>;
+  /**
+   * 장비 추가 옵션
+   */
+  get addOption(): Readonly<GearAddOption>;
+  /**
+   * 장비 주문서 강화 옵션
+   */
+  get upgradeOption(): Readonly<GearUpgradeOption>;
+  /**
+   * 장비 스타포스 옵션
+   */
+  get starforceOption(): Readonly<GearStarforceOption>;
+  /**
+   * 추가 옵션 목록
+   */
+  get addOptions(): readonly Readonly<AddOptionData>[];
+  /**
+   * 업그레이드 횟수
+   */
+  get scrollUpgradeCount(): number;
+  /**
+   * 복구 가능 횟수
+   */
+  get scrollResilienceCount(): number;
+  /**
+   * 업그레이드 가능 횟수
+   */
+  get scrollUpgradeableCount(): number;
+  /**
+   * 전체 업그레이드 가능 횟수
+   *
+   * 성공, 실패, 황금 망치 적용 여부를 무시한 장비의 기본 업그레이드 가능 횟수입니다.
+   */
+  get scrollTotalUpgradeableCount(): number;
+  /**
+   * 스타포스 강화 단계
+   */
+  get star(): number;
+  /**
+   * 최대 스타포스 강화 단계
+   *
+   * 놀라운 장비 강화 주문서가 사용되었을 경우 최대 `15`입니다.
+   */
+  get maxStar(): number;
+  /**
+   * 놀라운 장비 강화 주문서 사용 여부
+   */
+  get starScroll(): boolean;
+  /**
+   * 소울 인챈트 여부
+   */
+  get soulEnchanted(): boolean;
+  /**
+   * 소울
+   */
+  get soul(): ReadonlySoulData | undefined;
+  /**
+   * 소울 충전량
+   */
+  get soulCharge(): number;
+  /**
+   * 소울 충전 옵션
+   */
+  get soulChargeOption(): Readonly<SoulChargeOption>;
+  /**
+   * 잠재능력 등급
+   */
+  get potentialGrade(): PotentialGrade;
+  /**
+   * 잠재능력 목록
+   */
+  get potentials(): readonly ReadonlyPotential[];
+  /**
+   * 에디셔널 잠재능력 등급
+   */
+  get additionalPotentialGrade(): PotentialGrade;
+  /**
+   * 에디셔널 잠재능력 목록
+   */
+  get additionalPotentials(): readonly Readonly<ReadonlyPotential>[];
+  /**
+   * 장비 익셉셔널 옵션
+   */
+  get exceptionalOption(): Readonly<GearExceptionalOption>;
+  /**
+   * 익셉셔널 강화 횟수
+   */
+  get exceptionalUpgradeCount(): number;
+  /**
+   * 익셉셔널 강화 가능 횟수
+   */
+  get exceptionalUpgradeableCount(): number;
+  /**
+   * 전체 익셉셔널 강화 가능 횟수
+   */
+  get exceptionalTotalUpgradeableCount(): number;
+}
+//#endregion
+//#region src/lib/enhance/exceptional.d.ts
+/**
+ * 익셉셔널 해머
+ */
+interface ExceptionalHammer {
+  /** 익셉셔널 해머 이름 */
+  name: string;
+  /** 익셉셔널 해머 아이콘 */
+  icon?: string;
+  /** 익셉셔널 해머 옵션 */
+  option: Partial<GearUpgradeOption>;
+}
+/**
+ * 장비가 익셉셔널 강화를 지원하는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 지원할 경우 `true`; 아닐 경우 `false`.
+ */
+declare function supportsExceptional(gear: ReadonlyGear): boolean;
+/**
+ * 장비에 익셉셔널 강화를 적용할 수 있는 상태인지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function canApplyExceptional(gear: ReadonlyGear): boolean;
+/**
+ * 장비에 익셉셔널 강화를 적용합니다.
+ * @param gear 적용할 장비.
+ * @param exceptionalHammer 적용할 익셉셔널 해머.
+ *
+ * @throws {@link GearError}
+ * 익셉셔널 강화를 적용할 수 없는 상태의 장비일 경우.
+ */
+declare function applyExceptional(gear: Gear, exceptionalHammer: ExceptionalHammer): void;
+/**
+ * 장비의 익셉셔널 강화를 초기화할 수 있는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 초기화할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function canResetExceptional(gear: ReadonlyGear): boolean;
+/**
+ * 장비의 익셉셔널 강화를 초기화합니다.
+ * @param gear 초기화할 장비.
+ *
+ * @throws {@link GearError}
+ * 익셉셔널 강화를 초기화할 수 없는 장비일 경우.
+ */
+declare function resetExceptional(gear: Gear): void;
+//#endregion
+//#region src/lib/enhance/upgrade.d.ts
+/**
+ * 주문서
+ */
+interface Scroll {
+  /** 주문서 이름 */
+  name: string;
+  /** 주문서 아이콘 */
+  icon?: string;
+  /** 주문서 옵션 */
+  option: Partial<GearUpgradeOption>;
+}
+/**
+ * 장비가 주문서 강화를 지원하는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 지원할 경우 `true`; 아닐 경우 `false`.
+ */
+declare function supportsUpgrade(gear: ReadonlyGear): boolean;
+/**
+ * 장비에 주문서 실패를 적용할 수 있는 상태인지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function canFailScroll(gear: ReadonlyGear): boolean;
+/**
+ * 장비에 주문서 실패를 적용합니다.
+ * @param gear 적용할 장비.
+ *
+ * @throws {@link GearError}
+ * 주문서 실패를 적용할 수 없는 상태의 장비일 경우.
+ */
+declare function failScroll(gear: Gear): void;
+/**
+ * 장비가 주문서 실패로 차감된 업그레이드 가능 횟수를 복구할 수 있는 상태인지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 복구할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function canResileScroll(gear: ReadonlyGear): boolean;
+/**
+ * 장비의 주문서 실패로 차감된 업그레이드 가능 횟수를 1회 복구합니다.
+ * @param gear 복구할 장비.
+ *
+ * @throws {@link GearError}
+ * 업그레이드 가능 횟수를 복구할 수 없는 상태의 장비일 경우.
+ */
+declare function resileScroll(gear: Gear): void;
+/**
+ * 장비의 주문서 강화를 초기화할 수 있는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 초기화할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function canResetUpgrade(gear: ReadonlyGear): boolean;
+/**
+ * 장비의 주문서 강화를 초기화합니다.
+ * @param gear 초기화할 장비.
+ *
+ * @throws {@link GearError}
+ * 주문서 강화를 초기화할 수 없는 장비일 경우.
+ */
+declare function resetUpgrade(gear: Gear): void;
+/**
+ * 장비에 주문서를 적용할 수 있는 상태인지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function canApplyScroll(gear: ReadonlyGear): boolean;
+/**
+ * 장비에 주문서를 적용합니다.
+ * @param gear 적용할 장비.
+ * @param scroll 적용할 주문서.
+ *
+ * @throws {@link GearError}
+ * 주문서를 적용할 수 없는 상태의 장비일 경우.
+ */
+declare function applyScroll(gear: Gear, scroll: Scroll): void;
+//#endregion
+//#region src/lib/enhance/spellTrace.d.ts
+/**
+ * 주문의 흔적 종류
+ */
+declare enum SpellTraceType {
+  /** STR */
+  str = "str",
+  /** DEX */
+  dex = "dex",
+  /** INT */
+  int = "int",
+  /** LUK */
+  luk = "luk",
+  /** 최대 HP */
+  maxHp = "maxHp",
+  /** 올스탯 */
+  allStat = "allStat"
+}
+/**
+ * 주문의 흔적 성공 확률
+ */
+type SpellTraceRate = 100 | 70 | 30 | 15;
+/**
+ * 주문의 흔적
+ */
+type SpellTrace = Scroll & {
+  type: SpellTraceType;
+  rate: SpellTraceRate;
+};
+/**
+ * 장비에 주문의 흔적 강화를 적용합니다.
+ * @param gear 적용할 장비.
+ * @param type 주문의 흔적 종류.
+ * @param rate 주문의 흔적 성공 확률.
+ *
+ * @throws {@link GearError}
+ * 주문서를 적용할 수 없는 상태의 장비일 경우.
+ *
+ * @throws {@link GearError}
+ * 장비에 적용할 수 없는 주문의 흔적을 지정했을 경우.
+ */
+declare function applySpellTrace(gear: Gear, type: SpellTraceType, rate: SpellTraceRate): void;
+/**
+ * 주문의 흔적 주문서를 생성합니다.
+ * @param gear 대상 장비.
+ * @param type 주문의 흔적 종류.
+ * @param rate 주문의 흔적 성공 확률.
+ * @returns 주문의 흔적 주문서.
+ *
+ * @throws {@link GearError}
+ * 주문의 흔적을 장비에 적용할 수 없는 경우.
+ */
+declare function getSpellTraceScroll(gear: ReadonlyGear, type: SpellTraceType, rate: SpellTraceRate): SpellTrace;
+//#endregion
+//#region src/lib/Gear.d.ts
+/**
+ * 장비
+ *
+ * 장비 정보를 KMS과 동일한 방식으로 변경하는 기능을 제공합니다.
+ * - `supports...`: 장비가 특정 강화 방식을 지원하는지 여부입니다.
+ * - `can...`: 장비에 특정 강화를 적용할 수 있는 상태인지 여부입니다.
+ * - `apply...()`: 장비에 특정 강화를 적용합니다.
+ * - `set...()`: 장비의 특정 속성을 설정합니다.
+ * - `reset...()`: 장비의 특정 강화에 관련된 속성을 초기화합니다.
+ *
+ * 생성자에 전달된 장비 정보와 `data` 속성 간에 엄격한 동등(`===`)을 보장합니다.
+ *
+ * 장비 정보의 모든 속성에 대해 읽기 전용 속성을 제공합니다.
+ * 일부 속성은 장비 객체 자체에 또는 반환 객체의 속성에 쓰기가 가능합니다.
+ */
+declare class Gear extends ReadonlyGear {
+  /**
+   * 장비 정보
+   */
+  get data(): GearData;
+  /**
+   * 장비 외형
+   */
+  get shape(): Readonly<GearShapeData> | undefined;
+  /**
+   * 장비 외형 변경
+   *
+   * @param shape 변경할 장비 외형.
+   *
+   * @throws {@link GearError}
+   * 외형을 변경할 수 없는 장비일 경우.
+   */
+  set shape(shape: GearShapeData | undefined);
+  /**
+   * 이름 새기기
+   */
+  get itemTag(): string | undefined;
+  /**
+   * 이름 새기기 변경
+   *
+   * @param itemTag 적용할 이름.
+   */
+  set itemTag(itemTag: string | undefined);
+  /**
+   * 장비가 추가 옵션을 지원하는지 여부
+   */
+  get supportsAddOption(): boolean;
+  /**
+   * 장비에 추가 옵션을 적용할 수 있는 상태인지 여부
+   */
+  get canApplyAddOption(): boolean;
+  /**
+   * 장비에 추가 옵션을 적용합니다.
+   * @param type 추가 옵션 종류.
+   * @param grade 추가 옵션 단계.
+   *
+   * @throws {@link GearError}
+   * 추가 옵션을 적용할 수 없는 상태일 경우.
+   *
+   * @throws {@link GearError}
+   * 부여할 수 없는 추가 옵션을 지정했을 경우.
+   */
+  applyAddOption(type: AddOptionType, grade: AddOptionGrade): void;
+  /**
+   * 장비의 추가 옵션을 초기화할 수 있는 상태인지 여부
+   */
+  get canResetAddOption(): boolean;
+  /**
+   * 장비의 추가 옵션을 초기화합니다.
+   *
+   * @throws {@link GearError}
+   * 추가 옵션을 초기화할 수 없는 상태의 장비일 경우.
+   */
+  resetAddOption(): void;
+  /**
+   * 장비가 주문서 강화를 지원하는지 여부
+   */
+  get supportsUpgrade(): boolean;
+  /**
+   * 장비에 주문서 실패를 적용할 수 있는 상태인지 여부
+   */
+  get canApplyScrollFail(): boolean;
+  /**
+   * 장비에 주문서 실패를 1회 적용합니다.
+   *
+   * @throws {@link GearError}
+   * 주문서 실패를 적용할 수 없는 상태일 경우.
+   */
+  applyScrollFail(): void;
+  /**
+   * 장비의 주문서 실패로 차감된 업그레이드 가능 횟수를 복구할 수 있는 상태인지 여부
+   */
+  get canApplyResileScroll(): boolean;
+  /**
+   * 장비의 주문서 실패로 차감된 업그레이드 가능 횟수를 1회 복구합니다.
+   *
+   * @throws {@link GearError}
+   * 업그레이드 가능 횟수를 복구할 수 없는 상태일 경우.
+   */
+  applyResileScroll(): void;
+  /**
+   * 장비의 주문서 강화를 초기화할 수 있는 상태인지 여부
+   */
+  get canResetUpgrade(): boolean;
+  /**
+   * 장비의 주문서 강화를 초기화합니다.
+   *
+   * @throws {@link GearError}
+   * 주문서 강화를 초기화할 수 없는 장비일 경우.
+   */
+  resetUpgrade(): void;
+  /**
+   * 장비에 주문서를 적용할 수 있는 상태인지 여부
+   */
+  get canApplyScroll(): boolean;
+  /**
+   * 장비에 주문서를 1회 적용합니다.
+   * @param scroll 적용할 주문서.
+   *
+   * @throws {@link GearError}
+   * 주문서를 적용할 수 없는 상태일 경우.
+   */
+  applyScroll(scroll: Scroll): void;
+  /**
+   * 장비에 주문의 흔적 강화를 1회 적용합니다.
+   * @param type 주문의 흔적 종류.
+   * @param rate 주문의 흔적 성공 확률.
+   *
+   * @throws {@link GearError}
+   * 주문서를 적용할 수 없는 상태일 경우.
+   *
+   * @throws {@link GearError}
+   * 적용할 수 없는 주문의 흔적을 지정했을 경우.
+   */
+  applySpellTrace(type: SpellTraceType, rate: SpellTraceRate): void;
+  /**
+   * 장비가 스타포스 강화를 지원하는지 여부
+   */
+  get supportsStarforce(): boolean;
+  /**
+   * 장비에 스타포스 강화를 적용할 수 있는 상태인지 여부
+   */
+  get canApplyStarforce(): boolean;
+  /**
+   * 장비에 스타포스 강화를 1회 적용합니다.
+   *
+   * @throws {@link GearError}
+   * 스타포스 강화를 적용할 수 없는 경우.
+   */
+  applyStarforce(): void;
+  /**
+   * 장비에 최대 강화 단계를 무시하고 스타포스 강화를 적용할 수 있는 상태인지 여부
+   */
+  get canApplyStarforceIgnoringMaxStar(): boolean;
+  /**
+   * 장비에 최대 강화 단계를 무시하고 스타포스 강화를 1회 적용합니다.
+   *
+   * @throws {@link GearError}
+   * 스타포스 강화를 적용할 수 없는 경우.
+   */
+  applyStarforceIgnoringMaxStar(): void;
+  /**
+   * 장비에 놀라운 장비 강화 주문서를 적용할 수 있는 상태인지 여부
+   */
+  get canApplyStarScroll(): boolean;
+  /**
+   * 장비에 놀라운 장비 강화 주문서를 1회 적용합니다.
+   * @param bonus 보너스 스탯 적용 여부.
+   *
+   * @throws {@link GearError}
+   * 놀라운 장비 강화 주문서를 적용할 수 없는 경우.
+   */
+  applyStarScroll(bonus?: boolean): void;
+  /**
+   * 장비에 놀라운 장비 강화 주문서를 적용할 수 있는 상태인지 여부
+   */
+  get canApplyStarScrollIgnoringMaxStar(): boolean;
+  /**
+   * 장비에 놀라운 장비 강화 주문서를 1회 적용합니다.
+   * @param bonus 보너스 스탯 적용 여부.
+   *
+   * @throws {@link GearError}
+   * 놀라운 장비 강화 주문서를 적용할 수 없는 경우.
+   */
+  applyStarScrollIgnoringMaxStar(bonus?: boolean): void;
+  /**
+   * 장비의 스타포스 강화를 초기화할 수 있는지 여부
+   */
+  get canResetStarforce(): boolean;
+  /**
+   * 장비의 스타포스 강화를 초기화합니다.
+   */
+  resetStarforce(): void;
+  /**
+   * 장비가 잠재능력을 지원하는지 여부
+   */
+  get supportsPotential(): boolean;
+  /**
+   * 장비의 잠재능력을 설정할 수 있는지 여부
+   */
+  get canSetPotential(): boolean;
+  /**
+   * 장비의 잠재능력을 설정합니다.
+   *
+   * `grade`는 `PotentialGrade.Normal`일 수 없습니다.
+   *
+   * `options`에 포함된 잠재옵션은 1개 이상 3개 이하여야 합니다.
+   * @param grade 잠재능력 등급.
+   * @param options 잠재옵션 목록.
+   *
+   * @throws {@link GearError}
+   * 잠재능력을 설정할 수 없는 경우.
+   *
+   * @throws {@link RangeError}
+   * 설정하려는 잠재능력 등급이 Normal일 경우.
+   *
+   * @throws {@link TypeError}
+   * 잘못된 잠재옵션 목록을 지정했을 경우.
+   */
+  setPotential(grade: PotentialGrade, options: PotentialData[]): void;
+  /**
+   * 장비의 잠재능력을 초기화합니다.
+   *
+   * 에디셔널 잠재능력은 변경되지 않습니다.
+   *
+   * @throws {@link GearError}
+   * 잠재능력을 초기화할 수 없는 경우.
+   */
+  resetPotential(): void;
+  /**
+   * 장비가 에디셔널 잠재능력을 지원하는지 여부
+   */
+  get supportsAdditionalPotential(): boolean;
+  /**
+   * 장비의 에디셔널 잠재능력을 설정할 수 있는지 여부
+   */
+  get canSetAdditionalPotential(): boolean;
+  /**
+   * 장비의 에디셔널 잠재능력을 설정합니다.
+   *
+   * `grade`는 `PotentialGrade.Normal`일 수 없습니다.
+   *
+   * `options`에 포함된 에디셔널 잠재옵션은 1개 이상 3개 이하여야 합니다.
+   * @param grade 에디셔널 잠재능력 등급.
+   * @param options 에디셔널 잠재옵션 목록.
+   *
+   * @throws {@link GearError}
+   * 에디셔널 잠재능력을 설정할 수 없는 경우.
+   *
+   * @throws {@link RangeError}
+   * 설정하려는 에디셔널 잠재능력 등급이 Normal일 경우.
+   *
+   * @throws {@link TypeError}
+   * 잘못된 에디셔널 잠재옵션 목록을 지정했을 경우.
+   */
+  setAdditionalPotential(grade: PotentialGrade, options: PotentialData[]): void;
+  /**
+   * 장비의 에디셔널 잠재능력을 초기화합니다.
+   *
+   * @throws {@link GearError}
+   * 에디셔널 잠재능력을 초기화할 수 없는 경우.
+   */
+  resetAdditionalPotential(): void;
+  /**
+   * 장비가 소울웨폰을 지원하는지 여부
+   */
+  get supportsSoul(): boolean;
+  /**
+   * 장비에 소울 인챈터를 적용할 수 있는 상태인지 여부
+   */
+  get canApplySoulEnchant(): boolean;
+  /**
+   * 장비에 소울 인챈터를 적용합니다.
+   */
+  applySoulEnchant(): void;
+  /**
+   * 장비에 소울을 장착할 수 있는지 여부
+   */
+  get canSetSoul(): boolean;
+  /**
+   * 장비에 소울을 장착합니다.
+   * @param soul 장착할 소울 아이템.
+   *
+   * @throws {@link GearError}
+   * 소울을 장착할 수 없는 경우.
+   */
+  setSoul(soul: SoulData): void;
+  /**
+   * 장비의 소울 충전량을 설정할 수 있는지 여부
+   */
+  get canSetSoulCharge(): boolean;
+  /**
+   * 장비의 소울 충전량을 설정합니다.
+   * @param charge 소울 충전량.
+   *
+   * @throws {@link GearError}
+   * 소울 충전량을 설정할 수 없는 경우.
+   */
+  setSoulCharge(charge: number): void;
+  /**
+   * 장비의 소울웨폰을 초기화합니다.
+   */
+  resetSoulEnchant(): void;
+  /**
+   * 장비가 익셉셔널 강화를 지원하는지 여부
+   */
+  get supportsExceptional(): boolean;
+  /**
+   * 장비에 익셉셔널 강화를 적용할 수 있는지 여부
+   */
+  get canApplyExceptional(): boolean;
+  /**
+   * 장비에 익셉셔널 강화를 적용합니다.
+   * @param exceptionalHammer 적용할 익셉셔널 해머.
+   *
+   * @throws {@link GearError}
+   * 익셉셔널 강화를 적용할 수 없는 상태일 경우.
+   */
+  applyExceptional(exceptionalHammer: ExceptionalHammer): void;
+  /**
+   * 장비의 익셉셔널 강화를 초기화할 수 있는지 여부
+   */
+  get canResetExceptional(): boolean;
+  /**
+   * 장비의 익셉셔널 강화를 초기화합니다.
+   *
+   * @throws {@link GearError}
+   * 익셉셔널 강화를 초기화할 수 없는 경우.
+   */
+  resetExceptional(): void;
+}
+//#endregion
+//#region src/lib/enhance/addOption.d.ts
+/**
+ * 장비가 추가 옵션을 지원하는지 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function supportsAddOption(gear: ReadonlyGear): boolean;
+/**
+ * 장비에 추가 옵션을 적용할 수 있는 상태인지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function canApplyAddOption(gear: ReadonlyGear): boolean;
+/**
+ * 장비에 추가 옵션을 적용합니다.
+ * @param gear 적용할 장비.
+ * @param type 추가 옵션 종류.
+ * @param grade 추가 옵션 단계.
+ *
+ * @throws {@link GearError}
+ * 추가 옵션을 적용할 수 없는 상태의 장비일 경우.
+ *
+ * @throws {@link GearError}
+ * 장비에 부여할 수 없는 추가 옵션을 지정했을 경우.
+ */
+declare function applyAddOption(gear: Gear, type: AddOptionType, grade: AddOptionGrade): void;
+/**
+ * 추가 옵션을 초기화할 수 있는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 초기화할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function canResetAddOption(gear: ReadonlyGear): boolean;
+/**
+ * 장비의 추가 옵션을 초기화합니다.
+ * @param gear 초기화할 장비.
+ *
+ * @throws {@link GearError}
+ * 추가 옵션을 초기화할 수 없는 상태의 장비일 경우.
+ */
+declare function resetAddOption(gear: Gear): void;
+/**
+ * 장비에 적용되는 추가 옵션을 계산합니다.
+ * @param gear 추가옵션을 계산할 장비.
+ * @param type 추가 옵션 종류.
+ * @param grade 추가 옵션 단계.
+ * @returns 추가 옵션 종류 및 단계에 해당하는 옵션.
+ *
+ * @throws {@link GearError}
+ * 장비에 부여할 수 없는 추가 옵션을 지정했을 경우.
+ */
+declare function getAddOption(gear: ReadonlyGear, type: AddOptionType, grade: AddOptionGrade): Partial<GearAddOption>;
+/**
+ * 장비에 적용되는 추가 옵션 종류에 따른 값을 계산합니다.
+ * @param gear 추가옵션을 계산할 장비.
+ * @param type 추가 옵션 종류.
+ * @param grade 추가 옵션 단계.
+ * @returns 추가 옵션 값.
+ *
+ * @throws {@link GearError}
+ * 장비에 부여할 수 없는 추가 옵션을 지정했을 경우.
+ */
+declare function getAddOptionValue(gear: ReadonlyGear, type: AddOptionType, grade: AddOptionGrade): number;
+//#endregion
+//#region src/lib/enhance/soulSlot.d.ts
+/**
+ * 장비가 소울웨폰을 지원하는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 지원할 경우 `true`; 아닐 경우 `false`.
+ */
+declare function supportsSoul(gear: ReadonlyGear): boolean;
+/**
+ * 장비에 소울 인챈터를 적용할 수 있는 상태인지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function canApplySoulEnchant(gear: ReadonlyGear): boolean;
+/**
+ * 장비에 소울 인챈터를 적용합니다.
+ * @param gear 적용할 장비.
+ *
+ * @throws {@link GearError}
+ * 소울 인챈터를 적용할 수 없는 경우.
+ */
+declare function applySoulEnchant(gear: Gear): void;
+/**
+ * 장비에 소울을 장착할 수 있는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 장착할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function canSetSoul(gear: ReadonlyGear): boolean;
+/**
+ * 장비에 소울을 장착합니다.
+ * @param gear 대상 장비.
+ * @param soul 장착할 소울 아이템.
+ *
+ * @throws {@link GearError}
+ * 소울을 장착할 수 없는 경우.
+ */
+declare function setSoul(gear: Gear, soul: SoulData): void;
+/**
+ * 장비의 소울 충전량을 설정할 수 있는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 설정할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function canSetSoulCharge(gear: ReadonlyGear): boolean;
+/**
+ * 장비의 소울 충전량을 설정합니다.
+ * @param gear 대상 장비.
+ * @param charge 소울 충전량.
+ *
+ * @throws {@link GearError}
+ * 소울 충전량을 설정할 수 없는 경우.
+ *
+ * @throws {@link RangeError}
+ * 소울 충전량이 0 미만 또는 1000 초과인 경우.
+ */
+declare function setSoulCharge(gear: Gear, charge: number): void;
+/**
+ * 장비의 소울웨폰을 초기화합니다.
+ * @param gear 초기화할 장비.
+ */
+declare function resetSoulEnchant(gear: Gear): void;
+//#endregion
+//#region src/lib/enhance/starforce.d.ts
+/**
+ * 장비가 스타포스 강화를 지원하는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 지원할 경우 `true`; 아닐 경우 `false`.
+ */
+declare function supportsStarforce(gear: ReadonlyGear): boolean;
+/**
+ * 장비에 스타포스 강화를 적용할 수 있는 상태인지 여부를 확인합니다.
+ *
+ * 업그레이드가 완료되지 않은 장비, 놀라운 장비강화 주문서가 적용된 장비에도 적용할 수 있습니다.
+ * @param gear 확인할 장비.
+ * @param exceedMaxStar 장비의 최대 강화 단계를 초과하여 강화할 지 여부.
+ * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function canStarforce(gear: ReadonlyGear, exceedMaxStar?: boolean): boolean;
+/**
+ * 장비에 스타포스 강화를 1회 적용합니다.
+ *
+ * 업그레이드가 완료되지 않은 장비, 놀라운 장비강화 주문서가 적용된 장비에도 적용할 수 있습니다.
+ * @param gear 적용할 장비.
+ * @param exceedMaxStar 장비의 최대 강화 단계를 초과하여 강화할 지 여부.
+ *
+ * @throws {@link GearError}
+ * 스타포스 강화를 적용할 수 없는 경우.
+ */
+declare function starforce(gear: Gear, exceedMaxStar?: boolean): void;
+/**
+ * 장비에 놀라운 장비 강화 주문서를 적용할 수 있는 상태인지 여부를 확인합니다.
+ *
+ * 착용 가능 레벨 150 이하의 장비에만 적용할 수 있습니다.
+ * 업그레이드가 완료되지 않은 장비, 놀라운 장비강화 주문서가 적용된 장비에도 적용할 수 있습니다.
+ * 슈페리얼 장비에는 적용할 수 없습니다.
+ * @param gear 확인할 장비.
+ * @param exceedMaxStar 장비의 최대 강화 단계를 초과하여 강화할 지 여부.
+ * @returns 적용할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function canStarScroll(gear: ReadonlyGear, exceedMaxStar?: boolean): boolean;
+/**
+ * 장비에 놀라운 장비 강화 주문서를 1회 적용합니다.
+ *
+ * 착용 가능 레벨 150 이하의 장비에만 적용할 수 있습니다.
+ * 업그레이드가 완료되지 않은 장비, 스타포스 강화가 적용된 장비에도 적용할 수 있습니다.
+ * 슈페리얼 장비에는 적용할 수 없습니다.
+ *
+ * 보너스 스탯은 장비 분류에 따라 결정됩니다.
+ * - 방어구(방패 제외): 최대 HP +50
+ * - 장신구: 올스탯 +1 ~ +2
+ * - 무기/블레이드/방패: 공격력/마력 +1
+ * @param gear 적용할 장비.
+ * @param bonus 보너스 스탯 적용 여부.
+ * @param exceedMaxStar 장비의 최대 강화 단계를 초과하여 강화할 지 여부.
+ *
+ * @throws {@link GearError}
+ * 놀라운 장비 강화 주문서를 적용할 수 없는 경우.
+ */
+declare function starScroll(gear: Gear, bonus?: boolean, exceedMaxStar?: boolean): void;
+/**
+ * 장비의 스타포스 강화를 초기화할 수 있는지 여부를 확인합니다.
+ * @param gear 확인할 장비.
+ * @returns 초기화할 수 있을 경우 `true`; 아닐 경우 `false`.
+ */
+declare function canResetStarforce(gear: ReadonlyGear): boolean;
+/**
+ * 장비의 스타포스 강화를 초기화합니다.
+ * @param gear 초기화할 장비.
+ *
+ * @throws {@link GearError}
+ * 스타포스 강화를 초기화할 수 없는 장비일 경우.
+ */
+declare function resetStarforce(gear: Gear): void;
+/**
+ * 장비의 최대 스타포스 강화를 계산합니다.
+ *
+ * 놀라운 장비 강화 주문서가 사용되었을 경우 최대 `15`입니다.
+ * @param gear 계산할 장비.
+ * @returns 장비의 최대 스타포스 강화.
+ */
+declare function getMaxStar(gear: ReadonlyGear): number;
+/**
+ * exceedMaxStar가 true일 경우의 최대 스타포스 강화를 계산합니다.
+ * 장비 강화 주문서 및 언리미티드 아이템을 토드하는 경우를 고려합니다.
+ *
+ * 놀라운 장비 강화 주문서가 사용되었을 경우 최대 `15`입니다.
+ * @param gear 계산할 장비.
+ * @returns exceedMaxStar가 true일 경우의 최대 스타포스 강화.
+ */
+declare function getHardMaxStar(gear: ReadonlyGear): number;
+//#endregion
+//#region src/lib/manage/migrate.d.ts
+/**
+ * 입력 장비 정보를 목표 버전으로 마이그레이션합니다.
+ * 이 함수가 성공한 이후에는 입력 장비 정보 객체를 사용할 수 없습니다.
+ *
+ * @param data 마이그레이션할 장비 정보.
+ * @param version 목표 버전.
+ * @returns 목표 버전으로 마이그레이션된 장비 정보.
+ *
+ * @throws {@link TypeError}
+ * 입력 데이터가 유효하지 않은 경우.
+ * 입력 데이터의 버전이 잘못되었거나 지원하는 버전보다 최신인 경우.
+ */
+declare function migrate(data: object, version?: number): object;
+//#endregion
+//#region src/lib/gearOption.d.ts
+/**
+ * 장비 옵션의 설정되지 않은 속성(`undefined`)을 `0`으로 처리하는 프록시 객체를 생성합니다.
+ *
+ * 프록시 객체를 반복할 때 값이 `0`인 속성은 열거하지 않습니다.
+ * @param option 장비 옵션.
+ * @returns 장비 옵션 프록시.
+ */
+declare function toGearOption(option: Partial<GearOption>): GearOption;
+//#endregion
+//#region src/lib/gearType.d.ts
+/**
+ * 장비 분류가 주무기인지 여부를 확인합니다. 블레이드(`katara`)는 포함되지 않습니다.
+ * @param type 장비 분류.
+ * @returns 주무기일 경우 `true`; 아닐 경우 `false`.
+ */
+declare function isWeapon(type: GearType): boolean;
+/**
+ * 장비 분류가 한손무기인지 여부를 확인합니다. 블레이드(`katara`)는 포함되지 않습니다.
+ * @param type 장비 분류.
+ * @returns 한손무기일 경우 `true`; 아닐 경우 `false`.
+ */
+declare function isLeftWeapon(type: GearType): boolean;
+/**
+ * 장비 분류가 두손무기인지 여부를 확인합니다.
+ * @param type 장비 분류.
+ * @returns 두손무기일 경우 `true`; 아닐 경우 `false`.
+ */
+declare function isDoubleHandWeapon(type: GearType): boolean;
+/**
+ * 장비 분류가 보조무기인지 여부를 확인합니다. 블레이드(`katara`), 방패류가 포함됩니다.
+ * @param type 장비 분류.
+ * @returns 보조무기일 경우 `true`; 아닐 경우 `false`.
+ */
+declare function isSubWeapon(type: GearType): boolean;
+/**
+ * 장비 분류가 방패인지 여부를 확인합니다.
+ * @param type 장비 분류.
+ * @returns 방패일 경우 `true`; 아닐 경우 `false`.
+ */
+declare function isShield(type: GearType): boolean;
+/**
+ * 장비 분류가 방어구인지 여부를 확인합니다. 어깨장식이 포함되지 않고 방패가 포함됩니다.
+ * @param type 장비 분류.
+ * @returns 방어구일 경우 `true`; 아닐 경우 `false`.
+ */
+declare function isArmor(type: GearType): boolean;
+/**
+ * 장비 분류가 장신구인지 여부를 확인합니다. 어깨장식이 포함됩니다.
+ * @param type 장비 분류.
+ * @returns 장신구일 경우 `true`; 아닐 경우 `false`.
+ */
+declare function isAccessory(type: GearType): boolean;
+/**
+ * 장비 분류가 메카닉 장비인지 여부를 확인합니다.
+ * @param type 장비 분류.
+ * @returns 메카닉 장비일 경우 `true`; 아닐 경우 `false`.
+ */
+declare function isMechanicGear(type: GearType): boolean;
+/**
+ * 장비 분류가 에반 드래곤 장비인지 여부를 확인합니다.
+ * @param type 장비 분류.
+ * @returns 에반 드래곤 장비일 경우 `true`; 아닐 경우 `false`.
+ */
+declare function isDragonGear(type: GearType): boolean;
+//#endregion
+export { type AddOptionData, type AddOptionGrade, AddOptionType, type ExceptionalHammer, Gear, type GearAddOption, GearAttribute, type GearAttributeData, type GearBaseOption, GearCapability, GearCuttable, type GearData, type GearExceptionalOption, GearGender, type GearIncline, type GearOption, GearReq, type GearReqData, type GearShapeData, GearShare, type GearStarforceOption, GearTrade, GearType, type GearUpgradeOption, type PotentialData, PotentialGrade, type PotentialOption, ReadonlyGear, type ReadonlyPotential, type ReadonlySoulData, type Scroll, type SoulChargeOption, type SoulData, type SoulOption, type SoulSlotData, type SpellTrace, type SpellTraceRate, SpellTraceType, applyAddOption, applyExceptional, applyScroll, applySoulEnchant, applySpellTrace, canApplyAddOption, canApplyExceptional, canApplyScroll, canApplySoulEnchant, canFailScroll, canResetAddOption, canResetExceptional, canResetStarforce, canResetUpgrade, canResileScroll, canSetAdditionalPotential, canSetPotential, canSetSoul, canSetSoulCharge, canStarScroll, canStarforce, failScroll, getAddOption, getAddOptionValue, getHardMaxStar, getMaxStar, getSpellTraceScroll, isAccessory, isArmor, isDoubleHandWeapon, isDragonGear, isLeftWeapon, isMechanicGear, isShield, isSubWeapon, isWeapon, migrate, resetAddOption, resetAdditionalPotential, resetExceptional, resetPotential, resetSoulEnchant, resetStarforce, resetUpgrade, resileScroll, setAdditionalPotential, setPotential, setSoul, setSoulCharge, starScroll, starforce, supportsAddOption, supportsAdditionalPotential, supportsExceptional, supportsPotential, supportsSoul, supportsStarforce, supportsUpgrade, toGearOption };