hyper-scheduler 1.0.0

package/.editorconfig

@@ -0,0 +1,21 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+
+# TypeScript files
+[*.ts]
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+
+# Disable auto-fix for critical UI components
+[src/ui/components/{Timeline,TaskList,DevTools}.ts]
+# These files have specific logic that should not be auto-fixed
+# Manual review required for any changes

package/.eslintrc.cjs

@@ -0,0 +1,26 @@
+module.exports = {
+  root: true,
+  env: {
+    browser: true,
+    es2021: true,
+    node: true,
+  },
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+  ],
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    ecmaVersion: 12,
+    sourceType: 'module',
+  },
+  plugins: [
+    '@typescript-eslint',
+  ],
+  rules: {
+    '@typescript-eslint/no-explicit-any': 'off',
+    '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
+    'no-console': 'off',
+  },
+  ignorePatterns: ['dist/', 'coverage/', 'examples/'],
+};

package/GEMINI.md

@@ -0,0 +1 @@
+全部采用中文作为主要语言进行输出，包括文档和注释

package/README.md

@@ -0,0 +1,38 @@
+<p align="center">
+  <img src="docs/public/logo.svg" width="120" height="120" alt="Hyper Scheduler Logo">
+</p>
+
+<h1 align="center">Hyper Scheduler</h1>
+
+<p align="center">
+  <img src="https://img.shields.io/npm/v/hyper-scheduler" alt="NPM Version">
+  <img src="https://img.shields.io/npm/l/hyper-scheduler" alt="License">
+</p>
+
+A lightweight, dependency-free (core) JavaScript task scheduler supporting Cron expressions and Web Workers.
+
+## Features
+- 🚀 **Cross-platform**: Works in Node.js and Browser.
+- ⏰ **Precise Timing**: Uses Web Workers in browser to avoid background throttling.
+- 🛠 **Debuggable**: Built-in debug panel and CLI output.
+- 📦 **Tiny**: < 20KB gzipped.
+
+## Quick Start
+
+```bash
+npm install hyper-scheduler
+```
+
+```javascript
+import { Scheduler } from 'hyper-scheduler';
+
+const scheduler = new Scheduler({ debug: true });
+scheduler.createTask({
+  id: 'hello',
+  schedule: '*/5 * * * * *',
+  handler: () => console.log('Hello World')
+});
+scheduler.start();
+```
+
+See [Documentation](docs/guide/getting-started.md) for more details.

package/docs/.vitepress/config.ts

@@ -0,0 +1,52 @@
+import { defineConfig } from 'vitepress';
+
+export default defineConfig({
+  lang: 'zh-CN', // 设置语言为中文
+  title: 'Hyper Scheduler', // 更新标题
+  description: '轻量级全局任务调度 JavaScript 库。', // 更新描述
+  head: [
+    ['link', { rel: 'icon', href: '/logo.svg', type: 'image/svg+xml' }]
+  ],
+  themeConfig: {
+    logo: '/logo.svg',
+    nav: [
+      { text: '指南', link: '/guide/getting-started' }, // 更新导航文本
+      { text: 'API 参考', link: '/api/scheduler' },     // 更新导航文本
+      { text: '示例演示', link: '/examples/' },
+      // 多版本导航占位符 - 实际实现可能需要自定义组件或更复杂的配置
+      {
+        text: '版本',
+        items: [
+          { text: 'v1.0.0 (最新)', link: '/' },
+          // { text: 'v0.9.0', link: '/v0.9.0/' } // 示例历史版本
+        ]
+      }
+    ],
+    sidebar: [
+      {
+        text: '指南',
+        items: [
+          { text: '快速开始', link: '/guide/getting-started' },
+          { text: '核心概念', link: '/guide/core-concepts' },
+          { text: '最佳实践', link: '/guide/best-practices' }
+        ]
+      },
+      {
+        text: '示例演示',
+        items: [
+          { text: '双线程心跳监控', link: '/examples/' }
+        ]
+      },
+      {
+        text: 'API 参考',
+        items: [
+          { text: '总览', link: '/api/' },
+          { text: 'Scheduler', link: '/api/scheduler' },
+          { text: 'Task', link: '/api/task' },
+          { text: 'DevTools', link: '/api/devtools' },
+          { text: '类型定义', link: '/api/types' }
+        ]
+      }
+    ]
+  }
+});

package/docs/README.md

@@ -0,0 +1,120 @@
+# Hyper Scheduler 文档
+
+## 文档结构
+
+```
+docs/
+├── index.md                    # 首页
+├── guide/                      # 指南
+│   ├── getting-started.md      # 快速开始
+│   ├── core-concepts.md        # 核心概念
+│   └── best-practices.md       # 最佳实践
+└── api/                        # API 参考
+    ├── index.md                # API 总览
+    ├── scheduler.md            # Scheduler API
+    ├── task.md                 # Task API
+    ├── devtools.md             # DevTools API
+    └── types.md                # 类型定义
+```
+
+## 文档说明
+
+### 指南 (Guide)
+
+面向用户的教程和概念说明：
+
+- **快速开始** - 安装、基础用法、完整示例
+- **核心概念** - 调度器、任务、状态、事件系统等核心概念
+- **最佳实践** - 任务设计、错误处理、性能优化等实践建议
+
+### API 参考 (API Reference)
+
+详细的 API 文档：
+
+- **API 总览** - 快速查找和索引
+- **Scheduler** - 调度器类的所有方法和配置
+- **Task** - 任务定义、选项和运行时状态
+- **DevTools** - 调试工具配置和使用
+- **类型定义** - 完整的 TypeScript 类型
+
+## 文档特点
+
+### 1. 模块化组织
+
+- 按功能模块拆分文档
+- 每个 API 独立成页
+- 便于维护和查找
+
+### 2. 清晰的层次结构
+
+- 指南：从简单到复杂
+- API：按类和功能分组
+- 类型：集中管理类型定义
+
+### 3. 丰富的示例
+
+- 每个 API 都有使用示例
+- 包含常见模式和最佳实践
+- 提供完整的代码片段
+
+### 4. 交叉引用
+
+- 相关文档之间互相链接
+- 便于深入学习和查找
+
+## 本地预览
+
+```bash
+# 启动文档开发服务器
+npm run docs:dev
+
+# 构建文档
+npm run docs:build
+```
+
+## 贡献指南
+
+### 添加新文档
+
+1. 在相应目录创建 Markdown 文件
+2. 在 `.vitepress/config.ts` 中添加导航/侧边栏配置
+3. 添加交叉引用链接
+
+### 文档规范
+
+- 使用清晰的标题层次
+- 提供代码示例
+- 添加参数说明表格
+- 包含相关链接
+
+### 示例格式
+
+```markdown
+# API 名称
+
+简短描述。
+
+## 方法名
+
+详细说明。
+
+\`\`\`typescript
+// 代码示例
+\`\`\`
+
+### 参数
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| ... | ... | ... |
+
+### 示例
+
+\`\`\`typescript
+// 使用示例
+\`\`\`
+
+## 相关链接
+
+- [相关文档](./link.md)
+```

package/docs/api/devtools.md

@@ -0,0 +1,232 @@
+# DevTools
+
+浏览器环境下的可视化调试工具插件，提供任务监控、时间线视图和实时日志等功能。
+
+## 构造函数
+
+```typescript
+new DevTools(options?: DevToolsOptions)
+```
+
+### 参数
+
+- **options** `DevToolsOptions` - 可选配置对象
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `theme` | `'light' \| 'dark' \| 'auto'` | `'auto'` | 主题模式 |
+| `dockPosition` | `'right' \| 'bottom'` | `'right'` | 面板停靠位置 |
+| `language` | `'en' \| 'zh'` | `'en'` | 界面语言 |
+| `defaultZoom` | `number` | `1` | 时间线默认缩放级别 (0.5-5) |
+| `trigger` | `TriggerOptions` | - | 悬浮按钮配置 |
+
+### TriggerOptions
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `backgroundColor` | `string` | `'#3b82f6'` | 背景色 |
+| `textColor` | `string` | `'#ffffff'` | 文字/图标颜色 |
+| `position` | `'bottom-right' \| 'bottom-left' \| 'top-right' \| 'top-left'` | `'bottom-right'` | 位置 |
+
+## 使用方法
+
+### 基础用法
+
+```typescript
+import { Scheduler, DevTools } from 'hyper-scheduler';
+
+const scheduler = new Scheduler({
+  plugins: [
+    new DevTools()
+  ]
+});
+```
+
+### 自定义配置
+
+```typescript
+import { Scheduler, DevTools } from 'hyper-scheduler';
+
+const scheduler = new Scheduler({
+  plugins: [
+    new DevTools({
+      theme: 'dark',
+      dockPosition: 'bottom',
+      language: 'zh',
+      defaultZoom: 2,
+      trigger: {
+        backgroundColor: '#10b981',
+        textColor: '#ffffff',
+        position: 'bottom-left'
+      }
+    })
+  ]
+});
+```
+
+## 功能特性
+
+### 任务列表
+
+- 查看所有已注册任务
+- 实时显示任务状态（idle、running、stopped、error）
+- 显示上次执行时间和下次执行时间
+- 按标签过滤任务
+- 搜索任务
+- **任务驱动 (Task Driver)**
+    - 在任务列表中，任务 ID 旁会显示一个标记：
+        - **`M`**: 表示该任务在 **主线程 (Main Thread)** 中运行。
+        - **`W`**: 表示该任务在 **Web Worker 线程** 中运行。
+    - 这允许你快速识别任务的执行上下文，特别是对于需要避免阻塞 UI 的繁重任务。
+    - **注意**：`driver` 是 `Scheduler` 或 `Task` 的配置选项，而不是 `DevTools` 本身的配置。`DevTools` 仅负责可视化其状态。
+
+### 任务控制
+
+- 手动触发任务执行
+- 暂停/恢复任务
+- 删除任务
+- 查看任务详情
+
+### 时间线视图
+
+- 可视化任务执行时间线
+- 缩放时间轴（0.5x - 5x）
+- 显示任务执行时长
+- 区分成功/失败状态
+
+### 执行历史
+
+- 查看任务执行历史记录
+- 显示执行时间、耗时、状态
+- 查看错误信息
+- 统计成功率
+
+### 实时日志
+
+- 实时显示调度器事件
+- 任务注册、启动、完成、失败等事件
+- 可过滤日志级别
+
+## 主题配置
+
+### auto（自动）
+
+根据系统主题自动切换：
+
+```typescript
+new DevTools({
+  theme: 'auto'
+})
+```
+
+### light（浅色）
+
+```typescript
+new DevTools({
+  theme: 'light'
+})
+```
+
+### dark（深色）
+
+```typescript
+new DevTools({
+  theme: 'dark'
+})
+```
+
+## 停靠位置
+
+### right（右侧）
+
+面板停靠在浏览器窗口右侧：
+
+```typescript
+new DevTools({
+  dockPosition: 'right'
+})
+```
+
+### bottom（底部）
+
+面板停靠在浏览器窗口底部：
+
+```typescript
+new DevTools({
+  dockPosition: 'bottom'
+})
+```
+
+## 语言设置
+
+### 中文
+
+```typescript
+new DevTools({
+  language: 'zh'
+})
+```
+
+### 英文
+
+```typescript
+new DevTools({
+  language: 'en'
+})
+```
+
+## 时间线缩放
+
+控制时间线视图的默认缩放级别，范围 0.5 - 5：
+
+```typescript
+new DevTools({
+  defaultZoom: 2  // 2倍缩放
+})
+```
+
+- `0.5` - 显示更长时间范围
+- `1` - 默认缩放
+- `2` - 显示更多细节
+- `5` - 最大缩放
+
+## 悬浮按钮自定义
+
+### 位置
+
+```typescript
+new DevTools({
+  trigger: {
+    position: 'bottom-right'  // 右下角
+  }
+})
+```
+
+可选值：
+- `'bottom-right'` - 右下角（默认）
+- `'bottom-left'` - 左下角
+- `'top-right'` - 右上角
+- `'top-left'` - 左上角
+
+### 颜色
+
+```typescript
+new DevTools({
+  trigger: {
+    backgroundColor: '#10b981',  // 绿色背景
+    textColor: '#ffffff'         // 白色文字
+  }
+})
+```
+
+支持任何有效的 CSS 颜色值：
+- 十六进制：`'#3b82f6'`
+- RGB：`'rgb(59, 130, 246)'`
+- RGBA：`'rgba(59, 130, 246, 0.8)'`
+- 颜色名：`'blue'`
+
+## 相关链接
+
+- [Scheduler API](./scheduler.md) - 调度器 API
+- [快速开始](../guide/getting-started.md) - 使用指南
+- [类型定义](./types.md) - 完整类型定义

package/docs/api/index.md

@@ -0,0 +1,178 @@
+# API 参考
+
+Hyper Scheduler 的完整 API 文档。
+
+## 核心 API
+
+### [Scheduler](./scheduler.md)
+
+核心调度器类，负责任务的注册、调度和生命周期管理。
+
+**主要方法**：
+- `createTask()` - 注册新任务
+- `start()` / `stop()` - 启动/停止调度器
+- `startTask()` / `stopTask()` - 启动/停止指定任务
+- `triggerTask()` - 手动触发任务
+- `getTask()` / `getAllTasks()` - 查询任务
+- `deleteTask()` - 删除任务
+- `on()` - 订阅事件
+
+[查看完整文档 →](./scheduler.md)
+
+---
+
+### [Task](./task.md)
+
+任务配置和运行时状态。
+
+**核心接口**：
+- `TaskDefinition` - 任务定义
+- `TaskOptions` - 任务选项
+- `Task` - 任务运行时对象
+
+**配置选项**：
+- 调度规则（Cron / 时间间隔）
+- 重试策略
+- 时区设置
+- 错误处理
+
+[查看完整文档 →](./task.md)
+
+---
+
+### [DevTools](./devtools.md)
+
+浏览器环境下的可视化调试工具。
+
+**功能特性**：
+- 任务列表和状态监控
+- 时间线视图
+- 执行历史
+- 实时日志
+
+**配置选项**：
+- 主题模式
+- 停靠位置
+- 界面语言
+- 悬浮按钮自定义
+
+[查看完整文档 →](./devtools.md)
+
+---
+
+### [类型定义](./types.md)
+
+完整的 TypeScript 类型定义。
+
+**核心类型**：
+- `SchedulerConfig`
+- `TaskDefinition`
+- `TaskOptions`
+- `Task`
+- `TaskStatus`
+- `ExecutionRecord`
+
+**插件类型**：
+- `HyperSchedulerPlugin`
+- `DevToolsOptions`
+
+[查看完整文档 →](./types.md)
+
+---
+
+## 快速查找
+
+### 按功能分类
+
+#### 任务管理
+- [创建任务](./scheduler.md#createtask) - `scheduler.createTask()`
+- [删除任务](./scheduler.md#deletetask) - `scheduler.deleteTask()`
+- [查询任务](./scheduler.md#gettask) - `scheduler.getTask()`
+- [获取所有任务](./scheduler.md#getalltasks) - `scheduler.getAllTasks()`
+
+#### 任务控制
+- [启动调度器](./scheduler.md#start) - `scheduler.start()`
+- [停止调度器](./scheduler.md#stop) - `scheduler.stop()`
+- [启动任务](./scheduler.md#starttask) - `scheduler.startTask()`
+- [停止任务](./scheduler.md#stoptask) - `scheduler.stopTask()`
+- [手动触发](./scheduler.md#triggertask) - `scheduler.triggerTask()`
+
+#### 任务配置
+- [调度规则](./task.md#schedule) - Cron 表达式 / 时间间隔
+- [重试策略](./task.md#retry) - 失败重试配置
+- [时区设置](./task.md#timezone) - 任务专属时区
+- [错误处理](./task.md#onerror) - 错误回调函数
+
+#### 事件监听
+- [订阅事件](./scheduler.md#on) - `scheduler.on()`
+- [事件类型](./scheduler.md#支持的事件) - 完整事件列表
+
+#### 调试工具
+- [DevTools 配置](./devtools.md#构造函数) - 初始化选项
+- [主题设置](./devtools.md#主题配置) - light / dark / auto
+- [语言设置](./devtools.md#语言设置) - en / zh
+
+---
+
+## 使用示例
+
+### 基础用法
+
+```typescript
+import { Scheduler } from 'hyper-scheduler';
+
+const scheduler = new Scheduler({ debug: true });
+
+scheduler.createTask({
+  id: 'my-task',
+  schedule: '*/5 * * * * *',
+  handler: () => console.log('Task executed')
+});
+
+scheduler.start();
+```
+
+### 带重试和错误处理
+
+```typescript
+scheduler.createTask({
+  id: 'api-sync',
+  schedule: '5m',
+  handler: async () => {
+    await syncWithAPI();
+  },
+  options: {
+    retry: {
+      maxAttempts: 3,
+      initialDelay: 1000,
+      factor: 2
+    },
+    onError: (error, taskId) => {
+      console.error(`Task ${taskId} failed:`, error);
+    }
+  }
+});
+```
+
+### 使用 DevTools
+
+```typescript
+import { Scheduler, DevTools } from 'hyper-scheduler';
+
+const scheduler = new Scheduler({
+  plugins: [
+    new DevTools({
+      theme: 'dark',
+      language: 'zh'
+    })
+  ]
+});
+```
+
+---
+
+## 相关链接
+
+- [快速开始](../guide/getting-started.md) - 入门指南
+- [核心概念](../guide/core-concepts.md) - 深入理解
+- [最佳实践](../guide/best-practices.md) - 使用建议