@emasoft/svg-matrix 1.0.1 → 1.0.3

package/CLAUDE.md

@@ -1,60 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-svg-matrix is an arbitrary-precision matrix, vector, and affine transformation library for JavaScript using decimal.js. It provides Decimal-backed Matrix and Vector classes along with 2D (3x3) and 3D (4x4) transform helpers for geometry operations requiring high precision.
-
-## Commands
-
-```bash
-# Install dependencies
-npm install
-
-# Run tests (executes test/examples.js)
-npm test
-
-# CI test (clean install + test)
-npm run ci-test
-```
-
-## Architecture
-
-### Core Classes (src/)
-
-**Matrix** (`matrix.js`) - Decimal-backed matrix class with:
-- Factory methods: `Matrix.from()`, `Matrix.zeros()`, `Matrix.identity()`
-- Operations: `add()`, `sub()`, `mul()`, `transpose()`, `inverse()`, `clone()`
-- Linear algebra: `lu()` (LU decomposition), `qr()` (QR via Householder), `determinant()`, `solve()`, `exp()` (matrix exponential)
-- Vector application: `applyToVector()`
-
-**Vector** (`vector.js`) - Decimal-backed vector class with:
-- Basic ops: `add()`, `sub()`, `scale()`, `dot()`, `cross()`, `outer()`
-- Geometry: `norm()`, `normalize()`, `angleBetween()`, `projectOnto()`, `orthogonal()`
-- Conversion: `toArray()`, `toNumberArray()`, `toStringArray()`
-
-### Transform Helpers
-
-**Transforms2D** (`transforms2d.js`) - 3x3 affine matrices:
-- `translation(tx, ty)`, `scale(sx, sy)`, `rotate(theta)`, `rotateAroundPoint()`, `skew()`, `stretchAlongAxis()`
-- `applyTransform(M, x, y)` - applies matrix to 2D point with homogeneous division
-
-**Transforms3D** (`transforms3d.js`) - 4x4 affine matrices:
-- `translation(tx, ty, tz)`, `scale(sx, sy, sz)`, `rotateAroundAxis(ux, uy, uz, theta)`
-
-### Key Patterns
-
-All numeric inputs are converted to Decimal via the helper `const D = x => (x instanceof Decimal ? x : new Decimal(x))`. This allows passing numbers, strings, or Decimal instances.
-
-Transform composition uses right-to-left multiplication: `T.mul(R).mul(S)` applies S first, then R, then T.
-
-## Dependencies
-
-- **decimal.js** (^11.4.3) - Arbitrary-precision decimal arithmetic (runtime)
-- **@actions/oidc-client** - GitHub Actions OIDC for npm publishing (dev)
-- **node-fetch** - For npm token retrieval scripts (dev)
-
-## Publishing
-
-Releases are triggered by pushing version tags (`v*`). The publish workflow uses npm OIDC trusted publishing (Node 24 / npm 11.6+).

package/SVG-MATRIX/README.md

@@ -1,22 +0,0 @@
-# SVG-MATRIX
-
-Arbitrary-precision matrix, vector and affine transformation library for JavaScript using decimal.js.
-
-This repository contains:
-- Decimal-backed Matrix and Vector classes.
-- 2D (3x3) and 3D (4x4) transform helpers.
-- Examples and GitHub Actions workflows:
-  - .github/workflows/test.yml  => runs tests/examples on push/PR
-  - .github/workflows/publish.yml => publishes to npm via OIDC trusted publishing on tag push
-
-Install
-  npm ci
-
-Usage example:
-```js
-import { Decimal, Matrix, Vector, Transforms2D } from 'svg-matrix';
-Decimal.set({ precision: 80 });
-
-const M = Transforms2D.translation(2, 3).mul(Transforms2D.rotate(Math.PI/4)).mul(Transforms2D.scale(1.5));
-const p2 = Transforms2D.applyTransform(M, 1, 0);
-console.log('Transformed point:', p2.map(x => x.toString()));

package/SVG-MATRIX/package.json

@@ -1,33 +0,0 @@
-{
-  "name": "svg-matrix",
-  "version": "1.0.0",
-  "description": "Arbitrary-precision matrix, vector and affine transformation library for JavaScript using decimal.js",
-  "type": "module",
-  "main": "src/index.js",
-  "scripts": {
-    "test": "node test/examples.js",
-    "ci-test": "npm ci && npm test",
-    "prepublishOnly": "npm test"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Emasoft/SVG-MATRIX.git"
-  },
-  "keywords": [
-    "matrix",
-    "vector",
-    "arbitrary-precision",
-    "decimal",
-    "linear-algebra",
-    "affine",
-    "transform",
-    "svg",
-    "geometry"
-  ],
-  "author": "Emasoft",
-  "license": "MIT",
-  "dependencies": {
-    "decimal.js": "^11.4.3"
-  },
-  "devDependencies": {}
-}

package/npm-shrinkwrap.json

@@ -1,22 +0,0 @@
-{
-  "name": "@emasoft/svg-matrix",
-  "version": "1.0.1",
-  "lockfileVersion": 3,
-  "requires": true,
-  "packages": {
-    "": {
-      "name": "@emasoft/svg-matrix",
-      "version": "1.0.1",
-      "license": "MIT",
-      "dependencies": {
-        "decimal.js": "^10.6.0"
-      }
-    },
-    "node_modules/decimal.js": {
-      "version": "10.6.0",
-      "resolved": "https://registry.npmjs.org/decimal.js/-/decimal.js-10.6.0.tgz",
-      "integrity": "sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg==",
-      "license": "MIT"
-    }
-  }
-}

package/scripts/bootstrap_repo.sh

@@ -1,99 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# bootstrap_repo.sh
-# Creates a new repository (owner/repo), populates it with SVG-MATRIX files,
-# commits and pushes initial branch, and optionally sets OIDC secrets.
-#
-# Requirements:
-#  - gh CLI authenticated (gh auth status)
-#  - git installed
-#  - node/npm not required to run script (only to run tests later)
-#
-# Usage:
-#   OWNER=Emasoft REPO=SVG-MATRIX ./bootstrap_repo.sh
-# Optional env vars:
-#   VISIBILITY (public|private) default: public
-#   BRANCH default: main
-#   NPM_OIDC_TOKEN_URL and NPM_OIDC_AUDIENCE - optional secrets to set in the repo (if provided they'll be added)
-
-OWNER="${OWNER:-Emasoft}"
-REPO="${REPO:-SVG-MATRIX}"
-VISIBILITY="${VISIBILITY:-public}"
-BRANCH="${BRANCH:-main}"
-DIR="${REPO}"
-
-echo "Bootstrap repo: ${OWNER}/${REPO} (visibility=${VISIBILITY}, branch=${BRANCH})"
-
-# check prerequisites
-if ! command -v gh >/dev/null 2>&1; then
-  echo "gh CLI not found. Install and authenticate (gh auth login) and try again."
-  exit 1
-fi
-if ! command -v git >/dev/null 2>&1; then
-  echo "git not found. Please install git and try again."
-  exit 1
-fi
-
-# check gh auth
-if ! gh auth status >/dev/null 2>&1; then
-  echo "gh CLI not authenticated. Run: gh auth login"
-  gh auth status || true
-  exit 1
-fi
-
-# create local dir (safe)
-if [ -d "${DIR}" ]; then
-  echo "Directory ${DIR} already exists. Please remove or move it and re-run, or run in a different location."
-  exit 1
-fi
-
-mkdir "${DIR}"
-cd "${DIR}"
-
-# create files (each file is written with a here-doc)
-mkdir -p src test .github/workflows scripts
-
-cat > .gitignore <<'EOF'
-node_modules
-dist
-.DS_Store
-.env
-EOF
-
-cat > package.json <<'EOF'
-{
-  "name": "svg-matrix",
-  "version": "1.0.0",
-  "description": "Arbitrary-precision matrix, vector and affine transformation library for JavaScript using decimal.js",
-  "type": "module",
-  "main": "src/index.js",
-  "scripts": {
-    "test": "node test/examples.js",
-    "ci-test": "npm ci && npm test",
-    "prepublishOnly": "npm test"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Emasoft/SVG-MATRIX.git"
-  },
-  "keywords": [
-    "matrix",
-    "vector",
-    "arbitrary-precision",
-    "decimal",
-    "linear-algebra",
-    "affine",
-    "transform",
-    "svg",
-    "geometry"
-  ],
-  "author": "Emasoft",
-  "license": "MIT",
-  "dependencies": {
-    "decimal.js": "^11.4.3"
-  },
-  "devDependencies": {}
-}
-EOF
-

package/test/example.js

@@ -1,18 +0,0 @@
-import { Matrix, Decimal } from '../src/index.js';
-
-Decimal.set({ precision: 40 });
-
-const A = Matrix.from([[1.234567890123456789, 2.34567890123456789], [3.4567890123456789, 4.567890123456789]]);
-console.log('A:', A.toArrayOfStrings());
-
-const det = A.determinant();
-console.log('det(A):', det.toString());
-
-const inv = A.inverse();
-console.log('inv(A):', inv.toArrayOfStrings());
-
-const x = A.solve([1, 2]);
-console.log('solution x for Ax=[1,2]:', x.toArrayOfStrings());
-
-const B = Matrix.from([[1, 0], [0, 1]]);
-console.log('A * inv(A):', A.mul(inv).toArrayOfStrings());

package/test/examples.js

@@ -1,50 +0,0 @@
-import Decimal from 'decimal.js';
-import { Matrix, Vector, Transforms2D, Transforms3D } from '../src/index.js';
-
-Decimal.set({ precision: 80 });
-
-// Vector operations
-const v = Vector.from(['1.234567890123456789', '2.34567890123456789', '3.4567890123456789']);
-const w = Vector.from(['3.333333333333333333', '4.444444444444444444', '5.555555555555555555']);
-console.log('v =', v.toStringArray());
-console.log('w =', w.toStringArray());
-console.log('dot(v,w) =', v.dot(w).toString());
-console.log('v cross w =', v.cross(w).toStringArray());
-console.log('v norm =', v.norm().toString());
-console.log('normalized v =', v.normalize().toStringArray());
-console.log('angle(v,w) =', v.angleBetween(w).toString());
-
-// Matrix * vector
-const M = Matrix.from([[1.5, 0, 0], [0, 2.5, 0], [0, 0, 3.5]]);
-const mv = M.applyToVector(v);
-console.log('M * v =', mv.toStringArray());
-
-// 2D transforms: concatenation and inverse
-const T = Transforms2D.translation(2, 3);
-const R = Transforms2D.rotate(Math.PI / 4);
-const S = Transforms2D.scale('1.5');
-const M2 = T.mul(R).mul(S);
-console.log('Combined 2D M2:', M2.toArrayOfStrings());
-const p = [1, 0];
-const p2 = Transforms2D.applyTransform(M2, ...p);
-console.log('Point', p, '->', p2.map(x => x.toString()));
-const Minv = M2.inverse();
-const pBack = Transforms2D.applyTransform(Minv, ...p2);
-console.log('Back:', pBack.map(x => x.toString()));
-
-// 3D example
-const R3 = Transforms3D.rotateAroundAxis(1, 1, 0, Math.PI / 3);
-const T3 = Transforms3D.translation('0.5', '1.2', '3.4');
-const M3 = T3.mul(R3);
-console.log('3D transform M3:', M3.toArrayOfStrings());
-
-// Matrix exponential example (2x2 rot generator)
-const A = Matrix.from([[0, -1], [1, 0]]);
-const expA = A.exp();
-console.log('exp(A) approx rotation:', expA.toArrayOfStrings());
-
-// Solve linear system
-const B = Matrix.from([[4, 7], [2, 6]]);
-const bvec = [1, 1];
-const x = B.solve(bvec);
-console.log('Solution x for B x = b:', x.toStringArray());