sh-ast 0.3.1 → 0.4.0

package/dist/analyze/enumerate-commands.js

@@ -1,23 +1,11 @@
+/** Enumerates invocations on caller-owned faithful records while retaining syntactic contexts. */
+import { AndStmt, OrStmt, Pipe, PipeAll } from '../../generated/syntax-constants.js';
+import { nodePos } from '../syntax.js';
 import { ShAnalyzeMaxDepthError } from '../errors.js';
-import { isShNodeShape, nodeArray, stringField } from './node-helpers.js';
+import { isSyntaxNode, nodeArray } from './node-helpers.js';
 import { resolveWord } from './resolve-word.js';
-/**
- * mvdan/sh v3.13.1's `syntax.BinCmdOperator` token values for `BinaryCmd.Op`
- * — `AndStmt` (`&&`), `OrStmt` (`||`), `Pipe` (`|`), `PipeAll` (`|&`). These
- * are not part of any documented wire contract (`normalize()` copies
- * mvdan/sh's raw numeric token straight through — see design/ARCHITECTURE.md
- * open question 4), so they're pinned here by empirical observation against
- * this bridge's own shim rather than derived from an upstream constant, and
- * locked in by a canary test (`enumerate-commands.test.ts`, "binary command
- * operator identification") that would fail loudly if a future mvdan/sh
- * version renumbered them.
- */
-const BIN_CMD_OP_AND = 11;
-const BIN_CMD_OP_OR = 12;
-const BIN_CMD_OP_PIPE = 13;
-const BIN_CMD_OP_PIPE_ALL = 14;
 function isPipeOp(op) {
-    return op === BIN_CMD_OP_PIPE || op === BIN_CMD_OP_PIPE_ALL;
+    return op === Pipe || op === PipeAll;
 }
 /**
  * The maximum number of *genuinely nested* structural frames (subshells,
@@ -80,14 +68,14 @@ function scanForHiddenCommands(value, context, sites, depth) {
             scanForHiddenCommands(item, context, sites, depth);
         return;
     }
-    if (!isShNodeShape(value))
+    if (typeof value !== 'object' || value === null || value instanceof Uint8Array)
         return;
-    if (value.type === 'CmdSubst') {
-        visitStmtList(nodeArray(value.stmts), pushContext(context, { kind: 'cmdSubst' }), sites, depth + 1);
+    if (isSyntaxNode(value) && value.Type === 'CmdSubst') {
+        visitStmtList(nodeArray(value.Stmts), pushContext(context, { kind: 'cmdSubst' }), sites, depth + 1);
         return;
     }
-    if (value.type === 'ProcSubst') {
-        visitStmtList(nodeArray(value.stmts), pushContext(context, { kind: 'procSubst' }), sites, depth + 1);
+    if (isSyntaxNode(value) && value.Type === 'ProcSubst') {
+        visitStmtList(nodeArray(value.Stmts), pushContext(context, { kind: 'procSubst' }), sites, depth + 1);
         return;
     }
     for (const field of Object.values(value)) {
@@ -111,13 +99,13 @@ function visitStmt(stmt, context, sites, depth) {
         throw new ShAnalyzeMaxDepthError(MAX_STRUCTURAL_DEPTH);
     }
     let stmtContext = context;
-    if (stmt.negated === true)
+    if (stmt.Negated)
         stmtContext = pushContext(stmtContext, { kind: 'negated' });
-    if (stmt.background === true)
+    if (stmt.Background)
         stmtContext = pushContext(stmtContext, { kind: 'background' });
-    scanForHiddenCommands(stmt.redirs, stmtContext, sites, depth);
-    const cmd = stmt.cmd;
-    if (isShNodeShape(cmd))
+    scanForHiddenCommands(stmt.Redirs, stmtContext, sites, depth);
+    const cmd = stmt.Cmd;
+    if (isSyntaxNode(cmd))
         visitCommand(cmd, stmtContext, sites, depth);
 }
 /**
@@ -140,16 +128,16 @@ function visitStmt(stmt, context, sites, depth) {
  */
 function flattenPipelineStages(cmd) {
     const stages = [];
-    const workStack = [cmd.y, cmd.x];
+    const workStack = [cmd.Y, cmd.X];
     while (workStack.length > 0) {
         const operandStmt = workStack.pop();
-        if (!isShNodeShape(operandStmt))
+        if (!isSyntaxNode(operandStmt))
             continue;
-        const innerCmd = operandStmt.cmd;
-        if (isShNodeShape(innerCmd) && innerCmd.type === 'BinaryCmd' && isPipeOp(innerCmd.op)) {
+        const innerCmd = operandStmt.Cmd;
+        if (isSyntaxNode(innerCmd) && innerCmd.Type === 'BinaryCmd' && isPipeOp(innerCmd.Op)) {
             // Push `y` then `x` so `x` — the side that keeps the chain going in
             // the left-associative case — is popped (processed) first.
-            workStack.push(innerCmd.y, innerCmd.x);
+            workStack.push(innerCmd.Y, innerCmd.X);
         }
         else {
             stages.push(operandStmt);
@@ -184,7 +172,7 @@ function flattenPipelineStages(cmd) {
  * treatment, for the same reason).
  */
 function visitBinaryCmd(cmd, context, sites, depth) {
-    const op = cmd.op;
+    const op = cmd.Op;
     if (isPipeOp(op)) {
         const stages = flattenPipelineStages(cmd);
         stages.forEach((stage, index) => {
@@ -195,27 +183,27 @@ function visitBinaryCmd(cmd, context, sites, depth) {
     const rightOperands = [];
     let spine = cmd;
     for (;;) {
-        const spineOp = spine.op;
-        const frame = spineOp === BIN_CMD_OP_AND
+        const spineOp = spine.Op;
+        const frame = spineOp === AndStmt
             ? { kind: 'and', side: 'right' }
-            : spineOp === BIN_CMD_OP_OR
+            : spineOp === OrStmt
                 ? { kind: 'or', side: 'right' }
                 : undefined;
-        const y = spine.y;
-        if (isShNodeShape(y))
+        const y = spine.Y;
+        if (isSyntaxNode(y))
             rightOperands.push({ stmt: y, frame });
-        const x = spine.x;
-        if (!isShNodeShape(x))
+        const x = spine.X;
+        if (!isSyntaxNode(x))
             break;
-        const innerCmd = x.cmd;
-        if (isShNodeShape(innerCmd) && innerCmd.type === 'BinaryCmd' && !isPipeOp(innerCmd.op)) {
+        const innerCmd = x.Cmd;
+        if (isSyntaxNode(innerCmd) && innerCmd.Type === 'BinaryCmd' && !isPipeOp(innerCmd.Op)) {
             spine = innerCmd;
             continue;
         }
         // `x` is the leftmost operand: not a further same-family BinaryCmd
         // link, so this is where the spine walk ends — visit it with the
         // *outer* (unmodified) context, exactly as the original recursive
-        // implementation visited `cmd.x`.
+        // implementation visited `cmd.X`.
         visitStmt(x, context, sites, depth + 1);
         break;
     }
@@ -224,10 +212,10 @@ function visitBinaryCmd(cmd, context, sites, depth) {
     }
 }
 function visitIfClause(clause, context, sites, depth) {
-    visitStmtList(nodeArray(clause.cond), pushContext(context, { kind: 'if', branch: 'cond' }), sites, depth);
-    visitStmtList(nodeArray(clause.then), pushContext(context, { kind: 'if', branch: 'then' }), sites, depth);
-    const elseClause = clause.else;
-    if (isShNodeShape(elseClause)) {
+    visitStmtList(nodeArray(clause.Cond), pushContext(context, { kind: 'if', branch: 'cond' }), sites, depth);
+    visitStmtList(nodeArray(clause.Then), pushContext(context, { kind: 'if', branch: 'then' }), sites, depth);
+    const elseClause = clause.Else;
+    if (isSyntaxNode(elseClause)) {
         // A chained `elif` — mvdan/sh models it as `IfClause.Else` pointing to
         // another `IfClause` — is one more genuine level of nesting than
         // `cond`/`then` above, so it gets its own `depth + 1` (a long `elif`
@@ -238,13 +226,17 @@ function visitIfClause(clause, context, sites, depth) {
     }
 }
 function visitCommand(cmd, context, sites, depth) {
-    switch (cmd.type) {
+    switch (cmd.Type) {
         case 'CallExpr': {
-            scanForHiddenCommands(cmd.assigns, context, sites, depth);
-            scanForHiddenCommands(cmd.args, context, sites, depth);
-            const args = nodeArray(cmd.args);
+            scanForHiddenCommands(cmd.Assigns, context, sites, depth);
+            scanForHiddenCommands(cmd.Args, context, sites, depth);
+            // Argument positions carry command-line meaning. A nil pointer is an
+            // unsupported argument, not permission to shift later words left.
+            const args = cmd.Args ?? [];
             if (args.length > 0) {
-                const argv = args.map((word) => resolveWord(word, { context: 'command-argument' }));
+                const argv = args.map((word) => word === null
+                    ? { static: false, reason: 'unsupported' }
+                    : resolveWord(word, { context: 'command-argument' }));
                 sites.push({ node: cmd, argv0: argv[0], argv, context });
             }
             return;
@@ -256,73 +248,73 @@ function visitCommand(cmd, context, sites, depth) {
             // Transparent grouping (`{ ...; }`) — no context frame, but still one
             // genuine level of structural nesting for depth-guard purposes (a
             // pathological `{ { { ... } } }` chain must still trip the guard).
-            visitStmtList(nodeArray(cmd.stmts), context, sites, depth + 1);
+            visitStmtList(nodeArray(cmd.Stmts), context, sites, depth + 1);
             return;
         case 'Subshell':
-            visitStmtList(nodeArray(cmd.stmts), pushContext(context, { kind: 'subshell' }), sites, depth + 1);
+            visitStmtList(nodeArray(cmd.Stmts), pushContext(context, { kind: 'subshell' }), sites, depth + 1);
             return;
         case 'IfClause':
             visitIfClause(cmd, context, sites, depth + 1);
             return;
         case 'CaseClause': {
-            scanForHiddenCommands(cmd.word, context, sites, depth);
-            for (const item of nodeArray(cmd.items)) {
-                scanForHiddenCommands(item.patterns, context, sites, depth);
-                visitStmtList(nodeArray(item.stmts), pushContext(context, { kind: 'case' }), sites, depth + 1);
+            scanForHiddenCommands(cmd.Word, context, sites, depth);
+            for (const item of nodeArray(cmd.Items)) {
+                scanForHiddenCommands(item.Patterns, context, sites, depth);
+                visitStmtList(nodeArray(item.Stmts), pushContext(context, { kind: 'case' }), sites, depth + 1);
             }
             return;
         }
         case 'ForClause': {
-            scanForHiddenCommands(cmd.loop, context, sites, depth);
-            visitStmtList(nodeArray(cmd.do), pushContext(context, { kind: 'loop', role: 'body' }), sites, depth + 1);
+            scanForHiddenCommands(cmd.Loop, context, sites, depth);
+            visitStmtList(nodeArray(cmd.Do), pushContext(context, { kind: 'loop', role: 'body' }), sites, depth + 1);
             return;
         }
         case 'WhileClause': {
-            visitStmtList(nodeArray(cmd.cond), pushContext(context, { kind: 'loop', role: 'cond' }), sites, depth + 1);
-            visitStmtList(nodeArray(cmd.do), pushContext(context, { kind: 'loop', role: 'body' }), sites, depth + 1);
+            visitStmtList(nodeArray(cmd.Cond), pushContext(context, { kind: 'loop', role: 'cond' }), sites, depth + 1);
+            visitStmtList(nodeArray(cmd.Do), pushContext(context, { kind: 'loop', role: 'body' }), sites, depth + 1);
             return;
         }
         case 'FuncDecl': {
-            const nameNode = cmd.name;
-            const nameText = isShNodeShape(nameNode) ? stringField(nameNode, 'value') : '';
-            const body = cmd.body;
-            if (isShNodeShape(body)) {
+            const nameNode = cmd.Name;
+            const nameText = nameNode?.Value ?? '';
+            const body = cmd.Body;
+            if (isSyntaxNode(body)) {
                 visitStmt(body, pushContext(context, { kind: 'function', name: nameText }), sites, depth + 1);
             }
             return;
         }
         case 'CoprocClause': {
-            scanForHiddenCommands(cmd.name, context, sites, depth);
-            const stmt = cmd.stmt;
-            if (isShNodeShape(stmt)) {
+            scanForHiddenCommands(cmd.Name, context, sites, depth);
+            const stmt = cmd.Stmt;
+            if (isSyntaxNode(stmt)) {
                 visitStmt(stmt, pushContext(context, { kind: 'coproc' }), sites, depth + 1);
             }
             return;
         }
         case 'DeclClause':
-            scanForHiddenCommands(cmd.args, context, sites, depth);
+            scanForHiddenCommands(cmd.Args, context, sites, depth);
             return;
         case 'LetClause':
-            scanForHiddenCommands(cmd.exprs, context, sites, depth);
+            scanForHiddenCommands(cmd.Exprs, context, sites, depth);
             return;
         case 'TestClause':
-            scanForHiddenCommands(cmd.x, context, sites, depth);
+            scanForHiddenCommands(cmd.X, context, sites, depth);
             return;
         case 'ArithmCmd':
-            scanForHiddenCommands(cmd.x, context, sites, depth);
+            scanForHiddenCommands(cmd.X, context, sites, depth);
             return;
         case 'TestDecl': {
-            scanForHiddenCommands(cmd.description, context, sites, depth);
-            const body = cmd.body;
-            if (isShNodeShape(body))
+            scanForHiddenCommands(cmd.Description, context, sites, depth);
+            const body = cmd.Body;
+            if (isSyntaxNode(body))
                 visitStmt(body, context, sites, depth + 1);
             return;
         }
         case 'TimeClause': {
             // Transparent (`time cmd`) — no context frame, but still one genuine
             // level of structural nesting for depth-guard purposes.
-            const stmt = cmd.stmt;
-            if (isShNodeShape(stmt))
+            const stmt = cmd.Stmt;
+            if (isSyntaxNode(stmt))
                 visitStmt(stmt, context, sites, depth + 1);
             return;
         }
@@ -344,14 +336,14 @@ function visitCommand(cmd, context, sites, depth) {
  * `CmdSubst`/`ProcSubst` nested inside words, wherever those words occur
  * (arguments, redirection targets, case subjects/patterns, loop word
  * lists, assignment values, test/arithmetic operands, …), not only inside
- * `CallExpr.args`.
+ * `CallExpr.Args`.
  *
  * An assignment-only `CallExpr` (`FOO=bar`, `args` empty) has no first word
  * to resolve and is not itself a command invocation — no program runs — so
  * it produces no {@link CommandSite}; any command substitution nested in
  * its assigned value (`FOO=$(sub)`) is still found and reported.
  *
- * Results are sorted by source position (`node.range[0]`), so nested
+ * Results are sorted by source position (`nodePos(node).Offset`), so nested
  * command substitutions and out-of-structural-order redirection targets
  * still come back in source order regardless of traversal order.
  *
@@ -363,14 +355,9 @@ function visitCommand(cmd, context, sites, depth) {
  * traversed iteratively and never risks a stack overflow or trips the
  * nesting-depth guard below, regardless of how many stages/links it has.
  *
- * @param root - Any `ShNode` — typically a `File` from `parseSync`, but any
- * subtree (a `Stmt`, a `Command`, or even a bare `Word`) is handled. Note
- * `parseSync` itself already refuses (via its own `ShParseMaxDepthError`) any
- * input whose estimated nesting exceeds *its* limit before ever producing a
- * tree — see `parse-depth-guard.ts` — so a `root` sourced from `parseSync`
- * has already passed that earlier, lower-level line of defense; this
- * module's own guard below remains a second, independent backstop for
- * trees built or mutated some other way.
+ * @param root - Any `Node` — typically a `File` from `parseSync`, but any
+ * subtree (a `Stmt`, a `Command`, or even a bare `Word`) is handled.
+ * The depth guard also applies to caller-built or mutated trees.
  * @throws {@link ShAnalyzeMaxDepthError} if `root`'s genuinely nested
  * structure (subshells within subshells, chained command/process
  * substitutions, deeply nested `if`/`case`/loop/function/`time`/`{ }`
@@ -382,15 +369,18 @@ function visitCommand(cmd, context, sites, depth) {
  */
 export function enumerateCommands(root) {
     const sites = [];
-    if (root.type === 'File') {
-        visitStmtList(nodeArray(root.stmts), [], sites, 0);
+    if (root.Type === 'File') {
+        visitStmtList(nodeArray(root.Stmts), [], sites, 0);
     }
-    else if (root.type === 'Stmt') {
+    else if (root.Type === 'Stmt') {
         visitStmt(root, [], sites, 0);
     }
     else {
         visitCommand(root, [], sites, 0);
     }
-    return [...sites].sort((a, b) => a.node.range[0] - b.node.range[0]);
+    return sites
+        .map((site) => ({ site, offset: nodePos(site.node).Offset }))
+        .sort((a, b) => a.offset - b.offset)
+        .map(({ site }) => site);
 }
 //# sourceMappingURL=enumerate-commands.js.map

package/dist/analyze/enumerate-commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"enumerate-commands.js","sourceRoot":"","sources":["../../src/analyze/enumerate-commands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"enumerate-commands.js","sourceRoot":"","sources":["../../src/analyze/enumerate-commands.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAStD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAqGhD,SAAS,QAAQ,CAAC,EAAW;IAC3B,OAAO,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,OAAO,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,SAAS,WAAW,CAClB,OAAkC,EAClC,KAAqB;IAErB,OAAO,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAS,qBAAqB,CAC5B,KAAc,EACd,OAAkC,EAClC,KAAoB,EACpB,KAAa;IAEb,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7E,OAAO;IACT,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO;IACvF,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACrD,aAAa,CACX,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EACtB,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAC1C,KAAK,EACL,KAAK,GAAG,CAAC,CACV,CAAC;QACF,OAAO;IACT,CAAC;IACD,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACtD,aAAa,CACX,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EACtB,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAC3C,KAAK,EACL,KAAK,GAAG,CAAC,CACV,CAAC;QACF,OAAO;IACT,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACpB,KAAsB,EACtB,OAAkC,EAClC,KAAoB,EACpB,KAAa;IAEb,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,SAAS,CAChB,IAAU,EACV,OAAkC,EAClC,KAAoB,EACpB,KAAa;IAEb,IAAI,KAAK,GAAG,oBAAoB,EAAE,CAAC;QACjC,MAAM,IAAI,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,WAAW,GAAG,OAAO,CAAC;IAC1B,IAAI,IAAI,CAAC,OAAO;QAAE,WAAW,GAAG,WAAW,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9E,IAAI,IAAI,CAAC,UAAU;QAAE,WAAW,GAAG,WAAW,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IACpF,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACrB,IAAI,YAAY,CAAC,GAAG,CAAC;QAAE,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAS,qBAAqB,CAAC,GAAc;IAC3C,MAAM,MAAM,GAAW,EAAE,CAAC;IAC1B,MAAM,SAAS,GAAoB,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAClD,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC;QACpC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC;YAAE,SAAS;QACzC,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC;QACjC,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACrF,oEAAoE;YACpE,2DAA2D;YAC3D,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAS,cAAc,CACrB,GAAc,EACd,OAAkC,EAClC,KAAoB,EACpB,KAAa;IAEb,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;IAClB,IAAI,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC9B,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC/F,CAAC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAKD,MAAM,aAAa,GAAmB,EAAE,CAAC;IACzC,IAAI,KAAK,GAAc,GAAG,CAAC;IAC3B,SAAS,CAAC;QACR,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,GACT,OAAO,KAAK,OAAO;YACjB,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE;YAChC,CAAC,CAAC,OAAO,KAAK,MAAM;gBAClB,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE;gBAC/B,CAAC,CAAC,SAAS,CAAC;QAClB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;QAClB,IAAI,YAAY,CAAC,CAAC,CAAC;YAAE,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;YAAE,MAAM;QAC5B,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC;QACvB,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACtF,KAAK,GAAG,QAAQ,CAAC;YACjB,SAAS;QACX,CAAC;QACD,mEAAmE;QACnE,iEAAiE;QACjE,kEAAkE;QAClE,kCAAkC;QAClC,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACxC,MAAM;IACR,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,aAAa,EAAE,CAAC;QAC5C,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACpB,MAAgB,EAChB,OAAkC,EAClC,KAAoB,EACpB,KAAa;IAEb,aAAa,CACX,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EACtB,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EACpD,KAAK,EACL,KAAK,CACN,CAAC;IACF,aAAa,CACX,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EACtB,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EACpD,KAAK,EACL,KAAK,CACN,CAAC;IACF,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;IAC/B,IAAI,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,uEAAuE;QACvE,iEAAiE;QACjE,qEAAqE;QACrE,qEAAqE;QACrE,qEAAqE;QACrE,OAAO;QACP,aAAa,CACX,UAAU,EACV,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EACpD,KAAK,EACL,KAAK,GAAG,CAAC,CACV,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CACnB,GAAS,EACT,OAAkC,EAClC,KAAoB,EACpB,KAAa;IAEb,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,qBAAqB,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAC1D,qBAAqB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACvD,qEAAqE;YACrE,kEAAkE;YAClE,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAkB,EAAE,CAC7C,IAAI,KAAK,IAAI;oBACX,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE;oBAC1C,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CACvD,CAAC;gBACF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO;QACT,CAAC;QACD,KAAK,WAAW;YACd,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAC3C,OAAO;QACT,KAAK,OAAO;YACV,sEAAsE;YACtE,kEAAkE;YAClE,mEAAmE;YACnE,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAC/D,OAAO;QACT,KAAK,UAAU;YACb,aAAa,CACX,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EACpB,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAC1C,KAAK,EACL,KAAK,GAAG,CAAC,CACV,CAAC;YACF,OAAO;QACT,KAAK,UAAU;YACb,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAC9C,OAAO;QACT,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,qBAAqB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACvD,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxC,qBAAqB,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC5D,aAAa,CACX,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EACrB,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EACtC,KAAK,EACL,KAAK,GAAG,CAAC,CACV,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,qBAAqB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACvD,aAAa,CACX,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EACjB,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EACpD,KAAK,EACL,KAAK,GAAG,CAAC,CACV,CAAC;YACF,OAAO;QACT,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,aAAa,CACX,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EACnB,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EACpD,KAAK,EACL,KAAK,GAAG,CAAC,CACV,CAAC;YACF,aAAa,CACX,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EACjB,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EACpD,KAAK,EACL,KAAK,GAAG,CAAC,CACV,CAAC;YACF,OAAO;QACT,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC;YAC1B,MAAM,QAAQ,GAAG,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YACtB,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,SAAS,CACP,IAAI,EACJ,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAC1D,KAAK,EACL,KAAK,GAAG,CAAC,CACV,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,qBAAqB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACvD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YACtB,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAC9E,CAAC;YACD,OAAO;QACT,CAAC;QACD,KAAK,YAAY;YACf,qBAAqB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACvD,OAAO;QACT,KAAK,WAAW;YACd,qBAAqB,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACxD,OAAO;QACT,KAAK,YAAY;YACf,qBAAqB,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACpD,OAAO;QACT,KAAK,WAAW;YACd,qBAAqB,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACpD,OAAO;QACT,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,qBAAqB,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAC9D,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YACtB,IAAI,YAAY,CAAC,IAAI,CAAC;gBAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,qEAAqE;YACrE,wDAAwD;YACxD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YACtB,IAAI,YAAY,CAAC,IAAI,CAAC;gBAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QACD;YACE,qEAAqE;YACrE,qEAAqE;YACrE,sEAAsE;YACtE,iEAAiE;YACjE,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAU;IAC1C,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC;SAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAChC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;SAC5D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;SACnC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/analyze/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * `sh-ast/analyze` — the static-analysis layer built on top of the
- * normalized AST from the package root. Its first primitive,
+ * faithful upstream syntax records from the package root. Its first primitive,
  * {@link resolveWord}, answers "is this word statically a known string,
  * and if so which?" — the question every downstream lint rule or command
  * inventory asks first. Its second, {@link enumerateCommands}, answers
@@ -22,5 +22,6 @@ export type { CommandContext, CommandSite } from './enumerate-commands.js';
 export { DEFAULT_TRANSPARENT_WRAPPERS, resolveArgv0 } from './resolve-argv0.js';
 export type { Argv0ChainWord, Argv0Resolution, Argv0UnresolvedReason, Argv0UnresolvedWord, ResolveArgv0Options, WrapperSpec, } from './resolve-argv0.js';
 export { ShAnalyzeInvalidWrapperSpecError, ShAnalyzeMaxDepthError, ShAstError } from '../errors.js';
-export type { Position, ShNode } from '../types.js';
+export type * from '../../generated/syntax-types.js';
+export type { BinAritOperator, BinCmdOperator, BinTestOperator, CaseOperator, GlobOperator, OperatorFamily, ParExpOperator, ParNamesOperator, ProcOperator, RawOperator, RedirOperator, UnAritOperator, UnTestOperator, } from '../../generated/syntax-constants.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/analyze/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analyze/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAElG,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EAAE,4BAA4B,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAChF,YAAY,EACV,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAU5B,OAAO,EAAE,gCAAgC,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AASpG,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analyze/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAElG,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EAAE,4BAA4B,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAChF,YAAY,EACV,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAU5B,OAAO,EAAE,gCAAgC,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAIpG,mBAAmB,iCAAiC,CAAC;AACrD,YAAY,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,cAAc,EACd,cAAc,GACf,MAAM,qCAAqC,CAAC"}

package/dist/analyze/index.js

@@ -1,6 +1,6 @@
 /**
  * `sh-ast/analyze` — the static-analysis layer built on top of the
- * normalized AST from the package root. Its first primitive,
+ * faithful upstream syntax records from the package root. Its first primitive,
  * {@link resolveWord}, answers "is this word statically a known string,
  * and if so which?" — the question every downstream lint rule or command
  * inventory asks first. Its second, {@link enumerateCommands}, answers

package/dist/analyze/node-helpers.d.ts

@@ -1,28 +1,17 @@
-import type { ShNode } from '../types.js';
+import type { Node } from '../../generated/syntax-types.js';
 /**
- * True iff `value` has the minimal shape every normalized {@link ShNode}
- * carries (an object, not an array, with a string `type` field). Used to
- * narrow `unknown` field values discovered while walking a node's own
- * properties — every node field on {@link ShNode} is typed `unknown` (see
- * its index signature), so any code that inspects a specific field's value
- * needs this runtime check before treating it as a child node.
- *
+ * Recognizes concrete upstream syntax.Node records without confusing auxiliary
+ * records, typed nil interface tags, or token positions with records that have
+ * traversable fields. It does not validate complete trees.
  * @internal
  */
-export declare function isShNodeShape(value: unknown): value is ShNode;
+export declare function isSyntaxNode(value: unknown): value is Exclude<Node, {
+    Type: 'TypedNil';
+}>;
 /**
- * Filters `value` down to the {@link ShNode} elements of an array-shaped
- * field, discarding anything else — and returning `[]` for a non-array or
- * `undefined` field, so callers never need a separate `Array.isArray` guard.
- *
+ * Retains slice order and object identity while exposing present records to
+ * semantic traversal; nil slices and nil pointers contain no subtree to visit.
  * @internal
  */
-export declare function nodeArray(value: unknown): readonly ShNode[];
-/**
- * Reads `node[field]` as a string, defaulting to `''` for any other shape
- * (missing field, non-string value).
- *
- * @internal
- */
-export declare function stringField(node: ShNode, field: string): string;
+export declare function nodeArray<T>(value: readonly (T | null)[] | null): T[];
 //# sourceMappingURL=node-helpers.d.ts.map

package/dist/analyze/node-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-helpers.d.ts","sourceRoot":"","sources":["../../src/analyze/node-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAO7D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/D"}
+{"version":3,"file":"node-helpers.d.ts","sourceRoot":"","sources":["../../src/analyze/node-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,CAUzF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,GAAG,CAAC,EAAE,CAErE"}

package/dist/analyze/node-helpers.js

@@ -1,37 +1,26 @@
+/** Shared guards retain faithful node identity and omit only explicitly nil slice elements. */
+import { SYNTAX_SCHEMA } from '../../generated/syntax-schema.js';
 /**
- * True iff `value` has the minimal shape every normalized {@link ShNode}
- * carries (an object, not an array, with a string `type` field). Used to
- * narrow `unknown` field values discovered while walking a node's own
- * properties — every node field on {@link ShNode} is typed `unknown` (see
- * its index signature), so any code that inspects a specific field's value
- * needs this runtime check before treating it as a child node.
- *
+ * Recognizes concrete upstream syntax.Node records without confusing auxiliary
+ * records, typed nil interface tags, or token positions with records that have
+ * traversable fields. It does not validate complete trees.
  * @internal
  */
-export function isShNodeShape(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        !Array.isArray(value) &&
-        typeof value.type === 'string');
+export function isSyntaxNode(value) {
+    if (typeof value !== 'object' ||
+        value === null ||
+        !('Type' in value) ||
+        typeof value.Type !== 'string') {
+        return false;
+    }
+    return Object.hasOwn(SYNTAX_SCHEMA, value.Type) && SYNTAX_SCHEMA[value.Type].node;
 }
 /**
- * Filters `value` down to the {@link ShNode} elements of an array-shaped
- * field, discarding anything else — and returning `[]` for a non-array or
- * `undefined` field, so callers never need a separate `Array.isArray` guard.
- *
+ * Retains slice order and object identity while exposing present records to
+ * semantic traversal; nil slices and nil pointers contain no subtree to visit.
  * @internal
  */
 export function nodeArray(value) {
-    return Array.isArray(value) ? value.filter(isShNodeShape) : [];
-}
-/**
- * Reads `node[field]` as a string, defaulting to `''` for any other shape
- * (missing field, non-string value).
- *
- * @internal
- */
-export function stringField(node, field) {
-    const value = node[field];
-    return typeof value === 'string' ? value : '';
+    return value?.filter((node) => node !== null) ?? [];
 }
 //# sourceMappingURL=node-helpers.js.map

package/dist/analyze/node-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"node-helpers.js","sourceRoot":"","sources":["../../src/analyze/node-helpers.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ,CACvD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAAa;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC"}
+{"version":3,"file":"node-helpers.js","sourceRoot":"","sources":["../../src/analyze/node-helpers.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGjE;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;QAClB,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAC9B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;AACpF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAI,KAAmC;IAC9D,OAAO,KAAK,EAAE,MAAM,CAAC,CAAC,IAAI,EAAa,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;AACjE,CAAC"}

package/dist/analyze/resolve-argv0.d.ts

@@ -49,7 +49,7 @@ export interface WrapperSpec {
      * skipped — this is `env`'s and `sudo`'s own `VAR=val` *operand*
      * mechanism (setting variables in the wrapped command's environment),
      * which is a distinct, per-wrapper concept from the shell-level
-     * `CallExpr.assigns` prefixes {@link Argv0Resolution.assignmentsSkipped}
+     * `CallExpr.Assigns` prefixes {@link Argv0Resolution.assignmentsSkipped}
      * counts.
      */
     readonly skipAssignmentOperands?: boolean;
@@ -129,8 +129,8 @@ export interface WrapperSpec {
  *
  * Frozen (including each entry object and its own array/regexp fields) so
  * immutability of this shared, module-scoped table is a contract, not just
- * a convention any importer happens to honor — mirrors `visitorKeys`'s and
- * `CHILD_TYPE_SCHEMA`'s freezing in `visitor-keys.ts`/`normalize.ts`.
+ * a convention any importer happens to honor. Per-call wrapper options are
+ * separate values and cannot mutate these shared defaults.
  *
  * `xargs` is deliberately **excluded**: unlike every entry here, `xargs`
  * doesn't simply re-exec a single wrapped command word it can point to
@@ -265,11 +265,11 @@ export interface Argv0Resolution {
     readonly effective: Argv0ChainWord;
     /**
      * The number of `VAR=val` shell-assignment prefixes on the `CallExpr`
-     * itself (`CommandSite.node.assigns`, e.g. the `FOO=bar` in
+     * itself (`CommandSite.node.Assigns`, e.g. the `FOO=bar` in
      * `FOO=bar rm x`) that were skipped to reach argv0. This is a distinct
      * mechanism from a wrapper's own `VAR=val` *operands* (e.g. `env`'s or
      * `sudo`'s, see {@link WrapperSpec.skipAssignmentOperands}) — always
-     * exactly `CommandSite.node.assigns`'s length, independent of the
+     * exactly `CommandSite.node.Assigns`'s length, independent of the
      * wrapper chain found afterward.
      */
     readonly assignmentsSkipped: number;
@@ -314,7 +314,7 @@ export interface Argv0Resolution {
  *    (see {@link WrapperSpec.unresolvableFlags}'s doc comment).
  *
  * `VAR=val` shell-assignment prefixes on the `CallExpr` itself
- * (`CommandSite.node.assigns`, e.g. `FOO=bar rm x`) are always skipped and
+ * (`CommandSite.node.Assigns`, e.g. `FOO=bar rm x`) are always skipped and
  * counted in {@link Argv0Resolution.assignmentsSkipped} — a mechanism
  * distinct from a wrapper's own `VAR=val` *operands* (`env A=1 rm x`,
  * `sudo A=1 rm x`), which {@link WrapperSpec.skipAssignmentOperands}

package/dist/analyze/resolve-argv0.js

@@ -16,8 +16,8 @@ import { nodeArray } from './node-helpers.js';
  *
  * Frozen (including each entry object and its own array/regexp fields) so
  * immutability of this shared, module-scoped table is a contract, not just
- * a convention any importer happens to honor — mirrors `visitorKeys`'s and
- * `CHILD_TYPE_SCHEMA`'s freezing in `visitor-keys.ts`/`normalize.ts`.
+ * a convention any importer happens to honor. Per-call wrapper options are
+ * separate values and cannot mutate these shared defaults.
  *
  * `xargs` is deliberately **excluded**: unlike every entry here, `xargs`
  * doesn't simply re-exec a single wrapped command word it can point to
@@ -63,7 +63,7 @@ export const DEFAULT_TRANSPARENT_WRAPPERS = deepFreeze([
     // [argument...]]` — POSIX `env` (`-i`) plus GNU coreutils env(1)'s
     // commonly documented long/short forms. `VAR=val` operands preceding the
     // utility are `env`'s own environment-setting mechanism (distinct from
-    // `CallExpr.assigns`). `-S`/`--split-string` is deliberately *not* an
+    // `CallExpr.Assigns`). `-S`/`--split-string` is deliberately *not* an
     // `argFlags` entry — see `unresolvableFlags` below.
     {
         names: ['env'],
@@ -103,7 +103,7 @@ export const DEFAULT_TRANSPARENT_WRAPPERS = deepFreeze([
     // `enumerate-commands.ts`'s doc comment — `enumerateCommands` treats it
     // as transparent and never emits a `CallExpr`/`CommandSite` for it), so
     // this entry only ever matches an argv0 word reading literally `time`
-    // that reached `CallExpr.args` some other way (quoted — `"time" cmd`
+    // that reached `CallExpr.Args` some other way (quoted — `"time" cmd`
     // suppresses reserved-word recognition — or as another wrapper's
     // operand, e.g. `env time cmd`). `-p` (POSIX) and GNU time(1)'s
     // `--verbose`/`--portability` take no operand; `-o file`/`-f format`
@@ -454,7 +454,7 @@ function validateWrapperSpec(spec, index) {
  *    (see {@link WrapperSpec.unresolvableFlags}'s doc comment).
  *
  * `VAR=val` shell-assignment prefixes on the `CallExpr` itself
- * (`CommandSite.node.assigns`, e.g. `FOO=bar rm x`) are always skipped and
+ * (`CommandSite.node.Assigns`, e.g. `FOO=bar rm x`) are always skipped and
  * counted in {@link Argv0Resolution.assignmentsSkipped} — a mechanism
  * distinct from a wrapper's own `VAR=val` *operands* (`env A=1 rm x`,
  * `sudo A=1 rm x`), which {@link WrapperSpec.skipAssignmentOperands}
@@ -479,7 +479,7 @@ export function resolveArgv0(site, options) {
     if (options?.transparentWrappers !== undefined) {
         wrappers.forEach(validateWrapperSpec);
     }
-    const assignmentsSkipped = nodeArray(site.node.assigns).length;
+    const assignmentsSkipped = nodeArray(site.node.Assigns).length;
     const argv = site.argv;
     const chain = [];
     let index = 0;