lightweight-charts-indicators 0.16.2 → 0.16.3

package/dist/alert-states.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Alert conditions of the built-ins (PineScript `alertcondition()`): the declaration on the registry entry and the
+ * `alerts` of a result — per condition, the times of the bars on which it is true and whether it is true on the last
+ * bar (the shape the script runtime gives, oakscriptjs AlertState).
+ */
+import type { Bar } from 'oakscriptjs';
+/** One `alertcondition()` of a built-in: id, title and default message, as the reference declares them */
+export interface AlertConditionDecl {
+    id: string;
+    title: string;
+    message?: string;
+}
+/** One condition of a result: the bars (times as given in the input bars) on which it is true */
+export interface AlertConditionState extends AlertConditionDecl {
+    triggered: boolean;
+    times: number[];
+}
+/** The states of `decls` from one flag per bar for each of them (`flags[k][i]`: condition k is true on bar i) */
+export declare function alertStates(decls: AlertConditionDecl[], bars: Bar[], flags: boolean[][]): AlertConditionState[];
+/** PineScript `ta.crossover(a, b)` per bar (values: numbers, na = NaN / null): a > b now and a <= b on the bar before */
+export declare function crossedOver(a: ArrayLike<number | null | undefined>, b: number | ArrayLike<number | null | undefined>): boolean[];
+/** PineScript `ta.crossunder(a, b)` per bar: a < b now and a >= b on the bar before */
+export declare function crossedUnder(a: ArrayLike<number | null | undefined>, b: number | ArrayLike<number | null | undefined>): boolean[];
+//# sourceMappingURL=alert-states.d.ts.map

package/dist/alert-states.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-states.d.ts","sourceRoot":"","sources":["../src/alert-states.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEvC,0GAA0G;AAC1G,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,iGAAiG;AACjG,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,iHAAiH;AACjH,wBAAgB,WAAW,CAAC,KAAK,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,mBAAmB,EAAE,CAO/G;AAED,yHAAyH;AACzH,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,OAAO,EAAE,CAQhI;AAED,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,OAAO,EAAE,CAQjI"}

package/dist/helpers.d.ts

@@ -1,6 +1,6 @@
 /**
  * Helpers the built-in indicator sources import (`lightweight-charts-indicators/helpers`): the chart context
- * accessors, higher-timeframe periods, other-symbol requests, lower-timeframe volume and bar times. A source given by
+ * accessors, higher-timeframe periods, other-symbol requests, lower-timeframe volume, bar times and alert condition states. A source given by
  * `lightweight-charts-indicators/sources` imports from here instead of the library's own relative paths, so a host
  * that runs the source as a script provides this one module next to oakscriptjs.
  */
@@ -9,4 +9,5 @@ export * from './anchor-period';
 export * from './other-symbol';
 export * from './lower-tf-volume';
 export * from './bar-time';
+export * from './alert-states';
 //# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/helpers.mjs

@@ -580,14 +580,47 @@ function upDownVolumeOfChartBars(bars) {
 
 // src/bar-time.ts
 import { barInterval as barInterval2, barTime } from "oakscriptjs";
+
+// src/alert-states.ts
+function alertStates(decls, bars, flags) {
+  return decls.map((d, k) => {
+    const f = flags[k] ?? [];
+    const times = [];
+    for (let i = 0; i < bars.length; i++)
+      if (f[i])
+        times.push(bars[i].time);
+    return { ...d, triggered: !!f[bars.length - 1], times };
+  });
+}
+function crossedOver(a, b) {
+  const at = (x, i) => typeof x === "number" ? x : x[i] ?? NaN;
+  const out = [];
+  for (let i = 0; i < a.length; i++) {
+    const v = a[i] ?? NaN, w = at(b, i), pv = i > 0 ? a[i - 1] ?? NaN : NaN, pw = i > 0 ? at(b, i - 1) : NaN;
+    out.push(v > w && pv <= pw);
+  }
+  return out;
+}
+function crossedUnder(a, b) {
+  const at = (x, i) => typeof x === "number" ? x : x[i] ?? NaN;
+  const out = [];
+  for (let i = 0; i < a.length; i++) {
+    const v = a[i] ?? NaN, w = at(b, i), pv = i > 0 ? a[i - 1] ?? NaN : NaN, pw = i > 0 ? at(b, i - 1) : NaN;
+    out.push(v < w && pv >= pw);
+  }
+  return out;
+}
 export {
   MissingSymbolDataError,
+  alertStates,
   backgroundColorOf,
   barInterval2 as barInterval,
   barTime,
   barsAfterLastBar,
   basecurrencyOf,
   chartTimeframe,
+  crossedOver,
+  crossedUnder,
   currencyOf,
   foregroundColorOf,
   hasCalendar,