@363045841yyt/klinechart-core 0.7.3 → 0.7.5

package/src/config/chartSettings.ts

@@ -1,66 +1,66 @@
-/**
- * 图表设置配置
- */
-
-export interface SettingItem {
-  key: string
-  label: string
-  type: 'boolean' | 'select'
-  default: boolean | string
-  group?: string
-  options?: { value: string; label: string }[]
-}
-
-/**
- * 检测设备类型：mobile / tablet / desktop
- * 优先使用 Client Hints API (navigator.userAgentData)，不支持时回退到 UA + 屏幕/触控检测
- */
-export function getDeviceType(): 'mobile' | 'tablet' | 'desktop' {
-  if (typeof navigator === 'undefined') return 'desktop'
-
-  const uaData = (navigator as any).userAgentData
-  if (uaData?.formFactor) {
-    const formFactor = uaData.formFactor as string
-    if (formFactor === 'phone') return 'mobile'
-    if (formFactor === 'tablet') return 'tablet'
-    if (formFactor === 'desktop') return 'desktop'
-  }
-
-  if (uaData?.mobile === true) return 'mobile'
-  if (uaData?.mobile === false) {
-    // 明确非手机，但不确定是平板还是桌面，继续后续判断
-  }
-
-  const ua = navigator.userAgent.toLowerCase()
-  const isMobileUA = /android.*mobile|webos|iphone|ipod|blackberry|iemobile|opera mini|mobile/i.test(ua)
-  if (isMobileUA) return 'mobile'
-
-  const hasTouch = navigator.maxTouchPoints > 1
-  const isTabletScreen = window.screen.width >= 768 && window.screen.width <= 1366
-
-  if (hasTouch && isTabletScreen) return 'tablet'
-
-  return 'desktop'
-}
-
-/** 移动端（含平板）默认不开启 WebGL */
-const ENABLE_WEBGL_DEFAULT = getDeviceType() === 'desktop'
-
-/** 默认设置配置 */
-export const DEFAULT_SETTINGS = [
-  { key: 'showGridLines', label: '显示网格', type: 'boolean', default: true, group: 'main' },
-  { key: 'showVolumePriceMarkers', label: '显示量价关系标记', type: 'boolean', default: false, group: 'main' },
-  { key: 'logarithmicScale', label: '对数价格轴', type: 'boolean', default: false, group: 'main' },
-  { key: 'disableMainPaneVerticalScroll', label: '主图纵轴刻度自适应调整', type: 'boolean', default: true, group: 'main' },
-  { key: 'enableWebGLRendering', label: '启用 WebGL 硬件加速渲染', type: 'boolean', default: ENABLE_WEBGL_DEFAULT, group: 'main' },
-  { key: 'performanceTest10kKlines', label: '万条K线性能测试', type: 'boolean', default: false, group: 'experimental' },
-  { key: 'enableCanvasProfiler', label: 'Canvas 性能分析插桩', type: 'boolean', default: false, group: 'experimental' },
-] as const
-
-/** 图表设置类型（从 DEFAULT_SETTINGS 自动推导，同时兼容扩展） */
-export type ChartSettings = {
-  [K in (typeof DEFAULT_SETTINGS)[number]['key']]?: boolean
-} & Record<string, boolean | string>
-
-/** localStorage 存储键名 */
-export const SETTINGS_STORAGE_KEY = 'kline-chart-settings'
+/**
+ * 图表设置配置
+ */
+
+export interface SettingItem {
+  key: string
+  label: string
+  type: 'boolean' | 'select'
+  default: boolean | string
+  group?: string
+  options?: { value: string; label: string }[]
+}
+
+/**
+ * 检测设备类型：mobile / tablet / desktop
+ * 优先使用 Client Hints API (navigator.userAgentData)，不支持时回退到 UA + 屏幕/触控检测
+ */
+export function getDeviceType(): 'mobile' | 'tablet' | 'desktop' {
+  if (typeof navigator === 'undefined') return 'desktop'
+
+  const uaData = (navigator as any).userAgentData
+  if (uaData?.formFactor) {
+    const formFactor = uaData.formFactor as string
+    if (formFactor === 'phone') return 'mobile'
+    if (formFactor === 'tablet') return 'tablet'
+    if (formFactor === 'desktop') return 'desktop'
+  }
+
+  if (uaData?.mobile === true) return 'mobile'
+  if (uaData?.mobile === false) {
+    // 明确非手机，但不确定是平板还是桌面，继续后续判断
+  }
+
+  const ua = navigator.userAgent.toLowerCase()
+  const isMobileUA = /android.*mobile|webos|iphone|ipod|blackberry|iemobile|opera mini|mobile/i.test(ua)
+  if (isMobileUA) return 'mobile'
+
+  const hasTouch = navigator.maxTouchPoints > 1
+  const isTabletScreen = window.screen.width >= 768 && window.screen.width <= 1366
+
+  if (hasTouch && isTabletScreen) return 'tablet'
+
+  return 'desktop'
+}
+
+/** 移动端（含平板）默认不开启 WebGL */
+const ENABLE_WEBGL_DEFAULT = getDeviceType() === 'desktop'
+
+/** 默认设置配置 */
+export const DEFAULT_SETTINGS = [
+  { key: 'showGridLines', label: '显示网格', type: 'boolean', default: true, group: 'main' },
+  { key: 'showVolumePriceMarkers', label: '显示量价关系标记', type: 'boolean', default: false, group: 'main' },
+  { key: 'logarithmicScale', label: '对数价格轴', type: 'boolean', default: false, group: 'main' },
+  { key: 'disableMainPaneVerticalScroll', label: '主图纵轴刻度自适应调整', type: 'boolean', default: true, group: 'main' },
+  { key: 'enableWebGLRendering', label: '启用 WebGL 硬件加速渲染', type: 'boolean', default: ENABLE_WEBGL_DEFAULT, group: 'main' },
+  { key: 'performanceTest10kKlines', label: '万条K线性能测试', type: 'boolean', default: false, group: 'experimental' },
+  { key: 'enableCanvasProfiler', label: 'Canvas 性能分析插桩', type: 'boolean', default: false, group: 'experimental' },
+] as const
+
+/** 图表设置类型（从 DEFAULT_SETTINGS 自动推导，同时兼容扩展） */
+export type ChartSettings = {
+  [K in (typeof DEFAULT_SETTINGS)[number]['key']]?: boolean
+} & Record<string, boolean | string>
+
+/** localStorage 存储键名 */
+export const SETTINGS_STORAGE_KEY = 'kline-chart-settings'

package/src/controllers/__tests__/drawing.test.ts

@@ -1,214 +1,214 @@
-import { describe, it, expect, vi } from 'vitest'
-import { createDrawingController } from '../createDrawingController'
-
-// ---------------------------------------------------------------------------
-// Construction
-// ---------------------------------------------------------------------------
-
-describe('createDrawingController — construction', () => {
-    it('defaults to null activeTool and zero drawingCount', () => {
-        const c = createDrawingController()
-        expect(c.state()).toEqual({ activeTool: null, drawingCount: 0 })
-    })
-
-    it('accepts an initial active tool', () => {
-        const c = createDrawingController({ initialActiveTool: 'trendline' })
-        expect(c.state().activeTool).toBe('trendline')
-        expect(c.state().drawingCount).toBe(0)
-    })
-
-    it('accepts an initial drawing count', () => {
-        const c = createDrawingController({ initialDrawingCount: 5 })
-        expect(c.state().drawingCount).toBe(5)
-    })
-
-    it('floors a negative initial drawing count at 0', () => {
-        const c = createDrawingController({ initialDrawingCount: -3 })
-        expect(c.state().drawingCount).toBe(0)
-    })
-
-    it('accepts both initial values together', () => {
-        const c = createDrawingController({
-            initialActiveTool: 'fib',
-            initialDrawingCount: 2,
-        })
-        expect(c.state()).toEqual({ activeTool: 'fib', drawingCount: 2 })
-    })
-})
-
-// ---------------------------------------------------------------------------
-// setActiveTool
-// ---------------------------------------------------------------------------
-
-describe('setActiveTool', () => {
-    it('round-trips through every drawing tool type', () => {
-        const c = createDrawingController()
-        const types = [
-            'trendline',
-            'horizontal',
-            'fib',
-            'rectangle',
-            'arrow',
-        ] as const
-
-        for (const t of types) {
-            c.setActiveTool(t)
-            expect(c.state().activeTool).toBe(t)
-        }
-    })
-
-    it('can clear the active tool with null', () => {
-        const c = createDrawingController({ initialActiveTool: 'trendline' })
-        c.setActiveTool(null)
-        expect(c.state().activeTool).toBeNull()
-    })
-
-    it('emits exactly one notification per change', () => {
-        const c = createDrawingController()
-        const listener = vi.fn()
-        c.state.subscribe(listener)
-        c.setActiveTool('rectangle')
-        expect(listener).toHaveBeenCalledTimes(1)
-    })
-
-    it('does not emit when the value is unchanged', () => {
-        const c = createDrawingController({ initialActiveTool: 'fib' })
-        const listener = vi.fn()
-        c.state.subscribe(listener)
-        c.setActiveTool('fib')
-        expect(listener).not.toHaveBeenCalled()
-    })
-
-    it('preserves drawingCount when changing tools', () => {
-        const c = createDrawingController({ initialDrawingCount: 4 })
-        c.setActiveTool('arrow')
-        expect(c.state().drawingCount).toBe(4)
-    })
-})
-
-// ---------------------------------------------------------------------------
-// clearAll
-// ---------------------------------------------------------------------------
-
-describe('clearAll', () => {
-    it('resets drawingCount to 0', () => {
-        const c = createDrawingController({ initialDrawingCount: 7 })
-        c.clearAll()
-        expect(c.state().drawingCount).toBe(0)
-    })
-
-    it('preserves activeTool', () => {
-        const c = createDrawingController({
-            initialActiveTool: 'horizontal',
-            initialDrawingCount: 3,
-        })
-        c.clearAll()
-        expect(c.state().activeTool).toBe('horizontal')
-    })
-
-    it('emits one notification when count was non-zero', () => {
-        const c = createDrawingController({ initialDrawingCount: 2 })
-        const listener = vi.fn()
-        c.state.subscribe(listener)
-        c.clearAll()
-        expect(listener).toHaveBeenCalledTimes(1)
-    })
-
-    it('does not emit when count is already 0', () => {
-        const c = createDrawingController()
-        const listener = vi.fn()
-        c.state.subscribe(listener)
-        c.clearAll()
-        expect(listener).not.toHaveBeenCalled()
-    })
-})
-
-// ---------------------------------------------------------------------------
-// deleteLast
-// ---------------------------------------------------------------------------
-
-describe('deleteLast', () => {
-    it('decrements drawingCount by 1', () => {
-        const c = createDrawingController({ initialDrawingCount: 3 })
-        c.deleteLast()
-        expect(c.state().drawingCount).toBe(2)
-    })
-
-    it('floors at 0 — no-op when count is 0', () => {
-        const c = createDrawingController()
-        const listener = vi.fn()
-        c.state.subscribe(listener)
-        c.deleteLast()
-        expect(c.state().drawingCount).toBe(0)
-        expect(listener).not.toHaveBeenCalled()
-    })
-
-    it('emits one notification per successful decrement', () => {
-        const c = createDrawingController({ initialDrawingCount: 2 })
-        const listener = vi.fn()
-        c.state.subscribe(listener)
-        c.deleteLast()
-        c.deleteLast()
-        expect(listener).toHaveBeenCalledTimes(2)
-        expect(c.state().drawingCount).toBe(0)
-        // third call is a no-op (floor)
-        c.deleteLast()
-        expect(listener).toHaveBeenCalledTimes(2)
-    })
-
-    it('preserves activeTool when decrementing', () => {
-        const c = createDrawingController({
-            initialActiveTool: 'rectangle',
-            initialDrawingCount: 2,
-        })
-        c.deleteLast()
-        expect(c.state().activeTool).toBe('rectangle')
-    })
-})
-
-// ---------------------------------------------------------------------------
-// Immutability
-// ---------------------------------------------------------------------------
-
-describe('immutability', () => {
-    it('produces a new state object on every successful mutation', () => {
-        const c = createDrawingController({ initialDrawingCount: 1 })
-        const before = c.state()
-        c.setActiveTool('arrow')
-        const after = c.state()
-        expect(after).not.toBe(before)
-        // the original snapshot must not have been mutated
-        expect(before.activeTool).toBeNull()
-    })
-})
-
-// ---------------------------------------------------------------------------
-// dispose
-// ---------------------------------------------------------------------------
-
-describe('dispose', () => {
-    it('silences subsequent mutators for previously-attached subscribers', () => {
-        const c = createDrawingController({ initialDrawingCount: 3 })
-        const listener = vi.fn()
-        c.state.subscribe(listener)
-
-        c.dispose()
-
-        c.setActiveTool('fib')
-        c.clearAll()
-        c.deleteLast()
-
-        expect(listener).not.toHaveBeenCalled()
-        // state is frozen at its pre-dispose value
-        expect(c.state()).toEqual({ activeTool: null, drawingCount: 3 })
-    })
-
-    it('is idempotent', () => {
-        const c = createDrawingController()
-        expect(() => {
-            c.dispose()
-            c.dispose()
-            c.dispose()
-        }).not.toThrow()
-    })
-})
+import { describe, it, expect, vi } from 'vitest'
+import { createDrawingController } from '../createDrawingController'
+
+// ---------------------------------------------------------------------------
+// Construction
+// ---------------------------------------------------------------------------
+
+describe('createDrawingController — construction', () => {
+    it('defaults to null activeTool and zero drawingCount', () => {
+        const c = createDrawingController()
+        expect(c.state()).toEqual({ activeTool: null, drawingCount: 0 })
+    })
+
+    it('accepts an initial active tool', () => {
+        const c = createDrawingController({ initialActiveTool: 'trendline' })
+        expect(c.state().activeTool).toBe('trendline')
+        expect(c.state().drawingCount).toBe(0)
+    })
+
+    it('accepts an initial drawing count', () => {
+        const c = createDrawingController({ initialDrawingCount: 5 })
+        expect(c.state().drawingCount).toBe(5)
+    })
+
+    it('floors a negative initial drawing count at 0', () => {
+        const c = createDrawingController({ initialDrawingCount: -3 })
+        expect(c.state().drawingCount).toBe(0)
+    })
+
+    it('accepts both initial values together', () => {
+        const c = createDrawingController({
+            initialActiveTool: 'fib',
+            initialDrawingCount: 2,
+        })
+        expect(c.state()).toEqual({ activeTool: 'fib', drawingCount: 2 })
+    })
+})
+
+// ---------------------------------------------------------------------------
+// setActiveTool
+// ---------------------------------------------------------------------------
+
+describe('setActiveTool', () => {
+    it('round-trips through every drawing tool type', () => {
+        const c = createDrawingController()
+        const types = [
+            'trendline',
+            'horizontal',
+            'fib',
+            'rectangle',
+            'arrow',
+        ] as const
+
+        for (const t of types) {
+            c.setActiveTool(t)
+            expect(c.state().activeTool).toBe(t)
+        }
+    })
+
+    it('can clear the active tool with null', () => {
+        const c = createDrawingController({ initialActiveTool: 'trendline' })
+        c.setActiveTool(null)
+        expect(c.state().activeTool).toBeNull()
+    })
+
+    it('emits exactly one notification per change', () => {
+        const c = createDrawingController()
+        const listener = vi.fn()
+        c.state.subscribe(listener)
+        c.setActiveTool('rectangle')
+        expect(listener).toHaveBeenCalledTimes(1)
+    })
+
+    it('does not emit when the value is unchanged', () => {
+        const c = createDrawingController({ initialActiveTool: 'fib' })
+        const listener = vi.fn()
+        c.state.subscribe(listener)
+        c.setActiveTool('fib')
+        expect(listener).not.toHaveBeenCalled()
+    })
+
+    it('preserves drawingCount when changing tools', () => {
+        const c = createDrawingController({ initialDrawingCount: 4 })
+        c.setActiveTool('arrow')
+        expect(c.state().drawingCount).toBe(4)
+    })
+})
+
+// ---------------------------------------------------------------------------
+// clearAll
+// ---------------------------------------------------------------------------
+
+describe('clearAll', () => {
+    it('resets drawingCount to 0', () => {
+        const c = createDrawingController({ initialDrawingCount: 7 })
+        c.clearAll()
+        expect(c.state().drawingCount).toBe(0)
+    })
+
+    it('preserves activeTool', () => {
+        const c = createDrawingController({
+            initialActiveTool: 'horizontal',
+            initialDrawingCount: 3,
+        })
+        c.clearAll()
+        expect(c.state().activeTool).toBe('horizontal')
+    })
+
+    it('emits one notification when count was non-zero', () => {
+        const c = createDrawingController({ initialDrawingCount: 2 })
+        const listener = vi.fn()
+        c.state.subscribe(listener)
+        c.clearAll()
+        expect(listener).toHaveBeenCalledTimes(1)
+    })
+
+    it('does not emit when count is already 0', () => {
+        const c = createDrawingController()
+        const listener = vi.fn()
+        c.state.subscribe(listener)
+        c.clearAll()
+        expect(listener).not.toHaveBeenCalled()
+    })
+})
+
+// ---------------------------------------------------------------------------
+// deleteLast
+// ---------------------------------------------------------------------------
+
+describe('deleteLast', () => {
+    it('decrements drawingCount by 1', () => {
+        const c = createDrawingController({ initialDrawingCount: 3 })
+        c.deleteLast()
+        expect(c.state().drawingCount).toBe(2)
+    })
+
+    it('floors at 0 — no-op when count is 0', () => {
+        const c = createDrawingController()
+        const listener = vi.fn()
+        c.state.subscribe(listener)
+        c.deleteLast()
+        expect(c.state().drawingCount).toBe(0)
+        expect(listener).not.toHaveBeenCalled()
+    })
+
+    it('emits one notification per successful decrement', () => {
+        const c = createDrawingController({ initialDrawingCount: 2 })
+        const listener = vi.fn()
+        c.state.subscribe(listener)
+        c.deleteLast()
+        c.deleteLast()
+        expect(listener).toHaveBeenCalledTimes(2)
+        expect(c.state().drawingCount).toBe(0)
+        // third call is a no-op (floor)
+        c.deleteLast()
+        expect(listener).toHaveBeenCalledTimes(2)
+    })
+
+    it('preserves activeTool when decrementing', () => {
+        const c = createDrawingController({
+            initialActiveTool: 'rectangle',
+            initialDrawingCount: 2,
+        })
+        c.deleteLast()
+        expect(c.state().activeTool).toBe('rectangle')
+    })
+})
+
+// ---------------------------------------------------------------------------
+// Immutability
+// ---------------------------------------------------------------------------
+
+describe('immutability', () => {
+    it('produces a new state object on every successful mutation', () => {
+        const c = createDrawingController({ initialDrawingCount: 1 })
+        const before = c.state()
+        c.setActiveTool('arrow')
+        const after = c.state()
+        expect(after).not.toBe(before)
+        // the original snapshot must not have been mutated
+        expect(before.activeTool).toBeNull()
+    })
+})
+
+// ---------------------------------------------------------------------------
+// dispose
+// ---------------------------------------------------------------------------
+
+describe('dispose', () => {
+    it('silences subsequent mutators for previously-attached subscribers', () => {
+        const c = createDrawingController({ initialDrawingCount: 3 })
+        const listener = vi.fn()
+        c.state.subscribe(listener)
+
+        c.dispose()
+
+        c.setActiveTool('fib')
+        c.clearAll()
+        c.deleteLast()
+
+        expect(listener).not.toHaveBeenCalled()
+        // state is frozen at its pre-dispose value
+        expect(c.state()).toEqual({ activeTool: null, drawingCount: 3 })
+    })
+
+    it('is idempotent', () => {
+        const c = createDrawingController()
+        expect(() => {
+            c.dispose()
+            c.dispose()
+            c.dispose()
+        }).not.toThrow()
+    })
+})