@malib/gear 1.0.0 → 1.2.0

package/dist/index.d.mts

@@ -538,13 +538,13 @@ 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;
+declare const VERSION$1 = 3;
 /**
  * 장비 정보
  */
 interface GearData {
   /** 장비 정보 버전 */
-  version: typeof VERSION;
+  version: typeof VERSION$1;
   /** 아이템 ID */
   id: number;
   /** 장비명 */
@@ -617,13 +617,32 @@ interface GearReqData {
   level?: number;
   /** 착용 가능 레벨 증가 */
   levelIncrease?: number;
-  /** 착용 가능 직업 분류 */
-  job?: number;
-  /** 착용 가능 직업 */
-  class?: number[];
+  /** 착용 가능 직업 정보 */
+  job?: GearReqJobData;
   /** 착용 가능 성별 */
   gender?: GearGender;
 }
+/**
+ * 장비 착용 가능 직업 정보
+ */
+interface GearReqJobData {
+  /**
+   * 착용 가능 전직 계열 비트마스크 (전사, 마법사, 궁수, 도적, 해적)
+   */
+  class?: number;
+  /**
+   * 착용 가능 직업 코드 목록
+   *
+   * 차수 무관한 직업 코드 목록입니다.
+   */
+  jobs?: number[];
+  /**
+   * 착용 가능 세부 직업 코드 목록
+   *
+   * 차수를 고려한 직업 코드 목록입니다.
+   */
+  fullJobs?: number[];
+}
 /**
  * 착용 가능 성별
  */
@@ -827,20 +846,45 @@ declare class GearReq implements GearReqData {
    * 착용 가능 레벨 증가
    */
   get levelIncrease(): number;
-  /**
-   * 착용 가능 직업 분류
-   * */
-  get job(): number;
   /**
    * 착용 가능 직업
    */
-  get class(): number[];
+  get job(): GearReqJob;
   /**
    * 착용 가능 성별
    */
   get gender(): GearGender | undefined;
+}
+/**
+ * 장비 착용 제한 직업
+ */
+declare class GearReqJob implements GearReqJobData {
+  /**
+   * 장비 착용 제한 직업 정보
+   */
+  data: GearReqJobData;
+  /**
+   * 장비 착용 제한 직업 정보를 참조하는 장비 착용 제한 직업 인스턴스를 생성합니다.
+   */
+  constructor(data: GearReqJobData);
+  /**
+   * 착용 가능 전직 계열 비트마스크 (전사, 마법사, 궁수, 도적, 해적)
+   */
+  get class(): number;
+  /**
+   * 착용 가능 직업 코드 목록
+   *
+   * 차수 무관한 직업 코드 목록입니다.
+   */
+  get jobs(): number[];
   /**
-   * 초보자 및 전 직업 착용 가능 여부를 계산합니다.
+   * 착용 가능 세부 직업 코드 목록
+   *
+   * 차수를 고려한 직업 코드 목록입니다.
+   */
+  get fullJobs(): number[];
+  /**
+   * 초보자 착용 가능 여부를 계산합니다.
    * @returns 착용할 수 있을 경우 `true`; 아닐 경우 `false`.
    */
   beginner(): boolean;
@@ -903,7 +947,7 @@ declare class ReadonlyGear implements _Gear {
   /**
    * 장비 정보 버전
    */
-  get version(): typeof VERSION;
+  get version(): typeof VERSION$1;
   /**
    * 장비 ID
    */
@@ -1779,6 +1823,1282 @@ declare function getMaxStar(gear: ReadonlyGear): number;
  */
 declare function getHardMaxStar(gear: ReadonlyGear): number;
 //#endregion
+//#region ../../node_modules/.pnpm/@malib+gear@1.0.0-next.10/node_modules/@malib/gear/dist/_tsup-dts-rollup.d.ts
+/**
+ * 추가 옵션 정보
+ */
+declare interface AddOptionData$2 {
+  /** 추가 옵션 종류 */
+  type: AddOptionType$2;
+  /** 추가 옵션 단계 */
+  grade: AddOptionGrade$2;
+  /** 추가 옵션 수치 */
+  value: number;
+}
+/**
+ * 추가 옵션 단계
+ */
+declare type AddOptionGrade$2 = 1 | 2 | 3 | 4 | 5 | 6 | 7;
+/**
+ * 추가 옵션 종류
+ */
+declare enum AddOptionType$2 {
+  /** 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"
+}
+/**
+ * 장비 추가 옵션
+ */
+declare type GearAddOption$2 = Pick<GearBaseOption$2, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump' | 'bossDamage' | 'allStat' | 'damage' | 'reqLevelDecrease'>;
+/**
+ * 장비 속성 정보
+ */
+declare interface GearAttributeData$2 {
+  /** 고유 아이템 */
+  only?: boolean;
+  /** 교환 가능 여부 */
+  trade?: GearTrade$2;
+  /** 고유장착 아이템 */
+  onlyEquip?: boolean;
+  /** 월드 내 나의 캐릭터 간 이동 가능 여부 */
+  share?: GearShare$2;
+  /** 슈페리얼 */
+  superior?: boolean;
+  /** 공격 속도 */
+  attackSpeed?: number;
+  /** 주문서 강화 가능 여부 */
+  canScroll?: GearCapability$2;
+  /** 스타포스 강화 가능 여부 */
+  canStarforce?: GearCapability$2;
+  /** 추가 옵션 설정 가능 여부 */
+  canAddOption?: GearCapability$2;
+  /** 잠재능력 설정 가능 여부 */
+  canPotential?: GearCapability$2;
+  /** 에디셔널 잠재능력 설정 가능 여부 */
+  canAdditionalPotential?: GearCapability$2;
+  /** 스페셜 아이템 여부 */
+  specialGrade?: boolean;
+  /** 카르마의 가위 사용 가능 여부 */
+  cuttable?: GearCuttable$2;
+  /** 가위 사용 가능 횟수 */
+  cuttableCount?: number;
+  /** 최대 가위 사용 가능 횟수 */
+  totalCuttableCount?: number;
+  /** 쉐어 네임 텍을 사용 가능 여부 */
+  accountShareTag?: boolean;
+  /** 훈장 신비의 모루 사용 불가 여부 */
+  noShapeChange?: boolean;
+  /** 세트 효과 ID */
+  setItemId?: number;
+  /** 럭키 아이템 */
+  lucky?: boolean;
+  /** 장착 시 획득 경험치 */
+  incline?: Partial<GearIncline$2>;
+  /** 보스 드롭 여부 */
+  bossReward?: boolean;
+  /** 사용 가능 스킬 */
+  skills?: string[];
+  /** 성장 경험치 */
+  growthExp?: number;
+  /** 성장 레벨 */
+  growthLevel?: number;
+  /** 장비 유효 기간(KST) */
+  dateExpire?: string;
+}
+/**
+ * 장비 기본 옵션
+ */
+declare type GearBaseOption$2 = Pick<GearOption$2, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'maxHpRate' | 'maxMpRate' | 'maxDemonForce' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump' | 'bossDamage' | 'ignoreMonsterArmor' | 'allStat' | 'damage' | 'reqLevelDecrease'>;
+declare enum GearCapability$2 {
+  /** 설정 불가 */
+  Cannot = 0,
+  /** 설정 가능 */
+  Can = 1,
+  /** 재설정 불가 */
+  Fixed = 2
+}
+declare enum GearCuttable$2 {
+  /** 없음 */
+  None = 0,
+  /** 카르마의 가위 또는 실버 카르마의 가위를 사용하면 1회 교환이 가능하게 할 수 있습니다. */
+  Silver = 1,
+  /** 플래티넘 카르마의 가위를 사용하면 1회 교환이 가능하게 할 수 있습니다. */
+  Platinum = 2
+}
+/**
+ * 장비 정보
+ */
+declare interface GearData$2 {
+  /** 장비 메타데이터 */
+  meta: GearMetadata;
+  /** 장비명 */
+  name: string;
+  /** 장비 아이콘 */
+  icon?: string;
+  /** 장비 설명 */
+  desc?: string;
+  /** 장비 외형 */
+  shape?: GearShapeData$2;
+  /** 장비 분류 */
+  type: GearType$2;
+  /** 장비 착용 제한 */
+  req: GearReqData$2;
+  /** 장비 속성 */
+  attributes: GearAttributeData$2;
+  /** 장비 기본 옵션 */
+  baseOption?: Partial<GearBaseOption$2>;
+  /** 장비 추가 옵션 */
+  addOption?: Partial<GearAddOption$2>;
+  /** 장비 주문서 강화 옵션 */
+  upgradeOption?: Partial<GearUpgradeOption$2>;
+  /** 장비 스타포스 옵션 */
+  starforceOption?: Partial<GearStarforceOption$2>;
+  /** 추가 옵션 목록 */
+  addOptions?: AddOptionData$2[];
+  /** 업그레이드 횟수 */
+  scrollUpgradeCount?: number;
+  /** 복구 가능 횟수 */
+  scrollResilienceCount?: number;
+  /** 업그레이드 가능 횟수 */
+  scrollUpgradeableCount?: number;
+  /** 강화 단계 */
+  star?: number;
+  /** 놀라운 장비 강화 주문서 사용 여부 */
+  starScroll?: boolean;
+  /** 소울 웨폰 정보 */
+  soulSlot?: SoulSlotData$2;
+  /** 잠재능력 등급 */
+  potentialGrade?: PotentialGrade$2;
+  /** 잠재능력 목록 */
+  potentials?: PotentialData$2[];
+  /** 에디셔널 잠재능력 등급 */
+  additionalPotentialGrade?: PotentialGrade$2;
+  /** 에디셔널 잠재능력 목록 */
+  additionalPotentials?: PotentialData$2[];
+  /** 장비 익셉셔널 옵션 */
+  exceptionalOption?: Partial<GearExceptionalOption$2>;
+  /** 익셉셔널 강화 횟수 */
+  exceptionalUpgradeCount?: number;
+  /** 익셉셔널 강화 가능 횟수 */
+  exceptionalUpgradeableCount?: number;
+}
+/**
+ * 장비 익셉셔널 옵션
+ */
+declare type GearExceptionalOption$2 = Pick<GearBaseOption$2, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'attackPower' | 'magicPower'>;
+/**
+ * 착용 가능 성별
+ */
+declare enum GearGender$2 {
+  /** 남 */
+  Male = 0,
+  /** 여 */
+  Female = 1
+}
+declare interface GearIncline$2 {
+  /** 카리스마 */
+  charisma: number;
+  /** 통찰력 */
+  insight: number;
+  /** 의지 */
+  will: number;
+  /** 손재주 */
+  craft: number;
+  /** 감성 */
+  sense: number;
+  /** 매력 */
+  charm: number;
+}
+/**
+ * 장비 메타데이터
+ *
+ * 사용자는 메타데이터에 커스텀 속성을 추가할 수 있습니다.
+ * 커스텀 속성은 해당 라이브러리가 임의로 변경하지 않습니다.
+ * 충돌을 방지하기 위해 커스텀 속성명은 하나의 `_`으로 시작해야 합니다.
+ */
+declare interface GearMetadata {
+  /** 아이템 ID */
+  id: number;
+  /** 장비 정보 버전 */
+  version: 1;
+}
+/**
+ * 장비 옵션
+ */
+declare interface GearOption$2 {
+  /** 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;
+}
+/**
+ * 장비 착용 제한 정보
+ */
+declare interface GearReqData$2 {
+  /** 착용 가능 레벨 */
+  level?: number;
+  /** 착용 가능 레벨 증가 */
+  levelIncrease?: number;
+  /** 착용 가능 직업 분류 */
+  job?: number;
+  /** 착용 가능 직업 */
+  class?: number;
+  /** 착용 가능 성별 */
+  gender?: GearGender$2;
+}
+/**
+ * 장비 외형 정보
+ */
+declare interface GearShapeData$2 {
+  /** 장비 외형 이름 */
+  name: string;
+  /** 장비 외형 아이콘 */
+  icon: string;
+}
+declare enum GearShare$2 {
+  /** 없음 */
+  None = 0,
+  /** 월드 내 나의 캐릭터 간 이동 가능 */
+  AccountSharable = 1,
+  /** 월드 내 나의 캐릭터 간 1회 이동 가능 (이동 후 교환불가) */
+  AccountSharableOnce = 2
+}
+/**
+ * 장비 스타포스 옵션
+ */
+declare type GearStarforceOption$2 = Pick<GearBaseOption$2, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump'>;
+declare enum GearTrade$2 {
+  /** 교환 가능 */
+  Tradeable = 0,
+  /** 교환 불가 */
+  TradeBlock = 1,
+  /** 장착 시 교환 불가 */
+  EquipTradeBlock = 2,
+  /** 1회 교환 가능 */
+  TradeOnce = 3
+}
+declare enum GearType$2 {
+  /** 모자 */
+  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,
+  /** 드래곤 모자 */
+  dragonMask = 194,
+  /** 드래곤 펜던트 */
+  dragonPendant = 195,
+  /** 드래곤 날개장식 */
+  dragonWings = 196,
+  /** 드래곤 꼬리장식 */
+  dragonTail = 197
+}
+/**
+ * 장비 주문서 옵션
+ */
+declare type GearUpgradeOption$2 = Pick<GearBaseOption$2, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump'>;
+/**
+ * 잠재옵션 정보
+ */
+declare interface PotentialData$2 {
+  /** 잠재능력 ID */
+  id?: number;
+  /** 잠재능력 등급 */
+  grade: PotentialGrade$2;
+  /** 장비에 표시되는 이름 */
+  summary: string;
+  /** 잠재능력 옵션 */
+  option: Partial<PotentialOption$2>;
+}
+declare enum PotentialGrade$2 {
+  Normal = 0,
+  Rare = 1,
+  Epic = 2,
+  Unique = 3,
+  Legendary = 4
+}
+declare type PotentialOption$2 = Pick<GearOption$2, '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'>;
+/**
+ * 소울 충전 옵션
+ */
+declare type SoulChargeOption$2 = Pick<GearOption$2, 'attackPower' | 'magicPower'>;
+/**
+ * 소울 정보
+ */
+declare interface SoulData$2 {
+  /** 소울 명 */
+  name: string;
+  /** 소울 스킬 명 */
+  skill: string;
+  /** 소울 옵션 */
+  option: Partial<SoulOption$2>;
+  /** 소울 충전 옵션 배율 */
+  chargeFactor?: 1 | 2;
+}
+/**
+ * 소울 옵션
+ */
+declare type SoulOption$2 = Pick<GearOption$2, 'str' | 'dex' | 'int' | 'luk' | 'strRate' | 'dexRate' | 'intRate' | 'lukRate' | 'attackPower' | 'magicPower' | 'attackPowerRate' | 'magicPowerRate' | 'maxHp' | 'maxMp' | 'criticalRate' | 'ignoreMonsterArmor' | 'bossDamage'>;
+/**
+ * 소울 웨폰 정보
+ */
+declare interface SoulSlotData$2 {
+  /** 소울 아이템 */
+  soul?: SoulData$2;
+  /** 소울 충전량 */
+  charge?: number;
+  /** 소울 충전 옵션 */
+  chargeOption?: Partial<SoulChargeOption$2>;
+}
+//#endregion
+//#region ../../node_modules/.pnpm/@malib+gear@1.0.0-next.15/node_modules/@malib/gear/dist/_tsup-dts-rollup.d.ts
+/**
+ * 추가 옵션 정보
+ */
+declare interface AddOptionData$1 {
+  /** 추가 옵션 종류 */
+  type: AddOptionType$1;
+  /** 추가 옵션 단계 */
+  grade: AddOptionGrade$1;
+  /** 추가 옵션 수치 */
+  value: number;
+}
+/**
+ * 추가 옵션 단계
+ */
+declare type AddOptionGrade$1 = 1 | 2 | 3 | 4 | 5 | 6 | 7;
+/**
+ * 추가 옵션 종류
+ */
+declare enum AddOptionType$1 {
+  /** 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"
+}
+/**
+ * 장비 추가 옵션
+ */
+declare type GearAddOption$1 = Pick<GearBaseOption$1, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump' | 'bossDamage' | 'allStat' | 'damage' | 'reqLevelDecrease'>;
+/**
+ * 장비 속성 정보
+ */
+declare interface GearAttributeData$1 {
+  /** 고유 아이템 */
+  only?: boolean;
+  /** 교환 가능 여부 */
+  trade?: GearTrade$1;
+  /** 고유장착 아이템 */
+  onlyEquip?: boolean;
+  /** 월드 내 나의 캐릭터 간 이동 가능 여부 */
+  share?: GearShare$1;
+  /** 슈페리얼 */
+  superior?: boolean;
+  /** 공격 속도 */
+  attackSpeed?: number;
+  /** 주문서 강화 가능 여부 */
+  canScroll?: GearCapability$1;
+  /** 스타포스 강화 가능 여부 */
+  canStarforce?: GearCapability$1;
+  /** 추가 옵션 설정 가능 여부 */
+  canAddOption?: GearCapability$1;
+  /** 잠재능력 설정 가능 여부 */
+  canPotential?: GearCapability$1;
+  /** 에디셔널 잠재능력 설정 가능 여부 */
+  canAdditionalPotential?: GearCapability$1;
+  /** 스페셜 아이템 여부 */
+  specialGrade?: boolean;
+  /** 최대 스타포스 강화 단계 */
+  fixedMaxStar?: number;
+  /** 카르마의 가위 사용 가능 여부 */
+  cuttable?: GearCuttable$1;
+  /** 가위 사용 가능 횟수 */
+  cuttableCount?: number;
+  /** 최대 가위 사용 가능 횟수 */
+  totalCuttableCount?: number;
+  /** 쉐어 네임 텍을 사용 가능 여부 */
+  accountShareTag?: boolean;
+  /** 훈장 신비의 모루 사용 불가 여부 */
+  noShapeChange?: boolean;
+  /** 세트 효과 ID */
+  setItemId?: number;
+  /** 럭키 아이템 */
+  lucky?: boolean;
+  /** 장착 시 획득 경험치 */
+  incline?: Partial<GearIncline$1>;
+  /** 보스 드롭 여부 */
+  bossReward?: boolean;
+  /** 사용 가능 스킬 */
+  skills?: string[];
+  /** 성장 경험치 */
+  growthExp?: number;
+  /** 성장 레벨 */
+  growthLevel?: number;
+  /** 장비 유효 기간(KST) */
+  dateExpire?: string;
+}
+/**
+ * 장비 기본 옵션
+ */
+declare type GearBaseOption$1 = Pick<GearOption$1, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'maxHpRate' | 'maxMpRate' | 'maxDemonForce' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump' | 'bossDamage' | 'ignoreMonsterArmor' | 'allStat' | 'damage' | 'reqLevelDecrease'>;
+declare enum GearCapability$1 {
+  /** 설정 불가 */
+  Cannot = 0,
+  /** 설정 가능 */
+  Can = 1,
+  /** 재설정 불가 */
+  Fixed = 2
+}
+declare enum GearCuttable$1 {
+  /** 없음 */
+  None = 0,
+  /** 카르마의 가위 또는 실버 카르마의 가위를 사용하면 1회 교환이 가능하게 할 수 있습니다. */
+  Silver = 1,
+  /** 플래티넘 카르마의 가위를 사용하면 1회 교환이 가능하게 할 수 있습니다. */
+  Platinum = 2
+}
+/**
+ * 장비 정보
+ */
+declare interface GearData$1 {
+  /** 장비 정보 버전 */
+  version: typeof VERSION;
+  /** 아이템 ID */
+  id: number;
+  /** 장비명 */
+  name: string;
+  /** 장비 설명 */
+  desc?: string;
+  /** 장비 아이콘 */
+  icon: string;
+  /** 장비 외형 */
+  shape?: GearShapeData$1;
+  /** 이름 새기기 */
+  itemTag?: string;
+  /** 장비 분류 */
+  type: GearType$1;
+  /** 장비 착용 제한 */
+  req: GearReqData$1;
+  /** 장비 속성 */
+  attributes: GearAttributeData$1;
+  /** 장비 기본 옵션 */
+  baseOption?: Partial<GearBaseOption$1>;
+  /** 장비 추가 옵션 */
+  addOption?: Partial<GearAddOption$1>;
+  /** 장비 주문서 강화 옵션 */
+  upgradeOption?: Partial<GearUpgradeOption$1>;
+  /** 장비 스타포스 옵션 */
+  starforceOption?: Partial<GearStarforceOption$1>;
+  /** 추가 옵션 목록 */
+  addOptions?: AddOptionData$1[];
+  /** 업그레이드 횟수 */
+  scrollUpgradeCount?: number;
+  /** 복구 가능 횟수 */
+  scrollResilienceCount?: number;
+  /** 업그레이드 가능 횟수 */
+  scrollUpgradeableCount?: number;
+  /** 강화 단계 */
+  star?: number;
+  /** 놀라운 장비 강화 주문서 사용 여부 */
+  starScroll?: boolean;
+  /** 소울 웨폰 정보 */
+  soulSlot?: SoulSlotData$1;
+  /** 잠재능력 등급 */
+  potentialGrade?: PotentialGrade$1;
+  /** 잠재능력 목록 */
+  potentials?: PotentialData$1[];
+  /** 에디셔널 잠재능력 등급 */
+  additionalPotentialGrade?: PotentialGrade$1;
+  /** 에디셔널 잠재능력 목록 */
+  additionalPotentials?: PotentialData$1[];
+  /** 장비 익셉셔널 옵션 */
+  exceptionalOption?: Partial<GearExceptionalOption$1>;
+  /** 익셉셔널 강화 횟수 */
+  exceptionalUpgradeCount?: number;
+  /** 익셉셔널 강화 가능 횟수 */
+  exceptionalUpgradeableCount?: number;
+}
+/**
+ * 장비 익셉셔널 옵션
+ */
+declare type GearExceptionalOption$1 = Pick<GearBaseOption$1, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'attackPower' | 'magicPower'>;
+/**
+ * 착용 가능 성별
+ */
+declare enum GearGender$1 {
+  /** 남 */
+  Male = 0,
+  /** 여 */
+  Female = 1
+}
+declare interface GearIncline$1 {
+  /** 카리스마 */
+  charisma: number;
+  /** 통찰력 */
+  insight: number;
+  /** 의지 */
+  will: number;
+  /** 손재주 */
+  craft: number;
+  /** 감성 */
+  sense: number;
+  /** 매력 */
+  charm: number;
+}
+/**
+ * 장비 옵션
+ */
+declare interface GearOption$1 {
+  /** 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;
+}
+/**
+ * 장비 착용 제한 정보
+ */
+declare interface GearReqData$1 {
+  /** 착용 가능 레벨 */
+  level?: number;
+  /** 착용 가능 레벨 증가 */
+  levelIncrease?: number;
+  /** 착용 가능 직업 분류 */
+  job?: number;
+  /** 착용 가능 직업 */
+  class?: number;
+  /** 착용 가능 성별 */
+  gender?: GearGender$1;
+}
+/**
+ * 장비 외형 정보
+ */
+declare interface GearShapeData$1 {
+  /** 장비 외형 이름 */
+  name: string;
+  /** 장비 외형 아이콘 */
+  icon: string;
+}
+declare enum GearShare$1 {
+  /** 없음 */
+  None = 0,
+  /** 월드 내 나의 캐릭터 간 이동 가능 */
+  AccountSharable = 1,
+  /** 월드 내 나의 캐릭터 간 1회 이동 가능 (이동 후 교환불가) */
+  AccountSharableOnce = 2
+}
+/**
+ * 장비 스타포스 옵션
+ */
+declare type GearStarforceOption$1 = Pick<GearBaseOption$1, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump'>;
+declare enum GearTrade$1 {
+  /** 교환 가능 */
+  Tradeable = 0,
+  /** 교환 불가 */
+  TradeBlock = 1,
+  /** 장착 시 교환 불가 */
+  EquipTradeBlock = 2,
+  /** 1회 교환 가능 */
+  TradeOnce = 3
+}
+declare enum GearType$1 {
+  /** 모자 */
+  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
+}
+/**
+ * 장비 주문서 옵션
+ */
+declare type GearUpgradeOption$1 = Pick<GearBaseOption$1, 'str' | 'dex' | 'int' | 'luk' | 'maxHp' | 'maxMp' | 'attackPower' | 'magicPower' | 'armor' | 'speed' | 'jump'>;
+/**
+ * 잠재옵션 정보
+ */
+declare interface PotentialData$1 {
+  /** 잠재능력 ID */
+  id?: number;
+  /** 잠재능력 등급 */
+  grade: PotentialGrade$1;
+  /** 장비에 표시되는 이름 */
+  summary: string;
+  /** 잠재능력 옵션 */
+  option: Partial<PotentialOption$1>;
+}
+declare enum PotentialGrade$1 {
+  Normal = 0,
+  Rare = 1,
+  Epic = 2,
+  Unique = 3,
+  Legendary = 4
+}
+declare type PotentialOption$1 = Pick<GearOption$1, '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'>;
+/**
+ * 소울 충전 옵션
+ */
+declare type SoulChargeOption$1 = Pick<GearOption$1, 'attackPower' | 'magicPower'>;
+/**
+ * 소울 정보
+ */
+declare interface SoulData$1 {
+  /** 소울 명 */
+  name: string;
+  /** 소울 스킬 명 */
+  skill: string;
+  /** 소울 옵션 */
+  option: Partial<SoulOption$1>;
+  /** 소울 충전 옵션 배율 */
+  chargeFactor?: 1 | 2;
+}
+/**
+ * 소울 옵션
+ */
+declare type SoulOption$1 = Pick<GearOption$1, 'str' | 'dex' | 'int' | 'luk' | 'strRate' | 'dexRate' | 'intRate' | 'lukRate' | 'attackPower' | 'magicPower' | 'attackPowerRate' | 'magicPowerRate' | 'maxHp' | 'maxMp' | 'criticalRate' | 'ignoreMonsterArmor' | 'bossDamage'>;
+/**
+ * 소울 웨폰 정보
+ */
+declare interface SoulSlotData$1 {
+  /** 소울 아이템 */
+  soul?: SoulData$1;
+  /** 소울 충전량 */
+  charge?: number;
+  /** 소울 충전 옵션 */
+  chargeOption?: Partial<SoulChargeOption$1>;
+}
+declare const VERSION = 2;
+//#endregion
 //#region src/lib/manage/migrate.d.ts
 /**
  * 입력 장비 정보를 목표 버전으로 마이그레이션합니다.
@@ -1792,7 +3112,15 @@ declare function getHardMaxStar(gear: ReadonlyGear): number;
  * 입력 데이터가 유효하지 않은 경우.
  * 입력 데이터의 버전이 잘못되었거나 지원하는 버전보다 최신인 경우.
  */
-declare function migrate(data: object, version?: number): object;
+declare function migrate(data: GearData$2): GearData;
+declare function migrate(data: GearData$2, version: 1): GearData$2;
+declare function migrate(data: GearData$2, version: 2): GearData$1;
+declare function migrate(data: GearData$2, version: 3): GearData;
+declare function migrate(data: GearData$1): GearData;
+declare function migrate(data: GearData$1, version: 2): GearData$1;
+declare function migrate(data: GearData$1, version: 3): GearData;
+declare function migrate(data: GearData): GearData;
+declare function migrate(data: GearData, version: 3): GearData;
 //#endregion
 //#region src/lib/gearOption.d.ts
 /**