sh-ast 0.4.0 → 0.6.0

package/dist/syntax-walk-bounds.js

@@ -0,0 +1,188 @@
+import { nilDereference, WalkPanicError } from './syntax-walk-errors.js';
+/** Largest upstream source offset; the remaining high values are invalid sentinels. */
+const OFFSET_MAX = 0xffff_fff4;
+/** Ordinary zero Pos, distinct from a recovered token. */
+const ZERO = { offset: 0, lineCol: 0 };
+/** Serialized invalid offsets share all ordering behavior relevant to Walk. */
+function unpack(pos) {
+    return {
+        offset: pos.OffsetOverflow ? OFFSET_MAX + 1 : pos.Offset,
+        lineCol: ((pos.Line << 14) | pos.Col) >>> 0,
+    };
+}
+/** Upstream validity depends on both packed coordinates and raw offset. */
+function valid(pos) {
+    return pos.offset <= OFFSET_MAX && pos.lineCol !== 0;
+}
+/** Position arithmetic stops on invalid input and otherwise wraps both uint32 words. */
+function add(pos, n) {
+    return valid(pos) ? { offset: (pos.offset + n) >>> 0, lineCol: (pos.lineCol + n) >>> 0 } : pos;
+}
+/** Only the left operand must be valid; a right ordinary-invalid offset still orders. */
+function after(left, right) {
+    return valid(left) && left.offset > right.offset;
+}
+/** Upstream retains the first position unless the second is observably after it. */
+function maximum(left, right) {
+    return after(right, left) ? right : left;
+}
+/** A nil list and an empty list share indexed-access panic behavior. */
+function at(values, index) {
+    const length = values?.length ?? 0;
+    if (values === null || index < 0 || index >= length) {
+        throw new WalkPanicError(index < 0
+            ? `runtime error: index out of range [${String(index)}]`
+            : `runtime error: index out of range [${String(index)}] with length ${String(length)}`);
+    }
+    return values[index];
+}
+/** Nil pointers and nil interfaces both fail when a bound method dereferences them. */
+function concrete(node) {
+    if (node === null || node.Type === 'TypedNil') {
+        return nilDereference();
+    }
+    return node;
+}
+/** Only WordPart/ArithmExpr positions are reachable from comment placement. */
+function position(value) {
+    const node = concrete(value);
+    switch (node.Type) {
+        case 'CaseItem':
+            return position(at(node.Patterns, 0));
+        case 'ArrayElem':
+            return position(node.Index ?? node.Value);
+        case 'Word':
+            return position(at(node.Parts, 0));
+        case 'Lit':
+            return unpack(node.ValuePos);
+        case 'SglQuoted':
+        case 'DblQuoted':
+        case 'CmdSubst':
+        case 'ArithmExp':
+            return unpack(node.Left);
+        case 'ParamExp':
+            return node.Dollar.IsValid ? unpack(node.Dollar) : position(node.Param);
+        case 'ProcSubst':
+        case 'ExtGlob':
+            return unpack(node.OpPos);
+        case 'BraceExp':
+            return add(position(at(node.Elems, 0)), -1);
+        case 'BinaryArithm':
+            return position(node.X);
+        case 'UnaryArithm':
+            return node.Post ? position(node.X) : unpack(node.OpPos);
+        case 'ParenArithm':
+            return unpack(node.Lparen);
+        case 'FlagsArithm':
+            return add(position(node.Flags), -1);
+        default:
+            throw new WalkPanicError(`syntax.Walk: unexpected position dependency *syntax.${node.Type}`);
+    }
+}
+/** End follows the current fields, and is evaluated only when a Stmt has comments. */
+function end(value) {
+    const node = concrete(value);
+    switch (node.Type) {
+        case 'Stmt': {
+            if (node.Semicolon.IsValid) {
+                const end = add(unpack(node.Semicolon), 1);
+                return node.Coprocess || node.Disown ? add(end, 1) : end;
+            }
+            let result = node.Negated ? add(unpack(node.Position), 1) : unpack(node.Position);
+            if (node.Cmd !== null) {
+                result = end(node.Cmd);
+            }
+            if (node.Redirs?.length) {
+                result = maximum(result, end(at(node.Redirs, node.Redirs.length - 1)));
+            }
+            return result;
+        }
+        case 'CallExpr':
+            return node.Args?.length
+                ? end(at(node.Args, node.Args.length - 1))
+                : end(at(node.Assigns, (node.Assigns?.length ?? 0) - 1));
+        case 'Assign':
+            if (node.Value !== null) {
+                return end(node.Value);
+            }
+            if (node.Array !== null) {
+                return end(node.Array);
+            }
+            if (node.Index !== null) {
+                return add(end(node.Index), 2);
+            }
+            return node.Naked ? end(node.Name) : add(end(node.Name), 1);
+        case 'Redirect':
+            return end(node.Hdoc ?? node.Word);
+        case 'Subshell':
+        case 'ArrayExpr':
+        case 'ProcSubst':
+        case 'ParenArithm':
+        case 'ParenTest':
+            return add(unpack(node.Rparen), 1);
+        case 'Block':
+            return add(unpack(node.Rbrace), 1);
+        case 'IfClause':
+            return add(unpack(node.FiPos), 2);
+        case 'WhileClause':
+        case 'ForClause':
+            return add(unpack(node.DonePos), 4);
+        case 'BinaryCmd':
+        case 'BinaryArithm':
+        case 'BinaryTest':
+            return end(node.Y);
+        case 'FuncDecl':
+        case 'TestDecl':
+            return end(node.Body);
+        case 'Word':
+            return end(at(node.Parts, (node.Parts?.length ?? 0) - 1));
+        case 'Lit':
+            return unpack(node.ValueEnd);
+        case 'SglQuoted':
+        case 'DblQuoted':
+        case 'CmdSubst':
+            return add(unpack(node.Right), 1);
+        case 'ParamExp':
+            return !node.Short
+                ? add(unpack(node.Rbrace), 1)
+                : node.Index !== null
+                    ? add(end(node.Index), 1)
+                    : end(node.Param);
+        case 'ArithmExp':
+            return add(unpack(node.Right), node.Bracket ? 1 : 2);
+        case 'ArithmCmd':
+        case 'TestClause':
+            return add(unpack(node.Right), 2);
+        case 'UnaryArithm':
+            return node.Post ? add(unpack(node.OpPos), 2) : end(node.X);
+        case 'UnaryTest':
+            return end(node.X);
+        case 'FlagsArithm':
+            return node.X !== null ? end(node.X) : add(end(node.Flags), 1);
+        case 'CaseClause':
+            return add(unpack(node.Esac), 4);
+        case 'DeclClause':
+            return node.Args?.length ? end(at(node.Args, node.Args.length - 1)) : end(node.Variant);
+        case 'ExtGlob':
+            return add(end(node.Pattern), 1);
+        case 'TimeClause':
+            return node.Stmt === null ? add(unpack(node.Time), 4) : end(node.Stmt);
+        case 'CoprocClause':
+            return end(node.Stmt);
+        case 'LetClause':
+            return end(at(node.Exprs, (node.Exprs?.length ?? 0) - 1));
+        case 'BraceExp':
+            return add(node.Elems?.length ? end(at(node.Elems, node.Elems.length - 1)) : ZERO, 1);
+        default:
+            throw new WalkPanicError(`syntax.Walk: unexpected end dependency *syntax.${node.Type}`);
+    }
+}
+/** Stmt comments at or after the live end become the single deferred comment. @internal */
+export function atStatementEnd(node, hash) {
+    return !after(end(node), unpack(hash));
+}
+/** Case/array comments strictly after the live start become deferred. @internal */
+export function afterItemStart(node, hash) {
+    return after(unpack(hash), position(node));
+}
+//# sourceMappingURL=syntax-walk-bounds.js.map

package/dist/syntax-walk-bounds.js.map

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

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

@@ -0,0 +1,19 @@
+/** Walk-specific panic adaptation keeps upstream failures distinct from caller exceptions. */
+import type { GoString } from '../generated/syntax-types.js';
+import { ShAstError } from './errors.js';
+/**
+ * A panic raised by upstream-equivalent traversal, such as a nil dereference or
+ * unsupported concrete node. Exceptions thrown by callbacks are never wrapped.
+ * @public
+ */
+export declare class WalkPanicError extends ShAstError {
+    /** Stable discriminator for traversal panics. @public */
+    readonly code = "SH_AST_WALK_PANIC";
+    /** Exact upstream panic bytes; Error.message is only a display rendering. @public */
+    readonly Message: GoString;
+    /** Retains the upstream panic text separately from its display rendering. @public */
+    constructor(message: GoString);
+}
+/** A concrete pointer dereference failed at the point upstream would access it. @internal */
+export declare function nilDereference(): never;
+//# sourceMappingURL=syntax-walk-errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-walk-errors.d.ts","sourceRoot":"","sources":["../src/syntax-walk-errors.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C,yDAAyD;IACzD,QAAQ,CAAC,IAAI,uBAAuB;IAEpC,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAE3B,qFAAqF;gBACzE,OAAO,EAAE,QAAQ;CAK9B;AAED,6FAA6F;AAC7F,wBAAgB,cAAc,IAAI,KAAK,CAEtC"}

package/dist/syntax-walk-errors.js

@@ -0,0 +1,23 @@
+import { ShAstError } from './errors.js';
+/**
+ * A panic raised by upstream-equivalent traversal, such as a nil dereference or
+ * unsupported concrete node. Exceptions thrown by callbacks are never wrapped.
+ * @public
+ */
+export class WalkPanicError extends ShAstError {
+    /** Stable discriminator for traversal panics. @public */
+    code = 'SH_AST_WALK_PANIC';
+    /** Exact upstream panic bytes; Error.message is only a display rendering. @public */
+    Message;
+    /** Retains the upstream panic text separately from its display rendering. @public */
+    constructor(message) {
+        super(typeof message === 'string' ? message : new TextDecoder().decode(message));
+        this.Message = message;
+        this.name = 'WalkPanicError';
+    }
+}
+/** A concrete pointer dereference failed at the point upstream would access it. @internal */
+export function nilDereference() {
+    throw new WalkPanicError('runtime error: invalid memory address or nil pointer dereference');
+}
+//# sourceMappingURL=syntax-walk-errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-walk-errors.js","sourceRoot":"","sources":["../src/syntax-walk-errors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,yDAAyD;IAChD,IAAI,GAAG,mBAAmB,CAAC;IAEpC,qFAAqF;IAC5E,OAAO,CAAW;IAE3B,qFAAqF;IACrF,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,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,6FAA6F;AAC7F,MAAM,UAAU,cAAc;IAC5B,MAAM,IAAI,cAAc,CAAC,kEAAkE,CAAC,CAAC;AAC/F,CAAC"}

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

@@ -0,0 +1,3 @@
+/** Upstream license for the walk dispatcher and private boundary evaluator. */
+export {};
+//# sourceMappingURL=syntax-walk-license.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-walk-license.d.ts","sourceRoot":"","sources":["../src/syntax-walk-license.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAmC/E,OAAO,EAAE,CAAC"}

package/dist/syntax-walk-license.js

@@ -0,0 +1,37 @@
+/** Upstream license for the walk dispatcher and private boundary evaluator. */
+/*
+The walk dispatcher and private bounds evaluator adapt code from
+mvdan.cc/sh/v3/syntax (walk.go and nodes.go)
+(https://github.com/mvdan/sh), which is distributed under the following
+license:
+
+Copyright (c) 2016, Daniel Martí. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+   * Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+   * Redistributions in binary form must reproduce the above
+copyright notice, this list of conditions and the following disclaimer
+in the documentation and/or other materials provided with the
+distribution.
+   * Neither the name of the copyright holder nor the names of its
+contributors may be used to endorse or promote products derived from
+this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+export {};
+//# sourceMappingURL=syntax-walk-license.js.map

package/dist/syntax-walk-license.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-walk-license.js","sourceRoot":"","sources":["../src/syntax-walk-license.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCE;AACF,OAAO,EAAE,CAAC"}

package/dist/syntax-walk.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Synchronous live dispatch of mvdan/sh's Walk case ordering. Child reads
+ * occur when upstream reaches them; no precomputed trace or subtree transfer can
+ * hide callback edits. Ordinary JavaScript arrays retain their own object identity;
+ * distinct Go slice headers, capacity and value-slot addresses over shared backing
+ * storage are not represented. Ordinary JavaScript aliases remain shared.
+ * Positional work is limited to live comment placement.
+ *
+ * Adapted from mvdan.cc/sh/v3 v3.13.1 syntax/walk.go, copyright Daniel Martí.
+ * The upstream BSD license is retained in syntax-walk-license.ts.
+ */
+import type { Node } from '../generated/syntax-types.js';
+export { WalkPanicError } from './syntax-walk-errors.js';
+/**
+ * Walks synchronously using the pinned upstream case ordering. Each accepted entry is followed by its
+ * children and a null exit. Returning false prunes the entry without an exit;
+ * boolean exit return values are ignored. Every callback must return a boolean
+ * synchronously; other results produce InputError. Callback exceptions retain their identity,
+ * and upstream deferred comment callbacks still run during exception unwinding.
+ *
+ * Children and later fields are read live. Each list captures its array reference
+ * and length when traversal reaches that list, then reads existing later slots
+ * when reached. Replacing or reordering later slots is observed and can cause
+ * a node to be skipped or revisited. Indices added beyond the captured extent
+ * are not visited by that active list. Replacing the owner's array field does not
+ * redirect an active list, but a later walk or print sees the current field.
+ * Changes made before a list is reached are observed when it starts.
+ *
+ * Supported edits preserve each node's Type (and TypedNil.Kind), required field
+ * shapes and every index within each active list's captured extent. Leaving
+ * holes or shrinking an array below that extent (for example through truncation,
+ * deletion, or length-reducing splice/shift) is outside the mutation contract.
+ * These are not runtime validation rules. Ordinary JavaScript object and array
+ * aliases remain shared; the binding does not model distinct Go slice headers or
+ * capacity-dependent allocation over shared backing storage.
+ *
+ * Comments on Stmt, CaseItem and ArrayElem are copied before their callbacks,
+ * including position and byte-string values; editing a copy does not edit the
+ * stored comment. Last/CondLast/ThenLast/DoLast callbacks receive the stored
+ * JavaScript Comment object. Replacing its array slot leaves any previously
+ * retained callback object unchanged: there is no Go value-slot pointer identity.
+ * Reentrant walks maintain independent traversal state.
+ * @public
+ */
+export declare function walk(node: Node, callback: (node: Node | null) => boolean): void;
+//# sourceMappingURL=syntax-walk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-walk.d.ts","sourceRoot":"","sources":["../src/syntax-walk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAIlE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAOzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,OAAO,GAAG,IAAI,CAE/E"}