@tinta-lang/syntax 0.0.0-stage → 0.1.0-dev.0

package/dist/directive.d.ts

@@ -0,0 +1,40 @@
+import type { Column, Expr, Scalar, Span } from "@tinta-lang/types";
+import { registry } from "./registry.js";
+import { Source } from "./source.js";
+export type DirectiveName = (typeof registry.directives)[number];
+export interface DataRowSyntax {
+    readonly cells: readonly Scalar[];
+    readonly cellSpans: readonly Span[];
+    readonly span: Span;
+}
+export interface DirectiveSyntax {
+    readonly name: DirectiveName | "end";
+    readonly binding?: string;
+    readonly bindingSpan?: Span;
+    readonly sourceSpan?: Span;
+    readonly optionSpans?: Readonly<Record<string, Span>>;
+    readonly columnNameSpans?: readonly Span[];
+    readonly source?: string;
+    readonly chartType?: (typeof registry.chartTypes)[number];
+    readonly expression?: Expr;
+    readonly summary?: string;
+    readonly options: Readonly<Record<string, Expr>>;
+    readonly columns?: readonly Column[];
+    readonly columnSpans?: readonly Span[];
+    readonly rows?: readonly DataRowSyntax[];
+}
+export declare const optionKeys: {
+    readonly meta: readonly ["version", "title", "locale", "currency"];
+    readonly let: readonly [];
+    readonly calc: readonly [];
+    readonly slider: readonly ["min", "max", "step", "label"];
+    readonly toggle: readonly ["label"];
+    readonly choice: readonly ["options", "label"];
+    readonly when: readonly [];
+    readonly details: readonly [];
+    readonly data: readonly [];
+    readonly view: readonly ["where", "sort", "descending"];
+    readonly table: readonly ["title"];
+    readonly chart: readonly ["x", "y", "title", "xLabel", "yLabel", "select", "bins"];
+};
+export declare function parseDirective(source: Source, start: number, end: number): DirectiveSyntax;

package/dist/editing.d.ts

@@ -0,0 +1,46 @@
+import type { Span } from "@tinta-lang/types";
+import type { ParsedSource } from "./parser.js";
+import { type Lexeme } from "./expression.js";
+export interface EditingSite {
+    readonly replacement: Span;
+    readonly kind: "directive" | "option" | "literal" | "expression" | "selection" | "column" | "none";
+    readonly directive?: string;
+    readonly option?: string;
+    readonly table?: string;
+    readonly usedOptions?: readonly string[];
+    readonly quoted?: boolean;
+    readonly numericOnly?: boolean;
+    readonly listItem?: boolean;
+    readonly chartType?: string;
+    readonly xColumn?: string;
+    readonly call?: {
+        readonly name: string;
+        readonly argument: number;
+    };
+}
+export declare const editorNames: Readonly<{
+    directives: readonly ("slider" | "toggle" | "choice" | "let" | "calc" | "data" | "view" | "when" | "details" | "chart" | "table" | "meta")[];
+    functions: readonly ("if" | "min" | "max" | "round" | "pow" | "count" | "sum" | "mean" | "fixed" | "percent" | "money")[];
+    chartTypes: readonly ("line" | "area" | "bar" | "scatter" | "pie" | "donut" | "histogram")[];
+    locales: readonly ("en-US" | "en-GB" | "es-ES" | "fr-FR" | "de-DE" | "ja-JP" | "zh-CN" | "zh-TW")[];
+    currencies: readonly ("USD" | "EUR" | "GBP" | "JPY" | "CHF" | "CAD" | "AUD" | "CNY")[];
+    reserved: readonly ("if" | "min" | "max" | "round" | "pow" | "count" | "sum" | "mean" | "fixed" | "percent" | "money" | "not" | "and" | "or" | "true" | "false" | "row" | "__proto__" | "prototype" | "constructor")[];
+    options: Readonly<{
+        readonly meta: readonly ["version", "title", "locale", "currency"];
+        readonly let: readonly [];
+        readonly calc: readonly [];
+        readonly slider: readonly ["min", "max", "step", "label"];
+        readonly toggle: readonly ["label"];
+        readonly choice: readonly ["options", "label"];
+        readonly when: readonly [];
+        readonly details: readonly [];
+        readonly data: readonly [];
+        readonly view: readonly ["where", "sort", "descending"];
+        readonly table: readonly ["title"];
+        readonly chart: readonly ["x", "y", "title", "xLabel", "yLabel", "select", "bins"];
+    }>;
+}>;
+/** Exact lexical tokens inside an AST expression, including grouped names. */
+export declare function expressionLexemes(parsed: ParsedSource, span: Span): readonly Lexeme[];
+/** Context comes only from active Markdown extension regions and its lexer. */
+export declare function editingSite(parsed: ParsedSource, offset: number): EditingSite;

package/dist/enrichment.d.ts

@@ -0,0 +1,5 @@
+import type { Enrichment, Result, SourceInput } from "@tinta-lang/types";
+import { type SyntaxNode } from "./parser.js";
+/** Discard only source bookkeeping; retain all Markdown meaning and inert resource policy. */
+export declare function markdownMeaning(node: SyntaxNode): unknown;
+export declare function enrichMarkdown(input: SourceInput): Result<Enrichment>;

package/dist/expression.d.ts

@@ -0,0 +1,26 @@
+import type { Expr } from "@tinta-lang/types";
+import { Source } from "./source.js";
+export interface Lexeme {
+    readonly raw: string;
+    readonly start: number;
+    readonly end: number;
+}
+export declare const numberPattern: RegExp;
+export declare function identifier(source: Source, token: Lexeme): string;
+export declare function stringValue(source: Source, token: Lexeme, code?: string): string;
+export declare class ExpressionParser {
+    readonly source: Source;
+    readonly start: number;
+    readonly end: number;
+    readonly tokens: Lexeme[];
+    cursor: number;
+    constructor(source: Source, start: number, end: number);
+    peek(): Lexeme;
+    take(): Lexeme;
+    accept(raw: string): boolean;
+    expect(raw: string, code?: string): Lexeme;
+    finish(code?: string): void;
+    parse(min?: number, depth?: number): Expr;
+    private node;
+    private primary;
+}

package/dist/image-destinations.d.ts

@@ -0,0 +1,3 @@
+import type { SourceInput, Result, TextEdit } from "@tinta-lang/types";
+/** Original token spans, including reference definitions and angle destinations. */
+export declare function imageDestinationEdits(input: SourceInput, replacements: ReadonlyMap<string, string>): Result<readonly TextEdit[]>;

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { parse, parseRecovering } from "./parser.js";
+export type { EditingRegion, ParsedSource, SyntaxNode, EditorToken, SyntaxKind, } from "./parser.js";
+export type { DirectiveSyntax, DirectiveName, DataRowSyntax, } from "./directive.js";
+export { enrichMarkdown } from "./enrichment.js";
+export { decodeUtf8, encodeUtf8 } from "./source.js";
+export { imageDestinationEdits } from "./image-destinations.js";
+export { editingSite, expressionLexemes, editorNames } from "./editing.js";
+export type { EditingSite } from "./editing.js";