manim-web 0.2.0

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

@@ -0,0 +1,242 @@
+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
+ */
+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 | 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;
+}
+/**
+ * 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 {
+    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 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;
+    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
+     */
+    getPart(index: number): MathTex;
+    /**
+     * 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;
+    /**
+     * 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
+     */
+    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 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 default MathTex;
+//# sourceMappingURL=MathTex.d.ts.map

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

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

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

@@ -0,0 +1,86 @@
+import { Text, TextOptions } from './Text';
+/**
+ * Options for creating a Paragraph mobject
+ */
+export interface ParagraphOptions extends TextOptions {
+    /** Maximum width in world units for text wrapping */
+    width?: number;
+    /** Text alignment within the paragraph. Default: 'left' */
+    alignment?: 'left' | 'center' | 'right' | 'justify';
+}
+/**
+ * Paragraph - A text mobject with automatic word wrapping
+ *
+ * Extends Text to add word wrapping functionality. Text is wrapped
+ * to fit within a specified width, with configurable alignment.
+ *
+ * @example
+ * ```typescript
+ * // Create a paragraph with max width
+ * const para = new Paragraph({
+ *   text: 'This is a long paragraph that will automatically wrap to fit within the specified width.',
+ *   width: 4,  // 4 world units
+ *   alignment: 'justify'
+ * });
+ *
+ * // Update width to trigger re-wrap
+ * para.setWidth(3);
+ * ```
+ */
+export declare class Paragraph extends Text {
+    protected _maxWidth: number;
+    protected _alignment: 'left' | 'center' | 'right' | 'justify';
+    protected _wrappedLines: string[];
+    constructor(options: ParagraphOptions);
+    /**
+     * Get the maximum width for text wrapping
+     */
+    getMaxWidth(): number;
+    /**
+     * Set maximum width and trigger re-wrap
+     * @param width - Maximum width in world units
+     * @returns this for chaining
+     */
+    setWidth(width: number): this;
+    /**
+     * Get the paragraph alignment
+     */
+    getAlignment(): 'left' | 'center' | 'right' | 'justify';
+    /**
+     * Set paragraph alignment
+     * @param alignment - Text alignment
+     * @returns this for chaining
+     */
+    setAlignment(alignment: 'left' | 'center' | 'right' | 'justify'): this;
+    /**
+     * Wrap text to fit within max width
+     * @returns Array of wrapped lines
+     */
+    protected _wrapText(): string[];
+    /**
+     * Override measure text to use wrapped lines
+     */
+    protected _measureText(): {
+        lines: string[];
+        width: number;
+        height: number;
+    };
+    /**
+     * Render text to canvas with justification support
+     */
+    protected _renderToCanvas(): void;
+    /**
+     * Check if the next line starts a new paragraph (empty line or explicit break)
+     */
+    protected _isNewParagraph(lines: string[], currentIndex: number): boolean;
+    /**
+     * Draw a line with justified spacing
+     */
+    protected _drawJustifiedLine(line: string, startX: number, endX: number, y: number): void;
+    /**
+     * Create a copy of this Paragraph mobject
+     */
+    protected _createCopy(): Paragraph;
+}
+export default Paragraph;
+//# sourceMappingURL=Paragraph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Paragraph.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/Paragraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;CACrD;AAQD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,SAAU,SAAQ,IAAI;IACjC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAC9D,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,CAAM;gBAE3B,OAAO,EAAE,gBAAgB;IAiBrC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ7B;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS;IAIvD;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI;IAStE;;;OAGG;IACH,SAAS,CAAC,SAAS,IAAI,MAAM,EAAE;IA6C/B;;OAEG;cACgB,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAqCrF;;OAEG;cACgB,eAAe,IAAI,IAAI;IA2E1C;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAKzE;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAkDzF;;OAEG;cACgB,WAAW,IAAI,SAAS;CAgB5C;AAED,eAAe,SAAS,CAAC"}

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

@@ -0,0 +1,40 @@
+import { MathTex, MathTexOptions } from './MathTex';
+/**
+ * Options for creating a Tex object
+ * (Same as MathTexOptions)
+ */
+export type TexOptions = MathTexOptions;
+/**
+ * Tex - LaTeX rendering for manimweb
+ *
+ * This is an alias for MathTex to provide Manim API compatibility.
+ * Use this class when porting code from the original Manim library.
+ *
+ * @example
+ * ```typescript
+ * // Create a formula (Manim-style API)
+ * const formula = new Tex({ latex: 'x^2 + y^2 = r^2' });
+ *
+ * // Create with options
+ * const colored = new Tex({
+ *   latex: '\\frac{d}{dx}\\sin(x) = \\cos(x)',
+ *   color: '#ffff00',
+ *   fontSize: 56
+ * });
+ *
+ * // Use MathJax for advanced LaTeX
+ * const chem = new Tex({
+ *   latex: '\\ce{H2O -> H+ + OH-}',
+ *   renderer: 'mathjax'
+ * });
+ * ```
+ */
+export declare class Tex extends MathTex {
+    constructor(options: TexOptions);
+    /**
+     * Create a copy of this Tex
+     */
+    protected _createCopy(): Tex;
+}
+export default Tex;
+//# sourceMappingURL=Tex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Tex.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/Tex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,cAAc,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,GAAI,SAAQ,OAAO;gBAClB,OAAO,EAAE,UAAU;IAS/B;;OAEG;cACgB,WAAW,IAAI,GAAG;CAUtC;AAED,eAAe,GAAG,CAAC"}

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

@@ -0,0 +1,171 @@
+import { VMobject } from '../../core/VMobject';
+import { Vector3Tuple } from '../../core/Mobject';
+import { TextGlyphGroup } from './TextGlyphGroup';
+import { SkeletonizeOptions } from '../../utils/skeletonize';
+import * as THREE from 'three';
+/**
+ * Options for creating a Text mobject
+ */
+export interface TextOptions {
+    /** The text content to display */
+    text: string;
+    /** Font size in pixels. Default: 48 */
+    fontSize?: number;
+    /** Font family. Default: 'CMU Serif, Georgia, Times New Roman, serif' (Manim-like) */
+    fontFamily?: string;
+    /** Font weight. Default: 'normal' */
+    fontWeight?: string | number;
+    /** Font style ('normal' | 'italic'). Default: 'normal' */
+    fontStyle?: string;
+    /** Text color as CSS color string. Default: '#ffffff' */
+    color?: string;
+    /** Fill opacity from 0 to 1. Default: 1 */
+    fillOpacity?: number;
+    /** Stroke width for outlined text. Default: 0 */
+    strokeWidth?: number;
+    /** Line height multiplier. Default: 1.2 */
+    lineHeight?: number;
+    /** Letter spacing in pixels. Default: 0 */
+    letterSpacing?: number;
+    /** Text alignment. Default: 'center' */
+    textAlign?: 'left' | 'center' | 'right';
+    /** URL to a font file (OTF/TTF) for glyph vector extraction. When provided, loadGlyphs() can extract glyph outlines for stroke-draw animation. */
+    fontUrl?: string;
+}
+export declare class Text extends VMobject {
+    protected _text: string;
+    protected _fontSize: number;
+    protected _fontFamily: string;
+    protected _fontWeight: string | number;
+    protected _fontStyle: string;
+    /** Flag to track when canvas content needs re-rendering (text/color/font changes) */
+    protected _canvasDirty: boolean;
+    protected _lineHeight: number;
+    protected _letterSpacing: number;
+    protected _textAlign: 'left' | 'center' | 'right';
+    /** Optional font URL for glyph vector extraction */
+    protected _fontUrl?: string;
+    /** Cached glyph group (created lazily by loadGlyphs) */
+    protected _glyphGroup: TextGlyphGroup | null;
+    /** Off-screen canvas for text rendering */
+    protected _canvas: HTMLCanvasElement | null;
+    protected _ctx: CanvasRenderingContext2D | null;
+    /** Three.js texture from canvas */
+    protected _texture: THREE.CanvasTexture | null;
+    /** Plane mesh for displaying the texture */
+    protected _mesh: THREE.Mesh | null;
+    /** Cached dimensions in world units */
+    protected _worldWidth: number;
+    protected _worldHeight: number;
+    constructor(options: TextOptions);
+    /**
+     * Initialize the off-screen canvas
+     */
+    protected _initCanvas(): void;
+    /**
+     * Get the current text content
+     */
+    getText(): string;
+    /**
+     * Set new text content and re-render
+     * @param text - New text to display
+     * @returns this for chaining
+     */
+    setText(text: string): this;
+    /**
+     * Get the current font size
+     */
+    getFontSize(): number;
+    /**
+     * Set font size and re-render
+     * @param size - Font size in pixels
+     * @returns this for chaining
+     */
+    setFontSize(size: number): this;
+    /**
+     * Get the current font family
+     */
+    getFontFamily(): string;
+    /**
+     * Set font family and re-render
+     * @param family - CSS font family string
+     * @returns this for chaining
+     */
+    setFontFamily(family: string): this;
+    /**
+     * Get text width in world units
+     */
+    getWidth(): number;
+    /**
+     * Get text height in world units
+     */
+    getHeight(): number;
+    /**
+     * Build the CSS font string
+     */
+    protected _buildFontString(): string;
+    /**
+     * Split text into lines and measure dimensions
+     * @returns Object with lines array and canvas dimensions
+     */
+    protected _measureText(): {
+        lines: string[];
+        width: number;
+        height: number;
+    };
+    /**
+     * Render text to the off-screen canvas
+     */
+    protected _renderToCanvas(): void;
+    /**
+     * Draw text with custom letter spacing
+     */
+    protected _drawTextWithLetterSpacing(text: string, startX: number, y: number, _fontSize: number): void;
+    /**
+     * Update the mesh geometry to match new dimensions
+     */
+    protected _updateMesh(): void;
+    /**
+     * Create the Three.js backing object
+     */
+    protected _createThreeObject(): THREE.Object3D;
+    /**
+     * Sync material properties to Three.js
+     */
+    protected _syncMaterialToThree(): void;
+    /**
+     * Get the cached TextGlyphGroup (null until loadGlyphs() resolves).
+     */
+    getGlyphGroup(): TextGlyphGroup | null;
+    /**
+     * Lazily create a TextGlyphGroup from the font file at _fontUrl.
+     * Returns null if no fontUrl was provided.
+     *
+     * @param options.useSkeletonStroke  When true, each glyph computes its
+     *   skeleton (medial axis) for center-line stroke animation. Default: false.
+     * @param options.skeletonOptions  Fine-tuning options for the skeletonization
+     *   algorithm (grid resolution, smoothing, etc.).
+     */
+    loadGlyphs(options?: {
+        useSkeletonStroke?: boolean;
+        skeletonOptions?: SkeletonizeOptions;
+    }): Promise<TextGlyphGroup | null>;
+    /**
+     * Get the texture mesh (for animation cross-fade access).
+     */
+    getTextureMesh(): THREE.Mesh | null;
+    /**
+     * Get the center of this text mobject
+     */
+    getCenter(): Vector3Tuple;
+    /**
+     * Create a copy of this Text mobject
+     */
+    protected _createCopy(): Text;
+    /**
+     * Clean up Three.js and canvas resources
+     */
+    dispose(): void;
+}
+export default Text;
+//# sourceMappingURL=Text.d.ts.map

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

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