@forgecharts/sdk 1.1.23 → 1.1.28

package/dist/react/hooks/useChartCapabilities.js

@@ -0,0 +1,66 @@
+import { useState, useEffect, useMemo } from 'react';
+import { LicenseManager, getCapabilities } from '../../';
+/**
+ * Merges license-derived capabilities with optional host config overrides.
+ *
+ * A config flag explicitly set to `false` suppresses the feature even when
+ * the license permits it.  Omitting a field defers to the license.
+ * Derived render flags are recalculated from the updated feature flags so
+ * component-level gates remain consistent.
+ */
+function applyRuntimeConfig(caps, config) {
+    if (!config)
+        return caps;
+    const orderEntry = config.enableOrderEntry === false ? false : caps.orderEntry;
+    const draggableOrders = config.enableDraggableOrders === false ? false : caps.draggableOrders;
+    const bracketOrders = config.enableBracketOrders === false ? false : caps.bracketOrders;
+    const managedTrading = config.enableManagedTrading === false ? false : caps.managedTrading;
+    const indicators = config.enableIndicators === false ? false : caps.indicators;
+    return {
+        ...caps,
+        orderEntry,
+        draggableOrders,
+        bracketOrders,
+        managedTrading,
+        indicators,
+        // Recalculate derived render flags from the updated feature flags.
+        renderOrderEntry: orderEntry,
+        renderBuySellButtons: orderEntry,
+        renderOrderTicket: orderEntry,
+        renderBracketControls: orderEntry && bracketOrders,
+        renderOrderModificationControls: orderEntry && draggableOrders,
+        renderManagedTradingControls: managedTrading,
+        renderIndicators: indicators,
+    };
+}
+/**
+ * useChartCapabilities
+ *
+ * Returns the current chart capability set derived from two independent layers
+ * (both must allow a feature for it to be considered active):
+ *   1. **License entitlement** — from the loaded `LicensePayload` via `LicenseManager`.
+ *   2. **Host runtime config** — optional `ChartRuntimeConfig` passed by the consumer.
+ *
+ * The hook re-evaluates whenever the license changes and whenever the
+ * `config` reference changes (use a stable/memoised object to avoid unnecessary
+ * re-renders).
+ *
+ * Usage:
+ *   const caps = useChartCapabilities();
+ *   const caps = useChartCapabilities({ enableOrderEntry: false }); // suppress order entry
+ *   if (caps.renderOrderEntry) { ... }
+ */
+export function useChartCapabilities(config) {
+    const [licCaps, setLicCaps] = useState(() => getCapabilities());
+    useEffect(() => {
+        // Subscribe to license changes via LicenseManager only.
+        // Cross-tab StorageEvent sync is intentionally omitted — that coupling
+        // belongs at the app shell layer (ManagedAppShell reloads on auth change).
+        const unsub = LicenseManager.getInstance().subscribe(() => {
+            setLicCaps(getCapabilities());
+        });
+        return unsub;
+    }, []);
+    return useMemo(() => applyRuntimeConfig(licCaps, config), [licCaps, config]);
+}
+//# sourceMappingURL=useChartCapabilities.js.map

package/dist/react/hooks/useChartCapabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChartCapabilities.js","sourceRoot":"","sources":["../../../src/react/hooks/useChartCapabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAIzD;;;;;;;GAOG;AACH,SAAS,kBAAkB,CACzB,IAAuB,EACvB,MAAsC;IAEtC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,UAAU,GAAQ,MAAM,CAAC,gBAAgB,KAAU,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;IACzF,MAAM,eAAe,GAAG,MAAM,CAAC,qBAAqB,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;IAC9F,MAAM,aAAa,GAAK,MAAM,CAAC,mBAAmB,KAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;IAC5F,MAAM,cAAc,GAAI,MAAM,CAAC,oBAAoB,KAAM,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAC7F,MAAM,UAAU,GAAQ,MAAM,CAAC,gBAAgB,KAAU,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;IAEzF,OAAO;QACL,GAAG,IAAI;QACP,UAAU;QACV,eAAe;QACf,aAAa;QACb,cAAc;QACd,UAAU;QACV,mEAAmE;QACnE,gBAAgB,EAAiB,UAAU;QAC3C,oBAAoB,EAAa,UAAU;QAC3C,iBAAiB,EAAgB,UAAU;QAC3C,qBAAqB,EAAY,UAAU,IAAI,aAAa;QAC5D,+BAA+B,EAAE,UAAU,IAAI,eAAe;QAC9D,4BAA4B,EAAK,cAAc;QAC/C,gBAAgB,EAAiB,UAAU;KAC5C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA2B;IAC9D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAoB,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC;IAEnF,SAAS,CAAC,GAAG,EAAE;QACb,wDAAwD;QACxD,uEAAuE;QACvE,2EAA2E;QAC3E,MAAM,KAAK,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE;YACxD,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACf,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAC/E,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @forgecharts/sdk/react — Public React embed API
+ *
+ * Supported external integration surfaces:
+ *
+ *   ChartCanvas    — embed a single chart pane with full tool/indicator support
+ *   ChartWorkspace — embed the full multi-tab workspace UI (toolbars included)
+ *
+ * For Unmanaged host integration, use ChartCanvas or ChartWorkspace.
+ * For trading intents, wire TradingBridgeCallbacks.
+ *
+ * The following are intentionally NOT part of the public API:
+ *   - ManagedAppShell   (ForgeCharts Managed product shell — apps/frontend only)
+ *   - Internal sub-components (LayoutMenu, IndicatorPane, toolbars, …)
+ *   - MultiPaneChart    (internal rendering layer beneath ChartCanvas)
+ *
+ * Import from @forgecharts/chart-components/internal for app-layer-only symbols.
+ *
+ * @semver BREAKING changes are communicated via package.json major version bumps.
+ */
+export { ChartCanvas } from './canvas/ChartCanvas';
+export type { ChartCanvasHandle, ChartCanvasProps } from './canvas/ChartCanvas';
+export { ChartWorkspace } from './workspace/ChartWorkspace';
+export type { ChartWorkspaceProps, TabItem, TradingSession } from './workspace/ChartWorkspace';
+export { useChartCapabilities } from './hooks/useChartCapabilities';
+export type { TradingBridgeCallbacks } from './trading/TradingBridge';
+export { createTradingBridgeLogger } from './trading/TradingBridge';
+export type { ISymbolResolver, ChartRuntimeConfig } from '@forgecharts/types';
+export type { PlaceOrderIntent, ModifyOrderIntent, CancelOrderIntent, BracketAdjustIntent, TradingIntent, TradingIntentSide, TradingIntentOrderType, } from '@forgecharts/types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,YAAY,EAAE,mBAAmB,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGpE,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAIpE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG9E,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,28 @@
+/**
+ * @forgecharts/sdk/react — Public React embed API
+ *
+ * Supported external integration surfaces:
+ *
+ *   ChartCanvas    — embed a single chart pane with full tool/indicator support
+ *   ChartWorkspace — embed the full multi-tab workspace UI (toolbars included)
+ *
+ * For Unmanaged host integration, use ChartCanvas or ChartWorkspace.
+ * For trading intents, wire TradingBridgeCallbacks.
+ *
+ * The following are intentionally NOT part of the public API:
+ *   - ManagedAppShell   (ForgeCharts Managed product shell — apps/frontend only)
+ *   - Internal sub-components (LayoutMenu, IndicatorPane, toolbars, …)
+ *   - MultiPaneChart    (internal rendering layer beneath ChartCanvas)
+ *
+ * Import from @forgecharts/chart-components/internal for app-layer-only symbols.
+ *
+ * @semver BREAKING changes are communicated via package.json major version bumps.
+ */
+// ─── Canvas layer (primary single-pane embed API) ────────────────────────────
+export { ChartCanvas } from './canvas/ChartCanvas';
+// ─── Workspace layer (full workspace embed API) ───────────────────────────────
+export { ChartWorkspace } from './workspace/ChartWorkspace';
+// ─── Capability hook (useful for custom shells and conditional UI) ────────────
+export { useChartCapabilities } from './hooks/useChartCapabilities';
+export { createTradingBridgeLogger } from './trading/TradingBridge';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,gFAAgF;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,iFAAiF;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,iFAAiF;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAIpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/react/internal.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @forgecharts/sdk/react/internal
+ *
+ * Internal export surface — for use by the ForgeCharts Managed app layer ONLY.
+ * Do NOT import from this path in unmanaged host applications or external integrations.
+ * The semver stability guarantee of `@forgecharts/sdk/react` does NOT apply
+ * to symbols exported from this path.
+ *
+ * Direct internal consumers: apps/frontend
+ *
+ * Why this exists: ManagedAppShell is the ForgeCharts Managed product shell. It carries
+ * all Managed-mode state (layouts, preferences, workspace tabs, script drawer, watchlist,
+ * trade drawer). External hosts MUST NOT rely on it — they should compose ChartWorkspace
+ * or ChartCanvas directly with their own state management.
+ */
+export * from './index';
+export { ManagedAppShell } from './shell/ManagedAppShell';
+export type { ManagedAppShellProps, ManagedAppShellHandle, LayoutsAPI, PreferencesAPI, } from './shell/ManagedAppShell';
+export { LayoutMenu } from './workspace/LayoutMenu';
+export type { LayoutRecord } from './workspace/LayoutMenu';
+export { TabBar } from './workspace/TabBar';
+export type { TabItem as TabBarItem } from './workspace/TabBar';
+export { FloatingPanel } from './workspace/FloatingPanel';
+export { SymbolSearchDialog } from './workspace/SymbolSearchDialog';
+export { IndicatorsDialog } from './workspace/IndicatorsDialog';
+export { TopToolbar, DEFAULT_FAVORITES } from './workspace/toolbars/TopToolbar';
+export { RightToolbar } from './workspace/toolbars/RightToolbar';
+export { BottomToolbar } from './workspace/toolbars/BottomToolbar';
+export { IndicatorPane } from './canvas/IndicatorPane';
+export { IndicatorLabel } from './canvas/IndicatorLabel';
+export { ChartContextMenu } from './canvas/ChartContextMenu';
+export { ChartSettingsDialog } from './canvas/ChartSettingsDialog';
+export { PointerOverlay } from './canvas/PointerOverlay';
+export { LeftToolbar } from './canvas/toolbars/LeftToolbar';
+export type { VisibilityAction } from './canvas/toolbars/LeftToolbar';
+export { MultiPaneChart } from './canvas/ChartCanvas';
+export type { MultiPaneChartHandle, MultiPaneChartProps } from './canvas/ChartCanvas';
+//# sourceMappingURL=internal.d.ts.map

package/dist/react/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/react/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,cAAc,SAAS,CAAC;AAKxB,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,UAAU,EACV,cAAc,GACf,MAAM,yBAAyB,CAAC;AAKjC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,YAAY,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAInE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/react/internal.js

@@ -0,0 +1,44 @@
+/**
+ * @forgecharts/sdk/react/internal
+ *
+ * Internal export surface — for use by the ForgeCharts Managed app layer ONLY.
+ * Do NOT import from this path in unmanaged host applications or external integrations.
+ * The semver stability guarantee of `@forgecharts/sdk/react` does NOT apply
+ * to symbols exported from this path.
+ *
+ * Direct internal consumers: apps/frontend
+ *
+ * Why this exists: ManagedAppShell is the ForgeCharts Managed product shell. It carries
+ * all Managed-mode state (layouts, preferences, workspace tabs, script drawer, watchlist,
+ * trade drawer). External hosts MUST NOT rely on it — they should compose ChartWorkspace
+ * or ChartCanvas directly with their own state management.
+ */
+// Re-export the full public API so an import from this path is a strict superset.
+export * from './index';
+// ─── Managed app shell ────────────────────────────────────────────────────────
+// Internal only: ForgeCharts Managed product shell (apps/frontend).
+// Hosts building Unmanaged integrations must NOT use this.
+export { ManagedAppShell } from './shell/ManagedAppShell';
+// ─── Internal workspace sub-components ───────────────────────────────────────
+// Implementation details of ManagedAppShell / ChartWorkspace.
+// Not part of the public embed contract.
+export { LayoutMenu } from './workspace/LayoutMenu';
+export { TabBar } from './workspace/TabBar';
+export { FloatingPanel } from './workspace/FloatingPanel';
+export { SymbolSearchDialog } from './workspace/SymbolSearchDialog';
+export { IndicatorsDialog } from './workspace/IndicatorsDialog';
+export { TopToolbar, DEFAULT_FAVORITES } from './workspace/toolbars/TopToolbar';
+export { RightToolbar } from './workspace/toolbars/RightToolbar';
+export { BottomToolbar } from './workspace/toolbars/BottomToolbar';
+// ─── Internal canvas sub-components ──────────────────────────────────────────
+// Used inside ChartCanvas / ChartWorkspace — not for external composition.
+export { IndicatorPane } from './canvas/IndicatorPane';
+export { IndicatorLabel } from './canvas/IndicatorLabel';
+export { ChartContextMenu } from './canvas/ChartContextMenu';
+export { ChartSettingsDialog } from './canvas/ChartSettingsDialog';
+export { PointerOverlay } from './canvas/PointerOverlay';
+export { LeftToolbar } from './canvas/toolbars/LeftToolbar';
+// MultiPaneChart is the native multi-pane rendering component underlying ChartCanvas.
+// It is available here for advanced internal scenarios only.
+export { MultiPaneChart } from './canvas/ChartCanvas';
+//# sourceMappingURL=internal.js.map

package/dist/react/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/react/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,kFAAkF;AAClF,cAAc,SAAS,CAAC;AAExB,iFAAiF;AACjF,oEAAoE;AACpE,2DAA2D;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAQ1D,gFAAgF;AAChF,8DAA8D;AAC9D,yCAAyC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAEnE,gFAAgF;AAChF,2EAA2E;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAG5D,sFAAsF;AACtF,6DAA6D;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/react/shell/ManagedAppShell.d.ts

@@ -0,0 +1,91 @@
+/**
+ * ManagedAppShell — stateful chart application shell.
+ *
+ * Owns all workspace state (tabs, symbol, timeframe, layout persistence, etc.)
+ * and wires injected API clients to ChartWorkspace. App-specific drawers (script,
+ * watchlist, trade) are passed as render-prop factories so this shell never
+ * imports from the app layer.
+ */
+import React from 'react';
+import type { ChartCanvasHandle } from '../canvas/ChartCanvas';
+import type { LayoutRecord } from '../workspace/LayoutMenu';
+import type { IDatafeed, IndicatorConfig, ISymbolResolver, ChartRuntimeConfig } from '@forgecharts/types';
+import type { TradingBridgeCallbacks } from '../trading/TradingBridge';
+export type LayoutsAPI = {
+    list: () => Promise<LayoutRecord[]>;
+    get: (id: string) => Promise<LayoutRecord>;
+    create: (data: {
+        name: string;
+        symbol: string;
+        timeframe: string;
+        config: Record<string, unknown>;
+    }) => Promise<LayoutRecord>;
+    update: (id: string, data: Partial<{
+        name: string;
+        symbol: string;
+        timeframe: string;
+        config: Record<string, unknown>;
+    }>) => Promise<LayoutRecord>;
+    remove: (id: string) => Promise<void>;
+};
+export type PreferencesAPI = {
+    get: <T = Record<string, unknown>>() => Promise<T>;
+    put: (data: Record<string, unknown>) => Promise<void>;
+};
+export type ManagedAppShellProps = {
+    datafeed: IDatafeed;
+    layouts: LayoutsAPI;
+    preferences: PreferencesAPI;
+    /** Resolver used by the built-in symbol search dialog. */
+    symbolResolver: ISymbolResolver;
+    /**
+     * Async callback that returns the current user's Bearer token.
+     * Used to authenticate the internal `/api/license` fetch and can be
+     * forwarded to `TChart` / `ReferenceAPI` instances that need auth.
+     * If omitted, requests are sent without `Authorization` headers.
+     */
+    getAuthToken?: () => string | Promise<string>;
+    /**
+     * Base URL of the ForgeCharts API, e.g. `"https://charts.myapp.com"`.
+     * Defaults to the current origin.  Set this when the chart is embedded
+     * on a different domain from the API server.
+     */
+    apiUrl?: string;
+    /**
+     * Optional callback to resolve an exchange logo image URL.
+     * Receives the exchange code (e.g. "BINANCE") and returns a URL string or
+     * null/undefined to suppress the logo. If omitted, no logo is shown.
+     * ForgeCharts Studio sets this to the /api/logos/ endpoint.
+     */
+    getExchangeLogoUrl?: (exchange: string) => string | null | undefined;
+    /**
+     * Optional host-level feature overrides applied on top of the license.
+     * Set a flag to `false` to suppress a feature even when the license permits
+     * it.  Omitting the prop (or individual fields) defers fully to the license.
+     */
+    config?: ChartRuntimeConfig;
+    /**
+     * Optional trading bridge callbacks threaded to every ChartCanvas instance.
+     *
+     * Provide this when `enableOrderEntry` / `enableDraggableOrders` etc. are
+     * active so the chart can emit intents to your broker layer.
+     * Use `createTradingBridgeLogger(bridge)` in dev for structured logging.
+     */
+    tradingBridge?: TradingBridgeCallbacks;
+    renderScriptDrawer?: (props: {
+        onClose: () => void;
+        onAddIndicator: (c: IndicatorConfig) => void;
+    }) => React.ReactElement | null;
+    renderWatchlistDrawer?: (props: {
+        onClose: () => void;
+        onSelectSymbol: (sym: string) => void;
+    }) => React.ReactElement | null;
+    renderTradeDrawer?: (props: {
+        onClose: () => void;
+    }) => React.ReactElement | null;
+};
+export type ManagedAppShellHandle = {
+    getActiveChartHandle: () => ChartCanvasHandle | null;
+};
+export declare const ManagedAppShell: React.ForwardRefExoticComponent<ManagedAppShellProps & React.RefAttributes<ManagedAppShellHandle>>;
+//# sourceMappingURL=ManagedAppShell.d.ts.map

package/dist/react/shell/ManagedAppShell.d.ts.map

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