modestbench 0.0.1

package/dist/core/loader.d.ts

@@ -0,0 +1,55 @@
+/**
+ * ModestBench File Loader
+ *
+ * Handles discovery, loading, and validation of benchmark files. Supports glob
+ * pattern matching and file structure validation.
+ */
+import type { BenchmarkFile, FileLoader, ValidationResult } from "../types/index.js";
+/**
+ * File change notification for watch functionality
+ */
+interface FileChange {
+    readonly filePath: string;
+    readonly timestamp: Date;
+    readonly type: 'added' | 'deleted' | 'modified';
+}
+/**
+ * File watcher interface
+ */
+interface FileWatcher {
+    close(): void;
+}
+/**
+ * Implementation of FileLoader for benchmark files
+ */
+export declare class BenchmarkFileLoader implements FileLoader {
+    private readonly supportedExtensions;
+    /**
+     * Discover benchmark files using glob patterns or explicit file paths
+     */
+    discover(pattern: string | string[], exclude?: string[]): Promise<string[]>;
+    /**
+     * Load a single benchmark file
+     */
+    load(filePath: string): Promise<BenchmarkFile>;
+    /**
+     * Load multiple files in parallel
+     */
+    loadAll(filePaths: string[]): Promise<BenchmarkFile[]>;
+    /**
+     * Validate benchmark file (basic checks only - file existence and extension)
+     * Structure validation happens after loading in the load() method
+     */
+    validate(filePath: string): Promise<ValidationResult>;
+    /**
+     * Watch for file changes (placeholder implementation)
+     */
+    watch(_pattern: string, _callback: (changes: FileChange[]) => void): FileWatcher;
+    /**
+     * Validate the structure of loaded exports using Zod schema Returns the
+     * transformed/normalized data if validation succeeds
+     */
+    private validateExports;
+}
+export {};
+//# sourceMappingURL=loader.d.ts.map

package/dist/core/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/core/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAEV,aAAa,EACb,UAAU,EAEV,gBAAgB,EAEjB,0BAA0B;AAQ3B;;GAEG;AACH,UAAU,UAAU;IAClB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;CACjD;AAED;;GAEG;AACH,UAAU,WAAW;IACnB,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,mBAAoB,YAAW,UAAU;IACpD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA6B;IAEjE;;OAEG;IACG,QAAQ,CACZ,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAC1B,OAAO,GAAE,MAAM,EAAO,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC;IA4DpB;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA4EpD;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAW5D;;;OAGG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoD3D;;OAEG;IACH,KAAK,CACH,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,IAAI,GACzC,WAAW;IAUd;;;OAGG;IACH,OAAO,CAAC,eAAe;CAwCxB"}

package/dist/core/loader.js

@@ -0,0 +1,250 @@
+/**
+ * ModestBench File Loader
+ *
+ * Handles discovery, loading, and validation of benchmark files. Supports glob
+ * pattern matching and file structure validation.
+ */
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { glob } from 'glob';
+import { access, readFile, stat } from 'node:fs/promises';
+import { extname } from 'node:path';
+import { BENCHMARK_FILE_EXTENSIONS, BENCHMARK_FILE_PATTERN, } from "../constants.js";
+import { benchmarkFileSchema } from "./benchmark-schema.js";
+/**
+ * Implementation of FileLoader for benchmark files
+ */
+export class BenchmarkFileLoader {
+    supportedExtensions = BENCHMARK_FILE_EXTENSIONS;
+    /**
+     * Discover benchmark files using glob patterns or explicit file paths
+     */
+    async discover(pattern, exclude = []) {
+        try {
+            let patterns = Array.isArray(pattern) ? pattern : [pattern];
+            // Handle empty patterns - use sensible defaults
+            if (patterns.length === 0) {
+                patterns = [
+                    `*${BENCHMARK_FILE_PATTERN}`, // top-level current directory
+                    `bench/*${BENCHMARK_FILE_PATTERN}`, // top-level bench/ directory
+                ];
+            }
+            // Expand directory paths to recursive glob patterns
+            const expandedPatterns = [];
+            for (const p of patterns) {
+                try {
+                    const stats = await stat(p);
+                    if (stats.isDirectory()) {
+                        // Directory: search recursively
+                        expandedPatterns.push(`${p}/**/*${BENCHMARK_FILE_PATTERN}`);
+                    }
+                    else {
+                        // File or doesn't exist: use as-is (glob will handle it)
+                        expandedPatterns.push(p);
+                    }
+                }
+                catch {
+                    // Path doesn't exist, treat as glob pattern
+                    expandedPatterns.push(p);
+                }
+            }
+            const allFiles = new Set();
+            // Process each pattern
+            for (const p of expandedPatterns) {
+                const files = await glob(p, {
+                    absolute: true,
+                    ignore: exclude,
+                    nodir: true,
+                });
+                // Add discovered files to the set (automatic deduplication)
+                for (const file of files) {
+                    allFiles.add(file);
+                }
+            }
+            // Filter to supported file extensions
+            const supportedFiles = Array.from(allFiles).filter((file) => {
+                const ext = extname(file);
+                return this.supportedExtensions.has(ext);
+            });
+            return supportedFiles.sort();
+        }
+        catch (error) {
+            throw new Error(`File discovery failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Load a single benchmark file
+     */
+    async load(filePath) {
+        try {
+            // Basic file checks (existence, extension)
+            const basicValidation = await this.validate(filePath);
+            if (!basicValidation.valid) {
+                throw new Error(`Invalid benchmark file: ${basicValidation.errors.map((e) => e.message).join(', ')}`);
+            }
+            // Read file content
+            const content = await readFile(filePath, 'utf-8');
+            // Get file stats for metadata
+            const stats = await stat(filePath);
+            // Load the module using dynamic import
+            const ext = extname(filePath);
+            let module;
+            if (ext === '.ts' || ext === '.mts' || ext === '.cts') {
+                // For TypeScript files, use cosmiconfig-typescript-loader
+                const { TypeScriptLoader: createTypeScriptLoader } = await import('cosmiconfig-typescript-loader');
+                const loader = createTypeScriptLoader();
+                module = (await loader(filePath, content));
+            }
+            else {
+                // Use native dynamic import for JavaScript files with cache busting
+                // Add timestamp to prevent module caching issues across multiple loads
+                const timestamp = Date.now();
+                module = (await import(__rewriteRelativeImportExtension(`${filePath}?t=${timestamp}`)));
+            }
+            const exports = module.default || module;
+            // Validate the loaded exports structure with Zod
+            const structureValidation = this.validateExports(filePath, exports);
+            if (!structureValidation.valid || !structureValidation.data) {
+                throw new Error(`Invalid benchmark structure: ${structureValidation.errors.map((e) => e.message).join(', ')}`);
+            }
+            // Use the transformed/normalized data from Zod
+            // (this ensures shorthand functions are properly wrapped)
+            const normalizedExports = structureValidation.data;
+            // Analyze exports for metadata (simplified - structure already validated)
+            const hasDefaultExport = module.default !== undefined;
+            const exportNames = Object.keys(module);
+            return {
+                content,
+                exports: normalizedExports,
+                filePath,
+                metadata: {
+                    exportNames,
+                    hasDefaultExport,
+                    mtime: stats.mtime,
+                    size: stats.size,
+                },
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to load file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Load multiple files in parallel
+     */
+    async loadAll(filePaths) {
+        try {
+            const loadPromises = filePaths.map((filePath) => this.load(filePath));
+            return await Promise.all(loadPromises);
+        }
+        catch (error) {
+            throw new Error(`Failed to load files: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Validate benchmark file (basic checks only - file existence and extension)
+     * Structure validation happens after loading in the load() method
+     */
+    async validate(filePath) {
+        const errors = [];
+        const warnings = [];
+        try {
+            // Check file existence
+            try {
+                await access(filePath);
+            }
+            catch {
+                errors.push({
+                    code: 'FILE_NOT_FOUND',
+                    file: filePath,
+                    message: 'File does not exist',
+                    severity: 'error',
+                });
+                return { errors, files: [], valid: false, warnings };
+            }
+            // Check file extension
+            const ext = extname(filePath);
+            if (!this.supportedExtensions.has(ext)) {
+                errors.push({
+                    code: 'UNSUPPORTED_EXTENSION',
+                    file: filePath,
+                    message: `Unsupported file extension: ${ext}. Supported extensions: ${Array.from(this.supportedExtensions).join(', ')}`,
+                    severity: 'error',
+                });
+            }
+            return {
+                errors,
+                files: [filePath],
+                valid: errors.length === 0,
+                warnings,
+            };
+        }
+        catch (error) {
+            errors.push({
+                code: 'VALIDATION_ERROR',
+                file: filePath,
+                message: `Validation failed: ${error instanceof Error ? error.message : String(error)}`,
+                severity: 'error',
+            });
+            return {
+                errors,
+                files: [filePath],
+                valid: false,
+                warnings,
+            };
+        }
+    }
+    /**
+     * Watch for file changes (placeholder implementation)
+     */
+    watch(_pattern, _callback) {
+        // TODO: Implement file watching with chokidar or similar
+        // For now, return a no-op watcher
+        return {
+            close() {
+                // No-op
+            },
+        };
+    }
+    /**
+     * Validate the structure of loaded exports using Zod schema Returns the
+     * transformed/normalized data if validation succeeds
+     */
+    validateExports(filePath, exports) {
+        const errors = [];
+        const warnings = [];
+        try {
+            const result = benchmarkFileSchema.safeParse(exports);
+            if (!result.success) {
+                for (const issue of result.error.issues) {
+                    const path = issue.path.length > 0 ? `${issue.path.join('.')}: ` : '';
+                    errors.push({
+                        code: 'INVALID_STRUCTURE',
+                        file: filePath,
+                        message: `${path}${issue.message}`,
+                        severity: 'error',
+                    });
+                }
+                return { errors, valid: false, warnings };
+            }
+            // Return the transformed data (with shorthand functions normalized)
+            return { data: result.data, errors, valid: true, warnings };
+        }
+        catch (error) {
+            errors.push({
+                code: 'VALIDATION_ERROR',
+                file: filePath,
+                message: `Structure validation failed: ${error instanceof Error ? error.message : String(error)}`,
+                severity: 'error',
+            });
+            return { errors, valid: false, warnings };
+        }
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/core/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/core/loader.ts"],"names":[],"mappings":"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"}

package/dist/core/stats-utils.cjs

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * Statistical utility functions for benchmark result analysis
+ *
+ * Provides IQR-based outlier removal and comprehensive statistics calculation
+ * adapted from bench-node's StatisticalHistogram.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeOutliersIQR = exports.calculateStatistics = void 0;
+/**
+ * Calculate comprehensive statistics from samples
+ *
+ * Adapted from bench-node's StatisticalHistogram. Assumes samples are already
+ * sorted (e.g., from removeOutliersIQR output).
+ *
+ * @param samples - Sample values (should be sorted for accurate percentiles)
+ * @returns Computed statistics
+ */
+const calculateStatistics = (samples) => {
+    if (samples.length === 0) {
+        return {
+            cv: 0,
+            marginOfError: 0,
+            max: 0,
+            mean: 0,
+            min: 0,
+            p95: 0,
+            p99: 0,
+            stdDev: 0,
+            variance: 0,
+        };
+    }
+    // Min/Max (samples are already sorted from removeOutliersIQR)
+    const min = samples[0];
+    const max = samples[samples.length - 1];
+    // Mean
+    const mean = samples.length === 1
+        ? samples[0]
+        : samples.reduce((acc, v) => Math.min(Number.MAX_SAFE_INTEGER, acc + v), 0) / samples.length;
+    // Standard deviation and variance
+    let stdDev = 0;
+    let variance = 0;
+    if (samples.length >= 2) {
+        variance =
+            samples.reduce((acc, v) => acc + Math.pow(v - mean, 2), 0) /
+                (samples.length - 1);
+        stdDev = Math.sqrt(variance);
+    }
+    // Coefficient of Variation
+    const cv = mean === 0 || samples.length < 2 ? 0 : (stdDev / mean) * 100;
+    // Margin of Error (95% confidence)
+    const Z = 1.96;
+    const marginOfError = samples.length === 0 ? 0 : (Z * stdDev) / Math.sqrt(samples.length);
+    // Percentiles (using standard formula: floor((n-1) * p))
+    const p95 = samples[Math.floor((samples.length - 1) * 0.95)] ?? 0;
+    const p99 = samples[Math.floor((samples.length - 1) * 0.99)] ?? 0;
+    return { cv, marginOfError, max, mean, min, p95, p99, stdDev, variance };
+};
+exports.calculateStatistics = calculateStatistics;
+/**
+ * Remove outliers using Interquartile Range (IQR) method
+ *
+ * Adapted from bench-node's StatisticalHistogram.removeOutliers. Filters values
+ * outside [Q1 - 1.5×IQR, Q3 + 1.5×IQR] range.
+ *
+ * @param samples - Raw sample values (will be sorted internally)
+ * @returns Filtered samples with outliers removed
+ */
+const removeOutliersIQR = (samples) => {
+    if (samples.length < 4) {
+        return samples;
+    }
+    const sorted = samples.slice().sort((a, b) => a - b);
+    // Calculate Q1 and Q3
+    let q1;
+    let q3;
+    const size = sorted.length;
+    if (((size - 1) / 4) % 1 === 0 || (size / 4) % 1 === 0) {
+        q1 =
+            (1 / 2) *
+                (sorted[Math.floor(size / 4) - 1] + sorted[Math.floor(size / 4)]);
+        q3 =
+            (1 / 2) *
+                (sorted[Math.ceil((size * 3) / 4) - 1] +
+                    sorted[Math.ceil((size * 3) / 4)]);
+    }
+    else {
+        q1 = sorted[Math.floor(size / 4)];
+        q3 = sorted[Math.floor((size * 3) / 4)];
+    }
+    // Calculate IQR and bounds
+    const iqr = q3 - q1;
+    const minValue = q1 - iqr * 1.5;
+    const maxValue = q3 + iqr * 1.5;
+    // Filter outliers
+    return sorted.filter((value) => value <= maxValue && value >= minValue);
+};
+exports.removeOutliersIQR = removeOutliersIQR;
+//# sourceMappingURL=stats-utils.js.map

package/dist/core/stats-utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-utils.js","sourceRoot":"","sources":["../../src/core/stats-utils.ts"],"names":[],"mappings":"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"}

package/dist/core/stats-utils.d.cts

@@ -0,0 +1,50 @@
+/**
+ * Statistical utility functions for benchmark result analysis
+ *
+ * Provides IQR-based outlier removal and comprehensive statistics calculation
+ * adapted from bench-node's StatisticalHistogram.
+ */
+/**
+ * Statistics computed from sample data
+ */
+export interface SampleStatistics {
+    /** Coefficient of variation (stdDev/mean × 100) */
+    readonly cv: number;
+    /** Margin of error at 95% confidence */
+    readonly marginOfError: number;
+    /** Maximum value */
+    readonly max: number;
+    /** Mean (average) value */
+    readonly mean: number;
+    /** Minimum value */
+    readonly min: number;
+    /** 95th percentile */
+    readonly p95: number;
+    /** 99th percentile */
+    readonly p99: number;
+    /** Standard deviation */
+    readonly stdDev: number;
+    /** Variance */
+    readonly variance: number;
+}
+/**
+ * Calculate comprehensive statistics from samples
+ *
+ * Adapted from bench-node's StatisticalHistogram. Assumes samples are already
+ * sorted (e.g., from removeOutliersIQR output).
+ *
+ * @param samples - Sample values (should be sorted for accurate percentiles)
+ * @returns Computed statistics
+ */
+export declare const calculateStatistics: (samples: number[]) => SampleStatistics;
+/**
+ * Remove outliers using Interquartile Range (IQR) method
+ *
+ * Adapted from bench-node's StatisticalHistogram.removeOutliers. Filters values
+ * outside [Q1 - 1.5×IQR, Q3 + 1.5×IQR] range.
+ *
+ * @param samples - Raw sample values (will be sorted internally)
+ * @returns Filtered samples with outliers removed
+ */
+export declare const removeOutliersIQR: (samples: number[]) => number[];
+//# sourceMappingURL=stats-utils.d.ts.map

package/dist/core/stats-utils.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-utils.d.ts","sourceRoot":"","sources":["../../src/core/stats-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,oBAAoB;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,eAAe;IACf,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,EAAE,KAAG,gBAmDvD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,EAAE,KAAG,MAAM,EAgC3D,CAAC"}

package/dist/core/stats-utils.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Statistical utility functions for benchmark result analysis
+ *
+ * Provides IQR-based outlier removal and comprehensive statistics calculation
+ * adapted from bench-node's StatisticalHistogram.
+ */
+/**
+ * Statistics computed from sample data
+ */
+export interface SampleStatistics {
+    /** Coefficient of variation (stdDev/mean × 100) */
+    readonly cv: number;
+    /** Margin of error at 95% confidence */
+    readonly marginOfError: number;
+    /** Maximum value */
+    readonly max: number;
+    /** Mean (average) value */
+    readonly mean: number;
+    /** Minimum value */
+    readonly min: number;
+    /** 95th percentile */
+    readonly p95: number;
+    /** 99th percentile */
+    readonly p99: number;
+    /** Standard deviation */
+    readonly stdDev: number;
+    /** Variance */
+    readonly variance: number;
+}
+/**
+ * Calculate comprehensive statistics from samples
+ *
+ * Adapted from bench-node's StatisticalHistogram. Assumes samples are already
+ * sorted (e.g., from removeOutliersIQR output).
+ *
+ * @param samples - Sample values (should be sorted for accurate percentiles)
+ * @returns Computed statistics
+ */
+export declare const calculateStatistics: (samples: number[]) => SampleStatistics;
+/**
+ * Remove outliers using Interquartile Range (IQR) method
+ *
+ * Adapted from bench-node's StatisticalHistogram.removeOutliers. Filters values
+ * outside [Q1 - 1.5×IQR, Q3 + 1.5×IQR] range.
+ *
+ * @param samples - Raw sample values (will be sorted internally)
+ * @returns Filtered samples with outliers removed
+ */
+export declare const removeOutliersIQR: (samples: number[]) => number[];
+//# sourceMappingURL=stats-utils.d.ts.map

package/dist/core/stats-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-utils.d.ts","sourceRoot":"","sources":["../../src/core/stats-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,oBAAoB;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,eAAe;IACf,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,EAAE,KAAG,gBAmDvD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,EAAE,KAAG,MAAM,EAgC3D,CAAC"}

package/dist/core/stats-utils.js

@@ -0,0 +1,94 @@
+/**
+ * Statistical utility functions for benchmark result analysis
+ *
+ * Provides IQR-based outlier removal and comprehensive statistics calculation
+ * adapted from bench-node's StatisticalHistogram.
+ */
+/**
+ * Calculate comprehensive statistics from samples
+ *
+ * Adapted from bench-node's StatisticalHistogram. Assumes samples are already
+ * sorted (e.g., from removeOutliersIQR output).
+ *
+ * @param samples - Sample values (should be sorted for accurate percentiles)
+ * @returns Computed statistics
+ */
+export const calculateStatistics = (samples) => {
+    if (samples.length === 0) {
+        return {
+            cv: 0,
+            marginOfError: 0,
+            max: 0,
+            mean: 0,
+            min: 0,
+            p95: 0,
+            p99: 0,
+            stdDev: 0,
+            variance: 0,
+        };
+    }
+    // Min/Max (samples are already sorted from removeOutliersIQR)
+    const min = samples[0];
+    const max = samples[samples.length - 1];
+    // Mean
+    const mean = samples.length === 1
+        ? samples[0]
+        : samples.reduce((acc, v) => Math.min(Number.MAX_SAFE_INTEGER, acc + v), 0) / samples.length;
+    // Standard deviation and variance
+    let stdDev = 0;
+    let variance = 0;
+    if (samples.length >= 2) {
+        variance =
+            samples.reduce((acc, v) => acc + Math.pow(v - mean, 2), 0) /
+                (samples.length - 1);
+        stdDev = Math.sqrt(variance);
+    }
+    // Coefficient of Variation
+    const cv = mean === 0 || samples.length < 2 ? 0 : (stdDev / mean) * 100;
+    // Margin of Error (95% confidence)
+    const Z = 1.96;
+    const marginOfError = samples.length === 0 ? 0 : (Z * stdDev) / Math.sqrt(samples.length);
+    // Percentiles (using standard formula: floor((n-1) * p))
+    const p95 = samples[Math.floor((samples.length - 1) * 0.95)] ?? 0;
+    const p99 = samples[Math.floor((samples.length - 1) * 0.99)] ?? 0;
+    return { cv, marginOfError, max, mean, min, p95, p99, stdDev, variance };
+};
+/**
+ * Remove outliers using Interquartile Range (IQR) method
+ *
+ * Adapted from bench-node's StatisticalHistogram.removeOutliers. Filters values
+ * outside [Q1 - 1.5×IQR, Q3 + 1.5×IQR] range.
+ *
+ * @param samples - Raw sample values (will be sorted internally)
+ * @returns Filtered samples with outliers removed
+ */
+export const removeOutliersIQR = (samples) => {
+    if (samples.length < 4) {
+        return samples;
+    }
+    const sorted = samples.slice().sort((a, b) => a - b);
+    // Calculate Q1 and Q3
+    let q1;
+    let q3;
+    const size = sorted.length;
+    if (((size - 1) / 4) % 1 === 0 || (size / 4) % 1 === 0) {
+        q1 =
+            (1 / 2) *
+                (sorted[Math.floor(size / 4) - 1] + sorted[Math.floor(size / 4)]);
+        q3 =
+            (1 / 2) *
+                (sorted[Math.ceil((size * 3) / 4) - 1] +
+                    sorted[Math.ceil((size * 3) / 4)]);
+    }
+    else {
+        q1 = sorted[Math.floor(size / 4)];
+        q3 = sorted[Math.floor((size * 3) / 4)];
+    }
+    // Calculate IQR and bounds
+    const iqr = q3 - q1;
+    const minValue = q1 - iqr * 1.5;
+    const maxValue = q3 + iqr * 1.5;
+    // Filter outliers
+    return sorted.filter((value) => value <= maxValue && value >= minValue);
+};
+//# sourceMappingURL=stats-utils.js.map

package/dist/core/stats-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-utils.js","sourceRoot":"","sources":["../../src/core/stats-utils.ts"],"names":[],"mappings":"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"}