@363045841yyt/klinechart-core 0.7.3

package/dist/controllers/types.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Framework-agnostic controller interfaces.
+ *
+ * Every adapter (React, Vue, Angular) consumes these. Controllers expose state as
+ * `Signal<T>` so adapters bridge with their own reactivity (useSyncExternalStore,
+ * shallowRef, toSignal).
+ *
+ * Mutation methods are imperative — adapters call them in event handlers.
+ */
+import type { Signal } from '../reactivity';
+import type { CustomMarkerEntity } from '../engine/marker/registry';
+export interface ChartViewport {
+    zoomLevel: number;
+    plotWidth: number;
+    plotHeight: number;
+    dpr: number;
+    visibleFrom: number;
+    visibleTo: number;
+    desiredScrollLeft: number | undefined;
+    kWidth: number;
+    kGap: number;
+}
+export type IndicatorRole = 'main' | 'sub';
+export interface IndicatorInstance {
+    id: string;
+    definitionId: string;
+    label: string;
+    name: string;
+    role: IndicatorRole;
+    paneId?: string;
+    params: Record<string, unknown>;
+}
+export interface SubPaneInfo {
+    paneId: string;
+    indicatorId: string;
+    params: Record<string, unknown>;
+    ratio: number;
+}
+export type DrawingToolType = 'trendline' | 'horizontal' | 'fib' | 'rectangle' | 'arrow';
+export interface DrawingObject {
+    id: string;
+    type: DrawingToolType;
+}
+export type IndicatorPaneRole = IndicatorRole;
+export interface KLineData {
+    timestamp: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume?: number;
+    turnover?: number;
+    stockCode?: string;
+    amplitude?: number;
+    changePercent?: number;
+    changeAmount?: number;
+    turnoverRate?: number;
+}
+export interface IndicatorParamDef {
+    key: string;
+    label: string;
+    type: 'number' | 'string' | 'boolean' | 'color' | 'select';
+    default: number | string | boolean;
+    min?: number;
+    max?: number;
+    step?: number;
+    options?: ReadonlyArray<{
+        value: string;
+        label: string;
+    }>;
+}
+export interface IndicatorDefinition {
+    id: string;
+    label: string;
+    name?: string;
+    description?: string;
+    role: IndicatorPaneRole;
+    params: ReadonlyArray<IndicatorParamDef>;
+}
+export interface InteractionSnapshot {
+    crosshairPos: {
+        x: number;
+        y: number;
+    } | null;
+    crosshairIndex: number | null;
+    crosshairPrice: number | null;
+    hoveredIndex: number | null;
+    activePaneId: string | null;
+    tooltipPos: {
+        x: number;
+        y: number;
+    };
+    tooltipAnchorPlacement: 'right-bottom' | 'left-bottom';
+    hoveredMarkerData: Record<string, unknown> | null;
+    hoveredCustomMarker: Record<string, unknown> | null;
+    isDragging: boolean;
+    isResizingPaneBoundary: boolean;
+    isHoveringPaneBoundary: boolean;
+    hoveredPaneBoundaryId: string | null;
+    isHoveringRightAxis: boolean;
+}
+export interface DrawingControllerCallbacks {
+    onPointerDown?: (e: PointerEvent, container: HTMLElement) => boolean;
+    onPointerMove?: (e: PointerEvent, container: HTMLElement) => boolean;
+    onPointerUp?: (e: PointerEvent, container: HTMLElement) => boolean;
+}
+export interface ChartMountOptions {
+    container: HTMLElement;
+    data: ReadonlyArray<KLineData>;
+    initialZoomLevel?: number;
+    zoomLevels?: number;
+    theme?: 'light' | 'dark';
+}
+export interface ChartController {
+    readonly viewport: Signal<ChartViewport>;
+    readonly data: Signal<ReadonlyArray<KLineData>>;
+    readonly theme: Signal<'light' | 'dark'>;
+    readonly indicators: Signal<ReadonlyArray<IndicatorInstance>>;
+    readonly subPanes: Signal<ReadonlyArray<SubPaneInfo>>;
+    readonly drawingTool: Signal<DrawingToolType | null>;
+    readonly drawings: Signal<ReadonlyArray<DrawingObject>>;
+    readonly paneRatios: Signal<Readonly<Record<string, number>>>;
+    readonly interactionState: Signal<InteractionSnapshot>;
+    readonly catalog: ReadonlyArray<IndicatorDefinition>;
+    setData(next: ReadonlyArray<KLineData>): void;
+    appendData(next: ReadonlyArray<KLineData>): void;
+    updateData(next: ReadonlyArray<KLineData>): void;
+    setTheme(theme: 'light' | 'dark'): void;
+    zoomToLevel(level: number, anchorX?: number): void;
+    zoomIn(anchorX?: number): void;
+    zoomOut(anchorX?: number): void;
+    handlePointerEvent(e: PointerEvent, drawingController?: DrawingControllerCallbacks): boolean;
+    handleWheelEvent(e: WheelEvent): void;
+    handleScrollEvent(): void;
+    handlePinchZoom(delta: number, centerClientX: number): void;
+    addIndicator(definitionId: string, role: 'main' | 'sub', params?: Record<string, unknown>): string | null;
+    removeIndicator(instanceId: string): boolean;
+    updateIndicatorParams(instanceId: string, params: Record<string, unknown>): boolean;
+    updateRendererConfig(name: string, config: Record<string, unknown>): void;
+    setDrawingTool(tool: DrawingToolType | null): void;
+    clearDrawings(): void;
+    removeDrawing(drawingId: string): void;
+    resizeSubPane(paneId: string, deltaY: number): boolean;
+    createSubPane(paneId: string, indicatorId: string, params?: Record<string, unknown>): boolean;
+    clearSubPanes(): void;
+    updateCustomMarkers(markers: ReadonlyArray<CustomMarkerEntity>): void;
+    clearCustomMarkers(): void;
+    updateSettingsFacade(settings: Record<string, unknown>): void;
+    updateOptionsFacade(options: Record<string, unknown>): void;
+    /** tear down DOM + listeners; idempotent */
+    dispose(): void;
+}
+/**
+ * Factory contract — adapters call this on mount.
+ *
+ * Implementation lives in packages/core/src/controllers/createChartController.ts
+ * (Phase 1 deliverable). It wires the existing Chart engine in src/core/chart.ts.
+ */
+export type ChartControllerFactory = (opts: ChartMountOptions) => ChartController;
+/** @deprecated Use `IndicatorInstance` instead. Kept for createIndicatorSelectorController tests. */
+export interface ActiveIndicator {
+    id: string;
+    definitionId: string;
+    label: string;
+    name: string;
+    role: IndicatorPaneRole;
+    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>>;
+    readonly menuOpen: Signal<boolean>;
+    readonly searchQuery: Signal<string>;
+    readonly filteredMain: Signal<ReadonlyArray<IndicatorDefinition>>;
+    readonly filteredSub: Signal<ReadonlyArray<IndicatorDefinition>>;
+    add(definitionId: string): string | null;
+    remove(instanceId: string): boolean;
+    updateParams(instanceId: string, params: Record<string, number | string | boolean>): boolean;
+    reorder(fromInstanceId: string, toInstanceId: string): boolean;
+    openMenu(): void;
+    closeMenu(): void;
+    toggleMenu(): void;
+    setSearchQuery(q: string): void;
+    isActive(definitionId: string): boolean;
+    dispose(): void;
+}
+export type ToolId = string;
+export interface ToolDefinition {
+    id: ToolId;
+    label: string;
+    icon?: string;
+    group?: string;
+    disabled?: boolean;
+}
+/** @deprecated Flattened into ChartController. Kept for createToolbarController tests. */
+export interface ToolbarController {
+    readonly tools: Signal<ReadonlyArray<ToolDefinition>>;
+    readonly activeTool: Signal<ToolId | null>;
+    readonly disabledTools: Signal<ReadonlySet<ToolId>>;
+    selectTool(id: ToolId): void;
+    clearSelection(): void;
+    setDisabled(id: ToolId, disabled: boolean): void;
+    dispose(): void;
+}
+export interface DrawingState {
+    readonly activeTool: DrawingToolType | null;
+    readonly drawingCount: number;
+}
+/** @deprecated Flattened into ChartController. Kept for createDrawingController tests. */
+export interface DrawingController {
+    readonly state: Signal<DrawingState>;
+    setActiveTool(tool: DrawingToolType | null): void;
+    clearAll(): void;
+    deleteLast(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/controllers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/controllers/types.ts"],"names":[],"mappings":"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"}

package/dist/controllers/types.js

@@ -0,0 +1,11 @@
+/**
+ * Framework-agnostic controller interfaces.
+ *
+ * Every adapter (React, Vue, Angular) consumes these. Controllers expose state as
+ * `Signal<T>` so adapters bridge with their own reactivity (useSyncExternalStore,
+ * shallowRef, toSignal).
+ *
+ * Mutation methods are imperative — adapters call them in event handlers.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/controllers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/controllers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/engine/chart-store.d.ts

@@ -0,0 +1,75 @@
+import { type UnwrapNestedRefs } from 'vue';
+import type { DrawingObject } from '../plugin';
+/** 右侧空白绘制槽位数（逻辑 bar 数） */
+export declare const TRAILING_DRAWING_SLOTS = 24;
+export interface ChartStoreOptions {
+    initialZoomLevel: number;
+    minKWidth: number;
+    maxKWidth: number;
+    zoomLevels: number;
+    rightAxisWidth: number;
+    priceLabelWidth: number;
+}
+export declare function computeContentWidth(params: {
+    dataLength: number;
+    kWidth: number;
+    kGap: number;
+    viewWidth: number;
+    viewportDpr: number;
+}): number;
+export declare function createChartStore(opts: ChartStoreOptions): {
+    state: UnwrapNestedRefs<{
+        zoomLevel: number;
+        kWidth: number;
+        kGap: number;
+        viewportDpr: number;
+        dataLength: number;
+        dataVersion: number;
+        paneRatios: Record<string, number>;
+        drawings: {
+            id: string;
+            kind: import("./drawing").DrawingKind;
+            paneId: string;
+            visible: boolean;
+            locked?: boolean | undefined;
+            zIndex?: number | undefined;
+            anchors: {
+                id: string;
+                index: number;
+                time?: number | string | undefined;
+                price: number;
+            }[];
+            params: Record<string, unknown>;
+            style: {
+                stroke?: string | undefined;
+                strokeWidth?: number | undefined;
+                strokeStyle?: "solid" | "dashed" | "dotted" | undefined;
+                fill?: string | undefined;
+                fillOpacity?: number | undefined;
+                pointRadius?: number | undefined;
+                textColor?: string | undefined;
+                fontSize?: number | undefined;
+            };
+        }[];
+        selectedDrawingId: string | null;
+        drawingVersion: number;
+        viewWidth: number;
+    }>;
+    computed: {
+        axisHostWidth: import("vue").ComputedRef<number>;
+        totalWidth: import("vue").ComputedRef<number>;
+    };
+    actions: {
+        bumpDataVersion: () => void;
+        bumpDrawingVersion: () => void;
+        setDataLength: (length: number) => void;
+        setViewportDpr: (dpr: number) => void;
+        setViewWidth: (width: number) => void;
+        setZoomState: (level: number, newKWidth: number, newKGap: number) => void;
+        setPaneRatios: (ratios: Record<string, number>) => void;
+        setDrawings: (newDrawings: DrawingObject[]) => void;
+        setSelectedDrawingId: (id: string | null) => void;
+    };
+};
+export type ChartStore = ReturnType<typeof createChartStore>;
+//# sourceMappingURL=chart-store.d.ts.map

package/dist/engine/chart-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-store.d.ts","sourceRoot":"","sources":["../../src/engine/chart-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAE9C,0BAA0B;AAC1B,eAAO,MAAM,sBAAsB,KAAK,CAAA;AAExC,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;CACpB,GAAG,MAAM,CAMT;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB;WAuEpC,gBAAgB;;;;;;;oBA/Dd,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;2BAEb,MAAM,GAAG,IAAI;;;MA6DM;;;;;;;;gCAnCjB,MAAM;8BAIR,MAAM;8BAIN,MAAM;8BAIN,MAAM,aAAa,MAAM,WAAW,MAAM;gCAMxC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;mCAInB,aAAa,EAAE;mCAQf,MAAM,GAAG,IAAI;;EAsBhD;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAA"}

package/dist/engine/chart-store.js

@@ -0,0 +1,88 @@
+import { reactive, computed } from 'vue';
+import { getPhysicalKLineConfig } from './utils/klineConfig';
+/** 右侧空白绘制槽位数（逻辑 bar 数） */
+export const TRAILING_DRAWING_SLOTS = 24;
+export function computeContentWidth(params) {
+    const { dataLength, kWidth, kGap, viewWidth, viewportDpr } = params;
+    if (dataLength === 0)
+        return 0;
+    const { startXPx, unitPx } = getPhysicalKLineConfig(kWidth, kGap, viewportDpr);
+    const dataPlotWidth = (startXPx + (dataLength + TRAILING_DRAWING_SLOTS) * unitPx) / viewportDpr;
+    return Math.max(dataPlotWidth, viewWidth);
+}
+export function createChartStore(opts) {
+    const state = reactive({
+        zoomLevel: opts.initialZoomLevel,
+        kWidth: 0,
+        kGap: 1,
+        viewportDpr: 1,
+        dataLength: 0,
+        dataVersion: 0,
+        paneRatios: {},
+        drawings: [],
+        selectedDrawingId: null,
+        drawingVersion: 0,
+        viewWidth: 0,
+    });
+    // 右侧轴宽度
+    const axisHostWidth = computed(() => opts.rightAxisWidth + opts.priceLabelWidth);
+    const totalWidth = computed(() => computeContentWidth({
+        dataLength: state.dataLength,
+        kWidth: state.kWidth,
+        kGap: state.kGap,
+        viewWidth: state.viewWidth,
+        viewportDpr: state.viewportDpr,
+    }));
+    function bumpDataVersion() {
+        state.dataVersion++;
+    }
+    function bumpDrawingVersion() {
+        state.drawingVersion++;
+    }
+    function setDataLength(length) {
+        state.dataLength = length;
+    }
+    function setViewportDpr(dpr) {
+        state.viewportDpr = dpr;
+    }
+    function setViewWidth(width) {
+        state.viewWidth = width;
+    }
+    function setZoomState(level, newKWidth, newKGap) {
+        state.zoomLevel = level;
+        state.kWidth = newKWidth;
+        state.kGap = newKGap;
+    }
+    function setPaneRatios(ratios) {
+        state.paneRatios = ratios;
+    }
+    function setDrawings(newDrawings) {
+        state.drawings = newDrawings;
+        if (state.selectedDrawingId && !newDrawings.some((d) => d.id === state.selectedDrawingId)) {
+            state.selectedDrawingId = null;
+        }
+        state.drawingVersion++;
+    }
+    function setSelectedDrawingId(id) {
+        state.selectedDrawingId = id;
+    }
+    return {
+        state: state,
+        computed: {
+            axisHostWidth,
+            totalWidth,
+        },
+        actions: {
+            bumpDataVersion,
+            bumpDrawingVersion,
+            setDataLength,
+            setViewportDpr,
+            setViewWidth,
+            setZoomState,
+            setPaneRatios,
+            setDrawings,
+            setSelectedDrawingId,
+        },
+    };
+}
+//# sourceMappingURL=chart-store.js.map

package/dist/engine/chart-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-store.js","sourceRoot":"","sources":["../../src/engine/chart-store.ts"],"names":[],"mappings":"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"}