@forgecharts/sdk 1.1.27 → 1.1.29

package/dist/__tests__/backwardCompatibility.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Backward compatibility — unit tests
+ *
+ * Verifies that the introduction of licensing, unmanaged mode, and managed
+ * foundations does NOT break the existing SDK contract:
+ *
+ *   1. All expected exports exist and have the correct shape/type
+ *   2. CandleEngine works unchanged (no side-effects from new code)
+ *   3. Default mode is unmanaged (safe default — nothing breaks by default)
+ *   4. The RapidAPI datafeed path is unaffected (DatafeedConnector still exports)
+ *   5. New modules export correctly from the package root (index.ts)
+ */
+export {};
+//# sourceMappingURL=backwardCompatibility.test.d.ts.map

package/dist/__tests__/backwardCompatibility.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backwardCompatibility.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/backwardCompatibility.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/__tests__/candleInvariant.test.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Candle Invariant Tests
+ *
+ * Verifies that the invariant guards in `candleInvariants.ts` fire correctly,
+ * and that `CandleEngine.applyLiveUpdate` maintains all invariants during
+ * normal operation (no warnings) and surfaces violations during abnormal
+ * conditions (mocked guard paths).
+ *
+ * Test categories:
+ *   1. assertOhlcRelationships — each OHLC violation is detected independently
+ *   2. assertBucketAlignment — misaligned timestamps are caught
+ *   3. assertNotFinalized — mutating a closed bar triggers the guard
+ *   4. assertOpenImmutability — open-price overwrite is detected
+ *   5. assertNoDuplicateAppend — same-bucket spurious append is detected
+ *   6. assertFinalizedUnchanged — new-bucket finalisation is verified
+ *   7. CandleEngine integration — no spurious warnings during correct operation
+ *   8. barDivergenceCheck — compareSources and formatReport
+ */
+export {};
+//# sourceMappingURL=candleInvariant.test.d.ts.map

package/dist/__tests__/candleInvariant.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candleInvariant.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/candleInvariant.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/__tests__/public-api-surface.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SDK Public API Surface — type-level integration test.
+ *
+ * Verifies that @forgecharts/sdk exports the required public symbols.
+ * Compiled by `tsc --noEmit` (no runtime execution needed).
+ *
+ * The three primary integration points are:
+ *   1. createChart()   — vanilla JS/TS DOM-based embed
+ *   2. ChartCanvas     — React component embed
+ *   3. ChartWorkspace  — full-workspace React embed
+ */
+export {};
+//# sourceMappingURL=public-api-surface.d.ts.map

package/dist/__tests__/public-api-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api-surface.d.ts","sourceRoot":"","sources":["../../src/__tests__/public-api-surface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/__tests__/timeframeBoundary.test.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Timeframe Boundary Tests
+ *
+ * Verifies correctness of `getBucketStart` (from `@forgecharts/shared`) and the
+ * `CandleEngine` live-update / reconnect behaviour at every critical boundary.
+ *
+ * Test categories:
+ *   1. Fixed intervals — standard and previously-missing timeframes
+ *   2. Weekly alignment — Monday start (ISO 8601)
+ *   3. Monthly alignment — calendar first-of-month, incl. leap-year February
+ *   4. Live update semantics — open immutability, high/low expansion, close,
+ *      same-bucket vs new-bucket
+ *   5. Reconnect — gap backfill, historical bars override provisional,
+ *      forming candle survives reconnect
+ */
+export {};
+//# sourceMappingURL=timeframeBoundary.test.d.ts.map

package/dist/__tests__/timeframeBoundary.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeframeBoundary.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/timeframeBoundary.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/api/DrawingManager.d.ts

@@ -0,0 +1,20 @@
+import type { Drawing, OHLCV } from '@forgecharts/types';
+import type { CoordTransform } from '../core/CoordTransform';
+export declare class DrawingManager {
+    private readonly _map;
+    add(drawing: Omit<Drawing, 'id'>): string;
+    remove(id: string): boolean;
+    update(id: string, patches: Partial<Pick<Drawing, 'points' | 'color' | 'text' | 'visible' | 'lineWidth' | 'fillColor' | 'fillOpacity' | 'deviationMultiplier'>>): boolean;
+    get(id: string): Drawing | undefined;
+    has(id: string): boolean;
+    all(): readonly Drawing[];
+    clear(): void;
+    render(ctx: CanvasRenderingContext2D, transform: CoordTransform, selectedId?: string | null, interval?: string, candles?: readonly OHLCV[]): void;
+    renderPreview(ctx: CanvasRenderingContext2D, transform: CoordTransform, draft: Omit<Drawing, 'id'>, interval?: string, candles?: readonly OHLCV[]): void;
+    /** Returns anchor pixel positions — used by InteractionManager for handle hit-testing. */
+    static anchorPixels(d: Drawing, transform: CoordTransform): Array<{
+        x: number;
+        y: number;
+    }>;
+}
+//# sourceMappingURL=DrawingManager.d.ts.map

package/dist/api/DrawingManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DrawingManager.d.ts","sourceRoot":"","sources":["../../src/api/DrawingManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAuF7D,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;IAInD,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,MAAM;IAMzC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,GAAG,qBAAqB,CAAC,CAAC,GAC3I,OAAO;IAOV,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIpC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,GAAG,IAAI,SAAS,OAAO,EAAE;IAIzB,KAAK,IAAI,IAAI;IAMb,MAAM,CACJ,GAAG,EAAE,wBAAwB,EAC7B,SAAS,EAAE,cAAc,EACzB,UAAU,GAAE,MAAM,GAAG,IAAW,EAChC,QAAQ,SAAO,EACf,OAAO,GAAE,SAAS,KAAK,EAAO,GAC7B,IAAI;IAuBP,aAAa,CACX,GAAG,EAAE,wBAAwB,EAC7B,SAAS,EAAE,cAAc,EACzB,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAC1B,QAAQ,SAAO,EACf,OAAO,GAAE,SAAS,KAAK,EAAO,GAC7B,IAAI;IAWP,0FAA0F;IAC1F,MAAM,CAAC,YAAY,CACjB,CAAC,EAAE,OAAO,EACV,SAAS,EAAE,cAAc,GACxB,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAMnC"}

package/dist/api/EventBus.d.ts

@@ -0,0 +1,19 @@
+import type { ChartEventMap } from '@forgecharts/types';
+type Handler<T> = (payload: T) => void;
+/**
+ * EventBus — internal typed pub/sub used by TChart.
+ *
+ * All event keys are constrained to `keyof ChartEventMap`, giving
+ * full type inference on payload shapes at every call site.
+ */
+export declare class EventBus {
+    private readonly _listeners;
+    on<K extends keyof ChartEventMap>(event: K, handler: Handler<ChartEventMap[K]>): void;
+    off<K extends keyof ChartEventMap>(event: K, handler: Handler<ChartEventMap[K]>): void;
+    once<K extends keyof ChartEventMap>(event: K, handler: Handler<ChartEventMap[K]>): void;
+    emit<K extends keyof ChartEventMap>(event: K, payload: ChartEventMap[K]): void;
+    /** Removes all listeners — called on chart destruction. */
+    clear(): void;
+}
+export {};
+//# sourceMappingURL=EventBus.d.ts.map

package/dist/api/EventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../src/api/EventBus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;AAEvC;;;;;GAKG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAGvB;IAEJ,EAAE,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAOrF,GAAG,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAItF,IAAI,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAQvF,IAAI,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAa9E,2DAA2D;IAC3D,KAAK,IAAI,IAAI;CAGd"}

package/dist/api/IndicatorDAG.d.ts

@@ -0,0 +1,85 @@
+/**
+ * IndicatorDAG — Directed Acyclic Graph for indicator computation.
+ *
+ * Allows indicators to be chained: e.g. EMA can consume SMA's output instead
+ * of raw OHLCV prices. Circular dependencies are rejected at registration time.
+ * Results are cached and recomputed only when inputs actually change.
+ *
+ * Incremental fast-path: when a single bar is appended, SMA and EMA extend
+ * their result by exactly one point in O(1) time.
+ *
+ * @example
+ * ```ts
+ * const dag = new IndicatorDAG();
+ * dag.addNode('sma1', { type: 'sma', params: { period: 20 } });
+ * dag.addNode('ema1', { type: 'ema', params: { period: 10 }, sourceId: 'sma1' });
+ *
+ * dag.execute(bars);                        // SMA first, then EMA(SMA)
+ * const result = dag.getResult('ema1');     // { kind: 'series', points: [...] }
+ * ```
+ */
+import type { OHLCV, IndicatorConfig } from '@forgecharts/types';
+import type { IndicatorPoint, MACDPoint } from '../core/IndicatorEngine';
+/** Computed output of a single DAG node. */
+export type DAGResult = {
+    readonly kind: 'series';
+    readonly points: readonly IndicatorPoint[];
+} | {
+    readonly kind: 'macd';
+    readonly points: readonly MACDPoint[];
+};
+export declare class IndicatorDAG {
+    private readonly _nodes;
+    /**
+     * Registers a node for `id`.
+     * If the node already exists its config is updated if changed.
+     * Throws `'[IndicatorDAG] Circular dependency detected'` if adding `id`
+     * would form a cycle.
+     */
+    addNode(id: string, config: IndicatorConfig): void;
+    /** Removes `id` and marks any indicators that depended on it as dirty. */
+    removeNode(id: string): void;
+    /**
+     * Syncs the DAG to exactly the provided indicator list.
+     * Adds new nodes, removes obsolete ones, updates changed configs.
+     * Throws if the resulting graph contains a cycle.
+     */
+    sync(indicators: ReadonlyArray<{
+        readonly id: string;
+        readonly config: IndicatorConfig;
+    }>): void;
+    /**
+     * Runs all dirty nodes in topological order.
+     *
+     * When the OHLCV array grew by exactly one bar since a node's last run and
+     * its input series also grew by one, SMA and EMA use an O(1) incremental
+     * append path. All other types fall back to a full recompute.
+     *
+     * @returns `true` if any node was executed.
+     */
+    execute(bars: readonly OHLCV[]): boolean;
+    /** Forces every node to recompute on the next `execute()` call. */
+    invalidateAll(): void;
+    isDirty(): boolean;
+    getResult(id: string): DAGResult | null;
+    getAllResults(): ReadonlyMap<string, DAGResult>;
+    /**
+     * Returns node ids in topological execution order.
+     * Throws `'[IndicatorDAG] Circular dependency detected'` when a cycle exists.
+     */
+    private _topoSort;
+    private _needsRun;
+    /** Returns the ordered input series for `node` — either from a source indicator or raw price field. */
+    private _resolveSource;
+    /** Full recompute of a node's result. */
+    private _computeFull;
+    /**
+     * O(1) append of a single new point.
+     * Only called when `canIncremental` is true (input grew by exactly one element).
+     * Falls back to `_computeFull` for types that have no O(1) path.
+     */
+    private _appendOne;
+    /** Recursively marks all indicators that depend on `sourceId` as dirty. */
+    private _markDependentsDirty;
+}
+//# sourceMappingURL=IndicatorDAG.d.ts.map

package/dist/api/IndicatorDAG.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndicatorDAG.d.ts","sourceRoot":"","sources":["../../src/api/IndicatorDAG.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAc,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAczE,4CAA4C;AAC5C,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAA;CAAO,CAAC;AA8B5E,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAIlD;;;;;OAKG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IA+BlD,0EAA0E;IAC1E,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK5B;;;;OAIG;IACH,IAAI,CACF,UAAU,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;KAAE,CAAC,GACnF,IAAI;IAsCP;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,EAAE,SAAS,KAAK,EAAE,GAAG,OAAO;IA+BxC,mEAAmE;IACnE,aAAa,IAAI,IAAI;IAMrB,OAAO,IAAI,OAAO;IAMlB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIvC,aAAa,IAAI,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC;IAU/C;;;OAGG;IACH,OAAO,CAAC,SAAS;IAmCjB,OAAO,CAAC,SAAS;IAcjB,uGAAuG;IACvG,OAAO,CAAC,cAAc;IAWtB,yCAAyC;IACzC,OAAO,CAAC,YAAY;IA6CpB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAiClB,2EAA2E;IAC3E,OAAO,CAAC,oBAAoB;CAS7B"}

package/dist/api/IndicatorRegistry.d.ts

@@ -0,0 +1,22 @@
+import type { IndicatorConfig, IndicatorInstance } from '@forgecharts/types';
+/**
+ * IndicatorRegistry — tracks active indicator instances for a chart.
+ * Rendering is a separate concern (handled by sub-pane renderers, out of SDK scope).
+ */
+export declare class IndicatorRegistry {
+    private readonly _map;
+    /**
+     * Registers a new indicator and returns its opaque id.
+     */
+    add(config: IndicatorConfig): string;
+    /**
+     * Removes an indicator by id.
+     * @returns `true` if the indicator existed and was removed.
+     */
+    remove(id: string): boolean;
+    get(id: string): IndicatorInstance | undefined;
+    has(id: string): boolean;
+    all(): readonly IndicatorInstance[];
+    clear(): void;
+}
+//# sourceMappingURL=IndicatorRegistry.d.ts.map

package/dist/api/IndicatorRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndicatorRegistry.d.ts","sourceRoot":"","sources":["../../src/api/IndicatorRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAO7E;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwC;IAE7D;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM;IAMpC;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI9C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,GAAG,IAAI,SAAS,iBAAiB,EAAE;IAInC,KAAK,IAAI,IAAI;CAGd"}

package/dist/api/LayoutManager.d.ts

@@ -0,0 +1,30 @@
+import type { ChartLayout, ChartInterval, ChartTheme, IndicatorInstance, Drawing, Viewport, PaneDescriptor } from '@forgecharts/types';
+/**
+ * LayoutManager — pure serialisation / deserialisation of chart state.
+ * No side effects; state mutations are the caller's responsibility.
+ */
+export declare class LayoutManager {
+    /**
+     * Produces a serialisable snapshot of the current chart state.
+     */
+    static save(params: {
+        symbol: string;
+        interval: ChartInterval;
+        theme: ChartTheme;
+        indicators: readonly IndicatorInstance[];
+        drawings: readonly Drawing[];
+        viewport?: Viewport;
+        panes?: readonly PaneDescriptor[];
+    }): ChartLayout;
+    /**
+     * Serialises a layout to a JSON string safe for `localStorage` / remote persistence.
+     */
+    static toJSON(layout: ChartLayout): string;
+    /**
+     * Parses a JSON string back into a ChartLayout.
+     * Throws if the string is malformed.
+     */
+    static fromJSON(raw: string): ChartLayout;
+    private static _isLayout;
+}
+//# sourceMappingURL=LayoutManager.d.ts.map

package/dist/api/LayoutManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutManager.d.ts","sourceRoot":"","sources":["../../src/api/LayoutManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,OAAO,EACP,QAAQ,EACR,cAAc,EACf,MAAM,oBAAoB,CAAC;AAE5B;;;GAGG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,aAAa,CAAC;QACxB,KAAK,EAAE,UAAU,CAAC;QAClB,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;QACzC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;QAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;KACnC,GAAG,WAAW;IAaf;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;IAI1C;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAQzC,OAAO,CAAC,MAAM,CAAC,SAAS;CAazB"}

package/dist/api/PaneManager.d.ts

@@ -0,0 +1,42 @@
+import type { PaneDescriptor } from '@forgecharts/types';
+/**
+ * PaneManager — manages the collection of sub-pane (indicator panel) descriptors.
+ *
+ * Each `PaneDescriptor` carries:
+ *  - a stable `id`
+ *  - a `heightFraction` (0–1, all panes sum to 1)
+ *  - the `indicatorIds` assigned to that pane
+ *
+ * Height redistribution is proportional: when a pane is added/removed/resized,
+ * the remaining panes absorb or donate height proportionally to their current sizes.
+ */
+export declare class PaneManager {
+    private _panes;
+    getPanes(): readonly PaneDescriptor[];
+    /**
+     * Creates a new pane, distributing total height evenly across all panes.
+     * @returns The new pane's id.
+     */
+    createPane(label?: string): string;
+    /**
+     * Removes a pane and redistributes its height fraction to remaining panes.
+     */
+    removePane(id: string): void;
+    /**
+     * Assigns an indicator to a pane, removing it from any previous pane first.
+     */
+    assignIndicator(indicatorId: string, paneId: string): void;
+    /**
+     * Unassigns an indicator from whichever pane currently holds it.
+     */
+    unassignIndicator(indicatorId: string): void;
+    /**
+     * Resizes a pane by setting its `heightFraction`, clamped to [0.05, 0.9].
+     * Remaining panes absorb the difference proportionally.
+     */
+    resizePane(id: string, newFraction: number): void;
+    serialize(): readonly PaneDescriptor[];
+    restore(panes: readonly PaneDescriptor[]): void;
+    clear(): void;
+}
+//# sourceMappingURL=PaneManager.d.ts.map

package/dist/api/PaneManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaneManager.d.ts","sourceRoot":"","sources":["../../src/api/PaneManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOzD;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAwB;IAEtC,QAAQ,IAAI,SAAS,cAAc,EAAE;IAIrC;;;OAGG;IACH,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAiBlC;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAmB5B;;OAEG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAY1D;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAO5C;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAoBjD,SAAS,IAAI,SAAS,cAAc,EAAE;IAItC,OAAO,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI;IAI/C,KAAK,IAAI,IAAI;CAGd"}

package/dist/api/ReferenceAPI.d.ts

@@ -0,0 +1,78 @@
+import type { RefMarket, RefExchange, RefSymbol, SymbolSearchFilters, SymbolSearchResult } from '@forgecharts/types';
+export type ReferenceAPIConfig = {
+    /** Base URL of the ForgeCharts API server (e.g. "https://charts.myapp.com"). Defaults to current origin. */
+    apiUrl?: string;
+    /** Called to retrieve a Bearer token for authenticated endpoints. Falls back to localStorage['forgecharts-token']. */
+    getAuthToken?: () => string | Promise<string>;
+};
+type ProviderMapping = {
+    providerCode: string;
+    providerSymbol: string;
+    providerExchange: string | null;
+    metadata: unknown;
+};
+/**
+ * ReferenceAPI — headless SDK client for the Global Reference Data Platform.
+ *
+ * Provides symbol lookup, search, market/exchange browsing,
+ * provider mapping resolution, plus per-user favorites and recents.
+ *
+ * @example
+ * ```ts
+ * const ref = new ReferenceAPI();
+ * const { symbols } = await ref.searchSymbols('BTC');
+ * const popular = await ref.getPopularSymbols('crypto', 10);
+ * ```
+ */
+export declare class ReferenceAPI {
+    private readonly _base;
+    private readonly _getToken;
+    constructor(config?: ReferenceAPIConfig);
+    private _authHeaders;
+    private _get;
+    private _post;
+    private _delete;
+    /** Returns all active market categories (crypto, stocks, forex, …). */
+    getMarkets(): Promise<RefMarket[]>;
+    /** Returns all active exchanges / venues. */
+    getExchanges(): Promise<RefExchange[]>;
+    /**
+     * Full-text search across symbol tickers, names, and aliases.
+     * @param query   Search term (minimum 1 character).
+     * @param filters Optional market / exchange / limit / offset filters.
+     */
+    searchSymbols(query: string, filters?: SymbolSearchFilters): Promise<SymbolSearchResult>;
+    /**
+     * Browse the symbol catalogue with optional filters.
+     * Returns symbols ordered alphabetically.
+     */
+    getSymbols(filters?: SymbolSearchFilters): Promise<SymbolSearchResult>;
+    /**
+     * Returns the most popular / trending symbols.
+     * @param market  Optional market code to restrict results (e.g. "crypto").
+     * @param limit   Maximum results to return. Defaults to 20.
+     */
+    getPopularSymbols(market?: string, limit?: number): Promise<RefSymbol[]>;
+    /**
+     * Fetches full metadata for a single symbol by its global symbol key.
+     * @param symbolKey  e.g. "CRYPTO:BINANCE:BTCUSDT"
+     */
+    getSymbol(symbolKey: string): Promise<RefSymbol>;
+    /**
+     * Returns all provider-specific mappings for a symbol.
+     * Useful for resolving the correct datafeed symbol string at runtime.
+     */
+    getProviderMapping(symbolKey: string): Promise<ProviderMapping[]>;
+    /** Returns the authenticated user's recently viewed symbols (newest first). */
+    getRecentSymbols(): Promise<RefSymbol[]>;
+    /** Records a symbol as recently viewed for the authenticated user. */
+    recordRecentSymbol(symbolKey: string): Promise<void>;
+    /** Returns the authenticated user's favorite symbols. */
+    getFavoriteSymbols(): Promise<RefSymbol[]>;
+    /** Adds a symbol to the authenticated user's favorites. */
+    addFavoriteSymbol(symbolKey: string): Promise<void>;
+    /** Removes a symbol from the authenticated user's favorites. */
+    removeFavoriteSymbol(symbolKey: string): Promise<void>;
+}
+export {};
+//# sourceMappingURL=ReferenceAPI.d.ts.map

package/dist/api/ReferenceAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferenceAPI.d.ts","sourceRoot":"","sources":["../../src/api/ReferenceAPI.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,4GAA4G;IAC5G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sHAAsH;IACtH,YAAY,CAAC,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/C,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+C;gBAE7D,MAAM,GAAE,kBAAuB;YAO7B,YAAY;YAcZ,IAAI;YAeJ,KAAK;YAWL,OAAO;IAYrB,uEAAuE;IACjE,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIxC,6CAA6C;IACvC,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAM5C;;;;OAIG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAU9F;;;OAGG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAU5E;;;;OAIG;IACG,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAI1E;;;OAGG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAItD;;;OAGG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAQvE,+EAA+E;IACzE,gBAAgB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAI9C,sEAAsE;IAChE,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1D,yDAAyD;IACnD,kBAAkB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIhD,2DAA2D;IACrD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,gEAAgE;IAC1D,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7D"}