numpy-ts 0.3.0 → 0.4.0

package/dist/types/core/ndarray.d.ts

@@ -309,6 +309,36 @@ export declare class NDArray {
      * @returns Result of matrix multiplication
      */
     matmul(other: NDArray): NDArray;
+    /**
+     * Dot product (matching NumPy behavior)
+     * @param other - Array to dot with
+     * @returns Result of dot product (scalar or array depending on dimensions)
+     */
+    dot(other: NDArray): NDArray | number | bigint;
+    /**
+     * Sum of diagonal elements (trace)
+     * @returns Sum of diagonal elements
+     */
+    trace(): number | bigint;
+    /**
+     * Inner product (contracts over last axes of both arrays)
+     * @param other - Array to compute inner product with
+     * @returns Inner product result
+     */
+    inner(other: NDArray): NDArray | number | bigint;
+    /**
+     * Outer product (flattens inputs then computes a[i]*b[j])
+     * @param other - Array to compute outer product with
+     * @returns 2D outer product matrix
+     */
+    outer(other: NDArray): NDArray;
+    /**
+     * Tensor dot product along specified axes
+     * @param other - Array to contract with
+     * @param axes - Axes to contract (integer or [a_axes, b_axes])
+     * @returns Tensor dot product result
+     */
+    tensordot(other: NDArray, axes?: number | [number[], number[]]): NDArray | number | bigint;
     /**
      * Slice the array using NumPy-style string syntax
      *
@@ -545,4 +575,68 @@ export declare function positive(x: NDArray): NDArray;
  * @returns Array of reciprocals
  */
 export declare function reciprocal(x: NDArray): NDArray;
+/**
+ * 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 over last axis → (N-1)D
+ * - 1D · ND (N>2): Sum over first axis → (N-1)D
+ * - ND · MD (N,M≥2): Tensor contraction → (N+M-2)D
+ *
+ * @param a - First array
+ * @param b - Second array
+ * @returns Result of dot product
+ */
+export declare function dot(a: NDArray, b: NDArray): NDArray | number | bigint;
+/**
+ * Sum of diagonal elements
+ *
+ * @param a - Input 2D array
+ * @returns Sum of diagonal elements
+ */
+export declare function trace(a: NDArray): number | bigint;
+/**
+ * Permute array dimensions
+ *
+ * @param a - Input array
+ * @param axes - Optional permutation of axes (defaults to reverse order)
+ * @returns Transposed view
+ */
+export declare function transpose(a: NDArray, axes?: number[]): NDArray;
+/**
+ * Inner product of two arrays
+ *
+ * Contracts over last axes of both arrays.
+ * Result shape: (*a.shape[:-1], *b.shape[:-1])
+ *
+ * @param a - First array
+ * @param b - Second array
+ * @returns Inner product result
+ */
+export declare function inner(a: NDArray, b: NDArray): NDArray | number | bigint;
+/**
+ * Outer product of two arrays
+ *
+ * Flattens inputs then computes result[i,j] = a[i] * b[j]
+ *
+ * @param a - First array
+ * @param b - Second array
+ * @returns 2D outer product matrix
+ */
+export declare function outer(a: NDArray, b: NDArray): NDArray;
+/**
+ * Tensor dot product along specified axes
+ *
+ * @param a - First array
+ * @param b - Second array
+ * @param axes - Axes to contract (integer or [a_axes, b_axes])
+ * @returns Tensor dot product
+ */
+export declare function tensordot(a: NDArray, b: NDArray, axes?: number | [number[], number[]]): NDArray | number | bigint;
 //# sourceMappingURL=ndarray.d.ts.map

package/dist/types/index.d.ts

@@ -3,6 +3,6 @@
  *
  * @module numpy-ts
  */
-export { NDArray, zeros, ones, array, arange, linspace, logspace, geomspace, eye, empty, full, identity, asarray, copy, zeros_like, ones_like, empty_like, full_like, sqrt, power, absolute, negative, sign, mod, floor_divide, positive, reciprocal, } from './core/ndarray';
+export { NDArray, zeros, ones, array, arange, linspace, logspace, geomspace, eye, empty, full, identity, asarray, copy, zeros_like, ones_like, empty_like, full_like, sqrt, power, absolute, negative, sign, mod, floor_divide, positive, reciprocal, dot, trace, transpose, inner, outer, tensordot, } from './core/ndarray';
 export declare const __version__: string;
 //# sourceMappingURL=index.d.ts.map

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.3.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",
@@ -83,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",
@@ -105,9 +104,6 @@
     "typescript": "^5.3.3",
     "vitest": "^4.0.3"
   },
-  "dependencies": {
-    "@stdlib/blas": "^0.3.3"
-  },
   "engines": {
     "node": ">=18.0.0"
   },