steamsheep-ts-game-engine 3.1.2 → 3.2.0

package/README.md

@@ -539,10 +539,35 @@ const performRitualAction: ActionDef<Stats, Items, Flags, Extra> = {
 
 ---
 
+## ⚠️ 重要：通知系统使用
+
+如果你使用 `showModal()` 或 `showToast()` 但没有看到显示，请确保在你的应用中渲染了 `OverlaySystem` 组件：
+
+```tsx
+import { OverlaySystem } from 'steamsheep-ts-game-engine';
+
+function App() {
+  return (
+    <>
+      <YourGameUI />
+      {/* ⚠️ 必须添加这个组件 */}
+      <OverlaySystem />
+    </>
+  );
+}
+```
+
+详细说明请查看：[通知系统使用指南](./docs/NOTIFICATION_SYSTEM.md)
+
+---
+
 ## 📚 更多文档
 
+- **[通知系统使用指南](./docs/NOTIFICATION_SYSTEM.md)** - 如果 showModal/showToast 不显示，请看这里！
+- [事件系统单例问题](./docs/EVENT_SYSTEM_SINGLETON.md)
+- [完整游戏流程示例](./examples/complete-game-flow.ts)
+- [快速入门指南](./QUICK_START.md)
 - [完整功能示例](./examples/complete-features-example.ts)
-- [动态 Flag 示例](./examples/dynamic-flags-example.ts)
 - [核心类型定义](./core/types.ts)
 - [状态管理](./state/store.ts)
 - [历史管理](./state/history.ts)

package/dist/core/index.d.mts

@@ -1,5 +1,5 @@
-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';
+import { a as GameState } from '../types-Cp9kSsBQ.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-Cp9kSsBQ.mjs';
 
 /**
  * 系统消息常量

package/dist/core/index.d.ts

@@ -1,5 +1,5 @@
-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';
+import { a as GameState } from '../types-Cp9kSsBQ.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-Cp9kSsBQ.js';
 
 /**
  * 系统消息常量

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-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 { 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-Cp9kSsBQ.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-5-3GQpi9.mjs';
+export { G as GameStore, c as createGameEngineStore } from './store-CXGVzV4N.mjs';
 export { HistoryManager, SnapshotInfo } from './state/index.mjs';
-export { EngineEvents, EventBus, FlowSystem, QuerySystem, debugEventSystem, gameEvents, getEventListenerCounts, isEventBusSingleton } from './systems/index.mjs';
+export { EngineEvents, EventBus, FlowSystem, QuerySystem, debugEventSystem, gameEvents, getEventListenerCounts, getGlobalEventBusInstance, isEventBusSingleton } from './systems/index.mjs';
 export { Layout, LogStream, MainContent, OverlaySystem } from './ui/index.mjs';
 import 'zustand/middleware';
 import 'zustand';

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-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 { 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-Cp9kSsBQ.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-PPh__zkF.js';
+export { G as GameStore, c as createGameEngineStore } from './store-Bd5skpNR.js';
 export { HistoryManager, SnapshotInfo } from './state/index.js';
-export { EngineEvents, EventBus, FlowSystem, QuerySystem, debugEventSystem, gameEvents, getEventListenerCounts, isEventBusSingleton } from './systems/index.js';
+export { EngineEvents, EventBus, FlowSystem, QuerySystem, debugEventSystem, gameEvents, getEventListenerCounts, getGlobalEventBusInstance, isEventBusSingleton } from './systems/index.js';
 export { Layout, LogStream, MainContent, OverlaySystem } from './ui/index.js';
 import 'zustand/middleware';
 import 'zustand';

package/dist/index.js

@@ -522,6 +522,17 @@ var EventBus = class {
      * 类型安全在订阅/发射时强制执行
      */
     __publicField(this, "listeners", /* @__PURE__ */ new Map());
+    /**
+     * 实例 ID（用于调试）
+     * 每个 EventBus 实例都有唯一的 ID
+     */
+    __publicField(this, "_id", Math.random().toString(36).substring(2, 9));
+  }
+  /**
+   * 获取实例 ID
+   */
+  get id() {
+    return this._id;
   }
   /**
    * 订阅事件
@@ -609,13 +620,16 @@ var EventBus = class {
     this.listeners.clear();
   }
 };
-var GLOBAL_KEY = "__STEAMSHEEP_GAME_EVENTS__";
+var GLOBAL_SYMBOL = /* @__PURE__ */ Symbol.for("__STEAMSHEEP_GAME_EVENTS__");
 function getGlobalEventBus() {
   const globalObj = typeof globalThis !== "undefined" ? globalThis : typeof window !== "undefined" ? window : typeof self !== "undefined" ? self : {};
-  if (!globalObj[GLOBAL_KEY]) {
-    globalObj[GLOBAL_KEY] = new EventBus();
+  if (!globalObj[GLOBAL_SYMBOL]) {
+    globalObj[GLOBAL_SYMBOL] = new EventBus();
+    if (typeof window !== "undefined" && typeof console !== "undefined") {
+      console.log("[SteamSheep Engine] EventBus \u5355\u4F8B\u5DF2\u521B\u5EFA");
+    }
   }
-  return globalObj[GLOBAL_KEY];
+  return globalObj[GLOBAL_SYMBOL];
 }
 var gameEvents = getGlobalEventBus();
 var EngineEvents = {
@@ -637,9 +651,14 @@ var EngineEvents = {
   CUSTOM: "engine:custom_trigger"
 };
 function isEventBusSingleton() {
-  const GLOBAL_KEY2 = "__STEAMSHEEP_GAME_EVENTS__";
+  const GLOBAL_SYMBOL2 = /* @__PURE__ */ Symbol.for("__STEAMSHEEP_GAME_EVENTS__");
+  const globalObj = typeof globalThis !== "undefined" ? globalThis : typeof window !== "undefined" ? window : typeof self !== "undefined" ? self : {};
+  return globalObj[GLOBAL_SYMBOL2] === gameEvents;
+}
+function getGlobalEventBusInstance() {
+  const GLOBAL_SYMBOL2 = /* @__PURE__ */ Symbol.for("__STEAMSHEEP_GAME_EVENTS__");
   const globalObj = typeof globalThis !== "undefined" ? globalThis : typeof window !== "undefined" ? window : typeof self !== "undefined" ? self : {};
-  return globalObj[GLOBAL_KEY2] === gameEvents;
+  return globalObj[GLOBAL_SYMBOL2];
 }
 function getEventListenerCounts() {
   const counts = {};
@@ -650,8 +669,13 @@ function getEventListenerCounts() {
   return counts;
 }
 function debugEventSystem() {
+  const GLOBAL_SYMBOL2 = /* @__PURE__ */ Symbol.for("__STEAMSHEEP_GAME_EVENTS__");
   console.log("\n========== EventBus \u8C03\u8BD5\u4FE1\u606F ==========");
   console.log("\u5355\u4F8B\u72B6\u6001:", isEventBusSingleton() ? "\u2713 \u6B63\u5E38" : "\u2717 \u5F02\u5E38\uFF08\u591A\u4E2A\u5B9E\u4F8B\uFF09");
+  const instance = getGlobalEventBusInstance();
+  console.log("\u5B9E\u4F8B ID:", instance ? `EventBus@${instance._id || "unknown"}` : "\u672A\u627E\u5230");
+  console.log("Symbol Key:", GLOBAL_SYMBOL2.toString());
+  console.log("\u5BFC\u51FA\u5B9E\u4F8B:", gameEvents === instance ? "\u2713 \u4E00\u81F4" : "\u2717 \u4E0D\u4E00\u81F4");
   const counts = getEventListenerCounts();
   const eventCount = Object.keys(counts).length;
   if (eventCount === 0) {
@@ -662,6 +686,10 @@ function debugEventSystem() {
       console.log(`  - ${event}: ${count} \u4E2A\u76D1\u542C\u5668`);
     });
   }
+  console.log("\n\u73AF\u5883\u4FE1\u606F:");
+  console.log("  - globalThis:", typeof globalThis !== "undefined" ? "\u2713" : "\u2717");
+  console.log("  - window:", typeof window !== "undefined" ? "\u2713" : "\u2717");
+  console.log("  - self:", typeof self !== "undefined" ? "\u2713" : "\u2717");
   console.log("=====================================\n");
 }
 
@@ -1716,6 +1744,7 @@ exports.gameEvents = gameEvents;
 exports.generateId = generateId;
 exports.get = get;
 exports.getEventListenerCounts = getEventListenerCounts;
+exports.getGlobalEventBusInstance = getGlobalEventBusInstance;
 exports.getPercentage = getPercentage;
 exports.getStateDiff = getStateDiff;
 exports.getTimeOfDay = getTimeOfDay;