manim-web 0.3.21 → 0.3.22

package/dist/test-setup/vitest-setup.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Vitest setup file.
+ *
+ * Runs once per worker before any test file imports modules. Skips
+ * environment-dependent patches when the corresponding API is unavailable
+ * (e.g. node-env tests don't have `document`).
+ *
+ * Two concerns live here:
+ *   1. happy-dom polyfills for browser APIs the emulator doesn't implement.
+ *   2. A strict console policy that fails tests on unexpected warn/error.
+ *
+ * Both are idempotent: the file may run more than once per realm if a
+ * future config disables worker isolation, and we don't want shims to stack.
+ */
+declare const SETUP_MARKER: unique symbol;
+type SetupGlobal = typeof globalThis & {
+    [SETUP_MARKER]?: boolean;
+};
+declare const setupGlobal: SetupGlobal;
+//# sourceMappingURL=vitest-setup.d.ts.map

package/dist/test-setup/vitest-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-setup.d.ts","sourceRoot":"","sources":["../../src/test-setup/vitest-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,QAAA,MAAM,YAAY,eAA6C,CAAC;AAChE,KAAK,WAAW,GAAG,OAAO,UAAU,GAAG;IAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AACpE,QAAA,MAAM,WAAW,EAAiB,WAAW,CAAC"}

package/dist/{tex-C4_queV-.js → tex-BQCLd0dF.js}

@@ -1,10 +1,10 @@
-import { a as e, o as t, r as n, t as r } from "./Options-XPptO-6X.js";
-import { r as i } from "./mathjax-CoSFlQ0H.js";
-import { a, h as o, l as s, r as c } from "./mo-CNYDGAsg.js";
-import { t as l } from "./InputJax-DnDWM3Y0.js";
-import { a as u, t as d } from "./Factory-D-whCqrb.js";
-import { A as ee, C as te, D as ne, E as f, F as re, G as ie, H as ae, I as oe, J as se, K as ce, L as le, M as ue, O as p, P as m, Q as h, R as de, S as fe, T as pe, U as g, W as _, X as v, Y as y, Z as b, _ as x, a as S, b as C, c as w, d as T, f as E, g as D, h as O, i as k, j as me, k as A, l as j, m as M, n as N, o as P, p as F, q as I, s as L, t as R, u as z, v as B, w as he, x as V, y as H, z as U } from "./ParseMethods-BMPfzfQC.js";
-import { n as W, r as ge } from "./lengths-CP7zmbxJ.js";
+import { a as e, o as t, r as n, t as r } from "./Options-DMK2wYar.js";
+import { r as i } from "./mathjax-CPQWkQEv.js";
+import { a, h as o, l as s, r as c } from "./mo-hAX79Dzl.js";
+import { t as l } from "./InputJax-D5R2pqUk.js";
+import { a as u, t as d } from "./Factory-Ba6Nqb3M.js";
+import { A as ee, C as te, D as ne, E as f, F as re, G as ie, H as ae, I as oe, J as se, K as ce, L as le, M as ue, O as p, P as m, Q as h, R as de, S as fe, T as pe, U as g, W as _, X as v, Y as y, Z as b, _ as x, a as S, b as C, c as w, d as T, f as E, g as D, h as O, i as k, j as me, k as A, l as j, m as M, n as N, o as P, p as F, q as I, s as L, t as R, u as z, v as B, w as he, x as V, y as H, z as U } from "./ParseMethods-Deqa7kJ6.js";
+import { n as W, r as ge } from "./lengths-D2zTYMUu.js";
 //#region node_modules/@mathjax/src/mjs/core/FindMath.js
 var G = class {
 	constructor(e) {
@@ -790,16 +790,20 @@ new U("letter", R.variable, /[a-z]/i), new U("digit", R.digit, /[0-9.,]/), new U
 		null,
 		Q.MONOSPACE
 	],
-	tiny: [N.SetSize, .5],
-	Tiny: [N.SetSize, .6],
+	Tiny: [N.SetSize, .5],
+	tiny: [N.SetSize, .6],
 	scriptsize: [N.SetSize, .7],
-	small: [N.SetSize, .85],
+	SMALL: [N.SetSize, .7],
+	Small: [N.SetSize, .8],
+	footnotesize: [N.SetSize, .8],
+	small: [N.SetSize, .9],
 	normalsize: [N.SetSize, 1],
-	large: [N.SetSize, 1.2],
-	Large: [N.SetSize, 1.44],
-	LARGE: [N.SetSize, 1.73],
-	huge: [N.SetSize, 2.07],
-	Huge: [N.SetSize, 2.49],
+	large: [N.SetSize, 1.095],
+	Large: [N.SetSize, 1.2],
+	LARGE: [N.SetSize, 1.44],
+	huge: [N.SetSize, 1.728],
+	Huge: [N.SetSize, 2.074],
+	HUGE: [N.SetSize, 2.49],
 	arcsin: N.NamedFn,
 	arccos: N.NamedFn,
 	arctan: N.NamedFn,

package/dist/{tex-CA5MLeEe.js → tex-Cd_bTYKG.js}

@@ -1,10 +1,10 @@
-import { a as e, o as t, r as n, t as r } from "./Options-DRlTi0G8.js";
-import { r as i } from "./mathjax-7LgaTjtj.js";
-import { a, h as o, l as s, r as c } from "./mo-C5uLT3Z9.js";
-import { t as l } from "./InputJax-DL9oUQY4.js";
-import { a as u, t as d } from "./Factory-BKM7FEO-.js";
-import { A as ee, C as te, D as ne, E as f, F as re, G as ie, H as ae, I as oe, J as se, K as ce, L as le, M as ue, O as p, P as m, Q as h, R as de, S as fe, T as pe, U as g, W as _, X as v, Y as y, Z as b, _ as x, a as S, b as C, c as w, d as T, f as E, g as D, h as O, i as k, j as me, k as A, l as j, m as M, n as N, o as P, p as F, q as I, s as L, t as R, u as z, v as B, w as he, x as V, y as H, z as U } from "./ParseMethods-D3_HeS1K.js";
-import { n as W, r as ge } from "./lengths-D4tR1gYA.js";
+import { a as e, o as t, r as n, t as r } from "./Options-DMK2wYar.js";
+import { r as i } from "./mathjax-b-GTdZgw.js";
+import { a, h as o, l as s, r as c } from "./mo-D4wFHS6V.js";
+import { t as l } from "./InputJax-jNvwWU5P.js";
+import { a as u, t as d } from "./Factory-Ba6Nqb3M.js";
+import { A as ee, C as te, D as ne, E as f, F as re, G as ie, H as ae, I as oe, J as se, K as ce, L as le, M as ue, O as p, P as m, Q as h, R as de, S as fe, T as pe, U as g, W as _, X as v, Y as y, Z as b, _ as x, a as S, b as C, c as w, d as T, f as E, g as D, h as O, i as k, j as me, k as A, l as j, m as M, n as N, o as P, p as F, q as I, s as L, t as R, u as z, v as B, w as he, x as V, y as H, z as U } from "./ParseMethods-Dt5bYDSZ.js";
+import { n as W, r as ge } from "./lengths-D2zTYMUu.js";
 //#region node_modules/@mathjax/src/mjs/core/FindMath.js
 var G = class {
 	constructor(e) {
@@ -790,16 +790,20 @@ new U("letter", R.variable, /[a-z]/i), new U("digit", R.digit, /[0-9.,]/), new U
 		null,
 		Q.MONOSPACE
 	],
-	tiny: [N.SetSize, .5],
-	Tiny: [N.SetSize, .6],
+	Tiny: [N.SetSize, .5],
+	tiny: [N.SetSize, .6],
 	scriptsize: [N.SetSize, .7],
-	small: [N.SetSize, .85],
+	SMALL: [N.SetSize, .7],
+	Small: [N.SetSize, .8],
+	footnotesize: [N.SetSize, .8],
+	small: [N.SetSize, .9],
 	normalsize: [N.SetSize, 1],
-	large: [N.SetSize, 1.2],
-	Large: [N.SetSize, 1.44],
-	LARGE: [N.SetSize, 1.73],
-	huge: [N.SetSize, 2.07],
-	Huge: [N.SetSize, 2.49],
+	large: [N.SetSize, 1.095],
+	Large: [N.SetSize, 1.2],
+	LARGE: [N.SetSize, 1.44],
+	huge: [N.SetSize, 1.728],
+	Huge: [N.SetSize, 2.074],
+	HUGE: [N.SetSize, 2.49],
 	arcsin: N.NamedFn,
 	arccos: N.NamedFn,
 	arctan: N.NamedFn,

package/dist/utils/axis.d.ts

@@ -0,0 +1,4 @@
+export type AxisName = 'x' | 'y' | 'z';
+export declare function axisVector(axis: AxisName): [number, number, number];
+export declare function axisVectorFromEulerKey(key: 'X' | 'Y' | 'Z'): [number, number, number];
+//# sourceMappingURL=axis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"axis.d.ts","sourceRoot":"","sources":["../../src/utils/axis.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEvC,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CASnE;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAErF"}

package/dist/utils/logger.d.ts

@@ -3,12 +3,49 @@
  * Provides consistent logging interface for both browser and Node environments.
  * Includes log sanitization to redact sensitive data (tokens, keys, emails).
  */
+/** Severity of a log message. */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
 interface Logger {
     debug: (...args: unknown[]) => void;
     info: (...args: unknown[]) => void;
     warn: (...args: unknown[]) => void;
     error: (...args: unknown[]) => void;
 }
+/**
+ * A single log event delivered to {@link onLog} listeners. Every field is a
+ * primitive, so an entry is always safe to `JSON.stringify`.
+ */
+export interface LogEntry {
+    /** Severity of the log call. */
+    level: LogLevel;
+    /** Sanitized, human-readable message built from all log arguments. */
+    message: string;
+    /** Unix epoch milliseconds (`Date.now()`) when the log call happened. */
+    timestamp: number;
+}
+/** Callback invoked for every log message that passes the level filter. */
+export type LogListener = (entry: LogEntry) => void;
+/**
+ * Register a callback that receives every log message (at or above the active
+ * `LOG_LEVEL`). The forwarded {@link LogEntry} is sanitized, so secrets are
+ * never leaked to a remote endpoint.
+ *
+ * @returns An unsubscribe function that removes the listener.
+ *
+ * @example
+ * ```ts
+ * import { onLog } from 'manim-web';
+ *
+ * const stop = onLog((entry) =>
+ *   fetch('/__log', { method: 'POST', body: JSON.stringify(entry) }),
+ * );
+ * // ...later
+ * stop();
+ * ```
+ */
+export declare function onLog(listener: LogListener): () => void;
+/** Remove all registered {@link onLog} listeners. */
+export declare function clearLogListeners(): void;
 export declare const logger: Logger;
 export {};
 //# sourceMappingURL=logger.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,UAAU,MAAM;IACd,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC;AAwGD,eAAO,MAAM,MAAM,EAAE,MAapB,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iCAAiC;AACjC,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,UAAU,MAAM;IACd,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,gCAAgC;IAChC,KAAK,EAAE,QAAQ,CAAC;IAChB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,2EAA2E;AAC3E,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AA4LpD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,IAAI,CAKvD;AAED,qDAAqD;AACrD,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAwCD,eAAO,MAAM,MAAM,EAAE,MAKpB,CAAC"}

package/dist/utils/math.d.ts

@@ -1,5 +1,9 @@
 /**
  * Shared math utility functions used across the codebase.
+ *
+ * For low-level 3-vector ops (dot, cross, length, normalize, perpendicular,
+ * orthonormal frame, 2D orientation), prefer `src/utils/vectors.ts`. The
+ * helpers in this file build on top of that module.
  */
 /**
  * Linear interpolation between two numbers.

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;;;;;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"}
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;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,CAOlB;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,CA4BA"}

package/dist/utils/vectors.d.ts

@@ -1,4 +1,4 @@
-import { Vector3Tuple } from '../core/Mobject';
+import { Vector3Tuple } from '../core/MobjectTypes';
 /**
  * Scale a direction vector by a scalar.
  *
@@ -39,6 +39,59 @@ export declare function addVec(...vecs: Vector3Tuple[]): Vector3Tuple;
  * ```
  */
 export declare function subVec(a: Vector3Tuple, b: Vector3Tuple): Vector3Tuple;
+/**
+ * 3D dot product (a · b). Accepts plain number arrays so callers that use
+ * `number[]` (e.g. internal helpers in `math.ts`) can share the same impl.
+ *
+ * Missing components default to `0` so 2D points (`[x, y]`) are handled.
+ */
+export declare function dotVec(a: ArrayLike<number>, b: ArrayLike<number>): number;
+/**
+ * 3D cross product (a × b). Right-handed:
+ *   x = a.y*b.z − a.z*b.y, y = a.z*b.x − a.x*b.z, z = a.x*b.y − a.y*b.x.
+ */
+export declare function crossVec(a: ArrayLike<number>, b: ArrayLike<number>): Vector3Tuple;
+/**
+ * Euclidean length |v|. Missing components default to `0`.
+ */
+export declare function lengthVec(v: ArrayLike<number>): number;
+/**
+ * Return `v` normalised to unit length. If `|v|` is below `eps` the supplied
+ * `fallback` is returned (default `[0, 0, 0]`); the caller decides whether to
+ * treat that as an error.
+ */
+export declare function normalizeVec(v: ArrayLike<number>, fallback?: Vector3Tuple, eps?: number): Vector3Tuple;
+/**
+ * Return a unit vector perpendicular to `n`.
+ *
+ * Picked by Gram–Schmidt against whichever world basis vector has the
+ * smallest |dot(n, e_i)|, then normalized. This is coordinate-free in
+ * spirit — it never uses a hard "is the input close to Z?" branch — but it
+ * does pick from the world basis, so the result can change discontinuously
+ * very near a tie. Treat as "give me *some* perpendicular unit vector"
+ * rather than a temporally-stable frame.
+ */
+export declare function unitPerpendicularTo(n: Vector3Tuple, eps?: number): Vector3Tuple;
+/**
+ * Build a right-handed orthonormal frame `{u, v, n}` around the given
+ * normal. `n` is normalised; `u = unitPerpendicularTo(n)`; `v = n × u`.
+ *
+ * Use this instead of writing axis-equal-to-Z special cases in caller code.
+ */
+export declare function orthonormalFrame(normal: Vector3Tuple): {
+    u: Vector3Tuple;
+    v: Vector3Tuple;
+    n: Vector3Tuple;
+};
+/**
+ * 2D orientation predicate (signed twice-area of triangle o-a-b).
+ * Positive: counter-clockwise. Negative: clockwise. Zero: collinear.
+ *
+ * Mathematically this is the z-component of the cross product of
+ * (a-o) and (b-o) — kept as its own helper because it is an orientation
+ * test, not a general vector operation.
+ */
+export declare function orientation2D(o: ArrayLike<number>, a: ArrayLike<number>, b: ArrayLike<number>): number;
 /**
  * Create an array of evenly spaced values (NumPy linspace equivalent).
  *

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

@@ -1 +1 @@
-{"version":3,"file":"vectors.d.ts","sourceRoot":"","sources":["../../src/utils/vectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,YAAY,CAExE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,GAAG,IAAI,EAAE,YAAY,EAAE,GAAG,YAAY,CAU5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,YAAY,CAErE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAG3E"}
+{"version":3,"file":"vectors.d.ts","sourceRoot":"","sources":["../../src/utils/vectors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,YAAY,CAExE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,GAAG,IAAI,EAAE,YAAY,EAAE,GAAG,YAAY,CAU5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,YAAY,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAEzE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,YAAY,CAQjF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAKtD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EACpB,QAAQ,GAAE,YAAwB,EAClC,GAAG,SAAQ,GACV,YAAY,CAId;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,SAAQ,GAAG,YAAY,CAiB9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG;IACtD,CAAC,EAAE,YAAY,CAAC;IAChB,CAAC,EAAE,YAAY,CAAC;IAChB,CAAC,EAAE,YAAY,CAAC;CACjB,CAKA;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EACpB,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EACpB,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GACnB,MAAM,CAKR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAG3E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "manim-web",
-  "version": "0.3.21",
+  "version": "0.3.22",
   "description": "Manim-like mathematical animation library for the web",
   "type": "module",
   "main": "dist/index.js",
@@ -44,8 +44,8 @@
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
     "format": "prettier --write src/",
-    "docs": "node scripts/generate-example-docs.mjs && cd docs && npm run build",
-    "docs:dev": "node scripts/generate-example-docs.mjs && cd docs && npm start",
+    "docs": "npm run build && node scripts/generate-example-docs.mjs && cd docs && npm run build",
+    "docs:dev": "npm run build && node scripts/generate-example-docs.mjs && cd docs && npm start",
     "docs:examples": "node scripts/generate-example-docs.mjs",
     "lint:strict": "eslint src/ --max-warnings 106",
     "circular": "madge --circular --extensions ts src/",
@@ -68,9 +68,10 @@
     "@mathjax/src": "^4.1.1",
     "earcut": "^3.0.2",
     "gif.js": "^0.2.0",
-    "katex": "^0.16.28",
-    "opentype.js": "^1.3.4",
+    "katex": "^0.17.0",
+    "opentype.js": "^2.0.0",
     "polygon-clipping": "^0.15.7",
+    "typia": "^12.1.1",
     "three": "^0.184.0"
   },
   "devDependencies": {
@@ -87,13 +88,14 @@
     "husky": "^9.1.7",
     "jscpd": "^4.0.8",
     "knip": "^6.1.0",
-    "lint-staged": "^16.2.7",
+    "lint-staged": "^17.0.4",
     "madge": "^8.0.0",
     "prettier": "^3.8.1",
     "standard-version": "^9.5.0",
     "typedoc": "^0.28.16",
     "typescript": "^5.3.0",
     "typescript-eslint": "^8.54.0",
+    "@typia/unplugin": "^12.1.1",
     "vite": "^8.0.8",
     "vite-plugin-dts": "^5.0.0",
     "vitest": "^4.0.18",

package/dist/Factory-D-whCqrb.js

@@ -1,107 +0,0 @@
-//#region node_modules/@mathjax/src/mjs/core/MathItem.js
-function e(e, t, n, r, i, a, o = null) {
-	return {
-		open: e,
-		math: t,
-		close: n,
-		n: r,
-		start: { n: i },
-		end: { n: a },
-		display: o
-	};
-}
-var t = class {
-	get isEscaped() {
-		return this.display === null;
-	}
-	constructor(e, t, r = !0, i = {
-		i: 0,
-		n: 0,
-		delim: ""
-	}, a = {
-		i: 0,
-		n: 0,
-		delim: ""
-	}) {
-		this.root = null, this.typesetRoot = null, this.metrics = {}, this.inputData = {}, this.outputData = {}, this._state = n.UNPROCESSED, this.math = e, this.inputJax = t, this.display = r, this.start = i, this.end = a, this.root = null, this.typesetRoot = null, this.metrics = {}, this.inputData = {}, this.outputData = {};
-	}
-	render(e) {
-		e.renderActions.renderMath(this, e);
-	}
-	rerender(e, t = n.RERENDER) {
-		this.state() >= t && this.state(t - 1), e.renderActions.renderMath(this, e, t);
-	}
-	convert(e, t = n.LAST) {
-		e.renderActions.renderConvert(this, e, t);
-	}
-	compile(e) {
-		this.state() < n.COMPILED && (this.root = this.inputJax.compile(this, e), this.state(n.COMPILED));
-	}
-	typeset(e) {
-		this.state() < n.TYPESET && (this.typesetRoot = e.outputJax[this.isEscaped ? "escaped" : "typeset"](this, e), this.state(n.TYPESET));
-	}
-	updateDocument(e) {}
-	removeFromDocument(e = !1) {
-		this.clear();
-	}
-	setMetrics(e, t, n, r) {
-		this.metrics = {
-			em: e,
-			ex: t,
-			containerWidth: n,
-			scale: r
-		};
-	}
-	state(e = null, t = !1) {
-		return e != null && (e < n.INSERTED && this._state >= n.INSERTED && this.removeFromDocument(t), e < n.TYPESET && this._state >= n.TYPESET && (this.outputData = {}), e < n.COMPILED && this._state >= n.COMPILED && (this.inputData = {}), this._state = e), this._state;
-	}
-	reset(e = !1) {
-		this.state(n.UNPROCESSED, e);
-	}
-	clear() {}
-}, n = {
-	UNPROCESSED: 0,
-	FINDMATH: 10,
-	COMPILED: 20,
-	CONVERT: 100,
-	METRICS: 110,
-	RERENDER: 125,
-	TYPESET: 150,
-	INSERTED: 200,
-	LAST: 1e4
-};
-function r(e, t) {
-	if (e in n) throw Error("State " + e + " already exists");
-	n[e] = t;
-}
-//#endregion
-//#region node_modules/@mathjax/src/mjs/core/Tree/Factory.js
-var i = class {
-	constructor(e = null) {
-		this.defaultKind = "unknown", this.nodeMap = /* @__PURE__ */ new Map(), this.node = {}, e === null && (e = this.constructor.defaultNodes);
-		for (let t of Object.keys(e)) this.setNodeClass(t, e[t]);
-	}
-	create(e, ...t) {
-		return (this.node[e] || this.node[this.defaultKind])(...t);
-	}
-	setNodeClass(e, t) {
-		this.nodeMap.set(e, t);
-		let n = this.nodeMap.get(e);
-		this.node[e] = (...e) => new n(this, ...e);
-	}
-	getNodeClass(e) {
-		return this.nodeMap.get(e);
-	}
-	deleteNodeClass(e) {
-		this.nodeMap.delete(e), delete this.node[e];
-	}
-	nodeIsKind(e, t) {
-		return e instanceof this.getNodeClass(t);
-	}
-	getKinds() {
-		return Array.from(this.nodeMap.keys());
-	}
-};
-i.defaultNodes = {};
-//#endregion
-export { e as a, r as i, t as n, n as r, i as t };