@altopelago/aeon-core 0.9.0

package/README.md

@@ -0,0 +1,133 @@
+# @altopelago/aeon-core
+
+The canonical, safe entry point for AEON processing.
+
+## Installation
+
+```bash
+pnpm add @altopelago/aeon-core
+```
+
+Implementation docs:
+
+- [`docs/implementations/typescript/api/core.md`](../../../../docs/implementations/typescript/api/core.md)
+
+## Quick Start
+
+```ts
+import { compile } from '@altopelago/aeon-core';
+
+const input = `
+config = {
+  host = "localhost"
+  port:int32 = 8080
+}
+`;
+
+const result = compile(input);
+
+if (result.errors.length === 0) {
+  for (const event of result.events) {
+    console.log(event.path, event.value);
+  }
+} else {
+  for (const error of result.errors) {
+    console.error(error.message);
+  }
+}
+```
+
+## What You Get
+
+- `events`: Assignment Events emitted from the source document
+- `errors`: diagnostics from lexing, parsing, and downstream compile phases
+
+## Common Patterns
+
+### Fail closed by default
+
+`compile()` returns an empty `events` array if any phase reports errors.
+That is the production-safe default.
+
+### Recovery mode for tooling
+
+Use recovery mode only when partial output is useful for editors or diagnostics:
+
+```ts
+const result = compile(input, { recovery: true });
+
+console.log(result.events); // may be partial
+console.log(result.errors); // all known issues
+```
+
+> Warning: recovery mode is for tooling only.
+
+### Typical next step
+
+If you need schema validation after compile, pass `result.events` to `@altopelago/aeos-core`.
+
+### Inspect the file preamble without full parsing
+
+Use `inspectFilePreamble()` to read only the allowed file-header slot for:
+- a leading `#!...` shebang
+- a `//! format:<id>` host directive on line 1, or line 2 after a shebang
+
+```ts
+import { inspectFilePreamble } from '@altopelago/aeon-core';
+
+const info = inspectFilePreamble('#!/usr/bin/env aeon\n//! format:aeon.test.v1\nvalue = {');
+console.log(info.format); // "aeon.test.v1"
+```
+
+## API
+
+### `compile(input, options?)`
+
+Compiles an AEON document into Assignment Events.
+
+**Parameters:**
+- `input: string` — AEON document source text
+- `options?: CompileOptions`
+  - `recovery?: boolean` — Enable recovery mode (default: `false`)
+  - `maxInputBytes?: number` — Maximum accepted UTF-8 input size before fail-closed rejection
+  - `maxAttributeDepth?: number`
+  - `maxSeparatorDepth?: number`
+  - `emitAnnotations?: boolean`
+  - `datatypePolicy?: 'reserved_only' | 'allow_custom'`
+
+**Returns:** `CompileResult`
+- `events: AssignmentEvent[]` — Assignment events (empty if errors and not in recovery mode)
+- `errors: AEONError[]` — All errors from all phases
+- `header` — Parsed header metadata for downstream finalization/runtime projection
+
+### `inspectFilePreamble(input)`
+
+Reads only the file-header preamble slot and returns:
+- `shebang`
+- `hostDirective`
+- `format`
+- `span`
+
+## Exported Types
+
+- `CompileResult` — Return type of `compile()`
+- `CompileOptions` — Options for `compile()`
+- `AssignmentEvent` — Individual binding event
+- `CanonicalPath` — Path representation
+- `AEONError` — Union of all error types
+- `Span`, `Position` — Source location types
+- `formatPath()` — Utility to format paths as strings
+
+## Lower-Level Packages
+
+For advanced tooling, lower-level packages are available but considered unstable:
+
+- `@altopelago/aeon-lexer` — Tokenization
+- `@altopelago/aeon-parser` — AST construction
+- `@altopelago/aeon-aes` — Event emission and validation
+
+These APIs may evolve. Prefer `@altopelago/aeon-core` for stable usage.
+
+For the implementation-defined option surface and security-oriented controls, see:
+
+- [`docs/implementations/typescript/limits-and-policies.md`](../../../../docs/implementations/typescript/limits-and-policies.md)

package/dist/index.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @altopelago/aeon-core - AEON Core Package
+ *
+ * The canonical, safe entry point for AEON processing.
+ *
+ * Usage:
+ * ```ts
+ * import { compile } from '@altopelago/aeon-core';
+ *
+ * const result = compile('key = "value"');
+ * if (result.errors.length === 0) {
+ *   console.log(result.events);
+ * }
+ * ```
+ */
+import { type LexerError } from '@altopelago/aeon-lexer';
+import { type ParserError, type Document, type Value } from '@altopelago/aeon-parser';
+import { EventEmissionError, type AssignmentEvent, type PathResolutionError, type ReferenceValidationError, type ModeEnforcementError, type DatatypePolicy } from '@altopelago/aeon-aes';
+import { type AnnotationRecord } from '@altopelago/aeon-annotation-stream';
+export { inspectFilePreamble, type FilePreambleInfo, type HostDirective, type HostDirectiveKind } from './preamble.js';
+export declare const VERSION = "0.9.0";
+/**
+ * Union of all possible AEON errors
+ */
+export type AEONError = LexerError | ParserError | PathResolutionError | EventEmissionError | ReferenceValidationError | ModeEnforcementError | InputSizeExceededError;
+export declare class InputSizeExceededError extends Error {
+    readonly code = "INPUT_SIZE_EXCEEDED";
+    readonly actualBytes: number;
+    readonly maxBytes: number;
+    constructor(actualBytes: number, maxBytes: number);
+}
+/**
+ * Compilation result
+ */
+export interface CompileResult {
+    /** Assignment events (empty if any errors occurred unless recovery mode) */
+    readonly events: readonly AssignmentEvent[];
+    /** All errors from all phases */
+    readonly errors: readonly AEONError[];
+    /** Parsed header metadata for downstream projection/finalization. */
+    readonly header?: {
+        readonly fields: ReadonlyMap<string, Value>;
+        readonly span: Document['span'];
+        readonly form: 'structured' | 'shorthand';
+    };
+    /** Structured comment records emitted in parallel when enabled */
+    readonly annotations?: readonly AnnotationRecord[];
+}
+/**
+ * Compilation options
+ */
+export interface CompileOptions {
+    /**
+     * Enable recovery mode: emit partial events even if errors exist.
+     * Default: false (fail-closed - no events on any error)
+     *
+     * WARNING: Recovery mode should only be used for tooling (e.g., IDE support).
+     * For production processing, always use fail-closed (default).
+     */
+    readonly recovery?: boolean;
+    /** Maximum number of attribute segments in a reference path (default: 1). */
+    readonly maxAttributeDepth?: number;
+    /** Maximum number of separator specs in a datatype annotation (default: 1). */
+    readonly maxSeparatorDepth?: number;
+    /** Maximum nesting depth for nested generic type annotations (default: 1). */
+    readonly maxGenericDepth?: number;
+    /** Maximum container nesting depth for objects, lists, tuples, and nodes (default: 256). */
+    readonly maxNestingDepth?: number;
+    /** Emit structured annotation stream records. Default: true. */
+    readonly emitAnnotations?: boolean;
+    /** Datatype policy in strict mode. Default: reserved_only */
+    readonly datatypePolicy?: DatatypePolicy;
+    /** Maximum UTF-8 input size in bytes. Fail-closed when exceeded. */
+    readonly maxInputBytes?: number;
+}
+/**
+ * Compile an AEON document into Assignment Events
+ *
+ * This is the canonical, safe entry point for AEON processing.
+ * It runs all phases (lex → parse → resolve → emit → validate → enforce)
+ * and returns a deterministic result.
+ *
+ * **Fail-closed behavior**: If ANY error occurs in ANY phase,
+ * the returned events array will be empty. Errors are always collected
+ * and returned for diagnostics.
+ *
+ * @param input - AEON document source text
+ * @param options - Optional compilation settings
+ * @returns Compilation result with events and errors
+ *
+ * @example
+ * ```ts
+ * const result = compile('config = { port = 8080 }');
+ * if (result.errors.length === 0) {
+ *   for (const event of result.events) {
+ *     console.log(event.path, event.value);
+ *   }
+ * }
+ * ```
+ */
+export declare function compile(input: string, options?: CompileOptions): CompileResult;
+export type { AssignmentEvent, CanonicalPath } from '@altopelago/aeon-aes';
+export type { AnnotationRecord } from '@altopelago/aeon-annotation-stream';
+export type { Span, Position } from '@altopelago/aeon-lexer';
+export { formatPath } from '@altopelago/aeon-aes';
+//# 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;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAA2C,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAgB,MAAM,yBAAyB,CAAC;AAC7I,OAAO,EAKH,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA2C,KAAK,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACpH,OAAO,EAAE,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAMvH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,SAAS,GACf,UAAU,GACV,WAAW,GACX,mBAAmB,GACnB,kBAAkB,GAClB,wBAAwB,GACxB,oBAAoB,GACpB,sBAAsB,CAAC;AAE7B,qBAAa,sBAAuB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAMpD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE;QACd,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC5C,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChC,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,CAAC;KAC7C,CAAC;IACF,kEAAkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,+EAA+E;IAC/E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,4FAA4F;IAC5F,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,gEAAgE;IAChE,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,oEAAoE;IACpE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa,CA8FlF;AAwBD,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,331 @@
+/**
+ * @altopelago/aeon-core - AEON Core Package
+ *
+ * The canonical, safe entry point for AEON processing.
+ *
+ * Usage:
+ * ```ts
+ * import { compile } from '@altopelago/aeon-core';
+ *
+ * const result = compile('key = "value"');
+ * if (result.errors.length === 0) {
+ *   console.log(result.events);
+ * }
+ * ```
+ */
+import { tokenize } from '@altopelago/aeon-lexer';
+import { parse, SyntaxError as ParserSyntaxError } from '@altopelago/aeon-parser';
+import { resolvePaths, emitEvents, validateReferences, enforceMode, EventEmissionError, } from '@altopelago/aeon-aes';
+import { buildAnnotationStreamFromSourceAndSpans } from '@altopelago/aeon-annotation-stream';
+export { inspectFilePreamble } from './preamble.js';
+// =============================================================================
+// PUBLIC API
+// =============================================================================
+export const VERSION = '0.9.0';
+export class InputSizeExceededError extends Error {
+    code = 'INPUT_SIZE_EXCEEDED';
+    actualBytes;
+    maxBytes;
+    constructor(actualBytes, maxBytes) {
+        super(`Input size ${actualBytes} bytes exceeds configured limit of ${maxBytes} bytes`);
+        this.name = 'InputSizeExceededError';
+        this.actualBytes = actualBytes;
+        this.maxBytes = maxBytes;
+    }
+}
+/**
+ * Compile an AEON document into Assignment Events
+ *
+ * This is the canonical, safe entry point for AEON processing.
+ * It runs all phases (lex → parse → resolve → emit → validate → enforce)
+ * and returns a deterministic result.
+ *
+ * **Fail-closed behavior**: If ANY error occurs in ANY phase,
+ * the returned events array will be empty. Errors are always collected
+ * and returned for diagnostics.
+ *
+ * @param input - AEON document source text
+ * @param options - Optional compilation settings
+ * @returns Compilation result with events and errors
+ *
+ * @example
+ * ```ts
+ * const result = compile('config = { port = 8080 }');
+ * if (result.errors.length === 0) {
+ *   for (const event of result.events) {
+ *     console.log(event.path, event.value);
+ *   }
+ * }
+ * ```
+ */
+export function compile(input, options = {}) {
+    const allErrors = [];
+    const recovery = options.recovery ?? false;
+    const maxAttributeDepth = options.maxAttributeDepth ?? 1;
+    const maxSeparatorDepth = options.maxSeparatorDepth ?? 1;
+    const maxGenericDepth = options.maxGenericDepth ?? 1;
+    const maxNestingDepth = options.maxNestingDepth ?? 256;
+    const emitAnnotations = options.emitAnnotations ?? true;
+    const datatypePolicy = options.datatypePolicy;
+    const maxInputBytes = options.maxInputBytes;
+    if (maxInputBytes !== undefined) {
+        const actualBytes = Buffer.byteLength(input, 'utf8');
+        if (actualBytes > maxInputBytes) {
+            allErrors.push(new InputSizeExceededError(actualBytes, maxInputBytes));
+            return { events: [], errors: allErrors };
+        }
+    }
+    input = stripLeadingBom(input);
+    // Phase 1: Lexing
+    const lexResult = tokenize(input, { includeComments: false });
+    allErrors.push(...normalizeLexerErrors(input, lexResult.errors));
+    if (lexResult.errors.length > 0 && !recovery) {
+        return { events: [], errors: allErrors };
+    }
+    // Phase 2: Parsing
+    const parseResult = parse(lexResult.tokens, { maxAttributeDepth, maxSeparatorDepth, maxGenericDepth, maxNestingDepth });
+    allErrors.push(...parseResult.errors);
+    if (parseResult.errors.length > 0 && !recovery) {
+        return { events: [], errors: allErrors };
+    }
+    if (!parseResult.document) {
+        return { events: [], errors: allErrors };
+    }
+    // Phase 3: Path Resolution
+    const resolveResult = resolvePaths(parseResult.document, { indexedPaths: true });
+    allErrors.push(...resolveResult.errors);
+    if (resolveResult.errors.length > 0 && !recovery) {
+        return { events: [], errors: allErrors };
+    }
+    // Phase 4: Event Emission
+    const emitResult = emitEvents(resolveResult, { recovery });
+    for (const err of emitResult.errors) {
+        if (err instanceof EventEmissionError) {
+            allErrors.push(err);
+        }
+    }
+    if (emitResult.errors.length > 0 && !recovery && emitResult.events.length === 0) {
+        return { events: [], errors: allErrors };
+    }
+    // Phase 5: Reference Validation
+    const refResult = validateReferences(emitResult.events, { recovery, maxAttributeDepth });
+    allErrors.push(...refResult.errors);
+    if (refResult.errors.length > 0 && !recovery) {
+        return { events: [], errors: allErrors };
+    }
+    // Phase 6: Mode Enforcement
+    const modeResult = enforceMode(refResult.events, parseResult.document.header, {
+        recovery,
+        ...(datatypePolicy ? { datatypePolicy } : {}),
+    });
+    allErrors.push(...modeResult.errors);
+    if (modeResult.errors.length > 0 && !recovery) {
+        return { events: [], errors: allErrors };
+    }
+    const result = {
+        events: modeResult.events,
+        errors: allErrors,
+        ...(parseResult.document.header
+            ? {
+                header: {
+                    fields: parseResult.document.header.fields,
+                    span: parseResult.document.header.span,
+                    form: parseResult.document.header.form,
+                },
+            }
+            : {}),
+    };
+    if (emitAnnotations) {
+        const spanTargets = collectSpanTargets(parseResult.document);
+        result.annotations =
+            buildAnnotationStreamFromSourceAndSpans(input, modeResult.events, spanTargets);
+    }
+    return result;
+}
+function normalizeLexerErrors(input, errors) {
+    return errors.map((error) => {
+        if (error.code === 'INVALID_NUMBER') {
+            const raw = input.slice(error.span.start.offset, error.span.end.offset);
+            if (raw.startsWith('#') || raw.startsWith('$')) {
+                return new ParserSyntaxError(`Invalid literal spelling: '${raw}'`, error.span, null, raw);
+            }
+        }
+        return error;
+    });
+}
+// Utility for formatting paths (commonly needed)
+export { formatPath } from '@altopelago/aeon-aes';
+function stripLeadingBom(input) {
+    return input.startsWith('\uFEFF') ? input.slice(1) : input;
+}
+function collectSpanTargets(document) {
+    const spans = [];
+    const seen = new Set();
+    const addSpan = (span) => {
+        const key = `${span.start.offset}:${span.end.offset}`;
+        if (seen.has(key)) {
+            return;
+        }
+        seen.add(key);
+        spans.push(span);
+    };
+    const visitValue = (value) => {
+        addSpan(value.span);
+        switch (value.type) {
+            case 'TypedValue':
+                if (value.datatype) {
+                    addSpan(value.datatype.span);
+                }
+                for (const attribute of value.attributes) {
+                    addSpan(attribute.span);
+                    for (const [, entry] of attribute.entries) {
+                        for (const nestedAttribute of entry.attributes) {
+                            addSpan(nestedAttribute.span);
+                            for (const [, nestedEntry] of nestedAttribute.entries) {
+                                addSpan(nestedEntry.value.span);
+                                if (nestedEntry.datatype) {
+                                    addSpan(nestedEntry.datatype.span);
+                                }
+                            }
+                        }
+                        addSpan(entry.value.span);
+                        if (entry.datatype) {
+                            addSpan(entry.datatype.span);
+                        }
+                    }
+                }
+                visitValue(value.value);
+                break;
+            case 'ObjectNode':
+                for (const attribute of value.attributes) {
+                    addSpan(attribute.span);
+                    for (const [, entry] of attribute.entries) {
+                        for (const nestedAttribute of entry.attributes) {
+                            addSpan(nestedAttribute.span);
+                            for (const [, nestedEntry] of nestedAttribute.entries) {
+                                addSpan(nestedEntry.value.span);
+                                if (nestedEntry.datatype) {
+                                    addSpan(nestedEntry.datatype.span);
+                                }
+                            }
+                        }
+                        addSpan(entry.value.span);
+                        if (entry.datatype) {
+                            addSpan(entry.datatype.span);
+                        }
+                    }
+                }
+                for (const binding of value.bindings) {
+                    visitBinding(binding);
+                }
+                break;
+            case 'ListNode':
+                for (const attribute of value.attributes) {
+                    addSpan(attribute.span);
+                    for (const [, entry] of attribute.entries) {
+                        for (const nestedAttribute of entry.attributes) {
+                            addSpan(nestedAttribute.span);
+                            for (const [, nestedEntry] of nestedAttribute.entries) {
+                                addSpan(nestedEntry.value.span);
+                                if (nestedEntry.datatype) {
+                                    addSpan(nestedEntry.datatype.span);
+                                }
+                            }
+                        }
+                        addSpan(entry.value.span);
+                        if (entry.datatype) {
+                            addSpan(entry.datatype.span);
+                        }
+                    }
+                }
+                for (const element of value.elements) {
+                    visitValue(element);
+                }
+                break;
+            case 'TupleLiteral':
+                for (const attribute of value.attributes) {
+                    addSpan(attribute.span);
+                    for (const [, entry] of attribute.entries) {
+                        for (const nestedAttribute of entry.attributes) {
+                            addSpan(nestedAttribute.span);
+                            for (const [, nestedEntry] of nestedAttribute.entries) {
+                                addSpan(nestedEntry.value.span);
+                                if (nestedEntry.datatype) {
+                                    addSpan(nestedEntry.datatype.span);
+                                }
+                            }
+                        }
+                        addSpan(entry.value.span);
+                        if (entry.datatype) {
+                            addSpan(entry.datatype.span);
+                        }
+                    }
+                }
+                for (const element of value.elements) {
+                    visitValue(element);
+                }
+                break;
+            case 'NodeLiteral':
+                for (const attribute of value.attributes) {
+                    addSpan(attribute.span);
+                    for (const [, entry] of attribute.entries) {
+                        for (const nestedAttribute of entry.attributes) {
+                            addSpan(nestedAttribute.span);
+                            for (const [, nestedEntry] of nestedAttribute.entries) {
+                                addSpan(nestedEntry.value.span);
+                                if (nestedEntry.datatype) {
+                                    addSpan(nestedEntry.datatype.span);
+                                }
+                            }
+                        }
+                        addSpan(entry.value.span);
+                        if (entry.datatype) {
+                            addSpan(entry.datatype.span);
+                        }
+                    }
+                }
+                if (value.datatype) {
+                    addSpan(value.datatype.span);
+                }
+                for (const child of value.children) {
+                    visitValue(child);
+                }
+                break;
+            default:
+                break;
+        }
+    };
+    const visitBinding = (binding) => {
+        addSpan(binding.span);
+        if (binding.datatype) {
+            addSpan(binding.datatype.span);
+        }
+        for (const attribute of binding.attributes) {
+            addSpan(attribute.span);
+            for (const [, entry] of attribute.entries) {
+                addSpan(entry.value.span);
+                if (entry.datatype) {
+                    addSpan(entry.datatype.span);
+                }
+            }
+        }
+        visitValue(binding.value);
+    };
+    if (document.header) {
+        addSpan(document.header.span);
+        for (const binding of document.header.bindings) {
+            visitBinding(binding);
+        }
+    }
+    for (const binding of document.bindings) {
+        visitBinding(binding);
+    }
+    if (document.envelope) {
+        addSpan(document.envelope.span);
+        for (const [, value] of document.envelope.fields) {
+            visitValue(value);
+        }
+    }
+    return spans;
+}
+//# 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;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAmB,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,WAAW,IAAI,iBAAiB,EAA6D,MAAM,yBAAyB,CAAC;AAC7I,OAAO,EACH,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,kBAAkB,GAMrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,uCAAuC,EAAyB,MAAM,oCAAoC,CAAC;AACpH,OAAO,EAAE,mBAAmB,EAAqE,MAAM,eAAe,CAAC;AAEvH,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAc/B,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACpC,IAAI,GAAG,qBAAqB,CAAC;IAC7B,WAAW,CAAS;IACpB,QAAQ,CAAS;IAE1B,YAAY,WAAmB,EAAE,QAAgB;QAC7C,KAAK,CAAC,cAAc,WAAW,sCAAsC,QAAQ,QAAQ,CAAC,CAAC;QACvF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CACJ;AAgDD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,UAA0B,EAAE;IAC/D,MAAM,SAAS,GAAgB,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;IAC3C,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,CAAC,CAAC;IACzD,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,CAAC,CAAC;IACzD,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,CAAC,CAAC;IACrD,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,GAAG,CAAC;IACvD,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;IACxD,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAC9C,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAE5C,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrD,IAAI,WAAW,GAAG,aAAa,EAAE,CAAC;YAC9B,SAAS,CAAC,IAAI,CAAC,IAAI,sBAAsB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;YACvE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC7C,CAAC;IACL,CAAC;IAED,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAE/B,kBAAkB;IAClB,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9D,SAAS,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC3C,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC7C,CAAC;IAED,mBAAmB;IACnB,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC,CAAC;IACxH,SAAS,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7C,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC7C,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;QACxB,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC7C,CAAC;IAED,2BAA2B;IAC3B,MAAM,aAAa,GAAG,YAAY,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IACjF,SAAS,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,aAAa,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC/C,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC7C,CAAC;IAED,0BAA0B;IAC1B,MAAM,UAAU,GAAG,UAAU,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3D,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,GAAG,YAAY,kBAAkB,EAAE,CAAC;YACpC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACL,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9E,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC7C,CAAC;IAED,gCAAgC;IAChC,MAAM,SAAS,GAAG,kBAAkB,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACzF,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC3C,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC7C,CAAC;IAED,4BAA4B;IAC5B,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE;QAC1E,QAAQ;QACR,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC,CAAC;IACH,SAAS,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5C,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,MAAM,GAAkB;QAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,MAAM,EAAE,SAAS;QACjB,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM;YAC3B,CAAC,CAAC;gBACE,MAAM,EAAE;oBACJ,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM;oBAC1C,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI;oBACtC,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI;iBACzC;aACJ;YACD,CAAC,CAAC,EAAE,CAAC;KACZ,CAAC;IAEF,IAAI,eAAe,EAAE,CAAC;QAClB,MAAM,WAAW,GAAG,kBAAkB,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAuD,CAAC,WAAW;YAChE,uCAAuC,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa,EAAE,MAA6B;IACtE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACxB,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACxE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7C,OAAO,IAAI,iBAAiB,CACxB,8BAA8B,GAAG,GAAG,EACpC,KAAK,CAAC,IAAI,EACV,IAAI,EACJ,GAAG,CACN,CAAC;YACN,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC,CAAC,CAAC;AACP,CAAC;AAWD,iDAAiD;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,SAAS,eAAe,CAAC,KAAa;IAClC,OAAO,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/D,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAkB;IAC1C,MAAM,KAAK,GAAsM,EAAE,CAAC;IACpN,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,OAAO,GAAG,CAAC,IAAgM,EAAQ,EAAE;QACvN,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QACtD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAChB,OAAO;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,KAAY,EAAQ,EAAE;QACtC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,YAAY;gBACb,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACjB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACjC,CAAC;gBACD,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;oBACvC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;oBACxB,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;wBACxC,KAAK,MAAM,eAAe,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;4BAC7C,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;4BAC9B,KAAK,MAAM,CAAC,EAAE,WAAW,CAAC,IAAI,eAAe,CAAC,OAAO,EAAE,CAAC;gCACpD,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gCAChC,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;oCACvB,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gCACvC,CAAC;4BACL,CAAC;wBACL,CAAC;wBACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBAC1B,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;4BACjB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;wBACjC,CAAC;oBACL,CAAC;gBACL,CAAC;gBACD,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACxB,MAAM;YACV,KAAK,YAAY;gBACb,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;oBACvC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;oBACxB,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;wBACxC,KAAK,MAAM,eAAe,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;4BAC7C,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;4BAC9B,KAAK,MAAM,CAAC,EAAE,WAAW,CAAC,IAAI,eAAe,CAAC,OAAO,EAAE,CAAC;gCACpD,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gCAChC,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;oCACvB,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gCACvC,CAAC;4BACL,CAAC;wBACL,CAAC;wBACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBAC1B,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;4BACjB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;wBACjC,CAAC;oBACL,CAAC;gBACL,CAAC;gBACD,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACnC,YAAY,CAAC,OAAO,CAAC,CAAC;gBAC1B,CAAC;gBACD,MAAM;YACV,KAAK,UAAU;gBACX,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;oBACvC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;oBACxB,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;wBACxC,KAAK,MAAM,eAAe,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;4BAC7C,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;4BAC9B,KAAK,MAAM,CAAC,EAAE,WAAW,CAAC,IAAI,eAAe,CAAC,OAAO,EAAE,CAAC;gCACpD,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gCAChC,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;oCACvB,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gCACvC,CAAC;4BACL,CAAC;wBACL,CAAC;wBACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBAC1B,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;4BACjB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;wBACjC,CAAC;oBACL,CAAC;gBACL,CAAC;gBACD,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACnC,UAAU,CAAC,OAAO,CAAC,CAAC;gBACxB,CAAC;gBACD,MAAM;YACV,KAAK,cAAc;gBACf,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;oBACvC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;oBACxB,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;wBACxC,KAAK,MAAM,eAAe,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;4BAC7C,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;4BAC9B,KAAK,MAAM,CAAC,EAAE,WAAW,CAAC,IAAI,eAAe,CAAC,OAAO,EAAE,CAAC;gCACpD,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gCAChC,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;oCACvB,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gCACvC,CAAC;4BACL,CAAC;wBACL,CAAC;wBACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBAC1B,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;4BACjB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;wBACjC,CAAC;oBACL,CAAC;gBACL,CAAC;gBACD,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACnC,UAAU,CAAC,OAAO,CAAC,CAAC;gBACxB,CAAC;gBACD,MAAM;YACV,KAAK,aAAa;gBACd,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;oBACvC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;oBAC5B,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;wBACxC,KAAK,MAAM,eAAe,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;4BAC7C,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;4BAC9B,KAAK,MAAM,CAAC,EAAE,WAAW,CAAC,IAAI,eAAe,CAAC,OAAO,EAAE,CAAC;gCACpD,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gCAChC,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;oCACvB,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gCACvC,CAAC;4BACL,CAAC;wBACL,CAAC;wBACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBAC1B,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;4BACjB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;wBAC7B,CAAC;oBACL,CAAC;gBACL,CAAC;gBACD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACjB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACjC,CAAC;gBACD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACjC,UAAU,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;gBACD,MAAM;YACV;gBACI,MAAM;QACd,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,CAAC,OAAgB,EAAQ,EAAE;QAC5C,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACzC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACxB,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;gBACxC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1B,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACjB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACjC,CAAC;YACL,CAAC;QACL,CAAC;QACD,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC;IAEF,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC7C,YAAY,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;IACL,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACtC,YAAY,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC/C,UAAU,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/preamble.d.ts

@@ -0,0 +1,18 @@
+import type { Span } from '@altopelago/aeon-lexer';
+export type HostDirectiveKind = 'format' | 'unknown';
+export interface HostDirective {
+    readonly raw: string;
+    readonly kind: HostDirectiveKind;
+    readonly value: string | null;
+}
+export interface FilePreambleInfo {
+    readonly shebang: string | null;
+    readonly hostDirective: HostDirective | null;
+    readonly format: string | null;
+    readonly span: {
+        readonly shebang?: Span;
+        readonly hostDirective?: Span;
+    };
+}
+export declare function inspectFilePreamble(source: string): FilePreambleInfo;
+//# sourceMappingURL=preamble.d.ts.map

package/dist/preamble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preamble.d.ts","sourceRoot":"","sources":["../src/preamble.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAErD,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE;QACX,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;QACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;KACjC,CAAC;CACL;AAQD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CA+CpE"}

package/dist/preamble.js

@@ -0,0 +1,91 @@
+export function inspectFilePreamble(source) {
+    source = stripLeadingBom(source);
+    const firstLine = readLine(source, 0, 1);
+    if (!firstLine) {
+        return { shebang: null, hostDirective: null, format: null, span: {} };
+    }
+    let shebang = null;
+    let shebangSpan;
+    let hostDirectiveLine = null;
+    if (firstLine.raw.startsWith('#!')) {
+        shebang = firstLine.raw;
+        shebangSpan = firstLine.span;
+        hostDirectiveLine = readLine(source, firstLine.nextOffset, 2);
+    }
+    else if (firstLine.raw.startsWith('//!')) {
+        hostDirectiveLine = firstLine;
+    }
+    if (!hostDirectiveLine && shebangSpan) {
+        const secondLine = readLine(source, firstLine.nextOffset, 2);
+        if (secondLine && secondLine.raw.startsWith('//!')) {
+            hostDirectiveLine = secondLine;
+        }
+    }
+    let hostDirective = null;
+    let format = null;
+    let hostDirectiveSpan;
+    if (hostDirectiveLine && hostDirectiveLine.raw.startsWith('//!')) {
+        hostDirective = parseHostDirective(hostDirectiveLine.raw);
+        hostDirectiveSpan = hostDirectiveLine.span;
+        if (hostDirective.kind === 'format') {
+            format = hostDirective.value;
+        }
+    }
+    return {
+        shebang,
+        hostDirective,
+        format,
+        span: {
+            ...(shebangSpan ? { shebang: shebangSpan } : {}),
+            ...(hostDirectiveSpan ? { hostDirective: hostDirectiveSpan } : {}),
+        },
+    };
+}
+function stripLeadingBom(source) {
+    return source.startsWith('\uFEFF') ? source.slice(1) : source;
+}
+function parseHostDirective(raw) {
+    const formatPrefix = '//! format:';
+    if (raw.startsWith(formatPrefix)) {
+        const value = raw.slice(formatPrefix.length).trim();
+        return {
+            raw,
+            kind: 'format',
+            value: value.length > 0 ? value : null,
+        };
+    }
+    return {
+        raw,
+        kind: 'unknown',
+        value: null,
+    };
+}
+function readLine(source, offset, line) {
+    let startOffset = offset;
+    if (startOffset >= source.length) {
+        return null;
+    }
+    if (line > 1 && source[startOffset] === '\n') {
+        startOffset += 1;
+    }
+    if (startOffset >= source.length) {
+        return null;
+    }
+    let endOffset = startOffset;
+    while (endOffset < source.length && source[endOffset] !== '\n') {
+        endOffset += 1;
+    }
+    let rawEndOffset = endOffset;
+    if (rawEndOffset > startOffset && source[rawEndOffset - 1] === '\r') {
+        rawEndOffset -= 1;
+    }
+    return {
+        raw: source.slice(startOffset, rawEndOffset),
+        span: {
+            start: { line, column: 1, offset: startOffset },
+            end: { line, column: rawEndOffset - startOffset + 1, offset: rawEndOffset },
+        },
+        nextOffset: endOffset < source.length ? endOffset + 1 : endOffset,
+    };
+}
+//# sourceMappingURL=preamble.js.map

package/dist/preamble.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@altopelago/aeon-core",
+  "version": "0.9.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.d.ts.map",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.js.map"
+  ],
+  "dependencies": {
+    "@altopelago/aeon-lexer": "0.9.0",
+    "@altopelago/aeon-aes": "0.9.0",
+    "@altopelago/aeon-annotation-stream": "0.9.0",
+    "@altopelago/aeon-parser": "0.9.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node --test dist/*.test.js",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}