numpy-ts 0.2.0 → 0.4.0

package/dist/types/ops/linalg.d.ts

@@ -5,12 +5,91 @@
  * @module ops/linalg
  */
 import { ArrayStorage } from '../core/storage';
+/**
+ * Dot product of two arrays (fully NumPy-compatible)
+ *
+ * Behavior depends on input dimensions:
+ * - 0D · 0D: Multiply scalars → scalar
+ * - 0D · ND or ND · 0D: Element-wise multiply → ND
+ * - 1D · 1D: Inner product → scalar
+ * - 2D · 2D: Matrix multiplication → 2D
+ * - 2D · 1D: Matrix-vector product → 1D
+ * - 1D · 2D: Vector-matrix product → 1D
+ * - ND · 1D (N≥2): Sum product over last axis of a → (N-1)D
+ * - 1D · ND (N≥2): Sum product over first axis of b → (N-1)D
+ * - ND · MD (N,M≥2): Sum product over last axis of a and second-to-last of b → (N+M-2)D
+ *
+ * For 2D·2D, prefer using matmul() instead.
+ */
+export declare function dot(a: ArrayStorage, b: ArrayStorage): ArrayStorage | number | bigint;
 /**
  * Matrix multiplication
  * Requires 2D arrays with compatible shapes
  *
+ * Automatically detects transposed/non-contiguous arrays via strides
+ * and uses appropriate DGEMM transpose parameters.
+ *
  * Note: Currently uses float64 precision for all operations.
  * Integer inputs are promoted to float64 (matching NumPy behavior).
  */
 export declare function matmul(a: ArrayStorage, b: ArrayStorage): ArrayStorage;
+/**
+ * Sum along the diagonal of a 2D array
+ *
+ * Computes the trace (sum of diagonal elements) of a matrix.
+ * For non-square matrices, sums along the diagonal up to min(rows, cols).
+ *
+ * @param a - Input 2D array
+ * @returns Sum of diagonal elements
+ */
+export declare function trace(a: ArrayStorage): number | bigint;
+/**
+ * Permute the dimensions of an array
+ *
+ * Standalone version of NDArray.transpose() method.
+ * Returns a view with axes permuted.
+ *
+ * @param a - Input array
+ * @param axes - Optional permutation of axes (defaults to reverse order)
+ * @returns Transposed view
+ */
+export declare function transpose(a: ArrayStorage, axes?: number[]): ArrayStorage;
+/**
+ * Inner product of two arrays
+ *
+ * Computes sum product over the LAST axes of both a and b.
+ * - 1D · 1D: Same as dot (ordinary inner product) → scalar
+ * - ND · MD: Contracts last dimension of each → (*a.shape[:-1], *b.shape[:-1])
+ *
+ * Different from dot: always uses last axis of BOTH arrays.
+ *
+ * @param a - First array
+ * @param b - Second array
+ * @returns Inner product result
+ */
+export declare function inner(a: ArrayStorage, b: ArrayStorage): ArrayStorage | number | bigint;
+/**
+ * Outer product of two vectors
+ *
+ * Computes out[i, j] = a[i] * b[j]
+ * Input arrays are flattened if not 1D.
+ *
+ * @param a - First input (flattened to 1D)
+ * @param b - Second input (flattened to 1D)
+ * @returns 2D array of shape (a.size, b.size)
+ */
+export declare function outer(a: ArrayStorage, b: ArrayStorage): ArrayStorage;
+/**
+ * Tensor dot product along specified axes
+ *
+ * Computes sum product over specified axes.
+ *
+ * @param a - First array
+ * @param b - Second array
+ * @param axes - Axes to contract:
+ *   - Integer N: Contract last N axes of a with first N of b
+ *   - [a_axes, b_axes]: Contract specified axes
+ * @returns Tensor dot product
+ */
+export declare function tensordot(a: ArrayStorage, b: ArrayStorage, axes: number | [number[], number[]]): ArrayStorage | number | bigint;
 //# sourceMappingURL=linalg.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "numpy-ts",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Complete NumPy implementation for TypeScript and JavaScript (under construction)",
   "main": "dist/numpy-ts.node.cjs",
   "browser": "dist/numpy-ts.browser.js",
@@ -54,8 +54,10 @@
     "bench:build": "esbuild benchmarks/src/index.ts --bundle --platform=node --format=cjs --outfile=benchmarks/dist/bench.cjs",
     "bench": "npm run bench:build && node benchmarks/dist/bench.cjs",
     "bench:quick": "npm run bench:build && node benchmarks/dist/bench.cjs --quick",
+    "bench:large": "npm run bench:build && node benchmarks/dist/bench.cjs --large",
     "bench:category": "npm run bench:build && node benchmarks/dist/bench.cjs --category",
-    "bench:view": "open benchmarks/results/plots/latest.html || xdg-open benchmarks/results/plots/latest.html"
+    "bench:view": "open benchmarks/results/plots/latest.html || xdg-open benchmarks/results/plots/latest.html",
+    "bench:large:view": "open benchmarks/results/plots/latest-large.html || xdg-open benchmarks/results/plots/latest-large.html"
   },
   "keywords": [
     "numpy",
@@ -81,7 +83,6 @@
   },
   "homepage": "https://github.com/dupontcyborg/numpy-ts#readme",
   "devDependencies": {
-    "@stdlib/types": "^0.4.3",
     "@types/node": "^24.9.1",
     "@typescript-eslint/eslint-plugin": "^8.46.2",
     "@typescript-eslint/parser": "^8.46.2",
@@ -103,13 +104,12 @@
     "typescript": "^5.3.3",
     "vitest": "^4.0.3"
   },
-  "dependencies": {
-    "@stdlib/blas": "^0.3.3",
-    "@stdlib/ndarray": "^0.3.3"
-  },
   "engines": {
     "node": ">=18.0.0"
   },
+  "overrides": {
+    "js-yaml": ">=4.1.1"
+  },
   "lint-staged": {
     "*.ts": [
       "eslint --fix",