pi-jinyong-xia 1.0.0

package/dist/extensions/wuxue-types.d.ts

@@ -0,0 +1,155 @@
+/**
+ * 武功系统 - 类型定义与五行系统
+ */
+export type Element = "金" | "木" | "水" | "火" | "土";
+export declare const OVERCOMES: Record<Element, Element>;
+export declare const GENERATES: Record<Element, Element>;
+export declare const ELEMENT_SYMBOL: Record<Element, string>;
+export declare function getElementMultiplier(atk: Element, def: Element): number;
+/** 返回元素加成标签："克制" | "被克" | "" */
+export declare function getElementBonusLabel(atk: Element, def: Element): string;
+export interface WuxueState {
+    level: number;
+    xp: number;
+    xpToNext: number;
+    totalXp: number;
+    hp: number;
+    maxHp: number;
+    attack: number;
+    defense: number;
+    gold: number;
+    skills: Skill[];
+    achievements: string[];
+    totalTrainings: number;
+    totalFeeds: number;
+    totalCommands: number;
+    totalEdits: number;
+    totalErrors: number;
+    items: Record<string, number>;
+    attackBuff: number;
+    defenseBuff: number;
+    xpBonus: number;
+}
+export interface Skill {
+    id: string;
+    name: string;
+    level: number;
+    xp: number;
+    description: string;
+    unlocked: boolean;
+    element: Element;
+}
+export interface SkillDef {
+    id: string;
+    name: string;
+    description: string;
+    element: Element;
+}
+export interface WeaponDef {
+    id: string;
+    name: string;
+    type: string;
+    attack: number;
+    rarity: "凡品" | "良品" | "精品" | "极品" | "神器";
+    description: string;
+    element: Element;
+}
+export interface ItemDef {
+    id: string;
+    name: string;
+    type: "恢复" | "增益" | "武功";
+    description: string;
+    effect: {
+        hp?: number;
+        attackBuff?: number;
+        defenseBuff?: number;
+        xpBonus?: number;
+    };
+}
+export interface BossDef {
+    id: string;
+    name: string;
+    title: string;
+    element: Element;
+    baseHp: number;
+    baseAttack: number;
+    baseDefense: number;
+    description: string;
+}
+export interface DropResult {
+    type: "encounter" | "battle" | "event" | "weapon" | "item" | "gold" | "skill_scroll" | "none";
+    location?: string;
+    name: string;
+    description: string;
+    weaponId?: string;
+    itemId?: string;
+    goldAmount?: number;
+    xpAmount?: number;
+    skillScrollId?: string;
+    battleResult?: "win" | "lose" | "flee";
+    hpChange?: number;
+    encounterChar?: string;
+}
+export interface BattleLog {
+    turn: number;
+    attacker: string;
+    damage: number;
+    elementBonus: string;
+    isSkillHit?: boolean;
+    selfDamage?: number;
+}
+export interface BattleResult {
+    won: boolean;
+    playerHp: number;
+    bossHpLeft: number;
+    bossName: string;
+    bossElement: Element;
+    logs: BattleLog[];
+    goldReward: number;
+    xpReward: number;
+    skillXpReward: number;
+}
+/** 手动战斗状态 */
+export type TurnAction = "attack" | "skill" | "defend" | "item" | "flee";
+export interface BattleState {
+    playerHp: number;
+    playerMaxHp: number;
+    bossHp: number;
+    bossMaxHp: number;
+    bossName: string;
+    bossElement: Element;
+    turn: number;
+    playerAtk: number;
+    playerDef: number;
+    bossAtk: number;
+    bossDef: number;
+    weaponElement: Element;
+    skillElement?: Element;
+    skillLevel: number;
+    skillDmgBase: number;
+    skillTriggerInterval: number;
+    weaponAttack: number;
+    logs: BattleLog[];
+}
+export interface TurnResult {
+    logs: BattleLog[];
+    over: boolean;
+    won?: boolean;
+    fled?: boolean;
+    dice?: DiceEvent;
+}
+/** 🎲 骰子随机事件 */
+export type DiceEventType = "暴击" | "闪避" | "元素共鸣" | "破防" | "回春" | "虚弱" | "普通";
+export interface DiceEvent {
+    roll: number;
+    event: DiceEventType;
+    target: "player" | "boss" | "both";
+    desc: string;
+}
+export interface BattleAction {
+    id: string;
+    label: string;
+    type: TurnAction;
+    desc: string;
+    emoji: string;
+}

package/dist/extensions/wuxue-types.js

@@ -0,0 +1,28 @@
+/**
+ * 武功系统 - 类型定义与五行系统
+ */
+export const OVERCOMES = {
+    "金": "木", "木": "土", "土": "水", "水": "火", "火": "金",
+};
+export const GENERATES = {
+    "木": "火", "火": "土", "土": "金", "金": "水", "水": "木",
+};
+export const ELEMENT_SYMBOL = {
+    "金": "🤍", "木": "💚", "水": "💙", "火": "❤️", "土": "🟤",
+};
+export function getElementMultiplier(atk, def) {
+    if (OVERCOMES[atk] === def)
+        return 1.5;
+    if (OVERCOMES[def] === atk)
+        return 0.7;
+    return 1.0;
+}
+/** 返回元素加成标签："克制" | "被克" | "" */
+export function getElementBonusLabel(atk, def) {
+    if (OVERCOMES[atk] === def)
+        return "克制";
+    if (OVERCOMES[def] === atk)
+        return "被克";
+    return "";
+}
+//# sourceMappingURL=wuxue-types.js.map

package/dist/extensions/wuxue-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wuxue-types.js","sourceRoot":"","sources":["../../extensions/wuxue-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,CAAC,MAAM,SAAS,GAA6B;IAClD,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;CAChD,CAAC;AACF,MAAM,CAAC,MAAM,SAAS,GAA6B;IAClD,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;CAChD,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAA4B;IACtD,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI;CACrD,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,GAAY,EAAE,GAAY;IAC9D,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,GAAG;QAAE,OAAO,GAAG,CAAC;IACvC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,GAAG;QAAE,OAAO,GAAG,CAAC;IACvC,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,oBAAoB,CAAC,GAAY,EAAE,GAAY;IAC9D,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,EAAE,CAAC;AACX,CAAC"}

package/dist/extensions/wuxue.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 武功系统 - 等级、经验、状态管理、成就、校验
+ *
+ * 等级体系（参考武侠世界）：
+ *   1-10:  江湖小虾米
+ *   11-20: 初窥门径
+ *   21-30: 小有所成
+ *   31-40: 身手不凡
+ *   41-50: 名动一方
+ *   51-60: 威震武林
+ *   61-70: 一代宗师
+ *   71-80: 登峰造极
+ *   81-90: 返璞归真
+ *   91-99: 天下无敌
+ *   100:   武林至尊
+ */
+export type { Element } from "./wuxue-types.js";
+export { ELEMENT_SYMBOL, getElementMultiplier, getElementBonusLabel, OVERCOMES, GENERATES } from "./wuxue-types.js";
+export type { WuxueState, Skill, SkillDef, WeaponDef, ItemDef, BossDef, DropResult, BattleLog, BattleResult } from "./wuxue-types.js";
+export { SKILL_POOL, MAX_SKILLS, EXCLUSIVE_SKILL_IDS, WEAPON_DEFS, ITEM_DEFS, getRandomSkill, getShopSkills, getRandomUnownedSkill, getSkill, getSkillXpToNext, addSkillXp, getSkillPrice, getWeaponDef, getRaritySymbol, getItemDef, useItem } from "./wuxue-data.js";
+export { getLocation, getEvent, generateEncounter } from "./wuxue-encounter.js";
+export { BOSS_DEFS, getBossForLevel, fightBoss, initBattleState, executeBattleTurn, finalizeBattle, rollDice } from "./wuxue-boss.js";
+export { FACTIONS, getFaction, getAllFactions, getFactionBonus, getFactionRankTitle, getFactionRankIndex, addContribution } from "./wuxue-faction.js";
+export type { FactionDef } from "./wuxue-faction.js";
+export { PROFESSIONS, getProfession, getAllProfessions, getProfessionBonus } from "./wuxue-profession.js";
+export type { ProfessionDef } from "./wuxue-profession.js";
+export { TALENTS, getTalent, getAllTalents, getTalentsByBranch, calculateTalentBonuses, canLearnTalent, getTalentPointsPerLevel, getBranchName, getBranchEmoji } from "./wuxue-talent.js";
+export type { TalentDef } from "./wuxue-talent.js";
+export { ACHIEVEMENT_DEFS, ACHIEVEMENT_CATEGORIES, getAchievementDef, getAllAchievementDefs, getAchievementsByCategory, getRarityLabel, getRarityColor, getRarityEmoji } from "./wuxue-achievements.js";
+export type { AchievementDef, AchievementCategory } from "./wuxue-achievements.js";
+import type { Element, WuxueState, Skill } from "./wuxue-types.js";
+export declare function getLevelTitle(level: number): string;
+export declare function xpForLevel(level: number): number;
+export declare function getWuli(state: WuxueState, weaponAttack: number): number;
+export declare function updateCombatStats(state: WuxueState, weaponAttack: number): void;
+export declare function createInitialState(): WuxueState;
+/** 补齐老存档中 skills 缺失的 element 等字段 */
+export declare function migrateSkills(skills: Skill[]): void;
+export declare function addXp(state: WuxueState, amount: number): {
+    leveledUp: boolean;
+    newLevel: number;
+};
+export declare function feed(state: WuxueState): {
+    xpGain: number;
+    goldGain: number;
+    leveledUp: boolean;
+};
+/** 获取最大血量（随等级增长） */
+export declare function getMaxHp(level: number): number;
+/** 恢复血量到满（用于tick自然回复或复活） */
+export declare function recoverHp(state: WuxueState): void;
+export declare function train(state: WuxueState, skillId?: string): {
+    success: boolean;
+    xpGain: number;
+    goldGain: number;
+    leveledUp: boolean;
+    skillUp: boolean;
+    msg: string;
+};
+export declare function tick(state: WuxueState): void;
+export declare function recordEvent(state: WuxueState, type: "command" | "edit" | "error" | "tool"): {
+    xpGain: number;
+    goldGain: number;
+    leveledUp: boolean;
+} | null;
+interface AchievementDef {
+    id: string;
+    name: string;
+    description: string;
+    check: (state: WuxueState) => boolean;
+}
+export declare function checkAchievements(state: WuxueState): string[];
+export declare function getAchievementDefs(): AchievementDef[];
+export declare class ValidationError extends Error {
+    readonly field: string;
+    constructor(field: string, message: string);
+}
+/** 校验 WuxueState 的完整性 */
+export declare function validateWuxueState(state: unknown): asserts state is WuxueState;
+/** 校验 Element 类型 */
+export declare function validateElement(el: string): asserts el is Element;
+/** 校验武器 ID 有效性 */
+export declare function validateWeaponId(id: string): void;
+/** 校验武功 ID 有效性 */
+export declare function validateSkillId(id: string): void;
+/** 校验 Boss ID 有效性 */
+export declare function validateBossId(id: string): void;
+/** 校验道具 ID 有效性 */
+export declare function validateItemId(id: string): void;