minerva-design 1.4.0 → 1.6.0

package/dist/charts/react/trading.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"trading.cjs","names":["useRef","useState","createTradingChart","require_chart","react","react_jsx_runtime","isPlainObject","value","proto","shallowEqual","keys","a","b","key","sameItem","v","i","sameValue","sameOptions","size","fallback","TradingChart","options","props","handlers","containerRef","chartRef","handlersRef","stable","setStable","optionsRef","container","chart","h","offs","off","ref","bar","bars","index","animate","range","tool","id","visible","width","height","style"],"sources":["../../../../charts/src/react/trading.tsx"],"sourcesContent":["import {\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  useState,\n  type CSSProperties,\n  type Ref,\n} from \"react\";\nimport { createTradingChart } from \"../engine/trading/chart\";\nimport type {\n  TradingBar,\n  TradingBarsInput,\n  TradingChartInstance,\n  TradingChartOptions,\n  TradingClickEvent,\n  TradingCrosshairEvent,\n  TradingDrawing,\n  TradingDrawingTool,\n  TradingHistoryRequestEvent,\n  TradingIndicatorToggleEvent,\n  TradingOrderMoveEvent,\n  TradingVisibleRange,\n} from \"../engine/trading/types\";\nimport type { ChartRendererKind } from \"../engine/types\";\n\n/** Imperative handle of `<TradingChart>` */\nexport interface TradingChartHandle {\n  /**\n   * Streams a bar: the time of the last bar replaces it, a later time\n   * appends it (cheap: call it on every tick)\n   */\n  update(bar: TradingBar): void;\n  /** Appends bars newer than the last one */\n  appendBars(bars: TradingBarsInput): void;\n  /** Inserts older bars before the first one, keeping the view */\n  prependBars(bars: TradingBarsInput): void;\n  /** Replaces the bars */\n  setBars(bars: TradingBarsInput): void;\n  /** Number of bars */\n  getBarCount(): number;\n  /** Bar at an index, `null` outside the data */\n  getBar(index: number): TradingBar | null;\n  /** Scrolls to the latest bar */\n  scrollToRealtime(animate?: boolean): void;\n  /** Shows every bar */\n  fitContent(): void;\n  /** Visible bars, `null` before mounting */\n  getVisibleRange(): TradingVisibleRange | null;\n  /** Shows the bars between two logical indices */\n  setVisibleRange(range: { from: number; to: number }): void;\n  /** Fits every price scale to the visible bars again */\n  resetPriceScales(): void;\n  /** Activates a drawing tool */\n  setDrawingTool(tool: TradingDrawingTool): void;\n  /** Current drawings */\n  getDrawings(): readonly TradingDrawing[];\n  /** Deletes a drawing */\n  removeDrawing(id: string): void;\n  /** Selects a drawing (`null` clears the selection) */\n  selectDrawing(id: string | null): void;\n  /** Shows or hides an indicator */\n  setIndicatorVisible(id: string, visible: boolean): void;\n  /** Backend in use, `null` until ready */\n  getRenderer(): ChartRendererKind | null;\n  /** The underlying engine instance (minerva-design/charts/core) */\n  getInstance(): TradingChartInstance | null;\n}\n\n/** Props of `<TradingChart>`: the options of `createTradingChart`, the size and the events */\nexport interface TradingChartProps extends TradingChartOptions {\n  /**\n   * Height (pixels or any CSS length)\n   * @default 480\n   */\n  height?: number | string;\n  /**\n   * Width (pixels or any CSS length)\n   * @default \"100%\"\n   */\n  width?: number | string;\n  /** Class of the root element */\n  className?: string;\n  /** Inline styles of the root element */\n  style?: CSSProperties;\n  /** Imperative handle (streaming, scrolling, drawings) */\n  ref?: Ref<TradingChartHandle>;\n  /** The crosshair moved (`null` when it left the chart) */\n  onCrosshairMove?: (event: TradingCrosshairEvent | null) => void;\n  /** A pane was clicked */\n  onClick?: (event: TradingClickEvent) => void;\n  /** The visible bars changed */\n  onVisibleRangeChange?: (range: TradingVisibleRange) => void;\n  /** A draggable price line was dropped at a new price */\n  onOrderMove?: (event: TradingOrderMoveEvent) => void;\n  /** The user added, moved or deleted drawings (pass them back as `drawings`) */\n  onDrawingsChange?: (drawings: readonly TradingDrawing[]) => void;\n  /** The selected drawing changed */\n  onDrawingSelect?: (id: string | null) => void;\n  /** The drawing tool changed (back to `cursor` after a drawing) */\n  onDrawingToolChange?: (tool: TradingDrawingTool) => void;\n  /** An indicator was shown or hidden from its legend */\n  onIndicatorToggle?: (event: TradingIndicatorToggleEvent) => void;\n  /** The oldest bar came into view: load older bars (`prependBars`) */\n  onHistoryRequest?: (event: TradingHistoryRequestEvent) => void;\n  /** The backend in use (again after a fallback) */\n  onRendererChange?: (renderer: ChartRendererKind) => void;\n}\n\ntype Handlers = Pick<\n  TradingChartProps,\n  | \"onCrosshairMove\"\n  | \"onClick\"\n  | \"onVisibleRangeChange\"\n  | \"onOrderMove\"\n  | \"onDrawingsChange\"\n  | \"onDrawingSelect\"\n  | \"onDrawingToolChange\"\n  | \"onIndicatorToggle\"\n  | \"onHistoryRequest\"\n  | \"onRendererChange\"\n>;\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> => {\n  if (typeof value !== \"object\" || value === null) return false;\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n};\n\nconst shallowEqual = (\n  a: Record<string, unknown>,\n  b: Record<string, unknown>,\n): boolean => {\n  const keys = Object.keys(a);\n  if (keys.length !== Object.keys(b).length) return false;\n  return keys.every(\n    (key) =>\n      Object.prototype.hasOwnProperty.call(b, key) && sameItem(a[key], b[key]),\n  );\n};\n\n/** Identical, or inline arrays of identical values */\nconst sameItem = (a: unknown, b: unknown): boolean =>\n  a === b ||\n  (Array.isArray(a) &&\n    Array.isArray(b) &&\n    a.length === b.length &&\n    a.every((v, i) => v === b[i]));\n\n/**\n * Same option value: identical, or inline arrays / objects of plain objects\n * with identical fields (`indicators={[{ type: \"ma\", period: 7 }]}`). Bars,\n * markers and drawings are compared by identity when they are not plain\n * objects (typed arrays) and item by item otherwise.\n */\nconst sameValue = (a: unknown, b: unknown): boolean => {\n  if (a === b) return true;\n  if (Array.isArray(a) && Array.isArray(b)) {\n    return (\n      a.length === b.length &&\n      a.every(\n        (v, i) =>\n          v === b[i] ||\n          (isPlainObject(v) && isPlainObject(b[i]) && shallowEqual(v, b[i])),\n      )\n    );\n  }\n  return isPlainObject(a) && isPlainObject(b) && shallowEqual(a, b);\n};\n\n/** Options describing the same chart (bars and drawings compared by identity) */\nconst sameOptions = (a: TradingChartOptions, b: TradingChartOptions) => {\n  const keys = Object.keys(a) as (keyof TradingChartOptions)[];\n  if (keys.length !== Object.keys(b).length) return false;\n  return keys.every((key) => {\n    if (!Object.prototype.hasOwnProperty.call(b, key)) return false;\n    // new bars / drawings arrays are always applied: compared by identity\n    if (key === \"bars\" || key === \"drawings\") return a[key] === b[key];\n    return sameValue(a[key], b[key]);\n  });\n};\n\nconst size = (value: number | string | undefined, fallback: string) =>\n  value === undefined\n    ? fallback\n    : typeof value === \"number\"\n      ? `${value}px`\n      : value;\n\n/**\n * Professional trading chart: candles (hollow, Heikin-Ashi, bars, line,\n * area, baseline) over a gap-free time axis, indicator panes, drawing\n * tools, order lines and real-time streaming, drawn on the GPU.\n */\nexport function TradingChart(props: TradingChartProps) {\n  const {\n    height,\n    width,\n    className,\n    style,\n    ref,\n    onCrosshairMove,\n    onClick,\n    onVisibleRangeChange,\n    onOrderMove,\n    onDrawingsChange,\n    onDrawingSelect,\n    onDrawingToolChange,\n    onIndicatorToggle,\n    onHistoryRequest,\n    onRendererChange,\n    ...options\n  } = props;\n  const handlers: Handlers = {\n    onCrosshairMove,\n    onClick,\n    onVisibleRangeChange,\n    onOrderMove,\n    onDrawingsChange,\n    onDrawingSelect,\n    onDrawingToolChange,\n    onIndicatorToggle,\n    onHistoryRequest,\n    onRendererChange,\n  };\n  const containerRef = useRef<HTMLDivElement>(null);\n  const chartRef = useRef<TradingChartInstance | null>(null);\n  const handlersRef = useRef<Handlers>(handlers);\n\n  // a new options object on every render: keep the previous one while it\n  // describes the same chart (state derived during render)\n  const [stable, setStable] = useState<TradingChartOptions>(options);\n  if (stable !== options && !sameOptions(stable, options)) setStable(options);\n  const optionsRef = useRef(stable);\n\n  useEffect(() => {\n    handlersRef.current = handlers;\n  });\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n    const chart = createTradingChart(container, optionsRef.current);\n    chartRef.current = chart;\n    const h = () => handlersRef.current;\n    const offs = [\n      chart.on(\"crosshairMove\", (e) => h().onCrosshairMove?.(e)),\n      chart.on(\"click\", (e) => h().onClick?.(e)),\n      chart.on(\"visibleRangeChange\", (e) => h().onVisibleRangeChange?.(e)),\n      chart.on(\"orderMove\", (e) => h().onOrderMove?.(e)),\n      chart.on(\"drawingsChange\", (e) => h().onDrawingsChange?.(e)),\n      chart.on(\"drawingSelect\", (e) => h().onDrawingSelect?.(e)),\n      chart.on(\"drawingToolChange\", (e) => h().onDrawingToolChange?.(e)),\n      chart.on(\"indicatorToggle\", (e) => h().onIndicatorToggle?.(e)),\n      chart.on(\"historyRequest\", (e) => h().onHistoryRequest?.(e)),\n      chart.on(\"renderer\", (e) => h().onRendererChange?.(e)),\n    ];\n    return () => {\n      offs.forEach((off) => off());\n      chart.destroy();\n      chartRef.current = null;\n    };\n  }, []);\n\n  useEffect(() => {\n    if (optionsRef.current === stable) return;\n    optionsRef.current = stable;\n    chartRef.current?.setOptions(stable);\n  }, [stable]);\n\n  useImperativeHandle(\n    ref,\n    (): TradingChartHandle => ({\n      update: (bar) => chartRef.current?.update(bar),\n      appendBars: (bars) => chartRef.current?.appendBars(bars),\n      prependBars: (bars) => chartRef.current?.prependBars(bars),\n      setBars: (bars) => chartRef.current?.setBars(bars),\n      getBarCount: () => chartRef.current?.getBarCount() ?? 0,\n      getBar: (index) => chartRef.current?.getBar(index) ?? null,\n      scrollToRealtime: (animate) =>\n        chartRef.current?.scrollToRealtime(animate),\n      fitContent: () => chartRef.current?.fitContent(),\n      getVisibleRange: () => chartRef.current?.getVisibleRange() ?? null,\n      setVisibleRange: (range) => chartRef.current?.setVisibleRange(range),\n      resetPriceScales: () => chartRef.current?.resetPriceScales(),\n      setDrawingTool: (tool) => chartRef.current?.setDrawingTool(tool),\n      getDrawings: () => chartRef.current?.getDrawings() ?? [],\n      removeDrawing: (id) => chartRef.current?.removeDrawing(id),\n      selectDrawing: (id) => chartRef.current?.selectDrawing(id),\n      setIndicatorVisible: (id, visible) =>\n        chartRef.current?.setIndicatorVisible(id, visible),\n      getRenderer: () => chartRef.current?.getRenderer() ?? null,\n      getInstance: () => chartRef.current,\n    }),\n    [],\n  );\n\n  return (\n    <div\n      className={className}\n      style={{\n        position: \"relative\",\n        width: size(width, \"100%\"),\n        height: size(height, \"480px\"),\n        ...style,\n      }}\n    >\n      <div ref={containerRef} style={{ position: \"absolute\", inset: 0 }} />\n    </div>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"trading.cjs","names":["useRef","useState","createTradingChart","require_chart","react","react_jsx_runtime","isPlainObject","value","proto","shallowEqual","keys","a","b","key","sameItem","v","i","sameValue","sameOptions","size","fallback","TradingChart","options","props","handlers","containerRef","chartRef","handlersRef","stable","setStable","optionsRef","container","chart","h","offs","off","ref","bar","bars","index","animate","range","time","price","mode","tool","id","patch","count","speed","type","quality","visible","width","height","style"],"sources":["../../../../charts/src/react/trading.tsx"],"sourcesContent":["import {\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  useState,\n  type CSSProperties,\n  type Ref,\n} from \"react\";\nimport { createTradingChart } from \"../engine/trading/chart\";\nimport type {\n  TradingBar,\n  TradingBarsInput,\n  TradingChartInstance,\n  TradingChartOptions,\n  TradingClickEvent,\n  TradingCrosshairEvent,\n  TradingDrawing,\n  TradingDrawingPatch,\n  TradingDrawingTool,\n  TradingHistoryRequestEvent,\n  TradingIndicatorToggleEvent,\n  TradingOrderCancelEvent,\n  TradingOrderCreateEvent,\n  TradingOrderMoveEvent,\n  TradingReplayState,\n  TradingScaleMode,\n  TradingUndoState,\n  TradingVisibleRange,\n} from \"../engine/trading/types\";\nimport type { ChartRendererKind } from \"../engine/types\";\n\n/** Imperative handle of `<TradingChart>` */\nexport interface TradingChartHandle {\n  /**\n   * Streams a bar: the time of the last bar replaces it, a later time\n   * appends it (cheap: call it on every tick)\n   */\n  update(bar: TradingBar): void;\n  /** Appends bars newer than the last one */\n  appendBars(bars: TradingBarsInput): void;\n  /** Inserts older bars before the first one, keeping the view */\n  prependBars(bars: TradingBarsInput): void;\n  /** Replaces the bars */\n  setBars(bars: TradingBarsInput): void;\n  /** Number of bars */\n  getBarCount(): number;\n  /** Bar at an index, `null` outside the data */\n  getBar(index: number): TradingBar | null;\n  /** Scrolls to the latest bar */\n  scrollToRealtime(animate?: boolean): void;\n  /** Shows every bar */\n  fitContent(): void;\n  /** Visible bars, `null` before mounting */\n  getVisibleRange(): TradingVisibleRange | null;\n  /** Shows the bars between two logical indices */\n  setVisibleRange(range: { from: number; to: number }): void;\n  /** Times at the edges of the plot, `null` before mounting */\n  getVisibleTimeRange(): { from: number; to: number } | null;\n  /** Shows the bars between two times */\n  setVisibleTimeRange(range: { from: number; to: number }): void;\n  /** Shows the crosshair at a time (and a price); `null` hides it */\n  setCrosshair(time: number | null, price?: number): void;\n  /** Sets the price scale of the price pane */\n  setScaleMode(mode: TradingScaleMode): void;\n  /** Fits every price scale to the visible bars again */\n  resetPriceScales(): void;\n  /** Activates a drawing tool */\n  setDrawingTool(tool: TradingDrawingTool): void;\n  /** Current drawings */\n  getDrawings(): readonly TradingDrawing[];\n  /** Deletes a drawing */\n  removeDrawing(id: string): void;\n  /** Changes the style or the content of a drawing (undoable) */\n  updateDrawing(id: string, patch: TradingDrawingPatch): void;\n  /** Selects a drawing (`null` clears the selection) */\n  selectDrawing(id: string | null): void;\n  /** Undoes the last change of the drawings */\n  undo(): void;\n  /** Redoes the last undone change of the drawings */\n  redo(): void;\n  /** Whether the drawings can be undone or redone */\n  getUndoState(): TradingUndoState;\n  /** Starts a bar replay after `time` (the user picks the bar without it) */\n  startReplay(time?: number): void;\n  /** Shows the next bars of the replay */\n  replayStep(count?: number): void;\n  /** Plays the replay at `speed` bars per second */\n  replayPlay(speed?: number): void;\n  /** Pauses the replay */\n  replayPause(): void;\n  /** Ends the replay and shows every bar */\n  stopReplay(): void;\n  /** State of the bar replay, `null` before mounting */\n  getReplayState(): TradingReplayState | null;\n  /** Image of the chart as a data URL (`\"\"` before mounting) */\n  toDataURL(type?: string, quality?: number): string;\n  /** Image of the chart as a blob */\n  toBlob(type?: string, quality?: number): Promise<Blob | null>;\n  /** Shows the chart full screen */\n  requestFullscreen(): Promise<void>;\n  /** Leaves full screen */\n  exitFullscreen(): Promise<void>;\n  /** Shows or hides an indicator */\n  setIndicatorVisible(id: string, visible: boolean): void;\n  /** Backend in use, `null` until ready */\n  getRenderer(): ChartRendererKind | null;\n  /** The underlying engine instance (minerva-design/charts/core) */\n  getInstance(): TradingChartInstance | null;\n}\n\n/** Props of `<TradingChart>`: the options of `createTradingChart`, the size and the events */\nexport interface TradingChartProps extends TradingChartOptions {\n  /**\n   * Height (pixels or any CSS length)\n   * @default 480\n   */\n  height?: number | string;\n  /**\n   * Width (pixels or any CSS length)\n   * @default \"100%\"\n   */\n  width?: number | string;\n  /** Class of the root element */\n  className?: string;\n  /** Inline styles of the root element */\n  style?: CSSProperties;\n  /** Imperative handle (streaming, scrolling, drawings) */\n  ref?: Ref<TradingChartHandle>;\n  /** The crosshair moved (`null` when it left the chart) */\n  onCrosshairMove?: (event: TradingCrosshairEvent | null) => void;\n  /** A pane was clicked */\n  onClick?: (event: TradingClickEvent) => void;\n  /** The visible bars changed */\n  onVisibleRangeChange?: (range: TradingVisibleRange) => void;\n  /** A draggable price line was dropped at a new price, or moved with the keyboard */\n  onOrderMove?: (event: TradingOrderMoveEvent) => void;\n  /** The \"+\" order entry button was clicked, or an order confirmed with the keyboard (see `orderEntry`) */\n  onOrderCreate?: (event: TradingOrderCreateEvent) => void;\n  /** The close button of a `cancellable` price line was clicked, or Delete pressed on it */\n  onOrderCancel?: (event: TradingOrderCancelEvent) => void;\n  /** The user added, moved or deleted drawings (pass them back as `drawings`) */\n  onDrawingsChange?: (drawings: readonly TradingDrawing[]) => void;\n  /** The selected drawing changed */\n  onDrawingSelect?: (id: string | null) => void;\n  /** The drawing tool changed (back to `cursor` after a drawing) */\n  onDrawingToolChange?: (tool: TradingDrawingTool) => void;\n  /** Undo / redo of the drawings became possible or impossible */\n  onUndoChange?: (state: TradingUndoState) => void;\n  /** The bar replay started, stepped, played, paused or stopped */\n  onReplayChange?: (state: TradingReplayState) => void;\n  /** The chart entered (`true`) or left full screen */\n  onFullscreenChange?: (fullscreen: boolean) => void;\n  /** An indicator was shown or hidden from its legend */\n  onIndicatorToggle?: (event: TradingIndicatorToggleEvent) => void;\n  /** The oldest bar came into view: load older bars (`prependBars`) */\n  onHistoryRequest?: (event: TradingHistoryRequestEvent) => void;\n  /** The backend in use (again after a fallback) */\n  onRendererChange?: (renderer: ChartRendererKind) => void;\n}\n\ntype Handlers = Pick<\n  TradingChartProps,\n  | \"onCrosshairMove\"\n  | \"onClick\"\n  | \"onVisibleRangeChange\"\n  | \"onOrderMove\"\n  | \"onOrderCreate\"\n  | \"onOrderCancel\"\n  | \"onDrawingsChange\"\n  | \"onDrawingSelect\"\n  | \"onDrawingToolChange\"\n  | \"onUndoChange\"\n  | \"onReplayChange\"\n  | \"onFullscreenChange\"\n  | \"onIndicatorToggle\"\n  | \"onHistoryRequest\"\n  | \"onRendererChange\"\n>;\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> => {\n  if (typeof value !== \"object\" || value === null) return false;\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n};\n\nconst shallowEqual = (\n  a: Record<string, unknown>,\n  b: Record<string, unknown>,\n): boolean => {\n  const keys = Object.keys(a);\n  if (keys.length !== Object.keys(b).length) return false;\n  return keys.every(\n    (key) =>\n      Object.prototype.hasOwnProperty.call(b, key) && sameItem(a[key], b[key]),\n  );\n};\n\n/** Identical, or inline arrays of identical values */\nconst sameItem = (a: unknown, b: unknown): boolean =>\n  a === b ||\n  (Array.isArray(a) &&\n    Array.isArray(b) &&\n    a.length === b.length &&\n    a.every((v, i) => v === b[i]));\n\n/**\n * Same option value: identical, or inline arrays / objects of plain objects\n * with identical fields (`indicators={[{ type: \"ma\", period: 7 }]}`). Bars,\n * markers and drawings are compared by identity when they are not plain\n * objects (typed arrays) and item by item otherwise.\n */\nconst sameValue = (a: unknown, b: unknown): boolean => {\n  if (a === b) return true;\n  if (Array.isArray(a) && Array.isArray(b)) {\n    return (\n      a.length === b.length &&\n      a.every(\n        (v, i) =>\n          v === b[i] ||\n          (isPlainObject(v) && isPlainObject(b[i]) && shallowEqual(v, b[i])),\n      )\n    );\n  }\n  return isPlainObject(a) && isPlainObject(b) && shallowEqual(a, b);\n};\n\n/** Options describing the same chart (bars and drawings compared by identity) */\nconst sameOptions = (a: TradingChartOptions, b: TradingChartOptions) => {\n  const keys = Object.keys(a) as (keyof TradingChartOptions)[];\n  if (keys.length !== Object.keys(b).length) return false;\n  return keys.every((key) => {\n    if (!Object.prototype.hasOwnProperty.call(b, key)) return false;\n    // new bars / drawings arrays are always applied: compared by identity\n    if (key === \"bars\" || key === \"drawings\") return a[key] === b[key];\n    return sameValue(a[key], b[key]);\n  });\n};\n\nconst size = (value: number | string | undefined, fallback: string) =>\n  value === undefined\n    ? fallback\n    : typeof value === \"number\"\n      ? `${value}px`\n      : value;\n\n/**\n * Professional trading chart: candles (hollow, Heikin-Ashi, bars, line,\n * area, baseline) over a gap-free time axis, indicator panes, drawing\n * tools, order lines and real-time streaming, drawn on the GPU.\n */\nexport function TradingChart(props: TradingChartProps) {\n  const {\n    height,\n    width,\n    className,\n    style,\n    ref,\n    onCrosshairMove,\n    onClick,\n    onVisibleRangeChange,\n    onOrderMove,\n    onOrderCreate,\n    onOrderCancel,\n    onDrawingsChange,\n    onDrawingSelect,\n    onDrawingToolChange,\n    onUndoChange,\n    onReplayChange,\n    onFullscreenChange,\n    onIndicatorToggle,\n    onHistoryRequest,\n    onRendererChange,\n    ...options\n  } = props;\n  const handlers: Handlers = {\n    onCrosshairMove,\n    onClick,\n    onVisibleRangeChange,\n    onOrderMove,\n    onOrderCreate,\n    onOrderCancel,\n    onDrawingsChange,\n    onDrawingSelect,\n    onDrawingToolChange,\n    onUndoChange,\n    onReplayChange,\n    onFullscreenChange,\n    onIndicatorToggle,\n    onHistoryRequest,\n    onRendererChange,\n  };\n  const containerRef = useRef<HTMLDivElement>(null);\n  const chartRef = useRef<TradingChartInstance | null>(null);\n  const handlersRef = useRef<Handlers>(handlers);\n\n  // a new options object on every render: keep the previous one while it\n  // describes the same chart (state derived during render)\n  const [stable, setStable] = useState<TradingChartOptions>(options);\n  if (stable !== options && !sameOptions(stable, options)) setStable(options);\n  const optionsRef = useRef(stable);\n\n  useEffect(() => {\n    handlersRef.current = handlers;\n  });\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n    const chart = createTradingChart(container, optionsRef.current);\n    chartRef.current = chart;\n    const h = () => handlersRef.current;\n    const offs = [\n      chart.on(\"crosshairMove\", (e) => h().onCrosshairMove?.(e)),\n      chart.on(\"click\", (e) => h().onClick?.(e)),\n      chart.on(\"visibleRangeChange\", (e) => h().onVisibleRangeChange?.(e)),\n      chart.on(\"orderMove\", (e) => h().onOrderMove?.(e)),\n      chart.on(\"orderCreate\", (e) => h().onOrderCreate?.(e)),\n      chart.on(\"orderCancel\", (e) => h().onOrderCancel?.(e)),\n      chart.on(\"drawingsChange\", (e) => h().onDrawingsChange?.(e)),\n      chart.on(\"drawingSelect\", (e) => h().onDrawingSelect?.(e)),\n      chart.on(\"drawingToolChange\", (e) => h().onDrawingToolChange?.(e)),\n      chart.on(\"undoChange\", (e) => h().onUndoChange?.(e)),\n      chart.on(\"replayChange\", (e) => h().onReplayChange?.(e)),\n      chart.on(\"fullscreenChange\", (e) => h().onFullscreenChange?.(e)),\n      chart.on(\"indicatorToggle\", (e) => h().onIndicatorToggle?.(e)),\n      chart.on(\"historyRequest\", (e) => h().onHistoryRequest?.(e)),\n      chart.on(\"renderer\", (e) => h().onRendererChange?.(e)),\n    ];\n    return () => {\n      offs.forEach((off) => off());\n      chart.destroy();\n      chartRef.current = null;\n    };\n  }, []);\n\n  useEffect(() => {\n    if (optionsRef.current === stable) return;\n    optionsRef.current = stable;\n    chartRef.current?.setOptions(stable);\n  }, [stable]);\n\n  useImperativeHandle(\n    ref,\n    (): TradingChartHandle => ({\n      update: (bar) => chartRef.current?.update(bar),\n      appendBars: (bars) => chartRef.current?.appendBars(bars),\n      prependBars: (bars) => chartRef.current?.prependBars(bars),\n      setBars: (bars) => chartRef.current?.setBars(bars),\n      getBarCount: () => chartRef.current?.getBarCount() ?? 0,\n      getBar: (index) => chartRef.current?.getBar(index) ?? null,\n      scrollToRealtime: (animate) =>\n        chartRef.current?.scrollToRealtime(animate),\n      fitContent: () => chartRef.current?.fitContent(),\n      getVisibleRange: () => chartRef.current?.getVisibleRange() ?? null,\n      setVisibleRange: (range) => chartRef.current?.setVisibleRange(range),\n      getVisibleTimeRange: () =>\n        chartRef.current?.getVisibleTimeRange() ?? null,\n      setVisibleTimeRange: (range) =>\n        chartRef.current?.setVisibleTimeRange(range),\n      setCrosshair: (time, price) =>\n        chartRef.current?.setCrosshair(time, price),\n      setScaleMode: (mode) => chartRef.current?.setScaleMode(mode),\n      resetPriceScales: () => chartRef.current?.resetPriceScales(),\n      setDrawingTool: (tool) => chartRef.current?.setDrawingTool(tool),\n      getDrawings: () => chartRef.current?.getDrawings() ?? [],\n      removeDrawing: (id) => chartRef.current?.removeDrawing(id),\n      updateDrawing: (id, patch) => chartRef.current?.updateDrawing(id, patch),\n      selectDrawing: (id) => chartRef.current?.selectDrawing(id),\n      undo: () => chartRef.current?.undo(),\n      redo: () => chartRef.current?.redo(),\n      getUndoState: () =>\n        chartRef.current?.getUndoState() ?? { canUndo: false, canRedo: false },\n      startReplay: (time) => chartRef.current?.startReplay(time),\n      replayStep: (count) => chartRef.current?.replayStep(count),\n      replayPlay: (speed) => chartRef.current?.replayPlay(speed),\n      replayPause: () => chartRef.current?.replayPause(),\n      stopReplay: () => chartRef.current?.stopReplay(),\n      getReplayState: () => chartRef.current?.getReplayState() ?? null,\n      toDataURL: (type, quality) =>\n        chartRef.current?.toDataURL(type, quality) ?? \"\",\n      toBlob: (type, quality) =>\n        chartRef.current?.toBlob(type, quality) ?? Promise.resolve(null),\n      requestFullscreen: () =>\n        chartRef.current?.requestFullscreen() ?? Promise.resolve(),\n      exitFullscreen: () =>\n        chartRef.current?.exitFullscreen() ?? Promise.resolve(),\n      setIndicatorVisible: (id, visible) =>\n        chartRef.current?.setIndicatorVisible(id, visible),\n      getRenderer: () => chartRef.current?.getRenderer() ?? null,\n      getInstance: () => chartRef.current,\n    }),\n    [],\n  );\n\n  return (\n    <div\n      className={className}\n      style={{\n        position: \"relative\",\n        width: size(width, \"100%\"),\n        height: size(height, \"480px\"),\n        ...style,\n      }}\n    >\n      <div ref={containerRef} style={{ position: \"absolute\", inset: 0 }} />\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/charts/react/trading.d.cts

@@ -1,5 +1,5 @@
 import { CSSProperties, Ref } from 'react';
-import { TradingBar, TradingBarsInput, TradingChartInstance, TradingChartOptions, TradingClickEvent, TradingCrosshairEvent, TradingDrawing, TradingDrawingTool, TradingHistoryRequestEvent, TradingIndicatorToggleEvent, TradingOrderMoveEvent, TradingVisibleRange } from '../engine/trading/types.cjs';
+import { TradingBar, TradingBarsInput, TradingChartInstance, TradingChartOptions, TradingClickEvent, TradingCrosshairEvent, TradingDrawing, TradingDrawingPatch, TradingDrawingTool, TradingHistoryRequestEvent, TradingIndicatorToggleEvent, TradingOrderCancelEvent, TradingOrderCreateEvent, TradingOrderMoveEvent, TradingReplayState, TradingScaleMode, TradingUndoState, TradingVisibleRange } from '../engine/trading/types.cjs';
 import { ChartRendererKind } from '../engine/types.cjs';
 /** Imperative handle of `<TradingChart>` */
 export interface TradingChartHandle {
@@ -29,6 +29,20 @@ export interface TradingChartHandle {
         from: number;
         to: number;
     }): void;
+    /** Times at the edges of the plot, `null` before mounting */
+    getVisibleTimeRange(): {
+        from: number;
+        to: number;
+    } | null;
+    /** Shows the bars between two times */
+    setVisibleTimeRange(range: {
+        from: number;
+        to: number;
+    }): void;
+    /** Shows the crosshair at a time (and a price); `null` hides it */
+    setCrosshair(time: number | null, price?: number): void;
+    /** Sets the price scale of the price pane */
+    setScaleMode(mode: TradingScaleMode): void;
     /** Fits every price scale to the visible bars again */
     resetPriceScales(): void;
     /** Activates a drawing tool */
@@ -37,8 +51,36 @@ export interface TradingChartHandle {
     getDrawings(): readonly TradingDrawing[];
     /** Deletes a drawing */
     removeDrawing(id: string): void;
+    /** Changes the style or the content of a drawing (undoable) */
+    updateDrawing(id: string, patch: TradingDrawingPatch): void;
     /** Selects a drawing (`null` clears the selection) */
     selectDrawing(id: string | null): void;
+    /** Undoes the last change of the drawings */
+    undo(): void;
+    /** Redoes the last undone change of the drawings */
+    redo(): void;
+    /** Whether the drawings can be undone or redone */
+    getUndoState(): TradingUndoState;
+    /** Starts a bar replay after `time` (the user picks the bar without it) */
+    startReplay(time?: number): void;
+    /** Shows the next bars of the replay */
+    replayStep(count?: number): void;
+    /** Plays the replay at `speed` bars per second */
+    replayPlay(speed?: number): void;
+    /** Pauses the replay */
+    replayPause(): void;
+    /** Ends the replay and shows every bar */
+    stopReplay(): void;
+    /** State of the bar replay, `null` before mounting */
+    getReplayState(): TradingReplayState | null;
+    /** Image of the chart as a data URL (`""` before mounting) */
+    toDataURL(type?: string, quality?: number): string;
+    /** Image of the chart as a blob */
+    toBlob(type?: string, quality?: number): Promise<Blob | null>;
+    /** Shows the chart full screen */
+    requestFullscreen(): Promise<void>;
+    /** Leaves full screen */
+    exitFullscreen(): Promise<void>;
     /** Shows or hides an indicator */
     setIndicatorVisible(id: string, visible: boolean): void;
     /** Backend in use, `null` until ready */
@@ -70,14 +112,24 @@ export interface TradingChartProps extends TradingChartOptions {
     onClick?: (event: TradingClickEvent) => void;
     /** The visible bars changed */
     onVisibleRangeChange?: (range: TradingVisibleRange) => void;
-    /** A draggable price line was dropped at a new price */
+    /** A draggable price line was dropped at a new price, or moved with the keyboard */
     onOrderMove?: (event: TradingOrderMoveEvent) => void;
+    /** The "+" order entry button was clicked, or an order confirmed with the keyboard (see `orderEntry`) */
+    onOrderCreate?: (event: TradingOrderCreateEvent) => void;
+    /** The close button of a `cancellable` price line was clicked, or Delete pressed on it */
+    onOrderCancel?: (event: TradingOrderCancelEvent) => void;
     /** The user added, moved or deleted drawings (pass them back as `drawings`) */
     onDrawingsChange?: (drawings: readonly TradingDrawing[]) => void;
     /** The selected drawing changed */
     onDrawingSelect?: (id: string | null) => void;
     /** The drawing tool changed (back to `cursor` after a drawing) */
     onDrawingToolChange?: (tool: TradingDrawingTool) => void;
+    /** Undo / redo of the drawings became possible or impossible */
+    onUndoChange?: (state: TradingUndoState) => void;
+    /** The bar replay started, stepped, played, paused or stopped */
+    onReplayChange?: (state: TradingReplayState) => void;
+    /** The chart entered (`true`) or left full screen */
+    onFullscreenChange?: (fullscreen: boolean) => void;
     /** An indicator was shown or hidden from its legend */
     onIndicatorToggle?: (event: TradingIndicatorToggleEvent) => void;
     /** The oldest bar came into view: load older bars (`prependBars`) */

package/dist/charts/react/trading.d.ts

@@ -1,5 +1,5 @@
 import { CSSProperties, Ref } from 'react';
-import { TradingBar, TradingBarsInput, TradingChartInstance, TradingChartOptions, TradingClickEvent, TradingCrosshairEvent, TradingDrawing, TradingDrawingTool, TradingHistoryRequestEvent, TradingIndicatorToggleEvent, TradingOrderMoveEvent, TradingVisibleRange } from '../engine/trading/types.js';
+import { TradingBar, TradingBarsInput, TradingChartInstance, TradingChartOptions, TradingClickEvent, TradingCrosshairEvent, TradingDrawing, TradingDrawingPatch, TradingDrawingTool, TradingHistoryRequestEvent, TradingIndicatorToggleEvent, TradingOrderCancelEvent, TradingOrderCreateEvent, TradingOrderMoveEvent, TradingReplayState, TradingScaleMode, TradingUndoState, TradingVisibleRange } from '../engine/trading/types.js';
 import { ChartRendererKind } from '../engine/types.js';
 /** Imperative handle of `<TradingChart>` */
 export interface TradingChartHandle {
@@ -29,6 +29,20 @@ export interface TradingChartHandle {
         from: number;
         to: number;
     }): void;
+    /** Times at the edges of the plot, `null` before mounting */
+    getVisibleTimeRange(): {
+        from: number;
+        to: number;
+    } | null;
+    /** Shows the bars between two times */
+    setVisibleTimeRange(range: {
+        from: number;
+        to: number;
+    }): void;
+    /** Shows the crosshair at a time (and a price); `null` hides it */
+    setCrosshair(time: number | null, price?: number): void;
+    /** Sets the price scale of the price pane */
+    setScaleMode(mode: TradingScaleMode): void;
     /** Fits every price scale to the visible bars again */
     resetPriceScales(): void;
     /** Activates a drawing tool */
@@ -37,8 +51,36 @@ export interface TradingChartHandle {
     getDrawings(): readonly TradingDrawing[];
     /** Deletes a drawing */
     removeDrawing(id: string): void;
+    /** Changes the style or the content of a drawing (undoable) */
+    updateDrawing(id: string, patch: TradingDrawingPatch): void;
     /** Selects a drawing (`null` clears the selection) */
     selectDrawing(id: string | null): void;
+    /** Undoes the last change of the drawings */
+    undo(): void;
+    /** Redoes the last undone change of the drawings */
+    redo(): void;
+    /** Whether the drawings can be undone or redone */
+    getUndoState(): TradingUndoState;
+    /** Starts a bar replay after `time` (the user picks the bar without it) */
+    startReplay(time?: number): void;
+    /** Shows the next bars of the replay */
+    replayStep(count?: number): void;
+    /** Plays the replay at `speed` bars per second */
+    replayPlay(speed?: number): void;
+    /** Pauses the replay */
+    replayPause(): void;
+    /** Ends the replay and shows every bar */
+    stopReplay(): void;
+    /** State of the bar replay, `null` before mounting */
+    getReplayState(): TradingReplayState | null;
+    /** Image of the chart as a data URL (`""` before mounting) */
+    toDataURL(type?: string, quality?: number): string;
+    /** Image of the chart as a blob */
+    toBlob(type?: string, quality?: number): Promise<Blob | null>;
+    /** Shows the chart full screen */
+    requestFullscreen(): Promise<void>;
+    /** Leaves full screen */
+    exitFullscreen(): Promise<void>;
     /** Shows or hides an indicator */
     setIndicatorVisible(id: string, visible: boolean): void;
     /** Backend in use, `null` until ready */
@@ -70,14 +112,24 @@ export interface TradingChartProps extends TradingChartOptions {
     onClick?: (event: TradingClickEvent) => void;
     /** The visible bars changed */
     onVisibleRangeChange?: (range: TradingVisibleRange) => void;
-    /** A draggable price line was dropped at a new price */
+    /** A draggable price line was dropped at a new price, or moved with the keyboard */
     onOrderMove?: (event: TradingOrderMoveEvent) => void;
+    /** The "+" order entry button was clicked, or an order confirmed with the keyboard (see `orderEntry`) */
+    onOrderCreate?: (event: TradingOrderCreateEvent) => void;
+    /** The close button of a `cancellable` price line was clicked, or Delete pressed on it */
+    onOrderCancel?: (event: TradingOrderCancelEvent) => void;
     /** The user added, moved or deleted drawings (pass them back as `drawings`) */
     onDrawingsChange?: (drawings: readonly TradingDrawing[]) => void;
     /** The selected drawing changed */
     onDrawingSelect?: (id: string | null) => void;
     /** The drawing tool changed (back to `cursor` after a drawing) */
     onDrawingToolChange?: (tool: TradingDrawingTool) => void;
+    /** Undo / redo of the drawings became possible or impossible */
+    onUndoChange?: (state: TradingUndoState) => void;
+    /** The bar replay started, stepped, played, paused or stopped */
+    onReplayChange?: (state: TradingReplayState) => void;
+    /** The chart entered (`true`) or left full screen */
+    onFullscreenChange?: (fullscreen: boolean) => void;
     /** An indicator was shown or hidden from its legend */
     onIndicatorToggle?: (event: TradingIndicatorToggleEvent) => void;
     /** The oldest bar came into view: load older bars (`prependBars`) */

package/dist/charts/react/trading.js

@@ -15,63 +15,94 @@ var o = (e) => {
 	return n.length === Object.keys(t).length && n.every((n) => Object.prototype.hasOwnProperty.call(t, n) ? n === "bars" || n === "drawings" ? e[n] === t[n] : l(e[n], t[n]) : !1);
 }, d = (e, t) => e === void 0 ? t : typeof e == "number" ? `${e}px` : e;
 function f(o) {
-	let { height: s, width: c, className: l, style: f, ref: p, onCrosshairMove: m, onClick: h, onVisibleRangeChange: g, onOrderMove: _, onDrawingsChange: v, onDrawingSelect: y, onDrawingToolChange: b, onIndicatorToggle: x, onHistoryRequest: S, onRendererChange: C, ...w } = o, T = {
+	let { height: s, width: c, className: l, style: f, ref: p, onCrosshairMove: m, onClick: h, onVisibleRangeChange: g, onOrderMove: _, onOrderCreate: v, onOrderCancel: y, onDrawingsChange: b, onDrawingSelect: x, onDrawingToolChange: S, onUndoChange: C, onReplayChange: w, onFullscreenChange: T, onIndicatorToggle: E, onHistoryRequest: D, onRendererChange: O, ...k } = o, A = {
 		onCrosshairMove: m,
 		onClick: h,
 		onVisibleRangeChange: g,
 		onOrderMove: _,
-		onDrawingsChange: v,
-		onDrawingSelect: y,
-		onDrawingToolChange: b,
-		onIndicatorToggle: x,
-		onHistoryRequest: S,
-		onRendererChange: C
-	}, E = r(null), D = r(null), O = r(T), [k, A] = i(w);
-	k !== w && !u(k, w) && A(w);
-	let j = r(k);
+		onOrderCreate: v,
+		onOrderCancel: y,
+		onDrawingsChange: b,
+		onDrawingSelect: x,
+		onDrawingToolChange: S,
+		onUndoChange: C,
+		onReplayChange: w,
+		onFullscreenChange: T,
+		onIndicatorToggle: E,
+		onHistoryRequest: D,
+		onRendererChange: O
+	}, j = r(null), M = r(null), N = r(A), [P, F] = i(k);
+	P !== k && !u(P, k) && F(k);
+	let I = r(P);
 	return t(() => {
-		O.current = T;
+		N.current = A;
 	}), t(() => {
-		let t = E.current;
+		let t = j.current;
 		if (!t) return;
-		let n = e(t, j.current);
-		D.current = n;
-		let r = () => O.current, i = [
+		let n = e(t, I.current);
+		M.current = n;
+		let r = () => N.current, i = [
 			n.on("crosshairMove", (e) => r().onCrosshairMove?.(e)),
 			n.on("click", (e) => r().onClick?.(e)),
 			n.on("visibleRangeChange", (e) => r().onVisibleRangeChange?.(e)),
 			n.on("orderMove", (e) => r().onOrderMove?.(e)),
+			n.on("orderCreate", (e) => r().onOrderCreate?.(e)),
+			n.on("orderCancel", (e) => r().onOrderCancel?.(e)),
 			n.on("drawingsChange", (e) => r().onDrawingsChange?.(e)),
 			n.on("drawingSelect", (e) => r().onDrawingSelect?.(e)),
 			n.on("drawingToolChange", (e) => r().onDrawingToolChange?.(e)),
+			n.on("undoChange", (e) => r().onUndoChange?.(e)),
+			n.on("replayChange", (e) => r().onReplayChange?.(e)),
+			n.on("fullscreenChange", (e) => r().onFullscreenChange?.(e)),
 			n.on("indicatorToggle", (e) => r().onIndicatorToggle?.(e)),
 			n.on("historyRequest", (e) => r().onHistoryRequest?.(e)),
 			n.on("renderer", (e) => r().onRendererChange?.(e))
 		];
 		return () => {
-			i.forEach((e) => e()), n.destroy(), D.current = null;
+			i.forEach((e) => e()), n.destroy(), M.current = null;
 		};
 	}, []), t(() => {
-		j.current !== k && (j.current = k, D.current?.setOptions(k));
-	}, [k]), n(p, () => ({
-		update: (e) => D.current?.update(e),
-		appendBars: (e) => D.current?.appendBars(e),
-		prependBars: (e) => D.current?.prependBars(e),
-		setBars: (e) => D.current?.setBars(e),
-		getBarCount: () => D.current?.getBarCount() ?? 0,
-		getBar: (e) => D.current?.getBar(e) ?? null,
-		scrollToRealtime: (e) => D.current?.scrollToRealtime(e),
-		fitContent: () => D.current?.fitContent(),
-		getVisibleRange: () => D.current?.getVisibleRange() ?? null,
-		setVisibleRange: (e) => D.current?.setVisibleRange(e),
-		resetPriceScales: () => D.current?.resetPriceScales(),
-		setDrawingTool: (e) => D.current?.setDrawingTool(e),
-		getDrawings: () => D.current?.getDrawings() ?? [],
-		removeDrawing: (e) => D.current?.removeDrawing(e),
-		selectDrawing: (e) => D.current?.selectDrawing(e),
-		setIndicatorVisible: (e, t) => D.current?.setIndicatorVisible(e, t),
-		getRenderer: () => D.current?.getRenderer() ?? null,
-		getInstance: () => D.current
+		I.current !== P && (I.current = P, M.current?.setOptions(P));
+	}, [P]), n(p, () => ({
+		update: (e) => M.current?.update(e),
+		appendBars: (e) => M.current?.appendBars(e),
+		prependBars: (e) => M.current?.prependBars(e),
+		setBars: (e) => M.current?.setBars(e),
+		getBarCount: () => M.current?.getBarCount() ?? 0,
+		getBar: (e) => M.current?.getBar(e) ?? null,
+		scrollToRealtime: (e) => M.current?.scrollToRealtime(e),
+		fitContent: () => M.current?.fitContent(),
+		getVisibleRange: () => M.current?.getVisibleRange() ?? null,
+		setVisibleRange: (e) => M.current?.setVisibleRange(e),
+		getVisibleTimeRange: () => M.current?.getVisibleTimeRange() ?? null,
+		setVisibleTimeRange: (e) => M.current?.setVisibleTimeRange(e),
+		setCrosshair: (e, t) => M.current?.setCrosshair(e, t),
+		setScaleMode: (e) => M.current?.setScaleMode(e),
+		resetPriceScales: () => M.current?.resetPriceScales(),
+		setDrawingTool: (e) => M.current?.setDrawingTool(e),
+		getDrawings: () => M.current?.getDrawings() ?? [],
+		removeDrawing: (e) => M.current?.removeDrawing(e),
+		updateDrawing: (e, t) => M.current?.updateDrawing(e, t),
+		selectDrawing: (e) => M.current?.selectDrawing(e),
+		undo: () => M.current?.undo(),
+		redo: () => M.current?.redo(),
+		getUndoState: () => M.current?.getUndoState() ?? {
+			canUndo: !1,
+			canRedo: !1
+		},
+		startReplay: (e) => M.current?.startReplay(e),
+		replayStep: (e) => M.current?.replayStep(e),
+		replayPlay: (e) => M.current?.replayPlay(e),
+		replayPause: () => M.current?.replayPause(),
+		stopReplay: () => M.current?.stopReplay(),
+		getReplayState: () => M.current?.getReplayState() ?? null,
+		toDataURL: (e, t) => M.current?.toDataURL(e, t) ?? "",
+		toBlob: (e, t) => M.current?.toBlob(e, t) ?? Promise.resolve(null),
+		requestFullscreen: () => M.current?.requestFullscreen() ?? Promise.resolve(),
+		exitFullscreen: () => M.current?.exitFullscreen() ?? Promise.resolve(),
+		setIndicatorVisible: (e, t) => M.current?.setIndicatorVisible(e, t),
+		getRenderer: () => M.current?.getRenderer() ?? null,
+		getInstance: () => M.current
 	}), []), /* @__PURE__ */ a("div", {
 		className: l,
 		style: {
@@ -81,7 +112,7 @@ function f(o) {
 			...f
 		},
 		children: /* @__PURE__ */ a("div", {
-			ref: E,
+			ref: j,
 			style: {
 				position: "absolute",
 				inset: 0

package/dist/charts/react/trading.js.map

@@ -1 +1 @@
-{"version":3,"file":"trading.js","names":["isPlainObject","value","proto","shallowEqual","keys","a","b","key","sameItem","v","i","sameValue","sameOptions","size","fallback","TradingChart","options","props","handlers","containerRef","useRef","chartRef","handlersRef","stable","setStable","useState","optionsRef","useEffect","container","chart","createTradingChart","h","offs","off","useImperativeHandle","ref","bar","bars","index","animate","range","tool","id","visible","width","height","style"],"sources":["../../../../charts/src/react/trading.tsx"],"sourcesContent":["import {\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  useState,\n  type CSSProperties,\n  type Ref,\n} from \"react\";\nimport { createTradingChart } from \"../engine/trading/chart\";\nimport type {\n  TradingBar,\n  TradingBarsInput,\n  TradingChartInstance,\n  TradingChartOptions,\n  TradingClickEvent,\n  TradingCrosshairEvent,\n  TradingDrawing,\n  TradingDrawingTool,\n  TradingHistoryRequestEvent,\n  TradingIndicatorToggleEvent,\n  TradingOrderMoveEvent,\n  TradingVisibleRange,\n} from \"../engine/trading/types\";\nimport type { ChartRendererKind } from \"../engine/types\";\n\n/** Imperative handle of `<TradingChart>` */\nexport interface TradingChartHandle {\n  /**\n   * Streams a bar: the time of the last bar replaces it, a later time\n   * appends it (cheap: call it on every tick)\n   */\n  update(bar: TradingBar): void;\n  /** Appends bars newer than the last one */\n  appendBars(bars: TradingBarsInput): void;\n  /** Inserts older bars before the first one, keeping the view */\n  prependBars(bars: TradingBarsInput): void;\n  /** Replaces the bars */\n  setBars(bars: TradingBarsInput): void;\n  /** Number of bars */\n  getBarCount(): number;\n  /** Bar at an index, `null` outside the data */\n  getBar(index: number): TradingBar | null;\n  /** Scrolls to the latest bar */\n  scrollToRealtime(animate?: boolean): void;\n  /** Shows every bar */\n  fitContent(): void;\n  /** Visible bars, `null` before mounting */\n  getVisibleRange(): TradingVisibleRange | null;\n  /** Shows the bars between two logical indices */\n  setVisibleRange(range: { from: number; to: number }): void;\n  /** Fits every price scale to the visible bars again */\n  resetPriceScales(): void;\n  /** Activates a drawing tool */\n  setDrawingTool(tool: TradingDrawingTool): void;\n  /** Current drawings */\n  getDrawings(): readonly TradingDrawing[];\n  /** Deletes a drawing */\n  removeDrawing(id: string): void;\n  /** Selects a drawing (`null` clears the selection) */\n  selectDrawing(id: string | null): void;\n  /** Shows or hides an indicator */\n  setIndicatorVisible(id: string, visible: boolean): void;\n  /** Backend in use, `null` until ready */\n  getRenderer(): ChartRendererKind | null;\n  /** The underlying engine instance (minerva-design/charts/core) */\n  getInstance(): TradingChartInstance | null;\n}\n\n/** Props of `<TradingChart>`: the options of `createTradingChart`, the size and the events */\nexport interface TradingChartProps extends TradingChartOptions {\n  /**\n   * Height (pixels or any CSS length)\n   * @default 480\n   */\n  height?: number | string;\n  /**\n   * Width (pixels or any CSS length)\n   * @default \"100%\"\n   */\n  width?: number | string;\n  /** Class of the root element */\n  className?: string;\n  /** Inline styles of the root element */\n  style?: CSSProperties;\n  /** Imperative handle (streaming, scrolling, drawings) */\n  ref?: Ref<TradingChartHandle>;\n  /** The crosshair moved (`null` when it left the chart) */\n  onCrosshairMove?: (event: TradingCrosshairEvent | null) => void;\n  /** A pane was clicked */\n  onClick?: (event: TradingClickEvent) => void;\n  /** The visible bars changed */\n  onVisibleRangeChange?: (range: TradingVisibleRange) => void;\n  /** A draggable price line was dropped at a new price */\n  onOrderMove?: (event: TradingOrderMoveEvent) => void;\n  /** The user added, moved or deleted drawings (pass them back as `drawings`) */\n  onDrawingsChange?: (drawings: readonly TradingDrawing[]) => void;\n  /** The selected drawing changed */\n  onDrawingSelect?: (id: string | null) => void;\n  /** The drawing tool changed (back to `cursor` after a drawing) */\n  onDrawingToolChange?: (tool: TradingDrawingTool) => void;\n  /** An indicator was shown or hidden from its legend */\n  onIndicatorToggle?: (event: TradingIndicatorToggleEvent) => void;\n  /** The oldest bar came into view: load older bars (`prependBars`) */\n  onHistoryRequest?: (event: TradingHistoryRequestEvent) => void;\n  /** The backend in use (again after a fallback) */\n  onRendererChange?: (renderer: ChartRendererKind) => void;\n}\n\ntype Handlers = Pick<\n  TradingChartProps,\n  | \"onCrosshairMove\"\n  | \"onClick\"\n  | \"onVisibleRangeChange\"\n  | \"onOrderMove\"\n  | \"onDrawingsChange\"\n  | \"onDrawingSelect\"\n  | \"onDrawingToolChange\"\n  | \"onIndicatorToggle\"\n  | \"onHistoryRequest\"\n  | \"onRendererChange\"\n>;\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> => {\n  if (typeof value !== \"object\" || value === null) return false;\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n};\n\nconst shallowEqual = (\n  a: Record<string, unknown>,\n  b: Record<string, unknown>,\n): boolean => {\n  const keys = Object.keys(a);\n  if (keys.length !== Object.keys(b).length) return false;\n  return keys.every(\n    (key) =>\n      Object.prototype.hasOwnProperty.call(b, key) && sameItem(a[key], b[key]),\n  );\n};\n\n/** Identical, or inline arrays of identical values */\nconst sameItem = (a: unknown, b: unknown): boolean =>\n  a === b ||\n  (Array.isArray(a) &&\n    Array.isArray(b) &&\n    a.length === b.length &&\n    a.every((v, i) => v === b[i]));\n\n/**\n * Same option value: identical, or inline arrays / objects of plain objects\n * with identical fields (`indicators={[{ type: \"ma\", period: 7 }]}`). Bars,\n * markers and drawings are compared by identity when they are not plain\n * objects (typed arrays) and item by item otherwise.\n */\nconst sameValue = (a: unknown, b: unknown): boolean => {\n  if (a === b) return true;\n  if (Array.isArray(a) && Array.isArray(b)) {\n    return (\n      a.length === b.length &&\n      a.every(\n        (v, i) =>\n          v === b[i] ||\n          (isPlainObject(v) && isPlainObject(b[i]) && shallowEqual(v, b[i])),\n      )\n    );\n  }\n  return isPlainObject(a) && isPlainObject(b) && shallowEqual(a, b);\n};\n\n/** Options describing the same chart (bars and drawings compared by identity) */\nconst sameOptions = (a: TradingChartOptions, b: TradingChartOptions) => {\n  const keys = Object.keys(a) as (keyof TradingChartOptions)[];\n  if (keys.length !== Object.keys(b).length) return false;\n  return keys.every((key) => {\n    if (!Object.prototype.hasOwnProperty.call(b, key)) return false;\n    // new bars / drawings arrays are always applied: compared by identity\n    if (key === \"bars\" || key === \"drawings\") return a[key] === b[key];\n    return sameValue(a[key], b[key]);\n  });\n};\n\nconst size = (value: number | string | undefined, fallback: string) =>\n  value === undefined\n    ? fallback\n    : typeof value === \"number\"\n      ? `${value}px`\n      : value;\n\n/**\n * Professional trading chart: candles (hollow, Heikin-Ashi, bars, line,\n * area, baseline) over a gap-free time axis, indicator panes, drawing\n * tools, order lines and real-time streaming, drawn on the GPU.\n */\nexport function TradingChart(props: TradingChartProps) {\n  const {\n    height,\n    width,\n    className,\n    style,\n    ref,\n    onCrosshairMove,\n    onClick,\n    onVisibleRangeChange,\n    onOrderMove,\n    onDrawingsChange,\n    onDrawingSelect,\n    onDrawingToolChange,\n    onIndicatorToggle,\n    onHistoryRequest,\n    onRendererChange,\n    ...options\n  } = props;\n  const handlers: Handlers = {\n    onCrosshairMove,\n    onClick,\n    onVisibleRangeChange,\n    onOrderMove,\n    onDrawingsChange,\n    onDrawingSelect,\n    onDrawingToolChange,\n    onIndicatorToggle,\n    onHistoryRequest,\n    onRendererChange,\n  };\n  const containerRef = useRef<HTMLDivElement>(null);\n  const chartRef = useRef<TradingChartInstance | null>(null);\n  const handlersRef = useRef<Handlers>(handlers);\n\n  // a new options object on every render: keep the previous one while it\n  // describes the same chart (state derived during render)\n  const [stable, setStable] = useState<TradingChartOptions>(options);\n  if (stable !== options && !sameOptions(stable, options)) setStable(options);\n  const optionsRef = useRef(stable);\n\n  useEffect(() => {\n    handlersRef.current = handlers;\n  });\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n    const chart = createTradingChart(container, optionsRef.current);\n    chartRef.current = chart;\n    const h = () => handlersRef.current;\n    const offs = [\n      chart.on(\"crosshairMove\", (e) => h().onCrosshairMove?.(e)),\n      chart.on(\"click\", (e) => h().onClick?.(e)),\n      chart.on(\"visibleRangeChange\", (e) => h().onVisibleRangeChange?.(e)),\n      chart.on(\"orderMove\", (e) => h().onOrderMove?.(e)),\n      chart.on(\"drawingsChange\", (e) => h().onDrawingsChange?.(e)),\n      chart.on(\"drawingSelect\", (e) => h().onDrawingSelect?.(e)),\n      chart.on(\"drawingToolChange\", (e) => h().onDrawingToolChange?.(e)),\n      chart.on(\"indicatorToggle\", (e) => h().onIndicatorToggle?.(e)),\n      chart.on(\"historyRequest\", (e) => h().onHistoryRequest?.(e)),\n      chart.on(\"renderer\", (e) => h().onRendererChange?.(e)),\n    ];\n    return () => {\n      offs.forEach((off) => off());\n      chart.destroy();\n      chartRef.current = null;\n    };\n  }, []);\n\n  useEffect(() => {\n    if (optionsRef.current === stable) return;\n    optionsRef.current = stable;\n    chartRef.current?.setOptions(stable);\n  }, [stable]);\n\n  useImperativeHandle(\n    ref,\n    (): TradingChartHandle => ({\n      update: (bar) => chartRef.current?.update(bar),\n      appendBars: (bars) => chartRef.current?.appendBars(bars),\n      prependBars: (bars) => chartRef.current?.prependBars(bars),\n      setBars: (bars) => chartRef.current?.setBars(bars),\n      getBarCount: () => chartRef.current?.getBarCount() ?? 0,\n      getBar: (index) => chartRef.current?.getBar(index) ?? null,\n      scrollToRealtime: (animate) =>\n        chartRef.current?.scrollToRealtime(animate),\n      fitContent: () => chartRef.current?.fitContent(),\n      getVisibleRange: () => chartRef.current?.getVisibleRange() ?? null,\n      setVisibleRange: (range) => chartRef.current?.setVisibleRange(range),\n      resetPriceScales: () => chartRef.current?.resetPriceScales(),\n      setDrawingTool: (tool) => chartRef.current?.setDrawingTool(tool),\n      getDrawings: () => chartRef.current?.getDrawings() ?? [],\n      removeDrawing: (id) => chartRef.current?.removeDrawing(id),\n      selectDrawing: (id) => chartRef.current?.selectDrawing(id),\n      setIndicatorVisible: (id, visible) =>\n        chartRef.current?.setIndicatorVisible(id, visible),\n      getRenderer: () => chartRef.current?.getRenderer() ?? null,\n      getInstance: () => chartRef.current,\n    }),\n    [],\n  );\n\n  return (\n    <div\n      className={className}\n      style={{\n        position: \"relative\",\n        width: size(width, \"100%\"),\n        height: size(height, \"480px\"),\n        ...style,\n      }}\n    >\n      <div ref={containerRef} style={{ position: \"absolute\", inset: 0 }} />\n    </div>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"trading.js","names":["isPlainObject","value","proto","shallowEqual","keys","a","b","key","sameItem","v","i","sameValue","sameOptions","size","fallback","TradingChart","options","props","handlers","containerRef","useRef","chartRef","handlersRef","stable","setStable","useState","optionsRef","useEffect","container","chart","createTradingChart","h","offs","off","useImperativeHandle","ref","bar","bars","index","animate","range","time","price","mode","tool","id","patch","count","speed","type","quality","visible","width","height","style"],"sources":["../../../../charts/src/react/trading.tsx"],"sourcesContent":["import {\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  useState,\n  type CSSProperties,\n  type Ref,\n} from \"react\";\nimport { createTradingChart } from \"../engine/trading/chart\";\nimport type {\n  TradingBar,\n  TradingBarsInput,\n  TradingChartInstance,\n  TradingChartOptions,\n  TradingClickEvent,\n  TradingCrosshairEvent,\n  TradingDrawing,\n  TradingDrawingPatch,\n  TradingDrawingTool,\n  TradingHistoryRequestEvent,\n  TradingIndicatorToggleEvent,\n  TradingOrderCancelEvent,\n  TradingOrderCreateEvent,\n  TradingOrderMoveEvent,\n  TradingReplayState,\n  TradingScaleMode,\n  TradingUndoState,\n  TradingVisibleRange,\n} from \"../engine/trading/types\";\nimport type { ChartRendererKind } from \"../engine/types\";\n\n/** Imperative handle of `<TradingChart>` */\nexport interface TradingChartHandle {\n  /**\n   * Streams a bar: the time of the last bar replaces it, a later time\n   * appends it (cheap: call it on every tick)\n   */\n  update(bar: TradingBar): void;\n  /** Appends bars newer than the last one */\n  appendBars(bars: TradingBarsInput): void;\n  /** Inserts older bars before the first one, keeping the view */\n  prependBars(bars: TradingBarsInput): void;\n  /** Replaces the bars */\n  setBars(bars: TradingBarsInput): void;\n  /** Number of bars */\n  getBarCount(): number;\n  /** Bar at an index, `null` outside the data */\n  getBar(index: number): TradingBar | null;\n  /** Scrolls to the latest bar */\n  scrollToRealtime(animate?: boolean): void;\n  /** Shows every bar */\n  fitContent(): void;\n  /** Visible bars, `null` before mounting */\n  getVisibleRange(): TradingVisibleRange | null;\n  /** Shows the bars between two logical indices */\n  setVisibleRange(range: { from: number; to: number }): void;\n  /** Times at the edges of the plot, `null` before mounting */\n  getVisibleTimeRange(): { from: number; to: number } | null;\n  /** Shows the bars between two times */\n  setVisibleTimeRange(range: { from: number; to: number }): void;\n  /** Shows the crosshair at a time (and a price); `null` hides it */\n  setCrosshair(time: number | null, price?: number): void;\n  /** Sets the price scale of the price pane */\n  setScaleMode(mode: TradingScaleMode): void;\n  /** Fits every price scale to the visible bars again */\n  resetPriceScales(): void;\n  /** Activates a drawing tool */\n  setDrawingTool(tool: TradingDrawingTool): void;\n  /** Current drawings */\n  getDrawings(): readonly TradingDrawing[];\n  /** Deletes a drawing */\n  removeDrawing(id: string): void;\n  /** Changes the style or the content of a drawing (undoable) */\n  updateDrawing(id: string, patch: TradingDrawingPatch): void;\n  /** Selects a drawing (`null` clears the selection) */\n  selectDrawing(id: string | null): void;\n  /** Undoes the last change of the drawings */\n  undo(): void;\n  /** Redoes the last undone change of the drawings */\n  redo(): void;\n  /** Whether the drawings can be undone or redone */\n  getUndoState(): TradingUndoState;\n  /** Starts a bar replay after `time` (the user picks the bar without it) */\n  startReplay(time?: number): void;\n  /** Shows the next bars of the replay */\n  replayStep(count?: number): void;\n  /** Plays the replay at `speed` bars per second */\n  replayPlay(speed?: number): void;\n  /** Pauses the replay */\n  replayPause(): void;\n  /** Ends the replay and shows every bar */\n  stopReplay(): void;\n  /** State of the bar replay, `null` before mounting */\n  getReplayState(): TradingReplayState | null;\n  /** Image of the chart as a data URL (`\"\"` before mounting) */\n  toDataURL(type?: string, quality?: number): string;\n  /** Image of the chart as a blob */\n  toBlob(type?: string, quality?: number): Promise<Blob | null>;\n  /** Shows the chart full screen */\n  requestFullscreen(): Promise<void>;\n  /** Leaves full screen */\n  exitFullscreen(): Promise<void>;\n  /** Shows or hides an indicator */\n  setIndicatorVisible(id: string, visible: boolean): void;\n  /** Backend in use, `null` until ready */\n  getRenderer(): ChartRendererKind | null;\n  /** The underlying engine instance (minerva-design/charts/core) */\n  getInstance(): TradingChartInstance | null;\n}\n\n/** Props of `<TradingChart>`: the options of `createTradingChart`, the size and the events */\nexport interface TradingChartProps extends TradingChartOptions {\n  /**\n   * Height (pixels or any CSS length)\n   * @default 480\n   */\n  height?: number | string;\n  /**\n   * Width (pixels or any CSS length)\n   * @default \"100%\"\n   */\n  width?: number | string;\n  /** Class of the root element */\n  className?: string;\n  /** Inline styles of the root element */\n  style?: CSSProperties;\n  /** Imperative handle (streaming, scrolling, drawings) */\n  ref?: Ref<TradingChartHandle>;\n  /** The crosshair moved (`null` when it left the chart) */\n  onCrosshairMove?: (event: TradingCrosshairEvent | null) => void;\n  /** A pane was clicked */\n  onClick?: (event: TradingClickEvent) => void;\n  /** The visible bars changed */\n  onVisibleRangeChange?: (range: TradingVisibleRange) => void;\n  /** A draggable price line was dropped at a new price, or moved with the keyboard */\n  onOrderMove?: (event: TradingOrderMoveEvent) => void;\n  /** The \"+\" order entry button was clicked, or an order confirmed with the keyboard (see `orderEntry`) */\n  onOrderCreate?: (event: TradingOrderCreateEvent) => void;\n  /** The close button of a `cancellable` price line was clicked, or Delete pressed on it */\n  onOrderCancel?: (event: TradingOrderCancelEvent) => void;\n  /** The user added, moved or deleted drawings (pass them back as `drawings`) */\n  onDrawingsChange?: (drawings: readonly TradingDrawing[]) => void;\n  /** The selected drawing changed */\n  onDrawingSelect?: (id: string | null) => void;\n  /** The drawing tool changed (back to `cursor` after a drawing) */\n  onDrawingToolChange?: (tool: TradingDrawingTool) => void;\n  /** Undo / redo of the drawings became possible or impossible */\n  onUndoChange?: (state: TradingUndoState) => void;\n  /** The bar replay started, stepped, played, paused or stopped */\n  onReplayChange?: (state: TradingReplayState) => void;\n  /** The chart entered (`true`) or left full screen */\n  onFullscreenChange?: (fullscreen: boolean) => void;\n  /** An indicator was shown or hidden from its legend */\n  onIndicatorToggle?: (event: TradingIndicatorToggleEvent) => void;\n  /** The oldest bar came into view: load older bars (`prependBars`) */\n  onHistoryRequest?: (event: TradingHistoryRequestEvent) => void;\n  /** The backend in use (again after a fallback) */\n  onRendererChange?: (renderer: ChartRendererKind) => void;\n}\n\ntype Handlers = Pick<\n  TradingChartProps,\n  | \"onCrosshairMove\"\n  | \"onClick\"\n  | \"onVisibleRangeChange\"\n  | \"onOrderMove\"\n  | \"onOrderCreate\"\n  | \"onOrderCancel\"\n  | \"onDrawingsChange\"\n  | \"onDrawingSelect\"\n  | \"onDrawingToolChange\"\n  | \"onUndoChange\"\n  | \"onReplayChange\"\n  | \"onFullscreenChange\"\n  | \"onIndicatorToggle\"\n  | \"onHistoryRequest\"\n  | \"onRendererChange\"\n>;\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> => {\n  if (typeof value !== \"object\" || value === null) return false;\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n};\n\nconst shallowEqual = (\n  a: Record<string, unknown>,\n  b: Record<string, unknown>,\n): boolean => {\n  const keys = Object.keys(a);\n  if (keys.length !== Object.keys(b).length) return false;\n  return keys.every(\n    (key) =>\n      Object.prototype.hasOwnProperty.call(b, key) && sameItem(a[key], b[key]),\n  );\n};\n\n/** Identical, or inline arrays of identical values */\nconst sameItem = (a: unknown, b: unknown): boolean =>\n  a === b ||\n  (Array.isArray(a) &&\n    Array.isArray(b) &&\n    a.length === b.length &&\n    a.every((v, i) => v === b[i]));\n\n/**\n * Same option value: identical, or inline arrays / objects of plain objects\n * with identical fields (`indicators={[{ type: \"ma\", period: 7 }]}`). Bars,\n * markers and drawings are compared by identity when they are not plain\n * objects (typed arrays) and item by item otherwise.\n */\nconst sameValue = (a: unknown, b: unknown): boolean => {\n  if (a === b) return true;\n  if (Array.isArray(a) && Array.isArray(b)) {\n    return (\n      a.length === b.length &&\n      a.every(\n        (v, i) =>\n          v === b[i] ||\n          (isPlainObject(v) && isPlainObject(b[i]) && shallowEqual(v, b[i])),\n      )\n    );\n  }\n  return isPlainObject(a) && isPlainObject(b) && shallowEqual(a, b);\n};\n\n/** Options describing the same chart (bars and drawings compared by identity) */\nconst sameOptions = (a: TradingChartOptions, b: TradingChartOptions) => {\n  const keys = Object.keys(a) as (keyof TradingChartOptions)[];\n  if (keys.length !== Object.keys(b).length) return false;\n  return keys.every((key) => {\n    if (!Object.prototype.hasOwnProperty.call(b, key)) return false;\n    // new bars / drawings arrays are always applied: compared by identity\n    if (key === \"bars\" || key === \"drawings\") return a[key] === b[key];\n    return sameValue(a[key], b[key]);\n  });\n};\n\nconst size = (value: number | string | undefined, fallback: string) =>\n  value === undefined\n    ? fallback\n    : typeof value === \"number\"\n      ? `${value}px`\n      : value;\n\n/**\n * Professional trading chart: candles (hollow, Heikin-Ashi, bars, line,\n * area, baseline) over a gap-free time axis, indicator panes, drawing\n * tools, order lines and real-time streaming, drawn on the GPU.\n */\nexport function TradingChart(props: TradingChartProps) {\n  const {\n    height,\n    width,\n    className,\n    style,\n    ref,\n    onCrosshairMove,\n    onClick,\n    onVisibleRangeChange,\n    onOrderMove,\n    onOrderCreate,\n    onOrderCancel,\n    onDrawingsChange,\n    onDrawingSelect,\n    onDrawingToolChange,\n    onUndoChange,\n    onReplayChange,\n    onFullscreenChange,\n    onIndicatorToggle,\n    onHistoryRequest,\n    onRendererChange,\n    ...options\n  } = props;\n  const handlers: Handlers = {\n    onCrosshairMove,\n    onClick,\n    onVisibleRangeChange,\n    onOrderMove,\n    onOrderCreate,\n    onOrderCancel,\n    onDrawingsChange,\n    onDrawingSelect,\n    onDrawingToolChange,\n    onUndoChange,\n    onReplayChange,\n    onFullscreenChange,\n    onIndicatorToggle,\n    onHistoryRequest,\n    onRendererChange,\n  };\n  const containerRef = useRef<HTMLDivElement>(null);\n  const chartRef = useRef<TradingChartInstance | null>(null);\n  const handlersRef = useRef<Handlers>(handlers);\n\n  // a new options object on every render: keep the previous one while it\n  // describes the same chart (state derived during render)\n  const [stable, setStable] = useState<TradingChartOptions>(options);\n  if (stable !== options && !sameOptions(stable, options)) setStable(options);\n  const optionsRef = useRef(stable);\n\n  useEffect(() => {\n    handlersRef.current = handlers;\n  });\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n    const chart = createTradingChart(container, optionsRef.current);\n    chartRef.current = chart;\n    const h = () => handlersRef.current;\n    const offs = [\n      chart.on(\"crosshairMove\", (e) => h().onCrosshairMove?.(e)),\n      chart.on(\"click\", (e) => h().onClick?.(e)),\n      chart.on(\"visibleRangeChange\", (e) => h().onVisibleRangeChange?.(e)),\n      chart.on(\"orderMove\", (e) => h().onOrderMove?.(e)),\n      chart.on(\"orderCreate\", (e) => h().onOrderCreate?.(e)),\n      chart.on(\"orderCancel\", (e) => h().onOrderCancel?.(e)),\n      chart.on(\"drawingsChange\", (e) => h().onDrawingsChange?.(e)),\n      chart.on(\"drawingSelect\", (e) => h().onDrawingSelect?.(e)),\n      chart.on(\"drawingToolChange\", (e) => h().onDrawingToolChange?.(e)),\n      chart.on(\"undoChange\", (e) => h().onUndoChange?.(e)),\n      chart.on(\"replayChange\", (e) => h().onReplayChange?.(e)),\n      chart.on(\"fullscreenChange\", (e) => h().onFullscreenChange?.(e)),\n      chart.on(\"indicatorToggle\", (e) => h().onIndicatorToggle?.(e)),\n      chart.on(\"historyRequest\", (e) => h().onHistoryRequest?.(e)),\n      chart.on(\"renderer\", (e) => h().onRendererChange?.(e)),\n    ];\n    return () => {\n      offs.forEach((off) => off());\n      chart.destroy();\n      chartRef.current = null;\n    };\n  }, []);\n\n  useEffect(() => {\n    if (optionsRef.current === stable) return;\n    optionsRef.current = stable;\n    chartRef.current?.setOptions(stable);\n  }, [stable]);\n\n  useImperativeHandle(\n    ref,\n    (): TradingChartHandle => ({\n      update: (bar) => chartRef.current?.update(bar),\n      appendBars: (bars) => chartRef.current?.appendBars(bars),\n      prependBars: (bars) => chartRef.current?.prependBars(bars),\n      setBars: (bars) => chartRef.current?.setBars(bars),\n      getBarCount: () => chartRef.current?.getBarCount() ?? 0,\n      getBar: (index) => chartRef.current?.getBar(index) ?? null,\n      scrollToRealtime: (animate) =>\n        chartRef.current?.scrollToRealtime(animate),\n      fitContent: () => chartRef.current?.fitContent(),\n      getVisibleRange: () => chartRef.current?.getVisibleRange() ?? null,\n      setVisibleRange: (range) => chartRef.current?.setVisibleRange(range),\n      getVisibleTimeRange: () =>\n        chartRef.current?.getVisibleTimeRange() ?? null,\n      setVisibleTimeRange: (range) =>\n        chartRef.current?.setVisibleTimeRange(range),\n      setCrosshair: (time, price) =>\n        chartRef.current?.setCrosshair(time, price),\n      setScaleMode: (mode) => chartRef.current?.setScaleMode(mode),\n      resetPriceScales: () => chartRef.current?.resetPriceScales(),\n      setDrawingTool: (tool) => chartRef.current?.setDrawingTool(tool),\n      getDrawings: () => chartRef.current?.getDrawings() ?? [],\n      removeDrawing: (id) => chartRef.current?.removeDrawing(id),\n      updateDrawing: (id, patch) => chartRef.current?.updateDrawing(id, patch),\n      selectDrawing: (id) => chartRef.current?.selectDrawing(id),\n      undo: () => chartRef.current?.undo(),\n      redo: () => chartRef.current?.redo(),\n      getUndoState: () =>\n        chartRef.current?.getUndoState() ?? { canUndo: false, canRedo: false },\n      startReplay: (time) => chartRef.current?.startReplay(time),\n      replayStep: (count) => chartRef.current?.replayStep(count),\n      replayPlay: (speed) => chartRef.current?.replayPlay(speed),\n      replayPause: () => chartRef.current?.replayPause(),\n      stopReplay: () => chartRef.current?.stopReplay(),\n      getReplayState: () => chartRef.current?.getReplayState() ?? null,\n      toDataURL: (type, quality) =>\n        chartRef.current?.toDataURL(type, quality) ?? \"\",\n      toBlob: (type, quality) =>\n        chartRef.current?.toBlob(type, quality) ?? Promise.resolve(null),\n      requestFullscreen: () =>\n        chartRef.current?.requestFullscreen() ?? Promise.resolve(),\n      exitFullscreen: () =>\n        chartRef.current?.exitFullscreen() ?? Promise.resolve(),\n      setIndicatorVisible: (id, visible) =>\n        chartRef.current?.setIndicatorVisible(id, visible),\n      getRenderer: () => chartRef.current?.getRenderer() ?? null,\n      getInstance: () => chartRef.current,\n    }),\n    [],\n  );\n\n  return (\n    <div\n      className={className}\n      style={{\n        position: \"relative\",\n        width: size(width, \"100%\"),\n        height: size(height, \"480px\"),\n        ...style,\n      }}\n    >\n      <div ref={containerRef} style={{ position: \"absolute\", inset: 0 }} />\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/charts/react/types.d.cts

@@ -245,6 +245,17 @@ export interface BoxPlotChartProps extends ChartCommonProps, BoxplotStatsOptions
      * @default "vertical"
      */
     orientation?: ChartOrientation;
+    /**
+     * Outliers drawn as rings of the series color or as filled dots (series
+     * may set their own `outlierShape`)
+     * @default "hollow"
+     */
+    outlierShape?: "hollow" | "filled";
+    /**
+     * Diameter of the outliers in CSS pixels
+     * @default 7
+     */
+    outlierSize?: number;
 }
 /** Props of WaterfallChart */
 export interface WaterfallChartProps extends Omit<ChartCommonProps, "crosshair" | "labels">, Omit<WaterfallOptions, "labels"> {

package/dist/charts/react/types.d.ts

@@ -245,6 +245,17 @@ export interface BoxPlotChartProps extends ChartCommonProps, BoxplotStatsOptions
      * @default "vertical"
      */
     orientation?: ChartOrientation;
+    /**
+     * Outliers drawn as rings of the series color or as filled dots (series
+     * may set their own `outlierShape`)
+     * @default "hollow"
+     */
+    outlierShape?: "hollow" | "filled";
+    /**
+     * Diameter of the outliers in CSS pixels
+     * @default 7
+     */
+    outlierSize?: number;
 }
 /** Props of WaterfallChart */
 export interface WaterfallChartProps extends Omit<ChartCommonProps, "crosshair" | "labels">, Omit<WaterfallOptions, "labels"> {