steamsheep-ts-game-engine 3.0.0 → 3.1.0

package/README.md

@@ -197,7 +197,7 @@ effects: {
 }
 ```
 
-### 4. 职责分离 (afterEffects)
+### 4. 职责分离 (afterEffects + resultText 双参数)
 
 ```typescript
 {
@@ -213,10 +213,11 @@ effects: {
     }
   },
   
-  // 文本生成在这里
-  resultText: (state) => {
-    return state.stats.sanity < 20 
-      ? '你感到理智正在崩溃...' 
+  // 文本生成 - 可以比较前后状态
+  resultText: (state, original) => {
+    const sanityLoss = original.stats.sanity - state.stats.sanity;
+    return sanityLoss > 15
+      ? `你失去了 ${sanityLoss} 点理智，感到崩溃...`
       : '仪式完成了。';
   }
 }
@@ -359,6 +360,61 @@ if (store.hasSnapshot('before_boss_fight')) {
 store.deleteSnapshot('before_boss_fight');
 ```
 
+### 11. ResultText 比较前后状态
+
+```typescript
+// 简化前：需要通过 afterEffects + extra 传递信息
+{
+  effects: {
+    conditionalEffects: () => {
+      if (Math.random() < 0.15) {
+        return { statsChange: { gnosis: 1 } };
+      }
+      return null;
+    }
+  },
+  afterEffects: (state, original, actions) => {
+    const gainedGnosis = state.stats.gnosis > original.stats.gnosis;
+    actions.setExtra({ lastMeditateGainedGnosis: gainedGnosis });
+  },
+  resultText: (state) => {
+    return state.extra.lastMeditateGainedGnosis
+      ? "获得了灵知！"
+      : "平静地冥想。";
+  }
+}
+
+// 简化后：直接比较前后状态
+{
+  effects: {
+    conditionalEffects: () => {
+      if (Math.random() < 0.15) {
+        return { statsChange: { gnosis: 1 } };
+      }
+      return null;
+    }
+  },
+  resultText: (state, original) => {
+    const gainedGnosis = state.stats.gnosis > original.stats.gnosis;
+    return gainedGnosis
+      ? "获得了灵知！"
+      : "平静地冥想。";
+  }
+}
+
+// 显示具体变化量
+resultText: (state, original) => {
+  const hpChange = state.stats.hp - original.stats.hp;
+  const goldChange = state.stats.gold - original.stats.gold;
+  
+  const parts = [];
+  if (hpChange < 0) parts.push(`失去 ${-hpChange} HP`);
+  if (goldChange > 0) parts.push(`获得 ${goldChange} 金币`);
+  
+  return parts.join('，') || '什么都没发生。';
+}
+```
+
 ---
 
 ## 🎮 完整示例
@@ -477,6 +533,7 @@ const performRitualAction: ActionDef<Stats, Items, Flags, Extra> = {
 8. ✅ **灵活的 Requirements** - custom 可返回失败原因
 9. ✅ **明确的执行顺序** - 5 个阶段，清晰的文档说明
 10. ✅ **命名快照系统** - 支持保存和恢复命名快照
+11. ✅ **ResultText 双参数** - 可以比较前后状态，无需 extra 传递
 
 所有功能都是类型安全的，并且完全向后兼容！
 

package/dist/core/index.d.mts

@@ -1,5 +1,5 @@
-import { a as GameState } from '../types-C3Q7UPWy.mjs';
-export { A as ActionDef, E as EffectDef, F as FlagsBatchOperation, G as GameStoreActions, d as LocationDef, L as LogEntry, b as NotificationPayload, N as NotificationType, R as RequirementCheckResult, c as RequirementDef, S as StatRequirement, W as WorldState } from '../types-C3Q7UPWy.mjs';
+import { a as GameState } from '../types-D-nDlnv3.mjs';
+export { A as ActionDef, E as EffectDef, F as FlagsBatchOperation, G as GameStoreActions, d as LocationDef, L as LogEntry, b as NotificationPayload, N as NotificationType, R as RequirementCheckResult, c as RequirementDef, S as StatRequirement, W as WorldState } from '../types-D-nDlnv3.mjs';
 
 /**
  * 系统消息常量

package/dist/core/index.d.ts

@@ -1,5 +1,5 @@
-import { a as GameState } from '../types-C3Q7UPWy.js';
-export { A as ActionDef, E as EffectDef, F as FlagsBatchOperation, G as GameStoreActions, d as LocationDef, L as LogEntry, b as NotificationPayload, N as NotificationType, R as RequirementCheckResult, c as RequirementDef, S as StatRequirement, W as WorldState } from '../types-C3Q7UPWy.js';
+import { a as GameState } from '../types-D-nDlnv3.js';
+export { A as ActionDef, E as EffectDef, F as FlagsBatchOperation, G as GameStoreActions, d as LocationDef, L as LogEntry, b as NotificationPayload, N as NotificationType, R as RequirementCheckResult, c as RequirementDef, S as StatRequirement, W as WorldState } from '../types-D-nDlnv3.js';
 
 /**
  * 系统消息常量

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-export { A as ActionDef, E as EffectDef, F as FlagsBatchOperation, a as GameState, G as GameStoreActions, d as LocationDef, L as LogEntry, b as NotificationPayload, N as NotificationType, R as RequirementCheckResult, c as RequirementDef, S as StatRequirement, W as WorldState } from './types-C3Q7UPWy.mjs';
+export { A as ActionDef, E as EffectDef, F as FlagsBatchOperation, a as GameState, G as GameStoreActions, d as LocationDef, L as LogEntry, b as NotificationPayload, N as NotificationType, R as RequirementCheckResult, c as RequirementDef, S as StatRequirement, W as WorldState } from './types-D-nDlnv3.mjs';
 export { DEFAULT_CONFIG, DEFAULT_STATS, ENGINE_VERSION, LOG_TYPE_COLORS, SystemMessages, TIME_CONSTANTS, UI_CONSTANTS, VALIDATION, clamp, debounce, deepClone, delay, formatGameTime, formatNumber, generateId, get, getPercentage, getStateDiff, getTimeOfDay, isEmpty, randomChoice, randomInt, shuffle, throttle } from './core/index.mjs';
-export { G as GameStore, c as createGameEngineStore } from './store-B7yMYHpB.mjs';
+export { G as GameStore, c as createGameEngineStore } from './store-5-3GQpi9.mjs';
 export { HistoryManager, SnapshotInfo } from './state/index.mjs';
 export { EngineEvents, EventBus, FlowSystem, QuerySystem, gameEvents } from './systems/index.mjs';
 export { Layout, LogStream, MainContent, OverlaySystem } from './ui/index.mjs';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { A as ActionDef, E as EffectDef, F as FlagsBatchOperation, a as GameState, G as GameStoreActions, d as LocationDef, L as LogEntry, b as NotificationPayload, N as NotificationType, R as RequirementCheckResult, c as RequirementDef, S as StatRequirement, W as WorldState } from './types-C3Q7UPWy.js';
+export { A as ActionDef, E as EffectDef, F as FlagsBatchOperation, a as GameState, G as GameStoreActions, d as LocationDef, L as LogEntry, b as NotificationPayload, N as NotificationType, R as RequirementCheckResult, c as RequirementDef, S as StatRequirement, W as WorldState } from './types-D-nDlnv3.js';
 export { DEFAULT_CONFIG, DEFAULT_STATS, ENGINE_VERSION, LOG_TYPE_COLORS, SystemMessages, TIME_CONSTANTS, UI_CONSTANTS, VALIDATION, clamp, debounce, deepClone, delay, formatGameTime, formatNumber, generateId, get, getPercentage, getStateDiff, getTimeOfDay, isEmpty, randomChoice, randomInt, shuffle, throttle } from './core/index.js';
-export { G as GameStore, c as createGameEngineStore } from './store-BKROShPq.js';
+export { G as GameStore, c as createGameEngineStore } from './store-PPh__zkF.js';
 export { HistoryManager, SnapshotInfo } from './state/index.js';
 export { EngineEvents, EventBus, FlowSystem, QuerySystem, gameEvents } from './systems/index.js';
 export { Layout, LogStream, MainContent, OverlaySystem } from './ui/index.js';

package/dist/index.js

@@ -1355,7 +1355,7 @@ var FlowSystem = class {
       action.afterEffects(currentState, originalState, actions);
     }
     const finalState = store;
-    const resultText = typeof action.resultText === "function" ? action.resultText(finalState) : action.resultText;
+    const resultText = typeof action.resultText === "function" ? action.resultText(finalState, state) : action.resultText;
     store.addLog(resultText, "result");
     gameEvents.emit(EngineEvents.ACTION_EXECUTED, { actionId: action.id });
     return true;