@metamask-previews/perps-controller 0.0.0-preview-685dbf46b → 1.0.0-preview-bc00f2c

package/dist/aggregation/SubscriptionMultiplexer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionMultiplexer.mjs","sourceRoot":"","sources":["../../src/aggregation/SubscriptionMultiplexer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SubscriptionMultiplexer - Manages WebSocket subscriptions across multiple providers\n *\n * Responsibilities:\n * - Manage subscriptions to multiple providers simultaneously\n * - Tag all updates with providerId so UI can differentiate sources\n * - Support aggregation modes: 'merge' (all prices) or 'best_price' (best price per symbol)\n * - Cache latest updates per provider per symbol for aggregation\n */\n\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig';\nimport type {\n  PerpsProviderType,\n  PerpsProvider,\n  PerpsLogger,\n  PriceUpdate,\n  Position,\n  OrderFill,\n  Order,\n  AccountState,\n  SubscribePricesParams,\n  SubscribePositionsParams,\n  SubscribeOrderFillsParams,\n  SubscribeOrdersParams,\n  SubscribeAccountParams,\n} from '../types';\nimport { ensureError } from '../utils/errorUtils';\n\n/**\n * Options for constructing SubscriptionMultiplexer\n */\nexport type SubscriptionMultiplexerOptions = {\n  /** Optional logger for error reporting (e.g., Sentry) */\n  logger?: PerpsLogger;\n};\n\n/**\n * Aggregation mode for price subscriptions\n */\nexport type PriceAggregationMode = 'merge' | 'best_price';\n\n/**\n * Parameters for multiplexed price subscriptions\n */\nexport type MultiplexedPricesParams = {\n  /** Symbols to subscribe to */\n  symbols: string[];\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated price updates */\n  callback: (prices: PriceUpdate[]) => void;\n  /** Aggregation mode: 'merge' returns all prices, 'best_price' returns best per symbol */\n  aggregationMode?: PriceAggregationMode;\n  /** Optional throttle in milliseconds */\n  throttleMs?: number;\n  /** Include order book data */\n  includeOrderBook?: boolean;\n  /** Include market data (funding, OI, volume) */\n  includeMarketData?: boolean;\n};\n\n/**\n * Parameters for multiplexed position subscriptions\n */\nexport type MultiplexedPositionsParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated position updates */\n  callback: (positions: Position[]) => void;\n};\n\n/**\n * Parameters for multiplexed order fill subscriptions\n */\nexport type MultiplexedOrderFillsParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated order fill updates */\n  callback: (fills: OrderFill[], isSnapshot?: boolean) => void;\n};\n\n/**\n * Parameters for multiplexed order subscriptions\n */\nexport type MultiplexedOrdersParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive aggregated order updates */\n  callback: (orders: Order[]) => void;\n};\n\n/**\n * Parameters for multiplexed account subscriptions\n */\nexport type MultiplexedAccountParams = {\n  /** Provider instances to subscribe through */\n  providers: [PerpsProviderType, PerpsProvider][];\n  /** Callback to receive account updates (one per provider) */\n  callback: (accounts: AccountState[]) => void;\n};\n\n/**\n * SubscriptionMultiplexer manages real-time data subscriptions across\n * multiple perps providers.\n *\n * Key features:\n * - Subscribes to all providers simultaneously\n * - Tags all updates with source providerId\n * - Caches latest values for aggregation\n * - Supports different aggregation modes for prices\n *\n * @example\n * ```typescript\n * const mux = new SubscriptionMultiplexer();\n *\n * const unsubscribe = mux.subscribeToPrices({\n *   symbols: ['BTC', 'ETH'],\n *   providers: [\n *     ['hyperliquid', hlProvider],\n *     ['myx', myxProvider],\n *   ],\n *   callback: (prices) => {\n *     // prices have providerId injected\n *     prices.forEach(p => console.log(`${p.providerId}: ${p.symbol} = ${p.price}`));\n *   },\n *   aggregationMode: 'merge',\n * });\n *\n * // Later: clean up\n * unsubscribe();\n * ```\n */\nexport class SubscriptionMultiplexer {\n  /**\n   * Optional logger for error reporting\n   */\n  readonly #logger?: PerpsLogger;\n\n  /**\n   * Cache of latest prices per symbol per provider\n   * Map<symbol, Map<providerId, PriceUpdate>>\n   */\n  readonly #priceCache: Map<string, Map<PerpsProviderType, PriceUpdate>> =\n    new Map();\n\n  /**\n   * Cache of latest positions per provider\n   * Map<providerId, Position[]>\n   */\n  readonly #positionCache: Map<PerpsProviderType, Position[]> = new Map();\n\n  /**\n   * Cache of latest orders per provider\n   * Map<providerId, Order[]>\n   */\n  readonly #orderCache: Map<PerpsProviderType, Order[]> = new Map();\n\n  /**\n   * Cache of latest account state per provider\n   * Map<providerId, AccountState>\n   */\n  readonly #accountCache: Map<PerpsProviderType, AccountState> = new Map();\n\n  /**\n   * Create a new SubscriptionMultiplexer.\n   *\n   * @param options - Optional configuration including logger for error reporting\n   */\n  constructor(options?: SubscriptionMultiplexerOptions) {\n    this.#logger = options?.logger;\n  }\n\n  /**\n   * Subscribe to price updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToPrices(params: MultiplexedPricesParams): () => void {\n    const {\n      symbols,\n      providers,\n      callback,\n      aggregationMode = 'merge',\n      throttleMs,\n      includeOrderBook,\n      includeMarketData,\n    } = params;\n\n    const unsubscribers: (() => void)[] = [];\n\n    // Subscribe to each provider with defensive error handling\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribePricesParams = {\n          symbols,\n          callback: (updates) => {\n            // Tag and cache each update\n            updates.forEach((update) => {\n              const taggedUpdate: PriceUpdate = { ...update, providerId };\n\n              // Initialize symbol cache if needed\n              if (!this.#priceCache.has(update.symbol)) {\n                this.#priceCache.set(update.symbol, new Map());\n              }\n              const symbolCache = this.#priceCache.get(update.symbol);\n              if (symbolCache) {\n                symbolCache.set(providerId, taggedUpdate);\n              }\n            });\n\n            // Aggregate and emit based on mode\n            const aggregated = this.#aggregatePrices(symbols, aggregationMode);\n            callback(aggregated);\n          },\n          throttleMs,\n          includeOrderBook,\n          includeMarketData,\n        };\n\n        const unsub = provider.subscribeToPrices(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        // Log to Sentry before cleanup\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToPrices'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToPrices',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n\n        // Clean up any subscriptions created before the failure\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    // Return combined unsubscribe function\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      // Optionally clear cache for these symbols\n      symbols.forEach((symbol) => {\n        this.#priceCache.delete(symbol);\n      });\n    };\n  }\n\n  /**\n   * Subscribe to position updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToPositions(params: MultiplexedPositionsParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribePositionsParams = {\n          callback: (positions) => {\n            // Tag positions with providerId and cache\n            const taggedPositions = positions.map((pos) => ({\n              ...pos,\n              providerId,\n            }));\n            this.#positionCache.set(providerId, taggedPositions);\n\n            // Emit aggregated positions from all providers\n            const allPositions = this.#aggregatePositions();\n            callback(allPositions);\n          },\n        };\n\n        const unsub = provider.subscribeToPositions(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToPositions'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToPositions',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      // Clear position cache for these providers\n      providers.forEach(([providerId]) => {\n        this.#positionCache.delete(providerId);\n      });\n    };\n  }\n\n  /**\n   * Subscribe to order fill updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToOrderFills(params: MultiplexedOrderFillsParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribeOrderFillsParams = {\n          callback: (fills, isSnapshot) => {\n            // Tag fills with providerId\n            const taggedFills = fills.map((fill) => ({\n              ...fill,\n              providerId,\n            }));\n\n            // For fills, we don't aggregate - emit immediately with tags\n            callback(taggedFills, isSnapshot);\n          },\n        };\n\n        const unsub = provider.subscribeToOrderFills(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToOrderFills'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToOrderFills',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n    };\n  }\n\n  /**\n   * Subscribe to order updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToOrders(params: MultiplexedOrdersParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribeOrdersParams = {\n          callback: (orders) => {\n            // Tag orders with providerId and cache\n            const taggedOrders = orders.map((order) => ({\n              ...order,\n              providerId,\n            }));\n            this.#orderCache.set(providerId, taggedOrders);\n\n            // Emit aggregated orders from all providers\n            const allOrders = this.#aggregateOrders();\n            callback(allOrders);\n          },\n        };\n\n        const unsub = provider.subscribeToOrders(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToOrders'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToOrders',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      providers.forEach(([providerId]) => {\n        this.#orderCache.delete(providerId);\n      });\n    };\n  }\n\n  /**\n   * Subscribe to account updates from multiple providers.\n   *\n   * @param params - Subscription parameters\n   * @returns Unsubscribe function\n   */\n  subscribeToAccount(params: MultiplexedAccountParams): () => void {\n    const { providers, callback } = params;\n    const unsubscribers: (() => void)[] = [];\n\n    for (const [providerId, provider] of providers) {\n      try {\n        const subscribeParams: SubscribeAccountParams = {\n          callback: (account) => {\n            if (account === null) {\n              this.#accountCache.delete(providerId);\n            } else {\n              // Tag account with providerId and cache\n              const taggedAccount: AccountState = {\n                ...account,\n                providerId,\n              };\n              this.#accountCache.set(providerId, taggedAccount);\n            }\n\n            // Emit all cached account states\n            const allAccounts = Array.from(this.#accountCache.values());\n            callback(allAccounts);\n          },\n        };\n\n        const unsub = provider.subscribeToAccount(subscribeParams);\n        unsubscribers.push(unsub);\n      } catch (error) {\n        this.#logger?.error(\n          ensureError(error, 'SubscriptionMultiplexer.subscribeToAccount'),\n          {\n            tags: {\n              feature: PERPS_CONSTANTS.FeatureName,\n              provider: providerId,\n              method: 'subscribeToAccount',\n            },\n            context: {\n              name: 'SubscriptionMultiplexer',\n              data: { subscribedCount: unsubscribers.length },\n            },\n          },\n        );\n        unsubscribers.forEach((unsub) => unsub());\n        throw error;\n      }\n    }\n\n    return () => {\n      unsubscribers.forEach((unsub) => unsub());\n      providers.forEach(([providerId]) => {\n        this.#accountCache.delete(providerId);\n      });\n    };\n  }\n\n  /**\n   * Aggregate cached prices based on mode.\n   *\n   * @param symbols - Symbols to include in result\n   * @param mode - Aggregation mode\n   * @returns Aggregated price updates\n   */\n  #aggregatePrices(\n    symbols: string[],\n    mode: PriceAggregationMode,\n  ): PriceUpdate[] {\n    const result: PriceUpdate[] = [];\n\n    symbols.forEach((symbol) => {\n      const providerPrices = this.#priceCache.get(symbol);\n      if (!providerPrices || providerPrices.size === 0) {\n        return;\n      }\n\n      if (mode === 'merge') {\n        // Return all prices (one per provider)\n        providerPrices.forEach((price) => {\n          result.push(price);\n        });\n      } else {\n        // 'best_price': Return the best price across providers\n        const best = this.#findBestPrice(providerPrices);\n        if (best) {\n          result.push(best);\n        }\n      }\n    });\n\n    return result;\n  }\n\n  /**\n   * Find the best price from multiple provider prices.\n   * \"Best\" is defined as the price with the smallest spread.\n   *\n   * @param providerPrices - Map of provider prices for a symbol\n   * @returns Best price update or undefined\n   */\n  #findBestPrice(\n    providerPrices: Map<PerpsProviderType, PriceUpdate>,\n  ): PriceUpdate | undefined {\n    let bestPrice: PriceUpdate | undefined;\n    let smallestSpread = Infinity;\n\n    providerPrices.forEach((price) => {\n      if (price.spread === undefined) {\n        // No spread info - just use the first one\n        bestPrice ??= price;\n      } else {\n        // If spread is available, use it to determine best\n        const spreadValue = parseFloat(price.spread);\n        if (!isNaN(spreadValue) && spreadValue < smallestSpread) {\n          smallestSpread = spreadValue;\n          bestPrice = price;\n        }\n      }\n    });\n\n    return bestPrice;\n  }\n\n  /**\n   * Aggregate positions from all providers.\n   *\n   * @returns All cached positions\n   */\n  #aggregatePositions(): Position[] {\n    const allPositions: Position[] = [];\n    this.#positionCache.forEach((positions) => {\n      allPositions.push(...positions);\n    });\n    return allPositions;\n  }\n\n  /**\n   * Aggregate orders from all providers.\n   *\n   * @returns All cached orders\n   */\n  #aggregateOrders(): Order[] {\n    const allOrders: Order[] = [];\n    this.#orderCache.forEach((orders) => {\n      allOrders.push(...orders);\n    });\n    return allOrders;\n  }\n\n  /**\n   * Clear all cached data.\n   */\n  clearCache(): void {\n    this.#priceCache.clear();\n    this.#positionCache.clear();\n    this.#orderCache.clear();\n    this.#accountCache.clear();\n  }\n\n  /**\n   * Get cached price for a symbol from a specific provider.\n   *\n   * @param symbol - Market symbol\n   * @param providerId - Provider ID\n   * @returns Cached price update or undefined\n   */\n  getCachedPrice(\n    symbol: string,\n    providerId: PerpsProviderType,\n  ): PriceUpdate | undefined {\n    return this.#priceCache.get(symbol)?.get(providerId);\n  }\n\n  /**\n   * Get all cached prices for a symbol.\n   *\n   * @param symbol - Market symbol\n   * @returns Map of provider ID to price update\n   */\n  getAllCachedPricesForSymbol(\n    symbol: string,\n  ): Map<PerpsProviderType, PriceUpdate> | undefined {\n    return this.#priceCache.get(symbol);\n  }\n}\n"]}

package/dist/aggregation/index.cjs

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubscriptionMultiplexer = void 0;
+/**
+ * Provider aggregation module exports
+ */
+var SubscriptionMultiplexer_1 = require("./SubscriptionMultiplexer.cjs");
+Object.defineProperty(exports, "SubscriptionMultiplexer", { enumerable: true, get: function () { return SubscriptionMultiplexer_1.SubscriptionMultiplexer; } });
+//# sourceMappingURL=index.cjs.map

package/dist/aggregation/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/aggregation/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,yEAAoE;AAA3D,kIAAA,uBAAuB,OAAA","sourcesContent":["/**\n * Provider aggregation module exports\n */\nexport { SubscriptionMultiplexer } from './SubscriptionMultiplexer';\nexport type {\n  PriceAggregationMode,\n  MultiplexedPricesParams,\n  MultiplexedPositionsParams,\n  MultiplexedOrderFillsParams,\n  MultiplexedOrdersParams,\n  MultiplexedAccountParams,\n} from './SubscriptionMultiplexer';\n"]}

package/dist/aggregation/index.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Provider aggregation module exports
+ */
+export { SubscriptionMultiplexer } from "./SubscriptionMultiplexer.cjs";
+export type { PriceAggregationMode, MultiplexedPricesParams, MultiplexedPositionsParams, MultiplexedOrderFillsParams, MultiplexedOrdersParams, MultiplexedAccountParams, } from "./SubscriptionMultiplexer.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/aggregation/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/aggregation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,uBAAuB,EAAE,sCAAkC;AACpE,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,GACzB,sCAAkC"}

package/dist/aggregation/index.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Provider aggregation module exports
+ */
+export { SubscriptionMultiplexer } from "./SubscriptionMultiplexer.mjs";
+export type { PriceAggregationMode, MultiplexedPricesParams, MultiplexedPositionsParams, MultiplexedOrderFillsParams, MultiplexedOrdersParams, MultiplexedAccountParams, } from "./SubscriptionMultiplexer.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/aggregation/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/aggregation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,uBAAuB,EAAE,sCAAkC;AACpE,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,GACzB,sCAAkC"}

package/dist/aggregation/index.mjs

@@ -0,0 +1,5 @@
+/**
+ * Provider aggregation module exports
+ */
+export { SubscriptionMultiplexer } from "./SubscriptionMultiplexer.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/aggregation/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/aggregation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,uBAAuB,EAAE,sCAAkC","sourcesContent":["/**\n * Provider aggregation module exports\n */\nexport { SubscriptionMultiplexer } from './SubscriptionMultiplexer';\nexport type {\n  PriceAggregationMode,\n  MultiplexedPricesParams,\n  MultiplexedPositionsParams,\n  MultiplexedOrderFillsParams,\n  MultiplexedOrdersParams,\n  MultiplexedAccountParams,\n} from './SubscriptionMultiplexer';\n"]}

package/dist/constants/chartConfig.cjs

@@ -0,0 +1,227 @@
+"use strict";
+/**
+ * Portable chart configuration constants for PerpsController
+ * NO UI dependencies (@metamask/design-tokens, Colors, Theme)
+ *
+ * UI-specific exports (PERPS_CHART_CONFIG, CHART_INTERVALS, TIME_DURATIONS,
+ * getCandlestickColors) remain in the outer constants/chartConfig.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateCandleCount = exports.getDefaultCandlePeriodForDuration = exports.getCandlePeriodsForDuration = exports.DEFAULT_CANDLE_PERIOD = exports.CANDLE_PERIODS = exports.DURATION_CANDLE_PERIODS = exports.MAX_CANDLE_COUNT = exports.ChartInterval = exports.TimeDuration = exports.CandlePeriod = void 0;
+/**
+ * Enum for available candle periods
+ * Provides type safety and prevents typos when referencing candle periods
+ */
+var CandlePeriod;
+(function (CandlePeriod) {
+    CandlePeriod["OneMinute"] = "1m";
+    CandlePeriod["ThreeMinutes"] = "3m";
+    CandlePeriod["FiveMinutes"] = "5m";
+    CandlePeriod["FifteenMinutes"] = "15m";
+    CandlePeriod["ThirtyMinutes"] = "30m";
+    CandlePeriod["OneHour"] = "1h";
+    CandlePeriod["TwoHours"] = "2h";
+    CandlePeriod["FourHours"] = "4h";
+    CandlePeriod["EightHours"] = "8h";
+    CandlePeriod["TwelveHours"] = "12h";
+    CandlePeriod["OneDay"] = "1d";
+    CandlePeriod["ThreeDays"] = "3d";
+    CandlePeriod["OneWeek"] = "1w";
+    CandlePeriod["OneMonth"] = "1M";
+})(CandlePeriod || (exports.CandlePeriod = CandlePeriod = {}));
+/**
+ * Enum for available time durations
+ * Provides type safety and prevents typos when referencing durations
+ */
+var TimeDuration;
+(function (TimeDuration) {
+    TimeDuration["OneHour"] = "1hr";
+    TimeDuration["OneDay"] = "1d";
+    TimeDuration["OneWeek"] = "1w";
+    TimeDuration["OneMonth"] = "1m";
+    TimeDuration["YearToDate"] = "ytd";
+    TimeDuration["Max"] = "max";
+})(TimeDuration || (exports.TimeDuration = TimeDuration = {}));
+/**
+ * Enum for chart intervals (legacy support)
+ * Note: Some intervals overlap with CandlePeriod but serve different purposes
+ */
+var ChartInterval;
+(function (ChartInterval) {
+    ChartInterval["OneMinute"] = "1m";
+    ChartInterval["FiveMinutes"] = "5m";
+    ChartInterval["FifteenMinutes"] = "15m";
+    ChartInterval["ThirtyMinutes"] = "30m";
+    ChartInterval["OneHour"] = "1h";
+    ChartInterval["TwoHours"] = "2h";
+    ChartInterval["FourHours"] = "4h";
+    ChartInterval["EightHours"] = "8h";
+})(ChartInterval || (exports.ChartInterval = ChartInterval = {}));
+/**
+ * Maximum number of candles to load in memory
+ * Extracted from PERPS_CHART_CONFIG.CANDLE_COUNT.TOTAL for portability
+ */
+exports.MAX_CANDLE_COUNT = 500;
+/**
+ * Available candle periods mapped to each time duration
+ * This ensures users only see sensible candle periods for each duration
+ * and keeps the chart readable on mobile screens (target: ~20-100 candles)
+ */
+exports.DURATION_CANDLE_PERIODS = {
+    [TimeDuration.OneHour]: {
+        periods: [
+            { label: '1min', value: CandlePeriod.OneMinute }, // 60 candles
+            { label: '3min', value: CandlePeriod.ThreeMinutes }, // 20 candles
+            { label: '5min', value: CandlePeriod.FiveMinutes }, // 12 candles
+            { label: '15min', value: CandlePeriod.FifteenMinutes }, // 4 candles
+        ],
+        default: CandlePeriod.OneMinute, // 1-minute candles for development/testing
+    },
+    [TimeDuration.OneDay]: {
+        periods: [
+            { label: '15min', value: CandlePeriod.FifteenMinutes }, // 96 candles
+            { label: '1h', value: CandlePeriod.OneHour }, // 24 candles
+            { label: '2h', value: CandlePeriod.TwoHours }, // 12 candles
+            { label: '4h', value: CandlePeriod.FourHours }, // 6 candles
+        ],
+        default: CandlePeriod.OneHour, // Good balance for daily view
+    },
+    [TimeDuration.OneWeek]: {
+        periods: [
+            { label: '1h', value: CandlePeriod.OneHour }, // 168 candles (bit high, but acceptable)
+            { label: '2h', value: CandlePeriod.TwoHours }, // 84 candles
+            { label: '4h', value: CandlePeriod.FourHours }, // 42 candles
+            { label: '8h', value: CandlePeriod.EightHours }, // 21 candles
+            { label: '1D', value: CandlePeriod.OneDay }, // 7 candles
+        ],
+        default: CandlePeriod.FourHours, // Good detail for weekly view
+    },
+    [TimeDuration.OneMonth]: {
+        periods: [
+            { label: '8h', value: CandlePeriod.EightHours }, // 90 candles (30 days * 3 per day)
+            { label: '12h', value: CandlePeriod.TwelveHours }, // 60 candles (30 days * 2 per day)
+            { label: '1D', value: CandlePeriod.OneDay }, // 30 candles
+            { label: '1W', value: CandlePeriod.OneWeek }, // ~4 candles
+        ],
+        default: CandlePeriod.OneDay, // Daily candles for monthly view
+    },
+    [TimeDuration.YearToDate]: {
+        periods: [
+            { label: '1D', value: CandlePeriod.OneDay }, // ~365 candles (will be capped)
+            { label: '1W', value: CandlePeriod.OneWeek }, // ~52 candles
+        ],
+        default: CandlePeriod.OneWeek, // Weekly candles for yearly view
+    },
+    [TimeDuration.Max]: {
+        periods: [
+            { label: '1W', value: CandlePeriod.OneWeek }, // ~104 candles (2 years)
+        ],
+        default: CandlePeriod.OneWeek, // Only weekly makes sense for max view
+    },
+};
+exports.CANDLE_PERIODS = [
+    { label: '1m', value: CandlePeriod.OneMinute },
+    { label: '3m', value: CandlePeriod.ThreeMinutes },
+    { label: '5m', value: CandlePeriod.FiveMinutes },
+    { label: '15m', value: CandlePeriod.FifteenMinutes },
+    { label: '30m', value: CandlePeriod.ThirtyMinutes },
+    { label: '1h', value: CandlePeriod.OneHour },
+    { label: '2h', value: CandlePeriod.TwoHours },
+    { label: '4h', value: CandlePeriod.FourHours },
+    { label: '8h', value: CandlePeriod.EightHours },
+    { label: '12h', value: CandlePeriod.TwelveHours },
+    { label: '1d', value: CandlePeriod.OneDay },
+    { label: '3d', value: CandlePeriod.ThreeDays },
+    { label: '7d', value: CandlePeriod.OneWeek },
+];
+exports.DEFAULT_CANDLE_PERIOD = CandlePeriod.FifteenMinutes;
+/**
+ * Get available candle periods for a specific duration
+ *
+ * @param duration - The time duration to retrieve candle periods for.
+ * @returns The list of candle period options available for the given duration.
+ */
+const getCandlePeriodsForDuration = (duration) => {
+    const periods = exports.DURATION_CANDLE_PERIODS[duration]?.periods || [];
+    return periods;
+};
+exports.getCandlePeriodsForDuration = getCandlePeriodsForDuration;
+/**
+ * Get the default candle period for a specific duration
+ *
+ * @param duration - The time duration to retrieve the default candle period for.
+ * @returns The default candle period for the given duration.
+ */
+const getDefaultCandlePeriodForDuration = (duration) => exports.DURATION_CANDLE_PERIODS[duration]?.default ||
+    CandlePeriod.OneHour;
+exports.getDefaultCandlePeriodForDuration = getDefaultCandlePeriodForDuration;
+/**
+ * Calculate the number of candles to fetch based on duration and candle period
+ *
+ * @param duration - The time duration for the chart display.
+ * @param candlePeriod - The candle period interval.
+ * @returns The number of candles to fetch, capped at MAX_CANDLE_COUNT.
+ */
+const calculateCandleCount = (duration, candlePeriod) => {
+    // Convert candle period to minutes
+    const periodInMinutes = (() => {
+        switch (candlePeriod) {
+            case CandlePeriod.OneMinute:
+                return 1;
+            case CandlePeriod.ThreeMinutes:
+                return 3;
+            case CandlePeriod.FiveMinutes:
+                return 5;
+            case CandlePeriod.FifteenMinutes:
+                return 15;
+            case CandlePeriod.ThirtyMinutes:
+                return 30;
+            case CandlePeriod.OneHour:
+                return 60;
+            case CandlePeriod.TwoHours:
+                return 120;
+            case CandlePeriod.FourHours:
+                return 240;
+            case CandlePeriod.EightHours:
+                return 480;
+            case CandlePeriod.TwelveHours:
+                return 720;
+            case CandlePeriod.OneDay:
+                return 1440; // 24 * 60
+            case CandlePeriod.ThreeDays:
+                return 4320; // 3 * 24 * 60
+            case CandlePeriod.OneWeek:
+                return 10080; // 7 * 24 * 60
+            case CandlePeriod.OneMonth:
+                return 43200; // 30 * 24 * 60 (approximate)
+            default:
+                return 60; // Default to 1h
+        }
+    })();
+    // Convert duration to total minutes needed
+    const durationInMinutes = (() => {
+        switch (duration) {
+            case TimeDuration.OneHour:
+                return 60; // 1 hour
+            case TimeDuration.OneDay:
+                return 60 * 24; // 1 day
+            case TimeDuration.OneWeek:
+                return 60 * 24 * 7; // 1 week
+            case TimeDuration.OneMonth:
+                return 60 * 24 * 30; // 1 month (30 days)
+            case TimeDuration.YearToDate:
+                return 60 * 24 * 365; // Year to date (365 days max)
+            case TimeDuration.Max:
+                return 60 * 24 * 365 * 2; // Max (2 years)
+            default:
+                return 60 * 24; // Default to 1 day
+        }
+    })();
+    // Calculate number of candles needed
+    const candleCount = Math.ceil(durationInMinutes / periodInMinutes);
+    // Cap at MAX_CANDLE_COUNT candles max for memory management
+    // Allow minimum of 10 candles for basic functionality
+    return Math.min(Math.max(candleCount, 10), exports.MAX_CANDLE_COUNT);
+};
+exports.calculateCandleCount = calculateCandleCount;
+//# sourceMappingURL=chartConfig.cjs.map

package/dist/constants/chartConfig.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartConfig.cjs","sourceRoot":"","sources":["../../src/constants/chartConfig.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;;GAGG;AACH,IAAY,YAeX;AAfD,WAAY,YAAY;IACtB,gCAAgB,CAAA;IAChB,mCAAmB,CAAA;IACnB,kCAAkB,CAAA;IAClB,sCAAsB,CAAA;IACtB,qCAAqB,CAAA;IACrB,8BAAc,CAAA;IACd,+BAAe,CAAA;IACf,gCAAgB,CAAA;IAChB,iCAAiB,CAAA;IACjB,mCAAmB,CAAA;IACnB,6BAAa,CAAA;IACb,gCAAgB,CAAA;IAChB,8BAAc,CAAA;IACd,+BAAe,CAAA;AACjB,CAAC,EAfW,YAAY,4BAAZ,YAAY,QAevB;AAED;;;GAGG;AACH,IAAY,YAOX;AAPD,WAAY,YAAY;IACtB,+BAAe,CAAA;IACf,6BAAa,CAAA;IACb,8BAAc,CAAA;IACd,+BAAe,CAAA;IACf,kCAAkB,CAAA;IAClB,2BAAW,CAAA;AACb,CAAC,EAPW,YAAY,4BAAZ,YAAY,QAOvB;AAED;;;GAGG;AACH,IAAY,aASX;AATD,WAAY,aAAa;IACvB,iCAAgB,CAAA;IAChB,mCAAkB,CAAA;IAClB,uCAAsB,CAAA;IACtB,sCAAqB,CAAA;IACrB,+BAAc,CAAA;IACd,gCAAe,CAAA;IACf,iCAAgB,CAAA;IAChB,kCAAiB,CAAA;AACnB,CAAC,EATW,aAAa,6BAAb,aAAa,QASxB;AAED;;;GAGG;AACU,QAAA,gBAAgB,GAAG,GAAG,CAAC;AAEpC;;;;GAIG;AACU,QAAA,uBAAuB,GAAG;IACrC,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE;QACtB,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,SAAS,EAAE,EAAE,aAAa;YAC/D,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,YAAY,EAAE,EAAE,aAAa;YAClE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,WAAW,EAAE,EAAE,aAAa;YACjE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,cAAc,EAAE,EAAE,YAAY;SACrE;QACD,OAAO,EAAE,YAAY,CAAC,SAAS,EAAE,2CAA2C;KAC7E;IACD,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE;QACrB,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,cAAc,EAAE,EAAE,aAAa;YACrE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,EAAE,aAAa;YAC3D,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,QAAQ,EAAE,EAAE,aAAa;YAC5D,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,SAAS,EAAE,EAAE,YAAY;SAC7D;QACD,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,8BAA8B;KAC9D;IACD,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE;QACtB,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,EAAE,yCAAyC;YACvF,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,QAAQ,EAAE,EAAE,aAAa;YAC5D,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,SAAS,EAAE,EAAE,aAAa;YAC7D,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,UAAU,EAAE,EAAE,aAAa;YAC9D,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,EAAE,YAAY;SAC1D;QACD,OAAO,EAAE,YAAY,CAAC,SAAS,EAAE,8BAA8B;KAChE;IACD,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE;QACvB,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,UAAU,EAAE,EAAE,mCAAmC;YACpF,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,WAAW,EAAE,EAAE,mCAAmC;YACtF,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,EAAE,aAAa;YAC1D,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,EAAE,aAAa;SAC5D;QACD,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,iCAAiC;KAChE;IACD,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE;QACzB,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,EAAE,gCAAgC;YAC7E,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,EAAE,cAAc;SAC7D;QACD,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,iCAAiC;KACjE;IACD,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE;QAClB,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,EAAE,yBAAyB;SACxE;QACD,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,uCAAuC;KACvE;CACO,CAAC;AAEE,QAAA,cAAc,GAAG;IAC5B,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,SAAS,EAAE;IAC9C,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,YAAY,EAAE;IACjD,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,WAAW,EAAE;IAChD,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,cAAc,EAAE;IACpD,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,aAAa,EAAE;IACnD,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE;IAC5C,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,QAAQ,EAAE;IAC7C,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,SAAS,EAAE;IAC9C,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,UAAU,EAAE;IAC/C,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,WAAW,EAAE;IACjD,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE;IAC3C,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,SAAS,EAAE;IAC9C,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE;CACpC,CAAC;AAEE,QAAA,qBAAqB,GAAG,YAAY,CAAC,cAAc,CAAC;AAEjE;;;;;GAKG;AACI,MAAM,2BAA2B,GAAG,CACzC,QAA+B,EACoB,EAAE;IACrD,MAAM,OAAO,GACX,+BAAuB,CAAC,QAAwB,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC;IAEnE,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAPW,QAAA,2BAA2B,+BAOtC;AAEF;;;;;GAKG;AACI,MAAM,iCAAiC,GAAG,CAC/C,QAA+B,EACjB,EAAE,CAChB,+BAAuB,CAAC,QAAwB,CAAC,EAAE,OAAO;IAC1D,YAAY,CAAC,OAAO,CAAC;AAJV,QAAA,iCAAiC,qCAIvB;AAEvB;;;;;;GAMG;AACI,MAAM,oBAAoB,GAAG,CAClC,QAA+B,EAC/B,YAAmC,EAC3B,EAAE;IACV,mCAAmC;IACnC,MAAM,eAAe,GAAG,CAAC,GAAW,EAAE;QACpC,QAAQ,YAAY,EAAE,CAAC;YACrB,KAAK,YAAY,CAAC,SAAS;gBACzB,OAAO,CAAC,CAAC;YACX,KAAK,YAAY,CAAC,YAAY;gBAC5B,OAAO,CAAC,CAAC;YACX,KAAK,YAAY,CAAC,WAAW;gBAC3B,OAAO,CAAC,CAAC;YACX,KAAK,YAAY,CAAC,cAAc;gBAC9B,OAAO,EAAE,CAAC;YACZ,KAAK,YAAY,CAAC,aAAa;gBAC7B,OAAO,EAAE,CAAC;YACZ,KAAK,YAAY,CAAC,OAAO;gBACvB,OAAO,EAAE,CAAC;YACZ,KAAK,YAAY,CAAC,QAAQ;gBACxB,OAAO,GAAG,CAAC;YACb,KAAK,YAAY,CAAC,SAAS;gBACzB,OAAO,GAAG,CAAC;YACb,KAAK,YAAY,CAAC,UAAU;gBAC1B,OAAO,GAAG,CAAC;YACb,KAAK,YAAY,CAAC,WAAW;gBAC3B,OAAO,GAAG,CAAC;YACb,KAAK,YAAY,CAAC,MAAM;gBACtB,OAAO,IAAI,CAAC,CAAC,UAAU;YACzB,KAAK,YAAY,CAAC,SAAS;gBACzB,OAAO,IAAI,CAAC,CAAC,cAAc;YAC7B,KAAK,YAAY,CAAC,OAAO;gBACvB,OAAO,KAAK,CAAC,CAAC,cAAc;YAC9B,KAAK,YAAY,CAAC,QAAQ;gBACxB,OAAO,KAAK,CAAC,CAAC,6BAA6B;YAC7C;gBACE,OAAO,EAAE,CAAC,CAAC,gBAAgB;QAC/B,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,2CAA2C;IAC3C,MAAM,iBAAiB,GAAG,CAAC,GAAW,EAAE;QACtC,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,YAAY,CAAC,OAAO;gBACvB,OAAO,EAAE,CAAC,CAAC,SAAS;YACtB,KAAK,YAAY,CAAC,MAAM;gBACtB,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ;YAC1B,KAAK,YAAY,CAAC,OAAO;gBACvB,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS;YAC/B,KAAK,YAAY,CAAC,QAAQ;gBACxB,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,oBAAoB;YAC3C,KAAK,YAAY,CAAC,UAAU;gBAC1B,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,8BAA8B;YACtD,KAAK,YAAY,CAAC,GAAG;gBACnB,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,gBAAgB;YAC5C;gBACE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,mBAAmB;QACvC,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,qCAAqC;IACrC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,GAAG,eAAe,CAAC,CAAC;IAEnE,4DAA4D;IAC5D,sDAAsD;IACtD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,wBAAgB,CAAC,CAAC;AAC/D,CAAC,CAAC;AAlEW,QAAA,oBAAoB,wBAkE/B","sourcesContent":["/**\n * Portable chart configuration constants for PerpsController\n * NO UI dependencies (@metamask/design-tokens, Colors, Theme)\n *\n * UI-specific exports (PERPS_CHART_CONFIG, CHART_INTERVALS, TIME_DURATIONS,\n * getCandlestickColors) remain in the outer constants/chartConfig.ts\n */\n\n/**\n * Enum for available candle periods\n * Provides type safety and prevents typos when referencing candle periods\n */\nexport enum CandlePeriod {\n  OneMinute = '1m',\n  ThreeMinutes = '3m',\n  FiveMinutes = '5m',\n  FifteenMinutes = '15m',\n  ThirtyMinutes = '30m',\n  OneHour = '1h',\n  TwoHours = '2h',\n  FourHours = '4h',\n  EightHours = '8h',\n  TwelveHours = '12h',\n  OneDay = '1d',\n  ThreeDays = '3d',\n  OneWeek = '1w',\n  OneMonth = '1M',\n}\n\n/**\n * Enum for available time durations\n * Provides type safety and prevents typos when referencing durations\n */\nexport enum TimeDuration {\n  OneHour = '1hr',\n  OneDay = '1d',\n  OneWeek = '1w',\n  OneMonth = '1m',\n  YearToDate = 'ytd',\n  Max = 'max',\n}\n\n/**\n * Enum for chart intervals (legacy support)\n * Note: Some intervals overlap with CandlePeriod but serve different purposes\n */\nexport enum ChartInterval {\n  OneMinute = '1m',\n  FiveMinutes = '5m',\n  FifteenMinutes = '15m',\n  ThirtyMinutes = '30m',\n  OneHour = '1h',\n  TwoHours = '2h',\n  FourHours = '4h',\n  EightHours = '8h',\n}\n\n/**\n * Maximum number of candles to load in memory\n * Extracted from PERPS_CHART_CONFIG.CANDLE_COUNT.TOTAL for portability\n */\nexport const MAX_CANDLE_COUNT = 500;\n\n/**\n * Available candle periods mapped to each time duration\n * This ensures users only see sensible candle periods for each duration\n * and keeps the chart readable on mobile screens (target: ~20-100 candles)\n */\nexport const DURATION_CANDLE_PERIODS = {\n  [TimeDuration.OneHour]: {\n    periods: [\n      { label: '1min', value: CandlePeriod.OneMinute }, // 60 candles\n      { label: '3min', value: CandlePeriod.ThreeMinutes }, // 20 candles\n      { label: '5min', value: CandlePeriod.FiveMinutes }, // 12 candles\n      { label: '15min', value: CandlePeriod.FifteenMinutes }, // 4 candles\n    ],\n    default: CandlePeriod.OneMinute, // 1-minute candles for development/testing\n  },\n  [TimeDuration.OneDay]: {\n    periods: [\n      { label: '15min', value: CandlePeriod.FifteenMinutes }, // 96 candles\n      { label: '1h', value: CandlePeriod.OneHour }, // 24 candles\n      { label: '2h', value: CandlePeriod.TwoHours }, // 12 candles\n      { label: '4h', value: CandlePeriod.FourHours }, // 6 candles\n    ],\n    default: CandlePeriod.OneHour, // Good balance for daily view\n  },\n  [TimeDuration.OneWeek]: {\n    periods: [\n      { label: '1h', value: CandlePeriod.OneHour }, // 168 candles (bit high, but acceptable)\n      { label: '2h', value: CandlePeriod.TwoHours }, // 84 candles\n      { label: '4h', value: CandlePeriod.FourHours }, // 42 candles\n      { label: '8h', value: CandlePeriod.EightHours }, // 21 candles\n      { label: '1D', value: CandlePeriod.OneDay }, // 7 candles\n    ],\n    default: CandlePeriod.FourHours, // Good detail for weekly view\n  },\n  [TimeDuration.OneMonth]: {\n    periods: [\n      { label: '8h', value: CandlePeriod.EightHours }, // 90 candles (30 days * 3 per day)\n      { label: '12h', value: CandlePeriod.TwelveHours }, // 60 candles (30 days * 2 per day)\n      { label: '1D', value: CandlePeriod.OneDay }, // 30 candles\n      { label: '1W', value: CandlePeriod.OneWeek }, // ~4 candles\n    ],\n    default: CandlePeriod.OneDay, // Daily candles for monthly view\n  },\n  [TimeDuration.YearToDate]: {\n    periods: [\n      { label: '1D', value: CandlePeriod.OneDay }, // ~365 candles (will be capped)\n      { label: '1W', value: CandlePeriod.OneWeek }, // ~52 candles\n    ],\n    default: CandlePeriod.OneWeek, // Weekly candles for yearly view\n  },\n  [TimeDuration.Max]: {\n    periods: [\n      { label: '1W', value: CandlePeriod.OneWeek }, // ~104 candles (2 years)\n    ],\n    default: CandlePeriod.OneWeek, // Only weekly makes sense for max view\n  },\n} as const;\n\nexport const CANDLE_PERIODS = [\n  { label: '1m', value: CandlePeriod.OneMinute },\n  { label: '3m', value: CandlePeriod.ThreeMinutes },\n  { label: '5m', value: CandlePeriod.FiveMinutes },\n  { label: '15m', value: CandlePeriod.FifteenMinutes },\n  { label: '30m', value: CandlePeriod.ThirtyMinutes },\n  { label: '1h', value: CandlePeriod.OneHour },\n  { label: '2h', value: CandlePeriod.TwoHours },\n  { label: '4h', value: CandlePeriod.FourHours },\n  { label: '8h', value: CandlePeriod.EightHours },\n  { label: '12h', value: CandlePeriod.TwelveHours },\n  { label: '1d', value: CandlePeriod.OneDay },\n  { label: '3d', value: CandlePeriod.ThreeDays },\n  { label: '7d', value: CandlePeriod.OneWeek },\n] as const;\n\nexport const DEFAULT_CANDLE_PERIOD = CandlePeriod.FifteenMinutes;\n\n/**\n * Get available candle periods for a specific duration\n *\n * @param duration - The time duration to retrieve candle periods for.\n * @returns The list of candle period options available for the given duration.\n */\nexport const getCandlePeriodsForDuration = (\n  duration: TimeDuration | string,\n): readonly { label: string; value: CandlePeriod }[] => {\n  const periods =\n    DURATION_CANDLE_PERIODS[duration as TimeDuration]?.periods || [];\n\n  return periods;\n};\n\n/**\n * Get the default candle period for a specific duration\n *\n * @param duration - The time duration to retrieve the default candle period for.\n * @returns The default candle period for the given duration.\n */\nexport const getDefaultCandlePeriodForDuration = (\n  duration: TimeDuration | string,\n): CandlePeriod =>\n  DURATION_CANDLE_PERIODS[duration as TimeDuration]?.default ||\n  CandlePeriod.OneHour;\n\n/**\n * Calculate the number of candles to fetch based on duration and candle period\n *\n * @param duration - The time duration for the chart display.\n * @param candlePeriod - The candle period interval.\n * @returns The number of candles to fetch, capped at MAX_CANDLE_COUNT.\n */\nexport const calculateCandleCount = (\n  duration: TimeDuration | string,\n  candlePeriod: CandlePeriod | string,\n): number => {\n  // Convert candle period to minutes\n  const periodInMinutes = ((): number => {\n    switch (candlePeriod) {\n      case CandlePeriod.OneMinute:\n        return 1;\n      case CandlePeriod.ThreeMinutes:\n        return 3;\n      case CandlePeriod.FiveMinutes:\n        return 5;\n      case CandlePeriod.FifteenMinutes:\n        return 15;\n      case CandlePeriod.ThirtyMinutes:\n        return 30;\n      case CandlePeriod.OneHour:\n        return 60;\n      case CandlePeriod.TwoHours:\n        return 120;\n      case CandlePeriod.FourHours:\n        return 240;\n      case CandlePeriod.EightHours:\n        return 480;\n      case CandlePeriod.TwelveHours:\n        return 720;\n      case CandlePeriod.OneDay:\n        return 1440; // 24 * 60\n      case CandlePeriod.ThreeDays:\n        return 4320; // 3 * 24 * 60\n      case CandlePeriod.OneWeek:\n        return 10080; // 7 * 24 * 60\n      case CandlePeriod.OneMonth:\n        return 43200; // 30 * 24 * 60 (approximate)\n      default:\n        return 60; // Default to 1h\n    }\n  })();\n\n  // Convert duration to total minutes needed\n  const durationInMinutes = ((): number => {\n    switch (duration) {\n      case TimeDuration.OneHour:\n        return 60; // 1 hour\n      case TimeDuration.OneDay:\n        return 60 * 24; // 1 day\n      case TimeDuration.OneWeek:\n        return 60 * 24 * 7; // 1 week\n      case TimeDuration.OneMonth:\n        return 60 * 24 * 30; // 1 month (30 days)\n      case TimeDuration.YearToDate:\n        return 60 * 24 * 365; // Year to date (365 days max)\n      case TimeDuration.Max:\n        return 60 * 24 * 365 * 2; // Max (2 years)\n      default:\n        return 60 * 24; // Default to 1 day\n    }\n  })();\n\n  // Calculate number of candles needed\n  const candleCount = Math.ceil(durationInMinutes / periodInMinutes);\n\n  // Cap at MAX_CANDLE_COUNT candles max for memory management\n  // Allow minimum of 10 candles for basic functionality\n  return Math.min(Math.max(candleCount, 10), MAX_CANDLE_COUNT);\n};\n"]}

package/dist/constants/chartConfig.d.cts

@@ -0,0 +1,216 @@
+/**
+ * Portable chart configuration constants for PerpsController
+ * NO UI dependencies (@metamask/design-tokens, Colors, Theme)
+ *
+ * UI-specific exports (PERPS_CHART_CONFIG, CHART_INTERVALS, TIME_DURATIONS,
+ * getCandlestickColors) remain in the outer constants/chartConfig.ts
+ */
+/**
+ * Enum for available candle periods
+ * Provides type safety and prevents typos when referencing candle periods
+ */
+export declare enum CandlePeriod {
+    OneMinute = "1m",
+    ThreeMinutes = "3m",
+    FiveMinutes = "5m",
+    FifteenMinutes = "15m",
+    ThirtyMinutes = "30m",
+    OneHour = "1h",
+    TwoHours = "2h",
+    FourHours = "4h",
+    EightHours = "8h",
+    TwelveHours = "12h",
+    OneDay = "1d",
+    ThreeDays = "3d",
+    OneWeek = "1w",
+    OneMonth = "1M"
+}
+/**
+ * Enum for available time durations
+ * Provides type safety and prevents typos when referencing durations
+ */
+export declare enum TimeDuration {
+    OneHour = "1hr",
+    OneDay = "1d",
+    OneWeek = "1w",
+    OneMonth = "1m",
+    YearToDate = "ytd",
+    Max = "max"
+}
+/**
+ * Enum for chart intervals (legacy support)
+ * Note: Some intervals overlap with CandlePeriod but serve different purposes
+ */
+export declare enum ChartInterval {
+    OneMinute = "1m",
+    FiveMinutes = "5m",
+    FifteenMinutes = "15m",
+    ThirtyMinutes = "30m",
+    OneHour = "1h",
+    TwoHours = "2h",
+    FourHours = "4h",
+    EightHours = "8h"
+}
+/**
+ * Maximum number of candles to load in memory
+ * Extracted from PERPS_CHART_CONFIG.CANDLE_COUNT.TOTAL for portability
+ */
+export declare const MAX_CANDLE_COUNT = 500;
+/**
+ * Available candle periods mapped to each time duration
+ * This ensures users only see sensible candle periods for each duration
+ * and keeps the chart readable on mobile screens (target: ~20-100 candles)
+ */
+export declare const DURATION_CANDLE_PERIODS: {
+    readonly "1hr": {
+        readonly periods: readonly [{
+            readonly label: "1min";
+            readonly value: CandlePeriod.OneMinute;
+        }, {
+            readonly label: "3min";
+            readonly value: CandlePeriod.ThreeMinutes;
+        }, {
+            readonly label: "5min";
+            readonly value: CandlePeriod.FiveMinutes;
+        }, {
+            readonly label: "15min";
+            readonly value: CandlePeriod.FifteenMinutes;
+        }];
+        readonly default: CandlePeriod.OneMinute;
+    };
+    readonly "1d": {
+        readonly periods: readonly [{
+            readonly label: "15min";
+            readonly value: CandlePeriod.FifteenMinutes;
+        }, {
+            readonly label: "1h";
+            readonly value: CandlePeriod.OneHour;
+        }, {
+            readonly label: "2h";
+            readonly value: CandlePeriod.TwoHours;
+        }, {
+            readonly label: "4h";
+            readonly value: CandlePeriod.FourHours;
+        }];
+        readonly default: CandlePeriod.OneHour;
+    };
+    readonly "1w": {
+        readonly periods: readonly [{
+            readonly label: "1h";
+            readonly value: CandlePeriod.OneHour;
+        }, {
+            readonly label: "2h";
+            readonly value: CandlePeriod.TwoHours;
+        }, {
+            readonly label: "4h";
+            readonly value: CandlePeriod.FourHours;
+        }, {
+            readonly label: "8h";
+            readonly value: CandlePeriod.EightHours;
+        }, {
+            readonly label: "1D";
+            readonly value: CandlePeriod.OneDay;
+        }];
+        readonly default: CandlePeriod.FourHours;
+    };
+    readonly "1m": {
+        readonly periods: readonly [{
+            readonly label: "8h";
+            readonly value: CandlePeriod.EightHours;
+        }, {
+            readonly label: "12h";
+            readonly value: CandlePeriod.TwelveHours;
+        }, {
+            readonly label: "1D";
+            readonly value: CandlePeriod.OneDay;
+        }, {
+            readonly label: "1W";
+            readonly value: CandlePeriod.OneWeek;
+        }];
+        readonly default: CandlePeriod.OneDay;
+    };
+    readonly ytd: {
+        readonly periods: readonly [{
+            readonly label: "1D";
+            readonly value: CandlePeriod.OneDay;
+        }, {
+            readonly label: "1W";
+            readonly value: CandlePeriod.OneWeek;
+        }];
+        readonly default: CandlePeriod.OneWeek;
+    };
+    readonly max: {
+        readonly periods: readonly [{
+            readonly label: "1W";
+            readonly value: CandlePeriod.OneWeek;
+        }];
+        readonly default: CandlePeriod.OneWeek;
+    };
+};
+export declare const CANDLE_PERIODS: readonly [{
+    readonly label: "1m";
+    readonly value: CandlePeriod.OneMinute;
+}, {
+    readonly label: "3m";
+    readonly value: CandlePeriod.ThreeMinutes;
+}, {
+    readonly label: "5m";
+    readonly value: CandlePeriod.FiveMinutes;
+}, {
+    readonly label: "15m";
+    readonly value: CandlePeriod.FifteenMinutes;
+}, {
+    readonly label: "30m";
+    readonly value: CandlePeriod.ThirtyMinutes;
+}, {
+    readonly label: "1h";
+    readonly value: CandlePeriod.OneHour;
+}, {
+    readonly label: "2h";
+    readonly value: CandlePeriod.TwoHours;
+}, {
+    readonly label: "4h";
+    readonly value: CandlePeriod.FourHours;
+}, {
+    readonly label: "8h";
+    readonly value: CandlePeriod.EightHours;
+}, {
+    readonly label: "12h";
+    readonly value: CandlePeriod.TwelveHours;
+}, {
+    readonly label: "1d";
+    readonly value: CandlePeriod.OneDay;
+}, {
+    readonly label: "3d";
+    readonly value: CandlePeriod.ThreeDays;
+}, {
+    readonly label: "7d";
+    readonly value: CandlePeriod.OneWeek;
+}];
+export declare const DEFAULT_CANDLE_PERIOD = CandlePeriod.FifteenMinutes;
+/**
+ * Get available candle periods for a specific duration
+ *
+ * @param duration - The time duration to retrieve candle periods for.
+ * @returns The list of candle period options available for the given duration.
+ */
+export declare const getCandlePeriodsForDuration: (duration: TimeDuration | string) => readonly {
+    label: string;
+    value: CandlePeriod;
+}[];
+/**
+ * Get the default candle period for a specific duration
+ *
+ * @param duration - The time duration to retrieve the default candle period for.
+ * @returns The default candle period for the given duration.
+ */
+export declare const getDefaultCandlePeriodForDuration: (duration: TimeDuration | string) => CandlePeriod;
+/**
+ * Calculate the number of candles to fetch based on duration and candle period
+ *
+ * @param duration - The time duration for the chart display.
+ * @param candlePeriod - The candle period interval.
+ * @returns The number of candles to fetch, capped at MAX_CANDLE_COUNT.
+ */
+export declare const calculateCandleCount: (duration: TimeDuration | string, candlePeriod: CandlePeriod | string) => number;
+//# sourceMappingURL=chartConfig.d.cts.map

package/dist/constants/chartConfig.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartConfig.d.cts","sourceRoot":"","sources":["../../src/constants/chartConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,oBAAY,YAAY;IACtB,SAAS,OAAO;IAChB,YAAY,OAAO;IACnB,WAAW,OAAO;IAClB,cAAc,QAAQ;IACtB,aAAa,QAAQ;IACrB,OAAO,OAAO;IACd,QAAQ,OAAO;IACf,SAAS,OAAO;IAChB,UAAU,OAAO;IACjB,WAAW,QAAQ;IACnB,MAAM,OAAO;IACb,SAAS,OAAO;IAChB,OAAO,OAAO;IACd,QAAQ,OAAO;CAChB;AAED;;;GAGG;AACH,oBAAY,YAAY;IACtB,OAAO,QAAQ;IACf,MAAM,OAAO;IACb,OAAO,OAAO;IACd,QAAQ,OAAO;IACf,UAAU,QAAQ;IAClB,GAAG,QAAQ;CACZ;AAED;;;GAGG;AACH,oBAAY,aAAa;IACvB,SAAS,OAAO;IAChB,WAAW,OAAO;IAClB,cAAc,QAAQ;IACtB,aAAa,QAAQ;IACrB,OAAO,OAAO;IACd,QAAQ,OAAO;IACf,SAAS,OAAO;IAChB,UAAU,OAAO;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmD1B,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcjB,CAAC;AAEX,eAAO,MAAM,qBAAqB,8BAA8B,CAAC;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,aAC5B,YAAY,GAAG,MAAM,KAC9B,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,EAKjD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,aAClC,YAAY,GAAG,MAAM,KAC9B,YAEmB,CAAC;AAEvB;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,aACrB,YAAY,GAAG,MAAM,gBACjB,YAAY,GAAG,MAAM,KAClC,MA+DF,CAAC"}