@esengine/timer 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ESEngine Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,459 @@
+import * as _esengine_ecs_framework from '@esengine/ecs-framework';
+import { BlueprintNodeTemplate, INodeExecutor, BlueprintNode, ExecutionResult } from '@esengine/blueprint';
+
+/**
+ * @zh 定时器服务接口
+ * @en Timer Service Interfaces
+ *
+ * @zh 提供定时器和冷却系统的核心接口
+ * @en Provides core interfaces for timer and cooldown systems
+ */
+/**
+ * @zh 定时器句柄，用于取消定时器
+ * @en Timer handle for cancelling timers
+ */
+interface TimerHandle {
+    /**
+     * @zh 定时器 ID
+     * @en Timer ID
+     */
+    readonly id: string;
+    /**
+     * @zh 是否有效（未被取消）
+     * @en Whether the timer is still valid (not cancelled)
+     */
+    readonly isValid: boolean;
+    /**
+     * @zh 取消定时器
+     * @en Cancel the timer
+     */
+    cancel(): void;
+}
+/**
+ * @zh 定时器信息
+ * @en Timer information
+ */
+interface TimerInfo {
+    /**
+     * @zh 定时器 ID
+     * @en Timer ID
+     */
+    readonly id: string;
+    /**
+     * @zh 剩余时间（毫秒）
+     * @en Remaining time in milliseconds
+     */
+    readonly remaining: number;
+    /**
+     * @zh 是否重复执行
+     * @en Whether the timer repeats
+     */
+    readonly repeating: boolean;
+    /**
+     * @zh 间隔时间（毫秒，仅重复定时器）
+     * @en Interval in milliseconds (only for repeating timers)
+     */
+    readonly interval?: number;
+}
+/**
+ * @zh 冷却信息
+ * @en Cooldown information
+ */
+interface CooldownInfo {
+    /**
+     * @zh 冷却 ID
+     * @en Cooldown ID
+     */
+    readonly id: string;
+    /**
+     * @zh 总持续时间（毫秒）
+     * @en Total duration in milliseconds
+     */
+    readonly duration: number;
+    /**
+     * @zh 剩余时间（毫秒）
+     * @en Remaining time in milliseconds
+     */
+    readonly remaining: number;
+    /**
+     * @zh 进度（0-1，0 表示刚开始，1 表示结束）
+     * @en Progress from 0 to 1 (0 = just started, 1 = finished)
+     */
+    readonly progress: number;
+    /**
+     * @zh 是否已就绪（冷却完成）
+     * @en Whether the cooldown is ready (finished)
+     */
+    readonly isReady: boolean;
+}
+/**
+ * @zh 定时器回调函数
+ * @en Timer callback function
+ */
+type TimerCallback = () => void;
+/**
+ * @zh 带时间参数的定时器回调
+ * @en Timer callback with time parameter
+ */
+type TimerCallbackWithTime = (deltaTime: number) => void;
+/**
+ * @zh 定时器服务接口
+ * @en Timer service interface
+ *
+ * @zh 提供定时器调度和冷却管理功能
+ * @en Provides timer scheduling and cooldown management
+ */
+interface ITimerService {
+    /**
+     * @zh 调度一次性定时器
+     * @en Schedule a one-time timer
+     *
+     * @param id - @zh 定时器标识 @en Timer identifier
+     * @param delay - @zh 延迟时间（毫秒）@en Delay in milliseconds
+     * @param callback - @zh 回调函数 @en Callback function
+     * @returns @zh 定时器句柄 @en Timer handle
+     */
+    schedule(id: string, delay: number, callback: TimerCallback): TimerHandle;
+    /**
+     * @zh 调度重复定时器
+     * @en Schedule a repeating timer
+     *
+     * @param id - @zh 定时器标识 @en Timer identifier
+     * @param interval - @zh 间隔时间（毫秒）@en Interval in milliseconds
+     * @param callback - @zh 回调函数 @en Callback function
+     * @param immediate - @zh 是否立即执行一次 @en Whether to execute immediately
+     * @returns @zh 定时器句柄 @en Timer handle
+     */
+    scheduleRepeating(id: string, interval: number, callback: TimerCallback, immediate?: boolean): TimerHandle;
+    /**
+     * @zh 取消定时器
+     * @en Cancel a timer
+     *
+     * @param handle - @zh 定时器句柄 @en Timer handle
+     */
+    cancel(handle: TimerHandle): void;
+    /**
+     * @zh 通过 ID 取消定时器
+     * @en Cancel timer by ID
+     *
+     * @param id - @zh 定时器标识 @en Timer identifier
+     */
+    cancelById(id: string): void;
+    /**
+     * @zh 检查定时器是否存在
+     * @en Check if a timer exists
+     *
+     * @param id - @zh 定时器标识 @en Timer identifier
+     * @returns @zh 是否存在 @en Whether the timer exists
+     */
+    hasTimer(id: string): boolean;
+    /**
+     * @zh 获取定时器信息
+     * @en Get timer information
+     *
+     * @param id - @zh 定时器标识 @en Timer identifier
+     * @returns @zh 定时器信息或 null @en Timer info or null
+     */
+    getTimerInfo(id: string): TimerInfo | null;
+    /**
+     * @zh 开始冷却
+     * @en Start a cooldown
+     *
+     * @param id - @zh 冷却标识 @en Cooldown identifier
+     * @param duration - @zh 持续时间（毫秒）@en Duration in milliseconds
+     */
+    startCooldown(id: string, duration: number): void;
+    /**
+     * @zh 检查是否在冷却中
+     * @en Check if on cooldown
+     *
+     * @param id - @zh 冷却标识 @en Cooldown identifier
+     * @returns @zh 是否在冷却中 @en Whether on cooldown
+     */
+    isOnCooldown(id: string): boolean;
+    /**
+     * @zh 检查冷却是否就绪
+     * @en Check if cooldown is ready
+     *
+     * @param id - @zh 冷却标识 @en Cooldown identifier
+     * @returns @zh 是否已就绪 @en Whether ready
+     */
+    isCooldownReady(id: string): boolean;
+    /**
+     * @zh 获取剩余冷却时间
+     * @en Get remaining cooldown time
+     *
+     * @param id - @zh 冷却标识 @en Cooldown identifier
+     * @returns @zh 剩余时间（毫秒），0 表示无冷却 @en Remaining time in ms, 0 if no cooldown
+     */
+    getCooldownRemaining(id: string): number;
+    /**
+     * @zh 获取冷却进度
+     * @en Get cooldown progress
+     *
+     * @param id - @zh 冷却标识 @en Cooldown identifier
+     * @returns @zh 进度（0-1），1 表示完成或无冷却 @en Progress 0-1, 1 if done or no cooldown
+     */
+    getCooldownProgress(id: string): number;
+    /**
+     * @zh 获取冷却信息
+     * @en Get cooldown information
+     *
+     * @param id - @zh 冷却标识 @en Cooldown identifier
+     * @returns @zh 冷却信息或 null @en Cooldown info or null
+     */
+    getCooldownInfo(id: string): CooldownInfo | null;
+    /**
+     * @zh 重置冷却
+     * @en Reset a cooldown
+     *
+     * @param id - @zh 冷却标识 @en Cooldown identifier
+     */
+    resetCooldown(id: string): void;
+    /**
+     * @zh 清除所有冷却
+     * @en Clear all cooldowns
+     */
+    clearAllCooldowns(): void;
+    /**
+     * @zh 更新定时器服务
+     * @en Update timer service
+     *
+     * @param deltaTime - @zh 距上次更新的时间（毫秒）@en Time since last update in ms
+     */
+    update(deltaTime: number): void;
+    /**
+     * @zh 清除所有定时器和冷却
+     * @en Clear all timers and cooldowns
+     */
+    clear(): void;
+}
+
+/**
+ * @zh 定时器服务实现
+ * @en Timer Service Implementation
+ *
+ * @zh 提供定时器调度和冷却管理的默认实现
+ * @en Provides default implementation for timer scheduling and cooldown management
+ */
+
+/**
+ * @zh 定时器服务配置
+ * @en Timer service configuration
+ */
+interface TimerServiceConfig {
+    /**
+     * @zh 最大定时器数量（0 表示无限制）
+     * @en Maximum number of timers (0 for unlimited)
+     */
+    maxTimers?: number;
+    /**
+     * @zh 最大冷却数量（0 表示无限制）
+     * @en Maximum number of cooldowns (0 for unlimited)
+     */
+    maxCooldowns?: number;
+}
+/**
+ * @zh 定时器服务实现
+ * @en Timer service implementation
+ *
+ * @example
+ * ```typescript
+ * const timerService = new TimerService();
+ *
+ * // 一次性定时器 | One-time timer
+ * const handle = timerService.schedule('myTimer', 1000, () => {
+ *     console.log('Timer fired!');
+ * });
+ *
+ * // 重复定时器 | Repeating timer
+ * timerService.scheduleRepeating('heartbeat', 100, () => {
+ *     console.log('Tick');
+ * });
+ *
+ * // 冷却系统 | Cooldown system
+ * timerService.startCooldown('skill_fireball', 5000);
+ * if (timerService.isCooldownReady('skill_fireball')) {
+ *     // 可以使用技能 | Can use skill
+ * }
+ *
+ * // 每帧更新 | Update each frame
+ * timerService.update(deltaTime);
+ * ```
+ */
+declare class TimerService implements ITimerService {
+    private timers;
+    private cooldowns;
+    private config;
+    constructor(config?: TimerServiceConfig);
+    schedule(id: string, delay: number, callback: TimerCallback): TimerHandle;
+    scheduleRepeating(id: string, interval: number, callback: TimerCallback, immediate?: boolean): TimerHandle;
+    cancel(handle: TimerHandle): void;
+    cancelById(id: string): void;
+    hasTimer(id: string): boolean;
+    getTimerInfo(id: string): TimerInfo | null;
+    startCooldown(id: string, duration: number): void;
+    isOnCooldown(id: string): boolean;
+    isCooldownReady(id: string): boolean;
+    getCooldownRemaining(id: string): number;
+    getCooldownProgress(id: string): number;
+    getCooldownInfo(id: string): CooldownInfo | null;
+    resetCooldown(id: string): void;
+    clearAllCooldowns(): void;
+    update(deltaTime: number): void;
+    private updateTimers;
+    private updateCooldowns;
+    clear(): void;
+    /**
+     * @zh 获取活跃定时器数量
+     * @en Get active timer count
+     */
+    get activeTimerCount(): number;
+    /**
+     * @zh 获取活跃冷却数量
+     * @en Get active cooldown count
+     */
+    get activeCooldownCount(): number;
+    /**
+     * @zh 获取所有活跃定时器 ID
+     * @en Get all active timer IDs
+     */
+    getActiveTimerIds(): string[];
+    /**
+     * @zh 获取所有活跃冷却 ID
+     * @en Get all active cooldown IDs
+     */
+    getActiveCooldownIds(): string[];
+}
+/**
+ * @zh 创建定时器服务
+ * @en Create timer service
+ *
+ * @param config - @zh 配置选项 @en Configuration options
+ * @returns @zh 定时器服务实例 @en Timer service instance
+ */
+declare function createTimerService(config?: TimerServiceConfig): ITimerService;
+
+/**
+ * @zh 定时器服务令牌
+ * @en Timer service token
+ *
+ * @zh 用于注入定时器服务
+ * @en Used for injecting timer service
+ */
+declare const TimerServiceToken: _esengine_ecs_framework.ServiceToken<ITimerService>;
+
+/**
+ * @zh 定时器蓝图节点
+ * @en Timer Blueprint Nodes
+ *
+ * @zh 提供定时器和冷却功能的蓝图节点
+ * @en Provides blueprint nodes for timer and cooldown functionality
+ */
+
+/**
+ * @zh StartCooldown 节点模板
+ * @en StartCooldown node template
+ */
+declare const StartCooldownTemplate: BlueprintNodeTemplate;
+/**
+ * @zh StartCooldown 节点执行器
+ * @en StartCooldown node executor
+ */
+declare class StartCooldownExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh IsCooldownReady 节点模板
+ * @en IsCooldownReady node template
+ */
+declare const IsCooldownReadyTemplate: BlueprintNodeTemplate;
+/**
+ * @zh IsCooldownReady 节点执行器
+ * @en IsCooldownReady node executor
+ */
+declare class IsCooldownReadyExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh GetCooldownProgress 节点模板
+ * @en GetCooldownProgress node template
+ */
+declare const GetCooldownProgressTemplate: BlueprintNodeTemplate;
+/**
+ * @zh GetCooldownProgress 节点执行器
+ * @en GetCooldownProgress node executor
+ */
+declare class GetCooldownProgressExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh ResetCooldown 节点模板
+ * @en ResetCooldown node template
+ */
+declare const ResetCooldownTemplate: BlueprintNodeTemplate;
+/**
+ * @zh ResetCooldown 节点执行器
+ * @en ResetCooldown node executor
+ */
+declare class ResetCooldownExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh GetCooldownInfo 节点模板
+ * @en GetCooldownInfo node template
+ */
+declare const GetCooldownInfoTemplate: BlueprintNodeTemplate;
+/**
+ * @zh GetCooldownInfo 节点执行器
+ * @en GetCooldownInfo node executor
+ */
+declare class GetCooldownInfoExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh HasTimer 节点模板
+ * @en HasTimer node template
+ */
+declare const HasTimerTemplate: BlueprintNodeTemplate;
+/**
+ * @zh HasTimer 节点执行器
+ * @en HasTimer node executor
+ */
+declare class HasTimerExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh CancelTimer 节点模板
+ * @en CancelTimer node template
+ */
+declare const CancelTimerTemplate: BlueprintNodeTemplate;
+/**
+ * @zh CancelTimer 节点执行器
+ * @en CancelTimer node executor
+ */
+declare class CancelTimerExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh GetTimerRemaining 节点模板
+ * @en GetTimerRemaining node template
+ */
+declare const GetTimerRemainingTemplate: BlueprintNodeTemplate;
+/**
+ * @zh GetTimerRemaining 节点执行器
+ * @en GetTimerRemaining node executor
+ */
+declare class GetTimerRemainingExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh 定时器节点定义
+ * @en Timer node definitions
+ */
+declare const TimerNodeDefinitions: {
+    template: BlueprintNodeTemplate;
+    executor: StartCooldownExecutor;
+}[];
+
+export { CancelTimerExecutor, CancelTimerTemplate, type CooldownInfo, GetCooldownInfoExecutor, GetCooldownInfoTemplate, GetCooldownProgressExecutor, GetCooldownProgressTemplate, GetTimerRemainingExecutor, GetTimerRemainingTemplate, HasTimerExecutor, HasTimerTemplate, type ITimerService, IsCooldownReadyExecutor, IsCooldownReadyTemplate, ResetCooldownExecutor, ResetCooldownTemplate, StartCooldownExecutor, StartCooldownTemplate, type TimerCallback, type TimerCallbackWithTime, type TimerHandle, type TimerInfo, TimerNodeDefinitions, TimerService, type TimerServiceConfig, TimerServiceToken, createTimerService };

package/dist/index.js

@@ -0,0 +1,762 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/TimerService.ts
+var _a;
+var TimerHandleImpl = (_a = class {
+  constructor(timer) {
+    __publicField(this, "timer");
+    this.timer = timer;
+  }
+  get id() {
+    return this.timer.id;
+  }
+  get isValid() {
+    return !this.timer.cancelled;
+  }
+  cancel() {
+    this.timer.cancelled = true;
+  }
+}, __name(_a, "TimerHandleImpl"), _a);
+var _TimerService = class _TimerService {
+  constructor(config = {}) {
+    __publicField(this, "timers", /* @__PURE__ */ new Map());
+    __publicField(this, "cooldowns", /* @__PURE__ */ new Map());
+    __publicField(this, "config");
+    this.config = {
+      maxTimers: config.maxTimers ?? 0,
+      maxCooldowns: config.maxCooldowns ?? 0
+    };
+  }
+  // =========================================================================
+  // 定时器 API | Timer API
+  // =========================================================================
+  schedule(id, delay, callback) {
+    this.cancelById(id);
+    if (this.config.maxTimers > 0 && this.timers.size >= this.config.maxTimers) {
+      throw new Error(`Maximum timer limit reached: ${this.config.maxTimers}`);
+    }
+    const timer = {
+      id,
+      callback,
+      remaining: Math.max(0, delay),
+      repeating: false,
+      interval: 0,
+      cancelled: false
+    };
+    this.timers.set(id, timer);
+    return new TimerHandleImpl(timer);
+  }
+  scheduleRepeating(id, interval, callback, immediate = false) {
+    this.cancelById(id);
+    if (this.config.maxTimers > 0 && this.timers.size >= this.config.maxTimers) {
+      throw new Error(`Maximum timer limit reached: ${this.config.maxTimers}`);
+    }
+    const safeInterval = Math.max(1, interval);
+    const timer = {
+      id,
+      callback,
+      remaining: immediate ? 0 : safeInterval,
+      repeating: true,
+      interval: safeInterval,
+      cancelled: false
+    };
+    this.timers.set(id, timer);
+    return new TimerHandleImpl(timer);
+  }
+  cancel(handle) {
+    handle.cancel();
+    this.timers.delete(handle.id);
+  }
+  cancelById(id) {
+    const timer = this.timers.get(id);
+    if (timer) {
+      timer.cancelled = true;
+      this.timers.delete(id);
+    }
+  }
+  hasTimer(id) {
+    const timer = this.timers.get(id);
+    return timer !== void 0 && !timer.cancelled;
+  }
+  getTimerInfo(id) {
+    const timer = this.timers.get(id);
+    if (!timer || timer.cancelled) {
+      return null;
+    }
+    return {
+      id: timer.id,
+      remaining: timer.remaining,
+      repeating: timer.repeating,
+      interval: timer.repeating ? timer.interval : void 0
+    };
+  }
+  // =========================================================================
+  // 冷却 API | Cooldown API
+  // =========================================================================
+  startCooldown(id, duration) {
+    if (this.config.maxCooldowns > 0 && !this.cooldowns.has(id)) {
+      if (this.cooldowns.size >= this.config.maxCooldowns) {
+        throw new Error(`Maximum cooldown limit reached: ${this.config.maxCooldowns}`);
+      }
+    }
+    const safeDuration = Math.max(0, duration);
+    this.cooldowns.set(id, {
+      id,
+      duration: safeDuration,
+      remaining: safeDuration
+    });
+  }
+  isOnCooldown(id) {
+    const cooldown = this.cooldowns.get(id);
+    return cooldown !== void 0 && cooldown.remaining > 0;
+  }
+  isCooldownReady(id) {
+    return !this.isOnCooldown(id);
+  }
+  getCooldownRemaining(id) {
+    const cooldown = this.cooldowns.get(id);
+    return cooldown ? Math.max(0, cooldown.remaining) : 0;
+  }
+  getCooldownProgress(id) {
+    const cooldown = this.cooldowns.get(id);
+    if (!cooldown || cooldown.duration <= 0) {
+      return 1;
+    }
+    const elapsed = cooldown.duration - cooldown.remaining;
+    return Math.min(1, Math.max(0, elapsed / cooldown.duration));
+  }
+  getCooldownInfo(id) {
+    const cooldown = this.cooldowns.get(id);
+    if (!cooldown) {
+      return null;
+    }
+    const remaining = Math.max(0, cooldown.remaining);
+    const progress = cooldown.duration > 0 ? Math.min(1, (cooldown.duration - remaining) / cooldown.duration) : 1;
+    return {
+      id: cooldown.id,
+      duration: cooldown.duration,
+      remaining,
+      progress,
+      isReady: remaining <= 0
+    };
+  }
+  resetCooldown(id) {
+    this.cooldowns.delete(id);
+  }
+  clearAllCooldowns() {
+    this.cooldowns.clear();
+  }
+  // =========================================================================
+  // 更新 | Update
+  // =========================================================================
+  update(deltaTime) {
+    if (deltaTime <= 0) {
+      return;
+    }
+    this.updateTimers(deltaTime);
+    this.updateCooldowns(deltaTime);
+  }
+  updateTimers(deltaTime) {
+    const toRemove = [];
+    for (const [id, timer] of this.timers) {
+      if (timer.cancelled) {
+        toRemove.push(id);
+        continue;
+      }
+      timer.remaining -= deltaTime;
+      if (timer.remaining <= 0) {
+        try {
+          timer.callback();
+        } catch (error) {
+          console.error(`Timer callback error [${id}]:`, error);
+        }
+        if (timer.repeating && !timer.cancelled) {
+          timer.remaining += timer.interval;
+          if (timer.remaining < 0) {
+            timer.remaining = timer.interval;
+          }
+        } else {
+          timer.cancelled = true;
+          toRemove.push(id);
+        }
+      }
+    }
+    for (const id of toRemove) {
+      this.timers.delete(id);
+    }
+  }
+  updateCooldowns(deltaTime) {
+    const toRemove = [];
+    for (const [id, cooldown] of this.cooldowns) {
+      cooldown.remaining -= deltaTime;
+      if (cooldown.remaining <= 0) {
+        toRemove.push(id);
+      }
+    }
+    for (const id of toRemove) {
+      this.cooldowns.delete(id);
+    }
+  }
+  clear() {
+    for (const timer of this.timers.values()) {
+      timer.cancelled = true;
+    }
+    this.timers.clear();
+    this.cooldowns.clear();
+  }
+  // =========================================================================
+  // 调试 | Debug
+  // =========================================================================
+  /**
+   * @zh 获取活跃定时器数量
+   * @en Get active timer count
+   */
+  get activeTimerCount() {
+    return this.timers.size;
+  }
+  /**
+   * @zh 获取活跃冷却数量
+   * @en Get active cooldown count
+   */
+  get activeCooldownCount() {
+    return this.cooldowns.size;
+  }
+  /**
+   * @zh 获取所有活跃定时器 ID
+   * @en Get all active timer IDs
+   */
+  getActiveTimerIds() {
+    return Array.from(this.timers.keys());
+  }
+  /**
+   * @zh 获取所有活跃冷却 ID
+   * @en Get all active cooldown IDs
+   */
+  getActiveCooldownIds() {
+    return Array.from(this.cooldowns.keys());
+  }
+};
+__name(_TimerService, "TimerService");
+var TimerService = _TimerService;
+function createTimerService(config) {
+  return new TimerService(config);
+}
+__name(createTimerService, "createTimerService");
+
+// src/tokens.ts
+import { createServiceToken } from "@esengine/ecs-framework";
+var TimerServiceToken = createServiceToken("timerService");
+
+// src/nodes/TimerNodes.ts
+var StartCooldownTemplate = {
+  type: "StartCooldown",
+  title: "Start Cooldown",
+  category: "time",
+  description: "Start a cooldown timer / \u5F00\u59CB\u51B7\u5374\u8BA1\u65F6",
+  keywords: [
+    "timer",
+    "cooldown",
+    "start",
+    "delay"
+  ],
+  menuPath: [
+    "Timer",
+    "Start Cooldown"
+  ],
+  isPure: false,
+  inputs: [
+    {
+      name: "exec",
+      displayName: "",
+      type: "exec"
+    },
+    {
+      name: "id",
+      displayName: "Cooldown ID",
+      type: "string",
+      defaultValue: ""
+    },
+    {
+      name: "duration",
+      displayName: "Duration (ms)",
+      type: "float",
+      defaultValue: 1e3
+    }
+  ],
+  outputs: [
+    {
+      name: "exec",
+      displayName: "",
+      type: "exec"
+    }
+  ],
+  color: "#00bcd4"
+};
+var _StartCooldownExecutor = class _StartCooldownExecutor {
+  execute(node, context) {
+    const ctx = context;
+    const id = ctx.evaluateInput(node.id, "id", "");
+    const duration = ctx.evaluateInput(node.id, "duration", 1e3);
+    if (id && ctx.timerService) {
+      ctx.timerService.startCooldown(id, duration);
+    }
+    return {
+      outputs: {},
+      nextExec: "exec"
+    };
+  }
+};
+__name(_StartCooldownExecutor, "StartCooldownExecutor");
+var StartCooldownExecutor = _StartCooldownExecutor;
+var IsCooldownReadyTemplate = {
+  type: "IsCooldownReady",
+  title: "Is Cooldown Ready",
+  category: "time",
+  description: "Check if cooldown is ready / \u68C0\u67E5\u51B7\u5374\u662F\u5426\u5C31\u7EEA",
+  keywords: [
+    "timer",
+    "cooldown",
+    "ready",
+    "check"
+  ],
+  menuPath: [
+    "Timer",
+    "Is Cooldown Ready"
+  ],
+  isPure: true,
+  inputs: [
+    {
+      name: "id",
+      displayName: "Cooldown ID",
+      type: "string",
+      defaultValue: ""
+    }
+  ],
+  outputs: [
+    {
+      name: "isReady",
+      displayName: "Is Ready",
+      type: "bool"
+    },
+    {
+      name: "isOnCooldown",
+      displayName: "Is On Cooldown",
+      type: "bool"
+    }
+  ],
+  color: "#00bcd4"
+};
+var _IsCooldownReadyExecutor = class _IsCooldownReadyExecutor {
+  execute(node, context) {
+    const ctx = context;
+    const id = ctx.evaluateInput(node.id, "id", "");
+    const isReady = id ? ctx.timerService?.isCooldownReady(id) ?? true : true;
+    const isOnCooldown = !isReady;
+    return {
+      outputs: {
+        isReady,
+        isOnCooldown
+      }
+    };
+  }
+};
+__name(_IsCooldownReadyExecutor, "IsCooldownReadyExecutor");
+var IsCooldownReadyExecutor = _IsCooldownReadyExecutor;
+var GetCooldownProgressTemplate = {
+  type: "GetCooldownProgress",
+  title: "Get Cooldown Progress",
+  category: "time",
+  description: "Get cooldown progress (0-1) / \u83B7\u53D6\u51B7\u5374\u8FDB\u5EA6 (0-1)",
+  keywords: [
+    "timer",
+    "cooldown",
+    "progress",
+    "remaining"
+  ],
+  menuPath: [
+    "Timer",
+    "Get Cooldown Progress"
+  ],
+  isPure: true,
+  inputs: [
+    {
+      name: "id",
+      displayName: "Cooldown ID",
+      type: "string",
+      defaultValue: ""
+    }
+  ],
+  outputs: [
+    {
+      name: "progress",
+      displayName: "Progress",
+      type: "float"
+    },
+    {
+      name: "remaining",
+      displayName: "Remaining (ms)",
+      type: "float"
+    },
+    {
+      name: "isReady",
+      displayName: "Is Ready",
+      type: "bool"
+    }
+  ],
+  color: "#00bcd4"
+};
+var _GetCooldownProgressExecutor = class _GetCooldownProgressExecutor {
+  execute(node, context) {
+    const ctx = context;
+    const id = ctx.evaluateInput(node.id, "id", "");
+    const progress = id ? ctx.timerService?.getCooldownProgress(id) ?? 1 : 1;
+    const remaining = id ? ctx.timerService?.getCooldownRemaining(id) ?? 0 : 0;
+    const isReady = remaining <= 0;
+    return {
+      outputs: {
+        progress,
+        remaining,
+        isReady
+      }
+    };
+  }
+};
+__name(_GetCooldownProgressExecutor, "GetCooldownProgressExecutor");
+var GetCooldownProgressExecutor = _GetCooldownProgressExecutor;
+var ResetCooldownTemplate = {
+  type: "ResetCooldown",
+  title: "Reset Cooldown",
+  category: "time",
+  description: "Reset a cooldown (make it ready) / \u91CD\u7F6E\u51B7\u5374\uFF08\u4F7F\u5176\u5C31\u7EEA\uFF09",
+  keywords: [
+    "timer",
+    "cooldown",
+    "reset",
+    "clear"
+  ],
+  menuPath: [
+    "Timer",
+    "Reset Cooldown"
+  ],
+  isPure: false,
+  inputs: [
+    {
+      name: "exec",
+      displayName: "",
+      type: "exec"
+    },
+    {
+      name: "id",
+      displayName: "Cooldown ID",
+      type: "string",
+      defaultValue: ""
+    }
+  ],
+  outputs: [
+    {
+      name: "exec",
+      displayName: "",
+      type: "exec"
+    }
+  ],
+  color: "#00bcd4"
+};
+var _ResetCooldownExecutor = class _ResetCooldownExecutor {
+  execute(node, context) {
+    const ctx = context;
+    const id = ctx.evaluateInput(node.id, "id", "");
+    if (id && ctx.timerService) {
+      ctx.timerService.resetCooldown(id);
+    }
+    return {
+      outputs: {},
+      nextExec: "exec"
+    };
+  }
+};
+__name(_ResetCooldownExecutor, "ResetCooldownExecutor");
+var ResetCooldownExecutor = _ResetCooldownExecutor;
+var GetCooldownInfoTemplate = {
+  type: "GetCooldownInfo",
+  title: "Get Cooldown Info",
+  category: "time",
+  description: "Get detailed cooldown information / \u83B7\u53D6\u8BE6\u7EC6\u51B7\u5374\u4FE1\u606F",
+  keywords: [
+    "timer",
+    "cooldown",
+    "info",
+    "details"
+  ],
+  menuPath: [
+    "Timer",
+    "Get Cooldown Info"
+  ],
+  isPure: true,
+  inputs: [
+    {
+      name: "id",
+      displayName: "Cooldown ID",
+      type: "string",
+      defaultValue: ""
+    }
+  ],
+  outputs: [
+    {
+      name: "exists",
+      displayName: "Exists",
+      type: "bool"
+    },
+    {
+      name: "duration",
+      displayName: "Duration (ms)",
+      type: "float"
+    },
+    {
+      name: "remaining",
+      displayName: "Remaining (ms)",
+      type: "float"
+    },
+    {
+      name: "progress",
+      displayName: "Progress",
+      type: "float"
+    },
+    {
+      name: "isReady",
+      displayName: "Is Ready",
+      type: "bool"
+    }
+  ],
+  color: "#00bcd4"
+};
+var _GetCooldownInfoExecutor = class _GetCooldownInfoExecutor {
+  execute(node, context) {
+    const ctx = context;
+    const id = ctx.evaluateInput(node.id, "id", "");
+    const info = id ? ctx.timerService?.getCooldownInfo(id) : null;
+    return {
+      outputs: {
+        exists: info !== null,
+        duration: info?.duration ?? 0,
+        remaining: info?.remaining ?? 0,
+        progress: info?.progress ?? 1,
+        isReady: info?.isReady ?? true
+      }
+    };
+  }
+};
+__name(_GetCooldownInfoExecutor, "GetCooldownInfoExecutor");
+var GetCooldownInfoExecutor = _GetCooldownInfoExecutor;
+var HasTimerTemplate = {
+  type: "HasTimer",
+  title: "Has Timer",
+  category: "time",
+  description: "Check if a timer exists / \u68C0\u67E5\u5B9A\u65F6\u5668\u662F\u5426\u5B58\u5728",
+  keywords: [
+    "timer",
+    "exists",
+    "check",
+    "has"
+  ],
+  menuPath: [
+    "Timer",
+    "Has Timer"
+  ],
+  isPure: true,
+  inputs: [
+    {
+      name: "id",
+      displayName: "Timer ID",
+      type: "string",
+      defaultValue: ""
+    }
+  ],
+  outputs: [
+    {
+      name: "exists",
+      displayName: "Exists",
+      type: "bool"
+    }
+  ],
+  color: "#00bcd4"
+};
+var _HasTimerExecutor = class _HasTimerExecutor {
+  execute(node, context) {
+    const ctx = context;
+    const id = ctx.evaluateInput(node.id, "id", "");
+    const exists = id ? ctx.timerService?.hasTimer(id) ?? false : false;
+    return {
+      outputs: {
+        exists
+      }
+    };
+  }
+};
+__name(_HasTimerExecutor, "HasTimerExecutor");
+var HasTimerExecutor = _HasTimerExecutor;
+var CancelTimerTemplate = {
+  type: "CancelTimer",
+  title: "Cancel Timer",
+  category: "time",
+  description: "Cancel a timer by ID / \u901A\u8FC7 ID \u53D6\u6D88\u5B9A\u65F6\u5668",
+  keywords: [
+    "timer",
+    "cancel",
+    "stop",
+    "clear"
+  ],
+  menuPath: [
+    "Timer",
+    "Cancel Timer"
+  ],
+  isPure: false,
+  inputs: [
+    {
+      name: "exec",
+      displayName: "",
+      type: "exec"
+    },
+    {
+      name: "id",
+      displayName: "Timer ID",
+      type: "string",
+      defaultValue: ""
+    }
+  ],
+  outputs: [
+    {
+      name: "exec",
+      displayName: "",
+      type: "exec"
+    }
+  ],
+  color: "#00bcd4"
+};
+var _CancelTimerExecutor = class _CancelTimerExecutor {
+  execute(node, context) {
+    const ctx = context;
+    const id = ctx.evaluateInput(node.id, "id", "");
+    if (id && ctx.timerService) {
+      ctx.timerService.cancelById(id);
+    }
+    return {
+      outputs: {},
+      nextExec: "exec"
+    };
+  }
+};
+__name(_CancelTimerExecutor, "CancelTimerExecutor");
+var CancelTimerExecutor = _CancelTimerExecutor;
+var GetTimerRemainingTemplate = {
+  type: "GetTimerRemaining",
+  title: "Get Timer Remaining",
+  category: "time",
+  description: "Get remaining time for a timer / \u83B7\u53D6\u5B9A\u65F6\u5668\u5269\u4F59\u65F6\u95F4",
+  keywords: [
+    "timer",
+    "remaining",
+    "time",
+    "left"
+  ],
+  menuPath: [
+    "Timer",
+    "Get Timer Remaining"
+  ],
+  isPure: true,
+  inputs: [
+    {
+      name: "id",
+      displayName: "Timer ID",
+      type: "string",
+      defaultValue: ""
+    }
+  ],
+  outputs: [
+    {
+      name: "remaining",
+      displayName: "Remaining (ms)",
+      type: "float"
+    },
+    {
+      name: "exists",
+      displayName: "Exists",
+      type: "bool"
+    }
+  ],
+  color: "#00bcd4"
+};
+var _GetTimerRemainingExecutor = class _GetTimerRemainingExecutor {
+  execute(node, context) {
+    const ctx = context;
+    const id = ctx.evaluateInput(node.id, "id", "");
+    const info = id ? ctx.timerService?.getTimerInfo(id) : null;
+    return {
+      outputs: {
+        remaining: info?.remaining ?? 0,
+        exists: info !== null
+      }
+    };
+  }
+};
+__name(_GetTimerRemainingExecutor, "GetTimerRemainingExecutor");
+var GetTimerRemainingExecutor = _GetTimerRemainingExecutor;
+var TimerNodeDefinitions = [
+  {
+    template: StartCooldownTemplate,
+    executor: new StartCooldownExecutor()
+  },
+  {
+    template: IsCooldownReadyTemplate,
+    executor: new IsCooldownReadyExecutor()
+  },
+  {
+    template: GetCooldownProgressTemplate,
+    executor: new GetCooldownProgressExecutor()
+  },
+  {
+    template: ResetCooldownTemplate,
+    executor: new ResetCooldownExecutor()
+  },
+  {
+    template: GetCooldownInfoTemplate,
+    executor: new GetCooldownInfoExecutor()
+  },
+  {
+    template: HasTimerTemplate,
+    executor: new HasTimerExecutor()
+  },
+  {
+    template: CancelTimerTemplate,
+    executor: new CancelTimerExecutor()
+  },
+  {
+    template: GetTimerRemainingTemplate,
+    executor: new GetTimerRemainingExecutor()
+  }
+];
+export {
+  CancelTimerExecutor,
+  CancelTimerTemplate,
+  GetCooldownInfoExecutor,
+  GetCooldownInfoTemplate,
+  GetCooldownProgressExecutor,
+  GetCooldownProgressTemplate,
+  GetTimerRemainingExecutor,
+  GetTimerRemainingTemplate,
+  HasTimerExecutor,
+  HasTimerTemplate,
+  IsCooldownReadyExecutor,
+  IsCooldownReadyTemplate,
+  ResetCooldownExecutor,
+  ResetCooldownTemplate,
+  StartCooldownExecutor,
+  StartCooldownTemplate,
+  TimerNodeDefinitions,
+  TimerService,
+  TimerServiceToken,
+  createTimerService
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/TimerService.ts","../src/tokens.ts","../src/nodes/TimerNodes.ts"],"sourcesContent":["/**\n * @zh 定时器服务实现\n * @en Timer Service Implementation\n *\n * @zh 提供定时器调度和冷却管理的默认实现\n * @en Provides default implementation for timer scheduling and cooldown management\n */\n\nimport type {\n    ITimerService,\n    TimerHandle,\n    TimerInfo,\n    TimerCallback,\n    CooldownInfo\n} from './ITimerService';\n\n// =============================================================================\n// 内部类型 | Internal Types\n// =============================================================================\n\n/**\n * @zh 内部定时器数据\n * @en Internal timer data\n */\ninterface InternalTimer {\n    id: string;\n    callback: TimerCallback;\n    remaining: number;\n    repeating: boolean;\n    interval: number;\n    cancelled: boolean;\n}\n\n/**\n * @zh 内部冷却数据\n * @en Internal cooldown data\n */\ninterface InternalCooldown {\n    id: string;\n    duration: number;\n    remaining: number;\n}\n\n// =============================================================================\n// 定时器句柄实现 | Timer Handle Implementation\n// =============================================================================\n\n/**\n * @zh 定时器句柄实现\n * @en Timer handle implementation\n */\nclass TimerHandleImpl implements TimerHandle {\n    private timer: InternalTimer;\n\n    constructor(timer: InternalTimer) {\n        this.timer = timer;\n    }\n\n    get id(): string {\n        return this.timer.id;\n    }\n\n    get isValid(): boolean {\n        return !this.timer.cancelled;\n    }\n\n    cancel(): void {\n        this.timer.cancelled = true;\n    }\n}\n\n// =============================================================================\n// 定时器服务实现 | Timer Service Implementation\n// =============================================================================\n\n/**\n * @zh 定时器服务配置\n * @en Timer service configuration\n */\nexport interface TimerServiceConfig {\n    /**\n     * @zh 最大定时器数量（0 表示无限制）\n     * @en Maximum number of timers (0 for unlimited)\n     */\n    maxTimers?: number;\n\n    /**\n     * @zh 最大冷却数量（0 表示无限制）\n     * @en Maximum number of cooldowns (0 for unlimited)\n     */\n    maxCooldowns?: number;\n}\n\n/**\n * @zh 定时器服务实现\n * @en Timer service implementation\n *\n * @example\n * ```typescript\n * const timerService = new TimerService();\n *\n * // 一次性定时器 | One-time timer\n * const handle = timerService.schedule('myTimer', 1000, () => {\n *     console.log('Timer fired!');\n * });\n *\n * // 重复定时器 | Repeating timer\n * timerService.scheduleRepeating('heartbeat', 100, () => {\n *     console.log('Tick');\n * });\n *\n * // 冷却系统 | Cooldown system\n * timerService.startCooldown('skill_fireball', 5000);\n * if (timerService.isCooldownReady('skill_fireball')) {\n *     // 可以使用技能 | Can use skill\n * }\n *\n * // 每帧更新 | Update each frame\n * timerService.update(deltaTime);\n * ```\n */\nexport class TimerService implements ITimerService {\n    private timers: Map<string, InternalTimer> = new Map();\n    private cooldowns: Map<string, InternalCooldown> = new Map();\n    private config: Required<TimerServiceConfig>;\n\n    constructor(config: TimerServiceConfig = {}) {\n        this.config = {\n            maxTimers: config.maxTimers ?? 0,\n            maxCooldowns: config.maxCooldowns ?? 0\n        };\n    }\n\n    // =========================================================================\n    // 定时器 API | Timer API\n    // =========================================================================\n\n    schedule(id: string, delay: number, callback: TimerCallback): TimerHandle {\n        this.cancelById(id);\n\n        if (this.config.maxTimers > 0 && this.timers.size >= this.config.maxTimers) {\n            throw new Error(`Maximum timer limit reached: ${this.config.maxTimers}`);\n        }\n\n        const timer: InternalTimer = {\n            id,\n            callback,\n            remaining: Math.max(0, delay),\n            repeating: false,\n            interval: 0,\n            cancelled: false\n        };\n\n        this.timers.set(id, timer);\n        return new TimerHandleImpl(timer);\n    }\n\n    scheduleRepeating(\n        id: string,\n        interval: number,\n        callback: TimerCallback,\n        immediate = false\n    ): TimerHandle {\n        this.cancelById(id);\n\n        if (this.config.maxTimers > 0 && this.timers.size >= this.config.maxTimers) {\n            throw new Error(`Maximum timer limit reached: ${this.config.maxTimers}`);\n        }\n\n        const safeInterval = Math.max(1, interval);\n\n        const timer: InternalTimer = {\n            id,\n            callback,\n            remaining: immediate ? 0 : safeInterval,\n            repeating: true,\n            interval: safeInterval,\n            cancelled: false\n        };\n\n        this.timers.set(id, timer);\n        return new TimerHandleImpl(timer);\n    }\n\n    cancel(handle: TimerHandle): void {\n        handle.cancel();\n        this.timers.delete(handle.id);\n    }\n\n    cancelById(id: string): void {\n        const timer = this.timers.get(id);\n        if (timer) {\n            timer.cancelled = true;\n            this.timers.delete(id);\n        }\n    }\n\n    hasTimer(id: string): boolean {\n        const timer = this.timers.get(id);\n        return timer !== undefined && !timer.cancelled;\n    }\n\n    getTimerInfo(id: string): TimerInfo | null {\n        const timer = this.timers.get(id);\n        if (!timer || timer.cancelled) {\n            return null;\n        }\n\n        return {\n            id: timer.id,\n            remaining: timer.remaining,\n            repeating: timer.repeating,\n            interval: timer.repeating ? timer.interval : undefined\n        };\n    }\n\n    // =========================================================================\n    // 冷却 API | Cooldown API\n    // =========================================================================\n\n    startCooldown(id: string, duration: number): void {\n        if (this.config.maxCooldowns > 0 && !this.cooldowns.has(id)) {\n            if (this.cooldowns.size >= this.config.maxCooldowns) {\n                throw new Error(`Maximum cooldown limit reached: ${this.config.maxCooldowns}`);\n            }\n        }\n\n        const safeDuration = Math.max(0, duration);\n\n        this.cooldowns.set(id, {\n            id,\n            duration: safeDuration,\n            remaining: safeDuration\n        });\n    }\n\n    isOnCooldown(id: string): boolean {\n        const cooldown = this.cooldowns.get(id);\n        return cooldown !== undefined && cooldown.remaining > 0;\n    }\n\n    isCooldownReady(id: string): boolean {\n        return !this.isOnCooldown(id);\n    }\n\n    getCooldownRemaining(id: string): number {\n        const cooldown = this.cooldowns.get(id);\n        return cooldown ? Math.max(0, cooldown.remaining) : 0;\n    }\n\n    getCooldownProgress(id: string): number {\n        const cooldown = this.cooldowns.get(id);\n        if (!cooldown || cooldown.duration <= 0) {\n            return 1;\n        }\n\n        const elapsed = cooldown.duration - cooldown.remaining;\n        return Math.min(1, Math.max(0, elapsed / cooldown.duration));\n    }\n\n    getCooldownInfo(id: string): CooldownInfo | null {\n        const cooldown = this.cooldowns.get(id);\n        if (!cooldown) {\n            return null;\n        }\n\n        const remaining = Math.max(0, cooldown.remaining);\n        const progress = cooldown.duration > 0\n            ? Math.min(1, (cooldown.duration - remaining) / cooldown.duration)\n            : 1;\n\n        return {\n            id: cooldown.id,\n            duration: cooldown.duration,\n            remaining,\n            progress,\n            isReady: remaining <= 0\n        };\n    }\n\n    resetCooldown(id: string): void {\n        this.cooldowns.delete(id);\n    }\n\n    clearAllCooldowns(): void {\n        this.cooldowns.clear();\n    }\n\n    // =========================================================================\n    // 更新 | Update\n    // =========================================================================\n\n    update(deltaTime: number): void {\n        if (deltaTime <= 0) {\n            return;\n        }\n\n        this.updateTimers(deltaTime);\n        this.updateCooldowns(deltaTime);\n    }\n\n    private updateTimers(deltaTime: number): void {\n        const toRemove: string[] = [];\n\n        for (const [id, timer] of this.timers) {\n            if (timer.cancelled) {\n                toRemove.push(id);\n                continue;\n            }\n\n            timer.remaining -= deltaTime;\n\n            if (timer.remaining <= 0) {\n                try {\n                    timer.callback();\n                } catch (error) {\n                    console.error(`Timer callback error [${id}]:`, error);\n                }\n\n                if (timer.repeating && !timer.cancelled) {\n                    timer.remaining += timer.interval;\n                    if (timer.remaining < 0) {\n                        timer.remaining = timer.interval;\n                    }\n                } else {\n                    timer.cancelled = true;\n                    toRemove.push(id);\n                }\n            }\n        }\n\n        for (const id of toRemove) {\n            this.timers.delete(id);\n        }\n    }\n\n    private updateCooldowns(deltaTime: number): void {\n        const toRemove: string[] = [];\n\n        for (const [id, cooldown] of this.cooldowns) {\n            cooldown.remaining -= deltaTime;\n\n            if (cooldown.remaining <= 0) {\n                toRemove.push(id);\n            }\n        }\n\n        for (const id of toRemove) {\n            this.cooldowns.delete(id);\n        }\n    }\n\n    clear(): void {\n        for (const timer of this.timers.values()) {\n            timer.cancelled = true;\n        }\n        this.timers.clear();\n        this.cooldowns.clear();\n    }\n\n    // =========================================================================\n    // 调试 | Debug\n    // =========================================================================\n\n    /**\n     * @zh 获取活跃定时器数量\n     * @en Get active timer count\n     */\n    get activeTimerCount(): number {\n        return this.timers.size;\n    }\n\n    /**\n     * @zh 获取活跃冷却数量\n     * @en Get active cooldown count\n     */\n    get activeCooldownCount(): number {\n        return this.cooldowns.size;\n    }\n\n    /**\n     * @zh 获取所有活跃定时器 ID\n     * @en Get all active timer IDs\n     */\n    getActiveTimerIds(): string[] {\n        return Array.from(this.timers.keys());\n    }\n\n    /**\n     * @zh 获取所有活跃冷却 ID\n     * @en Get all active cooldown IDs\n     */\n    getActiveCooldownIds(): string[] {\n        return Array.from(this.cooldowns.keys());\n    }\n}\n\n// =============================================================================\n// 工厂函数 | Factory Functions\n// =============================================================================\n\n/**\n * @zh 创建定时器服务\n * @en Create timer service\n *\n * @param config - @zh 配置选项 @en Configuration options\n * @returns @zh 定时器服务实例 @en Timer service instance\n */\nexport function createTimerService(config?: TimerServiceConfig): ITimerService {\n    return new TimerService(config);\n}\n","/**\n * @zh 定时器服务令牌\n * @en Timer Service Tokens\n */\n\nimport { createServiceToken } from '@esengine/ecs-framework';\nimport type { ITimerService } from './ITimerService';\n\n/**\n * @zh 定时器服务令牌\n * @en Timer service token\n *\n * @zh 用于注入定时器服务\n * @en Used for injecting timer service\n */\nexport const TimerServiceToken = createServiceToken<ITimerService>('timerService');\n","/**\n * @zh 定时器蓝图节点\n * @en Timer Blueprint Nodes\n *\n * @zh 提供定时器和冷却功能的蓝图节点\n * @en Provides blueprint nodes for timer and cooldown functionality\n */\n\nimport type { BlueprintNodeTemplate, BlueprintNode, INodeExecutor, ExecutionResult } from '@esengine/blueprint';\nimport type { ITimerService } from '../ITimerService';\n\n// =============================================================================\n// 执行上下文接口 | Execution Context Interface\n// =============================================================================\n\n/**\n * @zh 定时器上下文\n * @en Timer context\n */\ninterface TimerContext {\n    timerService: ITimerService;\n    evaluateInput(nodeId: string, pinName: string, defaultValue?: unknown): unknown;\n    setOutputs(nodeId: string, outputs: Record<string, unknown>): void;\n}\n\n// =============================================================================\n// StartCooldown 节点 | StartCooldown Node\n// =============================================================================\n\n/**\n * @zh StartCooldown 节点模板\n * @en StartCooldown node template\n */\nexport const StartCooldownTemplate: BlueprintNodeTemplate = {\n    type: 'StartCooldown',\n    title: 'Start Cooldown',\n    category: 'time',\n    description: 'Start a cooldown timer / 开始冷却计时',\n    keywords: ['timer', 'cooldown', 'start', 'delay'],\n    menuPath: ['Timer', 'Start Cooldown'],\n    isPure: false,\n    inputs: [\n        {\n            name: 'exec',\n            displayName: '',\n            type: 'exec'\n        },\n        {\n            name: 'id',\n            displayName: 'Cooldown ID',\n            type: 'string',\n            defaultValue: ''\n        },\n        {\n            name: 'duration',\n            displayName: 'Duration (ms)',\n            type: 'float',\n            defaultValue: 1000\n        }\n    ],\n    outputs: [\n        {\n            name: 'exec',\n            displayName: '',\n            type: 'exec'\n        }\n    ],\n    color: '#00bcd4'\n};\n\n/**\n * @zh StartCooldown 节点执行器\n * @en StartCooldown node executor\n */\nexport class StartCooldownExecutor implements INodeExecutor {\n    execute(node: BlueprintNode, context: unknown): ExecutionResult {\n        const ctx = context as TimerContext;\n        const id = ctx.evaluateInput(node.id, 'id', '') as string;\n        const duration = ctx.evaluateInput(node.id, 'duration', 1000) as number;\n\n        if (id && ctx.timerService) {\n            ctx.timerService.startCooldown(id, duration);\n        }\n\n        return {\n            outputs: {},\n            nextExec: 'exec'\n        };\n    }\n}\n\n// =============================================================================\n// IsCooldownReady 节点 | IsCooldownReady Node\n// =============================================================================\n\n/**\n * @zh IsCooldownReady 节点模板\n * @en IsCooldownReady node template\n */\nexport const IsCooldownReadyTemplate: BlueprintNodeTemplate = {\n    type: 'IsCooldownReady',\n    title: 'Is Cooldown Ready',\n    category: 'time',\n    description: 'Check if cooldown is ready / 检查冷却是否就绪',\n    keywords: ['timer', 'cooldown', 'ready', 'check'],\n    menuPath: ['Timer', 'Is Cooldown Ready'],\n    isPure: true,\n    inputs: [\n        {\n            name: 'id',\n            displayName: 'Cooldown ID',\n            type: 'string',\n            defaultValue: ''\n        }\n    ],\n    outputs: [\n        {\n            name: 'isReady',\n            displayName: 'Is Ready',\n            type: 'bool'\n        },\n        {\n            name: 'isOnCooldown',\n            displayName: 'Is On Cooldown',\n            type: 'bool'\n        }\n    ],\n    color: '#00bcd4'\n};\n\n/**\n * @zh IsCooldownReady 节点执行器\n * @en IsCooldownReady node executor\n */\nexport class IsCooldownReadyExecutor implements INodeExecutor {\n    execute(node: BlueprintNode, context: unknown): ExecutionResult {\n        const ctx = context as TimerContext;\n        const id = ctx.evaluateInput(node.id, 'id', '') as string;\n\n        const isReady = id ? ctx.timerService?.isCooldownReady(id) ?? true : true;\n        const isOnCooldown = !isReady;\n\n        return {\n            outputs: {\n                isReady,\n                isOnCooldown\n            }\n        };\n    }\n}\n\n// =============================================================================\n// GetCooldownProgress 节点 | GetCooldownProgress Node\n// =============================================================================\n\n/**\n * @zh GetCooldownProgress 节点模板\n * @en GetCooldownProgress node template\n */\nexport const GetCooldownProgressTemplate: BlueprintNodeTemplate = {\n    type: 'GetCooldownProgress',\n    title: 'Get Cooldown Progress',\n    category: 'time',\n    description: 'Get cooldown progress (0-1) / 获取冷却进度 (0-1)',\n    keywords: ['timer', 'cooldown', 'progress', 'remaining'],\n    menuPath: ['Timer', 'Get Cooldown Progress'],\n    isPure: true,\n    inputs: [\n        {\n            name: 'id',\n            displayName: 'Cooldown ID',\n            type: 'string',\n            defaultValue: ''\n        }\n    ],\n    outputs: [\n        {\n            name: 'progress',\n            displayName: 'Progress',\n            type: 'float'\n        },\n        {\n            name: 'remaining',\n            displayName: 'Remaining (ms)',\n            type: 'float'\n        },\n        {\n            name: 'isReady',\n            displayName: 'Is Ready',\n            type: 'bool'\n        }\n    ],\n    color: '#00bcd4'\n};\n\n/**\n * @zh GetCooldownProgress 节点执行器\n * @en GetCooldownProgress node executor\n */\nexport class GetCooldownProgressExecutor implements INodeExecutor {\n    execute(node: BlueprintNode, context: unknown): ExecutionResult {\n        const ctx = context as TimerContext;\n        const id = ctx.evaluateInput(node.id, 'id', '') as string;\n\n        const progress = id ? ctx.timerService?.getCooldownProgress(id) ?? 1 : 1;\n        const remaining = id ? ctx.timerService?.getCooldownRemaining(id) ?? 0 : 0;\n        const isReady = remaining <= 0;\n\n        return {\n            outputs: {\n                progress,\n                remaining,\n                isReady\n            }\n        };\n    }\n}\n\n// =============================================================================\n// ResetCooldown 节点 | ResetCooldown Node\n// =============================================================================\n\n/**\n * @zh ResetCooldown 节点模板\n * @en ResetCooldown node template\n */\nexport const ResetCooldownTemplate: BlueprintNodeTemplate = {\n    type: 'ResetCooldown',\n    title: 'Reset Cooldown',\n    category: 'time',\n    description: 'Reset a cooldown (make it ready) / 重置冷却（使其就绪）',\n    keywords: ['timer', 'cooldown', 'reset', 'clear'],\n    menuPath: ['Timer', 'Reset Cooldown'],\n    isPure: false,\n    inputs: [\n        {\n            name: 'exec',\n            displayName: '',\n            type: 'exec'\n        },\n        {\n            name: 'id',\n            displayName: 'Cooldown ID',\n            type: 'string',\n            defaultValue: ''\n        }\n    ],\n    outputs: [\n        {\n            name: 'exec',\n            displayName: '',\n            type: 'exec'\n        }\n    ],\n    color: '#00bcd4'\n};\n\n/**\n * @zh ResetCooldown 节点执行器\n * @en ResetCooldown node executor\n */\nexport class ResetCooldownExecutor implements INodeExecutor {\n    execute(node: BlueprintNode, context: unknown): ExecutionResult {\n        const ctx = context as TimerContext;\n        const id = ctx.evaluateInput(node.id, 'id', '') as string;\n\n        if (id && ctx.timerService) {\n            ctx.timerService.resetCooldown(id);\n        }\n\n        return {\n            outputs: {},\n            nextExec: 'exec'\n        };\n    }\n}\n\n// =============================================================================\n// GetCooldownInfo 节点 | GetCooldownInfo Node\n// =============================================================================\n\n/**\n * @zh GetCooldownInfo 节点模板\n * @en GetCooldownInfo node template\n */\nexport const GetCooldownInfoTemplate: BlueprintNodeTemplate = {\n    type: 'GetCooldownInfo',\n    title: 'Get Cooldown Info',\n    category: 'time',\n    description: 'Get detailed cooldown information / 获取详细冷却信息',\n    keywords: ['timer', 'cooldown', 'info', 'details'],\n    menuPath: ['Timer', 'Get Cooldown Info'],\n    isPure: true,\n    inputs: [\n        {\n            name: 'id',\n            displayName: 'Cooldown ID',\n            type: 'string',\n            defaultValue: ''\n        }\n    ],\n    outputs: [\n        {\n            name: 'exists',\n            displayName: 'Exists',\n            type: 'bool'\n        },\n        {\n            name: 'duration',\n            displayName: 'Duration (ms)',\n            type: 'float'\n        },\n        {\n            name: 'remaining',\n            displayName: 'Remaining (ms)',\n            type: 'float'\n        },\n        {\n            name: 'progress',\n            displayName: 'Progress',\n            type: 'float'\n        },\n        {\n            name: 'isReady',\n            displayName: 'Is Ready',\n            type: 'bool'\n        }\n    ],\n    color: '#00bcd4'\n};\n\n/**\n * @zh GetCooldownInfo 节点执行器\n * @en GetCooldownInfo node executor\n */\nexport class GetCooldownInfoExecutor implements INodeExecutor {\n    execute(node: BlueprintNode, context: unknown): ExecutionResult {\n        const ctx = context as TimerContext;\n        const id = ctx.evaluateInput(node.id, 'id', '') as string;\n\n        const info = id ? ctx.timerService?.getCooldownInfo(id) : null;\n\n        return {\n            outputs: {\n                exists: info !== null,\n                duration: info?.duration ?? 0,\n                remaining: info?.remaining ?? 0,\n                progress: info?.progress ?? 1,\n                isReady: info?.isReady ?? true\n            }\n        };\n    }\n}\n\n// =============================================================================\n// HasTimer 节点 | HasTimer Node\n// =============================================================================\n\n/**\n * @zh HasTimer 节点模板\n * @en HasTimer node template\n */\nexport const HasTimerTemplate: BlueprintNodeTemplate = {\n    type: 'HasTimer',\n    title: 'Has Timer',\n    category: 'time',\n    description: 'Check if a timer exists / 检查定时器是否存在',\n    keywords: ['timer', 'exists', 'check', 'has'],\n    menuPath: ['Timer', 'Has Timer'],\n    isPure: true,\n    inputs: [\n        {\n            name: 'id',\n            displayName: 'Timer ID',\n            type: 'string',\n            defaultValue: ''\n        }\n    ],\n    outputs: [\n        {\n            name: 'exists',\n            displayName: 'Exists',\n            type: 'bool'\n        }\n    ],\n    color: '#00bcd4'\n};\n\n/**\n * @zh HasTimer 节点执行器\n * @en HasTimer node executor\n */\nexport class HasTimerExecutor implements INodeExecutor {\n    execute(node: BlueprintNode, context: unknown): ExecutionResult {\n        const ctx = context as TimerContext;\n        const id = ctx.evaluateInput(node.id, 'id', '') as string;\n\n        const exists = id ? ctx.timerService?.hasTimer(id) ?? false : false;\n\n        return {\n            outputs: {\n                exists\n            }\n        };\n    }\n}\n\n// =============================================================================\n// CancelTimer 节点 | CancelTimer Node\n// =============================================================================\n\n/**\n * @zh CancelTimer 节点模板\n * @en CancelTimer node template\n */\nexport const CancelTimerTemplate: BlueprintNodeTemplate = {\n    type: 'CancelTimer',\n    title: 'Cancel Timer',\n    category: 'time',\n    description: 'Cancel a timer by ID / 通过 ID 取消定时器',\n    keywords: ['timer', 'cancel', 'stop', 'clear'],\n    menuPath: ['Timer', 'Cancel Timer'],\n    isPure: false,\n    inputs: [\n        {\n            name: 'exec',\n            displayName: '',\n            type: 'exec'\n        },\n        {\n            name: 'id',\n            displayName: 'Timer ID',\n            type: 'string',\n            defaultValue: ''\n        }\n    ],\n    outputs: [\n        {\n            name: 'exec',\n            displayName: '',\n            type: 'exec'\n        }\n    ],\n    color: '#00bcd4'\n};\n\n/**\n * @zh CancelTimer 节点执行器\n * @en CancelTimer node executor\n */\nexport class CancelTimerExecutor implements INodeExecutor {\n    execute(node: BlueprintNode, context: unknown): ExecutionResult {\n        const ctx = context as TimerContext;\n        const id = ctx.evaluateInput(node.id, 'id', '') as string;\n\n        if (id && ctx.timerService) {\n            ctx.timerService.cancelById(id);\n        }\n\n        return {\n            outputs: {},\n            nextExec: 'exec'\n        };\n    }\n}\n\n// =============================================================================\n// GetTimerRemaining 节点 | GetTimerRemaining Node\n// =============================================================================\n\n/**\n * @zh GetTimerRemaining 节点模板\n * @en GetTimerRemaining node template\n */\nexport const GetTimerRemainingTemplate: BlueprintNodeTemplate = {\n    type: 'GetTimerRemaining',\n    title: 'Get Timer Remaining',\n    category: 'time',\n    description: 'Get remaining time for a timer / 获取定时器剩余时间',\n    keywords: ['timer', 'remaining', 'time', 'left'],\n    menuPath: ['Timer', 'Get Timer Remaining'],\n    isPure: true,\n    inputs: [\n        {\n            name: 'id',\n            displayName: 'Timer ID',\n            type: 'string',\n            defaultValue: ''\n        }\n    ],\n    outputs: [\n        {\n            name: 'remaining',\n            displayName: 'Remaining (ms)',\n            type: 'float'\n        },\n        {\n            name: 'exists',\n            displayName: 'Exists',\n            type: 'bool'\n        }\n    ],\n    color: '#00bcd4'\n};\n\n/**\n * @zh GetTimerRemaining 节点执行器\n * @en GetTimerRemaining node executor\n */\nexport class GetTimerRemainingExecutor implements INodeExecutor {\n    execute(node: BlueprintNode, context: unknown): ExecutionResult {\n        const ctx = context as TimerContext;\n        const id = ctx.evaluateInput(node.id, 'id', '') as string;\n\n        const info = id ? ctx.timerService?.getTimerInfo(id) : null;\n\n        return {\n            outputs: {\n                remaining: info?.remaining ?? 0,\n                exists: info !== null\n            }\n        };\n    }\n}\n\n// =============================================================================\n// 节点定义集合 | Node Definition Collection\n// =============================================================================\n\n/**\n * @zh 定时器节点定义\n * @en Timer node definitions\n */\nexport const TimerNodeDefinitions = [\n    { template: StartCooldownTemplate, executor: new StartCooldownExecutor() },\n    { template: IsCooldownReadyTemplate, executor: new IsCooldownReadyExecutor() },\n    { template: GetCooldownProgressTemplate, executor: new GetCooldownProgressExecutor() },\n    { template: ResetCooldownTemplate, executor: new ResetCooldownExecutor() },\n    { template: GetCooldownInfoTemplate, executor: new GetCooldownInfoExecutor() },\n    { template: HasTimerTemplate, executor: new HasTimerExecutor() },\n    { template: CancelTimerTemplate, executor: new CancelTimerExecutor() },\n    { template: GetTimerRemainingTemplate, executor: new GetTimerRemainingExecutor() }\n];\n"],"mappings":"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","names":["TimerHandleImpl","timer","id","isValid","cancelled","cancel","TimerService","config","timers","Map","cooldowns","maxTimers","maxCooldowns","schedule","delay","callback","cancelById","size","Error","remaining","Math","max","repeating","interval","set","scheduleRepeating","immediate","safeInterval","handle","delete","get","hasTimer","undefined","getTimerInfo","startCooldown","duration","has","safeDuration","isOnCooldown","cooldown","isCooldownReady","getCooldownRemaining","getCooldownProgress","elapsed","min","getCooldownInfo","progress","isReady","resetCooldown","clearAllCooldowns","clear","update","deltaTime","updateTimers","updateCooldowns","toRemove","push","error","console","values","activeTimerCount","activeCooldownCount","getActiveTimerIds","Array","from","keys","getActiveCooldownIds","createTimerService","createServiceToken","TimerServiceToken","StartCooldownTemplate","type","title","category","description","keywords","menuPath","isPure","inputs","name","displayName","defaultValue","outputs","color","StartCooldownExecutor","execute","node","context","ctx","id","evaluateInput","duration","timerService","startCooldown","nextExec","IsCooldownReadyTemplate","IsCooldownReadyExecutor","isReady","isCooldownReady","isOnCooldown","GetCooldownProgressTemplate","GetCooldownProgressExecutor","progress","getCooldownProgress","remaining","getCooldownRemaining","ResetCooldownTemplate","ResetCooldownExecutor","resetCooldown","GetCooldownInfoTemplate","GetCooldownInfoExecutor","info","getCooldownInfo","exists","HasTimerTemplate","HasTimerExecutor","hasTimer","CancelTimerTemplate","CancelTimerExecutor","cancelById","GetTimerRemainingTemplate","GetTimerRemainingExecutor","getTimerInfo","TimerNodeDefinitions","template","executor"]}

package/module.json

@@ -0,0 +1,23 @@
+{
+    "id": "timer",
+    "name": "@esengine/timer",
+    "globalKey": "timer",
+    "displayName": "Timer & Cooldown",
+    "description": "定时器和冷却系统 | Timer and cooldown system",
+    "version": "1.0.0",
+    "category": "Other",
+    "icon": "Timer",
+    "tags": ["timer", "cooldown", "delay", "schedule"],
+    "isCore": false,
+    "defaultEnabled": true,
+    "isEngineModule": true,
+    "canContainContent": false,
+    "platforms": ["web", "desktop"],
+    "dependencies": ["core"],
+    "exports": {
+        "components": [],
+        "systems": []
+    },
+    "outputPath": "dist/index.js",
+    "pluginExport": "TimerPlugin"
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@esengine/timer",
+  "version": "1.0.0",
+  "description": "Timer and cooldown system for ECS Framework / ECS 框架的定时器和冷却系统",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "module.json"
+  ],
+  "dependencies": {
+    "tslib": "^2.8.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.17",
+    "rimraf": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.8.3",
+    "@esengine/ecs-framework": "2.4.2",
+    "@esengine/blueprint": "1.0.0",
+    "@esengine/build-config": "1.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "clean": "rimraf dist"
+  }
+}