import type { Pos } from "./diagnostics"; import type { Scalar } from "./types"; export type BinaryOperator = | "??" | "||" | "&&" | "==" | "!=" | "===" | "!==" | "<" | "<=" | ">" | ">=" | "+" | "-" | "*" | "/" | "%" | "**" | "in"; export interface NamedArg { readonly name: string; readonly value: Expr; readonly pos: Pos; } export type Expr = | { readonly type: "literal"; readonly value: Scalar; readonly pos: Pos } /** `quasis.length === parts.length + 1`. */ | { readonly type: "template"; readonly quasis: readonly string[]; readonly parts: readonly Expr[]; readonly pos: Pos } /** `$name`; `name` excludes the `$`. */ | { readonly type: "state"; readonly name: string; readonly pos: Pos } /** A named value or an arrow parameter. */ | { readonly type: "ident"; readonly name: string; readonly pos: Pos } | { readonly type: "list"; readonly items: readonly Expr[]; readonly pos: Pos } | { readonly type: "object"; /** An expression key is computed, as in `{[k]: 1}`; a null key spreads `value`, as in `{...o}`. */ readonly entries: readonly { readonly key: string | Expr | null; readonly value: Expr; readonly pos: Pos }[]; readonly pos: Pos; } /** `...value`; the parser makes it only as a list item or an argument. */ | { readonly type: "spread"; readonly value: Expr; readonly pos: Pos } | { readonly type: "unary"; readonly op: "!" | "-" | "typeof"; readonly operand: Expr; readonly pos: Pos } | { readonly type: "binary"; readonly op: BinaryOperator; readonly left: Expr; readonly right: Expr; readonly pos: Pos } | { readonly type: "conditional"; readonly test: Expr; readonly then: Expr; readonly else: Expr; readonly pos: Pos } /** `object.name`; `pos` is the property name. */ | { readonly type: "member"; readonly object: Expr; readonly name: string; readonly pos: Pos } | { readonly type: "index"; readonly object: Expr; readonly index: Expr; readonly pos: Pos } /** `name(...)`: a component, action or function; `pos` is the name (the node key). */ | { readonly type: "call"; readonly name: string; readonly args: readonly Expr[]; readonly named: readonly NamedArg[]; readonly pos: Pos; } /** `object.name(...)`; `pos` is the method name. `optional`: after a `?.`, so a null object gives null. */ | { readonly type: "method"; readonly object: Expr; readonly name: string; readonly args: readonly Expr[]; readonly named: readonly NamedArg[]; readonly optional: boolean; readonly pos: Pos; } | { readonly type: "arrow"; readonly params: readonly string[]; readonly body: Expr; readonly pos: Pos } /** `name` holds `value` while `body` runs; block bodies and destructuring parse into these. */ | { readonly type: "let"; readonly name: string; readonly value: Expr; readonly body: Expr; readonly pos: Pos }; export type CallExpr = Extract; export type ArrowExpr = Extract; export interface Decl { readonly name: string; readonly value: Expr; readonly pos: Pos; } export type Statement = | ({ readonly kind: "state" } & Decl) | ({ readonly kind: "named" } & Decl) | { readonly kind: "root"; readonly value: Expr }; /** A validated program. Only `compile` creates one. */ export interface Program { /** `$state` declarations in source order. */ readonly states: readonly Decl[]; readonly named: ReadonlyMap; /** Bare expressions in source order, or the named value `root`. */ readonly roots: readonly Expr[]; }