@forgecharts/sdk 1.1.36 → 1.2.3

package/dist/react/agent/AgentUIBus.d.ts

@@ -0,0 +1,111 @@
+/**
+ * AgentUIBus
+ *
+ * A typed pub/sub bus that lets the AI agent drive real UI actions in real time.
+ * Components subscribe to the events they own; the CommandDispatcher emits them
+ * after executing a tool so the user sees the application responding live.
+ *
+ * Design principles:
+ *  - One bus instance per agent session (singleton, reset on mount)
+ *  - Purely in-memory — no persistence, no network
+ *  - Components own their own reaction (open, animate, type) — the bus only
+ *    carries intent, never DOM references
+ */
+export type AgentUIEventMap = {
+    /** Open or close the script drawer. */
+    'panel:script': {
+        open: boolean;
+    };
+    /** Open or close the watchlist drawer. */
+    'panel:watchlist': {
+        open: boolean;
+    };
+    /** Open or close the indicators dialog. */
+    'panel:indicators': {
+        open: boolean;
+    };
+    /** Open or close the bottom trading panel. */
+    'panel:trading': {
+        open: boolean;
+    };
+    /** Switch the active tab in the bottom trading panel. */
+    'panel:trading:tab': {
+        tab: 'orders' | 'positions' | 'history';
+    };
+    /** Highlight a timeframe button briefly after the agent changes it. */
+    'chart:timeframe:highlight': {
+        timeframe: string;
+    };
+    /** Highlight the symbol picker after the agent changes the symbol. */
+    'chart:symbol:highlight': {
+        symbol: string;
+    };
+    /**
+     * Stream source code into the script editor one chunk at a time.
+     * Emit this repeatedly with successive slices to get a typewriter effect.
+     * Emit with `done: true` on the last chunk.
+     */
+    'script:type': {
+        chunk: string;
+        done: boolean;
+        scriptName?: string;
+    };
+    /** Clear the script editor and reset to a blank state. */
+    'script:clear': Record<string, never>;
+    /** Flash the "Run" / "Add to chart" button after script is fully typed. */
+    'script:ready': Record<string, never>;
+    /** Reload the saved scripts list (e.g. after delete). */
+    'script:reload': Record<string, never>;
+    /**
+     * Tell the ScriptDrawer to set its activeScriptId so subsequent saves
+     * update the script as a new version rather than creating a duplicate.
+     */
+    'script:activate': {
+        scriptId: string;
+    };
+    /**
+     * Tell the ScriptDrawer to attach (Add to Chart) using its current code.
+     * Equivalent to the user clicking the "Add to Chart" button.
+     */
+    'script:attach': Record<string, never>;
+    /** Flash/highlight a symbol row that was just added by the agent. */
+    'watchlist:highlight': {
+        symbol: string;
+    };
+    /** Briefly highlight an indicator row in the dialog after it was added. */
+    'indicators:highlight': {
+        indicatorType: string;
+    };
+    /** Show a brief toast/flash when drawings are added or cleared. */
+    'drawings:feedback': {
+        action: 'added' | 'cleared';
+        drawingType?: string;
+    };
+};
+export type AgentUIEventName = keyof AgentUIEventMap;
+type Handler<T> = (payload: T) => void;
+declare class AgentUIBusImpl {
+    private listeners;
+    on<K extends AgentUIEventName>(event: K, handler: Handler<AgentUIEventMap[K]>): void;
+    off<K extends AgentUIEventName>(event: K, handler: Handler<AgentUIEventMap[K]>): void;
+    emit<K extends AgentUIEventName>(event: K, payload: AgentUIEventMap[K]): void;
+    /** Remove all listeners (call on unmount to avoid leaks). */
+    clear(): void;
+}
+export declare const AgentUIBus: AgentUIBusImpl;
+/**
+ * Subscribe to an AgentUIBus event for the lifetime of the component.
+ * Automatically unsubscribes on unmount.
+ */
+export declare function useAgentUIEvent<K extends AgentUIEventName>(event: K, handler: Handler<AgentUIEventMap[K]>): void;
+/**
+ * Stream a string into the script editor with a typewriter effect.
+ * Emits `script:type` events one chunk at a time, then `script:ready`.
+ *
+ * @param source   Full source code string to type
+ * @param msPerChar Delay between characters in ms (default 12)
+ * @param chunkSize Characters per emit (default 3 — balances realism vs speed)
+ */
+export declare function streamCodeToEditor(source: string, msPerChar?: number, chunkSize?: number): Promise<void>;
+export {};
+//# sourceMappingURL=AgentUIBus.d.ts.map

package/dist/react/agent/AgentUIBus.d.ts.map

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

package/dist/react/agent/AssistantPanel.d.ts

@@ -0,0 +1,12 @@
+import type { ChartContextSnapshot } from '@forgecharts/types';
+type AssistantPanelProps = {
+    onClose: () => void;
+    chartContext: ChartContextSnapshot;
+};
+/**
+ * AssistantPanel — inline drawer panel (right of RightToolbar).
+ * Styled like WatchlistDrawer — no position:fixed.
+ */
+export declare function AssistantPanel({ onClose, chartContext }: AssistantPanelProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=AssistantPanel.d.ts.map

package/dist/react/agent/AssistantPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantPanel.d.ts","sourceRoot":"","sources":["../../../src/react/agent/AssistantPanel.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA+B,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE5F,KAAK,mBAAmB,GAAG;IACzB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,YAAY,EAAE,oBAAoB,CAAC;CACpC,CAAC;AA6FF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,mBAAmB,2CAuN5E"}

package/dist/react/agent/CommandDispatcher.d.ts

@@ -0,0 +1,77 @@
+import type { IPublicChart, AgentToolCall } from '@forgecharts/types';
+/**
+ * Result of a tool execution.
+ */
+export type ToolResult = {
+    ok: boolean;
+    data?: unknown;
+    error?: string;
+};
+/**
+ * Extended chart interface for agent tool handlers.
+ * These methods may be provided by the host application's IPublicChart
+ * implementation. Handlers use try/catch so missing methods fail gracefully.
+ */
+type ExtendedChart = IPublicChart & {
+    scrollToDate?(timestamp: number): void;
+    setVisibleRange?(from: number, to: number): void;
+    getIndicators?(): unknown[];
+    updateIndicator?(id: string, params: Record<string, unknown>): void;
+    setIndicatorVisible?(id: string, visible: boolean): void;
+    getIndicatorValues?(id: string, limit: number): unknown;
+    getAvailableIndicators?(): unknown[];
+    getDrawings?(): unknown[];
+    removeDrawing?(id: string): void;
+    updateDrawing?(id: string, props: unknown): void;
+    getDrawingTypes?(): string[];
+    getLayouts?(): unknown[];
+    deleteLayout?(id: string): void;
+    getWatchlist?(): unknown;
+    addToWatchlist?(symbol: string): void;
+    removeFromWatchlist?(symbol: string): void;
+    getScripts?(): unknown[] | Promise<unknown[]>;
+    getScriptSource?(id: string): string;
+    createScript?(name: string, source: string): string | Promise<string>;
+    deleteScript?(id: string): void | Promise<void>;
+    updateScriptSource?(id: string, source: string): void;
+    validateScript?(source: string): unknown;
+    compileAndAttachScript?(id: string): void;
+    detachScript?(id: string): void;
+    getScriptConsole?(id: string, limit: number): string[];
+    runBacktest?(params: unknown): unknown;
+    getBacktestTrades?(): unknown[];
+    getBacktestEquityCurve?(): unknown;
+    plotBacktestEquity?(pane: string): void;
+};
+/**
+ * CommandDispatcher — Executes tool calls against IPublicChart.
+ *
+ * This is a pure TypeScript class (not a React component) that bridges
+ * agent tool calls to chart operations. It handles both client-side
+ * operations (chart navigation, indicators, drawings) and server-side
+ * operations (data queries, scripts, trading).
+ *
+ * For server-side tools, it returns a placeholder response since the
+ * actual execution happens at the API layer.
+ */
+export declare class CommandDispatcher {
+    private chart;
+    private handlers;
+    constructor(chart: ExtendedChart);
+    /**
+     * Register all tool handlers.
+     */
+    private registerHandlers;
+    /**
+     * Execute a tool call, emit AgentUIBus side-effects, and return the result.
+     * UI side-effects run AFTER the data operation so the panel opens with data ready.
+     */
+    execute(toolCall: AgentToolCall): Promise<ToolResult>;
+    /**
+     * Emit AgentUIBus events that animate the UI after a successful tool call.
+     * Each case maps a tool name to the panel/action it should drive.
+     */
+    private _emitUIEffect;
+}
+export {};
+//# sourceMappingURL=CommandDispatcher.d.ts.map

package/dist/react/agent/CommandDispatcher.d.ts.map

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

package/dist/react/agent/VoiceInput.d.ts

@@ -0,0 +1,36 @@
+/**
+ * VoiceInput — Web Speech API wrapper for voice-to-text.
+ *
+ * Provides a simple interface to the browser's speech recognition API.
+ * Handles both interim results (as the user is speaking) and final results
+ * (when the user stops speaking).
+ */
+export declare class VoiceInput {
+    private recognition;
+    private onInterim;
+    private onFinal;
+    private onError;
+    /**
+     * Check if the browser supports the Web Speech API.
+     */
+    static isSupported(): boolean;
+    /**
+     * Start listening for speech input.
+     *
+     * @param callbacks - Event handlers for interim, final, and error states
+     */
+    start(callbacks: {
+        onInterim: (text: string) => void;
+        onFinal: (text: string) => void;
+        onError: (error: string) => void;
+    }): void;
+    /**
+     * Stop listening and clean up.
+     */
+    stop(): void;
+    /**
+     * Abort the current recognition session.
+     */
+    abort(): void;
+}
+//# sourceMappingURL=VoiceInput.d.ts.map

package/dist/react/agent/VoiceInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceInput.d.ts","sourceRoot":"","sources":["../../../src/react/agent/VoiceInput.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2CH,qBAAa,UAAU;IACrB,OAAO,CAAC,WAAW,CAA0C;IAC7D,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,OAAO,CAA0C;IAEzD;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,OAAO;IAO7B;;;;OAIG;IACH,KAAK,CAAC,SAAS,EAAE;QACf,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAClC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAChC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;KAClC,GAAG,IAAI;IAkFR;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,KAAK,IAAI,IAAI;CAMd"}

package/dist/react/agent/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Agent system exports.
+ *
+ * The agent system provides:
+ * - AgentProvider: State management and SSE streaming
+ * - useAgent: Hook to access agent state and actions
+ * - AgentFAB: Floating action button for initiating conversations
+ * - AssistantPanel: Chat panel UI
+ * - CommandDispatcher: Executes tool calls against IPublicChart
+ * - VoiceInput: Web Speech API wrapper
+ */
+export { AgentProvider } from './AgentProvider';
+export { useAgent, AgentContext, type AgentConfig, type AgentContextValue, } from './useAgent';
+export { AgentFAB } from './AgentFAB';
+export { AssistantPanel } from './AssistantPanel';
+export { CommandDispatcher, type ToolResult } from './CommandDispatcher';
+export { VoiceInput } from './VoiceInput';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/react/agent/useAgent.d.ts

@@ -0,0 +1,81 @@
+import type { AgentMessage, FABState, ChartContextSnapshot, AgentApprovalRequest } from '@forgecharts/types';
+/**
+ * Configuration for the Agent system.
+ */
+export type AgentConfig = {
+    apiUrl: string;
+    getAuthToken: () => string | Promise<string>;
+};
+/**
+ * Context value exposed by AgentProvider.
+ */
+export type AgentContextValue = {
+    /** All messages in the current conversation. */
+    messages: AgentMessage[];
+    /** Visual state of the floating action button. */
+    fabState: FABState;
+    /** True while streaming a response from the API. */
+    isStreaming: boolean;
+    /** Pending approval for a destructive tool call, or null. */
+    pendingApproval: AgentApprovalRequest | null;
+    /** Deep analysis mode toggle. */
+    deepAnalysis: boolean;
+    /** Current error message, or null if no error. */
+    error: string | null;
+    /** Token usage for the last response, or null. */
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    } | null;
+    /** True while the initial chat history is being loaded from the server. */
+    historyLoading: boolean;
+    /** Index into `messages` where the current session starts (messages before this are loaded history). */
+    sessionStart: number;
+    /**
+     * Sends a message to the agent and streams the response.
+     * Automatically sets up SSE listening and dispatches tool calls.
+     */
+    sendMessage: (text: string, chartContext: ChartContextSnapshot) => Promise<void>;
+    /**
+     * Updates a tool call with its result.
+     * Called by CommandDispatcher after executing a tool.
+     */
+    handleToolResult: (toolCallId: string, result: {
+        ok: boolean;
+        data?: unknown;
+        error?: string;
+    }) => void;
+    /**
+     * Approves a pending destructive tool call.
+     * Changes status from 'approval_required' to 'pending'.
+     */
+    approveAction: (toolCallId: string) => void;
+    /**
+     * Rejects a pending destructive tool call.
+     * Changes status to 'rejected'.
+     */
+    rejectAction: (toolCallId: string) => void;
+    /**
+     * Sets the FAB visual state.
+     */
+    setFabState: (state: FABState) => void;
+    /**
+     * Toggles deep analysis mode.
+     */
+    setDeepAnalysis: (on: boolean) => void;
+    /**
+     * Clears all messages from the conversation.
+     */
+    clearMessages: () => void;
+    /**
+     * Aborts the current streaming response.
+     */
+    cancelStream: () => void;
+};
+export declare const AgentContext: import("react").Context<AgentContextValue | null>;
+/**
+ * Hook to access the agent context.
+ * Must be called within an AgentProvider.
+ */
+export declare function useAgent(): AgentContextValue;
+//# sourceMappingURL=useAgent.d.ts.map

package/dist/react/agent/useAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgent.d.ts","sourceRoot":"","sources":["../../../src/react/agent/useAgent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EACR,oBAAoB,EAEpB,oBAAoB,EAErB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAG9B,gDAAgD;IAChD,QAAQ,EAAE,YAAY,EAAE,CAAC;IAEzB,kDAAkD;IAClD,QAAQ,EAAE,QAAQ,CAAC;IAEnB,oDAAoD;IACpD,WAAW,EAAE,OAAO,CAAC;IAErB,6DAA6D;IAC7D,eAAe,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAE7C,iCAAiC;IACjC,YAAY,EAAE,OAAO,CAAC;IAEtB,kDAAkD;IAClD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB,kDAAkD;IAClD,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAE5D,2EAA2E;IAC3E,cAAc,EAAE,OAAO,CAAC;IAExB,wGAAwG;IACxG,YAAY,EAAE,MAAM,CAAC;IAIrB;;;OAGG;IACH,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjF;;;OAGG;IACH,gBAAgB,EAAE,CAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KACpD,IAAI,CAAC;IAEV;;;OAGG;IACH,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5C;;;OAGG;IACH,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAE3C;;OAEG;IACH,WAAW,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IAEvC;;OAEG;IACH,eAAe,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,CAAC;IAEvC;;OAEG;IACH,aAAa,EAAE,MAAM,IAAI,CAAC;IAE1B;;OAEG;IACH,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC;AAEF,eAAO,MAAM,YAAY,mDAAgD,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,iBAAiB,CAM5C"}

package/dist/react/canvas/ChartCanvas.d.ts

@@ -14,6 +14,7 @@
 import type { TradingOverlayStore } from '../../';
 import type { DrawingToolType, PointerToolType, IndicatorConfig, ChartLayout, IDatafeed, ChartTheme } from '../../';
 import type { TradingBridgeCallbacks } from '../trading/TradingBridge';
+import type { CanvasSettings, ChartTemplate } from './ChartSettingsDialog';
 export type ChartCanvasHandle = {
     /** Returns the full current chart state (indicators, drawings, viewport). */
     getLayoutSnapshot: () => ChartLayout | null;
@@ -21,6 +22,10 @@ export type ChartCanvasHandle = {
     loadLayoutSnapshot: (layout: ChartLayout) => void;
     /** Adds an indicator to the live chart and returns its id. */
     addIndicator: (config: IndicatorConfig) => string | null;
+    /** Returns the number of indicators currently active on this chart. */
+    getIndicatorCount: () => number;
+    /** Returns all active indicators on this chart. */
+    getIndicators: () => readonly import('@forgecharts/types').IndicatorInstance[];
     /** Captures the visible chart area as a PNG data-URL. */
     captureScreenshot: () => Promise<string | null>;
     /**
@@ -31,6 +36,8 @@ export type ChartCanvasHandle = {
     getOverlayStore: () => TradingOverlayStore | null;
     /** Programmatically activates a pointer tool (cursor / crosshair / dot / demonstration). */
     selectPointerTool: (tool: PointerToolType) => void;
+    /** Returns the last bar's close price, or 0 if no data. */
+    getLastPrice: () => number;
 };
 export type ChartCanvasProps = {
     symbol: string;
@@ -49,6 +56,8 @@ export type ChartCanvasProps = {
     layoutToRestore?: ChartLayout | undefined;
     /** Called whenever an indicator is added or removed, so the parent can trigger a workspace save. */
     onIndicatorsChanged?: () => void;
+    /** Called whenever a drawing is created, updated (including property edits), moved, or removed, so the parent can trigger a workspace save. */
+    onDrawingsChanged?: () => void;
     /**
      * Initial price-pane fraction (0.3–0.85). Defaults to 0.6.
      * The parent controls persistence; changes are reported via onPriceFractionChange.
@@ -75,6 +84,12 @@ export type ChartCanvasProps = {
     getAuthToken?: () => string | Promise<string>;
     /** Base URL for the ForgeCharts API, used by the profile drawer. Defaults to same origin. */
     apiUrl?: string;
+    /**
+     * Opaque key that changes when the active data provider changes (e.g. Rithmic connects).
+     * Causes the contract-switch roll-date fetch to re-run so markers appear after a
+     * provider session starts, even if the initial fetch returned empty results.
+     */
+    providerKey?: string | null;
     /** Initial drawing-tool favorites shown in the floating toolbar. Persisted and reported via onDrawingFavoritesChange. */
     drawingFavorites?: DrawingToolType[];
     /** Called when the user stars/unstars a drawing tool so the parent can persist the list. */
@@ -86,6 +101,13 @@ export type ChartCanvasProps = {
     initialActiveTool?: PointerToolType;
     /** Called whenever the user selects a pointer tool, so the parent can persist the choice. */
     onPointerToolChange?: (tool: PointerToolType) => void;
+    /**
+     * Initial magnet snap mode. Defaults to `'snap-xy'`.
+     * Provided by the parent for workspace persistence.
+     */
+    initialMagnetMode?: import('@forgecharts/types').MagnetMode;
+    /** Called when the user changes the magnet mode, so the parent can persist the choice. */
+    onMagnetModeChange?: (mode: import('@forgecharts/types').MagnetMode) => void;
     /**
      * Optional trading bridge callbacks for Unmanaged mode.
      *
@@ -98,6 +120,29 @@ export type ChartCanvasProps = {
      * console output of every emitted intent.
      */
     tradingBridge?: TradingBridgeCallbacks;
+    /**
+     * Rendering backend. Defaults to `'canvas'` (Canvas 2D).
+     * Set to `'pixi'` for GPU-accelerated rendering via PixiJS.
+     */
+    renderBackend?: 'canvas' | 'pixi';
+    /** Initial canvas settings (background, grid, contract switches) restored from the workspace. */
+    initialCanvasSettings?: CanvasSettings;
+    /** Called when the user applies canvas settings so the parent can persist the change. */
+    onCanvasSettingsChange?: (settings: CanvasSettings) => void;
+    /** Called when the user selects a specific contract from the contract switch dialog. */
+    onSymbolChange?: (symbol: string) => void;
+    /** Saved chart-settings templates. */
+    chartTemplates?: ChartTemplate[];
+    /** Called to save/update a template. */
+    onSaveTemplate?: (template: ChartTemplate) => void;
+    /** Called to delete a template. */
+    onDeleteTemplate?: (name: string) => void;
+    /** The default canvas settings used when user clicks "Apply defaults". */
+    defaultCanvasSettings?: CanvasSettings;
+    /** Called when the user clicks a position overlay label on the chart. */
+    onPositionClick?: (positionId: string) => void;
+    /** Called when the user finishes dragging an SL/TP order line to a new price. */
+    onOrderDragEnd?: (orderId: string, newPrice: number) => void;
 };
 /** @deprecated Use ChartCanvasProps */
 export type MultiPaneChartProps = ChartCanvasProps;

package/dist/react/canvas/ChartCanvas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChartCanvas.d.ts","sourceRoot":"","sources":["../../../src/react/canvas/ChartCanvas.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,KAAK,EACM,eAAe,EAAa,eAAe,EACjC,eAAe,EAAE,WAAW,EAAE,SAAS,EACjE,UAAU,EACX,MAAM,QAAQ,CAAC;AAGhB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAyPvE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,6EAA6E;IAC7E,iBAAiB,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAC5C,kEAAkE;IAClE,kBAAkB,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IAClD,8DAA8D;IAC9D,YAAY,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,MAAM,GAAG,IAAI,CAAC;IACzD,yDAAyD;IACzD,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAChD;;;;OAIG;IACH,eAAe,EAAE,MAAM,mBAAmB,GAAG,IAAI,CAAC;IAClD,4FAA4F;IAC5F,iBAAiB,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,eAAe,EAAE,CAAC;IACtC;;;;OAIG;IACH,eAAe,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC1C,oGAAoG;IACpG,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrE,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,0DAA0D;IAC1D,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,uGAAuG;IACvG,YAAY,CAAC,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yHAAyH;IACzH,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,4FAA4F;IAC5F,wBAAwB,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;IAC7D;;;OAGG;IACH,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC,6FAA6F;IAC7F,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;IACtD;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,sBAAsB,CAAC;CACxC,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AACnD,wCAAwC;AACxC,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAErD,eAAO,MAAM,WAAW,gHA8sBtB,CAAC;AAEH,kCAAkC;AAClC,eAAO,MAAM,cAAc,gHAAc,CAAC"}
+{"version":3,"file":"ChartCanvas.d.ts","sourceRoot":"","sources":["../../../src/react/canvas/ChartCanvas.tsx"],"names":[],"mappings":"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"}

package/dist/react/canvas/ChartSettingsDialog.d.ts

@@ -1,8 +1,10 @@
 /**
- * ChartSettingsDialog — canvas settings modal.
+ * ChartSettingsDialog — chart settings modal.
  *
  * Sections (sidebar nav):
+ *  • Symbol — candle colors, data modification, precision, timezone
  *  • Canvas — background color, grid visibility, grid color
+ *  • Events — contract switches on continuous futures
  *
  * Additional sections can be added by extending SECTIONS and adding a matching
  * content renderer in renderContent().
@@ -10,16 +12,92 @@
  * The parent passes `initialSettings` and receives the final values via `onApply`.
  * Nothing is persisted here; persistence (localStorage / DB) lives in the parent.
  */
+export type CandleColors = {
+    bodyUp: string;
+    bodyDown: string;
+    borderUp: string;
+    borderDown: string;
+    wickUp: string;
+    wickDown: string;
+};
 export type CanvasSettings = {
     background: string;
     gridColor: string;
     gridVisible: boolean;
+    gridAlpha: number;
+    gridWidth: number;
+    /** Show vertical "Contract Switch" markers at roll dates on continuous futures. */
+    showContractSwitches: boolean;
+    /** Color candles based on close vs previous close instead of open vs close. */
+    colorByPrevClose: boolean;
+    /** Candle body/border/wick colors. */
+    candle: CandleColors;
+    /** Show candle borders. */
+    borderVisible: boolean;
+    /** Show candle wicks. */
+    wickVisible: boolean;
+    /** Price precision override: 'default' = auto-heuristic, or explicit decimal count. */
+    precision: 'default' | number;
+    /** Use settlement price as close on daily interval. */
+    useSettlement: boolean;
+    /** Adjust for contract changes (back-adjust continuous data). */
+    adjustForContractChanges: boolean;
+    /** Countdown to bar close displayed on the price scale. */
+    countdownToBarClose: boolean;
+    /** Currency & unit visibility on price scale: 'mouse-over' | 'always' | 'never'. */
+    currencyAndUnit: 'mouse-over' | 'always' | 'never';
+    /** Show day of week on time axis labels. */
+    dayOfWeekOnLabels: boolean;
+    /** Date format used on the time axis. */
+    dateFormat: string;
+    /** Time hours format: '24' or '12'. */
+    timeHoursFormat: '24' | '12';
+    /** Preserve chart left-edge scroll position when changing interval. */
+    saveLeftEdgePosition: boolean;
+    /** Status line (top-left overlay) visibility settings. */
+    statusLine: {
+        showLogo: boolean;
+        showTitle: boolean;
+        /** Title display mode: 'description' | 'ticker' | 'ticker-description'. */
+        titleMode: 'description' | 'ticker' | 'ticker-description';
+        showOpenMarketStatus: boolean;
+        showChartValues: boolean;
+        showBarChangeValues: boolean;
+        showVolume: boolean;
+        showLastDayChangeValues: boolean;
+        /** Indicator overlay labels. */
+        showIndicatorTitles: boolean;
+        showIndicatorInputs: boolean;
+        showIndicatorValues: boolean;
+        showBackground: boolean;
+    };
+};
+/** A named chart-settings template. */
+export type ChartTemplate = {
+    name: string;
+    settings: CanvasSettings;
 };
 type Props = {
     initialSettings: CanvasSettings;
     onApply: (settings: CanvasSettings) => void;
     onClose: () => void;
+    /** Live preview: called on every settings change so the chart updates in real time. */
+    onPreview?: (settings: CanvasSettings) => void;
+    /** Called when the user cancels — allows the caller to revert the preview. */
+    onCancel?: () => void;
+    /** Current timezone, shown in the Symbol section for reference. */
+    timezone?: string;
+    /** Called when the user changes timezone from the Symbol section. */
+    onTimezoneChange?: (tz: string) => void;
+    /** Saved chart-settings templates. */
+    templates?: ChartTemplate[];
+    /** Called to persist a new or updated template. */
+    onSaveTemplate?: (template: ChartTemplate) => void;
+    /** Called to delete a template by name. */
+    onDeleteTemplate?: (name: string) => void;
+    /** The default settings used for "Apply defaults". */
+    defaultSettings?: CanvasSettings;
 };
-export declare function ChartSettingsDialog({ initialSettings, onApply, onClose }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function ChartSettingsDialog({ initialSettings, onApply, onClose, onPreview, onCancel, timezone, onTimezoneChange, templates, onSaveTemplate, onDeleteTemplate, defaultSettings }: Props): import("react/jsx-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=ChartSettingsDialog.d.ts.map

package/dist/react/canvas/ChartSettingsDialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChartSettingsDialog.d.ts","sourceRoot":"","sources":["../../../src/react/canvas/ChartSettingsDialog.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAQF,KAAK,KAAK,GAAG;IACX,eAAe,EAAE,cAAc,CAAC;IAChC,OAAO,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAC5C,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,2CAmG/E"}
+{"version":3,"file":"ChartSettingsDialog.d.ts","sourceRoot":"","sources":["../../../src/react/canvas/ChartSettingsDialog.tsx"],"names":[],"mappings":"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"}

package/dist/react/canvas/ContractSwitchDialog.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ContractSwitchDialog — popup shown when a user clicks a contract-switch marker.
+ *
+ * Displays the from/to contracts with a clean accent. Clicking either
+ * contract triggers `onSelectContract` so the parent can switch the symbol.
+ */
+import type { ContractSwitch } from '@forgecharts/types';
+type Props = {
+    /** The contract switch the user clicked. */
+    sw: ContractSwitch;
+    /** Screen-space position for the popup. */
+    position: {
+        x: number;
+        y: number;
+    };
+    /** Called when the user picks a contract to navigate to. */
+    onSelectContract: (symbol: string) => void;
+    onClose: () => void;
+};
+export declare function ContractSwitchDialog({ sw, position, onSelectContract, onClose }: Props): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=ContractSwitchDialog.d.ts.map

package/dist/react/canvas/ContractSwitchDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContractSwitchDialog.d.ts","sourceRoot":"","sources":["../../../src/react/canvas/ContractSwitchDialog.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,KAAK,KAAK,GAAG;IACX,4CAA4C;IAC5C,EAAE,EAAE,cAAc,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,4DAA4D;IAC5D,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,EAAE,KAAK,2CA4CtF"}

package/dist/react/canvas/DrawingPropertiesDialog.d.ts

@@ -0,0 +1,23 @@
+import type { Drawing } from '@forgecharts/types';
+type DrawingPatches = Partial<Pick<Drawing, 'color' | 'lineWidth' | 'fillColor' | 'fillOpacity' | 'text' | 'fontSize' | 'deviationMultiplier' | 'visible' | 'points'>>;
+type Props = {
+    drawing: Drawing;
+    /** Called when the user clicks Ok — commit the final patches. */
+    onApply: (patches: DrawingPatches) => void;
+    /**
+     * Called on every input change so the canvas updates in real time.
+     * The parent should call `chart.updateDrawing(id, patches)` without
+     * closing the dialog or triggering a workspace save.
+     */
+    onPreview: (patches: DrawingPatches) => void;
+    /**
+     * Called when the user clicks Cancel or presses Escape.
+     * The parent should restore the original drawing state captured before
+     * the dialog was opened.
+     */
+    onRevert: () => void;
+    onClose: () => void;
+};
+export declare function DrawingPropertiesDialog({ drawing, onApply, onPreview, onRevert, onClose }: Props): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=DrawingPropertiesDialog.d.ts.map

package/dist/react/canvas/DrawingPropertiesDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DrawingPropertiesDialog.d.ts","sourceRoot":"","sources":["../../../src/react/canvas/DrawingPropertiesDialog.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,oBAAoB,CAAC;AAI/D,KAAK,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,EACtC,OAAO,GACP,WAAW,GACX,WAAW,GACX,aAAa,GACb,MAAM,GACN,UAAU,GACV,qBAAqB,GACrB,SAAS,GACT,QAAQ,CACX,CAAC,CAAC;AAEH,KAAK,KAAK,GAAG;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC3C;;;;OAIG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAgHF,wBAAgB,uBAAuB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,2CAqYhG"}