@363045841yyt/klinechart-core 0.8.13 → 0.8.14-alpha.1

package/src/engine/subPaneManager.ts

@@ -1,15 +1,19 @@
 import { KLineChartError } from '../errors'
-import type { SubIndicatorType } from './renderers/Indicator'
+import type { RendererPlugin, RendererPluginWithHost, RenderContext } from '../plugin'
 import { createSignal, type Signal } from '../reactivity/signal'
+import { createLayerFromPlugin } from '../scene/createLayerFromPlugin'
+import type { Layer } from '../scene/types'
+
+import type { PaneSpec } from './chartTypes'
+import type { IndicatorScheduler } from './indicators/scheduler'
+import type { SubIndicatorType } from './renderers/Indicator'
 import { createSubIndicatorRenderer } from './renderers/Indicator'
-import { createPaneTitleRendererPlugin } from './renderers/paneTitle'
-import { createIndicatorScaleRendererPlugin } from './renderers/Indicator/scale/indicator_scale'
 import { findIndicator } from './renderers/Indicator/indicatorCatalog'
-import type { IndicatorScheduler } from './indicators/scheduler'
-import type { RendererPlugin, RendererPluginWithHost, RenderContext } from '../plugin'
-import type { PaneSpec } from './chartTypes'
-import type { Layer } from '../scene/types'
-import { createLayerFromPlugin } from '../scene/createLayerFromPlugin'
+import { createIndicatorScaleRendererPlugin } from './renderers/Indicator/scale/indicator_scale'
+import { createPaneTitleRendererPlugin } from './renderers/paneTitle'
+
+
+
 
 export interface SubPaneEntry {
   paneId: string
@@ -226,11 +230,11 @@ export class SubPaneManager {
   }
 
   getAll(): SubPaneEntry[] {
-    return Array.from(this.entries.values())
+    return [...this.entries.values()]
   }
 
   getPaneIds(): string[] {
-    return Array.from(this.entries.keys())
+    return [...this.entries.keys()]
   }
 
   clear(ctx: SubPaneContext): void {

package/src/engine/utils/__tests__/tickPosition.test.ts

@@ -1,4 +1,5 @@
 import { describe, expect, it } from 'vitest'
+
 import { calculateValueTickPositions } from '../tickPosition'
 
 describe('calculateValueTickPositions', () => {

package/src/engine/utils/tickPosition.ts

@@ -1,6 +1,7 @@
-import { calculateTickCount } from './tickCount'
 import { fromLog, logFormulaForPriceRange, toLog } from '../scale/logFormula'
 
+import { calculateTickCount } from './tickCount'
+
 export interface TickPosition {
   index: number
   t: number

package/src/engine/viewport/chartViewportManager.ts

@@ -1,6 +1,6 @@
+import { createSignal, type Signal } from '../../reactivity/signal'
 import type { ChartDom, Viewport, ViewportState } from '../chartTypes'
 import type { VisibleRange, UpdateLevel } from '../layout/pane'
-import { createSignal, type Signal } from '../../reactivity/signal'
 
 export interface ViewportDependencies {
   getDom: () => ChartDom

package/src/indicators/__tests__/maFamily.test.ts

@@ -10,12 +10,13 @@
  */
 
 import { describe, it, expect } from 'vitest'
+
 import { computeALMA } from '../alma'
-import { computeT3 } from '../t3'
-import { computeZLEMA } from '../zlema'
+import { computeFRAMA } from '../frama'
 import { computeLSMA } from '../lsma'
+import { computeT3 } from '../t3'
 import { computeVIDYA } from '../vidya'
-import { computeFRAMA } from '../frama'
+import { computeZLEMA } from '../zlema'
 
 function constant(n: number, v: number): number[] {
   return Array.from({ length: n }, () => v)

package/src/indicators/__tests__/oscillators.test.ts

@@ -8,12 +8,13 @@
  */
 
 import { describe, it, expect } from 'vitest'
-import { computeStochRSI } from '../stochRSI'
+
 import { computeAwesomeOscillator } from '../awesomeOscillator'
-import { computeUltimateOscillator } from '../ultimateOscillator'
 import { computeDPO } from '../dpo'
 import { computeFisherTransform } from '../fisherTransform'
 import { computeSchaffTrendCycle } from '../schaffTrendCycle'
+import { computeStochRSI } from '../stochRSI'
+import { computeUltimateOscillator } from '../ultimateOscillator'
 
 function ramp(n: number, start = 1, step = 1): number[] {
   return Array.from({ length: n }, (_, i) => start + step * i)

package/src/input/gesture.ts

@@ -31,8 +31,8 @@
  * history, pinch to zoom, swipe to flick-scroll, tap to inspect).
  */
 
-import { createSignal, type Signal } from '../reactivity'
 import { KLineChartError } from '../errors'
+import { createSignal, type Signal } from '../reactivity'
 
 // ---------------------------------------------------------------------------
 // Event surface

package/src/input/keyboard.ts

@@ -39,8 +39,8 @@
  *       })
  */
 
-import { createSignal, type Signal } from '../reactivity'
 import { KLineChartError } from '../errors'
+import { createSignal, type Signal } from '../reactivity'
 
 // ---------------------------------------------------------------------------
 // Public shape

package/src/mcp/chartBridge.ts

@@ -1,7 +1,10 @@
-import type { ToolCall, ToolResult, ControllerDescription, ToolCallHandler } from './types'
+import { Effect, Fiber, pipe, Schedule } from 'effect'
+
 import { KLineChartError } from '../errors'
 import { generateUUID } from '../utils/uuid'
-import { Effect, Fiber, pipe, Schedule } from 'effect'
+
+import type { ToolCall, ToolResult, ControllerDescription, ToolCallHandler } from './types'
+
 
 export interface ChartBridgeOptions {
   wsUrl: string

package/src/plugin/PluginHost.ts

@@ -2,6 +2,12 @@
  * 插件宿主 - 核心管理类
  */
 import { KLineChartError } from '../errors'
+
+import { ConfigManager } from './ConfigManager'
+import { EventBus } from './EventBus'
+import { HookSystem } from './HookSystem'
+import { PluginRegistry } from './PluginRegistry'
+import { StateStore } from './StateStore'
 import type {
   Plugin,
   PluginConfig,
@@ -11,11 +17,6 @@ import type {
   PluginLogger,
   HookCallOptions,
 } from './types'
-import { PluginRegistry } from './PluginRegistry'
-import { EventBus } from './EventBus'
-import { HookSystem } from './HookSystem'
-import { ConfigManager } from './ConfigManager'
-import { StateStore } from './StateStore'
 
 export class PluginHostImpl implements PluginHost {
   private registry: PluginRegistry

package/src/plugin/PluginRegistry.ts

@@ -2,6 +2,7 @@
  * 插件注册表
  */
 import { KLineChartError } from '../errors'
+
 import type { Plugin, PluginDescriptor, PluginState } from './types'
 
 export class PluginRegistry {
@@ -54,7 +55,7 @@ export class PluginRegistry {
    * 获取所有插件
    */
   getAll(): PluginDescriptor[] {
-    return Array.from(this.plugins.values())
+    return [...this.plugins.values()]
   }
 
   /**

package/src/plugin/rendererPluginManager.ts

@@ -2,6 +2,8 @@
  * 渲染器插件管理器
  */
 
+import { UpdateLevel } from '../engine/layout/pane'
+
 import type {
   RendererPlugin,
   RenderContext,
@@ -9,7 +11,6 @@ import type {
   RendererPluginWithHost,
   PluginHost,
 } from './types'
-import { UpdateLevel } from '../engine/layout/pane'
 
 /** 渲染器错误事件（裁剪后，不含大数据） */
 export interface RendererErrorEvent {
@@ -322,7 +323,7 @@ export class RendererPluginManager {
 
   /** 获取所有渲染器插件 */
   getAllPlugins(): RendererPlugin[] {
-    return Array.from(this.plugins.values())
+    return [...this.plugins.values()]
   }
 
   /** 获取指定渲染器 */

package/src/plugin/types.ts

@@ -2,8 +2,8 @@
  * 插件系统核心类型定义
  */
 
-import type { KLineData } from '../types/price'
 import type { CandleWebGLSurface, LineWebGLSurface } from '../engine/renderers/webgl/candleSurface'
+import type { KLineData } from '../types/price'
 
 /** 插件生命周期状态 */
 export enum PluginState {

package/src/render/__tests__/contract.test.ts

@@ -12,6 +12,7 @@
  */
 
 import { describe, it, expect } from 'vitest'
+
 import type {
   SurfaceBackend,
   SurfaceRegion,

package/src/render/__tests__/webglRenderer.fallback.test.ts

@@ -1,4 +1,5 @@
 import { describe, it, expect, vi, beforeEach } from 'vitest'
+
 import { createWebGLRenderer } from '../createWebGLRenderer'
 import type { SurfaceBackend, SurfaceRegion } from '../index'
 

package/src/render/__tests__/webglRenderer.test.ts

@@ -1,4 +1,5 @@
 import { describe, it, expect, vi, beforeEach } from 'vitest'
+
 import { createWebGLRenderer } from '../createWebGLRenderer'
 import type { SurfaceBackend, SurfaceRegion } from '../index'
 

package/src/render/__tests__/webglSurfaceBackend.test.ts

@@ -1,4 +1,5 @@
 import { describe, it, expect, vi } from 'vitest'
+
 import { createWebGLSurfaceBackend } from '../createWebGLSurfaceBackend'
 import type { SurfaceBackend, SurfaceRegion } from '../index'
 

package/src/render/createWebGLRenderer.ts

@@ -1,4 +1,6 @@
-import type { SurfaceBackend, SurfaceRegion } from './SurfaceBackend'
+import { CandleWebGLSurface, LineWebGLSurface } from '../engine/renderers/webgl/candleSurface'
+import { SharedWebGLSurface } from '../engine/renderers/webgl/sharedWebGLSurface'
+
 import type {
   Renderer,
   RendererCapabilities,
@@ -10,8 +12,7 @@ import type {
   DrawLinesParams,
   DispatchComputeParams,
 } from './Renderer'
-import { SharedWebGLSurface } from '../engine/renderers/webgl/sharedWebGLSurface'
-import { CandleWebGLSurface, LineWebGLSurface } from '../engine/renderers/webgl/candleSurface'
+import type { SurfaceBackend, SurfaceRegion } from './SurfaceBackend'
 
 type WebGLPipelineDescriptor = {
   type: 'candle' | 'line' | 'fill'

package/src/render/createWebGLSurfaceBackend.ts

@@ -1,6 +1,7 @@
-import type { SurfaceBackend, SurfaceRegion, CompositeOptions } from './SurfaceBackend'
 import { SharedWebGLSurface } from '../engine/renderers/webgl/sharedWebGLSurface'
 
+import type { SurfaceBackend, SurfaceRegion, CompositeOptions } from './SurfaceBackend'
+
 export function createWebGLSurfaceBackend(surface: SharedWebGLSurface): SurfaceBackend {
   let disposed = false
 

package/src/renderer-tier/__tests__/selectBackend.test.ts

@@ -19,8 +19,8 @@
 import { describe, it, expect } from 'vitest'
 
 import { selectBackend, selectBackendOrThrow, type BackendRegistry } from '..'
-import type { RendererTierResult } from '../types'
 import { isKLineChartError } from '../../errors'
+import type { RendererTierResult } from '../types'
 
 const ALWAYS = (): boolean => true
 const NEVER = (): boolean => false

package/src/renderer-tier/detectRendererTier.ts

@@ -28,6 +28,7 @@
  */
 
 import { KLineChartError } from '../errors'
+
 import {
   RENDERER_TIER_RANK,
   type DetectRendererTierOptions,

package/src/renderer-tier/selectBackend.ts

@@ -26,13 +26,14 @@
  */
 
 import { KLineChartError } from '../errors'
+
+import { detectRendererTier, isTierAtLeast } from './detectRendererTier'
 import {
   RENDERER_TIER_RANK,
   type DetectRendererTierOptions,
   type RendererTier,
   type RendererTierResult,
 } from './types'
-import { detectRendererTier, isTierAtLeast } from './detectRendererTier'
 
 // ---------------------------------------------------------------------------
 // Public shape

package/src/replay/__tests__/controller.test.ts

@@ -1,4 +1,5 @@
 import { describe, it, expect, vi } from 'vitest'
+
 import { createReplayController } from '../createReplayController'
 import type { ReplayState } from '../types'
 

package/src/replay/__tests__/timeline.test.ts

@@ -1,4 +1,5 @@
 import { describe, it, expect } from 'vitest'
+
 import {
   barIndexToTimestamp,
   timestampToBarIndex,

package/src/replay/createReplayController.ts

@@ -23,6 +23,7 @@ import { KLineChartError } from '../errors'
  */
 
 import { createSignal, type Signal } from '../reactivity/signal'
+
 import type {
   ReplayController,
   ReplayControllerInit,
@@ -98,7 +99,7 @@ export function createReplayController(init?: ReplayControllerInit): ReplayContr
   const speed = init?.speed ?? 1
   assertValidSpeed(speed)
 
-  let barIntervalMs = init?.barIntervalMs ?? DEFAULT_BAR_INTERVAL_MS
+  const barIntervalMs = init?.barIntervalMs ?? DEFAULT_BAR_INTERVAL_MS
   if (!Number.isFinite(barIntervalMs) || barIntervalMs <= 0) {
     throw new KLineChartError(
       'REPLAY_CONFIG_INVALID',

package/src/scale/__tests__/anchoredZoom.test.ts

@@ -1,4 +1,5 @@
 import { describe, it, expect } from 'vitest'
+
 import { computeAnchoredZoom } from '../anchoredZoom'
 
 /**

package/src/scale/__tests__/originShift.test.ts

@@ -1,4 +1,5 @@
 import { describe, it, expect } from 'vitest'
+
 import { createOriginShiftPolicy } from '../originShift'
 
 describe('createOriginShiftPolicy', () => {

package/src/scale/__tests__/priceScale.test.ts

@@ -1,4 +1,5 @@
 import { describe, it, expect, vi } from 'vitest'
+
 import { createPriceScale } from '../createPriceScale'
 
 describe('createPriceScale — linear mode', () => {

package/src/scale/__tests__/timeScale.test.ts

@@ -1,4 +1,5 @@
 import { describe, it, expect, vi } from 'vitest'
+
 import { createTimeScale } from '../createTimeScale'
 
 describe('createTimeScale', () => {

package/src/scale/createPriceScale.ts

@@ -30,9 +30,10 @@
  * we don't want one bad row to crash the chart.
  */
 
-import { createSignal } from '../reactivity/signal'
 import { KLineChartError } from '../errors'
+import { createSignal } from '../reactivity/signal'
 import type { Signal } from '../reactivity/signal'
+
 import { createOriginShiftPolicy, type OriginShiftPolicy } from './originShift'
 import type { PriceScale, ScaleMode } from './types'
 

package/src/scale/createTimeScale.ts

@@ -15,8 +15,9 @@
  * extrapolate, or display a "—" label.
  */
 
-import { createSignal } from '../reactivity/signal'
 import { KLineChartError } from '../errors'
+import { createSignal } from '../reactivity/signal'
+
 import type { TimeScale } from './types'
 
 export interface TimeScaleConfig {

package/src/scene/__tests__/layerFromPlugin.test.ts

@@ -1,7 +1,8 @@
 import { describe, it, expect, vi } from 'vitest'
-import { createLayerFromPlugin } from '../createLayerFromPlugin'
+
 import { RENDERER_PRIORITY } from '../../plugin'
 import type { RendererPlugin, RenderContext } from '../../plugin'
+import { createLayerFromPlugin } from '../createLayerFromPlugin'
 import type { PaintContext } from '../types'
 
 // ---------------------------------------------------------------------------

package/src/scene/__tests__/layerRegistry.test.ts

@@ -12,6 +12,7 @@
  */
 
 import { describe, it, expect } from 'vitest'
+
 import { createLayerRegistry, BUILTIN_LAYER_TYPES, type LayerFactory } from '../layerRegistry'
 import type { Layer, PaintContext } from '../types'
 

package/src/scene/__tests__/scene.test.ts

@@ -14,9 +14,10 @@
  */
 
 import { describe, it, expect } from 'vitest'
+
+import type { Renderer } from '../../render/Renderer'
 import { createScene } from '../createScene'
 import type { Layer, LayerRole, PaintContext, PaneRole } from '../types'
-import type { Renderer } from '../../render/Renderer'
 
 // ---------------------------------------------------------------------------
 // Test helpers

package/src/scene/createLayerFromPlugin.ts

@@ -1,5 +1,6 @@
 import { RENDERER_PRIORITY } from '../plugin'
 import type { RendererPlugin, RenderContext } from '../plugin'
+
 import type { Layer, LayerRole, PaintContext, PaneRole } from './types'
 
 export function createLayerFromPlugin(

package/src/scene/createScene.ts

@@ -19,6 +19,7 @@
  */
 
 import { createSignal, type Signal } from '../reactivity/signal'
+
 import type { Layer, LayerRole, PaintContext, Scene } from './types'
 
 export function createScene(): Scene {
@@ -30,7 +31,7 @@ export function createScene(): Scene {
   const layersSignal: Signal<ReadonlyArray<Layer>> = createSignal<ReadonlyArray<Layer>>([])
 
   const publish = (): void => {
-    layersSignal.set(layerList.slice() as ReadonlyArray<Layer>)
+    layersSignal.set([...layerList] as ReadonlyArray<Layer>)
   }
 
   // ---- public API --------------------------------------------------------

package/src/scene/layerRegistry.ts

@@ -81,7 +81,7 @@ export function createLayerRegistry(): LayerRegistry {
   const get = (typeId: string): LayerFactory | null => factories.get(typeId) ?? null
 
   const list = (): ReadonlyArray<LayerFactory> =>
-    Array.from(factories.values()) as ReadonlyArray<LayerFactory>
+    [...factories.values()] as ReadonlyArray<LayerFactory>
 
   return { register, unregister, get, list }
 }

package/src/scene/types.ts

@@ -18,9 +18,9 @@
  * controllers can compile against them without pulling in the implementation.
  */
 
+import type { Signal } from '../reactivity/signal'
 import type { Renderer } from '../render/Renderer'
 import type { SurfaceRegion } from '../render/SurfaceBackend'
-import type { Signal } from '../reactivity/signal'
 
 /**
  * Roles let the scene group layers and let other systems target them

package/src/scheduler/createFrameBudget.ts

@@ -33,8 +33,8 @@
  *   if (budget.recentFrameMs() > 18) skipLowPriorityWork()
  */
 
-import { createSignal, type Signal } from '../reactivity'
 import { KLineChartError } from '../errors'
+import { createSignal, type Signal } from '../reactivity'
 
 // ---------------------------------------------------------------------------
 // Public shape

package/src/semantic/__tests__/controller.test.ts

@@ -1,4 +1,5 @@
 import { afterEach, describe, expect, it, vi } from 'vitest'
+
 import { SemanticChartController, type SemanticChartAdapter } from '../controller'
 import type { SemanticChartConfig } from '../types'
 

package/src/semantic/controller.ts

@@ -1,9 +1,11 @@
-import { EventBus } from '../plugin/EventBus'
-import type { CustomMarkerEntity } from '../engine/marker/registry'
-import { SemanticConfigValidator } from './validator'
-import { getBuiltinIndicatorDefinitions } from '../engine/indicators/registerBuiltins'
+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,
@@ -12,8 +14,10 @@ import type {
   CustomMarker,
   DataConfig,
 } from './types'
-import type { SubIndicatorType as CoreSubIndicatorType } from '../engine/renderers/Indicator'
-import type { KLineData, DataFetcher, SymbolSpec } from '../controllers/types'
+import { SemanticConfigValidator } from './validator'
+
+
+
 
 export type SemanticEventType = 'config:loading' | 'config:ready' | 'config:error'
 export type { DataFetcher, SymbolSpec } from '../controllers/types'

package/src/tokens/colorPresetSettings.ts

@@ -48,7 +48,10 @@ export interface ColorPresetItem {
 
 export type ColorPresetOverrides = Partial<Record<ColorPresetKey, ColorValue>>
 
-export type ColorPresetSettings = Partial<Record<ColorPresetThemeName, ColorPresetOverrides>>
+export interface ColorPresetSettings {
+  light?: ColorPresetOverrides
+  dark?: ColorPresetOverrides
+}
 
 export const COLOR_PRESET_STORAGE_KEY = 'kline-chart-color-presets'
 
@@ -93,20 +96,35 @@ export const COLOR_PRESET_ITEMS: readonly ColorPresetItem[] = [
   { key: 'mtfOverlay', label: '多周期叠加', group: 'interaction' },
 ]
 
+// 白名单 key 集合
 const COLOR_PRESET_KEYS = new Set<ColorPresetKey>(COLOR_PRESET_ITEMS.map((item) => item.key))
 
-export function normalizeColorPresetSettings(value: unknown): ColorPresetSettings {
+/**
+ * 将传入的颜色预设值归一化为干净的 ColorPresetSettings。
+ * 过滤掉非法 key、非字符串颜色、空字符串，只保留 light/dark 两个主题下的有效色值。
+ *
+ * 从 JSON.parse（localStorage）路径传入时类型会被擦除，运行时仍会执行过滤；
+ * 有 TypeScript 保障的调用路径（组件 prop）则同时获得编译期类型检查。
+ *
+ * @param value - 待归一化的颜色预设
+ * @returns 干净的 ColorPresetSettings 对象
+ */
+export function normalizeColorPresetSettings(value?: ColorPresetSettings): ColorPresetSettings {
+  // 非法 / 非对象输入直接返回空对象，避免下游取 .light / .dark 报错
   if (!value || typeof value !== 'object') return {}
 
   const source = value as Record<string, unknown>
   const result: ColorPresetSettings = {}
 
+  // 只扫描 light / dark 两个主题，忽略其他无关顶层 key
   for (const themeName of ['light', 'dark'] as const) {
     const themeOverrides = source[themeName]
     if (!themeOverrides || typeof themeOverrides !== 'object') continue
 
     const clean: ColorPresetOverrides = {}
     for (const [key, color] of Object.entries(themeOverrides as Record<string, unknown>)) {
+      // 只放行 COLOR_PRESET_ITEMS 中登记过的 key + 非空颜色字符串
+      // 三重过滤：白名单 + 类型检查 + 非空校验
       if (
         COLOR_PRESET_KEYS.has(key as ColorPresetKey) &&
         typeof color === 'string' &&
@@ -115,6 +133,7 @@ export function normalizeColorPresetSettings(value: unknown): ColorPresetSetting
         clean[key as ColorPresetKey] = color
       }
     }
+    // 没有有效改动的 theme 不写入结果，保持对象精简
     if (Object.keys(clean).length > 0) result[themeName] = clean
   }
 

package/src/tokens/theme-china.ts

@@ -19,10 +19,10 @@
  * ```
  */
 
-import type { ColorTokens, Theme } from './types'
-import { lightTheme } from './theme-light'
-import { darkTheme } from './theme-dark'
 import { applyColorPresetOverrides, type ColorPresetSettings } from './colorPresetSettings'
+import { darkTheme } from './theme-dark'
+import { lightTheme } from './theme-light'
+import type { ColorTokens, Theme } from './types'
 
 /**
  * Swap all bull/bear colour pairs in a Theme so that "up" (bull) uses

package/src/tokens/theme-dark.ts

@@ -17,8 +17,8 @@
  * `__tests__/themes.test.ts` enforces this.
  */
 
-import type { Theme } from './types'
 import { spacing, typography, motion } from './theme-base'
+import type { Theme } from './types'
 
 export const darkTheme: Theme = {
   name: 'dark',

package/src/tokens/theme-light.ts

@@ -19,8 +19,8 @@
  * Each WCAG AA against the background (>= 3:1 for non-text).
  */
 
-import type { Theme } from './types'
 import { spacing, typography, motion } from './theme-base'
+import type { Theme } from './types'
 
 export const lightTheme: Theme = {
   name: 'light',

package/src/utils/__tests__/dateFormat.test.ts

@@ -1,4 +1,5 @@
 import { describe, it, expect } from 'vitest'
+
 import { findMonthBoundaries, findDayBoundaries } from '../dateFormat'
 
 function clamp(n: number, min: number, max: number): number {