@vninvestcharts/widget 0.0.0-stage → 0.2.0

package/dist/dts/widget/components/settings/model/chartSettingsSchema.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Chart Settings SSOT Data Schema (TradingView Parity)
+ */
+export type CandleStyle = "candle" | "hollow" | "bar" | "line" | "area";
+export type PriceScaleMode = "normal" | "logarithmic" | "percentage";
+export type GridLineStyle = "solid" | "dashed" | "dotted";
+export type CrosshairMode = "cross" | "dot" | "magnet";
+export type ThemePresetName = "classic-dark" | "modern-light" | "trading-night" | "neutral-pro" | "high-contrast" | "midnight-blue";
+export type OverlayStyle = "candle" | "hollow" | "step" | "area";
+export interface SymbolSettings {
+    candleStyle: CandleStyle;
+    upColor: string;
+    downColor: string;
+    borderUpColor: string;
+    borderDownColor: string;
+    wickUpColor: string;
+    wickDownColor: string;
+    showLastPriceLine: boolean;
+    lastPriceLineColor?: string;
+    showPrevClosePriceLine: boolean;
+    prevClosePriceLineColor?: string;
+    showHighLowPriceLines: boolean;
+    precision: "default" | "0" | "1" | "2" | "3" | "4";
+    timezone: string;
+}
+export interface StatusLineSettings {
+    showLogo: boolean;
+    showTicker: boolean;
+    showOhlc: boolean;
+    showBarChange: boolean;
+    showVolume: boolean;
+    showIndicatorTitles: boolean;
+    showIndicatorArguments: boolean;
+    showIndicatorValues: boolean;
+    backgroundOpacity: number;
+}
+export interface ScalesSettings {
+    priceScaleMode: PriceScaleMode;
+    invertScale: boolean;
+    priceAxisPosition: "right" | "left";
+    showSymbolLastValue: boolean;
+    showPrevCloseValue: boolean;
+    showIndicatorValues: boolean;
+    showCountdownToBarClose: boolean;
+    showTimeScrollbar: boolean;
+    dateFormat: "yyyy-mm-dd" | "dd/mm/yyyy" | "mm/dd/yyyy";
+    timeFormat: "24h" | "12h";
+}
+export interface AppearanceSettings {
+    backgroundType: "solid" | "gradient";
+    backgroundColor: string;
+    backgroundGradientTop?: string;
+    backgroundGradientBottom?: string;
+    vertGridVisible: boolean;
+    vertGridColor: string;
+    vertGridStyle: GridLineStyle;
+    horzGridVisible: boolean;
+    horzGridColor: string;
+    horzGridStyle: GridLineStyle;
+    crosshairMode: CrosshairMode;
+    crosshairColor: string;
+    crosshairWidth: number;
+    showWatermark: boolean;
+    watermarkOpacity: number;
+    scalesFontSize: 10 | 11 | 12 | 14;
+    marginTopRatio: number;
+    marginBottomRatio: number;
+}
+export interface PanesLayoutSettings {
+    maxVisiblePanes: number;
+    showNonTradingDays: boolean;
+    overlayTimeframe?: string;
+    overlayStyle: OverlayStyle;
+}
+export interface TradingEventsSettings {
+    showCorporateEvents: boolean;
+    showWhaleFlow: boolean;
+    whaleThreshold: number;
+    showCVD: boolean;
+    cvdMode: "oscillator" | "histogram";
+    alertAudioEnabled: boolean;
+    showPaperOrders: boolean;
+    showPaperPositions: boolean;
+    dataAdapterName: "binance" | "local" | "vnstocks" | string;
+}
+export interface ThemeSettings {
+    mode: "dark" | "light";
+    presetName: ThemePresetName;
+}
+export interface ChartSettingsState {
+    version: 1;
+    symbol: SymbolSettings;
+    statusLine: StatusLineSettings;
+    scales: ScalesSettings;
+    appearance: AppearanceSettings;
+    panesLayout: PanesLayoutSettings;
+    tradingEvents: TradingEventsSettings;
+    theme: ThemeSettings;
+}
+export type SettingsTabId = "symbol" | "statusLine" | "scales" | "appearance" | "panes" | "indicators" | "indicatorSets" | "trading" | "theme" | "licensing" | "reset";

package/dist/dts/widget/components/settings/model/defaultSettings.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Default Chart Settings by Theme Preset
+ */
+import type { ChartSettingsState } from "./chartSettingsSchema";
+export declare function createDefaultSettings(isDark?: boolean, preset?: string, defaultShowTimeScrollbar?: boolean): ChartSettingsState;

package/dist/dts/widget/components/settings/model/indicatorShare.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Indicator cross-chart share (explicit "apply to all" only).
+ *
+ * v1 scope: indicator SERIES (never symbols/timeframes/layout). Price-pane main
+ * series (series[0]), compare overlays (overlaySymbolId) and derived-on-derived
+ * series (sourceType indicator, unresolvable cross-chart) are never shared.
+ * Shared copies drop identity + data-source bindings so targets compute from
+ * their own bars (same minimal shape the composer writes).
+ */
+import type { PaneDescriptor, SeriesConfig } from "../../../../lib/core/types/pane-descriptor";
+export declare const INDICATORS_SHARE_EVENT = "vnsc-indicators-share";
+export interface SharedIndicator {
+    paneId: string;
+    paneLabel: string;
+    series: SeriesConfig;
+}
+export interface IndicatorsShareDetail {
+    sourceChartId: string | null;
+    indicators: SharedIndicator[];
+}
+/** Collect shareable indicator series with pane attribution (pure, no mutation). */
+export declare function extractShareableIndicators(panes: readonly PaneDescriptor[]): SharedIndicator[];
+/**
+ * Merge shared indicators into a target layout (pure, no mutation).
+ * Returns the ORIGINAL array reference when nothing was added (no-op signal).
+ * Never touches the target price-pane main series; creates missing non-price
+ * panes as visible shells (heightRatio 0.15 matches volume-class panes).
+ */
+export declare function mergeIndicatorsIntoLayout(panes: readonly PaneDescriptor[], indicators: readonly SharedIndicator[]): readonly PaneDescriptor[];

package/dist/dts/widget/components/settings/storageKeys.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Chart-centric storage keys (Settings S1).
+ * SSOT for namespacing per-chart settings. Pattern follows M1 paper-trading
+ * namespace (`liveNamespace`: suffix chartId, legacy fallback when absent).
+ */
+import type { StorageAdapter } from "@vninvestcharts/engine-react";
+export declare const LEGACY_COMPOSITE_KEY = "vnsc_chart_settings_v1";
+/** Normalize empty chartId to undefined (single-chart legacy mode). */
+export declare function normalizeChartId(chartId?: string | null): string | undefined;
+/**
+ * Composite settings key. Multi-chart cell -> `vnsc_chart_settings_<chartId>`;
+ * single-chart (no chartId) -> legacy global key (backward compatible).
+ */
+export declare function settingsCompositeKey(chartId?: string | null): string;
+/** Scoped single-setting key: `<base>_<chartId>` in multi, `<base>` in single. */
+export declare function scopedSingleKey(base: string, chartId?: string | null): string;
+/** Read scoped-first, fall back to legacy global (one-time migration path). */
+export declare function readScopedSetting(adapter: StorageAdapter | undefined, base: string, chartId?: string | null): string | null;
+/** Write to scoped key in multi, legacy key in single (never both). */
+export declare function writeScopedSetting(adapter: StorageAdapter | undefined, base: string, value: string, chartId?: string | null): void;
+/** Remove scoped key (reset scope = own chart only). */
+export declare function removeScopedSetting(adapter: StorageAdapter | undefined, base: string, chartId?: string | null): void;
+/**
+ * Two-way envelope guard (S2). Multi-chart receiver (`myChartId` set) only
+ * accepts events carrying exactly its chartId — legacy/global events are
+ * ignored so one chart can never be overwritten by another. Single-chart
+ * receiver (no id) only accepts global events and ignores foreign envelopes.
+ */
+export declare function shouldAcceptSettingsEvent(myChartId?: string | null, incomingChartId?: string | null): boolean;

package/dist/dts/widget/components/settings/tabs/AppearanceSettingsTab.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tab 4: Appearance & Canvas Theme Settings
+ */
+import React from "react";
+export declare function AppearanceSettingsTab(): React.JSX.Element;

package/dist/dts/widget/components/settings/tabs/IndicatorParamsForm.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Indicator Parameters Form
+ * Generates parameter fields, input source selectors, and styling per indicator
+ */
+import React from "react";
+import type { PaneDescriptor, SeriesConfig } from "../../../../lib/core";
+export interface IndicatorParamsFormProps {
+    pane: PaneDescriptor;
+    series: SeriesConfig;
+    seriesIndex: number;
+}
+export declare function IndicatorParamsForm(props: IndicatorParamsFormProps): React.JSX.Element | null;

package/dist/dts/widget/components/settings/tabs/IndicatorsSettingsTab.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Tab 6: Indicators Settings & Indicator Sets
+ */
+import React from "react";
+import { type SeriesTier } from "../../../../lib/core";
+export interface IndicatorsSettingsTabProps {
+    /** Owning chart id (multi) — share source attribution; absent = single (no share button). */
+    chartId?: string;
+    selectedPaneId?: string;
+    onSelectedPaneIdChange?: (paneId: string) => void;
+    comparisonOverlays?: ReadonlyArray<{
+        symbolId: string;
+        visible: boolean;
+        color: string;
+        yAxis: "left" | "right";
+        lineWidth: number;
+        lineStyle: "solid" | "dashed" | "dotted";
+        fillArea: boolean;
+        normalizeToBaseline: boolean;
+    }>;
+    onComparisonRemove?: (symbolId: string) => void;
+    onComparisonUpdate?: (symbolId: string, updates: Partial<{
+        visible: boolean;
+        color: string;
+        yAxis: "left" | "right";
+        lineWidth: number;
+        lineStyle: "solid" | "dashed" | "dotted";
+        fillArea: boolean;
+        normalizeToBaseline: boolean;
+    }>) => void;
+    /** S3b-2: tier gate cho composer thêm series (undefined = không gate, legacy). */
+    seriesTier?: SeriesTier;
+}
+export declare function IndicatorsSettingsTab(props: IndicatorsSettingsTabProps): React.JSX.Element;

package/dist/dts/widget/components/settings/tabs/LicensingSettingsTab.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Licensing Settings Tab
+ */
+import React from "react";
+export declare function LicensingSettingsTab(): React.JSX.Element | null;

package/dist/dts/widget/components/settings/tabs/PanesLayoutSettingsTab.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tab 5: Panes & Layout Settings
+ */
+import React from "react";
+export interface PanesLayoutSettingsTabProps {
+    selectedPaneId?: string;
+    onSelectedPaneIdChange?: (paneId: string) => void;
+    onExportLayout?: () => void;
+    onImportLayout?: (layoutJson: string) => void;
+}
+export declare function PanesLayoutSettingsTab(props: PanesLayoutSettingsTabProps): React.JSX.Element;

package/dist/dts/widget/components/settings/tabs/ResetSettingsTab.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Reset Settings Tab
+ */
+import React from "react";
+export interface ResetSettingsTabProps {
+    onReset?: () => void;
+}
+export declare function ResetSettingsTab(props: ResetSettingsTabProps): React.JSX.Element;

package/dist/dts/widget/components/settings/tabs/ScalesSettingsTab.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tab 3: Scales & Coordinates Settings
+ */
+import React from "react";
+export declare function ScalesSettingsTab(): React.JSX.Element;

package/dist/dts/widget/components/settings/tabs/StatusLineSettingsTab.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tab 2: Status Line Settings
+ */
+import React from "react";
+export declare function StatusLineSettingsTab(): React.JSX.Element;

package/dist/dts/widget/components/settings/tabs/SymbolSettingsTab.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tab 1: Symbol & Candle Settings
+ */
+import React from "react";
+export declare function SymbolSettingsTab(): React.JSX.Element;

package/dist/dts/widget/components/settings/tabs/ThemePaletteSettingsTab.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tab 8: Theme & Palette Settings
+ */
+import React from "react";
+export interface ThemePaletteSettingsTabProps {
+    toggleTheme?: () => void;
+    isDark?: boolean;
+}
+export declare function ThemePaletteSettingsTab(props: ThemePaletteSettingsTabProps): React.JSX.Element;

package/dist/dts/widget/components/settings/tabs/TradingEventsSettingsTab.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tab 7: Trading & Events Settings
+ */
+import React from "react";
+export declare function TradingEventsSettingsTab(props: {
+    chartId?: string | null;
+    symbol?: string;
+}): React.JSX.Element;

package/dist/dts/widget/components/toolbar/DrawingToolIcon.d.ts

@@ -0,0 +1,10 @@
+/**
+ * P3 split: tool glyph renderer extracted from DrawingToolbar (pure move,
+ * zero behavior change). Prefers the shared `drawingToolIcons` registry and
+ * falls back to the legacy inline SVG set for ids the registry lacks.
+ */
+export interface DrawingToolIconProps {
+    /** Drawing tool id (e.g. "trendLine", "fibonacci", "cursor"). */
+    id: string;
+}
+export declare function DrawingToolIcon({ id }: DrawingToolIconProps): import("react").JSX.Element;

package/dist/dts/widget/components/toolbar/DrawingToolbar.d.ts

@@ -0,0 +1,33 @@
+/**
+ * WE2 P2-02: DrawingToolbar
+ *
+ * Left-side drawing toolbar with tool groups, recent tools, favorites,
+ * magnet snap toggle, and search.
+ *
+ * Connects to VNInvestChartsStateContext for active tool state.
+ * Uses .vnsc- CSS prefix for widget namespace.
+ */
+import type { PatTier } from "@vninvestcharts/engine-core";
+export interface DrawingToolbarProps {
+    /** Current active tool name (e.g., "trendLine", "fibonacci") */
+    activeTool?: string;
+    /** Called when user selects a tool */
+    onToolSelect?: (tool: string) => void;
+    /** Current magnet snap sensitivity: 0=off, 1=weak, 2=normal, 3=strong */
+    magnetSensitivity?: number;
+    /** Called when user cycles magnet sensitivity (M key equivalent) */
+    onMagnetCycle?: () => void;
+    /** Current PAT tier for premium tool gating */
+    patTier?: PatTier;
+    /** Called when a premium tool is clicked but blocked (insufficient tier) */
+    onPremiumToolClick?: (tool: string) => void;
+    /** Whether the drawing dock is open */
+    isDockOpen?: boolean;
+    /** Called when user toggles the drawing dock panel */
+    onToggleDock?: () => void;
+    /** Whether the toolbar is locked (docked) */
+    isLocked?: boolean;
+    /** Called when user toggles lock/dock state */
+    onToggleLock?: () => void;
+}
+export declare function DrawingToolbar({ activeTool, onToolSelect, magnetSensitivity, onMagnetCycle, patTier, onPremiumToolClick, isDockOpen, onToggleDock, isLocked, onToggleLock, }: DrawingToolbarProps): import("react").JSX.Element;

package/dist/dts/widget/components/toolbar/FloatingChartBar.d.ts

@@ -0,0 +1,20 @@
+/**
+ * FloatingChartBar — hover-revealed chart navigation bar (GoCharting style).
+ *
+ * Rendered as last child of `.rsc-engine-surface`; auto-hide handled by
+ * `styles/floating-chart-bar.css`. All labels via `useWidgetI18n` (Rule 1).
+ * Root stops click/mousedown/pointerdown/contextmenu/doubleclick propagation
+ * so bar interaction never leaks into fork surface handlers (P3 drawings,
+ * price-scale menu). Toggle button only renders in multi-chart cells.
+ */
+export interface FloatingChartBarProps {
+    onZoomIn: () => void;
+    onZoomOut: () => void;
+    onPanLeft: () => void;
+    onPanRight: () => void;
+    onFitToData: () => void;
+    onToggleLayout?: () => void;
+    isSoloMode?: boolean;
+    panDisabled?: boolean;
+}
+export declare function FloatingChartBar(props: FloatingChartBarProps): import("react").JSX.Element;

package/dist/dts/widget/components/toolbar/FloatingFavoritesBar.d.ts

@@ -0,0 +1,18 @@
+/**
+ * P3 R-P3-02: floating quick-favorites bar.
+ *
+ * Draggable (grip handle) overlay listing the user's pinned drawing tools.
+ * Renders through the widget portal root (falls back to document.body, the
+ * MobileToolbar pattern) so host `overflow:hidden` containers never clip it.
+ * Tools persist via useFavoriteTools (`vnsc_favTools`); bar position persists
+ * in `vnsc_favToolsBarPos`. Hidden while no tool is pinned.
+ */
+export interface FloatingFavoritesBarProps {
+    favoriteTools: readonly string[];
+    activeTool?: string;
+    onToolSelect: (tool: string) => void;
+    onUnpin: (tool: string) => void;
+    isVisible?: boolean;
+    onClose?: () => void;
+}
+export declare function FloatingFavoritesBar({ favoriteTools, activeTool, onToolSelect, onUnpin, isVisible, onClose, }: FloatingFavoritesBarProps): import("react").JSX.Element | null;

package/dist/dts/widget/components/toolbar/MultiChartTopbar.d.ts

@@ -0,0 +1,47 @@
+import type { ChartLayout } from "../../VNInvestMultiCharts";
+export interface MultiChartTopbarProps {
+    layout: ChartLayout;
+    onLayoutChange: (layout: ChartLayout) => void;
+    activeChartId: string | null;
+    activeSymbol?: string;
+    activeTimeframe?: string;
+    onSymbolChange: (symbol: string) => void;
+    onTimeframeChange: (timeframe: string) => void;
+    syncSettings: {
+        visibleRange: boolean;
+        crosshair: boolean;
+        drawings: boolean;
+        symbolLinks: boolean;
+        timeframe: boolean;
+        chartType: boolean;
+        replay: boolean;
+    };
+    onSyncChange: (key: string, value: boolean) => void;
+    onSaveWorkspace?: () => void;
+    onAddChart?: () => void;
+    onThemeToggle?: () => void;
+    isDark?: boolean;
+    isMobile?: boolean;
+    /** Mobile-only: search toggle */
+    onSearchToggle?: () => void;
+    /** Mobile-only: fullscreen toggle */
+    onFullscreenClick?: () => void;
+    isFullscreen?: boolean;
+    /** Mobile-only: snapshot click */
+    onSnapshotClick?: () => void;
+    /** Mobile-only: chart type */
+    chartType?: string;
+    onChartTypeChange?: (chartType: string) => void;
+    /** Mobile-only: compare toggle */
+    compareOpen?: boolean;
+    onCompareToggle?: () => void;
+    /** Mobile-only: replay */
+    replayPlaying?: boolean;
+    onReplayPlay?: () => void;
+    onReplayPause?: () => void;
+    /** System menu trigger (mobile) */
+    onSystemMenuOpen?: () => void;
+    /** Tier PAT đã xác minh — cổng cho chart type pro. Vắng ⇒ khoá (fail-closed). */
+    patTier?: string;
+}
+export declare function MultiChartTopbar({ layout, onLayoutChange, activeChartId, activeSymbol, activeTimeframe, onSymbolChange, onTimeframeChange, syncSettings, onSyncChange, onSaveWorkspace, onAddChart, onThemeToggle, isDark, isMobile, onSearchToggle, onFullscreenClick, isFullscreen, onSnapshotClick, chartType, onChartTypeChange, compareOpen, onCompareToggle, replayPlaying, onReplayPlay, onReplayPause, patTier, }: MultiChartTopbarProps): import("react").JSX.Element;

package/dist/dts/widget/components/toolbar/UnifiedDrawingToolbar.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import type { PatTier } from "@vninvestcharts/engine-core";
+interface UnifiedDrawingToolbarProps {
+    /** The active chart ID to control */
+    activeChartId: string | null;
+    /** Chart refs map to access drawing managers */
+    chartRefs: Map<string, React.RefObject<any>>;
+    /** Whether the toolbar is locked open */
+    locked?: boolean;
+    /** Callback when lock state changes */
+    onLockChange?: (locked: boolean) => void;
+    /** Whether the toolbar is collapsed */
+    collapsed?: boolean;
+    /** Callback when collapse state changes */
+    onCollapseChange?: (collapsed: boolean) => void;
+    /** Custom className */
+    className?: string;
+    /** Current PAT tier for premium tool gating */
+    patTier?: PatTier;
+    /** Called when a premium tool is clicked but blocked (insufficient tier) */
+    onPremiumToolClick?: (tool: string) => void;
+    /** Whether the drawing dock is open */
+    isDockOpen?: boolean;
+    /** Called when user toggles the drawing dock panel */
+    onToggleDock?: () => void;
+}
+export declare const UnifiedDrawingToolbar: React.FC<UnifiedDrawingToolbarProps>;
+export default UnifiedDrawingToolbar;

package/dist/dts/widget/components/trading/PaperTradePanel.d.ts

@@ -0,0 +1,41 @@
+/**
+ * WE2 P2-07: PaperTradePanel
+ *
+ * @deprecated Task 11 — chỉ giữ làm compatibility shim cho public API.
+ * Dùng TradingBottomPanel (5 tabs) cho mọi bề mặt mới. Khối sizing trùng lặp
+ * đã gỡ (chỉ giữ 1 khối local-state). Panel showing paper trading positions,
+ * journal, and performance stats. Uses .vnsc- CSS classes for theme
+ * inheritance from .vnsc-root.
+ */
+export interface PaperTradePosition {
+    id: string;
+    side: "long" | "short";
+    entryPrice: number;
+    currentPrice: number;
+    quantity: number;
+    entryBar: number;
+    unrealizedPnl?: number;
+}
+export interface PaperTradeJournalEntry {
+    id: string;
+    side: "long" | "short";
+    entryPrice: number;
+    exitPrice: number;
+    quantity: number;
+    pnl: number;
+    barsHeld: number;
+}
+export interface PaperTradeSizingConfig {
+    mode: "fixed" | "percent";
+    riskPercent: number;
+    initialEquity: number;
+}
+export interface PaperTradePanelProps {
+    positions: readonly PaperTradePosition[];
+    journal: readonly PaperTradeJournalEntry[];
+    sizing?: PaperTradeSizingConfig;
+    onSizingChange?: (cfg: PaperTradeSizingConfig) => void;
+    onReset?: () => void;
+    onClose?: () => void;
+}
+export declare function PaperTradePanel({ positions, journal, sizing, onSizingChange, onReset, onClose, }: PaperTradePanelProps): import("react").JSX.Element;

package/dist/dts/widget/components/workspace/WorkspaceToolbar.d.ts

@@ -0,0 +1,25 @@
+import React, { type CSSProperties, type ReactNode } from "react";
+import type { StorageAdapter } from "@vninvestcharts/engine-react";
+export interface WorkspaceInfo {
+    id: string;
+    name: string;
+    updatedAt: number;
+}
+export interface WorkspaceToolbarProps {
+    currentWorkspaceId?: string;
+    currentWorkspaceName?: string;
+    workspaces: WorkspaceInfo[];
+    onSave: (workspaceId: string, name: string) => Promise<void>;
+    onLoad: (workspaceId: string) => Promise<void>;
+    onDelete?: (workspaceId: string) => Promise<void>;
+    onImport?: (file: File) => Promise<void>;
+    onExport?: (workspaceId: string) => Promise<void>;
+    storageAdapter?: StorageAdapter;
+    className?: string;
+    style?: CSSProperties;
+    children?: ReactNode;
+    autoSaveEnabled?: boolean;
+    onAutoSaveToggle?: (enabled: boolean) => void;
+}
+export declare const WorkspaceToolbar: React.FC<WorkspaceToolbarProps>;
+export default WorkspaceToolbar;

package/dist/dts/widget/config/toolGroups.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tool group configuration for drawing toolbar inside the widget.
+ * Covers 14 groups.
+ * Each group has id (for tracking) and labelKey (for i18n lookup in tool.group.*).
+ */
+export interface ToolGroup {
+    id: string;
+    labelKey: string;
+    tools: string[];
+}
+export declare const TOOL_GROUPS_V2: ToolGroup[];

package/dist/dts/widget/config/toolShortcuts.d.ts

@@ -0,0 +1,27 @@
+/**
+ * P4: single source of truth for drawing-tool keyboard shortcuts.
+ * Merges the legacy single-letter map with the P4 additions. Uppercase keys
+ * are Shift-modified (e.key arrives uppercased while Shift is held).
+ *
+ * NOTE: `E` stays bound to `ellipse` (existing muscle memory); the eraser is
+ * toolbar-only.
+ *
+ * **2026-09-30:** this file is now the *only* shortcut source. The legacy
+ * `DRAWING_SHORTCUTS` table in `@vninvestcharts/engine-drawing` (`shortcutMap.ts`) and
+ * `SHORTCUTS` in `engine-react/adapters/KeyboardAdapter.ts` were both **deleted** as
+ * breaking changes in engine 3.0.0 — they had zero consumers and were a wrong second copy
+ * (bare `C`/`H`/`M` and `Ctrl+H` collided with bindings that really run). There is no
+ * longer a competing table to drift from.
+ */
+/** KeyboardEvent.key → DrawingToolType. Uppercase = Shift-held. */
+export declare const TOOL_SHORTCUT_KEYS: Record<string, string>;
+/** Display label for a shortcut key (Shift-held uppercase keys shown as such). */
+export declare function shortcutDisplayLabel(key: string): string;
+/** DrawingToolType → display shortcut label (tools without a binding map to ""). */
+export declare const TOOL_SHORTCUT_LABELS: Record<string, string>;
+/**
+ * P3: Alt-held industry bindings (TradingView parity). `KeyboardEvent.key`
+ * stays lowercase for letters while Alt is held (unlike Shift), so the map
+ * keys are lowercase. All four tools are free-tier — no PAT gating needed.
+ */
+export declare const ALT_TOOL_SHORTCUTS: Record<string, string>;

package/dist/dts/widget/constants/comparison.d.ts

@@ -0,0 +1 @@
+export declare const COMPARISON_COLORS: string[];

package/dist/dts/widget/constants/symbolSearch.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Symbol search SSOT constants (SYMBOL_SEARCH P1).
+ * Single definition surface for futures/crypto fallbacks, timeframe
+ * aliases, recent-storage key and exchange filter options.
+ */
+import type { SymbolSearchItem } from "../types/symbolSearch";
+export declare const RECENT_SYMBOLS_KEY = "vni_recent_symbols";
+export declare const MAX_RECENT = 10;
+export type ExchangeFilter = "ALL" | "HOSE" | "HNX" | "UPCOM";
+export declare const EXCHANGE_OPTIONS: ExchangeFilter[];
+export declare const TIMEFRAME_ALIASES: Record<string, string>;
+export declare const FUTURES_SYMBOLS: SymbolSearchItem[];
+export declare const CRYPTO_SYMBOLS: SymbolSearchItem[];
+export { VN30_SYMBOLS } from "./vn30";

package/dist/dts/widget/constants/vn30.d.ts

@@ -0,0 +1,7 @@
+/**
+ * VN30 basket — single source of truth (moved from VNSymbolSearch).
+ * Consumed by symbol search sections and the Phase 4b watchlist fallback.
+ */
+export declare const VN30_SYMBOLS: string[];
+/** Static display names for the VN30 basket (watchlist fallback rows). */
+export declare const VN30_NAMES: Record<string, string>;

package/dist/dts/widget/context/DataProviderContext.d.ts

@@ -0,0 +1,7 @@
+import React, { type ReactNode } from "react";
+import { type IChartDataProvider } from "../types/dataProvider";
+export declare const DataProviderContext: React.Context<IChartDataProvider | null>;
+export declare function DataProviderProvider({ provider, children, }: {
+    provider: IChartDataProvider | null;
+    children: ReactNode;
+}): React.FunctionComponentElement<React.ProviderProps<IChartDataProvider | null>>;

package/dist/dts/widget/context/HoverEmitter.d.ts

@@ -0,0 +1,50 @@
+/**
+ * WE2 P1-05: HoverEmitter
+ *
+ * Ref-based EventTarget emitter for high-frequency hover/mouse coordinate events.
+ *
+ * Why not React state?
+ *   Hover events fire on every pixel the mouse moves. Pushing these through
+ *   React state would trigger a re-render on every pixel — causing jank.
+ *
+ * Why not mitt?
+ *   EventTarget is a native browser API — zero bundle size impact.
+ *   CustomEvent supports structured data via the `detail` property.
+ *
+ * Usage:
+ *   // In provider:
+ *   const hoverEmitterRef = useRef<EventTarget>(createHoverEmitter());
+ *
+ *   // Emit from canvas surface:
+ *   emitHover(hoverEmitterRef, { datum, pixelX, pixelY, paneId });
+ *
+ *   // Subscribe in OHLCHeader, tooltip, etc:
+ *   useHoverSubscription(hoverEmitterRef, (payload) => { ... });
+ */
+import { type RefObject } from "react";
+import type { EnrichedDatum } from "../../lib/core/calculators/types";
+export interface HoverEventPayload {
+    datum: EnrichedDatum | undefined;
+    pixelX: number;
+    pixelY: number;
+    paneId: string | undefined;
+}
+export type HoverEmitter = EventTarget;
+export declare function createHoverEmitter(): HoverEmitter;
+/** Emit a hover event — safe to call on every mouse move. */
+export declare function emitHover(emitter: HoverEmitter, payload: HoverEventPayload): void;
+/** Clear hover state (e.g., when mouse leaves chart). */
+export declare function clearHover(emitter: HoverEmitter): void;
+/**
+ * Subscribe to hover events without causing React re-renders on every pixel.
+ * The callback receives the payload and can update local DOM refs directly.
+ *
+ * If you DO want React state updates, pass a setState function as the callback,
+ * but be aware this will trigger re-renders on every hover event.
+ */
+export declare function useHoverSubscription(emitterRef: RefObject<HoverEmitter | null>, callback: (payload: HoverEventPayload) => void): void;
+/**
+ * React hook that bridges hover events into React state.
+ * Use sparingly — only when a component truly needs hover data in its render output.
+ */
+export declare function useHoverState(emitterRef: RefObject<HoverEmitter | null>): HoverEventPayload | null;