oakscriptjs 0.10.1 → 0.11.0

package/dist/cjs/script/index.js

@@ -52,6 +52,7 @@ __export(script_exports, {
   hlc3: () => hlc3,
   hlcc4: () => hlcc4,
   hline: () => hline,
+  holdDrawing: () => import_registry2.holdDrawing,
   hour: () => hour,
   inSession: () => inSession,
   indicator: () => indicator,
@@ -76,6 +77,7 @@ __export(script_exports, {
   plotshape: () => plotshape,
   polyline: () => polyline,
   position: () => import_types.position,
+  releaseDrawing: () => import_registry2.releaseDrawing,
   request: () => request,
   second: () => second,
   seriesOf: () => seriesOf,
@@ -91,7 +93,9 @@ __export(script_exports, {
   time_close: () => time_close,
   time_tradingday: () => time_tradingday,
   timeframe: () => timeframe,
+  timenow: () => timenow,
   timestamp: () => timestamp,
+  varDrawing: () => import_registry2.varDrawing,
   volume: () => volume,
   weekofyear: () => weekofyear,
   year: () => year
@@ -112,6 +116,7 @@ var chartPointCore = __toESM(require("../chartpoint/index.js"), 1);
 var textCore = __toESM(require("../text/index.js"), 1);
 var mathCore = __toESM(require("../math/index.js"), 1);
 var import_registry = require("../drawing/registry.js");
+var import_registry2 = require("../drawing/registry.js");
 var import_output = require("../drawing/output.js");
 var timeframeCore = __toESM(require("../timeframe/index.js"), 1);
 var timeCore = __toESM(require("../time/index.js"), 1);
@@ -175,6 +180,7 @@ let scriptOptions = {};
 function executeScript(body, barsInput, inputs = {}, chart2 = {}, options = {}) {
   ctxBars.setAll(barsInput);
   chartCtx = { ...chart2 };
+  runNow = chart2.now ?? Date.now();
   scriptOptions = options;
   ctx = freshCollector(inputs);
   (0, import_registry.resetDrawings)();
@@ -356,9 +362,10 @@ const ta = {
   /** `ta.lowestbars(source, length)` or `ta.lowestbars(length)` (source = low); offsets are 0 or negative. */
   lowestbars: (sourceOrLength, length) => typeof sourceOrLength === "number" ? taSeries.lowestbars(low, sourceOrLength) : taSeries.lowestbars(sourceOrLength, length),
   /** `ta.vwap(source, anchor?, stdev_mult?)` with the chart volume; the default anchor is a new trading
-   *  day (`timeframe.change("1D")`), which needs the chart context (timeframe, time zone, session). */
+   *  day (`timeframe.change("1D")`), which needs the chart context (timeframe, time zone, session), and the
+   *  first bar: as in PineScript, the first loaded bars (a day in progress) have a value. */
   vwap: ((source, anchor, stdev_mult) => {
-    const a = anchor ?? changeOf("1D");
+    const a = anchor ?? changeOf("1D", true);
     return stdev_mult === void 0 ? taSeries.vwap(source, volume, a) : taSeries.vwapBands(source, volume, a, stdev_mult);
   }),
   /** `ta.mfi(source, length)` with the chart volume (PineScript takes 2 arguments). */
@@ -758,6 +765,7 @@ function eachBar(fn) {
     for (idx = 0; idx < b.length; idx++) {
       if (pendingError && pendingError.bar === idx) throw new Error((0, import_series.historyError)(idx, pendingError.barsBack));
       currentBar = idx;
+      (0, import_registry.setDrawingBar)(idx, idx === b.length - 1);
       const r = fn(ctx2);
       out[idx] = typeof r === "number" ? r : typeof r === "boolean" ? r ? 1 : 0 : NaN;
       for (const buffer of buffers.values()) {
@@ -773,6 +781,7 @@ function eachBar(fn) {
     }
   } finally {
     currentBar = -1;
+    (0, import_registry.setDrawingBar)(null);
   }
   return import_series.Series.fromArray(ctxBars, out);
 }
@@ -988,6 +997,14 @@ function symbolProperty(key) {
   }
   return value;
 }
+function chartText(key, name) {
+  collector();
+  const value = chartCtx[key];
+  if (value === void 0) {
+    throw new Error(`${name} is not known: pass it as executeScript(body, bars, inputs, { ${key} }).`);
+  }
+  return value;
+}
 function symbolScale() {
   collector();
   const { minmove, pricescale } = chartCtx;
@@ -1024,6 +1041,12 @@ const syminfo = {
   get session() {
     collector();
     return chartCtx.sessionType ?? "regular";
+  },
+  get type() {
+    return chartText("symbolType", "syminfo.type");
+  },
+  get currency() {
+    return chartText("currency", "syminfo.currency");
   }
 };
 function calendar(fn) {
@@ -1095,7 +1118,12 @@ function calendarFor(session2, timezone) {
     return { bars: new import_bars.SessionBars(new import_calendar.TradingCalendar(tz, { session: toSpec(symbol).session }, "symbol"), bars2.chart.period), test: true };
   }
   const spec = session2 ? { session: session2 } : { session: toSpec(chartCtx.session).session };
-  return { bars: new import_bars.SessionBars(new import_calendar.TradingCalendar(tz, spec, session2 ? "pine" : "symbol"), bars2.chart.period), test: true };
+  return {
+    bars: new import_bars.SessionBars(new import_calendar.TradingCalendar(tz, spec, session2 ? "pine" : "symbol"), bars2.chart.period),
+    test: true,
+    // a PineScript session string: the rules of time.inSession (runs ending at 0000, days around a clock change)
+    inside: session2 ? (time2) => timeCore.inSession(time2, session2, tz, timeframeCore.in_seconds(bars2.chart.period) * 1e3) : void 0
+  };
 }
 function perBar(fn) {
   const times = ctxBars.bars.map(barTime);
@@ -1108,25 +1136,28 @@ function callableSeries(series, fn) {
 }
 function timeFunction(tf, session2, timezone) {
   collector();
-  const { bars: bars2, test } = calendarFor(session2, timezone);
+  const { bars: bars2, test, inside } = calendarFor(session2, timezone);
   const timeframeString = tf || chartTimeframe().period;
-  return perBar((t) => test && !bars2.inside(t) ? NaN : bars2.timeOf(t, timeframeString));
+  return perBar((t) => test && !(inside ? inside(t) : bars2.inside(t)) ? NaN : bars2.timeOf(t, timeframeString));
 }
 function timeCloseFunction(tf, session2, timezone) {
   collector();
-  const { bars: bars2, test } = calendarFor(session2, timezone);
+  const { bars: bars2, test, inside } = calendarFor(session2, timezone);
   const timeframeString = tf || chartTimeframe().period;
-  return perBar((t) => test && !bars2.inside(t) ? NaN : bars2.closeOf(t, timeframeString));
+  return perBar((t) => test && !(inside ? inside(t) : bars2.inside(t)) ? NaN : bars2.closeOf(t, timeframeString));
 }
+let runNow = NaN;
+const timenow = new import_series.Series(ctxBars, () => runNow);
 const time = callableSeries(new import_series.Series(ctxBars, (b) => barTime(b)), timeFunction);
 const time_close = callableSeries(
   new import_series.Series(ctxBars, (_b, i) => sessionBars().bars.closeOf(barTime(ctxBars.bars[i]), chartTimeframe().period)),
   timeCloseFunction
 );
 const time_tradingday = new import_series.Series(ctxBars, (b) => sessionBars().bars.tradingDayTime(barTime(b)));
-function changeOf(tf) {
+function changeOf(tf, firstBar = false) {
   const { bars: bars2 } = sessionBars();
-  return perBar((t, i, times) => i > 0 && bars2.timeOf(t, tf) !== bars2.timeOf(times[i - 1], tf) ? 1 : 0);
+  const changed = (a, b) => !Number.isNaN(a) && !Number.isNaN(b) && a !== b;
+  return perBar((t, i, times) => (i > 0 ? changed(bars2.timeOf(t, tf), bars2.timeOf(times[i - 1], tf)) : firstBar) ? 1 : 0);
 }
 function flag(key) {
   const { bars: bars2, regular } = sessionBars();
@@ -1308,6 +1339,14 @@ const table = {
 };
 const text = { ...textCore };
 const chart = {
+  /** Chart foreground colour (PineScript `chart.fg_color`), from the chart context. */
+  get fg_color() {
+    return chartText("foregroundColor", "chart.fg_color");
+  },
+  /** Chart background colour (PineScript `chart.bg_color`), from the chart context. */
+  get bg_color() {
+    return chartText("backgroundColor", "chart.bg_color");
+  },
   point: {
     ...chartPointCore,
     now(price) {