@vninvestcharts/widget 0.0.0-stage → 0.2.0

package/dist/dts/widget/trading/chart/TradingOverlaysHost.d.ts

@@ -0,0 +1,28 @@
+import { createPaneProjector, type PaneRuntimeSnapshot, type VisibleRange as EngineVisibleRange } from "@vninvestcharts/engine-core";
+import type { TradingOrder, TradingPosition } from "../../../lib/core/trading/types";
+export interface PositionLineModel {
+    position: TradingPosition;
+    stopLossPrice?: number;
+    stopOrderId?: string;
+    takeProfitPrice?: number;
+    takeProfitOrderId?: string;
+}
+export interface TradingOverlaysHostProps {
+    snapshot: PaneRuntimeSnapshot;
+    visibleRange: EngineVisibleRange;
+    scaleSlotId: string;
+    scale?: Parameters<typeof createPaneProjector>[3];
+    positions: PositionLineModel[];
+    pendingOrders: TradingOrder[];
+    accountEquity: number;
+    contractMultiplier?: number;
+    tickSize: number;
+    drawingActive?: boolean;
+    onClosePosition?: (positionId: string) => void;
+    onReversePosition?: (positionId: string) => void;
+    onModifyOrder?: (orderId: string, patch: {
+        stopPrice: number;
+    }) => void;
+    onCancelOrder?: (orderId: string) => void;
+}
+export declare function TradingOverlaysHost({ snapshot, visibleRange, scaleSlotId, scale, positions, pendingOrders, accountEquity, contractMultiplier, tickSize, drawingActive, onClosePosition, onReversePosition, onModifyOrder, onCancelOrder, }: TradingOverlaysHostProps): import("react").JSX.Element;

package/dist/dts/widget/trading/chart/priceTicks.d.ts

@@ -0,0 +1 @@
+export declare function roundToTick(price: number, tickSize: number): number;

package/dist/dts/widget/trading/chart/useFloatingDrag.d.ts

@@ -0,0 +1,40 @@
+export interface FloatingPos {
+    x: number;
+    y: number;
+}
+export interface FloatingDragOptions {
+    storageKey: string;
+    defaultPos: FloatingPos;
+    getBounds: () => {
+        width: number;
+        height: number;
+    };
+    /**
+     * Element được định vị, để clamp vị trí đã lưu ngay khi mount.
+     * Bắt buộc: nếu thiếu, một vị trí lưu từ viewport rộng hơn sẽ đặt panel ngoài màn
+     * hình, **grip biến mất**, và vì drag/reset đều cần grip nên người dùng kẹt vĩnh viễn.
+     */
+    getElement?: () => HTMLElement | null;
+    /** `useHoldDrag`: px phải đi trước khi coi là kéo. Mặc định 5px (bỏ rung chuột). */
+    moveThreshold?: number;
+}
+/**
+ * Kéo bằng cách BẤM GIỮ trên bất kỳ vị trí nào của panel — không cần grip riêng.
+ *
+ * Vì sao không `preventDefault`/`setPointerCapture` ngay ở pointerdown: làm vậy thì
+ * pointerdown của nút con bị nuốt và **nút chết** (xem bug 2026-09-30: nút expand không
+ * bấm được). Ở đây ta chờ chuột đi quá `MOVE_THRESHOLD` px mới thực sự chiếm pointer.
+ * Người dùng chỉ bấm (không di) ⇒ không có capture ⇒ click tới nút con bình thường.
+ */
+export declare function useHoldDrag({ storageKey, defaultPos, getBounds, getElement, moveThreshold, }: FloatingDragOptions): {
+    pos: FloatingPos;
+    onSurfacePointerDown: (e: React.PointerEvent<HTMLElement>) => void;
+    onSurfaceDoubleClick: (e: React.MouseEvent<HTMLElement>) => void;
+    reset: () => void;
+};
+export declare function useFloatingDrag({ storageKey, defaultPos, getBounds, getElement }: FloatingDragOptions): {
+    pos: FloatingPos;
+    onGripPointerDown: (e: React.PointerEvent<HTMLElement>) => void;
+    onGripDoubleClick: () => void;
+    reset: () => void;
+};

package/dist/dts/widget/trading/chart/useTradingHotkeys.d.ts

@@ -0,0 +1,21 @@
+export interface TradingHotkeyHandlers {
+    onBuy: () => void;
+    onSell: () => void;
+    onCloseRequest: () => void;
+}
+/**
+ * SSOT cho các phím Shift mà module này SỞ HỮU.
+ *
+ * Xuất ra để `useDrawingToolShortcuts` loại đúng các phím này khi giữ Shift — vì
+ * `toolShortcuts.ts` cũng map `B`/`S`/`C` (`shortPosition`…). Cả hai listener cùng
+ * `window` và không `stopImmediatePropagation` ⇒ trước đây `Shift+S` **vừa** chọn công cụ
+ * **vừa** mở phiếu bán. Không hardcode danh sách thứ hai ở nơi khác: nó ở đây.
+ *
+ * ⚠️ `Shift+L` / `Shift+P` / `Shift+M` **KHÔNG** thuộc về đây — chúng là binding hợp lệ
+ * của drawing tool / magnet, phải tiếp tục chạy.
+ */
+export declare const TRADING_HOTKEY_KEYS: readonly ["B", "S", "C"];
+export interface TradingHotkeyOptions extends TradingHotkeyHandlers {
+    enabled?: boolean;
+}
+export declare function useTradingHotkeys(options: TradingHotkeyOptions): void;

package/dist/dts/widget/trading/config/paperRuntimeConfig.d.ts

@@ -0,0 +1,53 @@
+/**
+ * S1: PaperRuntimeConfig — user-tunable paper trading config (§8 audit).
+ * Pure types + defaults + validators (no React, no storage — see S3 hook).
+ * All changes are PROSPECTIVE (§10 Q2): fills booked keep old values.
+ */
+export type CostBasisMethod = "average" | "fifo";
+export type PnlDisplayMode = "gross" | "net";
+export interface PaperRuntimeConfig {
+    brokerFeeRate: number;
+    commissionPerContract: number;
+    taxRate: number;
+    slippageTicks: number;
+    costBasisMethod: CostBasisMethod;
+    allowShortSelling: boolean;
+    settlementDays: number;
+    maxLeverage: number;
+    pnlDisplayMode: PnlDisplayMode;
+    effectiveFrom: number;
+}
+export declare const DEFAULT_PAPER_RUNTIME_CONFIG: PaperRuntimeConfig;
+export declare const PAPER_CONFIG_BOUNDS: {
+    readonly brokerFeeRate: {
+        readonly min: 0;
+        readonly max: 0.05;
+    };
+    readonly commissionPerContract: {
+        readonly min: 0;
+        readonly max: 100000;
+    };
+    readonly taxRate: {
+        readonly min: 0;
+        readonly max: 0.05;
+    };
+    readonly slippageTicks: {
+        readonly min: 0;
+        readonly max: 20;
+    };
+    readonly settlementDays: {
+        readonly allowed: readonly [0, 1, 2, 3];
+    };
+    readonly maxLeverage: {
+        readonly min: 1;
+        readonly max: 100;
+    };
+};
+export interface ConfigValidationError {
+    field: keyof PaperRuntimeConfig;
+    message: string;
+}
+/** Field-level validation shared by modal (S1) and hook (S3). */
+export declare function validatePaperRuntimeConfig(config: Partial<PaperRuntimeConfig>): ConfigValidationError[];
+/** Merge user partial over defaults (never mutates either). */
+export declare function resolvePaperRuntimeConfig(partial?: Partial<PaperRuntimeConfig> | null): PaperRuntimeConfig;

package/dist/dts/widget/trading/context/PaperPanelRegistry.d.ts

@@ -0,0 +1,45 @@
+import type { BrokerAccount, OrderValidationInput, TradingOrder, TradingPosition } from "../../../lib/core/trading/types";
+import type { TradingAnalytics } from "../../../lib/core/trading/AnalyticsEngine";
+import type { BrokerRuntimePatch, BrokerRuntimeSummary } from "../../../lib/core/trading/VirtualBrokerEngine";
+export interface PaperPanelSnapshot {
+    account: BrokerAccount;
+    positions: TradingPosition[];
+    orders: TradingOrder[];
+    orderHistory: TradingOrder[];
+    ordersMargin: number;
+    analytics: TradingAnalytics;
+    log: {
+        timestamp: number;
+        message: string;
+    }[];
+    /** Thống nhất single/multi: ô active bị ẩn trading bar → panel hiện CTA bật lại. */
+    tradingEnabled: boolean;
+    onEnableTrading: () => void;
+}
+export interface PaperPanelBinding {
+    chartId: string;
+    symbol: string;
+    shared: boolean;
+    getSnapshot(): PaperPanelSnapshot;
+    closePosition(positionId: string): boolean;
+    /** P1.3: đóng tất cả vị thế của ô. */
+    closeAllPositions(reason?: string): number;
+    reversePosition(positionId: string): void;
+    cancelOrder(orderId: string): boolean;
+    /** P1.3: lấy snapshot orders để bulk-cancel (working filter ở caller). */
+    getOrders(): TradingOrder[];
+    resetAccount(initialBalance?: number): void;
+    /** S2 (P5 parity F1-A): đặt lệnh qua broker của cell (cho dock form workspace). */
+    placeOrder(input: OrderValidationInput): TradingOrder;
+    subscribe(listener: () => void): () => void;
+    /** S6: apply runtime pricing/rules without recreating the broker. */
+    applyRuntimeConfig?: (patch: BrokerRuntimePatch) => BrokerRuntimeSummary;
+}
+export declare function registerPaperPanelBinding(binding: PaperPanelBinding): void;
+export declare function unregisterPaperPanelBinding(chartId: string): void;
+export declare function getPaperPanelBinding(chartId: string | null): PaperPanelBinding | undefined;
+export declare function subscribePaperPanelRegistry(chartId: string | null, listener: () => void): () => void;
+/** Re-render khi binding đến/mất (late registration) — D8, không bao giờ kẹt rỗng. */
+export declare function usePaperPanelBinding(chartId: string | null): PaperPanelBinding | undefined;
+/** Xóa toàn bộ binding giữa các test (chống rò Map — Finding-06). */
+export declare function clearAllPaperPanelBindingsForTesting(): void;

package/dist/dts/widget/trading/context/TradingContext.d.ts

@@ -0,0 +1,80 @@
+import { type ReactNode } from "react";
+import type { AsyncStorageAdapter, AudioAdapter } from "@vninvestcharts/engine-react";
+import { VirtualBrokerEngine } from "../../../lib/core/trading/VirtualBrokerEngine";
+import { MarketDataPort } from "../../../lib/core/trading/MarketDataPort";
+import { type MarketRules } from "../../../lib/core/trading/MarketRules";
+import type { ReplayOHLCBar } from "../../../lib/core/replay/replayTradingTypes";
+import type { EnrichedDatum } from "../../../lib/core/calculators/types";
+import type { OrderSide, OrderValidationInput, TradingOrder } from "../../../lib/core/trading/types";
+import type { TradingBottomPanelProps } from "../panel/TradingBottomPanel";
+export interface TradingReplayFeed {
+    active: boolean;
+    playing: boolean;
+    bar: ReplayOHLCBar | null;
+    timestamp: number;
+}
+export interface TradingProviderProps {
+    symbol: string;
+    bars: readonly EnrichedDatum[];
+    rules?: MarketRules;
+    initialBalance?: number;
+    replayActive?: boolean;
+    replayPlaying?: boolean;
+    replayBar?: ReplayOHLCBar | null;
+    /**
+     * Task 11: inject broker/port dùng chung (multi-chart singleton). Khi có,
+     * provider KHÔNG tạo engine riêng (không hydrate/reset giùm — chủ sở hữu quản lý).
+     */
+    externalBroker?: VirtualBrokerEngine;
+    externalPort?: MarketDataPort;
+    liveStorageNamespace?: string;
+    storageAdapter?: AsyncStorageAdapter;
+    audioAdapter?: AudioAdapter;
+    /** Task TVP-A0: prop ép bật/tắt (ưu tiên cao nhất). Mặc định đọc localStorage. */
+    defaultEnabled?: boolean;
+    /** Task M1+M2: định danh chart (multi) cho namespace persist + gating. */
+    chartId?: string;
+    /** Task M2: chỉ chart active nhận hotkey. Mặc định true (single-chart không ảnh hưởng). */
+    isActiveChart?: boolean;
+    children: ReactNode;
+}
+export interface TicketState {
+    open: boolean;
+    side: OrderSide;
+    price?: number;
+    /** Qty preset từ strip (không có = lot mặc định của rules). */
+    quantity?: number;
+}
+export interface EditTarget {
+    orderId: string;
+    price?: number;
+    stopPrice?: number;
+}
+export interface TradingContextValue {
+    mode: "live" | "replay";
+    symbol: string;
+    rules: MarketRules;
+    broker: VirtualBrokerEngine;
+    port: MarketDataPort;
+    tradingEnabled: boolean;
+    setTradingEnabled: (enabled: boolean) => void;
+    isActiveChart: boolean;
+    panelProps: Omit<TradingBottomPanelProps, "onClose">;
+    ticket: TicketState;
+    openTicket: (side: OrderSide, price?: number, quantity?: number) => void;
+    closeTicket: () => void;
+    editTarget: EditTarget | null;
+    startEditOrder: (orderId: string) => void;
+    cancelEdit: () => void;
+    closeRequested: boolean;
+    requestClose: () => void;
+    cancelCloseRequest: () => void;
+    confirmCloseAll: () => void;
+    oneKeyClose: boolean;
+    setOneKeyClose: (enabled: boolean) => void;
+    /** Đặt lệnh qua broker + log rejection (one-click/ticket đỡ im lặng). */
+    placeOrder: (input: OrderValidationInput) => TradingOrder;
+}
+export declare function useTradingContext(): TradingContextValue;
+export declare function liveNamespace(explicit: string | undefined, chartId: string | undefined, profile: string): string;
+export declare function TradingProvider({ symbol, bars, rules: rulesProp, initialBalance, replayActive, replayPlaying, replayBar, liveStorageNamespace, storageAdapter, audioAdapter, externalBroker, externalPort, defaultEnabled, chartId, isActiveChart, children, }: TradingProviderProps): import("react").JSX.Element;

package/dist/dts/widget/trading/context/WorkspaceTradingSync.d.ts

@@ -0,0 +1,24 @@
+import { type BroadcastChannelAdapter } from "@vninvestcharts/engine-react";
+import type { BrokerAccount, TradingOrder, TradingPosition } from "../../../lib/core/trading/types";
+export declare const TRADING_SYNC_DOMAIN = "paper-trading";
+export declare const TRADING_SYNC_WORKSPACE = "vnsc_trading_sync";
+export interface TradingSyncSnapshot {
+    account: BrokerAccount;
+    positions: TradingPosition[];
+    orders: TradingOrder[];
+    updatedAt: number;
+}
+export interface TradingSyncHandler {
+    (snapshot: TradingSyncSnapshot, fromId: string): void;
+}
+export declare class WorkspaceTradingSync {
+    private readonly adapter;
+    private readonly chartId;
+    private readonly workspaceId;
+    private disposeFn;
+    constructor(workspaceId?: string, chartId?: string, adapter?: BroadcastChannelAdapter | null);
+    get id(): string;
+    broadcastState(snapshot: Omit<TradingSyncSnapshot, "updatedAt">): void;
+    subscribe(handler: TradingSyncHandler): () => void;
+    dispose(): void;
+}

package/dist/dts/widget/trading/hooks/usePaperRuntimeConfig.d.ts

@@ -0,0 +1,36 @@
+import type { MarketRules } from "../../../lib/core/trading/MarketRules";
+import type { ExecutionSimulatorOptions } from "../../../lib/core/trading/ExecutionSimulator";
+import { type PaperRuntimeConfig } from "../config/paperRuntimeConfig";
+export declare const PAPER_CONFIG_EVENT = "vnsc_paper_config_changed";
+export interface PaperConfigChangedDetail {
+    profile: string;
+    chartId?: string;
+    config: PaperRuntimeConfig;
+}
+export declare function paperConfigKey(profile: string, chartId?: string | null): string;
+/**
+ * Merge user config over base market rules. Pure, never mutates inputs —
+ * method refs (validateOrder/getTickSize) ride along by reference, so merged
+ * copies keep working (S2 this-fix).
+ */
+export declare function mergeMarketRules(base: MarketRules, user: Partial<PaperRuntimeConfig>): MarketRules;
+/** Split user config into engine-shaped pieces (rules vs simulator knobs). */
+export declare function splitEnginePatch(user: Partial<PaperRuntimeConfig>): {
+    rulesPatch: Partial<MarketRules>;
+    simulatorOptions: ExecutionSimulatorOptions;
+};
+export interface UsePaperRuntimeConfigOptions {
+    profile: string;
+    chartId?: string | null;
+    baseRules: MarketRules;
+}
+export interface UsePaperRuntimeConfigReturn {
+    config: PaperRuntimeConfig;
+    perChartOverride: boolean;
+    setPerChartOverride: (override: boolean) => void;
+    save: (partial: Partial<PaperRuntimeConfig>) => PaperRuntimeConfig | null;
+    mergedRules: MarketRules;
+    simulatorOptions: ExecutionSimulatorOptions;
+    version: number;
+}
+export declare function usePaperRuntimeConfig({ profile, chartId, baseRules, }: UsePaperRuntimeConfigOptions): UsePaperRuntimeConfigReturn;

package/dist/dts/widget/trading/index.d.ts

@@ -0,0 +1,5 @@
+export { TradingProvider, useTradingContext, type TradingContextValue, type TradingReplayFeed } from "./context/TradingContext";
+export { TradingChartSurface } from "./chart/TradingChartSurface";
+export { ConnectedTradingPanel } from "./panel/ConnectedTradingPanel";
+export { TradingDockPanel } from "./ticket/TradingDockPanel";
+export { ConnectedTradingDockPanel } from "./ticket/ConnectedTradingDockPanel";

package/dist/dts/widget/trading/panel/AccountSummaryTab.d.ts

@@ -0,0 +1,7 @@
+import type { BrokerAccount } from "../../../lib/core/trading/types";
+import type { TradingAnalytics } from "../../../lib/core/trading/AnalyticsEngine";
+export interface AccountSummaryTabProps {
+    account: BrokerAccount;
+    analytics: TradingAnalytics;
+}
+export declare function AccountSummaryTab({ account, analytics }: AccountSummaryTabProps): import("react").JSX.Element;

package/dist/dts/widget/trading/panel/ActiveChartPaperPanel.d.ts

@@ -0,0 +1,26 @@
+import { type PaperPanelSnapshot } from "../context/PaperPanelRegistry";
+import type { BrokerAccount } from "../../../lib/core/trading/types";
+import type { TradingAnalytics } from "../../../lib/core/trading/AnalyticsEngine";
+export declare const EMPTY_PAPER_ACCOUNT: BrokerAccount;
+export interface ActiveChartReplaySource {
+    broker: {
+        getAccount(): BrokerAccount;
+        getPositions(): PaperPanelSnapshot["positions"];
+        getOrders(): PaperPanelSnapshot["orders"];
+        getAnalytics(): TradingAnalytics;
+    };
+    log: {
+        timestamp: number;
+        message: string;
+    }[];
+    closePosition(positionId: string): boolean | void;
+    reversePosition(positionId: string): void;
+    cancelOrder(orderId: string): boolean | void;
+    reset(): void;
+}
+export interface ActiveChartPaperPanelProps {
+    chartId: string | null;
+    replay?: ActiveChartReplaySource | null;
+    onClose?: () => void;
+}
+export declare function ActiveChartPaperPanel({ chartId, replay, onClose }: ActiveChartPaperPanelProps): import("react").JSX.Element;

package/dist/dts/widget/trading/panel/ConnectedTradingPanel.d.ts

@@ -0,0 +1,3 @@
+export declare function ConnectedTradingPanel({ onClose }: {
+    onClose?: () => void;
+}): import("react").JSX.Element;

package/dist/dts/widget/trading/panel/HistoryTab.d.ts

@@ -0,0 +1,5 @@
+import type { TradingOrder } from "../../../lib/core/trading/types";
+export interface HistoryTabProps {
+    orders: TradingOrder[];
+}
+export declare function HistoryTab({ orders }: HistoryTabProps): import("react").JSX.Element;

package/dist/dts/widget/trading/panel/MarketFallbackBanner.d.ts

@@ -0,0 +1,4 @@
+export declare function MarketFallbackBanner({ symbol, onOpenSettings, }: {
+    symbol: string | null | undefined;
+    onOpenSettings: () => void;
+}): import("react").JSX.Element | null;

package/dist/dts/widget/trading/panel/OrdersTab.d.ts

@@ -0,0 +1,8 @@
+import type { TradingOrder } from "../../../lib/core/trading/types";
+export interface OrdersTabProps {
+    orders: TradingOrder[];
+    onCancelOrder: (orderId: string) => void;
+    /** P1.3: hủy tất cả lệnh chờ (optional — ẩn khi không truyền). */
+    onCancelAllOrders?: () => void;
+}
+export declare function OrdersTab({ orders, onCancelOrder, onCancelAllOrders }: OrdersTabProps): import("react").JSX.Element;

package/dist/dts/widget/trading/panel/PaperCapitalDialog.d.ts

@@ -0,0 +1,8 @@
+export interface PaperCapitalDialogProps {
+    open: boolean;
+    currency: string;
+    defaultAmount: number;
+    onConfirm: (amount: number) => void;
+    onCancel: () => void;
+}
+export declare function PaperCapitalDialog({ open, currency, defaultAmount, onConfirm, onCancel }: PaperCapitalDialogProps): import("react").JSX.Element | null;

package/dist/dts/widget/trading/panel/PaperSettingsModal.d.ts

@@ -0,0 +1,17 @@
+import { type PaperRuntimeConfig } from "../config/paperRuntimeConfig";
+export interface PaperSettingsModalProps {
+    open: boolean;
+    initial: PaperRuntimeConfig;
+    perChartOverride: boolean;
+    onToggleOverride: (override: boolean) => void;
+    onSave: (config: Partial<PaperRuntimeConfig>) => void;
+    onCancel: () => void;
+    /** S4-polish: hide settlement cycle for non-VN markets (meaningless for crypto). */
+    hideSettlement?: boolean;
+    /**
+     * Audit-2 P0#3: hide VN-specific fee rows (sell tax, flat VND
+     * commission) for non-VN profiles — crypto uses maker/taker only.
+     */
+    hideVnFees?: boolean;
+}
+export declare function PaperSettingsModal({ open, initial, perChartOverride, onToggleOverride, onSave, onCancel, hideSettlement, hideVnFees, }: PaperSettingsModalProps): import("react").JSX.Element | null;

package/dist/dts/widget/trading/panel/PositionsTab.d.ts

@@ -0,0 +1,15 @@
+import type { TradingOrder, TradingPosition } from "../../../lib/core/trading/types";
+export interface PositionsTabProps {
+    positions: TradingPosition[];
+    orders: TradingOrder[];
+    onClosePosition: (positionId: string) => void;
+    onReversePosition: (positionId: string) => void;
+    /** P1.3: đóng tất cả vị thế (optional — ẩn khi không truyền). */
+    onCloseAllPositions?: () => void;
+    /** S6: PnL display mode + exit-cost rates for the net estimate. */
+    pnlDisplayMode?: "gross" | "net";
+    exitFeeRate?: number;
+    exitTaxRate?: number;
+    onTogglePnlDisplay?: () => void;
+}
+export declare function PositionsTab({ positions, orders, onClosePosition, onReversePosition, onCloseAllPositions, pnlDisplayMode, exitFeeRate, exitTaxRate, onTogglePnlDisplay, }: PositionsTabProps): import("react").JSX.Element;

package/dist/dts/widget/trading/panel/TradeHistoryTab.d.ts

@@ -0,0 +1,5 @@
+import type { ClosedTradeRecord } from "../../../lib/core/trading/AnalyticsEngine";
+export interface TradeHistoryTabProps {
+    trades: ClosedTradeRecord[];
+}
+export declare function TradeHistoryTab({ trades }: TradeHistoryTabProps): import("react").JSX.Element;

package/dist/dts/widget/trading/panel/TradingBottomPanel.d.ts

@@ -0,0 +1,36 @@
+import { type ReactNode } from "react";
+import type { BrokerAccount, TradingOrder, TradingPosition } from "../../../lib/core/trading/types";
+import type { TradingAnalytics } from "../../../lib/core/trading/AnalyticsEngine";
+import type { PanelLogEntry } from "./TradingLogTab";
+import type { PaperRuntimeConfig } from "../config/paperRuntimeConfig";
+export type TradingPanelTab = "positions" | "orders" | "history" | "trades" | "summary" | "log";
+export interface TradingBottomPanelProps {
+    account: BrokerAccount;
+    positions: TradingPosition[];
+    orders: TradingOrder[];
+    orderHistory: TradingOrder[];
+    ordersMargin: number;
+    analytics: TradingAnalytics;
+    log: PanelLogEntry[];
+    onClosePosition: (positionId: string) => void;
+    onReversePosition: (positionId: string) => void;
+    onCancelOrder: (orderId: string) => void;
+    /** P1.3: bulk actions (optional — ẩn khi không truyền, backward-compat). */
+    onCloseAllPositions?: () => void;
+    onCancelAllOrders?: () => void;
+    onResetAccount: (initialBalance?: number) => void;
+    onClose?: () => void;
+    tradingEnabled?: boolean;
+    onEnableTrading?: () => void;
+    /** Badge ô chart (multi follow-active) — render trong header, không đụng layout flex. */
+    titleBadge?: ReactNode;
+    /** S4: active symbol for the market-fallback banner. */
+    symbol?: string | null;
+    paperConfig?: PaperRuntimeConfig;
+    onSavePaperConfig?: (config: Partial<PaperRuntimeConfig>) => void;
+    pnlDisplayMode?: "gross" | "net";
+    exitFeeRate?: number;
+    exitTaxRate?: number;
+    onTogglePnlDisplay?: () => void;
+}
+export declare function TradingBottomPanel({ account, positions, orders, orderHistory, ordersMargin, analytics, log, onClosePosition, onReversePosition, onCancelOrder, onCloseAllPositions, onCancelAllOrders, onResetAccount, onClose, tradingEnabled, onEnableTrading, titleBadge, symbol, paperConfig, onSavePaperConfig, pnlDisplayMode, exitFeeRate, exitTaxRate, onTogglePnlDisplay, }: TradingBottomPanelProps): import("react").JSX.Element;

package/dist/dts/widget/trading/panel/TradingLogTab.d.ts

@@ -0,0 +1,8 @@
+export interface PanelLogEntry {
+    timestamp: number;
+    message: string;
+}
+export interface TradingLogTabProps {
+    log: PanelLogEntry[];
+}
+export declare function TradingLogTab({ log }: TradingLogTabProps): import("react").JSX.Element;

package/dist/dts/widget/trading/panel/TradingPanelHeader.d.ts

@@ -0,0 +1,17 @@
+import type { BrokerAccount, TradingPosition } from "../../../lib/core/trading/types";
+import { type PaperRuntimeConfig } from "../config/paperRuntimeConfig";
+export interface TradingPanelHeaderProps {
+    account: BrokerAccount;
+    positions: TradingPosition[];
+    realizedPnl: number;
+    ordersMargin: number;
+    onResetAccount: (initialBalance?: number) => void;
+    onExportCsv: () => void;
+    paperConfig?: PaperRuntimeConfig;
+    onSavePaperConfig?: (config: Partial<PaperRuntimeConfig>) => void;
+    /** S4: symbol for the market-fallback banner (unclassified → VN_SPOT). */
+    symbol?: string | null;
+}
+export declare const MARGIN_SAFE_THRESHOLD = 150;
+export declare const MARGIN_WARNING_THRESHOLD = 100;
+export declare function TradingPanelHeader({ account, positions, realizedPnl, ordersMargin, onResetAccount, onExportCsv, paperConfig, onSavePaperConfig, symbol }: TradingPanelHeaderProps): import("react").JSX.Element;

package/dist/dts/widget/trading/panel/csvExport.d.ts

@@ -0,0 +1,18 @@
+import type { ClosedTradeRecord } from "../../../lib/core/trading/AnalyticsEngine";
+import type { TradingOrder, TradingPosition } from "../../../lib/core/trading/types";
+export declare function toCsvCell(value: unknown): string;
+export declare function buildCsv(headers: string[], rows: unknown[][]): string;
+export declare function positionsToRows(positions: TradingPosition[]): {
+    headers: string[];
+    rows: unknown[][];
+};
+export declare function ordersToRows(orders: TradingOrder[]): {
+    headers: string[];
+    rows: unknown[][];
+};
+export declare function tradesToRows(trades: ClosedTradeRecord[]): {
+    headers: string[];
+    rows: unknown[][];
+};
+/** Tải file CSV (BOM UTF-8 cho Excel Windows). Trả false khi môi trường thiếu API. */
+export declare function downloadCsv(filename: string, csv: string): boolean;

package/dist/dts/widget/trading/ticket/ConnectedTradingDockPanel.d.ts

@@ -0,0 +1,5 @@
+export declare function ConnectedTradingDockPanel({ canUseAdvancedOrders, canUseReplayTrading, isReplayMode }: {
+    canUseAdvancedOrders?: boolean;
+    canUseReplayTrading?: boolean;
+    isReplayMode?: boolean;
+}): import("react").JSX.Element;

package/dist/dts/widget/trading/ticket/OrderTicketForm.d.ts

@@ -0,0 +1,31 @@
+import type { MarketRules } from "../../../lib/core/trading/MarketRules";
+import type { OrderType, OrderValidationInput, TradingPosition } from "../../../lib/core/trading/types";
+export interface OrderTicketAccount {
+    equity: number;
+    freeMargin: number;
+    buyingPower: number;
+}
+export interface OrderTicketFormProps {
+    side: "buy" | "sell";
+    symbol: string;
+    lastPrice: number;
+    rules: MarketRules;
+    account: OrderTicketAccount;
+    currentPosition?: TradingPosition | null;
+    onClose: () => void;
+    onSubmit: (order: OrderValidationInput) => void;
+    /** Edit-mode (Task 10): prefill + lưu qua onModify thay vì đặt lệnh mới. */
+    initialValues?: {
+        price?: number;
+        stopPrice?: number;
+    };
+    /** Qty preset từ strip (mặc định = lot của rules). */
+    initialQuantity?: number;
+    initialType?: OrderType;
+    editOrderId?: string;
+    onModify?: (orderId: string, patch: {
+        price?: number;
+        stopPrice?: number;
+    }) => void;
+}
+export declare function OrderTicketForm({ side, symbol, lastPrice, rules, account, currentPosition, onClose, onSubmit, initialValues, initialQuantity, initialType, editOrderId, onModify, }: OrderTicketFormProps): import("react").JSX.Element;

package/dist/dts/widget/trading/ticket/OrderTicketModal.d.ts

@@ -0,0 +1,29 @@
+import type { MarketRules } from "../../../lib/core/trading/MarketRules";
+import type { OrderType, OrderValidationInput, TradingPosition } from "../../../lib/core/trading/types";
+import { type OrderTicketAccount } from "./OrderTicketForm";
+export type { OrderTicketAccount };
+export interface OrderTicketModalProps {
+    open: boolean;
+    side: "buy" | "sell";
+    symbol: string;
+    lastPrice: number;
+    rules: MarketRules;
+    account: OrderTicketAccount;
+    currentPosition?: TradingPosition | null;
+    mountTarget?: Element | null;
+    onClose: () => void;
+    onSubmit: (order: OrderValidationInput) => void;
+    /** Edit-mode (Task 10): prefill + lưu qua onModify thay vì đặt lệnh mới. */
+    initialValues?: {
+        price?: number;
+        stopPrice?: number;
+    };
+    initialQuantity?: number;
+    initialType?: OrderType;
+    editOrderId?: string;
+    onModify?: (orderId: string, patch: {
+        price?: number;
+        stopPrice?: number;
+    }) => void;
+}
+export declare function OrderTicketModal({ open, mountTarget, onClose, ...formProps }: OrderTicketModalProps): import("react").JSX.Element | null;

package/dist/dts/widget/trading/ticket/RegistryTradingDockPanel.d.ts

@@ -0,0 +1,9 @@
+export interface RegistryTradingDockPanelProps {
+    chartId: string | null;
+    lastPrice: number;
+    /** Replay mode (không binding replay) hoặc tắt trading → disable form. */
+    disabled?: boolean;
+    /** S1: quyền lệnh nâng cao từ capability (tôn trọng license `caps`). */
+    canUseAdvancedOrders?: boolean;
+}
+export declare function RegistryTradingDockPanel({ chartId, lastPrice, disabled, canUseAdvancedOrders }: RegistryTradingDockPanelProps): React.ReactNode;

package/dist/dts/widget/trading/ticket/RiskCalculatorView.d.ts

@@ -0,0 +1,9 @@
+export interface RiskCalculatorViewProps {
+    entryPrice: number;
+    quantity: number;
+    takeProfitPrice?: number;
+    stopLossPrice?: number;
+    contractMultiplier?: number;
+    accountEquity: number;
+}
+export declare function RiskCalculatorView({ entryPrice, quantity, takeProfitPrice, stopLossPrice, contractMultiplier, accountEquity, }: RiskCalculatorViewProps): import("react").JSX.Element | null;