sh-ast 0.3.1 → 0.5.0

package/dist/syntax-errors.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Error adaptation for the upstream syntax interface. Exceptions retain the Go
+ * error's structured information and partial result; JavaScript's display message
+ * is never the only copy of a byte-bearing upstream value.
+ */
+import type { File, GoString, SyntaxPos } from '../generated/syntax-types.js';
+import { ShAstError } from './errors.js';
+/**
+ * A source grammar error reported by mvdan/sh, with the partial parsed file.
+ * @public
+ */
+export declare class ParseError extends ShAstError {
+    readonly Message: GoString;
+    readonly Filename: GoString;
+    readonly Pos: SyntaxPos;
+    readonly Text: GoString;
+    readonly Incomplete: boolean;
+    readonly File: File | null;
+    /** Identifies a source grammar failure independently of its display text. */
+    readonly code = "SH_AST_SYNTAX_PARSE";
+    /**
+     * Keeps the original Go fields. Message is the formatted upstream error;
+     * Text is its unformatted diagnostic, and File is the result returned with it.
+     */
+    constructor(Message: GoString, Filename: GoString, Pos: SyntaxPos, Text: GoString, Incomplete: boolean, File: File | null);
+}
+/**
+ * A syntax feature rejected for the selected upstream language variant.
+ * @public
+ */
+export declare class LangError extends ShAstError {
+    readonly Message: GoString;
+    readonly Filename: GoString;
+    readonly Pos: SyntaxPos;
+    readonly Feature: GoString;
+    readonly Langs: readonly number[];
+    readonly LangUsed: number;
+    readonly File: File | null;
+    /** Identifies a dialect-specific syntax failure. */
+    readonly code = "SH_AST_SYNTAX_LANG";
+    /** Preserves the feature, permitted variants, actual variant and partial tree. */
+    constructor(Message: GoString, Filename: GoString, Pos: SyntaxPos, Feature: GoString, Langs: readonly number[], LangUsed: number, File: File | null);
+}
+/**
+ * An argument cannot be represented by the binding or violates an upstream
+ * operation's input constraint. It is distinct from malformed shell source.
+ * @public
+ */
+export declare class InputError extends ShAstError {
+    readonly Message: GoString;
+    /** Identifies caller input that cannot be passed faithfully to the operation. */
+    readonly code = "SH_AST_SYNTAX_INPUT";
+    /** Retains exact upstream message bytes even when Error.message needs text. */
+    constructor(Message: GoString);
+}
+//# sourceMappingURL=syntax-errors.d.ts.map

package/dist/syntax-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-errors.d.ts","sourceRoot":"","sources":["../src/syntax-errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,qBAAa,UAAW,SAAQ,UAAU;IAStC,QAAQ,CAAC,OAAO,EAAE,QAAQ;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ;IAC3B,QAAQ,CAAC,GAAG,EAAE,SAAS;IACvB,QAAQ,CAAC,IAAI,EAAE,QAAQ;IACvB,QAAQ,CAAC,UAAU,EAAE,OAAO;IAC5B,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAb5B,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,yBAAyB;IAEtC;;;OAGG;gBAEQ,OAAO,EAAE,QAAQ,EACjB,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,IAAI,GAAG,IAAI;CAK7B;AAED;;;GAGG;AACH,qBAAa,SAAU,SAAQ,UAAU;IAMrC,QAAQ,CAAC,OAAO,EAAE,QAAQ;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ;IAC3B,QAAQ,CAAC,GAAG,EAAE,SAAS;IACvB,QAAQ,CAAC,OAAO,EAAE,QAAQ;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAX5B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,wBAAwB;IAErC,kFAAkF;gBAEvE,OAAO,EAAE,QAAQ,EACjB,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,QAAQ,EACjB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,IAAI,GAAG,IAAI;CAK7B;AAED;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,UAAU;IAK5B,QAAQ,CAAC,OAAO,EAAE,QAAQ;IAJtC,iFAAiF;IACjF,QAAQ,CAAC,IAAI,yBAAyB;IAEtC,+EAA+E;gBAC1D,OAAO,EAAE,QAAQ;CAIvC"}

package/dist/syntax-errors.js

@@ -0,0 +1,80 @@
+import { ShAstError } from './errors.js';
+/**
+ * A source grammar error reported by mvdan/sh, with the partial parsed file.
+ * @public
+ */
+export class ParseError extends ShAstError {
+    Message;
+    Filename;
+    Pos;
+    Text;
+    Incomplete;
+    File;
+    /** Identifies a source grammar failure independently of its display text. */
+    code = 'SH_AST_SYNTAX_PARSE';
+    /**
+     * Keeps the original Go fields. Message is the formatted upstream error;
+     * Text is its unformatted diagnostic, and File is the result returned with it.
+     */
+    constructor(Message, Filename, Pos, Text, Incomplete, File) {
+        super(displayMessage(Message));
+        this.Message = Message;
+        this.Filename = Filename;
+        this.Pos = Pos;
+        this.Text = Text;
+        this.Incomplete = Incomplete;
+        this.File = File;
+        this.name = 'ParseError';
+    }
+}
+/**
+ * A syntax feature rejected for the selected upstream language variant.
+ * @public
+ */
+export class LangError extends ShAstError {
+    Message;
+    Filename;
+    Pos;
+    Feature;
+    Langs;
+    LangUsed;
+    File;
+    /** Identifies a dialect-specific syntax failure. */
+    code = 'SH_AST_SYNTAX_LANG';
+    /** Preserves the feature, permitted variants, actual variant and partial tree. */
+    constructor(Message, Filename, Pos, Feature, Langs, LangUsed, File) {
+        super(displayMessage(Message));
+        this.Message = Message;
+        this.Filename = Filename;
+        this.Pos = Pos;
+        this.Feature = Feature;
+        this.Langs = Langs;
+        this.LangUsed = LangUsed;
+        this.File = File;
+        this.name = 'LangError';
+    }
+}
+/**
+ * An argument cannot be represented by the binding or violates an upstream
+ * operation's input constraint. It is distinct from malformed shell source.
+ * @public
+ */
+export class InputError extends ShAstError {
+    Message;
+    /** Identifies caller input that cannot be passed faithfully to the operation. */
+    code = 'SH_AST_SYNTAX_INPUT';
+    /** Retains exact upstream message bytes even when Error.message needs text. */
+    constructor(Message) {
+        super(displayMessage(Message));
+        this.Message = Message;
+        this.name = 'InputError';
+    }
+}
+/**
+ * Error.message is a human-readable rendering only. The public Message property
+ * retains original bytes when the Go value is not valid UTF-8.
+ */
+function displayMessage(value) {
+    return typeof value === 'string' ? value : new TextDecoder().decode(value);
+}
+//# sourceMappingURL=syntax-errors.js.map

package/dist/syntax-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-errors.js","sourceRoot":"","sources":["../src/syntax-errors.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,OAAO,UAAW,SAAQ,UAAU;IAS7B;IACA;IACA;IACA;IACA;IACA;IAbX,6EAA6E;IACpE,IAAI,GAAG,qBAAqB,CAAC;IAEtC;;;OAGG;IACH,YACW,OAAiB,EACjB,QAAkB,EAClB,GAAc,EACd,IAAc,EACd,UAAmB,EACnB,IAAiB;QAE1B,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;QAPtB,YAAO,GAAP,OAAO,CAAU;QACjB,aAAQ,GAAR,QAAQ,CAAU;QAClB,QAAG,GAAH,GAAG,CAAW;QACd,SAAI,GAAJ,IAAI,CAAU;QACd,eAAU,GAAV,UAAU,CAAS;QACnB,SAAI,GAAJ,IAAI,CAAa;QAG1B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,UAAU;IAM5B;IACA;IACA;IACA;IACA;IACA;IACA;IAXX,oDAAoD;IAC3C,IAAI,GAAG,oBAAoB,CAAC;IAErC,kFAAkF;IAClF,YACW,OAAiB,EACjB,QAAkB,EAClB,GAAc,EACd,OAAiB,EACjB,KAAwB,EACxB,QAAgB,EAChB,IAAiB;QAE1B,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;QARtB,YAAO,GAAP,OAAO,CAAU;QACjB,aAAQ,GAAR,QAAQ,CAAU;QAClB,QAAG,GAAH,GAAG,CAAW;QACd,YAAO,GAAP,OAAO,CAAU;QACjB,UAAK,GAAL,KAAK,CAAmB;QACxB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,SAAI,GAAJ,IAAI,CAAa;QAG1B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,UAAW,SAAQ,UAAU;IAKnB;IAJrB,iFAAiF;IACxE,IAAI,GAAG,qBAAqB,CAAC;IAEtC,+EAA+E;IAC/E,YAAqB,OAAiB;QACpC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;QADZ,YAAO,GAAP,OAAO,CAAU;QAEpC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,KAAe;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC"}

package/dist/syntax-print-errors.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Printing has two upstream failure modes: returned errors and panics raised by
+ * the operation. Both retain exact message bytes; neither is a parser failure
+ * or a claim that the transport itself malfunctioned.
+ */
+import type { GoString } from '../generated/syntax-types.js';
+import { ShAstError } from './errors.js';
+/**
+ * An error returned by upstream Printer.Print, such as an unsupported root or
+ * incompatible formatting options. No partial writer output is exposed.
+ * @public
+ */
+export declare class PrintError extends ShAstError {
+    /** Stable identity for an ordinary error returned by upstream Print. @public */
+    readonly code = "SH_AST_SYNTAX_PRINT";
+    /** Exact upstream error bytes; Error.message is only a display rendering. @public */
+    readonly Message: GoString;
+    /** Retains the upstream error without interpreting its human-readable text. @public */
+    constructor(message: GoString);
+}
+/**
+ * Upstream Printer.Print panicked for a representable tree or option value.
+ * Partial and typed-nil trees can trigger this independently of root support.
+ * Catching the panic preserves reuse of the binding's shared runtime.
+ * @public
+ */
+export declare class PrintPanicError extends ShAstError {
+    /** Stable identity for an upstream panic caught at the Print operation. @public */
+    readonly code = "SH_AST_SYNTAX_PRINT_PANIC";
+    /** Exact panic rendering from Go; Error.message is only a display rendering. @public */
+    readonly Message: GoString;
+    /** Retains the panic message separately from ordinary returned Print errors. @public */
+    constructor(message: GoString);
+}
+//# sourceMappingURL=syntax-print-errors.d.ts.map

package/dist/syntax-print-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-print-errors.d.ts","sourceRoot":"","sources":["../src/syntax-print-errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,UAAU;IACxC,gFAAgF;IAChF,QAAQ,CAAC,IAAI,yBAAyB;IAEtC,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAE3B,uFAAuF;gBAC3E,OAAO,EAAE,QAAQ;CAK9B;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,mFAAmF;IACnF,QAAQ,CAAC,IAAI,+BAA+B;IAE5C,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAE3B,wFAAwF;gBAC5E,OAAO,EAAE,QAAQ;CAK9B"}

package/dist/syntax-print-errors.js

@@ -0,0 +1,37 @@
+import { ShAstError } from './errors.js';
+/**
+ * An error returned by upstream Printer.Print, such as an unsupported root or
+ * incompatible formatting options. No partial writer output is exposed.
+ * @public
+ */
+export class PrintError extends ShAstError {
+    /** Stable identity for an ordinary error returned by upstream Print. @public */
+    code = 'SH_AST_SYNTAX_PRINT';
+    /** Exact upstream error bytes; Error.message is only a display rendering. @public */
+    Message;
+    /** Retains the upstream error without interpreting its human-readable text. @public */
+    constructor(message) {
+        super(typeof message === 'string' ? message : new TextDecoder().decode(message));
+        this.Message = message;
+        this.name = 'PrintError';
+    }
+}
+/**
+ * Upstream Printer.Print panicked for a representable tree or option value.
+ * Partial and typed-nil trees can trigger this independently of root support.
+ * Catching the panic preserves reuse of the binding's shared runtime.
+ * @public
+ */
+export class PrintPanicError extends ShAstError {
+    /** Stable identity for an upstream panic caught at the Print operation. @public */
+    code = 'SH_AST_SYNTAX_PRINT_PANIC';
+    /** Exact panic rendering from Go; Error.message is only a display rendering. @public */
+    Message;
+    /** Retains the panic message separately from ordinary returned Print errors. @public */
+    constructor(message) {
+        super(typeof message === 'string' ? message : new TextDecoder().decode(message));
+        this.Message = message;
+        this.name = 'PrintPanicError';
+    }
+}
+//# sourceMappingURL=syntax-print-errors.js.map

package/dist/syntax-print-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-print-errors.js","sourceRoot":"","sources":["../src/syntax-print-errors.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;GAIG;AACH,MAAM,OAAO,UAAW,SAAQ,UAAU;IACxC,gFAAgF;IACvE,IAAI,GAAG,qBAAqB,CAAC;IAEtC,qFAAqF;IAC5E,OAAO,CAAW;IAE3B,uFAAuF;IACvF,YAAY,OAAiB;QAC3B,KAAK,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,mFAAmF;IAC1E,IAAI,GAAG,2BAA2B,CAAC;IAE5C,wFAAwF;IAC/E,OAAO,CAAW;IAE3B,wFAAwF;IACxF,YAAY,OAAiB;QAC3B,KAAK,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/syntax-print.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Collected-output access to upstream Printer.Print. The reverse codec rebuilds
+ * the current faithful tree, and Go owns formatting decisions. This module has
+ * no source cache, parser round trip, writer callbacks, or reusable printer state.
+ */
+import type { GoString, Node } from '../generated/syntax-types.js';
+/**
+ * Upstream NewPrinter controls applied to a fresh printer for each call. All
+ * flags default to false; zero indentation selects tabs. The pinned WASM uint
+ * domain is 64-bit, so Indent accepts bigint beyond JavaScript's safe integers.
+ * @public
+ */
+export interface PrintOptions {
+    /** Spaces per level, or zero for tabs. Large values can request expensive output. */
+    Indent?: number | bigint;
+    /** Places multiline binary operators on the next line with a backslash continuation. */
+    BinaryNextLine?: boolean;
+    /** Indents case alternatives, placing their bodies two levels below the case clause. */
+    SwitchCaseIndent?: boolean;
+    /** Adds space after redirection operators except `>&`, `<&`, `>(` and `<(`. */
+    SpaceRedirects?: boolean;
+    /**
+     * Preserves token columns on a best-effort basis.
+     * @deprecated Upstream marks this option as flawed and plans removal in v4.
+     */
+    KeepPadding?: boolean;
+    /** Omits comments, indentation and optional whitespace. Incompatible with SingleLine. */
+    Minify?: boolean;
+    /** Reduces newlines except where comments, heredocs or File output require them. */
+    SingleLine?: boolean;
+    /** Places a function's opening brace on the next line. */
+    FunctionNextLine?: boolean;
+}
+/**
+ * Formats the current tree with a fresh upstream printer and collects all output.
+ * Supported roots are File, Stmt, Word, Assign, Command and WordPart; other Nodes
+ * produce PrintError. Only File output has upstream's trailing-newline behavior.
+ * Invalid UTF-8 output remains bytes. Upstream formatting can itself consume
+ * input bytes, including its tabwriter escape byte, so this is not source replay.
+ *
+ * InputError identifies unrepresentable input; PrintError is an ordinary returned
+ * upstream error; PrintPanicError retains an upstream operation panic. No partial
+ * output or arbitrary writer lifecycle is exposed. Full tree reconstruction and
+ * collected output require memory proportional to the values involved; extreme
+ * indentation or tree size is not made resource-safe by panic adaptation.
+ * @public
+ */
+export declare function printSync(node: Node, options?: PrintOptions): GoString;
+//# sourceMappingURL=syntax-print.d.ts.map

package/dist/syntax-print.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-print.d.ts","sourceRoot":"","sources":["../src/syntax-print.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAOnE;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,wFAAwF;IACxF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wFAAwF;IACxF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+EAA+E;IAC/E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yFAAyF;IACzF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oFAAoF;IACpF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,YAAiB,GAAG,QAAQ,CAoC1E"}

package/dist/syntax-print.js

@@ -0,0 +1,86 @@
+import { ShInternalError } from './errors.js';
+import { InputError } from './syntax-errors.js';
+import { PrintError, PrintPanicError } from './syntax-print-errors.js';
+import { decodeWire, encodeWire, isGoString, isRecord, isSyntaxNode } from './syntax-wire.js';
+import { callSyntax } from './wasm-instance.js';
+/**
+ * Formats the current tree with a fresh upstream printer and collects all output.
+ * Supported roots are File, Stmt, Word, Assign, Command and WordPart; other Nodes
+ * produce PrintError. Only File output has upstream's trailing-newline behavior.
+ * Invalid UTF-8 output remains bytes. Upstream formatting can itself consume
+ * input bytes, including its tabwriter escape byte, so this is not source replay.
+ *
+ * InputError identifies unrepresentable input; PrintError is an ordinary returned
+ * upstream error; PrintPanicError retains an upstream operation panic. No partial
+ * output or arbitrary writer lifecycle is exposed. Full tree reconstruction and
+ * collected output require memory proportional to the values involved; extreme
+ * indentation or tree size is not made resource-safe by panic adaptation.
+ * @public
+ */
+export function printSync(node, options = {}) {
+    validatePrintOptions(options);
+    if (!isSyntaxNode(node)) {
+        throw new InputError('Expected a complete, acyclic upstream Node record');
+    }
+    const payload = new TextEncoder().encode(encodeWire(node));
+    const result = decodeWire(callSyntax('print', payload, encodeWire(options)));
+    if (!isRecord(result)) {
+        throw new ShInternalError('The syntax printer returned a non-record response');
+    }
+    if (result.Error !== undefined) {
+        const error = result.Error;
+        if (!isRecord(error) || !isGoString(error.Message)) {
+            throw new ShInternalError('The syntax printer returned a malformed error');
+        }
+        switch (error.Kind) {
+            case 'PrintError':
+                throw new PrintError(error.Message);
+            case 'PrintPanicError':
+                throw new PrintPanicError(error.Message);
+            case 'InputError':
+                throw new InputError(error.Message);
+            case 'InternalError':
+                throw new ShInternalError(typeof error.Message === 'string'
+                    ? error.Message
+                    : new TextDecoder().decode(error.Message));
+            default:
+                throw new ShInternalError('The syntax printer returned an unknown error kind');
+        }
+    }
+    if (!isGoString(result.Output)) {
+        throw new ShInternalError('The syntax printer returned an invalid output value');
+    }
+    return result.Output;
+}
+/** Validates exact option domains without imposing a formatting or indentation policy. */
+function validatePrintOptions(options) {
+    if (!isRecord(options)) {
+        throw new InputError('Printer options must be a data record');
+    }
+    const flags = new Set([
+        'BinaryNextLine',
+        'SwitchCaseIndent',
+        'SpaceRedirects',
+        'KeepPadding',
+        'Minify',
+        'SingleLine',
+        'FunctionNextLine',
+    ]);
+    for (const [name, value] of Object.entries(options)) {
+        if (name === 'Indent') {
+            const valid = typeof value === 'bigint'
+                ? value >= 0n && value <= 0xffffffffffffffffn
+                : typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
+            if (!valid) {
+                throw new InputError('Indent must be a safe nonnegative integer or uint64 bigint');
+            }
+        }
+        else if (!flags.has(name)) {
+            throw new InputError(`Unknown printer option: ${name}`);
+        }
+        else if (typeof value !== 'boolean') {
+            throw new InputError(`${name} must be boolean`);
+        }
+    }
+}
+//# sourceMappingURL=syntax-print.js.map

package/dist/syntax-print.js.map

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

package/dist/syntax-snapshot.d.ts

@@ -0,0 +1,47 @@
+import type { File, Node, SyntaxPos } from '../generated/syntax-types.js';
+/**
+ * A node's upstream bounds as observed during parsing. These values refer to the
+ * original source, even when the corresponding syntax record is later edited.
+ * @public
+ */
+export interface NodePositions {
+    /** Starting byte position observed for the original parsed node. */
+    readonly Pos: Readonly<SyntaxPos>;
+    /** Exclusive ending byte position observed for the original parsed node. */
+    readonly End: Readonly<SyntaxPos>;
+}
+/**
+ * Identity-based lookup of the original parse's bounds. A new or copied node has
+ * no observation. The index never calls WASM or recalculates edited node bounds.
+ * @public
+ */
+export interface PositionSnapshot {
+    /**
+     * Returns the captured pair for a node from this parse, or undefined for a
+     * foreign node. If either upstream observation failed, throws the captured
+     * InputError without changing the successfully parsed File. Use nodePos or
+     * nodeEnd to request a live, independent bound from current edited fields.
+     */
+    get(node: Node): NodePositions | undefined;
+}
+/**
+ * Mutable upstream syntax together with a separate source-bound position view.
+ * Editing File never updates Positions; source consumers can retain original
+ * spans while transformations query live nodePos/nodeEnd as needed.
+ * @public
+ */
+export interface ParsedFile {
+    /** The complete mutable upstream File; no bounds or consumer fields are added. */
+    readonly File: File;
+    /** Immutable original observations, keyed by this File's node identities. */
+    readonly Positions: PositionSnapshot;
+}
+/**
+ * Validates complete sidecar coverage once, then stores immutable observations in
+ * a weak identity map. Missing or duplicate metadata is a transport defect; no
+ * per-node live-position fallback may disguise it or multiply WASM transfers.
+ * The File must already have passed the full syntax boundary validator.
+ * @internal
+ */
+export declare function createPositionSnapshot(file: File, raw: unknown): PositionSnapshot;
+//# sourceMappingURL=syntax-snapshot.d.ts.map

package/dist/syntax-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-snapshot.d.ts","sourceRoot":"","sources":["../src/syntax-snapshot.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,IAAI,EAAY,IAAI,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAKpF;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,GAAG,SAAS,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;CACtC;AAgED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAmDjF"}

package/dist/syntax-snapshot.js

@@ -0,0 +1,121 @@
+/**
+ * Correlates parse-time upstream position observations with the decoded syntax
+ * records. Snapshots belong to one parse and never track later edits; live
+ * nodePos/nodeEnd remain a separate responsibility. No traversal order or
+ * visitor-control protocol is exposed by this lookup-only view.
+ */
+import { SYNTAX_INTERFACES, SYNTAX_SCHEMA } from '../generated/syntax-schema.js';
+import { ShInternalError } from './errors.js';
+import { InputError } from './syntax-errors.js';
+import { isGoString, isRecord, isSyntaxPos } from './syntax-wire.js';
+/**
+ * Checks only node identity within an already fully validated File. Revalidating
+ * each subtree here would reintroduce work proportional to all descendant sizes.
+ */
+function isNodeIdentity(value) {
+    return ((typeof value.Type === 'string' && SYNTAX_INTERFACES.Node.includes(value.Type)) ||
+        (value.Type === 'TypedNil' &&
+            typeof value.Kind === 'string' &&
+            SYNTAX_INTERFACES.Node.includes(value.Kind)));
+}
+/**
+ * Indexes child-bearing fields once, including paths through auxiliary records.
+ * Metadata order is irrelevant: paths correlate observations without inventing a
+ * Walk order or equating auxiliary records with syntax.Node values.
+ */
+function nodesByPath(file) {
+    const nodes = new Map();
+    const visit = (value, path) => {
+        if (!isRecord(value) || typeof value.Type !== 'string')
+            return;
+        if (isNodeIdentity(value))
+            nodes.set(JSON.stringify(path), value);
+        if (!Object.hasOwn(SYNTAX_SCHEMA, value.Type))
+            return;
+        for (const [name, field] of Object.entries(SYNTAX_SCHEMA[value.Type].fields)) {
+            if (field.kind !== 'struct' && field.kind !== 'interface')
+                continue;
+            const child = value[name];
+            if (Array.isArray(child)) {
+                child.forEach((item, index) => {
+                    visit(item, [...path, name, index]);
+                });
+            }
+            else {
+                visit(child, [...path, name]);
+            }
+        }
+    };
+    visit(file, []);
+    return nodes;
+}
+/** Accepts the exact field/index domain used by the upstream observation sidecar. */
+function isPath(value) {
+    return (Array.isArray(value) &&
+        value.every((component) => typeof component === 'string' ||
+            (typeof component === 'number' && Number.isSafeInteger(component) && component >= 0)));
+}
+/** An upstream method produced exactly one position or one preserved failure. */
+function isObservation(position, error) {
+    return (isSyntaxPos(position) && error === null) || (position === null && isGoString(error));
+}
+/**
+ * Validates complete sidecar coverage once, then stores immutable observations in
+ * a weak identity map. Missing or duplicate metadata is a transport defect; no
+ * per-node live-position fallback may disguise it or multiply WASM transfers.
+ * The File must already have passed the full syntax boundary validator.
+ * @internal
+ */
+export function createPositionSnapshot(file, raw) {
+    const nodes = nodesByPath(file);
+    if (!Array.isArray(raw) || raw.length !== nodes.size)
+        throw new ShInternalError('The syntax snapshot does not cover every parsed node');
+    const observations = new WeakMap();
+    const remaining = new Map(nodes);
+    for (const entry of raw) {
+        if (!isRecord(entry) ||
+            Object.keys(entry).length !== 5 ||
+            !isPath(entry.Path) ||
+            !isObservation(entry.Pos, entry.PosError) ||
+            !isObservation(entry.End, entry.EndError)) {
+            throw new ShInternalError('The syntax snapshot contains an invalid position observation');
+        }
+        const path = JSON.stringify(entry.Path);
+        const node = remaining.get(path);
+        if (node === undefined)
+            throw new ShInternalError('The syntax snapshot contains an unknown or duplicate node path');
+        remaining.delete(path);
+        if (isGoString(entry.PosError)) {
+            observations.set(node, { error: entry.PosError });
+        }
+        else if (isGoString(entry.EndError)) {
+            observations.set(node, { error: entry.EndError });
+        }
+        else if (isSyntaxPos(entry.Pos) && isSyntaxPos(entry.End)) {
+            observations.set(node, {
+                positions: Object.freeze({
+                    Pos: Object.freeze({ ...entry.Pos }),
+                    End: Object.freeze({ ...entry.End }),
+                }),
+            });
+        }
+        else {
+            throw new ShInternalError('The syntax snapshot dropped an upstream method outcome');
+        }
+    }
+    if (remaining.size !== 0)
+        throw new ShInternalError('The syntax snapshot omitted parsed node observations');
+    return Object.freeze({
+        get(node) {
+            const observation = observations.get(node);
+            if (observation === undefined)
+                return undefined;
+            if ('error' in observation) {
+                // An exception may be edited by its catcher; retain the captured bytes.
+                throw new InputError(typeof observation.error === 'string' ? observation.error : observation.error.slice());
+            }
+            return observation.positions;
+        },
+    });
+}
+//# sourceMappingURL=syntax-snapshot.js.map

package/dist/syntax-snapshot.js.map

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

package/dist/syntax-walk-bounds.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Private live boundary evaluation for Walk's comment placement. These methods
+ * mirror the pinned mvdan/sh node methods so callback edits are visible without
+ * repeatedly serializing subtrees to WASM. They are not public position APIs.
+ *
+ * Adapted from mvdan.cc/sh/v3 v3.13.1 syntax/nodes.go, copyright Daniel Martí.
+ * The upstream BSD license is retained in syntax-walk-license.ts.
+ */
+import type { Node, SyntaxPos } from '../generated/syntax-types.js';
+/** Stmt comments at or after the live end become the single deferred comment. @internal */
+export declare function atStatementEnd(node: Extract<Node, {
+    Type: 'Stmt';
+}>, hash: SyntaxPos): boolean;
+/** Case/array comments strictly after the live start become deferred. @internal */
+export declare function afterItemStart(node: Extract<Node, {
+    Type: 'CaseItem' | 'ArrayElem';
+}>, hash: SyntaxPos): boolean;
+//# sourceMappingURL=syntax-walk-bounds.d.ts.map

package/dist/syntax-walk-bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-walk-bounds.d.ts","sourceRoot":"","sources":["../src/syntax-walk-bounds.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AA6LpE,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAE9F;AACD,mFAAmF;AACnF,wBAAgB,cAAc,CAC5B,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,UAAU,GAAG,WAAW,CAAA;CAAE,CAAC,EACvD,IAAI,EAAE,SAAS,GACd,OAAO,CAET"}