openalgo-script 0.5.0 → 0.6.0

package/dist/core/importer/importer.js

@@ -0,0 +1,220 @@
+/**
+ * The importer: a script in the source dialect in, OpenScript and findings out.
+ *
+ * The source dialect is the widely used chart scripting language whose scripts
+ * open with a version annotation comment, declare themselves with an
+ * `indicator` or `strategy` call and reach their built-ins through namespaces
+ * such as `ta` and `math`. Versions 5 and 6 are read.
+ *
+ * It is text to text and nothing else: no file is read, no global is touched
+ * and nothing is evaluated. What it cannot translate faithfully it does not
+ * approximate. A statement is translated whole, with the source dialect's
+ * meaning, or kept as a comment line per source line and reported; a
+ * translation whose meaning differs in a way the importer can state is written
+ * and reported with a warning. Every finding points into the imported text.
+ */
+import { diagnosticFor } from '../diagnostics/index.js';
+import { sourceFile } from '../source/index.js';
+import { Context } from './context.js';
+import { readItems } from './lexer.js';
+import { binding } from './names.js';
+import { declarationLine } from './orders.js';
+import { readScript } from './parser.js';
+import { findingsOf, settle } from './settle.js';
+import { translateStatement } from './statements.js';
+import { pathOf } from './syntax.js';
+const ANNOTATION = /^\s*@version\s*=\s*(\d+)\s*$/;
+/** The version annotation, if one comes before the first line of code. */
+function annotationOf(items) {
+    for (const item of items) {
+        if (item.kind === 'code')
+            return undefined;
+        if (item.kind !== 'remark')
+            continue;
+        const found = ANNOTATION.exec(item.remark.text);
+        if (found !== null)
+            return { remark: item.remark, version: found[1] ?? '' };
+    }
+    return undefined;
+}
+function declaresOf(stmt) {
+    switch (stmt.kind) {
+        case 'declare':
+        case 'function':
+            return [stmt.name];
+        case 'tuple':
+            return stmt.names;
+        case 'refused':
+            return stmt.declares;
+        default:
+            return [];
+    }
+}
+function nodeOf(stmt, declaration) {
+    return {
+        stmt,
+        lines: stmt.lines,
+        declares: declaresOf(stmt),
+        reads: [],
+        output: [],
+        refusal: undefined,
+        failed: undefined,
+        lost: undefined,
+        notes: [],
+        declaration,
+    };
+}
+function visit(body, each) {
+    for (const entry of body) {
+        if (entry.kind !== 'stmt')
+            continue;
+        const stmt = entry.stmt;
+        each(stmt);
+        if (stmt.kind === 'if') {
+            for (const branch of stmt.branches)
+                visit(branch.body, each);
+            if (stmt.otherwise !== undefined)
+                visit(stmt.otherwise, each);
+        }
+        else if (stmt.kind === 'for' || stmt.kind === 'while')
+            visit(stmt.body, each);
+        else if (stmt.kind === 'switch')
+            for (const arm of stmt.arms)
+                visit(arm.body, each);
+        else if (stmt.kind === 'function' && Array.isArray(stmt.body))
+            visit(stmt.body, each);
+    }
+}
+/** The side each literal entry id opens, read from the script's entry calls. */
+function entrySides(body) {
+    const sides = new Map();
+    visit(body, (stmt) => {
+        if (stmt.kind !== 'evaluate' || stmt.expr.kind !== 'call')
+            return;
+        if (pathOf(stmt.expr.callee) !== 'strategy.entry')
+            return;
+        const args = stmt.expr.args;
+        const id = args.find((arg) => arg.label === 'id') ?? args.find((arg, i) => arg.label === undefined && i === 0);
+        const side = args.find((arg) => arg.label === 'direction') ?? args.filter((arg) => arg.label === undefined)[1];
+        const direction = side === undefined ? undefined : pathOf(side.value);
+        if (id?.value.kind !== 'string')
+            return;
+        if (direction === 'strategy.long')
+            sides.set(id.value.value, 'long');
+        if (direction === 'strategy.short')
+            sides.set(id.value.value, 'short');
+    });
+    return sides;
+}
+function reassignments(body) {
+    const found = new Map();
+    visit(body, (stmt) => {
+        if (stmt.kind !== 'assign')
+            return;
+        const held = found.get(stmt.name.name) ?? [];
+        held.push({ op: stmt.op, value: stmt.value });
+        found.set(stmt.name.name, held);
+    });
+    return found;
+}
+function refusal(diagnostic) {
+    return { source: '', findings: [diagnostic] };
+}
+/** Zero width, where the first statement starts: where a declaration was expected. */
+function firstStatement(file, body) {
+    const first = body.find((entry) => entry.kind === 'stmt');
+    return first?.kind === 'stmt' ? file.spanAt(first.stmt.at.offset, 0) : file.spanAt(file.text.length, 0);
+}
+function declarationOf(body) {
+    for (const entry of body) {
+        if (entry.kind !== 'stmt' || entry.stmt.kind !== 'evaluate' || entry.stmt.expr.kind !== 'call')
+            continue;
+        const path = pathOf(entry.stmt.expr.callee);
+        if (path === 'indicator' || path === 'strategy' || path === 'library') {
+            return { stmt: entry.stmt, call: entry.stmt.expr, path };
+        }
+    }
+    return undefined;
+}
+export function importScript(text, options = {}) {
+    const file = sourceFile(options.name ?? 'imported', text);
+    const items = readItems(file);
+    const annotation = annotationOf(items);
+    if (annotation === undefined || (annotation.version !== '5' && annotation.version !== '6')) {
+        const at = annotation === undefined ? file.spanAt(0, 0) : file.spanAt(annotation.remark.offset, annotation.remark.text.length + 2);
+        const found = annotation === undefined ? 'declares no version' : `declares version ${annotation.version}`;
+        return refusal(diagnosticFor('OS9001', at, { found }));
+    }
+    const body = readScript(items);
+    const declaration = declarationOf(body);
+    if (declaration === undefined)
+        return refusal(diagnosticFor('OS9004', firstStatement(file, body), { found: 'has none' }));
+    if (declaration.path === 'library') {
+        return refusal(diagnosticFor('OS9004', file.spanAt(declaration.call.callee.at.offset, declaration.call.callee.at.length), { found: 'declares a library' }));
+    }
+    const used = new Set();
+    for (const item of items) {
+        if (item.kind !== 'code')
+            continue;
+        for (const token of item.logical.tokens)
+            if (token.kind === 'name')
+                used.add(token.text);
+    }
+    const version = annotation.version === '5' ? 5 : 6;
+    const globals = new Set();
+    for (const entry of body)
+        if (entry.kind === 'stmt')
+            for (const one of declaresOf(entry.stmt))
+                globals.add(one.name);
+    const ctx = new Context({ file, version, used, globals, reassigned: reassignments(body), entries: entrySides(body) });
+    const declared = nodeOf(declaration.stmt, true);
+    ctx.node = declared;
+    const trailing = declaration.stmt.remarks.map((one) => `  //${one.text}`).join('');
+    declared.output = [{ depth: 0, text: `${declarationLine(ctx, declaration.call, declaration.path)}${trailing}` }];
+    ctx.node = undefined;
+    const nodes = [declared];
+    const pieces = [];
+    const later = [];
+    let stage = 'before';
+    for (const entry of body) {
+        if (entry.kind === 'remark' && entry.remark === annotation.remark) {
+            pieces.push({ kind: 'text', text: 'version 1' }, { kind: 'blank' });
+            stage = 'header';
+            continue;
+        }
+        if (entry.kind === 'stmt' && entry.stmt === declaration.stmt) {
+            pieces.push({ kind: 'node', node: declared }, ...later);
+            later.length = 0;
+            stage = 'body';
+            continue;
+        }
+        const piece = entry.kind === 'remark'
+            ? { kind: 'remark', remark: entry.remark, depth: 0 }
+            : entry.kind === 'blank'
+                ? { kind: 'blank' }
+                : undefined;
+        if (piece !== undefined) {
+            pieces.push(piece);
+            continue;
+        }
+        if (entry.kind !== 'stmt')
+            continue;
+        const node = nodeOf(entry.stmt, false);
+        ctx.node = node;
+        node.output = translateStatement(ctx, entry.stmt, 0);
+        for (const one of node.declares) {
+            if (!ctx.fileScope.names.has(one.name)) {
+                ctx.fileScope.names.set(one.name, binding(ctx.namer.declare(one.name, false), 'variable', true));
+            }
+        }
+        ctx.node = undefined;
+        nodes.push(node);
+        if (stage === 'body')
+            pieces.push({ kind: 'node', node });
+        else
+            later.push({ kind: 'node', node });
+    }
+    const source = settle(ctx, nodes, pieces);
+    return { source, findings: findingsOf(nodes) };
+}
+//# sourceMappingURL=importer.js.map

package/dist/core/importer/importer.js.map

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

package/dist/core/importer/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The importer: a script written in another chart language, as OpenScript.
+ *
+ * `importScript` reads a script in the version-annotated chart dialect, the one
+ * whose scripts open with a `//@version=` comment and reach their built-ins
+ * through namespaces, and returns the OpenScript text and a finding for every
+ * statement it kept as a comment and every translation whose meaning differs in
+ * a stated way. It is pure: text in, text and findings out, and nothing read,
+ * written or evaluated on the way.
+ *
+ * `MAPPINGS` and `COLOURS` are the table of what translates to what. They are
+ * behind this door for the documentation page's comparison test and for a tool
+ * that wants to show a reader the same table; the package surface is
+ * `importScript` and its two types.
+ */
+export { importScript } from './importer.js';
+export type { ImportOptions, ImportResult } from './importer.js';
+export { COLOURS, MAPPINGS } from './table.js';
+export type { Difference, Mapping } from './table.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/importer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/importer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/importer/index.js

@@ -0,0 +1,18 @@
+/**
+ * The importer: a script written in another chart language, as OpenScript.
+ *
+ * `importScript` reads a script in the version-annotated chart dialect, the one
+ * whose scripts open with a `//@version=` comment and reach their built-ins
+ * through namespaces, and returns the OpenScript text and a finding for every
+ * statement it kept as a comment and every translation whose meaning differs in
+ * a stated way. It is pure: text in, text and findings out, and nothing read,
+ * written or evaluated on the way.
+ *
+ * `MAPPINGS` and `COLOURS` are the table of what translates to what. They are
+ * behind this door for the documentation page's comparison test and for a tool
+ * that wants to show a reader the same table; the package surface is
+ * `importScript` and its two types.
+ */
+export { importScript } from './importer.js';
+export { COLOURS, MAPPINGS } from './table.js';
+//# sourceMappingURL=index.js.map

package/dist/core/importer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/importer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/importer/lexer.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Reading a script in the source dialect into logical lines of tokens.
+ *
+ * The source dialect is line oriented and indentation delimited, like
+ * OpenScript, and it differs in the two places a reader has to know about. A
+ * statement continues onto the next line when a bracket is still open, when
+ * the line ends on an operator that cannot end one, or when the next line is
+ * indented by an amount that is not a whole number of blocks: the dialect's
+ * blocks are four columns deep, and a continuation is told apart from a block
+ * by being indented off that grid. A tab in leading whitespace counts as one
+ * block.
+ *
+ * This reader is deliberately separate from OpenScript's lexer. The two
+ * languages share a shape and differ in almost every token rule that matters to
+ * a diagnostic: the source dialect has `:=`, `=>` and single quoted strings as
+ * ordinary tokens and no `none`, and running its text through OpenScript's
+ * lexer would report every one of those as a mistake in a file nobody wrote in
+ * OpenScript.
+ *
+ * Nothing here refuses anything. A character the dialect does not have becomes
+ * a `bad` token, and the parser decides what the statement holding it is.
+ */
+import type { SourceFile } from '../source/index.js';
+export type TokenKind = 'name' | 'number' | 'string' | 'color' | 'op' | 'bad';
+export interface Token {
+    readonly kind: TokenKind;
+    /** The characters as written. */
+    readonly text: string;
+    /** A string literal's decoded value; for every other kind, the text. */
+    readonly value: string;
+    readonly offset: number;
+    readonly length: number;
+}
+/** A `//` comment, with the text after the two slashes. */
+export interface Remark {
+    readonly text: string;
+    readonly offset: number;
+    readonly line: number;
+}
+/** One statement's worth of tokens, which may have spanned several lines. */
+export interface Logical {
+    /** Leading columns of the first line, a tab counted as one block. */
+    readonly indent: number;
+    readonly tokens: readonly Token[];
+    /** Comments written after code on any of the statement's lines. */
+    readonly remarks: readonly Remark[];
+    readonly firstLine: number;
+    readonly lastLine: number;
+}
+export type Item = {
+    readonly kind: 'code';
+    readonly logical: Logical;
+} | {
+    readonly kind: 'remark';
+    readonly remark: Remark;
+    readonly indent: number;
+} | {
+    readonly kind: 'blank';
+    readonly line: number;
+};
+/**
+ * The whole file as items: statements, comment lines and blank lines, in order.
+ *
+ * A comment line or a blank line inside an open statement belongs to that
+ * statement and ends nothing, the same rule OpenScript gives them.
+ */
+export declare function readItems(file: SourceFile): readonly Item[];
+//# sourceMappingURL=lexer.d.ts.map

package/dist/core/importer/lexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexer.d.ts","sourceRoot":"","sources":["../../../src/core/importer/lexer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,KAAK,CAAC;AAE9E,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,2DAA2D;AAC3D,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,6EAA6E;AAC7E,MAAM,WAAW,OAAO;IACtB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,IAAI,GACZ;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAuKtD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,IAAI,EAAE,CAsD3D"}

package/dist/core/importer/lexer.js

@@ -0,0 +1,207 @@
+/** The width of one block in the dialect, which a continuation is indented off. */
+const BLOCK = 4;
+const TWO_CHARACTER = [':=', '==', '!=', '<=', '>=', '=>', '+=', '-=', '*=', '/=', '%='];
+const ONE_CHARACTER = '+-*/%<>=?:,.()[]';
+/** Tokens after which a statement cannot end, so the next indented line continues it. */
+const CONTINUES = new Set([
+    ',', '+', '-', '*', '/', '%', '==', '!=', '<', '<=', '>', '>=', '?', ':', ':=', '=',
+    '+=', '-=', '*=', '/=', '%=', 'and', 'or', 'not', '(', '[',
+]);
+const NAME_START = /[A-Za-z_]/;
+const NAME_PART = /[A-Za-z0-9_]/;
+const DIGIT = /[0-9]/;
+const HEX = /[0-9A-Fa-f]/;
+const ESCAPES = { n: '\n', t: '\t', r: '\r', '\\': '\\', "'": "'", '"': '"' };
+/** Columns of leading whitespace, and where the text after it starts. */
+function measure(text) {
+    let indent = 0;
+    let start = 0;
+    while (start < text.length) {
+        const c = text[start];
+        if (c === ' ')
+            indent += 1;
+        else if (c === '\t')
+            indent += BLOCK - (indent % BLOCK);
+        else
+            break;
+        start += 1;
+    }
+    return { indent, start };
+}
+function readString(text, at) {
+    const quote = text[at];
+    let value = '';
+    let i = at + 1;
+    while (i < text.length) {
+        const c = text[i] ?? '';
+        if (c === quote)
+            return { end: i + 1, value, closed: true };
+        if (c === '\\' && i + 1 < text.length) {
+            const next = text[i + 1] ?? '';
+            value += ESCAPES[next] ?? next;
+            i += 2;
+            continue;
+        }
+        value += c;
+        i += 1;
+    }
+    return { end: text.length, value, closed: false };
+}
+function readNumber(text, at) {
+    let i = at;
+    while (i < text.length && DIGIT.test(text[i] ?? ''))
+        i += 1;
+    if (text[i] === '.' && !NAME_START.test(text[i + 1] ?? '')) {
+        i += 1;
+        while (i < text.length && DIGIT.test(text[i] ?? ''))
+            i += 1;
+    }
+    if ((text[i] === 'e' || text[i] === 'E') && /[0-9+-]/.test(text[i + 1] ?? '')) {
+        let j = i + 1;
+        if (text[j] === '+' || text[j] === '-')
+            j += 1;
+        if (DIGIT.test(text[j] ?? '')) {
+            i = j;
+            while (i < text.length && DIGIT.test(text[i] ?? ''))
+                i += 1;
+        }
+    }
+    return i;
+}
+/** Every token on one physical line, and the comment that ends it if any. */
+function tokensOf(text, start, lineStart, line) {
+    const tokens = [];
+    const token = (kind, from, to, value) => {
+        const written = text.slice(from, to);
+        tokens.push({ kind, text: written, value: value ?? written, offset: lineStart + from, length: to - from });
+    };
+    let i = start;
+    while (i < text.length) {
+        const c = text[i] ?? '';
+        if (c === ' ' || c === '\t') {
+            i += 1;
+            continue;
+        }
+        if (c === '/' && text[i + 1] === '/') {
+            return { tokens, remark: { text: text.slice(i + 2).trimEnd(), offset: lineStart + i, line } };
+        }
+        if (NAME_START.test(c)) {
+            let j = i + 1;
+            while (j < text.length && NAME_PART.test(text[j] ?? ''))
+                j += 1;
+            token('name', i, j);
+            i = j;
+            continue;
+        }
+        if (DIGIT.test(c) || (c === '.' && DIGIT.test(text[i + 1] ?? ''))) {
+            const j = readNumber(text, i);
+            token('number', i, j);
+            i = j;
+            continue;
+        }
+        if (c === '"' || c === "'") {
+            const read = readString(text, i);
+            token(read.closed ? 'string' : 'bad', i, read.end, read.value);
+            i = read.end;
+            continue;
+        }
+        if (c === '#') {
+            let j = i + 1;
+            while (j < text.length && HEX.test(text[j] ?? ''))
+                j += 1;
+            token(j - i === 7 || j - i === 9 ? 'color' : 'bad', i, j);
+            i = j;
+            continue;
+        }
+        const pair = text.slice(i, i + 2);
+        if (TWO_CHARACTER.includes(pair)) {
+            token('op', i, i + 2);
+            i += 2;
+            continue;
+        }
+        token(ONE_CHARACTER.includes(c) ? 'op' : 'bad', i, i + 1);
+        i += 1;
+    }
+    return { tokens, remark: undefined };
+}
+/** How far a line's brackets leave the statement open. */
+function depthAfter(depth, tokens) {
+    let open = depth;
+    for (const one of tokens) {
+        if (one.kind !== 'op')
+            continue;
+        if (one.text === '(' || one.text === '[')
+            open += 1;
+        else if (one.text === ')' || one.text === ']')
+            open = Math.max(0, open - 1);
+    }
+    return open;
+}
+function continues(current, next) {
+    if (current.depth > 0)
+        return true;
+    if (next.indent <= current.indent)
+        return false;
+    if (next.indent % BLOCK !== 0)
+        return true;
+    const last = current.tokens[current.tokens.length - 1];
+    return last !== undefined && CONTINUES.has(last.text);
+}
+/**
+ * The whole file as items: statements, comment lines and blank lines, in order.
+ *
+ * A comment line or a blank line inside an open statement belongs to that
+ * statement and ends nothing, the same rule OpenScript gives them.
+ */
+export function readItems(file) {
+    const items = [];
+    let current;
+    const held = [];
+    const close = () => {
+        if (current === undefined)
+            return;
+        const { indent, tokens, remarks, firstLine, lastLine } = current;
+        items.push({ kind: 'code', logical: { indent, tokens, remarks, firstLine, lastLine } });
+        current = undefined;
+    };
+    for (let line = 1; line <= file.lineCount; line += 1) {
+        const text = file.lineText(line);
+        const { indent, start } = measure(text);
+        const read = tokensOf(text, start, file.lineStart(line), line);
+        const physical = { line, indent, tokens: read.tokens, remark: read.remark };
+        if (physical.tokens.length === 0) {
+            if (current !== undefined && current.depth > 0) {
+                if (physical.remark !== undefined)
+                    current.remarks.push(physical.remark);
+                continue;
+            }
+            held.push(physical.remark === undefined
+                ? { kind: 'blank', line }
+                : { kind: 'remark', remark: physical.remark, indent });
+            continue;
+        }
+        if (current !== undefined && continues(current, physical)) {
+            current.tokens.push(...physical.tokens);
+            if (physical.remark !== undefined)
+                current.remarks.push(physical.remark);
+            current.lastLine = line;
+            current.depth = depthAfter(current.depth, physical.tokens);
+            continue;
+        }
+        close();
+        items.push(...held);
+        held.length = 0;
+        current = {
+            indent,
+            tokens: [...physical.tokens],
+            remarks: physical.remark === undefined ? [] : [physical.remark],
+            firstLine: line,
+            lastLine: line,
+            depth: depthAfter(0, physical.tokens),
+        };
+    }
+    close();
+    items.push(...held);
+    return items;
+}
+//# sourceMappingURL=lexer.js.map

package/dist/core/importer/lexer.js.map

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

package/dist/core/importer/names.d.ts

@@ -0,0 +1,41 @@
+export type BindingKind = 'variable' | 'function' | 'parameter' | 'loop';
+export interface Binding {
+    readonly output: string;
+    readonly kind: BindingKind;
+    readonly topLevel: boolean;
+    /** Bound to a declaration handle, which only `fill` may take. */
+    handle: 'plot' | 'level' | undefined;
+    /** Never absent on any bar: bound to an input or a literal and never reassigned. */
+    present: boolean;
+    /** A whole-number constant in the source dialect's sense, which version 5 divides without a fraction. */
+    whole: boolean;
+    /** A function's parameters, source spelling to output spelling, for its named arguments. */
+    labels: ReadonlyMap<string, string> | undefined;
+}
+export declare class Scope {
+    readonly names: Map<string, Binding>;
+    readonly parent: Scope | undefined;
+    constructor(parent: Scope | undefined);
+    find(name: string): Binding | undefined;
+    get isGlobal(): boolean;
+}
+export declare class Namer {
+    #private;
+    /** `used` is every identifier the source writes, anywhere. */
+    constructor(used: Iterable<string>);
+    /** Whether OpenScript already means something by this name. */
+    static reserved(name: string): boolean;
+    /** A spelling no source name and no OpenScript name has, starting from `base`. */
+    fresh(base: string): string;
+    /**
+     * The spelling of a source name declared in `scope`.
+     *
+     * `hides` says whether an enclosing scope can already see the name, which is
+     * the case the source dialect reads as a new name and OpenScript would read
+     * as an update of the old one.
+     */
+    declare(name: string, hides: boolean): string;
+}
+/** A binding with the defaults a plain declaration has. */
+export declare function binding(output: string, kind: BindingKind, topLevel: boolean): Binding;
+//# sourceMappingURL=names.d.ts.map

package/dist/core/importer/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../src/core/importer/names.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,CAAC;AAEzE,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,iEAAiE;IACjE,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACrC,oFAAoF;IACpF,OAAO,EAAE,OAAO,CAAC;IACjB,yGAAyG;IACzG,KAAK,EAAE,OAAO,CAAC;IACf,4FAA4F;IAC5F,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CACjD;AAKD,qBAAa,KAAK;IAChB,QAAQ,CAAC,KAAK,uBAA8B;IAC5C,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,SAAS,CAAC;gBAEvB,MAAM,EAAE,KAAK,GAAG,SAAS;IAIrC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIvC,IAAI,QAAQ,IAAI,OAAO,CAEtB;CACF;AAED,qBAAa,KAAK;;IAGhB,8DAA8D;gBAClD,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC;IAIlC,+DAA+D;IAC/D,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAStC,kFAAkF;IAClF,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAS3B;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM;CAK9C;AAED,2DAA2D;AAC3D,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAErF"}