oxc-coverage-instrument 0.2.12 → 0.2.14

package/package.json

@@ -1,12 +1,24 @@
 {
   "name": "oxc-coverage-instrument",
-  "version": "0.2.12",
-  "description": "Istanbul-compatible JavaScript/TypeScript coverage instrumentation using the Oxc AST. 58x faster than istanbul-lib-instrument.",
+  "version": "0.2.14",
+  "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.12",
-    "@oxc-coverage-instrument/binding-darwin-x64": "0.2.12",
-    "@oxc-coverage-instrument/binding-linux-x64-gnu": "0.2.12",
-    "@oxc-coverage-instrument/binding-linux-arm64-gnu": "0.2.12",
-    "@oxc-coverage-instrument/binding-linux-x64-musl": "0.2.12",
-    "@oxc-coverage-instrument/binding-win32-x64-msvc": "0.2.12",
-    "@oxc-coverage-instrument/binding-win32-arm64-msvc": "0.2.12"
+    "@oxc-coverage-instrument/binding-darwin-arm64": "0.2.14",
+    "@oxc-coverage-instrument/binding-darwin-x64": "0.2.14",
+    "@oxc-coverage-instrument/binding-linux-x64-gnu": "0.2.14",
+    "@oxc-coverage-instrument/binding-linux-arm64-gnu": "0.2.14",
+    "@oxc-coverage-instrument/binding-linux-x64-musl": "0.2.14",
+    "@oxc-coverage-instrument/binding-win32-x64-msvc": "0.2.14",
+    "@oxc-coverage-instrument/binding-win32-arm64-msvc": "0.2.14"
   }
 }

package/vitest.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Creates an instrumenter that implements the istanbul-lib-instrument
+ * Instrumenter interface, backed by oxc-coverage-instrument.
+ *
+ * Use with Vitest's `coverage.instrumenter` option (requires vitest with
+ * custom instrumenter support):
+ *
+ * ```ts
+ * import { defineConfig } from 'vitest/config'
+ * import { createOxcInstrumenter } from 'oxc-coverage-instrument/vitest'
+ *
+ * export default defineConfig({
+ *   test: {
+ *     coverage: {
+ *       provider: 'istanbul',
+ *       instrumenter: () => createOxcInstrumenter(),
+ *     }
+ *   }
+ * })
+ * ```
+ */
+export declare function createOxcInstrumenter(options?: {
+  /** Name of the global coverage variable (default: "__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
+}): {
+  instrumentSync(code: string, filename: string, inputSourceMap?: any): string
+  lastSourceMap(): any
+  lastFileCoverage(): any
+}

package/vitest.js

@@ -0,0 +1,81 @@
+// 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: createOxcInstrumenter(),
+//       }
+//     }
+//   })
+
+const { instrument } = require('./index.js');
+
+/**
+ * Creates an instrumenter that implements the istanbul-lib-instrument
+ * Instrumenter interface, backed by oxc-coverage-instrument.
+ *
+ * @param {object} [options]
+ * @param {string} [options.coverageVariable='__coverage__']
+ * @param {string[]} [options.ignoreClassMethods=[]]
+ * @param {boolean} [options.reportLogic=false]
+ * @returns {Instrumenter}
+ */
+function createOxcInstrumenter(options = {}) {
+  const coverageVariable = options.coverageVariable || '__coverage__';
+  const ignoreClassMethods = options.ignoreClassMethods || [];
+  const reportLogic = options.reportLogic || false;
+
+  let _lastSourceMap = null;
+  let _lastFileCoverage = null;
+
+  return {
+    /**
+     * Instrument source code synchronously.
+     * @param {string} code - Source code to instrument.
+     * @param {string} filename - File path for coverage map.
+     * @param {object} [inputSourceMap] - Input source map from prior transform.
+     * @returns {string} Instrumented source code.
+     */
+    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;
+    },
+
+    /**
+     * Get the source map of the last instrumented file.
+     * @returns {object|null}
+     */
+    lastSourceMap() {
+      return _lastSourceMap;
+    },
+
+    /**
+     * Get the coverage object of the last instrumented file.
+     * @returns {object}
+     */
+    lastFileCoverage() {
+      return _lastFileCoverage;
+    },
+  };
+}
+
+module.exports = { createOxcInstrumenter };