@363045841yyt/klinechart-core 0.7.5 → 0.7.6

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/semantic/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,aAAa,EACb,YAAY,EACZ,eAAe,EACf,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,uBAAuB,EAAE,KAAK,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAChG,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEnH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/semantic/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,aAAa,EACb,YAAY,EACZ,eAAe,EACf,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,uBAAuB,EAAE,KAAK,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAChG,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAErE,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEnH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.7.5";
+export declare const VERSION = "0.7.6";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "0.7.5";
+export const VERSION = "0.7.6";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@363045841yyt/klinechart-core",
-  "version": "0.7.5",
+  "version": "0.7.6",
   "description": "Headless K-line chart engine + reactive controllers. Zero framework dependencies.",
   "license": "MIT",
   "repository": {
@@ -47,10 +47,6 @@
       "types": "./dist/engine/chart.d.ts",
       "import": "./dist/engine/chart.js"
     },
-    "./engine/chart-store": {
-      "types": "./dist/engine/chart-store.d.ts",
-      "import": "./dist/engine/chart-store.js"
-    },
     "./engine/utils/zoom": {
       "types": "./dist/engine/utils/zoom.d.ts",
       "import": "./dist/engine/utils/zoom.js"
@@ -79,6 +75,10 @@
       "types": "./dist/engine/controller/interaction.d.ts",
       "import": "./dist/engine/controller/interaction.js"
     },
+    "./engine/marker/registry": {
+      "types": "./dist/engine/marker/registry.d.ts",
+      "import": "./dist/engine/marker/registry.js"
+    },
     "./engine/drawing": {
       "types": "./dist/engine/drawing/index.d.ts",
       "import": "./dist/engine/drawing/index.js"
@@ -126,4 +126,4 @@
     "vite-plugin-babel": "^1.3.2",
     "vitest": "^4.1.5"
   }
-}
+}

package/src/controllers/createChartController.ts

@@ -25,12 +25,13 @@ import type {
     DrawingControllerCallbacks,
     IndicatorDefinition,
     KLineData,
+    PaneInfo,
+    PaneSpec,
 } from './types'
 import type { CustomMarkerEntity } from '../engine/marker/registry'
 import {
     Chart,
     type ChartOptions,
-    type Viewport as LegacyViewport,
     type ViewportState as LegacyViewportState,
     type IndicatorInstance as LegacyIndicatorInstance,
     type SubPaneInfo as LegacySubPaneInfo,
@@ -185,14 +186,13 @@ function mapPaneRatios(ratios: Readonly<Record<string, number>>): Readonly<Recor
     return { ...ratios }
 }
 
-function mapInteractionRecord(
-    value: Record<string, any> | null | undefined,
-): Record<string, unknown> | null {
+function mapInteractionRecord<T>(
+    value: T | null | undefined,
+): T | null {
     if (!value) {
         return null
     }
-
-    return { ...value }
+    return { ...value } as T
 }
 
 function mapInteractionSnapshot(snapshot: LegacyInteractionSnapshot): InteractionSnapshot {
@@ -287,17 +287,27 @@ export function createChartController(opts: ChartMountOptions): ChartController
         throw new Error('[createChartController] opts.container must be a non-null HTMLElement')
     }
 
-    const mounted = buildDom(opts.container)
+    const hasExistingDom = !!(opts.canvasLayer && opts.rightAxisLayer && opts.xAxisCanvas)
+    const mounted = hasExistingDom
+        ? {
+            container: opts.container as HTMLDivElement,
+            canvasLayer: opts.canvasLayer as HTMLDivElement,
+            rightAxisLayer: opts.rightAxisLayer as HTMLDivElement,
+            xAxisCanvas: opts.xAxisCanvas!,
+            cleanup: () => { /* DOM owned by caller */ },
+        }
+        : buildDom(opts.container)
+
     const initialZoomLevel = opts.initialZoomLevel ?? DEFAULT_OPTS.initialZoomLevel
     const zoomLevelCount = opts.zoomLevels ?? DEFAULT_OPTS.zoomLevels
 
     const chartOptions: ChartOptions = {
-        yPaddingPx: DEFAULT_OPTS.yPaddingPx,
-        rightAxisWidth: DEFAULT_OPTS.rightAxisWidth,
-        bottomAxisHeight: DEFAULT_OPTS.bottomAxisHeight,
-        minKWidth: DEFAULT_OPTS.minKWidth,
-        maxKWidth: DEFAULT_OPTS.maxKWidth,
-        priceLabelWidth: DEFAULT_OPTS.priceLabelWidth,
+        yPaddingPx: opts.yPaddingPx ?? DEFAULT_OPTS.yPaddingPx,
+        rightAxisWidth: opts.rightAxisWidth ?? DEFAULT_OPTS.rightAxisWidth,
+        bottomAxisHeight: opts.bottomAxisHeight ?? DEFAULT_OPTS.bottomAxisHeight,
+        minKWidth: opts.minKWidth ?? DEFAULT_OPTS.minKWidth,
+        maxKWidth: opts.maxKWidth ?? DEFAULT_OPTS.maxKWidth,
+        priceLabelWidth: opts.priceLabelWidth ?? DEFAULT_OPTS.priceLabelWidth,
         panes: [{ id: 'main', ratio: 1 }],
         paneGap: 0,
         zoomLevels: zoomLevelCount,
@@ -433,6 +443,12 @@ export function createChartController(opts: ChartMountOptions): ChartController
         chart.paneRatios.subscribe(() => paneRatios.set(mapPaneRatios(chart.paneRatios.peek()))),
     )
 
+    // paneLayout
+    const paneLayout: Signal<ReadonlyArray<PaneSpec>> = createSignal<ReadonlyArray<PaneSpec>>([])
+    unsubs.push(
+        chart.paneLayout.subscribe(() => paneLayout.set([...chart.paneLayout.peek()])),
+    )
+
     // interactionState
     unsubs.push(
         chart.interactionState.subscribe(() =>
@@ -440,21 +456,6 @@ export function createChartController(opts: ChartMountOptions): ChartController
         ),
     )
 
-    // -------------------------------------------------------------------
-    // Legacy callback for resize (chart's viewport signal doesn't fire
-    // on resize — only on zoom/scroll through facade methods)
-    // -------------------------------------------------------------------
-
-    chart.setOnViewportChange((vp: LegacyViewport) => {
-        const current = viewport.peek()
-        viewport.set({
-            ...current,
-            plotWidth: vp.plotWidth,
-            plotHeight: vp.plotHeight,
-            dpr: vp.dpr > 0 ? vp.dpr : current.dpr,
-        })
-    })
-
     // -------------------------------------------------------------------
     // Lifecycle guard
     // -------------------------------------------------------------------
@@ -481,6 +482,16 @@ export function createChartController(opts: ChartMountOptions): ChartController
         setData(merged)
     }
 
+    function getData(): ReadonlyArray<KLineData> {
+        if (disposed) return []
+        return chart.getData()
+    }
+
+    function getZoomLevelCount(): number {
+        if (disposed) return 0
+        return chart.getZoomLevelCount()
+    }
+
     function setTheme(nextTheme: 'light' | 'dark'): void {
         if (disposed) return
         chart.setTheme(nextTheme)
@@ -551,6 +562,28 @@ export function createChartController(opts: ChartMountOptions): ChartController
         chart.updateRendererConfig(name, config)
     }
 
+    function setTooltipSize(size: { width: number; height: number }): void {
+        if (disposed) return
+        chart.interaction.setTooltipSize(size)
+    }
+
+    function setTooltipAnchorPositioning(enabled: boolean): void {
+        if (disposed) return
+        chart.interaction.setTooltipAnchorPositioning(enabled)
+    }
+
+    function getContentWidth(): number {
+        if (disposed) return 0
+        return chart.getContentWidth()
+    }
+
+    function getIndicatorTitle(instanceId: string): string | undefined {
+        if (disposed) return undefined
+        const instances = chart.indicators.peek()
+        const match = instances.find(inst => inst.id === instanceId)
+        return match?.label
+    }
+
     function setDrawingTool(tool: DrawingToolType | null): void {
         if (disposed) return
         chart.setDrawingTool(tool)
@@ -566,6 +599,65 @@ export function createChartController(opts: ChartMountOptions): ChartController
         chart.removeDrawing(drawingId)
     }
 
+    // ---- DrawingChartAdapter methods ----
+
+    function setDrawings(drawings: any[]): void {
+        if (disposed) return
+        chart.setDrawings(drawings)
+    }
+
+    function setSelectedDrawingId(id: string | null): void {
+        if (disposed) return
+        chart.setSelectedDrawingId(id)
+    }
+
+    function getViewport(): { scrollLeft: number; plotWidth: number; plotHeight: number } | null {
+        if (disposed) return null
+        const vp = chart.getViewport()
+        return vp
+    }
+
+    function getKWidthKGap(): { kWidth: number; kGap: number } {
+        if (disposed) return { kWidth: 0, kGap: 0 }
+        const opt = chart.getOption()
+        return { kWidth: opt.kWidth, kGap: opt.kGap }
+    }
+
+    function getCurrentDpr(): number {
+        if (disposed) return 1
+        return chart.getCurrentDpr()
+    }
+
+    function getLogicalIndexAtX(mouseX: number): number | null {
+        if (disposed) return null
+        return chart.getLogicalIndexAtX(mouseX)
+    }
+
+    function getTimestampAtLogicalIndex(index: number): number | null {
+        if (disposed) return null
+        return chart.getTimestampAtLogicalIndex(index)
+    }
+
+    function priceToY(paneId: string, price: number): number {
+        if (disposed) return 0
+        const renderer = chart.getPaneRenderers().find(item => item.getPane().id === paneId)
+        return renderer?.getPane().yAxis.priceToY(price) ?? 0
+    }
+
+    function yToPrice(paneId: string, y: number): number {
+        if (disposed) return 0
+        const renderer = chart.getPaneRenderers().find(item => item.getPane().id === paneId)
+        return renderer?.getPane().yAxis.yToPrice(y) ?? 0
+    }
+
+    function getPaneInfo(paneId: string): PaneInfo | undefined {
+        if (disposed) return undefined
+        const renderer = chart.getPaneRenderers().find(item => item.getPane().id === paneId)
+        const pane = renderer?.getPane()
+        if (!pane) return undefined
+        return { paneId: pane.id, top: pane.top, height: pane.height }
+    }
+
     function createSubPane(paneId: string, indicatorId: string, params?: Record<string, unknown>): boolean {
         if (disposed) return false
         return chart.createSubPane(paneId, indicatorId as never, params as Record<string, string | number | boolean> | undefined)
@@ -576,6 +668,25 @@ export function createChartController(opts: ChartMountOptions): ChartController
         chart.clearSubPanes()
     }
 
+    function replaceSubPaneIndicator(
+        paneId: string,
+        indicatorId: string,
+        params?: Record<string, unknown>,
+    ): boolean {
+        if (disposed) return false
+        try {
+            chart.replaceSubPaneIndicator(paneId, indicatorId as never, params as Record<string, string | number | boolean>)
+            return true
+        } catch {
+            return false
+        }
+    }
+
+    function updatePaneLayout(panes: PaneSpec[]): void {
+        if (disposed) return
+        chart.updatePaneLayout(panes)
+    }
+
     function resizeSubPane(paneId: string, deltaY: number): boolean {
         if (disposed) return false
         return chart.resizeSubPane(paneId, deltaY)
@@ -604,7 +715,6 @@ export function createChartController(opts: ChartMountOptions): ChartController
     function dispose(): void {
         if (disposed) return
         disposed = true
-        // Unsubscribe all signal bridges first
         for (const unsub of unsubs) {
             try {
                 unsub()
@@ -633,11 +743,14 @@ export function createChartController(opts: ChartMountOptions): ChartController
         drawingTool,
         drawings,
         paneRatios,
+        paneLayout,
         interactionState,
         catalog: DEFAULT_INDICATOR_CATALOG,
         setData,
         appendData,
         updateData: setData,
+        getData,
+        getZoomLevelCount,
         setTheme,
         zoomToLevel,
         zoomIn,
@@ -650,11 +763,27 @@ export function createChartController(opts: ChartMountOptions): ChartController
         removeIndicator,
         updateIndicatorParams,
         updateRendererConfig,
+        setTooltipSize,
+        setTooltipAnchorPositioning,
+        getIndicatorTitle,
+        getContentWidth,
         setDrawingTool,
         clearDrawings,
         removeDrawing,
+        setDrawings,
+        setSelectedDrawingId,
+        getViewport,
+        getKWidthKGap,
+        getCurrentDpr,
+        getLogicalIndexAtX,
+        getTimestampAtLogicalIndex,
+        priceToY,
+        yToPrice,
+        getPaneInfo,
         createSubPane,
         clearSubPanes,
+        replaceSubPaneIndicator,
+        updatePaneLayout,
         resizeSubPane,
         updateCustomMarkers,
         clearCustomMarkers,

package/src/controllers/index.ts

@@ -1,3 +1,4 @@
+// -- Controller types (framework-agnostic) --
 export type {
     KLineData,
     IndicatorPaneRole,
@@ -14,7 +15,39 @@ export type {
     ChartViewport,
     ChartController,
     ChartControllerFactory,
+    PaneSpec,
+    DrawingChartAdapter,
+    DrawingChartViewport,
+    PaneInfo,
 } from './types'
 
 export { createChartController } from './createChartController'
 export { createIndicatorSelectorController } from './createIndicatorSelectorController'
+
+// -- Engine sub-path re-exports (Phase 9: facade for Vue adapter) --
+
+// Utility functions
+export {
+    zoomLevelToKWidth,
+    kGapFromKWidth,
+} from '../engine/utils/zoom'
+export { getPhysicalKLineConfig } from '../engine/utils/klineConfig'
+
+// Indicator types & config
+export type { SubIndicatorType } from '../engine/renderers/Indicator'
+export {
+    SUB_PANE_INDICATOR_CONFIGS,
+    SUB_PANE_INDICATORS,
+} from '../engine/renderers/Indicator/subPaneConfig'
+
+// Indicator data helpers
+export {
+    allIndicators,
+    findIndicator,
+    isSubIndicatorId,
+} from '../engine/renderers/Indicator/indicatorData'
+export type { Indicator } from '../engine/renderers/Indicator/indicatorData'
+
+// Drawing
+export { DrawingInteractionController } from '../engine/drawing'
+export type { DrawingToolId } from '../engine/drawing'

package/src/controllers/types.ts

@@ -9,7 +9,8 @@
  */
 
 import type { Signal } from '../reactivity'
-import type { CustomMarkerEntity } from '../engine/marker/registry'
+import type { CustomMarkerEntity, MarkerEntity } from '../engine/marker/registry'
+import type { PaneSpec } from '../engine/chart'
 
 // Controller-owned public surface. Legacy engine types may mirror these
 // shapes internally, but adapters depend only on core-defined contracts.
@@ -73,6 +74,8 @@ export interface KLineData {
     turnoverRate?: number
 }
 
+export type { PaneSpec }
+
 // ---------------------------------------------------------------------------
 // Indicator metadata
 // ---------------------------------------------------------------------------
@@ -109,8 +112,8 @@ export interface InteractionSnapshot {
     activePaneId: string | null
     tooltipPos: { x: number; y: number }
     tooltipAnchorPlacement: 'right-bottom' | 'left-bottom'
-    hoveredMarkerData: Record<string, unknown> | null
-    hoveredCustomMarker: Record<string, unknown> | null
+    hoveredMarkerData: MarkerEntity | null
+    hoveredCustomMarker: CustomMarkerEntity | null
     isDragging: boolean
     isResizingPaneBoundary: boolean
     isHoveringPaneBoundary: boolean
@@ -118,6 +121,51 @@ export interface InteractionSnapshot {
     isHoveringRightAxis: boolean
 }
 
+// ---------------------------------------------------------------------------
+// Pane info (read-only pane metadata for DrawingChartAdapter)
+// ---------------------------------------------------------------------------
+
+export interface PaneInfo {
+    paneId: string
+    top: number
+    height: number
+}
+
+// ---------------------------------------------------------------------------
+// Drawing adapter — narrow interface for DrawingInteractionController
+// ---------------------------------------------------------------------------
+
+export interface DrawingChartViewport {
+    scrollLeft: number
+    plotWidth: number
+    plotHeight: number
+}
+
+export interface DrawingChartAdapter {
+    /** persist full drawing list to the chart engine */
+    setDrawings(drawings: any[]): void
+    /** highlight a drawing by ID */
+    setSelectedDrawingId(id: string | null): void
+    /** current viewport (nullable if chart not ready) */
+    getViewport(): DrawingChartViewport | null
+    /** resolved chart options (kWidth, kGap) */
+    getKWidthKGap(): { kWidth: number; kGap: number }
+    /** device pixel ratio */
+    getCurrentDpr(): number
+    /** raw K-line data */
+    getData(): ReadonlyArray<KLineData>
+    /** screen-x → logical bar index */
+    getLogicalIndexAtX(mouseX: number): number | null
+    /** logical index → unix timestamp (ms) */
+    getTimestampAtLogicalIndex(index: number): number | null
+    /** price → Y within the given pane */
+    priceToY(paneId: string, price: number): number
+    /** Y within the given pane → price */
+    yToPrice(paneId: string, y: number): number
+    /** read-only pane metadata by pane ID */
+    getPaneInfo(paneId: string): PaneInfo | undefined
+}
+
 // ---------------------------------------------------------------------------
 // Drawing controller callback type (passed to handlePointerEvent)
 // ---------------------------------------------------------------------------
@@ -138,9 +186,22 @@ export interface ChartMountOptions {
     initialZoomLevel?: number
     zoomLevels?: number
     theme?: 'light' | 'dark'
+
+    // Pre-existing DOM elements (skip buildDom when provided)
+    canvasLayer?: HTMLElement
+    rightAxisLayer?: HTMLElement
+    xAxisCanvas?: HTMLCanvasElement
+
+    // Chart options overrides
+    yPaddingPx?: number
+    rightAxisWidth?: number
+    bottomAxisHeight?: number
+    priceLabelWidth?: number
+    minKWidth?: number
+    maxKWidth?: number
 }
 
-export interface ChartController {
+export interface ChartController extends DrawingChartAdapter {
     // ---- Signals ----
     readonly viewport: Signal<ChartViewport>
     readonly data: Signal<ReadonlyArray<KLineData>>
@@ -150,6 +211,7 @@ export interface ChartController {
     readonly drawingTool: Signal<DrawingToolType | null>
     readonly drawings: Signal<ReadonlyArray<DrawingObject>>
     readonly paneRatios: Signal<Readonly<Record<string, number>>>
+    readonly paneLayout: Signal<ReadonlyArray<PaneSpec>>
     readonly interactionState: Signal<InteractionSnapshot>
 
     // indicator catalog (static — adapters use for picker UI)
@@ -159,6 +221,8 @@ export interface ChartController {
     setData(next: ReadonlyArray<KLineData>): void
     appendData(next: ReadonlyArray<KLineData>): void
     updateData(next: ReadonlyArray<KLineData>): void
+    getData(): ReadonlyArray<KLineData>
+    getZoomLevelCount(): number
 
     // ---- Theme ----
     setTheme(theme: 'light' | 'dark'): void
@@ -193,11 +257,22 @@ export interface ChartController {
     resizeSubPane(paneId: string, deltaY: number): boolean
     createSubPane(paneId: string, indicatorId: string, params?: Record<string, unknown>): boolean
     clearSubPanes(): void
+    replaceSubPaneIndicator(paneId: string, indicatorId: string, params?: Record<string, unknown>): boolean
+    updatePaneLayout(panes: PaneSpec[]): void
 
     // ---- Drawing / Markers ----
     updateCustomMarkers(markers: ReadonlyArray<CustomMarkerEntity>): void
     clearCustomMarkers(): void
 
+    // ---- Interaction sub-methods ----
+    setTooltipSize(size: { width: number; height: number }): void
+    setTooltipAnchorPositioning(enabled: boolean): void
+
+    // ---- Narrow queries ----
+    getIndicatorTitle(instanceId: string): string | undefined
+    /** total scrollable content width (replaces direct computeContentWidth imports) */
+    getContentWidth(): number
+
     // ---- Settings ----
     updateSettingsFacade(settings: Record<string, unknown>): void
     updateOptionsFacade(options: Record<string, unknown>): void
@@ -218,7 +293,6 @@ export type ChartControllerFactory = (opts: ChartMountOptions) => ChartControlle
 // Legacy type aliases (deprecated — kept for internal sub-controller tests)
 // ---------------------------------------------------------------------------
 
-/** @deprecated Use `IndicatorInstance` instead. Kept for createIndicatorSelectorController tests. */
 export interface ActiveIndicator {
     id: string
     definitionId: string
@@ -228,7 +302,6 @@ export interface ActiveIndicator {
     params: Readonly<Record<string, number | string | boolean>>
 }
 
-/** @deprecated Flattened into ChartController. Kept for createIndicatorSelectorController tests. */
 export interface IndicatorSelectorController {
     readonly catalog: Signal<ReadonlyArray<IndicatorDefinition>>
     readonly active: Signal<ReadonlyArray<ActiveIndicator>>
@@ -258,7 +331,6 @@ export interface ToolDefinition {
     disabled?: boolean
 }
 
-/** @deprecated Flattened into ChartController. Kept for createToolbarController tests. */
 export interface ToolbarController {
     readonly tools: Signal<ReadonlyArray<ToolDefinition>>
     readonly activeTool: Signal<ToolId | null>
@@ -274,7 +346,6 @@ export interface DrawingState {
     readonly drawingCount: number
 }
 
-/** @deprecated Flattened into ChartController. Kept for createDrawingController tests. */
 export interface DrawingController {
     readonly state: Signal<DrawingState>
     setActiveTool(tool: DrawingToolType | null): void