oakscriptjs 0.11.0 → 0.11.2

package/dist/cjs/session/calendar.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/session/calendar.ts"],
-  "sourcesContent": ["/**\n * Trading calendar: the session periods of each trading day of a symbol, from the symbol session\n * information (issue #100).\n *\n * Session format (symbol session information, also PineScript session strings):\n * - periods \"HHMM-HHMM\", several separated by commas; \"24x7\" is the whole day, every day\n * - a period whose end is not after its start (\"1700-1600\", \"1700-1700\") starts the day before the\n *   trading day: the session that opens Sunday 17:00 is Monday's\n * - \"HHMMF<n>\" moves a time <n> days before the trading day (\"1700F2-1200F1\"); \"F\" alone is one day (\"1700F-1900\":\n *   17:00 of the day before to 19:00)\n * - several sections joined by \"|\", each with its own days (\"1900-1900:3456|1700F-1900:2\": Monday opens on Sunday\n *   17:00, the other days at 19:00 of the day before)\n * - optional days after \":\" (1 = Sunday ... 7 = Saturday); without days a symbol session trades Monday to\n *   Friday (\"24x7\": every day), and a PineScript session string follows PineScript's rules (one period:\n *   every day; several periods: Monday to Friday)\n * - \"#YYYYMMDD/<session>\" changes the session from that date (\"0900-1746#20251201/0800-2200\")\n * - corrections (\"session-correction\"): \"<session>:<dates>;dayoff:<dates>\" replace the session of these\n *   dates (early closes, days off); holidays (\"session_holidays\") are dates without session\n */\n\nimport { zonedFields, zonedToUnix } from '../time/timezone.js';\nimport { parsePineSession } from '../time/session.js';\n\n/** Session information of a symbol (hours, corrections, holidays). */\nexport interface SessionSpec {\n  /** Session hours: \"0930-1600\", \"1700-1600\", \"24x7\", \"0400-2000\" ... */\n  session: string;\n  /** Exceptions by date (symbol info \"session-correction\"): \"0930-1300:20251128,20251224;dayoff:20250109\" */\n  corrections?: string;\n  /** Exchange holidays as \"YYYYMMDD\" (symbol info \"session_holidays\"), comma-separated or as an array */\n  holidays?: string | string[];\n}\n\n/** Date as YYYYMMDD. */\nexport type DateNum = number;\n\ninterface Period {\n  /** Minutes after midnight */\n  start: number;\n  end: number;\n  /** Days before the trading day */\n  startOffset: number;\n  endOffset: number;\n}\n\ninterface Version {\n  from: DateNum;\n  periods: Period[];\n  /** Index 1 (Sunday) to 7 (Saturday) */\n  days: boolean[];\n  /** PineScript session strings: the periods of each weekday (index 1 to 7), from the \"|\" sections */\n  byDay?: Period[][];\n}\n\nexport const toDateNum = (y: number, m: number, d: number): DateNum => y * 10000 + m * 100 + d;\nconst utcOf = (date: DateNum): number => Date.UTC(Math.floor(date / 10000), Math.floor(date / 100) % 100 - 1, date % 100);\nconst fromUtc = (ms: number): DateNum => {\n  const d = new Date(ms);\n  return toDateNum(d.getUTCFullYear(), d.getUTCMonth() + 1, d.getUTCDate());\n};\nexport const addDays = (date: DateNum, n: number): DateNum => fromUtc(utcOf(date) + n * 86_400_000);\n/** 1 = Sunday ... 7 = Saturday */\nexport const weekdayOf = (date: DateNum): number => new Date(utcOf(date)).getUTCDay() + 1;\n/** 00:00 UTC of the date, in ms (PineScript `time_tradingday`). */\nexport const dateUtcMs = utcOf;\n\nfunction parseTime(token: string, spec: string): { minutes: number; offset?: number } {\n  const m = /^(\\d{2})(\\d{2})(?:F(\\d*))?$/.exec(token.trim());\n  if (!m) throw new SyntaxError(`Invalid session \"${spec}\"`);\n  // \"F\" without a number is one day before the trading day\n  return { minutes: Number(m[1]) * 60 + Number(m[2]), offset: m[3] === undefined ? undefined : Number(m[3] || 1) };\n}\n\nfunction parsePeriods(text: string, spec: string): Period[] {\n  if (text.trim() === '24x7') return [{ start: 0, end: 1440, startOffset: 0, endOffset: 0 }];\n  return text.split(',').map((p) => {\n    const [a = '', b = ''] = p.split('-');\n    const s = parseTime(a, spec);\n    const e = parseTime(b, spec);\n    if (s.minutes === 0 && e.minutes === 0 && s.offset === undefined && e.offset === undefined) {\n      return { start: 0, end: 1440, startOffset: 0, endOffset: 0 };\n    }\n    return {\n      start: s.minutes,\n      end: e.minutes,\n      startOffset: s.offset ?? (e.minutes <= s.minutes ? 1 : 0),\n      endOffset: e.offset ?? 0,\n    };\n  });\n}\n\n/** A PineScript session string as periods per weekday (rules in time/session.ts). */\nfunction pineVersion(text: string, from: DateNum): Version {\n  const ranges = parsePineSession(text);\n  if (ranges === null) throw new SyntaxError(`Session \"${text}\" is the symbol session`);\n  const byDay: Period[][] = Array.from({ length: 8 }, () => []);\n  for (const { start, end, days } of ranges) {\n    const period: Period =\n      start === 0 && end === 0\n        ? { start: 0, end: 1440, startOffset: 0, endOffset: 0 }\n        : { start, end, startOffset: end <= start ? 1 : 0, endOffset: 0 };\n    for (const d of days) byDay[d]!.push(period);\n  }\n  return { from, periods: [], days: byDay.map((p) => p.length > 0), byDay };\n}\n\nfunction parseVersion(text: string, from: DateNum, spec: string, rule: 'symbol' | 'pine'): Version {\n  if (rule === 'pine') return pineVersion(text, from);\n  if (text.includes('|')) {\n    // sections with their own days\n    const byDay: Period[][] = Array.from({ length: 8 }, () => []);\n    for (const section of text.split('|').filter((part) => part.trim())) {\n      const one = parseVersion(section, from, spec, rule);\n      one.days.forEach((on, d) => {\n        if (on) byDay[d] = one.periods;\n      });\n    }\n    return { from, periods: [], days: byDay.map((p) => p.length > 0), byDay };\n  }\n  const [periodText = '', dayText] = text.trim().split(':');\n  const periods = parsePeriods(periodText, spec);\n  const allDays = periodText.trim() === '24x7';\n  const digits = dayText ?? (allDays ? '1234567' : '23456');\n  if (!/^[1-7]+$/.test(digits)) throw new SyntaxError(`Invalid session days in \"${spec}\"`);\n  const days = new Array<boolean>(8).fill(false);\n  for (const d of digits) days[Number(d)] = true;\n  return { from, periods, days };\n}\n\n/** Session periods of every trading day of a symbol, as UNIX times (ms). */\nexport class TradingCalendar {\n  private readonly versions: Version[];\n  private readonly corrections = new Map<DateNum, Period[] | null>();\n  private readonly holidays: Set<DateNum>;\n  private readonly cache = new Map<DateNum, Array<[number, number]>>();\n\n  /**\n   * @param timezone - Time zone of the session hours (the exchange time zone)\n   * @param spec - Session information (hours, corrections, holidays)\n   * @param rule - Days without \":days\": 'symbol' (Monday to Friday) or 'pine' (PineScript session strings)\n   */\n  constructor(\n    readonly timezone: string,\n    spec: SessionSpec,\n    rule: 'symbol' | 'pine' = 'symbol'\n  ) {\n    const [first = '', ...changes] = spec.session.split('#');\n    this.versions = [parseVersion(first, 0, spec.session, rule)];\n    for (const change of changes) {\n      const m = /^(\\d{8})\\/(.+)$/.exec(change.trim());\n      if (!m) throw new SyntaxError(`Invalid session change in \"${spec.session}\"`);\n      this.versions.push(parseVersion(m[2]!, Number(m[1]), spec.session, rule));\n    }\n    for (const part of (spec.corrections ?? '').split(';').filter((p) => p.trim())) {\n      const i = part.lastIndexOf(':');\n      const text = part.slice(0, i).trim();\n      const periods = text === 'dayoff' ? null : parsePeriods(text, part);\n      for (const date of part.slice(i + 1).split(',')) this.corrections.set(Number(date), periods);\n    }\n    const holidays = Array.isArray(spec.holidays) ? spec.holidays : (spec.holidays ?? '').split(',');\n    this.holidays = new Set(holidays.filter((h) => h.trim()).map(Number));\n  }\n\n  /** Session periods [start, end) of the trading day `date`; empty when the day has no session. */\n  periods(date: DateNum): Array<[number, number]> {\n    let out = this.cache.get(date);\n    if (out) return out;\n    let periods: Period[] = [];\n    const correction = this.corrections.get(date);\n    if (correction !== undefined) {\n      periods = correction ?? [];\n    } else if (!this.holidays.has(date)) {\n      const version = [...this.versions].reverse().find((v) => v.from <= date)!;\n      if (version.byDay) periods = version.byDay[weekdayOf(date)]!;\n      else if (version.days[weekdayOf(date)]) periods = version.periods;\n    }\n    const y = Math.floor(date / 10000);\n    const m = Math.floor(date / 100) % 100;\n    const d = date % 100;\n    out = periods.map((p) => [\n      zonedToUnix(this.timezone, y, m, d - p.startOffset, Math.floor(p.start / 60), p.start % 60),\n      zonedToUnix(this.timezone, y, m, d - p.endOffset, Math.floor(p.end / 60), p.end % 60),\n    ]);\n    this.cache.set(date, out);\n    return out;\n  }\n\n  isTradingDay(date: DateNum): boolean {\n    return this.periods(date).length > 0;\n  }\n\n  /**\n   * True for a bar that opens after the session of its day was cut by a correction (an early close) but inside the\n   * usual hours of that day: PineScript has no period for such a bar (`time(\"D\")` is na on it).\n   */\n  afterEarlyClose(time: number): boolean {\n    const at = this.locate(time);\n    if (!at || at.inside || !this.corrections.get(at.date)) return false;\n    const version = [...this.versions].reverse().find((v) => v.from <= at.date)!;\n    const usual = version.byDay ? version.byDay[weekdayOf(at.date)]! : version.days[weekdayOf(at.date)] ? version.periods : [];\n    const y = Math.floor(at.date / 10000);\n    const m = Math.floor(at.date / 100) % 100;\n    const d = at.date % 100;\n    return usual.some(\n      (p) =>\n        zonedToUnix(this.timezone, y, m, d - p.startOffset, Math.floor(p.start / 60), p.start % 60) <= time &&\n        time < zonedToUnix(this.timezone, y, m, d - p.endOffset, Math.floor(p.end / 60), p.end % 60)\n    );\n  }\n\n  /**\n   * Trading day and period of a time: the period that contains it, else the last period that started\n   * before it. Null when no trading day is found near the time.\n   */\n  locate(time: number): { date: DateNum; index: number; inside: boolean } | null {\n    const f = zonedFields(time, this.timezone);\n    const local = toDateNum(f.year, f.month, f.day);\n    for (let k = 0; k <= 5; k++) {\n      const date = addDays(local, k);\n      const index = this.periods(date).findIndex(([s, e]) => s <= time && time < e);\n      if (index !== -1) return { date, index, inside: true };\n    }\n    for (let k = 5; k >= -7; k--) {\n      const date = addDays(local, k);\n      const periods = this.periods(date);\n      let index = -1;\n      periods.forEach(([s], i) => {\n        if (s <= time) index = i;\n      });\n      if (index !== -1) return { date, index, inside: false };\n    }\n    return null;\n  }\n\n  /** First trading day in [from, to] (dates), or null. */\n  firstTradingDay(from: DateNum, to: DateNum): DateNum | null {\n    for (let date = from; date <= to; date = addDays(date, 1)) if (this.isTradingDay(date)) return date;\n    return null;\n  }\n\n  /** Last trading day in [from, to] (dates), or null. */\n  lastTradingDay(from: DateNum, to: DateNum): DateNum | null {\n    for (let date = to; date >= from; date = addDays(date, -1)) if (this.isTradingDay(date)) return date;\n    return null;\n  }\n}\n\n/** Monday of the week of `date` (weeks run Monday to Sunday). */\nexport const weekStart = (date: DateNum): DateNum => addDays(date, -((weekdayOf(date) + 5) % 7));\n/** First day of the month of `date`. */\nexport const monthStart = (date: DateNum): DateNum => Math.floor(date / 100) * 100 + 1;\n/** Last day of the month of `date`. */\nexport const monthEnd = (date: DateNum): DateNum => addDays(monthStart(addDays(monthStart(date), 32)), -1);\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Trading calendar: the session periods of each trading day of a symbol, from the symbol session\n * information (issue #100).\n *\n * Session format (symbol session information, also PineScript session strings):\n * - periods \"HHMM-HHMM\", several separated by commas; \"24x7\" is the whole day, every day\n * - a period whose end is not after its start (\"1700-1600\", \"1700-1700\") starts the day before the\n *   trading day: the session that opens Sunday 17:00 is Monday's\n * - \"HHMMF<n>\" moves a time <n> days before the trading day (\"1700F2-1200F1\"); \"F\" alone is one day (\"1700F-1900\":\n *   17:00 of the day before to 19:00)\n * - several sections joined by \"|\", each with its own days (\"1900-1900:3456|1700F-1900:2\": Monday opens on Sunday\n *   17:00, the other days at 19:00 of the day before)\n * - optional days after \":\" (1 = Sunday ... 7 = Saturday); without days a symbol session trades Monday to\n *   Friday (\"24x7\": every day), and a PineScript session string follows PineScript's rules (one period:\n *   every day; several periods: Monday to Friday)\n * - \"#YYYYMMDD/<session>\" changes the session from that date (\"0900-1746#20251201/0800-2200\")\n * - corrections (\"session-correction\"): \"<session>:<dates>;dayoff:<dates>\" replace the session of these\n *   dates (early closes, days off); holidays (\"session_holidays\") are dates without session\n */\n\nimport { zonedFields, zonedToUnix } from '../time/timezone.js';\nimport { parsePineSession } from '../time/session.js';\n\n/** Session information of a symbol (hours, corrections, holidays). */\nexport interface SessionSpec {\n  /** Session hours: \"0930-1600\", \"1700-1600\", \"24x7\", \"0400-2000\" ... */\n  session: string;\n  /** Exceptions by date (symbol info \"session-correction\"): \"0930-1300:20251128,20251224;dayoff:20250109\" */\n  corrections?: string;\n  /** Exchange holidays as \"YYYYMMDD\" (symbol info \"session_holidays\"), comma-separated or as an array */\n  holidays?: string | string[];\n}\n\n/** Date as YYYYMMDD. */\nexport type DateNum = number;\n\ninterface Period {\n  /** Minutes after midnight */\n  start: number;\n  end: number;\n  /** Days before the trading day */\n  startOffset: number;\n  endOffset: number;\n}\n\ninterface Version {\n  from: DateNum;\n  periods: Period[];\n  /** Index 1 (Sunday) to 7 (Saturday) */\n  days: boolean[];\n  /** PineScript session strings: the periods of each weekday (index 1 to 7), from the \"|\" sections */\n  byDay?: Period[][];\n}\n\nexport const toDateNum = (y: number, m: number, d: number): DateNum => y * 10000 + m * 100 + d;\nconst utcOf = (date: DateNum): number => Date.UTC(Math.floor(date / 10000), Math.floor(date / 100) % 100 - 1, date % 100);\nconst fromUtc = (ms: number): DateNum => {\n  const d = new Date(ms);\n  return toDateNum(d.getUTCFullYear(), d.getUTCMonth() + 1, d.getUTCDate());\n};\nexport const addDays = (date: DateNum, n: number): DateNum => fromUtc(utcOf(date) + n * 86_400_000);\n/** 1 = Sunday ... 7 = Saturday */\nexport const weekdayOf = (date: DateNum): number => new Date(utcOf(date)).getUTCDay() + 1;\n/** 00:00 UTC of the date, in ms (PineScript `time_tradingday`). */\nexport const dateUtcMs = utcOf;\n\nfunction parseTime(token: string, spec: string): { minutes: number; offset?: number } {\n  const m = /^(\\d{2})(\\d{2})(?:F(\\d*))?$/.exec(token.trim());\n  if (!m) throw new SyntaxError(`Invalid session \"${spec}\"`);\n  // \"F\" without a number is one day before the trading day\n  return { minutes: Number(m[1]) * 60 + Number(m[2]), offset: m[3] === undefined ? undefined : Number(m[3] || 1) };\n}\n\nfunction parsePeriods(text: string, spec: string): Period[] {\n  if (text.trim() === '24x7') return [{ start: 0, end: 1440, startOffset: 0, endOffset: 0 }];\n  return text.split(',').map((p) => {\n    const [a = '', b = ''] = p.split('-');\n    const s = parseTime(a, spec);\n    const e = parseTime(b, spec);\n    if (s.minutes === 0 && e.minutes === 0 && s.offset === undefined && e.offset === undefined) {\n      return { start: 0, end: 1440, startOffset: 0, endOffset: 0 };\n    }\n    return {\n      start: s.minutes,\n      end: e.minutes,\n      startOffset: s.offset ?? (e.minutes <= s.minutes ? 1 : 0),\n      endOffset: e.offset ?? 0,\n    };\n  });\n}\n\n/** A PineScript session string as periods per weekday (rules in time/session.ts). */\nfunction pineVersion(text: string, from: DateNum): Version {\n  const ranges = parsePineSession(text);\n  if (ranges === null) throw new SyntaxError(`Session \"${text}\" is the symbol session`);\n  const byDay: Period[][] = Array.from({ length: 8 }, () => []);\n  for (const { start, end, days, startDays } of ranges) {\n    // a run that ends at 0000 ends at 24:00 of the day it starts and belongs to that day (#173)\n    const period: Period =\n      start === 0 && end === 0\n        ? { start: 0, end: 1440, startOffset: 0, endOffset: 0 }\n        : startDays !== undefined\n          ? { start, end, startOffset: startDays, endOffset: 0 }\n          : end === 0\n            ? { start, end: 1440, startOffset: 0, endOffset: 0 }\n            : { start, end, startOffset: end <= start ? 1 : 0, endOffset: 0 };\n    for (const d of days) byDay[d]!.push(period);\n  }\n  return { from, periods: [], days: byDay.map((p) => p.length > 0), byDay };\n}\n\nfunction parseVersion(text: string, from: DateNum, spec: string, rule: 'symbol' | 'pine'): Version {\n  if (rule === 'pine') return pineVersion(text, from);\n  if (text.includes('|')) {\n    // sections with their own days\n    const byDay: Period[][] = Array.from({ length: 8 }, () => []);\n    for (const section of text.split('|').filter((part) => part.trim())) {\n      const one = parseVersion(section, from, spec, rule);\n      one.days.forEach((on, d) => {\n        if (on) byDay[d] = one.periods;\n      });\n    }\n    return { from, periods: [], days: byDay.map((p) => p.length > 0), byDay };\n  }\n  const [periodText = '', dayText] = text.trim().split(':');\n  const periods = parsePeriods(periodText, spec);\n  const allDays = periodText.trim() === '24x7';\n  const digits = dayText ?? (allDays ? '1234567' : '23456');\n  if (!/^[1-7]+$/.test(digits)) throw new SyntaxError(`Invalid session days in \"${spec}\"`);\n  const days = new Array<boolean>(8).fill(false);\n  for (const d of digits) days[Number(d)] = true;\n  return { from, periods, days };\n}\n\n/** Session periods of every trading day of a symbol, as UNIX times (ms). */\nexport class TradingCalendar {\n  private readonly versions: Version[];\n  private readonly corrections = new Map<DateNum, Period[] | null>();\n  private readonly holidays: Set<DateNum>;\n  private readonly cache = new Map<DateNum, Array<[number, number]>>();\n  private readonly pine: boolean;\n\n  /**\n   * @param timezone - Time zone of the session hours (the exchange time zone)\n   * @param spec - Session information (hours, corrections, holidays)\n   * @param rule - Days without \":days\": 'symbol' (Monday to Friday) or 'pine' (PineScript session strings)\n   * @param dayPlacement - PineScript session strings read for `time(\"D\", session)`: the wall times of a clock-change\n   *   day are placed as the JVM does (see `periods`); without it, as `time.inSession` places them\n   */\n  constructor(\n    readonly timezone: string,\n    spec: SessionSpec,\n    rule: 'symbol' | 'pine' = 'symbol',\n    dayPlacement = false\n  ) {\n    this.pine = rule === 'pine' && dayPlacement;\n    const [first = '', ...changes] = spec.session.split('#');\n    this.versions = [parseVersion(first, 0, spec.session, rule)];\n    for (const change of changes) {\n      const m = /^(\\d{8})\\/(.+)$/.exec(change.trim());\n      if (!m) throw new SyntaxError(`Invalid session change in \"${spec.session}\"`);\n      this.versions.push(parseVersion(m[2]!, Number(m[1]), spec.session, rule));\n    }\n    for (const part of (spec.corrections ?? '').split(';').filter((p) => p.trim())) {\n      const i = part.lastIndexOf(':');\n      const text = part.slice(0, i).trim();\n      const periods = text === 'dayoff' ? null : parsePeriods(text, part);\n      for (const date of part.slice(i + 1).split(',')) this.corrections.set(Number(date), periods);\n    }\n    const holidays = Array.isArray(spec.holidays) ? spec.holidays : (spec.holidays ?? '').split(',');\n    this.holidays = new Set(holidays.filter((h) => h.trim()).map(Number));\n  }\n\n  /** Session periods [start, end) of the trading day `date`; empty when the day has no session. */\n  periods(date: DateNum): Array<[number, number]> {\n    let out = this.cache.get(date);\n    if (out) return out;\n    let periods: Period[] = [];\n    const correction = this.corrections.get(date);\n    if (correction !== undefined) {\n      periods = correction ?? [];\n    } else if (!this.holidays.has(date)) {\n      const version = [...this.versions].reverse().find((v) => v.from <= date)!;\n      if (version.byDay) periods = version.byDay[weekdayOf(date)]!;\n      else if (version.days[weekdayOf(date)]) periods = version.periods;\n    }\n    const y = Math.floor(date / 10000);\n    const m = Math.floor(date / 100) % 100;\n    const d = date % 100;\n    const at = (dd: number, minutes: number, earlier = false): number =>\n      zonedToUnix(this.timezone, y, m, dd, Math.floor(minutes / 60), minutes % 60, 0, earlier);\n    // for \"D\", PineScript session strings place the wall times of a clock-change day as the JVM does: a skipped time moves\n    // past the gap, a repeated time is its first pass, and the end is the minute before it plus one minute (\"0000-0300\"\n    // on a 02:00 -> 03:00 night ends at 03:00 of the old offset, \"0000-0400\" at 04:00 of the new one) (#173)\n    out = periods.map((p) =>\n      this.pine\n        ? [at(d - p.startOffset, p.start, true), at(d - p.endOffset, p.end - 1, true) + 60_000]\n        : [at(d - p.startOffset, p.start), at(d - p.endOffset, p.end)]\n    );\n    // for \"D\", the runs of a PineScript session string on one day are one period, from the earliest start to the\n    // latest end: the time between two runs is inside the day (#182)\n    if (this.pine && out.length > 1) out = [[Math.min(...out.map((p) => p[0])), Math.max(...out.map((p) => p[1]))]];\n    this.cache.set(date, out);\n    return out;\n  }\n\n  isTradingDay(date: DateNum): boolean {\n    return this.periods(date).length > 0;\n  }\n\n  /**\n   * True for a bar that opens after the session of its day was cut by a correction (an early close) but inside the\n   * usual hours of that day: PineScript has no period for such a bar (`time(\"D\")` is na on it).\n   */\n  afterEarlyClose(time: number): boolean {\n    const at = this.locate(time);\n    if (!at || at.inside || !this.corrections.get(at.date)) return false;\n    const version = [...this.versions].reverse().find((v) => v.from <= at.date)!;\n    const usual = version.byDay ? version.byDay[weekdayOf(at.date)]! : version.days[weekdayOf(at.date)] ? version.periods : [];\n    const y = Math.floor(at.date / 10000);\n    const m = Math.floor(at.date / 100) % 100;\n    const d = at.date % 100;\n    return usual.some(\n      (p) =>\n        zonedToUnix(this.timezone, y, m, d - p.startOffset, Math.floor(p.start / 60), p.start % 60) <= time &&\n        time < zonedToUnix(this.timezone, y, m, d - p.endOffset, Math.floor(p.end / 60), p.end % 60)\n    );\n  }\n\n  /**\n   * Trading day and period of a time: the period that contains it, else the last period that started\n   * before it. Null when no trading day is found near the time.\n   */\n  locate(time: number): { date: DateNum; index: number; inside: boolean } | null {\n    const f = zonedFields(time, this.timezone);\n    const local = toDateNum(f.year, f.month, f.day);\n    for (let k = 0; k <= 5; k++) {\n      const date = addDays(local, k);\n      const index = this.periods(date).findIndex(([s, e]) => s <= time && time < e);\n      if (index !== -1) return { date, index, inside: true };\n    }\n    for (let k = 5; k >= -7; k--) {\n      const date = addDays(local, k);\n      const periods = this.periods(date);\n      let index = -1;\n      periods.forEach(([s], i) => {\n        if (s <= time) index = i;\n      });\n      if (index !== -1) return { date, index, inside: false };\n    }\n    return null;\n  }\n\n  /** First trading day in [from, to] (dates), or null. */\n  firstTradingDay(from: DateNum, to: DateNum): DateNum | null {\n    for (let date = from; date <= to; date = addDays(date, 1)) if (this.isTradingDay(date)) return date;\n    return null;\n  }\n\n  /** Last trading day in [from, to] (dates), or null. */\n  lastTradingDay(from: DateNum, to: DateNum): DateNum | null {\n    for (let date = to; date >= from; date = addDays(date, -1)) if (this.isTradingDay(date)) return date;\n    return null;\n  }\n}\n\n/** Monday of the week of `date` (weeks run Monday to Sunday). */\nexport const weekStart = (date: DateNum): DateNum => addDays(date, -((weekdayOf(date) + 5) % 7));\n/** First day of the month of `date`. */\nexport const monthStart = (date: DateNum): DateNum => Math.floor(date / 100) * 100 + 1;\n/** Last day of the month of `date`. */\nexport const monthEnd = (date: DateNum): DateNum => addDays(monthStart(addDays(monthStart(date), 32)), -1);\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/cjs/session/context.d.ts

@@ -35,10 +35,26 @@ export interface ChartSessions {
  * @throws Error when the context has no timeframe, time zone or session
  */
 export declare function chartSessions(chart: SessionContext): ChartSessions;
-/** PineScript `time(timeframe)` (ms) of a bar that opens at `time`: the start of its period; NaN without one. */
-export declare function periodTime(time: number, timeframe: string, chart: SessionContext): number;
-/** PineScript `time_close(timeframe)` (ms) of a bar that opens at `time`. */
-export declare function periodClose(time: number, timeframe: string, chart: SessionContext): number;
+/** Open and close (ms) of the period that contains a bar opening at a time in ms; NaN outside the session. */
+export interface SessionPeriods {
+    open: (time: number) => number;
+    close: (time: number) => number;
+}
+/**
+ * `time(tf, session, timezone)` / `time_close(tf, session, timezone)` of a bar, as PineScript computes them (#173):
+ * an intraday timeframe tests the bar with the session rules of time.inSession and aligns its periods on the start
+ * of the run that contains the bar; "D" tests the bar against the day's session period (the calendar; the time
+ * between two runs of a day is inside it, #182); a timeframe of more than one day ("2D", "W", "M") has no test and
+ * keeps the period's time. `bars` is the calendar of the loaded session (`chartSessions(chart).bars`).
+ */
+export declare function sessionPeriods(bars: SessionBars, chart: SessionContext, timeframe: string, session?: string, timezone?: string): SessionPeriods;
+/**
+ * PineScript `time(timeframe, session, timezone)` (ms) of a bar that opens at `time`: the start of its period; NaN
+ * without one or outside `session` (#182). Without `session` and `timezone`, the periods of the loaded session.
+ */
+export declare function periodTime(time: number, timeframe: string, chart: SessionContext, session?: string, timezone?: string): number;
+/** PineScript `time_close(timeframe, session, timezone)` (ms) of a bar that opens at `time` (#182). */
+export declare function periodClose(time: number, timeframe: string, chart: SessionContext, session?: string, timezone?: string): number;
 /** PineScript `time_tradingday` (ms, 00:00 UTC of the trading day) of a bar that opens at `time`. */
 export declare function tradingDayTime(time: number, chart: SessionContext): number;
 /** PineScript `session.*` flags of bars that open at `times` (in order). */
@@ -69,7 +85,8 @@ export declare function barTimeAfter(time: number, count: number, chart: Session
  * Number of bars from the bar that opens at `from` to the bar that contains `to`, on the trading calendar of the
  * context (0 when `to` is in the bar of `from` or before it). For a drawing placed at a time after the last bar
  * (PineScript `time + n days` with `xloc.bar_time`): the chart shows it on the bar of that time, weekends and
- * holidays skipped. NaN when no bar is found within 100,000 bars.
+ * holidays skipped. `to` is first rounded to the nearest second, a half second going up (#174: 15 ms before a bar
+ * opens is on that bar, 501 ms before is on the bar before). NaN when no bar is found within 100,000 bars.
  */
 export declare function barsUntil(from: number, to: number, chart: SessionContext): number;
 //# sourceMappingURL=context.d.ts.map

package/dist/cjs/session/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/session/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAG7C,OAAO,EAAE,WAAW,EAAgB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAElE,6GAA6G;AAC7G,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC/B,sFAAsF;IACtF,cAAc,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IACtC,mDAAmD;IACnD,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;CACvB;AAED,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAKD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,CAgBlE;AAED,iHAAiH;AACjH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,CAGzF;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,CAG1F;AAED,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,CAG1E;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,cAAc,GAAG,YAAY,CAG/F;AAED,6GAA6G;AAC7G,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,qCAAqC;IACrC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gDAAgD;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,eAAe,CAyBtG;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,CAKvF;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,CAWjF"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/session/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAI7C,OAAO,EAAE,WAAW,EAA8B,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAElE,6GAA6G;AAC7G,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC/B,sFAAsF;IACtF,cAAc,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IACtC,mDAAmD;IACnD,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;CACvB;AAED,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAKD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,CAgBlE;AAED,8GAA8G;AAC9G,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACjC;AAgCD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,cAAc,CAyBhB;AAcD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9H;AAED,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG/H;AAED,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,CAG1E;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,cAAc,GAAG,YAAY,CAG/F;AAED,6GAA6G;AAC7G,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,qCAAqC;IACrC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gDAAgD;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,eAAe,CA0BtG;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,CAKvF;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,CAWjF"}

package/dist/cjs/session/context.js

@@ -25,11 +25,13 @@ __export(context_exports, {
   periodClose: () => periodClose,
   periodTime: () => periodTime,
   resampleSession: () => resampleSession,
+  sessionPeriods: () => sessionPeriods,
   tradingDayTime: () => tradingDayTime
 });
 module.exports = __toCommonJS(context_exports);
 var import_timeframe = require("../timeframe/index.js");
 var import_resample = require("../security/resample.js");
+var import_session = require("../time/session.js");
 var import_bars = require("./bars.js");
 var import_calendar = require("./calendar.js");
 const toSpec = (s) => typeof s === "string" ? { session: s } : s;
@@ -51,13 +53,71 @@ function chartSessions(chart) {
   cache.set(chart, out);
   return out;
 }
-function periodTime(time, timeframe, chart) {
-  const s = chartSessions(chart);
-  return s.bars.timeOf(time * s.unit, timeframe);
+function calendarFor(bars, chart, session, timezone, dayPlacement) {
+  if (!session && !timezone) return { bars, test: false };
+  const tz = timezone ?? chart.timezone;
+  if (session !== void 0 && (0, import_session.parsePineSession)(session) === null) {
+    const name = session.trim();
+    const symbol = name === "regular" && chart.regularSession ? chart.regularSession : chart.session;
+    return { bars: new import_bars.SessionBars(new import_calendar.TradingCalendar(tz, { session: toSpec(symbol).session }, "symbol"), bars.chart.period), test: true };
+  }
+  const spec = session ? { session } : { session: toSpec(chart.session).session };
+  return {
+    bars: new import_bars.SessionBars(new import_calendar.TradingCalendar(tz, spec, session ? "pine" : "symbol", dayPlacement), bars.chart.period),
+    test: true,
+    // a PineScript session string: the rules of time.inSession (runs ending at 0000, days around a clock change)
+    inside: session ? (time) => (0, import_session.sessionRun)(time, session, tz, (0, import_timeframe.in_seconds)(bars.chart.period) * 1e3) !== null : void 0
+  };
+}
+function sessionPeriods(bars, chart, timeframe, session, timezone) {
+  const tf = (0, import_timeframe.info)(timeframe);
+  const { bars: calendar, test, inside } = calendarFor(bars, chart, session, timezone, !tf.isintraday);
+  const open = (t) => calendar.timeOf(t, timeframe);
+  const close = (t) => calendar.closeOf(t, timeframe);
+  if (!test) return { open, close };
+  if (tf.isintraday) {
+    if (session !== void 0 && (0, import_session.parsePineSession)(session) !== null && !calendar.chart.isdwm) {
+      const tz = timezone ?? chart.timezone;
+      const barMs = (0, import_timeframe.in_seconds)(calendar.chart.period) * 1e3;
+      const ms = (0, import_timeframe.in_seconds)(tf.period) * 1e3;
+      const run = (t) => (0, import_session.sessionRun)(t, session, tz, barMs);
+      const start = (t, r) => r[0] + Math.floor((t - r[0]) / ms) * ms;
+      return {
+        open: (t) => {
+          const r = run(t);
+          return r ? start(t, r) : NaN;
+        },
+        close: (t) => {
+          const r = run(t);
+          return r ? Math.min(start(t, r) + ms, r[1]) : NaN;
+        }
+      };
+    }
+    const isIn = (t) => inside ? inside(t) : calendar.inside(t);
+    return { open: (t) => isIn(t) ? open(t) : NaN, close: (t) => isIn(t) ? close(t) : NaN };
+  }
+  if (tf.isdaily && tf.multiplier === 1) {
+    return { open: (t) => calendar.inside(t) ? open(t) : NaN, close: (t) => calendar.inside(t) ? close(t) : NaN };
+  }
+  return { open, close };
 }
-function periodClose(time, timeframe, chart) {
+const periodCache = /* @__PURE__ */ new WeakMap();
+function periodsOfChart(chart, timeframe, session, timezone) {
   const s = chartSessions(chart);
-  return s.bars.closeOf(time * s.unit, timeframe);
+  let byKey = periodCache.get(chart);
+  if (!byKey) periodCache.set(chart, byKey = /* @__PURE__ */ new Map());
+  const key = `${timeframe}|${session ?? ""}|${timezone ?? ""}`;
+  let p = byKey.get(key);
+  if (!p) byKey.set(key, p = sessionPeriods(s.bars, chart, timeframe, session, timezone));
+  return { s, p };
+}
+function periodTime(time, timeframe, chart, session, timezone) {
+  const { s, p } = periodsOfChart(chart, timeframe, session, timezone);
+  return p.open(time * s.unit);
+}
+function periodClose(time, timeframe, chart, session, timezone) {
+  const { s, p } = periodsOfChart(chart, timeframe, session, timezone);
+  return p.close(time * s.unit);
 }
 function tradingDayTime(time, chart) {
   const s = chartSessions(chart);
@@ -86,6 +146,7 @@ function resampleSession(bars, timeframe, chart) {
     const periods = at ? calendar.calendar.periods(at.date) : [];
     return periods.length ? calendar.timeOf(periods[0][0], tf.period) : starts[i];
   });
+  (0, import_bars.strayPeriods)(starts, dayPeriods, times, s.bars, tf.isdwm ? null : (0, import_timeframe.in_seconds)(tf.period) * 1e3);
   const reaches = times.map((t) => s.bars.closeOf(t, chartTf.period) >= calendar.periodEnd(t, tf.period));
   const { group, latest } = (0, import_resample.periodsOf)(starts, dayPeriods, reaches);
   const after = (0, import_resample.afterCompletion)(group, latest);
@@ -100,7 +161,7 @@ function barTimeAfter(time, count, chart) {
 }
 function barsUntil(from, to, chart) {
   const s = chartSessions(chart);
-  const target = to * s.unit;
+  const target = Math.floor(to * s.unit / 1e3 + 0.5) * 1e3;
   let t = from * s.unit;
   for (let k = 0; k < 1e5; k++) {
     const next = s.bars.nextBarTime(t);

package/dist/cjs/session/context.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/session/context.ts"],
-  "sourcesContent": ["/**\n * The session of a chart context, for code that does not run a whole script (a port with its own bar loop).\n *\n * The same values as the script API gives (`time(tf)`, `time_close(tf)`, `time_tradingday`, `session.*`, the periods\n * of `request.security`), from the session, corrections and holidays of the context. Bar times are in the unit of\n * the context (`timeUnit`, seconds by default, as `Bar.time`); PineScript time values are returned in ms.\n *\n * @module session/context\n */\n\nimport type { Bar } from '../types/index.js';\nimport { info, in_seconds } from '../timeframe/index.js';\nimport { afterCompletion, periodsOf, resample } from '../security/resample.js';\nimport { SessionBars, sessionFlags, type SessionFlags } from './bars.js';\nimport { TradingCalendar, type SessionSpec } from './calendar.js';\n\n/** The part of a chart context that the session functions read (a `ChartContext` of the script API fits). */\nexport interface SessionContext {\n  /** Chart timeframe: \"5\", \"60\", \"1D\"... */\n  timeframe?: string;\n  /** Exchange time zone: \"America/New_York\", \"Etc/UTC\"... */\n  timezone?: string;\n  /** Session of the loaded bars: hours, corrections, holidays */\n  session?: SessionSpec | string;\n  /** Regular trading hours when the bars include extended hours (default: `session`) */\n  regularSession?: SessionSpec | string;\n  /** Unit of the bar times: 's' (default) or 'ms' */\n  timeUnit?: 's' | 'ms';\n}\n\n/** The session calendars of a context: the loaded bars and the regular hours. */\nexport interface ChartSessions {\n  bars: SessionBars;\n  regular: SessionBars;\n  /** ms per unit of the bar times */\n  unit: number;\n}\n\nconst toSpec = (s: SessionSpec | string): SessionSpec => (typeof s === 'string' ? { session: s } : s);\nconst cache = new WeakMap<object, ChartSessions>();\n\n/**\n * Session calendars of a chart context (cached per context object).\n * @throws Error when the context has no timeframe, time zone or session\n */\nexport function chartSessions(chart: SessionContext): ChartSessions {\n  const cached = cache.get(chart);\n  if (cached) return cached;\n  const { timeframe, timezone, session } = chart;\n  if (!timeframe || !timezone || !session) {\n    throw new Error('The chart context needs timeframe, timezone and session for the session functions.');\n  }\n  const loaded = toSpec(session);\n  const regular = chart.regularSession ? toSpec(chart.regularSession) : loaded;\n  const out: ChartSessions = {\n    bars: new SessionBars(new TradingCalendar(timezone, loaded), timeframe),\n    regular: new SessionBars(new TradingCalendar(timezone, { holidays: loaded.holidays, ...regular }), timeframe),\n    unit: chart.timeUnit === 'ms' ? 1 : 1000,\n  };\n  cache.set(chart, out);\n  return out;\n}\n\n/** PineScript `time(timeframe)` (ms) of a bar that opens at `time`: the start of its period; NaN without one. */\nexport function periodTime(time: number, timeframe: string, chart: SessionContext): number {\n  const s = chartSessions(chart);\n  return s.bars.timeOf(time * s.unit, timeframe);\n}\n\n/** PineScript `time_close(timeframe)` (ms) of a bar that opens at `time`. */\nexport function periodClose(time: number, timeframe: string, chart: SessionContext): number {\n  const s = chartSessions(chart);\n  return s.bars.closeOf(time * s.unit, timeframe);\n}\n\n/** PineScript `time_tradingday` (ms, 00:00 UTC of the trading day) of a bar that opens at `time`. */\nexport function tradingDayTime(time: number, chart: SessionContext): number {\n  const s = chartSessions(chart);\n  return s.bars.tradingDayTime(time * s.unit);\n}\n\n/** PineScript `session.*` flags of bars that open at `times` (in order). */\nexport function chartSessionFlags(times: ArrayLike<number>, chart: SessionContext): SessionFlags {\n  const s = chartSessions(chart);\n  return sessionFlags(Array.from(times, (t) => t * s.unit), s.bars, s.regular);\n}\n\n/** Higher-timeframe bars of the chart bars and what `mapToChart` needs to bring values back to the chart. */\nexport interface SessionResample {\n  /** Bars of `timeframe`, built from the chart bars */\n  bars: Bar[];\n  /** Period index of each chart bar */\n  group: number[];\n  /** Latest completed period at each chart bar */\n  latest: number[];\n}\n\n/**\n * Same-symbol `request.security` on a timeframe equal to or higher than the chart's, with the session of the context:\n * D / W / M periods follow the regular hours, corrections and holidays; intraday periods the loaded session.\n * Compute on `bars`, then bring each value series back with `mapToChart(values, group, latest, lookahead, gaps)`.\n * @throws Error when `timeframe` is lower than the chart timeframe\n */\nexport function resampleSession(bars: Bar[], timeframe: string, chart: SessionContext): SessionResample {\n  const s = chartSessions(chart);\n  const chartTf = s.bars.chart;\n  const tf = info(timeframe || chartTf.period);\n  if (tf.period === chartTf.period) {\n    const group = bars.map((_, i) => i);\n    return { bars, group, latest: group };\n  }\n  if (in_seconds(tf.period) < in_seconds(chartTf.period)) {\n    throw new Error(`resampleSession: timeframe \"${tf.period}\" is lower than the chart timeframe \"${chartTf.period}\".`);\n  }\n  const times = bars.map((b) => (b.time as number) * s.unit);\n  const calendar = tf.isdwm ? s.regular : s.bars;\n  const starts = times.map((t) => calendar.timeOf(t, tf.period));\n  const dayPeriods = times.map((t, i) => {\n    const at = s.bars.calendar.locate(t);\n    const periods = at ? calendar.calendar.periods(at.date) : [];\n    return periods.length ? calendar.timeOf(periods[0]![0], tf.period) : starts[i]!;\n  });\n  const reaches = times.map((t) => s.bars.closeOf(t, chartTf.period) >= calendar.periodEnd(t, tf.period));\n  const { group, latest } = periodsOf(starts, dayPeriods, reaches);\n  // a higher-timeframe bar ends at the bar that completes it (no value from after the completion)\n  const after = afterCompletion(group, latest);\n  const kept = (_: unknown, i: number): boolean => !after[i];\n  return { bars: resample(bars.filter(kept), starts.map((x) => x / s.unit).filter(kept)).bars, group, latest };\n}\n\n/**\n * Open time of the `count`-th bar after the bar that opens at `time`, on the trading calendar of the context: the\n * closed hours, weekends, holidays and days off are skipped. `count` 0 is the bar itself. For a drawing that ends\n * `count` bars after the last bar (PineScript `bar_index + count`).\n */\nexport function barTimeAfter(time: number, count: number, chart: SessionContext): number {\n  const s = chartSessions(chart);\n  let t = time * s.unit;\n  for (let k = 0; k < count && !Number.isNaN(t); k++) t = s.bars.nextBarTime(t);\n  return t / s.unit;\n}\n\n/**\n * Number of bars from the bar that opens at `from` to the bar that contains `to`, on the trading calendar of the\n * context (0 when `to` is in the bar of `from` or before it). For a drawing placed at a time after the last bar\n * (PineScript `time + n days` with `xloc.bar_time`): the chart shows it on the bar of that time, weekends and\n * holidays skipped. NaN when no bar is found within 100,000 bars.\n */\nexport function barsUntil(from: number, to: number, chart: SessionContext): number {\n  const s = chartSessions(chart);\n  const target = to * s.unit;\n  let t = from * s.unit;\n  for (let k = 0; k < 100_000; k++) {\n    const next = s.bars.nextBarTime(t);\n    if (Number.isNaN(next)) return NaN;\n    if (next > target) return k;\n    t = next;\n  }\n  return NaN;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * The session of a chart context, for code that does not run a whole script (a port with its own bar loop).\n *\n * The same values as the script API gives (`time(tf)`, `time_close(tf)`, `time_tradingday`, `session.*`, the periods\n * of `request.security`), from the session, corrections and holidays of the context. Bar times are in the unit of\n * the context (`timeUnit`, seconds by default, as `Bar.time`); PineScript time values are returned in ms.\n *\n * @module session/context\n */\n\nimport type { Bar } from '../types/index.js';\nimport { info, in_seconds } from '../timeframe/index.js';\nimport { afterCompletion, periodsOf, resample } from '../security/resample.js';\nimport { parsePineSession, sessionRun } from '../time/session.js';\nimport { SessionBars, sessionFlags, strayPeriods, type SessionFlags } from './bars.js';\nimport { TradingCalendar, type SessionSpec } from './calendar.js';\n\n/** The part of a chart context that the session functions read (a `ChartContext` of the script API fits). */\nexport interface SessionContext {\n  /** Chart timeframe: \"5\", \"60\", \"1D\"... */\n  timeframe?: string;\n  /** Exchange time zone: \"America/New_York\", \"Etc/UTC\"... */\n  timezone?: string;\n  /** Session of the loaded bars: hours, corrections, holidays */\n  session?: SessionSpec | string;\n  /** Regular trading hours when the bars include extended hours (default: `session`) */\n  regularSession?: SessionSpec | string;\n  /** Unit of the bar times: 's' (default) or 'ms' */\n  timeUnit?: 's' | 'ms';\n}\n\n/** The session calendars of a context: the loaded bars and the regular hours. */\nexport interface ChartSessions {\n  bars: SessionBars;\n  regular: SessionBars;\n  /** ms per unit of the bar times */\n  unit: number;\n}\n\nconst toSpec = (s: SessionSpec | string): SessionSpec => (typeof s === 'string' ? { session: s } : s);\nconst cache = new WeakMap<object, ChartSessions>();\n\n/**\n * Session calendars of a chart context (cached per context object).\n * @throws Error when the context has no timeframe, time zone or session\n */\nexport function chartSessions(chart: SessionContext): ChartSessions {\n  const cached = cache.get(chart);\n  if (cached) return cached;\n  const { timeframe, timezone, session } = chart;\n  if (!timeframe || !timezone || !session) {\n    throw new Error('The chart context needs timeframe, timezone and session for the session functions.');\n  }\n  const loaded = toSpec(session);\n  const regular = chart.regularSession ? toSpec(chart.regularSession) : loaded;\n  const out: ChartSessions = {\n    bars: new SessionBars(new TradingCalendar(timezone, loaded), timeframe),\n    regular: new SessionBars(new TradingCalendar(timezone, { holidays: loaded.holidays, ...regular }), timeframe),\n    unit: chart.timeUnit === 'ms' ? 1 : 1000,\n  };\n  cache.set(chart, out);\n  return out;\n}\n\n/** Open and close (ms) of the period that contains a bar opening at a time in ms; NaN outside the session. */\nexport interface SessionPeriods {\n  open: (time: number) => number;\n  close: (time: number) => number;\n}\n\n/**\n * Calendar for the `session` / `timezone` arguments of `time(tf, session, timezone)`. Without both: the loaded\n * session. As in PineScript, an explicit time zone reads the symbol session hours in that zone without corrections\n * and holidays, and an explicit session follows PineScript's session string rules.\n */\nfunction calendarFor(\n  bars: SessionBars,\n  chart: SessionContext,\n  session: string | undefined,\n  timezone: string | undefined,\n  dayPlacement: boolean\n): { bars: SessionBars; test: boolean; inside?: (time: number) => boolean } {\n  if (!session && !timezone) return { bars, test: false };\n  const tz = timezone ?? chart.timezone!;\n  // a session string that is empty or does not start with a digit is the symbol session: \"regular\" the regular\n  // hours, \"extended\" and any other name the loaded hours (PineScript)\n  if (session !== undefined && parsePineSession(session) === null) {\n    const name = session.trim();\n    const symbol = name === 'regular' && chart.regularSession ? chart.regularSession : chart.session!;\n    return { bars: new SessionBars(new TradingCalendar(tz, { session: toSpec(symbol).session }, 'symbol'), bars.chart.period), test: true };\n  }\n  const spec = session ? { session } : { session: toSpec(chart.session!).session };\n  return {\n    bars: new SessionBars(new TradingCalendar(tz, spec, session ? 'pine' : 'symbol', dayPlacement), bars.chart.period),\n    test: true,\n    // a PineScript session string: the rules of time.inSession (runs ending at 0000, days around a clock change)\n    inside: session ? (time) => sessionRun(time, session, tz, in_seconds(bars.chart.period) * 1000) !== null : undefined,\n  };\n}\n\n/**\n * `time(tf, session, timezone)` / `time_close(tf, session, timezone)` of a bar, as PineScript computes them (#173):\n * an intraday timeframe tests the bar with the session rules of time.inSession and aligns its periods on the start\n * of the run that contains the bar; \"D\" tests the bar against the day's session period (the calendar; the time\n * between two runs of a day is inside it, #182); a timeframe of more than one day (\"2D\", \"W\", \"M\") has no test and\n * keeps the period's time. `bars` is the calendar of the loaded session (`chartSessions(chart).bars`).\n */\nexport function sessionPeriods(\n  bars: SessionBars,\n  chart: SessionContext,\n  timeframe: string,\n  session?: string,\n  timezone?: string\n): SessionPeriods {\n  const tf = info(timeframe);\n  const { bars: calendar, test, inside } = calendarFor(bars, chart, session, timezone, !tf.isintraday);\n  const open = (t: number): number => calendar.timeOf(t, timeframe);\n  const close = (t: number): number => calendar.closeOf(t, timeframe);\n  if (!test) return { open, close };\n  if (tf.isintraday) {\n    if (session !== undefined && parsePineSession(session) !== null && !calendar.chart.isdwm) {\n      const tz = timezone ?? chart.timezone!;\n      const barMs = in_seconds(calendar.chart.period) * 1000;\n      const ms = in_seconds(tf.period) * 1000;\n      const run = (t: number) => sessionRun(t, session, tz, barMs);\n      const start = (t: number, r: [number, number]) => r[0] + Math.floor((t - r[0]) / ms) * ms;\n      return {\n        open: (t) => { const r = run(t); return r ? start(t, r) : NaN; },\n        close: (t) => { const r = run(t); return r ? Math.min(start(t, r) + ms, r[1]) : NaN; },\n      };\n    }\n    const isIn = (t: number) => (inside ? inside(t) : calendar.inside(t));\n    return { open: (t) => (isIn(t) ? open(t) : NaN), close: (t) => (isIn(t) ? close(t) : NaN) };\n  }\n  if (tf.isdaily && tf.multiplier === 1) {\n    return { open: (t) => (calendar.inside(t) ? open(t) : NaN), close: (t) => (calendar.inside(t) ? close(t) : NaN) };\n  }\n  return { open, close };\n}\n\nconst periodCache = new WeakMap<object, Map<string, SessionPeriods>>();\n\nfunction periodsOfChart(chart: SessionContext, timeframe: string, session?: string, timezone?: string): { s: ChartSessions; p: SessionPeriods } {\n  const s = chartSessions(chart);\n  let byKey = periodCache.get(chart);\n  if (!byKey) periodCache.set(chart, (byKey = new Map()));\n  const key = `${timeframe}|${session ?? ''}|${timezone ?? ''}`;\n  let p = byKey.get(key);\n  if (!p) byKey.set(key, (p = sessionPeriods(s.bars, chart, timeframe, session, timezone)));\n  return { s, p };\n}\n\n/**\n * PineScript `time(timeframe, session, timezone)` (ms) of a bar that opens at `time`: the start of its period; NaN\n * without one or outside `session` (#182). Without `session` and `timezone`, the periods of the loaded session.\n */\nexport function periodTime(time: number, timeframe: string, chart: SessionContext, session?: string, timezone?: string): number {\n  const { s, p } = periodsOfChart(chart, timeframe, session, timezone);\n  return p.open(time * s.unit);\n}\n\n/** PineScript `time_close(timeframe, session, timezone)` (ms) of a bar that opens at `time` (#182). */\nexport function periodClose(time: number, timeframe: string, chart: SessionContext, session?: string, timezone?: string): number {\n  const { s, p } = periodsOfChart(chart, timeframe, session, timezone);\n  return p.close(time * s.unit);\n}\n\n/** PineScript `time_tradingday` (ms, 00:00 UTC of the trading day) of a bar that opens at `time`. */\nexport function tradingDayTime(time: number, chart: SessionContext): number {\n  const s = chartSessions(chart);\n  return s.bars.tradingDayTime(time * s.unit);\n}\n\n/** PineScript `session.*` flags of bars that open at `times` (in order). */\nexport function chartSessionFlags(times: ArrayLike<number>, chart: SessionContext): SessionFlags {\n  const s = chartSessions(chart);\n  return sessionFlags(Array.from(times, (t) => t * s.unit), s.bars, s.regular);\n}\n\n/** Higher-timeframe bars of the chart bars and what `mapToChart` needs to bring values back to the chart. */\nexport interface SessionResample {\n  /** Bars of `timeframe`, built from the chart bars */\n  bars: Bar[];\n  /** Period index of each chart bar */\n  group: number[];\n  /** Latest completed period at each chart bar */\n  latest: number[];\n}\n\n/**\n * Same-symbol `request.security` on a timeframe equal to or higher than the chart's, with the session of the context:\n * D / W / M periods follow the regular hours, corrections and holidays; intraday periods the loaded session.\n * Compute on `bars`, then bring each value series back with `mapToChart(values, group, latest, lookahead, gaps)`.\n * @throws Error when `timeframe` is lower than the chart timeframe\n */\nexport function resampleSession(bars: Bar[], timeframe: string, chart: SessionContext): SessionResample {\n  const s = chartSessions(chart);\n  const chartTf = s.bars.chart;\n  const tf = info(timeframe || chartTf.period);\n  if (tf.period === chartTf.period) {\n    const group = bars.map((_, i) => i);\n    return { bars, group, latest: group };\n  }\n  if (in_seconds(tf.period) < in_seconds(chartTf.period)) {\n    throw new Error(`resampleSession: timeframe \"${tf.period}\" is lower than the chart timeframe \"${chartTf.period}\".`);\n  }\n  const times = bars.map((b) => (b.time as number) * s.unit);\n  const calendar = tf.isdwm ? s.regular : s.bars;\n  const starts = times.map((t) => calendar.timeOf(t, tf.period));\n  const dayPeriods = times.map((t, i) => {\n    const at = s.bars.calendar.locate(t);\n    const periods = at ? calendar.calendar.periods(at.date) : [];\n    return periods.length ? calendar.timeOf(periods[0]![0], tf.period) : starts[i]!;\n  });\n  strayPeriods(starts, dayPeriods, times, s.bars, tf.isdwm ? null : in_seconds(tf.period) * 1000);\n  const reaches = times.map((t) => s.bars.closeOf(t, chartTf.period) >= calendar.periodEnd(t, tf.period));\n  const { group, latest } = periodsOf(starts, dayPeriods, reaches);\n  // a higher-timeframe bar ends at the bar that completes it (no value from after the completion)\n  const after = afterCompletion(group, latest);\n  const kept = (_: unknown, i: number): boolean => !after[i];\n  return { bars: resample(bars.filter(kept), starts.map((x) => x / s.unit).filter(kept)).bars, group, latest };\n}\n\n/**\n * Open time of the `count`-th bar after the bar that opens at `time`, on the trading calendar of the context: the\n * closed hours, weekends, holidays and days off are skipped. `count` 0 is the bar itself. For a drawing that ends\n * `count` bars after the last bar (PineScript `bar_index + count`).\n */\nexport function barTimeAfter(time: number, count: number, chart: SessionContext): number {\n  const s = chartSessions(chart);\n  let t = time * s.unit;\n  for (let k = 0; k < count && !Number.isNaN(t); k++) t = s.bars.nextBarTime(t);\n  return t / s.unit;\n}\n\n/**\n * Number of bars from the bar that opens at `from` to the bar that contains `to`, on the trading calendar of the\n * context (0 when `to` is in the bar of `from` or before it). For a drawing placed at a time after the last bar\n * (PineScript `time + n days` with `xloc.bar_time`): the chart shows it on the bar of that time, weekends and\n * holidays skipped. `to` is first rounded to the nearest second, a half second going up (#174: 15 ms before a bar\n * opens is on that bar, 501 ms before is on the bar before). NaN when no bar is found within 100,000 bars.\n */\nexport function barsUntil(from: number, to: number, chart: SessionContext): number {\n  const s = chartSessions(chart);\n  const target = Math.floor((to * s.unit) / 1000 + 0.5) * 1000;\n  let t = from * s.unit;\n  for (let k = 0; k < 100_000; k++) {\n    const next = s.bars.nextBarTime(t);\n    if (Number.isNaN(next)) return NaN;\n    if (next > target) return k;\n    t = next;\n  }\n  return NaN;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWA,uBAAiC;AACjC,sBAAqD;AACrD,qBAA6C;AAC7C,kBAA2E;AAC3E,sBAAkD;AAwBlD,MAAM,SAAS,CAAC,MAA0C,OAAO,MAAM,WAAW,EAAE,SAAS,EAAE,IAAI;AACnG,MAAM,QAAQ,oBAAI,QAA+B;AAM1C,SAAS,cAAc,OAAsC;AAClE,QAAM,SAAS,MAAM,IAAI,KAAK;AAC9B,MAAI,OAAQ,QAAO;AACnB,QAAM,EAAE,WAAW,UAAU,QAAQ,IAAI;AACzC,MAAI,CAAC,aAAa,CAAC,YAAY,CAAC,SAAS;AACvC,UAAM,IAAI,MAAM,oFAAoF;AAAA,EACtG;AACA,QAAM,SAAS,OAAO,OAAO;AAC7B,QAAM,UAAU,MAAM,iBAAiB,OAAO,MAAM,cAAc,IAAI;AACtE,QAAM,MAAqB;AAAA,IACzB,MAAM,IAAI,wBAAY,IAAI,gCAAgB,UAAU,MAAM,GAAG,SAAS;AAAA,IACtE,SAAS,IAAI,wBAAY,IAAI,gCAAgB,UAAU,EAAE,UAAU,OAAO,UAAU,GAAG,QAAQ,CAAC,GAAG,SAAS;AAAA,IAC5G,MAAM,MAAM,aAAa,OAAO,IAAI;AAAA,EACtC;AACA,QAAM,IAAI,OAAO,GAAG;AACpB,SAAO;AACT;AAaA,SAAS,YACP,MACA,OACA,SACA,UACA,cAC0E;AAC1E,MAAI,CAAC,WAAW,CAAC,SAAU,QAAO,EAAE,MAAM,MAAM,MAAM;AACtD,QAAM,KAAK,YAAY,MAAM;AAG7B,MAAI,YAAY,cAAa,iCAAiB,OAAO,MAAM,MAAM;AAC/D,UAAM,OAAO,QAAQ,KAAK;AAC1B,UAAM,SAAS,SAAS,aAAa,MAAM,iBAAiB,MAAM,iBAAiB,MAAM;AACzF,WAAO,EAAE,MAAM,IAAI,wBAAY,IAAI,gCAAgB,IAAI,EAAE,SAAS,OAAO,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,MAAM,MAAM,GAAG,MAAM,KAAK;AAAA,EACxI;AACA,QAAM,OAAO,UAAU,EAAE,QAAQ,IAAI,EAAE,SAAS,OAAO,MAAM,OAAQ,EAAE,QAAQ;AAC/E,SAAO;AAAA,IACL,MAAM,IAAI,wBAAY,IAAI,gCAAgB,IAAI,MAAM,UAAU,SAAS,UAAU,YAAY,GAAG,KAAK,MAAM,MAAM;AAAA,IACjH,MAAM;AAAA;AAAA,IAEN,QAAQ,UAAU,CAAC,aAAS,2BAAW,MAAM,SAAS,QAAI,6BAAW,KAAK,MAAM,MAAM,IAAI,GAAI,MAAM,OAAO;AAAA,EAC7G;AACF;AASO,SAAS,eACd,MACA,OACA,WACA,SACA,UACgB;AAChB,QAAM,SAAK,uBAAK,SAAS;AACzB,QAAM,EAAE,MAAM,UAAU,MAAM,OAAO,IAAI,YAAY,MAAM,OAAO,SAAS,UAAU,CAAC,GAAG,UAAU;AACnG,QAAM,OAAO,CAAC,MAAsB,SAAS,OAAO,GAAG,SAAS;AAChE,QAAM,QAAQ,CAAC,MAAsB,SAAS,QAAQ,GAAG,SAAS;AAClE,MAAI,CAAC,KAAM,QAAO,EAAE,MAAM,MAAM;AAChC,MAAI,GAAG,YAAY;AACjB,QAAI,YAAY,cAAa,iCAAiB,OAAO,MAAM,QAAQ,CAAC,SAAS,MAAM,OAAO;AACxF,YAAM,KAAK,YAAY,MAAM;AAC7B,YAAM,YAAQ,6BAAW,SAAS,MAAM,MAAM,IAAI;AAClD,YAAM,SAAK,6BAAW,GAAG,MAAM,IAAI;AACnC,YAAM,MAAM,CAAC,UAAc,2BAAW,GAAG,SAAS,IAAI,KAAK;AAC3D,YAAM,QAAQ,CAAC,GAAW,MAAwB,EAAE,CAAC,IAAI,KAAK,OAAO,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI;AACvF,aAAO;AAAA,QACL,MAAM,CAAC,MAAM;AAAE,gBAAM,IAAI,IAAI,CAAC;AAAG,iBAAO,IAAI,MAAM,GAAG,CAAC,IAAI;AAAA,QAAK;AAAA,QAC/D,OAAO,CAAC,MAAM;AAAE,gBAAM,IAAI,IAAI,CAAC;AAAG,iBAAO,IAAI,KAAK,IAAI,MAAM,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI;AAAA,QAAK;AAAA,MACvF;AAAA,IACF;AACA,UAAM,OAAO,CAAC,MAAe,SAAS,OAAO,CAAC,IAAI,SAAS,OAAO,CAAC;AACnE,WAAO,EAAE,MAAM,CAAC,MAAO,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAM,OAAO,CAAC,MAAO,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,IAAK;AAAA,EAC5F;AACA,MAAI,GAAG,WAAW,GAAG,eAAe,GAAG;AACrC,WAAO,EAAE,MAAM,CAAC,MAAO,SAAS,OAAO,CAAC,IAAI,KAAK,CAAC,IAAI,KAAM,OAAO,CAAC,MAAO,SAAS,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,IAAK;AAAA,EAClH;AACA,SAAO,EAAE,MAAM,MAAM;AACvB;AAEA,MAAM,cAAc,oBAAI,QAA6C;AAErE,SAAS,eAAe,OAAuB,WAAmB,SAAkB,UAA4D;AAC9I,QAAM,IAAI,cAAc,KAAK;AAC7B,MAAI,QAAQ,YAAY,IAAI,KAAK;AACjC,MAAI,CAAC,MAAO,aAAY,IAAI,OAAQ,QAAQ,oBAAI,IAAI,CAAE;AACtD,QAAM,MAAM,GAAG,SAAS,IAAI,WAAW,EAAE,IAAI,YAAY,EAAE;AAC3D,MAAI,IAAI,MAAM,IAAI,GAAG;AACrB,MAAI,CAAC,EAAG,OAAM,IAAI,KAAM,IAAI,eAAe,EAAE,MAAM,OAAO,WAAW,SAAS,QAAQ,CAAE;AACxF,SAAO,EAAE,GAAG,EAAE;AAChB;AAMO,SAAS,WAAW,MAAc,WAAmB,OAAuB,SAAkB,UAA2B;AAC9H,QAAM,EAAE,GAAG,EAAE,IAAI,eAAe,OAAO,WAAW,SAAS,QAAQ;AACnE,SAAO,EAAE,KAAK,OAAO,EAAE,IAAI;AAC7B;AAGO,SAAS,YAAY,MAAc,WAAmB,OAAuB,SAAkB,UAA2B;AAC/H,QAAM,EAAE,GAAG,EAAE,IAAI,eAAe,OAAO,WAAW,SAAS,QAAQ;AACnE,SAAO,EAAE,MAAM,OAAO,EAAE,IAAI;AAC9B;AAGO,SAAS,eAAe,MAAc,OAA+B;AAC1E,QAAM,IAAI,cAAc,KAAK;AAC7B,SAAO,EAAE,KAAK,eAAe,OAAO,EAAE,IAAI;AAC5C;AAGO,SAAS,kBAAkB,OAA0B,OAAqC;AAC/F,QAAM,IAAI,cAAc,KAAK;AAC7B,aAAO,0BAAa,MAAM,KAAK,OAAO,CAAC,MAAM,IAAI,EAAE,IAAI,GAAG,EAAE,MAAM,EAAE,OAAO;AAC7E;AAkBO,SAAS,gBAAgB,MAAa,WAAmB,OAAwC;AACtG,QAAM,IAAI,cAAc,KAAK;AAC7B,QAAM,UAAU,EAAE,KAAK;AACvB,QAAM,SAAK,uBAAK,aAAa,QAAQ,MAAM;AAC3C,MAAI,GAAG,WAAW,QAAQ,QAAQ;AAChC,UAAMA,SAAQ,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC;AAClC,WAAO,EAAE,MAAM,OAAAA,QAAO,QAAQA,OAAM;AAAA,EACtC;AACA,UAAI,6BAAW,GAAG,MAAM,QAAI,6BAAW,QAAQ,MAAM,GAAG;AACtD,UAAM,IAAI,MAAM,+BAA+B,GAAG,MAAM,wCAAwC,QAAQ,MAAM,IAAI;AAAA,EACpH;AACA,QAAM,QAAQ,KAAK,IAAI,CAAC,MAAO,EAAE,OAAkB,EAAE,IAAI;AACzD,QAAM,WAAW,GAAG,QAAQ,EAAE,UAAU,EAAE;AAC1C,QAAM,SAAS,MAAM,IAAI,CAAC,MAAM,SAAS,OAAO,GAAG,GAAG,MAAM,CAAC;AAC7D,QAAM,aAAa,MAAM,IAAI,CAAC,GAAG,MAAM;AACrC,UAAM,KAAK,EAAE,KAAK,SAAS,OAAO,CAAC;AACnC,UAAM,UAAU,KAAK,SAAS,SAAS,QAAQ,GAAG,IAAI,IAAI,CAAC;AAC3D,WAAO,QAAQ,SAAS,SAAS,OAAO,QAAQ,CAAC,EAAG,CAAC,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC;AAAA,EAC/E,CAAC;AACD,gCAAa,QAAQ,YAAY,OAAO,EAAE,MAAM,GAAG,QAAQ,WAAO,6BAAW,GAAG,MAAM,IAAI,GAAI;AAC9F,QAAM,UAAU,MAAM,IAAI,CAAC,MAAM,EAAE,KAAK,QAAQ,GAAG,QAAQ,MAAM,KAAK,SAAS,UAAU,GAAG,GAAG,MAAM,CAAC;AACtG,QAAM,EAAE,OAAO,OAAO,QAAI,2BAAU,QAAQ,YAAY,OAAO;AAE/D,QAAM,YAAQ,iCAAgB,OAAO,MAAM;AAC3C,QAAM,OAAO,CAAC,GAAY,MAAuB,CAAC,MAAM,CAAC;AACzD,SAAO,EAAE,UAAM,0BAAS,KAAK,OAAO,IAAI,GAAG,OAAO,IAAI,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,OAAO,IAAI,CAAC,EAAE,MAAM,OAAO,OAAO;AAC7G;AAOO,SAAS,aAAa,MAAc,OAAe,OAA+B;AACvF,QAAM,IAAI,cAAc,KAAK;AAC7B,MAAI,IAAI,OAAO,EAAE;AACjB,WAAS,IAAI,GAAG,IAAI,SAAS,CAAC,OAAO,MAAM,CAAC,GAAG,IAAK,KAAI,EAAE,KAAK,YAAY,CAAC;AAC5E,SAAO,IAAI,EAAE;AACf;AASO,SAAS,UAAU,MAAc,IAAY,OAA+B;AACjF,QAAM,IAAI,cAAc,KAAK;AAC7B,QAAM,SAAS,KAAK,MAAO,KAAK,EAAE,OAAQ,MAAO,GAAG,IAAI;AACxD,MAAI,IAAI,OAAO,EAAE;AACjB,WAAS,IAAI,GAAG,IAAI,KAAS,KAAK;AAChC,UAAM,OAAO,EAAE,KAAK,YAAY,CAAC;AACjC,QAAI,OAAO,MAAM,IAAI,EAAG,QAAO;AAC/B,QAAI,OAAO,OAAQ,QAAO;AAC1B,QAAI;AAAA,EACN;AACA,SAAO;AACT;",
   "names": ["group"]
 }

package/dist/cjs/str/floatingdecimal.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Decimal digits of a double as PineScript's plain `str.tostring` produces them.
+ *
+ * PineScript formats a number without a format with the digits of the classic binary to decimal conversion of the
+ * JVM (the one `Double.toString` used before Java 19), then rounds them to 10 decimals half to even, with two
+ * flags of the conversion deciding a tie on the last digit: digits that were rounded up are not rounded up again,
+ * digits that were cut on a '5' are. These digits are not always the shortest ones: 78195689105219552 keeps all
+ * its digits (the shortest form is 78195689105219550), and 1990736.000001111 has 16 digits where rounding the exact
+ * value would give 1990736.0000011111 (#174).
+ */
+/** Digits d1d2d3... of |x| = 0.d1d2d3... × 10^decExponent, with the flags of the conversion. */
+export interface ConvertedDigits {
+    digits: string;
+    decExponent: number;
+    /** The last digit was rounded up */
+    roundedUp: boolean;
+    /** The digits are the exact value of the double */
+    exact: boolean;
+}
+/** Digits of a positive finite double, as the JVM converter gives them. */
+export declare function convertDouble(x: number): ConvertedDigits;
+/**
+ * `|x|` with at most `maxFrac` decimals, as the JVM's decimal formatter rounds the converted digits (half to even;
+ * a tie on the last converted digit is decided by the conversion flags). Returns the digits and the position of the
+ * decimal point (value = 0.digits × 10^intLen); "" for zero.
+ */
+export declare function javaFixedDigits(x: number, maxFrac: number): {
+    digits: string;
+    intLen: number;
+};
+//# sourceMappingURL=floatingdecimal.d.ts.map

package/dist/cjs/str/floatingdecimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floatingdecimal.d.ts","sourceRoot":"","sources":["../../../src/str/floatingdecimal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gGAAgG;AAChG,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,KAAK,EAAE,OAAO,CAAC;CAChB;AAqCD,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,eAAe,CAuJxD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAoD9F"}