@danielsimonjr/mathts-parallel 0.2.2 → 0.3.0

package/dist/index.d.ts

@@ -72,6 +72,22 @@ interface ComputePoolConfig {
     /** Default task timeout in milliseconds */
     taskTimeout: number;
 }
+/**
+ * Default per-op thresholds derived from benchmark data (tools/benchmark/parallel/run.ts,
+ * 2026-05-23).  Values measured on a noisy CI container — re-run on target hardware to retune.
+ *
+ *  'never'  → Number.MAX_SAFE_INTEGER  (benchmark showed no reliable speedup)
+ *  'always' → 0                        (always parallelize when pool is ready)
+ *  number   → minimum element count before dispatching to workers
+ */
+/**
+ * Canonical, benchmark-tuned per-op parallelization thresholds. This is the
+ * single source of truth consulted by `ComputePool.shouldParallelize` — the
+ * authority the typed functions actually dispatch through. The coarser
+ * category-level {@link ThresholdDispatcher} derives its overlapping values
+ * (e.g. matmul) from here so the two cannot silently diverge.
+ */
+declare const DEFAULT_THRESHOLD_BY_OP: Partial<Record<OpName, OpThreshold>>;
 /**
  * Default ComputePool configuration
  */
@@ -1179,11 +1195,14 @@ interface ThresholdConfig {
     general: number;
 }
 /**
- * Default thresholds optimized for typical hardware
+ * Default category-level thresholds.
  *
- * These thresholds account for worker creation overhead vs computation benefit.
- * Smaller thresholds for compute-intensive operations (matmul, decomposition).
- * Larger thresholds for memory-bound operations (elementwise, reduce).
+ * NOTE: `ComputePool.shouldParallelize` (op-level, {@link DEFAULT_THRESHOLD_BY_OP})
+ * is the authority the typed functions dispatch through. This category map is a
+ * coarser helper; where a category overlaps a tuned op (matmul) its value is
+ * derived from the canonical const so the two cannot diverge. The remaining
+ * categories (no single ComputePool op equivalent — many are 'never') keep
+ * heuristic defaults for compute-vs-memory-bound work.
  */
 declare const DEFAULT_THRESHOLDS: ThresholdConfig;
 /**
@@ -1283,4 +1302,4 @@ interface PoolStats {
     activeTasks: number;
 }
 
-export { type BitwiseBinaryOp, type ChunkInfo, type ChunkOptions, type ChunkResult, ComputePool, type ComputePoolConfig, DEFAULT_POOL_CONFIG, DEFAULT_THRESHOLDS, type DispatchResult, type ElementwiseOptions, type ExecOptions, type ExecutionMode, type MapOptions, type MatmulOptions, type OpName, type OpThreshold, type OperationCategory, type ParallelResult, type PoolOptions, type PoolStats, type ReduceOptions, type ThresholdConfig, ThresholdDispatcher, bitAnd, bitNot, bitOr, bitXor, calculateChunks, calculateOptimalChunks, chunkArray, chunkFloat64Array, computePool, dispatch, leftShift, mergeArrayChunks, mergeFloat64Chunks, parallelAbs, parallelAdd, parallelCos, parallelCount, parallelDistance, parallelDivide, parallelDot, parallelElementwise, parallelEvery, parallelExp, parallelFilter, parallelFind, parallelForEach, parallelHistogram, parallelLog, parallelMap, parallelMatmul, parallelMatvec, parallelMax, parallelMean, parallelMin, parallelMinMax, parallelMultiply, parallelNegate, parallelNorm, parallelOuter, parallelReduce, parallelScale, parallelSin, parallelSome, parallelSort, parallelSqrt, parallelSquare, parallelStd, parallelSubtract, parallelSum, parallelTan, parallelTranspose, parallelUnary, parallelVariance, partition2D, partitionRange, resolveOpThreshold, rightArithShift, rightLogShift, shouldParallelize$1 as shouldChunkParallelize, shouldParallelize, thresholdDispatcher };
+export { type BitwiseBinaryOp, type ChunkInfo, type ChunkOptions, type ChunkResult, ComputePool, type ComputePoolConfig, DEFAULT_POOL_CONFIG, DEFAULT_THRESHOLDS, DEFAULT_THRESHOLD_BY_OP, type DispatchResult, type ElementwiseOptions, type ExecOptions, type ExecutionMode, type MapOptions, type MatmulOptions, type OpName, type OpThreshold, type OperationCategory, type ParallelResult, type PoolOptions, type PoolStats, type ReduceOptions, type ThresholdConfig, ThresholdDispatcher, bitAnd, bitNot, bitOr, bitXor, calculateChunks, calculateOptimalChunks, chunkArray, chunkFloat64Array, computePool, dispatch, leftShift, mergeArrayChunks, mergeFloat64Chunks, parallelAbs, parallelAdd, parallelCos, parallelCount, parallelDistance, parallelDivide, parallelDot, parallelElementwise, parallelEvery, parallelExp, parallelFilter, parallelFind, parallelForEach, parallelHistogram, parallelLog, parallelMap, parallelMatmul, parallelMatvec, parallelMax, parallelMean, parallelMin, parallelMinMax, parallelMultiply, parallelNegate, parallelNorm, parallelOuter, parallelReduce, parallelScale, parallelSin, parallelSome, parallelSort, parallelSqrt, parallelSquare, parallelStd, parallelSubtract, parallelSum, parallelTan, parallelTranspose, parallelUnary, parallelVariance, partition2D, partitionRange, resolveOpThreshold, rightArithShift, rightLogShift, shouldParallelize$1 as shouldChunkParallelize, shouldParallelize, thresholdDispatcher };

package/dist/index.js

@@ -1483,11 +1483,15 @@ async function parallelCount(data, predicate, options = {}) {
 }
 
 // src/strategies/threshold.ts
+function opThreshold(op, fallback) {
+  const raw = DEFAULT_THRESHOLD_BY_OP[op];
+  return typeof raw === "number" ? raw : fallback;
+}
 var DEFAULT_THRESHOLDS = {
-  matmul: 1e4,
-  // ~100x100 matrix
+  matmul: opThreshold("matmul", 4096),
+  // canonical: DEFAULT_THRESHOLD_BY_OP.matmul
   elementwise: 5e4,
-  // ~50K elements
+  // ~50K elements (memory-bound; ComputePool ops mostly 'never')
   reduce: 1e5,
   // ~100K elements
   map: 1e4,
@@ -1495,7 +1499,7 @@ var DEFAULT_THRESHOLDS = {
   sort: 5e3,
   // ~5K elements
   decomposition: 2500,
-  // ~50x50 matrix
+  // ~50x50 matrix (no single canonical op; heuristic)
   general: 5e4
   // Default ~50K
 };
@@ -1608,6 +1612,7 @@ export {
   ComputePool,
   DEFAULT_POOL_CONFIG,
   DEFAULT_THRESHOLDS,
+  DEFAULT_THRESHOLD_BY_OP,
   ThresholdDispatcher,
   Transfer,
   bitAnd,

package/package.json

@@ -1,57 +1,57 @@
-{
-  "name": "@danielsimonjr/mathts-parallel",
-  "version": "0.2.2",
-  "description": "WebWorker parallelization for MathTS computations",
-  "author": "Daniel Simon Jr.",
-  "license": "MIT",
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsup src/index.ts src/matrix.worker.ts --format esm --dts --clean",
-    "dev": "tsup src/index.ts src/matrix.worker.ts --format esm --dts --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src --ext .ts",
-    "lint:fix": "eslint src --ext .ts --fix",
-    "clean": "rm -rf dist",
-    "build:prod": "tsup src/index.ts src/matrix.worker.ts --format esm --dts --clean --minify --treeshake"
-  },
-  "dependencies": {
-    "@danielsimonjr/mathts-workerpool": "^0.2.0"
-  },
-  "devDependencies": {
-    "@types/node": "^25.5.2",
-    "tsup": "^8.0.0",
-    "typescript": "^5.3.0",
-    "vitest": "^4.1.5"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/danielsimonjr/mathts",
-    "directory": "parallel"
-  },
-  "keywords": [
-    "math",
-    "typescript",
-    "parallel",
-    "webworker",
-    "worker-pool"
-  ]
-}
+{
+  "name": "@danielsimonjr/mathts-parallel",
+  "version": "0.3.0",
+  "description": "WebWorker parallelization for MathTS computations",
+  "author": "Daniel Simon Jr.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts src/matrix.worker.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts src/matrix.worker.ts --format esm --dts --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "clean": "rm -rf dist",
+    "build:prod": "tsup src/index.ts src/matrix.worker.ts --format esm --dts --clean --minify --treeshake"
+  },
+  "dependencies": {
+    "@danielsimonjr/mathts-workerpool": "^0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^4.1.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/danielsimonjr/mathts",
+    "directory": "parallel"
+  },
+  "keywords": [
+    "math",
+    "typescript",
+    "parallel",
+    "webworker",
+    "worker-pool"
+  ]
+}