@danielsimonjr/mathts-matrix 0.3.2 → 0.4.1

package/dist/index.js

@@ -1461,11 +1461,25 @@ init_DenseMatrix();
 init_SparseMatrix();
 
 // src/backends/Backend.ts
+import { GPU_MIN_ELEMENTS } from "@danielsimonjr/mathts-gpu";
 var DEFAULT_BACKEND_HINTS = {
   wasmThreshold: 1e3,
   // > 1000 elements
-  gpuThreshold: 1e5,
-  // > 100K elements
+  // ⚠️ THIS ROUTE IS DORMANT. Both GPU branches gate on `backendRegistry.has('gpu')`,
+  // and NOTHING ever registers a 'gpu' backend: `register-backends.ts` registers
+  // only `jsBackend` + `wasmBackend`, and no other call site calls `register()`.
+  // (`GPUMatrixBackend` does declare `type = 'gpu'` — it is simply never handed to
+  // the registry.) So `has('gpu')` is permanently false, no matrix op has ever been
+  // selected onto the GPU through the BackendManager, and this number has never been
+  // read on a live path.
+  //
+  // GPU matrix work reaches the device a different way: `gpuMatmul` and friends
+  // call `gpuMatrixBackend` directly, which gates on its own `minElements`
+  // (= GPU_MIN_ELEMENTS). This value is aligned to that single canonical
+  // threshold so the codebase no longer carries four divergent GPU magic numbers
+  // (it was 100_000 here, 50_000 / 10_000 / 200_000 in BackendManager, against a
+  // live 65_536) — a trap for whoever eventually wires this route up.
+  gpuThreshold: GPU_MIN_ELEMENTS,
   preferredBackend: "js"
 };
 var BackendRegistry = class {
@@ -3703,6 +3717,9 @@ function createGPUMatrixBackend(config) {
   return new GPUMatrixBackend(config);
 }
 
+// src/backends/BackendManager.ts
+import { GPU_MIN_ELEMENTS as GPU_MIN_ELEMENTS2 } from "@danielsimonjr/mathts-gpu";
+
 // src/config.ts
 var DEFAULT_CONFIG3 = {
   backends: {
@@ -3773,11 +3790,18 @@ var DEFAULT_EXTENDED_HINTS = {
     // matmul: the SIMD-WASM kernel wins from ~256 elems (16²), solidly 1.3–2.2× (measured,
     // tools/benchmarks/matmul-threshold.mjs); below that copy/alloc overhead dominates (8²
     // loses, 12² marginal). Dropped 500→256 to stop forcing 16²–22² matmuls onto JS.
-    multiply: { wasm: 256, gpu: 5e4 },
-    decomposition: { wasm: 100, gpu: 1e4 },
+    // ⚠️ Every `gpu:` threshold below is DORMANT — `selectBackend` gates the GPU
+    // branch on `backendRegistry.has('gpu')`, and no 'gpu' backend is ever
+    // registered (register-backends.ts registers js + wasm only). They are aligned
+    // to the single canonical GPU_MIN_ELEMENTS rather than left as four divergent
+    // magic numbers (50_000 / 10_000 / 200_000 against a live 65_536), which would
+    // mislead whoever wires this route up. GPU matrix work currently reaches the
+    // device via `gpuMatmul` -> `gpuMatrixBackend`, not through this manager.
+    multiply: { wasm: 256, gpu: GPU_MIN_ELEMENTS2 },
+    decomposition: { wasm: 100, gpu: GPU_MIN_ELEMENTS2 },
     // transpose WASM is retired (memory-bound, lost 4–6×) — WASMBackend.transpose always uses
     // JS regardless of this gate; kept high so the manager doesn't even select the WASM backend.
-    transpose: { wasm: 2e3, gpu: 2e5 }
+    transpose: { wasm: 2e3, gpu: GPU_MIN_ELEMENTS2 }
   },
   autoSIMD: true,
   fallbackOnError: true

package/package.json

@@ -1,70 +1,70 @@
-{
-  "name": "@danielsimonjr/mathts-matrix",
-  "version": "0.3.2",
-  "description": "Matrix operations for MathTS with WASM/WebGPU backend support",
-  "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 --format esm --dts --clean && node scripts/copy-wasm.mjs",
-    "copy:wasm": "node scripts/copy-wasm.mjs",
-    "dev": "tsup src/index.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 --format esm --dts --clean --minify --treeshake && node scripts/copy-wasm.mjs"
-  },
-  "dependencies": {
-    "@danielsimonjr/mathts-core": "^0.6.0",
-    "@danielsimonjr/mathts-gpu": "^0.1.1",
-    "@danielsimonjr/mathts-parallel": "^0.3.4"
-  },
-  "devDependencies": {
-    "@types/node": "^25.5.2",
-    "tsup": "^8.0.0",
-    "typescript": "^5.3.0",
-    "vitest": "^4.1.5",
-    "@webgpu/types": "^0.1.67"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/danielsimonjr/mathts",
-    "directory": "matrix"
-  },
-  "keywords": [
-    "math",
-    "matrix",
-    "linear-algebra",
-    "typescript",
-    "wasm",
-    "webgpu"
-  ],
-  "peerDependencies": {
-    "@webgpu/types": "^0.1.67"
-  },
-  "peerDependenciesMeta": {
-    "@webgpu/types": {
-      "optional": true
-    }
-  }
-}
+{
+  "name": "@danielsimonjr/mathts-matrix",
+  "version": "0.4.1",
+  "description": "Matrix operations for MathTS with WASM/WebGPU backend support",
+  "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 --format esm --dts --clean && node scripts/copy-wasm.mjs",
+    "copy:wasm": "node scripts/copy-wasm.mjs",
+    "dev": "tsup src/index.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 --format esm --dts --clean --minify --treeshake && node scripts/copy-wasm.mjs"
+  },
+  "dependencies": {
+    "@danielsimonjr/mathts-core": "^0.6.0",
+    "@danielsimonjr/mathts-gpu": "^0.2.0",
+    "@danielsimonjr/mathts-parallel": "^0.3.4"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^4.1.5",
+    "@webgpu/types": "^0.1.67"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/danielsimonjr/mathts",
+    "directory": "matrix"
+  },
+  "keywords": [
+    "math",
+    "matrix",
+    "linear-algebra",
+    "typescript",
+    "wasm",
+    "webgpu"
+  ],
+  "peerDependencies": {
+    "@webgpu/types": "^0.1.67"
+  },
+  "peerDependenciesMeta": {
+    "@webgpu/types": {
+      "optional": true
+    }
+  }
+}