stock-sdk 2.0.0-beta.0 → 2.0.0

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

@@ -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 };

package/dist/cache.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkBGZ4ZUAFcjs = require('./chunk-BGZ4ZUAF.cjs');var _chunkDOOAXFSScjs = require('./chunk-DOOAXFSS.cjs');require('./chunk-4VDLQK6F.cjs');exports.MemoryCache = _chunkDOOAXFSScjs.a; exports.MemoryCacheStore = _chunkBGZ4ZUAFcjs.a; exports.cacheThrough = _chunkBGZ4ZUAFcjs.b; exports.clearSharedCaches = _chunkDOOAXFSScjs.c; exports.createCacheKey = _chunkDOOAXFSScjs.d; exports.getSharedCache = _chunkDOOAXFSScjs.b;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkWCBK5KYAcjs = require('./chunk-WCBK5KYA.cjs');var _chunkTVIEKKDQcjs = require('./chunk-TVIEKKDQ.cjs');require('./chunk-4VDLQK6F.cjs');exports.MemoryCache = _chunkTVIEKKDQcjs.a; exports.MemoryCacheStore = _chunkWCBK5KYAcjs.a; exports.cacheThrough = _chunkWCBK5KYAcjs.b; exports.clearSharedCaches = _chunkTVIEKKDQcjs.c; exports.createCacheKey = _chunkTVIEKKDQcjs.d; exports.getSharedCache = _chunkTVIEKKDQcjs.b;

package/dist/cache.js

@@ -1 +1 @@
-import{a as e,b as f}from"./chunk-SPLQXFFF.js";import{a,b,c,d}from"./chunk-JYHHLB34.js";import"./chunk-WOT6VMZA.js";export{a as MemoryCache,e as MemoryCacheStore,f as cacheThrough,c as clearSharedCaches,d as createCacheKey,b as getSharedCache};
+import{a as e,b as f}from"./chunk-F3KZXCVO.js";import{a,b,c,d}from"./chunk-DU7MCVLJ.js";import"./chunk-WOT6VMZA.js";export{a as MemoryCache,e as MemoryCacheStore,f as cacheThrough,c as clearSharedCaches,d as createCacheKey,b as getSharedCache};