@vninvestcharts/widget 0.0.0-stage → 0.2.0

package/dist/dts/widget/components/overlays/WhalePanel.d.ts

@@ -0,0 +1,5 @@
+import type { WhaleFeedResponse } from "../../../lib/types/vninvest";
+export interface WhalePanelProps {
+    data: WhaleFeedResponse | null;
+}
+export declare function WhalePanel({ data }: WhalePanelProps): import("react").JSX.Element;

package/dist/dts/widget/components/panels/AdvisoryPanel.d.ts

@@ -0,0 +1,25 @@
+import { type AdvisoryResult as BaseAdvisoryResult } from "../../../lib/types/vninvest";
+export interface AdvisoryResult extends Partial<BaseAdvisoryResult> {
+    recommendation?: string;
+    reasoning?: string;
+    keyLevels?: Array<{
+        type: string;
+        price: number;
+        description: string;
+    }>;
+    riskFactors?: string[];
+}
+export interface AdvisoryPanelProps {
+    /** Show the panel */
+    show: boolean;
+    /** Advisory result from API */
+    result: AdvisoryResult | null;
+    /** Loading state */
+    isLoading: boolean;
+    /** Refresh callback */
+    onRefresh?: () => void;
+}
+export declare const AdvisoryPanel: {
+    ({ show, result, isLoading, onRefresh }: AdvisoryPanelProps): import("react").JSX.Element | null;
+    displayName: string;
+};

package/dist/dts/widget/components/panels/PineEditorPanel.d.ts

@@ -0,0 +1,18 @@
+export interface PineEditorPanelProps {
+    onAddIndicator: (config: any) => void;
+    bars?: {
+        open: number[];
+        high: number[];
+        low: number[];
+        close: number[];
+        volume: number[];
+    };
+    /**
+     * 1.6b: series types the host already has on the chart. A saved script is restored only when
+     * its type appears here, which is what makes the restore idempotent (it never dispatches
+     * `addSeries`, so StrictMode cannot duplicate a series) and stops it resurrecting a Pine series
+     * the user deleted from the chart but kept in the editor.
+     */
+    restorableSeriesTypes?: readonly string[];
+}
+export declare function PineEditorPanel({ onAddIndicator, bars, restorableSeriesTypes }: PineEditorPanelProps): import("react").JSX.Element;

package/dist/dts/widget/components/panels/StrategyTesterPanel.d.ts

@@ -0,0 +1,7 @@
+export interface StrategyTesterPanelProps {
+    plotData: any[];
+    symbol: string;
+    timeframe: string;
+    activeIndicators: any[];
+}
+export declare function StrategyTesterPanel({ plotData, symbol, timeframe, activeIndicators }: StrategyTesterPanelProps): import("react").JSX.Element;

package/dist/dts/widget/components/panels/TapePanel.d.ts

@@ -0,0 +1,17 @@
+import { type TapeEntry } from "../../../lib/types/vninvest";
+export interface TapePanelProps {
+    /** Show the panel */
+    show: boolean;
+    /** Tape entries (most recent last) */
+    entries: readonly TapeEntry[];
+    /** Loading state */
+    isLoading: boolean;
+    /** Filter in billions VND */
+    filterBillions: number;
+    /** Filter change callback */
+    onFilterChange?: (billions: number) => void;
+}
+export declare const TapePanel: {
+    ({ show, entries, isLoading, filterBillions, onFilterChange }: TapePanelProps): import("react").JSX.Element | null;
+    displayName: string;
+};

package/dist/dts/widget/components/panels/index.d.ts

@@ -0,0 +1,8 @@
+export { AdvisoryPanel } from "./AdvisoryPanel";
+export type { AdvisoryPanelProps } from "./AdvisoryPanel";
+export { TapePanel } from "./TapePanel";
+export type { TapePanelProps } from "./TapePanel";
+export { StrategyTesterPanel } from "./StrategyTesterPanel";
+export type { StrategyTesterPanelProps } from "./StrategyTesterPanel";
+export { PineEditorPanel } from "./PineEditorPanel";
+export type { PineEditorPanelProps } from "./PineEditorPanel";

package/dist/dts/widget/components/replay/FloatingReplayToolbar.d.ts

@@ -0,0 +1,24 @@
+import type { ReplayAnalyticsStats } from "../../../lib/core/replay/ReplaySessionAnalytics";
+export interface FloatingReplayToolbarProps {
+    replayPlaying?: boolean;
+    replaySpeed?: number;
+    replayCurrentBar?: number;
+    replayTotalBars?: number;
+    onReplayPlay?: () => void;
+    onReplayPause?: () => void;
+    onReplayStop?: () => void;
+    onReplayStepForward?: () => void;
+    onReplayStepBack?: () => void;
+    onReplayRewind?: () => void;
+    onReplaySpeedChange?: (speed: number) => void;
+    onReplaySeek?: (barIndex: number) => void;
+    replayInterval?: string;
+    onReplayIntervalChange?: (interval: string) => void;
+    replayMode?: "single" | "all";
+    onReplayModeChange?: (mode: "single" | "all") => void;
+    replayTotalPnl?: number;
+    replayAnalytics?: ReplayAnalyticsStats;
+    onJumpToBar?: () => void;
+    onClose?: () => void;
+}
+export declare function FloatingReplayToolbar({ replayPlaying, replaySpeed, replayCurrentBar, replayTotalBars, onReplayPlay, onReplayPause, onReplayStop, onReplayStepForward, onReplayStepBack, onReplayRewind, onReplaySpeedChange, onReplaySeek, replayInterval, onReplayIntervalChange, replayMode, onReplayModeChange, replayTotalPnl, replayAnalytics, onJumpToBar, onClose, }: FloatingReplayToolbarProps): import("react").JSX.Element;

package/dist/dts/widget/components/replay/ReplayCutOverlay.d.ts

@@ -0,0 +1,8 @@
+import type { EngineOverlayCrosshairSnapshot } from "@vninvestcharts/engine-core";
+export interface ReplayCutOverlayProps {
+    crosshair: EngineOverlayCrosshairSnapshot | null;
+    plotData: ReadonlyArray<{
+        date?: Date | number | null;
+    }>;
+}
+export declare function ReplayCutOverlay({ crosshair, plotData }: ReplayCutOverlayProps): import("react").JSX.Element | null;

package/dist/dts/widget/components/search/SymbolCompareModal.d.ts

@@ -0,0 +1,24 @@
+/**
+ * P2 unified compare entry (SYMBOL_SEARCH): one modal hosting VNSymbolSearch
+ * mode="unified" (Switch + Compare per row). Shared by single + multi chart
+ * so both surfaces render the identical dialog.
+ */
+import type { StockDataAdapter } from "../../../lib/types/adapter";
+import type { VNInvestClient } from "../../adapters/VNInvestClient";
+import type { ComparisonOverlayEntry } from "../../hooks/useComparisonState";
+export interface SymbolCompareModalProps {
+    adapter?: StockDataAdapter;
+    client?: VNInvestClient;
+    /** Current main-chart symbol — matching rows render disabled (no self-compare). */
+    mainSymbol?: string;
+    /** Main-symbol switch (caller also closes the dialog). Unused while allowSwitch is false. */
+    onSwitch: (symbol: string) => void;
+    onTimeframeChange?: (timeframe: string) => void;
+    existing: string[];
+    entries?: ComparisonOverlayEntry[];
+    onAdd: (symbolId: string) => void;
+    onRemove: (symbolId: string) => void;
+    onUpdate?: (symbolId: string, partial: Partial<ComparisonOverlayEntry>) => void;
+    onClose: () => void;
+}
+export declare function SymbolCompareModal(p: SymbolCompareModalProps): import("react").JSX.Element;

package/dist/dts/widget/components/search/SymbolSearchModal.d.ts

@@ -0,0 +1,12 @@
+/**
+ * P2-c: SymbolSearchModal — centered TradingView-style symbol search dialog.
+ * Wraps VNSymbolSearch (keyboard nav / filters / recents reused as-is).
+ * Renders fixed-position so it centers on viewport incl. Shadow DOM hosts.
+ */
+import { type ReactNode } from "react";
+export interface SymbolSearchModalProps {
+    open: boolean;
+    onClose: () => void;
+    children?: ReactNode;
+}
+export declare function SymbolSearchModal({ open, onClose, children }: SymbolSearchModalProps): import("react").JSX.Element | null;

package/dist/dts/widget/components/search/VNSymbolSearch.d.ts

@@ -0,0 +1,83 @@
+import type { StockDataAdapter } from "../../../lib/types/adapter";
+import type { VNInvestClient } from "../../adapters/VNInvestClient";
+import type { ComparisonOverlayEntry } from "../../hooks/useComparisonState";
+import type { SymbolSearchItem } from "../../types/symbolSearch";
+/** Unified compare controls (P2): single object replacing the 5 loose compare* props. */
+export interface SymbolSearchCompare {
+    existing: string[];
+    entries?: ComparisonOverlayEntry[];
+    onAdd: (symbolId: string, options?: {
+        color?: string;
+    }) => void;
+    onRemove: (symbolId: string) => void;
+    onUpdate?: (symbolId: string, partial: Partial<ComparisonOverlayEntry>) => void;
+    open?: boolean;
+    onClose?: () => void;
+}
+export interface VNSymbolSearchProps {
+    /** New: standard adapter interface. */
+    adapter?: StockDataAdapter;
+    /** Legacy: direct VNInvestClient reference (backward compat with demo). */
+    client?: VNInvestClient;
+    /** Current symbol (required in symbol mode, unused in compare mode). */
+    value?: string;
+    /** Fired on symbol selection (required in symbol mode, unused in compare mode). */
+    onChange?: (symbol: string) => void;
+    onItemSelect?: (item: SymbolSearchItem) => void;
+    /** If provided, called on input focus instead of opening dropdown. */
+    onFocusGuard?: () => void;
+    /** If set, opens the search with this prefix pre-filled (for quick keyboard entry). */
+    quickEntryPrefix?: string;
+    /** Fired when search includes a timeframe suffix (e.g. "VIC 1D", "BTCUSDT 1h"). */
+    onTimeframeChange?: (timeframe: string) => void;
+    /** Operation mode: "symbol" (default) for main switching, "compare" (legacy) for overlay picker, "unified" for both in one modal (P2). */
+    mode?: "unified" | "symbol" | "compare";
+    /**
+     * Default pick action for row/chip/Enter in unified mode.
+     * - "switch" (default): P2 behavior — row click / plain Enter replaces the main symbol.
+     * - "compare": row click / plain Enter adds a comparison overlay and keeps the panel open.
+     *   Used by SymbolCompareModal so the compare dialog can never replace the main symbol.
+     */
+    defaultAction?: "switch" | "compare";
+    /**
+     * Show the per-row Switch button in unified mode.
+     * Defaults to true unless defaultAction === "compare" (TradingView compare dialog has no Switch).
+     */
+    allowSwitch?: boolean;
+    /**
+     * Current main-chart symbol (e.g. "VIC"). Matching rows render disabled with a
+     * "Current" badge — a symbol can never be compared against itself.
+     */
+    mainSymbol?: string;
+    /** Compare mode: whether the dialog is open. */
+    compareOpen?: boolean;
+    /** Compare mode: close callback. */
+    onCompareClose?: () => void;
+    /** Compare mode: add a comparison overlay. */
+    onAddCompareSymbol?: (symbolId: string, options?: {
+        color?: string;
+    }) => void;
+    /** Compare mode: remove a comparison overlay. */
+    onRemoveCompareSymbol?: (symbolId: string) => void;
+    /** Compare mode: list of currently compared symbol IDs (filters them out of results). */
+    compareExistingOverlays?: string[];
+    /** Compare mode: full overlay entries for rich display (visibility, normalizeToBaseline, color). */
+    compareOverlayEntries?: ComparisonOverlayEntry[];
+    /** Compare mode: update a specific overlay property. */
+    onUpdateCompareOverlay?: (symbolId: string, partial: Partial<ComparisonOverlayEntry>) => void;
+    /** Unified compare object (P2). Loose compare* props above are shimmed into it (deprecated). */
+    compare?: SymbolSearchCompare;
+    /** Symbol mode: controlled open state (for external trigger, e.g. toolbar button). */
+    open?: boolean;
+    /** Symbol mode: called when open state changes. */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Flat layout: render results in normal flow instead of a floating dropdown.
+     * Required when embedded in SymbolSearchModal (the modal panel already
+     * provides border/background — a nested absolute dropdown stacks 2 layers).
+     */
+    flat?: boolean;
+}
+export declare function VNSymbolSearch({ adapter, client, value, onChange, onItemSelect, onFocusGuard, quickEntryPrefix, onTimeframeChange, mode, compareOpen, onCompareClose, onAddCompareSymbol, onRemoveCompareSymbol, compareExistingOverlays, compareOverlayEntries, onUpdateCompareOverlay, compare: compareProp, defaultAction, allowSwitch, mainSymbol, open: openProp, onOpenChange, flat, }: VNSymbolSearchProps): import("react").JSX.Element;
+/** SSOT alias (SYMBOL_SEARCH P1): single search component for symbol + compare. */
+export { VNSymbolSearch as SymbolSearch };

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

@@ -0,0 +1,74 @@
+import { AlertCondition, AlertConditionType, AlertSource } from "../../../lib/alerts/types";
+import type { PortalAdapter } from "@vninvestcharts/engine-react";
+export interface AlertsModalProps {
+    open: boolean;
+    onClose: () => void;
+    symbol: string;
+    timeframe: string;
+    alertManager: any;
+    portalAdapter?: PortalAdapter;
+}
+/**
+ * SSOT cho các key giá mà nhánh `type: "price"` đọc được.
+ *
+ * Trước đây danh sách này bị viết lặp ở hai `<select>` và **không ai validate
+ * nó**, nên form có thể persist một key không tồn tại. Đó không phải chuyện giả định:
+ * `AlertsModal.tsx:197-208` (effect cũ) ghi đè `sourceAKey` bằng output của indicator
+ * kể cả khi `sourceAType === "price"`, và với RSI (output đầu là `"line"`) điều đó làm
+ * alert lưu `{type:"price", key:"line"}`. `AlertEvaluator.getValue` đọc `datum["line"]`
+ * → `undefined` → `null` ⇒ **không bao giờ fire**. Tệ hơn: `<select>` có `value="line"`
+ * khớp 0 `<option>` nên trình duyệt hiển thị option đầu (`close`) — **UI khẳng định một
+ * điều kiện, alert lưu điều kiện khác**.
+ *
+ * Vì vậy giá trị ở đây vừa sinh `<option>` vừa là predicate: một key không thuộc đây
+ * là key không đọc được, và form không được lưu nó.
+ */
+export declare const PRICE_SOURCE_KEYS: readonly ["close", "open", "high", "low"];
+export declare function isPriceSourceKey(key: string | undefined): boolean;
+/** Everything the create-alert form collects, as one flat bag, so the builder
+ *  below stays pure and testable without mounting React or the portal. */
+export interface AlertDraftInput {
+    id: string;
+    symbol: string;
+    timeframe: string;
+    sourceAType: "price" | "indicator";
+    sourceAKey: string;
+    sourceAIndicatorId: string;
+    condition: AlertConditionType;
+    sourceBType: "value" | "price" | "indicator";
+    sourceBValue: string;
+    sourceBKey: string;
+    sourceBIndicatorId: string;
+    frequency: AlertCondition["frequency"];
+    actionPopup: boolean;
+    actionSound: boolean;
+    webhookUrl: string;
+    message: string;
+    createdAt: number;
+}
+/**
+ * The source-B half of an alert, in the shape it is PERSISTED.
+ *
+ * The threshold lives at `sourceB.value` — NOT at a top-level `sourceBValue`.
+ * Four independent places agree on that key and none mentions the other:
+ *   - src/lib/alerts/types.ts:12        `AlertSource.value?: number` ("for sourceB")
+ *   - src/lib/alerts/types.ts:15-33     `AlertCondition` has NO `sourceBValue`
+ *   - src/lib/alerts/AlertEvaluator.ts:38-40   reads `source.value`
+ *   - src/lib/alerts/AlertManager.ts:136       JSON.stringify(this.alerts), verbatim
+ *
+ * A missing or non-numeric threshold is stored as `value: undefined`, i.e. the
+ * key is simply ABSENT from the persisted JSON, and AlertEvaluator.getValue then
+ * returns null so the alert can never fire. It must NOT be coerced to 0:
+ * "price > 0" is a real, wrong, user-visible alert, while a null threshold fails
+ * closed. This is the third fabricated zero this repo has been bitten by.
+ */
+export declare function buildAlertSourceB(input: {
+    sourceBType: "value" | "price" | "indicator";
+    sourceBValue: string;
+    sourceBKey: string;
+    sourceBIndicatorId: string;
+}): AlertSource;
+/** The exact object handed to AlertManager.addAlert(). Pure — no Date.now(),
+ *  no React state, so a test can assert the persisted shape deterministically. */
+export declare function buildAlertDraft(input: AlertDraftInput): AlertCondition;
+export declare function AlertsModal({ open, onClose, symbol, timeframe, alertManager, portalAdapter }: AlertsModalProps): import("react").ReactPortal | null;

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

@@ -0,0 +1,58 @@
+/**
+ * Settings Context & State Management
+ * SSOT for Chart Settings across all 8 modular tabs
+ */
+import React, { type ReactNode } from "react";
+import type { ChartSettingsState, SettingsTabId } from "./model/chartSettingsSchema";
+import type { StorageAdapter } from "@vninvestcharts/engine-react";
+export interface SettingsContextValue {
+    settings: ChartSettingsState;
+    activeTab: SettingsTabId;
+    setActiveTab: (tab: SettingsTabId) => void;
+    searchQuery: string;
+    setSearchQuery: (query: string) => void;
+    updateSection: <K extends keyof Omit<ChartSettingsState, "version">>(section: K, patch: Partial<ChartSettingsState[K]>) => void;
+    resetSection: <K extends keyof Omit<ChartSettingsState, "version">>(section: K) => void;
+    resetAll: () => void;
+}
+export declare function useSettingsContext(): SettingsContextValue;
+export interface SettingsProviderProps {
+    children: ReactNode;
+    isDark?: boolean;
+    themePreset?: string;
+    storageAdapter?: StorageAdapter;
+    initialTab?: SettingsTabId;
+    onOverlayTimeframeChange?: (next: string | undefined) => void;
+    onOverlayStyleChange?: (next: "hollow" | "step" | "area" | "candle") => void;
+    onMaxVisiblePanesChange?: (next: number) => void;
+    onShowNonTradingDaysChange?: (next: boolean) => void;
+    onTimezoneChange?: (timezone: string) => void;
+    onAlertAudioEnabledChange?: (next: boolean) => void;
+    onEnableWhaleChange?: (next: boolean) => void;
+    onWhaleThresholdChange?: (next: number) => void;
+    onEnableCVDChange?: (next: boolean) => void;
+    onCVDModeChange?: (next: "oscillator" | "histogram") => void;
+    onDataAdapterChange?: (name: string) => void;
+    onShowTimeScrollbarChange?: (next: boolean) => void;
+    toggleTheme?: () => void;
+    onReset?: () => void;
+    overlayTimeframe?: string;
+    overlayStyle?: "hollow" | "step" | "area" | "candle";
+    maxVisiblePanes?: number;
+    showNonTradingDays?: boolean;
+    showTimeScrollbar?: boolean;
+    timezone?: string;
+    alertAudioEnabled?: boolean;
+    enableWhale?: boolean;
+    whaleThreshold?: number;
+    enableCVD?: boolean;
+    cvdMode?: "oscillator" | "histogram";
+    dataAdapterName?: string;
+    /**
+     * Chart-centric isolation (S1). Multi-chart cell passes its chartId ->
+     * storage + events are namespaced to that chart. Single-chart omits it
+     * -> legacy global key (backward compatible).
+     */
+    chartId?: string | null;
+}
+export declare function SettingsProvider(props: SettingsProviderProps): React.JSX.Element;

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

@@ -0,0 +1,78 @@
+/**
+ * WE2 P2-05: SettingsModal (Lean Shell Architecture)
+ * Modular 2-column TradingView-parity Chart Settings Modal
+ */
+import React, { type ReactNode } from "react";
+import type { PortalAdapter, StorageAdapter } from "@vninvestcharts/engine-react";
+import type { SeriesTier } from "../../../lib/core";
+export interface SettingsModalProps {
+    open: boolean;
+    onClose?: () => void;
+    children?: ReactNode;
+    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;
+    selectedPaneId?: string;
+    onSelectedPaneIdChange?: (paneId: string) => void;
+    maxVisiblePanes?: number;
+    onMaxVisiblePanesChange?: (next: number) => void;
+    maxVisibleBars?: number;
+    onMaxVisibleBarsChange?: (next: number) => void;
+    showNonTradingDays?: boolean;
+    onShowNonTradingDaysChange?: (next: boolean) => void;
+    showTimeScrollbar?: boolean;
+    onShowTimeScrollbarChange?: (next: boolean) => void;
+    showDrawingPriceMarkers?: boolean;
+    onShowDrawingPriceMarkersChange?: (next: boolean) => void;
+    enableWhale?: boolean;
+    onEnableWhaleChange?: (next: boolean) => void;
+    whaleThreshold?: number;
+    onWhaleThresholdChange?: (next: number) => void;
+    enableCVD?: boolean;
+    onEnableCVDChange?: (next: boolean) => void;
+    cvdMode?: "oscillator" | "histogram";
+    onCVDModeChange?: (next: "oscillator" | "histogram") => void;
+    onReset?: () => void;
+    isDark?: boolean;
+    toggleTheme?: () => void;
+    timezone?: string;
+    onTimezoneChange?: (timezone: string) => void;
+    alertAudioEnabled?: boolean;
+    onAlertAudioEnabledChange?: (next: boolean) => void;
+    dataAdapterName?: string;
+    onDataAdapterChange?: (name: string) => void;
+    overlayTimeframe?: string;
+    onOverlayTimeframeChange?: (next: string | undefined) => void;
+    overlayStyle?: "hollow" | "step" | "area" | "candle";
+    onOverlayStyleChange?: (next: "hollow" | "step" | "area" | "candle") => void;
+    onExportLayout?: () => void;
+    onImportLayout?: (layoutJson: string) => void;
+    portalAdapter?: PortalAdapter;
+    storageAdapter?: StorageAdapter;
+    themePreset?: string;
+    chartId?: string;
+    /** Displayed in the header when set (locked at open; never read from ambient active). */
+    symbol?: string;
+    /** Displayed in the header when set (locked at open). */
+    timeframe?: string;
+    /** S3b-2: tier gate cho composer thêm series (undefined = không gate, legacy). */
+    seriesTier?: SeriesTier;
+}
+export declare function SettingsModal(props: SettingsModalProps): React.ReactPortal | null;

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

@@ -0,0 +1,17 @@
+export interface SettingsRangeSliderMark {
+    value: number;
+    label: string;
+}
+export interface SettingsRangeSliderProps {
+    value: number;
+    min: number;
+    max: number;
+    step: number;
+    onChange: (next: number) => void;
+    marks?: readonly SettingsRangeSliderMark[];
+    formatValue?: (value: number) => string;
+    inputAriaLabel?: string;
+    inputAriaValueText?: string;
+    showCurrentIndicator?: boolean;
+}
+export declare function SettingsRangeSlider({ value, min, max, step, onChange, marks, formatValue, inputAriaLabel, inputAriaValueText, showCurrentIndicator, }: SettingsRangeSliderProps): import("react").JSX.Element;

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

@@ -0,0 +1,16 @@
+/**
+ * SnapshotPreviewModal
+ *
+ * A premium modal for previewing a captured chart snapshot before downloading.
+ * Supports dark/light mode context, portal rendering, and i18n localization.
+ */
+import type { PortalAdapter } from "@vninvestcharts/engine-react";
+export interface SnapshotPreviewModalProps {
+    isOpen: boolean;
+    imageDataUrl: string;
+    isDark: boolean;
+    onClose: () => void;
+    onSave: () => void;
+    portalAdapter?: PortalAdapter;
+}
+export declare function SnapshotPreviewModal({ isOpen, imageDataUrl, isDark, onClose, onSave, portalAdapter, }: SnapshotPreviewModalProps): import("react").ReactPortal | null;

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

@@ -0,0 +1,27 @@
+/**
+ * Workspace settings distribution (Settings S4/S5).
+ * Provided by the multi-chart grid only. Single-chart has no provider
+ * (legacy global behavior). Zero-delta for VNInvestMultiCharts/VNInvestCharts:
+ * GridContainer wraps its slots with this provider.
+ */
+import React from "react";
+import type { StorageAdapter } from "@vninvestcharts/engine-react";
+export interface WorkspaceSettingsValue {
+    /** True when inside a multi-chart grid (badge + Apply to All visible). */
+    isMultiChart: boolean;
+}
+export declare function useWorkspaceSettings(): WorkspaceSettingsValue;
+export interface WorkspaceSettingsProviderProps {
+    children: React.ReactNode;
+    /** All chartIds in the grid (fan-out targets). */
+    chartIds: readonly string[];
+    /** Shared storage adapter (same instance as grid cells). */
+    storageAdapter?: StorageAdapter;
+}
+/**
+ * Marks the subtree as multi-chart and fans out Apply-to-All payloads:
+ * merges the appearance slice into EVERY chart's scoped composite and
+ * dispatches a targeted `vnsc-settings-sync` envelope per chart so cells
+ * repaint immediately without reload. Never touches symbol/panes/scale.
+ */
+export declare function WorkspaceSettingsProvider(props: WorkspaceSettingsProviderProps): React.JSX.Element;

package/dist/dts/widget/components/settings/helpers/seriesFormatters.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Series formatting and labeling helpers for Settings modal
+ */
+import type { SeriesTypeId } from "../../../../lib/core";
+export declare function formatSeriesSuffix(type: SeriesTypeId, params?: any): string;
+export declare const SERIES_LABEL_KEYS: Partial<Record<SeriesTypeId, string>>;
+export declare const SERIES_ABBREVIATIONS: Partial<Record<SeriesTypeId, string>>;
+export declare const TECHNICAL_INDICATORS: Set<SeriesTypeId>;
+export declare const LINE_WIDTH_SERIES_TYPES: Set<SeriesTypeId>;
+export declare function supportsSeriesLineWidth(seriesType: SeriesTypeId): boolean;
+export declare function formatSeriesDisplayName(type: SeriesTypeId, params: any, t: (key: string, opt?: any) => string, index?: number): string;

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

@@ -0,0 +1,31 @@
+/**
+ * Appearance-style payload for "Apply to All" (Settings S5).
+ * Field-level whitelist: only visual/display fields are copied.
+ * Symbol identity, timeframe, panes, scale modes and data sources are NEVER copied.
+ */
+import type { ChartSettingsState } from "./chartSettingsSchema";
+export interface AppearanceStylePayload {
+    symbol: Pick<ChartSettingsState["symbol"], "candleStyle" | "upColor" | "downColor" | "borderUpColor" | "borderDownColor" | "wickUpColor" | "wickDownColor" | "showLastPriceLine" | "lastPriceLineColor" | "showPrevClosePriceLine" | "prevClosePriceLineColor" | "showHighLowPriceLines" | "precision">;
+    statusLine: ChartSettingsState["statusLine"];
+    scales: Pick<ChartSettingsState["scales"], "priceAxisPosition" | "showSymbolLastValue" | "showPrevCloseValue" | "showIndicatorValues" | "showCountdownToBarClose" | "dateFormat" | "timeFormat">;
+    appearance: ChartSettingsState["appearance"];
+    theme: ChartSettingsState["theme"];
+}
+/** Window event fired by the source chart when user clicks Apply to All. */
+export declare const APPLY_APPEARANCE_EVENT = "vnsc-apply-appearance-to-all";
+/** Window event fired after fan-out completes (feedback + tests). */
+export declare const APPLIED_APPEARANCE_EVENT = "vnsc-applied-appearance-to-all";
+export interface ApplyAppearanceDetail {
+    sourceChartId: string;
+    payload: AppearanceStylePayload;
+    /** Source chart's paper-trading visibility; fans out to every chart when defined. */
+    paperEnabled?: boolean;
+}
+/** Extract the copyable appearance slice (pure). */
+export declare function extractAppearancePayload(state: ChartSettingsState): AppearanceStylePayload;
+/**
+ * Merge payload into a target state (pure). Blacklisted fields
+ * (timezone, priceScaleMode/invertScale/showTimeScrollbar, panesLayout,
+ * tradingEvents incl. dataAdapterName) are preserved from target.
+ */
+export declare function applyAppearancePayload(target: ChartSettingsState, payload: AppearanceStylePayload): ChartSettingsState;