@vninvestcharts/widget 0.0.0-stage → 0.2.0

package/dist/dts/lib/core/hooks/useChartTheme.d.ts

@@ -0,0 +1,12 @@
+export type ChartTheme = "modern-light" | "classic-dark" | "trading-night" | "neutral-pro" | "high-contrast";
+export type ThemeMode = "light" | "dark";
+export declare function themeToMode(theme: ChartTheme): ThemeMode;
+export interface UseChartThemeResult {
+    theme: ChartTheme;
+    setTheme: (theme: ChartTheme) => void;
+    cycleTheme: () => void;
+    toggleTheme: () => void;
+    isDark: boolean;
+    resolvedMode: ThemeMode;
+}
+export declare function useChartTheme(defaultTheme?: ChartTheme): UseChartThemeResult;

package/dist/dts/lib/core/hooks/useDynamicPanes.d.ts

@@ -0,0 +1,155 @@
+import { type Dispatch } from "react";
+import type { PaneDescriptor, SeriesConfig, SeriesTypeId, YAxisSide } from "../types/pane-descriptor";
+export interface StoredPaneLayout {
+    version: 1;
+    panes: readonly PaneDescriptor[];
+}
+export interface PaneLayoutStorageLike {
+    getItem: (key: string) => string | null;
+    setItem: (key: string, value: string) => void;
+    removeItem: (key: string) => void;
+}
+export interface UseDynamicPanesOptions {
+    maxVisiblePanes?: number;
+    panesOverride?: readonly PaneDescriptor[];
+    dispatchOverride?: Dispatch<DynamicPaneAction>;
+    /** Per-chart storage namespace (multi-chart cell id). Absent = legacy shared key. */
+    storageScopeId?: string | null;
+}
+/** Scoped pane-layout key: `<base>:<chartId>` in multi, legacy base in single. */
+export declare function scopedPaneLayoutKey(scopeId?: string | null): string;
+export type DynamicPaneAction = {
+    type: "toggleVisible";
+    id: string;
+    maxVisiblePanes?: number;
+} | {
+    type: "addPane";
+    pane: Omit<PaneDescriptor, "id">;
+    maxVisiblePanes?: number;
+} | {
+    type: "removePane";
+    id: string;
+} | {
+    type: "deletePane";
+    id: string;
+} | {
+    type: "renamePane";
+    paneId: string;
+    label: string;
+} | {
+    type: "restorePane";
+    id: string;
+    maxVisiblePanes?: number;
+} | {
+    type: "addSeries";
+    paneId: string;
+    series: SeriesConfig;
+    maxVisiblePanes?: number;
+} | {
+    type: "removeSeries";
+    paneId: string;
+    seriesType: SeriesTypeId;
+    seriesIndex?: number;
+} | {
+    type: "toggleSeriesVisible";
+    paneId: string;
+    seriesType: SeriesTypeId;
+    seriesIndex?: number;
+    maxVisiblePanes?: number;
+} | {
+    type: "updateSeriesParams";
+    paneId: string;
+    seriesType: SeriesTypeId;
+    params: Record<string, unknown>;
+    seriesIndex?: number;
+} | {
+    type: "updateSeriesType";
+    paneId: string;
+    seriesType: SeriesTypeId;
+    seriesIndex?: number;
+} | {
+    type: "updateSeriesYAxis";
+    paneId: string;
+    seriesType: SeriesTypeId;
+    yAxis: YAxisSide;
+    seriesIndex?: number;
+} | {
+    type: "updateSeriesColor";
+    paneId: string;
+    seriesType: SeriesTypeId;
+    color: string;
+    seriesIndex?: number;
+} | {
+    type: "updateSeriesLineWidth";
+    paneId: string;
+    seriesType: SeriesTypeId;
+    lineWidth?: number;
+    seriesIndex?: number;
+} | {
+    type: "updateSeriesSubColor";
+    paneId: string;
+    seriesType: SeriesTypeId;
+    subKey: string;
+    color: string;
+    seriesIndex?: number;
+} | {
+    type: "updateSeriesSource";
+    paneId: string;
+    seriesType: SeriesTypeId;
+    sourceType?: "price" | "indicator";
+    sourceId?: string;
+    sourceKey?: string;
+    seriesIndex?: number;
+} | {
+    type: "applyDelta";
+    splitterIndex: number;
+    deltaY: number;
+    available: number;
+} | {
+    type: "equalizePair";
+    splitterIndex: number;
+    available: number;
+} | {
+    type: "replaceLayout";
+    panes: readonly PaneDescriptor[];
+} | {
+    type: "resetToDefault";
+} | {
+    type: "reorderPanes";
+    fromVisibleIndex: number;
+    toVisibleIndex: number;
+};
+export interface UseDynamicPanesResult {
+    panes: PaneDescriptor[];
+    visiblePanes: PaneDescriptor[];
+    heights: number[];
+    available: number;
+    toggleVisible: (id: string) => void;
+    addPane: (pane: Omit<PaneDescriptor, "id">) => void;
+    removePane: (id: string) => void;
+    deletePane: (id: string) => void;
+    renamePane: (paneId: string, label: string) => void;
+    restorePane: (id: string) => void;
+    addSeries: (paneId: string, series: SeriesConfig) => void;
+    removeSeries: (paneId: string, seriesType: SeriesTypeId, seriesIndex?: number) => void;
+    toggleSeriesVisible: (paneId: string, seriesType: SeriesTypeId, seriesIndex?: number) => void;
+    updateSeriesParams: (paneId: string, seriesType: SeriesTypeId, params: Record<string, unknown>, seriesIndex?: number) => void;
+    updateSeriesType: (paneId: string, seriesType: SeriesTypeId, seriesIndex?: number) => void;
+    updateSeriesYAxis: (paneId: string, seriesType: SeriesTypeId, yAxis: YAxisSide, seriesIndex?: number) => void;
+    updateSeriesColor: (paneId: string, seriesType: SeriesTypeId, color: string, seriesIndex?: number) => void;
+    updateSeriesLineWidth: (paneId: string, seriesType: SeriesTypeId, lineWidth: number | undefined, seriesIndex?: number) => void;
+    updateSeriesSubColor: (paneId: string, seriesType: SeriesTypeId, subKey: string, color: string, seriesIndex?: number) => void;
+    updateSeriesSource: (paneId: string, seriesType: SeriesTypeId, sourceType?: "price" | "indicator", sourceId?: string, sourceKey?: string, seriesIndex?: number) => void;
+    applyDelta: (splitterIndex: number, deltaY: number) => void;
+    equalizePair: (splitterIndex: number) => void;
+    replaceLayout: (panes: readonly PaneDescriptor[]) => void;
+    resetToDefault: () => void;
+    reorderPanes: (fromVisibleIndex: number, toVisibleIndex: number) => void;
+    canAddPane: boolean;
+}
+export declare function normalizeLoadedPaneLayout(panes: readonly PaneDescriptor[]): PaneDescriptor[];
+export declare function dynamicPanesReducer(state: readonly PaneDescriptor[], action: DynamicPaneAction): PaneDescriptor[];
+export declare function createDefaultPaneLayout(): PaneDescriptor[];
+export declare function loadPaneLayout(storage?: PaneLayoutStorageLike, scopeId?: string | null): PaneDescriptor[];
+export declare function savePaneLayout(panes: readonly PaneDescriptor[], storage?: PaneLayoutStorageLike, scopeId?: string | null): void;
+export declare function useDynamicPanes(totalHeight: number, options?: UseDynamicPanesOptions): UseDynamicPanesResult;

package/dist/dts/lib/core/hooks/useIndicatorSets.d.ts

@@ -0,0 +1,20 @@
+import type { IndicatorSet, IndicatorSetStorageLike } from "../types/indicator-set";
+import type { PaneDescriptor } from "../types/pane-descriptor";
+export interface UseIndicatorSetsOptions {
+    currentPanes: readonly PaneDescriptor[];
+    storage?: IndicatorSetStorageLike;
+    onApplyPanes?: (panes: readonly PaneDescriptor[]) => void;
+}
+export interface UseIndicatorSetsResult {
+    sets: IndicatorSet[];
+    builtinSets: readonly IndicatorSet[];
+    userSets: IndicatorSet[];
+    getSetById: (id: string) => IndicatorSet | undefined;
+    saveCurrentAsSet: (name: string) => IndicatorSet | null;
+    applySet: (id: string) => boolean;
+    renameSet: (id: string, name: string) => boolean;
+    deleteSet: (id: string) => boolean;
+    exportSet: (id: string) => boolean;
+    importSet: (file: File) => Promise<IndicatorSet | null>;
+}
+export declare function useIndicatorSets(options: UseIndicatorSetsOptions): UseIndicatorSetsResult;

package/dist/dts/lib/core/hooks/usePaneManager.d.ts

@@ -0,0 +1,39 @@
+import type { IndicatorConfig, PaneConfig } from "../../types/pane";
+export type PaneInput = Omit<PaneConfig, "id"> & {
+    id?: string;
+};
+export interface PaneManagerState {
+    panes: PaneConfig[];
+    addPane: (pane: PaneInput) => string;
+    removePane: (paneId: string) => void;
+    resizePane: (paneId: string, heightPx: number) => void;
+    addIndicator: (paneId: string, indicator: IndicatorConfig) => void;
+    removeIndicator: (paneId: string, indicatorName: string) => void;
+    updateIndicator: (paneId: string, indicatorName: string, patch: Partial<IndicatorConfig>) => void;
+}
+export type PaneManagerAction = {
+    type: "addPane";
+    pane: PaneInput;
+} | {
+    type: "removePane";
+    paneId: string;
+} | {
+    type: "resizePane";
+    paneId: string;
+    heightPx: number;
+} | {
+    type: "addIndicator";
+    paneId: string;
+    indicator: IndicatorConfig;
+} | {
+    type: "removeIndicator";
+    paneId: string;
+    indicatorName: string;
+} | {
+    type: "updateIndicator";
+    paneId: string;
+    indicatorName: string;
+    patch: Partial<IndicatorConfig>;
+};
+export declare function paneManagerReducer(state: PaneConfig[], action: PaneManagerAction): PaneConfig[];
+export declare function usePaneManager(initialPanes?: readonly PaneInput[]): PaneManagerState;

package/dist/dts/lib/core/hooks/usePaneSizes.d.ts

@@ -0,0 +1,52 @@
+/**
+ * usePaneSizes
+ * Generic N-pane height manager for resizable chart panes.
+ *
+ * Heights are tracked as ratios (sum = 1) so they scale with the container.
+ * Ratios are persisted to localStorage when a storageKey is provided.
+ *
+ * @example
+ * const { heights, applyDelta, reset, available } = usePaneSizes(chartHeight, {
+ *   initialRatios: [0.5, 0.27, 0.23],
+ *   minHeights:    [100, 36, 36],
+ *   storageKey:    "my-chart-panes-v1",
+ * });
+ * const [priceH, volumeH, momentumH] = heights;
+ */
+export interface UsePaneSizesOptions {
+    /**
+     * Initial proportional sizes (will be normalised so they sum to 1).
+     * The number of elements determines the pane count.
+     * Defaults to two equal panes [0.5, 0.5].
+     */
+    initialRatios?: number[];
+    /**
+     * Minimum height in pixels for each pane (index matches initialRatios).
+     * Defaults to 40 px for each pane.
+     */
+    minHeights?: number[];
+    /**
+     * localStorage key used to persist layout between sessions.
+     * Omit to disable persistence.
+     */
+    storageKey?: string;
+    /**
+     * Pixels consumed by the ChartCanvas frame (margins top + bottom).
+     * Defaults to 36 (ChartCanvas default: top 8 + bottom 28).
+     */
+    marginV?: number;
+}
+export interface UsePaneSizesResult {
+    /** Pixel height for each pane, ordered top → bottom. */
+    heights: number[];
+    /** Total usable vertical space (totalHeight − marginV), clamped to min sum. */
+    available: number;
+    /**
+     * Commit a drag delta when a ChartSplitter is released.
+     * splitterIndex 0 = between pane[0] and pane[1], 1 = between pane[1] and pane[2], etc.
+     */
+    applyDelta: (splitterIndex: number, deltaY: number, currentAvailable: number) => void;
+    /** Reset all panes to their initial ratios. */
+    reset: () => void;
+}
+export declare function usePaneSizes(totalHeight: number, options?: UsePaneSizesOptions): UsePaneSizesResult;

package/dist/dts/lib/core/index.d.ts

@@ -0,0 +1,41 @@
+export { ChartTerminal } from "./ChartTerminal";
+export { ChartPane } from "./ChartPane";
+export { PaneSplitter } from "./PaneSplitter";
+export { usePaneManager, paneManagerReducer } from "./hooks/usePaneManager";
+export { useCanvasResize } from "./hooks/useCanvasResize";
+export { computeScales } from "./scales/computeScales";
+export { ChartSplitter } from "./ChartSplitter";
+export { usePaneSizes } from "./hooks/usePaneSizes";
+export { useChartTheme, themeToMode } from "./hooks/useChartTheme";
+export { useIndicatorSets } from "./hooks/useIndicatorSets";
+export { PaneLabel } from "./PaneLabel";
+export { PaneHeader } from "./PaneHeader";
+export { SeriesPicker } from "./SeriesPicker";
+export { IndicatorLegend } from "./IndicatorLegend";
+export type { IndicatorLegendProps } from "./IndicatorLegend";
+export { BarReplayController } from "./replay/BarReplayController";
+export { ChartRenderContext, useChartRenderContext } from "./canvas/ChartRenderContext";
+export { OverlayCanvas } from "./canvas/OverlayCanvas";
+export type { OverlayDrawContext, OverlayCanvasProps } from "./canvas/OverlayCanvas";
+export { useDynamicPanes, dynamicPanesReducer, createDefaultPaneLayout, loadPaneLayout, savePaneLayout } from "./hooks/useDynamicPanes";
+export { DEFAULT_PANES, PANE_LAYOUT_STORAGE_KEY, PANE_MAX_VISIBLE } from "./types/pane-descriptor";
+export { isDefaultPaneId } from "./types/pane-descriptor";
+export type { PaneDescriptor, SeriesConfig, SeriesTypeId, TooltipMode, YAxisSide } from "./types/pane-descriptor";
+export { SERIES_SUB_COMPONENTS } from "./types/seriesComponents";
+export type { SeriesSubComponent } from "./types/seriesComponents";
+export { INDICATOR_SETS_STORAGE_KEY } from "./types/indicator-set";
+export type { IndicatorSet, IndicatorSetsStorage, IndicatorSetStorageLike } from "./types/indicator-set";
+export type { BarReplayState, ReplayBarLike, ReplaySpeed } from "./replay/BarReplayController";
+export { getSeries, listRegistered, registerSeries } from "./registry/SeriesRegistry";
+export { filterAvailableSeries, getSeriesTier, isSeriesAvailableForTier, toSeriesTier } from "./registry/SeriesRegistry";
+export type { SeriesTier } from "./registry/SeriesRegistry";
+export { clearSeriesStyleOverride, clearSeriesStyleOverrides, getSeriesStyleOverride, listSeriesStyleOverrides, overrideSeriesStyle, subscribeSeriesStyle, subscribeSeriesStyleChanges } from "./registry/SeriesRegistry";
+export type { SeriesSettingField, IndicatorCatalogEntry, IndicatorCategory, RepaintPolicy, PanePolicy, ScalePolicy } from "./types/indicator-catalog";
+export type { ChartHandle, VisibleRange } from "./types/chart";
+export type { SeriesStyleOverride } from "./registry/SeriesRegistry";
+export { initRegistry } from "./registry/registerAll";
+export type { ChartSyncState } from "./ChartPane";
+export type { PaneInput, PaneManagerState, PaneManagerAction } from "./hooks/usePaneManager";
+export type { ChartSplitterProps } from "./ChartSplitter";
+export type { UsePaneSizesOptions, UsePaneSizesResult } from "./hooks/usePaneSizes";
+export type { UseChartThemeResult, ChartTheme, ThemeMode } from "./hooks/useChartTheme";

package/dist/dts/lib/core/paneScaleSlotDomains.d.ts

@@ -0,0 +1,3 @@
+import type { EnrichedDatum } from "./calculators/types";
+import type { PaneDescriptor } from "./types/pane-descriptor";
+export declare function computePaneScaleSlotDomains(panes: readonly PaneDescriptor[], data: readonly EnrichedDatum[]): Record<string, [number, number]>;

package/dist/dts/lib/core/registry/SeriesRegistry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Barrel của SeriesRegistry — điểm import duy nhất cho toàn bộ consumer.
+ *
+ * Trước slice 0.8, file này chứa cả state, cả API, cả 73 lệnh `register*Series`.
+ * Nay đã tách:
+ *
+ * - `registryCore.ts` — singleton map, kiểu `RegistryEntry`/`SeriesTier`/`TooltipEntryDef`,
+ *   `registerSeries`/`registerLineSeries`, getter, override style, helper tier.
+ * - `registerPhaseOne.ts` — `registerPhaseOneSeries()`: clear registry rồi chạy 73 thunk
+ *   theo đúng thứ tự lịch sử.
+ * - 8 module nhóm chỉ báo: `priceChartTypes`, `movingAverage`, `volatility`, `momentum`,
+ *   `volumeFlow`, `trend`, `marketStructure`, `profile`.
+ *
+ * File này chỉ re-export, không có state và không có logic đăng ký — nên import
+ * `SeriesRegistry` bây giờ không còn kéo theo 15 component series.
+ *
+ * Hướng phụ thuộc (một chiều, không cycle):
+ *   SeriesRegistry → registerPhaseOne → {nhóm chỉ báo} → registryCore
+ */
+export type { RegistryEntry, SeriesStyleOverride, SeriesTier, TooltipEntryDef } from "./registryCore";
+export { clearRegistry, clearSeriesStyleOverrides, listSeriesStyleOverrides, overrideSeriesStyle, getSeriesStyleOverride, clearSeriesStyleOverride, subscribeSeriesStyle, subscribeSeriesStyleChanges, registerSeries, getSeries, listRegistered, getSeriesTier, isSeriesAvailableForTier, toSeriesTier, filterAvailableSeries, } from "./registryCore";
+export { registerPhaseOneSeries } from "./registerPhaseOne";

package/dist/dts/lib/core/registry/filterPanesBySeriesTier.d.ts

@@ -0,0 +1,43 @@
+import type { SeriesTier } from "./registryCore";
+import type { PaneDescriptor } from "../types/pane-descriptor";
+/**
+ * Tier render gate for ALL series types (PINE STAGE 2 item W-01).
+ *
+ * WHAT IT GATES. Every series in every pane passes through `filterAvailableSeries`
+ * (registryCore.ts:232-243) — built-ins and Pine-generated alike. Unregistered types
+ * fail closed inside it (catch → dropped), which is what keeps the tooltip path from
+ * throwing `SeriesRegistry: unknown type` on an orphan `pine_*` id after a browser
+ * restart, or after `importScript` mints a new script id (`useScriptPersistence.ts:124`)
+ * and orphans every `pine_<oldId>`.
+ *
+ * WHY NOT Pine-only (the Stage 1 shape). Stage 1 item 1.7 gated only runtime-generated
+ * Pine types and left the 9 paid BUILT-IN types ungated: Baseline, Renko, Kagi,
+ * PointAndFigure, LineBreak, MarketProfile, VolumeProfile (pro) + Footprint,
+ * DeltaProfile (enterprise). PROBE A measured 77 registered types = 68 free / 7 pro /
+ * 2 enterprise, and PROBE B showed `filterPanesBySeriesTier(panes_with_all_9, "free")`
+ * keeping 10/10 by identity — the render gate deleted in `c38ccae` (2026-10-03, "cut
+ * the legacy lane") was never restored for built-ins (`DynamicChart.tsx:1281` used to
+ * call `filterAvailableSeries` before the cut). This function IS that restoration.
+ *
+ * WHO LOSES WHAT (PROBE C — measured, not feared). After this gate: pro keeps 7/7,
+ * enterprise keeps 9/9, free loses exactly the 9 paid types. The old docblock's fear
+ * ("strip up to 9 chart types from paying customers") is wrong about pro/enterprise —
+ * only Free loses anything, and Free was never entitled to paid types (Rule 15), so no
+ * paying customer needs any notice. Locked in by `builtInSeriesTierGate.test.ts`.
+ *
+ * WHY THE GATE LIVES HERE (unchanged from Stage 1). Gating at `resolvedPanes`
+ * (VNInvestCharts.tsx:351) is not possible: that memo's body finishes at :404, while
+ * `effectiveToolbarTier` does not exist until :713 — reading the tier there is a TDZ
+ * error (:315 already warns about this). So the widget derives `renderPanes` AFTER the
+ * tier is known (VNInvestCharts.tsx:822-828) and feeds THAT to the engine
+ * (`forkEnginePanes`, VNInvestCharts.tsx:1230). `resolvedPanes` itself stays UNFILTERED
+ * so the settings composer can still show a locked series as an upgrade prompt.
+ *
+ * SHAPE CONTRACT: the returned array has the SAME LENGTH as the input. `paneDescriptorBridge.ts`
+ * maps pane descriptors to engine pane specs 1:1, so dropping a pane here would shift every
+ * downstream index. A pane whose series are all locked becomes `{...pane, series: []}`.
+ * When nothing is dropped the INPUT array is returned by identity, so the memo upstream
+ * never invalidates on a no-op pass (no Pine pre-check is needed: refs are preserved,
+ * not rebuilt).
+ */
+export declare function filterPanesBySeriesTier(panes: readonly PaneDescriptor[] | undefined, currentTier: SeriesTier): readonly PaneDescriptor[];

package/dist/dts/lib/core/registry/marketStructure.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Nhóm 7/8 — cấu trúc thị trường (pivot, fractal, sóng Wyckoff).
+ */
+export declare const registerWyckoffWave: () => void;
+export declare const registerFractals: () => void;
+export declare const registerPivotStandard: () => void;
+export declare const registerPivotHighLow: () => void;

package/dist/dts/lib/core/registry/momentum.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Nhóm 4/8 — oscillator / momentum (RSI, MACD, CCI, KDJ, WR, ROC, TRIX, PSY, CR,
+ * AC, BIAS, MTM, AO, CI, độ lệch tương đối).
+ */
+export declare const registerRSI: () => void;
+export declare const registerMACD: () => void;
+export declare const registerStrengthElder: () => void;
+export declare const registerStrengthRelative: () => void;
+export declare const registerWR: () => void;
+export declare const registerKDJ: () => void;
+export declare const registerCCI: () => void;
+export declare const registerBIAS: () => void;
+export declare const registerMTM: () => void;
+export declare const registerAO: () => void;
+export declare const registerROC: () => void;
+export declare const registerTRIX: () => void;
+export declare const registerPSY: () => void;
+export declare const registerCR: () => void;
+export declare const registerCI: () => void;
+export declare const registerAC: () => void;

package/dist/dts/lib/core/registry/movingAverage.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Nhóm 2/8 — moving average và biến thể (SMA/EMA/WMA/HMA/DEMA/TEMA/VWMA, DMA,
+ * BBI, ribbon).
+ */
+export declare const registerEMA: () => void;
+export declare const registerMA: () => void;
+export declare const registerBBI: () => void;
+export declare const registerWMA: () => void;
+export declare const registerVWMA: () => void;
+export declare const registerHMA: () => void;
+export declare const registerDEMA: () => void;
+export declare const registerTEMA: () => void;
+export declare const registerMARibbon: () => void;
+export declare const registerDMA: () => void;

package/dist/dts/lib/core/registry/priceChartTypes.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Nhóm 1/8 — loại chart / price renderer gốc: các kiểu nến/line/area/bar mà
+ * chart-type picker chọn được, cộng Histogram. Không phải chỉ báo.
+ */
+export declare const registerCandlestick: () => void;
+export declare const registerHollowCandle: () => void;
+export declare const registerOHLC: () => void;
+export declare const registerHeikinAshi: () => void;
+export declare const registerLine: () => void;
+export declare const registerArea: () => void;
+export declare const registerBaseline: () => void;
+export declare const registerRenko: () => void;
+export declare const registerKagi: () => void;
+export declare const registerPointAndFigure: () => void;
+export declare const registerLineBreak: () => void;
+export declare const registerHistogram: () => void;

package/dist/dts/lib/core/registry/profile.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Nhóm 8/8 — order-flow profile / footprint + overlay so sánh (tier pro/enterprise).
+ */
+export declare const registerMarketProfile: () => void;
+export declare const registerVolumeProfile: () => void;
+export declare const registerFootprint: () => void;
+export declare const registerDeltaProfile: () => void;
+export declare const registerComparison: () => void;

package/dist/dts/lib/core/registry/registerAll.d.ts

@@ -0,0 +1 @@
+export declare function initRegistry(): void;

package/dist/dts/lib/core/registry/registerPhaseOne.d.ts

@@ -0,0 +1,3 @@
+/** Một thunk đăng ký đúng một series type. */
+export type SeriesRegistration = () => void;
+export declare function registerPhaseOneSeries(): void;

package/dist/dts/lib/core/registry/registryCore.d.ts

@@ -0,0 +1,77 @@
+import type { ComponentType } from "react";
+import type { SeriesRenderMode } from "@vninvestcharts/engine-core";
+import type { EnrichedDatum } from "../calculators/types";
+import type { SeriesSettingField } from "../types/indicator-catalog";
+import type { SeriesConfig, SeriesTypeId, YAxisSide } from "../types/pane-descriptor";
+/**
+ * Lõi của SeriesRegistry: map đăng ký, các kiểu entry, override style và
+ * helper tier. KHÔNG chứa bất kỳ `register*Series(...)` nào — các đăng ký
+ * nằm ở `registerPhaseOne.ts` + 8 module theo nhóm chỉ báo.
+ *
+ * Lưu ý kiến trúc: map là singleton ở cấp module. Các module đăng ký import
+ * *xuông* vào đây (một chiều), nên không có import cycle.
+ */
+export interface SeriesStyleOverride {
+    color?: string;
+    lineWidth?: number;
+    visible?: boolean;
+    opacity?: number;
+    dashPattern?: number[];
+}
+export interface TooltipEntryDef {
+    label: string;
+    color?: string;
+    format: (value: number) => string;
+    accessor: (datum: EnrichedDatum) => number | undefined;
+}
+/** S3b: tối thiểu tier được thêm series (mặc định "free" khi vắng). */
+export type SeriesTier = "free" | "pro" | "enterprise";
+export interface RegistryEntry {
+    component: ComponentType<any>;
+    defaultParams: Record<string, unknown>;
+    defaultYAxis: YAxisSide;
+    tooltipEntry: (config: SeriesConfig) => TooltipEntryDef;
+    settingsFields?: readonly SeriesSettingField[];
+    tier?: SeriesTier;
+    /**
+     * Render mode mà engine sẽ dùng cho series này. Khai báo ở đây để registry là
+     * SSOT phía widget và có thể đối chiếu với `resolveSeriesRenderMode` của
+     * engine (`registry/__tests__/priceChartRenderMode.test.ts`) — hai bảng độc
+     * lập cùng ghi "chế độ vẽ" là cách chắc chắn trôi lệch.
+     */
+    renderMode?: SeriesRenderMode;
+}
+/** Đọc `params.period` nếu hợp lệ, ngược lại dùng fallback của chỉ báo. */
+export declare function periodFromConfig(config: SeriesConfig, fallback: number): number;
+export declare function registerLineSeries(type: SeriesTypeId, options: Omit<RegistryEntry, "component" | "defaultParams" | "defaultYAxis" | "tooltipEntry"> & {
+    component: ComponentType<any>;
+    defaultYAxis?: YAxisSide;
+    defaultParams?: Record<string, unknown>;
+    tooltipEntry: (config: SeriesConfig) => TooltipEntryDef;
+    settingsFields?: readonly SeriesSettingField[];
+}): void;
+export declare function clearRegistry(): void;
+export declare function clearSeriesStyleOverrides(): void;
+export declare function listSeriesStyleOverrides(): Record<string, Partial<SeriesStyleOverride>>;
+export declare function overrideSeriesStyle(instanceId: string, partialStyle: Partial<SeriesStyleOverride>): void;
+export declare function getSeriesStyleOverride(instanceId: string): Partial<SeriesStyleOverride> | undefined;
+export declare function clearSeriesStyleOverride(instanceId: string): void;
+export declare function subscribeSeriesStyle(instanceId: string, callback: () => void): () => void;
+export declare function subscribeSeriesStyleChanges(callback: () => void): () => void;
+export declare function registerSeries(type: SeriesTypeId, entry: RegistryEntry): void;
+export declare function getSeries(type: SeriesTypeId): RegistryEntry;
+export declare function listRegistered(): SeriesTypeId[];
+/** S3b: tier của series (vắng entry.tier = "free"). Ném lỗi như getSeries nếu type lạ. */
+export declare function getSeriesTier(type: SeriesTypeId): SeriesTier;
+/** S3b: tier hiện tại có được thêm series này không (pure, fail-closed về free). */
+export declare function isSeriesAvailableForTier(type: SeriesTypeId, currentTier: SeriesTier): boolean;
+/**
+ * S5b: map tier thô (PAT 7 mức / plan server / null) về SeriesTier 3 mức.
+ * starter/none/khuyết → free; custom/internal → enterprise (full).
+ */
+export declare function toSeriesTier(tier: string | null | undefined): SeriesTier;
+/**
+ * S3b-1: lọc series theo tier (dùng cho render-gate tập trung ở DynamicChart).
+ * Chuẩn hóa alias trước khi tra tier; type lạ → loại (fail-closed, không render).
+ */
+export declare function filterAvailableSeries(series: readonly SeriesConfig[], currentTier: SeriesTier): SeriesConfig[];

package/dist/dts/lib/core/registry/trend.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Nhóm 6/8 — hệ thống xu hướng (SAR, DMI, Ichimoku, Supertrend, Alligator/Gator,
+ * HTF overlay).
+ */
+export declare const registerSAR: () => void;
+export declare const registerDMI: () => void;
+export declare const registerIchimoku: () => void;
+export declare const registerSupertrend: () => void;
+export declare const registerAlligator: () => void;
+export declare const registerGator: () => void;
+export declare const registerHTFOverlay: () => void;

package/dist/dts/lib/core/registry/volatility.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Nhóm 3/8 — dải biến động và độ phân tán (Bollinger, Keltner, Donchian,
+ * ChaikinVol, StdDev, HV).
+ */
+export declare const registerBollingerBand: () => void;
+export declare const registerBollingerBands: () => void;
+export declare const registerKeltner: () => void;
+export declare const registerDonchian: () => void;
+export declare const registerChaikinVol: () => void;
+export declare const registerStdDev: () => void;
+export declare const registerHV: () => void;

package/dist/dts/lib/core/registry/volumeFlow.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Nhóm 5/8 — volume & money flow (Volume, OBV, VR, PVT, BRAR, EMV, SMFI, CMF, MFI,
+ * ChaikinOscillator, VolOsc, CVD, VWAP).
+ */
+export declare const registerVolume: () => void;
+export declare const registerCVDApprox: () => void;
+export declare const registerCVDRealtime: () => void;
+export declare const registerSMFI: () => void;
+export declare const registerWhale: () => void;
+export declare const registerOBV: () => void;
+export declare const registerVR: () => void;
+export declare const registerBRAR: () => void;
+export declare const registerEMV: () => void;
+export declare const registerPVT: () => void;
+export declare const registerCMF: () => void;
+export declare const registerChaikinOscillator: () => void;
+export declare const registerMFI: () => void;
+export declare const registerVolOsc: () => void;
+export declare const registerVWAP: () => void;
+export declare const registerAnchoredVWAP: () => void;