manim-web 0.3.19 → 0.3.21

package/dist/utils/math.d.ts

@@ -11,6 +11,13 @@ export declare function lerp(a: number, b: number, t: number): number;
  * Each point is represented as a number array [x, y, z].
  */
 export declare function lerpPoint(a: number[], b: number[], t: number): number[];
+/**
+ * Compute signed 2D polygon area from points sampled with a fixed stride.
+ *
+ * Example: cubic Bezier control points use stride=3 to select anchors.
+ * Positive = counter-clockwise, negative = clockwise.
+ */
+export declare function signedArea2DFromStride(points: number[][], stride?: number): number;
 /**
  * Hermite smoothstep interpolation.
  * Maps t in [0, 1] to a smooth S-curve: 3t^2 - 2t^3.
@@ -40,6 +47,13 @@ export declare function coordsToPoint(x: number, y: number, xRange: [number, num
  * @returns Graph coordinates [x, y]
  */
 export declare function pointToCoords(point: [number, number, number], xRange: [number, number, ...number[]], yRange: [number, number, ...number[]], xLength: number, yLength: number): [number, number];
+/**
+ * Apply a 2x2 or 3x3 transformation matrix to a single point,
+ * relative to an aboutPoint (defaults to origin).
+ *
+ * Returns the original point unchanged if the matrix dimensions are invalid.
+ */
+export declare function transformPointByMatrix(point: number[], matrix: number[][], aboutPoint?: number[]): number[];
 /**
  * Evaluate a cubic Bezier curve at parameter t.
  * Uses the standard cubic Bernstein polynomial:
@@ -48,12 +62,43 @@ export declare function pointToCoords(point: [number, number, number], xRange: [
  * The z-component uses nullish coalescing (p[2] ?? 0) so that 2D points
  * (without an explicit z) are handled safely.
  */
+export declare function evalCubicBezier(p0: number[], p1: number[], p2: number[], p3: number[], t: number): number[];
 /**
- * Apply a 2x2 or 3x3 transformation matrix to a single point,
- * relative to an aboutPoint (defaults to origin).
+ * Select 3 maximally scattered points from a point set.
  *
- * Returns the original point unchanged if the matrix dimensions are invalid.
+ * Algorithm: first point → furthest from first → furthest from both.
+ * This tends to pick a wide triangle, which gives a more stable plane basis.
+ *
+ * @returns Indices of 3 scattered points (fewer if not enough input)
  */
-export declare function transformPointByMatrix(point: number[], matrix: number[][], aboutPoint?: number[]): number[];
-export declare function evalCubicBezier(p0: number[], p1: number[], p2: number[], p3: number[], t: number): number[];
+export declare function selectScatteredPoints(points: number[][]): number[];
+/**
+ * Extract two vectors from 3 points [p0, p1, p2]: v1 = p1-p0, v2 = p2-p0.
+ * These span the plane containing the points.
+ * Returns null if < 3 points.
+ */
+export declare function extractVectorsFrom3Points(points: number[][]): {
+    v1: number[];
+    v2: number[];
+} | null;
+/**
+ * Project a 3D point onto a 2D plane basis.
+ *
+ * @param point - 3D point to project
+ * @param origin - Plane origin point
+ * @param v1 - First basis vector (becomes x-axis)
+ * @param v2 - Second basis vector (becomes y-axis)
+ * @returns [u, v] coordinates on the plane
+ */
+export declare function projectToPlane(point: number[], origin: number[], v1: number[], v2: number[]): [number, number];
+/**
+ * Get orthonormalized basis vectors from two spanning vectors.
+ * Uses Gram-Schmidt: normalizes v1, then makes v2 orthogonal to v1 and normalizes.
+ *
+ * @returns Object with orthonormal v1, v2 and the original (for reversal)
+ */
+export declare function orthonormalizeBasis(v1: number[], v2: number[]): {
+    v1: number[];
+    v2: number[];
+};
 //# sourceMappingURL=math.d.ts.map

package/dist/utils/math.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EACrC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAQ1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC/B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EACrC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,CAAC,MAAM,EAAE,MAAM,CAAC,CAQlB;AAED;;;;;;;GAOG;AACH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,MAAM,EAAE,EAAE,EAClB,UAAU,GAAE,MAAM,EAAc,GAC/B,MAAM,EAAE,CAoBV;AAED,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EAAE,EACZ,EAAE,EAAE,MAAM,EAAE,EACZ,EAAE,EAAE,MAAM,EAAE,EACZ,EAAE,EAAE,MAAM,EAAE,EACZ,CAAC,EAAE,MAAM,GACR,MAAM,EAAE,CAeV"}
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,SAAI,GAAG,MAAM,CAe7E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EACrC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAQ1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC/B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EACrC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,CAAC,MAAM,EAAE,MAAM,CAAC,CAQlB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,MAAM,EAAE,EAAE,EAClB,UAAU,GAAE,MAAM,EAAc,GAC/B,MAAM,EAAE,CAoBV;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EAAE,EACZ,EAAE,EAAE,MAAM,EAAE,EACZ,EAAE,EAAE,MAAM,EAAE,EACZ,EAAE,EAAE,MAAM,EAAE,EACZ,CAAC,EAAE,MAAM,GACR,MAAM,EAAE,CAeV;AAMD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAuBlE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EAAE,EAAE,GACjB;IAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IAAC,EAAE,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAOvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,MAAM,EAAE,EAChB,EAAE,EAAE,MAAM,EAAE,EACZ,EAAE,EAAE,MAAM,EAAE,GACX,CAAC,MAAM,EAAE,MAAM,CAAC,CAQlB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,MAAM,EAAE,EACZ,EAAE,EAAE,MAAM,EAAE,GACX;IACD,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;CACd,CAsBA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "manim-web",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "description": "Manim-like mathematical animation library for the web",
   "type": "module",
   "main": "dist/index.js",
@@ -8,6 +8,7 @@
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
@@ -64,13 +65,13 @@
     ]
   },
   "dependencies": {
+    "@mathjax/src": "^4.1.1",
     "earcut": "^3.0.2",
     "gif.js": "^0.2.0",
     "katex": "^0.16.28",
-    "mathjax-full": "^3.2.1",
     "opentype.js": "^1.3.4",
     "polygon-clipping": "^0.15.7",
-    "three": "^0.183.2"
+    "three": "^0.184.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
@@ -78,7 +79,7 @@
     "@types/earcut": "^3.0.0",
     "@types/katex": "^0.16.8",
     "@types/react": "^19.2.13",
-    "@types/three": "^0.182.0",
+    "@types/three": "^0.184.0",
     "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^10.0.2",
     "eslint-config-prettier": "^10.1.8",
@@ -94,7 +95,7 @@
     "typescript": "^5.3.0",
     "typescript-eslint": "^8.54.0",
     "vite": "^8.0.8",
-    "vite-plugin-dts": "^4.5.4",
+    "vite-plugin-dts": "^5.0.0",
     "vitest": "^4.0.18",
     "vue": "^3.0.0"
   },