hyper-scheduler 1.1.3 → 1.1.5

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="public/logo.svg" width="120" height="120" alt="Hyper Scheduler Logo">
+  <img src="https://github.com/CrazyMrYan/hyper-scheduler/raw/main/public/logo.svg" width="120" height="120" alt="Hyper Scheduler Logo">
 </p>
 
 <h1 align="center">Hyper Scheduler</h1>
@@ -21,7 +21,7 @@ A lightweight, dependency-free (core) JavaScript task scheduler supporting Cron
 
 ## DevTools
 
-![](./public/task-list.png)
+![](https://github.com/CrazyMrYan/hyper-scheduler/raw/main/public/task-list.png)
 
 ## Quick Start
 

package/dist/constants.d.ts

@@ -0,0 +1,17 @@
+export declare const TaskStatus: {
+    readonly IDLE: "idle";
+    readonly RUNNING: "running";
+    readonly STOPPED: "stopped";
+    readonly ERROR: "error";
+};
+export declare const SchedulerEvents: {
+    readonly TASK_REGISTERED: "task_registered";
+    readonly TASK_STARTED: "task_started";
+    readonly TASK_COMPLETED: "task_completed";
+    readonly TASK_FAILED: "task_failed";
+    readonly TASK_STOPPED: "task_stopped";
+    readonly TASK_REMOVED: "task_removed";
+    readonly TASK_UPDATED: "task_updated";
+    readonly SCHEDULER_STARTED: "scheduler_started";
+    readonly SCHEDULER_STOPPED: "scheduler_stopped";
+};

package/dist/core/retry-strategy.d.ts

@@ -0,0 +1,15 @@
+import { TaskOptions } from '../types';
+/**
+ * 重试策略工具类。
+ * 提供指数退避等重试延迟计算逻辑。
+ */
+export declare class RetryStrategy {
+    /**
+     * 计算下一次重试的延迟时间。
+     * 采用指数退避算法 (Exponential Backoff)。
+     * @param attempt 当前重试次数 (从 0 开始，0 表示第一次重试)
+     * @param options 任务的重试配置
+     * @returns 延迟毫秒数，如果超过最大尝试次数则返回 -1
+     */
+    static getDelay(attempt: number, options?: TaskOptions['retry']): number;
+}

package/dist/core/scheduler.d.ts

@@ -0,0 +1,120 @@
+import { SchedulerConfig, Task, TaskDefinition } from '../types';
+import { TimerStrategy } from '../platform/timer-strategy';
+export type TimerStrategyFactory = (driver: 'worker' | 'main') => TimerStrategy;
+/**
+ * 核心调度器类。
+ * 负责管理任务生命周期、时间循环和任务执行。
+ */
+export declare class Scheduler {
+    private registry;
+    private config;
+    private defaultTimerStrategy;
+    private timerStrategyFactory?;
+    private taskTimerStrategies;
+    private running;
+    private timers;
+    private listeners;
+    private eventListeners;
+    /**
+     * 创建一个新的调度器实例。
+     * @param timerStrategy 默认计时策略（NodeTimer 或 BrowserTimer）
+     * @param config 调度器配置
+     * @param timerStrategyFactory 可选的定时器策略工厂，用于创建任务级别的定时器
+     */
+    constructor(timerStrategy: TimerStrategy, config?: SchedulerConfig, timerStrategyFactory?: TimerStrategyFactory);
+    /**
+     * 订阅任务列表变更事件。
+     * 当任务创建、状态改变或删除时触发。
+     * @param listener 回调函数
+     * @returns 取消订阅的函数
+     */
+    subscribe(listener: (tasks: Task[]) => void): () => void;
+    /**
+     * 订阅特定事件
+     * @param event 事件名称
+     * @param handler 事件处理函数
+     * @returns 取消订阅的函数
+     */
+    on(event: string, handler: (payload: any) => void): () => void;
+    private emit;
+    /**
+     * 获取任务的定时器策略
+     * 优先使用任务级别配置，其次使用全局配置，最后使用默认策略
+     */
+    private getTimerStrategy;
+    private notify;
+    /**
+     * 创建并注册一个新任务。
+     * @param definition 任务定义
+     */
+    createTask(definition: TaskDefinition): void;
+    /**
+     * 删除指定 ID 的任务。
+     * @param id 任务 ID
+     * @returns 如果删除成功返回 true，否则返回 false
+     */
+    deleteTask(id: string): boolean;
+    /**
+     * 手动启动一个任务（将其置为 idle 状态并重新加入调度）。
+     * 即使调度器未启动，也可以单独启动某个任务。
+     * @param id 任务 ID
+     */
+    startTask(id: string): void;
+    /**
+     * 强制调度任务，即使调度器未启动
+     */
+    private scheduleTaskForce;
+    /**
+     * 执行单个任务（用于独立启动的任务）
+     */
+    private executeTaskIndividual;
+    /**
+     * 停止一个任务（取消当前的定时器并标记为 stopped）。
+     * @param id 任务 ID
+     */
+    stopTask(id: string): void;
+    /**
+     * 获取任务信息。
+     * @param id 任务 ID
+     */
+    getTask(id: string): Task | undefined;
+    /**
+     * 获取所有任务，可按命名空间筛选。
+     * @param namespace 可选的命名空间名称
+     * @returns 任务数组
+     */
+    getAllTasks(namespace?: string): Task[];
+    /**
+     * 获取调度器运行状态。
+     */
+    isRunning(): boolean;
+    /**
+     * 获取任务的实际驱动方式。
+     * 优先使用任务级配置，其次使用全局配置，默认为 'worker'。
+     */
+    getTaskDriver(id: string): 'worker' | 'main';
+    /**
+     * 获取全局驱动配置。
+     */
+    getGlobalDriver(): 'worker' | 'main';
+    /**
+     * 手动触发任务执行（忽略调度器状态，立即执行一次）。
+     * 执行完成后恢复到之前的状态。
+     * @param id 任务 ID
+     */
+    triggerTask(id: string): Promise<void>;
+    /**
+     * 启动调度器。
+     * 开始处理所有任务（除了手动停止的任务）。
+     */
+    start(scope?: string): void;
+    /**
+     * 停止调度器。
+     * 取消所有正在等待的定时器。
+     */
+    stop(scope?: string): void;
+    private scheduleTask;
+    private executeTask;
+    private recordHistory;
+    private log;
+}

package/dist/core/task-registry.d.ts

@@ -0,0 +1,43 @@
+import { Task } from '../types';
+/**
+ * 任务注册表。
+ * 负责存储和管理所有的任务实例。
+ */
+export declare class TaskRegistry {
+    private tasks;
+    private namespaceIndex;
+    constructor();
+    /**
+     * 注册一个新任务。
+     * @param task 任务对象
+     * @throws Error 如果 ID 已存在
+     */
+    addTask(task: Task): void;
+    /**
+     * 根据 ID 获取任务。
+     * @param id 任务 ID
+     * @returns 任务对象或 undefined
+     */
+    getTask(id: string): Task | undefined;
+    /**
+     * 删除任务。
+     * @param id 任务 ID
+     * @returns 是否删除成功
+     */
+    deleteTask(id: string): boolean;
+    /**
+     * 获取所有已注册的任务。
+     * @returns 任务数组
+     */
+    getAllTasks(): Task[];
+    /**
+     * 根据命名空间获取所有任务。
+     * @param namespace 命名空间名称
+     * @returns 该命名空间下的任务数组
+     */
+    getTasksByNamespace(namespace: string): Task[];
+    /**
+     * 清空所有任务和索引。
+     */
+    clear(): void;
+}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { Scheduler as CoreScheduler } from './core/scheduler';
+import { SchedulerConfig } from './types';
+import { DevTools } from './plugins/dev-tools';
+import { TaskStatus, SchedulerEvents } from './constants';
+/**
+ * Hyper Scheduler 主入口类。
+ * 自动根据运行环境（浏览器或 Node.js）选择合适的计时策略。
+ *
+ * 支持两级 driver 配置：
+ * 1. 全局配置：new Scheduler({ driver: 'worker' | 'main' })
+ * 2. 任务级配置：createTask({ options: { driver: 'worker' | 'main' } })
+ *
+ * 任务级配置优先于全局配置。
+ */
+export declare class Scheduler extends CoreScheduler {
+    /**
+     * 创建调度器实例。
+     * @param config 配置项
+     */
+    constructor(config?: SchedulerConfig);
+}
+export * from './types';
+export { CoreScheduler, DevTools, TaskStatus, SchedulerEvents };

package/dist/platform/browser/browser-timer.d.ts

@@ -0,0 +1,20 @@
+import { TimerStrategy } from '../timer-strategy';
+/**
+ * 浏览器环境下的计时策略实现。
+ * 使用 Web Worker 来运行计时循环，以避免后台标签页的节流限制。
+ */
+export declare class BrowserTimer implements TimerStrategy {
+    private worker;
+    private callbacks;
+    private nextId;
+    constructor();
+    /**
+     * 安排一个定时任务。
+     * 向 Web Worker 发送消息以注册计时器。
+     */
+    schedule(callback: () => void, delay: number): number;
+    /**
+     * 取消一个定时任务。
+     */
+    cancel(handle: number): void;
+}

package/dist/platform/browser/main-thread-timer.d.ts

@@ -0,0 +1,10 @@
+import { TimerStrategy } from '../timer-strategy';
+/**
+ * 浏览器环境下的主线程计时策略实现。
+ * 使用原生的 setTimeout/clearTimeout，运行在主线程上。
+ * 注意：在后台标签页中可能受到浏览器节流限制。
+ */
+export declare class MainThreadTimer implements TimerStrategy {
+    schedule(callback: () => void, delay: number): number;
+    cancel(handle: number): void;
+}

package/dist/platform/browser/worker.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Web Worker 脚本。
+ * 用于在后台线程中运行计时器，避免主线程阻塞或页面后台节流影响计时精度。
+ */
+interface TimerMessage {
+    id: number;
+    delay: number;
+    type: 'schedule' | 'cancel';
+}
+declare const timers: Map<number, number>;

package/dist/platform/node/debug-cli.d.ts

@@ -0,0 +1,8 @@
+import { Task } from '../../types';
+/**
+ * Node.js 环境下的调试 CLI 工具。
+ * 用于在控制台输出任务状态表格。
+ */
+export declare class DebugCLI {
+    static logTaskUpdate(tasks: Task[]): void;
+}

package/dist/platform/node/node-timer.d.ts

@@ -0,0 +1,9 @@
+import { TimerStrategy } from '../timer-strategy';
+/**
+ * Node.js 环境下的计时策略实现。
+ * 简单包装了原生的 setTimeout 和 clearTimeout。
+ */
+export declare class NodeTimer implements TimerStrategy {
+    schedule(callback: () => void, delay: number): NodeJS.Timeout;
+    cancel(handle: NodeJS.Timeout): void;
+}

package/dist/platform/timer-strategy.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 计时策略接口。
+ * 定义了跨平台计时器（Node.js 和 浏览器）的统一接口。
+ */
+export interface TimerStrategy {
+    /**
+     * 安排一个回调函数在指定延迟后执行。
+     * @param callback 回调函数
+     * @param delay 延迟毫秒数
+     * @returns 用于取消定时器的句柄 (Handle)
+     */
+    schedule(callback: () => void, delay: number): any;
+    /**
+     * 取消一个已安排的定时器。
+     * @param handle schedule 方法返回的句柄
+     */
+    cancel(handle: any): void;
+}

package/dist/plugins/dev-tools.d.ts

@@ -0,0 +1,10 @@
+import { Scheduler } from '../core/scheduler';
+import { DevToolsOptions, HyperSchedulerPlugin } from '../types';
+export declare class DevTools implements HyperSchedulerPlugin {
+    name: string;
+    private options;
+    constructor(options?: DevToolsOptions);
+    init(scheduler: Scheduler): void;
+    private mount;
+    private setupElement;
+}

package/dist/types.d.ts

@@ -0,0 +1,119 @@
+import { TaskStatus as TaskStatusEnum } from './constants';
+export type TaskStatus = typeof TaskStatusEnum[keyof typeof TaskStatusEnum];
+export interface ExecutionRecord {
+    timestamp: number;
+    duration: number;
+    success: boolean;
+    error?: string;
+}
+export interface TaskOptions {
+    retry?: {
+        maxAttempts: number;
+        initialDelay: number;
+        factor?: number;
+    };
+    timezone?: string;
+    /** 任务执行失败时的错误处理回调 */
+    onError?: (error: Error, taskId: string) => void;
+    /**
+     * 任务隔离的命名空间。
+     * 默认值: 'default'
+     */
+    namespace?: string;
+    /**
+     * 如果为 true，任务将在调度器启动时（或在创建时如果调度器已启动）立即运行一次。
+     * 默认值: false
+     */
+    runImmediately?: boolean;
+    /**
+     * 定时器驱动方式（仅浏览器环境有效）
+     * - 'worker': 使用 Web Worker（默认，更精确，不受后台节流影响）
+     * - 'main': 使用主线程 setTimeout（更简单，但可能受后台节流影响）
+     * 如果不指定，则使用调度器全局配置
+     */
+    driver?: 'worker' | 'main';
+}
+export interface TaskDefinition {
+    id: string;
+    /**
+     * 任务调度规则。
+     * 支持:
+     * 1. Cron 表达式 (例如: "*\/5 * * * * *")
+     * 2. 间隔字符串 (例如: "10s", "5m", "1h")
+     */
+    schedule: string;
+    handler: () => void | Promise<void>;
+    options?: TaskOptions;
+    tags?: string[];
+}
+export interface Task extends TaskDefinition {
+    status: TaskStatus;
+    lastRun?: number;
+    nextRun?: number;
+    history: ExecutionRecord[];
+    tags?: string[];
+    executionCount?: number;
+}
+export interface SchedulerConfig {
+    debug?: boolean;
+    maxHistory?: number;
+    timezone?: string;
+    plugins?: HyperSchedulerPlugin[];
+    /**
+     * 定时器驱动方式（仅浏览器环境有效）
+     * - 'worker': 使用 Web Worker（默认，更精确，不受后台节流影响）
+     * - 'main': 使用主线程 setTimeout（更简单，但可能受后台节流影响）
+     */
+    driver?: 'worker' | 'main';
+}
+export interface HyperSchedulerPlugin {
+    name: string;
+    init(scheduler: any, options?: any): void;
+}
+export interface TaskSnapshot {
+    id: string;
+    status: string;
+    lastRun: number | null;
+    nextRun: number | null;
+    executionCount: number;
+    schedule: string;
+    tags: string[];
+    error: string | null;
+    driver: 'worker' | 'main';
+    namespace?: string;
+}
+export interface DevToolsOptions {
+    /** 主题模式 */
+    theme?: 'light' | 'dark' | 'auto';
+    /** 面板停靠位置 */
+    dockPosition?: 'right' | 'bottom';
+    /** 界面语言 */
+    language?: 'en' | 'zh';
+    /** 时间线默认缩放级别 (0.5-5) */
+    defaultZoom?: number;
+    /**
+     * 缩放时间步长 (单位毫秒)
+     * 默认值: 1000 (1秒)
+     */
+    zoomStep?: number;
+    /** 悬浮按钮配置 */
+    trigger?: {
+        /** 背景色 */
+        backgroundColor?: string;
+        /** 文字/图标颜色 */
+        textColor?: string;
+        /** 位置 */
+        position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    };
+}
+export interface TaskControlAPI {
+    trigger(taskId: string): Promise<void>;
+    pause(taskId: string): void;
+    resume(taskId: string): void;
+    remove(taskId: string): void;
+}
+export interface SchedulerIntrospectionAPI {
+    getTasks(): TaskSnapshot[];
+    on(event: string, handler: (data: any) => void): () => void;
+    isRunning(): boolean;
+}

package/dist/ui/components/devtools.d.ts

@@ -0,0 +1,30 @@
+import { SchedulerIntrospectionAPI, TaskControlAPI } from '../../types';
+import './floating-trigger';
+import './task-header';
+import './task-list';
+import './task-detail';
+import './timeline';
+import './resizer';
+export declare class DevTools extends HTMLElement {
+    private _shadow;
+    private store;
+    private scheduler?;
+    private rAFId?;
+    private lastTime;
+    private $panel;
+    private $header;
+    private $taskList;
+    private $taskDetail;
+    private $timeline;
+    private $trigger;
+    private $overlay;
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    setScheduler(api: SchedulerIntrospectionAPI & TaskControlAPI): void;
+    private cacheDom;
+    private bindStore;
+    private addEventListeners;
+    private startLoop;
+    render(): void;
+}

package/dist/ui/components/floating-trigger.d.ts

@@ -0,0 +1,27 @@
+export declare class FloatingTrigger extends HTMLElement {
+    private _shadow;
+    private _position;
+    private _bgColor;
+    private _textColor;
+    private _isDragging;
+    private _wasDragging;
+    private _offsetX;
+    private _offsetY;
+    private _isCollapsed;
+    private _savedX;
+    private _savedY;
+    static get observedAttributes(): string[];
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private onResize;
+    attributeChangedCallback(name: string, _oldVal: string, newVal: string): void;
+    private loadState;
+    private resetPositionToDefault;
+    private saveState;
+    private applyPosition;
+    private updateStyles;
+    private updateCollapsedState;
+    addEventListeners(): void;
+    render(): void;
+}

package/dist/ui/components/icons.d.ts

@@ -0,0 +1,16 @@
+export declare const ICONS: {
+    back: string;
+    trigger: string;
+    pause: string;
+    resume: string;
+    remove: string;
+    close: string;
+    settings: string;
+    sun: string;
+    moon: string;
+    dock: string;
+    dockRight: string;
+    dockBottom: string;
+    chart: string;
+    list: string;
+};

package/dist/ui/components/resizer.d.ts

@@ -0,0 +1,14 @@
+export declare class Resizer extends HTMLElement {
+    private _shadow;
+    private startX;
+    private startY;
+    private startWidth;
+    private startHeight;
+    private panel;
+    private mode;
+    constructor();
+    private isMobile;
+    connectedCallback(): void;
+    private addEventListeners;
+    render(): void;
+}

package/dist/ui/components/task-detail.d.ts

@@ -0,0 +1,13 @@
+import { TaskSnapshot, ExecutionRecord } from '../../types';
+export declare class TaskDetail extends HTMLElement {
+    private _shadow;
+    private _task;
+    private _history;
+    constructor();
+    connectedCallback(): void;
+    set task(task: TaskSnapshot | null);
+    set history(h: ExecutionRecord[]);
+    updateTexts(): void;
+    private renderContent;
+    render(): void;
+}

package/dist/ui/components/task-header.d.ts

@@ -0,0 +1,37 @@
+export declare class TaskHeader extends HTMLElement {
+    private _shadow;
+    private _fps;
+    private _stats;
+    private _theme;
+    private _activeTab;
+    private _language;
+    private _schedulerRunning;
+    private $fps;
+    private $stats;
+    private $schedulerStatus;
+    private $themeIcon;
+    private $dockIcon;
+    private $tabs;
+    private $searchInput;
+    private $title;
+    private $langBtn;
+    constructor();
+    connectedCallback(): void;
+    set fps(val: number);
+    set stats(val: {
+        active: number;
+        total: number;
+    });
+    set schedulerRunning(val: boolean);
+    set theme(val: 'light' | 'dark' | 'auto');
+    set language(val: 'en' | 'zh');
+    set dockPosition(val: 'right' | 'bottom');
+    set activeTab(val: 'tasks' | 'timeline');
+    private cacheDom;
+    private addEventListeners;
+    private updateThemeIcon;
+    private updateTabs;
+    private updateTexts;
+    private updateView;
+    render(): void;
+}

package/dist/ui/components/task-list.d.ts

@@ -0,0 +1,21 @@
+import { TaskSnapshot } from '../../types';
+export declare class TaskList extends HTMLElement {
+    private _shadow;
+    private _allTasks;
+    private _filteredTasks;
+    private _lastExecutionTimes;
+    private _expandedNamespaces;
+    constructor();
+    connectedCallback(): void;
+    set tasks(map: Map<string, TaskSnapshot>);
+    private groupTasksByNamespace;
+    filter(text: string, map: Map<string, TaskSnapshot>): void;
+    updateHeaders(): void;
+    private getStatusIcon;
+    private formatSchedule;
+    private formatTime;
+    private getDriverBadge;
+    private renderTaskRow;
+    private renderRows;
+    render(): void;
+}

package/dist/ui/components/timeline.d.ts

@@ -0,0 +1,26 @@
+import { TaskSnapshot, ExecutionRecord } from '../../types';
+export declare class Timeline extends HTMLElement {
+    private _shadow;
+    private _tasks;
+    private _history;
+    private $canvas;
+    private ctx;
+    private timeRange;
+    private zoom;
+    constructor();
+    connectedCallback(): void;
+    set data(val: {
+        tasks: Map<string, TaskSnapshot>;
+        history: Map<string, ExecutionRecord[]>;
+    });
+    set defaultZoom(val: number);
+    updateTexts(): void;
+    private updateZoomLabel;
+    private setupZoom;
+    private startLoop;
+    private draw;
+    private drawTimeAxis;
+    private drawTaskRow;
+    private drawLegend;
+    render(): void;
+}

package/dist/ui/i18n/en.d.ts

@@ -0,0 +1,76 @@
+export declare const en: {
+    header: {
+        title: string;
+        searchPlaceholder: string;
+        toggleDock: string;
+        toggleTheme: string;
+        close: string;
+    };
+    stats: {
+        loading: string;
+        fps: string;
+        status: string;
+        active: string;
+        total: string;
+        mainThread: string;
+        scheduler: string;
+        running: string;
+        stopped: string;
+    };
+    tabs: {
+        tasks: string;
+        timeline: string;
+    };
+    list: {
+        idTags: string;
+        status: string;
+        driver: string;
+        driverWorker: string;
+        driverMain: string;
+        schedule: string;
+        count: string;
+        lastRun: string;
+        actions: string;
+        noTags: string;
+        tip: string;
+    };
+    detail: {
+        back: string;
+        details: string;
+        config: string;
+        history: string;
+        lastRuns: string;
+        avgDuration: string;
+        startTime: string;
+        duration: string;
+        drift: string;
+        status: string;
+        noHistory: string;
+        noTask: string;
+        success: string;
+        failed: string;
+        error: string;
+    };
+    timeline: {
+        zoom: string;
+        timeRange: string;
+        legend: string;
+        instant: string;
+        duration: string;
+        workerDriver: string;
+        mainDriver: string;
+    };
+    status: {
+        running: string;
+        paused: string;
+        stopped: string;
+        idle: string;
+        error: string;
+    };
+    actions: {
+        trigger: string;
+        start: string;
+        stop: string;
+        remove: string;
+    };
+};

package/dist/ui/i18n/index.d.ts

@@ -0,0 +1,5 @@
+type Lang = 'en' | 'zh';
+export declare function setLanguage(lang: Lang): void;
+export declare function getLanguage(): Lang;
+export declare function t(key: string, params?: Record<string, any>): string;
+export {};

package/dist/ui/i18n/zh.d.ts

@@ -0,0 +1,76 @@
+export declare const zh: {
+    header: {
+        title: string;
+        searchPlaceholder: string;
+        toggleDock: string;
+        toggleTheme: string;
+        close: string;
+    };
+    stats: {
+        loading: string;
+        fps: string;
+        status: string;
+        active: string;
+        total: string;
+        mainThread: string;
+        scheduler: string;
+        running: string;
+        stopped: string;
+    };
+    tabs: {
+        tasks: string;
+        timeline: string;
+    };
+    list: {
+        idTags: string;
+        status: string;
+        driver: string;
+        driverWorker: string;
+        driverMain: string;
+        schedule: string;
+        count: string;
+        lastRun: string;
+        actions: string;
+        noTags: string;
+        tip: string;
+    };
+    detail: {
+        back: string;
+        details: string;
+        config: string;
+        history: string;
+        lastRuns: string;
+        avgDuration: string;
+        startTime: string;
+        duration: string;
+        drift: string;
+        status: string;
+        noHistory: string;
+        noTask: string;
+        success: string;
+        failed: string;
+        error: string;
+    };
+    timeline: {
+        zoom: string;
+        timeRange: string;
+        legend: string;
+        instant: string;
+        duration: string;
+        workerDriver: string;
+        mainDriver: string;
+    };
+    status: {
+        running: string;
+        paused: string;
+        stopped: string;
+        idle: string;
+        error: string;
+    };
+    actions: {
+        trigger: string;
+        start: string;
+        stop: string;
+        remove: string;
+    };
+};

package/dist/ui/store/dev-tools-store.d.ts

@@ -0,0 +1,53 @@
+import { TaskSnapshot, TaskControlAPI } from '../../types';
+export interface DevToolsState {
+    isOpen: boolean;
+    activeTab: 'tasks' | 'timeline';
+    theme: 'light' | 'dark' | 'auto';
+    dockPosition: 'right' | 'bottom';
+    panelSize: {
+        width: number;
+        height: number;
+    };
+    language: 'en' | 'zh';
+    filterText: string;
+    selectedTaskId: string | null;
+    tasks: Map<string, TaskSnapshot>;
+    history: Map<string, any[]>;
+    fps: number;
+    schedulerRunning: boolean;
+}
+type Listener<T> = (value: T) => void;
+export declare class DevToolsStore {
+    private state;
+    private listeners;
+    private scheduler?;
+    constructor();
+    setScheduler(scheduler: TaskControlAPI): void;
+    getState(): Readonly<DevToolsState>;
+    subscribe<K extends keyof DevToolsState>(key: K, callback: Listener<DevToolsState[K]>): () => void;
+    private notify;
+    toggle(): void;
+    setTheme(theme: 'light' | 'dark' | 'auto'): void;
+    /**
+     * Set language synchronously without notifying listeners.
+     * Used during initialization before child components render.
+     */
+    setLanguageSync(lang: 'en' | 'zh'): void;
+    setLanguage(lang: 'en' | 'zh'): void;
+    setPanelSize(size: {
+        width?: number;
+        height?: number;
+    }): void;
+    setTab(tab: 'tasks' | 'timeline'): void;
+    setDockPosition(pos: 'right' | 'bottom'): void;
+    setFilterText(text: string): void;
+    updateTask(task: TaskSnapshot): void;
+    selectTask(id: string | null): void;
+    addHistory(taskId: string, record: any): void;
+    triggerTask(id: string): Promise<void>;
+    stopTask(id: string): void;
+    startTask(id: string): void;
+    removeTask(id: string): void;
+    setSchedulerRunning(running: boolean): void;
+}
+export {};

package/dist/ui/styles/theme.css.d.ts

@@ -0,0 +1 @@
+export declare const themeStyles = "\n  :host {\n    --hs-font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif;\n    --hs-font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace;\n    --hs-font-size: 12px;\n    --hs-line-height: 1.5;\n    --hs-panel-width: 400px;\n    --hs-panel-height: 300px;\n    \n    /* \u7B49\u5BBD\u6570\u5B57\u5B57\u4F53 */\n    --hs-font-monospaced-num: var(--hs-font-mono);\n\n    /* Light Theme (Default) */\n    --hs-bg: #ffffff;\n    --hs-bg-secondary: #f3f4f6;\n    --hs-text: #1f2937;\n    --hs-text-secondary: #6b7280;\n    --hs-border: #e5e7eb;\n    --hs-primary: #3b82f6;\n    --hs-primary-hover: #2563eb;\n    --hs-danger: #ef4444;\n    --hs-danger-hover: #dc2626;\n    --hs-success: #10b981;\n    --hs-warning: #f59e0b;\n    \n    --hs-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);\n    --hs-radius: 6px;\n    --hs-header-height: 40px;\n    --hs-z-index: 9999;\n    --hs-z-index-overlay: 9998;\n\n    /* Default display styles for the host itself */\n    background: var(--hs-bg);\n    color: var(--hs-text);\n    font-family: var(--hs-font-family);\n    font-size: var(--hs-font-size);\n    line-height: var(--hs-line-height);\n  }\n\n  :host([theme=\"dark\"]) {\n    --hs-bg: #111827;\n    --hs-bg-secondary: #1f2937;\n    --hs-text: #f9fafb;\n    --hs-text-secondary: #9ca3af;\n    --hs-border: #374151;\n    --hs-primary: #60a5fa;\n    --hs-primary-hover: #3b82f6;\n    --hs-danger: #f87171;\n    --hs-danger-hover: #ef4444;\n    --hs-success: #34d399;\n    --hs-warning: #fbbf24;\n    \n    --hs-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.5), 0 2px 4px -1px rgba(0, 0, 0, 0.3);\n  }\n\n  :host {\n    background: var(--hs-bg);\n    color: var(--hs-text);\n  }\n";

package/dist/utils/cron-lite.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 轻量级 Cron 解析器
+ * 支持标准 5 位和 6 位 cron 表达式
+ * 格式: [秒] 分 时 日 月 周
+ */
+/**
+ * 验证 cron 表达式
+ */
+export declare function validateCron(expression: string): void;
+/**
+ * 计算下一次运行时间
+ */
+export declare function getNextRun(expression: string, _timezone?: string): Date;

package/dist/utils/id.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 验证任务 ID 是否为非空字符串。
+ * @param id 待验证的 ID
+ * @throws Error 如果 ID 无效
+ */
+export declare function validateId(id: string): void;

package/dist/utils/schedule.d.ts

@@ -0,0 +1,23 @@
+export type ScheduleType = 'cron' | 'interval';
+export interface ParsedSchedule {
+    type: ScheduleType;
+    value: any | number;
+}
+/**
+ * 解析调度规则字符串，将其转换为 Cron 表达式对象或毫秒级间隔。
+ * 支持的间隔格式: "10s", "5m", "2h", "1d"。
+ * @param schedule 调度规则字符串
+ * @returns 解析后的调度对象
+ * @throws Error 如果字符串格式无效
+ */
+export declare function parseSchedule(schedule: string): ParsedSchedule;
+/**
+ * 计算下一次运行时间。
+ * @param schedule 调度规则字符串或已解析的对象
+ * @param options 可选配置 (cron 的时区，interval 的上次运行时间)
+ * @returns 下一次运行的 Date 对象
+ */
+export declare function getNextRun(schedule: string | ParsedSchedule, options?: {
+    timezone?: string;
+    lastRun?: number;
+}): Date;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyper-scheduler",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "A lightweight, dependency-free (core) JavaScript task scheduler supporting Cron expressions and Web Workers.",
   "type": "module",
   "main": "./dist/index.umd.js",
@@ -8,6 +8,7 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     }
@@ -15,8 +16,7 @@
   "files": [
     "dist",
     "README.md",
-    "LICENSE",
-    "public"
+    "LICENSE"
   ],
   "scripts": {
     "dev": "vite",
@@ -27,7 +27,7 @@
     "example:vue": "cd examples/vue-demo && yarn && yarn dev",
     "example:react": "cd examples/react-demo && yarn && yarn dev",
     "dev:all": "concurrently \"yarn docs:dev\" \"yarn example:vue\" \"yarn example:react\" \"vite examples/browser --port 3003\"",
-    "build": "tsc && vite build",
+    "build": "npx vite build && tsc -p tsconfig.build.json",
     "prepublishOnly": "yarn build",
     "test": "vitest",
     "lint": "eslint . --ext .ts"

package/dist/logo.svg

@@ -1,54 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" fill="none">
-  <defs>
-    <linearGradient id="main" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#6366f1"/>
-      <stop offset="100%" style="stop-color:#a855f7"/>
-    </linearGradient>
-    <linearGradient id="bolt" x1="50%" y1="0%" x2="50%" y2="100%">
-      <stop offset="0%" style="stop-color:#fcd34d"/>
-      <stop offset="100%" style="stop-color:#f59e0b"/>
-    </linearGradient>
-    <filter id="glow">
-      <feGaussianBlur stdDeviation="2" result="blur"/>
-      <feMerge>
-        <feMergeNode in="blur"/>
-        <feMergeNode in="SourceGraphic"/>
-      </feMerge>
-    </filter>
-    <filter id="softShadow">
-      <feDropShadow dx="0" dy="2" stdDeviation="3" flood-color="#6366f1" flood-opacity="0.3"/>
-    </filter>
-  </defs>
-  
-  <!-- 背景圆 - 柔和填充 -->
-  <circle cx="64" cy="64" r="56" fill="url(#main)" opacity="0.1"/>
-  
-  <!-- 刻度点 - 简约时钟感 -->
-  <g fill="url(#main)" opacity="0.7">
-    <circle cx="64" cy="16" r="4"/>
-    <circle cx="112" cy="64" r="4"/>
-    <circle cx="64" cy="112" r="4"/>
-    <circle cx="16" cy="64" r="4"/>
-  </g>
-  
-  <!-- 次要刻度 -->
-  <g fill="url(#main)" opacity="0.35">
-    <circle cx="98" cy="26" r="2.5"/>
-    <circle cx="102" cy="98" r="2.5"/>
-    <circle cx="26" cy="98" r="2.5"/>
-    <circle cx="30" cy="26" r="2.5"/>
-  </g>
-  
-  <!-- 闪电 - 核心元素 -->
-  <path d="M72 20 L44 68 L62 68 L52 108 L88 52 L68 52 L72 20Z" 
-        fill="url(#bolt)" 
-        filter="url(#glow)"/>
-  
-  <!-- 闪电高光 -->
-  <path d="M70 26 L50 64 L62 64 L56 92" 
-        stroke="#fff" 
-        stroke-width="2" 
-        stroke-linecap="round"
-        fill="none"
-        opacity="0.4"/>
-</svg>

package/public/logo.svg

@@ -1,54 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" fill="none">
-  <defs>
-    <linearGradient id="main" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#6366f1"/>
-      <stop offset="100%" style="stop-color:#a855f7"/>
-    </linearGradient>
-    <linearGradient id="bolt" x1="50%" y1="0%" x2="50%" y2="100%">
-      <stop offset="0%" style="stop-color:#fcd34d"/>
-      <stop offset="100%" style="stop-color:#f59e0b"/>
-    </linearGradient>
-    <filter id="glow">
-      <feGaussianBlur stdDeviation="2" result="blur"/>
-      <feMerge>
-        <feMergeNode in="blur"/>
-        <feMergeNode in="SourceGraphic"/>
-      </feMerge>
-    </filter>
-    <filter id="softShadow">
-      <feDropShadow dx="0" dy="2" stdDeviation="3" flood-color="#6366f1" flood-opacity="0.3"/>
-    </filter>
-  </defs>
-  
-  <!-- 背景圆 - 柔和填充 -->
-  <circle cx="64" cy="64" r="56" fill="url(#main)" opacity="0.1"/>
-  
-  <!-- 刻度点 - 简约时钟感 -->
-  <g fill="url(#main)" opacity="0.7">
-    <circle cx="64" cy="16" r="4"/>
-    <circle cx="112" cy="64" r="4"/>
-    <circle cx="64" cy="112" r="4"/>
-    <circle cx="16" cy="64" r="4"/>
-  </g>
-  
-  <!-- 次要刻度 -->
-  <g fill="url(#main)" opacity="0.35">
-    <circle cx="98" cy="26" r="2.5"/>
-    <circle cx="102" cy="98" r="2.5"/>
-    <circle cx="26" cy="98" r="2.5"/>
-    <circle cx="30" cy="26" r="2.5"/>
-  </g>
-  
-  <!-- 闪电 - 核心元素 -->
-  <path d="M72 20 L44 68 L62 68 L52 108 L88 52 L68 52 L72 20Z" 
-        fill="url(#bolt)" 
-        filter="url(#glow)"/>
-  
-  <!-- 闪电高光 -->
-  <path d="M70 26 L50 64 L62 64 L56 92" 
-        stroke="#fff" 
-        stroke-width="2" 
-        stroke-linecap="round"
-        fill="none"
-        opacity="0.4"/>
-</svg>