manim-web 0.2.0 → 0.3.0

package/dist/mobjects/text/MathTexSVG.d.ts

@@ -0,0 +1,95 @@
+import { VGroup } from '../../core/VGroup';
+import { Vector3Tuple } from '../../core/Mobject';
+export interface MathTexSVGOptions {
+    /** LaTeX string or array of strings for multi-part expressions. */
+    latex: string | string[];
+    /** Color as CSS color string. Default: WHITE ('#ffffff') */
+    color?: string;
+    /** Scale factor (1 = standard math size). Default: 1 */
+    fontSize?: number;
+    /** Use display mode (block) vs inline mode. Default: true */
+    displayMode?: boolean;
+    /** Position in 3D space. Default: [0,0,0] */
+    position?: Vector3Tuple;
+    /** Stroke width for glyph outlines. Default: 2 */
+    strokeWidth?: number;
+    /** Fill opacity for glyph interiors. Default: 1 */
+    fillOpacity?: number;
+    /** Explicit target height in world units. Overrides fontSize scaling. */
+    height?: number;
+    /** Custom LaTeX macros as { name: expansion }. */
+    macros?: Record<string, string>;
+}
+export declare class MathTexSVG extends VGroup {
+    protected _latex: string;
+    protected _fontSize: number;
+    protected _displayMode: boolean;
+    protected _color: string;
+    protected _svgStrokeWidth: number;
+    protected _svgFillOpacity: number;
+    protected _targetHeight: number | undefined;
+    protected _macros: Record<string, string> | undefined;
+    /** Whether this is a multi-part MathTexSVG (created from string[]) */
+    protected _isMultiPart: boolean;
+    /** Child part groups (only when _isMultiPart is true) */
+    protected _parts: VGroup[];
+    /** Promise that resolves when rendering is complete */
+    protected _renderPromise: Promise<void> | null;
+    constructor(options: MathTexSVGOptions);
+    /**
+     * Wait for the LaTeX to finish rendering.
+     */
+    waitForRender(): Promise<void>;
+    /**
+     * Get a sub-part of a multi-part expression.
+     * Only available when created with a string array.
+     * Returns a VGroup with setColor() support.
+     */
+    getPart(index: number): VGroup;
+    /**
+     * Get the number of parts.
+     */
+    getPartCount(): number;
+    /**
+     * Get the LaTeX string.
+     */
+    getLatex(): string;
+    /**
+     * Override setColor to propagate to all VMobject children (fill + stroke).
+     */
+    setColor(color: string): this;
+    /**
+     * Start the async rendering process.
+     */
+    protected _startRender(): void;
+    /**
+     * Render the LaTeX to VMobject paths.
+     */
+    protected _render(): Promise<void>;
+    /**
+     * Restyle all VMobject children for solid glyph rendering.
+     */
+    protected _restyleChildren(group: VGroup): void;
+    /**
+     * Scale and center the assembled paths by transforming actual point data.
+     */
+    protected _scaleToTarget(): void;
+    /**
+     * Render a multi-part expression by:
+     * 1. Rendering the FULL expression as one MathJax call (correct layout)
+     * 2. Rendering each part separately to count its glyphs
+     * 3. Splitting the full expression's VMobjects into part groups by glyph count
+     */
+    private _renderMultiPart;
+    /**
+     * Lightweight VGroup used as a part container in multi-part mode.
+     * Supports setColor() for per-part coloring.
+     */
+    private static _PartGroup;
+    /**
+     * Create a copy of this MathTexSVG.
+     */
+    protected _createCopy(): MathTexSVG;
+}
+export default MathTexSVG;
+//# sourceMappingURL=MathTexSVG.d.ts.map

package/dist/mobjects/text/MathTexSVG.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MathTexSVG.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/MathTexSVG.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,KAAK,EAAW,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIhE,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,qBAAa,UAAW,SAAQ,MAAM;IACpC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC;IAChC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAEtD,sEAAsE;IACtE,SAAS,CAAC,YAAY,EAAE,OAAO,CAAS;IACxC,yDAAyD;IACzD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;IAChC,uDAAuD;IACvD,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAQ;gBAE1C,OAAO,EAAE,iBAAiB;IAuCtC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAMpC;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAU9B;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACM,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IA0BtC;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IAU9B;;OAEG;cACa,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BxC;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAmB/C;;OAEG;IACH,SAAS,CAAC,cAAc,IAAI,IAAI;IAmDhC;;;;;OAKG;YACW,gBAAgB;IAqE9B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU,CAqBvB;IAEF;;OAEG;cACgB,WAAW,IAAI,UAAU;CAgB7C;AAED,eAAe,UAAU,CAAC"}

package/dist/mobjects/text/index.d.ts

@@ -11,6 +11,7 @@ export { Paragraph, type ParagraphOptions } from './Paragraph';
 export { MarkupText, type MarkupTextOptions, type StyledTextSegment } from './MarkupText';
 export { ensureKatexStyles, areKatexStylesLoaded } from './katex-styles';
 export { MathTex, type MathTexOptions, type TexRenderer } from './MathTex';
+export { MathTexSVG, type MathTexSVGOptions } from './MathTexSVG';
 export { renderLatexToSVG, preloadMathJax, isMathJaxLoaded, katexCanRender, type MathJaxRenderOptions, type MathJaxRenderResult, } from './MathJaxRenderer';
 export { parseSVGPathData, svgToVMobjects, type SVGToVMobjectOptions, } from './svgPathParser';
 export { Tex, type TexOptions } from './Tex';

package/dist/mobjects/text/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9E,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/D,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG1F,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGzE,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAG3E,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAG7C,OAAO,EACL,aAAa,EACb,OAAO,EACP,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EACL,IAAI,EACJ,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,KAAK,EACV,KAAK,SAAS,EACd,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACL,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9E,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/D,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG1F,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGzE,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAG3E,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGlE,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAG7C,OAAO,EACL,aAAa,EACb,OAAO,EACP,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EACL,IAAI,EACJ,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,KAAK,EACV,KAAK,SAAS,EACd,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACL,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/utils/featureFlags.d.ts

@@ -1,5 +1,5 @@
 /**
- * Lightweight feature flag system for manim-js.
+ * Lightweight feature flag system for manim-web.
  * Enables toggling experimental features without code changes.
  */
 type FeatureFlags = Record<string, boolean>;

package/dist/utils/logger.d.ts

@@ -1,5 +1,5 @@
 /**
- * Structured logger for manim-js.
+ * Structured logger for manim-web.
  * Provides consistent logging interface for both browser and Node environments.
  * Includes log sanitization to redact sensitive data (tokens, keys, emails).
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "manim-web",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Manim-like mathematical animation library for the web",
   "type": "module",
   "main": "dist/index.js",
@@ -37,8 +37,8 @@
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
     "format": "prettier --write src/",
-    "docs": "node scripts/generate-example-docs.mjs && cd website && npm run build",
-    "docs:dev": "node scripts/generate-example-docs.mjs && cd website && npm start",
+    "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:examples": "node scripts/generate-example-docs.mjs",
     "cpd": "jscpd src/",
     "test:integration": "npx playwright test",
@@ -73,6 +73,7 @@
     "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
+    "happy-dom": "^20.6.1",
     "husky": "^9.1.7",
     "jscpd": "^4.0.8",
     "knip": "^5.83.1",

package/dist/constants/colors.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=colors.test.d.ts.map

package/dist/constants/colors.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"colors.test.d.ts","sourceRoot":"","sources":["../../src/constants/colors.test.ts"],"names":[],"mappings":""}

package/dist/constants/directions.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=directions.test.d.ts.map

package/dist/constants/directions.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"directions.test.d.ts","sourceRoot":"","sources":["../../src/constants/directions.test.ts"],"names":[],"mappings":""}

package/dist/core/SceneExtensions.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=SceneExtensions.test.d.ts.map

package/dist/core/SceneExtensions.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SceneExtensions.test.d.ts","sourceRoot":"","sources":["../../src/core/SceneExtensions.test.ts"],"names":[],"mappings":""}

package/dist/examples.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=examples.test.d.ts.map

package/dist/examples.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"examples.test.d.ts","sourceRoot":"","sources":["../src/examples.test.ts"],"names":[],"mappings":""}

package/dist/rate-functions/rateFunctions.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=rateFunctions.test.d.ts.map

package/dist/rate-functions/rateFunctions.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rateFunctions.test.d.ts","sourceRoot":"","sources":["../../src/rate-functions/rateFunctions.test.ts"],"names":[],"mappings":""}