sh-ast 0.3.0 → 0.4.0

package/generated/syntax-schema.js

@@ -0,0 +1,1740 @@
+// Code generated by tools/gen-visitor-keys from mvdan.cc/sh/v3 v3.13.1. DO NOT EDIT.
+// Faithful syntax values; see design/ARCHITECTURE.md.
+/*
+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.
+*/
+
+/**
+ * Complete upstream field shapes for reflection and consumer adaptation. Ordering is deterministic for review, not the upstream Walk order. The public binding freezes this shared metadata; represented syntax records remain mutable.
+ *
+ * @public
+ */
+export const SYNTAX_SCHEMA = {
+  ArithmCmd: {
+    node: true,
+    fields: {
+      Left: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Right: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Unsigned: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      X: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'ArithmExpr',
+      },
+    },
+  },
+  ArithmExp: {
+    node: true,
+    fields: {
+      Bracket: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Left: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Right: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Unsigned: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      X: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'ArithmExpr',
+      },
+    },
+  },
+  ArrayElem: {
+    node: true,
+    fields: {
+      Comments: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      Index: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'ArithmExpr',
+      },
+      Value: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Word',
+      },
+    },
+  },
+  ArrayExpr: {
+    node: true,
+    fields: {
+      Elems: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'ArrayElem',
+      },
+      Last: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      Lparen: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Rparen: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  Assign: {
+    node: true,
+    fields: {
+      Append: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Array: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'ArrayExpr',
+      },
+      Index: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'ArithmExpr',
+      },
+      Naked: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Name: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Lit',
+      },
+      Value: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Word',
+      },
+    },
+  },
+  BinaryArithm: {
+    node: true,
+    fields: {
+      Op: {
+        kind: 'operator',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: 'BinAritOperator',
+      },
+      OpPos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      X: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'ArithmExpr',
+      },
+      Y: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'ArithmExpr',
+      },
+    },
+  },
+  BinaryCmd: {
+    node: true,
+    fields: {
+      Op: {
+        kind: 'operator',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: 'BinCmdOperator',
+      },
+      OpPos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      X: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Stmt',
+      },
+      Y: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Stmt',
+      },
+    },
+  },
+  BinaryTest: {
+    node: true,
+    fields: {
+      Op: {
+        kind: 'operator',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: 'BinTestOperator',
+      },
+      OpPos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      X: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'TestExpr',
+      },
+      Y: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'TestExpr',
+      },
+    },
+  },
+  Block: {
+    node: true,
+    fields: {
+      Last: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      Lbrace: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Rbrace: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Stmts: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Stmt',
+      },
+    },
+  },
+  BraceExp: {
+    node: true,
+    fields: {
+      Elems: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Word',
+      },
+      Sequence: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  CStyleLoop: {
+    node: true,
+    fields: {
+      Cond: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'ArithmExpr',
+      },
+      Init: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'ArithmExpr',
+      },
+      Lparen: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Post: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'ArithmExpr',
+      },
+      Rparen: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  CallExpr: {
+    node: true,
+    fields: {
+      Args: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Word',
+      },
+      Assigns: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Assign',
+      },
+    },
+  },
+  CaseClause: {
+    node: true,
+    fields: {
+      Braces: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Case: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Esac: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      In: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Items: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'CaseItem',
+      },
+      Last: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      Word: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Word',
+      },
+    },
+  },
+  CaseItem: {
+    node: true,
+    fields: {
+      Comments: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      Last: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      Op: {
+        kind: 'operator',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: 'CaseOperator',
+      },
+      OpPos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Patterns: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Word',
+      },
+      Stmts: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Stmt',
+      },
+    },
+  },
+  CmdSubst: {
+    node: true,
+    fields: {
+      Backquotes: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Last: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      Left: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      ReplyVar: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Right: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Stmts: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Stmt',
+      },
+      TempFile: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  Comment: {
+    node: true,
+    fields: {
+      Hash: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Text: {
+        kind: 'string',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  CoprocClause: {
+    node: true,
+    fields: {
+      Coproc: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Name: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Word',
+      },
+      Stmt: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Stmt',
+      },
+    },
+  },
+  DblQuoted: {
+    node: true,
+    fields: {
+      Dollar: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Left: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Parts: {
+        kind: 'interface',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'WordPart',
+      },
+      Right: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  DeclClause: {
+    node: true,
+    fields: {
+      Args: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Assign',
+      },
+      Variant: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Lit',
+      },
+    },
+  },
+  Expansion: {
+    node: false,
+    fields: {
+      Op: {
+        kind: 'operator',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: 'ParExpOperator',
+      },
+      Word: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Word',
+      },
+    },
+  },
+  ExtGlob: {
+    node: true,
+    fields: {
+      Op: {
+        kind: 'operator',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: 'GlobOperator',
+      },
+      OpPos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Pattern: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Lit',
+      },
+    },
+  },
+  File: {
+    node: true,
+    fields: {
+      Last: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      Name: {
+        kind: 'string',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Stmts: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Stmt',
+      },
+    },
+  },
+  FlagsArithm: {
+    node: true,
+    fields: {
+      Flags: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Lit',
+      },
+      X: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'ArithmExpr',
+      },
+    },
+  },
+  ForClause: {
+    node: true,
+    fields: {
+      Braces: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Do: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Stmt',
+      },
+      DoLast: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      DoPos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      DonePos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      ForPos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Loop: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Loop',
+      },
+      Select: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  FuncDecl: {
+    node: true,
+    fields: {
+      Body: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Stmt',
+      },
+      Name: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Lit',
+      },
+      Names: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Lit',
+      },
+      Parens: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Position: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      RsrvWord: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  IfClause: {
+    node: true,
+    fields: {
+      Cond: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Stmt',
+      },
+      CondLast: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      Else: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'IfClause',
+      },
+      FiPos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Last: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      Position: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Then: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Stmt',
+      },
+      ThenLast: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      ThenPos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  LetClause: {
+    node: true,
+    fields: {
+      Exprs: {
+        kind: 'interface',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'ArithmExpr',
+      },
+      Let: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  Lit: {
+    node: true,
+    fields: {
+      Value: {
+        kind: 'string',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      ValueEnd: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      ValuePos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  ParamExp: {
+    node: true,
+    fields: {
+      Dollar: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Excl: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Exp: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Expansion',
+      },
+      Flags: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Lit',
+      },
+      Index: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'ArithmExpr',
+      },
+      IsSet: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Length: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Modifiers: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Lit',
+      },
+      Names: {
+        kind: 'operator',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: 'ParNamesOperator',
+      },
+      NestedParam: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'WordPart',
+      },
+      Param: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Lit',
+      },
+      Rbrace: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Repl: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Replace',
+      },
+      Short: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Slice: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Slice',
+      },
+      Width: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  ParenArithm: {
+    node: true,
+    fields: {
+      Lparen: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Rparen: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      X: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'ArithmExpr',
+      },
+    },
+  },
+  ParenTest: {
+    node: true,
+    fields: {
+      Lparen: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Rparen: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      X: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'TestExpr',
+      },
+    },
+  },
+  ProcSubst: {
+    node: true,
+    fields: {
+      Last: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      Op: {
+        kind: 'operator',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: 'ProcOperator',
+      },
+      OpPos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Rparen: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Stmts: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Stmt',
+      },
+    },
+  },
+  Redirect: {
+    node: true,
+    fields: {
+      Hdoc: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Word',
+      },
+      N: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Lit',
+      },
+      Op: {
+        kind: 'operator',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: 'RedirOperator',
+      },
+      OpPos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Word: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Word',
+      },
+    },
+  },
+  Replace: {
+    node: false,
+    fields: {
+      All: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Orig: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Word',
+      },
+      With: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Word',
+      },
+    },
+  },
+  SglQuoted: {
+    node: true,
+    fields: {
+      Dollar: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Left: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Right: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Value: {
+        kind: 'string',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  Slice: {
+    node: false,
+    fields: {
+      Length: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'ArithmExpr',
+      },
+      Offset: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'ArithmExpr',
+      },
+    },
+  },
+  Stmt: {
+    node: true,
+    fields: {
+      Background: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Cmd: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Command',
+      },
+      Comments: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      Coprocess: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Disown: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Negated: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Position: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Redirs: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Redirect',
+      },
+      Semicolon: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  Subshell: {
+    node: true,
+    fields: {
+      Last: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      Lparen: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Rparen: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Stmts: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Stmt',
+      },
+    },
+  },
+  TestClause: {
+    node: true,
+    fields: {
+      Left: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Right: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      X: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'TestExpr',
+      },
+    },
+  },
+  TestDecl: {
+    node: true,
+    fields: {
+      Body: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Stmt',
+      },
+      Description: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Word',
+      },
+      Position: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  TimeClause: {
+    node: true,
+    fields: {
+      PosixFormat: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Stmt: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Stmt',
+      },
+      Time: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  UnaryArithm: {
+    node: true,
+    fields: {
+      Op: {
+        kind: 'operator',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: 'UnAritOperator',
+      },
+      OpPos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Post: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      X: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'ArithmExpr',
+      },
+    },
+  },
+  UnaryTest: {
+    node: true,
+    fields: {
+      Op: {
+        kind: 'operator',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: 'UnTestOperator',
+      },
+      OpPos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      X: {
+        kind: 'interface',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'TestExpr',
+      },
+    },
+  },
+  WhileClause: {
+    node: true,
+    fields: {
+      Cond: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Stmt',
+      },
+      CondLast: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      Do: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Stmt',
+      },
+      DoLast: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: false,
+        type: 'Comment',
+      },
+      DoPos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      DonePos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Until: {
+        kind: 'boolean',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      WhilePos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+    },
+  },
+  Word: {
+    node: true,
+    fields: {
+      Parts: {
+        kind: 'interface',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'WordPart',
+      },
+    },
+  },
+  WordIter: {
+    node: true,
+    fields: {
+      InPos: {
+        kind: 'position',
+        nullable: false,
+        slice: false,
+        elementNullable: false,
+        type: null,
+      },
+      Items: {
+        kind: 'struct',
+        nullable: true,
+        slice: true,
+        elementNullable: true,
+        type: 'Word',
+      },
+      Name: {
+        kind: 'struct',
+        nullable: true,
+        slice: false,
+        elementNullable: false,
+        type: 'Lit',
+      },
+    },
+  },
+};
+
+/**
+ * Concrete alternatives for upstream interfaces; syntax.Node deliberately excludes auxiliary structs. This is reflection metadata, not a traversal implementation.
+ *
+ * @public
+ */
+export const SYNTAX_INTERFACES = {
+  ArithmExpr: ['BinaryArithm', 'FlagsArithm', 'ParenArithm', 'UnaryArithm', 'Word'],
+  Command: [
+    'ArithmCmd',
+    'BinaryCmd',
+    'Block',
+    'CallExpr',
+    'CaseClause',
+    'CoprocClause',
+    'DeclClause',
+    'ForClause',
+    'FuncDecl',
+    'IfClause',
+    'LetClause',
+    'Subshell',
+    'TestClause',
+    'TestDecl',
+    'TimeClause',
+    'WhileClause',
+  ],
+  Loop: ['CStyleLoop', 'WordIter'],
+  Node: [
+    'ArithmCmd',
+    'ArithmExp',
+    'ArrayElem',
+    'ArrayExpr',
+    'Assign',
+    'BinaryArithm',
+    'BinaryCmd',
+    'BinaryTest',
+    'Block',
+    'BraceExp',
+    'CStyleLoop',
+    'CallExpr',
+    'CaseClause',
+    'CaseItem',
+    'CmdSubst',
+    'Comment',
+    'CoprocClause',
+    'DblQuoted',
+    'DeclClause',
+    'ExtGlob',
+    'File',
+    'FlagsArithm',
+    'ForClause',
+    'FuncDecl',
+    'IfClause',
+    'LetClause',
+    'Lit',
+    'ParamExp',
+    'ParenArithm',
+    'ParenTest',
+    'ProcSubst',
+    'Redirect',
+    'SglQuoted',
+    'Stmt',
+    'Subshell',
+    'TestClause',
+    'TestDecl',
+    'TimeClause',
+    'UnaryArithm',
+    'UnaryTest',
+    'WhileClause',
+    'Word',
+    'WordIter',
+  ],
+  TestExpr: ['BinaryTest', 'ParenTest', 'UnaryTest', 'Word'],
+  WordPart: [
+    'ArithmExp',
+    'BraceExp',
+    'CmdSubst',
+    'DblQuoted',
+    'ExtGlob',
+    'Lit',
+    'ParamExp',
+    'ProcSubst',
+    'SglQuoted',
+  ],
+};