openalgo-script 0.1.0-alpha.1 → 0.4.0

package/dist/core/stdlib/volume/accumulation.js

@@ -0,0 +1,127 @@
+import { NONE, fold, held, isPresent, result, slot, tailOf } from '../values/index.js';
+import { emaStep } from '../averages/index.js';
+/**
+ * Where the close sat inside the bar, as -1 at the low to 1 at the high, times
+ * the volume behind it.
+ *
+ * A bar whose high and low are equal has no position inside it to report, and
+ * the settled treatment is that such a bar contributes nothing rather than
+ * ending the running total.
+ */
+export function moneyFlow(bar) {
+    if (!isPresent(bar.high) || !isPresent(bar.low))
+        return NONE;
+    if (!isPresent(bar.close) || !isPresent(bar.volume))
+        return NONE;
+    const span = bar.high - bar.low;
+    if (!(span > 0))
+        return 0;
+    return result((((bar.close - bar.low) - (bar.high - bar.close)) / span) * bar.volume);
+}
+/** `obv()`: the running total of volume signed by the close's direction, from bar 0, seeded 0. */
+export function obvStep(state, key, bar) {
+    const totalKey = `${key}t`;
+    const closeKey = `${key}p`;
+    const seenKey = `${key}k`;
+    const previousClose = held(state, closeKey);
+    const started = state[seenKey] === true;
+    if (!isPresent(bar.volume) || !isPresent(bar.close)) {
+        state[seenKey] = true;
+        state[closeKey] = bar.close;
+        return NONE;
+    }
+    let total = slot(state, totalKey, 0);
+    if (started && isPresent(previousClose)) {
+        if (bar.close > previousClose)
+            total += bar.volume;
+        else if (bar.close < previousClose)
+            total -= bar.volume;
+    }
+    state[seenKey] = true;
+    state[closeKey] = bar.close;
+    state[totalKey] = total;
+    return result(total);
+}
+/** `obv()` as a tail. */
+export function obvTail() {
+    return tailOf((state, bar) => obvStep(state, '', bar));
+}
+/** `obv()` over a run of bars. */
+export function obv(bars) {
+    return fold(obvTail(), bars);
+}
+/** `ad()`: the running total of volume weighted by where the close sat, from bar 0. */
+export function adStep(state, key, bar) {
+    const flow = moneyFlow(bar);
+    if (!isPresent(flow))
+        return NONE;
+    const total = slot(state, `${key}t`, 0) + flow;
+    state[`${key}t`] = total;
+    return result(total);
+}
+/** `ad()` as a tail. */
+export function adTail() {
+    return tailOf((state, bar) => adStep(state, '', bar));
+}
+/** `ad()` over a run of bars. */
+export function ad(bars) {
+    return fold(adTail(), bars);
+}
+/**
+ * `adOsc(fast, slow)`: the difference of two means of `ad`, from bar `slow - 1`.
+ *
+ * The averages run over the running total, not over the per-bar term, so what
+ * this measures is acceleration in accumulation rather than the flow itself.
+ */
+export function adOscStep(state, key, bar, fast, slow) {
+    const total = adStep(state, `${key}a`, bar);
+    const near = emaStep(state, `${key}f`, total, fast);
+    const far = emaStep(state, `${key}s`, total, slow);
+    if (!isPresent(near) || !isPresent(far))
+        return NONE;
+    return result(near - far);
+}
+/** `adOsc(fast, slow)` as a tail. */
+export function adOscTail(fast = 3, slow = 10) {
+    return tailOf((state, bar) => adOscStep(state, '', bar, fast, slow));
+}
+/** `adOsc(fast, slow)` over a run of bars. */
+export function adOsc(bars, fast = 3, slow = 10) {
+    return fold(adOscTail(fast, slow), bars);
+}
+/**
+ * `pvt()`: the running total of volume weighted by percentage change, from bar
+ * 1, seeded 0.
+ *
+ * The total starts at zero before the first change, and the first change is at
+ * bar 1, so bar 0 is absent and bar 1 already carries its own term. Reporting a
+ * zero at bar 0 would claim a reading on a bar where the quantity is not
+ * defined.
+ */
+export function pvtStep(state, key, bar) {
+    const totalKey = `${key}t`;
+    const closeKey = `${key}p`;
+    const seenKey = `${key}k`;
+    const before = held(state, closeKey);
+    const started = state[seenKey] === true;
+    state[seenKey] = true;
+    state[closeKey] = bar.close;
+    if (!started)
+        return NONE;
+    if (!isPresent(before) || before === 0)
+        return NONE;
+    if (!isPresent(bar.close) || !isPresent(bar.volume))
+        return NONE;
+    const total = slot(state, totalKey, 0) + ((bar.close - before) / before) * bar.volume;
+    state[totalKey] = total;
+    return result(total);
+}
+/** `pvt()` as a tail. */
+export function pvtTail() {
+    return tailOf((state, bar) => pvtStep(state, '', bar));
+}
+/** `pvt()` over a run of bars. */
+export function pvt(bars) {
+    return fold(pvtTail(), bars);
+}
+//# sourceMappingURL=accumulation.js.map

package/dist/core/stdlib/volume/accumulation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accumulation.js","sourceRoot":"","sources":["../../../../src/core/stdlib/volume/accumulation.ts"],"names":[],"mappings":"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"}

package/dist/core/stdlib/volume/flow.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The lookback volume readings: `cmf`, `mfi`, `eom`, `forceIndex` and
+ * `relativeVolume`.
+ *
+ * Each is written once, as a step over a state region, and its tail is that
+ * step over a region of its own.
+ */
+import type { Bar, StateRecord, Tail, Value } from '../values/index.js';
+/** `cmf(len)`: accumulation over the lookback as a fraction of its volume, from bar `len - 1`. */
+export declare function cmfStep(state: StateRecord, key: string, bar: Bar, len: number | null): Value;
+/** `cmf(len)` as a tail. */
+export declare function cmfTail(len?: number): Tail<Bar, Value>;
+/** `cmf(len)` over a run of bars. */
+export declare function cmf(bars: readonly Bar[], len?: number): Value[];
+/**
+ * `mfi(len)`: the strength reading computed on money flow rather than price,
+ * from bar `len`.
+ *
+ * A bar's whole flow counts on one side or the other, by whether the typical
+ * price rose or fell, so the first lookback is bars 1 to `len` and the extra bar
+ * is in the declared warmup.
+ */
+export declare function mfiStep(state: StateRecord, key: string, bar: Bar, len: number | null): Value;
+/** `mfi(len)` as a tail. */
+export declare function mfiTail(len?: number): Tail<Bar, Value>;
+/** `mfi(len)` over a run of bars. */
+export declare function mfi(bars: readonly Bar[], len?: number): Value[];
+/**
+ * `eom(len)`: how far price moved per unit of volume, from bar `len`.
+ *
+ * The midpoint's move, times the bar's range, over the volume traded, then
+ * averaged over the lookback. The midpoint move needs the previous bar, so the
+ * average's lookback starts at bar 1 and the first reading is at bar `len`.
+ *
+ * **No scaling constant.** Implementations of this reading usually multiply by
+ * a large divisor whose only job is to bring the number into a readable range,
+ * and they do not agree on it. `stdlib.md` section 7 declares `eom(len = 14)`
+ * with no such argument, so there is none here and the reading is the quantity
+ * itself. That leaves it very small on a liquid instrument, which is recorded
+ * as a gap in the specification rather than papered over with a constant this
+ * library invented.
+ */
+export declare function eomStep(state: StateRecord, key: string, bar: Bar, len: number | null): Value;
+/** `eom(len)` as a tail. */
+export declare function eomTail(len?: number): Tail<Bar, Value>;
+/** `eom(len)` over a run of bars. */
+export declare function eom(bars: readonly Bar[], len?: number): Value[];
+/** `forceIndex(len)`: change times volume, smoothed, from bar `len`. */
+export declare function forceIndexStep(state: StateRecord, key: string, bar: Bar, len: number | null): Value;
+/** `forceIndex(len)` as a tail. */
+export declare function forceIndexTail(len?: number): Tail<Bar, Value>;
+/** `forceIndex(len)` over a run of bars. */
+export declare function forceIndex(bars: readonly Bar[], len?: number): Value[];
+/** `relativeVolume(len)`: this bar's volume over its own recent average, from bar `len - 1`. */
+export declare function relativeVolumeStep(state: StateRecord, key: string, volume: Value, len: number | null): Value;
+/** `relativeVolume(len)` as a tail. */
+export declare function relativeVolumeTail(len?: number): Tail<Bar, Value>;
+/** `relativeVolume(len)` over a run of bars. */
+export declare function relativeVolume(bars: readonly Bar[], len?: number): Value[];
+//# sourceMappingURL=flow.d.ts.map

package/dist/core/stdlib/volume/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../../../src/core/stdlib/volume/flow.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAOxE,kGAAkG;AAClG,wBAAgB,OAAO,CACrB,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,KAAK,CAKP;AAED,4BAA4B;AAC5B,wBAAgB,OAAO,CAAC,GAAG,SAAK,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAElD;AAED,qCAAqC;AACrC,wBAAgB,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,SAAK,GAAG,KAAK,EAAE,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,KAAK,CAuBP;AAED,4BAA4B;AAC5B,wBAAgB,OAAO,CAAC,GAAG,SAAK,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAElD;AAED,qCAAqC;AACrC,wBAAgB,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,SAAK,GAAG,KAAK,EAAE,CAE3D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,KAAK,CAaP;AAED,4BAA4B;AAC5B,wBAAgB,OAAO,CAAC,GAAG,SAAK,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAElD;AAED,qCAAqC;AACrC,wBAAgB,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,SAAK,GAAG,KAAK,EAAE,CAE3D;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,KAAK,CAIP;AAED,mCAAmC;AACnC,wBAAgB,cAAc,CAAC,GAAG,SAAK,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAEzD;AAED,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,SAAK,GAAG,KAAK,EAAE,CAElE;AAED,gGAAgG;AAChG,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,KAAK,EACb,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,KAAK,CAIP;AAED,uCAAuC;AACvC,wBAAgB,kBAAkB,CAAC,GAAG,SAAK,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAE7D;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,SAAK,GAAG,KAAK,EAAE,CAEtE"}

package/dist/core/stdlib/volume/flow.js

@@ -0,0 +1,125 @@
+import { NONE, fold, held, hl2, hlc3, isPresent, result, tailOf } from '../values/index.js';
+import { emaStep, smaStep } from '../averages/index.js';
+import { changeStep, sumStep } from '../series/index.js';
+import { moneyFlow } from './accumulation.js';
+/** `cmf(len)`: accumulation over the lookback as a fraction of its volume, from bar `len - 1`. */
+export function cmfStep(state, key, bar, len) {
+    const flow = sumStep(state, `${key}f`, moneyFlow(bar), len);
+    const traded = sumStep(state, `${key}v`, bar.volume, len);
+    if (!isPresent(flow) || !isPresent(traded) || !(traded > 0))
+        return NONE;
+    return result(flow / traded);
+}
+/** `cmf(len)` as a tail. */
+export function cmfTail(len = 20) {
+    return tailOf((state, bar) => cmfStep(state, '', bar, len));
+}
+/** `cmf(len)` over a run of bars. */
+export function cmf(bars, len = 20) {
+    return fold(cmfTail(len), bars);
+}
+/**
+ * `mfi(len)`: the strength reading computed on money flow rather than price,
+ * from bar `len`.
+ *
+ * A bar's whole flow counts on one side or the other, by whether the typical
+ * price rose or fell, so the first lookback is bars 1 to `len` and the extra bar
+ * is in the declared warmup.
+ */
+export function mfiStep(state, key, bar, len) {
+    const typicalKey = `${key}p`;
+    const seenKey = `${key}k`;
+    const typical = hlc3(bar);
+    const before = held(state, typicalKey);
+    const started = state[seenKey] === true;
+    state[seenKey] = true;
+    state[typicalKey] = typical;
+    let up = NONE;
+    let down = NONE;
+    if (started && isPresent(typical) && isPresent(before) && isPresent(bar.volume)) {
+        const flow = result(typical * bar.volume);
+        up = typical > before ? flow : 0;
+        down = typical < before ? flow : 0;
+    }
+    const rise = sumStep(state, `${key}u`, up, len);
+    const fall = sumStep(state, `${key}d`, down, len);
+    if (!isPresent(rise) || !isPresent(fall))
+        return NONE;
+    // No down bar in the lookback is the top of the scale, as in `rsi`.
+    if (fall === 0)
+        return 100;
+    return result(100 - 100 / (1 + rise / fall));
+}
+/** `mfi(len)` as a tail. */
+export function mfiTail(len = 14) {
+    return tailOf((state, bar) => mfiStep(state, '', bar, len));
+}
+/** `mfi(len)` over a run of bars. */
+export function mfi(bars, len = 14) {
+    return fold(mfiTail(len), bars);
+}
+/**
+ * `eom(len)`: how far price moved per unit of volume, from bar `len`.
+ *
+ * The midpoint's move, times the bar's range, over the volume traded, then
+ * averaged over the lookback. The midpoint move needs the previous bar, so the
+ * average's lookback starts at bar 1 and the first reading is at bar `len`.
+ *
+ * **No scaling constant.** Implementations of this reading usually multiply by
+ * a large divisor whose only job is to bring the number into a readable range,
+ * and they do not agree on it. `stdlib.md` section 7 declares `eom(len = 14)`
+ * with no such argument, so there is none here and the reading is the quantity
+ * itself. That leaves it very small on a liquid instrument, which is recorded
+ * as a gap in the specification rather than papered over with a constant this
+ * library invented.
+ */
+export function eomStep(state, key, bar, len) {
+    const travelled = changeStep(state, `${key}c`, hl2(bar), 1);
+    let term = NONE;
+    if (isPresent(travelled) &&
+        isPresent(bar.high) &&
+        isPresent(bar.low) &&
+        isPresent(bar.volume) &&
+        bar.volume !== 0) {
+        term = result((travelled * (bar.high - bar.low)) / bar.volume);
+    }
+    return smaStep(state, `${key}q`, term, len);
+}
+/** `eom(len)` as a tail. */
+export function eomTail(len = 14) {
+    return tailOf((state, bar) => eomStep(state, '', bar, len));
+}
+/** `eom(len)` over a run of bars. */
+export function eom(bars, len = 14) {
+    return fold(eomTail(len), bars);
+}
+/** `forceIndex(len)`: change times volume, smoothed, from bar `len`. */
+export function forceIndexStep(state, key, bar, len) {
+    const moved = changeStep(state, `${key}c`, bar.close, 1);
+    const force = isPresent(moved) && isPresent(bar.volume) ? result(moved * bar.volume) : NONE;
+    return emaStep(state, `${key}e`, force, len);
+}
+/** `forceIndex(len)` as a tail. */
+export function forceIndexTail(len = 13) {
+    return tailOf((state, bar) => forceIndexStep(state, '', bar, len));
+}
+/** `forceIndex(len)` over a run of bars. */
+export function forceIndex(bars, len = 13) {
+    return fold(forceIndexTail(len), bars);
+}
+/** `relativeVolume(len)`: this bar's volume over its own recent average, from bar `len - 1`. */
+export function relativeVolumeStep(state, key, volume, len) {
+    const mean = smaStep(state, `${key}q`, volume, len);
+    if (!isPresent(mean) || !isPresent(volume) || mean === 0)
+        return NONE;
+    return result(volume / mean);
+}
+/** `relativeVolume(len)` as a tail. */
+export function relativeVolumeTail(len = 20) {
+    return tailOf((state, bar) => relativeVolumeStep(state, '', bar.volume, len));
+}
+/** `relativeVolume(len)` over a run of bars. */
+export function relativeVolume(bars, len = 20) {
+    return fold(relativeVolumeTail(len), bars);
+}
+//# sourceMappingURL=flow.js.map

package/dist/core/stdlib/volume/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../../../src/core/stdlib/volume/flow.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,kGAAkG;AAClG,MAAM,UAAU,OAAO,CACrB,KAAkB,EAClB,GAAW,EACX,GAAQ,EACR,GAAkB;IAElB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1D,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,OAAO,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,OAAO,CAAC,GAAG,GAAG,EAAE;IAC9B,OAAO,MAAM,CAAC,CAAC,KAAK,EAAE,GAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,GAAG,CAAC,IAAoB,EAAE,GAAG,GAAG,EAAE;IAChD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CACrB,KAAkB,EAClB,GAAW,EACX,GAAQ,EACR,GAAkB;IAElB,MAAM,UAAU,GAAG,GAAG,GAAG,GAAG,CAAC;IAC7B,MAAM,OAAO,GAAG,GAAG,GAAG,GAAG,CAAC;IAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IACxC,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC;IAE5B,IAAI,EAAE,GAAU,IAAI,CAAC;IACrB,IAAI,IAAI,GAAU,IAAI,CAAC;IACvB,IAAI,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,EAAE,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAClD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,oEAAoE;IACpE,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC3B,OAAO,MAAM,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,OAAO,CAAC,GAAG,GAAG,EAAE;IAC9B,OAAO,MAAM,CAAC,CAAC,KAAK,EAAE,GAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,GAAG,CAAC,IAAoB,EAAE,GAAG,GAAG,EAAE;IAChD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,OAAO,CACrB,KAAkB,EAClB,GAAW,EACX,GAAQ,EACR,GAAkB;IAElB,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,IAAI,IAAI,GAAU,IAAI,CAAC;IACvB,IACE,SAAS,CAAC,SAAS,CAAC;QACpB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;QACnB,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;QAClB,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;QACrB,GAAG,CAAC,MAAM,KAAK,CAAC,EAChB,CAAC;QACD,IAAI,GAAG,MAAM,CAAC,CAAC,SAAS,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,OAAO,CAAC,GAAG,GAAG,EAAE;IAC9B,OAAO,MAAM,CAAC,CAAC,KAAK,EAAE,GAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,GAAG,CAAC,IAAoB,EAAE,GAAG,GAAG,EAAE;IAChD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,cAAc,CAC5B,KAAkB,EAClB,GAAW,EACX,GAAQ,EACR,GAAkB;IAElB,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5F,OAAO,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,cAAc,CAAC,GAAG,GAAG,EAAE;IACrC,OAAO,MAAM,CAAC,CAAC,KAAK,EAAE,GAAQ,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,UAAU,CAAC,IAAoB,EAAE,GAAG,GAAG,EAAE;IACvD,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,kBAAkB,CAChC,KAAkB,EAClB,GAAW,EACX,MAAa,EACb,GAAkB;IAElB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACpD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtE,OAAO,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,kBAAkB,CAAC,GAAG,GAAG,EAAE;IACzC,OAAO,MAAM,CAAC,CAAC,KAAK,EAAE,GAAQ,EAAE,EAAE,CAAC,kBAAkB,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AACrF,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,cAAc,CAAC,IAAoB,EAAE,GAAG,GAAG,EAAE;IAC3D,OAAO,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC"}

package/dist/core/stdlib/volume/index.d.ts

@@ -0,0 +1,5 @@
+export { ad, adOsc, adOscStep, adOscTail, adStep, adTail, moneyFlow, obv, obvStep, obvTail, pvt, pvtStep, pvtTail, } from './accumulation.js';
+export { cmf, cmfStep, cmfTail, eom, eomStep, eomTail, forceIndex, forceIndexStep, forceIndexTail, mfi, mfiStep, mfiTail, relativeVolume, relativeVolumeStep, relativeVolumeTail, } from './flow.js';
+export type { Anchored } from './weighted.js';
+export { vwap, vwapAnchor, vwapAnchorStep, vwapAnchorTail, vwapStep, vwapTail, } from './weighted.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/stdlib/volume/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/stdlib/volume/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,EAAE,EACF,KAAK,EACL,SAAS,EACT,SAAS,EACT,MAAM,EACN,MAAM,EACN,SAAS,EACT,GAAG,EACH,OAAO,EACP,OAAO,EACP,GAAG,EACH,OAAO,EACP,OAAO,GACR,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,GAAG,EACH,OAAO,EACP,OAAO,EACP,GAAG,EACH,OAAO,EACP,OAAO,EACP,UAAU,EACV,cAAc,EACd,cAAc,EACd,GAAG,EACH,OAAO,EACP,OAAO,EACP,cAAc,EACd,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EACL,IAAI,EACJ,UAAU,EACV,cAAc,EACd,cAAc,EACd,QAAQ,EACR,QAAQ,GACT,MAAM,eAAe,CAAC"}

package/dist/core/stdlib/volume/index.js

@@ -0,0 +1,4 @@
+export { ad, adOsc, adOscStep, adOscTail, adStep, adTail, moneyFlow, obv, obvStep, obvTail, pvt, pvtStep, pvtTail, } from './accumulation.js';
+export { cmf, cmfStep, cmfTail, eom, eomStep, eomTail, forceIndex, forceIndexStep, forceIndexTail, mfi, mfiStep, mfiTail, relativeVolume, relativeVolumeStep, relativeVolumeTail, } from './flow.js';
+export { vwap, vwapAnchor, vwapAnchorStep, vwapAnchorTail, vwapStep, vwapTail, } from './weighted.js';
+//# sourceMappingURL=index.js.map

package/dist/core/stdlib/volume/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/stdlib/volume/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,EAAE,EACF,KAAK,EACL,SAAS,EACT,SAAS,EACT,MAAM,EACN,MAAM,EACN,SAAS,EACT,GAAG,EACH,OAAO,EACP,OAAO,EACP,GAAG,EACH,OAAO,EACP,OAAO,GACR,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,GAAG,EACH,OAAO,EACP,OAAO,EACP,GAAG,EACH,OAAO,EACP,OAAO,EACP,UAAU,EACV,cAAc,EACd,cAAc,EACd,GAAG,EACH,OAAO,EACP,OAAO,EACP,cAAc,EACd,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,IAAI,EACJ,UAAU,EACV,cAAc,EACd,cAAc,EACd,QAAQ,EACR,QAAQ,GACT,MAAM,eAAe,CAAC"}

package/dist/core/stdlib/volume/weighted.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `vwap` and `vwapAnchor`: the volume weighted average price since an anchor.
+ *
+ * `stdlib.md` section 7 writes `vwap(src)` and says it resets at the start of
+ * each trading session **as the instrument defines it**, not at midnight,
+ * because the session is what the number means. Where a session starts follows
+ * from the instrument's own trading hours and not from any arithmetic here, so
+ * this library takes the anchor as a flag per bar and an engine derives it.
+ * `vwapAnchor` is therefore the whole of the calculation and `vwap` is that
+ * calculation with the session's first bars passed in.
+ *
+ * The running totals are carried rather than rebuilt, because that is the
+ * definition: a volume weighted average since an anchor is a pair of running
+ * totals, and a lookback over the bars since the anchor would be a different
+ * quantity with a different value.
+ */
+import type { Series, StateRecord, Tail, Value } from '../values/index.js';
+/** A bar's source price, its volume, and whether the average restarts here. */
+export interface Anchored {
+    readonly src: Value;
+    readonly volume: Value;
+    readonly reset: boolean;
+}
+/**
+ * `vwapAnchor(src, resetWhen)`: from the first bar `resetWhen` is true.
+ *
+ * The bar the condition holds on is the first bar of the new average, not the
+ * last bar of the old one. Absent before the condition has ever been true,
+ * because there is no anchor to measure from and zero would read as a price.
+ */
+export declare function vwapAnchorStep(state: StateRecord, key: string, input: Anchored): Value;
+/** `vwapAnchor(src, resetWhen)` as a tail. */
+export declare function vwapAnchorTail(): Tail<Anchored, Value>;
+/** `vwapAnchor(src, resetWhen)` over whole series. */
+export declare function vwapAnchor(src: Series, volume: Series, resetWhen: readonly boolean[]): Value[];
+/**
+ * `vwap(src)`: the same average anchored to the session, from the session's
+ * first bar.
+ *
+ * `sessionStart` is the engine's answer to "does a new trading session begin on
+ * this bar", read off the instrument's stated trading hours, which is why it
+ * is an argument rather than something derived from the timestamps here. On a daily or longer interval every bar is its own
+ * session, so every bar is an anchor and the result equals `src`; the compiler
+ * emits warning OS8006 saying so, which is a compile-time matter and not this
+ * library's.
+ */
+export declare function vwapTail(): Tail<Anchored, Value>;
+/** `vwap(src)` as a step, which is `vwapAnchor` anchored to the session. */
+export declare function vwapStep(state: StateRecord, key: string, input: Anchored): Value;
+/** `vwap(src)` over whole series. */
+export declare function vwap(src: Series, volume: Series, sessionStart: readonly boolean[]): Value[];
+//# sourceMappingURL=weighted.d.ts.map

package/dist/core/stdlib/volume/weighted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weighted.d.ts","sourceRoot":"","sources":["../../../../src/core/stdlib/volume/weighted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG3E,+EAA+E;AAC/E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,KAAK,CAiBtF;AAED,8CAA8C;AAC9C,wBAAgB,cAAc,IAAI,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAEtD;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,OAAO,EAAE,GAC5B,KAAK,EAAE,CAST;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAEhD;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,KAAK,CAEhF;AAED,qCAAqC;AACrC,wBAAgB,IAAI,CAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,SAAS,OAAO,EAAE,GAC/B,KAAK,EAAE,CAET"}

package/dist/core/stdlib/volume/weighted.js

@@ -0,0 +1,64 @@
+import { NONE, flag, fold, isPresent, result, slot, tailOf } from '../values/index.js';
+/**
+ * `vwapAnchor(src, resetWhen)`: from the first bar `resetWhen` is true.
+ *
+ * The bar the condition holds on is the first bar of the new average, not the
+ * last bar of the old one. Absent before the condition has ever been true,
+ * because there is no anchor to measure from and zero would read as a price.
+ */
+export function vwapAnchorStep(state, key, input) {
+    const flowKey = `${key}f`;
+    const tradedKey = `${key}v`;
+    const anchoredKey = `${key}a`;
+    if (input.reset) {
+        state[flowKey] = 0;
+        state[tradedKey] = 0;
+        state[anchoredKey] = true;
+    }
+    if (!flag(state, anchoredKey))
+        return NONE;
+    if (!isPresent(input.src) || !isPresent(input.volume))
+        return NONE;
+    const flow = slot(state, flowKey, 0) + input.src * input.volume;
+    const traded = slot(state, tradedKey, 0) + input.volume;
+    state[flowKey] = flow;
+    state[tradedKey] = traded;
+    if (traded === 0)
+        return NONE;
+    return result(flow / traded);
+}
+/** `vwapAnchor(src, resetWhen)` as a tail. */
+export function vwapAnchorTail() {
+    return tailOf((state, input) => vwapAnchorStep(state, '', input));
+}
+/** `vwapAnchor(src, resetWhen)` over whole series. */
+export function vwapAnchor(src, volume, resetWhen) {
+    return fold(vwapAnchorTail(), src.map((value, index) => ({
+        src: value,
+        volume: volume[index] ?? NONE,
+        reset: resetWhen[index] === true,
+    })));
+}
+/**
+ * `vwap(src)`: the same average anchored to the session, from the session's
+ * first bar.
+ *
+ * `sessionStart` is the engine's answer to "does a new trading session begin on
+ * this bar", read off the instrument's stated trading hours, which is why it
+ * is an argument rather than something derived from the timestamps here. On a daily or longer interval every bar is its own
+ * session, so every bar is an anchor and the result equals `src`; the compiler
+ * emits warning OS8006 saying so, which is a compile-time matter and not this
+ * library's.
+ */
+export function vwapTail() {
+    return vwapAnchorTail();
+}
+/** `vwap(src)` as a step, which is `vwapAnchor` anchored to the session. */
+export function vwapStep(state, key, input) {
+    return vwapAnchorStep(state, key, input);
+}
+/** `vwap(src)` over whole series. */
+export function vwap(src, volume, sessionStart) {
+    return vwapAnchor(src, volume, sessionStart);
+}
+//# sourceMappingURL=weighted.js.map

package/dist/core/stdlib/volume/weighted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weighted.js","sourceRoot":"","sources":["../../../../src/core/stdlib/volume/weighted.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AASvF;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAkB,EAAE,GAAW,EAAE,KAAe;IAC7E,MAAM,OAAO,GAAG,GAAG,GAAG,GAAG,CAAC;IAC1B,MAAM,SAAS,GAAG,GAAG,GAAG,GAAG,CAAC;IAC5B,MAAM,WAAW,GAAG,GAAG,GAAG,GAAG,CAAC;IAC9B,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnB,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrB,KAAK,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IAC5B,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACnE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IAChE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IACxD,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC;IAC1B,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,CAAC,KAAK,EAAE,KAAe,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,UAAU,CACxB,GAAW,EACX,MAAc,EACd,SAA6B;IAE7B,OAAO,IAAI,CACT,cAAc,EAAE,EAChB,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACzB,GAAG,EAAE,KAAK;QACV,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI;QAC7B,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI;KACjC,CAAC,CAAC,CACJ,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,cAAc,EAAE,CAAC;AAC1B,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,QAAQ,CAAC,KAAkB,EAAE,GAAW,EAAE,KAAe;IACvE,OAAO,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,IAAI,CAClB,GAAW,EACX,MAAc,EACd,YAAgC;IAEhC,OAAO,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;AAC/C,CAAC"}

package/dist/core/version/version.generated.d.ts

@@ -1,10 +1,10 @@
 /** This build's package version. The release refuses to publish unless the tag, the manifest and this agree. */
-export declare const VERSION = "0.1.0-alpha.1";
+export declare const VERSION = "0.4.0";
 /**
  * The compiled program format this compiler emits.
  *
  * Deliberately not the package version. An engine written by somebody else
  * targets this number, and it moves only when the format does.
  */
-export declare const COMPILED_FORMAT_VERSION = "1.0";
+export declare const COMPILED_FORMAT_VERSION = "1.1";
 //# sourceMappingURL=version.generated.d.ts.map

package/dist/core/version/version.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.generated.d.ts","sourceRoot":"","sources":["../../../src/core/version/version.generated.ts"],"names":[],"mappings":"AAKA,gHAAgH;AAChH,eAAO,MAAM,OAAO,kBAAkB,CAAC;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAAQ,CAAC"}
+{"version":3,"file":"version.generated.d.ts","sourceRoot":"","sources":["../../../src/core/version/version.generated.ts"],"names":[],"mappings":"AAKA,gHAAgH;AAChH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAAQ,CAAC"}

package/dist/core/version/version.generated.js

@@ -3,12 +3,12 @@
 // VERSION comes from package.json and COMPILED_FORMAT_VERSION from
 // spec/compiled-program.md, so neither can drift from the thing it names.
 /** This build's package version. The release refuses to publish unless the tag, the manifest and this agree. */
-export const VERSION = "0.1.0-alpha.1";
+export const VERSION = "0.4.0";
 /**
  * The compiled program format this compiler emits.
  *
  * Deliberately not the package version. An engine written by somebody else
  * targets this number, and it moves only when the format does.
  */
-export const COMPILED_FORMAT_VERSION = "1.0";
+export const COMPILED_FORMAT_VERSION = "1.1";
 //# sourceMappingURL=version.generated.js.map

package/dist/core/version/version.generated.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.generated.js","sourceRoot":"","sources":["../../../src/core/version/version.generated.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,mEAAmE;AACnE,0EAA0E;AAE1E,gHAAgH;AAChH,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC"}
+{"version":3,"file":"version.generated.js","sourceRoot":"","sources":["../../../src/core/version/version.generated.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,mEAAmE;AACnE,0EAA0E;AAE1E,gHAAgH;AAChH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC"}

package/dist/editor/complete.d.ts

@@ -0,0 +1,40 @@
+import type { Span } from '../core/index.js';
+/**
+ * What a completion is, which decides the icon a host puts beside it.
+ *
+ * `value` is a library name read without brackets, `close` and `aqua` among
+ * them; `function` is one that is called. The two are the manifest's own
+ * `callable`, not a guess from the spelling.
+ */
+export type CompletionKind = 'function' | 'value' | 'namespace' | 'member' | 'variable' | 'argument';
+export interface Completion {
+    /** What the row reads as: the name, or the parameter for a named argument. */
+    readonly label: string;
+    /**
+     * What a host puts into the text, which is not always the label.
+     *
+     * A named argument is written `len = `, so accepting the row leaves the caret
+     * where the value goes rather than beside a label with no equals sign.
+     */
+    readonly insert: string;
+    readonly kind: CompletionKind;
+    /** The signature or the type, spelled by the manifest and the checker. */
+    readonly detail: string;
+    /** The line the specification gives it, where it gives one. */
+    readonly summary: string | undefined;
+    /** Named in the library and not implemented in this version: OS2020. */
+    readonly planned: boolean;
+    /** The catalogue's OS2020 message for this name, on a planned row and no other. */
+    readonly refusal: string | undefined;
+    /** The text the row replaces, which is the word being typed or nothing. */
+    readonly replace: Span;
+}
+/**
+ * Everything that may be written at an offset, most useful first.
+ *
+ * Rows are filtered by the word already typed, which is compared exactly:
+ * `language.md` makes names case sensitive, so `EM` is not a start of `ema` and
+ * offering it would be offering a name that does not compile.
+ */
+export declare function complete(source: string, offset: number): readonly Completion[];
+//# sourceMappingURL=complete.d.ts.map

package/dist/editor/complete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../src/editor/complete.ts"],"names":[],"mappings":"AAkDA,OAAO,KAAK,EAAyB,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAMpE;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,OAAO,GACP,WAAW,GACX,QAAQ,GACR,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,WAAW,UAAU;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;CACxB;AA8FD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE,CAwE9E"}