oxc-coverage-instrument 0.2.13 → 0.2.15

package/package.json

@@ -1,12 +1,24 @@
 {
   "name": "oxc-coverage-instrument",
-  "version": "0.2.13",
-  "description": "Istanbul-compatible JavaScript/TypeScript coverage instrumentation using the Oxc AST. 58x faster than istanbul-lib-instrument.",
+  "version": "0.2.15",
+  "description": "Istanbul-compatible JavaScript/TypeScript coverage instrumentation using the Oxc AST. 8-48x faster than istanbul-lib-instrument.",
   "main": "index.js",
   "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    },
+    "./vitest": {
+      "types": "./vitest.d.ts",
+      "default": "./vitest.js"
+    }
+  },
   "files": [
     "index.js",
-    "index.d.ts"
+    "index.d.ts",
+    "vitest.js",
+    "vitest.d.ts"
   ],
   "keywords": [
     "oxc",
@@ -49,12 +61,12 @@
     "test": "node test.mjs"
   },
   "optionalDependencies": {
-    "@oxc-coverage-instrument/binding-darwin-arm64": "0.2.13",
-    "@oxc-coverage-instrument/binding-darwin-x64": "0.2.13",
-    "@oxc-coverage-instrument/binding-linux-x64-gnu": "0.2.13",
-    "@oxc-coverage-instrument/binding-linux-arm64-gnu": "0.2.13",
-    "@oxc-coverage-instrument/binding-linux-x64-musl": "0.2.13",
-    "@oxc-coverage-instrument/binding-win32-x64-msvc": "0.2.13",
-    "@oxc-coverage-instrument/binding-win32-arm64-msvc": "0.2.13"
+    "@oxc-coverage-instrument/binding-darwin-arm64": "0.2.15",
+    "@oxc-coverage-instrument/binding-darwin-x64": "0.2.15",
+    "@oxc-coverage-instrument/binding-linux-x64-gnu": "0.2.15",
+    "@oxc-coverage-instrument/binding-linux-arm64-gnu": "0.2.15",
+    "@oxc-coverage-instrument/binding-linux-x64-musl": "0.2.15",
+    "@oxc-coverage-instrument/binding-win32-x64-msvc": "0.2.15",
+    "@oxc-coverage-instrument/binding-win32-arm64-msvc": "0.2.15"
   }
 }

package/vitest.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Options for creating an Oxc-based coverage instrumenter.
+ *
+ * When used with Vitest's `coverage.instrumenter` option, the factory receives
+ * `InstrumenterOptions` with `coverageVariable` and `ignoreClassMethods`.
+ */
+export interface OxcInstrumenterOptions {
+  /** Global variable name for coverage data (Vitest passes `__VITEST_COVERAGE__`). */
+  coverageVariable?: string
+  /** Class method names to exclude from function coverage. */
+  ignoreClassMethods?: string[]
+  /** When true, adds truthy-value tracking (bT) for logical expressions. */
+  reportLogic?: boolean
+}
+
+/**
+ * Creates an instrumenter that implements the istanbul-lib-instrument
+ * Instrumenter interface, backed by oxc-coverage-instrument.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from 'vitest/config'
+ * import { createOxcInstrumenter } from 'oxc-coverage-instrument/vitest'
+ *
+ * export default defineConfig({
+ *   test: {
+ *     coverage: {
+ *       provider: 'istanbul',
+ *       instrumenter: (options) => createOxcInstrumenter(options),
+ *     }
+ *   }
+ * })
+ * ```
+ */
+export declare function createOxcInstrumenter(options?: OxcInstrumenterOptions): {
+  instrumentSync(code: string, filename: string, inputSourceMap?: any): string
+  lastSourceMap(): any
+  lastFileCoverage(): any
+}

package/vitest.js

@@ -0,0 +1,72 @@
+// Vitest Istanbul instrumenter adapter for oxc-coverage-instrument.
+//
+// Implements the istanbul-lib-instrument Instrumenter interface so it can be
+// used as a drop-in replacement in @vitest/coverage-istanbul.
+//
+// Usage in vitest.config.ts:
+//
+//   import { defineConfig } from 'vitest/config'
+//   import { createOxcInstrumenter } from 'oxc-coverage-instrument/vitest'
+//
+//   export default defineConfig({
+//     test: {
+//       coverage: {
+//         provider: 'istanbul',
+//         instrumenter: (options) => createOxcInstrumenter(options),
+//       }
+//     }
+//   })
+
+const { instrument } = require('./index.js');
+
+/**
+ * Creates an instrumenter that implements the istanbul-lib-instrument
+ * Instrumenter interface, backed by oxc-coverage-instrument.
+ *
+ * When used with Vitest's `coverage.instrumenter` option, the factory receives
+ * `InstrumenterOptions` with `coverageVariable` and `ignoreClassMethods`.
+ * These are forwarded to the native instrumenter automatically.
+ *
+ * @param {object} [options]
+ * @param {string} [options.coverageVariable] - Global variable for coverage data.
+ *   Vitest passes its internal `__VITEST_COVERAGE__`; defaults to `__coverage__`.
+ * @param {string[]} [options.ignoreClassMethods] - Class methods to skip.
+ * @param {boolean} [options.reportLogic] - Enable truthy-value tracking (bT).
+ * @returns {{ instrumentSync, lastSourceMap, lastFileCoverage }}
+ */
+function createOxcInstrumenter(options) {
+  options = options || {};
+  const coverageVariable = options.coverageVariable || '__coverage__';
+  const ignoreClassMethods = options.ignoreClassMethods || [];
+  const reportLogic = options.reportLogic || false;
+
+  let _lastSourceMap = null;
+  let _lastFileCoverage = null;
+
+  return {
+    instrumentSync(code, filename, inputSourceMap) {
+      const result = instrument(code, filename, {
+        coverageVariable,
+        sourceMap: true,
+        inputSourceMap: inputSourceMap ? JSON.stringify(inputSourceMap) : undefined,
+        reportLogic,
+        ignoreClassMethods,
+      });
+
+      _lastFileCoverage = JSON.parse(result.coverageMap);
+      _lastSourceMap = result.sourceMap ? JSON.parse(result.sourceMap) : null;
+
+      return result.code;
+    },
+
+    lastSourceMap() {
+      return _lastSourceMap;
+    },
+
+    lastFileCoverage() {
+      return _lastFileCoverage;
+    },
+  };
+}
+
+module.exports = { createOxcInstrumenter };