openalgo-script 0.1.0-alpha.1 → 0.4.0

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

@@ -0,0 +1,221 @@
+/**
+ * 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;
+    /**
+     * Column widths in media pixels, one per column.
+     *
+     * The chart's own default is one flat width for every column, which is a
+     * width chosen without seeing the text. A grid whose first column says
+     * "Moving averages" and whose second says "RSI: 27.22" has two columns that
+     * want different room, and one number cannot give it to both.
+     */
+    readonly cellWidth?: readonly number[];
+    /**
+     * `'auto'` to shrink a cell's type until its text fits the cell it is in.
+     *
+     * The chart measures the text it is about to draw, which nothing upstream of
+     * it can do, so this is what makes a column width that is slightly wrong
+     * merely slightly loose instead of two cells written over each other.
+     */
+    readonly fontSize?: number | 'auto';
+}
+/** 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"}

package/dist/adapters/charts/tables.js

@@ -0,0 +1,166 @@
+import { cssColour, cssOf } from './colours.js';
+import { colourField, numberField, stringField } from './fields.js';
+/** The language's four corners, in the chart's own words. */
+const CORNERS = {
+    topLeft: 'top-left',
+    topRight: 'top-right',
+    bottomLeft: 'bottom-left',
+    bottomRight: 'bottom-right',
+};
+const ALIGNMENTS = ['left', 'center', 'right'];
+/**
+ * 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 function buildTable(program, lookup, written) {
+    const declared = program.outputs.tables[0];
+    if (declared === undefined)
+        return null;
+    return oneTable(declared, lookup, written.find((one) => one.key === declared.key));
+}
+function oneTable(declared, lookup, written) {
+    const position = stringField(declared.position, lookup, 'topRight');
+    const textColour = colourField(declared.options.textColor, lookup);
+    const bgColour = colourField(declared.options.bgColor, lookup);
+    const rows = whole(numberField(declared.rows, lookup, 0));
+    const cols = whole(numberField(declared.cols, lookup, 0));
+    const fallback = textColour === undefined ? undefined : cssColour(textColour);
+    const grid = [];
+    for (let row = 0; row < rows; row += 1) {
+        grid.push(new Array(cols).fill({ text: '' }));
+    }
+    for (const cell of written?.cells ?? []) {
+        const built = oneCell(cell, fallback);
+        const line = grid[cell.row];
+        if (built === undefined || line === undefined || cell.col >= cols)
+            continue;
+        line[cell.col] = built;
+    }
+    return {
+        rows: grid,
+        options: {
+            position: CORNERS[position] ?? 'top-right',
+            borderWidth: numberField(declared.options.borderWidth, lookup, 0),
+            ...(bgColour === undefined ? {} : { background: cssColour(bgColour) }),
+            ...(cols > 0 ? { cellWidth: columnWidths(grid, cols) } : {}),
+            // The chart measures the text it is about to draw and shrinks it to fit,
+            // which is the half of this that cannot be done from here.
+            fontSize: 'auto',
+        },
+    };
+}
+/**
+ * How wide each column has to be, in media pixels.
+ *
+ * The chart's default is one width for every column, chosen without seeing the
+ * text, and a grid whose header says "Moving averages" over cells saying
+ * "RSI: 27.22" has one column bleeding into the next. Nothing downstream can
+ * choose better, because by the time the chart has the grid it has lost which
+ * cells belong together; and nothing upstream can, because the script declares
+ * a size and writes text, not a layout.
+ *
+ * **This is an estimate, and it is allowed to be.** A real width needs the font
+ * the chart will draw with, and only the chart has it. So the width is counted
+ * off the characters and the chart's own `fontSize: 'auto'` corrects whatever
+ * this gets wrong: too narrow and the type shrinks a little, too wide and the
+ * column is a little loose. Either is a table that reads. The failure this
+ * replaces was neither.
+ *
+ * Delete it when the chart can size a column from its own measurements. It
+ * exists because that is not a thing it can be asked to do yet.
+ */
+function columnWidths(grid, cols) {
+    const widths = [];
+    for (let col = 0; col < cols; col += 1) {
+        let widest = 0;
+        for (const row of grid) {
+            const text = row[col]?.text ?? '';
+            if (text.length > 0)
+                widest = Math.max(widest, textWidth(text));
+        }
+        widths.push(Math.min(MAX_COLUMN, Math.max(MIN_COLUMN, Math.ceil(widest) + CELL_PADDING * 2)));
+    }
+    return widths;
+}
+/**
+ * Roughly how wide a string is at the type size the chart starts from.
+ *
+ * Counted rather than measured, and counted in two weights rather than one: a
+ * column of "Histogram: -7.01" is half punctuation and narrow digits, and
+ * treating every character as an em-and-a-bit makes that column half again as
+ * wide as it needs to be while "Moving averages" stays too narrow. Two weights
+ * is not typography, but it is enough to tell those two apart.
+ */
+function textWidth(text) {
+    let width = 0;
+    for (const character of text) {
+        width += NARROW.has(character) ? BASE_SIZE * NARROW_EM : BASE_SIZE * WIDE_EM;
+    }
+    return width;
+}
+/** The characters that take noticeably less than an average advance. */
+const NARROW = new Set([...' .,:;!|ijlt1IJfr()[]{}-']);
+/**
+ * The type size the widths are counted at.
+ *
+ * The chart's own default row is 18 media pixels and it draws at 62% of the
+ * row, so this is the size a cell gets before anything shrinks it. Counting at
+ * a larger size would reserve room the text never uses.
+ */
+const BASE_SIZE = 11;
+const NARROW_EM = 0.32;
+const WIDE_EM = 0.56;
+/** What the chart insets a cell's text by, on each side. */
+const CELL_PADDING = 4;
+/**
+ * The narrowest a column is drawn.
+ *
+ * A column of one-character cells sized to its content is a sliver, and a grid
+ * of slivers reads as a rendering fault rather than as a narrow column.
+ */
+const MIN_COLUMN = 56;
+/**
+ * The widest a column is drawn.
+ *
+ * A cell holding a sentence would otherwise push the grid past the pane it is
+ * pinned inside, taking the chart with it. Past this the type shrinks instead,
+ * which is the chart's job and it is better at it.
+ */
+const MAX_COLUMN = 220;
+/**
+ * One written cell, or none.
+ *
+ * A cell whose text is absent is dropped rather than drawn, which leaves the
+ * blank cell that was already in its place: absence reaching a drawing surface
+ * is a gap, and a blank cell is what a grid draws where nothing was written
+ * (`language.md` 6.7).
+ *
+ * The grid's own text colour is written into each cell that named none, because
+ * the chart carries a text colour per cell and the language declares one for the
+ * whole grid as well.
+ */
+function oneCell(cell, fallback) {
+    if (typeof cell.text !== 'string')
+        return undefined;
+    const align = typeof cell.align === 'string' && ALIGNMENTS.includes(cell.align)
+        ? cell.align
+        : 'left';
+    const textColour = cssOf(cell.textColor) ?? fallback;
+    const bgColour = cssOf(cell.bgColor);
+    return {
+        text: cell.text,
+        ...(textColour === undefined ? {} : { textColor: textColour }),
+        ...(bgColour === undefined ? {} : { bgColor: bgColour }),
+        align,
+    };
+}
+/** A declared size, as a count of rows or columns a grid can be built with. */
+function whole(size) {
+    return size > 0 ? Math.floor(size) : 0;
+}
+//# sourceMappingURL=tables.js.map

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

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

package/dist/adapters/codemirror/commands.d.ts

@@ -0,0 +1,14 @@
+import type { EditorView } from './contract.js';
+/**
+ * Lays the document out again, and says whether anything changed.
+ *
+ * ```ts
+ * keymap.of([{ key: "Shift-Alt-f", run: formatDocument }])
+ * ```
+ *
+ * False where the document is already laid out, which is what an editor command
+ * returns when it has nothing to do: the key press then falls through to
+ * whatever else is bound to it rather than being swallowed.
+ */
+export declare function formatDocument(view: EditorView): boolean;
+//# sourceMappingURL=commands.d.ts.map

package/dist/adapters/codemirror/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/adapters/codemirror/commands.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAaxD"}

package/dist/adapters/codemirror/commands.js

@@ -0,0 +1,52 @@
+/**
+ * Laying a script out again, as an editor command.
+ *
+ * `format` is the tier's, and the guarantee it carries is the one that makes a
+ * format button safe to put in front of somebody holding a position: laying a
+ * script out again cannot change what it computes. Every example and every gate
+ * script in the repository is formatted, both texts compiled, and the compiled
+ * programs compared field for field; and every call checks itself against the
+ * lexer, so a rule that is wrong returns the source untouched rather than a
+ * changed program.
+ *
+ * The whole document is replaced rather than a minimal edit computed. It is the
+ * honest version: a diff would have to be trusted to be equivalent to the
+ * replacement, and a formatter that moved a line somewhere unintended would do
+ * it silently. The cursor is kept where it was in the new text, clamped, because
+ * a format that sends the caret to the top of the file is a format nobody
+ * presses twice.
+ *
+ * **A document with two character line endings comes back with one character
+ * ones**, because that is what `language.md` 3.1 normalises a file to before
+ * anything reads it and what every offset in this tier indexes. It is the one
+ * change to a file's bytes that formatting makes without being asked, and it is
+ * recorded in `spec/editor-narrowings.json`.
+ */
+import { format } from '../../editor/index.js';
+import { documentOf, normalisedOffset } from './positions.js';
+/**
+ * Lays the document out again, and says whether anything changed.
+ *
+ * ```ts
+ * keymap.of([{ key: "Shift-Alt-f", run: formatDocument }])
+ * ```
+ *
+ * False where the document is already laid out, which is what an editor command
+ * returns when it has nothing to do: the key press then falls through to
+ * whatever else is bound to it rather than being swallowed.
+ */
+export function formatDocument(view) {
+    const raw = view.state.doc.toString();
+    const held = documentOf(raw);
+    const laid = format(held.text);
+    if (laid === raw)
+        return false;
+    const at = normalisedOffset(held, view.state.selection.main.head);
+    view.dispatch({
+        changes: { from: 0, to: view.state.doc.length, insert: laid },
+        selection: { anchor: Math.min(at, laid.length) },
+        scrollIntoView: true,
+    });
+    return true;
+}
+//# sourceMappingURL=commands.js.map

package/dist/adapters/codemirror/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/adapters/codemirror/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,IAAgB;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IAE/B,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,CAAC,QAAQ,CAAC;QACZ,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;QAC7D,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE;QAChD,cAAc,EAAE,IAAI;KACrB,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/adapters/codemirror/completion.d.ts

@@ -0,0 +1,15 @@
+import type { EditorCompletionContext, EditorCompletionResult } from './contract.js';
+/**
+ * Every completion for the position the editor is asking about.
+ *
+ * ```ts
+ * autocompletion({ override: [openscriptCompletion] })
+ * ```
+ *
+ * Nothing comes back for an empty list rather than an empty list, because the
+ * editor reads the two differently: an empty result closes the panel and null
+ * lets another source answer, and a host with a snippet source of its own should
+ * keep it.
+ */
+export declare function openscriptCompletion(context: EditorCompletionContext): EditorCompletionResult | null;
+//# sourceMappingURL=completion.d.ts.map

package/dist/adapters/codemirror/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../../src/adapters/codemirror/completion.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAEV,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AAmBvB;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,uBAAuB,GAC/B,sBAAsB,GAAG,IAAI,CAc/B"}

package/dist/adapters/codemirror/completion.js

@@ -0,0 +1,64 @@
+/**
+ * Completions, as the editor's completion source.
+ *
+ * The whole of the work is done by `complete`, which reads the standard library
+ * manifest, the checker's bindings and the error catalogue. What is here is the
+ * translation: the editor wants a range to replace, a list of rows, and a note
+ * about whether the list is already filtered.
+ *
+ * **The list is already filtered**, by the word the writer has typed, compared
+ * exactly, because the language's names are case sensitive. So `filter` is false
+ * and the editor is told not to filter it again: its own matcher is fuzzy and
+ * case insensitive, and running it over a list that has already answered the
+ * question would put `EMA` in front of somebody as though it compiled.
+ *
+ * **A planned call is shown and marked.** `complete` carries the catalogue's own
+ * OS2020 sentence on a planned row, so that is what goes in the row's expanded
+ * note, and the row is pushed to the bottom of the list with the editor's own
+ * boost. A host that would rather not show them at all drops them with one
+ * field, which is why they are marked rather than filtered here.
+ */
+import { complete } from '../../editor/index.js';
+import { COMPLETION_TYPES } from './tokens.js';
+/** As far down the list as the editor will move a row. */
+const PLANNED_BOOST = -99;
+function rowOf(one) {
+    const info = one.refusal ?? one.summary;
+    const type = COMPLETION_TYPES[one.kind];
+    return {
+        label: one.label,
+        ...(type === undefined ? {} : { type }),
+        detail: one.detail,
+        ...(info === undefined ? {} : { info }),
+        ...(one.insert === one.label ? {} : { apply: one.insert }),
+        ...(one.planned ? { boost: PLANNED_BOOST } : {}),
+    };
+}
+/**
+ * Every completion for the position the editor is asking about.
+ *
+ * ```ts
+ * autocompletion({ override: [openscriptCompletion] })
+ * ```
+ *
+ * Nothing comes back for an empty list rather than an empty list, because the
+ * editor reads the two differently: an empty result closes the panel and null
+ * lets another source answer, and a host with a snippet source of its own should
+ * keep it.
+ */
+export function openscriptCompletion(context) {
+    const rows = complete(context.state.doc.toString(), context.pos);
+    // The first row carries the range every row replaces, so an empty list and a
+    // list whose first row is missing are one answer: nothing. Two guards for that
+    // would be one guard and a line no test can reach.
+    const first = rows[0];
+    if (first === undefined)
+        return null;
+    return {
+        from: first.replace.offset,
+        to: first.replace.offset + first.replace.length,
+        options: rows.map(rowOf),
+        filter: false,
+    };
+}
+//# sourceMappingURL=completion.js.map

package/dist/adapters/codemirror/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../../src/adapters/codemirror/completion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAOjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,0DAA0D;AAC1D,MAAM,aAAa,GAAG,CAAC,EAAE,CAAC;AAE1B,SAAS,KAAK,CAAC,GAAe;IAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC;IACxC,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACvC,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACvC,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;QAC1D,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAgC;IAEhC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACjE,6EAA6E;IAC7E,+EAA+E;IAC/E,mDAAmD;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAErC,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;QAC1B,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM;QAC/C,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QACxB,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC"}