manim-web 0.3.18 → 0.3.20

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

@@ -1,249 +1,115 @@
-import { Mobject, Vector3Tuple } from '../../core/Mobject';
-/**
- * MathTex - LaTeX rendering for manimweb using KaTeX (default) or MathJax (fallback)
- *
- * This module provides LaTeX math rendering capabilities by:
- * 1. Using KaTeX to render LaTeX to HTML (fast, limited subset)
- * 2. Falling back to MathJax SVG output for unsupported LaTeX (full LaTeX support)
- * 3. Converting output to canvas via DOM walking / SVG foreignObject
- * 4. Creating a THREE.js textured plane mesh
- *
- * Renderer selection:
- * - 'katex'  : KaTeX only (fast, limited subset)
- * - 'mathjax': MathJax only (slower, full LaTeX including \usepackage, align, etc.)
- * - 'auto'   : Try KaTeX first; fall back to MathJax if KaTeX throws (default)
- */
-import * as THREE from 'three';
-/**
- * Which renderer to use for LaTeX.
- * - 'katex'  : KaTeX only (fast, but limited LaTeX subset)
- * - 'mathjax': MathJax SVG only (slower, full LaTeX support)
- * - 'auto'   : Try KaTeX first; if it throws, fall back to MathJax
- */
-export type TexRenderer = 'katex' | 'mathjax' | 'auto';
-/**
- * Options for creating a MathTex object
- */
+import { VGroup } from '../../core/VGroup';
+import { Vector3Tuple } from '../../core/Mobject';
 export interface MathTexOptions {
-    /** LaTeX string or array of strings for multi-part expressions.
-     *  When an array is provided, each string becomes a separate sub-mobject
-     *  accessible via getPart(index), matching Python Manim's behavior. */
+    /** LaTeX string or array of strings for multi-part expressions. */
     latex: string | string[];
-    /** Color as CSS color string. Default: '#ffffff' */
+    /** Color as CSS color string. Default: WHITE ('#ffffff') */
     color?: string;
-    /** Base font size in pixels. Default: 48 */
+    /** 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 in 3D space. Default: [0,0,0] */
     position?: Vector3Tuple;
-    /** Internal: padding in pixels around the rendered content. Default: 10 */
-    _padding?: number;
-    /**
-     * Which renderer to use.
-     * - 'katex'  : KaTeX only (fast)
-     * - 'mathjax': MathJax SVG only (full LaTeX support)
-     * - 'auto'   : KaTeX first, MathJax fallback (default)
-     */
-    renderer?: TexRenderer;
-}
-/**
- * Internal state for async rendering
- */
-interface RenderState {
-    canvas: HTMLCanvasElement | null;
-    texture: THREE.CanvasTexture | null;
-    mesh: THREE.Mesh | null;
-    width: number;
-    height: number;
-    isRendering: boolean;
-    renderPromise: Promise<void> | null;
-    renderError: Error | null;
+    /** Stroke width for glyph outlines. Default: 0 */
+    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>;
 }
-/**
- * MathTex - A mobject for rendering LaTeX mathematical expressions
- *
- * Uses KaTeX for LaTeX parsing and renders to a textured plane in Three.js.
- * The rendering is asynchronous but the constructor is synchronous.
- *
- * @example
- * ```typescript
- * // Create a simple equation
- * const equation = new MathTex({ latex: 'E = mc^2' });
- *
- * // Create a colored integral
- * const integral = new MathTex({
- *   latex: '\\int_0^\\infty e^{-x^2} dx = \\frac{\\sqrt{\\pi}}{2}',
- *   color: '#00ff00',
- *   fontSize: 64
- * });
- *
- * // Wait for rendering to complete before animating
- * await integral.waitForRender();
- * ```
- */
-export declare class MathTex extends Mobject {
+export declare class MathTex extends VGroup {
     protected _latex: string;
     protected _fontSize: number;
     protected _displayMode: boolean;
-    protected _renderState: RenderState;
-    /** User-requested renderer mode */
-    protected _renderer: TexRenderer;
-    /** Which renderer was actually used for the last successful render */
-    protected _activeRenderer: 'katex' | 'mathjax' | null;
+    protected _color: string;
+    protected _svgStrokeWidth: number;
+    protected _svgFillOpacity: number;
+    protected _targetHeight: number | undefined;
+    protected _macros: Record<string, string> | undefined;
+    protected _svgViewBoxWidth: number;
     /** Whether this is a multi-part MathTex (created from string[]) */
     protected _isMultiPart: boolean;
-    /** Child MathTex parts (only when _isMultiPart is true) */
-    protected _parts: MathTex[];
-    /** Promise that resolves when parts are arranged (multi-part only) */
-    protected _arrangePromise: Promise<void> | null;
-    /** Padding in pixels around rendered content */
-    protected _padding: number;
+    /** Child part groups (only when _isMultiPart is true) */
+    protected _parts: VGroup[];
+    /** Promise that resolves when rendering is complete */
+    protected _renderPromise: Promise<void> | null;
+    /** Error from rendering, if any */
+    protected _renderError: Error | null;
     constructor(options: MathTexOptions);
-    /**
-     * Get the renderer mode
-     */
-    getRenderer(): TexRenderer;
-    /**
-     * Get which renderer was actually used for the current render.
-     * Returns null if not yet rendered.
-     */
-    getActiveRenderer(): 'katex' | 'mathjax' | null;
-    /**
-     * Set the renderer mode and re-render.
-     * @param renderer The renderer to use
-     * @returns this for chaining
-     */
-    setRenderer(renderer: TexRenderer): this;
-    /**
-     * Get the LaTeX string
-     */
-    getLatex(): string;
-    /**
-     * Set the LaTeX string and re-render
-     * @param latex New LaTeX string
-     * @returns this for chaining
-     */
-    setLatex(latex: string): this;
-    /**
-     * Get the font size
-     */
-    getFontSize(): number;
-    /**
-     * Set the font size and re-render
-     * @param size New font size in pixels
-     * @returns this for chaining
-     */
-    setFontSize(size: number): this;
-    /**
-     * Override setColor — texture is always rendered white, so we only need
-     * to update the material tint via _syncMaterialToThree (no re-render).
-     */
-    setColor(color: string): this;
-    /**
-     * Override setOpacity to propagate to multi-part children.
-     */
-    setOpacity(opacity: number): this;
     /**
      * Wait for the LaTeX to finish rendering.
-     * For multi-part MathTex, waits for all parts to render and be arranged.
-     * @returns Promise that resolves when rendering is complete
      */
     waitForRender(): Promise<void>;
     /**
-     * Get a sub-part of a multi-part MathTex expression.
-     * Only available when the MathTex was created with a string array.
-     * @param index Zero-based index of the part
-     * @returns The MathTex sub-part at the given index
+     * 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): MathTex;
+    getPart(index: number): VGroup;
     /**
-     * Get the number of parts (1 for single-string, N for multi-part).
+     * Get the number of parts.
      */
     getPartCount(): number;
     /**
-     * Arrange child parts horizontally after they all render.
-     * Positions parts so their content (minus padding) is seamlessly adjacent.
+     * Get the LaTeX string.
      */
-    private _arrangeParts;
+    getLatex(): string;
     /**
-     * Check if rendering is in progress
+     * Get the render error, if any.
+     * Returns null if rendering succeeded or is still in progress.
      */
-    isRendering(): boolean;
+    getRenderError(): Error | null;
     /**
-     * Get the rendered dimensions in world units
-     * @returns [width, height] or [0, 0] if not yet rendered
+     * Override setColor to propagate to all VMobject children (fill + stroke).
      */
-    getDimensions(): [number, number];
+    setColor(color: string): this;
     /**
-     * Start the async rendering process
+     * Start the async rendering process.
      */
     protected _startRender(): void;
     /**
-     * Render the LaTeX to a canvas using the selected renderer.
-     *
-     * Renderer selection logic:
-     * - 'katex'  : Use KaTeX directly (throwOnError: false)
-     * - 'mathjax': Use MathJax SVG output, rendered to canvas via Image
-     * - 'auto'   : Try KaTeX with throwOnError: true. If it throws,
-     *              fall back to MathJax.
-     */
-    protected _renderLatex(): Promise<void>;
-    /**
-     * Determine which concrete renderer to use for the current LaTeX string.
+     * Render the LaTeX to VMobject paths.
      */
-    private _resolveRenderer;
+    protected _render(): Promise<void>;
     /**
-     * Parse an SVG dimension attribute that may use "ex" units and convert
-     * to pixels.  MathJax outputs width/height like "5.002ex"; parseFloat
-     * strips the suffix, so we detect "ex" and scale appropriately.
+     * Restyle all VMobject children for solid glyph rendering.
      */
-    private _parseSvgDimension;
+    protected _restyleChildren(group: VGroup): void;
     /**
-     * Render using MathJax SVG output.  The SVG is painted onto a canvas
-     * texture in the same way the KaTeX path works, keeping the visual
-     * pipeline consistent.
-     */
-    protected _renderLatexViaMathJax(): Promise<void>;
-    /**
-     * Render the LaTeX to a canvas by walking the KaTeX DOM
-     * and drawing each text element at its computed CSS position.
-     */
-    protected _renderLatexViaKaTeX(): Promise<void>;
-    /**
-     * Walk the KaTeX DOM tree and render text nodes + SVG elements
-     * at their computed CSS positions onto a canvas.
-     */
-    protected _renderDomToCanvas(container: HTMLElement, containerRect: DOMRect, width: number, height: number, padding: number): Promise<HTMLCanvasElement>;
-    /**
-     * Update the mesh geometry to match current dimensions
+     * Scale and center the assembled paths by transforming point data directly.
+     *
+     * Unit flow:
+     * - MathJax path coordinates arrive in font units (~1000 units per em).
+     * - Convert font-size points to world units via DEFAULT_FONT_SIZE_PT baseline.
+     * - Convert MathJax units to em by dividing by MATHJAX_SVG_UNITS_PER_EM.
+     *
+     * This keeps MathTex aligned with Text/MathTexImage behavior at 48pt.
      */
-    protected _updateMeshGeometry(): void;
+    protected _scaleToTarget(): void;
     /**
-     * Create the Three.js backing object
+     * 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
      */
-    protected _createThreeObject(): THREE.Object3D;
+    private _renderMultiPart;
     /**
-     * Sync material properties to Three.js
+     * Lightweight VGroup used as a part container in multi-part mode.
+     * Supports setColor() for per-part coloring.
      */
-    protected _syncMaterialToThree(): void;
+    private static _PartGroup;
     /**
-     * Create a copy of this MathTex
+     * Create a copy of this MathTex.
      */
     protected _createCopy(): MathTex;
-    /**
-     * Set reveal progress for Write animation (left-to-right wipe).
-     * @param alpha - Progress from 0 (hidden) to 1 (fully visible)
-     */
-    setRevealProgress(alpha: number): void;
-    /**
-     * Get the center of this MathTex
-     */
-    getCenter(): Vector3Tuple;
-    /**
-     * Clean up Three.js resources
-     */
-    dispose(): void;
 }
-export {};
+/**
+ * @deprecated Use `MathTex` instead. `MathTexSVG` is a backwards-compatible alias.
+ */
+export declare const MathTexSVG: typeof MathTex;
+/** @deprecated Use `MathTexOptions` instead. */
+export type MathTexSVGOptions = MathTexOptions;
 //# sourceMappingURL=MathTex.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"MathTex.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/MathTex.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MathTex.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/MathTex.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,KAAK,EAAW,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQhE,MAAM,WAAW,cAAc;IAC7B,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,OAAQ,SAAQ,MAAM;IACjC,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;IACtD,SAAS,CAAC,gBAAgB,EAAE,MAAM,CAAQ;IAE1C,mEAAmE;IACnE,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;IACtD,mCAAmC;IACnC,SAAS,CAAC,YAAY,EAAE,KAAK,GAAG,IAAI,CAAQ;gBAEhC,OAAO,EAAE,cAAc;IAyCnC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IASpC;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAU9B;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;OAGG;IACH,cAAc,IAAI,KAAK,GAAG,IAAI;IAI9B;;OAEG;IACM,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IA0BtC;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IAW9B;;OAEG;cACa,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgCxC;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAmB/C;;;;;;;;;OASG;IACH,SAAS,CAAC,cAAc,IAAI,IAAI;IAoDhC;;;;;OAKG;YACW,gBAAgB;IA4E9B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU,CAqBvB;IAEF;;OAEG;cACgB,WAAW,IAAI,OAAO;CAgB1C;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,gBAAU,CAAC;AAClC,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC"}

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

@@ -0,0 +1,258 @@
+import { Mobject, Vector3Tuple } from '../../core/Mobject';
+/**
+ * MathTexImage - Rasterized LaTeX rendering for manimweb using KaTeX (default) or MathJax (fallback)
+ *
+ * This module provides LaTeX math rendering capabilities by:
+ * 1. Using KaTeX to render LaTeX to HTML (fast, limited subset)
+ * 2. Falling back to MathJax SVG output for unsupported LaTeX (full LaTeX support)
+ * 3. Converting output to canvas via DOM walking / SVG foreignObject
+ * 4. Creating a THREE.js textured plane mesh
+ *
+ * Renderer selection:
+ * - 'katex'  : KaTeX only (fast, limited subset)
+ * - 'mathjax': MathJax only (slower, full LaTeX including \usepackage, align, etc.)
+ * - 'auto'   : Try KaTeX first; fall back to MathJax if KaTeX throws (default)
+ *
+ * NOTE: This is the rasterized (texture-based) renderer. For SVG path-based
+ * rendering (recommended), use MathTex from './MathTex' instead.
+ */
+import * as THREE from 'three';
+/**
+ * Which renderer to use for LaTeX.
+ * - 'katex'  : KaTeX only (fast, but limited LaTeX subset)
+ * - 'mathjax': MathJax SVG only (slower, full LaTeX support)
+ * - 'auto'   : Try KaTeX first; if it throws, fall back to MathJax
+ */
+export type TexRenderer = 'katex' | 'mathjax' | 'auto';
+/**
+ * Options for creating a MathTexImage object
+ */
+export interface MathTexImageOptions {
+    /** LaTeX string or array of strings for multi-part expressions.
+     *  When an array is provided, each string becomes a separate sub-mobject
+     *  accessible via getPart(index), matching Python Manim's behavior. */
+    latex: string | string[];
+    /** Color as CSS color string. Default: '#ffffff' */
+    color?: string;
+    /** Base font size in pixels. Default: 48 */
+    fontSize?: number;
+    /** Use display mode (block) vs inline mode. Default: true */
+    displayMode?: boolean;
+    /** Position in 3D space. Default: [0, 0, 0] */
+    position?: Vector3Tuple;
+    /** Internal: padding in pixels around the rendered content. Default: 10 */
+    _padding?: number;
+    /**
+     * Which renderer to use.
+     * - 'katex'  : KaTeX only (fast)
+     * - 'mathjax': MathJax SVG only (full LaTeX support)
+     * - 'auto'   : KaTeX first, MathJax fallback (default)
+     */
+    renderer?: TexRenderer;
+}
+/**
+ * Internal state for async rendering
+ */
+interface RenderState {
+    canvas: HTMLCanvasElement | null;
+    texture: THREE.CanvasTexture | null;
+    mesh: THREE.Mesh | null;
+    width: number;
+    height: number;
+    isRendering: boolean;
+    renderPromise: Promise<void> | null;
+    renderError: Error | null;
+}
+/**
+ * MathTexImage - A mobject for rendering LaTeX mathematical expressions via rasterization
+ *
+ * Uses KaTeX for LaTeX parsing and renders to a textured plane in Three.js.
+ * The rendering is asynchronous but the constructor is synchronous.
+ *
+ * NOTE: For SVG path-based rendering (recommended, like Python Manim), use MathTex instead.
+ *
+ * @example
+ * ```typescript
+ * // Create a simple equation (rasterized)
+ * const equation = new MathTexImage({ latex: 'E = mc^2' });
+ *
+ * // Create a colored integral
+ * const integral = new MathTexImage({
+ *   latex: '\\int_0^\\infty e^{-x^2} dx = \\frac{\\sqrt{\\pi}}{2}',
+ *   color: '#00ff00',
+ *   fontSize: 64
+ * });
+ *
+ * // Wait for rendering to complete before animating
+ * await integral.waitForRender();
+ * ```
+ */
+export declare class MathTexImage extends Mobject {
+    protected _latex: string;
+    protected _fontSize: number;
+    protected _displayMode: boolean;
+    protected _renderState: RenderState;
+    /** User-requested renderer mode */
+    protected _renderer: TexRenderer;
+    /** Which renderer was actually used for the last successful render */
+    protected _activeRenderer: 'katex' | 'mathjax' | null;
+    /** Whether this is a multi-part MathTexImage (created from string[]) */
+    protected _isMultiPart: boolean;
+    /** Child MathTexImage parts (only when _isMultiPart is true) */
+    protected _parts: MathTexImage[];
+    /** Promise that resolves when parts are arranged (multi-part only) */
+    protected _arrangePromise: Promise<void> | null;
+    /** Padding in pixels around rendered content */
+    protected _padding: number;
+    constructor(options: MathTexImageOptions);
+    /**
+     * Get the renderer mode
+     */
+    getRenderer(): TexRenderer;
+    /**
+     * Get which renderer was actually used for the current render.
+     * Returns null if not yet rendered.
+     */
+    getActiveRenderer(): 'katex' | 'mathjax' | null;
+    /**
+     * Set the renderer mode and re-render.
+     * @param renderer The renderer to use
+     * @returns this for chaining
+     */
+    setRenderer(renderer: TexRenderer): this;
+    /**
+     * Get the LaTeX string
+     */
+    getLatex(): string;
+    /**
+     * Set the LaTeX string and re-render
+     * @param latex New LaTeX string
+     * @returns this for chaining
+     */
+    setLatex(latex: string): this;
+    /**
+     * Get the font size
+     */
+    getFontSize(): number;
+    /**
+     * Set the font size and re-render
+     * @param size New font size in pixels
+     * @returns this for chaining
+     */
+    setFontSize(size: number): this;
+    /**
+     * Override setColor — texture is always rendered white, so we only need
+     * to update the material tint via _syncMaterialToThree (no re-render).
+     */
+    setColor(color: string): this;
+    /**
+     * Override setStrokeOpacity to propagate to multi-part children.
+     */
+    setStrokeOpacity(opacity: number): this;
+    /**
+     * Wait for the LaTeX to finish rendering.
+     * For multi-part MathTexImage, waits for all parts to render and be arranged.
+     * @returns Promise that resolves when rendering is complete
+     */
+    waitForRender(): Promise<void>;
+    /**
+     * Get a sub-part of a multi-part MathTexImage expression.
+     * Only available when the MathTexImage was created with a string array.
+     * @param index Zero-based index of the part
+     * @returns The MathTexImage sub-part at the given index
+     */
+    getPart(index: number): MathTexImage;
+    /**
+     * Get the number of parts (1 for single-string, N for multi-part).
+     */
+    getPartCount(): number;
+    /**
+     * Arrange child parts horizontally after they all render.
+     * Positions parts so their content (minus padding) is seamlessly adjacent.
+     */
+    private _arrangeParts;
+    /**
+     * Check if rendering is in progress
+     */
+    isRendering(): boolean;
+    /**
+     * Get the rendered dimensions in world units
+     * @returns [width, height] or [0, 0] if not yet rendered
+     */
+    getDimensions(): [number, number];
+    /**
+     * Start the async rendering process
+     */
+    protected _startRender(): void;
+    /**
+     * Render the LaTeX to a canvas using the selected renderer.
+     *
+     * Renderer selection logic:
+     * - 'katex'  : Use KaTeX directly (throwOnError: false)
+     * - 'mathjax': Use MathJax SVG output, rendered to canvas via Image
+     * - 'auto'   : Try KaTeX with throwOnError: true. If it throws,
+     *              fall back to MathJax.
+     */
+    protected _renderLatex(): Promise<void>;
+    /**
+     * Determine which concrete renderer to use for the current LaTeX string.
+     */
+    private _resolveRenderer;
+    /**
+     * Parse an SVG dimension attribute that may use "ex" units and convert
+     * to pixels.  MathJax outputs width/height like "5.002ex"; parseFloat
+     * strips the suffix, so we detect "ex" and scale appropriately.
+     */
+    private _parseSvgDimension;
+    /**
+     * Render using MathJax SVG output.  The SVG is painted onto a canvas
+     * texture in the same way the KaTeX path works, keeping the visual
+     * pipeline consistent.
+     */
+    protected _renderLatexViaMathJax(): Promise<void>;
+    /**
+     * Render the LaTeX to a canvas by walking the KaTeX DOM
+     * and drawing each text element at its computed CSS position.
+     *
+     * IMPORTANT: The canvas dimensions are in pixel space, rendered at the
+     * user's fontSize (e.g., fontSize=48 → 48px). The caller must convert
+     * these pixel dimensions to world space using scaleFactor = 0.01.
+     */
+    protected _renderLatexViaKaTeX(): Promise<void>;
+    /**
+     * Walk the KaTeX DOM tree and render text nodes + SVG elements
+     * at their computed CSS positions onto a canvas.
+     */
+    protected _renderDomToCanvas(container: HTMLElement, containerRect: DOMRect, width: number, height: number, padding: number, scale?: number): Promise<HTMLCanvasElement>;
+    /**
+     * Update the mesh geometry to match current dimensions
+     */
+    protected _updateMeshGeometry(): void;
+    /**
+     * Create the Three.js backing object
+     */
+    protected _createThreeObject(): THREE.Object3D;
+    /**
+     * Sync material properties to Three.js
+     */
+    protected _syncMaterialToThree(): void;
+    /**
+     * Create a copy of this MathTexImage
+     */
+    protected _createCopy(): MathTexImage;
+    /**
+     * Set reveal progress for Write animation (left-to-right wipe).
+     * @param alpha - Progress from 0 (hidden) to 1 (fully visible)
+     */
+    setRevealProgress(alpha: number): void;
+    /**
+     * Get the center of this MathTexImage
+     */
+    getCenter(): Vector3Tuple;
+    /**
+     * Clean up Three.js resources
+     */
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=MathTexImage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MathTexImage.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/MathTexImage.ts"],"names":[],"mappings":"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"}

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

@@ -1,13 +1,13 @@
-import { MathTex, MathTexOptions } from './MathTex';
+import { MathTexImage, MathTexImageOptions } from './MathTexImage';
 import { VGroup } from '../../core/VGroup';
-export type SingleStringMathTexOptions = Omit<MathTexOptions, 'latex'>;
+export type SingleStringMathTexOptions = Omit<MathTexImageOptions, 'latex'>;
 /**
- * SingleStringMathTex - A variant of MathTex for single-string LaTeX
+ * SingleStringMathTex - A variant of MathTexImage for single-string LaTeX
  *
- * Wraps MathTex but enforces that the LaTeX is treated as a single
+ * Wraps MathTexImage but enforces that the LaTeX is treated as a single
  * indivisible expression (no part splitting).
  */
-export declare class SingleStringMathTex extends MathTex {
+export declare class SingleStringMathTex extends MathTexImage {
     constructor(latex: string, options?: SingleStringMathTexOptions);
     /**
      * Get the LaTeX source string
@@ -21,10 +21,10 @@ export interface MathTexPartOptions {
     fontSize?: number;
 }
 /**
- * MathTexPart - Represents a selectable part of a MathTex expression
+ * MathTexPart - Represents a selectable part of a MathTexImage expression
  *
- * Allows creating MathTex expressions with individually styleable/animatable parts.
- * Each part is a separate MathTex that can be colored or animated independently.
+ * Allows creating MathTexImage expressions with individually styleable/animatable parts.
+ * Each part is a separate MathTexImage that can be colored or animated independently.
  *
  * @example
  * ```typescript
@@ -55,11 +55,11 @@ export declare class MathTexPart extends VGroup {
     /**
      * Get a specific part by index
      */
-    getPart(index: number): MathTex | undefined;
+    getPart(index: number): MathTexImage | undefined;
     /**
      * Get all parts
      */
-    getParts(): MathTex[];
+    getParts(): MathTexImage[];
     /**
      * Get the number of parts
      */

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

@@ -1 +1 @@
-{"version":3,"file":"MathTexParts.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/MathTexParts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;AAEvE;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,OAAO;gBAClC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,0BAA+B;IAInE;;OAEG;IACH,YAAY,IAAI,MAAM;CAGvB;AAED,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAY,SAAQ,MAAM;IACrC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,YAAY,CAAgB;;IAMpC;;OAEG;IACH,MAAM,CAAC,SAAS,CACd,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAClE,OAAO,GAAE,MAAY,GACpB,WAAW;IAgCd;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI3C;;OAEG;IACH,QAAQ,IAAI,OAAO,EAAE;IAIrB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOhD;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACH,YAAY,IAAI,MAAM;CAGvB"}
+{"version":3,"file":"MathTexParts.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/MathTexParts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;AAE5E;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,0BAA+B;IAInE;;OAEG;IACH,YAAY,IAAI,MAAM;CAGvB;AAED,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAY,SAAQ,MAAM;IACrC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,YAAY,CAAgB;;IAMpC;;OAEG;IACH,MAAM,CAAC,SAAS,CACd,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAClE,OAAO,GAAE,MAAY,GACpB,WAAW;IAgCd;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIhD;;OAEG;IACH,QAAQ,IAAI,YAAY,EAAE;IAI1B;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOhD;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACH,YAAY,IAAI,MAAM;CAGvB"}