@poe-platform/safe-bash 0.1.803 → 0.1.804

package/dist/safe-bash/command-chunks/{chunk-LWSBAWLT.js → chunk-TXI64OAG.js}

@@ -1,6 +1,6 @@
 import {
   Parser
-} from "./chunk-LWS62ISU.js";
+} from "./chunk-N6DIASO2.js";
 import {
   init_buffer
 } from "./chunk-HX3SHTCE.js";

package/dist/safe-bash/command-chunks/{chunk-GIRNFXP3.js → chunk-TZRI7BJZ.js}

@@ -33,6 +33,7 @@ function parse(args) {
   let terse = false;
   let format;
   let printf = false;
+  let bsd = false;
   let literal = false;
   const paths = [];
   for (let index = 0; index < args.length; index++) {
@@ -44,25 +45,35 @@ function parse(args) {
     else if (argument === "--file-system") filesystem = true;
     else if (argument === "--terse") terse = true;
     else if (argument === "--format" || argument.startsWith("--format=") || argument === "--printf" || argument.startsWith("--printf=")) {
+      bsd = false;
       printf = argument.startsWith("--printf");
       format = argument.includes("=") ? argument.slice(argument.indexOf("=") + 1) : args[++index];
       if (format === void 0) throw new UsageError(`missing format for '${argument}'`);
     } else if (!argument.startsWith("--")) {
       for (let offset = 1; offset < argument.length; offset++) {
         if (argument[offset] === "L") follow = true;
-        else if (argument[offset] === "f") filesystem = true;
-        else if (argument[offset] === "t") terse = true;
+        else if (argument[offset] === "f") {
+          const next = args[index + 1];
+          const formatOption = next?.startsWith("-c") || next?.startsWith("--format=") || next?.startsWith("--printf=");
+          if (offset === argument.length - 1 && next?.includes("%") && !formatOption && index + 2 < args.length) {
+            format = args[++index];
+            bsd = true;
+            filesystem = false;
+            printf = false;
+          } else filesystem = true;
+        } else if (argument[offset] === "t") terse = true;
         else if (argument[offset] === "c") {
           format = argument.slice(offset + 1) || args[++index];
           if (format === void 0) throw new UsageError("missing format for '-c'");
           printf = false;
+          bsd = false;
           break;
         } else throw new UsageError(`unrecognized option '${argument}'`);
       }
     } else throw new UsageError(`unrecognized option '${argument}'`);
   }
   requireOperands(paths);
-  return { follow, filesystem, terse, format, printf, paths };
+  return { follow, filesystem, terse, format, printf, paths, bsd };
 }
 function quoted(text, style) {
   if (style === "literal") return text;
@@ -113,7 +124,7 @@ function epoch(milliseconds, precision) {
   const suffix = precision ? "." + fraction.toString().padStart(places, "0") + "0".repeat(precision - places) : "";
   return `${value < 0 ? "-" : ""}${seconds}${suffix}`;
 }
-function directive(format, start) {
+function directive(format, start, bsd) {
   let index = start + 1;
   const flagsStart = index;
   while (index < format.length && "-+ #0".includes(format[index])) index++;
@@ -127,7 +138,15 @@ function directive(format, start) {
     while (index < format.length && format[index] >= "0" && format[index] <= "9") index++;
     precision = format.slice(precisionStart, index);
   }
-  const code = format[index];
+  let code = format[index];
+  if (bsd && code !== void 0) {
+    const pair = format.slice(index, index + 2);
+    const mapping = { z: "s", N: "n", m: "Y", a: "X", c: "Z", B: "W", Lp: "a", Sp: "A", u: "u", Su: "U", g: "g", Sg: "G", i: "i", l: "h", HT: "bsdType", Y: "bsdTarget", "%": "%" };
+    const key = Object.hasOwn(mapping, pair) ? pair : code;
+    if (!Object.hasOwn(mapping, key)) throw new UsageError(`unsupported BSD stat format: %${key}`);
+    code = mapping[key];
+    index += key.length - 1;
+  }
   if (code === void 0) throw new UsageError("invalid stat format directive");
   const codePoint = code.charCodeAt(0);
   if (code !== "%" && !(codePoint >= 65 && codePoint <= 90) && !(codePoint >= 97 && codePoint <= 122)) {
@@ -159,7 +178,7 @@ function formatField(text, code, flags, width, precision, numeric, epoch2) {
   }
   return concatBytes([allocSpaces(padding), bytes]);
 }
-async function render(context, path, name, stat, format, escapes, limit, filesystem, terse) {
+async function render(context, path, name, stat, format, escapes, limit, filesystem, terse, bsd) {
   const chunks = [];
   let bytes = 0;
   const append = (text) => {
@@ -203,7 +222,7 @@ async function render(context, path, name, stat, format, escapes, limit, filesys
       index += point.length;
       continue;
     }
-    const parsed = directive(format, index);
+    const parsed = directive(format, index, bsd);
     index += parsed.length;
     const { code, flags } = parsed;
     const width = Number(parsed.width || 0);
@@ -232,8 +251,15 @@ async function render(context, path, name, stat, format, escapes, limit, filesys
     if (Object.hasOwn(times, code)) {
       text = terse && times[code] === void 0 ? "?" : epoch(available(times[code], code), precision ?? 0);
       numeric = text !== "?";
-    } else if (code === "n") text = name;
-    else if (code === "N") {
+    } else if (code === "bsdType") text = stat.type === "directory" ? "Directory" : stat.type === "symlink" ? "Symbolic Link" : stat.type === "character" ? "Character Device" : "Regular File";
+    else if (code === "n") text = name;
+    else if (code === "bsdTarget") {
+      text = "";
+      if (stat.type === "symlink") {
+        if (!context.fs.readlink) throw new FsError("ENOTSUP", { syscall: "readlink", path });
+        text = await context.fs.readlink(path, { signal: context.signal });
+      }
+    } else if (code === "N") {
       text = quoted(name, context.env.QUOTING_STYLE);
       if (stat.type === "symlink") {
         if (!context.fs.readlink) throw new FsError("ENOTSUP", { syscall: "readlink", path });
@@ -292,7 +318,7 @@ function createStatCommand(configuration = {}) {
         const terse = parsed.terse && parsed.format === void 0;
         if (terse && parsed.filesystem) throw new FsError("ENOTSUP", { message: "filesystem terse stat is unsupported" });
         const format = parsed.format ?? (parsed.filesystem ? "  File: %n\n  Type: %T" : terse ? "%n %s %b %f %u %g %D %i %h %t %T %X %Y %Z %W %o" : "  File: %N\n  Size: %s	Type: %F\n  Mode: %a (%A)\nAccess: %x\nModify: %y\nChange: %z\n Birth: %w");
-        const text = await render(context, path, name, stat, format, parsed.printf, configured.limits.maxOutputBytes, parsed.filesystem, terse);
+        const text = await render(context, path, name, stat, format, parsed.printf, configured.limits.maxOutputBytes, parsed.filesystem, terse, parsed.bsd);
         await budget.output(parsed.printf ? text : concatBytes([text, Uint8Array.of(10)]));
       } catch (error) {
         context.signal.throwIfAborted();
@@ -305,7 +331,7 @@ function createStatCommand(configuration = {}) {
   });
 }
 var syncStatDecoder = new TextDecoder("utf-8", { fatal: false });
-function renderSync(path, name, stat, format, escapes, limit, filesystem, terse, quotingStyle) {
+function renderSync(path, name, stat, format, escapes, limit, filesystem, terse, quotingStyle, bsd) {
   const chunks = [];
   let bytes = 0;
   const append = (text) => {
@@ -348,7 +374,7 @@ function renderSync(path, name, stat, format, escapes, limit, filesystem, terse,
       index += point.length;
       continue;
     }
-    const parsed = directive(format, index);
+    const parsed = directive(format, index, bsd);
     index += parsed.length;
     const { code, flags } = parsed;
     const width = Number(parsed.width || 0);
@@ -377,8 +403,12 @@ function renderSync(path, name, stat, format, escapes, limit, filesystem, terse,
     if (Object.hasOwn(times, code)) {
       text = terse && times[code] === void 0 ? "?" : epoch(available(times[code], code), precision ?? 0);
       numeric = text !== "?";
-    } else if (code === "n") text = name;
-    else if (code === "N") {
+    } else if (code === "bsdType") text = stat.type === "directory" ? "Directory" : stat.type === "symlink" ? "Symbolic Link" : stat.type === "character" ? "Character Device" : "Regular File";
+    else if (code === "n") text = name;
+    else if (code === "bsdTarget") {
+      if (stat.type === "symlink" && stat.target === void 0) throw new FsError("ENOTSUP", { syscall: "readlink", path });
+      text = stat.type === "symlink" ? stat.target : "";
+    } else if (code === "N") {
       text = quoted(name, quotingStyle);
       if (stat.type === "symlink") {
         if (stat.target === void 0) throw new FsError("ENOTSUP", { syscall: "readlink", path });
@@ -451,7 +481,7 @@ function evalSyncStat(args, cwd, quotingStyle, inspectStat) {
     if (terse && parsed.filesystem) return void 0;
     const format = parsed.format ?? (parsed.filesystem ? "  File: %n\n  Type: %T" : terse ? "%n %s %b %f %u %g %D %i %h %t %T %X %Y %Z %W %o" : "  File: %N\n  Size: %s	Type: %F\n  Mode: %a (%A)\nAccess: %x\nModify: %y\nChange: %z\n Birth: %w");
     try {
-      const rendered = renderSync(abs, name, stat, format, parsed.printf, 262144, parsed.filesystem, terse, quotingStyle);
+      const rendered = renderSync(abs, name, stat, format, parsed.printf, 262144, parsed.filesystem, terse, quotingStyle, parsed.bsd);
       outChunks.push(parsed.printf ? rendered : concatBytes([rendered, Uint8Array.of(10)]));
     } catch {
       return void 0;

package/dist/safe-bash/command-chunks/{chunk-QOKBZFFD.js → chunk-U3MMODA5.js}

@@ -27,22 +27,17 @@ var Budget = class {
   workTotal = 0;
   maxWorkLimit;
   _signal;
-  _aborted = false;
   get signal() {
     return this._signal;
   }
   set signal(value) {
     this._signal = value;
-    this._aborted = value.aborted;
-    if (!this._aborted) value.addEventListener("abort", () => {
-      this._aborted = true;
-    }, { once: true });
   }
   get aborted() {
-    return this._aborted;
+    return this._signal.aborted;
   }
   check() {
-    if (this._aborted) this._signal.throwIfAborted();
+    this._signal.throwIfAborted();
   }
   bound(name, value) {
     this.check();

package/dist/safe-bash/command-chunks/{chunk-ZYHTWNAE.js → chunk-UAW423ZL.js}

@@ -1,6 +1,3 @@
-import {
-  recurse
-} from "./chunk-PTT3I223.js";
 import {
   splitRegex
 } from "./chunk-VSRGNQCP.js";
@@ -9,12 +6,12 @@ import {
   scanRegex,
   substituteRegex
 } from "./chunk-KQLD3AED.js";
-import {
-  formatValue
-} from "./chunk-BPE5INLI.js";
 import {
   indices
 } from "./chunk-4BB2SWJ5.js";
+import {
+  recurse
+} from "./chunk-PTT3I223.js";
 import {
   capture
 } from "./chunk-CQTRW45K.js";
@@ -25,7 +22,7 @@ import {
   strftime,
   strptime,
   toDateIso8601
-} from "./chunk-GMIHJYDG.js";
+} from "./chunk-M32HFSX7.js";
 import {
   delpaths
 } from "./chunk-OYYV7ZAF.js";
@@ -46,6 +43,9 @@ import {
 import {
   splitString
 } from "./chunk-HMOZ6XVJ.js";
+import {
+  formatValue
+} from "./chunk-BPE5INLI.js";
 import {
   JqParseError,
   measureValue,
@@ -1070,10 +1070,10 @@ var Interpreter = class _Interpreter {
     const length = input === null ? 0 : input.length;
     const size = remove2 ? Math.max(0, length - 1) : Math.max(length, key + 1);
     this.budget.collection(size);
-    if (!Number.isSafeInteger(size) || size > 1e6) throw new JqLimitError("maxCollectionSize");
+    if (!Number.isSafeInteger(size)) throw new JqLimitError("maxCollectionSize");
     const padding = remove2 ? 0 : Math.max(0, key - length);
     const minimumBytes = size ? 2 * size + 1 + 3 * padding : 2;
-    if (minimumBytes > Math.min(this.budget.limits.maxValueBytes, 16 * 1024 * 1024)) throw new JqLimitError("maxValueBytes");
+    if (minimumBytes > this.budget.limits.maxValueBytes) throw new JqLimitError("maxValueBytes");
     const result = [];
     if (input !== null) for (const item of input) {
       {
@@ -1255,8 +1255,8 @@ var Interpreter = class _Interpreter {
       yield mktime(input);
       return;
     }
-    if (name === "strftime" || name === "strptime") {
-      for await (const format of this.run(args[0], input)) yield name === "strftime" ? strftime(input, format, budget) : strptime(input, format, budget);
+    if (name === "strftime" || name === "strflocaltime" || name === "strptime") {
+      for await (const format of this.run(args[0], input)) yield name === "strptime" ? strptime(input, format, budget) : strftime(input, format, budget, name === "strflocaltime");
       return;
     }
     if (name === "fromdateiso8601" || name === "fromdate") {

package/dist/safe-bash/command-chunks/{chunk-C5YYCQHW.js → chunk-UXEEUGOV.js}

@@ -1,7 +1,7 @@
 import {
   parseSelection,
   resolveSelection
-} from "./chunk-LCF3OB7P.js";
+} from "./chunk-RBME3JEH.js";
 import {
   Writer
 } from "./chunk-VM2ZMWHQ.js";
@@ -10,21 +10,21 @@ import {
   outputOperation,
   preflight,
   publish
-} from "./chunk-JDYXY44P.js";
+} from "./chunk-FJURV46Y.js";
 import {
   checkedAdd,
   inferDelimiter,
   unsigned
-} from "./chunk-Z45N42QC.js";
+} from "./chunk-DPAYAVMS.js";
 import {
   boundedSort
 } from "./chunk-HEYKESED.js";
 import {
   Scanner
-} from "./chunk-E55UKBIE.js";
+} from "./chunk-DBAT3IK2.js";
 import {
   XanError
-} from "./chunk-QOKBZFFD.js";
+} from "./chunk-U3MMODA5.js";
 import {
   init_buffer
 } from "./chunk-HX3SHTCE.js";
@@ -510,6 +510,214 @@ async function* concatenate(args, scope, budget, writer) {
   }
 }
 
+// packages/safe-bash-command-xan/src/presentation.ts
+init_buffer();
+import { escapeText } from "../../safe-bash-contracts/escaping.js";
+import { widthOf } from "../../safe-bash-command-column/display.js";
+
+// packages/safe-bash-command-xan/src/expression.ts
+init_buffer();
+async function expressions(text, header, noHeaders, budget) {
+  budget.bound("maxSelectorBytes", await budget.textSize(text));
+  budget.hold(text.length * 4);
+  let offset = 0;
+  const space = () => {
+    while (" 	\r\n".includes(text[offset] ?? "\0")) {
+      offset++;
+      budget.work();
+    }
+  };
+  const identifier = () => {
+    const start = offset;
+    while (offset < text.length) {
+      const c = text.charCodeAt(offset);
+      if (!(c >= 65 && c <= 90 || c >= 97 && c <= 122 || c === 95 || offset > start && c >= 48 && c <= 57)) break;
+      offset++;
+      budget.work();
+    }
+    return text.slice(start, offset);
+  };
+  const numeric = (value) => {
+    const number = typeof value === "number" ? value : decimalNumber(value, budget);
+    if (number === void 0 || !Number.isFinite(number)) throw new XanError("expression requires a finite number");
+    return number;
+  };
+  const parse = (minimum, depth) => {
+    budget.bound("maxSelectorDepth", depth);
+    if (depth > 128) throw new XanError("expression nesting is too deep");
+    budget.add("maxSelectorNodes", 1);
+    budget.hold(64);
+    space();
+    let left;
+    const char = text[offset];
+    if (char === "+" || char === "-") {
+      offset++;
+      const inner = parse(3, depth + 1);
+      left = (row) => (char === "-" ? -1 : 1) * numeric(inner(row));
+    } else if (char === "(") {
+      offset++;
+      left = parse(0, depth + 1);
+      space();
+      if (text[offset++] !== ")") throw new XanError("expected closing parenthesis");
+    } else if (char === "'" || char === '"') {
+      offset++;
+      let value = "";
+      while (offset < text.length && text[offset] !== char) {
+        budget.work();
+        value += text[offset++];
+      }
+      if (text[offset++] !== char) throw new XanError("unclosed expression string");
+      left = () => value;
+    } else if (char !== void 0 && (char >= "0" && char <= "9" || char === ".")) {
+      const start = offset;
+      while (offset < text.length && "0123456789.eE".includes(text[offset])) {
+        const previous = text[offset++];
+        budget.work();
+        if ((previous === "e" || previous === "E") && (text[offset] === "+" || text[offset] === "-")) offset++;
+      }
+      const value = decimalNumber(text.slice(start, offset), budget);
+      if (value === void 0) throw new XanError("invalid expression number");
+      left = () => value;
+    } else {
+      const name = identifier();
+      if (!name) throw new XanError("expected expression");
+      let column = -1;
+      if (!noHeaders) for (let i = 0; i < (header?.width ?? 0); i++) {
+        budget.work();
+        if (cellText(header.cells[i].decoded.view(), budget) === name) {
+          column = i;
+          break;
+        }
+      }
+      if (column < 0) throw new XanError(`unknown expression column: ${name}`);
+      left = (row) => cellText(row.cells[column].decoded.view(), budget);
+    }
+    let chainDepth = depth;
+    while (true) {
+      space();
+      const operator = text[offset] ?? "";
+      const precedence = operator === "+" || operator === "-" ? 1 : operator === "*" || operator === "/" || operator === "%" ? 2 : -1;
+      if (precedence < minimum) break;
+      budget.bound("maxSelectorDepth", ++chainDepth);
+      if (chainDepth > 128) throw new XanError("expression nesting is too deep");
+      offset++;
+      const right = parse(precedence + 1, depth + 1), previous = left;
+      left = (row) => {
+        budget.work();
+        const a = numeric(previous(row)), b = numeric(right(row));
+        const value = operator === "+" ? a + b : operator === "-" ? a - b : operator === "*" ? a * b : operator === "/" ? a / b : a % b;
+        if (!Number.isFinite(value)) throw new XanError("non-finite arithmetic result");
+        return value;
+      };
+    }
+    return left;
+  };
+  const result = [];
+  for (; ; ) {
+    space();
+    const start = offset;
+    const evaluate = parse(0, 1);
+    let name = text.slice(start, offset).trim();
+    if (text.slice(offset, offset + 2).toLowerCase() === "as" && " 	\r\n".includes(text[offset + 2] ?? "\0")) {
+      offset += 2;
+      space();
+      name = identifier();
+      if (!name) throw new XanError("expected expression alias");
+      space();
+    }
+    budget.bound("maxSelectedColumns", result.length + 1);
+    budget.hold(64);
+    result.push({ name, evaluate });
+    const checkpoint = budget.checkpoint();
+    if (checkpoint) await checkpoint;
+    if (offset === text.length) break;
+    if (text[offset++] !== ",") throw new XanError("unexpected expression syntax");
+  }
+  return result;
+}
+
+// packages/safe-bash-command-xan/src/presentation.ts
+async function presentationRows(args, scope, budget, writer) {
+  const scanner = scope.open(args.inputs[0], args);
+  const first = await scanner.next();
+  if (first) scope.own(first.free);
+  const table = args.command === "table";
+  const source = args.command === "map" ? args.operand : args.evaluateFile ? await scope.expression(args.selection) : args.selection;
+  const projections = table ? [] : await expressions(source, first, args.noHeaders, budget);
+  if (args.command === "map" && projections.length !== 1) throw new XanError("map requires one expression");
+  budget.hold((first?.width ?? 0) * 32);
+  const selected = table ? await resolveSelection(await parseSelection(args.selection, budget), first?.cells.map((cell) => cell.decoded.view()) ?? [], args.noHeaders, budget) : [];
+  const lines = [], widths = selected.map(() => 0);
+  let retained = 0;
+  const hold = (size) => {
+    budget.hold(size);
+    retained += size;
+  };
+  let row = first;
+  return (async function* () {
+    try {
+      if (!table && !args.noHeaders) {
+        yield* textRow(args.command === "map" ? [...first?.cells.map((cell) => cell.decoded.view()) ?? [], args.rightSelection] : projections.map((projection) => projection.name), writer, budget);
+        first?.free();
+        row = await scanner.next();
+      }
+      while (row) {
+        if (row.width !== first?.width) throw new XanError("inconsistent field count");
+        if (table) {
+          hold(selected.length * 64 + 32);
+          const line = [];
+          for (let i = 0; i < selected.length; i++) {
+            const bytes = row.cells[selected[i]].decoded.view();
+            hold(bytes.length * 16);
+            const value = escapeText(cellText(bytes, budget), "diagnostic");
+            let width2 = 0;
+            for (const character of value) {
+              budget.work();
+              width2 += widthOf(character.codePointAt(0));
+            }
+            widths[i] = Math.max(widths[i], width2);
+            line.push({ text: value, width: width2 });
+          }
+          lines.push(line);
+        } else {
+          const size = row.cells.reduce((sum, cell) => sum + cell.decoded.length * 4, 0) * Math.max(1, projections.length);
+          budget.hold(size);
+          try {
+            const values = projections.map((projection) => String(projection.evaluate(row)));
+            yield* textRow(args.command === "map" ? [...row.cells.map((cell) => cell.decoded.view()), ...values] : values, writer, budget);
+          } finally {
+            budget.release(size);
+          }
+        }
+        row.free();
+        row = await scanner.next();
+      }
+      if (table) {
+        const size = widths.reduce((sum, width2) => sum + width2 + 2, 1);
+        for (let i = 0; i < lines.length; i++) {
+          const textSize = lines[i].reduce((sum, value) => sum + value.text.length, 0);
+          const temporary = (size + textSize) * 4;
+          budget.hold(temporary);
+          try {
+            budget.work(size);
+            const c = budget.checkpoint();
+            if (c) await c;
+            yield* emitted(await writer.text(lines[i].map((value, column) => value.text + " ".repeat(widths[column] - value.width)).join("  ") + "\n"), budget);
+            if (i === 0 && !args.noHeaders) yield* emitted(await writer.text(widths.map((width2) => "-".repeat(width2)).join("  ") + "\n"), budget);
+          } finally {
+            budget.release(temporary);
+          }
+        }
+      }
+    } finally {
+      row?.free();
+      first?.free();
+      budget.release(retained);
+      await scanner.close();
+    }
+  })();
+}
+
 // packages/safe-bash-command-xan/src/condition.ts
 init_buffer();
 async function condition(expression, headers, noHeaders, budget, scope) {
@@ -872,13 +1080,13 @@ async function* transformRows(args, scope, budget, writer) {
     const predicate = args.command === "filter" ? await condition(args.operand, first, args.noHeaders, budget, scope) : void 0;
     const pattern = args.command === "search" ? await budget.encode(options.has("ignore-case") ? args.operand.toLowerCase() : args.operand) : void 0;
     if (pattern) scope.own(() => budget.release(pattern.length));
-    const limit = options.has("limit") ? await unsigned(options.get("limit"), "--limit", budget) : void 0;
+    const limit = options.has("limit") ? await unsigned(options.get("limit"), "--limit", budget) : args.command === "top" ? 10n : void 0;
     let matches = 0n;
     for await (const row of source) {
       let held = false;
       try {
-        if (args.command === "sort" || args.command === "reverse") {
-          if (options.has("numeric")) for (const position of selected) numericCell(row.cells[position].decoded.view(), budget);
+        if (args.command === "sort" || args.command === "reverse" || args.command === "top") {
+          if (options.has("numeric") || args.command === "top") for (const position of selected) numericCell(row.cells[position].decoded.view(), budget);
           budget.hold(32);
           retained.push(row);
           held = true;
@@ -926,15 +1134,16 @@ async function* transformRows(args, scope, budget, writer) {
       for (const position of selected) {
         const a = left.cells[position].decoded.view(), b = right.cells[position].decoded.view();
         let order;
-        if (options.has("numeric")) {
+        if (options.has("numeric") || args.command === "top") {
           order = Math.sign(numericCell(a, budget) - numericCell(b, budget));
         } else order = await compareBytes(a, b, budget);
-        if (order) return options.has("reverse") ? -order : order;
+        if (order) return options.has("reverse") !== (args.command === "top") ? -order : order;
       }
       return 0;
     };
-    if (args.command === "sort") await boundedSort(retained, 32, budget, compare);
+    if (args.command === "sort" || args.command === "top") await boundedSort(retained, 32, budget, compare);
     for (let i = 0; i < retained.length; i++) {
+      if (args.command === "top" && BigInt(i) >= limit) break;
       budget.work();
       const c = budget.checkpoint();
       if (c) await c;
@@ -1076,7 +1285,8 @@ function width(row, expected) {
   if (row.width !== expected) throw new XanError(`CSV error: record ${row.number} (byte: ${row.offset}): found record with ${row.width} fields, but the previous record has ${expected} fields`);
 }
 async function prepareRows(args, selection, scope, budget, writer) {
-  if (args.help) return emitted2(await writer.text("xan: CSV tools for virtual files and byte streams\nCommands: headers (h), count, select, slice, head, tail, sort, search,\n          filter, reverse, rename, drop, stats, freq (frequency), join,\n          dedup, enum, transpose, agg, groupby, to, from, cat, split\nCommon: -h --help, -d --delimiter BYTE, -o --output PATH\nheaders: -j --just-names, --csv, -s --start N, --color auto|never\ncount/select/slice: -n --no-headers\ncount: -H/--human-readable, -c/--check-alignment, -a/--approx, -p/--parallel, -t/--threads N\nselect: literal selection or -e/--evaluate COLUMN, -f/--evaluate-file PATH;\nslice: -s/--start, --skip, -e/--end, -l/--len, -i/--index, -I/--indices, -L/--last\nslice bytes: -B/--byte-offset N, --end-byte N, --raw\nslice conditions: -S/--start-condition EXPR, -E/--end-condition EXPR\nConditions: named column comparisons with string/number literals.\nhead/tail: -l/--limit N (default 10)\nsort: -s/--select COLUMNS, -N/--numeric, -R/--reverse, -u/--uniq\nsearch: PATTERN; -s/--select, -e/--exact, -i/--ignore-case, -v/--invert-match\nfilter: COLUMN comparison LITERAL; -v/--invert-match\nrename: NAMES; -s/--select COLUMNS; drop: SELECTION\nstats/freq: -s/--select COLUMNS; freq: -l/--limit N, -A/--all, -N/--no-extra\njoin: COLUMNS LEFT [RIGHT_COLUMNS] RIGHT; --left/--right/--full/--semi/--anti/--cross\n      --drop-key none|left|right|both, --nulls, -i/--ignore-case\nSearch uses literal substrings; filter supports the comparisons above.\nagg/groupby: aggregate calls (count, sum, mean, min, max, first, last) with optional AS names.\nto: json, jsonl, ndjson, txt; from: -f json, jsonl, ndjson, txt, raw.\ncat: rows or cols [--pad]; split: -S SIZE, -O DIRECTORY, -f TEMPLATE.\nOther expressions, formats and forced color are unsupported.\nCount execution options use exact sequential counting.\n"), budget);
+  if (args.help) return emitted2(await writer.text("xan: CSV tools for virtual files and byte streams\nCommands: headers (h), count, select, slice, head, tail, sort, search,\n          filter, reverse, rename, drop, stats, freq (frequency), join,\n          dedup, enum, transpose, agg, groupby, to, from, cat, split, table, top, map\nCommon: -h --help, -d --delimiter BYTE, -o --output PATH\nheaders: -j --just-names, --csv, -s --start N, --color auto|never\ncount/select/slice: -n --no-headers\ncount: -H/--human-readable, -c/--check-alignment, -a/--approx, -p/--parallel, -t/--threads N\nselect: literal selection or -e/--evaluate EXPRESSIONS, -f/--evaluate-file PATH;\nslice: -s/--start, --skip, -e/--end, -l/--len, -i/--index, -I/--indices, -L/--last\nslice bytes: -B/--byte-offset N, --end-byte N, --raw\nslice conditions: -S/--start-condition EXPR, -E/--end-condition EXPR\nConditions: named column comparisons with string/number literals.\nhead/tail: -l/--limit N (default 10)\nsort: -s/--select COLUMNS, -N/--numeric, -R/--reverse, -u/--uniq\nsearch: PATTERN; -s/--select, -e/--exact, -i/--ignore-case, -v/--invert-match\nfilter: COLUMN comparison LITERAL; -v/--invert-match\nrename: NAMES; -s/--select COLUMNS; drop: SELECTION\nstats/freq: -s/--select COLUMNS; freq: -l/--limit N, -A/--all, -N/--no-extra\njoin: COLUMNS LEFT [RIGHT_COLUMNS] RIGHT; --left/--right/--full/--semi/--anti/--cross\n      --drop-key none|left|right|both, --nulls, -i/--ignore-case\nSearch uses literal substrings; filter supports the comparisons above.\nagg/groupby: aggregate calls (count, sum, mean, min, max, first, last) with optional AS names.\nto: json, jsonl, ndjson, txt; from: -f json, jsonl, ndjson, txt, raw.\ncat: rows or cols [--pad]; split: -S SIZE, -O DIRECTORY, -f TEMPLATE.\nselect -e: arithmetic (+ - * / %), parentheses, literals, columns and AS aliases.\nmap: EXPRESSION COLUMN; append one computed column.\ntop: COLUMNS; -l/--limit N (default 10), -R/--reverse (smallest first).\ntable: aligned text; -s/--select COLUMNS, -n/--no-headers.\nOther expressions, formats and forced color are unsupported.\nCount execution options use exact sequential counting.\n"), budget);
+  if (args.command === "map" || args.command === "table" || args.command === "select" && (args.evaluate || args.evaluateFile)) return presentationRows(args, scope, budget, writer);
   if (["dedup", "enum", "transpose", "agg", "groupby", "to", "from", "cat", "split"].includes(args.command)) return extendedRows(args, scope, budget, writer);
   if (!["headers", "count", "select", "drop", "slice"].includes(args.command)) return transformRows(args, scope, budget, writer);
   if (args.command === "headers") return prepareHeaders(args, scope, budget, writer);