as-test 1.1.5 → 1.1.7

package/CHANGELOG.md

@@ -1,11 +1,26 @@
 # Change Log
 
-## 2026-05-15 - v1.1.5
+## 2026-05-18 - v1.1.7
+
+### Modes & CLI
+
+- fix: when a config declares named modes, the implicit base config no longer runs alongside them; only modes with `default !== false` are selected. Configs without any declared modes still fall back to the base mode.
+- feat: add `--watch` to `ast test` to re-run on source or spec changes (150ms debounce, clear-screen, `Ctrl+C` to stop). Watches all base directories derived from `input` patterns plus `assembly/` and the resolved config file; ignores `node_modules`, `.git`, and the configured `outDir`.
+
+### Runtime
+
+- chore: replace the homegrown JSON serialization helpers (`quote`, `rawOrNull`, `stringifyValue`, `escape`, `unicodeEscape`, `stringifyArray`) with `json-as` across the AssemblyScript runtime and transform, and delete `assembly/util/json.ts`. The `LogTransform` now injects `import { JSON } from "json-as/assembly"` per instrumented source and inlines `JSON.stringify<T>()` into the log helper.
+- chore: promote `json-as` to a required peer dependency (`>=1.0.0`). npm 7+ installs it automatically; pnpm and yarn users must add `json-as` to their own `devDependencies` alongside `as-test`.
+- chore: remove the unused `__as_test_log_default` and `__as_test_json_value` exports.
+
+## 2026-05-14 - v1.1.6
 
 - fix: coverage `mode` and `dependencies` filtering now correctly handles AssemblyScript-normalized `~lib/<pkg>/...` paths, which are the actual runtime paths emitted for `node_modules` imports.
 - fix: `ENTRY_FILE` injected by the transform now uses the full relative path instead of the basename, preventing snapshot key collisions between specs with the same filename in different directories; snapshot lookup normalizes the file prefix to maintain backward compatibility with existing `.snap` files.
 - fix: transform visitor and coverage instrumentation now resolve `NodeKind` values at runtime instead of relying on compile-time const enum inlining, so they remain correct across AssemblyScript versions.
 - fix: add a no-op `TupleType` case to the transform visitor so files using tuple types no longer throw during instrumentation.
+- fix: coverage transform no longer wraps `return this` in constructors, preventing AS231 ("A class with a constructor explicitly returning something else than 'this' must be '@final'").
+- fix: coverage transform preserves expression-body arrows instead of converting them to block bodies, preventing TS1140 ("Type argument expected") on typed arrow parameters such as `[1,2,3].map((x: i32) => x + 1)`.
 
 ## 2026-05-14 - v1.1.4
 

package/README.md

@@ -2,14 +2,6 @@
 ╠═╣ ╚═╗ ══  ║  ╠═  ╚═╗  ║ 
 ╩ ╩ ╚═╝     ╩  ╚═╝ ╚═╝  ╩ </pre></h1>
 
-> **Upgrading to 1.1.0**
->
-> See [CHANGELOG.md](./CHANGELOG.md) for upgrade notes. In most projects, refreshing generated runners is enough:
->
-> ```bash
-> rm -rf .as-test/runners && npx as-test init
-> ```
-
 <details>
 <summary>Table of Contents</summary>
 
@@ -47,9 +39,12 @@ That gives you a basic config file, a sample test, and optionally a sample fuzze
 If you already have a project and just want the package:
 
 ```bash
-npm install --save-dev as-test
+npm install --save-dev as-test json-as
 ```
 
+`json-as` is a required peer dependency (used for value serialization in
+assertions, snapshots, and `log()`)
+
 ## Docs
 
 Full documentation lives at:

package/assembly/index.ts

@@ -14,8 +14,8 @@ import {
   sendFileStart,
   sendReport,
 } from "./util/wipc";
-import { quote } from "./util/json";
-import { bold, formatValue, green, red } from "./util/format";
+import { JSON } from "json-as/assembly";
+import { bold, green, red } from "./util/format";
 import {
   createFuzzer,
   FuzzerBase,
@@ -37,7 +37,6 @@ export {
   StringOptions,
 } from "./src/fuzz";
 export { __as_test_deep_equal } from "./src/expectation";
-export { __as_test_json_value } from "./util/json";
 
 let entrySuites: Suite[] = [];
 let entryFuzzers: FuzzerBase[] = [];
@@ -241,11 +240,7 @@ export function xexpect<T>(
  */
 export function log<T>(data: T): void {
   if (!__as_test_log_is_enabled()) return;
-  __as_test_log_serialized(__as_test_log_default<T>(data));
-}
-
-export function __as_test_log_default<T>(data: T): string {
-  return formatValue(data);
+  __as_test_log_serialized(JSON.stringify<T>(data));
 }
 
 export function __as_test_log_is_enabled(): bool {
@@ -556,23 +551,23 @@ class CoveragePointReport {
   serialize(): string {
     return (
       '{"hash":' +
-      quote(this.hash) +
+      JSON.stringify<string>(this.hash) +
       ',"file":' +
-      quote(this.file) +
+      JSON.stringify<string>(this.file) +
       ',"line":' +
       this.line.toString() +
       ',"column":' +
       this.column.toString() +
       ',"type":' +
-      quote(this.type) +
+      JSON.stringify<string>(this.type) +
       ',"executed":' +
       (this.executed ? "true" : "false") +
       ',"parentHash":' +
-      quote(this.parentHash) +
+      JSON.stringify<string>(this.parentHash) +
       ',"scopeKind":' +
-      quote(this.scopeKind) +
+      JSON.stringify<string>(this.scopeKind) +
       ',"scopeName":' +
-      quote(this.scopeName) +
+      JSON.stringify<string>(this.scopeName) +
       ',"depth":' +
       this.depth.toString() +
       "}"
@@ -698,7 +693,7 @@ export class Result {
   serialize(): string {
     return (
       '{"name":' +
-      quote(this.name) +
+      JSON.stringify<string>(this.name) +
       ',"arg1":' +
       this.arg1.toString() +
       ',"arg2":' +

package/assembly/src/expectation.ts

@@ -1,6 +1,6 @@
 import { visualize } from "../util/helpers";
 import { Tests } from "./tests";
-import { quote, stringifyValue } from "../util/json";
+import { JSON } from "json-as/assembly";
 import { namedSnapshotKey, nextUnnamedSnapshotKey } from "..";
 import {
   sendAssertionFailure,
@@ -425,8 +425,8 @@ export class Expectation<T> extends Tests {
       this._resolve(
         passed,
         "toContain",
-        stringifyValue<T>(this._left),
-        stringifyValue<valueof<T>>(value),
+        JSON.stringify<T>(this._left),
+        JSON.stringify<valueof<T>>(value),
         message,
       );
       return;
@@ -451,7 +451,7 @@ export class Expectation<T> extends Tests {
       ? namedSnapshotKey(this._snapshotKey, name)
       : nextUnnamedSnapshotKey(this._snapshotKey);
 
-    const actual = stringifyValue<T>(this._left);
+    const actual = JSON.stringify<T>(this._left);
     const res = snapshotAssert(key, actual);
     this._resolve(res.ok, "toMatchSnapshot", actual, res.expected, message);
   }
@@ -491,8 +491,8 @@ export class Expectation<T> extends Tests {
     this._resolve(
       passed,
       "toBe",
-      stringifyValue<T>(this._left),
-      stringifyValue<T>(equals),
+      JSON.stringify<T>(this._left),
+      JSON.stringify<T>(equals),
       message,
     );
   }
@@ -505,8 +505,8 @@ export class Expectation<T> extends Tests {
     this._resolve(
       passed,
       "toEqual",
-      stringifyValue<T>(this._left),
-      stringifyValue<T>(equals),
+      JSON.stringify<T>(this._left),
+      JSON.stringify<T>(equals),
       message,
     );
   }
@@ -519,8 +519,8 @@ export class Expectation<T> extends Tests {
     this._resolve(
       passed,
       "toStrictEqual",
-      stringifyValue<T>(this._left),
-      stringifyValue<T>(equals),
+      JSON.stringify<T>(this._left),
+      JSON.stringify<T>(equals),
       message,
     );
   }
@@ -606,5 +606,5 @@ function isTruthy<T>(value: T): bool {
 }
 
 function q(value: string): string {
-  return quote(value);
+  return JSON.stringify<string>(value);
 }

package/assembly/src/fuzz.ts

@@ -1,4 +1,8 @@
-import { quote, rawOrNull, stringifyValue } from "../util/json";
+import { JSON } from "json-as/assembly";
+
+function quote(s: string): string {
+  return JSON.stringify<string>(s);
+}
 
 export class StringOptions {
   charset: string = "ascii";
@@ -656,7 +660,7 @@ export class FuzzFailure {
       ',"seed":' +
       this.seed.toString() +
       ',"input":' +
-      rawOrNull(this.input) +
+      (this.input.length ? this.input : "null") +
       "}"
     );
   }
@@ -877,7 +881,7 @@ export class Fuzzer1<A, R> extends FuzzerBase {
         );
       } else {
         this.generator(seed, (a: A): R => {
-          __as_test_fuzz_input = "[" + stringifyValue<A>(a) + "]";
+          __as_test_fuzz_input = "[" + JSON.stringify<A>(a) + "]";
           return changetype<(a: A) => R>(__fuzz_run1)(a);
         });
       }
@@ -948,7 +952,7 @@ export class Fuzzer2<A, B, R> extends FuzzerBase {
       } else {
         this.generator(seed, (a: A, b: B): R => {
           __as_test_fuzz_input =
-            "[" + stringifyValue<A>(a) + "," + stringifyValue<B>(b) + "]";
+            "[" + JSON.stringify<A>(a) + "," + JSON.stringify<B>(b) + "]";
           return changetype<(a: A, b: B) => R>(__fuzz_run2)(a, b);
         });
       }
@@ -1022,11 +1026,11 @@ export class Fuzzer3<A, B, C, R> extends FuzzerBase {
         )(seed, (a: A, b: B, c: C): R => {
           __as_test_fuzz_input =
             "[" +
-            stringifyValue<A>(a) +
+            JSON.stringify<A>(a) +
             "," +
-            stringifyValue<B>(b) +
+            JSON.stringify<B>(b) +
             "," +
-            stringifyValue<C>(c) +
+            JSON.stringify<C>(c) +
             "]";
           return changetype<(a: A, b: B, c: C) => R>(__fuzz_run3)(a, b, c);
         });

package/assembly/src/log.ts

@@ -1,4 +1,4 @@
-import { quote } from "../util/json";
+import { JSON } from "json-as/assembly";
 
 import { sendLog } from "../util/wipc";
 
@@ -21,7 +21,7 @@ export class Log {
       ',"depth":' +
       this.depth.toString() +
       ',"text":' +
-      quote(this.text) +
+      JSON.stringify<string>(this.text) +
       "}"
     );
   }

package/assembly/src/suite.ts

@@ -4,7 +4,7 @@ import { Tests } from "./tests";
 import { Log } from "./log";
 import { after_each_callback, before_each_callback } from "..";
 import { sendSuiteEnd, sendSuiteStart } from "../util/wipc";
-import { quote } from "../util/json";
+import { JSON } from "json-as/assembly";
 
 export class Suite {
   public file: string = "unknown";
@@ -175,17 +175,17 @@ export class Suite {
   serialize(): string {
     let out = "{";
     if (this.depth <= 0) {
-      out += '"file":' + quote(this.file) + ",";
+      out += '"file":' + JSON.stringify<string>(this.file) + ",";
     }
     out += '"order":' + this.order.toString();
     out += ',"time":' + this.time.serialize();
-    out += ',"description":' + quote(this.description);
+    out += ',"description":' + JSON.stringify<string>(this.description);
     out += ',"depth":' + this.depth.toString();
     out += ',"suites":' + serializeSuites(this.suites);
     out += ',"tests":' + serializeTests(this.tests);
     out += ',"logs":' + serializeLogs(this.logs);
-    out += ',"kind":' + quote(this.kind);
-    out += ',"verdict":' + quote(this.verdict);
+    out += ',"kind":' + JSON.stringify<string>(this.kind);
+    out += ',"verdict":' + JSON.stringify<string>(this.verdict);
     out += "}";
     return out;
   }

package/assembly/src/tests.ts

@@ -1,4 +1,4 @@
-import { quote, rawOrNull } from "../util/json";
+import { JSON } from "json-as/assembly";
 
 export class Tests {
   public order: i32 = 0;
@@ -15,19 +15,19 @@ export class Tests {
       '{"order":' +
       this.order.toString() +
       ',"type":' +
-      quote(this.type) +
+      JSON.stringify<string>(this.type) +
       ',"verdict":' +
-      quote(this.verdict) +
+      JSON.stringify<string>(this.verdict) +
       ',"left":' +
-      rawOrNull(this.left) +
+      (this.left.length ? this.left : "null") +
       ',"right":' +
-      rawOrNull(this.right) +
+      (this.right.length ? this.right : "null") +
       ',"instr":' +
-      quote(this.instr) +
+      JSON.stringify<string>(this.instr) +
       ',"message":' +
-      quote(this.message) +
+      JSON.stringify<string>(this.message) +
       ',"location":' +
-      quote(this.location) +
+      JSON.stringify<string>(this.location) +
       "}"
     );
   }

package/assembly/util/wipc.ts

@@ -1,4 +1,8 @@
-import { quote as q } from "./json";
+import { JSON } from "json-as/assembly";
+
+function q(s: string): string {
+  return JSON.stringify<string>(s);
+}
 
 // @ts-ignore
 @external("env", "process.stdout.write")

package/bin/build-worker-pool.js

@@ -1,155 +1,159 @@
 import { spawn } from "child_process";
 import { fileURLToPath } from "url";
 export class BuildWorkerPool {
-    constructor(size) {
-        this.pools = new Map();
-        this.nextId = 1;
-        this.closed = false;
-        this.size = Math.max(1, size);
+  constructor(size) {
+    this.pools = new Map();
+    this.nextId = 1;
+    this.closed = false;
+    this.size = Math.max(1, size);
+  }
+  buildFileMode(args) {
+    if (this.closed) {
+      return Promise.reject(new Error("build worker pool is closed"));
     }
-    buildFileMode(args) {
-        if (this.closed) {
-            return Promise.reject(new Error("build worker pool is closed"));
-        }
-        const featureToggles = args.featureToggles ?? {};
-        const overrides = args.overrides ?? {};
-        const signature = buildSignature(args.modeName, featureToggles, overrides);
-        const pool = this.getPool(signature);
-        return new Promise((resolve, reject) => {
-            pool.queue.push({
-                id: this.nextId++,
-                configPath: args.configPath,
-                file: args.file,
-                modeName: args.modeName,
-                buildCommand: args.buildCommand,
-                featureToggles,
-                overrides,
-                resolve,
-                reject,
-            });
-            this.pump(pool);
-        });
-    }
-    async close() {
-        this.closed = true;
-        const waits = [];
-        for (const pool of this.pools.values()) {
-            while (pool.queue.length) {
-                const task = pool.queue.shift();
-                task.reject(new Error("build worker pool closed"));
-            }
-            for (const worker of pool.workers) {
-                waits.push(new Promise((resolve) => {
-                    if (worker.child.exitCode != null || worker.child.killed) {
-                        resolve();
-                        return;
-                    }
-                    worker.child.once("exit", () => resolve());
-                    worker.child.kill();
-                }));
-            }
-        }
-        await Promise.all(waits);
-    }
-    getPool(signature) {
-        let pool = this.pools.get(signature);
-        if (pool)
-            return pool;
-        pool = {
-            workers: Array.from({ length: this.size }, () => this.spawnWorker(signature)),
-            queue: [],
-        };
-        this.pools.set(signature, pool);
-        return pool;
-    }
-    spawnWorker(signature) {
-        const workerPath = fileURLToPath(new URL("./build-worker.js", import.meta.url));
-        const child = spawn(process.execPath, [workerPath], {
-            stdio: ["ignore", "ignore", "ignore", "ipc"],
-        });
-        const worker = {
-            child,
-            busy: false,
-            task: null,
-        };
-        child.on("message", (message) => {
-            this.onMessage(signature, worker, message);
-        });
-        child.on("exit", () => {
-            const pool = this.pools.get(signature);
-            const failedTask = worker.task;
-            worker.busy = false;
-            worker.task = null;
-            if (failedTask) {
-                const modeLabel = failedTask.modeName ?? "default";
-                const fileLabel = failedTask.file;
-                const commandText = failedTask.buildCommand?.trim().length
-                    ? `\nBuild command: ${failedTask.buildCommand}`
-                    : "";
-                failedTask.reject(new Error(`build worker exited unexpectedly while building ${fileLabel} in mode ${modeLabel}${commandText}`));
-            }
-            if (!pool || this.closed)
-                return;
-            const index = pool.workers.indexOf(worker);
-            if (index >= 0) {
-                pool.workers[index] = this.spawnWorker(signature);
+    const featureToggles = args.featureToggles ?? {};
+    const overrides = args.overrides ?? {};
+    const signature = buildSignature(args.modeName, featureToggles, overrides);
+    const pool = this.getPool(signature);
+    return new Promise((resolve, reject) => {
+      pool.queue.push({
+        id: this.nextId++,
+        configPath: args.configPath,
+        file: args.file,
+        modeName: args.modeName,
+        buildCommand: args.buildCommand,
+        featureToggles,
+        overrides,
+        resolve,
+        reject,
+      });
+      this.pump(pool);
+    });
+  }
+  async close() {
+    this.closed = true;
+    const waits = [];
+    for (const pool of this.pools.values()) {
+      while (pool.queue.length) {
+        const task = pool.queue.shift();
+        task.reject(new Error("build worker pool closed"));
+      }
+      for (const worker of pool.workers) {
+        waits.push(
+          new Promise((resolve) => {
+            if (worker.child.exitCode != null || worker.child.killed) {
+              resolve();
+              return;
             }
-            this.pump(pool);
-        });
-        return worker;
+            worker.child.once("exit", () => resolve());
+            worker.child.kill();
+          }),
+        );
+      }
     }
-    onMessage(signature, worker, message) {
-        const pool = this.pools.get(signature);
-        const task = worker.task;
-        if (!pool || !task || task.id !== message.id)
-            return;
-        worker.busy = false;
-        worker.task = null;
-        if (message.type == "done") {
-            task.resolve();
-        }
-        else {
-            task.reject(deserializeError(message.error));
-        }
-        this.pump(pool);
+    await Promise.all(waits);
+  }
+  getPool(signature) {
+    let pool = this.pools.get(signature);
+    if (pool) return pool;
+    pool = {
+      workers: Array.from({ length: this.size }, () =>
+        this.spawnWorker(signature),
+      ),
+      queue: [],
+    };
+    this.pools.set(signature, pool);
+    return pool;
+  }
+  spawnWorker(signature) {
+    const workerPath = fileURLToPath(
+      new URL("./build-worker.js", import.meta.url),
+    );
+    const child = spawn(process.execPath, [workerPath], {
+      stdio: ["ignore", "ignore", "ignore", "ipc"],
+    });
+    const worker = {
+      child,
+      busy: false,
+      task: null,
+    };
+    child.on("message", (message) => {
+      this.onMessage(signature, worker, message);
+    });
+    child.on("exit", () => {
+      const pool = this.pools.get(signature);
+      const failedTask = worker.task;
+      worker.busy = false;
+      worker.task = null;
+      if (failedTask) {
+        const modeLabel = failedTask.modeName ?? "default";
+        const fileLabel = failedTask.file;
+        const commandText = failedTask.buildCommand?.trim().length
+          ? `\nBuild command: ${failedTask.buildCommand}`
+          : "";
+        failedTask.reject(
+          new Error(
+            `build worker exited unexpectedly while building ${fileLabel} in mode ${modeLabel}${commandText}`,
+          ),
+        );
+      }
+      if (!pool || this.closed) return;
+      const index = pool.workers.indexOf(worker);
+      if (index >= 0) {
+        pool.workers[index] = this.spawnWorker(signature);
+      }
+      this.pump(pool);
+    });
+    return worker;
+  }
+  onMessage(signature, worker, message) {
+    const pool = this.pools.get(signature);
+    const task = worker.task;
+    if (!pool || !task || task.id !== message.id) return;
+    worker.busy = false;
+    worker.task = null;
+    if (message.type == "done") {
+      task.resolve();
+    } else {
+      task.reject(deserializeError(message.error));
     }
-    pump(pool) {
-        for (const worker of pool.workers) {
-            if (worker.busy)
-                continue;
-            const task = pool.queue.shift();
-            if (!task)
-                return;
-            worker.busy = true;
-            worker.task = task;
-            worker.child.send({
-                type: "build-file",
-                id: task.id,
-                configPath: task.configPath,
-                file: task.file,
-                modeName: task.modeName,
-                featureToggles: task.featureToggles,
-                overrides: task.overrides,
-            });
-        }
+    this.pump(pool);
+  }
+  pump(pool) {
+    for (const worker of pool.workers) {
+      if (worker.busy) continue;
+      const task = pool.queue.shift();
+      if (!task) return;
+      worker.busy = true;
+      worker.task = task;
+      worker.child.send({
+        type: "build-file",
+        id: task.id,
+        configPath: task.configPath,
+        file: task.file,
+        modeName: task.modeName,
+        featureToggles: task.featureToggles,
+        overrides: task.overrides,
+      });
     }
+  }
 }
 function buildSignature(modeName, featureToggles, overrides) {
-    return JSON.stringify({
-        modeName: modeName ?? "default",
-        featureToggles,
-        overrides,
-    });
+  return JSON.stringify({
+    modeName: modeName ?? "default",
+    featureToggles,
+    overrides,
+  });
 }
 function deserializeError(payload) {
-    const error = new Error(typeof payload.message == "string" ? payload.message : "unknown error");
-    error.name = typeof payload.name == "string" ? payload.name : "Error";
-    if (typeof payload.stack == "string")
-        error.stack = payload.stack;
-    for (const [key, value] of Object.entries(payload)) {
-        if (key == "name" || key == "message" || key == "stack")
-            continue;
-        error[key] = value;
-    }
-    return error;
+  const error = new Error(
+    typeof payload.message == "string" ? payload.message : "unknown error",
+  );
+  error.name = typeof payload.name == "string" ? payload.name : "Error";
+  if (typeof payload.stack == "string") error.stack = payload.stack;
+  for (const [key, value] of Object.entries(payload)) {
+    if (key == "name" || key == "message" || key == "stack") continue;
+    error[key] = value;
+  }
+  return error;
 }