@363045841yyt/klinechart-core 0.8.14 → 0.9.0-alpha.0

package/src/semantic/controller.ts

@@ -1,235 +0,0 @@
-import type { KLineData, DataFetcher, SymbolSpec } from '../controllers/types'
-import { getRegisteredIndicatorDefinition } from '../engine/indicators/indicatorDefinitionRegistry'
-import type { IndicatorMetadata } from '../engine/indicators/indicatorMetadata'
-import { getBuiltinIndicatorDefinitions } from '../engine/indicators/registerBuiltins'
-import type { CustomMarkerEntity } from '../engine/marker/registry'
-import type { SubIndicatorType as CoreSubIndicatorType } from '../engine/renderers/Indicator'
-import { EventBus } from '../plugin/EventBus'
-
-import type {
-  SemanticChartConfig,
-  ApplyResult,
-  MainIndicatorConfig,
-  SubIndicatorConfig,
-  CustomMarker,
-  DataConfig,
-} from './types'
-import { SemanticConfigValidator } from './validator'
-
-
-
-
-export type SemanticEventType = 'config:loading' | 'config:ready' | 'config:error'
-export type { DataFetcher, SymbolSpec } from '../controllers/types'
-
-function normalizeIndicatorId(id: string): string {
-  return id
-    .trim()
-    .toLowerCase()
-    .replace(/[^a-z0-9]/g, '')
-}
-
-function getSemanticIndicatorDefinition(type: string): IndicatorMetadata | undefined {
-  const registered = getRegisteredIndicatorDefinition(type)
-  if (registered) return registered
-
-  const normalizedType = normalizeIndicatorId(type)
-  return getBuiltinIndicatorDefinitions().find((definition) => {
-    const candidates = [definition.name, definition.displayName, ...(definition.aliases ?? [])]
-    return candidates.some((candidate) => normalizeIndicatorId(candidate) === normalizedType)
-  })
-}
-
-export interface SemanticChartAdapter {
-  setSymbols(specs: ReadonlyArray<SymbolSpec>): void
-  updateData(data: ReadonlyArray<KLineData>): void
-  updateRendererConfig(name: string, config: Record<string, unknown>): void
-  addIndicator?(
-    definitionId: string,
-    role: 'main' | 'sub',
-    params?: Record<string, unknown>,
-  ): string | null
-  removeIndicator?(instanceId: string): boolean
-  enableMainIndicator?(
-    indicatorId: string,
-    params?: Record<string, number | boolean | string>,
-  ): boolean
-  disableMainIndicator?(indicatorId: string): boolean
-  clearSubPanes(): void
-  createSubPane(
-    paneId: string,
-    indicatorId: CoreSubIndicatorType,
-    params?: Record<string, unknown>,
-  ): boolean
-  clearCustomMarkers(): void
-  updateCustomMarkers(markers: ReadonlyArray<CustomMarkerEntity>): void
-}
-
-export class SemanticChartController {
-  private chart: SemanticChartAdapter
-  private validator: SemanticConfigValidator
-  private events: EventBus
-
-  constructor(chart: SemanticChartAdapter) {
-    this.chart = chart
-    this.validator = new SemanticConfigValidator()
-    this.events = new EventBus()
-  }
-
-  async applyConfig(config: SemanticChartConfig): Promise<ApplyResult> {
-    const validation = await this.validator.validate(config)
-    if (!validation.valid) {
-      return { success: false, errors: validation.errors }
-    }
-
-    const security = this.validator.securityCheck(config)
-    if (!security.passed) {
-      return { success: false, errors: security.violations }
-    }
-
-    this.events.emit('config:loading', undefined)
-    try {
-      await this.doApplyConfig(config)
-      this.events.emit('config:ready', undefined)
-      return { success: true }
-    } catch (error) {
-      this.events.emit('config:error', error)
-      return {
-        success: false,
-        errors: [error instanceof Error ? error.message : String(error)],
-      }
-    }
-  }
-
-  on(event: SemanticEventType, handler: (data?: unknown) => void): void {
-    this.events.on(event, handler)
-  }
-
-  off(event: SemanticEventType, handler: (data?: unknown) => void): void {
-    this.events.off(event, handler)
-  }
-
-  private async doApplyConfig(config: SemanticChartConfig): Promise<void> {
-    // 先注册指标（同步），确保 scheduler 首次 applyResults 时指标已在 registry
-    if (config.indicators) {
-      this.applyIndicators(config.indicators.main, config.indicators.sub)
-    }
-
-    this.chart.setSymbols([
-      {
-        symbol: config.data.symbol,
-        exchange: config.data.exchange,
-        period: config.data.period,
-        adjust: config.data.adjust,
-        source: config.data.source,
-        startDate: config.data.startDate,
-        endDate: config.data.endDate,
-      },
-    ])
-
-    if (config.markers) {
-      this.applyMarkers(config.markers.customMarkers, config.data.period)
-    }
-
-    if (config.chart) {
-      this.applyChartOptions(config.chart)
-    }
-  }
-
-  private applyIndicators(main?: MainIndicatorConfig[], sub?: SubIndicatorConfig[]): void {
-    if (main) {
-      for (const indicator of main) {
-        if (!indicator.enabled) {
-          if (!this.chart.removeIndicator?.(indicator.type)) {
-            this.chart.disableMainIndicator?.(indicator.type)
-          }
-          continue
-        }
-        const added = this.chart.addIndicator?.(
-          indicator.type,
-          'main',
-          indicator.params as Record<string, unknown>,
-        )
-        if (added) {
-          continue
-        }
-        const enabled = this.chart.enableMainIndicator?.(
-          indicator.type,
-          indicator.params as Record<string, number | boolean | string>,
-        )
-        if (enabled) {
-          continue
-        }
-        getSemanticIndicatorDefinition(indicator.type)?.semantic?.apply?.(this.chart, indicator)
-      }
-    }
-
-    this.chart.clearSubPanes()
-
-    if (sub) {
-      for (const indicator of sub) {
-        this.applySubIndicator(indicator)
-      }
-    }
-  }
-
-  private applySubIndicator(indicator: SubIndicatorConfig): void {
-    if (!indicator.enabled) return
-    const { type, params } = indicator
-    const paneId = `${type}_0`
-    const indicatorId = type
-    const success = this.chart.createSubPane(paneId, indicatorId as CoreSubIndicatorType, params)
-    if (!success) {
-      console.warn(`[Semantic] Failed to create sub pane for ${type}`)
-    }
-  }
-
-  private applyMarkers(markers?: CustomMarker[], period?: DataConfig['period']): void {
-    if (!markers || markers.length === 0) {
-      this.chart.clearCustomMarkers()
-      return
-    }
-    const entities: CustomMarkerEntity[] = markers.map((marker) => ({
-      id: marker.id,
-      date: marker.date,
-      timestamp: parseDateToTimestamp(marker.date, period || 'daily'),
-      shape: marker.shape,
-      groupKey: marker.groupKey,
-      offset: marker.offset,
-      style: marker.style,
-      label: marker.label,
-      metadata: marker.metadata,
-    }))
-    this.chart.updateCustomMarkers(entities)
-  }
-
-  private applyChartOptions(options: {
-    kWidth?: number
-    kGap?: number
-    autoScrollToRight?: boolean
-  }): void {
-    if (options.autoScrollToRight !== undefined) {
-    }
-  }
-}
-
-function parseDateToTimestamp(dateStr: string, _period: DataConfig['period']): number {
-  const hasTime = dateStr.includes(' ')
-  if (hasTime) {
-    const [datePart, timePart] = dateStr.split(' ')
-    const parts = datePart!.split('-').map(Number)
-    const year = parts[0]!
-    const month = parts[1]!
-    const day = parts[2]!
-    const timeParts = timePart!.split(':').map(Number)
-    const hour = timeParts[0]!
-    const minute = timeParts[1]!
-    return Date.UTC(year, month - 1, day, hour - 8, minute, 0, 0)
-  } else {
-    const parts = dateStr.split('-').map(Number)
-    const year = parts[0]!
-    const month = parts[1]!
-    const day = parts[2]!
-    return Date.UTC(year, month - 1, day, 0 - 8, 0, 0, 0)
-  }
-}

package/src/semantic/index.ts

@@ -1,36 +0,0 @@
-export type {
-  SemanticChartConfig,
-  AdjustType,
-  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 type { SemanticChartAdapter } from './controller'
-export type { DataFetcher, SymbolSpec } from '../controllers/types'
-
-export {
-  SemanticConfigValidator,
-  sanitizeParams,
-  sanitizeColor,
-  validateColor,
-  validateSymbol,
-} from './validator'
-
-export { drawShape, drawLabel, hitTestShape } from './drawShape'

package/src/semantic/types.ts

@@ -1,253 +0,0 @@
-/**
- * 语义化图表配置类型定义
- * 用于 Agent JSON 控制图表渲染
- */
-
-// ============ 根配置 ============
-
-/** 语义化图表配置 */
-export interface SemanticChartConfig {
-  /** 版本号，使用 semver 格式 */
-  version: `${number}.${number}.${number}`
-  data: DataConfig
-  indicators?: IndicatorsConfig
-  markers?: MarkersConfig
-  chart?: ChartOptions
-  theme?: ThemeConfig
-}
-
-// ============ 数据配置 ============
-
-/** 数据配置 */
-export type AdjustType = 'qfq' | 'hfq' | 'splits' | 'none'
-
-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' | 'timeshare'
-  adjust: AdjustType
-}
-
-// ============ 指标配置 ============
-
-/** 指标配置 */
-export interface IndicatorsConfig {
-  main?: MainIndicatorConfig[]
-  sub?: SubIndicatorConfig[]
-}
-
-// ============ 主图指标：判别联合类型 ============
-
-/** MA 均线参数 */
-export interface MAParams {
-  periods: number[] // 1-5个周期，如 [5, 10, 20]
-}
-
-/** BOLL 布林带参数 */
-export interface BOLLParams {
-  period?: number // 默认 20
-  multiplier?: number // 默认 2
-}
-
-/** EXPMA 指数平滑移动平均线参数 */
-export interface EXPMAParams {
-  fastPeriod?: number // 默认 12
-  slowPeriod?: number // 默认 50
-}
-
-/** ENE 轨道线参数 */
-export interface ENEParams {
-  period?: number // 默认 10
-  deviation?: number // 默认 11
-}
-
-/** 主图指标配置（判别联合） */
-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 // 图形大小，默认 12
-  lineWidth?: number // 线条粗细
-  opacity?: number // 透明度 0-1
-}
-
-/** 文本标注 */
-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 // 默认 10
-  kGap?: number // 默认 2
-  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[]
-}