@forgecharts/sdk 1.1.23 → 1.1.28

package/src/index.ts

@@ -1,190 +0,0 @@
-// ─── Primary entry point ─────────────────────────────────────────────────────
-export { createChart } from './api/createChart';
-export { TChart } from './api/TChart';
-
-// ─── Reference Data API ───────────────────────────────────────────────────────
-export { ReferenceAPI } from './api/ReferenceAPI';
-export type { ReferenceAPIConfig } from './api/ReferenceAPI';
-
-// ─── Datafeed ─────────────────────────────────────────────────────────────────
-export { DatafeedConnector } from './datafeed/DatafeedConnector';
-export type { ConnectorCallbacks } from './datafeed/DatafeedConnector';
-// ─── Indicator engine ─────────────────────────────────────────────────────
-export {
-  computeSMA,
-  computeEMA,
-  computeRSI,
-  computeMACD,
-  computeVolume,
-  // Series-based variants for DAG chaining
-  extractField,
-  computeSMAFromSeries,
-  computeEMAFromSeries,
-  computeWMAFromSeries,
-} from './core/IndicatorEngine';
-export type { IndicatorPoint, MACDPoint } from './core/IndicatorEngine';
-
-// ─── Indicator DAG ────────────────────────────────────────────────────────────
-export { IndicatorDAG } from './api/IndicatorDAG';
-export type { DAGResult } from './api/IndicatorDAG';
-
-// ─── TScript scripting engine ─────────────────────────────────────────────────
-export { TScriptIndicator } from './tscript/TScriptIndicator';
-export { Series as TScriptSeries } from './tscript/series';
-export { TScriptRuntime } from './tscript/runtime';
-export type { TValue, ScriptResult } from './tscript/runtime';
-
-// ─── Pine Script compatibility layer ─────────────────────────────────────────
-export { PineCompiler, DiagnosticBag } from './pine';
-export type { PineCompileResult, Diagnostic, DiagnosticSeverity } from './pine';
-
-// ─── Pane manager ─────────────────────────────────────────────────────────
-export { PaneManager } from './api/PaneManager';
-// ─── Coordinate transform system ─────────────────────────────────────────────
-export { CoordTransform } from './core/CoordTransform';
-export type { PlotArea } from './core/CoordTransform';
-
-// ─── Candle engine ────────────────────────────────────────────────────────────
-export { CandleEngine } from './engine/CandleEngine';
-export type { CandleBar, RawOHLCV, UpdateResult, GapInfo, CandleEngineOptions } from './engine/CandleEngine';
-export { timeframeToMs, getBucketStart } from './engine/timeframeUtils';
-export { getMissingBarCount, mergeBars } from './engine/mergeUtils';
-
-// ─── Trading types & overlay store ───────────────────────────────────────────
-export type {
-  CandleInput,
-  ChartOrder,
-  ChartPosition,
-  ExecutionFill,
-  OrderRole,
-  OrderSide,
-  OrderStatus,
-  PositionSide,
-  PositionStatus,
-  FillSide,
-} from './trading/tradingTypes';
-export { TradingOverlayStore } from './trading/TradingOverlayStore';
-export { UnmanagedIngestion } from './trading/UnmanagedIngestion';
-
-// ─── Managed trading ──────────────────────────────────────────────────────────
-export { ManagedTradingController } from './trading/managed/ManagedTradingController';
-export type {
-  IExecutionProvider,
-  PlaceOrderInput,
-  ModifyOrderInput,
-  PlaceBracketOrderInput,
-  OrderAck,
-  BracketOrderAck,
-  ManagedOrderType,
-  TimeInForce,
-} from './trading/managed/managedTypes';
-export {
-  assertManagedMode,
-  assertCanPlaceOrders,
-  assertCanUseBrackets,
-  assertCanUseDraggableOrders,
-  assertCanUseManagedTrading,
-  isManagedCapable,
-  canPlaceOrders,
-  canPlaceBrackets,
-  canUseDraggable,
-  canUseManagedTradingHook,
-} from './trading/managed/managedCapabilities';
-
-// ─── Licensing ────────────────────────────────────────────────────────────────
-export { LicenseManager } from './licensing/LicenseManager';
-export type { LicenseMode, LicenseFeatures, LicensePayload } from './licensing/licenseTypes';
-
-// ─── Chart runtime resolver ───────────────────────────────────────────────────
-export { ChartRuntimeResolver } from './licensing/ChartRuntimeResolver';
-export type { ChartCapabilities } from './licensing/ChartRuntimeResolver';
-export {
-  // Mode checks
-  isManagedMode,
-  isUnmanagedMode,
-  // Feature-level capability checks
-  canUseExternalIngestion,
-  canRenderOverlays,
-  canUseIndicators,
-  canUseOrderEntry,
-  canUseManagedTrading,
-  canUseDraggableOrders,
-  canUseBracketOrders,
-  getCapabilities,
-  // UI render capability checks
-  canRenderOrderEntry,
-  canRenderBuySellButtons,
-  canRenderOrderTicket,
-  canRenderBracketControls,
-  canRenderOrderModificationControls,
-  canRenderManagedTradingControls,
-  canRenderExternalOverlayOnlyMode,
-  canRenderPositions,
-  canRenderFills,
-  canRenderCandles,
-  canRenderIndicators,
-  canRenderDrawings,
-} from './licensing/ChartRuntimeResolver';
-
-// ─── Shared / public types ────────────────────────────────────────────────────
-export type {
-  // Primitives
-  OHLCV,
-  Bar,
-  Timeframe,
-  ChartOptions,
-  SeriesOptions,
-  SeriesType,
-  ChartTheme,
-  Viewport,
-  TimeRange,
-  PriceRange,
-  Point,
-  Rect,
-  Drawing,
-  DrawingType,
-  DrawingToolType,
-  PointerToolType,
-  DrawingPoint,
-  // Datafeed
-  IDatafeed,
-  MarketType,
-  SymbolInfo,
-  HistoricalBarsResult,
-  // Interaction
-  HitTestResult,
-  ChartKeyAction,
-  KeyModifiers,
-  // Public SDK API types
-  ChartInterval,
-  ChartConfig,
-  ChartLayout,
-  ChartEventMap,
-  IndicatorType,
-  IndicatorParams,
-  IndicatorConfig,
-  IndicatorInstance,
-  PriceField,
-  PaneDescriptor,
-  IPlugin,
-  IPublicChart,
-  // Reference Data Platform
-  RefMarket,
-  RefExchange,
-  RefSymbol,
-  SymbolSearchFilters,
-  SymbolSearchResult,
-} from '@forgecharts/types';
-
-// ─── Pointer tool descriptors & visual constants ──────────────────────────────
-export { cursorTool, CURSOR_LABEL, CURSOR_STYLE }
-  from './api/drawing tools/pointers menu/cursor';
-export { crosshairTool, CROSSHAIR_LABEL, CROSSHAIR_STYLE }
-  from './api/drawing tools/pointers menu/crosshair';
-export { dotTool, DOT_LABEL, DOT_STYLE, DOT_RADIUS, DOT_COLOR }
-  from './api/drawing tools/pointers menu/dot';
-export {
-  demonstrationTool,
-  DEMONSTRATION_LABEL, DEMONSTRATION_STYLE,
-  DEMONSTRATION_RADIUS, DEMONSTRATION_FILL, DEMONSTRATION_STROKE, DEMONSTRATION_COLOR,
-} from './api/drawing tools/pointers menu/demonstration';

package/src/licensing/ChartRuntimeResolver.ts

@@ -1,380 +0,0 @@
-/**
- * ChartRuntimeResolver
- *
- * Single source of truth for runtime capability queries.
- * Mode is always derived from the installed LicenseManager state — it is
- * never passed in by chart config, ensuring clients cannot bypass the
- * license-driven mode selection.
- *
- * Usage:
- *   import { ChartRuntimeResolver } from '@forgecharts/sdk';
- *   const resolver = ChartRuntimeResolver.getInstance();
- *
- *   resolver.isManagedMode()           // true when a managed license is active
- *   resolver.isUnmanagedMode()         // true when no license or unmanaged license
- *   resolver.canUseOrderEntry()        // built-in order entry UI
- *   resolver.canUseExternalIngestion() // external data ingestion APIs
- *   resolver.canRenderOverlays()       // overlay rendering
- *   resolver.canUseIndicators()        // indicator panel
- *   resolver.canUseManagedTrading()    // managed broker / execution hooks
- *   resolver.canUseDraggableOrders()   // drag-to-price order placement
- *   resolver.canUseBracketOrders()     // bracket / OCO order support
- *
- * Capability matrix
- * ─────────────────────────────────────────────────────
- * Capability               unmanaged   managed
- * ─────────────────────────────────────────────────────
- * externalIngestion          ✓           ✗  (managed feed owns data)
- * overlays                   ✓           ✓  (both modes render overlays)
- * indicators                 ✓           ✓
- * orderEntry                 ✗           ✓  (requires managed license)
- * managedTrading             ✗           ✓
- * draggableOrders            ✗           ✓
- * bracketOrders              ✗           ✓
- * ─────────────────────────────────────────────────────
- *
- * Feature flags in the LicensePayload can further restrict capabilities
- * within a mode. A managed license with `orderEntry: false` will still
- * return false from canUseOrderEntry().
- */
-
-import { LicenseManager } from './LicenseManager';
-import type { LicenseFeatures } from './licenseTypes';
-
-export class ChartRuntimeResolver {
-  private static instance: ChartRuntimeResolver | null = null;
-
-  /** Always read from the singleton LicenseManager — never store a copy. */
-  private get lm(): LicenseManager {
-    return LicenseManager.getInstance();
-  }
-
-  private constructor() {}
-
-  static getInstance(): ChartRuntimeResolver {
-    if (!ChartRuntimeResolver.instance) {
-      ChartRuntimeResolver.instance = new ChartRuntimeResolver();
-    }
-    return ChartRuntimeResolver.instance;
-  }
-
-  // ── Mode checks ─────────────────────────────────────────────────────────────
-
-  /** True when the active license is in managed mode. */
-  isManagedMode(): boolean {
-    return this.lm.getMode() === 'managed';
-  }
-
-  /** True when no license is installed or the license is in unmanaged mode. */
-  isUnmanagedMode(): boolean {
-    return this.lm.getMode() === 'unmanaged';
-  }
-
-  // ── Capability queries ───────────────────────────────────────────────────────
-
-  /**
-   * External data ingestion APIs (e.g. pushing tick data from an external broker).
-   * Available in unmanaged mode only — in managed mode the built-in feed owns data.
-   * Override via `unmanagedIngestion` feature flag on a managed license if needed.
-   */
-  canUseExternalIngestion(): boolean {
-    if (this.isUnmanagedMode()) return true;
-    // A managed license can explicitly opt-in to external ingestion
-    return this.#featureOrDefault('unmanagedIngestion', false);
-  }
-
-  /**
-   * Overlay rendering from external state (price levels, zones, signals).
-   * Enabled in both modes by default; can be restricted via feature flag.
-   */
-  canRenderOverlays(): boolean {
-    return this.#featureOrDefault('overlays', true);
-  }
-
-  /**
-   * Indicator panel / computations.
-   * Enabled in both modes by default; can be restricted via feature flag.
-   */
-  canUseIndicators(): boolean {
-    return this.#featureOrDefault('indicators', true);
-  }
-
-  /**
-   * Built-in order entry UI hooks.
-   * Requires managed mode AND the `orderEntry` feature flag (or no flag restriction).
-   */
-  canUseOrderEntry(): boolean {
-    if (this.isUnmanagedMode()) return false;
-    return this.#featureOrDefault('orderEntry', true);
-  }
-
-  /**
-   * Managed trading service hooks (broker execution, position management).
-   * Requires managed mode AND the `managedTrading` feature flag (or no flag restriction).
-   */
-  canUseManagedTrading(): boolean {
-    if (this.isUnmanagedMode()) return false;
-    return this.#featureOrDefault('managedTrading', true);
-  }
-
-  /**
-   * Drag-to-price order placement.
-   * Requires managed mode AND the `draggableOrders` feature flag (or no flag restriction).
-   */
-  canUseDraggableOrders(): boolean {
-    if (this.isUnmanagedMode()) return false;
-    return this.#featureOrDefault('draggableOrders', true);
-  }
-
-  /**
-   * Bracket / OCO order support.
-   * Requires managed mode AND the `bracketOrders` feature flag (or no flag restriction).
-   */
-  canUseBracketOrders(): boolean {
-    if (this.isUnmanagedMode()) return false;
-    return this.#featureOrDefault('bracketOrders', true);
-  }
-
-  // ── UI render capability checks ──────────────────────────────────────────────
-  // These are component-level gates. They derive from the feature-level checks
-  // above and are the checks that toolbar / panel components should consume.
-
-  /**
-   * Whether to render the order entry tool in the toolbar.
-   * Hidden in unmanaged mode — requires managed license with order entry.
-   */
-  canRenderOrderEntry(): boolean {
-    return this.canUseOrderEntry();
-  }
-
-  /**
-   * Whether to render Buy / Sell action buttons on the chart or toolbar.
-   * Hidden in unmanaged mode — order placement requires managed license.
-   */
-  canRenderBuySellButtons(): boolean {
-    return this.canUseOrderEntry();
-  }
-
-  /**
-   * Whether to render the order ticket panel (entry form / DOM entry).
-   * Requires managed mode with order entry enabled.
-   */
-  canRenderOrderTicket(): boolean {
-    return this.canUseOrderEntry();
-  }
-
-  /**
-   * Whether to render bracket order controls (TP, SL, OCO).
-   * Requires managed mode with order entry AND the bracketOrders feature flag.
-   * If order entry itself is disabled, bracket controls are also hidden.
-   */
-  canRenderBracketControls(): boolean {
-    if (!this.canUseOrderEntry()) return false;
-    return this.canUseBracketOrders();
-  }
-
-  /**
-   * Whether to render order modification controls (drag-to-modify, edit panel).
-   * Requires managed mode with order entry AND the draggableOrders feature flag.
-   * If order entry itself is disabled, modification controls are also hidden.
-   */
-  canRenderOrderModificationControls(): boolean {
-    if (!this.canUseOrderEntry()) return false;
-    return this.canUseDraggableOrders();
-  }
-
-  /**
-   * Whether to render the managed trading control panel as a whole.
-   * Guards the container that holds buy/sell, order ticket, bracket controls, etc.
-   */
-  canRenderManagedTradingControls(): boolean {
-    return this.canUseManagedTrading();
-  }
-
-  /**
-   * True when the chart is in external-overlay-only (unmanaged) mode.
-   * Drives rendering of the external data overlay panel while suppressing
-   * all order entry UI elements.
-   */
-  canRenderExternalOverlayOnlyMode(): boolean {
-    return this.isUnmanagedMode();
-  }
-
-  /**
-   * Positions are always rendered regardless of license mode.
-   * Data flows from TradingOverlayStore (host-pushed in unmanaged,
-   * ManagedTradingController-driven in managed).
-   */
-  canRenderPositions(): boolean {
-    return true;
-  }
-
-  /**
-   * Execution fills are always rendered regardless of license mode.
-   */
-  canRenderFills(): boolean {
-    return true;
-  }
-
-  /**
-   * Candles are always rendered — unaffected by license mode.
-   * The RapidAPI datafeed remains active in all modes.
-   */
-  canRenderCandles(): boolean {
-    return true;
-  }
-
-  /**
-   * Indicator panel follows the `indicators` feature flag.
-   * Enabled in both modes by default.
-   */
-  canRenderIndicators(): boolean {
-    return this.canUseIndicators();
-  }
-
-  /**
-   * Drawing tools are always available regardless of license mode.
-   */
-  canRenderDrawings(): boolean {
-    return true;
-  }
-
-  // ── Convenience snapshot ────────────────────────────────────────────────────
-
-  /**
-   * Returns the full capability set as a plain object — useful for logging,
-   * debug panels, or passing state to React context in one call.
-   */
-  getCapabilities(): ChartCapabilities {
-    return {
-      // ── Mode & feature-level flags ──────────────────────────────────────
-      mode:                this.lm.getMode(),
-      externalIngestion:   this.canUseExternalIngestion(),
-      overlays:            this.canRenderOverlays(),
-      indicators:          this.canUseIndicators(),
-      orderEntry:          this.canUseOrderEntry(),
-      managedTrading:      this.canUseManagedTrading(),
-      draggableOrders:     this.canUseDraggableOrders(),
-      bracketOrders:       this.canUseBracketOrders(),
-      // ── UI render flags ─────────────────────────────────────────────────
-      renderOrderEntry:                this.canRenderOrderEntry(),
-      renderBuySellButtons:            this.canRenderBuySellButtons(),
-      renderOrderTicket:               this.canRenderOrderTicket(),
-      renderBracketControls:           this.canRenderBracketControls(),
-      renderOrderModificationControls: this.canRenderOrderModificationControls(),
-      renderManagedTradingControls:    this.canRenderManagedTradingControls(),
-      renderExternalOverlayOnly:       this.canRenderExternalOverlayOnlyMode(),
-      renderPositions:                 this.canRenderPositions(),
-      renderFills:                     this.canRenderFills(),
-      renderCandles:                   this.canRenderCandles(),
-      renderIndicators:                this.canRenderIndicators(),
-      renderDrawings:                  this.canRenderDrawings(),
-    };
-  }
-
-  // ── Private helpers ─────────────────────────────────────────────────────────
-
-  /**
-   * If the active license has an explicit feature flag, use it.
-   * Otherwise fall back to `defaultValue` (allows capability even without an
-   * explicit flag, matching the "omitted = allowed" convention).
-   */
-  #featureOrDefault(name: keyof LicenseFeatures, defaultValue: boolean): boolean {
-    const features = this.lm.getFeatures();
-    const flag = features[name];
-    return flag === undefined ? defaultValue : flag === true;
-  }
-}
-
-// ── Capability snapshot type ─────────────────────────────────────────────────
-
-export interface ChartCapabilities {
-  // ── Mode & feature-level flags ────────────────────────────────────────────
-  mode:              'managed' | 'unmanaged';
-  externalIngestion: boolean;
-  overlays:          boolean;
-  indicators:        boolean;
-  orderEntry:        boolean;
-  managedTrading:    boolean;
-  draggableOrders:   boolean;
-  bracketOrders:     boolean;
-  // ── UI render flags ───────────────────────────────────────────────────────
-  /** Show the order entry tool in toolbars (managed only). */
-  renderOrderEntry:                boolean;
-  /** Show Buy / Sell action buttons (managed only). */
-  renderBuySellButtons:            boolean;
-  /** Show the order ticket / entry form (managed only). */
-  renderOrderTicket:               boolean;
-  /** Show bracket order controls — TP, SL, OCO (managed + bracketOrders). */
-  renderBracketControls:           boolean;
-  /** Show order modification controls — drag handles, edit panel (managed + draggableOrders). */
-  renderOrderModificationControls: boolean;
-  /** Show the entire managed trading panel as a composite gate. */
-  renderManagedTradingControls:    boolean;
-  /** True when operating in external-overlay-only (unmanaged) mode. */
-  renderExternalOverlayOnly:       boolean;
-  /** Positions always rendered — data controlled by TradingOverlayStore. */
-  renderPositions:                 boolean;
-  /** Execution fills always rendered. */
-  renderFills:                     boolean;
-  /** Candles always rendered — RapidAPI datafeed unaffected by mode. */
-  renderCandles:                   boolean;
-  /** Indicators follow the `indicators` feature flag (both modes). */
-  renderIndicators:                boolean;
-  /** Drawing tools always available regardless of license mode. */
-  renderDrawings:                  boolean;
-}
-
-// ── Module-level convenience functions ───────────────────────────────────────
-// These mirror the instance methods and are the recommended import style for
-// non-class consumers.
-
-const resolver = () => ChartRuntimeResolver.getInstance();
-
-/** True when a managed license is active. */
-export const isManagedMode           = (): boolean => resolver().isManagedMode();
-/** True when no license or unmanaged license is active (safe default). */
-export const isUnmanagedMode         = (): boolean => resolver().isUnmanagedMode();
-/** External data ingestion APIs (unmanaged mode only by default). */
-export const canUseExternalIngestion = (): boolean => resolver().canUseExternalIngestion();
-/** Overlay rendering — enabled in both modes. */
-export const canRenderOverlays       = (): boolean => resolver().canRenderOverlays();
-/** Indicator computations — enabled in both modes. */
-export const canUseIndicators        = (): boolean => resolver().canUseIndicators();
-/** Built-in order entry UI — managed mode only. */
-export const canUseOrderEntry        = (): boolean => resolver().canUseOrderEntry();
-/** Managed trading service hooks — managed mode only. */
-export const canUseManagedTrading    = (): boolean => resolver().canUseManagedTrading();
-/** Drag-to-price order placement — managed mode only. */
-export const canUseDraggableOrders   = (): boolean => resolver().canUseDraggableOrders();
-/** Bracket / OCO order support — managed mode only. */
-export const canUseBracketOrders     = (): boolean => resolver().canUseBracketOrders();
-/** Full capability snapshot as a plain object. */
-export const getCapabilities         = (): ChartCapabilities => resolver().getCapabilities();
-
-// ── UI render convenience functions ──────────────────────────────────────────
-
-/** Whether to render the order entry tool in toolbars (managed only). */
-export const canRenderOrderEntry                = (): boolean => resolver().canRenderOrderEntry();
-/** Whether to render Buy/Sell buttons (managed only). */
-export const canRenderBuySellButtons            = (): boolean => resolver().canRenderBuySellButtons();
-/** Whether to render the order ticket panel (managed only). */
-export const canRenderOrderTicket               = (): boolean => resolver().canRenderOrderTicket();
-/** Whether to render bracket / OCO controls (managed + bracketOrders feature). */
-export const canRenderBracketControls           = (): boolean => resolver().canRenderBracketControls();
-/** Whether to render drag/edit order modification controls (managed + draggableOrders). */
-export const canRenderOrderModificationControls = (): boolean => resolver().canRenderOrderModificationControls();
-/** Whether to render the managed trading control panel (managed only). */
-export const canRenderManagedTradingControls    = (): boolean => resolver().canRenderManagedTradingControls();
-/** True when in external-overlay-only (unmanaged) mode — hides all order-entry UI. */
-export const canRenderExternalOverlayOnlyMode   = (): boolean => resolver().canRenderExternalOverlayOnlyMode();
-/** Positions always rendered regardless of mode. */
-export const canRenderPositions                 = (): boolean => resolver().canRenderPositions();
-/** Execution fills always rendered regardless of mode. */
-export const canRenderFills                     = (): boolean => resolver().canRenderFills();
-/** Candles always rendered — RapidAPI datafeed unaffected by mode. */
-export const canRenderCandles                   = (): boolean => resolver().canRenderCandles();
-/** Indicators follow the indicators feature flag (both modes by default). */
-export const canRenderIndicators                = (): boolean => resolver().canRenderIndicators();
-/** Drawing tools always available regardless of license mode. */
-export const canRenderDrawings                  = (): boolean => resolver().canRenderDrawings();