as-test 1.1.10 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # Change Log
 
+## 2026-05-22 - v1.3.0
+
+### `features` config array + arbitrary `--enable` passthrough
+
+- feat: new top-level `"features": ["try-as", "simd"]` array in `as-test.config.json` (and per-mode override). `try-as` is the only as-test-internal feature today and wires the `try-as/transform` + `AS_TEST_TRY_AS=1` build flags as before. Any other name in the array is passed through to `asc` as `--enable <name>` — so `"simd"`, `"threads"`, `"reference-types"`, `"gc"`, etc. now work without hand-editing `buildOptions.args`.
+- feat: `ast test|run|build --enable <name>` and `--disable <name>` now accept arbitrary feature names. CLI flags override the config array (CLI `--disable simd` removes a config-listed feature; CLI `--enable simd` adds it). The known special-case `coverage` flag still routes to the dedicated top-level `coverage` config field rather than the features array. Both flags accept comma-separated lists too: `--enable try-as,coverage,simd` and `--disable try-as,coverage`. The same syntax is honored by `ast init`.
+- feat: `ast init` interactive prompt now includes a multi-select "Features" step (↑/↓ to move, space to toggle, enter to confirm) with `coverage` and `try-as` options. `--enable`/`--disable` flags on `ast init` skip the prompt with explicit selections. The generated `as-test.config.json` writes `coverage` at the top level and `features` as a string array; when try-as is selected, `try-as` is also added to `devDependencies`.
+- chore: schema validation rejects malformed shapes (object form, non-string array entries) with a fix hint pointing at the new shape.
+
+### `mode()` registration gate + `AS_TEST_MODE_NAME`
+
+- feat: new `mode(matchers: string[], fn: () => void)` helper in the `as-test` runtime, plus an `AS_TEST_MODE_NAME: string` compile-time constant. Use `mode(["node:bindings"], () => { ... })` to gate suite/test registrations on the active mode name. Matcher semantics: positive entries OR; `!name` entries exclude; `[]` is a no-op; positive + negative entries combine as "any positive matches AND no negative matches."
+- feat: build-side wiring — `build-core.ts` injects `AS_TEST_MODE_NAME=<mode>` into the asc env per-mode build, and the as-test transform rewrites the initializer of `AS_TEST_MODE_NAME` in `assembly/src/mode.ts` (an `afterParse` AST patch) so the value is baked into the wasm at compile time. Default value when no mode is selected is `"default"`.
+- chore: bundled `assembly/__tests__/mode.spec.ts` exercises positive/negative/mixed matchers, empty matchers, and per-mode counter behaviour end-to-end against the project's own `node:bindings` / `node:wasi` modes.
+
+### Tooling
+
+- chore: `build:transform` now runs `prettier -w ./transform/` after the TypeScript build so generated output stays formatted.
+
+## 2026-05-20 - v1.2.0
+
+### Directory-preserving artifact layout
+
+- feat: build artifacts, fuzz artifacts, snapshots, readable logs, coverage logs, and crash records now mirror the source tree under the configured input globs instead of being flattened into a single directory with a `____`-mangled disambiguator suffix. For `assembly/__tests__/nested/array.spec.ts` the artifact is `outDir/<mode>/nested/array.spec.wasm` (previously `outDir/<mode>/array.<mode>.<target>.assembly____tests____nested.wasm`).
+- feat: filename simplified to `<stem>.wasm` — the `.<mode>.<target>` suffix has been dropped since the mode is already a directory level and the target is implied by the mode config.
+- feat: add `resolveGlobBase`, `resolveSpecRelativePath`, and `resolveArtifactPath` in `cli/util.ts` as the shared path helpers used by every code path that writes or looks up a per-spec artifact. Glob bases are computed component-wise (so `assembly/__tests` is not a prefix of `assembly/__tests__/foo.spec.ts`) and the longest matching base wins when multiple configured input patterns overlap.
+- feat: add an up-front collision check in `build()` that throws a clear error naming both source files when two configured inputs would resolve to the same artifact path.
+- fix: `ast test <one-spec>`, `ast run <one-spec>`, and `ast fuzz <one-spec>` no longer drop the disambiguator when only one of two same-basename files is being built. The build side and the runner side now compute the same path from the same configured input set.
+- fix: build sites now `mkdir -p` the artifact's parent directory before invoking `asc` — pinned `assemblyscript@0.28.17`'s `-o` flag does not create parents and would otherwise ENOENT for any new nested directory.
+- fix: `persistCrashRecord` now `mkdir -p`'s the entry's parent directory, supporting `/` in entry keys so nested specs and fuzz failures get their own crash files instead of clobbering by basename.
+- fix: replace the hardcoded `/__tests__/` and `/__fuzz__/` markers in snapshot and readable-log path resolution with proper glob-base computation, so projects with custom input layouts now nest correctly instead of falling back to basename-only paths.
+
+### `.toThrow()` is a real matcher
+
+- feat: `expect((): void => { throw new Error("boom"); }).toThrow()` now invokes the wrapped callback and asserts it threw, using try-as's `__ExceptionState.Failures` counter to detect the throw. Calling `.toThrow()` on a non-function value reports a clear "needs a function" failure.
+- feat: requires `--enable try-as`. Without the feature flag, `.toThrow()` warns once and is a no-op (existing behavior preserved).
+- chore: the bundled try-as integration spec lives at `assembly/__tests__/try-as.spec.ts` and is run by `npm test`, which now passes `--enable try-as`.
+
+### Breaking
+
+- chore: clean break on snapshot file layout — the legacy `${base}.snap.json` and `${base}.${disambiguator}.snap.json` fallbacks have been removed. After upgrading, run `--create-snapshots` or `--overwrite-snapshots` once so snapshots are written at their new relative-path locations.
+- chore: artifact filenames no longer carry the `<mode>.<target>` suffix; tooling that grepped the old shape needs adjusting. `ast clean` removes any orphan artifacts.
+- chore: `.toThrow()` no longer accepts a bare value — it now requires a `() => void` callback and the try-as feature flag.
+
+### Tooling
+
+- chore: husky pre-commit / commit-msg / pre-push hooks (build → format → typecheck → lint on commit; conventional-commits enforcement; full test gate only on push to `main` of `JairusSW/as-test`).
+
 ## 2026-05-19 - v1.1.10
 
 - feat: when the user already declares `--transform json-as/...` in `buildOptions.args` or in their referenced `asconfig.json` (top-level `options.transform`, any `targets.*.transform`, or via a single level of `extends`), as-test no longer adds its own auto-include — letting users bring their own json-as version or load path. Detection matches bare specifiers (`json-as`, `json-as/transform`), absolute paths, and `./node_modules/...` paths.

package/as-test.config.schema.json

@@ -180,6 +180,14 @@
       ],
       "default": false
     },
+    "features": {
+      "type": "array",
+      "description": "Enabled feature names. \"try-as\" wires up the try-as transform; any other name is passed through to asc as --enable <name> (e.g. \"simd\", \"threads\", \"reference-types\"). CLI --enable/--disable flags override this list. Coverage has its own top-level \"coverage\" field.",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    },
     "env": {
       "description": "Environment variables injected when building/running. Accepts a .env file path, an array of KEY=value strings, or an object map.",
       "oneOf": [
@@ -400,6 +408,13 @@
                   }
                 ]
               },
+              "features": {
+                "type": "array",
+                "description": "Mode-specific feature list. Replaces the base list entirely when set.",
+                "items": {
+                  "type": "string"
+                }
+              },
               "fuzz": {
                 "type": "object",
                 "additionalProperties": false,

package/assembly/coverage.ts

@@ -13,18 +13,17 @@ export class CoverPoint {
 
 export class Coverage {
   public all: CoverPoint[] = [];
-  public allIndex: Map<string, i32> = new Map<string, i32>();
-  public hashes: Map<string, CoverPoint> = new Map<string, CoverPoint>();
-  public points: i32 = 0;
+  public byHash: Map<string, CoverPoint> = new Map<string, CoverPoint>();
+  public uncovered: i32 = 0;
   static SN: Coverage = new Coverage();
 }
 
 export function __REGISTER(point: CoverPoint): void {
-  if (Coverage.SN.allIndex.has(point.hash)) return;
-  Coverage.SN.points++;
-  Coverage.SN.allIndex.set(point.hash, Coverage.SN.all.length);
-  Coverage.SN.all.push(point);
-  Coverage.SN.hashes.set(point.hash, point);
+  const cov = Coverage.SN;
+  if (cov.byHash.has(point.hash)) return;
+  cov.byHash.set(point.hash, point);
+  cov.all.push(point);
+  cov.uncovered++;
 }
 
 export function __REGISTER_RAW(
@@ -38,7 +37,8 @@ export function __REGISTER_RAW(
   scopeName: string = "",
   depth: i32 = 0,
 ): void {
-  if (Coverage.SN.allIndex.has(hash)) return;
+  const cov = Coverage.SN;
+  if (cov.byHash.has(hash)) return;
   const point = new CoverPoint();
   point.file = file;
   point.hash = hash;
@@ -49,32 +49,28 @@ export function __REGISTER_RAW(
   point.scopeKind = scopeKind;
   point.scopeName = scopeName;
   point.depth = depth;
-  Coverage.SN.points++;
-  Coverage.SN.allIndex.set(hash, Coverage.SN.all.length);
-  Coverage.SN.all.push(point);
-  Coverage.SN.hashes.set(hash, point);
+  cov.byHash.set(hash, point);
+  cov.all.push(point);
+  cov.uncovered++;
 }
 
+// Hot path: invoked at every instrumented point. After first hit, subsequent
+// hits short-circuit on `executed` before any writes.
 export function __COVER(hash: string): void {
-  if (Coverage.SN.allIndex.has(hash)) {
-    const index = Coverage.SN.allIndex.get(hash);
-    if (index < Coverage.SN.all.length) {
-      unchecked(Coverage.SN.all[index]).executed = true;
-    }
-  }
-  if (Coverage.SN.hashes.has(hash)) Coverage.SN.hashes.delete(hash);
-}
-
-export function __HASHES(): Map<string, CoverPoint> {
-  return Coverage.SN.hashes;
+  const cov = Coverage.SN;
+  if (!cov.byHash.has(hash)) return;
+  const point = cov.byHash.get(hash);
+  if (point.executed) return;
+  point.executed = true;
+  cov.uncovered--;
 }
 
 export function __POINTS(): i32 {
-  return Coverage.SN.points;
+  return Coverage.SN.all.length;
 }
 
 export function __UNCOVERED(): i32 {
-  return Coverage.SN.hashes.size;
+  return Coverage.SN.uncovered;
 }
 
 export function __ALL_POINTS(): CoverPoint[] {

package/assembly/index.ts

@@ -752,3 +752,5 @@ function formatTime(time: f64): string {
 
   return `${_us}μs`;
 }
+
+export { mode, AS_TEST_MODE_NAME } from "./src/mode";