manim-web 0.3.24 → 0.11.0

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

@@ -2,6 +2,7 @@ import { Vector3Tuple } from '../../core/Mobject';
 import { TexturedMobject } from '../../core/TexturedMobject';
 import { TextGlyphGroup } from './TextGlyphGroup';
 import { SkeletonizeOptions } from '../../utils/skeletonize';
+import { TextStyleMaps, TextStyleRun, StyledTextParams } from './textStyleRuns';
 import * as THREE from 'three';
 /**
  * Options for creating a Text mobject
@@ -31,6 +32,21 @@ export interface TextOptions {
     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;
+    /** Per-substring color map (text-to-color), as in Manim CE. Colors every occurrence of each substring. */
+    t2c?: Record<string, string>;
+    /** Per-substring font-weight map (text-to-weight), e.g. { bold: 'bold' }. */
+    t2w?: Record<string, string | number>;
+    /** Per-substring font-style map (text-to-slant), e.g. { x: 'italic' }. */
+    t2s?: Record<string, string>;
+    /**
+     * Linear color gradient fill, as in Manim CE `Text(..., gradient=(A, B, ...))`.
+     * Provide 2+ CSS colors. The text fills with a horizontal left-to-right
+     * gradient that spans its rendered box, with the colors evenly spaced across
+     * [0, 1]. The gradient takes precedence over the flat `color`. It composes
+     * with `t2c`: a substring colored by `t2c` keeps that color, and only the
+     * remaining (un-colored) characters take the gradient.
+     */
+    gradient?: string[];
 }
 export declare class Text extends TexturedMobject {
     protected _text: string;
@@ -45,6 +61,10 @@ export declare class Text extends TexturedMobject {
     protected _textAlign: 'left' | 'center' | 'right';
     /** Optional font URL for glyph vector extraction */
     protected _fontUrl?: string;
+    /** Per-substring style maps (t2c/t2w/t2s). Empty when no styling requested. */
+    protected _styleMaps: TextStyleMaps;
+    /** Linear color gradient (2+ colors), or null when the fill is flat. */
+    protected _gradient: string[] | null;
     /** Cached glyph group (created lazily by loadGlyphs) */
     protected _glyphGroup: TextGlyphGroup | null;
     /** Off-screen canvas for text rendering */
@@ -72,6 +92,24 @@ export declare class Text extends TexturedMobject {
      * @returns this for chaining
      */
     setText(text: string): this;
+    /**
+     * Get the per-substring style layout model: lines of styled runs.
+     *
+     * This is the testable model behind `t2c`/`t2w`/`t2s`. A run's null fields
+     * fall back to the Text base color/weight/style at render time.
+     */
+    getStyledTextLines(): TextStyleRun[][];
+    /**
+     * Get the configured linear gradient colors, or null when the fill is flat.
+     * Returns a copy so callers cannot mutate the internal state.
+     */
+    getGradient(): string[] | null;
+    /**
+     * True when this Text renders through the styled-run canvas path: either a
+     * per-substring style map (t2c/t2w/t2s) or an active color gradient is set.
+     * Plain Text with none of these keeps the original flat render path.
+     */
+    protected _usesStyledPath(): boolean;
     /**
      * Get the current font size
      */
@@ -121,6 +159,21 @@ export declare class Text extends TexturedMobject {
      * Draw text with custom letter spacing
      */
     protected _drawTextWithLetterSpacing(text: string, startX: number, y: number, _fontSize: number): void;
+    /** Collect the style and layout fields the styled canvas path needs. */
+    protected _styledTextParams(): StyledTextParams;
+    /**
+     * Measure styled (t2c/t2w/t2s) text via the shared styled-run layout helper.
+     */
+    protected _measureStyledText(): {
+        lines: string[];
+        width: number;
+        height: number;
+    };
+    /**
+     * Render styled (t2c/t2w/t2s) text through the shared styled-run renderer,
+     * then store the resulting world-space size.
+     */
+    protected _renderStyledToCanvas(): void;
     /**
      * Update the mesh geometry to match new dimensions
      */

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

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

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

@@ -0,0 +1,113 @@
+import { VGroup } from '../../core/VGroup';
+import { Vector3Tuple } from '../../core/Mobject';
+export interface TypstOptions {
+    /** Typst markup to compile. For `MathTypst`, math-mode content without `$`. */
+    typst: string;
+    /** Color as CSS color string. Default: WHITE ('#ffffff'). */
+    color?: string;
+    /** Scale factor (1 = standard size). Default: DEFAULT_FONT_SIZE_PT. */
+    fontSize?: number;
+    /** Position in 3D space. Default: [0, 0, 0]. */
+    position?: Vector3Tuple;
+    /** Stroke width for glyph outlines. Default: 0.00001. */
+    strokeWidth?: number;
+    /** Fill opacity for glyph interiors. Default: 1. */
+    fillOpacity?: number;
+    /** Explicit target height in world units. Overrides fontSize scaling. */
+    height?: number;
+}
+/** Options for `MathTypst` (identical shape to `TypstOptions`). */
+export type MathTypstOptions = TypstOptions;
+export declare class Typst extends VGroup {
+    /** Raw markup the user passed (before any math-mode wrapping). */
+    protected _typst: string;
+    /** Actual source compiled by Typst (wrapped for math mode in `MathTypst`). */
+    protected _source: string;
+    protected _fontSize: number;
+    protected _color: string;
+    protected _svgStrokeWidth: number;
+    protected _svgFillOpacity: number;
+    protected _targetHeight: number | undefined;
+    /** Promise that resolves when rendering is complete. */
+    protected _renderPromise: Promise<void> | null;
+    /** Error from rendering, if any. */
+    protected _renderError: Error | null;
+    constructor(options: TypstOptions);
+    /**
+     * Build the Typst source actually compiled from the user's markup.
+     * The base `Typst` compiles the markup verbatim; `MathTypst` overrides this to
+     * wrap the markup in math-mode delimiters.
+     *
+     * Pure (depends only on its argument), so it is safe to call from the base
+     * constructor before subclass fields initialize.
+     */
+    protected _buildSource(markup: string): string;
+    /**
+     * Wait for the Typst markup to finish compiling and rendering.
+     */
+    waitForRender(): Promise<void>;
+    /** Get the raw markup the user passed. */
+    getTypst(): string;
+    /** Get the actual Typst source compiled (math-wrapped for `MathTypst`). */
+    getSource(): string;
+    /**
+     * Get the render error, if any. Returns null when rendering succeeded or is
+     * still in progress.
+     */
+    getRenderError(): Error | null;
+    /**
+     * World-space center. An empty (not-yet-rendered) Typst falls back to its
+     * world-space origin instead of throwing, because Typst is built lazily and
+     * `scale()` / `moveTo()` may run before the SVG geometry exists.
+     */
+    getCenter(): Vector3Tuple;
+    /**
+     * Override setColor to propagate to all VMobject children (fill + stroke).
+     */
+    setColor(color: string): this;
+    /**
+     * Start the async rendering process.
+     */
+    protected _startRender(): void;
+    /**
+     * Compile the Typst source to SVG and build 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 point data directly.
+     *
+     * Unit flow mirrors MathTex: convert Typst SVG units to world units via the
+     * font-size baseline and `TYPST_SVG_UNITS_PER_EM`. An explicit `height`
+     * overrides the fontSize scaling with an exact target.
+     */
+    protected _scaleToTarget(): void;
+    /**
+     * Bake any pending parent `scaleVector` (e.g. from a pre-render `scale()`)
+     * into descendant geometry so post-render `shift` / `moveTo` operate in the
+     * same coordinate frame as the rendered glyphs (mirrors MathTex #324).
+     */
+    protected _consumePendingScale(): void;
+    copy(): Typst;
+}
+/**
+ * MathTypst - Typst in display math mode.
+ *
+ * Wraps the input in Typst math delimiters (`$ ... $`), mirroring how `MathTex`
+ * renders math while `Tex` renders text. The raw markup is kept verbatim in
+ * `getTypst()`; the wrapped form is what the compiler receives (`getSource()`).
+ *
+ * @example
+ * ```typescript
+ * const eq = new MathTypst({ typst: 'sum_(k=1)^n k = frac(n(n + 1), 2)' });
+ * await eq.waitForRender();
+ * ```
+ */
+export declare class MathTypst extends Typst {
+    protected _buildSource(markup: string): string;
+    copy(): MathTypst;
+}
+//# sourceMappingURL=Typst.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Typst.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/Typst.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,KAAK,EAAyB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAiB9E,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAE5C,qBAAa,KAAM,SAAQ,MAAM;IAC/B,kEAAkE;IAClE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAC5B,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;IAE5C,wDAAwD;IACxD,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAQ;IACtD,oCAAoC;IACpC,SAAS,CAAC,YAAY,EAAE,KAAK,GAAG,IAAI,CAAQ;gBAEhC,OAAO,EAAE,YAAY;IA8BjC;;;;;;;OAOG;IACH,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI9C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IASpC,0CAA0C;IAC1C,QAAQ,IAAI,MAAM;IAIlB,2EAA2E;IAC3E,SAAS,IAAI,MAAM;IAInB;;;OAGG;IACH,cAAc,IAAI,KAAK,GAAG,IAAI;IAI9B;;;;OAIG;IACM,SAAS,IAAI,YAAY;IAOlC;;OAEG;IACM,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAkBtC;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IAW9B;;OAEG;cACa,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBxC;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAmB/C;;;;;;OAMG;IACH,SAAS,CAAC,cAAc,IAAI,IAAI;IAgDhC;;;;OAIG;IACH,SAAS,CAAC,oBAAoB,IAAI,IAAI;IAuB7B,IAAI,IAAI,KAAK;CAavB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,SAAU,SAAQ,KAAK;cACf,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI9C,IAAI,IAAI,SAAS;CAa3B"}

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

@@ -0,0 +1,57 @@
+import { VGroup } from '../../core/VGroup';
+export interface TypstRenderOptions {
+    /** Stroke / fill color for the resulting VMobjects. Default: WHITE. */
+    color?: string;
+    /** Stroke width passed to the SVG importer. Default: 0.02. */
+    strokeWidth?: number;
+    /** Fill opacity passed to the SVG importer. Default: 1. */
+    fillOpacity?: number;
+}
+export interface TypstRenderResult {
+    /** The root SVG element produced by the Typst compiler. */
+    svgElement: SVGElement;
+    /** VMobject group with one child per glyph / path. */
+    vmobjectGroup: VGroup;
+    /** Original SVG string (for debugging or caching). */
+    svgString: string;
+    /** Bounding width in the SVG's viewBox units. */
+    width: number;
+    /** Bounding height in the SVG's viewBox units. */
+    height: number;
+}
+/**
+ * A function that compiles a Typst source string to a full SVG string.
+ * Used as the dependency-injection seam: tests set a mock compiler so the
+ * real WASM compiler is never loaded.
+ */
+export type TypstSvgCompiler = (source: string) => Promise<string> | string;
+/**
+ * Inject a Typst compiler, replacing the lazy-loaded WASM compiler.
+ *
+ * Pass a function that maps a Typst source string to an SVG string. Pass `null`
+ * to restore the default WASM-backed compiler. Tests use this to avoid any real
+ * WASM compile.
+ */
+export declare function setTypstCompiler(compiler: TypstSvgCompiler | null): void;
+/**
+ * Check whether the Typst compiler has already been loaded.
+ */
+export declare function isTypstLoaded(): boolean;
+/**
+ * Pre-load the Typst compiler so the first render is fast.
+ * Call this early if you know Typst will be used.
+ */
+export declare function preloadTypst(): Promise<void>;
+/**
+ * Compile a Typst source string to SVG and convert the result into VMobject
+ * paths suitable for manim-web animation.
+ *
+ * The returned VMobject coordinates are raw SVG viewBox units (not world units).
+ * The caller (`Typst`) applies the final point -> world conversion.
+ *
+ * @param source  - The Typst source to compile (already wrapped for math mode
+ *                  by `MathTypst` when applicable).
+ * @param options - Rendering options.
+ */
+export declare function renderTypstToSVG(source: string, options?: TypstRenderOptions): Promise<TypstRenderResult>;
+//# sourceMappingURL=TypstRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TypstRenderer.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/TypstRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAQhD,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,UAAU,EAAE,UAAU,CAAC;IACvB,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;AAoB5E;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAExE;AA8BD;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAGlD;AAeD;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CA0D5B"}

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

@@ -5,16 +5,19 @@
  * applied to Three.js plane meshes, as well as LaTeX rendering using KaTeX.
  */
 export { Text, type TextOptions } from './Text';
+export { type TextStyleMaps, type TextStyleRun, buildStyledTextLines } from './textStyleRuns';
 export { GlyphVMobject, type GlyphVMobjectOptions } from './GlyphVMobject';
 export { TextGlyphGroup, type TextGlyphGroupOptions } from './TextGlyphGroup';
 export { Paragraph, type ParagraphOptions } from './Paragraph';
 export { MarkupText, type MarkupTextOptions, type StyledTextSegment } from './MarkupText';
-export { ensureKatexStyles, areKatexStylesLoaded } from './katexStyles';
+export { ensureKatexStyles, areKatexStylesLoaded, setKatexStylesheetUrl } from './katexStyles';
 export { MathTex, type MathTexOptions, MathTexSVG, type MathTexSVGOptions } from './MathTex';
 export { MathTexImage, type MathTexImageOptions, type TexRenderer } from './MathTexImage';
-export { renderLatexToSVG, preloadMathJax, isMathJaxLoaded, katexCanRender, type MathJaxRenderOptions, type MathJaxRenderResult, } from './MathJaxRenderer';
+export { renderLatexToSVG, preloadMathJax, isMathJaxLoaded, katexCanRender, setMathJaxScriptUrl, type MathJaxRenderOptions, type MathJaxRenderResult, } from './MathJaxRenderer';
 export { parseSVGPathData, svgToVMobjects, type SVGToVMobjectOptions } from './svgPathParser';
 export { Tex, type TexOptions } from './Tex';
+export { Typst, MathTypst, type TypstOptions, type MathTypstOptions } from './Typst';
+export { renderTypstToSVG, preloadTypst, isTypstLoaded, setTypstCompiler, type TypstRenderOptions, type TypstRenderResult, type TypstSvgCompiler, } from './TypstRenderer';
 export { DecimalNumber, Integer, type DecimalNumberOptions } from './DecimalNumber';
 export { Variable, type VariableOptions } from './Variable';
 export { Code, type CodeOptions, type CodeColorScheme, type Token, type TokenType, DEFAULT_COLOR_SCHEME, MONOKAI_COLOR_SCHEME, } from './Code';

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,eAAe,CAAC;AAGxE,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG7F,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG1F,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG9F,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAG7C,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGpF,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,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,WAAW,EACX,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AAGxB,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,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG9F,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,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAG/F,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG7F,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG1F,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG9F,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAI7C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGpF,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,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,WAAW,EACX,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC"}

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

@@ -3,6 +3,11 @@
  *
  * Ensures the KaTeX stylesheet is loaded for proper LaTeX rendering.
  */
+/**
+ * Configure the stylesheet loaded by {@link ensureKatexStyles}.
+ * Pass `null` when the application bundles KaTeX CSS itself.
+ */
+export declare function setKatexStylesheetUrl(url: string | null): void;
 /**
  * Ensure KaTeX styles are loaded in the document.
  * This is called automatically by MathTex on first use.

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

@@ -1 +1 @@
-{"version":3,"file":"katexStyles.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/katexStyles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiCH;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4BlD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C"}
+{"version":3,"file":"katexStyles.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/katexStyles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAK9D;AA4BD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiClD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C"}

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

@@ -0,0 +1,38 @@
+/**
+ * `registerFont` — register a custom font in the browser (CE `register_font`).
+ *
+ * CE's `register_font(path)` registers a font file with the system so Pango can
+ * use it when rasterizing text. The browser analog is the CSS Font Loading API:
+ * build a `FontFace` and add it to `document.fonts`. The browser then loads the
+ * font lazily the first time text uses the family, so adding the face is enough
+ * to make the family available — no eager `load()` call is required.
+ *
+ * The function is guarded for environments without the API (Node, test workers,
+ * server-side rendering): it returns `false` and does nothing when `document`,
+ * `document.fonts`, or `FontFace` is unavailable, so it is safe to call anywhere.
+ */
+/**
+ * A font source accepted by `registerFont`.
+ *
+ * - A `string` is a CSS source. A bare URL or path is wrapped as `url("…")`;
+ *   a value that already starts with `url(` or `local(` is used verbatim.
+ * - A `BufferSource` (an `ArrayBuffer` or typed-array view) is font binary data,
+ *   passed straight to the `FontFace` constructor.
+ */
+export type FontSource = string | BufferSource;
+/**
+ * Register a custom font so text mobjects can use it by family name.
+ *
+ * @param family - The font-family name to register the source under.
+ * @param source - A CSS source string, a URL/path, or font binary data.
+ * @returns `true` when the font was registered, `false` when the CSS Font
+ *   Loading API is unavailable (for example in Node or a test worker).
+ *
+ * @example
+ * ```typescript
+ * registerFont('Inter', 'https://example.com/Inter.woff2');
+ * registerFont('Inter', 'url("/fonts/Inter.woff2")'); // explicit CSS source
+ * ```
+ */
+export declare function registerFont(family: string, source: FontSource): boolean;
+//# sourceMappingURL=registerFont.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registerFont.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/registerFont.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,YAAY,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAiBxE"}

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

@@ -0,0 +1,111 @@
+/**
+ * Per-substring style runs for the canvas-raster Text mobject.
+ *
+ * Manim CE lets `Text` color or restyle sub-strings through `t2c`
+ * (text-to-color), `t2w` (text-to-weight) and `t2s` (text-to-slant) maps. This
+ * module turns the plain text plus those maps into a layout model: a list of
+ * lines, each a list of styled runs. The model is pure and testable; the Text
+ * canvas renderer draws each run with its own font and color.
+ */
+/** Per-substring style maps, as in Manim CE `Text`. */
+export interface TextStyleMaps {
+    /** Map from a substring to a CSS color. Colors every occurrence. */
+    t2c?: Record<string, string>;
+    /** Map from a substring to a font weight ('bold', 'normal', 100-900). */
+    t2w?: Record<string, string | number>;
+    /** Map from a substring to a font style ('italic', 'oblique', 'normal'). */
+    t2s?: Record<string, string>;
+}
+/** One run of characters that share the same resolved style. */
+export interface TextStyleRun {
+    /** The run text (never contains a newline). */
+    text: string;
+    /** Resolved color, or null to use the Text base color. */
+    color: string | null;
+    /** Resolved font weight, or null to use the Text base weight. */
+    fontWeight: string | number | null;
+    /** Resolved font style, or null to use the Text base style. */
+    fontStyle: string | null;
+}
+/** True when at least one style map has an entry. */
+export declare function hasStyleMaps(maps: TextStyleMaps): boolean;
+/**
+ * Split `text` into lines on '\n', then each line into styled runs.
+ * An empty line yields an empty run list.
+ */
+export declare function buildStyledTextLines(text: string, maps: TextStyleMaps): TextStyleRun[][];
+/** Base font fields a run falls back to when it has no override. */
+export interface RunFontBase {
+    fontStyle: string;
+    fontWeight: string | number;
+    /** The scaled point size, used directly as `<n>pt` in the CSS font string. */
+    sizePt: number;
+    fontFamily: string;
+}
+/** Build the CSS canvas font string for one run, with base fallbacks. */
+export declare function runFontString(run: TextStyleRun, base: RunFontBase): string;
+/** One color stop of a linear gradient: an offset in [0, 1] and its CSS color. */
+export interface GradientStop {
+    offset: number;
+    color: string;
+}
+/**
+ * Build evenly-spaced gradient color stops from a color list.
+ *
+ * Two colors map to offsets [0, 1], three to [0, 0.5, 1], and n colors to
+ * offset i/(n-1). The color order is preserved. A single color is degenerate:
+ * it yields one stop at offset 0, which fills a solid color. An empty list
+ * yields no stops.
+ *
+ * This is pure, so the stop math is unit-testable without a real canvas.
+ */
+export declare function buildGradientStops(colors: string[]): GradientStop[];
+/**
+ * True when `gradient` can drive a linear gradient fill: it exists and has at
+ * least two colors, as Manim CE requires.
+ */
+export declare function gradientIsActive(gradient: string[] | null | undefined): gradient is string[];
+/** Style and layout fields the styled canvas path needs from a Text instance. */
+export interface StyledTextParams {
+    fontSize: number;
+    fontFamily: string;
+    fontStyle: string;
+    fontWeight: string | number;
+    lineHeight: number;
+    textAlign: 'left' | 'center' | 'right';
+    color: string;
+    fillOpacity: number;
+    strokeWidth: number;
+    /**
+     * Optional linear color gradient (2+ colors). When set, runs with no explicit
+     * color (no `t2c` match) fill with a horizontal left-to-right gradient that
+     * spans the text's rendered box. Runs with an explicit `t2c` color keep that
+     * color, so the gradient composes with `t2c` rather than overriding it.
+     */
+    gradient?: string[];
+}
+/**
+ * Measure styled text. Each run is measured with its own font so a bolder or
+ * italic run reserves the correct width. Letter spacing is not applied in
+ * styled mode so measure and render stay consistent.
+ */
+export declare function measureStyledText(ctx: CanvasRenderingContext2D, styledLines: TextStyleRun[][], params: StyledTextParams): {
+    lines: string[];
+    width: number;
+    height: number;
+};
+/**
+ * Draw styled text to the canvas and return its world-space size. Each run is
+ * drawn with its own font and color; x advances by the measured width of each
+ * run, so mixed-weight and mixed-style runs stay correctly spaced.
+ *
+ * The world-size conversion matches the plain Text path exactly.
+ */
+export declare function renderStyledTextToCanvas(canvas: HTMLCanvasElement, ctx: CanvasRenderingContext2D, styledLines: TextStyleRun[][], params: StyledTextParams, worldPerPt: {
+    defaultFontSizePt: number;
+    defaultFontSizeInWorld: number;
+}): {
+    width: number;
+    height: number;
+};
+//# sourceMappingURL=textStyleRuns.d.ts.map

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

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

package/dist/mobjects/three-d/ModelMobject.d.ts

@@ -0,0 +1,122 @@
+import { Vector3Tuple } from '../../core/Mobject';
+import { Mobject3D } from './Mobject3D';
+/**
+ * ModelMobject - import an external 3D model (glTF / .glb / .obj) as a mobject.
+ *
+ * ManimCE has no way to import an external 3D model (see the long-standing
+ * "OBJ Support" request). Three.js ships loaders for the common formats, so
+ * manim-web exposes them through a mobject that drops the loaded
+ * `THREE.Object3D` into the normal Group/Mobject hierarchy. The model then
+ * participates in shift / scale / rotate, z-depth and the 3D camera exactly
+ * like a built-in primitive (Cube, Surface3D, ...).
+ *
+ * Scene-graph wiring (why there are nested groups):
+ *   wrapper      - returned as `_threeObject`; its local transform is written
+ *                  by `Mobject._syncToThree` from the mobject transform, so it
+ *                  must stay under manim's control alone.
+ *     content    - carries the `scale` and `upAxis` options.
+ *       center   - carries the `center` recenter offset.
+ *         model  - the pristine loaded Object3D (never mutated by options, so
+ *                  `copy()` can clone it and re-apply the options cleanly).
+ *
+ * The real Three.js example loaders are pulled in through a lazy dynamic
+ * `import()` on first use, so the base bundle and SSR never load them. Tests
+ * inject a loader (via the `loader` option or `setModelLoaderFactory`), which
+ * bypasses the import and the network entirely - mirroring the
+ * `setTypstCompiler` dependency-injection seam in TypstRenderer.
+ */
+import * as THREE from 'three';
+/** Supported model formats, picked from the URL extension. */
+export type ModelFormat = 'gltf' | 'obj';
+/**
+ * The model's up direction. An axis name, or an explicit vector. The model is
+ * rotated so this direction aligns with the scene up (+Y).
+ */
+export type ModelUpAxis = 'x' | 'y' | 'z' | Vector3Tuple;
+/** A GLTF-style result, whose root Object3D lives on `.scene`. */
+interface GltfLike {
+    scene: THREE.Object3D;
+}
+/**
+ * The minimal loader contract ModelMobject needs. Three.js GLTFLoader and
+ * OBJLoader both satisfy it structurally. Tests implement it with a stub.
+ */
+export interface ModelLoader {
+    loadAsync(url: string, onProgress?: (event: ProgressEvent) => void): Promise<THREE.Object3D | GltfLike>;
+}
+/** Builds a loader for a format. The DI seam set by `setModelLoaderFactory`. */
+export type ModelLoaderFactory = (format: ModelFormat) => ModelLoader | Promise<ModelLoader>;
+/** Options for {@link ModelMobject.fromUrl}. */
+export interface ModelMobjectOptions {
+    /** Uniform factor, or per-axis factors, applied to the loaded model. */
+    scale?: number | Vector3Tuple;
+    /** The model's up direction; the model is rotated to the scene up (+Y). */
+    upAxis?: ModelUpAxis;
+    /** Recenter the model's bounding box to the origin. Default: false. */
+    center?: boolean;
+    /** Convenience fill color applied to every mesh material. */
+    color?: string;
+    /** Replace every mesh material with this one. Wins over `color`. */
+    materialOverride?: THREE.Material;
+    /** Progress callback forwarded to the loader. */
+    onProgress?: (event: ProgressEvent) => void;
+    /** Inject a loader directly (bypasses the factory and the network). */
+    loader?: ModelLoader;
+    /**
+     * When false, a load failure resolves to an empty ModelMobject whose
+     * {@link ModelMobject.getLoadError} holds the error instead of rejecting.
+     * Default: true (the returned promise rejects on failure).
+     */
+    throwOnError?: boolean;
+}
+/**
+ * Inject a loader factory, replacing the lazy-loaded Three.js example loaders.
+ * Pass `null` to restore the default. Tests use this to avoid any real loader.
+ */
+export declare function setModelLoaderFactory(factory: ModelLoaderFactory | null): void;
+/** Pick the model format from a URL's extension (ignores query and fragment). */
+export declare function detectModelFormat(url: string): ModelFormat;
+export declare class ModelMobject extends Mobject3D {
+    private readonly _model;
+    private readonly _centerGroup;
+    private readonly _content;
+    private readonly _wrapper;
+    private readonly _format;
+    private readonly _options;
+    private _loadError;
+    /**
+     * Prefer {@link ModelMobject.fromUrl}. This constructor wraps an already
+     * loaded Object3D (or `null` for an empty placeholder) and applies the
+     * geometry options.
+     */
+    constructor(object: THREE.Object3D | null, options?: ModelMobjectOptions, format?: ModelFormat | null);
+    /**
+     * Load a model from a URL and return a ready ModelMobject.
+     *
+     * The loader is chosen from the extension: `.glb` / `.gltf` -> GLTFLoader,
+     * `.obj` -> OBJLoader. Inject a loader with the `loader` option (or
+     * `setModelLoaderFactory`) to avoid the network, e.g. in tests.
+     */
+    static fromUrl(url: string, options?: ModelMobjectOptions): Promise<ModelMobject>;
+    /** Offset the center group so the model's bounding box sits at the origin. */
+    private _recenter;
+    /** Rotate the content group so the model's up axis aligns with +Y. */
+    private _applyUpAxis;
+    private _upAxisVector;
+    /** Scale the content group uniformly or per axis. */
+    private _applyScale;
+    /** Apply a material override, or a fill color, to every mesh in the model. */
+    private _applyMaterials;
+    private _applyColor;
+    private _forEachMesh;
+    /** The loaded model root (an empty Group if the load failed). */
+    getObject(): THREE.Object3D;
+    /** The format this model was loaded as, or null for a bare construction. */
+    getFormat(): ModelFormat | null;
+    /** The load error, or null if the model loaded successfully. */
+    getLoadError(): Error | null;
+    protected _createThreeObject(): THREE.Object3D;
+    copy(): ModelMobject;
+}
+export {};
+//# sourceMappingURL=ModelMobject.d.ts.map

package/dist/mobjects/three-d/ModelMobject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelMobject.d.ts","sourceRoot":"","sources":["../../../src/mobjects/three-d/ModelMobject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAMxC,8DAA8D;AAC9D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,CAAC;AAEzC;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,YAAY,CAAC;AAEzD,kEAAkE;AAClE,UAAU,QAAQ;IAChB,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,CACP,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAC1C,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC;CACvC;AAED,gFAAgF;AAChF,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAE7F,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC9B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC;IAClC,iDAAiD;IACjD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C,uEAAuE;IACvE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAYD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAE9E;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAK1D;AAiDD,qBAAa,YAAa,SAAQ,SAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,UAAU,CAAsB;IAExC;;;;OAIG;gBAED,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,EAC7B,OAAO,GAAE,mBAAwB,EACjC,MAAM,GAAE,WAAW,GAAG,IAAW;IAuBnC;;;;;;OAMG;WACU,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC;IAoB3F,8EAA8E;IAC9E,OAAO,CAAC,SAAS;IAOjB,sEAAsE;IACtE,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,aAAa;IASrB,qDAAqD;IACrD,OAAO,CAAC,WAAW;IASnB,8EAA8E;IAC9E,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,YAAY;IAQpB,iEAAiE;IACjE,SAAS,IAAI,KAAK,CAAC,QAAQ;IAI3B,4EAA4E;IAC5E,SAAS,IAAI,WAAW,GAAG,IAAI;IAI/B,gEAAgE;IAChE,YAAY,IAAI,KAAK,GAAG,IAAI;IAM5B,SAAS,CAAC,kBAAkB,IAAI,KAAK,CAAC,QAAQ;IAIrC,IAAI,IAAI,YAAY;CAO9B"}