@altopelago/aeon-parser 0.9.0

package/README.md

@@ -0,0 +1,26 @@
+# @altopelago/aeon-parser
+
+AST construction for AEON source text.
+
+## Installation
+
+```bash
+pnpm add @altopelago/aeon-parser
+```
+
+## Usage
+
+```ts
+import { tokenize } from '@altopelago/aeon-lexer';
+import { parse } from '@altopelago/aeon-parser';
+
+const tokens = tokenize('answer = 42').tokens;
+const result = parse(tokens);
+
+if (result.errors.length === 0) {
+  console.log(result.root);
+}
+```
+
+Use this package when you need direct parser output for tooling or advanced analysis.
+If you want the stable application-facing entry point, prefer `@altopelago/aeon-core`.

package/dist/ast.d.ts

@@ -0,0 +1,260 @@
+import type { Span } from '@altopelago/aeon-lexer';
+import type { TrimtickMetadata } from './trimticks.js';
+/**
+ * Base node interface
+ */
+export interface ASTNode {
+    readonly span: Span;
+}
+/**
+ * AEON Document
+ */
+export interface Document extends ASTNode {
+    readonly type: 'Document';
+    readonly header: Header | null;
+    readonly bindings: readonly Binding[];
+    readonly envelope: Envelope | null;
+}
+/**
+ * Document header
+ */
+export interface Header extends ASTNode {
+    readonly type: 'Header';
+    readonly form: 'structured' | 'shorthand';
+    /** Whether a structured header (aeon:header = {...}) was present */
+    readonly hasStructured: boolean;
+    /** Whether any shorthand header fields (aeon:mode = ...) were present */
+    readonly hasShorthand: boolean;
+    /** Full header bindings preserved for canonicalization and structural tooling */
+    readonly bindings: readonly Binding[];
+    readonly fields: ReadonlyMap<string, Value>;
+}
+/**
+ * Binding (key = value)
+ */
+export interface Binding extends ASTNode {
+    readonly type: 'Binding';
+    readonly key: string;
+    readonly value: Value;
+    readonly datatype: TypeAnnotation | null;
+    readonly attributes: readonly Attribute[];
+}
+/**
+ * Type annotation
+ */
+export interface TypeAnnotation extends ASTNode {
+    readonly type: 'TypeAnnotation';
+    readonly name: string;
+    readonly genericArgs: readonly string[];
+    readonly radixBase?: number | null;
+    readonly separators: readonly string[];
+}
+/**
+ * Attribute (@{...})
+ */
+export interface Attribute extends ASTNode {
+    readonly type: 'Attribute';
+    readonly entries: ReadonlyMap<string, AttributeValue>;
+}
+/**
+ * Attribute value (may have its own type annotation)
+ */
+export interface AttributeValue {
+    readonly value: Value;
+    readonly datatype: TypeAnnotation | null;
+    readonly attributes: readonly Attribute[];
+}
+/**
+ * Envelope binding metadata
+ */
+export interface Envelope extends ASTNode {
+    readonly type: 'Envelope';
+    readonly fields: ReadonlyMap<string, Value>;
+}
+/**
+ * Value union type
+ */
+export type Value = TypedValue | StringLiteral | NumberLiteral | InfinityLiteral | NaNLiteral | NullLiteral | BooleanLiteral | ToggleLiteral | HexLiteral | RadixLiteral | EncodingLiteral | SeparatorLiteral | DateLiteral | DateTimeLiteral | TimeLiteral | ObjectNode | ListNode | TupleLiteral | NodeLiteral | CloneReference | PointerReference;
+/**
+ * Anonymous headed value (:type = value, @{...} = value, or @{...}:type = value),
+ * valid only inside value containers.
+ */
+export interface TypedValue extends ASTNode {
+    readonly type: 'TypedValue';
+    readonly datatype: TypeAnnotation | null;
+    readonly attributes: readonly Attribute[];
+    readonly value: Value;
+}
+/**
+ * String literal
+ */
+export interface StringLiteral extends ASTNode {
+    readonly type: 'StringLiteral';
+    readonly value: string;
+    readonly raw: string;
+    readonly delimiter: '"' | "'" | '`';
+    readonly trimticks?: TrimtickMetadata;
+}
+/**
+ * Number literal
+ */
+export interface NumberLiteral extends ASTNode {
+    readonly type: 'NumberLiteral';
+    readonly value: string;
+    readonly raw: string;
+}
+/**
+ * Infinity literal
+ */
+export interface InfinityLiteral extends ASTNode {
+    readonly type: 'InfinityLiteral';
+    readonly value: 'Infinity' | '-Infinity';
+    readonly raw: 'Infinity' | '-Infinity';
+}
+/**
+ * NaN literal
+ */
+export interface NaNLiteral extends ASTNode {
+    readonly type: 'NaNLiteral';
+    readonly value: 'NaN' | '-NaN';
+    readonly raw: 'NaN' | '-NaN';
+}
+/**
+ * Null literal
+ */
+export interface NullLiteral extends ASTNode {
+    readonly type: 'NullLiteral';
+    readonly mode: 'reserved' | 'reason';
+    readonly value: string;
+    readonly raw: string;
+}
+/**
+ * Boolean literal
+ */
+export interface BooleanLiteral extends ASTNode {
+    readonly type: 'BooleanLiteral';
+    readonly value: boolean;
+    readonly raw: string;
+}
+/**
+ * Toggle literal (yes/no/on/off)
+ */
+export interface ToggleLiteral extends ASTNode {
+    readonly type: 'ToggleLiteral';
+    readonly value: 'yes' | 'no' | 'on' | 'off';
+    readonly raw: string;
+}
+/**
+ * Hex literal (#FF00AA)
+ */
+export interface HexLiteral extends ASTNode {
+    readonly type: 'HexLiteral';
+    readonly value: string;
+    readonly raw: string;
+}
+/**
+ * Radix literal (%1011)
+ */
+export interface RadixLiteral extends ASTNode {
+    readonly type: 'RadixLiteral';
+    readonly value: string;
+    readonly raw: string;
+}
+/**
+ * Encoding literal ($Base64...)
+ */
+export interface EncodingLiteral extends ASTNode {
+    readonly type: 'EncodingLiteral';
+    readonly value: string;
+    readonly raw: string;
+}
+/**
+ * Separator literal (^content)
+ */
+export interface SeparatorLiteral extends ASTNode {
+    readonly type: 'SeparatorLiteral';
+    readonly value: string;
+    readonly raw: string;
+}
+/**
+ * Date literal
+ */
+export interface DateLiteral extends ASTNode {
+    readonly type: 'DateLiteral';
+    readonly value: string;
+    readonly raw: string;
+}
+/**
+ * DateTime literal (including ZRUT)
+ */
+export interface DateTimeLiteral extends ASTNode {
+    readonly type: 'DateTimeLiteral';
+    readonly value: string;
+    readonly raw: string;
+}
+/**
+ * Time literal
+ */
+export interface TimeLiteral extends ASTNode {
+    readonly type: 'TimeLiteral';
+    readonly value: string;
+    readonly raw: string;
+}
+/**
+ * Object node
+ */
+export interface ObjectNode extends ASTNode {
+    readonly type: 'ObjectNode';
+    readonly bindings: readonly Binding[];
+    readonly attributes: readonly Attribute[];
+}
+/**
+ * List node
+ */
+export interface ListNode extends ASTNode {
+    readonly type: 'ListNode';
+    readonly elements: readonly Value[];
+    readonly attributes: readonly Attribute[];
+}
+/**
+ * Tuple node
+ */
+export interface TupleLiteral extends ASTNode {
+    readonly type: 'TupleLiteral';
+    readonly elements: readonly Value[];
+    readonly attributes: readonly Attribute[];
+    readonly raw: string;
+}
+/**
+ * Node literal (<tag(...)>)
+ */
+export interface NodeLiteral extends ASTNode {
+    readonly type: 'NodeLiteral';
+    readonly tag: string;
+    readonly attributes: readonly Attribute[];
+    readonly datatype: TypeAnnotation | null;
+    readonly children: readonly Value[];
+}
+/**
+ * Clone reference (~path)
+ */
+export interface CloneReference extends ASTNode {
+    readonly type: 'CloneReference';
+    readonly path: readonly ReferencePathSegment[];
+}
+/**
+ * Pointer reference (~>path)
+ */
+export interface PointerReference extends ASTNode {
+    readonly type: 'PointerReference';
+    readonly path: readonly ReferencePathSegment[];
+}
+export interface ReferenceAttrSegment {
+    readonly type: 'attr';
+    readonly key: string;
+}
+/**
+ * Reference path segment (member, index, and attribute segments)
+ */
+export type ReferencePathSegment = string | number | ReferenceAttrSegment;
+//# sourceMappingURL=ast.d.ts.map

package/dist/ast.d.ts.map

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

package/dist/ast.js

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

package/dist/ast.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,70 @@
+import type { Span } from '@altopelago/aeon-lexer';
+/**
+ * Base class for parser errors
+ */
+export declare class ParserError extends Error {
+    readonly span: Span;
+    readonly code: string;
+    constructor(message: string, span: Span, code?: string);
+}
+/**
+ * Syntax error - unexpected token or missing expected token
+ */
+export declare class SyntaxError extends ParserError {
+    readonly expected: string | null;
+    readonly found: string;
+    constructor(message: string, span: Span, expected: string | null, found: string);
+}
+export declare class InvalidSeparatorCharError extends ParserError {
+    readonly value: string;
+    constructor(value: string, span: Span);
+}
+export declare class SeparatorDepthExceededError extends ParserError {
+    readonly observedDepth: number;
+    readonly limit: number;
+    constructor(observedDepth: number, limit: number, span: Span);
+}
+export declare class GenericDepthExceededError extends ParserError {
+    readonly observedDepth: number;
+    readonly limit: number;
+    constructor(observedDepth: number, limit: number, span: Span);
+}
+export declare class AttributeDepthExceededError extends ParserError {
+    readonly observedDepth: number;
+    readonly limit: number;
+    constructor(observedDepth: number, limit: number, span: Span);
+}
+export declare class NestingDepthExceededError extends ParserError {
+    readonly observedDepth: number;
+    readonly limit: number;
+    constructor(observedDepth: number, limit: number, span: Span);
+}
+/**
+ * Duplicate key error
+ */
+export declare class DuplicateKeyError extends ParserError {
+    readonly key: string;
+    readonly path?: string;
+    constructor(key: string, span: Span, path?: string);
+}
+/**
+ * Profile error - feature requires profile that is not enabled
+ */
+export declare class ProfileError extends ParserError {
+    readonly feature: string;
+    constructor(feature: string, span: Span);
+}
+/**
+ * Reference error - invalid reference
+ */
+export declare class ReferenceError extends ParserError {
+    readonly path: string;
+    constructor(message: string, path: string, span: Span);
+}
+/**
+ * Type error - type mismatch
+ */
+export declare class TypeError extends ParserError {
+    constructor(message: string, span: Span);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEnD;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAE,MAAuB;CAMzE;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM;CAMlF;AAED,qBAAa,yBAA0B,SAAQ,WAAW;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;CAKxC;AAED,qBAAa,2BAA4B,SAAQ,WAAW;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;CAU/D;AAED,qBAAa,yBAA0B,SAAQ,WAAW;IACtD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;CAU/D;AAED,qBAAa,2BAA4B,SAAQ,WAAW;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;CAU/D;AAED,qBAAa,yBAA0B,SAAQ,WAAW;IACtD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;CAU/D;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM;CAQrD;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;CAK1C;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;CAKxD;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,WAAW;gBAC1B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;CAI1C"}

package/dist/errors.js

@@ -0,0 +1,121 @@
+/**
+ * Base class for parser errors
+ */
+export class ParserError extends Error {
+    span;
+    code;
+    constructor(message, span, code = 'PARSER_ERROR') {
+        super(message);
+        this.name = 'ParserError';
+        this.span = span;
+        this.code = code;
+    }
+}
+/**
+ * Syntax error - unexpected token or missing expected token
+ */
+export class SyntaxError extends ParserError {
+    expected;
+    found;
+    constructor(message, span, expected, found) {
+        super(message, span, 'SYNTAX_ERROR');
+        this.name = 'SyntaxError';
+        this.expected = expected;
+        this.found = found;
+    }
+}
+export class InvalidSeparatorCharError extends ParserError {
+    value;
+    constructor(value, span) {
+        super(`Invalid separator character '${value}'`, span, 'INVALID_SEPARATOR_CHAR');
+        this.name = 'InvalidSeparatorCharError';
+        this.value = value;
+    }
+}
+export class SeparatorDepthExceededError extends ParserError {
+    observedDepth;
+    limit;
+    constructor(observedDepth, limit, span) {
+        super(`Separator depth ${observedDepth} exceeds max_separator_depth ${limit}`, span, 'SEPARATOR_DEPTH_EXCEEDED');
+        this.name = 'SeparatorDepthExceededError';
+        this.observedDepth = observedDepth;
+        this.limit = limit;
+    }
+}
+export class GenericDepthExceededError extends ParserError {
+    observedDepth;
+    limit;
+    constructor(observedDepth, limit, span) {
+        super(`Generic depth ${observedDepth} exceeds max_generic_depth ${limit}`, span, 'GENERIC_DEPTH_EXCEEDED');
+        this.name = 'GenericDepthExceededError';
+        this.observedDepth = observedDepth;
+        this.limit = limit;
+    }
+}
+export class AttributeDepthExceededError extends ParserError {
+    observedDepth;
+    limit;
+    constructor(observedDepth, limit, span) {
+        super(`Attribute depth ${observedDepth} exceeds max_attribute_depth ${limit}`, span, 'ATTRIBUTE_DEPTH_EXCEEDED');
+        this.name = 'AttributeDepthExceededError';
+        this.observedDepth = observedDepth;
+        this.limit = limit;
+    }
+}
+export class NestingDepthExceededError extends ParserError {
+    observedDepth;
+    limit;
+    constructor(observedDepth, limit, span) {
+        super(`Value nesting depth ${observedDepth} exceeds max_nesting_depth ${limit}`, span, 'NESTING_DEPTH_EXCEEDED');
+        this.name = 'NestingDepthExceededError';
+        this.observedDepth = observedDepth;
+        this.limit = limit;
+    }
+}
+/**
+ * Duplicate key error
+ */
+export class DuplicateKeyError extends ParserError {
+    key;
+    path;
+    constructor(key, span, path) {
+        super(`Duplicate key: '${key}'`, span, 'DUPLICATE_KEY');
+        this.name = 'DuplicateKeyError';
+        this.key = key;
+        if (path !== undefined) {
+            this.path = path;
+        }
+    }
+}
+/**
+ * Profile error - feature requires profile that is not enabled
+ */
+export class ProfileError extends ParserError {
+    feature;
+    constructor(feature, span) {
+        super(`Feature '${feature}' requires a profile that is not enabled`, span, 'PROFILE_ERROR');
+        this.name = 'ProfileError';
+        this.feature = feature;
+    }
+}
+/**
+ * Reference error - invalid reference
+ */
+export class ReferenceError extends ParserError {
+    path;
+    constructor(message, path, span) {
+        super(message, span, 'REFERENCE_ERROR');
+        this.name = 'ReferenceError';
+        this.path = path;
+    }
+}
+/**
+ * Type error - type mismatch
+ */
+export class TypeError extends ParserError {
+    constructor(message, span) {
+        super(message, span, 'TYPE_ERROR');
+        this.name = 'TypeError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @altopelago/aeon-parser - AEON Parser Package
+ *
+ * Parses AEON tokens into an Abstract Syntax Tree.
+ */
+export * from './ast.js';
+export * from './parser.js';
+export * from './errors.js';
+export * from './trimticks.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @altopelago/aeon-parser - AEON Parser Package
+ *
+ * Parses AEON tokens into an Abstract Syntax Tree.
+ */
+export * from './ast.js';
+export * from './parser.js';
+export * from './errors.js';
+export * from './trimticks.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,28 @@
+import { type Token } from '@altopelago/aeon-lexer';
+import type { Document } from './ast.js';
+import { ParserError } from './errors.js';
+/**
+ * Parser options
+ */
+export interface ParserOptions {
+    /** Maximum nesting depth for attribute heads (default: 1) */
+    readonly maxAttributeDepth?: number;
+    /** Maximum number of separator segments in datatype annotation (default: 1) */
+    readonly maxSeparatorDepth?: number;
+    /** Maximum nesting depth for nested generic type annotations (default: 1) */
+    readonly maxGenericDepth?: number;
+    /** Maximum nesting depth for value structures like lists and objects (default: 256) */
+    readonly maxNestingDepth?: number;
+}
+/**
+ * Parse result
+ */
+export interface ParseResult {
+    readonly document: Document | null;
+    readonly errors: readonly ParserError[];
+}
+/**
+ * Parse AEON tokens into an AST
+ */
+export declare function parse(tokens: readonly Token[], options?: ParserOptions): ParseResult;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAoC,MAAM,wBAAwB,CAAC;AACtF,OAAO,KAAK,EACR,QAAQ,EA0BX,MAAM,UAAU,CAAC;AAClB,OAAO,EACH,WAAW,EAQd,MAAM,aAAa,CAAC;AAGrB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,+EAA+E;IAC/E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,uFAAuF;IACvF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;CAC3C;AAsqDD;;GAEG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,WAAW,CAGpF"}