sh-ast 0.4.0 → 0.6.0

package/README.md

@@ -6,6 +6,11 @@ mutable records preserving upstream fields, defaults, nulls, numeric operators,
 byte strings, and token positions. First use initializes WebAssembly synchronously
 in Node.js; no initialization promise is required.
 
+Traversal uses ordinary TypeScript arrays with explicit mutation limits. The
+[accepted representation decision](../../design/WALK-MUTATION-DECISION.md) records
+which live edits are supported and why this interface does not model Go storage
+capacity, reslicing, or value-slot addresses.
+
 ```ts
 import { LangBash, nodeEnd, parseSync } from 'sh-ast';
 
@@ -58,30 +63,122 @@ Positions }`. `Positions.get(node)` reads immutable original bounds by node
   a value does not promise every upstream operation accepts it.
 - `SYNTAX_SCHEMA` and `SYNTAX_INTERFACES` are deeply frozen field/interface
   metadata. Their order is not upstream Walk order.
+- `walk(node, callback)` calls the callback synchronously on entry and with `null`
+  on exit. Return `false` on entry to prune that occurrence, including its exit;
+  exit boolean values do not control traversal. Every callback result must be a
+  boolean; Promises and other values throw `InputError`. Child reads happen live, and
+  nested calls keep independent state. Specialized statement/item comment loops
+  visit value copies; ordinary comment lists visit their stored objects. The
+  array reference and initial length are captured when each list starts. Future
+  existing slots are read live; indices added beyond the captured extent are
+  ignored by that active traversal. Replacing the owner's array field does not retarget an active list.
+  See the mutation limits below.
+- `printSync(node, options?)` reconstructs the current edited tree and collects a
+  fresh upstream printer's output as `GoString`. Supported roots are File, Stmt,
+  Word, Assign, Command and WordPart alternatives. Only File gets a guaranteed
+  final newline. Printing applies upstream formatting; it does not replay the
+  original source or promise source-byte identity.
+- `PrintOptions` exposes `Indent`, `BinaryNextLine`, `SwitchCaseIndent`,
+  `SpaceRedirects`, `KeepPadding`, `Minify`, `SingleLine`, and `FunctionNextLine`.
+  Indent accepts an exact uint64 as a safe number or bigint, with zero selecting
+  tabs. Boolean defaults are false. KeepPadding is upstream's best-effort,
+  deprecated option; Minify and SingleLine together return an upstream error.
 
 `ParseError` and `LangError` preserve upstream fields, exact `Message` bytes, and
 any partial `File`. Their ordinary `Error.message` is a display string.
 `InputError` reports invalid binding inputs, upstream option constraints, or
 unsupported constructed nodes whose requested bound panics upstream.
 `ShInternalError` reports transport failures or unexpected upstream panics.
+`PrintError` retains ordinary upstream printer failures, and `PrintPanicError`
+retains panics from printing representable inputs. `WalkPanicError` represents
+upstream-equivalent traversal panics; callback exceptions retain their identity.
 All extend `ShAstError`. The conservative structural-depth guard throws
 `ShParseMaxDepthError` before potentially exhausting the WASM stack. It is a
 binding resource constraint and can reject deeply nested quoted or commented text.
+Printing collects complete output; large trees or indentation widths can consume
+substantial memory and time. The parse guard does not bound arbitrary constructed
+printing inputs. No arbitrary writer, partial-output, or reusable-printer protocol
+is exposed.
+
+## Traversal mutation limits
+
+Supported edits preserve a node's kind and shape: change syntax fields, replace
+pointer children before their read, replace future existing list slots, append
+beyond an active list's captured extent, or assign a new array to the owner field.
+Changes before a list starts are included in its captured reference and length.
+Pruning and synchronous nested walks retain their control behavior; nested walks
+see the tree at their own entry, while edits to shared objects remain live.
+
+Keep every index in an active list's captured extent present. Removing one,
+leaving a hole there, or shrinking below that extent is outside the supported
+contract, including through aliases. Truncation, `delete`, `pop`, `shift`, or a
+length-reducing `splice` can do this; removing appended indices beyond the captured
+extent does not affect the active list. No mutation detector or specific
+error/result is promised for those edits. Assign a new owner array
+instead; the active list keeps its original array and later walks see the new one.
+Length-preserving replacement or reordering, including `sort` and `reverse`,
+follows live slot reads and may revisit an object moved into a later slot. Walk
+does not promise to visit each object only once. An appended object moved into an
+original future slot is visited through that slot.
+
+Stored Comment callbacks receive JavaScript objects. Replacing a Comment slot
+leaves a retained callback object unchanged; it does not behave as a pointer to a
+Go value slot. Specialized Stmt/CaseItem/ArrayElem comment callbacks receive
+copies, so editing those callback values does not edit the original comments.
+Ordinary JavaScript aliases remain live; this interface does not clone shared
+arrays or objects. It does not model Go slice capacity, distinct slice headers
+sharing backing stores, or reslicing. These limits preclude unrestricted Go
+storage mutation parity while preserving live field edits and upstream traversal control.
+
+## Editing and printing
+
+```ts
+import { parseSync, printSync, walk } from 'sh-ast';
+
+const file = parseSync("printf '%s\\n' 'old 🎉'\n", { KeepComments: true });
+walk(file, (node) => {
+  if (node?.Type === 'SglQuoted' && node.Value === 'old 🎉') {
+    node.Value = 'new 🎉';
+  }
+  return true;
+});
+const output = printSync(file);
+```
+
+This edits a field without replacing array storage. Node positions still describe
+their upstream token values; live `nodePos` and `nodeEnd` compute from current
+fields, while a separately captured parse snapshot remains tied to original
+source. Consumers such as ESLint can edit a separate tree and use printed output
+as a fix without mutating their original lint view or traversal cache.
 
 `sh-ast/analyze` remains a separate syntactic interpretation layer. Its word,
 command, and wrapper analysis consumes the faithful records; it does not define
 parser behavior or the core tree representation.
 
+`resolveArgv0` follows only documented wrapper grammars. The default `env` and
+`sudo` entries accept assignment names beyond shell identifiers, such as `A-B`
+or `名`. `env` recognizes assignments after `--` and ends option scanning at its
+first assignment; `sudo` permits options between assignments, excludes names
+beginning with `/` or `=`, and stops recognizing assignments after `--`. An empty
+`env` assignment name (`=value`) reports `ambiguous-assignment`, since supported
+implementations differ. These are syntactic facts, not execution guarantees.
+Custom tables can choose `WrapperSpec.assignmentOperands` (`'shell-identifier'`,
+`'env'`, or `'sudo'`); this explicit grammar overrides `skipAssignmentOperands`.
+Existing `skipAssignmentOperands: true` tables retain their ASCII shell-identifier
+rule before `--`. Wrapper assignment operands do not change `assignmentsSkipped`,
+which counts only shell-level prefixes.
+
 ## Migration from 0.3
 
 Fields now use upstream spelling (`Type`, `Stmts`, `Cmd`, `Value`) and explicit
 null/default values. Replace dialect strings with numeric `Variant` constants,
 request comments explicitly, and handle structured errors and byte positions.
-The root no longer exports normalized `ShNode`/`ShNodes`, `range`/`loc`, `walk`, or
-`visitorKeys`. Consumers such as ESLint own their source-coordinate and traversal
-views. Whole-file parsing is the present scope; public upstream traversal and
-printing belong to the following minor release. Stateful/incremental parser
-protocols and full syntax-package parity are deferred.
+The root no longer exports normalized `ShNode`/`ShNodes`, `range`/`loc`, or
+`visitorKeys`. The new walker uses entry/null-exit callbacks rather than the former
+structural helper's protocol. Consumers such as ESLint own their source-coordinate
+and traversal views. Whole-file parsing, collected printing and the live walker
+with the mutation limits above form this candidate's scope. Stateful/incremental parser protocols
+and full syntax-package parity are deferred.
 
 The [design collection](../../design/ARCHITECTURE.md) and
 [implementation evidence](../../design/IMPLEMENTATION.md) describe the release
@@ -116,16 +213,34 @@ guessing at current behavior, and is pinned by `test/dialect-matrix.test.ts`.
 reaches the regex-test parser at all — `=~` is just another literal argument to a command named
 `[[`.
 
-\*\* Brace expansion is never split into a `BraceExp` node by this bridge, in any dialect — mvdan/sh
-only produces `BraceExp` nodes when the caller explicitly runs its `syntax.SplitBraces()`
-post-processing pass, which `shim/main.go` does not invoke. `{a,b}` always parses as an ordinary
-`Lit` word part, identically in every dialect.
+\*\* Parsing preserves upstream output: `{a,b}` remains an ordinary `Lit` word part,
+not a `BraceExp`, in every dialect. The analysis layer separately asks mvdan/sh v3.13.1's
+`syntax.SplitBraces` to recognize potential expansions on a private copy. `resolveWord`,
+`enumerateCommands`, and `resolveArgv0` report `static: false, reason: 'brace'` when actual
+brace-expansion parts are found, without changing the caller's tree. A bare Word carries no
+dialect or shell-option state, so this conservative observation also applies to POSIX-parsed
+records; it does not assert that POSIX sh performs brace expansion.
+
+Quoted or fully escaped opening braces within one literal part remain literal. Brace candidates containing other
+backslashes report `unsupported`: pinned upstream's escape handling differs from Bash, and
+analysis does not guess through that discrepancy. For example, `\{a,b\}` remains static,
+while `a{b\,c}` is conservatively unsupported. Any unquoted backslash escape crossing word-part boundaries in a constructed
+word is also unsupported, including boundaries into quoted parts: such a split
+can expose otherwise quoted syntax, and analysis does not reconstruct shell
+tokenization to infer a literal value. Malformed or singleton unescaped forms such as
+`a{b` and `{a}` remain static. See [the brace-classification decision](../../design/BRACE-CLASSIFICATION-DECISION.md).
 
 \*\*\* zsh's lexer never tokenizes `@(` as an extended-glob opener at all — deliberately, to avoid
 ambiguity with zsh's own glob qualifiers like `*(N)`. So `ls @(a|b)` parses without error under
 `Variant: LangZsh`, but produces plain `Lit` word parts rather than an `ExtGlob` node; the
 `checkLang` gate that rejects extended globs under posix is never reached for zsh.
 
+Reason descriptions do not promise universal precedence. Whole-word `unsupported`
+preflight still applies when a constructed word already contains a `BraceExp`.
+Independently quoted or fully protected literal siblings preserve `brace`; an
+escape crossing parts or an escape-uncertain brace candidate remains unsupported.
+Existing tilde/glob resolution order also remains applicable.
+
 ### `[[ ... ]]` and `let` under posix: accepted by design
 
 `Variant: LangPOSIX` accepting `[[ a == b ]]` and `let x=1` is **intentional upstream behavior, not

package/dist/analyze/brace-observation.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Observes potential brace syntax without rewriting caller-owned words. The
+ * pinned Go operation decides brace grammar; this module only excludes words
+ * with no unescaped opening brace and marks upstream escape discrepancies as
+ * uncertainty. Ordinary words never cross the WASM boundary for this check.
+ */
+import type { Word } from '../../generated/syntax-types.js';
+/** A positive observation is distinct from inability to trust upstream escape handling. @internal */
+export type BraceObservation = boolean | 'unsupported';
+/**
+ * Reports current word content, never an identity cache. Go reconstructs an
+ * isolated Word before SplitBraces mutates it. v3.13.1's SplitBraces mishandles
+ * escapes, so candidates containing backslashes remain unknown instead of
+ * introducing a competing brace grammar or claiming a false static value.
+ * @internal
+ */
+export declare function observeBraces(word: Word): BraceObservation;
+//# sourceMappingURL=brace-observation.d.ts.map

package/dist/analyze/brace-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brace-observation.d.ts","sourceRoot":"","sources":["../../src/analyze/brace-observation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AAK5D,qGAAqG;AACrG,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,aAAa,CAAC;AAEvD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,gBAAgB,CA0C1D"}

package/dist/analyze/brace-observation.js

@@ -0,0 +1,59 @@
+import { ShInternalError } from '../errors.js';
+import { decodeWire, encodeWire, isRecord } from '../syntax-wire.js';
+import { callSyntax } from '../wasm-instance.js';
+/**
+ * Reports current word content, never an identity cache. Go reconstructs an
+ * isolated Word before SplitBraces mutates it. v3.13.1's SplitBraces mishandles
+ * escapes, so candidates containing backslashes remain unknown instead of
+ * introducing a competing brace grammar or claiming a false static value.
+ * @internal
+ */
+export function observeBraces(word) {
+    let candidate = false;
+    let escaped = false;
+    let escapeCrossesPart = false;
+    // Adjacent literal records concatenate without a quote boundary. Carry the
+    // backslash state across them: two one-backslash records expose the next
+    // opening just as two backslashes in one Lit do. Nonliteral parts protect
+    // their own content and break this unquoted lexical run.
+    let protectedNext = false;
+    for (const part of word.Parts ?? []) {
+        escapeCrossesPart ||= protectedNext;
+        if (part?.Type !== 'Lit' || typeof part.Value !== 'string') {
+            protectedNext = false;
+            continue;
+        }
+        for (const character of part.Value) {
+            if (protectedNext) {
+                protectedNext = false;
+            }
+            else if (character === '\\') {
+                protectedNext = true;
+                escaped = true;
+            }
+            else if (character === '{') {
+                candidate = true;
+            }
+        }
+    }
+    // A split escape crosses the analyzer's per-part unquoting boundary. It can
+    // expose syntax inside a following quoted part, so uncertainty must not
+    // depend on finding a literal brace first. Decline every such constructed
+    // word instead of rebuilding shell tokenization or claiming static text.
+    if (escapeCrossesPart)
+        return 'unsupported';
+    if (!candidate)
+        return false;
+    if (escaped)
+        return 'unsupported';
+    const response = decodeWire(callSyntax('word-braces', new TextEncoder().encode(encodeWire(word))));
+    if (!isRecord(response))
+        throw new ShInternalError('Invalid brace observation response');
+    if (isRecord(response.Error) && response.Error.Kind === 'InputError')
+        return 'unsupported';
+    if (typeof response.Brace !== 'boolean' || Object.keys(response).length !== 1) {
+        throw new ShInternalError('Invalid brace observation response');
+    }
+    return response.Brace;
+}
+//# sourceMappingURL=brace-observation.js.map

package/dist/analyze/brace-observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brace-observation.js","sourceRoot":"","sources":["../../src/analyze/brace-observation.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAKjD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAC9B,2EAA2E;IAC3E,yEAAyE;IACzE,0EAA0E;IAC1E,yDAAyD;IACzD,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACpC,iBAAiB,KAAK,aAAa,CAAC;QACpC,IAAI,IAAI,EAAE,IAAI,KAAK,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC3D,aAAa,GAAG,KAAK,CAAC;YACtB,SAAS;QACX,CAAC;QACD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,aAAa,EAAE,CAAC;gBAClB,aAAa,GAAG,KAAK,CAAC;YACxB,CAAC;iBAAM,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBAC9B,aAAa,GAAG,IAAI,CAAC;gBACrB,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;iBAAM,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;gBAC7B,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IACD,4EAA4E;IAC5E,wEAAwE;IACxE,0EAA0E;IAC1E,yEAAyE;IACzE,IAAI,iBAAiB;QAAE,OAAO,aAAa,CAAC;IAC5C,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,IAAI,OAAO;QAAE,OAAO,aAAa,CAAC;IAClC,MAAM,QAAQ,GAAG,UAAU,CACzB,UAAU,CAAC,aAAa,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CACtE,CAAC;IACF,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,oCAAoC,CAAC,CAAC;IACzF,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,aAAa,CAAC;IAC3F,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,eAAe,CAAC,oCAAoC,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC;AACxB,CAAC"}

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

@@ -44,15 +44,34 @@ export interface WrapperSpec {
      */
     readonly names: readonly string[];
     /**
-     * When `true`, a `NAME=value`-shaped operand (an unquoted identifier
-     * followed by `=`, e.g. `A=1`) appearing after the wrapper name is
-     * 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}
-     * counts.
+     * Legacy shorthand for {@link WrapperSpec.assignmentOperands}'s
+     * `'shell-identifier'` grammar: skip statically resolved `NAME=value`
+     * words with an ASCII shell identifier before `--`. Options may follow
+     * these operands. Quote removal has already happened during word resolution.
+     * An explicit `assignmentOperands` takes precedence, even when this is false.
+     * These operands never contribute to shell-prefix `assignmentsSkipped`.
      */
     readonly skipAssignmentOperands?: boolean;
+    /**
+     * Assignment-operand scanning grammar, independent of the wrapper's name.
+     * Each preset defines both which static words are assignments and where
+     * option scanning stops; it does not model the utility's other options.
+     *
+     * - `'shell-identifier'`: the legacy ASCII `NAME=value` rule before `--`;
+     *   options may resume after an assignment.
+     * - `'env'`: after options, consume words containing `=` (including after
+     *   `--`). The first assignment ends option scanning permanently. Empty
+     *   names (`=value`) produce `'ambiguous-assignment'` because GNU/glibc
+     *   and BSD differ on whether they can be installed in the environment.
+     * - `'sudo'`: before `--`, consume words containing `=` unless they start
+     *   with `/` or `=`; option scanning may resume after each assignment.
+     *
+     * Active option parsing always takes precedence over utility assignments:
+     * `--unset=NAME` is an option, whereas `env A=1 --unset=NAME cmd` treats
+     * that same word as an assignment. This field overrides the legacy
+     * {@link WrapperSpec.skipAssignmentOperands} boolean when present.
+     */
+    readonly assignmentOperands?: 'shell-identifier' | 'env' | 'sudo';
     /** Exact flag tokens that take no operand of their own (e.g. `-i`, `-c`). */
     readonly noArgFlags?: readonly string[];
     /**
@@ -197,6 +216,11 @@ export interface ResolveArgv0Options {
  *   the real command rather than naming it as a separate word (e.g.
  *   `env -S 'rm -rf /'` — see {@link WrapperSpec.unresolvableFlags}'s doc
  *   comment).
+ * - `'ambiguous-assignment'` — a statically known assignment operand whose
+ *   acceptance differs across supported utility implementations, such as
+ *   `env =value cmd` (GNU/glibc accepts an empty name; BSD rejects it).
+ *   Neither the following command nor the operand itself is guessed as
+ *   the effective command.
  *
  * This union may grow in a **minor** release (mirroring
  * `WordResolutionReason`'s and `CommandContext`'s semver policy in
@@ -206,7 +230,7 @@ export interface ResolveArgv0Options {
  *
  * @public
  */
-export type Argv0UnresolvedReason = 'unknown-flag' | 'embedded-command';
+export type Argv0UnresolvedReason = 'unknown-flag' | 'embedded-command' | 'ambiguous-assignment';
 /**
  * A word position {@link resolveArgv0} could not resolve to either a known
  * static text or one of {@link WordResolution}'s own `static: false`

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

@@ -1 +1 @@
-{"version":3,"file":"resolve-argv0.d.ts","sourceRoot":"","sources":["../../src/analyze/resolve-argv0.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAElC;;;;;;;;OAQG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAE1C,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAExC;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEtC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE/C;;;;;;;;OAQG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE7C;;;;OAIG;IACH,QAAQ,CAAC,+BAA+B,CAAC,EAAE,MAAM,CAAC;CACnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,eAAO,MAAM,4BAA4B,EAAE,SAAS,WAAW,EA8G7D,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CACvD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,kBAAkB,CAAC;AAExE;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;CACxC;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,mBAAmB,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAE1C;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IAEnC;;;;;;;;OAQG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAmTD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,eAAe,CAgC9F"}
+{"version":3,"file":"resolve-argv0.d.ts","sourceRoot":"","sources":["../../src/analyze/resolve-argv0.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAElC;;;;;;;OAOG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAE1C;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,GAAG,KAAK,GAAG,MAAM,CAAC;IAElE,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAExC;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEtC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE/C;;;;;;;;OAQG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE7C;;;;OAIG;IACH,QAAQ,CAAC,+BAA+B,CAAC,EAAE,MAAM,CAAC;CACnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,eAAO,MAAM,4BAA4B,EAAE,SAAS,WAAW,EAqH7D,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CACvD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,kBAAkB,GAAG,sBAAsB,CAAC;AAEjG;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;CACxC;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,mBAAmB,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAE1C;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IAEnC;;;;;;;;OAQG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAyVD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,eAAe,CAgC9F"}

package/dist/analyze/resolve-argv0.js

@@ -1,3 +1,8 @@
+/**
+ * Resolves command-word provenance through caller-configurable wrapper grammars.
+ * Only statically known operands may be skipped; syntax facts never imply that
+ * a command is safe, permitted, installed, or guaranteed to execute successfully.
+ */
 import { ShAnalyzeInvalidWrapperSpecError } from '../errors.js';
 import { deepFreeze } from '../deep-freeze.js';
 import { nodeArray } from './node-helpers.js';
@@ -67,7 +72,11 @@ export const DEFAULT_TRANSPARENT_WRAPPERS = deepFreeze([
     // `argFlags` entry — see `unresolvableFlags` below.
     {
         names: ['env'],
-        skipAssignmentOperands: true,
+        // GNU env v9.8 src/env.c and FreeBSD releng/14.3 usr.bin/env/env.c
+        // scan strchr(word, '=') after getopt; options never resume afterward.
+        // https://github.com/coreutils/coreutils/blob/v9.8/src/env.c#L797
+        // https://github.com/freebsd/freebsd-src/blob/releng/14.3/usr.bin/env/env.c#L188
+        assignmentOperands: 'env',
         noArgFlags: ['-i', '--ignore-environment', '-0', '--null', '-v', '--debug'],
         argFlags: ['-u', '--unset', '-C', '--chdir'],
         // GNU env(1) `-S`/`--split-string=S`: processes and splits `S` into
@@ -145,7 +154,10 @@ export const DEFAULT_TRANSPARENT_WRAPPERS = deepFreeze([
     // environment-setting mechanism, "similar to env" per sudo(8).
     {
         names: ['sudo'],
-        skipAssignmentOperands: true,
+        // is_envar rejects '/' and '=' prefixes; !got_end_of_args prevents
+        // assignments after --, while the enclosing loop resumes getopt.
+        // https://github.com/sudo-project/sudo/blob/v1.9.17p2/src/parse_args.c#L263
+        assignmentOperands: 'sudo',
         noArgFlags: ['-A', '-b', '-E', '-H', '-k', '-n', '-P', '-S'],
         argFlags: ['-g', '-p', '-u'],
     },
@@ -255,7 +267,8 @@ function findWrapperSpec(wrappers, text) {
  *   `argv` with no wrapped-command word found (a malformed or truncated
  *   invocation, e.g. bare `env` with nothing else, or `sudo -u` with no
  *   operand for `-u`).
- * - `{ kind: 'unresolvable', reason }` — a *statically known* word that
+ * - `{ kind: 'unresolvable', reason }` — an ambiguous assignment, or a
+ *   *statically known* word that
  *   looks like a flag for this wrapper (unquoted, unescaped `-` prefix,
  *   not `--`) but matches none of `spec`'s recognized flag/operand shapes,
  *   or matches one of `spec.unresolvableFlags` (see
@@ -268,7 +281,7 @@ function findWrapperSpec(wrappers, text) {
  * A literal `--` (the standard getopt(3)/getopt_long(3) end-of-options
  * marker — POSIX Utility Syntax Guidelines, guideline 10) is skipped like
  * any other recognized token, but — critically — everything *after* it is
- * no longer eligible for **any** flag/operand recognition at all
+ * no longer eligible for **any** flag recognition at all
  * (`noArgFlags`, `noArgFlagPattern`, `argFlags` in every form,
  * `unresolvableFlags`, `stopsChainFlags`, or the generic
  * flag-shape/`'unknown-flag'` check): once options end, a later word that
@@ -278,15 +291,17 @@ function findWrapperSpec(wrappers, text) {
  * `--` for every wrapper here. A wrapper's mandatory positional operand
  * (e.g. `timeout`'s `DURATION`) is a distinct, non-flag concept and is
  * still consumed normally after `--` — only *flag* recognition stops.
- * `VAR=val` operand recognition (`skipAssignmentOperands`) is likewise
- * unaffected by `--`, matching GNU env(1)'s own two-phase argument
- * scanning (option parsing, then a separate `NAME=value` scan over
- * whatever's left) — `--` only ever disables *option* (flag) parsing.
+ * Assignment recognition follows the explicit grammar: `env` scans
+ * assignments even after `--` and stops option parsing at its first
+ * assignment; `sudo` and the legacy shell-identifier grammar recognize
+ * assignments only before `--` and allow later options.
  */
 function advancePastWrapperOperands(argv, startIndex, spec) {
     let index = startIndex;
     let positionalSeen = 0;
     let optionsEnded = false;
+    const assignmentGrammar = spec.assignmentOperands ??
+        (spec.skipAssignmentOperands === true ? 'shell-identifier' : undefined);
     const requiredPositional = spec.positionalOperandsBeforeCommand ?? 0;
     while (index < argv.length) {
         // `index < argv.length` just checked above, so this is a real element.
@@ -304,7 +319,24 @@ function advancePastWrapperOperands(argv, startIndex, spec) {
             index += 1;
             continue;
         }
-        if (!optionsEnded && spec.skipAssignmentOperands === true && isAssignmentShapedText(text)) {
+        // An '=' in an active option (e.g. --unset=NAME) does not make it an
+        // assignment. After env's option phase, however, even '-x=y' is one.
+        const canRecognizeAssignment = (assignmentGrammar === 'env' || !optionsEnded) &&
+            (assignmentGrammar === 'shell-identifier' || optionsEnded || !looksLikeFlag(text));
+        if (canRecognizeAssignment && assignmentGrammar === 'env' && text.startsWith('=')) {
+            // glibc putenv accepts an empty name, while FreeBSD setenv rejects
+            // it. The grammar therefore cannot identify a portable invocation.
+            return { kind: 'unresolvable', reason: 'ambiguous-assignment' };
+        }
+        const isAssignment = assignmentGrammar === 'shell-identifier'
+            ? isAssignmentShapedText(text)
+            : text.includes('=') &&
+                (assignmentGrammar === 'env' ||
+                    (assignmentGrammar === 'sudo' && !text.startsWith('/') && !text.startsWith('=')));
+        if (canRecognizeAssignment && isAssignment) {
+            if (assignmentGrammar === 'env') {
+                optionsEnded = true;
+            }
             index += 1;
             continue;
         }
@@ -404,6 +436,14 @@ function validateWrapperSpec(spec, index) {
         typeof spec.skipAssignmentOperands !== 'boolean') {
         throw new ShAnalyzeInvalidWrapperSpecError(`${context}.skipAssignmentOperands must be a boolean when present`);
     }
+    // JavaScript callers can bypass the declared union; validate raw boundary data.
+    const assignmentOperands = spec.assignmentOperands;
+    if (assignmentOperands !== undefined &&
+        assignmentOperands !== 'shell-identifier' &&
+        assignmentOperands !== 'env' &&
+        assignmentOperands !== 'sudo') {
+        throw new ShAnalyzeInvalidWrapperSpecError(`${context}.assignmentOperands must be shell-identifier, env, or sudo when present`);
+    }
     if (spec.noArgFlagPattern !== undefined && !(spec.noArgFlagPattern instanceof RegExp)) {
         throw new ShAnalyzeInvalidWrapperSpecError(`${context}.noArgFlagPattern must be a RegExp when present`);
     }

package/dist/analyze/resolve-argv0.js.map

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

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

@@ -2,7 +2,7 @@
 import type { Node } from '../../generated/syntax-types.js';
 /**
  * Why a {@link resolveWord} result is `static: false`: the word's exact
- * text cannot be determined from source alone.
+ * value cannot be classified as one reliably known literal word.
  *
  * - `'expansion'` — the word contains a `ParamExp` (`$x`, `${x}`), a
  *   `CmdSubst` (command substitution, either `$(...)` or backtick form), an
@@ -24,15 +24,12 @@ import type { Node } from '../../generated/syntax-types.js';
  *   Reference Manual §3.5.8.1, "Pattern Matching"), or an `ExtGlob` part
  *   (Bash Reference Manual §3.5.8, "Filename Expansion"): its value depends
  *   on which filesystem entries exist at run time.
- * - `'brace'` — the word contains a `BraceExp` part (`{a,b}`/`{1..10}`,
- *   Bash Reference Manual §3.5.1, "Brace Expansion"). mvdan/sh v3.13.1 only
- *   ever produces this node type when its caller applies `syntax.SplitBraces`
- *   to the parsed tree; this bridge's shim does not call it, so today a
- *   brace expression like `{a,b}` reaches {@link resolveWord} as an
- *   ordinary `Lit` (indistinguishable, in the AST this bridge produces,
- *   from literal `{`/`,`/`}` characters) rather than as a `BraceExp` part.
- *   This reason is handled here for forward-compatibility with that node
- *   type and is not reachable through {@link resolveWord} today.
+ * - `'brace'` — the word contains a `BraceExp` part or the pinned upstream
+ *   `syntax.SplitBraces` produces one on a private observation copy (Bash
+ *   Reference Manual §3.5.1, "Brace Expansion"). Parser output is unchanged.
+ *   This reports potential expansion in supporting dialects; a bare Word has
+ *   no dialect or shell-option state, so even POSIX-parsed words receive the
+ *   conservative classification. It does not claim POSIX sh expands braces.
  * - `'locale'` — the word contains a `$"..."` locale-translated string
  *   (Bash Reference Manual §3.1.2.5, "Locale-Specific Translation"): its
  *   value is looked up in the current locale's translation catalog at run
@@ -41,7 +38,10 @@ import type { Node } from '../../generated/syntax-types.js';
  *   `$"..."` word's *contents* would otherwise report — the `DblQuoted`
  *   node's own `dollar` flag is checked before its children are visited at
  *   all, so e.g. `$"hi $x"` reports `'locale'`, never `'expansion'`.
- * - `'unsupported'` — a word contains a nil or typed nil part, a literal carries a byte-preserving `Uint8Array`
+ * - `'unsupported'` — a brace candidate contains backslashes whose handling
+ *   differs between pinned mvdan/sh and Bash (rather than guessing through
+ *   that discrepancy), an unquoted backslash escape crosses word-part
+ *   boundaries in a caller-constructed word, a word contains a nil or typed nil part, a literal carries a byte-preserving `Uint8Array`
  *   rather than Unicode text, or the word contains a `$'...'` (ANSI-C quoted) `\u`/`\U`
  *   escape whose value has no corresponding Unicode character (greater than
  *   `U+10FFFF`, e.g. `$'\UFFFFFFFF'`): real bash's output for this case is
@@ -51,6 +51,14 @@ import type { Node } from '../../generated/syntax-types.js';
  *   package declines to claim a `static: true` text bash never actually
  *   produces.
  *
+ * Reason descriptions do not establish universal precedence among features.
+ * Whole-word `unsupported` preflight takes precedence even when a caller has
+ * already supplied a `BraceExp`: an escape crossing parts can invalidate the
+ * apparent quoting boundaries, and an escape-uncertain brace candidate remains
+ * uncertain. Independently quoted or fully protected literal siblings do not
+ * suppress a known `BraceExp`. After preflight, existing resolution order can
+ * select a triggering tilde or earlier glob before visiting that part.
+ *
  * This union may grow in a **minor** release — new mvdan/sh word-part node
  * types, or new statically-shaped-but-dynamic categories, can add new reason
  * strings without that being a breaking change. It is deliberately not
@@ -78,7 +86,7 @@ export type WordResolution = {
     /** The word's exact resolved text (quotes and escapes removed). */
     readonly text: string;
 } | {
-    /** The word's value depends on program state, the environment, or the filesystem. */
+    /** The word has potential expansion or cannot be resolved reliably by this analyzer. */
     readonly static: false;
     /** Why this word cannot be statically resolved. */
     readonly reason: WordResolutionReason;
@@ -132,7 +140,7 @@ export interface ResolveWordOptions {
  * resolves to `"rm"`). A word containing any expansion (`ParamExp`,
  * `CmdSubst`, `ArithmExp`, `ProcSubst`), a triggering unquoted `~` (see
  * `options.context`), an unquoted glob metacharacter/bracket
- * expression/`ExtGlob`, a `$"..."` locale translation, or an unrepresentable
+ * expression/`ExtGlob`, potential brace expansion, a `$"..."` locale translation, or an unrepresentable
  * `$'\U...'` escape is `static: false` with a reason — never an error, and
  * never a safety judgment (see {@link WordResolution}).
  *

package/dist/analyze/resolve-word.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-word.d.ts","sourceRoot":"","sources":["../../src/analyze/resolve-word.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AAK5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,MAAM,MAAM,oBAAoB,GAC9B,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEtE;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GACtB;IACE,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GACD;IACE,qFAAqF;IACrF,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;CACvC,CAAC;AAEN;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,CAAC;CAC5D;AAwKD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,cAAc,CAqCpF"}
+{"version":3,"file":"resolve-word.d.ts","sourceRoot":"","sources":["../../src/analyze/resolve-word.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AAM5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,MAAM,MAAM,oBAAoB,GAC9B,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEtE;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GACtB;IACE,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GACD;IACE,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;CACvC,CAAC;AAEN;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,CAAC;CAC5D;AAuKD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,cAAc,CAwCpF"}