vitest-pool-assemblyscript 0.3.1 → 0.5.0

package/dist/{compiler-BaNECXMW.mjs → compiler-CscxCJw3.mjs}

@@ -1,8 +1,9 @@
-import { POOL_ERROR_NAMES } from "./constants-DX9yo-el.mjs";
-import { createPoolError, debug, throwPoolErrorIfAborted } from "./debug-Cf2jt1kg.mjs";
+import { INTERNAL_PATH_LIB_PREFIX, POOL_ERROR_NAMES } from "./constants-DuBLuMjt.mjs";
+import { createPoolError, debug, throwPoolErrorIfAborted } from "./debug-Cm1VFmaz.mjs";
+import { getShortFunctionName } from "./wasm-names-CydfYzQK.mjs";
 import { createRequire } from "node:module";
 import { basename, dirname, resolve } from "node:path";
-import { access } from "node:fs/promises";
+import { access, readFile } from "node:fs/promises";
 import { main } from "assemblyscript/asc";
 import { fileURLToPath } from "node:url";
 
@@ -17,7 +18,6 @@ import { fileURLToPath } from "node:url";
 * wrapper transforms into the final BinaryDebugInfo format (1-based columns,
 * absolute paths, grouped by file and position).
 */
-const DEBUG_NATIVE_ADDON = false;
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const rootFromDist = resolve(__dirname, "..");
 const rootFromSrc = resolve(__dirname, "../..");
@@ -33,12 +33,21 @@ try {
 	}
 }
 /**
-* Convert a raw location (0-indexed columns, path indexes) to 
-* processed location (1-indexed columns, path strings)
+* Convert a raw location (0-indexed columns, path indexes) to
+* processed location (1-indexed columns, absolute path strings)
+*
+* Source map paths vary by import style and project structure:
+* - Relative imports: "assembly/compare.ts"
+* - Bare package imports: "~lib/vitest-pool-assemblyscript/assembly/compare.ts"
+* - Source outside project root: "../assembly/compare.ts" (e.g. test-external importing parent sources)
+*
+* All are normalized to absolute filesystem paths for consistent coverage key matching.
 */
-function convertLocation(rawLocation, debugSourceFiles) {
-	const filePath = debugSourceFiles[rawLocation.fileIndex];
+function convertLocation(rawLocation, debugSourceFiles, projectRoot) {
+	let filePath = debugSourceFiles[rawLocation.fileIndex];
 	if (!filePath) throw createPoolError(`No debug source file with index: ${rawLocation.fileIndex}}`, POOL_ERROR_NAMES.WASMInstrumentationError);
+	if (filePath.startsWith(INTERNAL_PATH_LIB_PREFIX)) filePath = resolve(projectRoot, "assembly", filePath.slice(INTERNAL_PATH_LIB_PREFIX.length));
+	else filePath = resolve(projectRoot, filePath);
 	return {
 		filePath,
 		line: rawLocation.line,
@@ -48,14 +57,14 @@ function convertLocation(rawLocation, debugSourceFiles) {
 /**
 * Convert a raw expression to processed format
 */
-function convertExpression(rawExpr, debugSourceFiles) {
+function convertExpression(rawExpr, debugSourceFiles, projectRoot) {
 	const converted = {
 		type: rawExpr.type,
 		isBranch: rawExpr.isBranch
 	};
 	if (rawExpr.branchPaths !== void 0) converted.branchPaths = rawExpr.branchPaths;
 	if (rawExpr.location) {
-		const convertedLocation = convertLocation(rawExpr.location, debugSourceFiles);
+		const convertedLocation = convertLocation(rawExpr.location, debugSourceFiles, projectRoot);
 		if (convertedLocation) converted.location = convertedLocation;
 	}
 	return converted;
@@ -71,10 +80,10 @@ function getPositionKey(location) {
 * Convert a raw function to processed format and compute position key
 * Returns undefined if function has no valid representative location
 */
-function convertFunction(rawFunc, debugSourceFiles) {
-	const representativeLocation = convertLocation(rawFunc.representativeLocation, debugSourceFiles);
+function convertFunction(rawFunc, debugSourceFiles, projectRoot) {
+	const representativeLocation = convertLocation(rawFunc.representativeLocation, debugSourceFiles, projectRoot);
 	const expressions = [];
-	if (rawFunc.expressions) for (const expr of rawFunc.expressions) expressions.push(convertExpression(expr, debugSourceFiles));
+	if (rawFunc.expressions) for (const expr of rawFunc.expressions) expressions.push(convertExpression(expr, debugSourceFiles, projectRoot));
 	return {
 		func: {
 			wasmIndex: rawFunc.wasmIndex,
@@ -89,32 +98,58 @@ function convertFunction(rawFunc, debugSourceFiles) {
 	};
 }
 /**
+* Check if two WASM function names are monomorphizations of the same generic function.
+* Generic monomorphizations share the same base name and suffix, differing only in
+* the type parameters inside angle brackets.
+*
+* e.g. "assembly/compare/closeTo<bool\2cbool>" and "assembly/compare/closeTo<bool\2cu8>"
+* e.g. "assembly/expect/BaseExpectMatcher<bool>#constructor" and "assembly/expect/BaseExpectMatcher<i8>#constructor"
+*/
+function isGenericMonomorphizationMatch(nameA, nameB) {
+	const openA = nameA.indexOf("<");
+	const openB = nameB.indexOf("<");
+	if (openA === -1 || openB === -1) return false;
+	const lastCloseA = nameA.lastIndexOf(">");
+	const lastCloseB = nameB.lastIndexOf(">");
+	if (lastCloseA === -1 || lastCloseB === -1) return false;
+	if (nameA.substring(0, openA) !== nameB.substring(0, openB)) return false;
+	if (nameA.substring(lastCloseA + 1) !== nameB.substring(lastCloseB + 1)) return false;
+	return true;
+}
+/**
 * Transform raw native addon output to processed BinaryDebugInfo
 */
-function transformDebugInfo(raw, logPrefix) {
+function transformDebugInfo(raw, logPrefix, projectRoot) {
 	const functionsByFileAndPosition = {};
 	debug(`${logPrefix} - Converting ${raw.functions.length} functions`);
-	let positionCollisionCount = 0;
+	let genericCollisionCount = 0;
 	let skippedCount = 0;
 	let instrumentedFunctionCount = 0;
 	for (const rawFunc of raw.functions) {
-		const result = convertFunction(rawFunc, raw.debugSourceFiles);
+		const result = convertFunction(rawFunc, raw.debugSourceFiles, projectRoot);
 		if (!result) {
 			debug(`${logPrefix} - WARNING: Skipped function (bad conversion): "${rawFunc.name}"`);
 			skippedCount++;
 			continue;
 		}
 		const { func, filePath, positionKey } = result;
-		if (functionsByFileAndPosition[filePath]?.[positionKey]) {
-			const existing = functionsByFileAndPosition[filePath][positionKey];
-			positionCollisionCount++;
-			throw createPoolError(`ERROR - Function Debug Position Collision at ${filePath}:${positionKey}: "${existing.name}" will be replaced by "${func.name}"`, POOL_ERROR_NAMES.WASMInstrumentationError);
+		const existingAtPosition = functionsByFileAndPosition[filePath]?.[positionKey];
+		if (existingAtPosition) {
+			const existingName = existingAtPosition[0].name;
+			if (isGenericMonomorphizationMatch(existingName, func.name)) {
+				existingAtPosition.push(func);
+				genericCollisionCount++;
+				instrumentedFunctionCount++;
+				debug(`${logPrefix} - Generic monomorphization at ${filePath}:${positionKey}: "${getShortFunctionName(func.name)}" grouped with "${getShortFunctionName(existingName)}"`);
+				continue;
+			}
+			throw createPoolError(`ERROR - Function Debug Position Collision at ${filePath}:${positionKey}: "${getShortFunctionName(existingName)}" will be replaced by "${getShortFunctionName(func.name)}". This is a bug. Please report it at: https://github.com/themattspiral/vitest-pool-assemblyscript/issues/new`, POOL_ERROR_NAMES.WASMInstrumentationError);
 		}
 		instrumentedFunctionCount++;
 		if (!functionsByFileAndPosition[filePath]) functionsByFileAndPosition[filePath] = {};
-		functionsByFileAndPosition[filePath][positionKey] = func;
+		functionsByFileAndPosition[filePath][positionKey] = [func];
 	}
-	debug(`${logPrefix} - BinaryDebugInfo transform complete: ${instrumentedFunctionCount} instrumented functions (${positionCollisionCount} position collisions, ${skippedCount} skipped)`);
+	debug(`${logPrefix} - BinaryDebugInfo transform complete: ${instrumentedFunctionCount} instrumented functions (${genericCollisionCount} generic collisions, ${skippedCount} skipped)`);
 	return {
 		debugSourceFiles: raw.debugSourceFiles,
 		functionsByFileAndPosition,
@@ -149,14 +184,15 @@ function instrumentForCoverage(wasmBuffer, sourceMapBuffer, instrumentationOptio
 		coverageMemoryPagesMax: instrumentationOptions.coverageMemoryPagesMax,
 		excludedFiles: instrumentationOptions.relativeExcludedFiles,
 		excludedLibraryFilePrefix: instrumentationOptions.excludedLibraryFilePrefix,
-		debug: DEBUG_NATIVE_ADDON,
+		excludedLibraryFileOverridePrefix: instrumentationOptions.excludedLibraryFileOverridePrefix,
+		debug: instrumentationOptions.debug,
 		logPrefix: nativeLogPrefix
 	};
 	const nativeResult = addon.instrumentForCoverage(wasmBuffer, sourceMapBuffer, options);
 	const addonTime = performance.now();
 	debug(`${interfaceLogPrefix} - TIMING Native addon: ${(addonTime - startTime).toFixed(2)} ms`);
 	if (nativeResult.errors?.length) throw createPoolError(`Errors encountered duriing native instrumentation: ${nativeResult.errors.join("\n")}`, POOL_ERROR_NAMES.WASMInstrumentationError);
-	const debugInfo = transformDebugInfo(nativeResult.debugInfo, interfaceLogPrefix);
+	const debugInfo = transformDebugInfo(nativeResult.debugInfo, interfaceLogPrefix, instrumentationOptions.projectRoot);
 	debug(`${interfaceLogPrefix} - TIMING DebugInfo Transform: ${(performance.now() - addonTime).toFixed(2)} ms`);
 	debug(`${interfaceLogPrefix} - Binary size: ${nativeResult.instrumentedWasm.length} bytes | Source map size: ${nativeResult.sourceMap.length * 2} bytes`);
 	return {
@@ -174,6 +210,7 @@ function instrumentForCoverage(wasmBuffer, sourceMapBuffer, instrumentationOptio
 * Handles compilation of AssemblyScript source code to WASM binaries.
 * Manages compiler options, transforms, and in-memory compilation.
 */
+const POOL_ASSEMBLY_NODE_MODULES_PREFIX = "node_modules/vitest-pool-assemblyscript/assembly/";
 const STRIP_INLINE_TRANSFORM = resolve(import.meta.dirname, "./compiler/transforms/strip-inline.mjs");
 setImmediate(async () => {
 	try {
@@ -184,19 +221,6 @@ setImmediate(async () => {
 });
 /**
 * Compile AssemblyScript source code to WASM binary
-*
-* Features:
-* - In-memory compilation (binary captured via writeFile callback)
-* - Filesystem reading enabled (for import resolution)
-* - Uses stub runtime and imported memory pattern
-* - Exports _start function for explicit initialization control
-* - Always returns clean binary
-* - Conditionally returns instrumented binary when coverage enabled
-*
-* @param filename - Full path to the source file (used as entry point)
-* @param options - Compilation options (coverage mode, etc.)
-* @returns Compilation result with clean binary and optional instrumented binary
-* @throws Error if compilation fails
 */
 async function compileAssemblyScript(filename, options, logModule, logLabel, signal) {
 	throwPoolErrorIfAborted(signal);
@@ -254,6 +278,22 @@ async function compileAssemblyScript(filename, options, logModule, logLabel, sig
 				debug(`${logPrefix} - Captured source map in memory: "${name}"`);
 				sourceMap = contents;
 			} else debug(`${logPrefix} - WARNING - Captured Unexpected File: "${name}" at baseDir: "${_baseDir}"`);
+		},
+		readFile: async (filename, baseDir) => {
+			const filePath = resolve(baseDir, filename);
+			try {
+				return await readFile(filePath, { encoding: "utf-8" });
+			} catch {
+				if (filename.startsWith(POOL_ASSEMBLY_NODE_MODULES_PREFIX)) {
+					const localPath = resolve(baseDir, "assembly", filename.substring(49));
+					try {
+						return await readFile(localPath, { encoding: "utf-8" });
+					} catch {
+						return null;
+					}
+				}
+				return null;
+			}
 		}
 	});
 	debug(`${logPrefix} - TIMING asc.main: ${(performance.now() - ascStart).toFixed(2)} ms`);
@@ -292,4 +332,4 @@ async function compileAssemblyScript(filename, options, logModule, logLabel, sig
 
 //#endregion
 export { compileAssemblyScript };
-//# sourceMappingURL=compiler-BaNECXMW.mjs.map
+//# sourceMappingURL=compiler-CscxCJw3.mjs.map

package/dist/compiler-CscxCJw3.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler-CscxCJw3.mjs","names":["ascMain"],"sources":["../src/native-instrumentation/addon-interface.ts","../src/compiler/index.ts"],"sourcesContent":["/**\n * Native addon interface for extracting debug information from WebAssembly binaries\n *\n * This module wraps Binaryen's C++ API to provide expression-level debug locations\n * and basic block information that the JavaScript API doesn't expose.\n *\n * The native addon outputs raw data (0-based columns, relative paths) which this\n * wrapper transforms into the final BinaryDebugInfo format (1-based columns,\n * absolute paths, grouped by file and position).\n */\n\nimport { createRequire } from 'node:module';\nimport { resolve, dirname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { debug } from '../util/debug.js';\nimport {\n  NativeAddon,\n  NativeInstrumentationResult,\n  NativeDebugInfoOutput,\n  NativeFunctionDebugInfo,\n  NativeExpressionDebugInfo,\n  NativeSourceLocation,\n  BinaryDebugInfo,\n  FunctionDebugInfo,\n  SourceLocation,\n  ExpressionDebugInfo,\n  InstrumentationResult,\n  NativeInstrumentationOptions,\n  InstrumentationOptions,\n} from '../types/types.js';\nimport { POOL_ERROR_NAMES, INTERNAL_PATH_LIB_PREFIX } from '../types/constants.js';\nimport { createPoolError } from '../util/pool-errors.js';\nimport { getShortFunctionName } from '../wasm-executor/wasm-names.js';\n\n// Load the native addon via node-gyp-build\n// node-gyp-build checks: prebuilds/ first, then build/Release/\n// It searches from the given directory for a package.json to find the package root.\n// We run from dist/ (published) or src/ (dev/tests), so we try both root paths.\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\nconst rootFromDist = resolve(__dirname, '..');\nconst rootFromSrc = resolve(__dirname, '../..');\n\nconst require = createRequire(import.meta.url);\nconst nodeGypBuild: (dir: string) => NativeAddon = require('node-gyp-build');\n\nlet addon: NativeAddon;\ntry {\n  addon = nodeGypBuild(rootFromDist);\n} catch {\n  try {\n    addon = nodeGypBuild(rootFromSrc);\n  } catch (err) {\n    throw createPoolError(\n      `Native addon not found. Searched from ${rootFromDist} and ${rootFromSrc}. ` +\n      `Ensure prebuilds are available or run 'npm run build:native' to compile from source. ` +\n      `Original error: ${err instanceof Error ? err.message : String(err)}`,\n      POOL_ERROR_NAMES.WASMInstrumentationError\n    );\n  }\n}\n\n/**\n * Convert a raw location (0-indexed columns, path indexes) to\n * processed location (1-indexed columns, absolute path strings)\n *\n * Source map paths vary by import style and project structure:\n * - Relative imports: \"assembly/compare.ts\"\n * - Bare package imports: \"~lib/vitest-pool-assemblyscript/assembly/compare.ts\"\n * - Source outside project root: \"../assembly/compare.ts\" (e.g. test-external importing parent sources)\n *\n * All are normalized to absolute filesystem paths for consistent coverage key matching.\n */\nfunction convertLocation(\n  rawLocation: NativeSourceLocation,\n  debugSourceFiles: string[],\n  projectRoot: string\n): SourceLocation {\n  let filePath = debugSourceFiles[rawLocation.fileIndex];\n\n  if (!filePath) {\n    throw createPoolError(\n      `No debug source file with index: ${rawLocation.fileIndex}}`,\n      POOL_ERROR_NAMES.WASMInstrumentationError\n    );\n  }\n\n  // Normalize to absolute path for consistent coverage key matching\n  if (filePath.startsWith(INTERNAL_PATH_LIB_PREFIX)) {\n    // ~lib/vitest-pool-assemblyscript/assembly/X.ts -> projectRoot/assembly/X.ts\n    const relativePart = filePath.slice(INTERNAL_PATH_LIB_PREFIX.length);\n    filePath = resolve(projectRoot, 'assembly', relativePart);\n  } else {\n    // Resolve relative path (handles both 'assembly/X.ts' and '../assembly/X.ts')\n    filePath = resolve(projectRoot, filePath);\n  }\n\n  return {\n    filePath,\n    line: rawLocation.line,\n    column: rawLocation.column + 1,  // convert from 0-indexed to 1-indexed\n  };\n}\n\n/**\n * Convert a raw expression to processed format\n */\nfunction convertExpression(\n  rawExpr: NativeExpressionDebugInfo,\n  debugSourceFiles: string[],\n  projectRoot: string\n): ExpressionDebugInfo {\n  const converted: ExpressionDebugInfo = {\n    type: rawExpr.type,\n    isBranch: rawExpr.isBranch,\n  };\n\n  if (rawExpr.branchPaths !== undefined) {\n    converted.branchPaths = rawExpr.branchPaths;\n  }\n\n  if (rawExpr.location) {\n    const convertedLocation = convertLocation(rawExpr.location, debugSourceFiles, projectRoot);\n    if (convertedLocation) {\n      converted.location = convertedLocation;\n    }\n  }\n\n  return converted;\n}\n\n/**\n * Generate a position key to identify the SourceLocation uniquely\n * within a file. Does NOT include the file identifier.\n */\nfunction getPositionKey(location: SourceLocation) {\n  return `${location.line}:${location.column}`;\n}\n\n/**\n * Convert a raw function to processed format and compute position key\n * Returns undefined if function has no valid representative location\n */\nfunction convertFunction(\n  rawFunc: NativeFunctionDebugInfo,\n  debugSourceFiles: string[],\n  projectRoot: string\n): { func: FunctionDebugInfo; filePath: string; positionKey: string } | undefined {\n  const representativeLocation = convertLocation(rawFunc.representativeLocation, debugSourceFiles, projectRoot);\n\n  // Convert expressions\n  const expressions: ExpressionDebugInfo[] = [];\n  if (rawFunc.expressions) {\n    for (const expr of rawFunc.expressions) {\n      expressions.push(convertExpression(expr, debugSourceFiles, projectRoot));\n    }\n  }\n\n  const converted: FunctionDebugInfo = {\n    wasmIndex: rawFunc.wasmIndex,\n    name: rawFunc.name,\n    representativeLocation,\n    coverageMemoryIndex: rawFunc.coverageMemoryIndex,\n    expressions,\n    basicBlocks: rawFunc.basicBlocks,\n  };\n\n  const filePath = representativeLocation.filePath;\n  const positionKey = getPositionKey(representativeLocation);\n\n  return { func: converted, filePath, positionKey };\n}\n\n/**\n * Check if two WASM function names are monomorphizations of the same generic function.\n * Generic monomorphizations share the same base name and suffix, differing only in\n * the type parameters inside angle brackets.\n *\n * e.g. \"assembly/compare/closeTo<bool\\2cbool>\" and \"assembly/compare/closeTo<bool\\2cu8>\"\n * e.g. \"assembly/expect/BaseExpectMatcher<bool>#constructor\" and \"assembly/expect/BaseExpectMatcher<i8>#constructor\"\n */\nfunction isGenericMonomorphizationMatch(nameA: string, nameB: string): boolean {\n  const openA = nameA.indexOf('<');\n  const openB = nameB.indexOf('<');\n\n  // Both must contain generic type parameters\n  if (openA === -1 || openB === -1) return false;\n\n  const lastCloseA = nameA.lastIndexOf('>');\n  const lastCloseB = nameB.lastIndexOf('>');\n\n  if (lastCloseA === -1 || lastCloseB === -1) return false;\n\n  // Prefix before '<' must match (includes module path, class, function name)\n  const prefixA = nameA.substring(0, openA);\n  const prefixB = nameB.substring(0, openB);\n  if (prefixA !== prefixB) return false;\n\n  // Suffix after last '>' must match (e.g. \"#constructor\", or empty)\n  const suffixA = nameA.substring(lastCloseA + 1);\n  const suffixB = nameB.substring(lastCloseB + 1);\n  if (suffixA !== suffixB) return false;\n\n  return true;\n}\n\n/**\n * Transform raw native addon output to processed BinaryDebugInfo\n */\nfunction transformDebugInfo(\n  raw: NativeDebugInfoOutput,\n  logPrefix: string,\n  projectRoot: string,\n): BinaryDebugInfo {\n  const functionsByFileAndPosition: Record<string, Record<string, FunctionDebugInfo[]>> = {};\n\n  debug(`${logPrefix} - Converting ${raw.functions.length} functions`);\n\n  let genericCollisionCount = 0;\n  let skippedCount = 0;\n  let instrumentedFunctionCount = 0;\n\n  for (const rawFunc of raw.functions) {\n    const result = convertFunction(rawFunc, raw.debugSourceFiles, projectRoot);\n    if (!result) {\n      debug(`${logPrefix} - WARNING: Skipped function (bad conversion): \"${rawFunc.name}\"`);\n      skippedCount++;\n      continue;\n    }\n\n    const { func, filePath, positionKey } = result;\n\n    // Check for position collisions\n    const existingAtPosition = functionsByFileAndPosition[filePath]?.[positionKey];\n    if (existingAtPosition) {\n      const existingName = existingAtPosition[0]!.name;\n\n      // Only allow collision if both are monomorphizations of the same generic\n      if (isGenericMonomorphizationMatch(existingName, func.name)) {\n        existingAtPosition.push(func);\n        genericCollisionCount++;\n        instrumentedFunctionCount++;\n        debug(\n          `${logPrefix} - Generic monomorphization at ${filePath}:${positionKey}:`\n          + ` \"${getShortFunctionName(func.name)}\" grouped with \"${getShortFunctionName(existingName)}\"`\n        );\n        continue;\n      }\n\n      throw createPoolError(\n        `ERROR - Function Debug Position Collision at ${filePath}:${positionKey}: \"${getShortFunctionName(existingName)}\"`\n        + ` will be replaced by \"${getShortFunctionName(func.name)}\". This is a bug. Please report it at:`\n        + ` https://github.com/themattspiral/vitest-pool-assemblyscript/issues/new`,\n        POOL_ERROR_NAMES.WASMInstrumentationError\n      );\n    }\n\n    instrumentedFunctionCount++;\n\n    // Group by file and position\n    if (!functionsByFileAndPosition[filePath]) {\n      functionsByFileAndPosition[filePath] = {};\n    }\n\n    functionsByFileAndPosition[filePath][positionKey] = [func];\n  }\n\n  debug(\n    `${logPrefix} - BinaryDebugInfo transform complete: ${instrumentedFunctionCount} instrumented functions`\n    + ` (${genericCollisionCount} generic collisions, ${skippedCount} skipped)`\n  );\n\n  return {\n    debugSourceFiles: raw.debugSourceFiles,\n    functionsByFileAndPosition,\n    instrumentedFunctionCount,\n  };\n}\n\n/**\n * Instrument a WASM binary for coverage collection and regenerate source map\n *\n * This function:\n * 1. Adds __coverage_memory import (multi-memory for coverage counters)\n * 2. Injects coverage counter increments at each function entry\n * 3. Regenerates source map with correct offsets after instrumentation\n * 4. Extracts debug info with coverageMemoryIndex assigned\n *\n * @param wasmBuffer - Buffer containing the clean WASM binary\n * @param sourceMapBuffer - Buffer containing the source map JSON\n * @returns Instrumented binary, regenerated source map, and debug info\n *\n * @throws {TypeError} If wasmBuffer or sourceMapBuffer are not Buffers\n * @throws {Error} If WASM binary or source map is invalid\n */\nexport function instrumentForCoverage(\n  wasmBuffer: Buffer,\n  sourceMapBuffer: Buffer,\n  instrumentationOptions: InstrumentationOptions,\n  logModule: string,\n  logLabel: string,\n): InstrumentationResult {\n  if (!Buffer.isBuffer(wasmBuffer)) {\n    throw createPoolError(\n      'instrumentForCoverage - wasmBuffer must be a Buffer',\n      POOL_ERROR_NAMES.WASMInstrumentationError\n    );\n  }\n  if (!Buffer.isBuffer(sourceMapBuffer)) {\n    throw createPoolError(\n      'instrumentForCoverage - sourceMapBuffer must be a Buffer',\n      POOL_ERROR_NAMES.WASMInstrumentationError\n    );\n  }\n\n  const interfaceLogPrefix = `[${logModule} Inst] ${logLabel}`;\n  const nativeLogPrefix = `[${logModule} InstNative] ${logLabel}`;\n\n  debug(`${interfaceLogPrefix} - Calling native instrumentForCoverage`);\n  const startTime = performance.now();\n\n  const options: NativeInstrumentationOptions = {\n    coverageMemoryPagesMin: instrumentationOptions.coverageMemoryPagesMin,\n    coverageMemoryPagesMax: instrumentationOptions.coverageMemoryPagesMax,\n    excludedFiles: instrumentationOptions.relativeExcludedFiles,\n    excludedLibraryFilePrefix: instrumentationOptions.excludedLibraryFilePrefix,\n    excludedLibraryFileOverridePrefix: instrumentationOptions.excludedLibraryFileOverridePrefix,\n    debug: instrumentationOptions.debug,\n    logPrefix: nativeLogPrefix\n  };\n  const nativeResult: NativeInstrumentationResult = addon.instrumentForCoverage(wasmBuffer, sourceMapBuffer, options);\n  const addonTime = performance.now();\n  debug(`${interfaceLogPrefix} - TIMING Native addon: ${(addonTime - startTime).toFixed(2)} ms`);\n\n  if (nativeResult.errors?.length) {\n    throw createPoolError(\n      `Errors encountered duriing native instrumentation: ${nativeResult.errors.join('\\n')}`,\n      POOL_ERROR_NAMES.WASMInstrumentationError,\n    );\n  }\n\n  const debugInfo = transformDebugInfo(nativeResult.debugInfo, interfaceLogPrefix, instrumentationOptions.projectRoot);\n  \n  const transformTime = performance.now();\n  debug(`${interfaceLogPrefix} - TIMING DebugInfo Transform: ${(transformTime - addonTime).toFixed(2)} ms`);\n  debug(`${interfaceLogPrefix} - Binary size: ${nativeResult.instrumentedWasm.length} bytes | Source map size: ${nativeResult.sourceMap.length * 2} bytes`);\n\n  return {\n    instrumentedWasm: nativeResult.instrumentedWasm,\n    sourceMap: nativeResult.sourceMap,\n    debugInfo,\n  };\n}\n","/**\n * AssemblyScript Compiler\n *\n * Handles compilation of AssemblyScript source code to WASM binaries.\n * Manages compiler options, transforms, and in-memory compilation.\n */\n\nimport { main as ascMain } from 'assemblyscript/asc';\nimport { basename, resolve } from 'node:path';\nimport { access, readFile, writeFile, mkdir } from 'node:fs/promises';\n\nimport { AssemblyScriptCompilerResult, AssemblyScriptCompilerOptions } from '../types/types.js';\nimport { POOL_ERROR_NAMES } from '../types/constants.js';\nimport { debug } from '../util/debug.js';\nimport { instrumentForCoverage } from '../native-instrumentation/addon-interface.js';\nimport { createPoolError, throwPoolErrorIfAborted } from '../util/pool-errors.js';\n\nconst DEBUG_WRITE_FILES = false;\n\n// Path prefix the AS compiler uses when resolving bare `vitest-pool-assemblyscript/assembly` imports\n// via node_modules. Used to detect self-imports and redirect to local assembly/ dir when running in-tree.\nconst POOL_ASSEMBLY_NODE_MODULES_PREFIX = 'node_modules/vitest-pool-assemblyscript/assembly/';\n\n// path assumes that we're running from dist/\nconst STRIP_INLINE_TRANSFORM = resolve(import.meta.dirname, './compiler/transforms/strip-inline.mjs');\n\nsetImmediate(async () => {\n  try {\n    await access(STRIP_INLINE_TRANSFORM);\n  } catch {\n    throw createPoolError(\n      `AS Compiler strip inline transform file not found at \"${STRIP_INLINE_TRANSFORM}\"`,\n      POOL_ERROR_NAMES.CompilationError\n    );\n  }\n});\n\n/**\n * Compile AssemblyScript source code to WASM binary\n */\nexport async function compileAssemblyScript(\n  filename: string,\n  options: AssemblyScriptCompilerOptions,\n  logModule: string,\n  logLabel: string,\n  signal?: AbortSignal\n): Promise<AssemblyScriptCompilerResult> {\n  throwPoolErrorIfAborted(signal);\n\n  const compileStart = performance.now();\n  const logPrefix = `[${logModule} ASC] ${logLabel}`;\n\n  const { shouldInstrument, instrumentationOptions, extraFlags } = options;\n\n  if (shouldInstrument && !instrumentationOptions) {\n    throw createPoolError(\n      'Instrumentation options are required for coverage instrumentation',\n      POOL_ERROR_NAMES.CompilationError\n    );\n  }\n\n  const stdoutLines: string[] = [];\n  const stderrLines: string[] = [];\n  let binary: Uint8Array | undefined;\n  let sourceMap: string | undefined;\n\n  // Use full path as entry file so AS compiler can resolve relative imports\n  const entryFile = filename;\n  // Use simple output name to avoid AS compiler prepending it to source map paths\n  const outputFile = 'output.wasm';\n\n  debug(`${logPrefix} - Compiling: \"${filename}\"`);\n\n  // Capture stdout/stderr (for potential error reporting)\n  const stdout = {\n    write: (text: string) => {\n      stdoutLines.push(text);\n      return true;\n    }\n  };\n\n  const stderr = {\n    write: (text: string) => {\n      stderrLines.push(text);\n      return true;\n    }\n  };\n\n  // Build compiler flags\n  const compilerFlags = [\n    entryFile,\n\n    // overrideable, though not recommended\n    '--optimizeLevel', '0',           // No optimization for easier debugging\n    '--shrinkLevel', '0',             // No shrink\n    '--runtime', 'stub',              // stub runtime (no GC)\n\n    ...(extraFlags || []),\n\n    // non-overrideable\n    '--outFile', outputFile,\n    '--importMemory',                 // Import memory from JS (enables imports during WASM start)\n    '--debug',                        // Include debug info\n    '--sourceMap',                    // Generate source maps for error reporting\n    '--exportStart', '_start',        // Export start function for explicit initialization control\n    '--exportTable'                   // Export function table for direct test execution\n  ];\n\n  // Add transform to strip @inline decorators if requested\n  // This improves coverage accuracy by preventing functions from being inlined,\n  // and enables correct source-mapped error reporting for errors originating\n  // inside inlined functions.\n  if (options.stripInline === true) {\n    compilerFlags.push(\n      '--transform', STRIP_INLINE_TRANSFORM\n    );\n    debug(`${logPrefix} - Added Transform - Stripping @inline decorators`);\n  }\n\n  // Compile with AssemblyScript compiler\n  const ascStart = performance.now();\n  const result = await ascMain(compilerFlags, {\n    stdout,\n    stderr,\n    // Let AS read from filesystem for import resolution\n    // WASM binary and source map are captured in memory via writeFile callback\n    writeFile: (name: string, contents: string | Uint8Array, _baseDir: string) => {\n      throwPoolErrorIfAborted(signal);\n\n      if (name.endsWith('.wasm') && contents instanceof Uint8Array) {\n        binary = contents;\n        debug(`${logPrefix} - Captured binary in memory: \"${name}\"`);\n      } else if (name.endsWith('.wasm.map') && typeof contents === 'string') {\n        debug(`${logPrefix} - Captured source map in memory: \"${name}\"`);\n        sourceMap = contents;\n      } else {\n        debug(`${logPrefix} - WARNING - Captured Unexpected File: \"${name}\" at baseDir: \"${_baseDir}\"`);\n      }\n    },\n    \n    // Custom readFile enables in-tree resolution of bare pool assembly imports.\n    // When a test file imports 'vitest-pool-assemblyscript/assembly', the AS compiler\n    // resolves it to a node_modules path. This works when the package is installed,\n    // but fails in-tree (the package isn't in its own node_modules). The fallback\n    // redirects these to the local assembly/ directory when the normal path isn't found.\n    readFile: async (filename, baseDir): Promise<string | null> => {\n      const filePath = resolve(baseDir, filename);\n\n      try {\n        return await readFile(filePath, { encoding: 'utf-8' });\n      } catch {\n        // Fallback: when running in-tree, redirect pool assembly imports to local assembly/ dir\n        if (filename.startsWith(POOL_ASSEMBLY_NODE_MODULES_PREFIX)) {\n          const localSubpath = filename.substring(POOL_ASSEMBLY_NODE_MODULES_PREFIX.length);\n          const localPath = resolve(baseDir, 'assembly', localSubpath);\n\n          try {\n            return await readFile(localPath, { encoding: 'utf-8' });\n          } catch {\n            return null;\n          }\n        }\n\n        return null;\n      }\n    },\n  });\n\n  debug(`${logPrefix} - TIMING asc.main: ${(performance.now() - ascStart).toFixed(2)} ms`);\n\n  if (result.error) {\n    const errorMessage = stderrLines.length > 0\n      ? `${result.error.message}\\n\\n${stderrLines.join('')}`\n      : result.error.message;\n\n    throw createPoolError(errorMessage, POOL_ERROR_NAMES.CompilationError, errorMessage);\n  }\n\n  if (!binary) {\n    const errorMessage = stderrLines.length > 0\n      ? `No WASM binary was generated\\n\\nAS Compiler output:\\n${stderrLines.join('')}`\n      : 'No WASM binary was generated';\n\n    throw createPoolError(errorMessage, POOL_ERROR_NAMES.CompilationError);\n  }\n\n  if (!sourceMap) {\n    throw createPoolError('Source map not captured from AssemblyScript Compiler', POOL_ERROR_NAMES.CompilationError);\n  }\n\n  const cleanBinary: Uint8Array = binary;\n  const wasmSourceMap: string = sourceMap;\n\n  debug(`${logPrefix} - Compilation successful, clean binary size: ${cleanBinary.length} bytes`);\n  debug(`${logPrefix} - Source map generated, size: ${wasmSourceMap.length * 2} bytes`);\n  \n  if (DEBUG_WRITE_FILES) {\n    // Write source map for debugging\n    const dir = './debug';\n    // TODO - handle non-.ts extensions\n    const sourceMapFileName = `${basename(filename, '.ts')}.ts.map`;\n    const sourceMapPath = `${dir}/${sourceMapFileName}`;\n\n    // Create directory if it doesn't exist\n    try {\n      await mkdir(dir, { recursive: true });\n    } catch {\n      // Directory already exists or creation failed, continue\n    }\n\n    // Format as well-formed JSON\n    const formattedSourceMap = JSON.stringify(JSON.parse(wasmSourceMap), null, 2);\n\n    writeFile(sourceMapPath, formattedSourceMap, { encoding: 'utf8' });\n    debug(`${logPrefix} - Wrote source map to: \"${sourceMapPath}\"`);\n\n    // Also write WASM binary for inspection\n    const wasmPath = sourceMapPath.replace('.map', '.wasm');\n    writeFile(wasmPath, cleanBinary);\n    debug(`${logPrefix} - Wrote WASM binary to: \"${wasmPath}\"`);\n  }\n\n  // Instrument binary for coverage if requested\n  if (options.shouldInstrument) {\n    throwPoolErrorIfAborted(signal);\n\n    const instrumentStart = performance.now();\n    const wasmBuffer = Buffer.from(cleanBinary);\n    const sourceMapBuffer = Buffer.from(wasmSourceMap);\n\n    const instrumentResult = instrumentForCoverage(wasmBuffer, sourceMapBuffer, options.instrumentationOptions!, logModule, logLabel);\n    const instCount = instrumentResult.debugInfo.instrumentedFunctionCount;\n\n    const instrumentEnd = performance.now();\n    debug(`${logPrefix} - TIMING Instrumented ${instCount} functions: ${(performance.now() - instrumentStart).toFixed(2)} ms`);\n\n    return {\n      binary: instrumentResult.instrumentedWasm,\n      sourceMap: instrumentResult.sourceMap,\n      debugInfo: instrumentResult.debugInfo,\n      isInstrumented: true,\n      compileTiming: instrumentEnd - compileStart,\n    };\n  }\n\n  // No instrumentation requested\n  return {\n    binary: cleanBinary,\n    sourceMap: wasmSourceMap,\n    isInstrumented: false,\n    compileTiming: performance.now() - compileStart,\n  };\n}\n"],"mappings":"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"}

package/dist/config/index-v3.d.mts

@@ -1,5 +1,5 @@
-import { AssemblyScriptPoolOptions, WasmImportsFactory, WasmImportsFactoryInfo } from "../types-8KKo9Hbf.mjs";
-import "../custom-provider-options-CF5C1kXb.mjs";
+import { AssemblyScriptPoolOptions, WasmImportsFactory, WasmImportsFactoryInfo } from "../types-DmyeERkL.mjs";
+import "../custom-provider-options-i_O0OSTV.mjs";
 import { ConfigEnv, UserWorkspaceConfig, ViteUserConfig } from "vitest/config";
 
 //#region src/config/config-helpers-v3.d.ts

package/dist/config/index.d.mts

@@ -1,4 +1,4 @@
-import { AssemblyScriptPoolOptions, WasmImportsFactory, WasmImportsFactoryInfo } from "../types-8KKo9Hbf.mjs";
-import "../custom-provider-options-CF5C1kXb.mjs";
-import { createAssemblyScriptPool } from "../pool-runner-init-CEwLyNI3.mjs";
+import { AssemblyScriptPoolOptions, WasmImportsFactory, WasmImportsFactoryInfo } from "../types-DmyeERkL.mjs";
+import "../custom-provider-options-i_O0OSTV.mjs";
+import { createAssemblyScriptPool } from "../pool-runner-init-D56aVMMD.mjs";
 export { type AssemblyScriptPoolOptions, type WasmImportsFactory, type WasmImportsFactoryInfo, createAssemblyScriptPool };

package/dist/config/index.mjs

@@ -1,9 +1,9 @@
-import "../constants-DX9yo-el.mjs";
-import "../resolve-config-BKjJQyy5.mjs";
-import "../debug-Cf2jt1kg.mjs";
+import "../constants-DuBLuMjt.mjs";
+import "../resolve-config-BFNr7LW7.mjs";
+import "../debug-Cm1VFmaz.mjs";
 import "../vitest-file-tasks-BUwzh375.mjs";
-import "../vitest-tasks-Cbri6MWZ.mjs";
+import "../vitest-tasks-ByPK8DvF.mjs";
 import "../worker-rpc-channel-lbhK7Qz8.mjs";
-import { createAssemblyScriptPool } from "../pool-runner-init-Cdpz_B-F.mjs";
+import { createAssemblyScriptPool } from "../pool-runner-init-D1QamWkS.mjs";
 
 export { createAssemblyScriptPool };

package/dist/{constants-DX9yo-el.mjs → constants-DuBLuMjt.mjs}

@@ -2,7 +2,7 @@
 const COVERAGE_PAYLOAD_FORMATS = { AssemblyScript: "assemblyscript" };
 /** Prefix for AssemblyScript compiler strip-inline exclusions and instrumentation exclusions */
 const ASSEMBLYSCRIPT_LIB_PREFIX = "~lib/";
-const INTERNAL_PATH_LIB_PREFIX = `${"~lib/"}vitest-pool-assemblyscript/`;
+const INTERNAL_PATH_LIB_PREFIX = `${"~lib/"}vitest-pool-assemblyscript/assembly/`;
 /** Paths instrumentation exclusions and assetion error stack frame filtering */
 const POOL_INTERNAL_PATHS = [
 	"assembly/compare.ts",
@@ -11,12 +11,12 @@ const POOL_INTERNAL_PATHS = [
 	"assembly/index.ts",
 	"assembly/options.ts",
 	"assembly/test.ts",
-	`${INTERNAL_PATH_LIB_PREFIX}assembly/compare.ts`,
-	`${INTERNAL_PATH_LIB_PREFIX}assembly/describe.ts`,
-	`${INTERNAL_PATH_LIB_PREFIX}assembly/expect.ts`,
-	`${INTERNAL_PATH_LIB_PREFIX}assembly/index.ts`,
-	`${INTERNAL_PATH_LIB_PREFIX}assembly/options.ts`,
-	`${INTERNAL_PATH_LIB_PREFIX}assembly/test.ts`
+	`${INTERNAL_PATH_LIB_PREFIX}compare.ts`,
+	`${INTERNAL_PATH_LIB_PREFIX}describe.ts`,
+	`${INTERNAL_PATH_LIB_PREFIX}expect.ts`,
+	`${INTERNAL_PATH_LIB_PREFIX}index.ts`,
+	`${INTERNAL_PATH_LIB_PREFIX}options.ts`,
+	`${INTERNAL_PATH_LIB_PREFIX}test.ts`
 ];
 /** Error names for AssemblyScript test failures reported to vitest */
 const TEST_ERROR_NAMES = {
@@ -135,5 +135,5 @@ const ASSourceKind = {
 };
 
 //#endregion
-export { ASCommonFlags, ASDecoratorKind, ASNodeKind, ASSourceKind, COVERAGE_PAYLOAD_FORMATS, POOL_ERROR_NAMES, POOL_INTERNAL_PATHS, TEST_ERROR_NAMES };
-//# sourceMappingURL=constants-DX9yo-el.mjs.map
+export { ASCommonFlags, ASDecoratorKind, ASNodeKind, ASSourceKind, COVERAGE_PAYLOAD_FORMATS, INTERNAL_PATH_LIB_PREFIX, POOL_ERROR_NAMES, POOL_INTERNAL_PATHS, TEST_ERROR_NAMES };
+//# sourceMappingURL=constants-DuBLuMjt.mjs.map

package/dist/constants-DuBLuMjt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-DuBLuMjt.mjs","names":[],"sources":["../src/types/constants.ts"],"sourcesContent":["/**\n * Plain Constants\n * \n * Only things that don't require importing ./types to avoid circular dependencies.\n */\n\n\n// ============================================================================\n// General / Shared Constants\n// ============================================================================\n\nexport const ASSEMBLYSCRIPT_POOL_NAME = 'assemblyscript' as const;\n\nexport const AS_POOL_ERROR_TYPE_FLAG = '__as_pool__' as const;\n\nexport const AS_POOL_WORKER_MSG_FLAG = '__as_pool__' as const;\n\nexport const AS_POOL_WASM_IMPORTS_ENV = '__as_pool_env__' as const;\n\nexport const VITEST_WORKER_REQUEST_MSG_FLAG = '__vitest_worker_request__' as const;\n\nexport const VITEST_WORKER_RESPONSE_MSG_FLAG = '__vitest_worker_response__' as const;\n\nexport const COVERAGE_PAYLOAD_FORMATS = {\n  AssemblyScript: 'assemblyscript',\n} as const;\n\n/** Prefix for AssemblyScript compiler strip-inline exclusions and instrumentation exclusions */\nexport const ASSEMBLYSCRIPT_LIB_PREFIX = '~lib/' as const;\n\nexport const INTERNAL_PATH_LIB_PREFIX: string = `${ASSEMBLYSCRIPT_LIB_PREFIX}vitest-pool-assemblyscript/assembly/` as const;\n\n/** Paths instrumentation exclusions and assetion error stack frame filtering */\nexport const POOL_INTERNAL_PATHS: string[] = [\n  // AS compiler source maps these as relative paths when running locally\n  'assembly/compare.ts',\n  'assembly/describe.ts',\n  'assembly/expect.ts',\n  'assembly/index.ts',\n  'assembly/options.ts',\n  'assembly/test.ts',\n\n  // AS compiler source maps these as library paths when running published version\n  `${INTERNAL_PATH_LIB_PREFIX}compare.ts`,\n  `${INTERNAL_PATH_LIB_PREFIX}describe.ts`,\n  `${INTERNAL_PATH_LIB_PREFIX}expect.ts`,\n  `${INTERNAL_PATH_LIB_PREFIX}index.ts`,\n  `${INTERNAL_PATH_LIB_PREFIX}options.ts`,\n  `${INTERNAL_PATH_LIB_PREFIX}test.ts`,\n] as const;\n\n/** Error names for AssemblyScript test failures reported to vitest */\nexport const TEST_ERROR_NAMES = {\n  /** Assertion evaluated to false within a test function */\n  AssertionError: 'AssertionError',\n  /** WASM runtime called abort after a non-planned user code error */\n  WASMRuntimeError: 'WASMRuntimeError',\n} as const;\n\n/** Error names for internal AssemblyScript pool failures */\nexport const POOL_ERROR_NAMES = {\n  /** AssemblyScript compiler (asc) error */\n  CompilationError: 'CompilationError',\n  /** Native instrumentation and debug info extraction error */\n  WASMInstrumentationError: 'WASMInstrumentationError',\n  /** Unexpected WASM execution error (not a known test error path) */\n  WASMExecutionHarnessError: 'WASMExecutionHarnessError',\n  /** Hybrid coverage provider error */\n  HybridCoverageProviderError: 'HybridCoverageProviderError',\n  /** vitest RPC reporting error */\n  PoolReportingError: 'PoolReportingError',\n  /** User configuration error */\n  PoolConfigError: 'PoolConfigError',\n  /** Generic AssemblyScript pool error */\n  PoolError: 'PoolError',\n  /** User syntax error in test/suite/expect */\n  PoolSyntaxError: 'PoolSyntaxError',\n\n  /** Flow Control: Indicates intentional abort */\n  PoolRunAbortedError: 'PoolRunAbortedError',\n  /**\n   * Flow Control: Indicates WASM execution halt through abort() handler,\n   * and should be handled by reporting an AssemblyScriptTestError to vitest\n   */\n  WASMExecutionAbortError: 'WASMExecutionAbortError',\n  /** Flow Control: Indicates WASM execution halt because test timeout elapsed */\n  WASMExecutionTimeoutError: 'WASMExecutionTimeoutError',\n} as const;\n\n// ============================================================================\n// AssemblyScript Compiler\n// ============================================================================\n\n// Redefined locally to avoid isolatedModules const enum access issues\n// with assemmblyscript enum exports. Reference assemblyscript.generated.d.ts\n\nexport const ASCommonFlags = {\n  Static: 32,\n  Get: 2048,\n  Set: 4096,\n} as const;\n\nexport const ASNodeKind = {\n  Source: 0,\n  NamedType: 1,\n  FunctionType: 2,\n  TypeName: 3,\n  TypeParameter: 4,\n  Parameter: 5,\n  Identifier: 6,\n  Assertion: 7,\n  Binary: 8,\n  Call: 9,\n  Class: 10,\n  Comma: 11,\n  ElementAccess: 12,\n  False: 13,\n  Function: 14,\n  InstanceOf: 15,\n  Literal: 16,\n  New: 17,\n  Null: 18,\n  Omitted: 19,\n  Parenthesized: 20,\n  PropertyAccess: 21,\n  Ternary: 22,\n  Super: 23,\n  This: 24,\n  True: 25,\n  Constructor: 26,\n  UnaryPostfix: 27,\n  UnaryPrefix: 28,\n  Compiled: 29,\n  Block: 30,\n  Break: 31,\n  Continue: 32,\n  Do: 33,\n  Empty: 34,\n  Export: 35,\n  ExportDefault: 36,\n  ExportImport: 37,\n  Expression: 38,\n  For: 39,\n  ForOf: 40,\n  If: 41,\n  Import: 42,\n  Return: 43,\n  Switch: 44,\n  Throw: 45,\n  Try: 46,\n  Variable: 47,\n  Void: 48,\n  While: 49,\n  Module: 50,\n  ClassDeclaration: 51,\n  EnumDeclaration: 52,\n  EnumValueDeclaration: 53,\n  FieldDeclaration: 54,\n  FunctionDeclaration: 55,\n  ImportDeclaration: 56,\n  InterfaceDeclaration: 57,\n  MethodDeclaration: 58,\n  NamespaceDeclaration: 59,\n  TypeDeclaration: 60,\n  VariableDeclaration: 61,\n  Decorator: 62,\n  ExportMember: 63,\n  SwitchCase: 64,\n  IndexSignature: 65,\n  Comment: 66,\n} as const;\n\nexport const ASDecoratorKind = {\n  Custom: 0,\n  Global: 1,\n  Operator: 2,\n  OperatorBinary: 3,\n  OperatorPrefix: 4,\n  OperatorPostfix: 5,\n  Unmanaged: 6,\n  Final: 7,\n  Inline: 8,\n  External: 9,\n  ExternalJs: 10,\n  Builtin: 11,\n  Lazy: 12,\n  Unsafe: 13\n} as const;\n\nexport const ASSourceKind = {\n  User: 0,\n  UserEntry: 1,\n  Library: 2,\n  LibraryEntry: 3\n} as const;\n"],"mappings":";AAuBA,MAAa,2BAA2B,EACtC,gBAAgB,kBACjB;;AAGD,MAAa,4BAA4B;AAEzC,MAAa,2BAAmC,WAA6B;;AAG7E,MAAa,sBAAgC;CAE3C;CACA;CACA;CACA;CACA;CACA;CAGA,GAAG,yBAAyB;CAC5B,GAAG,yBAAyB;CAC5B,GAAG,yBAAyB;CAC5B,GAAG,yBAAyB;CAC5B,GAAG,yBAAyB;CAC5B,GAAG,yBAAyB;CAC7B;;AAGD,MAAa,mBAAmB;CAE9B,gBAAgB;CAEhB,kBAAkB;CACnB;;AAGD,MAAa,mBAAmB;CAE9B,kBAAkB;CAElB,0BAA0B;CAE1B,2BAA2B;CAE3B,6BAA6B;CAE7B,oBAAoB;CAEpB,iBAAiB;CAEjB,WAAW;CAEX,iBAAiB;CAGjB,qBAAqB;CAKrB,yBAAyB;CAEzB,2BAA2B;CAC5B;AASD,MAAa,gBAAgB;CAC3B,QAAQ;CACR,KAAK;CACL,KAAK;CACN;AAED,MAAa,aAAa;CACxB,QAAQ;CACR,WAAW;CACX,cAAc;CACd,UAAU;CACV,eAAe;CACf,WAAW;CACX,YAAY;CACZ,WAAW;CACX,QAAQ;CACR,MAAM;CACN,OAAO;CACP,OAAO;CACP,eAAe;CACf,OAAO;CACP,UAAU;CACV,YAAY;CACZ,SAAS;CACT,KAAK;CACL,MAAM;CACN,SAAS;CACT,eAAe;CACf,gBAAgB;CAChB,SAAS;CACT,OAAO;CACP,MAAM;CACN,MAAM;CACN,aAAa;CACb,cAAc;CACd,aAAa;CACb,UAAU;CACV,OAAO;CACP,OAAO;CACP,UAAU;CACV,IAAI;CACJ,OAAO;CACP,QAAQ;CACR,eAAe;CACf,cAAc;CACd,YAAY;CACZ,KAAK;CACL,OAAO;CACP,IAAI;CACJ,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,OAAO;CACP,KAAK;CACL,UAAU;CACV,MAAM;CACN,OAAO;CACP,QAAQ;CACR,kBAAkB;CAClB,iBAAiB;CACjB,sBAAsB;CACtB,kBAAkB;CAClB,qBAAqB;CACrB,mBAAmB;CACnB,sBAAsB;CACtB,mBAAmB;CACnB,sBAAsB;CACtB,iBAAiB;CACjB,qBAAqB;CACrB,WAAW;CACX,cAAc;CACd,YAAY;CACZ,gBAAgB;CAChB,SAAS;CACV;AAED,MAAa,kBAAkB;CAC7B,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,gBAAgB;CAChB,gBAAgB;CAChB,iBAAiB;CACjB,WAAW;CACX,OAAO;CACP,QAAQ;CACR,UAAU;CACV,YAAY;CACZ,SAAS;CACT,MAAM;CACN,QAAQ;CACT;AAED,MAAa,eAAe;CAC1B,MAAM;CACN,WAAW;CACX,SAAS;CACT,cAAc;CACf"}

package/dist/{coverage-merge-0WqdC-dq.mjs → coverage-merge-DCEwyjMy.mjs}

@@ -19,4 +19,4 @@ function mergeCoverageData(accumulated, incoming) {
 
 //#endregion
 export { mergeCoverageData };
-//# sourceMappingURL=coverage-merge-0WqdC-dq.mjs.map
+//# sourceMappingURL=coverage-merge-DCEwyjMy.mjs.map

package/dist/{coverage-merge-0WqdC-dq.mjs.map → coverage-merge-DCEwyjMy.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"coverage-merge-0WqdC-dq.mjs","names":[],"sources":["../src/coverage-provider/coverage-merge.ts"],"sourcesContent":["/**\n * Coverage Data Merge Utilities\n *\n * Functions for merging CoverageData objects\n */\n\nimport type { CoverageData } from '../types/types.js';\n\n/**\n * Merge incoming CoverageData into accumulated CoverageData\n *\n * Combines by filepath + position, summing hit counts.\n * Mutates the accumulated object in place.\n *\n * @param accumulated - Accumulated coverage data (mutated)\n * @param incoming - New coverage data to merge in\n */\nexport function mergeCoverageData(\n  accumulated: CoverageData,\n  incoming: CoverageData\n): void {\n  for (const [filePath, positions] of Object.entries(incoming.hitCountsByFileAndPosition)) {\n    // Ensure file exists in accumulated\n    if (!accumulated.hitCountsByFileAndPosition[filePath]) {\n      accumulated.hitCountsByFileAndPosition[filePath] = {};\n    }\n\n    const accumulatedPositions = accumulated.hitCountsByFileAndPosition[filePath];\n\n    for (const [positionKey, hitCount] of Object.entries(positions)) {\n      if (accumulatedPositions[positionKey] !== undefined) {\n        // Position exists - sum hit counts\n        accumulatedPositions[positionKey] += hitCount;\n      } else {\n        // New position - set hit count\n        accumulatedPositions[positionKey] = hitCount;\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;AAiBA,SAAgB,kBACd,aACA,UACM;AACN,MAAK,MAAM,CAAC,UAAU,cAAc,OAAO,QAAQ,SAAS,2BAA2B,EAAE;AAEvF,MAAI,CAAC,YAAY,2BAA2B,UAC1C,aAAY,2BAA2B,YAAY,EAAE;EAGvD,MAAM,uBAAuB,YAAY,2BAA2B;AAEpE,OAAK,MAAM,CAAC,aAAa,aAAa,OAAO,QAAQ,UAAU,CAC7D,KAAI,qBAAqB,iBAAiB,OAExC,sBAAqB,gBAAgB;MAGrC,sBAAqB,eAAe"}
+{"version":3,"file":"coverage-merge-DCEwyjMy.mjs","names":[],"sources":["../src/coverage-provider/coverage-merge.ts"],"sourcesContent":["/**\n * Coverage Data Merge Utilities\n *\n * Functions for merging CoverageData objects\n */\n\nimport type { CoverageData } from '../types/types.js';\n\n/**\n * Merge incoming CoverageData into accumulated CoverageData\n *\n * Combines by filepath + position, summing hit counts.\n * Mutates the accumulated object in place.\n *\n * @param accumulated - Accumulated coverage data (mutated)\n * @param incoming - New coverage data to merge in\n */\nexport function mergeCoverageData(\n  accumulated: CoverageData,\n  incoming: CoverageData\n): void {\n  for (const [filePath, positions] of Object.entries(incoming.hitCountsByFileAndPosition)) {\n    // Ensure file exists in accumulated\n    if (!accumulated.hitCountsByFileAndPosition[filePath]) {\n      accumulated.hitCountsByFileAndPosition[filePath] = {};\n    }\n\n    const accumulatedPositions = accumulated.hitCountsByFileAndPosition[filePath];\n\n    for (const [positionKey, hitCount] of Object.entries(positions)) {\n      if (accumulatedPositions[positionKey] !== undefined) {\n        // Position exists - sum hit counts\n        accumulatedPositions[positionKey] += hitCount;\n      } else {\n        // New position - set hit count\n        accumulatedPositions[positionKey] = hitCount;\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;AAiBA,SAAgB,kBACd,aACA,UACM;AACN,MAAK,MAAM,CAAC,UAAU,cAAc,OAAO,QAAQ,SAAS,2BAA2B,EAAE;AAEvF,MAAI,CAAC,YAAY,2BAA2B,UAC1C,aAAY,2BAA2B,YAAY,EAAE;EAGvD,MAAM,uBAAuB,YAAY,2BAA2B;AAEpE,OAAK,MAAM,CAAC,aAAa,aAAa,OAAO,QAAQ,UAAU,CAC7D,KAAI,qBAAqB,iBAAiB,OAExC,sBAAqB,gBAAgB;MAGrC,sBAAqB,eAAe"}

package/dist/coverage-provider/index.mjs

@@ -1,15 +1,16 @@
-import { ASCommonFlags, ASNodeKind, COVERAGE_PAYLOAD_FORMATS, POOL_ERROR_NAMES } from "../constants-DX9yo-el.mjs";
-import { getProjectSerializedOrGlobalConfig } from "../resolve-config-BKjJQyy5.mjs";
-import { createPoolError, debug } from "../debug-Cf2jt1kg.mjs";
-import { mergeCoverageData } from "../coverage-merge-0WqdC-dq.mjs";
-import { ASTVisitor } from "../ast-visitor-lTahoS9R.mjs";
+import { ASCommonFlags, ASNodeKind, COVERAGE_PAYLOAD_FORMATS, POOL_ERROR_NAMES } from "../constants-DuBLuMjt.mjs";
+import { getProjectSerializedOrGlobalConfig } from "../resolve-config-BFNr7LW7.mjs";
+import { createPoolError, debug, debugOverride } from "../debug-Cm1VFmaz.mjs";
+import { warnIfASCoverageNotSupported } from "../node-check-CooGQMLH.mjs";
+import { mergeCoverageData } from "../coverage-merge-DCEwyjMy.mjs";
+import { ASTVisitor } from "../ast-visitor-DJLJd5dt.mjs";
 import { basename, parse, relative } from "node:path";
 import { readFile } from "node:fs/promises";
 import v8CoverageModule from "@vitest/coverage-v8";
 import istanbulCoverage from "istanbul-lib-coverage";
 import { Parser } from "assemblyscript";
-import { resolve as resolve$1 } from "path";
-import TestExclude from "test-exclude";
+import { relative as relative$1 } from "path";
+import { globSync } from "tinyglobby";
 
 //#region src/coverage-provider/containment-matcher.ts
 /**
@@ -59,7 +60,6 @@ function isPositionInRange(line, column, range) {
 
 //#endregion
 //#region src/coverage-provider/istanbul-converter.ts
-function istanbulDebug(...args) {}
 /**
 * Convert AssemblyScript coverage data to Istanbul format for a single file
 *
@@ -78,8 +78,11 @@ function istanbulDebug(...args) {}
 * @param absoluteFilePath - Absolute path to the source file (for Istanbul output)
 * @returns Istanbul FileCoverage object
 */
-async function convertToIstanbulFormat(fileFunctionsByStartLine, fileHitCountsByPosition, absoluteFilePath) {
+async function convertToIstanbulFormat(fileFunctionsByStartLine, fileHitCountsByPosition, absoluteFilePath, istanbulDebugEnabled) {
 	const startMatch = performance.now();
+	function istanbulDebug(...args) {
+		if (istanbulDebugEnabled) debugOverride(...args);
+	}
 	istanbulDebug(() => {
 		const sourceFunctionCount = Object.values(fileFunctionsByStartLine).reduce((sum, funcs) => sum + funcs.length, 0);
 		const uniqueHitPosCount = Object.keys(fileHitCountsByPosition).length;
@@ -318,31 +321,31 @@ async function parseFunctionsFromFile(absoluteSourceFilePath, relativeSourceFile
 /**
 * Glob Utilities for Coverage
 *
-* Uses test-exclude (same as Vitest's v8 coverage provider) to glob
-* AssemblyScript files matching coverage.include patterns.
+* Uses tinyglobby to glob AssemblyScript files matching coverage include/exclude patterns.
+* Supports ../ path traversals for projects that import source from outside the project root.
+*
+* Note: tinyglobby docs warn of a performance cost when globbing outside cwd (e.g. ../ patterns)
+* due to recalculating relative paths. Acceptable here since this runs once at startup.
 */
+const NODE_MODULES_GLOB = "**/node_modules/**";
 /**
 * Glob files matching coverage include/exclude patterns
 *
-* Uses test-exclude for consistent behavior with Vitest's built-in
-* coverage providers.
-*
 * @param include - Include patterns (e.g., ['assembly/**\/*.ts'])
 * @param exclude - Exclude patterns (e.g., ['**\/*.test.ts'])
 * @param projectRoot - Project root directory
-* @returns Array of absolute file paths
+* @returns Array of glob results with absolute and project-root-relative paths
 */
 function globFiles(include, exclude, projectRoot) {
 	if (include.length === 0) return [];
-	return new TestExclude({
+	return globSync(include, {
 		cwd: projectRoot,
-		include,
-		exclude,
-		excludeNodeModules: true
-	}).globSync(projectRoot).map((file) => ({
-		absolute: resolve$1(projectRoot, file),
-		projectRootRelative: file
-	})) || [];
+		ignore: [NODE_MODULES_GLOB, ...exclude],
+		absolute: true
+	}).map((absolute) => ({
+		absolute,
+		projectRootRelative: relative$1(projectRoot, absolute)
+	}));
 }
 
 //#endregion
@@ -373,6 +376,7 @@ var HybridCoverageProvider = class {
 		await this.v8Provider.initialize(ctx);
 		this.v8Provider.name = "hybrid-assemblyscript-v8 (delegated v8 reporter)";
 		debug("[HybridCoverageProvider] Initialized with delegated v8 provider");
+		warnIfASCoverageNotSupported();
 	}
 	/**
 	* Handle suite completion - delegate based on coverage format marker
@@ -429,9 +433,9 @@ var HybridCoverageProvider = class {
 				debug(`[HybridCoverageProvider] Parsing AS source for expected coverage: "${include.absolute}" (file key: "${include.projectRootRelative}")`);
 				const functionsByStartLine = await parseFunctionsFromFile(include.absolute, include.projectRootRelative) || {};
 				debug(`[HybridCoverageProvider] Parsed ${Object.keys(functionsByStartLine).length} AS source functions in "${include.projectRootRelative}"`);
-				const fileHitCountsByPosition = this.accumulatedCoverageData.hitCountsByFileAndPosition[include.projectRootRelative] ?? {};
-				debug(`[HybridCoverageProvider] Accumulated AS coverage has ${Object.keys(fileHitCountsByPosition).length} positions for "${include.projectRootRelative}"`);
-				return convertToIstanbulFormat(functionsByStartLine, fileHitCountsByPosition, include.absolute);
+				const fileHitCountsByPosition = this.accumulatedCoverageData.hitCountsByFileAndPosition[include.absolute] ?? {};
+				debug(`[HybridCoverageProvider] Accumulated AS coverage has ${Object.keys(fileHitCountsByPosition).length} positions for "${include.absolute}"`);
+				return convertToIstanbulFormat(functionsByStartLine, fileHitCountsByPosition, include.absolute, this.coverageOptions.debugIstanbul);
 			});
 			const istanbulResults = await Promise.all(fileProcessingPromises);
 			for (const istanbulData of istanbulResults) asCoverageMap.addFileCoverage(istanbulData);
@@ -443,8 +447,10 @@ var HybridCoverageProvider = class {
 		const jsCoverage = await this.v8Provider.generateCoverage(context);
 		debug(`[HybridCoverageProvider] JS coverage has ${Object.keys(jsCoverage.data).length} files`);
 		debug(`[HybridCoverageProvider] TIMING JS generateCoverage: ${(performance.now() - asGenerateEnd).toFixed(2)} ms`);
-		debug("[HybridCoverageProvider] Merging AS coverage into JS coverage");
-		jsCoverage.merge(asCoverageMap);
+		if (asCoverageMap.files().length) {
+			debug("[HybridCoverageProvider] Merging AS coverage into JS coverage");
+			jsCoverage.merge(asCoverageMap.toJSON());
+		} else debug("[HybridCoverageProvider] AS coverage map empty, not merging into JS coverage");
 		debug(`[HybridCoverageProvider] Final merged coverage has ${Object.keys(jsCoverage.data).length} files`);
 		debug(`[HybridCoverageProvider] TIMING Total generateCoverage: ${(performance.now() - start).toFixed(2)} ms`);
 		return jsCoverage;
@@ -483,6 +489,7 @@ var HybridCoverageProvider = class {
 			...resolvedV8Options,
 			provider: "custom",
 			customProviderModule: definedCoverageOptions.customProviderModule,
+			debugIstanbul: definedCoverageOptions.debugIstanbul ?? false,
 			assemblyScriptInclude: definedCoverageOptions.assemblyScriptInclude ?? [],
 			assemblyScriptExclude: definedCoverageOptions.assemblyScriptExclude ?? [],
 			globbedAssemblyScriptInclude,