hyper-scheduler 1.0.1 → 1.1.0

package/docs/.vitepress/cache/deps/vue.js

@@ -0,0 +1,347 @@
+import {
+  BaseTransition,
+  BaseTransitionPropsValidators,
+  Comment,
+  DeprecationTypes,
+  EffectScope,
+  ErrorCodes,
+  ErrorTypeStrings,
+  Fragment,
+  KeepAlive,
+  ReactiveEffect,
+  Static,
+  Suspense,
+  Teleport,
+  Text,
+  TrackOpTypes,
+  Transition,
+  TransitionGroup,
+  TriggerOpTypes,
+  VueElement,
+  assertNumber,
+  callWithAsyncErrorHandling,
+  callWithErrorHandling,
+  camelize,
+  capitalize,
+  cloneVNode,
+  compatUtils,
+  compile,
+  computed,
+  createApp,
+  createBaseVNode,
+  createBlock,
+  createCommentVNode,
+  createElementBlock,
+  createHydrationRenderer,
+  createPropsRestProxy,
+  createRenderer,
+  createSSRApp,
+  createSlots,
+  createStaticVNode,
+  createTextVNode,
+  createVNode,
+  customRef,
+  defineAsyncComponent,
+  defineComponent,
+  defineCustomElement,
+  defineEmits,
+  defineExpose,
+  defineModel,
+  defineOptions,
+  defineProps,
+  defineSSRCustomElement,
+  defineSlots,
+  devtools,
+  effect,
+  effectScope,
+  getCurrentInstance,
+  getCurrentScope,
+  getCurrentWatcher,
+  getTransitionRawChildren,
+  guardReactiveProps,
+  h,
+  handleError,
+  hasInjectionContext,
+  hydrate,
+  hydrateOnIdle,
+  hydrateOnInteraction,
+  hydrateOnMediaQuery,
+  hydrateOnVisible,
+  initCustomFormatter,
+  initDirectivesForSSR,
+  inject,
+  isMemoSame,
+  isProxy,
+  isReactive,
+  isReadonly,
+  isRef,
+  isRuntimeOnly,
+  isShallow,
+  isVNode,
+  markRaw,
+  mergeDefaults,
+  mergeModels,
+  mergeProps,
+  nextTick,
+  nodeOps,
+  normalizeClass,
+  normalizeProps,
+  normalizeStyle,
+  onActivated,
+  onBeforeMount,
+  onBeforeUnmount,
+  onBeforeUpdate,
+  onDeactivated,
+  onErrorCaptured,
+  onMounted,
+  onRenderTracked,
+  onRenderTriggered,
+  onScopeDispose,
+  onServerPrefetch,
+  onUnmounted,
+  onUpdated,
+  onWatcherCleanup,
+  openBlock,
+  patchProp,
+  popScopeId,
+  provide,
+  proxyRefs,
+  pushScopeId,
+  queuePostFlushCb,
+  reactive,
+  readonly,
+  ref,
+  registerRuntimeCompiler,
+  render,
+  renderList,
+  renderSlot,
+  resolveComponent,
+  resolveDirective,
+  resolveDynamicComponent,
+  resolveFilter,
+  resolveTransitionHooks,
+  setBlockTracking,
+  setDevtoolsHook,
+  setTransitionHooks,
+  shallowReactive,
+  shallowReadonly,
+  shallowRef,
+  ssrContextKey,
+  ssrUtils,
+  stop,
+  toDisplayString,
+  toHandlerKey,
+  toHandlers,
+  toRaw,
+  toRef,
+  toRefs,
+  toValue,
+  transformVNodeArgs,
+  triggerRef,
+  unref,
+  useAttrs,
+  useCssModule,
+  useCssVars,
+  useHost,
+  useId,
+  useModel,
+  useSSRContext,
+  useShadowRoot,
+  useSlots,
+  useTemplateRef,
+  useTransitionState,
+  vModelCheckbox,
+  vModelDynamic,
+  vModelRadio,
+  vModelSelect,
+  vModelText,
+  vShow,
+  version,
+  warn,
+  watch,
+  watchEffect,
+  watchPostEffect,
+  watchSyncEffect,
+  withAsyncContext,
+  withCtx,
+  withDefaults,
+  withDirectives,
+  withKeys,
+  withMemo,
+  withModifiers,
+  withScopeId
+} from "./chunk-EKBJ2FPM.js";
+export {
+  BaseTransition,
+  BaseTransitionPropsValidators,
+  Comment,
+  DeprecationTypes,
+  EffectScope,
+  ErrorCodes,
+  ErrorTypeStrings,
+  Fragment,
+  KeepAlive,
+  ReactiveEffect,
+  Static,
+  Suspense,
+  Teleport,
+  Text,
+  TrackOpTypes,
+  Transition,
+  TransitionGroup,
+  TriggerOpTypes,
+  VueElement,
+  assertNumber,
+  callWithAsyncErrorHandling,
+  callWithErrorHandling,
+  camelize,
+  capitalize,
+  cloneVNode,
+  compatUtils,
+  compile,
+  computed,
+  createApp,
+  createBlock,
+  createCommentVNode,
+  createElementBlock,
+  createBaseVNode as createElementVNode,
+  createHydrationRenderer,
+  createPropsRestProxy,
+  createRenderer,
+  createSSRApp,
+  createSlots,
+  createStaticVNode,
+  createTextVNode,
+  createVNode,
+  customRef,
+  defineAsyncComponent,
+  defineComponent,
+  defineCustomElement,
+  defineEmits,
+  defineExpose,
+  defineModel,
+  defineOptions,
+  defineProps,
+  defineSSRCustomElement,
+  defineSlots,
+  devtools,
+  effect,
+  effectScope,
+  getCurrentInstance,
+  getCurrentScope,
+  getCurrentWatcher,
+  getTransitionRawChildren,
+  guardReactiveProps,
+  h,
+  handleError,
+  hasInjectionContext,
+  hydrate,
+  hydrateOnIdle,
+  hydrateOnInteraction,
+  hydrateOnMediaQuery,
+  hydrateOnVisible,
+  initCustomFormatter,
+  initDirectivesForSSR,
+  inject,
+  isMemoSame,
+  isProxy,
+  isReactive,
+  isReadonly,
+  isRef,
+  isRuntimeOnly,
+  isShallow,
+  isVNode,
+  markRaw,
+  mergeDefaults,
+  mergeModels,
+  mergeProps,
+  nextTick,
+  nodeOps,
+  normalizeClass,
+  normalizeProps,
+  normalizeStyle,
+  onActivated,
+  onBeforeMount,
+  onBeforeUnmount,
+  onBeforeUpdate,
+  onDeactivated,
+  onErrorCaptured,
+  onMounted,
+  onRenderTracked,
+  onRenderTriggered,
+  onScopeDispose,
+  onServerPrefetch,
+  onUnmounted,
+  onUpdated,
+  onWatcherCleanup,
+  openBlock,
+  patchProp,
+  popScopeId,
+  provide,
+  proxyRefs,
+  pushScopeId,
+  queuePostFlushCb,
+  reactive,
+  readonly,
+  ref,
+  registerRuntimeCompiler,
+  render,
+  renderList,
+  renderSlot,
+  resolveComponent,
+  resolveDirective,
+  resolveDynamicComponent,
+  resolveFilter,
+  resolveTransitionHooks,
+  setBlockTracking,
+  setDevtoolsHook,
+  setTransitionHooks,
+  shallowReactive,
+  shallowReadonly,
+  shallowRef,
+  ssrContextKey,
+  ssrUtils,
+  stop,
+  toDisplayString,
+  toHandlerKey,
+  toHandlers,
+  toRaw,
+  toRef,
+  toRefs,
+  toValue,
+  transformVNodeArgs,
+  triggerRef,
+  unref,
+  useAttrs,
+  useCssModule,
+  useCssVars,
+  useHost,
+  useId,
+  useModel,
+  useSSRContext,
+  useShadowRoot,
+  useSlots,
+  useTemplateRef,
+  useTransitionState,
+  vModelCheckbox,
+  vModelDynamic,
+  vModelRadio,
+  vModelSelect,
+  vModelText,
+  vShow,
+  version,
+  warn,
+  watch,
+  watchEffect,
+  watchPostEffect,
+  watchSyncEffect,
+  withAsyncContext,
+  withCtx,
+  withDefaults,
+  withDirectives,
+  withKeys,
+  withMemo,
+  withModifiers,
+  withScopeId
+};
+//# sourceMappingURL=vue.js.map

package/docs/.vitepress/cache/deps/vue.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/docs/.vitepress/config.ts

@@ -0,0 +1,56 @@
+import { defineConfig } from 'vitepress';
+
+export default defineConfig({
+  base: '/hyper-scheduler/', // 设置 GitHub Pages 的基础路径
+  lang: 'zh-CN', // 设置语言为中文
+  title: 'Hyper Scheduler', // 更新标题
+  description: '轻量级全局任务调度 JavaScript 库。', // 更新描述
+  head: [
+    ['link', { rel: 'icon', href: '/logo.svg', type: 'image/svg+xml' }]
+  ],
+  themeConfig: {
+    logo: '/logo.svg',
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/CrazyMrYan/hyper-scheduler' }
+    ],
+    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/.vitepress/theme/components/DemoFrame.vue

@@ -0,0 +1,111 @@
+<script setup>
+import { defineProps, computed, ref, onMounted } from 'vue';
+import { useData } from 'vitepress';
+
+const { site } = useData();
+
+const props = defineProps({
+  path: {
+    type: String,
+    required: true
+  },
+  devPort: {
+    type: Number,
+    default: null
+  },
+  devPath: {
+    type: String,
+    default: '/'
+  },
+  title: {
+    type: String,
+    default: 'Demo'
+  }
+});
+
+const src = computed(() => {
+  const isDev = import.meta.env.DEV;
+  
+  // 如果在本地开发环境，且指定了端口，则使用 localhost
+  if (isDev && props.devPort) {
+    return `http://localhost:${props.devPort}${props.devPath}`;
+  }
+  
+  // 否则（生产环境构建或未指定端口），使用相对路径，并加上 base
+  const base = site.value.base || '/';
+  // 移除 path 开头的 /，避免双重斜杠或绝对路径问题
+  const cleanPath = props.path.startsWith('/') ? props.path.slice(1) : props.path;
+  // 确保 base 以 / 结尾
+  const cleanBase = base.endsWith('/') ? base : `${base}/`;
+  
+  return `${cleanBase}${cleanPath}`;
+});
+</script>
+
+<template>
+  <div class="demo-frame-container">
+    <div class="demo-header">
+      <span class="dot red"></span>
+      <span class="dot yellow"></span>
+      <span class="dot green"></span>
+      <span class="title">{{ title }}</span>
+      <a :href="src" target="_blank" class="open-btn" title="在新窗口打开">↗</a>
+    </div>
+    <iframe :src="src" class="demo-frame"></iframe>
+  </div>
+</template>
+
+<style scoped>
+.demo-frame-container {
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 8px;
+  overflow: hidden;
+  margin: 16px 0;
+  box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
+  background: var(--vp-c-bg);
+}
+
+.demo-header {
+  background: var(--vp-c-bg-soft);
+  padding: 8px 12px;
+  display: flex;
+  align-items: center;
+  border-bottom: 1px solid var(--vp-c-divider);
+}
+
+.dot {
+  width: 10px;
+  height: 10px;
+  border-radius: 50%;
+  margin-right: 6px;
+}
+
+.red { background-color: #ff5f56; }
+.yellow { background-color: #ffbd2e; }
+.green { background-color: #27c93f; }
+
+.title {
+  margin-left: 8px;
+  font-size: 12px;
+  color: var(--vp-c-text-2);
+  font-family: monospace;
+  flex: 1;
+}
+
+.open-btn {
+  text-decoration: none;
+  color: var(--vp-c-text-2);
+  font-size: 14px;
+}
+
+.open-btn:hover {
+  color: var(--vp-c-brand);
+}
+
+.demo-frame {
+  width: 100%;
+  height: 500px;
+  border: none;
+  display: block;
+}
+</style>

package/docs/.vitepress/theme/custom.css

@@ -0,0 +1,6 @@
+/* 自定义样式 */
+:root {
+  --vp-c-brand: #3b82f6;
+  --vp-c-brand-light: #60a5fa;
+  --vp-c-brand-dark: #2563eb;
+}

package/docs/.vitepress/theme/index.ts

@@ -0,0 +1,10 @@
+import DefaultTheme from 'vitepress/theme';
+import DemoFrame from './components/DemoFrame.vue';
+import './custom.css';
+
+export default {
+  extends: DefaultTheme,
+  enhanceApp({ app }) {
+    app.component('DemoFrame', DemoFrame);
+  }
+};

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)
+```