modestbench 0.0.1

package/dist/core/engines/accurate-engine.cjs

@@ -0,0 +1,292 @@
+"use strict";
+/**
+ * AccurateEngine - High-accuracy benchmark execution implementation
+ *
+ * Concrete implementation of ModestBenchEngine using measurement techniques
+ * adapted from bench-node for improved accuracy. Uses V8 optimization guards
+ * and array-based sample collection with IQR outlier removal.
+ *
+ * **Requirements:**
+ *
+ * - Node.js >= 20
+ * - --allow-natives-syntax flag (for V8 optimization guards)
+ *
+ * **Key Features:**
+ *
+ * - V8NeverOptimize guards prevent JIT optimization artifacts
+ * - Adaptive iteration calculation based on operation duration
+ * - IQR-based outlier removal for improved stability
+ * - Comprehensive statistics (mean, stdDev, variance, CV, percentiles)
+ * - Full ModestBench feature support (progress, abort, filtering)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccurateEngine = void 0;
+const engine_js_1 = require("../engine.cjs");
+const stats_utils_js_1 = require("../stats-utils.cjs");
+/**
+ * AccurateEngine - High-accuracy benchmarking with V8 optimization guards
+ */
+class AccurateEngine extends engine_js_1.ModestBenchEngine {
+    /**
+     * Maximum iterations per round to prevent overwhelming Node.js test runner
+     * and excessive memory usage
+     */
+    static MAX_ITERATIONS_PER_ROUND = 10000;
+    hasCheckedNativeSyntax = false;
+    nativeSyntaxErrorShown = false;
+    nativeSyntaxSupported = false;
+    /**
+     * Execute a single benchmark task using accurate measurement techniques
+     *
+     * This is the main integration point with ModestBench's engine abstraction.
+     */
+    async executeBenchmarkTask(taskName, taskData, config, _reporters = [], signal) {
+        try {
+            if (!taskData.fn || typeof taskData.fn !== 'function') {
+                throw new Error('Benchmark task must have a "fn" function property');
+            }
+            // Check for V8 native syntax support
+            const useOptGuards = this.checkNativeSyntax();
+            // Show helpful error if native syntax not available
+            if (!useOptGuards && !this.nativeSyntaxErrorShown) {
+                if (!config.quiet) {
+                    console.warn('\n⚠️  AccurateEngine requires --allow-natives-syntax flag for best accuracy.', '\nRunning in fallback mode (reduced accuracy).', '\n\nTo enable V8 optimization guards:', '\n  node --allow-natives-syntax --test', '\n  or add to package.json: "test": "node --allow-natives-syntax ..."', '\n');
+                }
+                this.nativeSyntaxErrorShown = true;
+            }
+            // Execute benchmark with or without opt guards
+            const rawSamples = useOptGuards
+                ? await this.executeBenchmarkWithOptGuards(taskData.fn, config, signal)
+                : await this.executeBenchmarkBasic(taskData.fn, config, signal);
+            // Check if aborted
+            if (signal?.aborted) {
+                return {
+                    cv: 0,
+                    error: new Error('Benchmark aborted by user signal'),
+                    iterations: rawSamples.length,
+                    marginOfError: 0,
+                    max: 0,
+                    mean: 0,
+                    metadata: taskData.metadata ?? {},
+                    min: 0,
+                    name: taskName,
+                    opsPerSecond: 0,
+                    p95: 0,
+                    p99: 0,
+                    stdDev: 0,
+                    ...(taskData.tags ? { tags: taskData.tags } : {}),
+                    variance: 0,
+                };
+            }
+            // Remove outliers using IQR method
+            const samples = (0, stats_utils_js_1.removeOutliersIQR)(rawSamples);
+            // Calculate statistics
+            const stats = (0, stats_utils_js_1.calculateStatistics)(samples);
+            // Transform to TaskResult
+            const taskResult = {
+                cv: stats.cv,
+                iterations: samples.length,
+                marginOfError: stats.marginOfError,
+                max: stats.max,
+                mean: stats.mean, // nanoseconds
+                metadata: taskData.metadata ?? {},
+                min: stats.min,
+                name: taskName,
+                opsPerSecond: 1e9 / stats.mean, // Convert ns to ops/sec
+                p95: stats.p95,
+                p99: stats.p99,
+                stdDev: stats.stdDev,
+                variance: stats.variance,
+                ...(taskData.tags ? { tags: taskData.tags } : {}),
+            };
+            return taskResult;
+        }
+        catch (error) {
+            const executionError = error instanceof Error ? error : new Error(String(error));
+            const errorResult = {
+                cv: 0,
+                error: executionError,
+                iterations: 0,
+                marginOfError: 0,
+                max: 0,
+                mean: 0,
+                metadata: taskData.metadata ?? {},
+                min: 0,
+                name: taskName,
+                opsPerSecond: 0,
+                p95: 0,
+                p99: 0,
+                stdDev: 0,
+                ...(taskData.tags ? { tags: taskData.tags } : {}),
+                variance: 0,
+            };
+            return errorResult;
+        }
+    }
+    /**
+     * Calculate initial iterations based on benchmark characteristics Adapted
+     * from bench-node's getInitialIterations algorithm
+     */
+    async calculateInitialIterations(fn, targetTime) {
+        // eslint-disable-next-line @typescript-eslint/unbound-method
+        const timer = process.hrtime.bigint;
+        const MIN_RESOLUTION = 0.5; // nanoseconds
+        const SCALE = 1e9; // ns to seconds
+        // Run a quick test with 30 iterations
+        const testIterations = 30;
+        const start = timer();
+        for (let i = 0; i < testIterations; i++) {
+            fn();
+        }
+        const duration = Number(timer() - start);
+        const durationPerOp = Math.max(MIN_RESOLUTION, duration / testIterations);
+        // Calculate how many iterations we need for targetTime
+        const totalOpsForTargetTime = targetTime / (durationPerOp / SCALE);
+        return Math.min(Number.MAX_SAFE_INTEGER, Math.max(1, Math.round(totalOpsForTargetTime)));
+    }
+    /**
+     * Check if V8 native syntax is available
+     */
+    checkNativeSyntax() {
+        if (this.hasCheckedNativeSyntax) {
+            return this.nativeSyntaxSupported;
+        }
+        try {
+            // Try to use a V8 intrinsic - this is the definitive test
+            // Must create AND execute the function to test if syntax is available
+            // SAFETY: This string is hardcoded and never influenced by user input.
+            // We use new Function() specifically to test V8 intrinsics support.
+            // eslint-disable-next-line @typescript-eslint/no-implied-eval, @typescript-eslint/no-unsafe-call
+            new Function('%NeverOptimizeFunction(() => {})')();
+            this.nativeSyntaxSupported = true;
+        }
+        catch {
+            this.nativeSyntaxSupported = false;
+        }
+        this.hasCheckedNativeSyntax = true;
+        return this.nativeSyntaxSupported;
+    }
+    /**
+     * Execute benchmark WITHOUT V8 optimization guards (fallback)
+     */
+    async executeBenchmarkBasic(fn, config, signal) {
+        // eslint-disable-next-line @typescript-eslint/unbound-method
+        const timer = process.hrtime.bigint;
+        const samples = [];
+        const SCALE = 1e9;
+        const targetTime = config.time / 1000;
+        const initialIterations = await this.calculateInitialIterations(fn, targetTime);
+        if (config.warmup > 0) {
+            const warmupTime = Math.min(config.warmup / 1000, 0.05);
+            await this.runWarmup(fn, initialIterations, warmupTime);
+        }
+        const maxDuration = (config.time / 1000) * SCALE;
+        let timeSpent = 0;
+        let iterations = initialIterations;
+        while (timeSpent < maxDuration || samples.length < config.iterations) {
+            if (signal?.aborted) {
+                break;
+            }
+            const start = timer();
+            for (let i = 0; i < iterations; i++) {
+                fn();
+            }
+            const duration = Number(timer() - start);
+            const durationPerOp = duration / iterations;
+            samples.push(durationPerOp);
+            timeSpent += duration;
+            if (samples.length % 100 === 0) {
+                this.progressManager.forceUpdate();
+            }
+            const remainingTime = Math.max(0, (maxDuration - timeSpent) / SCALE);
+            iterations = Math.round(remainingTime / (durationPerOp / SCALE));
+            iterations = Math.max(1, Math.min(AccurateEngine.MAX_ITERATIONS_PER_ROUND, iterations));
+        }
+        return samples;
+    }
+    /**
+     * Execute benchmark WITH V8 optimization guards (more accurate)
+     */
+    async executeBenchmarkWithOptGuards(fn, config, signal) {
+        // eslint-disable-next-line @typescript-eslint/unbound-method
+        const timer = process.hrtime.bigint;
+        const samples = [];
+        const SCALE = 1e9;
+        // Calculate iterations based on config
+        const targetTime = config.time / 1000; // ms to seconds
+        const initialIterations = await this.calculateInitialIterations(fn, targetTime);
+        // Run warmup
+        if (config.warmup > 0) {
+            const warmupTime = Math.min(config.warmup / 1000, 0.05); // Max 50ms warmup
+            await this.runWarmup(fn, initialIterations, warmupTime);
+        }
+        // Create DoNotOptimize wrapper using V8 intrinsics
+        // This prevents V8 from optimizing away the benchmark code
+        // eslint-disable-next-line @typescript-eslint/no-implied-eval
+        const DoNotOptimize = new Function('x', 'return x');
+        // eslint-disable-next-line @typescript-eslint/no-implied-eval
+        const NeverOptimize = new Function('fn', '%NeverOptimizeFunction(fn); return fn;');
+        // eslint-disable-next-line new-cap, @typescript-eslint/no-unsafe-call
+        const guardedDoNotOptimize = NeverOptimize(DoNotOptimize);
+        const maxDuration = (config.time / 1000) * SCALE;
+        let timeSpent = 0;
+        let iterations = initialIterations;
+        // Main benchmark loop
+        while (timeSpent < maxDuration || samples.length < config.iterations) {
+            if (signal?.aborted) {
+                break;
+            }
+            const start = timer();
+            for (let i = 0; i < iterations; i++) {
+                const result = fn();
+                guardedDoNotOptimize(result); // Prevent optimization
+            }
+            const duration = Number(timer() - start);
+            const durationPerOp = duration / iterations;
+            samples.push(durationPerOp);
+            timeSpent += duration;
+            // Update progress every 100 samples
+            if (samples.length % 100 === 0) {
+                this.progressManager.forceUpdate();
+            }
+            // Adjust iterations for next round
+            const remainingTime = Math.max(0, (maxDuration - timeSpent) / SCALE);
+            iterations = Math.round(remainingTime / (durationPerOp / SCALE));
+            iterations = Math.max(1, Math.min(AccurateEngine.MAX_ITERATIONS_PER_ROUND, iterations));
+        }
+        return samples;
+    }
+    /**
+     * Run warmup phase Adapted from bench-node's runWarmup algorithm
+     */
+    async runWarmup(
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+    fn, initialIterations, warmupTime) {
+        // eslint-disable-next-line @typescript-eslint/unbound-method
+        const timer = process.hrtime.bigint;
+        const MIN_RESOLUTION = 0.5;
+        const SCALE = 1e9;
+        const maxDuration = warmupTime * SCALE;
+        const minSamples = 10;
+        let timeSpent = 0n;
+        let samples = 0;
+        let iterations = Math.min(initialIterations, AccurateEngine.MAX_ITERATIONS_PER_ROUND);
+        while (Number(timeSpent) < maxDuration || samples <= minSamples) {
+            const start = timer();
+            for (let i = 0; i < iterations; i++) {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+                fn();
+            }
+            const duration = timer() - start;
+            timeSpent += duration;
+            samples++;
+            // Adjust iterations for next round
+            const durationPerOp = Math.max(MIN_RESOLUTION, Number(duration) / iterations);
+            const remainingTime = Math.max(0, (maxDuration - Number(timeSpent)) / SCALE);
+            iterations = Math.round(remainingTime / (durationPerOp / SCALE));
+            iterations = Math.max(1, Math.min(AccurateEngine.MAX_ITERATIONS_PER_ROUND, iterations));
+        }
+    }
+}
+exports.AccurateEngine = AccurateEngine;
+//# sourceMappingURL=accurate-engine.js.map

package/dist/core/engines/accurate-engine.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"accurate-engine.js","sourceRoot":"","sources":["../../../src/core/engines/accurate-engine.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AASH,6CAAiD;AACjD,uDAA2E;AAE3E;;GAEG;AACH,MAAa,cAAe,SAAQ,6BAAiB;IACnD;;;OAGG;IACK,MAAM,CAAU,wBAAwB,GAAG,KAAK,CAAC;IAEjD,sBAAsB,GAAG,KAAK,CAAC;IAE/B,sBAAsB,GAAG,KAAK,CAAC;IAE/B,qBAAqB,GAAG,KAAK,CAAC;IAEtC;;;;OAIG;IACO,KAAK,CAAC,oBAAoB,CAClC,QAAgB,EAChB,QAAuB,EACvB,MAAyB,EACzB,aAAyB,EAAE,EAC3B,MAAoB;QAEpB,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,OAAO,QAAQ,CAAC,EAAE,KAAK,UAAU,EAAE,CAAC;gBACtD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;YACvE,CAAC;YAED,qCAAqC;YACrC,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAE9C,oDAAoD;YACpD,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC;gBAClD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;oBAClB,OAAO,CAAC,IAAI,CACV,8EAA8E,EAC9E,gDAAgD,EAChD,uCAAuC,EACvC,wCAAwC,EACxC,uEAAuE,EACvE,IAAI,CACL,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC;YACrC,CAAC;YAED,+CAA+C;YAC/C,MAAM,UAAU,GAAG,YAAY;gBAC7B,CAAC,CAAC,MAAM,IAAI,CAAC,6BAA6B,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC;gBACvE,CAAC,CAAC,MAAM,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAElE,mBAAmB;YACnB,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,OAAO;oBACL,EAAE,EAAE,CAAC;oBACL,KAAK,EAAE,IAAI,KAAK,CAAC,kCAAkC,CAAC;oBACpD,UAAU,EAAE,UAAU,CAAC,MAAM;oBAC7B,aAAa,EAAE,CAAC;oBAChB,GAAG,EAAE,CAAC;oBACN,IAAI,EAAE,CAAC;oBACP,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,EAAE;oBACjC,GAAG,EAAE,CAAC;oBACN,IAAI,EAAE,QAAQ;oBACd,YAAY,EAAE,CAAC;oBACf,GAAG,EAAE,CAAC;oBACN,GAAG,EAAE,CAAC;oBACN,MAAM,EAAE,CAAC;oBACT,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACjD,QAAQ,EAAE,CAAC;iBACZ,CAAC;YACJ,CAAC;YAED,mCAAmC;YACnC,MAAM,OAAO,GAAG,IAAA,kCAAiB,EAAC,UAAU,CAAC,CAAC;YAE9C,uBAAuB;YACvB,MAAM,KAAK,GAAG,IAAA,oCAAmB,EAAC,OAAO,CAAC,CAAC;YAE3C,0BAA0B;YAC1B,MAAM,UAAU,GAAe;gBAC7B,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,UAAU,EAAE,OAAO,CAAC,MAAM;gBAC1B,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,cAAc;gBAChC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,EAAE;gBACjC,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,IAAI,EAAE,QAAQ;gBACd,YAAY,EAAE,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,wBAAwB;gBACxD,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClD,CAAC;YAEF,OAAO,UAAU,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,cAAc,GAClB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAE5D,MAAM,WAAW,GAAe;gBAC9B,EAAE,EAAE,CAAC;gBACL,KAAK,EAAE,cAAc;gBACrB,UAAU,EAAE,CAAC;gBACb,aAAa,EAAE,CAAC;gBAChB,GAAG,EAAE,CAAC;gBACN,IAAI,EAAE,CAAC;gBACP,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,EAAE;gBACjC,GAAG,EAAE,CAAC;gBACN,IAAI,EAAE,QAAQ;gBACd,YAAY,EAAE,CAAC;gBACf,GAAG,EAAE,CAAC;gBACN,GAAG,EAAE,CAAC;gBACN,MAAM,EAAE,CAAC;gBACT,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,QAAQ,EAAE,CAAC;aACZ,CAAC;YACF,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,0BAA0B,CACtC,EAAmC,EACnC,UAAkB;QAElB,6DAA6D;QAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;QACpC,MAAM,cAAc,GAAG,GAAG,CAAC,CAAC,cAAc;QAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,gBAAgB;QAEnC,sCAAsC;QACtC,MAAM,cAAc,GAAG,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,KAAK,EAAE,CAAC;QAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,EAAE,EAAE,CAAC;QACP,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC;QACzC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,QAAQ,GAAG,cAAc,CAAC,CAAC;QAE1E,uDAAuD;QACvD,MAAM,qBAAqB,GAAG,UAAU,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC,CAAC;QAEnE,OAAO,IAAI,CAAC,GAAG,CACb,MAAM,CAAC,gBAAgB,EACvB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAC/C,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,iBAAiB;QACvB,IAAI,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,qBAAqB,CAAC;QACpC,CAAC;QAED,IAAI,CAAC;YACH,0DAA0D;YAC1D,sEAAsE;YAEtE,uEAAuE;YACvE,oEAAoE;YACpE,iGAAiG;YACjG,IAAI,QAAQ,CAAC,kCAAkC,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,qBAAqB,GAAG,KAAK,CAAC;QACrC,CAAC;QAED,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC;QACnC,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACpC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB,CACjC,EAAmC,EACnC,MAAyB,EACzB,MAAoB;QAEpB,6DAA6D;QAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;QACpC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,GAAG,CAAC;QAElB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACtC,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAC7D,EAAE,EACF,UAAU,CACX,CAAC;QAEF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;YACxD,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,iBAAiB,EAAE,UAAU,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;QACjD,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,UAAU,GAAG,iBAAiB,CAAC;QAEnC,OAAO,SAAS,GAAG,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;YACrE,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM;YACR,CAAC;YAED,MAAM,KAAK,GAAG,KAAK,EAAE,CAAC;YAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpC,EAAE,EAAE,CAAC;YACP,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC;YACzC,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;YAE5C,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC5B,SAAS,IAAI,QAAQ,CAAC;YAEtB,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC;YACrC,CAAC;YAED,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC;YACrE,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC;YACjE,UAAU,GAAG,IAAI,CAAC,GAAG,CACnB,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,wBAAwB,EAAE,UAAU,CAAC,CAC9D,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,6BAA6B,CACzC,EAAmC,EACnC,MAAyB,EACzB,MAAoB;QAEpB,6DAA6D;QAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;QACpC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,GAAG,CAAC;QAElB,uCAAuC;QACvC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,gBAAgB;QACvD,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAC7D,EAAE,EACF,UAAU,CACX,CAAC;QAEF,aAAa;QACb,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,kBAAkB;YAC3E,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,iBAAiB,EAAE,UAAU,CAAC,CAAC;QAC1D,CAAC;QAED,mDAAmD;QACnD,2DAA2D;QAC3D,8DAA8D;QAC9D,MAAM,aAAa,GAAG,IAAI,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACpD,8DAA8D;QAC9D,MAAM,aAAa,GAAG,IAAI,QAAQ,CAChC,IAAI,EACJ,wCAAwC,CACzC,CAAC;QACF,sEAAsE;QACtE,MAAM,oBAAoB,GAAG,aAAa,CAAC,aAAa,CAE5C,CAAC;QAEb,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;QACjD,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,UAAU,GAAG,iBAAiB,CAAC;QAEnC,sBAAsB;QACtB,OAAO,SAAS,GAAG,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;YACrE,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM;YACR,CAAC;YAED,MAAM,KAAK,GAAG,KAAK,EAAE,CAAC;YAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpC,MAAM,MAAM,GAAG,EAAE,EAAE,CAAC;gBACpB,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,uBAAuB;YACvD,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC;YACzC,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;YAE5C,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC5B,SAAS,IAAI,QAAQ,CAAC;YAEtB,oCAAoC;YACpC,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC;YACrC,CAAC;YAED,mCAAmC;YACnC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC;YACrE,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC;YACjE,UAAU,GAAG,IAAI,CAAC,GAAG,CACnB,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,wBAAwB,EAAE,UAAU,CAAC,CAC9D,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,SAAS;IACrB,sEAAsE;IACtE,EAAY,EACZ,iBAAyB,EACzB,UAAkB;QAElB,6DAA6D;QAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;QACpC,MAAM,cAAc,GAAG,GAAG,CAAC;QAC3B,MAAM,KAAK,GAAG,GAAG,CAAC;QAClB,MAAM,WAAW,GAAG,UAAU,GAAG,KAAK,CAAC;QACvC,MAAM,UAAU,GAAG,EAAE,CAAC;QAEtB,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,UAAU,GAAG,IAAI,CAAC,GAAG,CACvB,iBAAiB,EACjB,cAAc,CAAC,wBAAwB,CACxC,CAAC;QAEF,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,WAAW,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;YAChE,MAAM,KAAK,GAAG,KAAK,EAAE,CAAC;YAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpC,6DAA6D;gBAC7D,EAAE,EAAE,CAAC;YACP,CAAC;YAED,MAAM,QAAQ,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;YACjC,SAAS,IAAI,QAAQ,CAAC;YACtB,OAAO,EAAE,CAAC;YAEV,mCAAmC;YACnC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAC5B,cAAc,EACd,MAAM,CAAC,QAAQ,CAAC,GAAG,UAAU,CAC9B,CAAC;YACF,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAC5B,CAAC,EACD,CAAC,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,KAAK,CAC1C,CAAC;YACF,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC;YACjE,UAAU,GAAG,IAAI,CAAC,GAAG,CACnB,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,wBAAwB,EAAE,UAAU,CAAC,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC;;AApXH,wCAqXC"}

package/dist/core/engines/accurate-engine.d.cts

@@ -0,0 +1,63 @@
+/**
+ * AccurateEngine - High-accuracy benchmark execution implementation
+ *
+ * Concrete implementation of ModestBenchEngine using measurement techniques
+ * adapted from bench-node for improved accuracy. Uses V8 optimization guards
+ * and array-based sample collection with IQR outlier removal.
+ *
+ * **Requirements:**
+ *
+ * - Node.js >= 20
+ * - --allow-natives-syntax flag (for V8 optimization guards)
+ *
+ * **Key Features:**
+ *
+ * - V8NeverOptimize guards prevent JIT optimization artifacts
+ * - Adaptive iteration calculation based on operation duration
+ * - IQR-based outlier removal for improved stability
+ * - Comprehensive statistics (mean, stdDev, variance, CV, percentiles)
+ * - Full ModestBench feature support (progress, abort, filtering)
+ */
+import type { BenchmarkTask, ModestBenchConfig, Reporter, TaskResult } from "../../types/index.cjs";
+import { ModestBenchEngine } from "../engine.cjs";
+/**
+ * AccurateEngine - High-accuracy benchmarking with V8 optimization guards
+ */
+export declare class AccurateEngine extends ModestBenchEngine {
+    /**
+     * Maximum iterations per round to prevent overwhelming Node.js test runner
+     * and excessive memory usage
+     */
+    private static readonly MAX_ITERATIONS_PER_ROUND;
+    private hasCheckedNativeSyntax;
+    private nativeSyntaxErrorShown;
+    private nativeSyntaxSupported;
+    /**
+     * Execute a single benchmark task using accurate measurement techniques
+     *
+     * This is the main integration point with ModestBench's engine abstraction.
+     */
+    protected executeBenchmarkTask(taskName: string, taskData: BenchmarkTask, config: ModestBenchConfig, _reporters?: Reporter[], signal?: AbortSignal): Promise<TaskResult>;
+    /**
+     * Calculate initial iterations based on benchmark characteristics Adapted
+     * from bench-node's getInitialIterations algorithm
+     */
+    private calculateInitialIterations;
+    /**
+     * Check if V8 native syntax is available
+     */
+    private checkNativeSyntax;
+    /**
+     * Execute benchmark WITHOUT V8 optimization guards (fallback)
+     */
+    private executeBenchmarkBasic;
+    /**
+     * Execute benchmark WITH V8 optimization guards (more accurate)
+     */
+    private executeBenchmarkWithOptGuards;
+    /**
+     * Run warmup phase Adapted from bench-node's runWarmup algorithm
+     */
+    private runWarmup;
+}
+//# sourceMappingURL=accurate-engine.d.ts.map

package/dist/core/engines/accurate-engine.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accurate-engine.d.ts","sourceRoot":"","sources":["../../../src/core/engines/accurate-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,UAAU,EACX,8BAA6B;AAE9B,OAAO,EAAE,iBAAiB,EAAE,sBAAqB;AAGjD;;GAEG;AACH,qBAAa,cAAe,SAAQ,iBAAiB;IACnD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAS;IAEzD,OAAO,CAAC,sBAAsB,CAAS;IAEvC,OAAO,CAAC,sBAAsB,CAAS;IAEvC,OAAO,CAAC,qBAAqB,CAAS;IAEtC;;;;OAIG;cACa,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,iBAAiB,EACzB,UAAU,GAAE,QAAQ,EAAO,EAC3B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC;IAoGtB;;;OAGG;YACW,0BAA0B;IA6BxC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;OAEG;YACW,qBAAqB;IAyDnC;;OAEG;YACW,6BAA6B;IA6E3C;;OAEG;YACW,SAAS;CAgDxB"}

package/dist/core/engines/accurate-engine.d.ts

@@ -0,0 +1,63 @@
+/**
+ * AccurateEngine - High-accuracy benchmark execution implementation
+ *
+ * Concrete implementation of ModestBenchEngine using measurement techniques
+ * adapted from bench-node for improved accuracy. Uses V8 optimization guards
+ * and array-based sample collection with IQR outlier removal.
+ *
+ * **Requirements:**
+ *
+ * - Node.js >= 20
+ * - --allow-natives-syntax flag (for V8 optimization guards)
+ *
+ * **Key Features:**
+ *
+ * - V8NeverOptimize guards prevent JIT optimization artifacts
+ * - Adaptive iteration calculation based on operation duration
+ * - IQR-based outlier removal for improved stability
+ * - Comprehensive statistics (mean, stdDev, variance, CV, percentiles)
+ * - Full ModestBench feature support (progress, abort, filtering)
+ */
+import type { BenchmarkTask, ModestBenchConfig, Reporter, TaskResult } from "../../types/index.js";
+import { ModestBenchEngine } from "../engine.js";
+/**
+ * AccurateEngine - High-accuracy benchmarking with V8 optimization guards
+ */
+export declare class AccurateEngine extends ModestBenchEngine {
+    /**
+     * Maximum iterations per round to prevent overwhelming Node.js test runner
+     * and excessive memory usage
+     */
+    private static readonly MAX_ITERATIONS_PER_ROUND;
+    private hasCheckedNativeSyntax;
+    private nativeSyntaxErrorShown;
+    private nativeSyntaxSupported;
+    /**
+     * Execute a single benchmark task using accurate measurement techniques
+     *
+     * This is the main integration point with ModestBench's engine abstraction.
+     */
+    protected executeBenchmarkTask(taskName: string, taskData: BenchmarkTask, config: ModestBenchConfig, _reporters?: Reporter[], signal?: AbortSignal): Promise<TaskResult>;
+    /**
+     * Calculate initial iterations based on benchmark characteristics Adapted
+     * from bench-node's getInitialIterations algorithm
+     */
+    private calculateInitialIterations;
+    /**
+     * Check if V8 native syntax is available
+     */
+    private checkNativeSyntax;
+    /**
+     * Execute benchmark WITHOUT V8 optimization guards (fallback)
+     */
+    private executeBenchmarkBasic;
+    /**
+     * Execute benchmark WITH V8 optimization guards (more accurate)
+     */
+    private executeBenchmarkWithOptGuards;
+    /**
+     * Run warmup phase Adapted from bench-node's runWarmup algorithm
+     */
+    private runWarmup;
+}
+//# sourceMappingURL=accurate-engine.d.ts.map

package/dist/core/engines/accurate-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accurate-engine.d.ts","sourceRoot":"","sources":["../../../src/core/engines/accurate-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,UAAU,EACX,6BAA6B;AAE9B,OAAO,EAAE,iBAAiB,EAAE,qBAAqB;AAGjD;;GAEG;AACH,qBAAa,cAAe,SAAQ,iBAAiB;IACnD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAS;IAEzD,OAAO,CAAC,sBAAsB,CAAS;IAEvC,OAAO,CAAC,sBAAsB,CAAS;IAEvC,OAAO,CAAC,qBAAqB,CAAS;IAEtC;;;;OAIG;cACa,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,iBAAiB,EACzB,UAAU,GAAE,QAAQ,EAAO,EAC3B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC;IAoGtB;;;OAGG;YACW,0BAA0B;IA6BxC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;OAEG;YACW,qBAAqB;IAyDnC;;OAEG;YACW,6BAA6B;IA6E3C;;OAEG;YACW,SAAS;CAgDxB"}