vitest-pool-assemblyscript 0.2.1 → 0.2.3

package/README.md

@@ -2,305 +2,160 @@
 
 AssemblyScript unit testing for your Vitest workflow: Simple, fast, familiar, AS-native.
 
-This is a [Vitest](https://vitest.dev) ["custom pool"](https://vitest.dev/guide/advanced/pool.html) which knows how to compile AssemblyScript to WASM, harness WASM to run tests, and report those results to vitest. It co-exists with existing JavaScript/TypeScript tests, and is designed for incremental adoption.
+This is a [Vitest](https://vitest.dev) [custom pool](https://vitest.dev/guide/advanced/pool.html) which can compile AssemblyScript to WASM, harness WASM to run tests, and report those results to vitest. It co-exists with existing JavaScript/TypeScript tests, and is designed for incremental adoption.
 
-- [Quickstart](#quickstart)
+- [Quick Start](#quick-start)
+- [Compatibility](#compatibility)
 - [Features](#features)
-- [Configuration](#configuration)
-- [Writing Tests](#writing-tests)
+- [Configuration Guide](docs/configuration-guide.md)
+- [Providing WASM Imports](docs/providing-wasm-imports.md)
+- [Writing Tests Guide](#writing-tests-guide)
 - [Matcher API](#matcher-api)
 - [Project Status & Expectations](#project-status--expectations)
-- [Installation Guide (Development Preview)](#installation-guide-development-preview)
+- [License](#license)
 
-**Note: 🚧 This project is currently *Pre-Release, Pre-v1, Under Active Development* 🚧**
-- See [Project Status & Expectations](#project-status--expectations) for what's working now, and to see what's planned!
+**Note: 🚧 This project is still early-stage and currently *Under Active Development* 🚧**
+- All features listed in the [Features](#features) section are stable and assumed to be bug-free
+- Native instrumentation prebuilds are available cross-platform
+- Expect matchers are stable (except where noted below), with more coming soon
+- See [Project Status & Expectations](#project-status--expectations) to see what's still planned!
 
----
-
-## Quickstart
-
-Coming Soon!
+Please [report a bug / request a feature](https://github.com/themattspiral/vitest-pool-assemblyscript/issues/new) if you encounter something you'd like to share!
 
 ---
 
-## Features
-
-### Vitest Integration
-- Use familiar `vitest` commands, CLI spec and test filtering, watch mode
-- Works with Vitest UI, reporters, and coverage tools
-- Project (workspace) config allows coexisting AssemblyScript pools and JavaScript pools
-- Hybrid Coverage Provider unifies test reports from multiple pools (delegating to v8 for JS/TS coverage)
-- Coverage reporting using any vitest reporter (`html`, `lcov`, `json`, etc)
-- Dual vitest 3.x / 4.x support
-
-### Per-Test WASM Isolation
-- Each AssemblyScript test file is compiled to a WASM binary once
-- Each test case runs in a fresh WASM instance (reusing the compiled binary)
-- One crashing test doesn't kill the rest within the same suite
-- `toThrowError()` matcher can be used to catch and expect specific errors (which trap and abort)
-
-### Familiar Developer Experience
-- Suite and test definition using `describe()` and `test()` in AssemblyScript
-- Inline test option configuration for common vitest options: `timeout`, `retry`, `skip`, `only`, `fails`
-- Assertion matching API based on vitest/jest `expect()` API. See [Matcher API](#matcher-api) for the set of supported matchers and differences from JavaScript 
-- Highlighted diffs for assertion and runtime failures, which point to source code
-- Source-mapped WASM error stack traces (accurate source `function file:line:column`)
-- AssemblyScript console output captured and provided to vitest for display
-- No boilerplate patterns for: `run()`, `endTest()`, `fs.readFile`, `WebAssembly.Instance`, etc
-
-### Performance & Customization
-- Parallel execution thread pool
-- Lightweight coverage instrumentation using separate memory
-- In-memory binaries and source maps for minimal file I/O
-- Coverage for inlined (`@inline`) code
-- Enforced hard timeouts for long-running WASM via thread termination, with intelligent resume
-- Configurable AssemblyScript compiler options
-- Configurable test memory size
-- Configurable WASM imports with access to memory
-
-### Why This Over [Alternative]?
+## Quick Start
 
-There are other standalone testing frameworks for AssemblyScript testing, including:
-- [assemblyscript-unittest-framework](https://github.com/wasm-ecosystem/assemblyscript-unittest-framework): A full-featured AS test framework
-  - Many thanks owed to this project for inspiring parts of our discovery and instrumentation approach
-- [as-test](https://github.com/JairusSW/as-test): A minimal and fast AssemblyScript test framework and runner
-- [Built with AssemblyScript - Testing & Benchmarking](https://www.assemblyscript.org/built-with-assemblyscript.html#testing-benchmarking) may track more
+### 1. Install
 
----
+```bash
+npm install -D vitest vitest-pool-assemblyscript assemblyscript
+```
 
-## Configuration
+### 2. Configure Vitest
 
-In your project's `vitest.config.ts`:
-- The `test` project configuration helpers needed depend on which version of vitest you're using.
-- The `coverage` configuration is the same across versions (shown in the first example below).
+Create or update `vitest.config.ts`. See the [Configuration Guide](docs/configuration-guide.md) for all supported vitest options, pool options, coverage configuration, and multi-project setups.
 
-### vitest 4.x.x Multiple-Project Config:
+**vitest 4.x:**
 ```typescript
-import { defineConfig, defineProject } from 'vitest/config';
+import { defineConfig } from 'vitest/config';
 import { createAssemblyScriptPool } from 'vitest-pool-assemblyscript/config';
 
 export default defineConfig({
   test: {
-    projects: [
-      // AssemblyScript project
-      defineProject({
-        test: {
-          name: {
-            label: 'assemblyscript-tests',
-            color: 'yellow'
-          },
-          include: ['test/assembly/**/*.as.{test,spec}.ts'],
-          
-          // supported vitest options
-          bail: 2,            // stop test run after this many failures
-          retry: 0,           // number of retries to attempt after initial failure
-          testTimeout: 500,   // ms to wait before terminating test
-          // allowOnly: true, // whether or not to respect test.only and describe.only
-          // maxWorkers: 8,   // concurrent file execution threads (default: available parallelism)
-
-          // configure vitest to use this custom pool for test files in `include`
-          pool: createAssemblyScriptPool({
-            stripInline: true,          // true to remove @inline decorators for coverage (default: true)
-            testMemoryPagesInitial: 2,  // initial WASM memory size in pages (default: 1)
-            testMemoryPagesMax: 4,      // maximum WASM memory size in pages (default: undefined)
-            extraCompilerFlags: ['--runtime', 'incremental'],      // additional asc flags to customize AS compilation
-            wasmImportsFactory: 'test-helpers/create-imports.js',  // factory function to create your own WASM imports
-          }),
-        }
-      }),
-
-      // JavaScript/TypeScript project
-      defineProject({
-        test: {
-          name: {
-            label: 'javascript-typescript-tests',
-            color: 'blue'
-          },
-          include: ['test/js/*.{test,spec}.{ts,js}'],
-        }
-      }),
-    ]
+    include: ['test/assembly/**/*.as.test.ts'],
+    pool: createAssemblyScriptPool(),
   },
-
-  // Coverage config must be at root level (applies to all projects).
-  // The "hybrid" provider delegates JS to v8, and merges AS coverage into the final report
   coverage: {
     provider: 'custom',
     customProviderModule: 'vitest-pool-assemblyscript/coverage',
-    assemblyScriptInclude: ['assembly/**/*.ts'],      // example, include AS sources to report on
-    assemblyScriptExclude: ['assembly/helpers/*.ts'], // example, exclude AS sources from reporting
-    
-    // all other v8 coverage options will be passed through to delegated v8 provider
+    assemblyScriptInclude: ['assembly/**/*.ts'],
     enabled: true,
-    cleanOnRerun: true,
-    reportsDirectory: './coverage',
-    reporter: ['text', 'lcov', 'html'],
-    include: ['src/**/*.ts'],            // example, include JS/TS sources to report on
   },
 });
 ```
 
-### vitest 4.x.x Single-Project Config:
+**vitest 3.x:**
 ```typescript
-import { defineConfig } from 'vitest/config';
-import { createAssemblyScriptPool } from 'vitest-pool-assemblyscript/config';
+import { defineAssemblyScriptConfig } from 'vitest-pool-assemblyscript/v3/config';
 
-export default defineConfig({
+export default defineAssemblyScriptConfig({
   test: {
-    pool: createAssemblyScriptPool({
-      // no change to available options (stripInline, testMemoryPagesInitial, etc)
-    }),
+    include: ['test/assembly/**/*.as.test.ts'],
+    pool: 'vitest-pool-assemblyscript/v3',
   },
-  coverage: {
-    // no change to available options
-  }
+  // coverage configuration mirrors v4
 });
 ```
 
-### vitest 3.2.x Multiple-Project Config:
+### 3. Write a Test
+
+Create a test file (e.g. `test/assembly/example-file.as.test.ts`):
+
 ```typescript
-import { defineConfig, defineProject } from 'vitest/config';
-import { defineAssemblyScriptProject } from 'vitest-pool-assemblyscript/v3/config';
+import { test, describe, expect } from "vitest-pool-assemblyscript/assembly";
 
-export default defineConfig({
-  test: {
-    projects: [
-      defineProject({
-        test: {
-          // JS/TS project config...
-        }
-      }),
-      defineAssemblyScriptProject({
-        test: {
-          // AS project config... (standard name/label, include, etc)
-
-          pool: 'vitest-pool-assemblyscript/v3',  // in v3, point to the module
-          poolOptions: {
-            assemblyScript: {
-              // same available options as v4 createAssemblyScriptPool are passed here
-              
-              // Additonal - v3 Only
-              // maxThreadsV3: 8    // concurrent test file threads to execute (default: availableParallelism - 1)
-            }
-          }
-        }
-      })
-    ]
-  },
-  
+test("basic math", () => {
+  expect(2 + 2).toBe(4);
+});
+
+describe("an example suite", () => {
+  test("string equality", () => {
+    expect("hello").toBe("hello");
+    expect("hello").not.toBe("world");
+  });
 });
 ```
 
-### vitest 3.2.x Single-Project Config:
-```typescript
-import { defineAssemblyScriptConfig } from 'vitest-pool-assemblyscript/v3/config';
+### 4. Run
 
-export default defineAssemblyScriptConfig({
-  test: {
-    pool: 'vitest-pool-assemblyscript/v3',
-    poolOptions: {
-      assemblyScript: {
-        // same available options as v4 createAssemblyScriptPool and v3 multi-project
-      }
-    }
-  },
-});
+```bash
+npx vitest run
 ```
 
-### Framework-Provided Imports
+---
 
-**`console`**
-The pool provides the full implementation of the [AssemblyScript `console` interface](https://www.assemblyscript.org/stdlib/console.html). This means you can transparently use `console.log("some string")` in your tests, and the output will be fed to vitest and displayed with the test results.
+## Compatibility
 
-If you prefer to do something else with your test console output, you may provide your own versions of these functions to the "env" module - See the next section for details on how to do this.
+| Dependency | Supported Versions |
+|---|---|
+| Node.js | 20, 22, 24+ |
+| Vitest | 3.2.x, 4.x |
+| AssemblyScript | 0.28+ |
 
-**`trace`**
-The pool also provides an implementation for `trace`, which passes through to Node `console.trace()` immediately for debugging.
+**Platforms with prebuilt native binaries:**
 
-**`abort`**
-The pool handles assertion errors, runtime errors, and expected throws by providing an abort handler. This cannot be user-overridden.
+| | x64 | arm64 |
+|---|---|---|
+| Linux (glibc) | ✓ | ✓ |
+| Linux (musl/Alpine) | ✓ | |
+| macOS | ✓ | ✓ |
+| Windows | ✓ | ✓ |
 
+---
 
-### User-Provided Imports with `WasmImportsFactory`
-To provide your own WebAssembly imports, configure `wasmImportsFactory` to point to an ES module which exports a factory function to create your imports:
-```typescript
-  // v4
-  // ...
-    pool: createAssemblyScriptPool({
-      wasmImportsFactory: 'test-helpers/create-imports.js',
-    })
-  // ...
-
-  // v3
-  // ...
-  poolOptions: {
-    assemblyScript: {
-      wasmImportsFactory: 'test-helpers/create-imports.js',
-    }
-  }
-  // ...
-```
+## Features
 
-The type signature for this function looks like this:
-```typescript
-type WasmImportsFactory = (moduleInfo: WasmImportsFactoryInfo) => WebAssembly.Imports;
-```
+### Vitest Integration
+- Use familiar `vitest` commands, CLI spec and test filtering, watch mode
+- Works with Vitest UI, reporters, and coverage tools
+- Project (workspace) config allows coexisting AssemblyScript pools and JavaScript pools
+- Hybrid Coverage Provider unifies test reports from multiple pools (delegating to v8 for JS/TS coverage)
+- Coverage reporting using any vitest reporter (`html`, `lcov`, `json`, etc)
+- Dual vitest 3.x / 4.x support
 
-And the `moduleInfo` argument that it is provided with looks like this:
-```typescript
-interface WasmImportsFactoryInfo {
-  module: WebAssembly.Module;
-  memory: WebAssembly.Memory;
-  utils: {
-    // convenience function for extracting returned strings from WASM memory
-    liftString: (stringPtr: number) => string | undefined;
-  }
-}
-```
+### Per-Test WASM Isolation
+- Each AssemblyScript test file is compiled to a WASM binary once
+- Each test case runs in a fresh WASM instance (reusing the compiled binary)
+- One crashing test doesn't kill the rest within the same suite
+- `toThrowError()` matcher can be used to catch and expect specific errors (which trap and abort)
 
-You may provide imports for any module name you wish. Here is an example factory function which uses the "env" module:
-```js
-export default function createWasmImports({ memory, module, utils }) {
-  return {
-    env: {
-      parseIntStringFunction: (inputStrPtr) => {
-        return parseInt(utils.liftString(inputStrPtr));
-      }
-    }
-  };
-}
-```
+### Familiar Developer Experience
+- Suite and test definition using `describe()` and `test()` in AssemblyScript
+- Inline test option configuration for common vitest options: `timeout`, `retry`, `skip`, `only`, `fails`
+- Assertion matching API based on vitest/jest `expect()` API. See [Matcher API](#matcher-api) for the set of supported matchers and differences from JavaScript 
+- Highlighted diffs for assertion and runtime failures, which point to source code
+- Source-mapped WASM error stack traces (accurate source `function file:line:column`)
+- AssemblyScript console output captured and provided to vitest for display
+- No boilerplate patterns for: `run()`, `endTest()`, `fs.readFile`, `WebAssembly.Instance`, etc
 
-Example AssemblyScript source code which uses this imported function (the "env" module name is specified):
-```typescript
-@external("env", "parseIntStringFunction")
-declare function parseIntStringFunction(input: string): i32;
+### Performance & Customization
+- Parallel execution thread pool
+- Lightweight coverage instrumentation using separate memory
+- In-memory binaries and source maps for minimal file I/O
+- Coverage for inlined (`@inline`) code
+- Enforced hard timeouts for long-running WASM via thread termination, with intelligent resume
+- Configurable AssemblyScript compiler options
+- Configurable test memory size
+- Configurable WASM imports with access to memory
 
-export function runParseIntStringFunction(input: string): i32 {
-  return parseIntStringFunction(input);
-}
-```
+---
 
-#### Module Names
-If you omit the module name in `@external` (e.g. `@external("parseIntStringFunction")`) or omit `@external` entirely, AssemblyScript uses the source file's own name (without the last file extension) as the module name, making it impractical to provide matching imports to every source file independently if you use imported functions across multiple places in your source. It is recommended to always specify a shared module name (such as "env") for this reason.
-
-Conversely, if you need to provide imports targeted to a specific source file, this behavior provides a way to do that as well. For example, if you have a source AS file called `my-file.as.ts` with `declare function myFunc(input: string): i32;` in it and omit the `@external` decorator, then you can import the function *only to this file* with:
-```js
-export default function createWasmImports({ utils }) {
-  return {
-    // default source file module name (omits the .ts extension)
-    'my-file.as': {
-      myFunc: (inputStrPtr) => {
-        return parseInt(utils.liftString(inputStrPtr));
-      }
-    }
-  };
-}
-```
+See also: **[Configuration Guide](docs/configuration-guide.md)** | **[Providing WASM Imports](docs/providing-wasm-imports.md)**
 
 ---
 
-## Writing Tests
+## Writing Tests Guide
 
 Import `test`, `describe`, `expect` (and `TestOptions` if needed) from `vitest-pool-assemblyscript/assembly`.
 
@@ -372,6 +227,10 @@ test.fails("expected failure with retry", TestOptions.retry(3), () => {
 });
 ```
 
+### Lifecycle Hooks (Setup & Teardown)
+
+Coming Soon!
+
 ---
 
 ## Matcher API
@@ -503,13 +362,12 @@ expect(() => { throw new Error("boom"); }).toThrowError("boom");
 
 ## Project Status & Expectations
 
-**This is a pre-v1 project** being developed in the open by an interested individual. Most core functionality is working, with a long list of planned features and polish to be added as time allows.
-
-*(Note: Not yet published to npm - currently development only)*
+**This is an early-stage project** being developed in the open by an interested individual with a career of experience shipping production code.
+- All features listed in the [Features](#features) section are stable and assumed to be bug-free
+- Native instrumentation prebuilds are available cross-platform
+- Expect matchers are stable (except where noted above), with more coming soon
 
-### Current State
-
-All features listed in the [Features](#features) section are working and assumed to be bug-free. Please [report a bug](https://github.com/themattspiral/vitest-pool-assemblyscript/issues/new) if you encounter one.
+Please [report a bug / request a feature](https://github.com/themattspiral/vitest-pool-assemblyscript/issues/new) if you encounter something you'd like to share!
 
 **⚠️ Known Limitations - Coming Soon:**
 - **Function-level coverage only**: No statement, branch, or line coverage yet
@@ -540,82 +398,24 @@ All features listed in the [Features](#features) section are working and assumed
 - TBD
 
 **✖️ Out of Scope (Currently):**
-- Compiler integration with other compile-to-WASM languages (Rust, C++)
-  - I would LOVE to expand this project to a more generic wasm pool, supporting pluggable compilers and ast parsing for different WASM ecosystems and toolchains
-  - Not in scope now because of time and effort. If you want to pay me to work on this [get in touch](https://github.com/themattspiral)!
 - Generic JS-harness testing of any precompiled WASM binary
+- Compiler & matcher integration with other compile-to-WASM languages (e.g. Rust and C++ with Emscripten)
+  - I would LOVE to expand this project to cover additional cases, supporting pluggable compilers, ast parsing, and matchers for different WASM ecosystems and toolchains
+  - Not in scope now because of time and effort
+  - If you want to pay me to work on this, please [get in touch](https://github.com/themattspiral)!
 
 ---
 
-## Installation Guide (Development Preview)
-
-**⚠️ Important:** This project is under active development. Features and APIs may change without notice. No guarantees are made about stability or functionality.
+## Prior Work
 
-**Feedback Welcome:** If you try this out, please open an issue on GitHub with your experience, bugs, or suggestions!
+There are other (standalone) testing frameworks for AssemblyScript testing which have inspired this project. In particular, many thanks are owed to [assemblyscript-unittest-framework](https://github.com/wasm-ecosystem/assemblyscript-unittest-framework) for inspiring parts of our test discovery and instrumentation walking approaches.
 
-### Prerequisites
-- Node.js 20.0.0+ (required due to our multi-memory coverage approach)
-- Vitest 3.2.0+ or 4.0.0+
-- AssemblyScript 0.28+
-- C++ build tools (dev only - distributed package will include prebuilds):
-  - GCC 7+ or Clang 5+ (C++17 support required)
-  - Python 3.x (required by node-gyp)
-
-### Setup
-
-1. **Clone the repository:**
-```bash
-git clone https://github.com/themattspiral/vitest-pool-assemblyscript.git
-cd vitest-pool-assemblyscript
-```
-
-2. **Install Binaryen C++ dependencies, then npm deps**
-```bash
-npm run setup-binaryen
-npm install
-```
-The `setup-binaryen` script downloads prebuilt Binaryen libraries and C++ headers to `third_party/binaryen/`. These are used to build the native addon that extracts debug info from WASM binaries.
-
-3. **Build Native Addon**
-```bash
-npm run build:native
-```
-
-4. **Build Pool**
-```bash
-npm run build
-```
-
-5. **Link the pool to your project:**
-```bash
-# In vitest-pool-assemblyscript:
-npm link
-
-# In your project directory:
-npm link vitest-pool-assemblyscript
-```
-
-6. **Configure Vitest** 
-
-See the [Configuration](#configuration) section.
-
-7. **Write your tests**
-See the [Writing Tests](#writing-tests) section.
-
-8. **Run your tests:**
-```bash
-# Run all tests once
-npx vitest run
-
-# Run specific test file
-npx vitest run example.as.test.ts
-
-# Run specific test in specific file
-npx vitest run example.as.test.ts -t "my test name"
-```
+See [Built with AssemblyScript - Testing & Benchmarking](https://www.assemblyscript.org/built-with-assemblyscript.html#testing-benchmarking) for other related work.
 
 ---
 
 ## License
 
 [MIT](LICENSE)
+ - Portions of this software have been derived from third-party works which are licenced under different terms. Individual code contributions have been noted where applicable and are accompanied by their respective licenses.
+ - See the license file and source code for details

package/binding.gyp

@@ -27,7 +27,7 @@
             "-lpthread"
           ],
           # Enable C++ exceptions (node-gyp disables them by default)
-          "cflags_cc": ["-std=c++17", "-fexceptions", "-O3"],
+          "cflags_cc": ["-std=c++20", "-fexceptions", "-O3"],
           "cflags!": ["-fno-exceptions"],
           "cflags_cc!": ["-fno-exceptions"]
         }],
@@ -38,9 +38,9 @@
           "xcode_settings": {
             "GCC_ENABLE_CPP_EXCEPTIONS": "YES",
             "CLANG_CXX_LIBRARY": "libc++",
-            # Minimum macOS deployment target for C++17 support
+            # Minimum macOS deployment target for C++20 support
             "MACOSX_DEPLOYMENT_TARGET": "10.15",
-            "OTHER_CPLUSPLUSFLAGS": ["-std=c++17", "-fexceptions", "-O3"]
+            "OTHER_CPLUSPLUSFLAGS": ["-std=c++20", "-fexceptions", "-O3"]
           }
         }],
         ["OS=='win'", {
@@ -52,7 +52,7 @@
             "VCCLCompilerTool": {
               # Enable C++ exception handling (/EHsc)
               "ExceptionHandling": 1,
-              "AdditionalOptions": ["/std:c++17"]
+              "AdditionalOptions": ["/std:c++20"]
             }
           }
         }]

package/dist/{compile-runner-8h0dBwG2.mjs → compile-runner-xGvQwgNf.mjs}

@@ -2,7 +2,7 @@ import { POOL_ERROR_NAMES, POOL_INTERNAL_PATHS } from "./constants-CA50WBdr.mjs"
 import { createPoolErrorFromAnyError, debug, getTestErrorFromPoolError } from "./debug-IeEHsxy0.mjs";
 import { failFile, getFullTaskHierarchy, prepareFileTaskForCollection } from "./vitest-file-tasks-BUwzh375.mjs";
 import { getTaskLogLabel, getTaskLogPrefix } from "./vitest-tasks-BKS7689f.mjs";
-import { executeWASMDiscovery, flushRpcUpdates, reportFileCollected, reportFileError, reportFileQueued, reportUserConsoleLogs } from "./load-user-imports-J9eaAW0_.mjs";
+import { executeWASMDiscovery, flushRpcUpdates, reportFileCollected, reportFileError, reportFileQueued, reportUserConsoleLogs } from "./load-user-imports-Bbmpaciu.mjs";
 import { compileAssemblyScript } from "./compiler-CN6BRK_N.mjs";
 import { basename, relative } from "node:path";
 
@@ -77,4 +77,4 @@ async function runCompileAndDiscover(file, logModule, rpc, poolOptions, projectR
 
 //#endregion
 export { runCompileAndDiscover };
-//# sourceMappingURL=compile-runner-8h0dBwG2.mjs.map
+//# sourceMappingURL=compile-runner-xGvQwgNf.mjs.map

package/dist/{compile-runner-8h0dBwG2.mjs.map → compile-runner-xGvQwgNf.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"compile-runner-8h0dBwG2.mjs","names":[],"sources":["../src/pool-thread/runner/compile-runner.ts"],"sourcesContent":["/**\n * Worker thread test runner logic for AssemblyScript Pool\n */\n\nimport { basename, relative } from 'node:path';\nimport type { File } from '@vitest/runner/types';\nimport type { SerializedDiffOptions } from '@vitest/utils/diff';\n\nimport type {\n  AssemblyScriptCompilerOptions,\n  AssemblyScriptConsoleLog,\n  AssemblyScriptConsoleLogHandler,\n  InstrumentationOptions,\n  ResolvedAssemblyScriptPoolOptions,\n  ThreadImports,\n  WASMCompilation,\n  WorkerRPC,\n} from '../../types/types.js';\nimport {\n  ASSEMBLYSCRIPT_LIB_PREFIX,\n  POOL_ERROR_NAMES,\n  POOL_INTERNAL_PATHS,\n} from '../../types/constants.js';\nimport { executeWASMDiscovery } from '../../wasm-executor/index.js';\nimport { debug } from '../../util/debug.js';\nimport {\n  reportFileQueued,\n  reportFileCollected,\n  reportUserConsoleLogs,\n  flushRpcUpdates,\n  reportFileError,\n} from '../rpc-reporter.js';\nimport { createPoolErrorFromAnyError, getTestErrorFromPoolError } from '../../util/pool-errors.js';\nimport { compileAssemblyScript } from '../../compiler/index.js';\nimport {\n  getTaskLogLabel,\n  getTaskLogPrefix,\n} from '../../util/vitest-tasks.js';\nimport {\n  failFile,\n  getFullTaskHierarchy,\n  prepareFileTaskForCollection,\n} from '../../util/vitest-file-tasks.js';\n\nlet threadCompilationCount: number = 0;\n\nexport async function runCompileAndDiscover(\n  file: File,\n  logModule: string,\n  rpc: WorkerRPC,\n  poolOptions: ResolvedAssemblyScriptPoolOptions,\n  projectRoot: string,\n  collectCoverage: boolean,\n  relativeUserCoverageExclusions: string[],\n  threadImports: ThreadImports,\n  diffOptions?: SerializedDiffOptions,\n  testNamePattern?: RegExp,\n  allowOnly?: boolean,\n): Promise<WASMCompilation | undefined> {\n  const base = basename(file.filepath);\n  const fileLogPrefix = getTaskLogPrefix(logModule, base, file);\n  const fileLogLabel = getTaskLogLabel(base, file);\n\n  debug(`${fileLogPrefix} - Beginning runCompileAndDiscover for \"${file.filepath}\" at ${Date.now()}`);\n\n  const runStart = performance.now();\n  let compilation: WASMCompilation | undefined;\n\n  try {\n    await reportFileQueued(rpc, file, logModule, fileLogLabel);\n\n    // TODO - move to options helpers\n    const relativeTestFilePath = relative(projectRoot, file.filepath);\n    const instrumentationOptions: InstrumentationOptions = {\n      relativeExcludedFiles: [\n        relativeTestFilePath,\n        ...POOL_INTERNAL_PATHS,\n        ...relativeUserCoverageExclusions,\n      ],\n      excludedLibraryFilePrefix: ASSEMBLYSCRIPT_LIB_PREFIX,\n      coverageMemoryPagesMin: poolOptions.coverageMemoryPagesInitial,\n      coverageMemoryPagesMax: poolOptions.coverageMemoryPagesMax,\n    };\n    const compilerOptions: AssemblyScriptCompilerOptions = {\n      stripInline: poolOptions.stripInline,\n      projectRoot: projectRoot,\n      shouldInstrument: collectCoverage,\n      instrumentationOptions,\n      extraFlags: poolOptions.extraCompilerFlags\n    };\n\n    const { binary, sourceMap, debugInfo, compileTiming } = await compileAssemblyScript(\n      file.filepath,\n      compilerOptions,\n      logModule,\n      fileLogLabel\n    );\n    file.setupDuration = compileTiming;\n    threadCompilationCount++;\n\n    debug(`${fileLogPrefix} - TIMING compileAssemblyScript total `\n      + `(thread comp # ${threadCompilationCount}): ${compileTiming.toFixed(2)} ms`\n    );\n    \n    const logMessages: AssemblyScriptConsoleLog[] = [];\n    const handleLog: AssemblyScriptConsoleLogHandler = (msg: string, isError: boolean = false): void => {\n      logMessages.push({ msg, time: Date.now(), isError });\n    };\n    \n    const discoverStart = performance.now();\n\n    await executeWASMDiscovery(\n      binary,\n      sourceMap,\n      base,\n      poolOptions,\n      collectCoverage,\n      handleLog,\n      file,\n      logModule,\n      threadImports,\n      diffOptions\n    );\n\n    // set skips when using only and/or user test name pattern, skip file task if all tests skipped\n    prepareFileTaskForCollection(file, testNamePattern, allowOnly);\n\n    file.collectDuration = performance.now() - discoverStart;\n    debug(`${fileLogPrefix} - TIMING Discovery Phase: ${file.collectDuration.toFixed(2)} ms`);\n\n    // vitest collect - report discovery results\n    await Promise.all([\n      // Report user console logs\n      reportUserConsoleLogs(rpc, logMessages, logModule, base, file),\n\n      // Report onCollected with collected and filtered tasks\n      reportFileCollected(rpc, file, logModule, fileLogLabel),\n    ]);\n\n    debug(() => `${fileLogPrefix} - Collected Test Suite Hierarchy:\\n${getFullTaskHierarchy(file)}`);\n\n    const totalTime = performance.now() - runStart;\n    debug(`${fileLogPrefix} - TIMING Compilation and Discovery: ${totalTime.toFixed(2)} ms`);\n\n    compilation = {\n      filePath: file.filepath,\n      binary,\n      sourceMap,\n      debugInfo,\n    };\n  } catch (error) {\n    const poolError = createPoolErrorFromAnyError(\n      `${fileLogLabel} - runCompileAndDiscover failure in worker`,\n      POOL_ERROR_NAMES.WASMExecutionHarnessError,\n      error\n    );\n    const testError = getTestErrorFromPoolError(poolError);\n\n    failFile(file, testError, runStart);\n\n    await reportFileQueued(rpc, file, logModule, fileLogLabel);\n    await reportFileError(rpc, file, logModule, fileLogLabel);\n\n    debug(`${fileLogPrefix} - Reported file error`);\n  } finally {\n    await flushRpcUpdates(rpc);\n    debug(`${fileLogPrefix} - runCompileAndDiscover Completed`);\n  }\n\n  return compilation;\n}\n"],"mappings":";;;;;;;;;;;;AA4CA,IAAI,yBAAiC;AAErC,eAAsB,sBACpB,MACA,WACA,KACA,aACA,aACA,iBACA,gCACA,eACA,aACA,iBACA,WACsC;CACtC,MAAM,OAAO,SAAS,KAAK,SAAS;CACpC,MAAM,gBAAgB,iBAAiB,WAAW,MAAM,KAAK;CAC7D,MAAM,eAAe,gBAAgB,MAAM,KAAK;AAEhD,OAAM,GAAG,cAAc,0CAA0C,KAAK,SAAS,OAAO,KAAK,KAAK,GAAG;CAEnG,MAAM,WAAW,YAAY,KAAK;CAClC,IAAI;AAEJ,KAAI;AACF,QAAM,iBAAiB,KAAK,MAAM,WAAW,aAAa;EAI1D,MAAM,yBAAiD;GACrD,uBAAuB;IAFI,SAAS,aAAa,KAAK,SAAS;IAI7D,GAAG;IACH,GAAG;IACJ;GACD;GACA,wBAAwB,YAAY;GACpC,wBAAwB,YAAY;GACrC;EACD,MAAM,kBAAiD;GACrD,aAAa,YAAY;GACZ;GACb,kBAAkB;GAClB;GACA,YAAY,YAAY;GACzB;EAED,MAAM,EAAE,QAAQ,WAAW,WAAW,kBAAkB,MAAM,sBAC5D,KAAK,UACL,iBACA,WACA,aACD;AACD,OAAK,gBAAgB;AACrB;AAEA,QAAM,GAAG,cAAc,uDACD,uBAAuB,KAAK,cAAc,QAAQ,EAAE,CAAC,KAC1E;EAED,MAAM,cAA0C,EAAE;EAClD,MAAM,aAA8C,KAAa,UAAmB,UAAgB;AAClG,eAAY,KAAK;IAAE;IAAK,MAAM,KAAK,KAAK;IAAE;IAAS,CAAC;;EAGtD,MAAM,gBAAgB,YAAY,KAAK;AAEvC,QAAM,qBACJ,QACA,WACA,MACA,aACA,iBACA,WACA,MACA,WACA,eACA,YACD;AAGD,+BAA6B,MAAM,iBAAiB,UAAU;AAE9D,OAAK,kBAAkB,YAAY,KAAK,GAAG;AAC3C,QAAM,GAAG,cAAc,6BAA6B,KAAK,gBAAgB,QAAQ,EAAE,CAAC,KAAK;AAGzF,QAAM,QAAQ,IAAI,CAEhB,sBAAsB,KAAK,aAAa,WAAW,MAAM,KAAK,EAG9D,oBAAoB,KAAK,MAAM,WAAW,aAAa,CACxD,CAAC;AAEF,cAAY,GAAG,cAAc,sCAAsC,qBAAqB,KAAK,GAAG;AAGhG,QAAM,GAAG,cAAc,wCADL,YAAY,KAAK,GAAG,UACkC,QAAQ,EAAE,CAAC,KAAK;AAExF,gBAAc;GACZ,UAAU,KAAK;GACf;GACA;GACA;GACD;UACM,OAAO;AAQd,WAAS,MAFS,0BALA,4BAChB,GAAG,aAAa,6CAChB,iBAAiB,2BACjB,MACD,CACqD,EAE5B,SAAS;AAEnC,QAAM,iBAAiB,KAAK,MAAM,WAAW,aAAa;AAC1D,QAAM,gBAAgB,KAAK,MAAM,WAAW,aAAa;AAEzD,QAAM,GAAG,cAAc,wBAAwB;WACvC;AACR,QAAM,gBAAgB,IAAI;AAC1B,QAAM,GAAG,cAAc,oCAAoC;;AAG7D,QAAO"}
+{"version":3,"file":"compile-runner-xGvQwgNf.mjs","names":[],"sources":["../src/pool-thread/runner/compile-runner.ts"],"sourcesContent":["/**\n * Worker thread test runner logic for AssemblyScript Pool\n */\n\nimport { basename, relative } from 'node:path';\nimport type { File } from '@vitest/runner/types';\nimport type { SerializedDiffOptions } from '@vitest/utils/diff';\n\nimport type {\n  AssemblyScriptCompilerOptions,\n  AssemblyScriptConsoleLog,\n  AssemblyScriptConsoleLogHandler,\n  InstrumentationOptions,\n  ResolvedAssemblyScriptPoolOptions,\n  ThreadImports,\n  WASMCompilation,\n  WorkerRPC,\n} from '../../types/types.js';\nimport {\n  ASSEMBLYSCRIPT_LIB_PREFIX,\n  POOL_ERROR_NAMES,\n  POOL_INTERNAL_PATHS,\n} from '../../types/constants.js';\nimport { executeWASMDiscovery } from '../../wasm-executor/index.js';\nimport { debug } from '../../util/debug.js';\nimport {\n  reportFileQueued,\n  reportFileCollected,\n  reportUserConsoleLogs,\n  flushRpcUpdates,\n  reportFileError,\n} from '../rpc-reporter.js';\nimport { createPoolErrorFromAnyError, getTestErrorFromPoolError } from '../../util/pool-errors.js';\nimport { compileAssemblyScript } from '../../compiler/index.js';\nimport {\n  getTaskLogLabel,\n  getTaskLogPrefix,\n} from '../../util/vitest-tasks.js';\nimport {\n  failFile,\n  getFullTaskHierarchy,\n  prepareFileTaskForCollection,\n} from '../../util/vitest-file-tasks.js';\n\nlet threadCompilationCount: number = 0;\n\nexport async function runCompileAndDiscover(\n  file: File,\n  logModule: string,\n  rpc: WorkerRPC,\n  poolOptions: ResolvedAssemblyScriptPoolOptions,\n  projectRoot: string,\n  collectCoverage: boolean,\n  relativeUserCoverageExclusions: string[],\n  threadImports: ThreadImports,\n  diffOptions?: SerializedDiffOptions,\n  testNamePattern?: RegExp,\n  allowOnly?: boolean,\n): Promise<WASMCompilation | undefined> {\n  const base = basename(file.filepath);\n  const fileLogPrefix = getTaskLogPrefix(logModule, base, file);\n  const fileLogLabel = getTaskLogLabel(base, file);\n\n  debug(`${fileLogPrefix} - Beginning runCompileAndDiscover for \"${file.filepath}\" at ${Date.now()}`);\n\n  const runStart = performance.now();\n  let compilation: WASMCompilation | undefined;\n\n  try {\n    await reportFileQueued(rpc, file, logModule, fileLogLabel);\n\n    // TODO - move to options helpers\n    const relativeTestFilePath = relative(projectRoot, file.filepath);\n    const instrumentationOptions: InstrumentationOptions = {\n      relativeExcludedFiles: [\n        relativeTestFilePath,\n        ...POOL_INTERNAL_PATHS,\n        ...relativeUserCoverageExclusions,\n      ],\n      excludedLibraryFilePrefix: ASSEMBLYSCRIPT_LIB_PREFIX,\n      coverageMemoryPagesMin: poolOptions.coverageMemoryPagesInitial,\n      coverageMemoryPagesMax: poolOptions.coverageMemoryPagesMax,\n    };\n    const compilerOptions: AssemblyScriptCompilerOptions = {\n      stripInline: poolOptions.stripInline,\n      projectRoot: projectRoot,\n      shouldInstrument: collectCoverage,\n      instrumentationOptions,\n      extraFlags: poolOptions.extraCompilerFlags\n    };\n\n    const { binary, sourceMap, debugInfo, compileTiming } = await compileAssemblyScript(\n      file.filepath,\n      compilerOptions,\n      logModule,\n      fileLogLabel\n    );\n    file.setupDuration = compileTiming;\n    threadCompilationCount++;\n\n    debug(`${fileLogPrefix} - TIMING compileAssemblyScript total `\n      + `(thread comp # ${threadCompilationCount}): ${compileTiming.toFixed(2)} ms`\n    );\n    \n    const logMessages: AssemblyScriptConsoleLog[] = [];\n    const handleLog: AssemblyScriptConsoleLogHandler = (msg: string, isError: boolean = false): void => {\n      logMessages.push({ msg, time: Date.now(), isError });\n    };\n    \n    const discoverStart = performance.now();\n\n    await executeWASMDiscovery(\n      binary,\n      sourceMap,\n      base,\n      poolOptions,\n      collectCoverage,\n      handleLog,\n      file,\n      logModule,\n      threadImports,\n      diffOptions\n    );\n\n    // set skips when using only and/or user test name pattern, skip file task if all tests skipped\n    prepareFileTaskForCollection(file, testNamePattern, allowOnly);\n\n    file.collectDuration = performance.now() - discoverStart;\n    debug(`${fileLogPrefix} - TIMING Discovery Phase: ${file.collectDuration.toFixed(2)} ms`);\n\n    // vitest collect - report discovery results\n    await Promise.all([\n      // Report user console logs\n      reportUserConsoleLogs(rpc, logMessages, logModule, base, file),\n\n      // Report onCollected with collected and filtered tasks\n      reportFileCollected(rpc, file, logModule, fileLogLabel),\n    ]);\n\n    debug(() => `${fileLogPrefix} - Collected Test Suite Hierarchy:\\n${getFullTaskHierarchy(file)}`);\n\n    const totalTime = performance.now() - runStart;\n    debug(`${fileLogPrefix} - TIMING Compilation and Discovery: ${totalTime.toFixed(2)} ms`);\n\n    compilation = {\n      filePath: file.filepath,\n      binary,\n      sourceMap,\n      debugInfo,\n    };\n  } catch (error) {\n    const poolError = createPoolErrorFromAnyError(\n      `${fileLogLabel} - runCompileAndDiscover failure in worker`,\n      POOL_ERROR_NAMES.WASMExecutionHarnessError,\n      error\n    );\n    const testError = getTestErrorFromPoolError(poolError);\n\n    failFile(file, testError, runStart);\n\n    await reportFileQueued(rpc, file, logModule, fileLogLabel);\n    await reportFileError(rpc, file, logModule, fileLogLabel);\n\n    debug(`${fileLogPrefix} - Reported file error`);\n  } finally {\n    await flushRpcUpdates(rpc);\n    debug(`${fileLogPrefix} - runCompileAndDiscover Completed`);\n  }\n\n  return compilation;\n}\n"],"mappings":";;;;;;;;;;;;AA4CA,IAAI,yBAAiC;AAErC,eAAsB,sBACpB,MACA,WACA,KACA,aACA,aACA,iBACA,gCACA,eACA,aACA,iBACA,WACsC;CACtC,MAAM,OAAO,SAAS,KAAK,SAAS;CACpC,MAAM,gBAAgB,iBAAiB,WAAW,MAAM,KAAK;CAC7D,MAAM,eAAe,gBAAgB,MAAM,KAAK;AAEhD,OAAM,GAAG,cAAc,0CAA0C,KAAK,SAAS,OAAO,KAAK,KAAK,GAAG;CAEnG,MAAM,WAAW,YAAY,KAAK;CAClC,IAAI;AAEJ,KAAI;AACF,QAAM,iBAAiB,KAAK,MAAM,WAAW,aAAa;EAI1D,MAAM,yBAAiD;GACrD,uBAAuB;IAFI,SAAS,aAAa,KAAK,SAAS;IAI7D,GAAG;IACH,GAAG;IACJ;GACD;GACA,wBAAwB,YAAY;GACpC,wBAAwB,YAAY;GACrC;EACD,MAAM,kBAAiD;GACrD,aAAa,YAAY;GACZ;GACb,kBAAkB;GAClB;GACA,YAAY,YAAY;GACzB;EAED,MAAM,EAAE,QAAQ,WAAW,WAAW,kBAAkB,MAAM,sBAC5D,KAAK,UACL,iBACA,WACA,aACD;AACD,OAAK,gBAAgB;AACrB;AAEA,QAAM,GAAG,cAAc,uDACD,uBAAuB,KAAK,cAAc,QAAQ,EAAE,CAAC,KAC1E;EAED,MAAM,cAA0C,EAAE;EAClD,MAAM,aAA8C,KAAa,UAAmB,UAAgB;AAClG,eAAY,KAAK;IAAE;IAAK,MAAM,KAAK,KAAK;IAAE;IAAS,CAAC;;EAGtD,MAAM,gBAAgB,YAAY,KAAK;AAEvC,QAAM,qBACJ,QACA,WACA,MACA,aACA,iBACA,WACA,MACA,WACA,eACA,YACD;AAGD,+BAA6B,MAAM,iBAAiB,UAAU;AAE9D,OAAK,kBAAkB,YAAY,KAAK,GAAG;AAC3C,QAAM,GAAG,cAAc,6BAA6B,KAAK,gBAAgB,QAAQ,EAAE,CAAC,KAAK;AAGzF,QAAM,QAAQ,IAAI,CAEhB,sBAAsB,KAAK,aAAa,WAAW,MAAM,KAAK,EAG9D,oBAAoB,KAAK,MAAM,WAAW,aAAa,CACxD,CAAC;AAEF,cAAY,GAAG,cAAc,sCAAsC,qBAAqB,KAAK,GAAG;AAGhG,QAAM,GAAG,cAAc,wCADL,YAAY,KAAK,GAAG,UACkC,QAAQ,EAAE,CAAC,KAAK;AAExF,gBAAc;GACZ,UAAU,KAAK;GACf;GACA;GACA;GACD;UACM,OAAO;AAQd,WAAS,MAFS,0BALA,4BAChB,GAAG,aAAa,6CAChB,iBAAiB,2BACjB,MACD,CACqD,EAE5B,SAAS;AAEnC,QAAM,iBAAiB,KAAK,MAAM,WAAW,aAAa;AAC1D,QAAM,gBAAgB,KAAK,MAAM,WAAW,aAAa;AAEzD,QAAM,GAAG,cAAc,wBAAwB;WACvC;AACR,QAAM,gBAAgB,IAAI;AAC1B,QAAM,GAAG,cAAc,oCAAoC;;AAG7D,QAAO"}

package/dist/config/index.mjs

@@ -3,6 +3,6 @@ import "../debug-IeEHsxy0.mjs";
 import "../vitest-file-tasks-BUwzh375.mjs";
 import "../vitest-tasks-BKS7689f.mjs";
 import "../worker-rpc-channel-lbhK7Qz8.mjs";
-import { createAssemblyScriptPool } from "../pool-runner-init-d5qScS41.mjs";
+import { createAssemblyScriptPool } from "../pool-runner-init-Kuzz61rB.mjs";
 
 export { createAssemblyScriptPool };

package/dist/coverage-provider/index.mjs

@@ -6,7 +6,7 @@ import { ASTVisitor } from "../ast-visitor-DC3SuTzs.mjs";
 import { basename, parse, relative } from "node:path";
 import { readFile } from "node:fs/promises";
 import v8CoverageModule from "@vitest/coverage-v8";
-import { createCoverageMap } from "istanbul-lib-coverage";
+import istanbulCoverage from "istanbul-lib-coverage";
 import { Parser } from "assemblyscript";
 import { resolve as resolve$1 } from "path";
 import TestExclude from "test-exclude";
@@ -355,6 +355,7 @@ function globFiles(include, exclude, projectRoot) {
 * - Delegates JS coverage to Vitest's v8 provider
 * - Merges both into a unified coverage report
 */
+const { createCoverageMap } = istanbulCoverage;
 var HybridCoverageProvider = class {
 	name = "hybrid-assemblyscript-v8";
 	v8Provider;