openalgo-script 0.1.0-alpha.0 → 0.2.0

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

@@ -0,0 +1,78 @@
+/**
+ * The declared inputs, in both directions.
+ *
+ * Out: one settings row per `input()` call, which is the whole of the generated
+ * settings dialog. The program already carries the label, the group, the help
+ * text, the bounds and the choices, because a settings dialog and a legend have
+ * to exist before the first bar runs, so nothing here decides anything. It
+ * translates a `kind` into the control a chart renders.
+ *
+ * Back in: what a dialog stored, turned into the values the engine validates.
+ * Two kinds need work and the rest pass through untouched. A colour arrives as a
+ * CSS string and has to become four numbers. A choice arrives as a string even
+ * when the script wrote numbers, because a select control has string values, so
+ * the stored string is matched against the declared options and the option's own
+ * value is what the engine is given.
+ *
+ * **A value the host stored and this module cannot convert is passed through
+ * rather than replaced.** The engine refuses it with OS6019, naming the key and
+ * the rule it broke. Substituting the default here would be a settings dialog
+ * that silently ignores what a user typed, which is the failure `2.6` is written
+ * to prevent, and it would hide it one layer further down than the engine does.
+ *
+ * **And a stored value the engine will refuse is not a value this adapter has.**
+ * The declared shape is built before anything runs, so a settings map holding a
+ * precision of 99 against an input declared `max = 8` put 99 into
+ * `plots[0].priceFormat`, which a host can show in a legend or on a price scale
+ * before the calculation that refuses it has been asked for. What a stored value
+ * is worth has one answer and it is the engine's own: `checkSetting` is the
+ * function the load refuses with, asked here before the load exists. A value it
+ * will not take reads as the **declared default** in the declared shape, and
+ * travels to the engine exactly as the host stored it, so the run still stops
+ * with OS6019 naming the key and the bound.
+ *
+ * Neither half of that is a fallback. The value is not repaired, because the
+ * same map still refuses; and the shape is not withheld, because the settings
+ * dialog a reader corrects the value in is built from the descriptor, and a
+ * study that refuses to describe itself is one whose bad setting cannot be
+ * reached. What a host is handed meanwhile is the shape the script declared,
+ * which is the shape the study has until a settings map the engine takes
+ * arrives.
+ */
+import type { CompiledInput, CompiledProgram } from '../../core/emit/index.js';
+import type { Value } from '../../core/engine/index.js';
+import type { ChartInput, ChartSettings } from './contract.js';
+import type { InputLookup } from './fields.js';
+/** One settings row per declared input, in source order. */
+export declare function inputRows(program: CompiledProgram): readonly ChartInput[];
+/**
+ * What the engine is handed as the host's settings.
+ *
+ * Only the declared keys travel. A chart's settings object also carries the
+ * generated per-plot appearance keys and the chart's timezone, and an engine
+ * given those would have nothing to do with them; leaving them out keeps the
+ * two vocabularies from having to agree on anything but the input keys.
+ */
+export declare function engineSettings(program: CompiledProgram, settings: ChartSettings): Record<string, unknown>;
+/** The value each declared input currently holds, for a declaration field. */
+export declare function lookupFor(program: CompiledProgram, settings: ChartSettings): InputLookup;
+/**
+ * A comparable spelling of every declared input's value.
+ *
+ * The incremental path is only valid while the engine it holds was loaded from
+ * the same settings, and comparing the two spellings is cheaper and safer than
+ * trusting a chart to have told us that a settings change happened.
+ *
+ * **It spells what the engine is handed, not what the declared shape shows.**
+ * Those part company the moment a stored value is one the engine refuses: every
+ * refused value shows the same declared default, so a signature taken from the
+ * shape would read a change from a setting that runs to one that cannot as no
+ * change at all, keep the held engine and go on drawing the old numbers instead
+ * of reporting OS6019. The kind is spelled beside the value for the same
+ * reason: a stored `7` and a stored `"7"` are one quotation mark apart, and one
+ * of them is refused.
+ */
+export declare function signatureOf(program: CompiledProgram, settings: ChartSettings): string;
+/** The declared default, as the value model holds it. */
+export declare function defaultValue(declared: CompiledInput): Value;
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../src/adapters/charts/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAY,MAAM,0BAA0B,CAAC;AAEzF,OAAO,KAAK,EAAe,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAe,MAAM,eAAe,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAc/C,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,UAAU,EAAE,CAIzE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,aAAa,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,GAAG,WAAW,CAMxF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,CAMrF;AAED,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,KAAK,CAE3D"}

package/dist/adapters/charts/settings.js

@@ -0,0 +1,225 @@
+import { checkSetting, constantValue } from '../../core/engine/index.js';
+import { cssColour, isColourValue, parseColour } from './colours.js';
+/** The eight series a `"source"` input may select, in the order 2.6 lists them. */
+const SOURCES = [
+    'open',
+    'high',
+    'low',
+    'close',
+    'hl2',
+    'hlc3',
+    'ohlc4',
+    'volume',
+];
+/** One settings row per declared input, in source order. */
+export function inputRows(program) {
+    const rows = [];
+    for (const declared of program.inputs)
+        rows.push(rowFor(declared));
+    return rows;
+}
+/**
+ * What the engine is handed as the host's settings.
+ *
+ * Only the declared keys travel. A chart's settings object also carries the
+ * generated per-plot appearance keys and the chart's timezone, and an engine
+ * given those would have nothing to do with them; leaving them out keeps the
+ * two vocabularies from having to agree on anything but the input keys.
+ */
+export function engineSettings(program, settings) {
+    const out = {};
+    for (const declared of program.inputs) {
+        const supplied = storedValue(declared, settings);
+        if (supplied !== undefined)
+            out[declared.key] = supplied;
+    }
+    return out;
+}
+/** The value each declared input currently holds, for a declaration field. */
+export function lookupFor(program, settings) {
+    return (key) => {
+        const declared = program.inputs.find((one) => one.key === key);
+        if (declared === undefined)
+            return null;
+        return effectiveValue(declared, settings);
+    };
+}
+/**
+ * A comparable spelling of every declared input's value.
+ *
+ * The incremental path is only valid while the engine it holds was loaded from
+ * the same settings, and comparing the two spellings is cheaper and safer than
+ * trusting a chart to have told us that a settings change happened.
+ *
+ * **It spells what the engine is handed, not what the declared shape shows.**
+ * Those part company the moment a stored value is one the engine refuses: every
+ * refused value shows the same declared default, so a signature taken from the
+ * shape would read a change from a setting that runs to one that cannot as no
+ * change at all, keep the held engine and go on drawing the old numbers instead
+ * of reporting OS6019. The kind is spelled beside the value for the same
+ * reason: a stored `7` and a stored `"7"` are one quotation mark apart, and one
+ * of them is refused.
+ */
+export function signatureOf(program, settings) {
+    const parts = [];
+    for (const declared of program.inputs) {
+        parts.push(`${declared.key}=${spellStored(storedValue(declared, settings))}`);
+    }
+    return parts.join('\u0000');
+}
+/** The declared default, as the value model holds it. */
+export function defaultValue(declared) {
+    return constantValue(declared.default);
+}
+function rowFor(declared) {
+    const held = defaultValue(declared);
+    const label = declared.label;
+    const key = declared.key;
+    const extra = {
+        ...(declared.group === '' ? {} : { group: declared.group }),
+        ...(declared.tooltip === null ? {} : { tooltip: declared.tooltip }),
+    };
+    // A choice is a choice whatever the type of its members. The compiled kind is
+    // `"select"` only where the values are strings, so a script that constrained a
+    // length to two numbers arrives as a number carrying options, and a spinner
+    // would offer every value between them: the engine validates a number against
+    // its bounds and not against its options, so nothing downstream would refuse
+    // the third value a user typed. The declared choices are the control.
+    const options = declared.options ?? [];
+    if (options.length > 0) {
+        return {
+            key,
+            type: 'select',
+            label,
+            default: spell(held),
+            options: options.map((one) => {
+                const text = spell(constantValue(one));
+                return { label: text, value: text };
+            }),
+            ...extra,
+        };
+    }
+    switch (declared.kind) {
+        case 'number':
+            return {
+                key,
+                type: 'number',
+                label,
+                default: typeof held === 'number' ? held : 0,
+                ...(declared.min === null ? {} : { min: declared.min }),
+                ...(declared.max === null ? {} : { max: declared.max }),
+                ...(declared.step === null ? {} : { step: declared.step }),
+                ...extra,
+            };
+        case 'bool':
+            return { key, type: 'boolean', label, default: held === true, ...extra };
+        case 'color':
+            return {
+                key,
+                type: 'color',
+                label,
+                default: isColourValue(held) ? cssColour(held) : 'rgba(0, 0, 0, 1)',
+                ...extra,
+            };
+        case 'source':
+            return {
+                key,
+                type: 'source',
+                label,
+                default: typeof held === 'string' && SOURCES.includes(held) ? held : 'close',
+                ...extra,
+            };
+        case 'interval':
+            return { key, type: 'interval', label, default: typeof held === 'string' ? held : '', ...extra };
+        case 'time':
+            return { key, type: 'time', label, default: typeof held === 'string' ? held : '', ...extra };
+        default:
+            return { key, type: 'text', label, default: typeof held === 'string' ? held : '', ...extra };
+    }
+}
+/** What the host stored for this input, converted, or nothing when it stored none. */
+function storedValue(declared, settings) {
+    if (!Object.prototype.hasOwnProperty.call(settings, declared.key))
+        return undefined;
+    const supplied = settings[declared.key];
+    if (supplied === undefined)
+        return undefined;
+    if (declared.kind === 'color' && typeof supplied === 'string') {
+        // A swatch has no alpha channel, so a stored colour that states none keeps
+        // the alpha the script declared. See `colours.ts`.
+        const held = defaultValue(declared);
+        const parsed = parseColour(supplied, isColourValue(held) ? held.a : 1);
+        return parsed ?? supplied;
+    }
+    if (declared.options !== null && typeof supplied === 'string') {
+        // The control's values are strings even where the declared choices are not,
+        // so a stored choice is matched on its own spelling and the engine is given
+        // the option the script wrote rather than the text of it.
+        const chosen = optionFor(declared.options, supplied);
+        return chosen === undefined ? supplied : chosen;
+    }
+    return supplied;
+}
+/**
+ * The effective value: the host's where the engine will run with it.
+ *
+ * The question is `checkSetting`'s, so there is no second list of types and
+ * bounds here to disagree with the first. This file decides only what to do
+ * with the answer, and the module's own paragraph says why a refused value
+ * reads as the declared default rather than as itself.
+ *
+ * One answer is narrowed and it is narrowed on purpose: a `"time"` input's
+ * stored string is read by the host's own conversion, which `run.ts` has and
+ * this has not, so a string is taken here and the load decides it.
+ */
+function effectiveValue(declared, settings) {
+    const stored = storedValue(declared, settings);
+    if (stored === undefined)
+        return defaultValue(declared);
+    const checked = checkSetting(declared, stored);
+    return checked.ok ? checked.value : defaultValue(declared);
+}
+/** The declared option a stored string names, matched on its own spelling. */
+function optionFor(options, supplied) {
+    for (const option of options) {
+        const value = constantValue(option);
+        if (spell(value) === supplied)
+            return value;
+    }
+    return undefined;
+}
+/**
+ * A stored value as the signature spells it, kind and all.
+ *
+ * Two stored values that spell one string are a settings change the incremental
+ * path does not notice, and a dialog stores numbers and text that look alike
+ * written out while the engine takes one and refuses the other. Every value of
+ * another kind spells the same word, which costs nothing: none of them can be
+ * behind a held engine, because the load that would have held one refused it.
+ */
+function spellStored(value) {
+    if (value === undefined)
+        return 'unset';
+    if (value === null)
+        return 'none';
+    if (isColourValue(value))
+        return `color ${cssColour(value)}`;
+    if (typeof value === 'number')
+        return `number ${String(value)}`;
+    if (typeof value === 'boolean')
+        return `bool ${String(value)}`;
+    if (typeof value === 'string')
+        return `text ${value}`;
+    return 'of another kind';
+}
+/** A value as a settings control spells it. */
+function spell(value) {
+    if (value === null)
+        return '';
+    if (isColourValue(value))
+        return cssColour(value);
+    if (typeof value === 'object')
+        return '';
+    return String(value);
+}
+//# sourceMappingURL=settings.js.map

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

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

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

@@ -0,0 +1,204 @@
+/**
+ * The four surfaces that are not columns of numbers, as the chart declares them.
+ *
+ * A plot, a band and a level all reduce to one number per bar, so they ride the
+ * table a calculation returns. A marker, a grid, a drawing object and a watched
+ * condition do not: three of them carry text and the fourth carries geometry, and
+ * a chart reads each of them from its own hook on the descriptor rather than from
+ * the table. Their shapes are declared here, away from the calculation's, because
+ * they are read at a different moment and by a different part of the chart.
+ *
+ * **Every hook takes the run it is reading and not a handle to the study.** The
+ * argument is the bars, the table the calculation just returned and the settings
+ * it was run with, and there is no per-instance store among them. What travels
+ * through a hook is therefore what those three can carry, and what cannot is
+ * written down in `produced.ts`, which is the one place this adapter solves that
+ * problem.
+ *
+ * **Every member here is narrowed to what this adapter emits.** The chart draws
+ * more shapes, more marker positions and more grid options than the language has
+ * words for, and a value the language cannot express is better left out of this
+ * file than declared and never written. A narrower type stays assignable to the
+ * chart's wider one, which is what the one line in `contract.ts` checks.
+ */
+import type { ChartBar, ChartLineStyle, ChartSettings, ChartValues } from './contract.js';
+/** What every hook below is handed: the run whose output it is reading. */
+export interface ChartSurfaceContext {
+    readonly bars: readonly ChartBar[];
+    readonly values: ChartValues;
+    readonly settings: ChartSettings;
+}
+/**
+ * Where a marker sits against its bar.
+ *
+ * The language has three (`stdlib.md` 14.3) and the chart has six. `"above"` and
+ * `"below"` are the chart's own two, and `"price"` becomes the in-bar position:
+ * the language names no price to put the marker at, and a marker drawn at the
+ * close would be this adapter deciding which price `"price"` meant.
+ */
+export type ChartMarkerPosition = 'aboveBar' | 'belowBar' | 'inBar';
+/**
+ * The mark itself.
+ *
+ * Nine of the language's ten shapes are one of the chart's own under the same
+ * name. The tenth, `"label"`, is a plate of text with a tail that points at the
+ * anchor, so which of the chart's two plates it is follows from where the marker
+ * sits rather than from the word: a plate above the bar has its tail pointing
+ * down at it.
+ */
+export type ChartMarkerShape = 'arrowUp' | 'arrowDown' | 'triangleUp' | 'triangleDown' | 'circle' | 'square' | 'diamond' | 'cross' | 'flag' | 'labelUp' | 'labelDown' | 'text';
+/** The four glyph sizes a chart draws a marker at. */
+export type ChartMarkerSize = 'tiny' | 'small' | 'medium' | 'big';
+/** One marker on one bar: a discrete event with a label, not a column. */
+export interface ChartMarker {
+    /** The bar's time, in the seconds a chart holds. */
+    readonly time: number;
+    readonly position: ChartMarkerPosition;
+    readonly shape: ChartMarkerShape;
+    readonly size: ChartMarkerSize;
+    readonly color: string;
+    readonly text?: string;
+}
+export type ChartCellAlign = 'left' | 'center' | 'right';
+/** One cell of a grid, as the last executed bar left it. */
+export interface ChartCell {
+    readonly text: string;
+    readonly textColor?: string;
+    readonly bgColor?: string;
+    readonly align?: ChartCellAlign;
+}
+/** Which corner of the pane a grid is pinned to. */
+export type ChartTablePosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+/** The grid options this adapter sets. A chart's own defaults fill the rest. */
+export interface ChartTableOptions {
+    readonly position: ChartTablePosition;
+    readonly borderWidth: number;
+    /** The backdrop behind the whole grid, which is the grid's own `bgColor`. */
+    readonly background?: string;
+}
+/** A grid of cells pinned to a corner, and the options it is drawn with. */
+export interface ChartGrid {
+    readonly rows: readonly (readonly ChartCell[])[];
+    readonly options?: ChartTableOptions;
+}
+/** One end of a drawing: a time on the shared axis, a price on the pane's scale. */
+export interface ChartAnchor {
+    readonly time: number;
+    readonly price: number;
+}
+/**
+ * One free-standing shape, anchored to time and price rather than to a bar.
+ *
+ * The four kinds are the language's four, `stdlib.md` 14.4, and the fields are
+ * the chart's own names for the same arguments. The whole list is replaced on
+ * every recompute, which is what makes a script that deletes an object have it
+ * disappear and a script that rolls a bar back not accumulate one per tick.
+ */
+export type ChartDrawing = {
+    readonly kind: 'line';
+    readonly from: ChartAnchor;
+    readonly to: ChartAnchor;
+    readonly color?: string;
+    readonly lineWidth?: number;
+    readonly lineStyle?: ChartLineStyle;
+    readonly extendLeft?: boolean;
+    readonly extendRight?: boolean;
+} | {
+    readonly kind: 'box';
+    readonly from: ChartAnchor;
+    readonly to: ChartAnchor;
+    readonly color?: string;
+    readonly fillColor?: string;
+    readonly opacity?: number;
+    readonly lineWidth?: number;
+    readonly text?: string;
+    readonly textColor?: string;
+    readonly tooltip?: string;
+} | {
+    readonly kind: 'label';
+    readonly at: ChartAnchor;
+    readonly text: string;
+    readonly color?: string;
+    readonly textColor?: string;
+    readonly align?: ChartCellAlign;
+    readonly tooltip?: string;
+} | {
+    readonly kind: 'polyline';
+    readonly points: readonly ChartAnchor[];
+    readonly color?: string;
+    readonly lineWidth?: number;
+    readonly closed?: boolean;
+    readonly fillColor?: string;
+    readonly opacity?: number;
+};
+/** What an alert's condition is handed, for the bar it is judging. */
+export interface ChartAlertContext extends ChartSurfaceContext {
+    readonly index: number;
+}
+/**
+ * One watched condition, declared before bar 0 and evaluated by the chart.
+ *
+ * The chart judges bars that are new since it last looked, which is the rule
+ * `stdlib.md` 16.2 states from the other side: a study added to a chart holding
+ * two years of bars announces none of them.
+ */
+export interface ChartAlertSpec {
+    readonly id: string;
+    readonly title: string;
+    /**
+     * The notification's text, computed for the bar that fired.
+     *
+     * The chart takes either a fixed string or a function of the same context
+     * `when` was judged on, and it calls the function only for a bar `when`
+     * accepted. This adapter writes only the function: a declared alert's message
+     * is an expression evaluated on the bar, so a fixed string could only ever be
+     * the title again, which is what this used to hand over.
+     */
+    message?(ctx: ChartAlertContext): string;
+    when(ctx: ChartAlertContext): boolean;
+}
+/**
+ * Bars of another instrument or interval, as the host is asked for them.
+ *
+ * There is no cancellation token on it, and none is needed: a chart bounds every
+ * request it forwards by the study instance's own lifetime, so a study removed
+ * while another instrument is loading is not answered after it is gone. A second
+ * token carried from here would be the same fact stated twice, and the weaker of
+ * the two.
+ */
+export interface ChartBarsRequest {
+    readonly symbol: string;
+    readonly exchange?: string;
+    readonly interval: string;
+    /** UTC seconds, both ends. */
+    readonly from: number;
+    readonly to: number;
+}
+/** What a study says about the data it is waiting for. */
+export type ChartDataStatus = {
+    readonly state: 'loading' | 'ready' | 'empty' | 'unsupported';
+} | {
+    readonly state: 'error';
+    readonly error: unknown;
+};
+/** Why the host says the bars or the identity behind a study have moved. */
+export type ChartDataChange = 'context' | 'range';
+/**
+ * The lifecycle of one study instance, for the data that is not on its bars.
+ *
+ * It is the only place the chart offers a transport, and a read of another
+ * instrument is the only thing in this language that needs one. Everything else
+ * a study produces is computed from bars the chart already holds.
+ */
+export interface ChartAttachContext {
+    /** Scratch this instance owns: the same object the calculation receives. */
+    readonly store: Record<string, unknown>;
+    /** Ask the host for another instrument's bars. Absent when it serves none. */
+    requestBars?(request: ChartBarsRequest): Promise<readonly ChartBar[]>;
+    /** Run the calculation again and repaint, once an answer has arrived. */
+    requestRecompute(): void;
+    setDataStatus?(status: ChartDataStatus): void;
+    setDataRetry?(retry: (() => void) | null): void;
+    subscribeDataChanges?(listener: (change: ChartDataChange) => void): () => void;
+}
+//# sourceMappingURL=surfaces.d.ts.map

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

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

package/dist/adapters/charts/surfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=surfaces.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.js","sourceRoot":"","sources":["../../../src/adapters/charts/surfaces.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,65 @@
+/**
+ * Declared grids into the chart's summary grid.
+ *
+ * **A table is written, not plotted.** It is the one output that is not a value
+ * per bar: its cells are written by library calls against a handle, into a
+ * buffer the engine empties at the start of every execution of a bar
+ * (`compiled-program.md` 2.8 and 5.1). What survives is what the last executed
+ * bar wrote, which is what a grid pinned to a corner of a pane shows.
+ *
+ * **So it is read once, after the run, and never per bar.** The obvious way to
+ * get this wrong is to collect a grid for every bar of a long history in order
+ * to display the last one, which costs the length of the history and throws all
+ * of it away. The engine holds one buffer per grid rather than one per bar, and
+ * this reads it exactly once per calculation, so a hundred thousand bars cost
+ * the same as ten.
+ *
+ * A script pays the other half of that bill for itself: `cell()` on every bar of
+ * a long history does the work of writing a grid that only the last bar's copy
+ * is kept from, and the documentation says to guard it with `bar.isLast`. That
+ * is a script's decision and not one this can make for it, because the buffer is
+ * cleared per bar and an engine cannot know which execution is the last one
+ * until it is.
+ *
+ * **The engine's cells are sparse and the chart's grid is dense.** A script
+ * writes the cells it has something to say about; the chart draws rows of cells.
+ * So the declared size is filled with blank cells and the written ones are
+ * placed into it, which is what `language.md` 6.7 asks for from the other
+ * direction: a cell nothing was written into is blank, never a zero.
+ *
+ * **A chart pane holds one grid and the language declares as many as it likes.**
+ * The descriptor has one `table` hook, so the first declared grid is the one
+ * drawn and any after it are not. That is a gap in the chart's own contract
+ * rather than a choice worth making here: there is no second hook to write to,
+ * and merging two grids into one would put cells somewhere the script never
+ * asked for.
+ *
+ * **What ought to happen is a refusal, and it cannot be written yet.** A study
+ * whose second grid never appears is a study with no explanation, so the second
+ * `table()` should be refused where it is written, naming the limit. Every
+ * diagnostic in this project carries a catalogue code and the catalogue has
+ * none for "the chart cannot draw something this study declares"; inventing one
+ * here is the one thing that is not allowed, so the gap is reported instead, in
+ * `issues/0011-a-second-declared-grid-is-dropped-with-nothing-said.md`, with the
+ * sentence it should carry.
+ *
+ * Until it lands, the drop is at least no longer silent inside this repository:
+ * it is recorded in `spec/chart-narrowings.json` with its reason, and
+ * `scripts/check-chart-surface.mjs` fails the build if this adapter ever drops
+ * anything else a compiled program declares without recording it there.
+ */
+import type { CompiledProgram } from '../../core/emit/index.js';
+import type { Grid } from '../../core/engine/index.js';
+import type { InputLookup } from './fields.js';
+import type { ChartGrid } from './surfaces.js';
+/**
+ * The grid a chart draws, from the declaration and the engine's buffer.
+ *
+ * The buffer is paired with the declaration by the key both of them carry
+ * rather than by position. The engine reads its grids in declaration order, so
+ * the two agree today, and a pairing by position is one reordering away from
+ * drawing one grid's cells into another grid's shape, which would be a wrong
+ * table that looks like a right one.
+ */
+export declare function buildTable(program: CompiledProgram, lookup: InputLookup, written: readonly Grid[]): ChartGrid | null;
+//# sourceMappingURL=tables.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../../src/adapters/charts/tables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,0BAA0B,CAAC;AACtF,OAAO,KAAK,EAAE,IAAI,EAAY,MAAM,4BAA4B,CAAC;AAGjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAGV,SAAS,EAEV,MAAM,eAAe,CAAC;AAYvB;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,SAAS,IAAI,EAAE,GACvB,SAAS,GAAG,IAAI,CAIlB"}