@363045841yyt/klinechart 0.7.1 → 0.7.3-alpha.0

package/dist/src/semantic/controller.d.ts

@@ -1,35 +0,0 @@
-import { Chart } from '../core/chart';
-import { SemanticChartConfig, ApplyResult } from './types';
-/** 状态事件类型 */
-export type SemanticEventType = 'config:loading' | 'config:ready' | 'config:error';
-export declare class SemanticChartController {
-    private chart;
-    private validator;
-    private events;
-    constructor(chart: Chart);
-    /**
-     * 应用语义化配置
-     */
-    applyConfig(config: SemanticChartConfig): Promise<ApplyResult>;
-    /**
-     * 订阅状态事件
-     */
-    on(event: SemanticEventType, handler: (data?: unknown) => void): void;
-    /**
-     * 取消订阅
-     */
-    off(event: SemanticEventType, handler: (data?: unknown) => void): void;
-    /**
-     * 应用语义化 UI 配置
-     * @param config 语义化配置
-     */
-    private doApplyConfig;
-    private applyIndicators;
-    private applyMAIndicator;
-    private applyBOLLIndicator;
-    private applyEXPMAIndicator;
-    private applyENEIndicator;
-    private applySubIndicator;
-    private applyMarkers;
-    private applyChartOptions;
-}

package/dist/src/semantic/drawShape.d.ts

@@ -1,14 +0,0 @@
-import { MarkerShapeType, MarkerStyle, MarkerLabel } from './types';
-/**
- * 绘制标记形状
- */
-export declare function drawShape(ctx: CanvasRenderingContext2D, shape: MarkerShapeType, x: number, y: number, size: number, style: MarkerStyle): void;
-/**
- * 绘制文本标注
- * @param isAboveMarker 标记是否在K线上方（true → 文字在标记上方，false → 文字在标记下方）
- */
-export declare function drawLabel(ctx: CanvasRenderingContext2D, label: MarkerLabel, x: number, y: number, markerSize: number, style: MarkerStyle, isAboveMarker?: boolean): void;
-/**
- * 点击测试（判断点是否在形状内）
- */
-export declare function hitTestShape(mx: number, my: number, shape: MarkerShapeType, x: number, y: number, size: number): boolean;

package/dist/src/semantic/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * 语义化图表配置模块
- * 用于 Agent 通过 JSON 控制图表渲染
- */
-export type { SemanticChartConfig, DataConfig, IndicatorsConfig, MainIndicatorConfig, SubIndicatorConfig, SubIndicatorType, MAParams, BOLLParams, MarkersConfig, CustomMarker, MarkerShapeType, MarkerStyle, MarkerLabel, LegendConfig, ChartOptions, ThemeConfig, ApplyResult, ValidationResult, SecurityResult, } from './types';
-export { SemanticChartController, type SemanticEventType } from './controller';
-export { SemanticConfigValidator, sanitizeParams, sanitizeColor, validateColor, validateSymbol, } from './validator';
-export { drawShape, drawLabel, hitTestShape } from './drawShape';

package/dist/src/semantic/types.d.ts

@@ -1,298 +0,0 @@
-/**
- * 语义化图表配置类型定义
- * 用于 Agent JSON 控制图表渲染
- */
-/** 语义化图表配置 */
-export interface SemanticChartConfig {
-    /** 版本号，使用 semver 格式 */
-    version: `${number}.${number}.${number}`;
-    data: DataConfig;
-    indicators?: IndicatorsConfig;
-    markers?: MarkersConfig;
-    chart?: ChartOptions;
-    theme?: ThemeConfig;
-}
-/** 数据配置 */
-export interface DataConfig {
-    source: 'baostock' | 'dongcai';
-    /** 股票代码（6位数字，不含前缀） */
-    symbol: string;
-    /** 交易所（可选，默认根据代码自动识别） */
-    exchange?: 'SH' | 'SZ' | 'BJ';
-    /** 开始日期 YYYY-MM-DD */
-    startDate: string;
-    /** 结束日期 YYYY-MM-DD */
-    endDate: string;
-    period: 'daily' | 'weekly' | 'monthly' | '5min' | '15min' | '30min' | '60min';
-    adjust: 'qfq' | 'hfq' | 'none';
-}
-/** 指标配置 */
-export interface IndicatorsConfig {
-    main?: MainIndicatorConfig[];
-    sub?: SubIndicatorConfig[];
-}
-/** MA 均线参数 */
-export interface MAParams {
-    periods: number[];
-}
-/** BOLL 布林带参数 */
-export interface BOLLParams {
-    period?: number;
-    multiplier?: number;
-}
-/** EXPMA 指数平滑移动平均线参数 */
-export interface EXPMAParams {
-    fastPeriod?: number;
-    slowPeriod?: number;
-}
-/** ENE 轨道线参数 */
-export interface ENEParams {
-    period?: number;
-    deviation?: number;
-}
-/** 主图指标配置（判别联合） */
-export type MainIndicatorConfig = {
-    type: 'MA';
-    enabled: boolean;
-    params?: MAParams;
-} | {
-    type: 'BOLL';
-    enabled: boolean;
-    params?: BOLLParams;
-} | {
-    type: 'EXPMA';
-    enabled: boolean;
-    params?: EXPMAParams;
-} | {
-    type: 'ENE';
-    enabled: boolean;
-    params?: ENEParams;
-};
-/** 副图指标参数映射 */
-export interface SubIndicatorParams {
-    VOLUME?: never;
-    MACD?: {
-        fast?: number;
-        slow?: number;
-        signal?: number;
-    };
-    RSI?: {
-        period1?: number;
-        period2?: number;
-        period3?: number;
-    };
-    CCI?: {
-        period?: number;
-    };
-    STOCH?: {
-        n?: number;
-        m?: number;
-    };
-    MOM?: {
-        period?: number;
-    };
-    WMSR?: {
-        period?: number;
-    };
-    KST?: {
-        roc1?: number;
-        roc2?: number;
-        roc3?: number;
-        roc4?: number;
-        signal?: number;
-    };
-    FASTK?: {
-        period?: number;
-    };
-    ATR?: {
-        period?: number;
-    };
-    WMA?: {
-        period?: number;
-    };
-    DEMA?: {
-        period?: number;
-    };
-    TEMA?: {
-        period?: number;
-    };
-    HMA?: {
-        period?: number;
-    };
-    KAMA?: {
-        period?: number;
-        fastPeriod?: number;
-        slowPeriod?: number;
-    };
-    SAR?: {
-        step?: number;
-        maxStep?: number;
-    };
-    SUPERTREND?: {
-        atrPeriod?: number;
-        multiplier?: number;
-    };
-    KELTNER?: {
-        emaPeriod?: number;
-        atrPeriod?: number;
-        multiplier?: number;
-    };
-    DONCHIAN?: {
-        period?: number;
-    };
-    ICHIMOKU?: {
-        tenkanPeriod?: number;
-        kijunPeriod?: number;
-        spanBPeriod?: number;
-        displacement?: number;
-    };
-    ROC?: {
-        period?: number;
-    };
-    TRIX?: {
-        period?: number;
-        signalPeriod?: number;
-    };
-    HV?: {
-        period?: number;
-        annualizationFactor?: number;
-    };
-    PARKINSON?: {
-        period?: number;
-        annualizationFactor?: number;
-    };
-    CHAIKIN_VOL?: {
-        emaPeriod?: number;
-        rocPeriod?: number;
-    };
-    VMA?: {
-        period?: number;
-    };
-    OBV?: Record<string, never>;
-    PVT?: Record<string, never>;
-    VWAP?: {
-        sessionResetGapMs?: number;
-    };
-    CMF?: {
-        period?: number;
-    };
-    MFI?: {
-        period?: number;
-    };
-    PIVOT?: Record<string, never>;
-    FIB?: {
-        period?: number;
-    };
-    STRUCTURE?: {
-        leftWindow?: number;
-        rightWindow?: number;
-        breakoutSource?: 'close' | 'wick';
-    };
-    ZONES?: {
-        showFVG?: boolean;
-        showOB?: boolean;
-        showFilledZones?: boolean;
-        obLookback?: number;
-    };
-    VOLUME_PROFILE?: {
-        bins?: number;
-        lookback?: number;
-        valueAreaPercent?: number;
-    };
-}
-/** 副图指标类型 */
-export type SubIndicatorType = keyof SubIndicatorParams;
-/** 副图指标配置 */
-export type SubIndicatorConfig = {
-    [K in SubIndicatorType]: {
-        type: K;
-        enabled: boolean;
-        params?: SubIndicatorParams[K];
-    };
-}[SubIndicatorType];
-/** 标记配置 */
-export interface MarkersConfig {
-    showVolumePriceMarkers?: boolean;
-    showExtremaMarkers?: boolean;
-    customMarkers?: CustomMarker[];
-    legend?: LegendConfig;
-}
-/** 预设图形形状 */
-export type MarkerShapeType = 'arrow_up' | 'arrow_down' | 'flag' | 'circle' | 'rectangle' | 'diamond';
-/** 自定义标记 */
-export interface CustomMarker {
-    id: string;
-    /**
-     * 日期时间字符串
-     * - 日K/周K/月K: "YYYY-MM-DD" (如 "2025-01-15")
-     * - 分钟K: "YYYY-MM-DD HH:mm" (如 "2025-01-15 09:30")
-     */
-    date: string;
-    shape: MarkerShapeType;
-    /** 图例分组键（可选，用于区分同形状不同含义的标记） */
-    groupKey?: string;
-    /** 标记位置偏移（相对K线中心） */
-    offset?: {
-        x?: number;
-        y?: number;
-    };
-    /** 样式配置 */
-    style?: MarkerStyle;
-    /** 文本标注 */
-    label?: MarkerLabel;
-    /** 元数据（点击弹窗展示，渲染时必须转义防XSS） */
-    metadata?: Record<string, unknown>;
-}
-/** 标记样式 */
-export interface MarkerStyle {
-    fillColor?: string;
-    strokeColor?: string;
-    textColor?: string;
-    size?: number;
-    lineWidth?: number;
-    opacity?: number;
-}
-/** 文本标注 */
-export interface MarkerLabel {
-    text: string;
-    position?: 'left' | 'right' | 'top' | 'bottom' | 'inside';
-    align?: 'start' | 'center' | 'end';
-    fontSize?: number;
-    offset?: {
-        x?: number;
-        y?: number;
-    };
-}
-/** 图例配置 */
-export interface LegendConfig {
-    enabled?: boolean;
-    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
-    /** 点击图例项的行为 */
-    onClick?: 'highlight' | 'toggle' | 'none';
-}
-/** 图表选项 */
-export interface ChartOptions {
-    kWidth?: number;
-    kGap?: number;
-    autoScrollToRight?: boolean;
-}
-/** 主题配置 */
-export interface ThemeConfig {
-    priceUpColor?: string;
-    priceDownColor?: string;
-}
-/** 应用结果 */
-export interface ApplyResult {
-    success: boolean;
-    errors?: string[];
-}
-/** 校验结果 */
-export interface ValidationResult {
-    valid: boolean;
-    errors?: string[];
-}
-/** 安全校验结果 */
-export interface SecurityResult {
-    passed: boolean;
-    violations?: string[];
-}

package/dist/src/semantic/validator.d.ts

@@ -1,43 +0,0 @@
-import { SemanticChartConfig, ValidationResult, SecurityResult } from './types';
-export declare class SemanticConfigValidator {
-    private limits;
-    private _ajv;
-    constructor();
-    private getAjv;
-    /**
-     * 入口校验（在 JSON.parse 之前调用）
-     * 检查原始字符串大小
-     */
-    validateRawInput(raw: string): ValidationResult;
-    /**
-     * JSON Schema 校验
-     */
-    validate(config: unknown): Promise<ValidationResult>;
-    /**
-     * 安全校验（纯同步）
-     */
-    securityCheck(config: SemanticChartConfig): SecurityResult;
-    private checkPrototypePollution;
-    private checkDateRange;
-    private checkSymbol;
-    private checkMarkerStyle;
-    /** 日期格式正则：YYYY-MM-DD 或 YYYY-MM-DD HH:mm */
-    private static readonly DATE_PATTERN;
-    private checkMarkerDate;
-}
-/**
- * 净化参数对象（防止原型污染）
- */
-export declare function sanitizeParams(params: Record<string, unknown>): Record<string, unknown>;
-/**
- * 净化颜色值（浏览器环境）
- */
-export declare function sanitizeColor(input: string): string | null;
-/**
- * 校验颜色值格式
- */
-export declare function validateColor(color: string): boolean;
-/**
- * 校验股票代码
- */
-export declare function validateSymbol(symbol: string, exchange?: 'SH' | 'SZ' | 'BJ'): boolean;

package/dist/src/test-setup.d.ts

@@ -1,6 +0,0 @@
-/**
- * Vitest 测试环境 polyfill
- * - jsdom 不实现 Path2D
- * - jsdom 不实现 WebGL —— 给 getContext('webgl'/'webgl2') 一个最小桩，让 Chart 构造不会崩
- */
-export {};

package/dist/src/types/kLine.d.ts

@@ -1,3 +0,0 @@
-import { KLineData } from './price';
-export type kLineTrend = 'up' | 'down' | 'flat';
-export declare function getKLineTrend(KLineData: KLineData): kLineTrend;

package/dist/src/types/price.d.ts

@@ -1,31 +0,0 @@
-export interface KLineData {
-    timestamp: number;
-    open: number;
-    high: number;
-    low: number;
-    close: number;
-    /** 股票代码（东财等数据源会提供） */
-    stockCode?: string;
-    /** 成交量 */
-    volume?: number;
-    /** 成交额 */
-    turnover?: number;
-    /** 振幅 */
-    amplitude?: number;
-    /** 涨跌幅 */
-    changePercent?: number;
-    /** 涨跌额 */
-    changeAmount?: number;
-    /** 换手率 */
-    turnoverRate?: number;
-}
-export interface KLineDailyDongCaiResponse extends KLineData {
-    stockCode: string;
-    volume: number;
-    turnover: number;
-    amplitude: number;
-    changePercent: number;
-    changeAmount: number;
-    turnoverRate: number;
-}
-export declare function toKLineData(arr: KLineDailyDongCaiResponse[]): KLineData[];

package/dist/src/types/volumePrice.d.ts

@@ -1,26 +0,0 @@
-/**
- * 量价关系类型枚举
- */
-export declare enum VolumePriceRelation {
-    /** 量价齐升（放量上涨）- 价格上涨且成交量显著放大 */
-    RISE_WITH_VOLUME = "rise_with_volume",
-    /** 量价背离（缩量上涨）- 价格上涨但成交量萎缩 */
-    RISE_WITHOUT_VOLUME = "rise_without_volume",
-    /** 量增价跌 - 价格下跌且成交量放大 */
-    FALL_WITH_VOLUME = "fall_with_volume",
-    /** 量缩价跌 - 价格下跌且成交量萎缩 */
-    FALL_WITHOUT_VOLUME = "fall_without_volume",
-    /** 中性状态 - 其他情况 */
-    OTHERS = "others"
-}
-/** 量价关系计算配置 */
-export interface VolumePriceConfig {
-    /** 成交量放大阈值（相对于均值的倍数） */
-    volumeAmplifyThreshold: number;
-    /** 成交量萎缩阈值（相对于均值的倍数） */
-    volumeShrinkThreshold: number;
-    /** 计算均值的周期 */
-    avgPeriod: number;
-}
-/** 默认量价关系计算配置 */
-export declare const DEFAULT_VOLUME_PRICE_CONFIG: VolumePriceConfig;

package/dist/src/utils/cache.d.ts

@@ -1,33 +0,0 @@
-declare class LocalCache {
-    /**
-     * 设置缓存
-     * @param key 缓存键
-     * @param data 缓存数据
-     */
-    set<T>(key: string, data: T): void;
-    /**
-     * 获取缓存
-     * @param key 缓存键
-     * @param maxAge 最大缓存时间（毫秒），默认 1 小时
-     * @returns 缓存数据或 null
-     */
-    get<T>(key: string, maxAge?: number): T | null;
-    /**
-     * 删除指定缓存
-     * @param key 缓存键
-     */
-    remove(key: string): void;
-    /**
-     * 清空所有缓存
-     */
-    clear(): void;
-    /**
-     * 生成缓存键
-     * @param prefix 前缀
-     * @param params 参数对象
-     * @returns 缓存键字符串
-     */
-    generateKey(prefix: string, params: Record<string, unknown>): string;
-}
-export declare const cache: LocalCache;
-export {};

package/dist/src/utils/dateFormat.d.ts

@@ -1,83 +0,0 @@
-/**
- * 日期格式化工具函数集合
- * 统一管理项目中所有日期相关的格式化逻辑
- */
-/**
- * 将时间戳格式化为 YYYYMMDD 格式（纯数字，无分隔符）
- * @param timestamp - 时间戳（毫秒）
- * @returns 格式化后的日期字符串，例如 "20250114"
- *
- * @example
- * formatDateToYYYYMMDDNoDash(1736793600000) // "20250114"
- */
-export declare function formatDateToYYYYMMDDNoDash(timestamp: number): string;
-/**
- * 获取当前日期的 YYYYMMDD 格式（纯数字，无分隔符）
- * @returns 当前日期的格式化字符串，例如 "20250114"
- *
- * @example
- * getCurrentDateYYYYMMDD() // "20250114"（根据实际日期）
- */
-export declare function getCurrentDateYYYYMMDD(): string;
-/**
- * 将时间戳格式化为 YYYY-MM-DD 格式（上海时区）
- * @param timestamp - 时间戳（毫秒）
- * @returns 格式化后的日期字符串，例如 "2025-01-14"
- *
- * @example
- * formatDateToYYYYMMDD(1736793600000) // "2025-01-14"
- */
-export declare function formatDateToYYYYMMDD(timestamp: number): string;
-/**
- * 格式化月份或年份用于显示
- * 当年为 1 月时显示年份，其他月份显示"X月"格式
- * @param timestamp - 时间戳（毫秒）
- * @returns 包含文本和是否为年份的标志
- *
- * @example
- * formatMonthOrYear(1704067200000) // { text: "2024", isYear: true }  (2024年1月)
- * formatMonthOrYear(1706745600000) // { text: "2月", isYear: false } (2024年2月)
- */
-export declare function formatMonthOrYear(timestamp: number): {
-    text: string;
-    isYear: boolean;
-};
-/**
- * 生成月份键值用于比较（YYYY-M 格式）
- * 注意：月份未补零，用于快速比较月份是否相同
- * @param timestamp - 时间戳（毫秒）
- * @returns 月份键值，例如 "2025-1"
- *
- * @example
- * monthKey(1736793600000) // "2025-1"
- */
-/**
- * 生成月份键值用于比较
- * 返回数字 year * 12 + month，比字符串比较更快且无分配
- * 使用 new Date 保证本地时区正确（与显示一致）
- *
- * @example
- * monthKey(1736793600000) // 24301 (2025*12 + 0)
- */
-export declare function monthKey(timestamp: number): number;
-/**
- * formatDateToYYYYMMDD 的别名，保持与历史代码的兼容性
- * timestamp 是"上海时区当天 00:00:00"映射到 UTC 的值；显示时强制按上海时区格式化
- * @param ts - 时间戳（毫秒）
- * @returns 格式化后的日期字符串，例如 "2025-01-14"
- */
-export declare const formatShanghaiDate: typeof formatDateToYYYYMMDD;
-/**
- * formatDateToYYYYMMDD 的别名，用于十字线日期标签显示
- * 按上海时区格式化，避免不同时区出现日期偏移
- * @param ts - 时间戳（毫秒）
- * @returns 格式化后的日期字符串，例如 "2025-01-14"
- */
-export declare const formatYMDShanghai: typeof formatDateToYYYYMMDD;
-/**
- * 查找每个月份第一个K线的索引
- * 结果按数据引用缓存，同一份数据多次调用直接返回缓存
- */
-export declare function findMonthBoundaries(data: Array<{
-    timestamp: number;
-} | undefined>): number[];

package/dist/src/utils/http.d.ts

@@ -1,14 +0,0 @@
-interface HttpParams {
-    params?: Record<string, string | number | undefined>;
-    timeout?: number;
-}
-interface HttpResponse<T> {
-    data: T;
-}
-export declare class HttpError extends Error {
-    constructor(message: string);
-    static isHttpError(error: unknown): error is HttpError;
-}
-declare function get<T>(url: string, config?: HttpParams): Promise<HttpResponse<T>>;
-export { get };
-export type { HttpParams, HttpResponse };

package/dist/src/utils/kLineDraw/MA.d.ts

@@ -1,7 +0,0 @@
-import { KLineData } from '../../types/price';
-import { drawOption, PriceRange } from './kLine';
-export declare function drawMA5Line(ctx: CanvasRenderingContext2D, data: KLineData[], option: drawOption, logicHeight: number, dpr?: number, startIndex?: number, endIndex?: number, priceRange?: PriceRange, kLinePositions?: number[], theme?: 'light' | 'dark'): void;
-export declare function drawMA10Line(ctx: CanvasRenderingContext2D, data: KLineData[], option: drawOption, logicHeight: number, dpr?: number, startIndex?: number, endIndex?: number, priceRange?: PriceRange, kLinePositions?: number[], theme?: 'light' | 'dark'): void;
-export declare function drawMA20Line(ctx: CanvasRenderingContext2D, data: KLineData[], option: drawOption, logicHeight: number, dpr?: number, startIndex?: number, endIndex?: number, priceRange?: PriceRange, kLinePositions?: number[], theme?: 'light' | 'dark'): void;
-export declare function drawMA30Line(ctx: CanvasRenderingContext2D, data: KLineData[], option: drawOption, logicHeight: number, dpr?: number, startIndex?: number, endIndex?: number, priceRange?: PriceRange, kLinePositions?: number[], theme?: 'light' | 'dark'): void;
-export declare function drawMA60Line(ctx: CanvasRenderingContext2D, data: KLineData[], option: drawOption, logicHeight: number, dpr?: number, startIndex?: number, endIndex?: number, priceRange?: PriceRange, kLinePositions?: number[], theme?: 'light' | 'dark'): void;