vue-network-time 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WatcherDing
+
+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/README.md

@@ -0,0 +1,257 @@
+# Vue Network Time
+
+<p align="center">
+  <strong>🕐 生产级 Vue 3 网络时间同步 SDK</strong>
+</p>
+
+<p align="center">
+  支持多时间源、Web Worker、时区格式化等企业级特性
+</p>
+
+## ✨ 特性
+
+- 🎯 **精确同步** - 基于 NTP 算法的 RTT 时间漂移修正
+- 🔄 **多时间源** - 支持多个时间源，提供 first-success 和 average 两种策略
+- 🚀 **Web Worker** - 后台线程同步，防止浏览器标签页挂起影响时间精度
+- 🌍 **时区支持** - 基于 Intl.DateTimeFormat 的时区格式化
+- 🔁 **自动重试** - 可配置的重试次数和指数退避策略
+- 💾 **单例模式** - 多组件共享同一实例，避免重复请求
+- 📦 **TypeScript** - 完整的类型定义和类型安全
+- 🌲 **Tree-shaking** - 模块化设计，支持按需引入
+- ⚡ **轻量级** - 核心代码约 15-20KB（minified）
+
+## 📦 安装
+
+```bash
+# npm
+npm install vue-network-time
+
+# pnpm
+pnpm add vue-network-time
+
+# yarn
+yarn add vue-network-time
+```
+
+## 🚀 快速开始
+
+```vue
+<template>
+  <div>
+    <p>当前时间: {{ now }}</p>
+    <p>格式化时间: {{ formatted }}</p>
+    <p>时间偏移: {{ offset }}ms</p>
+    <button @click="start">启动</button>
+    <button @click="stop">停止</button>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { onMounted } from 'vue'
+import { useNetworkTime } from 'vue-network-time'
+
+const { now, formatted, offset, running, start, stop, syncNow } = useNetworkTime({
+  url: 'https://worldtimeapi.org/api/timezone/Asia/Shanghai',
+  timeField: 'unixtime',
+  timeFormat: 's',
+  timezone: 'Asia/Shanghai',
+  syncInterval: 60000,
+  debug: true
+})
+
+onMounted(() => start())
+</script>
+```
+
+## 📖 API 文档
+
+### `useNetworkTime(options)`
+
+主要的 Vue 3 组合式函数。
+
+#### 参数：`NetworkTimeOptions`
+
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `url` | `string` | - | 单个时间源 URL |
+| `urls` | `string[]` | - | 多个时间源 URL |
+| `urlStrategy` | `'first-success' \| 'average'` | `'first-success'` | 多 URL 策略 |
+| `syncInterval` | `number` | `60000` | 同步间隔（毫秒） |
+| `tickInterval` | `number` | `1000` | Tick 间隔（毫秒） |
+| `timezone` | `string` | - | 时区（如 'Asia/Shanghai'） |
+| `timeField` | `string \| (resp: any) => number` | `'time'` | 时间字段名或提取函数 |
+| `timeFormat` | `'ms' \| 's' \| 'iso'` | `'ms'` | 时间格式 |
+| `parseTime` | `(resp: any) => number` | - | 自定义解析函数 |
+| `retry` | `RetryConfig` | `{ times: 3, interval: 1000, backoff: true }` | 重试配置 |
+| `offlineMode` | `'local' \| 'freeze' \| 'error'` | `'local'` | 离线模式 |
+| `singleton` | `boolean` | `false` | 是否启用单例模式 |
+| `cacheKey` | `string` | - | 单例缓存键 |
+| `useWorker` | `boolean` | `false` | 是否使用 Web Worker |
+| `debug` | `boolean` | `false` | 是否启用调试日志 |
+| `onError` | `(err: Error) => void` | - | 错误回调 |
+| `onSync` | `(time: number) => void` | - | 同步成功回调 |
+| `onTick` | `(time: number) => void` | - | Tick 回调 |
+
+#### 返回值：`UseNetworkTimeReturn`
+
+| 属性 | 类型 | 说明 |
+|------|------|------|
+| `now` | `Ref<number>` | 当前时间戳（毫秒） |
+| `formatted` | `Ref<string>` | 格式化后的时间字符串 |
+| `offset` | `Ref<number>` | 时间偏移量（毫秒） |
+| `running` | `Ref<boolean>` | 是否正在运行 |
+| `start` | `() => void` | 启动时间同步 |
+| `stop` | `() => void` | 停止时间同步 |
+| `syncNow` | `() => Promise<void>` | 立即同步 |
+
+## 💡 使用示例
+
+### 多时间源 + 平均策略
+
+```ts
+const { now, offset } = useNetworkTime({
+  urls: [
+    'https://worldtimeapi.org/api/timezone/Asia/Shanghai',
+    'https://timeapi.io/api/Time/current/zone?timeZone=Asia/Shanghai'
+  ],
+  urlStrategy: 'average', // 使用多个时间源的平均值
+  timeField: (resp) => {
+    // 自定义解析函数，适配不同 API
+    if (resp.unixtime) return resp.unixtime * 1000
+    if (resp.dateTime) return new Date(resp.dateTime).getTime()
+    return Date.now()
+  }
+})
+```
+
+### Web Worker 模式
+
+```ts
+const { now, formatted } = useNetworkTime({
+  url: 'https://worldtimeapi.org/api/timezone/Asia/Shanghai',
+  useWorker: true, // 在 Worker 中运行，防止标签页挂起
+  timezone: 'Asia/Shanghai',
+  syncInterval: 60000
+})
+```
+
+### 单例模式（多组件共享）
+
+```ts
+// 组件 A
+const time1 = useNetworkTime({
+  url: 'https://worldtimeapi.org/api/timezone/Asia/Shanghai',
+  singleton: true,
+  cacheKey: 'global-time'
+})
+
+// 组件 B（共享同一实例，不会重复请求）
+const time2 = useNetworkTime({
+  url: 'https://worldtimeapi.org/api/timezone/Asia/Shanghai',
+  singleton: true,
+  cacheKey: 'global-time'
+})
+```
+
+### 自定义重试策略
+
+```ts
+const { now } = useNetworkTime({
+  url: 'https://worldtimeapi.org/api/timezone/Asia/Shanghai',
+  retry: {
+    times: 5,           // 重试 5 次
+    interval: 2000,     // 初始间隔 2 秒
+    backoff: true       // 启用指数退避
+  }
+})
+```
+
+### 离线模式处理
+
+```ts
+const { now } = useNetworkTime({
+  url: 'https://worldtimeapi.org/api/timezone/Asia/Shanghai',
+  offlineMode: 'local', // 'local' | 'freeze' | 'error'
+  onError: (error) => {
+    console.error('同步失败:', error)
+  }
+})
+```
+
+## 🔧 核心算法
+
+### RTT 时间漂移修正
+
+本 SDK 使用类似 NTP 的算法计算时间偏移：
+
+```
+offset = serverTime - (requestStart + RTT / 2)
+correctedTime = Date.now() + offset
+```
+
+其中：
+- `serverTime`: 服务器返回的时间戳
+- `requestStart`: 请求开始时间
+- `RTT`: 往返时间（Round Trip Time）
+
+### 多时间源策略
+
+**First-Success（默认）**
+- 按顺序尝试每个时间源
+- 使用第一个成功的响应
+- 速度快，适合对精度要求不高的场景
+
+**Average**
+- 并发请求所有时间源
+- 计算所有成功响应的平均偏移量
+- 精度高，适合对时间精度要求高的场景
+
+## ⚠️ 注意事项
+
+### CORS 要求
+
+时间 API 必须支持 CORS，否则会出现跨域错误。推荐的公共时间 API：
+
+- [WorldTimeAPI](https://worldtimeapi.org/)
+- [TimeAPI](https://timeapi.io/)
+- [WorldClockAPI](http://worldclockapi.com/)
+
+### Web Worker 限制
+
+- 需要 HTTPS 环境（生产环境）
+- 某些浏览器可能不支持 Worker
+- Worker 中无法访问 DOM
+
+### 时区支持
+
+- 依赖浏览器的 `Intl.DateTimeFormat` API
+- 需要现代浏览器支持
+- 时区标识符遵循 IANA 标准
+
+## 📊 性能指标
+
+- **包大小**: ~15-20KB (minified)
+- **内存占用**: 单实例 ~1-2KB，Worker 额外 ~5KB
+- **网络请求**: 可配置同步间隔，默认 60 秒
+- **时间精度**: ±10-50ms（取决于网络延迟）
+
+## 🛠️ 开发
+
+```bash
+# 安装依赖
+pnpm install
+
+# 类型检查
+pnpm run type-check
+
+# 构建
+pnpm run build
+```
+
+## 📄 License
+
+MIT License © 2026
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request！

package/dist/core/DriftCorrector.d.ts

@@ -0,0 +1,47 @@
+import type { TimeSyncResponse } from '../types';
+/**
+ * 时间漂移修正器
+ * 使用 RTT（往返时间）算法计算和修正本地时间偏移
+ */
+export declare class DriftCorrector {
+    private offset;
+    private lastSyncTime;
+    private rttHistory;
+    private readonly maxHistorySize;
+    /**
+     * 计算时间偏移量
+     * 算法：offset = serverTime - (requestStart + RTT / 2)
+     *
+     * @param response 时间同步响应
+     * @returns 计算出的偏移量（毫秒）
+     */
+    calculateOffset(response: TimeSyncResponse): number;
+    /**
+     * 计算多个时间源的平均偏移量
+     * @param responses 多个时间同步响应
+     * @returns 平均偏移量
+     */
+    calculateAverageOffset(responses: TimeSyncResponse[]): number;
+    /**
+     * 获取当前修正后的时间
+     * @returns 修正后的时间戳（毫秒）
+     */
+    getCorrectedTime(): number;
+    /**
+     * 获取当前偏移量
+     */
+    getOffset(): number;
+    /**
+     * 获取上次同步时间
+     */
+    getLastSyncTime(): number;
+    /**
+     * 获取平均 RTT
+     */
+    getAverageRTT(): number;
+    /**
+     * 重置偏移量
+     */
+    reset(): void;
+}
+//# sourceMappingURL=DriftCorrector.d.ts.map

package/dist/core/DriftCorrector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DriftCorrector.d.ts","sourceRoot":"","sources":["../../src/core/DriftCorrector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAEhD;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,YAAY,CAAY;IAChC,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAK;IAEpC;;;;;;OAMG;IACH,eAAe,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM;IA4BnD;;;;OAIG;IACH,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,MAAM;IA+B7D;;;OAGG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,aAAa,IAAI,MAAM;IAKvB;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd"}

package/dist/core/RetryStrategy.d.ts

@@ -0,0 +1,31 @@
+import type { RetryConfig } from '../types';
+/**
+ * 重试策略
+ * 支持固定间隔和指数退避
+ */
+export declare class RetryStrategy {
+    private currentAttempt;
+    private readonly config;
+    constructor(config?: RetryConfig);
+    /**
+     * 执行带重试的异步操作
+     * @param fn 要执行的异步函数
+     * @param onRetry 重试时的回调
+     * @returns 操作结果
+     */
+    execute<T>(fn: () => Promise<T>, onRetry?: (attempt: number, error: Error) => void): Promise<T>;
+    /**
+     * 等待指定时间
+     * 如果启用指数退避，等待时间会随重试次数增加
+     */
+    private wait;
+    /**
+     * 获取当前重试次数
+     */
+    getCurrentAttempt(): number;
+    /**
+     * 重置重试计数
+     */
+    reset(): void;
+}
+//# sourceMappingURL=RetryStrategy.d.ts.map

package/dist/core/RetryStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetryStrategy.d.ts","sourceRoot":"","sources":["../../src/core/RetryStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,cAAc,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,MAAM,GAAE,WAA0C;IAQ9D;;;;;OAKG;IACG,OAAO,CAAC,CAAC,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,GAChD,OAAO,CAAC,CAAC,CAAC;IA6Bb;;;OAGG;IACH,OAAO,CAAC,IAAI;IAQZ;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/TimeParser.d.ts

@@ -0,0 +1,32 @@
+import type { TimeFormat } from '../types';
+/**
+ * 时间解析器
+ * 负责从各种格式中解析时间戳
+ */
+export declare class TimeParser {
+    /**
+     * 从响应中解析时间
+     * @param response 服务器响应
+     * @param timeField 时间字段名或提取函数
+     * @param timeFormat 时间格式
+     * @param parseTime 自定义解析函数
+     * @returns 时间戳（毫秒）
+     */
+    static parse(response: any, timeField?: string | ((resp: any) => number), timeFormat?: TimeFormat, parseTime?: (resp: any) => number): number;
+    /**
+     * 标准化时间值为毫秒时间戳
+     */
+    private static normalize;
+    /**
+     * 获取嵌套对象的值
+     * 支持 'data.time' 这样的路径
+     */
+    private static getNestedValue;
+    /**
+     * 验证时间戳是否合理
+     * @param timestamp 时间戳（毫秒）
+     * @returns 是否有效
+     */
+    static isValidTimestamp(timestamp: number): boolean;
+}
+//# sourceMappingURL=TimeParser.d.ts.map

package/dist/core/TimeParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeParser.d.ts","sourceRoot":"","sources":["../../src/core/TimeParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C;;;GAGG;AACH,qBAAa,UAAU;IACrB;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CACV,QAAQ,EAAE,GAAG,EACb,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,CAAC,EAC5C,UAAU,GAAE,UAAiB,EAC7B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,GAChC,MAAM;IAqBT;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAgCxB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAI7B;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAYpD"}

package/dist/core/TimeSyncClient.d.ts

@@ -0,0 +1,100 @@
+import type { NetworkTimeOptions } from '../types';
+/**
+ * 时间同步客户端
+ * 核心时间同步逻辑的协调器
+ */
+export declare class TimeSyncClient {
+    private options;
+    private driftCorrector;
+    private retryStrategy;
+    private timezone;
+    private syncTimer;
+    private tickTimer;
+    private running;
+    private currentTime;
+    private formattedTime;
+    private onTimeUpdate?;
+    private onFormattedUpdate?;
+    private onOffsetUpdate?;
+    private onRunningUpdate?;
+    constructor(options: NetworkTimeOptions);
+    /**
+     * 合并默认选项
+     */
+    private mergeDefaultOptions;
+    /**
+     * 启动时间同步
+     */
+    start(): void;
+    /**
+     * 停止时间同步
+     */
+    stop(): void;
+    /**
+     * 立即执行同步
+     */
+    syncNow(): Promise<void>;
+    /**
+     * 执行时间同步
+     */
+    private performSync;
+    /**
+     * 第一个成功策略
+     */
+    private syncFirstSuccess;
+    /**
+     * 平均值策略
+     */
+    private syncAverage;
+    /**
+     * 从单个 URL 获取时间
+     */
+    private fetchTime;
+    /**
+     * Tick 更新
+     */
+    private tick;
+    /**
+     * 处理同步错误
+     */
+    private handleSyncError;
+    /**
+     * 设置回调函数
+     */
+    onUpdate(callbacks: {
+        onTime?: (time: number) => void;
+        onFormatted?: (formatted: string) => void;
+        onOffset?: (offset: number) => void;
+        onRunning?: (running: boolean) => void;
+    }): void;
+    /**
+     * 更新时间
+     */
+    private updateTime;
+    /**
+     * 更新格式化时间
+     */
+    private updateFormatted;
+    /**
+     * 更新偏移量
+     */
+    private updateOffset;
+    /**
+     * 更新运行状态
+     */
+    private updateRunning;
+    /**
+     * 获取当前状态
+     */
+    getState(): {
+        now: number;
+        offset: number;
+        running: boolean;
+        formatted: string;
+    };
+    /**
+     * 日志输出
+     */
+    private log;
+}
+//# sourceMappingURL=TimeSyncClient.d.ts.map

package/dist/core/TimeSyncClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeSyncClient.d.ts","sourceRoot":"","sources":["../../src/core/TimeSyncClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAoB,MAAM,UAAU,CAAA;AAkBpE;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAwB;IAExC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,OAAO,CAAiB;IAEhC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,aAAa,CAAa;IAGlC,OAAO,CAAC,YAAY,CAAC,CAAwB;IAC7C,OAAO,CAAC,iBAAiB,CAAC,CAA6B;IACvD,OAAO,CAAC,cAAc,CAAC,CAA0B;IACjD,OAAO,CAAC,eAAe,CAAC,CAA4B;gBAExC,OAAO,EAAE,kBAAkB;IAgBvC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0C3B;;OAEG;IACH,KAAK,IAAI,IAAI;IA4Bb;;OAEG;IACH,IAAI,IAAI,IAAI;IAqBZ;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B;;OAEG;YACW,WAAW;IAgBzB;;OAEG;YACW,gBAAgB;IAe9B;;OAEG;YACW,WAAW;IAuBzB;;OAEG;YACW,SAAS;IAwDvB;;OAEG;IACH,OAAO,CAAC,IAAI;IAgBZ;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE;QAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;QAC/B,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;QACzC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;QACnC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;KACvC,GAAG,IAAI;IAOR;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,QAAQ;;;;;;IASR;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ"}

package/dist/core/TimeSyncSingleton.d.ts

@@ -0,0 +1,36 @@
+import type { NetworkTimeOptions } from '../types';
+import { TimeSyncClient } from './TimeSyncClient';
+/**
+ * 时间同步单例管理器
+ * 用于在多个组件间共享同一个时间同步实例
+ */
+export declare class TimeSyncSingleton {
+    private static instances;
+    private static refCounts;
+    /**
+     * 获取或创建单例实例
+     * @param options 配置选项
+     * @returns 时间同步客户端实例
+     */
+    static getInstance(options: NetworkTimeOptions): TimeSyncClient;
+    /**
+     * 释放实例引用
+     * 当引用计数归零时，销毁实例
+     * @param options 配置选项
+     */
+    static releaseInstance(options: NetworkTimeOptions): void;
+    /**
+     * 生成缓存键
+     * 基于 URL 和主要配置生成唯一键
+     */
+    private static generateKey;
+    /**
+     * 清除所有实例（用于测试或重置）
+     */
+    static clearAll(): void;
+    /**
+     * 获取当前实例数量
+     */
+    static getInstanceCount(): number;
+}
+//# sourceMappingURL=TimeSyncSingleton.d.ts.map

package/dist/core/TimeSyncSingleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeSyncSingleton.d.ts","sourceRoot":"","sources":["../../src/core/TimeSyncSingleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAyC;IACjE,OAAO,CAAC,MAAM,CAAC,SAAS,CAAiC;IAEzD;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,cAAc;IAkB/D;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAkBzD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAS1B;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,IAAI;IAMvB;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,MAAM;CAGlC"}

package/dist/core/Timezone.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 时区格式化器
+ * 使用 Intl.DateTimeFormat 进行时区转换和格式化
+ */
+export declare class Timezone {
+    private formatter;
+    private timezone;
+    constructor(timezone?: string);
+    /**
+     * 创建格式化器
+     */
+    private createFormatter;
+    /**
+     * 格式化时间戳
+     * @param timestamp 时间戳（毫秒）
+     * @returns 格式化后的时间字符串
+     */
+    format(timestamp: number): string;
+    /**
+     * 使用自定义选项格式化
+     * @param timestamp 时间戳（毫秒）
+     * @param options Intl.DateTimeFormat 选项
+     * @returns 格式化后的时间字符串
+     */
+    formatCustom(timestamp: number, options: Intl.DateTimeFormatOptions): string;
+    /**
+     * 获取当前时区
+     */
+    getTimezone(): string;
+    /**
+     * 设置新时区
+     */
+    setTimezone(timezone: string): void;
+    /**
+     * 验证时区是否有效
+     */
+    static isValidTimezone(timezone: string): boolean;
+}
+//# sourceMappingURL=Timezone.d.ts.map

package/dist/core/Timezone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Timezone.d.ts","sourceRoot":"","sources":["../../src/core/Timezone.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,QAAQ,GAAE,MAAc;IAKpC;;OAEG;IACH,OAAO,CAAC,eAAe;IA4BvB;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAajC;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,qBAAqB,GAAG,MAAM;IAa5E;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKnC;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAQlD"}

package/dist/core/WorkerClient.d.ts

@@ -0,0 +1,58 @@
+import type { NetworkTimeOptions } from '../types';
+/**
+ * Worker 客户端
+ * 主线程与 Worker 线程的通信接口
+ */
+export declare class WorkerClient {
+    private worker;
+    private options;
+    private onTick?;
+    private onSynced?;
+    private onError?;
+    constructor(options: NetworkTimeOptions);
+    /**
+     * 初始化 Worker
+     */
+    init(): Promise<void>;
+    /**
+     * 启动 Worker
+     */
+    start(): void;
+    /**
+     * 停止 Worker
+     */
+    stop(): void;
+    /**
+     * 立即同步
+     */
+    syncNow(): void;
+    /**
+     * 销毁 Worker
+     */
+    destroy(): void;
+    /**
+     * 设置回调函数
+     */
+    setCallbacks(callbacks: {
+        onTick?: (time: number, offset: number) => void;
+        onSynced?: (offset: number) => void;
+        onError?: (error: Error) => void;
+    }): void;
+    /**
+     * 发送消息到 Worker
+     */
+    private postMessage;
+    /**
+     * 处理来自 Worker 的消息
+     */
+    private handleMessage;
+    /**
+     * 处理 Worker 错误
+     */
+    private handleError;
+    /**
+     * 检查 Worker 是否可用
+     */
+    static isSupported(): boolean;
+}
+//# sourceMappingURL=WorkerClient.d.ts.map

package/dist/core/WorkerClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerClient.d.ts","sourceRoot":"","sources":["../../src/core/WorkerClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAiB,MAAM,UAAU,CAAA;AAEjE;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAAoB;IAGnC,OAAO,CAAC,MAAM,CAAC,CAAwC;IACvD,OAAO,CAAC,QAAQ,CAAC,CAA0B;IAC3C,OAAO,CAAC,OAAO,CAAC,CAAwB;gBAE5B,OAAO,EAAE,kBAAkB;IAIvC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE;QACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;QAC/C,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;QACnC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;KACjC,GAAG,IAAI;IAMR;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,OAAO,CAAC,aAAa;IA2BrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,OAAO;CAG9B"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Vue Network Time - 生产级网络时间同步 SDK
+ *
+ * @packageDocumentation
+ */
+export { useNetworkTime } from './vue/useNetworkTime';
+export type { UseNetworkTimeReturn } from './vue/useNetworkTime';
+export type { NetworkTimeOptions, TimeSyncState, TimeSyncResponse, TimeSourceStrategy, TimeFormat, OfflineMode, RetryConfig, WorkerMessage, WorkerMessageType } from './types';
+export { TimeSyncClient } from './core/TimeSyncClient';
+export { TimeSyncSingleton } from './core/TimeSyncSingleton';
+export { TimeParser } from './core/TimeParser';
+export { DriftCorrector } from './core/DriftCorrector';
+export { RetryStrategy } from './core/RetryStrategy';
+export { Timezone } from './core/Timezone';
+export { WorkerClient } from './core/WorkerClient';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAGhE,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,iBAAiB,EAClB,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA"}