numpy-ts 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * numpy-ts - Complete NumPy implementation for TypeScript and JavaScript
+ *
+ * @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, } from './core/ndarray';
+export declare const __version__: string;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/internal/compute.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Computation backend abstraction
+ *
+ * Internal module for element-wise and broadcast operations.
+ * Provides a swappable backend for different computation strategies.
+ *
+ * @internal
+ */
+import { ArrayStorage } from '../core/storage';
+/**
+ * Perform element-wise operation with broadcasting
+ *
+ * @param a - First array storage
+ * @param b - Second array storage
+ * @param op - Operation to perform (a, b) => result
+ * @param opName - Name of operation (for special handling)
+ * @returns Result storage
+ */
+export declare function elementwiseBinaryOp(a: ArrayStorage, b: ArrayStorage, op: (a: number, b: number) => number, opName: string): ArrayStorage;
+/**
+ * Perform element-wise comparison with broadcasting
+ * Returns boolean array (dtype: 'bool', stored as Uint8Array)
+ */
+export declare function elementwiseComparisonOp(a: ArrayStorage, b: ArrayStorage, op: (a: number, b: number) => boolean): ArrayStorage;
+//# sourceMappingURL=compute.d.ts.map

package/dist/types/internal/indexing.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Indexing utilities for array operations
+ * @internal
+ */
+/**
+ * Compute row-major strides for a given shape
+ */
+export declare function computeStrides(shape: readonly number[]): number[];
+/**
+ * Convert multi-index to linear index in row-major order
+ */
+export declare function multiIndexToLinear(indices: number[], shape: readonly number[]): number;
+/**
+ * Convert outer index and axis index to full multi-index
+ * Used in reductions along a specific axis
+ *
+ * @param outerIdx - Linear index in the reduced (output) array
+ * @param axis - The axis being reduced
+ * @param axisIdx - Position along the reduction axis
+ * @param shape - Original array shape
+ * @returns Full multi-index in the original array
+ */
+export declare function outerIndexToMultiIndex(outerIdx: number, axis: number, axisIdx: number, shape: readonly number[]): number[];
+//# sourceMappingURL=indexing.d.ts.map

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

@@ -0,0 +1,49 @@
+/**
+ * Arithmetic operations
+ *
+ * Pure functions for element-wise arithmetic operations:
+ * add, subtract, multiply, divide
+ *
+ * These functions are used by NDArray methods but are separated
+ * to keep the codebase modular and testable.
+ */
+import { ArrayStorage } from '../core/storage';
+/**
+ * Add two arrays or array and scalar
+ *
+ * @param a - First array storage
+ * @param b - Second array storage or scalar
+ * @returns Result storage
+ */
+export declare function add(a: ArrayStorage, b: ArrayStorage | number): ArrayStorage;
+/**
+ * Subtract two arrays or array and scalar
+ *
+ * @param a - First array storage
+ * @param b - Second array storage or scalar
+ * @returns Result storage
+ */
+export declare function subtract(a: ArrayStorage, b: ArrayStorage | number): ArrayStorage;
+/**
+ * Multiply two arrays or array and scalar
+ *
+ * @param a - First array storage
+ * @param b - Second array storage or scalar
+ * @returns Result storage
+ */
+export declare function multiply(a: ArrayStorage, b: ArrayStorage | number): ArrayStorage;
+/**
+ * Divide two arrays or array and scalar
+ *
+ * NumPy behavior: Integer division always promotes to float
+ * Type promotion rules:
+ * - float64 + anything → float64
+ * - float32 + integer → float32
+ * - integer + integer → float64
+ *
+ * @param a - First array storage
+ * @param b - Second array storage or scalar
+ * @returns Result storage with promoted float dtype
+ */
+export declare function divide(a: ArrayStorage, b: ArrayStorage | number): ArrayStorage;
+//# sourceMappingURL=arithmetic.d.ts.map

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

@@ -0,0 +1,43 @@
+/**
+ * Comparison operations
+ *
+ * Element-wise comparison operations that return boolean arrays:
+ * greater, greater_equal, less, less_equal, equal, not_equal,
+ * isclose, allclose
+ */
+import { ArrayStorage } from '../core/storage';
+/**
+ * Element-wise greater than comparison (a > b)
+ */
+export declare function greater(a: ArrayStorage, b: ArrayStorage | number): ArrayStorage;
+/**
+ * Element-wise greater than or equal comparison (a >= b)
+ */
+export declare function greaterEqual(a: ArrayStorage, b: ArrayStorage | number): ArrayStorage;
+/**
+ * Element-wise less than comparison (a < b)
+ */
+export declare function less(a: ArrayStorage, b: ArrayStorage | number): ArrayStorage;
+/**
+ * Element-wise less than or equal comparison (a <= b)
+ */
+export declare function lessEqual(a: ArrayStorage, b: ArrayStorage | number): ArrayStorage;
+/**
+ * Element-wise equality comparison (a == b)
+ */
+export declare function equal(a: ArrayStorage, b: ArrayStorage | number): ArrayStorage;
+/**
+ * Element-wise inequality comparison (a != b)
+ */
+export declare function notEqual(a: ArrayStorage, b: ArrayStorage | number): ArrayStorage;
+/**
+ * Element-wise "close" comparison with tolerance
+ * Returns true where |a - b| <= atol + rtol * |b|
+ */
+export declare function isclose(a: ArrayStorage, b: ArrayStorage | number, rtol?: number, atol?: number): ArrayStorage;
+/**
+ * Check if all elements are close (scalar result)
+ * Returns true if all elements satisfy isclose condition
+ */
+export declare function allclose(a: ArrayStorage, b: ArrayStorage | number, rtol?: number, atol?: number): boolean;
+//# sourceMappingURL=comparison.d.ts.map

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

@@ -0,0 +1,16 @@
+/**
+ * Linear algebra operations
+ *
+ * Pure functions for matrix operations (matmul, etc.).
+ * @module ops/linalg
+ */
+import { ArrayStorage } from '../core/storage';
+/**
+ * Matrix multiplication
+ * Requires 2D arrays with compatible shapes
+ *
+ * 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;
+//# sourceMappingURL=linalg.d.ts.map

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

@@ -0,0 +1,61 @@
+/**
+ * Reduction operations (sum, mean, max, min)
+ *
+ * Pure functions for reducing arrays along axes.
+ * @module ops/reduction
+ */
+import { ArrayStorage } from '../core/storage';
+/**
+ * Sum array elements over a given axis
+ */
+export declare function sum(storage: ArrayStorage, axis?: number, keepdims?: boolean): ArrayStorage | number;
+/**
+ * Compute the arithmetic mean along the specified axis
+ * Note: mean() returns float64 for integer dtypes, matching NumPy behavior
+ */
+export declare function mean(storage: ArrayStorage, axis?: number, keepdims?: boolean): ArrayStorage | number;
+/**
+ * Return the maximum along a given axis
+ */
+export declare function max(storage: ArrayStorage, axis?: number, keepdims?: boolean): ArrayStorage | number;
+/**
+ * Product array elements over a given axis
+ */
+export declare function prod(storage: ArrayStorage, axis?: number, keepdims?: boolean): ArrayStorage | number;
+/**
+ * Return the minimum along a given axis
+ */
+export declare function min(storage: ArrayStorage, axis?: number, keepdims?: boolean): ArrayStorage | number;
+/**
+ * Return the indices of the minimum values along a given axis
+ */
+export declare function argmin(storage: ArrayStorage, axis?: number): ArrayStorage | number;
+/**
+ * Return the indices of the maximum values along a given axis
+ */
+export declare function argmax(storage: ArrayStorage, axis?: number): ArrayStorage | number;
+/**
+ * Compute the variance along the specified axis
+ * @param storage - Input array storage
+ * @param axis - Axis along which to compute variance
+ * @param ddof - Delta degrees of freedom (default: 0)
+ * @param keepdims - Keep dimensions (default: false)
+ */
+export declare function variance(storage: ArrayStorage, axis?: number, ddof?: number, keepdims?: boolean): ArrayStorage | number;
+/**
+ * Compute the standard deviation along the specified axis
+ * @param storage - Input array storage
+ * @param axis - Axis along which to compute std
+ * @param ddof - Delta degrees of freedom (default: 0)
+ * @param keepdims - Keep dimensions (default: false)
+ */
+export declare function std(storage: ArrayStorage, axis?: number, ddof?: number, keepdims?: boolean): ArrayStorage | number;
+/**
+ * Test whether all array elements along a given axis evaluate to True
+ */
+export declare function all(storage: ArrayStorage, axis?: number, keepdims?: boolean): ArrayStorage | boolean;
+/**
+ * Test whether any array elements along a given axis evaluate to True
+ */
+export declare function any(storage: ArrayStorage, axis?: number, keepdims?: boolean): ArrayStorage | boolean;
+//# sourceMappingURL=reduction.d.ts.map

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

@@ -0,0 +1,39 @@
+/**
+ * Shape manipulation operations
+ *
+ * Pure functions for reshaping, transposing, and manipulating array dimensions.
+ * @module ops/shape
+ */
+import { ArrayStorage } from '../core/storage';
+/**
+ * Reshape array to a new shape
+ * Returns a view if array is C-contiguous, otherwise copies data
+ */
+export declare function reshape(storage: ArrayStorage, newShape: number[]): ArrayStorage;
+/**
+ * Return a flattened copy of the array
+ * Creates 1D array containing all elements in row-major order
+ * Always returns a copy (matching NumPy behavior)
+ */
+export declare function flatten(storage: ArrayStorage): ArrayStorage;
+/**
+ * Return a flattened array (view when possible, otherwise copy)
+ * Returns a view if array is C-contiguous, otherwise copies data
+ */
+export declare function ravel(storage: ArrayStorage): ArrayStorage;
+/**
+ * Transpose array (permute dimensions)
+ * Returns a view with transposed dimensions
+ */
+export declare function transpose(storage: ArrayStorage, axes?: number[]): ArrayStorage;
+/**
+ * Remove axes of length 1
+ * Returns a view with specified dimensions removed
+ */
+export declare function squeeze(storage: ArrayStorage, axis?: number): ArrayStorage;
+/**
+ * Expand the shape by inserting a new axis of length 1
+ * Returns a view with additional dimension
+ */
+export declare function expandDims(storage: ArrayStorage, axis: number): ArrayStorage;
+//# sourceMappingURL=shape.d.ts.map

package/package.json

@@ -0,0 +1,121 @@
+{
+  "name": "numpy-ts",
+  "version": "0.1.0",
+  "description": "Complete NumPy implementation for TypeScript and JavaScript (under construction)",
+  "main": "dist/numpy-ts.node.cjs",
+  "browser": "dist/numpy-ts.browser.js",
+  "module": "dist/numpy-ts.esm.js",
+  "types": "dist/types/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.cjs",
+    "dist/types/**/*.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "node": "./dist/numpy-ts.node.cjs",
+      "browser": "./dist/numpy-ts.browser.js",
+      "default": "./dist/numpy-ts.esm.js"
+    },
+    "./node": {
+      "types": "./dist/types/node.d.ts",
+      "default": "./dist/numpy-ts.node.cjs"
+    },
+    "./browser": {
+      "types": "./dist/types/browser.d.ts",
+      "default": "./dist/numpy-ts.browser.js"
+    }
+  },
+  "scripts": {
+    "dev": "esbuild src/index.ts --bundle --sourcemap --watch --outfile=dist/numpy-ts.dev.js",
+    "build": "npm run build:clean && tsx build.ts && npm run build:types",
+    "build:clean": "rm -rf dist",
+    "build:types": "tsc --emitDeclarationOnly --outDir dist/types",
+    "test": "vitest run --project=unit --project=validation",
+    "test:quick": "vitest run --project=quick",
+    "test:unit": "vitest run --project=unit",
+    "test:validation": "vitest run --project=validation",
+    "test:bundles": "npm run build && vitest run --project=bundle-node --project=bundle-esm --project=bundle-browser",
+    "test:ci": "npm run lint && npm run typecheck && npm test && npm run test:bundles",
+    "test:summary": "vitest run --reporter=tap | grep -E 'not ok|# tests'",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run tests/unit --coverage",
+    "test:coverage:view": "vitest run tests/unit --coverage; open coverage/index.html",
+    "test:coverage:all": "vitest run --coverage",
+    "lint": "eslint src tests --ext .ts",
+    "lint:fix": "eslint src tests --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "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:standard": "npm run bench:build && node benchmarks/dist/bench.cjs --standard",
+    "bench:full": "npm run bench:build && node benchmarks/dist/bench.cjs --full",
+    "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"
+  },
+  "keywords": [
+    "numpy",
+    "array",
+    "ndarray",
+    "matrix",
+    "linear-algebra",
+    "scientific-computing",
+    "math",
+    "statistics",
+    "fft",
+    "typescript",
+    "javascript"
+  ],
+  "author": "Nicolas Dupont",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dupontcyborg/numpy-ts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/dupontcyborg/numpy-ts/issues"
+  },
+  "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",
+    "@vitest/browser": "^4.0.3",
+    "@vitest/browser-playwright": "^4.0.3",
+    "@vitest/coverage-v8": "^4.0.3",
+    "chart.js": "^4.5.1",
+    "chartjs-node-canvas": "^5.0.0",
+    "esbuild": "^0.25.11",
+    "eslint": "^9.38.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.0.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.6",
+    "playwright": "^1.56.1",
+    "prettier": "^3.1.1",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.3"
+  },
+  "dependencies": {
+    "@stdlib/blas": "^0.3.3",
+    "@stdlib/ndarray": "^0.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  }
+}