manim-web 0.2.0

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

@@ -0,0 +1,199 @@
+import { VMobject } from '../../core/VMobject';
+import { Vector3Tuple } from '../../core/Mobject';
+/**
+ * DecimalNumber - A text mobject that displays a number and can be animated
+ *
+ * This module provides number display capabilities with configurable decimal places,
+ * sign display, and ellipsis support. Designed to work with ValueTracker for animations.
+ */
+import * as THREE from 'three';
+/**
+ * Options for creating a DecimalNumber mobject
+ */
+export interface DecimalNumberOptions {
+    /** The numeric value to display. Default: 0 */
+    value?: number;
+    /** Number of decimal places to show. Default: 2 */
+    numDecimalPlaces?: number;
+    /** Whether to show ellipsis (...) after the number. Default: false */
+    showEllipsis?: boolean;
+    /** Whether to show + sign for positive numbers. Default: false */
+    includeSign?: boolean;
+    /** Group digits with separator (e.g., 1,000). Default: false */
+    groupWithCommas?: boolean;
+    /** Font size in pixels. Default: 48 */
+    fontSize?: number;
+    /** Font family. Default: 'monospace' */
+    fontFamily?: string;
+    /** Font weight. Default: 'normal' */
+    fontWeight?: string | number;
+    /** Text color as CSS color string. Default: '#ffffff' */
+    color?: string;
+    /** Fill opacity from 0 to 1. Default: 1 */
+    fillOpacity?: number;
+    /** Edge to preserve when number width changes. Default: null (center) */
+    edgeToFix?: 'left' | 'right' | null;
+    /** Unit string to append (e.g., '%', 'm/s'). Default: '' */
+    unit?: string;
+    /** Buffer between number and unit. Default: 0.05 */
+    unitBuff?: number;
+}
+/**
+ * DecimalNumber - A text mobject that displays a configurable number
+ *
+ * The number can be animated by calling setValue() with new values,
+ * or by using a ValueTracker with an updater function.
+ *
+ * @example
+ * ```typescript
+ * // Create a simple decimal number
+ * const num = new DecimalNumber({ value: 3.14159 });
+ *
+ * // Create with custom formatting
+ * const percentage = new DecimalNumber({
+ *   value: 75.5,
+ *   numDecimalPlaces: 1,
+ *   includeSign: true,
+ *   unit: '%'
+ * });
+ *
+ * // Animate value change
+ * num.setValue(42);
+ * ```
+ */
+export declare class DecimalNumber extends VMobject {
+    protected _value: number;
+    protected _numDecimalPlaces: number;
+    protected _showEllipsis: boolean;
+    protected _includeSign: boolean;
+    protected _groupWithCommas: boolean;
+    protected _fontSize: number;
+    protected _fontFamily: string;
+    protected _fontWeight: string | number;
+    protected _edgeToFix: 'left' | 'right' | null;
+    protected _unit: string;
+    protected _unitBuff: number;
+    /** 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;
+    /** Previous edge position for edge-fixing */
+    protected _previousEdgePosition: number | null;
+    constructor(options?: DecimalNumberOptions);
+    /**
+     * Initialize the off-screen canvas
+     */
+    protected _initCanvas(): void;
+    /**
+     * Get the current numeric value
+     */
+    getValue(): number;
+    /**
+     * Set the numeric value and update display
+     * @param value - New value to display
+     * @returns this for chaining
+     */
+    setValue(value: number): this;
+    /**
+     * Get the X position of the edge being fixed
+     */
+    protected _getEdgeX(): number;
+    /**
+     * Get the number of decimal places
+     */
+    getNumDecimalPlaces(): number;
+    /**
+     * Set the number of decimal places
+     * @param places - Number of decimal places
+     * @returns this for chaining
+     */
+    setNumDecimalPlaces(places: number): this;
+    /**
+     * Get the font size
+     */
+    getFontSize(): number;
+    /**
+     * Set the font size
+     * @param size - Font size in pixels
+     * @returns this for chaining
+     */
+    setFontSize(size: number): this;
+    /**
+     * Format the number as a string
+     */
+    protected _formatNumber(): string;
+    /**
+     * Build the CSS font string
+     */
+    protected _buildFontString(): string;
+    /**
+     * Measure text dimensions
+     */
+    protected _measureText(): {
+        text: string;
+        width: number;
+        height: number;
+    };
+    /**
+     * Render text to the off-screen canvas
+     */
+    protected _renderToCanvas(): 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 center of this DecimalNumber
+     */
+    getCenter(): Vector3Tuple;
+    /**
+     * Get text width in world units
+     */
+    getWidth(): number;
+    /**
+     * Get text height in world units
+     */
+    getHeight(): number;
+    /**
+     * Create a copy of this DecimalNumber
+     */
+    protected _createCopy(): DecimalNumber;
+    /**
+     * Clean up Three.js and canvas resources
+     */
+    dispose(): void;
+}
+/**
+ * Integer - A DecimalNumber with zero decimal places
+ *
+ * Convenience class for displaying integers without decimal points.
+ *
+ * @example
+ * ```typescript
+ * const count = new Integer({ value: 42 });
+ * count.setValue(100);
+ * ```
+ */
+export declare class Integer extends DecimalNumber {
+    constructor(options?: Omit<DecimalNumberOptions, 'numDecimalPlaces'>);
+    /**
+     * Create a copy of this Integer
+     */
+    protected _createCopy(): Integer;
+}
+export default DecimalNumber;
+//# sourceMappingURL=DecimalNumber.d.ts.map

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

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

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

@@ -0,0 +1,76 @@
+import { VMobject } from '../../core/VMobject';
+import { Font, Glyph } from 'opentype.js';
+import { SkeletonizeOptions } from '../../utils/skeletonize';
+export interface GlyphVMobjectOptions {
+    /** The opentype.js Glyph object */
+    glyph: Glyph;
+    /** The font this glyph belongs to (needed for unitsPerEm) */
+    font: Font;
+    /** Font size in pixels */
+    fontSize: number;
+    /** X offset in pixels (for character positioning) */
+    xOffset?: number;
+    /** Y offset in pixels */
+    yOffset?: number;
+    /** Stroke color */
+    color?: string;
+    /** Stroke width for outline drawing */
+    strokeWidth?: number;
+    /**
+     * When true, compute the skeleton (medial axis) of the glyph outline
+     * so the Write animation can draw along the center-line rather than
+     * the perimeter. Default: false.
+     */
+    useSkeletonStroke?: boolean;
+    /** Options forwarded to the skeletonization algorithm. */
+    skeletonOptions?: SkeletonizeOptions;
+}
+/**
+ * A VMobject that represents a single glyph's outline as cubic Bezier curves.
+ *
+ * The glyph's path commands (M, L, Q, C, Z) are converted to the cubic Bezier
+ * control point format that VMobject expects:
+ *   [anchor1, handle1, handle2, anchor2, handle3, handle4, anchor3, ...]
+ *
+ * Multi-contour glyphs (e.g., "o", "B", "i") produce multiple sub-paths
+ * joined by degenerate zero-length segments.
+ */
+export declare class GlyphVMobject extends VMobject {
+    private _glyph;
+    private _glyphFontSize;
+    /** Whether skeleton computation was requested */
+    private _useSkeletonStroke;
+    /** Options for skeleton computation */
+    private _skeletonOptions;
+    /** Cached skeleton path (null = not yet computed, empty array = no skeleton) */
+    private _skeletonPath;
+    /** The raw outline points used to derive the skeleton */
+    private _outlinePoints;
+    constructor(options: GlyphVMobjectOptions);
+    /**
+     * Convert glyph path commands to cubic Bezier control points in world space.
+     */
+    private _buildPoints;
+    /**
+     * Get the skeleton (medial-axis) path for this glyph.
+     *
+     * The skeleton is computed lazily on first call (unless pre-computed
+     * at construction via `useSkeletonStroke: true`).
+     *
+     * @param options  Override skeletonization options for this call.
+     * @returns Cubic Bezier control points tracing the glyph center-line,
+     *   or `null` if the glyph has no computable skeleton.
+     */
+    getSkeletonPath(options?: SkeletonizeOptions): number[][] | null;
+    /**
+     * Returns true if this glyph was configured with skeleton stroke mode.
+     */
+    get useSkeletonStroke(): boolean;
+    /**
+     * Enable or disable skeleton stroke mode.
+     * If enabling, the skeleton is computed immediately.
+     */
+    set useSkeletonStroke(value: boolean);
+    protected _createCopy(): GlyphVMobject;
+}
+//# sourceMappingURL=GlyphVMobject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GlyphVMobject.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/GlyphVMobject.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAKpF,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,KAAK,EAAE,KAAK,CAAC;IACb,6DAA6D;IAC7D,IAAI,EAAE,IAAI,CAAC;IACX,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,0DAA0D;IAC1D,eAAe,CAAC,EAAE,kBAAkB,CAAC;CACtC;AAED;;;;;;;;;GASG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,cAAc,CAAS;IAE/B,iDAAiD;IACjD,OAAO,CAAC,kBAAkB,CAAU;IACpC,uCAAuC;IACvC,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,gFAAgF;IAChF,OAAO,CAAC,aAAa,CAA2B;IAChD,yDAAyD;IACzD,OAAO,CAAC,cAAc,CAAkB;gBAE5B,OAAO,EAAE,oBAAoB;IA+BzC;;OAEG;IACH,OAAO,CAAC,YAAY;IAoHpB;;;;;;;;;OASG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,EAAE,EAAE,GAAG,IAAI;IAYhE;;OAEG;IACH,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED;;;OAGG;IACH,IAAI,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAKnC;cAEkB,WAAW,IAAI,aAAa;CAWhD"}

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

@@ -0,0 +1,161 @@
+import { Text, TextOptions } from './Text';
+/**
+ * Options for creating a MarkupText mobject
+ */
+export interface MarkupTextOptions extends TextOptions {
+}
+/**
+ * A styled text segment produced by the Pango markup parser.
+ * Each segment is a leaf span of text sharing the same style.
+ */
+export interface StyledTextSegment {
+    /** The text content (no markup) */
+    text: string;
+    /** CSS font-family */
+    fontFamily: string | null;
+    /** Font size in CSS pixels (before RESOLUTION_SCALE) */
+    fontSize: number | null;
+    /** Font weight: 'normal', 'bold', or numeric 100-900 */
+    fontWeight: string | number | null;
+    /** Font style: 'normal' | 'italic' | 'oblique' */
+    fontStyle: string | null;
+    /** Foreground (fill) color as CSS string */
+    color: string | null;
+    /** Background color as CSS string (drawn as rect behind text) */
+    backgroundColor: string | null;
+    /** Draw underline decoration */
+    underline: boolean;
+    /** Draw strikethrough decoration */
+    strikethrough: boolean;
+    /** Vertical offset factor for super/subscript. 0 = normal, negative = super, positive = sub */
+    baselineShift: number;
+    /** Font size scale relative to parent (1 = same). Used for <big>/<small>/<sup>/<sub> */
+    relativeScale: number;
+    /** CSS font-variant (e.g. 'small-caps') */
+    fontVariant: string | null;
+}
+/**
+ * MarkupText - A text mobject with Pango-like XML markup support
+ *
+ * Supports rich inline formatting via XML tags modelled after Pango markup
+ * (the same format used by Python manim's MarkupText).
+ *
+ * @example
+ * ```typescript
+ * // Bold and italic
+ * const text = new MarkupText({
+ *   text: '<b>Bold</b> and <i>Italic</i> text'
+ * });
+ *
+ * // Colored text with span
+ * const colored = new MarkupText({
+ *   text: '<span foreground="red">Red</span> and <span color="#00ff00">Green</span>'
+ * });
+ *
+ * // Nested formatting
+ * const nested = new MarkupText({
+ *   text: '<b><i>Bold Italic</i></b> with <u>underline</u>'
+ * });
+ *
+ * // Complex span attributes
+ * const complex = new MarkupText({
+ *   text: '<span font_family="Courier" font_size="24" color="yellow" weight="bold">Custom</span> text'
+ * });
+ *
+ * // Superscript and subscript
+ * const math = new MarkupText({
+ *   text: 'x<sup>2</sup> + y<sub>i</sub>'
+ * });
+ *
+ * // Size variations
+ * const sizes = new MarkupText({
+ *   text: '<big>Big</big> Normal <small>Small</small>'
+ * });
+ *
+ * // Strikethrough
+ * const strike = new MarkupText({
+ *   text: '<s>deleted</s> replaced'
+ * });
+ * ```
+ *
+ * Also supports the legacy Markdown-style syntax (**bold**, *italic*, `code`)
+ * for backward compatibility when no XML tags are detected.
+ */
+export declare class MarkupText extends Text {
+    /** Parsed styled text segments */
+    protected _styledSegments: StyledTextSegment[];
+    /** Code / monospace font family */
+    protected _codeFontFamily: string;
+    constructor(options: MarkupTextOptions);
+    /**
+     * Set new text content and re-parse markup
+     */
+    setText(text: string): this;
+    /**
+     * Get the code font family
+     */
+    getCodeFontFamily(): string;
+    /**
+     * Set the code font family
+     * @param family - CSS font family for code / tt text
+     * @returns this for chaining
+     */
+    setCodeFontFamily(family: string): this;
+    /**
+     * Get the parsed styled segments (useful for inspection / testing)
+     */
+    getStyledSegments(): readonly StyledTextSegment[];
+    /**
+     * Parse the markup text into styled segments.
+     *
+     * If the text contains Pango-like XML tags, use the XML parser.
+     * Otherwise fall back to legacy Markdown-style parsing for backward compat.
+     */
+    protected _parseMarkup(): void;
+    /**
+     * Parse Pango-like XML markup
+     */
+    protected _parsePangoMarkup(text: string): void;
+    /**
+     * Legacy Markdown-style parsing (**bold**, *italic*, `code`)
+     * for backward compatibility.
+     */
+    protected _parseLegacyMarkup(text: string): void;
+    /**
+     * Create a default (unstyled) segment
+     */
+    private _makeDefaultSegment;
+    /**
+     * Resolve a styled segment's effective font size (in CSS pixels, before RESOLUTION_SCALE).
+     */
+    protected _resolveSegmentFontSize(seg: StyledTextSegment): number;
+    /**
+     * Build a CSS font string for a styled segment.
+     */
+    protected _buildStyledFontString(seg: StyledTextSegment): string;
+    /**
+     * Get plain text without markup for compatibility
+     */
+    protected _getPlainText(): string;
+    /**
+     * Split styled segments by newlines into lines of segments.
+     */
+    protected _splitStyledSegmentsByLine(): StyledTextSegment[][];
+    /**
+     * Measure the pixel width of a line of styled segments (after RESOLUTION_SCALE).
+     */
+    protected _measureStyledLineWidth(segments: StyledTextSegment[]): number;
+    /**
+     * Get the maximum effective font size in a line (for line height calculation).
+     */
+    protected _maxFontSizeInLine(segments: StyledTextSegment[]): number;
+    protected _measureText(): {
+        lines: string[];
+        width: number;
+        height: number;
+    };
+    protected _renderToCanvas(): void;
+    protected _createCopy(): MarkupText;
+}
+export default MarkupText;
+//# sourceMappingURL=MarkupText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MarkupText.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/MarkupText.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,WAAW;CA+BrD;AAMD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wDAAwD;IACxD,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACnC,kDAAkD;IAClD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iEAAiE;IACjE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gCAAgC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,aAAa,EAAE,OAAO,CAAC;IACvB,+FAA+F;IAC/F,aAAa,EAAE,MAAM,CAAC;IACtB,wFAAwF;IACxF,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AA0fD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,UAAW,SAAQ,IAAI;IAClC,kCAAkC;IAClC,SAAS,CAAC,eAAe,EAAE,iBAAiB,EAAE,CAAM;IAEpD,mCAAmC;IACnC,SAAS,CAAC,eAAe,EAAE,MAAM,CAAe;gBAEpC,OAAO,EAAE,iBAAiB;IAOtC;;OAEG;IACM,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASpC;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;;;OAIG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASvC;;OAEG;IACH,iBAAiB,IAAI,SAAS,iBAAiB,EAAE;IAQjD;;;;;OAKG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IAe9B;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAoB/C;;;OAGG;IACH,SAAS,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IA+DhD;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;IACH,SAAS,CAAC,uBAAuB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM;IAKjE;;OAEG;IACH,SAAS,CAAC,sBAAsB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM;IAgBhE;;OAEG;IACH,SAAS,CAAC,aAAa,IAAI,MAAM;IAIjC;;OAEG;IACH,SAAS,CAAC,0BAA0B,IAAI,iBAAiB,EAAE,EAAE;IAoB7D;;OAEG;IACH,SAAS,CAAC,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM;IAYxE;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM;cAahD,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;cAsClE,eAAe,IAAI,IAAI;cAqIvB,WAAW,IAAI,UAAU;CAiB7C;AAED,eAAe,UAAU,CAAC"}

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

@@ -0,0 +1,49 @@
+import { VGroup } from '../../core/VGroup';
+export interface MathJaxRenderOptions {
+    /** Display mode (block) vs inline mode. Default: true */
+    displayMode?: boolean;
+    /** Custom LaTeX preamble (e.g. '\\usepackage{amsmath}'). Merged with defaults. */
+    preamble?: string;
+    /** Custom macros as { name: expansion }. */
+    macros?: Record<string, string>;
+    /** Color applied to the output (CSS color string). Default: '#ffffff' */
+    color?: string;
+    /** Font scale relative to surrounding text (em). Default: 1 */
+    fontScale?: number;
+}
+export interface MathJaxRenderResult {
+    /** The root SVG element produced by MathJax */
+    svgElement: SVGElement;
+    /** VMobject group with one child per glyph/path */
+    vmobjectGroup: VGroup;
+    /** Original SVG string (for debugging or caching) */
+    svgString: string;
+    /** Bounding width in MathJax "ex" units */
+    width: number;
+    /** Bounding height in MathJax "ex" units */
+    height: number;
+}
+/**
+ * Check whether MathJax has already been loaded.
+ */
+export declare function isMathJaxLoaded(): boolean;
+/**
+ * Pre-load MathJax so the first render is fast.
+ * Call this early (e.g. on page load) if you know LaTeX will be used.
+ */
+export declare function preloadMathJax(): Promise<void>;
+/**
+ * Render a LaTeX string to SVG using MathJax and convert the result
+ * into VMobject paths suitable for manim-js animation.
+ *
+ * @param texString - The raw LaTeX to render (without delimiters).
+ * @param options   - Rendering options.
+ * @returns A MathJaxRenderResult containing the SVG element and VMobject group.
+ */
+export declare function renderLatexToSVG(texString: string, options?: MathJaxRenderOptions): Promise<MathJaxRenderResult>;
+/**
+ * Quick check: can KaTeX render this LaTeX string without throwing?
+ * Used by the 'auto' renderer mode to decide whether to fall back to MathJax.
+ */
+export declare function katexCanRender(texString: string, displayMode?: boolean): boolean;
+//# sourceMappingURL=MathJaxRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MathJaxRenderer.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/MathJaxRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAOhD,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,UAAU,EAAE,UAAU,CAAC;IACvB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB;AAgGD;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpD;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAyG9B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,UAAO,GAAG,OAAO,CAW7E"}