@malib/gear 0.0.1

package/lib/geartype.d.ts

@@ -0,0 +1,441 @@
+/**
+ * 장비 분류
+ */
+export 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,
+    /**
+     * 소울 슈터
+     */
+    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,
+    /**
+     * 펫장비
+     */
+    petEquip = 180,
+    /**
+     * 메카닉 엔진
+     */
+    machineEngine = 161,
+    /**
+     * 메카닉 암
+     */
+    machineArms = 162,
+    /**
+     * 메카닉 레그
+     */
+    machineLegs = 163,
+    /**
+     * 메카닉 프레임
+     */
+    machineBody = 164,
+    /**
+     * 메카닉 트렌지스터
+     */
+    machineTransistors = 165,
+    /**
+     * 드래곤 모자
+     */
+    dragonMask = 194,
+    /**
+     * 드래곤 펜던트
+     */
+    dragonPendant = 195,
+    /**
+     * 드래곤 날개장식
+     */
+    dragonWings = 196,
+    /**
+     * 드래곤 꼬리장식
+     */
+    dragonTail = 197
+}

package/lib/logic/bonusstat.d.ts

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

package/lib/logic/bonusstattype.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 보너스 스탯 종류
+ */
+export declare enum BonusStatType {
+    /** STR 단일 */
+    STR = 0,
+    /** DEX 단일 */
+    DEX = 1,
+    /** INT 단일 */
+    INT = 2,
+    /** LUK 단일 */
+    LUK = 3,
+    /** STR, DEX 이중 */
+    STR_DEX = 4,
+    /** STR, INT 이중 */
+    STR_INT = 5,
+    /** STR, LUK 이중 */
+    STR_LUK = 6,
+    /** DEX, INT 이중 */
+    DEX_INT = 7,
+    /** DEX, LUK 이중 */
+    DEX_LUK = 8,
+    /** INT, LUK 이중 */
+    INT_LUK = 9,
+    /** 방어력 */
+    PDD = 10,
+    /** 공격력 */
+    PAD = 11,
+    /** 마력 */
+    MAD = 12,
+    /** 최대 HP */
+    MHP = 13,
+    /** 최대 MP */
+    MMP = 14,
+    /** 이동속도 */
+    speed = 15,
+    /** 점프력 */
+    jump = 16,
+    /** 데미지 % */
+    damR = 17,
+    /** 보스 데미지 % */
+    bdR = 18,
+    /** 올스탯 % */
+    allStatR = 19,
+    /** 착용 레벨 감소 */
+    reduceReq = 20
+}

package/lib/logic/enhancement.d.ts

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

package/lib/logic/scroll.d.ts

@@ -0,0 +1,22 @@
+import { Gear } from "../gear";
+import { GearPropType } from "../gearproptype";
+export declare type SpellTraceProbability = 100 | 70 | 30 | 15;
+export declare type SpellTraceStatType = GearPropType.incSTR | GearPropType.incDEX | GearPropType.incINT | GearPropType.incLUK | GearPropType.incAllStat | GearPropType.incMHP;
+/**
+ * 주문서
+ */
+export declare class Scroll {
+    /** 주문서 이름 */
+    name: string;
+    /** 주문서 옵션 */
+    stat: Map<GearPropType, number>;
+    constructor(name?: string, stats?: Map<GearPropType, number>);
+    /**
+     * 주문의 흔적 `Scroll`을 반환합니다.
+     * @param gear 적용할 장비
+     * @param type 주문의 흔적 스탯 (`GearPropType`)
+     * @param probability 주문의 흔적 확률
+     * @returns 주문의 흔적 `Scroll`; 존재하지 않을 경우 `undefined`
+     */
+    static getSpellTraceScroll(gear: Gear, type: SpellTraceStatType, probability: SpellTraceProbability): Scroll | undefined;
+}

package/lib/logic/upgrade.d.ts

@@ -0,0 +1,53 @@
+import { Gear } from "../gear";
+import { Scroll, SpellTraceProbability, SpellTraceStatType } from "./scroll";
+/**
+ * 주문서 업그레이드 관련 기능을 제공합니다.
+ */
+export declare class UpgradeLogic {
+    /**
+     * 장비에 황금망치를 적용합니다.
+     * @param gear 황금망치를 적용할 장비
+     * @returns 황금망치가 적용됐을 경우 `true`; 아닐 경우 `false`
+     */
+    applyGoldHammer(gear: Gear): boolean;
+    /**
+     * 장비에 주문서를 1회 적용합니다.
+     *
+     * @param gear 주문서를 적용할 장비
+     * @param scroll 적용할 주문서
+     * @returns 주문서가 적용됐을 경우 `true`; 아닐 경우 `false`
+     */
+    applyScroll(gear: Gear, scroll: Scroll): boolean;
+    /**
+     * 장비에 주문의 흔적 강화를 1회 적용합니다.
+     * @param gear 강화를 적용할 장비
+     * @param type 주문의 흔적 스탯 종류
+     * @param probability 주문의 흔적 성공 확률 %
+     * @returns 주문서가 적용됐을 경우 `true`; 아닐 경우 `false`
+     */
+    applySpellTrace(gear: Gear, type: SpellTraceStatType, probability: SpellTraceProbability): boolean;
+    /**
+     * 장비의 업그레이드 가능 횟수를 1회 감소합니다.
+     *
+     * 주문서가 실패한 것과 동일한 효과입니다.
+     * @param gear 감소할 장비
+     * @returns 감소됐을 경우 `true`; 아닐 경우 `false`
+     */
+    addUpgradeFail(gear: Gear): boolean;
+    /**
+     * 장비의 업그레이드 가능 횟수를 1회 복구합니다.
+     *
+     * 장비의 최대 업그레이드 가능 횟수를 초과하지 않습니다.
+     * @param gear 복구할 장비
+     * @returns 복구했을 경우 `true`; 아닐 경우 `false`
+     */
+    restoreUpgradeFail(gear: Gear): boolean;
+    /**
+     * 장비의 주문서, 황금망치 관련 속성을 초기화합니다.
+     *
+     * 아크 이노센트와 동일한 효과입니다. 놀라운 장비강화 주문서가 적용된 장비도 적용 가능하지만 오차가 발생할 수 있습니다.
+     * @param gear 초기화할 장비
+     * @returns 초기화했을 경우 `true`; 아닐 경우 `false`
+     */
+    resetUpgrade(gear: Gear): boolean;
+}

package/lib/potential.d.ts

@@ -0,0 +1,38 @@
+import { GearPropType } from "./gearproptype";
+import { GearType } from "./geartype";
+/**
+ * 잠재옵션
+ */
+export declare class Potential {
+    /** 잠재옵션 ID */
+    code: number;
+    /**
+     * 잠재옵션 분류
+     *
+     * 잠재옵션을 적용 가능한 장비 분류를 나타냅니다.
+     */
+    optionType: number;
+    /** 장비의 최소 착용 가능 레벨 */
+    reqLevel: number;
+    /** 장비에 표시되는 문자열의 원본 */
+    summary: string;
+    /** 잠재옵션 옵션 */
+    option: Map<GearPropType, number>;
+    /**
+     * 장비에 표시되는 문자열
+     */
+    get convertSummary(): string;
+    /**
+     * 장비의 착용 가능 레벨로부터 잠재옵션의 레벨을 계산합니다.
+     * @param gearReqLevel 장비의 착용 가능 레벨
+     * @returns 잠재옵션 레벨 (1~20)
+     */
+    static getPotentialLevel(gearReqLevel: number): number;
+    /**
+     * 잠재옵션 분류와 장비 분류를 비교합니다.
+     * @param optionType 잠재옵션 분류
+     * @param gearType 장비 분류
+     * @returns 잠재옵션 분류가 장비 분류에 적용 가능한 경우 `true`; 아닌 경우 `false`
+     */
+    static checkOptionType(optionType: number, gearType: GearType): boolean;
+}

package/lib/potentialgrade.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 잠재능력 등급
+ */
+export declare enum PotentialGrade {
+    normal = 0,
+    rare = 1,
+    epic = 2,
+    unique = 3,
+    legendary = 4,
+    special = 5
+}