@363045841yyt/klinechart-core 0.7.3 → 0.7.5-alpha.2

package/src/engine/utils/zoom.ts

@@ -1,83 +1,83 @@
-import { getPhysicalKLineConfig } from './klineConfig'
-
-/**
- * 缩放计算纯函数
- * 无副作用、无 DOM 访问，供 Vue 层直接调用
- */
-
-export interface ZoomConfig {
-  minKWidth: number
-  maxKWidth: number
-  zoomLevelCount: number
-  dpr: number
-}
-
-export interface ZoomResult {
-  targetLevel: number
-  newKWidth: number
-  newKGap: number
-  newScrollLeft: number
-}
-
-const PHYS_K_GAP_MAX = 3
-
-/** 将缩放级别转换为 K 线宽度（逻辑像素） */
-export function zoomLevelToKWidth(level: number, config: ZoomConfig): number {
-  const t = (level - 1) / (config.zoomLevelCount - 1)
-  return config.minKWidth + t * (config.maxKWidth - config.minKWidth)
-}
-
-/** 根据K线宽度和DPR推导间隙（逻辑像素），K线越窄间距越小 */
-export function kGapFromKWidth(kWidth: number, dpr: number): number {
-  const kWidthPx = Math.round(kWidth * dpr)
-  const kGapPx = Math.max(1, Math.min(PHYS_K_GAP_MAX, Math.round(kWidthPx * 0.6)))
-  return kGapPx / dpr
-}
-
-/**
- * 缩放一级（+1 放大 / -1 缩小）
- * 返回新状态或 null（已达边界）
- */
-export function computeZoom(
-  delta: number,
-  mouseX: number,
-  scrollLeft: number,
-  currentLevel: number,
-  currentKWidth: number,
-  currentKGap: number,
-  config: ZoomConfig,
-): ZoomResult | null {
-  const targetLevel = Math.max(1, Math.min(config.zoomLevelCount, currentLevel + delta))
-  if (targetLevel === currentLevel) return null
-
-  const newKWidth = zoomLevelToKWidth(targetLevel, config)
-  const newKGap = kGapFromKWidth(newKWidth, config.dpr)
-
-  const oldConfig = getPhysicalKLineConfig(currentKWidth, currentKGap, config.dpr)
-  const newConfig = getPhysicalKLineConfig(newKWidth, newKGap, config.dpr)
-  const anchorWorldPx = Math.round((scrollLeft + mouseX) * config.dpr)
-  const anchorSlotFloat = (anchorWorldPx - oldConfig.startXPx) / oldConfig.unitPx
-  const newAnchorWorldPx = newConfig.startXPx + anchorSlotFloat * newConfig.unitPx
-  const newScrollLeft = newAnchorWorldPx / config.dpr - mouseX
-
-  return { targetLevel, newKWidth, newKGap, newScrollLeft }
-}
-
-/**
- * 缩放到指定级别
- * 返回新状态或 null（级别不变或无效）
- */
-export function computeZoomToLevel(
-  targetLevel: number,
-  anchorX: number,
-  scrollLeft: number,
-  currentLevel: number,
-  currentKWidth: number,
-  currentKGap: number,
-  config: ZoomConfig,
-): ZoomResult | null {
-  const clamped = Math.max(1, Math.min(config.zoomLevelCount, Math.round(targetLevel)))
-  const delta = clamped - currentLevel
-  if (delta === 0) return null
-  return computeZoom(delta, anchorX, scrollLeft, currentLevel, currentKWidth, currentKGap, config)
-}
+import { getPhysicalKLineConfig } from './klineConfig'
+
+/**
+ * 缩放计算纯函数
+ * 无副作用、无 DOM 访问，供 Vue 层直接调用
+ */
+
+export interface ZoomConfig {
+  minKWidth: number
+  maxKWidth: number
+  zoomLevelCount: number
+  dpr: number
+}
+
+export interface ZoomResult {
+  targetLevel: number
+  newKWidth: number
+  newKGap: number
+  newScrollLeft: number
+}
+
+const PHYS_K_GAP_MAX = 3
+
+/** 将缩放级别转换为 K 线宽度（逻辑像素） */
+export function zoomLevelToKWidth(level: number, config: ZoomConfig): number {
+  const t = (level - 1) / (config.zoomLevelCount - 1)
+  return config.minKWidth + t * (config.maxKWidth - config.minKWidth)
+}
+
+/** 根据K线宽度和DPR推导间隙（逻辑像素），K线越窄间距越小 */
+export function kGapFromKWidth(kWidth: number, dpr: number): number {
+  const kWidthPx = Math.round(kWidth * dpr)
+  const kGapPx = Math.max(1, Math.min(PHYS_K_GAP_MAX, Math.round(kWidthPx * 0.6)))
+  return kGapPx / dpr
+}
+
+/**
+ * 缩放一级（+1 放大 / -1 缩小）
+ * 返回新状态或 null（已达边界）
+ */
+export function computeZoom(
+  delta: number,
+  mouseX: number,
+  scrollLeft: number,
+  currentLevel: number,
+  currentKWidth: number,
+  currentKGap: number,
+  config: ZoomConfig,
+): ZoomResult | null {
+  const targetLevel = Math.max(1, Math.min(config.zoomLevelCount, currentLevel + delta))
+  if (targetLevel === currentLevel) return null
+
+  const newKWidth = zoomLevelToKWidth(targetLevel, config)
+  const newKGap = kGapFromKWidth(newKWidth, config.dpr)
+
+  const oldConfig = getPhysicalKLineConfig(currentKWidth, currentKGap, config.dpr)
+  const newConfig = getPhysicalKLineConfig(newKWidth, newKGap, config.dpr)
+  const anchorWorldPx = Math.round((scrollLeft + mouseX) * config.dpr)
+  const anchorSlotFloat = (anchorWorldPx - oldConfig.startXPx) / oldConfig.unitPx
+  const newAnchorWorldPx = newConfig.startXPx + anchorSlotFloat * newConfig.unitPx
+  const newScrollLeft = newAnchorWorldPx / config.dpr - mouseX
+
+  return { targetLevel, newKWidth, newKGap, newScrollLeft }
+}
+
+/**
+ * 缩放到指定级别
+ * 返回新状态或 null（级别不变或无效）
+ */
+export function computeZoomToLevel(
+  targetLevel: number,
+  anchorX: number,
+  scrollLeft: number,
+  currentLevel: number,
+  currentKWidth: number,
+  currentKGap: number,
+  config: ZoomConfig,
+): ZoomResult | null {
+  const clamped = Math.max(1, Math.min(config.zoomLevelCount, Math.round(targetLevel)))
+  const delta = clamped - currentLevel
+  if (delta === 0) return null
+  return computeZoom(delta, anchorX, scrollLeft, currentLevel, currentKWidth, currentKGap, config)
+}

package/src/engine/viewport/viewport.ts

@@ -1,67 +1,67 @@
-import type { KLineData } from '../../types/price'
-import type { PriceRange } from '../scale/price'
-import { getPhysicalKLineConfig } from '../utils/klineConfig'
-
-/**
- * 计算当前视口可见的 K 线索引范围（使用物理像素对齐）。
- *
- * - 所有计算在物理像素空间进行，确保与 calcKLinePositions 一致
- * - 会额外在左右各扩展 1 根（start-1/end+1），用于避免边缘裁剪带来的”断线/缺一根”观感
- *
- * @param scrollLeft 容器当前横向滚动量（逻辑像素）
- * @param viewWidth  绘图区域宽度（plotWidth，逻辑像素，不含右侧 yAxis）
- * @param kWidth     单根 K 线宽度（逻辑像素）
- * @param kGap       K 线间距（逻辑像素）
- * @param totalDataCount 数据总条数
- * @param dpr        设备像素比
- */
-export function getVisibleRange(
-    scrollLeft: number,
-    viewWidth: number,
-    kWidth: number,
-    kGap: number,
-    totalDataCount: number,
-    dpr: number = 1
-): { start: number; end: number } {
-    // 使用统一的物理像素配置，确保与 calcKLinePositions 完全一致
-    const { unitPx, startXPx } = getPhysicalKLineConfig(kWidth, kGap, dpr)
-
-    // scrollLeft 和 viewWidth 转换到物理像素空间
-    const scrollLeftPx = scrollLeft * dpr
-    const viewWidthPx = viewWidth * dpr
-
-    // 计算可见范围（物理像素空间整数运算）
-    const start = Math.max(0, Math.floor((scrollLeftPx - startXPx) / unitPx) - 1)
-    const end = Math.min(totalDataCount, Math.ceil((scrollLeftPx + viewWidthPx - startXPx) / unitPx) + 1)
-
-    return { start, end }
-}
-
-/**
- * 计算指定索引区间内的价格范围（max/min）。
- *
- * 主要用途：
- * - 为 pane 的 y 轴缩放与刻度提供 priceRange
- * - 为渲染器（网格线、极值标注等）提供可视区参考范围
- *
- * 注意：
- * - `endIndex` 为开区间（不包含）
- * - 若区间内无有效数据，会返回兜底范围 `{ maxPrice: 100, minPrice: 0 }`
- */
-export function getVisiblePriceRange(data: KLineData[], startIndex: number, endIndex: number): PriceRange {
-    let maxPrice = -Infinity
-    let minPrice = Infinity
-
-    for (let i = startIndex; i < endIndex && i < data.length; i++) {
-        const e = data[i]
-        if (!e) continue
-        if (e.high > maxPrice) maxPrice = e.high
-        if (e.low < minPrice) minPrice = e.low
-    }
-
-    if (!Number.isFinite(maxPrice) || !Number.isFinite(minPrice)) {
-        return { maxPrice: 100, minPrice: 0 }
-    }
-
-    return { maxPrice, minPrice }
-}
+import type { KLineData } from '../../types/price'
+import type { PriceRange } from '../scale/price'
+import { getPhysicalKLineConfig } from '../utils/klineConfig'
+
+/**
+ * 计算当前视口可见的 K 线索引范围（使用物理像素对齐）。
+ *
+ * - 所有计算在物理像素空间进行，确保与 calcKLinePositions 一致
+ * - 会额外在左右各扩展 1 根（start-1/end+1），用于避免边缘裁剪带来的”断线/缺一根”观感
+ *
+ * @param scrollLeft 容器当前横向滚动量（逻辑像素）
+ * @param viewWidth  绘图区域宽度（plotWidth，逻辑像素，不含右侧 yAxis）
+ * @param kWidth     单根 K 线宽度（逻辑像素）
+ * @param kGap       K 线间距（逻辑像素）
+ * @param totalDataCount 数据总条数
+ * @param dpr        设备像素比
+ */
+export function getVisibleRange(
+    scrollLeft: number,
+    viewWidth: number,
+    kWidth: number,
+    kGap: number,
+    totalDataCount: number,
+    dpr: number = 1
+): { start: number; end: number } {
+    // 使用统一的物理像素配置，确保与 calcKLinePositions 完全一致
+    const { unitPx, startXPx } = getPhysicalKLineConfig(kWidth, kGap, dpr)
+
+    // scrollLeft 和 viewWidth 转换到物理像素空间
+    const scrollLeftPx = scrollLeft * dpr
+    const viewWidthPx = viewWidth * dpr
+
+    // 计算可见范围（物理像素空间整数运算）
+    const start = Math.max(0, Math.floor((scrollLeftPx - startXPx) / unitPx) - 1)
+    const end = Math.min(totalDataCount, Math.ceil((scrollLeftPx + viewWidthPx - startXPx) / unitPx) + 1)
+
+    return { start, end }
+}
+
+/**
+ * 计算指定索引区间内的价格范围（max/min）。
+ *
+ * 主要用途：
+ * - 为 pane 的 y 轴缩放与刻度提供 priceRange
+ * - 为渲染器（网格线、极值标注等）提供可视区参考范围
+ *
+ * 注意：
+ * - `endIndex` 为开区间（不包含）
+ * - 若区间内无有效数据，会返回兜底范围 `{ maxPrice: 100, minPrice: 0 }`
+ */
+export function getVisiblePriceRange(data: KLineData[], startIndex: number, endIndex: number): PriceRange {
+    let maxPrice = -Infinity
+    let minPrice = Infinity
+
+    for (let i = startIndex; i < endIndex && i < data.length; i++) {
+        const e = data[i]
+        if (!e) continue
+        if (e.high > maxPrice) maxPrice = e.high
+        if (e.low < minPrice) minPrice = e.low
+    }
+
+    if (!Number.isFinite(maxPrice) || !Number.isFinite(minPrice)) {
+        return { maxPrice: 100, minPrice: 0 }
+    }
+
+    return { maxPrice, minPrice }
+}

package/src/index.ts

@@ -1,3 +1,3 @@
-export * from './reactivity'
-export * from './controllers'
-export { VERSION } from './version'
+export * from './reactivity'
+export * from './controllers'
+export { VERSION } from './version'

package/src/plugin/ConfigManager.ts

@@ -1,93 +1,93 @@
-/**
- * 配置管理器
- */
-
-type ConfigStore = Map<string, Map<string, unknown>>
-
-export class ConfigManager {
-  private configs: ConfigStore = new Map()
-  private defaults: Map<string, Record<string, unknown>> = new Map()
-
-  /**
-   * 注册插件的默认配置
-   */
-  registerDefaults(pluginName: string, defaults: Record<string, unknown>): void {
-    this.defaults.set(pluginName, { ...defaults })
-
-    // 初始化配置
-    if (!this.configs.has(pluginName)) {
-      this.configs.set(pluginName, new Map())
-    }
-
-    // 应用默认值
-    const config = this.configs.get(pluginName)!
-    for (const [key, value] of Object.entries(defaults)) {
-      if (!config.has(key)) {
-        config.set(key, value)
-      }
-    }
-  }
-
-  /**
-   * 获取配置
-   */
-  get<K = unknown>(pluginName: string, key: string, defaultValue?: K): K {
-    const pluginConfig = this.configs.get(pluginName)
-    if (pluginConfig?.has(key)) {
-      return pluginConfig.get(key) as K
-    }
-
-    // 尝试默认值
-    const defaults = this.defaults.get(pluginName)
-    if (defaults && key in defaults) {
-      return defaults[key] as K
-    }
-
-    return defaultValue as K
-  }
-
-  /**
-   * 设置配置
-   */
-  set(pluginName: string, key: string, value: unknown): void {
-    if (!this.configs.has(pluginName)) {
-      this.configs.set(pluginName, new Map())
-    }
-    this.configs.get(pluginName)!.set(key, value)
-  }
-
-  /**
-   * 批量设置配置
-   */
-  setAll(pluginName: string, config: Record<string, unknown>): void {
-    for (const [key, value] of Object.entries(config)) {
-      this.set(pluginName, key, value)
-    }
-  }
-
-  /**
-   * 获取插件所有配置
-   */
-  getAll(pluginName: string): Record<string, unknown> {
-    const config = this.configs.get(pluginName)
-    const defaults = this.defaults.get(pluginName) || {}
-
-    return {
-      ...defaults,
-      ...(config ? Object.fromEntries(config) : {}),
-    }
-  }
-
-  /**
-   * 清除插件配置
-   */
-  clear(pluginName?: string): void {
-    if (pluginName) {
-      this.configs.delete(pluginName)
-      this.defaults.delete(pluginName)
-    } else {
-      this.configs.clear()
-      this.defaults.clear()
-    }
-  }
-}
+/**
+ * 配置管理器
+ */
+
+type ConfigStore = Map<string, Map<string, unknown>>
+
+export class ConfigManager {
+  private configs: ConfigStore = new Map()
+  private defaults: Map<string, Record<string, unknown>> = new Map()
+
+  /**
+   * 注册插件的默认配置
+   */
+  registerDefaults(pluginName: string, defaults: Record<string, unknown>): void {
+    this.defaults.set(pluginName, { ...defaults })
+
+    // 初始化配置
+    if (!this.configs.has(pluginName)) {
+      this.configs.set(pluginName, new Map())
+    }
+
+    // 应用默认值
+    const config = this.configs.get(pluginName)!
+    for (const [key, value] of Object.entries(defaults)) {
+      if (!config.has(key)) {
+        config.set(key, value)
+      }
+    }
+  }
+
+  /**
+   * 获取配置
+   */
+  get<K = unknown>(pluginName: string, key: string, defaultValue?: K): K {
+    const pluginConfig = this.configs.get(pluginName)
+    if (pluginConfig?.has(key)) {
+      return pluginConfig.get(key) as K
+    }
+
+    // 尝试默认值
+    const defaults = this.defaults.get(pluginName)
+    if (defaults && key in defaults) {
+      return defaults[key] as K
+    }
+
+    return defaultValue as K
+  }
+
+  /**
+   * 设置配置
+   */
+  set(pluginName: string, key: string, value: unknown): void {
+    if (!this.configs.has(pluginName)) {
+      this.configs.set(pluginName, new Map())
+    }
+    this.configs.get(pluginName)!.set(key, value)
+  }
+
+  /**
+   * 批量设置配置
+   */
+  setAll(pluginName: string, config: Record<string, unknown>): void {
+    for (const [key, value] of Object.entries(config)) {
+      this.set(pluginName, key, value)
+    }
+  }
+
+  /**
+   * 获取插件所有配置
+   */
+  getAll(pluginName: string): Record<string, unknown> {
+    const config = this.configs.get(pluginName)
+    const defaults = this.defaults.get(pluginName) || {}
+
+    return {
+      ...defaults,
+      ...(config ? Object.fromEntries(config) : {}),
+    }
+  }
+
+  /**
+   * 清除插件配置
+   */
+  clear(pluginName?: string): void {
+    if (pluginName) {
+      this.configs.delete(pluginName)
+      this.defaults.delete(pluginName)
+    } else {
+      this.configs.clear()
+      this.defaults.clear()
+    }
+  }
+}

package/src/plugin/EventBus.ts

@@ -1,77 +1,77 @@
-/**
- * 事件总线实现
- */
-import type { EventHandler } from './types'
-
-type EventMap = Map<string, Set<EventHandler>>
-
-export class EventBus {
-  private listeners: EventMap = new Map()
-
-  /**
-   * 订阅事件
-   */
-  on<T = unknown>(event: string, handler: EventHandler<T>): void {
-    if (!this.listeners.has(event)) {
-      this.listeners.set(event, new Set())
-    }
-    this.listeners.get(event)!.add(handler as EventHandler)
-  }
-
-  /**
-   * 取消订阅
-   */
-  off<T = unknown>(event: string, handler: EventHandler<T>): void {
-    const handlers = this.listeners.get(event)
-    if (handlers) {
-      handlers.delete(handler as EventHandler)
-    }
-  }
-
-  /**
-   * 发布事件
-   */
-  emit<T = unknown>(event: string, data: T): void {
-    const handlers = this.listeners.get(event)
-    if (handlers) {
-      handlers.forEach((handler) => {
-        try {
-          handler(data)
-        } catch (error) {
-          console.error(`[EventBus] Error in handler for "${event}":`, error)
-        }
-      })
-    }
-  }
-
-  /**
-   * 订阅一次性事件
-   *
-   * 注册一个仅在事件首次触发时执行的回调。回调执行后会自动从监听队列中移除，
-   * 确保后续相同事件的 emit 不会再触发该逻辑。
-   *
-   * @param event - 事件名称
-   * @param handler - 待执行的回调函数
-   */
-  once<T = unknown>(event: string, handler: EventHandler<T>): void {
-    const wrapper: EventHandler<T> = (data) => {
-      this.off(event, wrapper)
-      handler(data)
-    }
-    this.on(event, wrapper)
-  }
-
-  /**
-   * 清除所有事件监听
-   */
-  clear(): void {
-    this.listeners.clear()
-  }
-
-  /**
-   * 获取事件的监听器数量
-   */
-  listenerCount(event: string): number {
-    return this.listeners.get(event)?.size ?? 0
-  }
-}
+/**
+ * 事件总线实现
+ */
+import type { EventHandler } from './types'
+
+type EventMap = Map<string, Set<EventHandler>>
+
+export class EventBus {
+  private listeners: EventMap = new Map()
+
+  /**
+   * 订阅事件
+   */
+  on<T = unknown>(event: string, handler: EventHandler<T>): void {
+    if (!this.listeners.has(event)) {
+      this.listeners.set(event, new Set())
+    }
+    this.listeners.get(event)!.add(handler as EventHandler)
+  }
+
+  /**
+   * 取消订阅
+   */
+  off<T = unknown>(event: string, handler: EventHandler<T>): void {
+    const handlers = this.listeners.get(event)
+    if (handlers) {
+      handlers.delete(handler as EventHandler)
+    }
+  }
+
+  /**
+   * 发布事件
+   */
+  emit<T = unknown>(event: string, data: T): void {
+    const handlers = this.listeners.get(event)
+    if (handlers) {
+      handlers.forEach((handler) => {
+        try {
+          handler(data)
+        } catch (error) {
+          console.error(`[EventBus] Error in handler for "${event}":`, error)
+        }
+      })
+    }
+  }
+
+  /**
+   * 订阅一次性事件
+   *
+   * 注册一个仅在事件首次触发时执行的回调。回调执行后会自动从监听队列中移除，
+   * 确保后续相同事件的 emit 不会再触发该逻辑。
+   *
+   * @param event - 事件名称
+   * @param handler - 待执行的回调函数
+   */
+  once<T = unknown>(event: string, handler: EventHandler<T>): void {
+    const wrapper: EventHandler<T> = (data) => {
+      this.off(event, wrapper)
+      handler(data)
+    }
+    this.on(event, wrapper)
+  }
+
+  /**
+   * 清除所有事件监听
+   */
+  clear(): void {
+    this.listeners.clear()
+  }
+
+  /**
+   * 获取事件的监听器数量
+   */
+  listenerCount(event: string): number {
+    return this.listeners.get(event)?.size ?? 0
+  }
+}