@metamask-previews/advanced-chart-core 0.0.0-preview-e58fe0640 → 0.0.0-preview-238cb7063

package/dist/core/state.mjs

@@ -0,0 +1,283 @@
+// Module-local state container for the AdvancedChart WebView.
+//
+// Replaces the legacy `window.chartWidget`, `window.isChartReady`,
+// `window.currentSymbol`, etc. (chartLogic.js lines ~21-60). Module-scoped
+// variables — not window.* globals — so behaviour is testable and ownership
+// is explicit. Future phases extend this with the OHLCV slice, the indicator
+// slice, and so on; the convention is "core state goes here, feature-local
+// state goes in features/<feature>/state.ts or overlays/<feature>/state.ts".
+const emptyPagination = () => ({
+    nextCursor: null,
+    hasMore: false,
+    assetId: null,
+    vsCurrency: null,
+});
+const state = {
+    widget: null,
+    isChartReady: false,
+    currentSymbol: 'ASSET',
+    currentResolution: '5',
+    currentChartType: 2,
+    theme: null,
+    libraryLoaded: false,
+    libraryError: null,
+    ohlcvData: [],
+    ohlcvGeneration: 0,
+    ohlcvPagination: emptyPagination(),
+    visibleFromMs: null,
+    visibleToMs: null,
+    realtimeCallbacks: {},
+    activeStudies: new Map(),
+    maStudies: new Map(),
+    legendStudyOrder: new Map(),
+    volumeStudyId: null,
+    volumeIsOverlay: null,
+    subPaneHeightRatio: null,
+    rnBackedPagination: { enabled: false },
+    hasExplicitCurrentPriceLine: false,
+    hotReloadSeq: 0,
+    slbMode: false,
+    slbCenteringPending: false,
+    legendOwnsLayoutSettle: false,
+};
+// ----- Widget lifecycle ---------------------------------------------------
+export function getWidget() {
+    return state.widget;
+}
+export function setWidget(widget) {
+    state.widget = widget;
+}
+export function isChartReady() {
+    return state.isChartReady;
+}
+export function setChartReady(ready) {
+    state.isChartReady = ready;
+}
+// ----- Symbol + resolution ------------------------------------------------
+export function getCurrentSymbol() {
+    return state.currentSymbol;
+}
+export function setCurrentSymbol(symbol) {
+    state.currentSymbol = symbol;
+}
+export function getCurrentResolution() {
+    return state.currentResolution;
+}
+export function setCurrentResolution(resolution) {
+    state.currentResolution = resolution;
+}
+// ----- Theme --------------------------------------------------------------
+export function getTheme() {
+    return state.theme;
+}
+export function setTheme(theme) {
+    state.theme = theme;
+}
+// ----- Library load -------------------------------------------------------
+export function isLibraryLoaded() {
+    return state.libraryLoaded;
+}
+export function setLibraryLoaded(loaded) {
+    state.libraryLoaded = loaded;
+}
+export function getLibraryError() {
+    return state.libraryError;
+}
+export function setLibraryError(error) {
+    state.libraryError = error;
+}
+// ----- Chart type --------------------------------------------------------
+export function getCurrentChartType() {
+    return state.currentChartType;
+}
+export function setCurrentChartType(type) {
+    state.currentChartType = type;
+}
+// ----- OHLCV data --------------------------------------------------------
+export function getOhlcvData() {
+    return state.ohlcvData;
+}
+export function setOhlcvData(data) {
+    state.ohlcvData = data;
+}
+export function appendOrReplaceLastBar(bar) {
+    const data = state.ohlcvData;
+    const last = data.at(-1);
+    if (data.length > 0 && last?.time === bar.time) {
+        data[data.length - 1] = bar;
+    }
+    else {
+        data.push(bar);
+    }
+}
+export function prependOhlcvBars(bars) {
+    state.ohlcvData = bars.concat(state.ohlcvData);
+}
+export function getOhlcvGeneration() {
+    return state.ohlcvGeneration;
+}
+export function bumpOhlcvGeneration() {
+    state.ohlcvGeneration += 1;
+    return state.ohlcvGeneration;
+}
+export function getOhlcvPagination() {
+    return state.ohlcvPagination;
+}
+export function setOhlcvPagination(pagination) {
+    state.ohlcvPagination = pagination;
+}
+export function clearOhlcvPagination() {
+    state.ohlcvPagination = emptyPagination();
+}
+// ----- Visible range ------------------------------------------------------
+export function getVisibleFromMs() {
+    return state.visibleFromMs;
+}
+export function setVisibleFromMs(ms) {
+    state.visibleFromMs = ms;
+}
+export function getVisibleToMs() {
+    return state.visibleToMs;
+}
+export function setVisibleToMs(ms) {
+    state.visibleToMs = ms;
+}
+// ----- Realtime tick subscribers ------------------------------------------
+export function registerRealtimeCallback(listenerGuid, callback) {
+    state.realtimeCallbacks[listenerGuid] = callback;
+}
+export function unregisterRealtimeCallback(listenerGuid) {
+    delete state.realtimeCallbacks[listenerGuid];
+}
+export function getRealtimeCallbacks() {
+    return state.realtimeCallbacks;
+}
+// ----- Indicator studies --------------------------------------------------
+export function getActiveStudies() {
+    return state.activeStudies;
+}
+export function getMaStudies() {
+    return state.maStudies;
+}
+export function getLegendStudyOrder() {
+    return state.legendStudyOrder;
+}
+export function registerStudy(bucket, name, studyId) {
+    if (bucket === 'active') {
+        state.activeStudies.set(name, studyId);
+    }
+    else {
+        state.maStudies.set(name, studyId);
+    }
+    state.legendStudyOrder.set(name, studyId);
+}
+export function unregisterStudy(name) {
+    const fromActive = state.activeStudies.get(name);
+    const fromMA = state.maStudies.get(name);
+    state.activeStudies.delete(name);
+    state.maStudies.delete(name);
+    state.legendStudyOrder.delete(name);
+    return fromActive ?? fromMA;
+}
+// ----- Volume study -------------------------------------------------------
+export function getVolumeStudyId() {
+    return state.volumeStudyId;
+}
+export function setVolumeStudyId(id) {
+    state.volumeStudyId = id;
+    if (id) {
+        state.legendStudyOrder.set('Volume', id);
+    }
+    else {
+        state.legendStudyOrder.delete('Volume');
+    }
+}
+export function getVolumeIsOverlay() {
+    return state.volumeIsOverlay;
+}
+export function setVolumeIsOverlay(isOverlay) {
+    state.volumeIsOverlay = isOverlay;
+}
+// ----- Sub-pane height ratio ----------------------------------------------
+export function getSubPaneHeightRatio() {
+    return state.subPaneHeightRatio;
+}
+export function setSubPaneHeightRatio(ratio) {
+    state.subPaneHeightRatio = ratio;
+}
+// ----- RN-backed pagination --------------------------------------------------
+export function getRnBackedPagination() {
+    return state.rnBackedPagination;
+}
+export function setRnBackedPagination(config) {
+    state.rnBackedPagination = config;
+}
+// ----- Hot-reload sequence guards --------------------------------------------
+export function bumpHotReloadSeq() {
+    state.hotReloadSeq += 1;
+    return state.hotReloadSeq;
+}
+export function getHotReloadSeq() {
+    return state.hotReloadSeq;
+}
+// ----- SLB (Social Leaderboard) mode -----------------------------------------
+export function getSlbMode() {
+    return state.slbMode;
+}
+export function setSlbMode(enabled) {
+    state.slbMode = enabled;
+}
+export function isSlbCenteringPending() {
+    return state.slbCenteringPending;
+}
+export function setSlbCenteringPending(pending) {
+    state.slbCenteringPending = pending;
+}
+// ----- Legend owns layout settle ---------------------------------------------
+export function setLegendOwnsLayoutSettle(owns) {
+    state.legendOwnsLayoutSettle = owns;
+}
+export function doesLegendOwnLayoutSettle() {
+    return state.legendOwnsLayoutSettle;
+}
+// ----- Explicit current price line -------------------------------------------
+export function getHasExplicitCurrentPriceLine() {
+    return state.hasExplicitCurrentPriceLine;
+}
+export function setHasExplicitCurrentPriceLine(has) {
+    state.hasExplicitCurrentPriceLine = has;
+}
+/**
+ * Resets state to defaults — useful for unit tests. NOT for runtime use; the
+ * WebView is created fresh per mount (the RN side recreates the HTML when
+ * the theme or feature flags change).
+ */
+export function _resetStateForTests() {
+    state.widget = null;
+    state.isChartReady = false;
+    state.currentSymbol = 'ASSET';
+    state.currentResolution = '5';
+    state.currentChartType = 2;
+    state.theme = null;
+    state.libraryLoaded = false;
+    state.libraryError = null;
+    state.ohlcvData = [];
+    state.ohlcvGeneration = 0;
+    state.ohlcvPagination = emptyPagination();
+    state.visibleFromMs = null;
+    state.visibleToMs = null;
+    state.realtimeCallbacks = {};
+    state.activeStudies = new Map();
+    state.maStudies = new Map();
+    state.legendStudyOrder = new Map();
+    state.volumeStudyId = null;
+    state.volumeIsOverlay = null;
+    state.subPaneHeightRatio = null;
+    state.rnBackedPagination = { enabled: false };
+    state.hasExplicitCurrentPriceLine = false;
+    state.hotReloadSeq = 0;
+    state.slbMode = false;
+    state.slbCenteringPending = false;
+    state.legendOwnsLayoutSettle = false;
+}
+//# sourceMappingURL=state.mjs.map

package/dist/core/state.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.mjs","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"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","sourcesContent":["// Module-local state container for the AdvancedChart WebView.\n//\n// Replaces the legacy `window.chartWidget`, `window.isChartReady`,\n// `window.currentSymbol`, etc. (chartLogic.js lines ~21-60). Module-scoped\n// variables — not window.* globals — so behaviour is testable and ownership\n// is explicit. Future phases extend this with the OHLCV slice, the indicator\n// slice, and so on; the convention is \"core state goes here, feature-local\n// state goes in features/<feature>/state.ts or overlays/<feature>/state.ts\".\n\nimport type {\n  ChartTheme,\n  ChartType,\n  OHLCVBar,\n  OHLCVPaginationConfig,\n  RealtimeTickCallback,\n  StudyId,\n  TVChartingLibraryWidget,\n} from './types.js';\n\ntype CoreState = {\n  widget: TVChartingLibraryWidget | null;\n  isChartReady: boolean;\n  currentSymbol: string;\n  currentResolution: string;\n  currentChartType: ChartType;\n  theme: ChartTheme | null;\n  libraryLoaded: boolean;\n  libraryError: string | null;\n  ohlcvData: OHLCVBar[];\n  /** Bumped on every SET_OHLCV_DATA; stale async resolutions discard via this token. */\n  ohlcvGeneration: number;\n  ohlcvPagination: OHLCVPaginationConfig;\n  /** Visible-range bounds (ms) for the next setVisibleRange after reset; null = use TV default. */\n  visibleFromMs: number | null;\n  visibleToMs: number | null;\n  /** TradingView subscribeBars listenerGuid → tick callback (forwarded by REALTIME_UPDATE). */\n  realtimeCallbacks: Record<string, RealtimeTickCallback>;\n  /** Curated indicators (MACD, RSI, BOL, MA200) keyed by indicator name → studyId. */\n  activeStudies: Map<string, StudyId>;\n  /** MA visibility-driven studies (MA5/10/20/50/200) keyed by name → studyId. */\n  maStudies: Map<string, StudyId>;\n  /** Insertion order used to render legend pills consistently across renders. */\n  legendStudyOrder: Map<string, StudyId>;\n  volumeStudyId: StudyId | null;\n  /** null when no volume; tracks overlay vs sub-pane for toggle continuity. */\n  volumeIsOverlay: boolean | null;\n  /** Effective ratio in (0, 1] for sub-pane height; null = TV default. */\n  subPaneHeightRatio: number | null;\n  /** When enabled, getBars sends FETCH_OLDER_BARS_REQUEST to RN instead of Price API. */\n  rnBackedPagination: { enabled: boolean };\n  /** True when position lines include a currentPrice line; hides TV's native price line. */\n  hasExplicitCurrentPriceLine: boolean;\n  /** Sequence counter for setResolution callbacks; stale callbacks bail when mismatched. */\n  hotReloadSeq: number;\n  /** SLB scoping flag — activates Strategy C (bulk back-fill) pagination. */\n  slbMode: boolean;\n  /**\n   * Set to true when SLB data arrives and the viewport hasn't been\n   * centered yet. Cleared after the first successful setVisibleRange\n   * so re-centering only happens on a fresh SET_OHLCV_DATA.\n   */\n  slbCenteringPending: boolean;\n  /**\n   * When true, the legend module owns the CHART_LAYOUT_SETTLED signal.\n   * ohlcvIngestion skips its early 2-rAF-tick emit and lets the legend\n   * fire it after the first successful render post-reset.\n   */\n  legendOwnsLayoutSettle: boolean;\n};\n\nconst emptyPagination = (): OHLCVPaginationConfig => ({\n  nextCursor: null,\n  hasMore: false,\n  assetId: null,\n  vsCurrency: null,\n});\n\nconst state: CoreState = {\n  widget: null,\n  isChartReady: false,\n  currentSymbol: 'ASSET',\n  currentResolution: '5',\n  currentChartType: 2,\n  theme: null,\n  libraryLoaded: false,\n  libraryError: null,\n  ohlcvData: [],\n  ohlcvGeneration: 0,\n  ohlcvPagination: emptyPagination(),\n  visibleFromMs: null,\n  visibleToMs: null,\n  realtimeCallbacks: {},\n  activeStudies: new Map(),\n  maStudies: new Map(),\n  legendStudyOrder: new Map(),\n  volumeStudyId: null,\n  volumeIsOverlay: null,\n  subPaneHeightRatio: null,\n  rnBackedPagination: { enabled: false },\n  hasExplicitCurrentPriceLine: false,\n  hotReloadSeq: 0,\n  slbMode: false,\n  slbCenteringPending: false,\n  legendOwnsLayoutSettle: false,\n};\n\n// ----- Widget lifecycle ---------------------------------------------------\n\nexport function getWidget(): TVChartingLibraryWidget | null {\n  return state.widget;\n}\n\nexport function setWidget(widget: TVChartingLibraryWidget | null): void {\n  state.widget = widget;\n}\n\nexport function isChartReady(): boolean {\n  return state.isChartReady;\n}\n\nexport function setChartReady(ready: boolean): void {\n  state.isChartReady = ready;\n}\n\n// ----- Symbol + resolution ------------------------------------------------\n\nexport function getCurrentSymbol(): string {\n  return state.currentSymbol;\n}\n\nexport function setCurrentSymbol(symbol: string): void {\n  state.currentSymbol = symbol;\n}\n\nexport function getCurrentResolution(): string {\n  return state.currentResolution;\n}\n\nexport function setCurrentResolution(resolution: string): void {\n  state.currentResolution = resolution;\n}\n\n// ----- Theme --------------------------------------------------------------\n\nexport function getTheme(): ChartTheme | null {\n  return state.theme;\n}\n\nexport function setTheme(theme: ChartTheme): void {\n  state.theme = theme;\n}\n\n// ----- Library load -------------------------------------------------------\n\nexport function isLibraryLoaded(): boolean {\n  return state.libraryLoaded;\n}\n\nexport function setLibraryLoaded(loaded: boolean): void {\n  state.libraryLoaded = loaded;\n}\n\nexport function getLibraryError(): string | null {\n  return state.libraryError;\n}\n\nexport function setLibraryError(error: string | null): void {\n  state.libraryError = error;\n}\n\n// ----- Chart type --------------------------------------------------------\n\nexport function getCurrentChartType(): ChartType {\n  return state.currentChartType;\n}\n\nexport function setCurrentChartType(type: ChartType): void {\n  state.currentChartType = type;\n}\n\n// ----- OHLCV data --------------------------------------------------------\n\nexport function getOhlcvData(): OHLCVBar[] {\n  return state.ohlcvData;\n}\n\nexport function setOhlcvData(data: OHLCVBar[]): void {\n  state.ohlcvData = data;\n}\n\nexport function appendOrReplaceLastBar(bar: OHLCVBar): void {\n  const data = state.ohlcvData;\n  const last = data.at(-1);\n  if (data.length > 0 && last?.time === bar.time) {\n    data[data.length - 1] = bar;\n  } else {\n    data.push(bar);\n  }\n}\n\nexport function prependOhlcvBars(bars: OHLCVBar[]): void {\n  state.ohlcvData = bars.concat(state.ohlcvData);\n}\n\nexport function getOhlcvGeneration(): number {\n  return state.ohlcvGeneration;\n}\n\nexport function bumpOhlcvGeneration(): number {\n  state.ohlcvGeneration += 1;\n  return state.ohlcvGeneration;\n}\n\nexport function getOhlcvPagination(): OHLCVPaginationConfig {\n  return state.ohlcvPagination;\n}\n\nexport function setOhlcvPagination(pagination: OHLCVPaginationConfig): void {\n  state.ohlcvPagination = pagination;\n}\n\nexport function clearOhlcvPagination(): void {\n  state.ohlcvPagination = emptyPagination();\n}\n\n// ----- Visible range ------------------------------------------------------\n\nexport function getVisibleFromMs(): number | null {\n  return state.visibleFromMs;\n}\n\nexport function setVisibleFromMs(ms: number | null): void {\n  state.visibleFromMs = ms;\n}\n\nexport function getVisibleToMs(): number | null {\n  return state.visibleToMs;\n}\n\nexport function setVisibleToMs(ms: number | null): void {\n  state.visibleToMs = ms;\n}\n\n// ----- Realtime tick subscribers ------------------------------------------\n\nexport function registerRealtimeCallback(\n  listenerGuid: string,\n  callback: RealtimeTickCallback,\n): void {\n  state.realtimeCallbacks[listenerGuid] = callback;\n}\n\nexport function unregisterRealtimeCallback(listenerGuid: string): void {\n  delete state.realtimeCallbacks[listenerGuid];\n}\n\nexport function getRealtimeCallbacks(): Record<string, RealtimeTickCallback> {\n  return state.realtimeCallbacks;\n}\n\n// ----- Indicator studies --------------------------------------------------\n\nexport function getActiveStudies(): Map<string, StudyId> {\n  return state.activeStudies;\n}\n\nexport function getMaStudies(): Map<string, StudyId> {\n  return state.maStudies;\n}\n\nexport function getLegendStudyOrder(): Map<string, StudyId> {\n  return state.legendStudyOrder;\n}\n\nexport function registerStudy(\n  bucket: 'active' | 'ma',\n  name: string,\n  studyId: StudyId,\n): void {\n  if (bucket === 'active') {\n    state.activeStudies.set(name, studyId);\n  } else {\n    state.maStudies.set(name, studyId);\n  }\n  state.legendStudyOrder.set(name, studyId);\n}\n\nexport function unregisterStudy(name: string): StudyId | undefined {\n  const fromActive = state.activeStudies.get(name);\n  const fromMA = state.maStudies.get(name);\n  state.activeStudies.delete(name);\n  state.maStudies.delete(name);\n  state.legendStudyOrder.delete(name);\n  return fromActive ?? fromMA;\n}\n\n// ----- Volume study -------------------------------------------------------\n\nexport function getVolumeStudyId(): StudyId | null {\n  return state.volumeStudyId;\n}\n\nexport function setVolumeStudyId(id: StudyId | null): void {\n  state.volumeStudyId = id;\n  if (id) {\n    state.legendStudyOrder.set('Volume', id);\n  } else {\n    state.legendStudyOrder.delete('Volume');\n  }\n}\n\nexport function getVolumeIsOverlay(): boolean | null {\n  return state.volumeIsOverlay;\n}\n\nexport function setVolumeIsOverlay(isOverlay: boolean | null): void {\n  state.volumeIsOverlay = isOverlay;\n}\n\n// ----- Sub-pane height ratio ----------------------------------------------\n\nexport function getSubPaneHeightRatio(): number | null {\n  return state.subPaneHeightRatio;\n}\n\nexport function setSubPaneHeightRatio(ratio: number | null): void {\n  state.subPaneHeightRatio = ratio;\n}\n\n// ----- RN-backed pagination --------------------------------------------------\n\nexport function getRnBackedPagination(): { enabled: boolean } {\n  return state.rnBackedPagination;\n}\n\nexport function setRnBackedPagination(config: { enabled: boolean }): void {\n  state.rnBackedPagination = config;\n}\n\n// ----- Hot-reload sequence guards --------------------------------------------\n\nexport function bumpHotReloadSeq(): number {\n  state.hotReloadSeq += 1;\n  return state.hotReloadSeq;\n}\n\nexport function getHotReloadSeq(): number {\n  return state.hotReloadSeq;\n}\n\n// ----- SLB (Social Leaderboard) mode -----------------------------------------\n\nexport function getSlbMode(): boolean {\n  return state.slbMode;\n}\n\nexport function setSlbMode(enabled: boolean): void {\n  state.slbMode = enabled;\n}\n\nexport function isSlbCenteringPending(): boolean {\n  return state.slbCenteringPending;\n}\n\nexport function setSlbCenteringPending(pending: boolean): void {\n  state.slbCenteringPending = pending;\n}\n\n// ----- Legend owns layout settle ---------------------------------------------\n\nexport function setLegendOwnsLayoutSettle(owns: boolean): void {\n  state.legendOwnsLayoutSettle = owns;\n}\n\nexport function doesLegendOwnLayoutSettle(): boolean {\n  return state.legendOwnsLayoutSettle;\n}\n\n// ----- Explicit current price line -------------------------------------------\n\nexport function getHasExplicitCurrentPriceLine(): boolean {\n  return state.hasExplicitCurrentPriceLine;\n}\n\nexport function setHasExplicitCurrentPriceLine(has: boolean): void {\n  state.hasExplicitCurrentPriceLine = has;\n}\n\n/**\n * Resets state to defaults — useful for unit tests. NOT for runtime use; the\n * WebView is created fresh per mount (the RN side recreates the HTML when\n * the theme or feature flags change).\n */\nexport function _resetStateForTests(): void {\n  state.widget = null;\n  state.isChartReady = false;\n  state.currentSymbol = 'ASSET';\n  state.currentResolution = '5';\n  state.currentChartType = 2;\n  state.theme = null;\n  state.libraryLoaded = false;\n  state.libraryError = null;\n  state.ohlcvData = [];\n  state.ohlcvGeneration = 0;\n  state.ohlcvPagination = emptyPagination();\n  state.visibleFromMs = null;\n  state.visibleToMs = null;\n  state.realtimeCallbacks = {};\n  state.activeStudies = new Map();\n  state.maStudies = new Map();\n  state.legendStudyOrder = new Map();\n  state.volumeStudyId = null;\n  state.volumeIsOverlay = null;\n  state.subPaneHeightRatio = null;\n  state.rnBackedPagination = { enabled: false };\n  state.hasExplicitCurrentPriceLine = false;\n  state.hotReloadSeq = 0;\n  state.slbMode = false;\n  state.slbCenteringPending = false;\n  state.legendOwnsLayoutSettle = false;\n}\n"]}

package/dist/core/timeUtils.cjs

@@ -0,0 +1,72 @@
+"use strict";
+// Time normalization helpers used across modules.
+//
+// Ported from chartLogic.js: normalizeChartUnixSec (line ~3564),
+// chartRawTimeToUnixMs (line ~3573), getApproxBarDurationSec (line ~3587).
+// Phase 2's widget/ohlcvIngestion.ts and pagination/priceApi.ts consume
+// these.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getApproxBarDurationSec = exports.chartRawTimeToUnixMs = exports.normalizeChartUnixSec = void 0;
+/**
+ * Convert a timestamp to unix seconds, accepting either ms or seconds.
+ * Values ≥ 1e12 are treated as milliseconds (~Sep 2001 in seconds; safe
+ * threshold). Returns null for non-finite input.
+ *
+ * @param value - A timestamp in seconds or milliseconds.
+ * @returns The timestamp in unix seconds, or null when non-finite.
+ */
+function normalizeChartUnixSec(value) {
+    const numericValue = Number(value);
+    if (!Number.isFinite(numericValue)) {
+        return null;
+    }
+    return numericValue >= 1e12
+        ? Math.floor(numericValue / 1000)
+        : Math.floor(numericValue);
+}
+exports.normalizeChartUnixSec = normalizeChartUnixSec;
+/**
+ * Convert a raw TradingView timestamp to unix milliseconds. Unlike
+ * normalizeChartUnixSec, keeps sub-second precision when the input is already
+ * in seconds (multiplies by 1000 instead of flooring).
+ *
+ * @param value - A raw TradingView timestamp in seconds or milliseconds.
+ * @returns The timestamp in unix milliseconds, or null when non-finite.
+ */
+function chartRawTimeToUnixMs(value) {
+    const numericValue = Number(value);
+    if (!Number.isFinite(numericValue)) {
+        return null;
+    }
+    if (numericValue >= 1e12) {
+        return numericValue;
+    }
+    return numericValue * 1000;
+}
+exports.chartRawTimeToUnixMs = chartRawTimeToUnixMs;
+const DEFAULT_BAR_DURATION_SEC = 300;
+const MIN_BAR_DURATION_SEC = 60;
+/**
+ * Approximates the bar duration (seconds) for a series of OHLCV bars by
+ * measuring the gap between the last two points. Used for visible-range
+ * alignment and end-icon insets.
+ *
+ * Returns a sensible default when the series is too short.
+ *
+ * @param bars - The OHLCV bar series to measure.
+ * @returns The approximate bar duration in seconds.
+ */
+function getApproxBarDurationSec(bars) {
+    if (!bars || bars.length < 2) {
+        return DEFAULT_BAR_DURATION_SEC;
+    }
+    const prev = bars.at(-2);
+    const last = bars.at(-1);
+    if (!prev || !last) {
+        return DEFAULT_BAR_DURATION_SEC;
+    }
+    const lastMs = Math.abs(last.time - prev.time);
+    return Math.max(MIN_BAR_DURATION_SEC, Math.round(lastMs / 1000));
+}
+exports.getApproxBarDurationSec = getApproxBarDurationSec;
+//# sourceMappingURL=timeUtils.cjs.map

package/dist/core/timeUtils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeUtils.cjs","sourceRoot":"","sources":["../../src/core/timeUtils.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,EAAE;AACF,iEAAiE;AACjE,2EAA2E;AAC3E,wEAAwE;AACxE,SAAS;;;AAET;;;;;;;GAOG;AACH,SAAgB,qBAAqB,CAAC,KAAc;IAClD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,YAAY,IAAI,IAAI;QACzB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;QACjC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AAC/B,CAAC;AARD,sDAQC;AAED;;;;;;;GAOG;AACH,SAAgB,oBAAoB,CAAC,KAAc;IACjD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;QACzB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,YAAY,GAAG,IAAI,CAAC;AAC7B,CAAC;AATD,oDASC;AAED,MAAM,wBAAwB,GAAG,GAAG,CAAC;AACrC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC;;;;;;;;;GASG;AACH,SAAgB,uBAAuB,CACrC,IAAiC;IAEjC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,wBAAwB,CAAC;IAClC,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO,wBAAwB,CAAC;IAClC,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;AACnE,CAAC;AAbD,0DAaC","sourcesContent":["// Time normalization helpers used across modules.\n//\n// Ported from chartLogic.js: normalizeChartUnixSec (line ~3564),\n// chartRawTimeToUnixMs (line ~3573), getApproxBarDurationSec (line ~3587).\n// Phase 2's widget/ohlcvIngestion.ts and pagination/priceApi.ts consume\n// these.\n\n/**\n * Convert a timestamp to unix seconds, accepting either ms or seconds.\n * Values ≥ 1e12 are treated as milliseconds (~Sep 2001 in seconds; safe\n * threshold). Returns null for non-finite input.\n *\n * @param value - A timestamp in seconds or milliseconds.\n * @returns The timestamp in unix seconds, or null when non-finite.\n */\nexport function normalizeChartUnixSec(value: unknown): number | null {\n  const numericValue = Number(value);\n  if (!Number.isFinite(numericValue)) {\n    return null;\n  }\n  return numericValue >= 1e12\n    ? Math.floor(numericValue / 1000)\n    : Math.floor(numericValue);\n}\n\n/**\n * Convert a raw TradingView timestamp to unix milliseconds. Unlike\n * normalizeChartUnixSec, keeps sub-second precision when the input is already\n * in seconds (multiplies by 1000 instead of flooring).\n *\n * @param value - A raw TradingView timestamp in seconds or milliseconds.\n * @returns The timestamp in unix milliseconds, or null when non-finite.\n */\nexport function chartRawTimeToUnixMs(value: unknown): number | null {\n  const numericValue = Number(value);\n  if (!Number.isFinite(numericValue)) {\n    return null;\n  }\n  if (numericValue >= 1e12) {\n    return numericValue;\n  }\n  return numericValue * 1000;\n}\n\nconst DEFAULT_BAR_DURATION_SEC = 300;\nconst MIN_BAR_DURATION_SEC = 60;\n\n/**\n * Approximates the bar duration (seconds) for a series of OHLCV bars by\n * measuring the gap between the last two points. Used for visible-range\n * alignment and end-icon insets.\n *\n * Returns a sensible default when the series is too short.\n *\n * @param bars - The OHLCV bar series to measure.\n * @returns The approximate bar duration in seconds.\n */\nexport function getApproxBarDurationSec(\n  bars: readonly { time: number }[],\n): number {\n  if (!bars || bars.length < 2) {\n    return DEFAULT_BAR_DURATION_SEC;\n  }\n  const prev = bars.at(-2);\n  const last = bars.at(-1);\n  if (!prev || !last) {\n    return DEFAULT_BAR_DURATION_SEC;\n  }\n  const lastMs = Math.abs(last.time - prev.time);\n  return Math.max(MIN_BAR_DURATION_SEC, Math.round(lastMs / 1000));\n}\n"]}

package/dist/core/timeUtils.d.cts

@@ -0,0 +1,32 @@
+/**
+ * Convert a timestamp to unix seconds, accepting either ms or seconds.
+ * Values ≥ 1e12 are treated as milliseconds (~Sep 2001 in seconds; safe
+ * threshold). Returns null for non-finite input.
+ *
+ * @param value - A timestamp in seconds or milliseconds.
+ * @returns The timestamp in unix seconds, or null when non-finite.
+ */
+export declare function normalizeChartUnixSec(value: unknown): number | null;
+/**
+ * Convert a raw TradingView timestamp to unix milliseconds. Unlike
+ * normalizeChartUnixSec, keeps sub-second precision when the input is already
+ * in seconds (multiplies by 1000 instead of flooring).
+ *
+ * @param value - A raw TradingView timestamp in seconds or milliseconds.
+ * @returns The timestamp in unix milliseconds, or null when non-finite.
+ */
+export declare function chartRawTimeToUnixMs(value: unknown): number | null;
+/**
+ * Approximates the bar duration (seconds) for a series of OHLCV bars by
+ * measuring the gap between the last two points. Used for visible-range
+ * alignment and end-icon insets.
+ *
+ * Returns a sensible default when the series is too short.
+ *
+ * @param bars - The OHLCV bar series to measure.
+ * @returns The approximate bar duration in seconds.
+ */
+export declare function getApproxBarDurationSec(bars: readonly {
+    time: number;
+}[]): number;
+//# sourceMappingURL=timeUtils.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeUtils.d.cts","sourceRoot":"","sources":["../../src/core/timeUtils.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQnE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CASlE;AAKD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAChC,MAAM,CAWR"}

package/dist/core/timeUtils.d.mts

@@ -0,0 +1,32 @@
+/**
+ * Convert a timestamp to unix seconds, accepting either ms or seconds.
+ * Values ≥ 1e12 are treated as milliseconds (~Sep 2001 in seconds; safe
+ * threshold). Returns null for non-finite input.
+ *
+ * @param value - A timestamp in seconds or milliseconds.
+ * @returns The timestamp in unix seconds, or null when non-finite.
+ */
+export declare function normalizeChartUnixSec(value: unknown): number | null;
+/**
+ * Convert a raw TradingView timestamp to unix milliseconds. Unlike
+ * normalizeChartUnixSec, keeps sub-second precision when the input is already
+ * in seconds (multiplies by 1000 instead of flooring).
+ *
+ * @param value - A raw TradingView timestamp in seconds or milliseconds.
+ * @returns The timestamp in unix milliseconds, or null when non-finite.
+ */
+export declare function chartRawTimeToUnixMs(value: unknown): number | null;
+/**
+ * Approximates the bar duration (seconds) for a series of OHLCV bars by
+ * measuring the gap between the last two points. Used for visible-range
+ * alignment and end-icon insets.
+ *
+ * Returns a sensible default when the series is too short.
+ *
+ * @param bars - The OHLCV bar series to measure.
+ * @returns The approximate bar duration in seconds.
+ */
+export declare function getApproxBarDurationSec(bars: readonly {
+    time: number;
+}[]): number;
+//# sourceMappingURL=timeUtils.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeUtils.d.mts","sourceRoot":"","sources":["../../src/core/timeUtils.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQnE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CASlE;AAKD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAChC,MAAM,CAWR"}

package/dist/core/timeUtils.mjs

@@ -0,0 +1,66 @@
+// Time normalization helpers used across modules.
+//
+// Ported from chartLogic.js: normalizeChartUnixSec (line ~3564),
+// chartRawTimeToUnixMs (line ~3573), getApproxBarDurationSec (line ~3587).
+// Phase 2's widget/ohlcvIngestion.ts and pagination/priceApi.ts consume
+// these.
+/**
+ * Convert a timestamp to unix seconds, accepting either ms or seconds.
+ * Values ≥ 1e12 are treated as milliseconds (~Sep 2001 in seconds; safe
+ * threshold). Returns null for non-finite input.
+ *
+ * @param value - A timestamp in seconds or milliseconds.
+ * @returns The timestamp in unix seconds, or null when non-finite.
+ */
+export function normalizeChartUnixSec(value) {
+    const numericValue = Number(value);
+    if (!Number.isFinite(numericValue)) {
+        return null;
+    }
+    return numericValue >= 1e12
+        ? Math.floor(numericValue / 1000)
+        : Math.floor(numericValue);
+}
+/**
+ * Convert a raw TradingView timestamp to unix milliseconds. Unlike
+ * normalizeChartUnixSec, keeps sub-second precision when the input is already
+ * in seconds (multiplies by 1000 instead of flooring).
+ *
+ * @param value - A raw TradingView timestamp in seconds or milliseconds.
+ * @returns The timestamp in unix milliseconds, or null when non-finite.
+ */
+export function chartRawTimeToUnixMs(value) {
+    const numericValue = Number(value);
+    if (!Number.isFinite(numericValue)) {
+        return null;
+    }
+    if (numericValue >= 1e12) {
+        return numericValue;
+    }
+    return numericValue * 1000;
+}
+const DEFAULT_BAR_DURATION_SEC = 300;
+const MIN_BAR_DURATION_SEC = 60;
+/**
+ * Approximates the bar duration (seconds) for a series of OHLCV bars by
+ * measuring the gap between the last two points. Used for visible-range
+ * alignment and end-icon insets.
+ *
+ * Returns a sensible default when the series is too short.
+ *
+ * @param bars - The OHLCV bar series to measure.
+ * @returns The approximate bar duration in seconds.
+ */
+export function getApproxBarDurationSec(bars) {
+    if (!bars || bars.length < 2) {
+        return DEFAULT_BAR_DURATION_SEC;
+    }
+    const prev = bars.at(-2);
+    const last = bars.at(-1);
+    if (!prev || !last) {
+        return DEFAULT_BAR_DURATION_SEC;
+    }
+    const lastMs = Math.abs(last.time - prev.time);
+    return Math.max(MIN_BAR_DURATION_SEC, Math.round(lastMs / 1000));
+}
+//# sourceMappingURL=timeUtils.mjs.map

package/dist/core/timeUtils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeUtils.mjs","sourceRoot":"","sources":["../../src/core/timeUtils.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,iEAAiE;AACjE,2EAA2E;AAC3E,wEAAwE;AACxE,SAAS;AAET;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,YAAY,IAAI,IAAI;QACzB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;QACjC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;QACzB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,YAAY,GAAG,IAAI,CAAC;AAC7B,CAAC;AAED,MAAM,wBAAwB,GAAG,GAAG,CAAC;AACrC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAiC;IAEjC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,wBAAwB,CAAC;IAClC,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO,wBAAwB,CAAC;IAClC,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;AACnE,CAAC","sourcesContent":["// Time normalization helpers used across modules.\n//\n// Ported from chartLogic.js: normalizeChartUnixSec (line ~3564),\n// chartRawTimeToUnixMs (line ~3573), getApproxBarDurationSec (line ~3587).\n// Phase 2's widget/ohlcvIngestion.ts and pagination/priceApi.ts consume\n// these.\n\n/**\n * Convert a timestamp to unix seconds, accepting either ms or seconds.\n * Values ≥ 1e12 are treated as milliseconds (~Sep 2001 in seconds; safe\n * threshold). Returns null for non-finite input.\n *\n * @param value - A timestamp in seconds or milliseconds.\n * @returns The timestamp in unix seconds, or null when non-finite.\n */\nexport function normalizeChartUnixSec(value: unknown): number | null {\n  const numericValue = Number(value);\n  if (!Number.isFinite(numericValue)) {\n    return null;\n  }\n  return numericValue >= 1e12\n    ? Math.floor(numericValue / 1000)\n    : Math.floor(numericValue);\n}\n\n/**\n * Convert a raw TradingView timestamp to unix milliseconds. Unlike\n * normalizeChartUnixSec, keeps sub-second precision when the input is already\n * in seconds (multiplies by 1000 instead of flooring).\n *\n * @param value - A raw TradingView timestamp in seconds or milliseconds.\n * @returns The timestamp in unix milliseconds, or null when non-finite.\n */\nexport function chartRawTimeToUnixMs(value: unknown): number | null {\n  const numericValue = Number(value);\n  if (!Number.isFinite(numericValue)) {\n    return null;\n  }\n  if (numericValue >= 1e12) {\n    return numericValue;\n  }\n  return numericValue * 1000;\n}\n\nconst DEFAULT_BAR_DURATION_SEC = 300;\nconst MIN_BAR_DURATION_SEC = 60;\n\n/**\n * Approximates the bar duration (seconds) for a series of OHLCV bars by\n * measuring the gap between the last two points. Used for visible-range\n * alignment and end-icon insets.\n *\n * Returns a sensible default when the series is too short.\n *\n * @param bars - The OHLCV bar series to measure.\n * @returns The approximate bar duration in seconds.\n */\nexport function getApproxBarDurationSec(\n  bars: readonly { time: number }[],\n): number {\n  if (!bars || bars.length < 2) {\n    return DEFAULT_BAR_DURATION_SEC;\n  }\n  const prev = bars.at(-2);\n  const last = bars.at(-1);\n  if (!prev || !last) {\n    return DEFAULT_BAR_DURATION_SEC;\n  }\n  const lastMs = Math.abs(last.time - prev.time);\n  return Math.max(MIN_BAR_DURATION_SEC, Math.round(lastMs / 1000));\n}\n"]}