as-test 1.0.0 → 1.0.3

package/CHANGELOG.md

@@ -1,5 +1,119 @@
 # Change Log
 
+## 2026-03-27 - 1.0.3
+
+### Parallel Execution
+
+- perf: add persistent build workers for parallel `ast run` and `ast test` so AssemblyScript modules stay warm across file builds instead of spawning a fresh compiler process per build.
+- perf: route normal and single-build-worker builds through the same persistent compiler-worker path so serial `ast test`, `ast run`, and `ast fuzz` runs also reuse the AssemblyScript API instead of spawning a fresh `asc` process per file.
+- perf: make each queue worker own one file through all selected modes before releasing its slot, which removes mid-file mode interleaving across workers.
+- feat: add `--parallel` with an automatic worker heuristic that stays in the 2-4 worker range for typical suites and only grows past that when there are substantially more files to process.
+- fix: keep parallel mixed-mode builds correct by isolating long-lived compiler workers by build signature so WASI and bindings state does not leak between builds.
+- fix: make `--jobs`, `--build-jobs`, and `--run-jobs` cooperate with ordered queue reporting while still emitting final per-file results as each file completes.
+
+### Docs
+
+- docs: refresh the README and external docs set for the current explicit-import workflow, `ast init`, `--parallel`, the split snapshot flags, and the current fuzzing/runtime guidance.
+
+## 2026-03-25 - v1.0.2
+
+### Explicit Imports, Typings & Reporting
+
+- feat: export the public fuzz option and fuzzer types directly from `assembly/index.ts` so runtime exports and package typings stay aligned.
+- fix: remove the experimental side-effect `import "as-test"` path and return the package to explicit imports only in the transform, typings, examples, tests, and README.
+- fix: remove the temporary declaration-file build path and return the package to a simpler no-`.d.ts` setup.
+- fix: keep fuzzing green while leaving the in-repo AssemblyScript `IntegerOptions` ergonomics issue for a later API change.
+- fix: align summary output columns for `failed`, `skipped`, and `total` across test/run/fuzz totals.
+- fix: make `ast test --fuzz` print fuzz file results before the final combined summary, with one merged totals block that includes `Fuzz` alongside the normal test totals.
+
+### Assertions & Serialization
+
+- feat: split equality matchers into `toBe`, `toEqual`, and `toStrictEqual` with explicit semantics:
+  - `toBe` uses identity / exact primitive equality
+  - `toEqual` uses deep equality
+  - `toStrictEqual` uses deep equality plus runtime-type matching for managed values.
+- feat: support method-based class equality via `__as_test_equals(other, strict)`, with compile-time errors for unsupported managed classes instead of silent fallback behavior.
+- feat: support method-based managed-value JSON serialization via `__as_test_json()`, with `__as_test_json_value()` exported for nested field serialization.
+
+### Runtime & Tooling
+
+- refactor: replace the handwritten JS WIPC channel implementation with the `wipc-js` dependency.
+- chore: switch CLI TypeScript module resolution to `Bundler` so package export maps resolve correctly.
+- chore: run linting in the main test workflow in addition to the existing release workflow.
+- chore: update `prettier` to `3.8.1` and `assemblyscript-prettier` to `3.0.4`.
+- perf: trim WIPC traffic so passing expectations are not reported in realtime, while warnings and `log()` output now use structured events.
+
+### Config & Environment
+
+- feat: allow `env` config values to come from a `.env` path, `KEY=value` array, or object map.
+- feat: support merged env overrides at the top level, `buildOptions`, `runOptions`, and per-mode build/run config.
+- feat: disable coverage by default and add `coverage.include` / `coverage.exclude` glob filters so projects can opt in and scope reports explicitly.
+
+### Web Runner
+
+- feat: add a `web` target that runs bindings-style artifacts in a browser over a WebSocket-backed WIPC bridge.
+- feat: scaffold `.as-test/runners/default.web.js` and a `web-headless` mode during `ast init --target web`.
+- feat: prompt to install Chromium with Playwright when a web run starts without an available browser.
+- fix: remove per-file web runner startup noise from normal test output.
+
+### Docs
+
+- docs: remove outdated `run()` calls from README usage snippets where they are no longer needed.
+- docs: add a `docs/` directory with focused guides for setup, tests, fuzzing, mocking, snapshots, coverage, reporters, assertions, config, CLI usage, and diagnostics.
+- docs: link the new docs index from the main README.
+- docs: reorder the README to follow the beginner workflow from installation through tests, mocking, snapshots, fuzzing, and runtimes.
+- docs: simplify the main README and replace stale examples with snippets that reflect the current config shape and working APIs.
+- docs: update snapshot CLI examples to use `--create-snapshots`.
+
+### CI
+
+- fix: add a dedicated `test:ci` script and `as-test.ci.config.json` so CI stays on the Wasmtime/WASI path instead of fanning out into `web-headless`.
+- fix: remove the baked-in `web-headless` mode from the repo's default config so the project defaults stay on the Wasmtime/WASI runner.
+- feat: add a dedicated `examples.yml` workflow that runs the standalone examples individually on push.
+- feat: install Chromium through Playwright for the `07-web` example job and pass its executable through `BROWSER`.
+- feat: add local `act` defaults and package scripts so GitHub Actions workflows can be exercised before pushing.
+
+### Init & Examples
+
+- feat: `ast init` can scaffold a basic fuzzer example and now writes `assembly/tsconfig.json` for editor-friendly AssemblyScript setup.
+- feat: update the generated `.gitignore` block to keep the `.as-test/` root while excluding runners and snapshots.
+- feat: add more standalone fuzzing examples and a dedicated `07-web` example project.
+- fix: rename `05-mocking-and-import-snapshots` to `05-mocking-and-imports` and align its file/test labels with the new name.
+- docs: update examples to use side-effect `import "as-test"` style where possible.
+
+### Fuzzing
+
+- feat: add `ast fuzz` to build and run dedicated `*.fuzz.ts` bindings targets.
+- feat: add `ast test --fuzz` to run fuzz targets after the normal spec pass and print a combined console summary.
+- feat: add an AssemblyScript-first fuzz API via `fuzz("name", callback).generate((seed, run) => ...)`.
+- feat: add built-in `FuzzSeed` generators for booleans, numbers, bytes, strings, arrays, and picks.
+- feat: treat failed expectations and `false` returns as fuzz failures, while traps and throws are reported as crashes.
+- feat: add top-level `fuzz` config for fuzz target discovery and default driver settings.
+- feat: add `xfuzz(...)` for skipped fuzz targets and report fuzz results through the built-in reporters, including TAP output.
+- feat: store fuzz and runtime crash artifacts as stable `.as-test/crashes/<entry>.json` and `.as-test/crashes/<entry>.log` files.
+- fix: fail `ast fuzz` and `ast test --fuzz` on logical fuzz failures, not only crashes.
+- fix: disambiguate duplicate fuzz basenames using the selected input set so same-named fuzz files do not overwrite one another.
+- fix: auto-inject `run()` correctly for fuzz files without being confused by generator-local `run(...)` parameters.
+- fix: make `try-as` opt-in even when the package is installed; it now only runs when explicitly enabled.
+
+### Snapshots & Logs
+
+- feat: switch text snapshots to readable `.snap` files with path-preserving output under `.as-test/snapshots/`.
+- feat: add comment support in `.snap` files and use clearer snapshot IDs like `Suite > test`, `Suite > test [name]`, and `Suite > test #2`.
+- feat: add readable per-file `.log` artifacts with mode, build command, run command, snapshot summary, suite/test totals, and failure details.
+- feat: split snapshot write flags into `--create-snapshots` and `--overwrite-snapshots`.
+- fix: preserve existing snapshot file preambles/comments on rewrite and only generate the default snapshot header when a new `.snap` file is first created.
+- fix: canonicalize legacy snapshot IDs on load/assert/write so old `::0` and `::name` variants collapse into the new readable IDs.
+
+### Mocking & Runtime API
+
+- fix: remove `snapshotImport(...)` and `restoreImport(...)` from the active runtime API in favor of the simpler mocking surface.
+- fix: escape control bytes and invalid surrogate code units consistently in runtime JSON serialization, including WIPC event frames and fuzz failure payloads.
+
+## 2026-03-11 - v1.0.1
+
+- patch: automatically tokenize buildOptions.args so that `["--enable simd"]` becomes `["--enable", "simd"]`
+
 ## 2026-03-11 - v1.0.0
 
 ### Docs
@@ -12,7 +126,8 @@
 - feat: reject unknown config keys with nearest-key suggestions.
 - feat: show structured validation diagnostics with JSON paths and fix hints.
 - feat: fail fast on invalid config JSON with parser error details.
-- 
+-
+
 ### Release Readiness
 
 - fix: resolve `@assemblyscript/wasi-shim` and `try-as` with package resolution instead of assuming a local `./node_modules` folder, so nested example projects and other valid installs run correctly.