hrbattle 0.1.0 → 1.0.0

package/dist/battle/config/jsonConfigLoader.d.ts

@@ -22,5 +22,11 @@ export interface BattleJsonConfigBundle {
 }
 export declare function loadBattleJsonConfigBundle(): BattleJsonConfigBundle;
 export declare function validateBattleJsonConfigBundle(bundle: BattleJsonConfigBundle): void;
-export declare function buildBattleUnitsFromJsonBundle(bundle: BattleJsonConfigBundle, team1HeroIds?: string[], team2HeroIds?: string[]): BattleInitUnit[];
+/** 英雄入参：可以是纯 heroId 字符串，也可以带技能等级覆盖 */
+export type HeroInput = string | {
+    heroId: string;
+    /** 技能等级覆盖，key 为 skillId，value 为等级数值 */
+    skillLevels?: Record<string, number>;
+};
+export declare function buildBattleUnitsFromJsonBundle(bundle: BattleJsonConfigBundle, team1?: HeroInput[], team2?: HeroInput[]): BattleInitUnit[];
 export {};

package/dist/battle/config/jsonConfigLoader.js

@@ -46,13 +46,21 @@ function cloneStats(stats) {
 function buildUnitInstanceId(teamId, position, heroId) {
     return `t${teamId}_p${position}_${heroId}`;
 }
-export function buildBattleUnitsFromJsonBundle(bundle, team1HeroIds = bundle.roster.defaultLineup.team1, team2HeroIds = bundle.roster.defaultLineup.team2) {
+function normalizeHeroInput(input) {
+    if (typeof input === "string")
+        return { heroId: input };
+    return input;
+}
+export function buildBattleUnitsFromJsonBundle(bundle, team1, team2) {
+    const team1Inputs = team1 ?? bundle.roster.defaultLineup.team1;
+    const team2Inputs = team2 ?? bundle.roster.defaultLineup.team2;
     const heroBookMap = new Map([
         ...bundle.heroSkillBooks.map((item) => [item.heroId, item]),
         ...bundle.monsterSkillBooks.map((item) => [item.heroId, item]),
     ]);
-    const buildTeam = (teamId, heroIds) => {
-        return heroIds.map((heroId, index) => {
+    const buildTeam = (teamId, inputs) => {
+        return inputs.map((input, index) => {
+            const { heroId, skillLevels } = normalizeHeroInput(input);
             const heroBook = heroBookMap.get(heroId);
             if (!heroBook) {
                 throw new Error(`missing-hero-skill-book:${heroId}`);
@@ -69,9 +77,15 @@ export function buildBattleUnitsFromJsonBundle(bundle, team1HeroIds = bundle.ros
                 position,
                 element: heroBook.element,
                 stats: cloneStats(stats),
-                skills: heroBook.skills.map((skill) => ({ ...skill }))
+                skills: heroBook.skills.map((skill) => {
+                    const cloned = { ...skill };
+                    if (skillLevels && skillLevels[skill.id] !== undefined) {
+                        cloned.level = skillLevels[skill.id];
+                    }
+                    return cloned;
+                })
             };
         });
     };
-    return [...buildTeam(1, team1HeroIds), ...buildTeam(2, team2HeroIds)];
+    return [...buildTeam(1, team1Inputs), ...buildTeam(2, team2Inputs)];
 }

package/dist/battle/types.d.ts

@@ -1,7 +1,7 @@
 export type TeamId = 1 | 2;
 export type UnitId = string;
 export type ElementType = "fire" | "thunder" | "water" | "rock" | "wind" | "light" | "dark";
-export type SkillType = "basic" | "core" | "ultimate";
+export type SkillType = "basic" | "core" | "ultimate" | "passive";
 export type SkillExecMode = "config" | "script" | "hybrid";
 export type BattleEventName = "OnTurnStart" | "OnTurnEnd" | "OnBeforeCast" | "OnAfterCast" | "OnBeforeDamage" | "OnAfterDamage" | "OnKill" | "OnDeath" | "OnBuffAdd" | "OnBuffRemove" | "OnExtraTurnGranted" | "OnImbalanceBreak" | "OnDamageDealt" | "BeforeDamageTaken";
 export interface UnitStats {

package/dist/index.d.ts

@@ -7,4 +7,6 @@ export { EffectSystem } from "./battle/effectSystem";
 export { calcDamage, calcEffectProbability, calcHealOrShield } from "./battle/formula";
 export { ConfigSkillEngine, ScriptSkillEngine, SkillExecutor } from "./battle/skillEngine";
 export { designedScripts } from "./battle/script/designedScripts";
+export { loadBattleJsonConfigBundle, validateBattleJsonConfigBundle, buildBattleUnitsFromJsonBundle } from "./battle/config/jsonConfigLoader";
+export type { BattleJsonConfigBundle, HeroInput } from "./battle/config/jsonConfigLoader";
 export type { BattleScriptApi, BattleConfig, BattleInitUnit, BuffConfig, ISkillScript, SkillDefinition, SkillExecMode, SkillTemplate, UnitModel, UnitStats } from "./battle/types";

package/dist/index.js

@@ -6,3 +6,4 @@ export { EffectSystem } from "./battle/effectSystem";
 export { calcDamage, calcEffectProbability, calcHealOrShield } from "./battle/formula";
 export { ConfigSkillEngine, ScriptSkillEngine, SkillExecutor } from "./battle/skillEngine";
 export { designedScripts } from "./battle/script/designedScripts";
+export { loadBattleJsonConfigBundle, validateBattleJsonConfigBundle, buildBattleUnitsFromJsonBundle } from "./battle/config/jsonConfigLoader";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hrbattle",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "一个基于回合制战斗引擎，支持技能脚本、buff系统和效果解析。",
   "type": "module",
   "main": "dist/index.js",