fauxnix-cli 0.9.2 → 0.11.0

package/dist/translator.d.ts

@@ -1,12 +1,35 @@
-import { Assignment, CommandList, Redirect, SimpleCommand, IfCommand, ForCommand, Word, WordPart } from './ast.js';
+import { Assignment, CommandList, Redirect, SimpleCommand, IfCommand, ForCommand, WhileCommand, CaseCommand, Word, WordPart } from './ast.js';
 import { PipelineCtx } from './registry.js';
 /** `${name:-word}` and friends using case-exact fx-scalar0. */
 export declare function paramExpr(name: string, op: ':-' | ':=' | ':+' | ':?' | '-' | '+' | '?', word: string): string;
+export declare function varExtraOf(p: WordPart): {
+    replace?: {
+        global: boolean;
+        pat: string;
+        repl: string;
+    };
+    slice?: {
+        offset: string;
+        length?: string;
+    };
+} | undefined;
 /** Map a bash $VAR name to a PowerShell expression (usable inside $(...)). */
 export declare function varExpr(name: string, index?: string, param?: {
     op: ':-' | ':=' | ':+' | ':?' | '-' | '+' | '?';
     word: string;
-}, length?: boolean): string;
+}, length?: boolean, extra?: {
+    replace?: {
+        global: boolean;
+        pat: string;
+        repl: string;
+    };
+    slice?: {
+        offset: string;
+        length?: string;
+    };
+}): string;
+/** `$?` `$$` `$0`–`$n` `$#` `$@` `$*` — not ordinary `$env:` names. */
+export declare function isSpecialShellVar(name: string): boolean;
 /** Escape text destined for the inside of a PS double-quoted string. */
 export declare function escapeDq(s: string): string;
 /** Normalize a literal POSIX-ish path to its Windows equivalent. */
@@ -39,6 +62,7 @@ export declare function operandExpr(w: Word): string;
 /**
  * `${name[@]}` / `"pre${name[@]}post"` — one argv per element.
  * Unquoted `${name[*]}` also splats (bash); quoted `"${name[*]}"` stays one join.
+ * `$@` / unquoted `$*` splat like `${arr[@]}`; quoted `"$@"` still splats.
  */
 export declare function splatSpec(w: Word): {
     name: string;
@@ -53,6 +77,8 @@ export declare function argListExpr(words: Word[], fn?: (w: Word) => string): st
  * Unquoted command words join non-empty lines with a space (IFS
  * word-split approximation). Handlers often emit one string object, so
  * a bare `$(…)` interpolation would keep those newlines.
+ * Lists (`;` `&&` `||`) reuse translateListInline inside the fx-csub
+ * scriptblock so the newline contract is unchanged.
  */
 export declare function translateCmdSub(cmdText: string, keepNl?: boolean): string;
 export declare function translateSimple(cmd: SimpleCommand, position: PipelineCtx['position'], hasStdin: boolean): string;
@@ -76,7 +102,7 @@ export interface PipelineParts {
     call: string;
 }
 export declare function translatePipelineBody(p: {
-    commands: Array<SimpleCommand | IfCommand | ForCommand>;
+    commands: Array<SimpleCommand | IfCommand | ForCommand | WhileCommand | CaseCommand>;
 }): PipelineParts;
 export interface SegmentPlan {
     op: ';' | '&&' | '||';

package/dist/translator.js

@@ -1,6 +1,7 @@
 import { FauxnixParseError, isUnquotedLiteral, } from './ast.js';
 import { parseCommand } from './parser.js';
 import { lookup, psStr } from './registry.js';
+import { PYTHON3_WINDOWS_HINT, SH_SCRIPT_WINDOWS_HINT } from './errors.js';
 /* ------------------------------------------------------------------ */
 /* Variable mapping                                                    */
 /* ------------------------------------------------------------------ */
@@ -38,8 +39,43 @@ export function paramExpr(name, op, word) {
         psStr('bash: ' + msg) +
         '); $script:fx_exit = 1; \'\' } else { $fx_pv } )');
 }
+function sliceArgExpr(s) {
+    if (s.length > 0 && s[0] === '$') {
+        return '(fx-scalar0 ' + psStr(s.slice(1)) + ')';
+    }
+    return psStr(s);
+}
+export function varExtraOf(p) {
+    if (p.kind !== 'Var')
+        return undefined;
+    if (!p.replace && !p.slice)
+        return undefined;
+    const extra = {};
+    if (p.replace)
+        extra.replace = p.replace;
+    if (p.slice)
+        extra.slice = p.slice;
+    return extra;
+}
 /** Map a bash $VAR name to a PowerShell expression (usable inside $(...)). */
-export function varExpr(name, index, param, length = false) {
+export function varExpr(name, index, param, length = false, extra) {
+    if (extra && extra.replace) {
+        const r = extra.replace;
+        return ('(fx-subst (fx-scalar0 ' +
+            psStr(name) +
+            ') ' +
+            psStr(r.pat) +
+            ' ' +
+            psStr(r.repl) +
+            ' ' +
+            (r.global ? '$true' : '$false') +
+            ')');
+    }
+    if (extra && extra.slice) {
+        const off = sliceArgExpr(extra.slice.offset);
+        const len = extra.slice.length !== undefined ? sliceArgExpr(extra.slice.length) : '$null';
+        return '(fx-slice (fx-scalar0 ' + psStr(name) + ') ' + off + ' ' + len + ')';
+    }
     if (param)
         return paramExpr(name, param.op, param.word);
     if (length) {
@@ -59,6 +95,12 @@ export function varExpr(name, index, param, length = false) {
     if (index !== undefined) {
         return '(fx-subget ' + psStr(name) + ' ' + psStr(index) + ')';
     }
+    if (/^[0-9]+$/.test(name)) {
+        if (name === '0') {
+            return "$(if ($env:FAUXNIX_ARG0) { [string]$env:FAUXNIX_ARG0 } else { 'fauxnix' })";
+        }
+        return '(fx-posget ' + name + ')';
+    }
     switch (name) {
         case 'HOME':
             return '$HOME';
@@ -81,10 +123,24 @@ export function varExpr(name, index, param, length = false) {
             return '[string]$PID';
         case 'HOSTNAME':
             return '$env:COMPUTERNAME';
+        case '#':
+            return '@(fx-posload).Count';
+        case '@':
+        case '*':
+            return '((@(fx-posload) -join (fx-ifs1)))';
         default:
             return '$env:' + name;
     }
 }
+/** `$?` `$$` `$0`–`$n` `$#` `$@` `$*` — not ordinary `$env:` names. */
+export function isSpecialShellVar(name) {
+    return (name === '?' ||
+        name === '$' ||
+        name === '#' ||
+        name === '@' ||
+        name === '*' ||
+        /^[0-9]+$/.test(name));
+}
 /* ------------------------------------------------------------------ */
 /* Word → PowerShell expression                                        */
 /* ------------------------------------------------------------------ */
@@ -154,7 +210,7 @@ export function exprOfWord(w, opts) {
     // single bare variable → bare expression
     if (expanded.length === 1 && expanded[0].kind === 'Var') {
         const v = expanded[0];
-        return varExpr(v.name, v.index, v.param, v.length === true);
+        return varExpr(v.name, v.index, v.param, v.length === true, varExtraOf(v));
     }
     // Bare `$(...)` must not sit inside a PS expandable string: the
     // substitution body contains `"` / `$_` that would break interpolation.
@@ -184,7 +240,7 @@ export function exprOfWord(w, opts) {
                     emitPart(q, true);
                 break;
             case 'Var':
-                out += '$(' + varExpr(p.name, p.index, p.param, p.length === true) + ')';
+                out += '$(' + varExpr(p.name, p.index, p.param, p.length === true, varExtraOf(p)) + ')';
                 break;
             case 'CmdSub':
                 out += '$(' + translateCmdSub(p.cmd, quoted || opts?.preserveCmdSub === true) + ')';
@@ -240,7 +296,7 @@ function arithSourceExpr(parts) {
                     emit(q);
                 break;
             case 'Var':
-                out += '$(' + varExpr(p.name, p.index, p.param, p.length === true) + ')';
+                out += '$(' + varExpr(p.name, p.index, p.param, p.length === true, varExtraOf(p)) + ')';
                 break;
             case 'CmdSub':
                 out += '$(' + translateCmdSub(p.cmd, true) + ')';
@@ -291,6 +347,7 @@ function wordPartsForSplat(w) {
 /**
  * `${name[@]}` / `"pre${name[@]}post"` — one argv per element.
  * Unquoted `${name[*]}` also splats (bash); quoted `"${name[*]}"` stays one join.
+ * `$@` / unquoted `$*` splat like `${arr[@]}`; quoted `"$@"` still splats.
  */
 export function splatSpec(w) {
     const parts = wordPartsForSplat(w);
@@ -301,7 +358,10 @@ export function splatSpec(w) {
     for (const { part: p, quoted } of parts) {
         const splat = p.kind === 'Var' &&
             !p.length &&
-            (p.index === '@' || (p.index === '*' && !quoted));
+            (p.name === '@' ||
+                (p.name === '*' && !quoted) ||
+                p.index === '@' ||
+                (p.index === '*' && !quoted));
         if (splat) {
             if (seen)
                 return null;
@@ -318,6 +378,12 @@ export function splatSpec(w) {
     }
     return name ? { name, prefix, suffix } : null;
 }
+/** Load the splat source: positionals (`@`/`*`) vs named arrays. */
+function splatLoadCall(name) {
+    if (name === '@' || name === '*')
+        return 'fx-posload';
+    return 'fx-arrload ' + psStr(name);
+}
 /** PS expression of a string[]: `@` words splat, others stay one element. */
 export function argListExpr(words, fn = exprOfWord) {
     if (words.length === 0)
@@ -329,9 +395,9 @@ export function argListExpr(words, fn = exprOfWord) {
             if (!s)
                 return '@(' + fn(w) + ')';
             if (!s.prefix && !s.suffix)
-                return '@(fx-arrload ' + psStr(s.name) + ')';
-            return ('@($( $fx_sp = @(fx-arrload ' +
-                psStr(s.name) +
+                return '@(' + splatLoadCall(s.name) + ')';
+            return ('@($( $fx_sp = @(' +
+                splatLoadCall(s.name) +
                 '); if ($fx_sp.Count -eq 0) { $fx_sp = @(' +
                 psStr(s.prefix + s.suffix) +
                 ') } else { $fx_sp[0] = ' +
@@ -352,14 +418,11 @@ export function argListExpr(words, fn = exprOfWord) {
  * Unquoted command words join non-empty lines with a space (IFS
  * word-split approximation). Handlers often emit one string object, so
  * a bare `$(…)` interpolation would keep those newlines.
+ * Lists (`;` `&&` `||`) reuse translateListInline inside the fx-csub
+ * scriptblock so the newline contract is unchanged.
  */
 export function translateCmdSub(cmdText, keepNl = false) {
-    const list = parseCommand(cmdText);
-    if (list.segments.length !== 1) {
-        throw new FauxnixParseError('fauxnix: command substitution with ; && || is not supported yet');
-    }
-    const { defs, call } = translatePipelineBody(list.segments[0].pipeline);
-    const inner = defs ? defs + '\n' + call : call;
+    const inner = translateListInline(parseCommand(cmdText));
     const collected = '(fx-csub { ' + inner + ' })';
     if (keepNl)
         return collected;
@@ -383,11 +446,21 @@ export function translateSimple(cmd, position, hasStdin) {
     // deviation: shell var vs exported var are indistinguishable here).
     if (cmd.name === null) {
         const exportHandler = lookup('export');
-        const words = cmd.assignments.map((a) => [
-            { kind: 'Text', text: a.name + '=' },
-            ...a.value,
-        ]);
-        return exportHandler ? exportHandler(words, { position, hasStdin }) : '';
+        const chunks = [];
+        for (const a of cmd.assignments) {
+            if (a.values) {
+                chunks.push('fx-arrput ' +
+                    psStr(a.name) +
+                    ' ' +
+                    argListExpr(a.values, (w) => exprOfWord(w, { preserveCmdSub: true })));
+            }
+            else {
+                const words = [[{ kind: 'Text', text: a.name + '=' }, ...a.value]];
+                if (exportHandler)
+                    chunks.push(exportHandler(words, { position, hasStdin }));
+            }
+        }
+        return chunks.join('\n');
     }
     const nameLit = literalOfWord(cmd.name);
     const nameSplat = splatSpec(cmd.name);
@@ -404,7 +477,7 @@ export function translateSimple(cmd, position, hasStdin) {
                 redirects: cmd.redirects,
             }, position, hasStdin);
         const emptyCmdLines = [
-            '$fx_cw = @(fx-arrload ' + psStr(nameSplat.name) + ')',
+            '$fx_cw = @(' + splatLoadCall(nameSplat.name) + ')',
         ];
         if (hasAffix) {
             emptyCmdLines.push('if ($fx_cw.Count -eq 0) { $fx_cw = @(' +
@@ -546,10 +619,20 @@ export function wrapTempEnv(sets, body, extra) {
         lines.push(arrSave + '[' + psStr(n) + '] = (fx-arrpackget ' + psStr(n) + ')');
     }
     const valVars = [];
+    const valIsArr = [];
     for (let i = 0; i < sets.length; i++) {
         const vn = '$fx_ev' + id + '_' + i;
         valVars.push(vn);
-        lines.push(vn + ' = ' + exprOfWord(sets[i].value, { preserveCmdSub: true }));
+        if (sets[i].values) {
+            valIsArr.push(true);
+            lines.push(vn +
+                ' = ' +
+                argListExpr(sets[i].values, (w) => exprOfWord(w, { preserveCmdSub: true })));
+        }
+        else {
+            valIsArr.push(false);
+            lines.push(vn + ' = ' + exprOfWord(sets[i].value, { preserveCmdSub: true }));
+        }
     }
     lines.push('try {');
     for (const u of unsets) {
@@ -575,6 +658,10 @@ export function wrapTempEnv(sets, body, extra) {
     for (let i = 0; i < sets.length; i++) {
         const n = sets[i].name;
         const nq = n.replace(/'/g, "''");
+        if (valIsArr[i]) {
+            lines.push('  fx-arrput ' + psStr(n) + ' ' + valVars[i]);
+            continue;
+        }
         lines.push('  $env:' + n + ' = ' + valVars[i]);
         lines.push('  fx-arrdrop ' + psStr(n));
         lines.push("  $env:FAUXNIX_SETVARS = ((@($env:FAUXNIX_SETVARS -split ';' | Where-Object { $_ -ne '' -and $_ -cne '" +
@@ -752,6 +839,22 @@ function translateIf(cmd) {
     lines.push('}');
     return lines.join('\n');
 }
+function translateCase(cmd) {
+    const lines = ['$script:fx_exit = 0', '$fx_cw = ' + exprOfWord(cmd.word)];
+    for (let i = 0; i < cmd.arms.length; i++) {
+        const arm = cmd.arms[i];
+        const pats = arm.patterns.map((w) => exprOfWord(w)).join(',');
+        const head = i === 0 ? 'if' : 'elseif';
+        lines.push(head + ' (fx-casematch $fx_cw @(' + pats + ')) {');
+        const body = translateListInline(arm.body);
+        if (body) {
+            for (const l of body.split('\n'))
+                lines.push(l ? '  ' + l : l);
+        }
+        lines.push('}');
+    }
+    return lines.join('\n');
+}
 function translateFor(cmd) {
     const n = cmd.name.replace(/'/g, "''");
     const lines = [
@@ -779,6 +882,22 @@ function translateFor(cmd) {
     lines.push('}');
     return lines.join('\n');
 }
+function translateWhile(cmd) {
+    // Bash: last executed body owns status; a test that ends the loop does not.
+    // Never-entered loops (`while false; do …; done`, `until true; do …; done`)
+    // exit 0. Save the body status and restore it on the failing test.
+    const fail = cmd.until ? '$script:fx_exit -eq 0' : '$script:fx_exit -ne 0';
+    const lines = ['$fx_wst = 0', 'do {'];
+    for (const l of translateListInline(cmd.test).split('\n'))
+        lines.push(l ? '  ' + l : l);
+    lines.push('  if (' + fail + ') { $script:fx_exit = $fx_wst; break }');
+    lines.push('  $script:fx_exit = 0');
+    for (const l of translateListInline(cmd.body).split('\n'))
+        lines.push(l ? '  ' + l : l);
+    lines.push('  $fx_wst = $script:fx_exit');
+    lines.push('} while ($true)');
+    return lines.join('\n');
+}
 function stdinTarget(c) {
     let t = null;
     for (const r of c.redirects) {
@@ -793,7 +912,24 @@ function stdinReadExpr(target) {
         return '@()';
     return '@(fx-readlines ' + pathExpr(n) + ')';
 }
+/** `>` `>>` `&>` `&>>` — Node last-stage apply cannot honor these on earlier stages. */
+function isStdoutFileRedirect(op) {
+    return op === '>' || op === '>>' || op === '&>' || op === '&>>';
+}
+const NONLAST_STDOUT_REDIRECT_MSG = 'fauxnix: stdout redirect on a non-last pipeline stage is not supported yet; write the file in a previous list segment (cmd >f; cat f) or wait for per-stage fds (#157)';
+function rejectNonLastStdoutRedirects(commands) {
+    if (commands.length < 2)
+        return;
+    for (let i = 0; i < commands.length - 1; i++) {
+        if (commands[i].redirects.some((r) => isStdoutFileRedirect(r.op))) {
+            throw new FauxnixParseError(NONLAST_STDOUT_REDIRECT_MSG);
+        }
+    }
+}
 export function translatePipelineBody(p) {
+    // Last-stage `>` is Node apply; a non-last `>` would truncate the file and
+    // still feed the pipe. Fail loud until in-stage writes (#157).
+    rejectNonLastStdoutRedirects(p.commands);
     // Every pipeline stage needs its own status slot. Handlers deliberately use
     // `$script:fx_exit` because their helper functions run in child scopes; in a
     // pipeline that shared flag lets an earlier failure leak into a successful
@@ -809,6 +945,10 @@ export function translatePipelineBody(p) {
             bodies.push(translateIf(c));
         else if (c.kind === 'For')
             bodies.push(translateFor(c));
+        else if (c.kind === 'While')
+            bodies.push(translateWhile(c));
+        else if (c.kind === 'Case')
+            bodies.push(translateCase(c));
         else
             bodies.push(translateSimple(c, position, hasStdin));
     }
@@ -912,6 +1052,10 @@ const WRAP_HELPER_ORDER = [
     'fx-csub',
     'fx-svenc',
     'fx-svdec',
+    'fx-posload',
+    'fx-posset',
+    'fx-posget',
+    'fx-posshift',
     'fx-arrload',
     'fx-scalar0',
     'fx-ifs1',
@@ -922,6 +1066,9 @@ const WRAP_HELPER_ORDER = [
     'fx-arrput',
     'fx-arrclr',
     'fx-subget',
+    'fx-casematch',
+    'fx-subst',
+    'fx-slice',
     'fx-winargv',
     'fx-native',
 ];
@@ -930,6 +1077,10 @@ const WRAP_HELPER_DEPS = {
     'fx-csub': [],
     'fx-svenc': [],
     'fx-svdec': [],
+    'fx-posload': ['fx-svdec'],
+    'fx-posset': ['fx-svenc'],
+    'fx-posget': ['fx-posload'],
+    'fx-posshift': ['fx-posload', 'fx-posset'],
     'fx-arrload': ['fx-scalar0', 'fx-svdec'],
     'fx-scalar0': ['fx-svdec'],
     'fx-ifs1': ['fx-scalar0'],
@@ -940,6 +1091,9 @@ const WRAP_HELPER_DEPS = {
     'fx-arrput': ['fx-arrdrop', 'fx-svenc'],
     'fx-arrclr': ['fx-arrdrop'],
     'fx-subget': ['fx-arrload', 'fx-ifs1'],
+    'fx-casematch': [],
+    'fx-subst': [],
+    'fx-slice': [],
     'fx-winargv': [],
     'fx-native': ['fx-winargv'],
 };
@@ -1057,7 +1211,16 @@ export function wrapScript(body, opts = {}) {
             '  $script:fx_csub = $true',
             '  try { $fx_o = @(& $b | ForEach-Object { [string]$_ }) }',
             '  finally { $script:fx_csub = $fx_prevcs }',
-            '  $fx_s = ($fx_o -join [string][char]10)',
+            // Line items (no trailing NL) get a NL between them. Chunks that
+            // already end in NL concatenate, so $(echo a; echo b) is a\nb.
+            "  $fx_s = ''",
+            '  foreach ($fx_x in $fx_o) {',
+            '    $fx_t = [string]$fx_x',
+            '    if ($fx_s.Length -gt 0 -and $fx_s[$fx_s.Length - 1] -ne [char]10) {',
+            '      $fx_s += [string][char]10',
+            '    }',
+            '    $fx_s += $fx_t',
+            '  }',
             '  while ($fx_s.Length -gt 0 -and $fx_s[$fx_s.Length - 1] -eq [char]10) {',
             '    $fx_s = $fx_s.Substring(0, $fx_s.Length - 1)',
             '  }',
@@ -1088,6 +1251,52 @@ export function wrapScript(body, opts = {}) {
             '  return [string]$sb',
             '}',
         ],
+        'fx-posload': [
+            'function fx-posload {',
+            '  if ($null -eq $env:FAUXNIX_POS -or [string]$env:FAUXNIX_POS -eq \'\') { return @() }',
+            '  $out = @()',
+            '  foreach ($el in @($env:FAUXNIX_POS -split [string][char]30)) { $out += ,(fx-svdec $el) }',
+            '  return $out',
+            '}',
+        ],
+        'fx-posset': [
+            'function fx-posset($vals) {',
+            '  if ($null -eq $vals) { $vals = @() }',
+            '  $vals = @($vals)',
+            '  if ($vals.Count -eq 0) { $env:FAUXNIX_POS = \'\'; return }',
+            '  $encs = @(); foreach ($v in $vals) { $encs += (fx-svenc $v) }',
+            '  $env:FAUXNIX_POS = ($encs -join [string][char]30)',
+            '}',
+        ],
+        'fx-posget': [
+            'function fx-posget($i) {',
+            '  $arr = @(fx-posload)',
+            '  $n = 0',
+            '  if (-not [int]::TryParse([string]$i, [ref]$n)) { return \'\' }',
+            '  if ($n -lt 1 -or $n -gt $arr.Count) { return \'\' }',
+            '  return [string]$arr[$n - 1]',
+            '}',
+        ],
+        'fx-posshift': [
+            'function fx-posshift($n) {',
+            '  $arr = @(fx-posload)',
+            '  $i = 1',
+            '  if ($null -ne $n -and [string]$n -ne \'\') {',
+            '    $parsed = 0',
+            '    if (-not [int]::TryParse([string]$n, [ref]$parsed)) {',
+            '      [Console]::Error.WriteLine(\'bash: shift: \' + [string]$n + \': numeric argument required\')',
+            '      $script:fx_exit = 1',
+            '      return',
+            '    }',
+            '    $i = $parsed',
+            '  }',
+            '  if ($i -lt 0 -or $i -gt $arr.Count) { $script:fx_exit = 1; return }',
+            '  if ($i -eq 0) { return }',
+            '  if ($i -eq $arr.Count) { fx-posset @(); return }',
+            '  $new = @($arr[$i..($arr.Count - 1)])',
+            '  fx-posset $new',
+            '}',
+        ],
         'fx-arrload': [
             'function fx-arrload($n) {',
             '  $n = [string]$n',
@@ -1095,8 +1304,10 @@ export function wrapScript(body, opts = {}) {
             '    $fx_eq = $fx_pair.IndexOf([char]61)',
             '    if ($fx_eq -lt 1) { continue }',
             '    if ($fx_pair.Substring(0, $fx_eq) -cne $n) { continue }',
+            '    $pay = $fx_pair.Substring($fx_eq + 1)',
+            '    if ($pay -eq [string][char]1) { return @() }',
             '    $out = @()',
-            '    foreach ($el in @($fx_pair.Substring($fx_eq + 1) -split [string][char]30)) { $out += ,(fx-svdec $el) }',
+            '    foreach ($el in @($pay -split [string][char]30)) { $out += ,(fx-svdec $el) }',
             '    return $out',
             '  }',
             '  $s0 = fx-scalar0 $n',
@@ -1178,9 +1389,12 @@ export function wrapScript(body, opts = {}) {
         'fx-arrput': [
             'function fx-arrput($n, $vals) {',
             '  $n = [string]$n',
-            '  $vals = @($vals)',
+            '  if ($null -eq $vals) { $vals = @() } else { $vals = @($vals) }',
             '  fx-arrdrop $n',
-            '  if ($vals.Count -eq 0) { } else {',
+            '  if ($vals.Count -eq 0) {',
+            // SOH payload: empty array, distinct from scalar '' and from A=('')
+            "    $env:FAUXNIX_ARRS = ((@($env:FAUXNIX_ARRS -split [string][char]10 | Where-Object { $_ -ne '' }) + ($n + [string][char]61 + [string][char]1)) -join [string][char]10)",
+            '  } else {',
             '    $encs = @(); foreach ($v in $vals) { $encs += (fx-svenc $v) }',
             "    $env:FAUXNIX_ARRS = ((@($env:FAUXNIX_ARRS -split [string][char]10 | Where-Object { $_ -ne '' }) + ($n + [string][char]61 + ($encs -join [string][char]30))) -join [string][char]10)",
             '  }',
@@ -1215,9 +1429,74 @@ export function wrapScript(body, opts = {}) {
             '  return [string]$arr[$i]',
             '}',
         ],
+        'fx-casematch': [
+            'function fx-casematch($w, $pats) {',
+            '  $w = [string]$w',
+            '  foreach ($p in @($pats)) {',
+            '    $pat = [string]$p',
+            '    try {',
+            '      $wp = [WildcardPattern]::new($pat, [System.Management.Automation.WildcardOptions]::None)',
+            '      if ($wp.IsMatch($w)) { return $true }',
+            '    } catch {}',
+            '  }',
+            '  return $false',
+            '}',
+        ],
+        'fx-subst': [
+            'function fx-subst($s, $pat, $repl, $all) {',
+            '  if ($null -eq $s) { return \'\' }',
+            '  $s = [string]$s',
+            '  $pat = [string]$pat',
+            '  $repl = [string]$repl',
+            '  if ($pat -eq \'\') { return $s }',
+            '  $glob = $false',
+            '  foreach ($fx_c in $pat.ToCharArray()) {',
+            '    if ($fx_c -eq [char]42 -or $fx_c -eq [char]63) { $glob = $true; break }',
+            '  }',
+            '  if (-not $glob) {',
+            '    if ($all) { return $s.Replace($pat, $repl) }',
+            '    $i = $s.IndexOf($pat)',
+            '    if ($i -lt 0) { return $s }',
+            '    return $s.Substring(0, $i) + $repl + $s.Substring($i + $pat.Length)',
+            '  }',
+            '  $sb = New-Object System.Text.StringBuilder',
+            '  foreach ($fx_c in $pat.ToCharArray()) {',
+            '    if ($fx_c -eq [char]42) { [void]$sb.Append(\'.*\'); continue }',
+            '    if ($fx_c -eq [char]63) { [void]$sb.Append(\'.\'); continue }',
+            '    [void]$sb.Append([regex]::Escape([string]$fx_c))',
+            '  }',
+            '  $rx = New-Object System.Text.RegularExpressions.Regex($sb.ToString(), [System.Text.RegularExpressions.RegexOptions]::Singleline)',
+            '  $fx_rep = $repl.Replace([string][char]36, ([string][char]36 + [string][char]36))',
+            '  if ($all) { return $rx.Replace($s, $fx_rep) }',
+            '  return $rx.Replace($s, $fx_rep, 1)',
+            '}',
+        ],
+        'fx-slice': [
+            'function fx-slice($s, $off, $len) {',
+            '  if ($null -eq $s) { return \'\' }',
+            '  $s = [string]$s',
+            '  $n = $s.Length',
+            '  $o = 0',
+            '  if (-not [int]::TryParse([string]$off, [ref]$o)) { return \'\' }',
+            '  if ($o -lt 0) { $o = $n + $o }',
+            '  if ($o -lt 0 -or $o -ge $n) { return \'\' }',
+            '  if ($null -eq $len -or [string]$len -eq \'\') { return $s.Substring($o) }',
+            '  $l = 0',
+            '  if (-not [int]::TryParse([string]$len, [ref]$l)) { return \'\' }',
+            '  if ($l -lt 0) {',
+            '    $fx_end = $n + $l',
+            '    if ($fx_end -lt $o) { return \'\' }',
+            '    $l = $fx_end - $o',
+            '  }',
+            '  if ($l -le 0) { return \'\' }',
+            '  if (($o + $l) -gt $n) { $l = $n - $o }',
+            '  return $s.Substring($o, $l)',
+            '}',
+        ],
         'fx-winargv': [
-            'function fx-winargv($argv) {',
+            'function fx-winargv($argv, $cmdmeta) {',
             // Empty [object[]] unwraps to $null on PS 5.1; @($null) is one empty arg.
+            // $cmdmeta: also quote & | () <> ^ so cmd.exe /c does not split the tail.
             '  if ($null -eq $argv) { $argv = @() }',
             '  $parts = New-Object System.Collections.Generic.List[string]',
             '  foreach ($a in @($argv)) {',
@@ -1226,6 +1505,7 @@ export function wrapScript(body, opts = {}) {
             '    $need = $false',
             '    foreach ($ch in $s.ToCharArray()) {',
             "      if ($ch -eq ' ' -or $ch -eq ([char]9) -or $ch -eq [char]34) { $need = $true; break }",
+            "      if ($cmdmeta -and ($ch -eq '&' -or $ch -eq '|' -or $ch -eq '(' -or $ch -eq ')' -or $ch -eq '<' -or $ch -eq '>' -or $ch -eq '^')) { $need = $true; break }",
             '    }',
             '    if (-not $need) { $parts.Add($s); continue }',
             '    $sb = New-Object System.Text.StringBuilder',
@@ -1259,7 +1539,14 @@ export function wrapScript(body, opts = {}) {
             // operator is only for names that are not executables.
             '    $cmd = Get-Command -Name $name -ErrorAction SilentlyContinue | Select-Object -First 1',
             '    if ($null -eq $cmd) {',
-            "      [Console]::Error.WriteLine('bash: ' + $name + ': command not found')",
+            "      $fx_nf = 'bash: ' + $name + ': command not found'",
+            "      $fx_n = [string]$name",
+            // Hint only — never alias python3→python (wrong interpreter).
+            "      if ($fx_n -eq 'python3' -or $fx_n -eq 'python3.exe') { $fx_nf += '" +
+                PYTHON3_WINDOWS_HINT +
+                "' }",
+            "      elseif ($fx_n -like '*.sh') { $fx_nf += '" + SH_SCRIPT_WINDOWS_HINT + "' }",
+            '      [Console]::Error.WriteLine($fx_nf)',
             '      $script:fx_exit = 127',
             '      return',
             '    }',
@@ -1272,6 +1559,8 @@ export function wrapScript(body, opts = {}) {
             '  $psi = New-Object System.Diagnostics.ProcessStartInfo',
             '  $ext = [IO.Path]::GetExtension([string]$app.Source)',
             // CreateProcess cannot launch .cmd/.bat with UseShellExecute=false (npm.cmd).
+            // /s strips one outer quote pair from the /c tail; CRT-quote cmd
+            // metacharacters so `&`/`|`/`()` do not start a second command.
             "  if ($ext -eq '.cmd' -or $ext -eq '.bat') {",
             '    $comspec = Get-Command -Name cmd -CommandType Application -ErrorAction SilentlyContinue | Select-Object -First 1',
             '    if ($null -eq $comspec) {',
@@ -1280,8 +1569,10 @@ export function wrapScript(body, opts = {}) {
             '      return',
             '    }',
             '    $psi.FileName = $comspec.Source',
-            '    $fx_rest = fx-winargv $argv',
-            "    if ($fx_rest.Length -gt 0) { $psi.Arguments = '/d /s /c ' + (fx-winargv $app.Source) + ' ' + $fx_rest } else { $psi.Arguments = '/d /s /c ' + (fx-winargv $app.Source) }",
+            '    $fx_app = fx-winargv $app.Source $true',
+            '    $fx_rest = fx-winargv $argv $true',
+            "    if ($fx_rest.Length -gt 0) { $fx_tail = $fx_app + ' ' + $fx_rest } else { $fx_tail = $fx_app }",
+            '    $psi.Arguments = \'/d /s /c "\' + $fx_tail + \'"\'',
             '  } else {',
             '    $psi.FileName = $app.Source',
             '    $psi.Arguments = fx-winargv $argv',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fauxnix-cli",
-  "version": "0.9.2",
+  "version": "0.11.0",
   "description": "Fauxnix — run Linux-style commands on Windows via deterministic PowerShell translation. No VM, no WSL. MCP server + CLI for AI agents.",
   "type": "module",
   "bin": {