stock-sdk 2.0.0-beta.0 → 2.0.0

package/README.md

@@ -3,8 +3,8 @@
 [![npm version](https://img.shields.io/npm/v/stock-sdk.svg)](https://www.npmjs.com/package/stock-sdk)
 [![npm downloads](https://img.shields.io/npm/dm/stock-sdk.svg)](https://www.npmjs.com/package/stock-sdk)
 [![license](https://img.shields.io/npm/l/stock-sdk)](https://github.com/chengzuopeng/stock-sdk/blob/master/LICENSE)
-[![MCP](https://img.shields.io/badge/protocol-MCP-blue)](https://stock-sdk-v2.linkdiary.cn/mcp/)
-[![AI Ready](https://img.shields.io/badge/AI-Ready-orange)](https://stock-sdk-v2.linkdiary.cn/mcp/)
+[![MCP](https://img.shields.io/badge/protocol-MCP-blue)](https://stock-sdk.linkdiary.cn/mcp/)
+[![AI Ready](https://img.shields.io/badge/AI-Ready-orange)](https://stock-sdk.linkdiary.cn/mcp/)
 
 **[English](./README_EN.md)** | 中文
 
@@ -12,20 +12,20 @@
 
 无需 Python、无需后端服务，直接在 **浏览器或 Node.js** 中获取 **A 股 / 港股 / 美股 / 公募基金** 的实时行情与 K 线数据。还自带 **命令行工具** 与 **MCP server**，一条命令取行情或接入 AI。
 
-**✨ 零依赖 | 🌐 Browser + Node.js | 📦 ESM + CJS + subpath | 🧠 完整 TypeScript 类型 | 🖥️ CLI | 🤖 MCP**
+**✨ 零依赖、轻量发布包 | 🌐 Browser + Node.js | 📦 ESM + CJS + subpath | 🧠 完整 TypeScript 类型 | 🖥️ CLI | 🤖 MCP**
 
-> 🧪 **v2.0.0 Beta**：v2 是一次架构跃迁（命名空间 API、统一符号模型、`Quote` 可辨识联合、统一错误体系、CLI / MCP / subpath 导出）。
-> 安装 beta：`npm i stock-sdk@beta`。从 v1 升级请先读 [v1 → v2 迁移指南](https://stock-sdk-v2.linkdiary.cn/guide/migration-v1-to-v2)（**破坏性变更，无兼容别名**）。
+> ✨ **v2.0.0**：v2 是一次架构跃迁（命名空间 API、统一符号模型、`Quote` 可辨识联合、统一错误体系、CLI / MCP / subpath 导出）。
+> 安装：`npm i stock-sdk`。从 v1 升级请先读 [v1 → v2 迁移指南](https://stock-sdk.linkdiary.cn/guide/migration-v1-to-v2)（**破坏性变更，无兼容别名**）。
 
-## 📖 官网文档（v2 Beta）
+## 📖 官网文档
 
-> ## 👉 https://stock-sdk-v2.linkdiary.cn
+> ## 👉 https://stock-sdk.linkdiary.cn
 >
-> **v2 Beta 的临时官网** —— 完整 API、命名空间总览、CLI / MCP 指南、在线 Playground、v1 → v2 迁移文档全部在这里。先看官网再上手最快。
+> 完整 API、命名空间总览、CLI / MCP 指南、在线 Playground、v1 → v2 迁移文档全部在这里。先看官网再上手最快。
 >
-> （v1 稳定版文档仍在 https://stock-sdk.linkdiary.cn）
+> （[v1 稳定版文档](https://v1.stock-sdk.linkdiary.cn) 已归档）
 
-📦 [NPM](https://www.npmjs.com/package/stock-sdk) | 📖 [GitHub](https://github.com/chengzuopeng/stock-sdk) | 🎮 [在线 Playground](https://stock-sdk-v2.linkdiary.cn/playground/)
+📦 [NPM](https://www.npmjs.com/package/stock-sdk) | 📖 [GitHub](https://github.com/chengzuopeng/stock-sdk) | 🎮 [在线 Playground](https://stock-sdk.linkdiary.cn/playground/)
 
 🧭 [Stock Dashboard](https://chengzuopeng.github.io/stock-dashboard/)：基于 stock-sdk 搭建的股票数据大盘演示站点，欢迎体验。
 
@@ -75,11 +75,11 @@
 ## 安装
 
 ```bash
-# v2 Beta（命名空间 API / CLI / MCP）
-npm install stock-sdk@beta
-
-# v1 稳定版
+# 最新版（v2：命名空间 API / CLI / MCP）
 npm install stock-sdk
+
+# v1 旧版（已封存，仅维护 critical 修复）
+npm install stock-sdk@legacy
 ```
 
 ## 快速开始
@@ -154,7 +154,7 @@ npx stock-sdk mcp
 
 环境变量 `STOCK_SDK_MCP_TOOLS=core|full|<逗号分隔工具名>` 控制工具集范围（默认 `core`）。
 
-👉 [完整 MCP 文档](https://stock-sdk-v2.linkdiary.cn/mcp/)
+👉 [完整 MCP 文档](https://stock-sdk.linkdiary.cn/mcp/)
 
 ---
 
@@ -216,6 +216,10 @@ try {
 只用纯计算（指标 / 符号 / 信号 / 选股）时，从 subpath 导入，bundle 不会拖入 `RequestClient` 与所有 provider：
 
 ```ts
+// 14 个指标、共 17 个纯函数(MA 族含 calcSMA/calcEMA/calcWMA 三个变体):
+// calcSMA / calcEMA / calcWMA / calcMA / calcMACD / calcBOLL / calcKDJ /
+// calcRSI / calcWR / calcBIAS / calcCCI / calcATR / calcOBV / calcROC /
+// calcDMI / calcSAR / calcKC
 import { calcMACD, calcKDJ } from 'stock-sdk/indicators';
 import { normalizeSymbol, toTencentSymbol } from 'stock-sdk/symbols';
 import { calcSignals } from 'stock-sdk/signals';
@@ -255,7 +259,7 @@ import { SdkError, isSdkError, getSdkErrorCode } from 'stock-sdk/errors';
 
 ## API 概览（命名空间）
 
-💡 完整 API 见 [官方文档](https://stock-sdk-v2.linkdiary.cn/api/)。v2 全部方法挂在命名空间下：
+💡 完整 API 见 [官方文档](https://stock-sdk.linkdiary.cn/api/)。v2 全部方法挂在命名空间下：
 
 | 命名空间 | 代表方法 |
 |---|---|
@@ -277,18 +281,18 @@ import { SdkError, isSdkError, getSdkErrorCode } from 'stock-sdk/errors';
 | 顶层 | `sdk.search(keyword)` |
 
 > 指标计算从主包改为 subpath：`import { calcMACD } from 'stock-sdk/indicators'`。
-> 从 v1 扁平 API 迁移？见 [v1 → v2 迁移指南](https://stock-sdk-v2.linkdiary.cn/guide/migration-v1-to-v2)（含完整 `sdk.getXxx()` → `sdk.<ns>.<method>()` 映射表）。
+> 从 v1 扁平 API 迁移？见 [v1 → v2 迁移指南](https://stock-sdk.linkdiary.cn/guide/migration-v1-to-v2)（含完整 `sdk.getXxx()` → `sdk.<ns>.<method>()` 映射表）。
 
 ---
 
 ## 开发校验
 
 ```bash
-yarn typecheck
-yarn build
-yarn test
-yarn test:integration:smoke   # 冒烟集成（真实网络）
-yarn test:integration:full    # 全量集成回归
+pnpm typecheck
+pnpm build
+pnpm test
+pnpm test:integration:smoke   # 冒烟集成（真实网络）
+pnpm test:integration:full    # 全量集成回归
 ```
 
 ---
@@ -299,7 +303,7 @@ yarn test:integration:full    # 全量集成回归
 
 ---
 
-🌐 [官网](https://stock-sdk-v2.linkdiary.cn) | 📦 [NPM](https://www.npmjs.com/package/stock-sdk) | 📖 [GitHub](https://github.com/chengzuopeng/stock-sdk) | 🎮 [在线演示](https://stock-sdk-v2.linkdiary.cn/playground) | 🧭 [Stock Dashboard](https://chengzuopeng.github.io/stock-dashboard/) | 🐛 [Issues](https://github.com/chengzuopeng/stock-sdk/issues)
+🌐 [官网](https://stock-sdk.linkdiary.cn) | 📦 [NPM](https://www.npmjs.com/package/stock-sdk) | 📖 [GitHub](https://github.com/chengzuopeng/stock-sdk) | 🎮 [在线演示](https://stock-sdk.linkdiary.cn/playground/) | 🧭 [Stock Dashboard](https://chengzuopeng.github.io/stock-dashboard/) | 🐛 [Issues](https://github.com/chengzuopeng/stock-sdk/issues)
 
 ---
 

package/dist/{adapters-C0s5bM8O.d.cts → adapters-BvE63CMd.d.cts}

@@ -39,6 +39,15 @@ interface NormalizedSymbol {
 type SymbolInput = string | SymbolRef;
 
 declare function normalizeSymbol(input: SymbolInput, hint?: Partial<SymbolRef>): NormalizedSymbol;
+/**
+ * 解析符号所属市场;解析失败返回 `undefined`,不抛错。
+ *
+ * F42: 收编 SDK(indicatorService.detectMarket)与 CLI(manifest.detectMarketTag)
+ * 各自 wrap normalizeSymbol + catch 的双实现。本函数**不**替调用方决定解析失败
+ * 时的兜底市场 —— "失败归 A 股"之类的 fallback 决策保留在各调用方(各一行),
+ * 避免把上层策略埋进共享符号层。
+ */
+declare function marketOf(input: SymbolInput): Market | undefined;
 
 /**
  * Provider 符号适配器：NormalizedSymbol → 各数据源原生格式（纯函数）
@@ -48,6 +57,12 @@ declare function normalizeSymbol(input: SymbolInput, hint?: Partial<SymbolRef>):
  * 避免把海外期货误拼成美股 secid（105.xxx）这类隐蔽错误。
  */
 
+/**
+ * 交易所 → 东财 secid 数字市场前缀（仅股票类）。
+ * F41: 导出供 providers 复用（tencent/batch 的美股代码列表按前缀过滤），
+ * 不再在各处重复声明 NASDAQ/NYSE/AMEX → 105/106/107 映射。
+ */
+declare const EXCHANGE_TO_SECID_PREFIX: Record<string, string>;
 /**
  * → 腾讯行情格式：sh600519 / sz000001 / bj920819 / hk00700 / usAAPL
  */
@@ -59,4 +74,4 @@ declare function toEastmoneySecid(ns: NormalizedSymbol): string;
 /** → 纯代码（去前缀） */
 declare function toPlainCode(ns: NormalizedSymbol): string;
 
-export { type AssetType as A, type Exchange as E, type Market as M, type NormalizedSymbol as N, type SymbolRef as S, type SymbolInput as a, toEastmoneySecid as b, toPlainCode as c, normalizeSymbol as n, toTencentSymbol as t };
+export { type AssetType as A, type Exchange as E, type Market as M, type NormalizedSymbol as N, type SymbolRef as S, type SymbolInput as a, toEastmoneySecid as b, toPlainCode as c, EXCHANGE_TO_SECID_PREFIX as d, marketOf as m, normalizeSymbol as n, toTencentSymbol as t };

package/dist/{adapters-C0s5bM8O.d.ts → adapters-BvE63CMd.d.ts}

@@ -39,6 +39,15 @@ interface NormalizedSymbol {
 type SymbolInput = string | SymbolRef;
 
 declare function normalizeSymbol(input: SymbolInput, hint?: Partial<SymbolRef>): NormalizedSymbol;
+/**
+ * 解析符号所属市场;解析失败返回 `undefined`,不抛错。
+ *
+ * F42: 收编 SDK(indicatorService.detectMarket)与 CLI(manifest.detectMarketTag)
+ * 各自 wrap normalizeSymbol + catch 的双实现。本函数**不**替调用方决定解析失败
+ * 时的兜底市场 —— "失败归 A 股"之类的 fallback 决策保留在各调用方(各一行),
+ * 避免把上层策略埋进共享符号层。
+ */
+declare function marketOf(input: SymbolInput): Market | undefined;
 
 /**
  * Provider 符号适配器：NormalizedSymbol → 各数据源原生格式（纯函数）
@@ -48,6 +57,12 @@ declare function normalizeSymbol(input: SymbolInput, hint?: Partial<SymbolRef>):
  * 避免把海外期货误拼成美股 secid（105.xxx）这类隐蔽错误。
  */
 
+/**
+ * 交易所 → 东财 secid 数字市场前缀（仅股票类）。
+ * F41: 导出供 providers 复用（tencent/batch 的美股代码列表按前缀过滤），
+ * 不再在各处重复声明 NASDAQ/NYSE/AMEX → 105/106/107 映射。
+ */
+declare const EXCHANGE_TO_SECID_PREFIX: Record<string, string>;
 /**
  * → 腾讯行情格式：sh600519 / sz000001 / bj920819 / hk00700 / usAAPL
  */
@@ -59,4 +74,4 @@ declare function toEastmoneySecid(ns: NormalizedSymbol): string;
 /** → 纯代码（去前缀） */
 declare function toPlainCode(ns: NormalizedSymbol): string;
 
-export { type AssetType as A, type Exchange as E, type Market as M, type NormalizedSymbol as N, type SymbolRef as S, type SymbolInput as a, toEastmoneySecid as b, toPlainCode as c, normalizeSymbol as n, toTencentSymbol as t };
+export { type AssetType as A, type Exchange as E, type Market as M, type NormalizedSymbol as N, type SymbolRef as S, type SymbolInput as a, toEastmoneySecid as b, toPlainCode as c, EXCHANGE_TO_SECID_PREFIX as d, marketOf as m, normalizeSymbol as n, toTencentSymbol as t };

package/dist/{addIndicators-TPEcddTW.d.cts → addIndicators-DwEr9RKK.d.cts}

@@ -1,3 +1,195 @@
+interface OHLCV {
+    open: number | null;
+    high: number | null;
+    low: number | null;
+    close: number | null;
+    volume?: number | null;
+}
+interface MAOptions {
+    /** 均线周期数组，默认 [5, 10, 20, 30, 60, 120, 250] */
+    periods?: number[];
+    /** 均线类型：'sma'(简单) | 'ema'(指数) | 'wma'(加权)，默认 'sma' */
+    type?: 'sma' | 'ema' | 'wma';
+}
+interface MACDOptions {
+    /** 短期 EMA 周期，默认 12 */
+    short?: number;
+    /** 长期 EMA 周期，默认 26 */
+    long?: number;
+    /** 信号线 EMA 周期，默认 9 */
+    signal?: number;
+}
+interface BOLLOptions {
+    /** 均线周期，默认 20 */
+    period?: number;
+    /** 标准差倍数，默认 2 */
+    stdDev?: number;
+}
+interface KDJOptions {
+    /** RSV 周期，默认 9 */
+    period?: number;
+    /** K 值平滑周期，默认 3 */
+    kPeriod?: number;
+    /** D 值平滑周期，默认 3 */
+    dPeriod?: number;
+}
+interface RSIOptions {
+    /** RSI 周期数组，默认 [6, 12, 24] */
+    periods?: number[];
+}
+interface WROptions {
+    /** WR 周期数组，默认 [6, 10] */
+    periods?: number[];
+}
+interface BIASOptions {
+    /** BIAS 周期数组，默认 [6, 12, 24] */
+    periods?: number[];
+}
+interface CCIOptions {
+    /** CCI 周期，默认 14 */
+    period?: number;
+}
+interface ATROptions {
+    /** ATR 周期，默认 14 */
+    period?: number;
+}
+/**
+ * 周期型指标(periods 复数)的文档简写入参:
+ * - `[5, 20]` 等价于 `{ periods: [5, 20] }`
+ * - `{ period: 14 }` 等价于 `{ periods: [14] }`
+ * （文档与 JSDoc 示例即简写形式,registry.normalizeIndicatorOptions 在入口归一）
+ */
+type PeriodsShorthand = number[] | {
+    period: number;
+};
+interface IndicatorOptions {
+    ma?: MAOptions | PeriodsShorthand | boolean;
+    macd?: MACDOptions | boolean;
+    boll?: BOLLOptions | boolean;
+    kdj?: KDJOptions | boolean;
+    rsi?: RSIOptions | PeriodsShorthand | boolean;
+    wr?: WROptions | PeriodsShorthand | boolean;
+    bias?: BIASOptions | PeriodsShorthand | boolean;
+    cci?: CCIOptions | boolean;
+    atr?: ATROptions | boolean;
+    obv?: OBVOptions | boolean;
+    roc?: ROCOptions | boolean;
+    dmi?: DMIOptions | boolean;
+    sar?: SAROptions | boolean;
+    kc?: KCOptions | boolean;
+}
+interface MAResult {
+    [key: string]: number | null;
+}
+interface MACDResult {
+    dif: number | null;
+    dea: number | null;
+    macd: number | null;
+}
+interface BOLLResult {
+    mid: number | null;
+    upper: number | null;
+    lower: number | null;
+    bandwidth: number | null;
+}
+interface KDJResult {
+    k: number | null;
+    d: number | null;
+    j: number | null;
+}
+interface RSIResult {
+    [key: string]: number | null;
+}
+interface WRResult {
+    [key: string]: number | null;
+}
+interface BIASResult {
+    [key: string]: number | null;
+}
+interface CCIResult {
+    cci: number | null;
+}
+interface ATRResult {
+    /** 真实波幅 */
+    tr: number | null;
+    /** 平均真实波幅 */
+    atr: number | null;
+}
+interface OBVOptions {
+    /** OBV 均线周期 */
+    maPeriod?: number;
+}
+interface OBVResult {
+    /** OBV 值 */
+    obv: number | null;
+    /** OBV 均线 */
+    obvMa: number | null;
+}
+interface ROCOptions {
+    /** ROC 周期，默认 12 */
+    period?: number;
+    /** 信号线周期 */
+    signalPeriod?: number;
+}
+interface ROCResult {
+    /** ROC 值（百分比） */
+    roc: number | null;
+    /** 信号线 */
+    signal: number | null;
+}
+interface DMIOptions {
+    /** 周期，默认 14 */
+    period?: number;
+    /** ADX 平滑周期 */
+    adxPeriod?: number;
+}
+interface DMIResult {
+    /** +DI 值 */
+    pdi: number | null;
+    /** -DI 值 */
+    mdi: number | null;
+    /** ADX 值 */
+    adx: number | null;
+    /** ADXR 值 */
+    adxr: number | null;
+}
+interface SAROptions {
+    /** 加速因子初始值，默认 0.02 */
+    afStart?: number;
+    /** 加速因子增量，默认 0.02 */
+    afIncrement?: number;
+    /** 加速因子最大值，默认 0.2 */
+    afMax?: number;
+}
+interface SARResult {
+    /** SAR 值 */
+    sar: number | null;
+    /** 趋势方向：1 上升，-1 下降 */
+    trend: 1 | -1 | null;
+    /** 极值点 */
+    ep: number | null;
+    /** 加速因子 */
+    af: number | null;
+}
+interface KCOptions {
+    /** EMA 周期，默认 20 */
+    emaPeriod?: number;
+    /** ATR 周期，默认 10 */
+    atrPeriod?: number;
+    /** ATR 倍数，默认 2 */
+    multiplier?: number;
+}
+interface KCResult {
+    /** 中轨（EMA） */
+    mid: number | null;
+    /** 上轨 */
+    upper: number | null;
+    /** 下轨 */
+    lower: number | null;
+    /** 通道宽度 */
+    width: number | null;
+}
+
 /**
  * 时间元信息工具
  *
@@ -8,7 +200,8 @@
  * - 不引入第三方时区库 (SDK 零依赖),通过 `Intl.DateTimeFormat` 计算时区偏移。
  * - 兼容多种本地时间字符串格式 (yyyyMMddHHmmss / YYYY-MM-DD HH:mm:ss / YYYY-MM-DD HH:mm /
  *   YYYY-MM-DD / yyyyMMdd / HH:mm 配 baseDate)。
- * - 解析失败/输入为空时 `timestamp` 为 `NaN`,调用方可用 `Number.isNaN` 检测。
+ * - parseMarketTime 解析失败返回 `NaN`(内部中间值);对外 `TimeMeta.timestamp`
+ *   一律经 toNullableEpoch 归一为 `null`,消费方判 `=== null` 即可。
  */
 /**
  * 已支持的市场时区。沿用 IANA 时区名。
@@ -46,6 +239,12 @@ interface TimeMeta {
  * @param tz    市场时区 (使用 `MARKET_TZ`)
  */
 declare function parseMarketTime(local: string, tz: MarketTz): number;
+/**
+ * 构造 `TimeMeta`。原始字符串无法解析时 `timestamp` 为 `null`。
+ *
+ * @param local 市场本地时间字符串
+ * @param tz    市场时区
+ */
 declare function buildTimeMeta(local: string, tz: MarketTz): TimeMeta;
 /**
  * 将"基础日期 (YYYY-MM-DD) + HH:mm 时间片"组合后构造 `TimeMeta`。
@@ -77,7 +276,7 @@ declare function formatInTz(epoch: number | null, tz: MarketTz): string;
 interface HistoryKline {
     /** 日期 YYYY-MM-DD (A 股时区) */
     date: string;
-    /** 当日 00:00 (`Asia/Shanghai`) 的 UTC 毫秒时间戳;无法解析时为 `NaN` */
+    /** 当日 00:00 (`Asia/Shanghai`) 的 UTC 毫秒时间戳;无法解析时为 `null` */
     timestamp: number | null;
     /** 日期所属市场时区 (`Asia/Shanghai`) */
     tz: MarketTz;
@@ -110,7 +309,7 @@ interface HistoryKline {
 interface MinuteTimeline {
     /** 时间 YYYY-MM-DD HH:mm (A 股时区) */
     time: string;
-    /** UTC 毫秒时间戳 (`Asia/Shanghai` 解释);无法解析时为 `NaN` */
+    /** UTC 毫秒时间戳 (`Asia/Shanghai` 解释);无法解析时为 `null` */
     timestamp: number | null;
     /** 时间所属市场时区 (`Asia/Shanghai`) */
     tz: MarketTz;
@@ -135,7 +334,7 @@ interface MinuteTimeline {
 interface MinuteKline {
     /** 时间 YYYY-MM-DD HH:mm (A 股时区) */
     time: string;
-    /** UTC 毫秒时间戳 (`Asia/Shanghai` 解释);无法解析时为 `NaN` */
+    /** UTC 毫秒时间戳 (`Asia/Shanghai` 解释);无法解析时为 `null` */
     timestamp: number | null;
     /** 时间所属市场时区 (`Asia/Shanghai`) */
     tz: MarketTz;
@@ -168,7 +367,7 @@ interface TodayTimeline {
     time: string;
     /**
      * UTC 毫秒时间戳。由所属 `TodayTimelineResponse.date` 与 `time` 拼接后,
-     * 按 `Asia/Shanghai` 解释得到;无法解析时为 `NaN`。
+     * 按 `Asia/Shanghai` 解释得到;无法解析时为 `null`。
      */
     timestamp: number | null;
     /** 时间所属市场时区 (`Asia/Shanghai`) */
@@ -190,7 +389,7 @@ interface TodayTimelineResponse {
     code: string;
     /** 交易日期 YYYY-MM-DD (A 股时区) */
     date: string;
-    /** 交易日 00:00 (`Asia/Shanghai`) 的 UTC 毫秒时间戳;无法解析时为 `NaN` */
+    /** 交易日 00:00 (`Asia/Shanghai`) 的 UTC 毫秒时间戳;无法解析时为 `null` */
     timestamp: number | null;
     /** 日期所属市场时区 (`Asia/Shanghai`) */
     tz: MarketTz;
@@ -212,7 +411,7 @@ interface TodayTimelineResponse {
 interface ForeignHistoryKlineBase {
     /** 日期 YYYY-MM-DD (市场本地时区) */
     date: string;
-    /** UTC 毫秒时间戳;无法解析时为 `NaN` */
+    /** UTC 毫秒时间戳;无法解析时为 `null` */
     timestamp: number | null;
     /** 股票代码 */
     code: string;
@@ -314,189 +513,6 @@ interface USMinuteTimeline extends Omit<MinuteTimeline, 'tz'> {
     code: string;
 }
 
-interface OHLCV {
-    open: number | null;
-    high: number | null;
-    low: number | null;
-    close: number | null;
-    volume?: number | null;
-}
-interface MAOptions {
-    /** 均线周期数组，默认 [5, 10, 20, 30, 60, 120, 250] */
-    periods?: number[];
-    /** 均线类型：'sma'(简单) | 'ema'(指数) | 'wma'(加权)，默认 'sma' */
-    type?: 'sma' | 'ema' | 'wma';
-}
-interface MACDOptions {
-    /** 短期 EMA 周期，默认 12 */
-    short?: number;
-    /** 长期 EMA 周期，默认 26 */
-    long?: number;
-    /** 信号线 EMA 周期，默认 9 */
-    signal?: number;
-}
-interface BOLLOptions {
-    /** 均线周期，默认 20 */
-    period?: number;
-    /** 标准差倍数，默认 2 */
-    stdDev?: number;
-}
-interface KDJOptions {
-    /** RSV 周期，默认 9 */
-    period?: number;
-    /** K 值平滑周期，默认 3 */
-    kPeriod?: number;
-    /** D 值平滑周期，默认 3 */
-    dPeriod?: number;
-}
-interface RSIOptions {
-    /** RSI 周期数组，默认 [6, 12, 24] */
-    periods?: number[];
-}
-interface WROptions {
-    /** WR 周期数组，默认 [6, 10] */
-    periods?: number[];
-}
-interface BIASOptions {
-    /** BIAS 周期数组，默认 [6, 12, 24] */
-    periods?: number[];
-}
-interface CCIOptions {
-    /** CCI 周期，默认 14 */
-    period?: number;
-}
-interface ATROptions {
-    /** ATR 周期，默认 14 */
-    period?: number;
-}
-interface IndicatorOptions {
-    ma?: MAOptions | boolean;
-    macd?: MACDOptions | boolean;
-    boll?: BOLLOptions | boolean;
-    kdj?: KDJOptions | boolean;
-    rsi?: RSIOptions | boolean;
-    wr?: WROptions | boolean;
-    bias?: BIASOptions | boolean;
-    cci?: CCIOptions | boolean;
-    atr?: ATROptions | boolean;
-    obv?: OBVOptions | boolean;
-    roc?: ROCOptions | boolean;
-    dmi?: DMIOptions | boolean;
-    sar?: SAROptions | boolean;
-    kc?: KCOptions | boolean;
-}
-interface MAResult {
-    [key: string]: number | null;
-}
-interface MACDResult {
-    dif: number | null;
-    dea: number | null;
-    macd: number | null;
-}
-interface BOLLResult {
-    mid: number | null;
-    upper: number | null;
-    lower: number | null;
-    bandwidth: number | null;
-}
-interface KDJResult {
-    k: number | null;
-    d: number | null;
-    j: number | null;
-}
-interface RSIResult {
-    [key: string]: number | null;
-}
-interface WRResult {
-    [key: string]: number | null;
-}
-interface BIASResult {
-    [key: string]: number | null;
-}
-interface CCIResult {
-    cci: number | null;
-}
-interface ATRResult {
-    /** 真实波幅 */
-    tr: number | null;
-    /** 平均真实波幅 */
-    atr: number | null;
-}
-interface OBVOptions {
-    /** OBV 均线周期 */
-    maPeriod?: number;
-}
-interface OBVResult {
-    /** OBV 值 */
-    obv: number | null;
-    /** OBV 均线 */
-    obvMa: number | null;
-}
-interface ROCOptions {
-    /** ROC 周期，默认 12 */
-    period?: number;
-    /** 信号线周期 */
-    signalPeriod?: number;
-}
-interface ROCResult {
-    /** ROC 值（百分比） */
-    roc: number | null;
-    /** 信号线 */
-    signal: number | null;
-}
-interface DMIOptions {
-    /** 周期，默认 14 */
-    period?: number;
-    /** ADX 平滑周期 */
-    adxPeriod?: number;
-}
-interface DMIResult {
-    /** +DI 值 */
-    pdi: number | null;
-    /** -DI 值 */
-    mdi: number | null;
-    /** ADX 值 */
-    adx: number | null;
-    /** ADXR 值 */
-    adxr: number | null;
-}
-interface SAROptions {
-    /** 加速因子初始值，默认 0.02 */
-    afStart?: number;
-    /** 加速因子增量，默认 0.02 */
-    afIncrement?: number;
-    /** 加速因子最大值，默认 0.2 */
-    afMax?: number;
-}
-interface SARResult {
-    /** SAR 值 */
-    sar: number | null;
-    /** 趋势方向：1 上升，-1 下降 */
-    trend: 1 | -1 | null;
-    /** 极值点 */
-    ep: number | null;
-    /** 加速因子 */
-    af: number | null;
-}
-interface KCOptions {
-    /** EMA 周期，默认 20 */
-    emaPeriod?: number;
-    /** ATR 周期，默认 10 */
-    atrPeriod?: number;
-    /** ATR 倍数，默认 2 */
-    multiplier?: number;
-}
-interface KCResult {
-    /** 中轨（EMA） */
-    mid: number | null;
-    /** 上轨 */
-    upper: number | null;
-    /** 下轨 */
-    lower: number | null;
-    /** 通道宽度 */
-    width: number | null;
-}
-
 /**
  * 带技术指标的 K 线数据
  */
@@ -521,4 +537,4 @@ type KlineWithIndicators<T extends AnyHistoryKline> = T & {
  */
 declare function addIndicators<T extends AnyHistoryKline>(klines: T[], options?: IndicatorOptions): KlineWithIndicators<T>[];
 
-export { type AnyHistoryKline as A, type BOLLOptions as B, type CCIOptions as C, type DMIOptions as D, type USMinuteTimeline as E, type MAResult as F, type MACDResult as G, type HistoryKline as H, type IndicatorOptions as I, type BOLLResult as J, type KlineWithIndicators as K, type OHLCV as L, type MAOptions as M, type KDJResult as N, type OBVOptions as O, type RSIResult as P, type WRResult as Q, type RSIOptions as R, type SAROptions as S, type TimeMeta as T, type USHistoryKline as U, type BIASResult as V, type WROptions as W, type CCIResult as X, type ATRResult as Y, addIndicators as a, type MACDOptions as b, type KDJOptions as c, type BIASOptions as d, type ATROptions as e, type OBVResult as f, type ROCOptions as g, type ROCResult as h, type DMIResult as i, type SARResult as j, type KCOptions as k, type KCResult as l, MARKET_TZ as m, type MarketTz as n, buildTimeMeta as o, parseMarketTime as p, buildTimeMetaFromDateAndTime as q, formatInTz as r, type MinuteTimeline as s, type MinuteKline as t, type TodayTimeline as u, type TodayTimelineResponse as v, type HKHistoryKline as w, type HKMinuteKline as x, type HKMinuteTimeline as y, type USMinuteKline as z };
+export { type AnyHistoryKline as A, type BOLLOptions as B, type CCIOptions as C, type DMIOptions as D, type USMinuteTimeline as E, type MAResult as F, type MACDResult as G, type HistoryKline as H, type IndicatorOptions as I, type BOLLResult as J, type KlineWithIndicators as K, type OHLCV as L, type MAOptions as M, type KDJResult as N, type OBVOptions as O, type RSIResult as P, type WRResult as Q, type RSIOptions as R, type SAROptions as S, type TimeMeta as T, type USHistoryKline as U, type BIASResult as V, type WROptions as W, type CCIResult as X, type ATRResult as Y, type PeriodsShorthand as Z, addIndicators as a, type MACDOptions as b, type KDJOptions as c, type BIASOptions as d, type ATROptions as e, type OBVResult as f, type ROCOptions as g, type ROCResult as h, type DMIResult as i, type SARResult as j, type KCOptions as k, type KCResult as l, MARKET_TZ as m, type MarketTz as n, buildTimeMeta as o, parseMarketTime as p, buildTimeMetaFromDateAndTime as q, formatInTz as r, type MinuteTimeline as s, type MinuteKline as t, type TodayTimeline as u, type TodayTimelineResponse as v, type HKHistoryKline as w, type HKMinuteKline as x, type HKMinuteTimeline as y, type USMinuteKline as z };