@metamask-previews/advanced-chart-core 0.0.0-preview-e58fe0640 → 0.0.0-preview-6eb51ef1f

package/dist/core/bootstrap.cjs

@@ -0,0 +1,185 @@
+"use strict";
+// Entry orchestration. Called once from src/index.ts when the IIFE evaluates
+// inside the WebView.
+//
+// Responsibilities (Phase 1 + 2):
+// 1. Read window.CONFIG (must be inlined by AdvancedChartTemplate before this
+//    script runs).
+// 2. Seed core state with the symbol / resolution / theme from CONFIG.
+// 3. Wire the RN→WV bridge to the message dispatcher.
+// 4. Register Phase 1 + 2 message handlers:
+//      SET_THEME_COLORS (Phase 1), SET_OHLCV_DATA, REALTIME_UPDATE,
+//      SET_CHART_TYPE (Phase 2).
+// 5. Begin loading the TradingView library so it's ready when the first
+//    SET_OHLCV_DATA arrives.
+// 6. On first SET_OHLCV_DATA: createChartWidget with the default datafeed,
+//    apply visual overrides, attach crosshair + visible-range listeners.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bootstrap = void 0;
+const bridge_js_1 = require("./bridge.cjs");
+const loadLibrary_js_1 = require("./loadLibrary.cjs");
+const handler_js_1 = require("../messages/handler.cjs");
+const theme_js_1 = require("../widget/theme.cjs");
+const datafeed_js_1 = require("../widget/datafeed.cjs");
+const priceFormatter_js_1 = require("../widget/priceFormatter.cjs");
+const timeUtils_js_1 = require("./timeUtils.cjs");
+const ohlcvIngestion_js_1 = require("../widget/ohlcvIngestion.cjs");
+const chartType_js_1 = require("../widget/chartType.cjs");
+const visualOverrides_js_1 = require("../widget/visualOverrides.cjs");
+const initChart_js_1 = require("../widget/initChart.cjs");
+const crosshair_js_1 = require("../interaction/crosshair.cjs");
+const visibleRange_js_1 = require("../interaction/visibleRange.cjs");
+const scaleLayout_js_1 = require("../widget/scaleLayout.cjs");
+const index_js_1 = require("../features/indicators/index.cjs");
+const subPane_js_1 = require("../features/indicators/subPane.cjs");
+const legend_js_1 = require("../features/indicators/legend.cjs");
+const index_js_2 = require("../features/volume/index.cjs");
+const index_js_3 = require("../overlays/tradeMarkers/index.cjs");
+const animation_js_1 = require("../overlays/tradeMarkers/animation.cjs");
+const markerHitTest_js_1 = require("../overlays/tradeMarkers/markerHitTest.cjs");
+const index_js_4 = require("../overlays/focusTime/index.cjs");
+const index_js_5 = require("../overlays/positionLines/index.cjs");
+const index_js_6 = require("../overlays/socialLeaderboard/index.cjs");
+const rnBacked_js_1 = require("../pagination/rnBacked.cjs");
+const state_js_1 = require("./state.cjs");
+/**
+ * When RN passes an explicit visible-range start (e.g. a specific period like
+ * 1D/1W/1M), build a `{ type: 'time-range', from, to }` timeframe so the
+ * initial view snaps to that window instead of defaulting to `Date.now()`.
+ * Padded by 2 bar durations so the last bar isn't glued to the right edge.
+ * Ported from chartLogic.js initChart's `tfOption` computation (~line 5284).
+ *
+ * @returns A `time-range` timeframe pinned to the requested window, or
+ * `undefined` when RN did not pass an explicit visible-range start.
+ */
+function buildInitialTimeframe() {
+    const visibleFromMs = (0, state_js_1.getVisibleFromMs)();
+    if (visibleFromMs === null) {
+        return undefined;
+    }
+    const visibleToMs = (0, state_js_1.getVisibleToMs)() ?? Date.now();
+    const initBarPadSec = (0, timeUtils_js_1.getApproxBarDurationSec)((0, state_js_1.getOhlcvData)()) * 2;
+    return {
+        type: 'time-range',
+        from: Math.floor(visibleFromMs / 1000),
+        to: Math.ceil(visibleToMs / 1000) + initBarPadSec,
+    };
+}
+function readConfig() {
+    const config = window.CONFIG;
+    if (!config) {
+        throw new Error('window.CONFIG is missing — AdvancedChartTemplate must inline ' +
+            'CONFIG before chartLogic runs.');
+    }
+    return config;
+}
+/**
+ * Phase 1 + 2 bootstrap. Returns the resolved CONFIG so callers (and tests)
+ * can inspect what booted. Idempotent on its inbound subscription — the
+ * WebView is not expected to bootstrap twice.
+ *
+ * @returns The resolved chart configuration read from `window.CONFIG`.
+ */
+function bootstrap() {
+    const config = readConfig();
+    (0, theme_js_1.initThemeFromConfig)(config.theme);
+    if (typeof config.subPaneHeightRatio === 'number') {
+        (0, state_js_1.setSubPaneHeightRatio)(config.subPaneHeightRatio);
+    }
+    (0, handler_js_1.registerHandler)('SET_THEME_COLORS', (payload) => {
+        (0, theme_js_1.applyThemeColors)(payload);
+    });
+    (0, handler_js_1.registerHandler)('SET_OHLCV_DATA', (payload) => {
+        (0, ohlcvIngestion_js_1.handleSetOHLCVData)(payload);
+    });
+    (0, handler_js_1.registerHandler)('REALTIME_UPDATE', (payload) => {
+        (0, ohlcvIngestion_js_1.handleRealtimeUpdate)(payload);
+    });
+    (0, handler_js_1.registerHandler)('SET_CHART_TYPE', (payload) => {
+        (0, chartType_js_1.handleSetChartType)(payload);
+    });
+    (0, handler_js_1.registerHandler)('ADD_INDICATOR', (payload) => {
+        (0, index_js_1.handleAddIndicator)(payload, config);
+    });
+    (0, handler_js_1.registerHandler)('REMOVE_INDICATOR', (payload) => {
+        (0, index_js_1.handleRemoveIndicator)(payload);
+    });
+    (0, handler_js_1.registerHandler)('SET_MA_VISIBILITY', (payload) => {
+        (0, index_js_1.handleSetMAVisibility)(payload, config);
+    });
+    (0, handler_js_1.registerHandler)('TOGGLE_VOLUME', (payload) => {
+        (0, index_js_2.handleToggleVolume)(payload);
+    });
+    (0, handler_js_1.registerHandler)('SET_SUB_PANE_LAYOUT', (payload) => {
+        (0, subPane_js_1.handleSetSubPaneLayout)(payload);
+    });
+    (0, index_js_3.registerTradeMarkerOverlay)();
+    (0, animation_js_1.registerTradeMarkerPulseHandler)();
+    (0, index_js_4.registerFocusTimeOverlay)();
+    (0, index_js_5.registerPositionLinesOverlay)();
+    (0, rnBacked_js_1.registerRnBackedPaginationHandler)();
+    (0, index_js_2.registerVolumeThemeSync)();
+    (0, bridge_js_1.onFromRN)((message) => {
+        (0, handler_js_1.dispatchInboundMessage)(message);
+    });
+    // Library load is fire-and-forget; the first-data handler awaits readiness
+    // again before constructing the widget, so this is purely a head-start.
+    (0, loadLibrary_js_1.loadTradingViewLibrary)(config.libraryUrl).catch((error) => {
+        (0, bridge_js_1.reportErrorToRN)(error);
+    });
+    (0, ohlcvIngestion_js_1.onFirstOhlcvData)(() => {
+        (0, loadLibrary_js_1.loadTradingViewLibrary)(config.libraryUrl)
+            .then(() => {
+            return (0, initChart_js_1.createChartWidget)(config, {
+                datafeed: datafeed_js_1.customDatafeed,
+                customFormatters: {
+                    priceFormatterFactory: priceFormatter_js_1.advancedChartPriceFormatterFactory,
+                },
+                timeframe: buildInitialTimeframe(),
+                onReady: (widget) => {
+                    try {
+                        (0, theme_js_1.flushPendingTheme)();
+                        (0, scaleLayout_js_1.applyScaleLayout)();
+                        (0, visualOverrides_js_1.applyVisualOverrides)(config.visualOverrides);
+                        (0, legend_js_1.setupLegendOverlay)(config.legendOverlay);
+                        const chart = widget.activeChart();
+                        // Match legacy onChartReady: when no explicit visible range
+                        // was passed, pin a 2-bar gap on the right. TV's default is
+                        // wider, leaving the chart visibly offset left.
+                        if ((0, state_js_1.getVisibleFromMs)() === null) {
+                            try {
+                                chart.getTimeScale().setRightOffset(2);
+                            }
+                            catch (rightOffsetError) {
+                                (0, bridge_js_1.reportErrorToRN)(rightOffsetError);
+                            }
+                        }
+                        (0, crosshair_js_1.attachCrosshairListener)(chart);
+                        (0, crosshair_js_1.attachTapDismiss)(widget);
+                        (0, markerHitTest_js_1.attachMarkerHitTest)(widget, chart);
+                        (0, visibleRange_js_1.attachVisibleRangeListeners)(chart);
+                        chart
+                            .selection()
+                            .onChanged()
+                            .subscribe(null, () => {
+                            chart.selection().clear();
+                        });
+                        (0, legend_js_1.attachLegendResizeListener)(widget);
+                        (0, index_js_6.slbScheduleInitialCentering)();
+                        (0, initChart_js_1.scheduleChartLayoutSettledNotify)();
+                    }
+                    catch (error) {
+                        (0, bridge_js_1.reportErrorToRN)(error);
+                    }
+                },
+            });
+        })
+            .catch((error) => {
+            (0, bridge_js_1.reportErrorToRN)(error);
+        });
+    });
+    (0, bridge_js_1.postToRN)('DEBUG', { message: 'modular-bootstrap-ready' });
+    return config;
+}
+exports.bootstrap = bootstrap;
+//# sourceMappingURL=bootstrap.cjs.map

package/dist/core/bootstrap.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.cjs","sourceRoot":"","sources":["../../src/core/bootstrap.ts"],"names":[],"mappings":"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","sourcesContent":["// Entry orchestration. Called once from src/index.ts when the IIFE evaluates\n// inside the WebView.\n//\n// Responsibilities (Phase 1 + 2):\n// 1. Read window.CONFIG (must be inlined by AdvancedChartTemplate before this\n//    script runs).\n// 2. Seed core state with the symbol / resolution / theme from CONFIG.\n// 3. Wire the RN→WV bridge to the message dispatcher.\n// 4. Register Phase 1 + 2 message handlers:\n//      SET_THEME_COLORS (Phase 1), SET_OHLCV_DATA, REALTIME_UPDATE,\n//      SET_CHART_TYPE (Phase 2).\n// 5. Begin loading the TradingView library so it's ready when the first\n//    SET_OHLCV_DATA arrives.\n// 6. On first SET_OHLCV_DATA: createChartWidget with the default datafeed,\n//    apply visual overrides, attach crosshair + visible-range listeners.\n\nimport { onFromRN, postToRN, reportErrorToRN } from './bridge.js';\nimport { loadTradingViewLibrary } from './loadLibrary.js';\nimport { dispatchInboundMessage, registerHandler } from '../messages/handler.js';\nimport {\n  applyThemeColors,\n  flushPendingTheme,\n  initThemeFromConfig,\n} from '../widget/theme.js';\nimport { customDatafeed } from '../widget/datafeed.js';\nimport { advancedChartPriceFormatterFactory } from '../widget/priceFormatter.js';\nimport { getApproxBarDurationSec } from './timeUtils.js';\nimport {\n  handleRealtimeUpdate,\n  handleSetOHLCVData,\n  onFirstOhlcvData,\n} from '../widget/ohlcvIngestion.js';\nimport { handleSetChartType } from '../widget/chartType.js';\nimport { applyVisualOverrides } from '../widget/visualOverrides.js';\nimport {\n  createChartWidget,\n  scheduleChartLayoutSettledNotify,\n} from '../widget/initChart.js';\nimport {\n  attachCrosshairListener,\n  attachTapDismiss,\n} from '../interaction/crosshair.js';\nimport { attachVisibleRangeListeners } from '../interaction/visibleRange.js';\nimport { applyScaleLayout } from '../widget/scaleLayout.js';\nimport {\n  handleAddIndicator,\n  handleRemoveIndicator,\n  handleSetMAVisibility,\n} from '../features/indicators/index.js';\nimport { handleSetSubPaneLayout } from '../features/indicators/subPane.js';\nimport {\n  attachLegendResizeListener,\n  setupLegendOverlay,\n} from '../features/indicators/legend.js';\nimport {\n  handleToggleVolume,\n  registerVolumeThemeSync,\n} from '../features/volume/index.js';\nimport { registerTradeMarkerOverlay } from '../overlays/tradeMarkers/index.js';\nimport { registerTradeMarkerPulseHandler } from '../overlays/tradeMarkers/animation.js';\nimport { attachMarkerHitTest } from '../overlays/tradeMarkers/markerHitTest.js';\nimport { registerFocusTimeOverlay } from '../overlays/focusTime/index.js';\nimport { registerPositionLinesOverlay } from '../overlays/positionLines/index.js';\nimport { slbScheduleInitialCentering } from '../overlays/socialLeaderboard/index.js';\nimport { registerRnBackedPaginationHandler } from '../pagination/rnBacked.js';\nimport {\n  getOhlcvData,\n  getVisibleFromMs,\n  getVisibleToMs,\n  setSubPaneHeightRatio,\n} from './state.js';\nimport type { ChartConfig } from './types.js';\n\n/**\n * When RN passes an explicit visible-range start (e.g. a specific period like\n * 1D/1W/1M), build a `{ type: 'time-range', from, to }` timeframe so the\n * initial view snaps to that window instead of defaulting to `Date.now()`.\n * Padded by 2 bar durations so the last bar isn't glued to the right edge.\n * Ported from chartLogic.js initChart's `tfOption` computation (~line 5284).\n *\n * @returns A `time-range` timeframe pinned to the requested window, or\n * `undefined` when RN did not pass an explicit visible-range start.\n */\nfunction buildInitialTimeframe():\n  | { type: 'time-range'; from: number; to: number }\n  | undefined {\n  const visibleFromMs = getVisibleFromMs();\n  if (visibleFromMs === null) {return undefined;}\n  const visibleToMs = getVisibleToMs() ?? Date.now();\n  const initBarPadSec = getApproxBarDurationSec(getOhlcvData()) * 2;\n  return {\n    type: 'time-range',\n    from: Math.floor(visibleFromMs / 1000),\n    to: Math.ceil(visibleToMs / 1000) + initBarPadSec,\n  };\n}\n\nfunction readConfig(): ChartConfig {\n  const config = window.CONFIG;\n  if (!config) {\n    throw new Error(\n      'window.CONFIG is missing — AdvancedChartTemplate must inline ' +\n        'CONFIG before chartLogic runs.',\n    );\n  }\n  return config;\n}\n\n/**\n * Phase 1 + 2 bootstrap. Returns the resolved CONFIG so callers (and tests)\n * can inspect what booted. Idempotent on its inbound subscription — the\n * WebView is not expected to bootstrap twice.\n *\n * @returns The resolved chart configuration read from `window.CONFIG`.\n */\nexport function bootstrap(): ChartConfig {\n  const config = readConfig();\n\n  initThemeFromConfig(config.theme);\n  if (typeof config.subPaneHeightRatio === 'number') {\n    setSubPaneHeightRatio(config.subPaneHeightRatio);\n  }\n\n  registerHandler('SET_THEME_COLORS', (payload) => {\n    applyThemeColors(payload);\n  });\n  registerHandler('SET_OHLCV_DATA', (payload) => {\n    handleSetOHLCVData(payload);\n  });\n  registerHandler('REALTIME_UPDATE', (payload) => {\n    handleRealtimeUpdate(payload);\n  });\n  registerHandler('SET_CHART_TYPE', (payload) => {\n    handleSetChartType(payload);\n  });\n  registerHandler('ADD_INDICATOR', (payload) => {\n    handleAddIndicator(payload, config);\n  });\n  registerHandler('REMOVE_INDICATOR', (payload) => {\n    handleRemoveIndicator(payload);\n  });\n  registerHandler('SET_MA_VISIBILITY', (payload) => {\n    handleSetMAVisibility(payload, config);\n  });\n  registerHandler('TOGGLE_VOLUME', (payload) => {\n    handleToggleVolume(payload);\n  });\n  registerHandler('SET_SUB_PANE_LAYOUT', (payload) => {\n    handleSetSubPaneLayout(payload);\n  });\n\n  registerTradeMarkerOverlay();\n  registerTradeMarkerPulseHandler();\n  registerFocusTimeOverlay();\n  registerPositionLinesOverlay();\n  registerRnBackedPaginationHandler();\n  registerVolumeThemeSync();\n\n  onFromRN((message) => {\n    dispatchInboundMessage(message);\n  });\n\n  // Library load is fire-and-forget; the first-data handler awaits readiness\n  // again before constructing the widget, so this is purely a head-start.\n  loadTradingViewLibrary(config.libraryUrl).catch((error) => {\n    reportErrorToRN(error);\n  });\n\n  onFirstOhlcvData(() => {\n    loadTradingViewLibrary(config.libraryUrl)\n      .then(() => {\n        return createChartWidget(config, {\n          datafeed: customDatafeed,\n          customFormatters: {\n            priceFormatterFactory: advancedChartPriceFormatterFactory,\n          },\n          timeframe: buildInitialTimeframe(),\n          onReady: (widget) => {\n            try {\n              flushPendingTheme();\n              applyScaleLayout();\n              applyVisualOverrides(config.visualOverrides);\n              setupLegendOverlay(config.legendOverlay);\n              const chart = widget.activeChart();\n              // Match legacy onChartReady: when no explicit visible range\n              // was passed, pin a 2-bar gap on the right. TV's default is\n              // wider, leaving the chart visibly offset left.\n              if (getVisibleFromMs() === null) {\n                try {\n                  chart.getTimeScale().setRightOffset(2);\n                } catch (rightOffsetError) {\n                  reportErrorToRN(rightOffsetError);\n                }\n              }\n              attachCrosshairListener(chart);\n              attachTapDismiss(widget);\n              attachMarkerHitTest(widget, chart);\n              attachVisibleRangeListeners(chart);\n              chart\n                .selection()\n                .onChanged()\n                .subscribe(null, () => {\n                  chart.selection().clear();\n                });\n              attachLegendResizeListener(widget);\n              slbScheduleInitialCentering();\n              scheduleChartLayoutSettledNotify();\n            } catch (error) {\n              reportErrorToRN(error);\n            }\n          },\n        });\n      })\n      .catch((error) => {\n        reportErrorToRN(error);\n      });\n  });\n\n  postToRN('DEBUG', { message: 'modular-bootstrap-ready' });\n\n  return config;\n}\n"]}

package/dist/core/bootstrap.d.cts

@@ -0,0 +1,10 @@
+import type { ChartConfig } from "./types.cjs";
+/**
+ * Phase 1 + 2 bootstrap. Returns the resolved CONFIG so callers (and tests)
+ * can inspect what booted. Idempotent on its inbound subscription — the
+ * WebView is not expected to bootstrap twice.
+ *
+ * @returns The resolved chart configuration read from `window.CONFIG`.
+ */
+export declare function bootstrap(): ChartConfig;
+//# sourceMappingURL=bootstrap.d.cts.map

package/dist/core/bootstrap.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.cts","sourceRoot":"","sources":["../../src/core/bootstrap.ts"],"names":[],"mappings":"AAuEA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAmB;AAqC9C;;;;;;GAMG;AACH,wBAAgB,SAAS,IAAI,WAAW,CA0GvC"}

package/dist/core/bootstrap.d.mts

@@ -0,0 +1,10 @@
+import type { ChartConfig } from "./types.mjs";
+/**
+ * Phase 1 + 2 bootstrap. Returns the resolved CONFIG so callers (and tests)
+ * can inspect what booted. Idempotent on its inbound subscription — the
+ * WebView is not expected to bootstrap twice.
+ *
+ * @returns The resolved chart configuration read from `window.CONFIG`.
+ */
+export declare function bootstrap(): ChartConfig;
+//# sourceMappingURL=bootstrap.d.mts.map

package/dist/core/bootstrap.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.mts","sourceRoot":"","sources":["../../src/core/bootstrap.ts"],"names":[],"mappings":"AAuEA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAmB;AAqC9C;;;;;;GAMG;AACH,wBAAgB,SAAS,IAAI,WAAW,CA0GvC"}

package/dist/core/bootstrap.mjs

@@ -0,0 +1,181 @@
+// Entry orchestration. Called once from src/index.ts when the IIFE evaluates
+// inside the WebView.
+//
+// Responsibilities (Phase 1 + 2):
+// 1. Read window.CONFIG (must be inlined by AdvancedChartTemplate before this
+//    script runs).
+// 2. Seed core state with the symbol / resolution / theme from CONFIG.
+// 3. Wire the RN→WV bridge to the message dispatcher.
+// 4. Register Phase 1 + 2 message handlers:
+//      SET_THEME_COLORS (Phase 1), SET_OHLCV_DATA, REALTIME_UPDATE,
+//      SET_CHART_TYPE (Phase 2).
+// 5. Begin loading the TradingView library so it's ready when the first
+//    SET_OHLCV_DATA arrives.
+// 6. On first SET_OHLCV_DATA: createChartWidget with the default datafeed,
+//    apply visual overrides, attach crosshair + visible-range listeners.
+import { onFromRN, postToRN, reportErrorToRN } from "./bridge.mjs";
+import { loadTradingViewLibrary } from "./loadLibrary.mjs";
+import { dispatchInboundMessage, registerHandler } from "../messages/handler.mjs";
+import { applyThemeColors, flushPendingTheme, initThemeFromConfig } from "../widget/theme.mjs";
+import { customDatafeed } from "../widget/datafeed.mjs";
+import { advancedChartPriceFormatterFactory } from "../widget/priceFormatter.mjs";
+import { getApproxBarDurationSec } from "./timeUtils.mjs";
+import { handleRealtimeUpdate, handleSetOHLCVData, onFirstOhlcvData } from "../widget/ohlcvIngestion.mjs";
+import { handleSetChartType } from "../widget/chartType.mjs";
+import { applyVisualOverrides } from "../widget/visualOverrides.mjs";
+import { createChartWidget, scheduleChartLayoutSettledNotify } from "../widget/initChart.mjs";
+import { attachCrosshairListener, attachTapDismiss } from "../interaction/crosshair.mjs";
+import { attachVisibleRangeListeners } from "../interaction/visibleRange.mjs";
+import { applyScaleLayout } from "../widget/scaleLayout.mjs";
+import { handleAddIndicator, handleRemoveIndicator, handleSetMAVisibility } from "../features/indicators/index.mjs";
+import { handleSetSubPaneLayout } from "../features/indicators/subPane.mjs";
+import { attachLegendResizeListener, setupLegendOverlay } from "../features/indicators/legend.mjs";
+import { handleToggleVolume, registerVolumeThemeSync } from "../features/volume/index.mjs";
+import { registerTradeMarkerOverlay } from "../overlays/tradeMarkers/index.mjs";
+import { registerTradeMarkerPulseHandler } from "../overlays/tradeMarkers/animation.mjs";
+import { attachMarkerHitTest } from "../overlays/tradeMarkers/markerHitTest.mjs";
+import { registerFocusTimeOverlay } from "../overlays/focusTime/index.mjs";
+import { registerPositionLinesOverlay } from "../overlays/positionLines/index.mjs";
+import { slbScheduleInitialCentering } from "../overlays/socialLeaderboard/index.mjs";
+import { registerRnBackedPaginationHandler } from "../pagination/rnBacked.mjs";
+import { getOhlcvData, getVisibleFromMs, getVisibleToMs, setSubPaneHeightRatio } from "./state.mjs";
+/**
+ * When RN passes an explicit visible-range start (e.g. a specific period like
+ * 1D/1W/1M), build a `{ type: 'time-range', from, to }` timeframe so the
+ * initial view snaps to that window instead of defaulting to `Date.now()`.
+ * Padded by 2 bar durations so the last bar isn't glued to the right edge.
+ * Ported from chartLogic.js initChart's `tfOption` computation (~line 5284).
+ *
+ * @returns A `time-range` timeframe pinned to the requested window, or
+ * `undefined` when RN did not pass an explicit visible-range start.
+ */
+function buildInitialTimeframe() {
+    const visibleFromMs = getVisibleFromMs();
+    if (visibleFromMs === null) {
+        return undefined;
+    }
+    const visibleToMs = getVisibleToMs() ?? Date.now();
+    const initBarPadSec = getApproxBarDurationSec(getOhlcvData()) * 2;
+    return {
+        type: 'time-range',
+        from: Math.floor(visibleFromMs / 1000),
+        to: Math.ceil(visibleToMs / 1000) + initBarPadSec,
+    };
+}
+function readConfig() {
+    const config = window.CONFIG;
+    if (!config) {
+        throw new Error('window.CONFIG is missing — AdvancedChartTemplate must inline ' +
+            'CONFIG before chartLogic runs.');
+    }
+    return config;
+}
+/**
+ * Phase 1 + 2 bootstrap. Returns the resolved CONFIG so callers (and tests)
+ * can inspect what booted. Idempotent on its inbound subscription — the
+ * WebView is not expected to bootstrap twice.
+ *
+ * @returns The resolved chart configuration read from `window.CONFIG`.
+ */
+export function bootstrap() {
+    const config = readConfig();
+    initThemeFromConfig(config.theme);
+    if (typeof config.subPaneHeightRatio === 'number') {
+        setSubPaneHeightRatio(config.subPaneHeightRatio);
+    }
+    registerHandler('SET_THEME_COLORS', (payload) => {
+        applyThemeColors(payload);
+    });
+    registerHandler('SET_OHLCV_DATA', (payload) => {
+        handleSetOHLCVData(payload);
+    });
+    registerHandler('REALTIME_UPDATE', (payload) => {
+        handleRealtimeUpdate(payload);
+    });
+    registerHandler('SET_CHART_TYPE', (payload) => {
+        handleSetChartType(payload);
+    });
+    registerHandler('ADD_INDICATOR', (payload) => {
+        handleAddIndicator(payload, config);
+    });
+    registerHandler('REMOVE_INDICATOR', (payload) => {
+        handleRemoveIndicator(payload);
+    });
+    registerHandler('SET_MA_VISIBILITY', (payload) => {
+        handleSetMAVisibility(payload, config);
+    });
+    registerHandler('TOGGLE_VOLUME', (payload) => {
+        handleToggleVolume(payload);
+    });
+    registerHandler('SET_SUB_PANE_LAYOUT', (payload) => {
+        handleSetSubPaneLayout(payload);
+    });
+    registerTradeMarkerOverlay();
+    registerTradeMarkerPulseHandler();
+    registerFocusTimeOverlay();
+    registerPositionLinesOverlay();
+    registerRnBackedPaginationHandler();
+    registerVolumeThemeSync();
+    onFromRN((message) => {
+        dispatchInboundMessage(message);
+    });
+    // Library load is fire-and-forget; the first-data handler awaits readiness
+    // again before constructing the widget, so this is purely a head-start.
+    loadTradingViewLibrary(config.libraryUrl).catch((error) => {
+        reportErrorToRN(error);
+    });
+    onFirstOhlcvData(() => {
+        loadTradingViewLibrary(config.libraryUrl)
+            .then(() => {
+            return createChartWidget(config, {
+                datafeed: customDatafeed,
+                customFormatters: {
+                    priceFormatterFactory: advancedChartPriceFormatterFactory,
+                },
+                timeframe: buildInitialTimeframe(),
+                onReady: (widget) => {
+                    try {
+                        flushPendingTheme();
+                        applyScaleLayout();
+                        applyVisualOverrides(config.visualOverrides);
+                        setupLegendOverlay(config.legendOverlay);
+                        const chart = widget.activeChart();
+                        // Match legacy onChartReady: when no explicit visible range
+                        // was passed, pin a 2-bar gap on the right. TV's default is
+                        // wider, leaving the chart visibly offset left.
+                        if (getVisibleFromMs() === null) {
+                            try {
+                                chart.getTimeScale().setRightOffset(2);
+                            }
+                            catch (rightOffsetError) {
+                                reportErrorToRN(rightOffsetError);
+                            }
+                        }
+                        attachCrosshairListener(chart);
+                        attachTapDismiss(widget);
+                        attachMarkerHitTest(widget, chart);
+                        attachVisibleRangeListeners(chart);
+                        chart
+                            .selection()
+                            .onChanged()
+                            .subscribe(null, () => {
+                            chart.selection().clear();
+                        });
+                        attachLegendResizeListener(widget);
+                        slbScheduleInitialCentering();
+                        scheduleChartLayoutSettledNotify();
+                    }
+                    catch (error) {
+                        reportErrorToRN(error);
+                    }
+                },
+            });
+        })
+            .catch((error) => {
+            reportErrorToRN(error);
+        });
+    });
+    postToRN('DEBUG', { message: 'modular-bootstrap-ready' });
+    return config;
+}
+//# sourceMappingURL=bootstrap.mjs.map

package/dist/core/bootstrap.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.mjs","sourceRoot":"","sources":["../../src/core/bootstrap.ts"],"names":[],"mappings":"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","sourcesContent":["// Entry orchestration. Called once from src/index.ts when the IIFE evaluates\n// inside the WebView.\n//\n// Responsibilities (Phase 1 + 2):\n// 1. Read window.CONFIG (must be inlined by AdvancedChartTemplate before this\n//    script runs).\n// 2. Seed core state with the symbol / resolution / theme from CONFIG.\n// 3. Wire the RN→WV bridge to the message dispatcher.\n// 4. Register Phase 1 + 2 message handlers:\n//      SET_THEME_COLORS (Phase 1), SET_OHLCV_DATA, REALTIME_UPDATE,\n//      SET_CHART_TYPE (Phase 2).\n// 5. Begin loading the TradingView library so it's ready when the first\n//    SET_OHLCV_DATA arrives.\n// 6. On first SET_OHLCV_DATA: createChartWidget with the default datafeed,\n//    apply visual overrides, attach crosshair + visible-range listeners.\n\nimport { onFromRN, postToRN, reportErrorToRN } from './bridge.js';\nimport { loadTradingViewLibrary } from './loadLibrary.js';\nimport { dispatchInboundMessage, registerHandler } from '../messages/handler.js';\nimport {\n  applyThemeColors,\n  flushPendingTheme,\n  initThemeFromConfig,\n} from '../widget/theme.js';\nimport { customDatafeed } from '../widget/datafeed.js';\nimport { advancedChartPriceFormatterFactory } from '../widget/priceFormatter.js';\nimport { getApproxBarDurationSec } from './timeUtils.js';\nimport {\n  handleRealtimeUpdate,\n  handleSetOHLCVData,\n  onFirstOhlcvData,\n} from '../widget/ohlcvIngestion.js';\nimport { handleSetChartType } from '../widget/chartType.js';\nimport { applyVisualOverrides } from '../widget/visualOverrides.js';\nimport {\n  createChartWidget,\n  scheduleChartLayoutSettledNotify,\n} from '../widget/initChart.js';\nimport {\n  attachCrosshairListener,\n  attachTapDismiss,\n} from '../interaction/crosshair.js';\nimport { attachVisibleRangeListeners } from '../interaction/visibleRange.js';\nimport { applyScaleLayout } from '../widget/scaleLayout.js';\nimport {\n  handleAddIndicator,\n  handleRemoveIndicator,\n  handleSetMAVisibility,\n} from '../features/indicators/index.js';\nimport { handleSetSubPaneLayout } from '../features/indicators/subPane.js';\nimport {\n  attachLegendResizeListener,\n  setupLegendOverlay,\n} from '../features/indicators/legend.js';\nimport {\n  handleToggleVolume,\n  registerVolumeThemeSync,\n} from '../features/volume/index.js';\nimport { registerTradeMarkerOverlay } from '../overlays/tradeMarkers/index.js';\nimport { registerTradeMarkerPulseHandler } from '../overlays/tradeMarkers/animation.js';\nimport { attachMarkerHitTest } from '../overlays/tradeMarkers/markerHitTest.js';\nimport { registerFocusTimeOverlay } from '../overlays/focusTime/index.js';\nimport { registerPositionLinesOverlay } from '../overlays/positionLines/index.js';\nimport { slbScheduleInitialCentering } from '../overlays/socialLeaderboard/index.js';\nimport { registerRnBackedPaginationHandler } from '../pagination/rnBacked.js';\nimport {\n  getOhlcvData,\n  getVisibleFromMs,\n  getVisibleToMs,\n  setSubPaneHeightRatio,\n} from './state.js';\nimport type { ChartConfig } from './types.js';\n\n/**\n * When RN passes an explicit visible-range start (e.g. a specific period like\n * 1D/1W/1M), build a `{ type: 'time-range', from, to }` timeframe so the\n * initial view snaps to that window instead of defaulting to `Date.now()`.\n * Padded by 2 bar durations so the last bar isn't glued to the right edge.\n * Ported from chartLogic.js initChart's `tfOption` computation (~line 5284).\n *\n * @returns A `time-range` timeframe pinned to the requested window, or\n * `undefined` when RN did not pass an explicit visible-range start.\n */\nfunction buildInitialTimeframe():\n  | { type: 'time-range'; from: number; to: number }\n  | undefined {\n  const visibleFromMs = getVisibleFromMs();\n  if (visibleFromMs === null) {return undefined;}\n  const visibleToMs = getVisibleToMs() ?? Date.now();\n  const initBarPadSec = getApproxBarDurationSec(getOhlcvData()) * 2;\n  return {\n    type: 'time-range',\n    from: Math.floor(visibleFromMs / 1000),\n    to: Math.ceil(visibleToMs / 1000) + initBarPadSec,\n  };\n}\n\nfunction readConfig(): ChartConfig {\n  const config = window.CONFIG;\n  if (!config) {\n    throw new Error(\n      'window.CONFIG is missing — AdvancedChartTemplate must inline ' +\n        'CONFIG before chartLogic runs.',\n    );\n  }\n  return config;\n}\n\n/**\n * Phase 1 + 2 bootstrap. Returns the resolved CONFIG so callers (and tests)\n * can inspect what booted. Idempotent on its inbound subscription — the\n * WebView is not expected to bootstrap twice.\n *\n * @returns The resolved chart configuration read from `window.CONFIG`.\n */\nexport function bootstrap(): ChartConfig {\n  const config = readConfig();\n\n  initThemeFromConfig(config.theme);\n  if (typeof config.subPaneHeightRatio === 'number') {\n    setSubPaneHeightRatio(config.subPaneHeightRatio);\n  }\n\n  registerHandler('SET_THEME_COLORS', (payload) => {\n    applyThemeColors(payload);\n  });\n  registerHandler('SET_OHLCV_DATA', (payload) => {\n    handleSetOHLCVData(payload);\n  });\n  registerHandler('REALTIME_UPDATE', (payload) => {\n    handleRealtimeUpdate(payload);\n  });\n  registerHandler('SET_CHART_TYPE', (payload) => {\n    handleSetChartType(payload);\n  });\n  registerHandler('ADD_INDICATOR', (payload) => {\n    handleAddIndicator(payload, config);\n  });\n  registerHandler('REMOVE_INDICATOR', (payload) => {\n    handleRemoveIndicator(payload);\n  });\n  registerHandler('SET_MA_VISIBILITY', (payload) => {\n    handleSetMAVisibility(payload, config);\n  });\n  registerHandler('TOGGLE_VOLUME', (payload) => {\n    handleToggleVolume(payload);\n  });\n  registerHandler('SET_SUB_PANE_LAYOUT', (payload) => {\n    handleSetSubPaneLayout(payload);\n  });\n\n  registerTradeMarkerOverlay();\n  registerTradeMarkerPulseHandler();\n  registerFocusTimeOverlay();\n  registerPositionLinesOverlay();\n  registerRnBackedPaginationHandler();\n  registerVolumeThemeSync();\n\n  onFromRN((message) => {\n    dispatchInboundMessage(message);\n  });\n\n  // Library load is fire-and-forget; the first-data handler awaits readiness\n  // again before constructing the widget, so this is purely a head-start.\n  loadTradingViewLibrary(config.libraryUrl).catch((error) => {\n    reportErrorToRN(error);\n  });\n\n  onFirstOhlcvData(() => {\n    loadTradingViewLibrary(config.libraryUrl)\n      .then(() => {\n        return createChartWidget(config, {\n          datafeed: customDatafeed,\n          customFormatters: {\n            priceFormatterFactory: advancedChartPriceFormatterFactory,\n          },\n          timeframe: buildInitialTimeframe(),\n          onReady: (widget) => {\n            try {\n              flushPendingTheme();\n              applyScaleLayout();\n              applyVisualOverrides(config.visualOverrides);\n              setupLegendOverlay(config.legendOverlay);\n              const chart = widget.activeChart();\n              // Match legacy onChartReady: when no explicit visible range\n              // was passed, pin a 2-bar gap on the right. TV's default is\n              // wider, leaving the chart visibly offset left.\n              if (getVisibleFromMs() === null) {\n                try {\n                  chart.getTimeScale().setRightOffset(2);\n                } catch (rightOffsetError) {\n                  reportErrorToRN(rightOffsetError);\n                }\n              }\n              attachCrosshairListener(chart);\n              attachTapDismiss(widget);\n              attachMarkerHitTest(widget, chart);\n              attachVisibleRangeListeners(chart);\n              chart\n                .selection()\n                .onChanged()\n                .subscribe(null, () => {\n                  chart.selection().clear();\n                });\n              attachLegendResizeListener(widget);\n              slbScheduleInitialCentering();\n              scheduleChartLayoutSettledNotify();\n            } catch (error) {\n              reportErrorToRN(error);\n            }\n          },\n        });\n      })\n      .catch((error) => {\n        reportErrorToRN(error);\n      });\n  });\n\n  postToRN('DEBUG', { message: 'modular-bootstrap-ready' });\n\n  return config;\n}\n"]}

package/dist/core/bridge.cjs

@@ -0,0 +1,115 @@
+"use strict";
+// Typed bridge between the WebView IIFE and React Native.
+//
+// Wraps the same window.ReactNativeWebView.postMessage(...) call shape that
+// legacy chartLogic.js's sendToReactNative() uses, so the RN-side
+// parseWebViewMessage in AdvancedChart.types.ts decodes our messages without
+// any change to its consumers.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onFromRN = exports.reportErrorToRN = exports.postToRN = exports.safeStringify = void 0;
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value) ?? 'Unknown error';
+    }
+    catch {
+        return String(value);
+    }
+}
+exports.safeStringify = safeStringify;
+/**
+ * Posts a typed message to React Native via window.ReactNativeWebView.
+ * Equivalent to legacy `sendToReactNative(type, payload)` at chartLogic.js
+ * line ~98. Silently no-ops when window.ReactNativeWebView is absent (e.g.
+ * during unit tests in a jsdom environment without the RN bridge stub).
+ *
+ * @param type - The outbound message type tag.
+ * @param payload - The payload associated with the message type.
+ */
+function postToRN(type, payload) {
+    const bridge = window.ReactNativeWebView;
+    if (!bridge) {
+        return;
+    }
+    try {
+        bridge.postMessage(JSON.stringify({ type, payload }));
+    }
+    catch {
+        // postMessage / JSON.stringify failure: nothing to do — the WebView
+        // cannot inform RN of its own bridge failure.
+    }
+}
+exports.postToRN = postToRN;
+/**
+ * Reports a runtime error to React Native via the ERROR channel. Matches the
+ * legacy `sendToReactNative('ERROR', { message })` pattern used throughout
+ * chartLogic.js.
+ *
+ * @param error - The error (or arbitrary thrown value) to report.
+ */
+function reportErrorToRN(error) {
+    let message;
+    if (error instanceof Error) {
+        message = error.message;
+    }
+    else if (typeof error === 'string') {
+        message = error;
+    }
+    else {
+        message = safeStringify(error);
+    }
+    postToRN('ERROR', { message });
+}
+exports.reportErrorToRN = reportErrorToRN;
+/**
+ * Registers a single inbound listener. React Native posts JSON strings via
+ * webView.postMessage; the WebView receives them on window 'message' on iOS
+ * and document 'message' on Android (see chartLogic.js line ~400). We
+ * subscribe to both so consumers don't have to.
+ *
+ * The returned function unsubscribes — useful for tests; the real bundle
+ * subscribes once at bootstrap and never unsubscribes.
+ *
+ * @param handler - Callback invoked with each well-formed inbound message.
+ * @returns A function that removes the registered listeners.
+ */
+function onFromRN(handler) {
+    const dispatch = (event) => {
+        // RN WebView inline HTML: native bridge messages arrive with an empty
+        // or "null" origin. Reject messages from real web origins.
+        const { origin } = event;
+        if (origin && origin !== 'null' && !origin.startsWith('file:')) {
+            return;
+        }
+        let parsed;
+        try {
+            parsed =
+                typeof event.data === 'string' ? JSON.parse(event.data) : event.data;
+        }
+        catch (parseError) {
+            reportErrorToRN(parseError);
+            return;
+        }
+        if (!parsed || typeof parsed !== 'object') {
+            return;
+        }
+        const candidate = parsed;
+        if (typeof candidate.type !== 'string') {
+            return;
+        }
+        // Trusting the type narrowing here is fine because messages/handler.ts
+        // re-validates via a switch on candidate.type before dispatching to a
+        // typed handler. Phase 1 only routes SET_THEME_COLORS, but the listener
+        // forwards every well-formed message so the handler can decide.
+        handler(parsed);
+    };
+    // iOS posts arrive on window; Android posts arrive on document. Subscribe
+    // to both to match legacy chartLogic.js handleMessage wiring.
+    window.addEventListener('message', dispatch);
+    document.addEventListener('message', dispatch);
+    return () => {
+        window.removeEventListener('message', dispatch);
+        document.removeEventListener('message', dispatch);
+    };
+}
+exports.onFromRN = onFromRN;
+//# sourceMappingURL=bridge.cjs.map

package/dist/core/bridge.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.cjs","sourceRoot":"","sources":["../../src/core/bridge.ts"],"names":[],"mappings":"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","sourcesContent":["// Typed bridge between the WebView IIFE and React Native.\n//\n// Wraps the same window.ReactNativeWebView.postMessage(...) call shape that\n// legacy chartLogic.js's sendToReactNative() uses, so the RN-side\n// parseWebViewMessage in AdvancedChart.types.ts decodes our messages without\n// any change to its consumers.\n\nimport type {\n  InboundMessage,\n  OutboundMessageType,\n  OutboundPayloads,\n} from '../messages/contract.js';\n\nexport function safeStringify(value: unknown): string {\n  try {\n    return JSON.stringify(value) ?? 'Unknown error';\n  } catch {\n    return String(value);\n  }\n}\n\n/**\n * Posts a typed message to React Native via window.ReactNativeWebView.\n * Equivalent to legacy `sendToReactNative(type, payload)` at chartLogic.js\n * line ~98. Silently no-ops when window.ReactNativeWebView is absent (e.g.\n * during unit tests in a jsdom environment without the RN bridge stub).\n *\n * @param type - The outbound message type tag.\n * @param payload - The payload associated with the message type.\n */\nexport function postToRN<Type extends OutboundMessageType>(\n  type: Type,\n  payload: OutboundPayloads[Type],\n): void {\n  const bridge = window.ReactNativeWebView;\n  if (!bridge) {\n    return;\n  }\n  try {\n    bridge.postMessage(JSON.stringify({ type, payload }));\n  } catch {\n    // postMessage / JSON.stringify failure: nothing to do — the WebView\n    // cannot inform RN of its own bridge failure.\n  }\n}\n\n/**\n * Reports a runtime error to React Native via the ERROR channel. Matches the\n * legacy `sendToReactNative('ERROR', { message })` pattern used throughout\n * chartLogic.js.\n *\n * @param error - The error (or arbitrary thrown value) to report.\n */\nexport function reportErrorToRN(error: unknown): void {\n  let message: string;\n  if (error instanceof Error) {\n    message = error.message;\n  } else if (typeof error === 'string') {\n    message = error;\n  } else {\n    message = safeStringify(error);\n  }\n  postToRN('ERROR', { message });\n}\n\nexport type InboundMessageHandler = (message: InboundMessage) => void;\n\n/**\n * Registers a single inbound listener. React Native posts JSON strings via\n * webView.postMessage; the WebView receives them on window 'message' on iOS\n * and document 'message' on Android (see chartLogic.js line ~400). We\n * subscribe to both so consumers don't have to.\n *\n * The returned function unsubscribes — useful for tests; the real bundle\n * subscribes once at bootstrap and never unsubscribes.\n *\n * @param handler - Callback invoked with each well-formed inbound message.\n * @returns A function that removes the registered listeners.\n */\nexport function onFromRN(handler: InboundMessageHandler): () => void {\n  const dispatch = (event: MessageEvent): void => {\n    // RN WebView inline HTML: native bridge messages arrive with an empty\n    // or \"null\" origin. Reject messages from real web origins.\n    const {origin} = event;\n    if (origin && origin !== 'null' && !origin.startsWith('file:')) {\n      return;\n    }\n\n    let parsed: unknown;\n    try {\n      parsed =\n        typeof event.data === 'string' ? JSON.parse(event.data) : event.data;\n    } catch (parseError) {\n      reportErrorToRN(parseError);\n      return;\n    }\n    if (!parsed || typeof parsed !== 'object') {\n      return;\n    }\n    const candidate = parsed as { type?: unknown };\n    if (typeof candidate.type !== 'string') {\n      return;\n    }\n    // Trusting the type narrowing here is fine because messages/handler.ts\n    // re-validates via a switch on candidate.type before dispatching to a\n    // typed handler. Phase 1 only routes SET_THEME_COLORS, but the listener\n    // forwards every well-formed message so the handler can decide.\n    handler(parsed as InboundMessage);\n  };\n\n  // iOS posts arrive on window; Android posts arrive on document. Subscribe\n  // to both to match legacy chartLogic.js handleMessage wiring.\n  window.addEventListener('message', dispatch as EventListener);\n  document.addEventListener('message', dispatch as EventListener);\n\n  return () => {\n    window.removeEventListener('message', dispatch as EventListener);\n    document.removeEventListener('message', dispatch as EventListener);\n  };\n}\n\n/** Re-export for callers that want the type tag union. */\nexport type { InboundMessageType } from '../messages/contract.js';\n"]}

package/dist/core/bridge.d.cts

@@ -0,0 +1,37 @@
+import type { InboundMessage, OutboundMessageType, OutboundPayloads } from "../messages/contract.cjs";
+export declare function safeStringify(value: unknown): string;
+/**
+ * Posts a typed message to React Native via window.ReactNativeWebView.
+ * Equivalent to legacy `sendToReactNative(type, payload)` at chartLogic.js
+ * line ~98. Silently no-ops when window.ReactNativeWebView is absent (e.g.
+ * during unit tests in a jsdom environment without the RN bridge stub).
+ *
+ * @param type - The outbound message type tag.
+ * @param payload - The payload associated with the message type.
+ */
+export declare function postToRN<Type extends OutboundMessageType>(type: Type, payload: OutboundPayloads[Type]): void;
+/**
+ * Reports a runtime error to React Native via the ERROR channel. Matches the
+ * legacy `sendToReactNative('ERROR', { message })` pattern used throughout
+ * chartLogic.js.
+ *
+ * @param error - The error (or arbitrary thrown value) to report.
+ */
+export declare function reportErrorToRN(error: unknown): void;
+export type InboundMessageHandler = (message: InboundMessage) => void;
+/**
+ * Registers a single inbound listener. React Native posts JSON strings via
+ * webView.postMessage; the WebView receives them on window 'message' on iOS
+ * and document 'message' on Android (see chartLogic.js line ~400). We
+ * subscribe to both so consumers don't have to.
+ *
+ * The returned function unsubscribes — useful for tests; the real bundle
+ * subscribes once at bootstrap and never unsubscribes.
+ *
+ * @param handler - Callback invoked with each well-formed inbound message.
+ * @returns A function that removes the registered listeners.
+ */
+export declare function onFromRN(handler: InboundMessageHandler): () => void;
+/** Re-export for callers that want the type tag union. */
+export type { InboundMessageType } from "../messages/contract.cjs";
+//# sourceMappingURL=bridge.d.cts.map

package/dist/core/bridge.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.cts","sourceRoot":"","sources":["../../src/core/bridge.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EACjB,iCAAgC;AAEjC,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,IAAI,SAAS,mBAAmB,EACvD,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,gBAAgB,CAAC,IAAI,CAAC,GAC9B,IAAI,CAWN;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAUpD;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAwCnE;AAED,0DAA0D;AAC1D,YAAY,EAAE,kBAAkB,EAAE,iCAAgC"}