playground: ship uutils sed

Add uutils/sed to the playground alongside grep, find and diff/cmp. sed
builds a single `sed` binary and, like diffutils, has only pure-Rust
dependencies (fancy-regex and regex, not onig), so its WASM build needs no
WASI SDK — it joins the wasm-standalone matrix with needs_wasi: false.

Register sed as its own on-demand standalone module (sed -> sed.wasm), add
it to the fallback command list, the help/load hints, a substitution
example, the version footer, and tests (stdin substitution, global
substitution over a file, and -n line selection).

Author: sylvestre

.github/workflows/website.yml

@@ -118,11 +118,11 @@ jobs:
         name: wasm-coreutils
         path: wasm-out
 
-  # grep, find and diffutils each ship a single standalone binary built the
+  # grep, find, diffutils and sed each ship a single standalone binary built the
   # same way, so they share one matrix job. grep/find pull in the Oniguruma C
   # library (onig_sys) and need a WASI sysroot to compile its bundled C sources;
-  # diffutils is pure Rust and sets needs_wasi: false. The `order` field keeps
-  # the merged command/version lists in a stable sequence in the `build` job.
+  # diffutils and sed are pure Rust and set needs_wasi: false. The `order` field
+  # keeps the merged command/version lists in a stable sequence in `build`.
   wasm-standalone:
     name: Build ${{ matrix.name }} WASM
     runs-on: ubuntu-latest
@@ -151,6 +151,13 @@ jobs:
           commands: '"diff","cmp"'
           version_const: UUTILS_DIFFUTILS_VERSION
           order: 30
+        - name: sed
+          repo: uutils/sed
+          bin: sed
+          needs_wasi: false
+          commands: '"sed"'
+          version_const: UUTILS_SED_VERSION
+          order: 40
     steps:
     - name: Checkout ${{ matrix.name }} Repository
       uses: actions/checkout@v7

content/playground.md

@@ -119,6 +119,12 @@ template = "page.html"
         parts.push('diffutils <a href="' + diffUrl + '"><code>' +
           UUTILS_DIFFUTILS_VERSION.short + '</code></a> (' + diffDate + ')');
       }
+      if (typeof UUTILS_SED_VERSION !== "undefined") {
+        var sedDate = UUTILS_SED_VERSION.date.split("T")[0];
+        var sedUrl = "https://github.com/uutils/sed/commit/" + UUTILS_SED_VERSION.commit;
+        parts.push('sed <a href="' + sedUrl + '"><code>' +
+          UUTILS_SED_VERSION.short + '</code></a> (' + sedDate + ')');
+      }
       if (typeof SITE_VERSION !== "undefined") {
         var siteDate = SITE_VERSION.date.split("T")[0];
         var siteUrl = "https://github.com/uutils/uutils.github.io/commit/" + SITE_VERSION.commit;
@@ -155,6 +161,7 @@ Click an example to run it in the terminal:
   <button class="playground-example">printf '🍎 apple\n🍌 banana\n🍒 cherry\n🥝 kiwi\n' | grep 🍌</button>
   <button class="playground-example">find . -name '*.md'</button>
   <button class="playground-example">diff -u shopping-old.txt shopping-new.txt</button>
+  <button class="playground-example">sed -e 's/banana/🍌/g' -e 's/date/🌴/g' fruits.txt</button>
   <button class="playground-example">sort -n < numbers.txt | head -3</button>
   <button class="playground-example">date</button>
   <button class="playground-example">uname -a</button>

static/js/wasm-terminal.js

@@ -16,14 +16,16 @@ if (typeof SharedArrayBuffer === "undefined") {
 const WASM_URL = "/wasm/uutils.wasm";
 // Some utilities ship as their own standalone WASM modules rather than as part
 // of the coreutils multicall binary (grep lives in uutils/grep, find in
-// uutils/findutils, diff and cmp in uutils/diffutils). Each module is loaded on
-// demand and is optional — see loadStandalone. A single module can provide
-// several commands (diffutils → diff, cmp), which the diffutils binary
-// dispatches on argv[0], so each command is invoked directly by its own name.
+// uutils/findutils, diff and cmp in uutils/diffutils, sed in uutils/sed). Each
+// module is loaded on demand and is optional — see loadStandalone. A single
+// module can provide several commands (diffutils → diff, cmp), which the
+// diffutils binary dispatches on argv[0], so each command is invoked directly
+// by its own name.
 const STANDALONE_MODULES = {
   grep: { url: "/wasm/grep.wasm", commands: ["grep"] },
   find: { url: "/wasm/find.wasm", commands: ["find"] },
   diffutils: { url: "/wasm/diffutils.wasm", commands: ["diff", "cmp"] },
+  sed: { url: "/wasm/sed.wasm", commands: ["sed"] },
 };
 // Map each command to the module that provides it (e.g. diff -> "diffutils").
 const STANDALONE_COMMAND_MODULE = Object.fromEntries(
@@ -73,7 +75,7 @@ const FALLBACK_COMMANDS = [
   "sha1sum", "sha224sum", "sha256sum", "sha384sum", "sha512sum",
   "shred", "shuf", "sleep", "sum", "tee", "true", "truncate",
   "uname", "unexpand", "uniq", "unlink", "vdir", "wc",
-  "grep", "find", "diff", "cmp",
+  "grep", "find", "diff", "cmp", "sed",
 ];
 const AVAILABLE_COMMANDS =
   (typeof WASM_COMMANDS !== "undefined" && Array.isArray(WASM_COMMANDS) && WASM_COMMANDS.length > 0)
@@ -550,6 +552,7 @@ async function executeCommandLine(line) {
       "  grep -i alice names.txt\n" +
       "  find . -name '*.md'\n" +
       "  diff -u shopping-old.txt shopping-new.txt\n" +
+      "  echo 'hello world' | sed 's/world/there/'\n" +
       "  basename /usr/local/bin/rustc\n" +
       "  date\n" +
       "  uname -a\n"
@@ -932,7 +935,7 @@ async function initPlayground(containerId) {
     terminal.writeln("");
     terminal.writeln("Type \x1b[1;32mhelp\x1b[0m for available commands.");
     terminal.writeln("Sample data files: names.txt, numbers.txt, fruits.txt, csv.txt, words.txt");
-    terminal.writeln("\x1b[2mgrep, find and diff/cmp load on demand — just run them, or use the buttons below.\x1b[0m");
+    terminal.writeln("\x1b[2mgrep, find, sed and diff/cmp load on demand — just run them, or use the buttons below.\x1b[0m");
   } catch (e) {
     terminal.writeln(" \x1b[1;31mfailed\x1b[0m");
     terminal.writeln("Failed to load WASM binary. Commands are not available.");
@@ -1017,6 +1020,7 @@ window._uutilsTestInternals = {
   get grepReady() { return !!standaloneModules.grep; },
   get findReady() { return !!standaloneModules.find; },
   get diffutilsReady() { return !!standaloneModules.diffutils; },
+  get sedReady() { return !!standaloneModules.sed; },
   initWasm,
   loadStandalone,
   LOCALE_SHORTCUTS,

static/js/wasm-terminal.test.html

@@ -549,6 +549,34 @@ <h1>wasm-terminal unit tests</h1>
       section("diffutils WASM module (SKIPPED - diffutils.wasm not loaded)");
     }
 
+    // ===== sed (standalone WASM module, loaded on demand) =====
+    // sed ships as its own module (uutils/sed). Pre-load it via the on-demand
+    // loader. Skips gracefully if sed.wasm is absent.
+    await T.loadStandalone("sed");
+    if (T.sedReady) {
+      section("sed WASM module");
+
+      assert("sed in AVAILABLE_COMMANDS",
+        AVAILABLE_COMMANDS.includes("sed"), true);
+
+      // Basic substitution on stdin.
+      await assertAsync("sed substitutes on stdin",
+        executeCommandLine("echo 'hello world' | sed 's/world/there/'"),
+        "hello there\n");
+
+      // Global substitution over a sample file.
+      await assertAsync("sed -e global substitution on a file",
+        executeCommandLine("sed 's/banana/kiwi/g' fruits.txt"),
+        "kiwi\napple\ncherry\ndate\napple\nkiwi\ncherry\napple\n");
+
+      // Line selection with -n / p.
+      await assertAsync("sed -n prints only the selected line",
+        executeCommandLine("sed -n '2p' numbers.txt"),
+        "7\n");
+    } else {
+      section("sed WASM module (SKIPPED - sed.wasm not loaded)");
+    }
+
   } else {
     section("l10n WASM integration (SKIPPED - WASM not loaded)");
   }