openalgo-script 0.1.0-alpha.1 → 0.2.0

package/dist/adapters/charts/drawings.js

@@ -0,0 +1,172 @@
+import { MS } from './bars.js';
+import { cssOf } from './colours.js';
+/** A colour a script left absent: nothing is drawn there. */
+const TRANSPARENT = 'rgba(0, 0, 0, 0)';
+const LINE_STYLES = ['solid', 'dashed', 'dotted'];
+const ALIGNMENTS = ['left', 'center', 'right'];
+/**
+ * One point, or nothing when either half of it is absent.
+ *
+ * The time crosses the same boundary a bar's does and in the same direction: an
+ * anchor is written in the language's milliseconds and a chart counts seconds,
+ * so an anchor handed over unconverted would sit fifty thousand years past the
+ * newest bar and still draw. It is not rounded, because rounding an anchor moves
+ * it, and a chart places one between two bars perfectly well.
+ */
+function anchorOf(anchor) {
+    if (anchor === undefined || anchor.time === null || anchor.price === null)
+        return undefined;
+    return { time: anchor.time / MS, price: anchor.price };
+}
+function colour(style, key) {
+    return cssOf(style[key] ?? null) ?? TRANSPARENT;
+}
+function number(style, key) {
+    const value = style[key];
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function text(style, key) {
+    const value = style[key];
+    return typeof value === 'string' && value !== '' ? value : undefined;
+}
+function flag(style, key) {
+    const value = style[key];
+    return typeof value === 'boolean' ? value : undefined;
+}
+function lineStyle(style) {
+    const value = style['style'];
+    return typeof value === 'string' && LINE_STYLES.includes(value)
+        ? value
+        : undefined;
+}
+function align(style) {
+    const value = style['align'];
+    return typeof value === 'string' && ALIGNMENTS.includes(value)
+        ? value
+        : undefined;
+}
+function oneLine(one) {
+    const from = anchorOf(one.anchors[0]);
+    const to = anchorOf(one.anchors[1]);
+    if (from === undefined || to === undefined)
+        return [];
+    const width = number(one.style, 'width');
+    const dash = lineStyle(one.style);
+    const left = flag(one.style, 'extendLeft');
+    const right = flag(one.style, 'extendRight');
+    return [
+        {
+            kind: 'line',
+            from,
+            to,
+            color: colour(one.style, 'color'),
+            ...(width === undefined ? {} : { lineWidth: width }),
+            ...(dash === undefined ? {} : { lineStyle: dash }),
+            ...(left === undefined ? {} : { extendLeft: left }),
+            ...(right === undefined ? {} : { extendRight: right }),
+        },
+    ];
+}
+function oneBox(one) {
+    const from = anchorOf(one.anchors[0]);
+    const to = anchorOf(one.anchors[1]);
+    if (from === undefined || to === undefined)
+        return [];
+    const opacity = number(one.style, 'opacity');
+    const width = number(one.style, 'width');
+    const caption = text(one.style, 'text');
+    const tooltip = text(one.style, 'tooltip');
+    return [
+        {
+            kind: 'box',
+            from,
+            to,
+            color: colour(one.style, 'color'),
+            fillColor: colour(one.style, 'fillColor'),
+            textColor: colour(one.style, 'textColor'),
+            ...(opacity === undefined ? {} : { opacity }),
+            ...(width === undefined ? {} : { lineWidth: width }),
+            ...(caption === undefined ? {} : { text: caption }),
+            ...(tooltip === undefined ? {} : { tooltip }),
+        },
+    ];
+}
+function oneLabel(one) {
+    const at = anchorOf(one.anchors[0]);
+    const written = one.style['text'];
+    if (at === undefined || typeof written !== 'string')
+        return [];
+    const placement = align(one.style);
+    const tooltip = text(one.style, 'tooltip');
+    return [
+        {
+            kind: 'label',
+            at,
+            text: written,
+            color: colour(one.style, 'color'),
+            textColor: colour(one.style, 'textColor'),
+            ...(placement === undefined ? {} : { align: placement }),
+            ...(tooltip === undefined ? {} : { tooltip }),
+        },
+    ];
+}
+/** The path cut at its gaps: one run of points per stretch that has none. */
+function runsOf(one) {
+    const runs = [];
+    let run = [];
+    for (const point of one.anchors) {
+        const anchor = anchorOf(point);
+        if (anchor === undefined) {
+            if (run.length > 1)
+                runs.push(run);
+            run = [];
+            continue;
+        }
+        run.push(anchor);
+    }
+    if (run.length > 1)
+        runs.push(run);
+    return runs;
+}
+function onePolyline(one) {
+    const runs = runsOf(one);
+    const whole = runs.length === 1 && runs[0]?.length === one.anchors.length;
+    const width = number(one.style, 'width');
+    const opacity = number(one.style, 'opacity');
+    const closed = flag(one.style, 'closed');
+    const filled = whole
+        ? {
+            fillColor: colour(one.style, 'fillColor'),
+            ...(closed === undefined ? {} : { closed }),
+            ...(opacity === undefined ? {} : { opacity }),
+        }
+        : {};
+    return runs.map((points) => ({
+        kind: 'polyline',
+        points,
+        color: colour(one.style, 'color'),
+        ...(width === undefined ? {} : { lineWidth: width }),
+        ...filled,
+    }));
+}
+/**
+ * Every object the script holds, in the order it created them.
+ *
+ * Creation order rather than any other, because it is the order the script wrote
+ * and therefore the order a reader expects one shape to sit over another.
+ */
+export function buildDrawings(held) {
+    const out = [];
+    for (const one of held) {
+        if (one.kind === 'line')
+            out.push(...oneLine(one));
+        else if (one.kind === 'box')
+            out.push(...oneBox(one));
+        else if (one.kind === 'label')
+            out.push(...oneLabel(one));
+        else
+            out.push(...onePolyline(one));
+    }
+    return out;
+}
+//# sourceMappingURL=drawings.js.map

package/dist/adapters/charts/drawings.js.map

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

package/dist/adapters/charts/errors.d.ts

@@ -0,0 +1,28 @@
+/**
+ * How the adapter tells a chart that a study cannot be drawn.
+ *
+ * The engine's surface never throws: it returns a diagnostic. The chart's
+ * surface is the opposite, because a descriptor's `calc` has nowhere else to
+ * put a failure, so this is where the one becomes the other. Nothing is
+ * invented on the way across: the diagnostic the engine produced is carried
+ * whole, with its catalogue code, its source position and its fix, and the
+ * thrown error's message is the sentence the catalogue already wrote.
+ *
+ * **The name is what a chart reads.** The chart's runtime tells a bad input,
+ * which a user can fix from the settings dialog, from a defect, which they
+ * cannot, by the error's name. So a failure raised before any bar ran is named
+ * as an input error, because everything refused at load is a setting, a limit
+ * or a capability the host chose, and a failure raised on a bar keeps this
+ * adapter's own name, because a script that computed four thousand bars and
+ * then stopped is not something a settings dialog can repair.
+ */
+import type { Diagnostic } from '../../core/index.js';
+export declare class ChartAdapterError extends Error {
+    readonly diagnostic: Diagnostic;
+    constructor(diagnostic: Diagnostic, name: string);
+}
+/** A refusal at load: the program never ran, so a setting is what to change. */
+export declare function refused(diagnostic: Diagnostic): ChartAdapterError;
+/** A failure on a bar: the program ran and stopped. */
+export declare function stopped(diagnostic: Diagnostic): ChartAdapterError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/adapters/charts/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/adapters/charts/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAQtD,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;gBAEpB,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM;CAKjD;AAED,gFAAgF;AAChF,wBAAgB,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,iBAAiB,CAEjE;AAED,uDAAuD;AACvD,wBAAgB,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,iBAAiB,CAEjE"}

package/dist/adapters/charts/errors.js

@@ -0,0 +1,21 @@
+/** The name the chart's runtime reads for a condition a user can fix. */
+const INPUT_ERROR = 'IndicatorInputError';
+/** The name for a failure that is not about a setting. */
+const SCRIPT_ERROR = 'OpenScriptError';
+export class ChartAdapterError extends Error {
+    diagnostic;
+    constructor(diagnostic, name) {
+        super(`${diagnostic.code}: ${diagnostic.message} ${diagnostic.fix}`);
+        this.name = name;
+        this.diagnostic = diagnostic;
+    }
+}
+/** A refusal at load: the program never ran, so a setting is what to change. */
+export function refused(diagnostic) {
+    return new ChartAdapterError(diagnostic, INPUT_ERROR);
+}
+/** A failure on a bar: the program ran and stopped. */
+export function stopped(diagnostic) {
+    return new ChartAdapterError(diagnostic, SCRIPT_ERROR);
+}
+//# sourceMappingURL=errors.js.map

package/dist/adapters/charts/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/adapters/charts/errors.ts"],"names":[],"mappings":"AAoBA,yEAAyE;AACzE,MAAM,WAAW,GAAG,qBAAqB,CAAC;AAE1C,0DAA0D;AAC1D,MAAM,YAAY,GAAG,iBAAiB,CAAC;AAEvC,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,UAAU,CAAa;IAEhC,YAAY,UAAsB,EAAE,IAAY;QAC9C,KAAK,CAAC,GAAG,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,UAAU,OAAO,CAAC,UAAsB;IAC5C,OAAO,IAAI,iBAAiB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AACxD,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,OAAO,CAAC,UAAsB;IAC5C,OAAO,IAAI,iBAAiB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;AACzD,CAAC"}

package/dist/adapters/charts/fields.d.ts

@@ -0,0 +1,33 @@
+/**
+ * A declaration field, read.
+ *
+ * Every field of `meta` and of every declaration in `outputs` holds either a
+ * value or the reference `{ "input": key }`, and the reference is how a tunable
+ * colour, a tunable pane range or a tunable band opacity reaches a declaration
+ * that is otherwise fixed before the first bar. The engine resolves those once
+ * at load, against the settings the host handed it; this module resolves the
+ * same fields against the settings the chart currently holds, which is what a
+ * descriptor built once and restyled many times needs.
+ *
+ * The lookup is a parameter rather than a settings object because converting one
+ * stored setting into a value is the input table's job, not this module's, and
+ * passing it in is what keeps the two from having to import each other.
+ */
+import type { Field, InputReference } from '../../core/emit/index.js';
+import type { ColourValue, Value } from '../../core/engine/index.js';
+/** What a field's `{ "input": key }` form is resolved through. */
+export type InputLookup = (key: string) => Value;
+export declare function isReference(field: Field): field is InputReference;
+/** A field as a value, with any input reference resolved. */
+export declare function fieldOf(field: Field, lookup: InputLookup): Value;
+/** A field that holds a colour, or nothing when it holds none. */
+export declare function colourField(field: Field, lookup: InputLookup): ColourValue | undefined;
+export declare function numberField(field: Field, lookup: InputLookup, fallback: number): number;
+export declare function stringField(field: Field, lookup: InputLookup, fallback: string): string;
+export declare function boolField(field: Field, lookup: InputLookup): boolean | undefined;
+/** A field that holds `[min, max]`, or nothing when it holds no such pair. */
+export declare function rangeField(field: Field, lookup: InputLookup): {
+    readonly min: number;
+    readonly max: number;
+} | null;
+//# sourceMappingURL=fields.d.ts.map

package/dist/adapters/charts/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../src/adapters/charts/fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAU,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAGrE,kEAAkE;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,KAAK,CAAC;AAEjD,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,IAAI,cAAc,CAEjE;AAED,6DAA6D;AAC7D,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,KAAK,CAKhE;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CAGtF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,CAGhF;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CACxB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,WAAW,GAClB;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAOvD"}

package/dist/adapters/charts/fields.js

@@ -0,0 +1,51 @@
+import { isColourValue } from './colours.js';
+export function isReference(field) {
+    return typeof field === 'object' && field !== null && !Array.isArray(field);
+}
+/** A field as a value, with any input reference resolved. */
+export function fieldOf(field, lookup) {
+    if (field === null)
+        return null;
+    if (isReference(field))
+        return lookup(field.input);
+    if (Array.isArray(field))
+        return colourFrom(field);
+    return field;
+}
+/** A field that holds a colour, or nothing when it holds none. */
+export function colourField(field, lookup) {
+    const value = fieldOf(field, lookup);
+    return isColourValue(value) ? value : undefined;
+}
+export function numberField(field, lookup, fallback) {
+    const value = fieldOf(field, lookup);
+    return typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+}
+export function stringField(field, lookup, fallback) {
+    const value = fieldOf(field, lookup);
+    return typeof value === 'string' ? value : fallback;
+}
+export function boolField(field, lookup) {
+    const value = fieldOf(field, lookup);
+    return typeof value === 'boolean' ? value : undefined;
+}
+/** A field that holds `[min, max]`, or nothing when it holds no such pair. */
+export function rangeField(field, lookup) {
+    const value = isReference(field) ? lookup(field.input) : field;
+    if (!Array.isArray(value) || value.length !== 2)
+        return null;
+    const [min, max] = value;
+    if (typeof min !== 'number' || typeof max !== 'number')
+        return null;
+    if (!Number.isFinite(min) || !Number.isFinite(max))
+        return null;
+    return { min, max };
+}
+/** The four numbers a colour field carries, as the value model holds them. */
+function colourFrom(field) {
+    if (field.length !== 4)
+        return null;
+    const [r, g, b, a] = field;
+    return { tag: 'color', r, g, b, a };
+}
+//# sourceMappingURL=fields.js.map

package/dist/adapters/charts/fields.js.map

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

package/dist/adapters/charts/fills.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Declared bands into the chart's shaded bands.
+ *
+ * A band is two plot keys and two colours, which is the chart's own spec, so the
+ * pair of keys crosses unchanged. Two details do not.
+ *
+ * **Opacity is a dimmer, not a second alpha.** A colour carries its own alpha
+ * everywhere in the language, and the band's `opacity` multiplies whatever the
+ * colours already are. That is exactly what the chart does with the field, so a
+ * script that never touches it gets the colour it wrote.
+ *
+ * **A band with no colour of its own follows the first plot.** `stdlib.md` 14.2
+ * says such a band is that plot's colour faded to twelve percent, and the plot's
+ * colour may be one the host picked from its palette rather than one the script
+ * wrote, so the band is pointed at the plot's settings key rather than at a value
+ * read now. The twelve percent is then the dimmer, multiplied by whatever the
+ * script asked for.
+ */
+import type { CompiledProgram } from '../../core/emit/index.js';
+import type { ChartFill } from './contract.js';
+import type { InputLookup } from './fields.js';
+export declare function buildFills(program: CompiledProgram, lookup: InputLookup): readonly ChartFill[];
+//# sourceMappingURL=fills.d.ts.map

package/dist/adapters/charts/fills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fills.d.ts","sourceRoot":"","sources":["../../../src/adapters/charts/fills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAQ,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAU/C,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,SAAS,EAAE,CAI9F"}

package/dist/adapters/charts/fills.js

@@ -0,0 +1,48 @@
+import { cssColour } from './colours.js';
+import { boolField, colourField, isReference, numberField } from './fields.js';
+/**
+ * The fade a band with no declared colour is drawn at, `stdlib.md` 14.2.
+ *
+ * It is written here because the adapter has to multiply it by the script's own
+ * opacity, and a chart applies its own default only where the field is absent.
+ */
+const UNCOLOURED_FADE = 0.12;
+export function buildFills(program, lookup) {
+    const out = [];
+    for (const band of program.outputs.fills)
+        out.push(oneBand(program, band, lookup));
+    return out;
+}
+function oneBand(program, band, lookup) {
+    const up = colourField(band.colorUp, lookup);
+    const down = colourField(band.colorDown, lookup);
+    const overlay = boolField(band.overlay, lookup);
+    const declared = up !== undefined || down !== undefined;
+    const opacity = numberField(band.opacity, lookup, 1) * (declared ? 1 : UNCOLOURED_FADE);
+    const follow = declared ? undefined : plotColourKey(program, band.between[0]);
+    return {
+        between: band.between,
+        ...(up === undefined ? {} : { colorUp: cssColour(up) }),
+        ...(down === undefined ? {} : { colorDown: cssColour(down) }),
+        ...(isReference(band.colorUp) ? { colorUpKey: band.colorUp.input } : {}),
+        ...(isReference(band.colorDown) ? { colorDownKey: band.colorDown.input } : {}),
+        ...(follow === undefined ? {} : { colorUpKey: follow, colorDownKey: follow }),
+        opacity,
+        ...(overlay === undefined ? {} : { overlay }),
+    };
+}
+/**
+ * The settings key holding a plot's colour.
+ *
+ * A chart generates one appearance row per plot and names it after the plot,
+ * except where the plot declares a colour key of its own, which is what a plot
+ * whose colour came from an `input()` does. The two cases are the same two this
+ * adapter produces in `plots.ts`.
+ */
+function plotColourKey(program, key) {
+    const plot = program.outputs.plots.find((one) => one.key === key);
+    if (plot !== undefined && isReference(plot.color))
+        return plot.color.input;
+    return `${key}:color`;
+}
+//# sourceMappingURL=fills.js.map

package/dist/adapters/charts/fills.js.map

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

package/dist/adapters/charts/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The chart adapter: a compiled program becomes a chart's indicator descriptor.
+ *
+ * This is the only module in the repository allowed to know two worlds at once,
+ * and it is the piece a platform with its own chart replaces rather than the
+ * piece it patches. Everything under `src/core` stays ignorant of charts, and
+ * the layering check is what keeps it that way.
+ *
+ * **The chart library is a peer dependency, and nothing here imports it.** A
+ * package that pulled a chart into everyone's install would defeat the point of
+ * a language that a platform can take on its own, so the descriptor's shape is
+ * declared in `contract.ts` and the value this produces is assigned to the
+ * library's own type by the host, in one line, at the host's build. See that
+ * file for the line.
+ *
+ * What is mapped is the whole output surface: the declared inputs and the
+ * settings dialog a chart generates from them, the plots with their styles and
+ * scales, the bands between them, the horizontal levels, the pane's fixed range,
+ * the markers, the candle and pane painting, the summary grid, the drawing
+ * objects a script mutates over time, the watched conditions, and the lifecycle
+ * a read of another instrument fetches through.
+ *
+ * What a study can express and this descriptor has no field for is recorded,
+ * with its reason, in `spec/chart-narrowings.json`, and each one is also named
+ * in the file that would have written it. `scripts/check-chart-surface.mjs`
+ * reads that record against a compiled program, so the list cannot grow in
+ * silence.
+ */
+export { descriptorFor } from './descriptor.js';
+export { candleOwner } from './paint.js';
+export type { Painter } from './paint.js';
+export { ChartAdapterError } from './errors.js';
+export { release } from './run.js';
+export type { ChartAdapterOptions } from './run.js';
+export type { ChartBar, ChartCalcContext, ChartDescriptor, ChartFill, ChartInput, ChartLevel, ChartLevelContext, ChartLineStyle, ChartPlot, ChartPriceFormat, ChartPriceScaleId, ChartSeriesStyle, ChartSeriesType, ChartSettings, ChartSource, ChartStore, ChartValues, } from './contract.js';
+export type { ChartAlertContext, ChartAlertSpec, ChartAnchor, ChartAttachContext, ChartBarsRequest, ChartCell, ChartCellAlign, ChartDataChange, ChartDataStatus, ChartDrawing, ChartGrid, ChartMarker, ChartMarkerPosition, ChartMarkerShape, ChartMarkerSize, ChartSurfaceContext, ChartTableOptions, ChartTablePosition, } from './surfaces.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/charts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/charts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,eAAe,EACf,eAAe,EACf,YAAY,EACZ,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,eAAe,CAAC"}

package/dist/adapters/charts/index.js

@@ -0,0 +1,33 @@
+/**
+ * The chart adapter: a compiled program becomes a chart's indicator descriptor.
+ *
+ * This is the only module in the repository allowed to know two worlds at once,
+ * and it is the piece a platform with its own chart replaces rather than the
+ * piece it patches. Everything under `src/core` stays ignorant of charts, and
+ * the layering check is what keeps it that way.
+ *
+ * **The chart library is a peer dependency, and nothing here imports it.** A
+ * package that pulled a chart into everyone's install would defeat the point of
+ * a language that a platform can take on its own, so the descriptor's shape is
+ * declared in `contract.ts` and the value this produces is assigned to the
+ * library's own type by the host, in one line, at the host's build. See that
+ * file for the line.
+ *
+ * What is mapped is the whole output surface: the declared inputs and the
+ * settings dialog a chart generates from them, the plots with their styles and
+ * scales, the bands between them, the horizontal levels, the pane's fixed range,
+ * the markers, the candle and pane painting, the summary grid, the drawing
+ * objects a script mutates over time, the watched conditions, and the lifecycle
+ * a read of another instrument fetches through.
+ *
+ * What a study can express and this descriptor has no field for is recorded,
+ * with its reason, in `spec/chart-narrowings.json`, and each one is also named
+ * in the file that would have written it. `scripts/check-chart-surface.mjs`
+ * reads that record against a compiled program, so the list cannot grow in
+ * silence.
+ */
+export { descriptorFor } from './descriptor.js';
+export { candleOwner } from './paint.js';
+export { ChartAdapterError } from './errors.js';
+export { release } from './run.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/charts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/charts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/adapters/charts/levels.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Declared levels into the chart's horizontal levels, and the pane's range.
+ *
+ * A level's price is a channel rather than a constant, so it is evaluated on
+ * every bar and **the level drawn is the one from the last bar executed**. That
+ * is what makes a level that tracks the data possible at all, and the chart
+ * recomputes its levels after every calculation for the same reason, so the two
+ * meet without either giving anything up: the price travels in the values table
+ * like any other column and is read at its last entry.
+ *
+ * A level whose last value is absent is not drawn, which is the rule for an
+ * absent value reaching any drawn surface: a line breaks, a band stops, a level
+ * is not drawn. Returning it at some substituted price would put a line on the
+ * chart that the script did not ask for.
+ *
+ * The colour, the dash and the width are read against the settings the chart
+ * holds at the moment it asks, not against the ones it held when the descriptor
+ * was built, so a level whose colour came from an `input()` follows the dialog.
+ */
+import type { CompiledProgram } from '../../core/emit/index.js';
+import type { ColumnSpec } from './columns.js';
+import type { ChartLevel, ChartLevelContext, ChartSettings } from './contract.js';
+export interface LevelsBuild {
+    readonly columns: readonly ColumnSpec[];
+    levels(ctx: ChartLevelContext): readonly ChartLevel[];
+}
+export declare function buildLevels(program: CompiledProgram): LevelsBuild;
+/**
+ * The study's own pane range, or nothing when it fixed none.
+ *
+ * It is read per call rather than once, because `range` is one of the fields a
+ * script may write with an `input()`, and a chart asks again whenever the
+ * settings change.
+ */
+export declare function buildRange(program: CompiledProgram): (settings: ChartSettings) => {
+    readonly min: number;
+    readonly max: number;
+} | null;
+//# sourceMappingURL=levels.d.ts.map

package/dist/adapters/charts/levels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"levels.d.ts","sourceRoot":"","sources":["../../../src/adapters/charts/levels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGhE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAkB,aAAa,EAAE,MAAM,eAAe,CAAC;AAMlG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,SAAS,UAAU,EAAE,CAAC;CACvD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,CAgCjE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,eAAe,GACvB,CAAC,QAAQ,EAAE,aAAa,KAAK;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAEpF"}

package/dist/adapters/charts/levels.js

@@ -0,0 +1,61 @@
+import { cssColour } from './colours.js';
+import { levelKey } from './columns.js';
+import { colourField, numberField, rangeField, stringField } from './fields.js';
+import { lookupFor } from './settings.js';
+const LINE_STYLES = ['solid', 'dashed', 'dotted'];
+export function buildLevels(program) {
+    const columns = program.outputs.levels.map((declared, index) => ({
+        key: levelKey(index),
+        channel: declared.channel,
+        part: 'value',
+    }));
+    return {
+        columns,
+        levels(ctx) {
+            const lookup = lookupFor(program, settingsOf(ctx));
+            const out = [];
+            for (let index = 0; index < program.outputs.levels.length; index += 1) {
+                const declared = program.outputs.levels[index];
+                if (declared === undefined)
+                    continue;
+                const column = ctx.values?.[levelKey(index)];
+                const price = column === undefined ? undefined : column[column.length - 1];
+                if (typeof price !== 'number')
+                    continue;
+                const colour = colourField(declared.color, lookup);
+                const title = stringField(declared.title, lookup, '');
+                const style = stringField(declared.lineStyle, lookup, 'dashed');
+                out.push({
+                    price,
+                    ...(colour === undefined ? {} : { color: cssColour(colour) }),
+                    ...(title === '' ? {} : { title }),
+                    lineWidth: numberField(declared.lineWidth, lookup, 1),
+                    lineStyle: LINE_STYLES.includes(style) ? style : 'dashed',
+                });
+            }
+            return out;
+        },
+    };
+}
+/**
+ * The study's own pane range, or nothing when it fixed none.
+ *
+ * It is read per call rather than once, because `range` is one of the fields a
+ * script may write with an `input()`, and a chart asks again whenever the
+ * settings change.
+ */
+export function buildRange(program) {
+    return (settings) => rangeField(program.meta.range, lookupFor(program, settings));
+}
+/**
+ * The settings a level context carries.
+ *
+ * The context spreads the settings keys onto itself and also carries them under
+ * `settings`, so a caller that built one by hand from a settings bag alone still
+ * works: the named member when there is one, the context itself otherwise.
+ */
+function settingsOf(ctx) {
+    const named = ctx.settings;
+    return named === undefined ? ctx : named;
+}
+//# sourceMappingURL=levels.js.map

package/dist/adapters/charts/levels.js.map

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