manim-web 0.3.24 → 0.10.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/ThreeDAxes.d.ts

@@ -12,6 +12,22 @@ export interface ThreeDAxesOptions {
     yRange?: [number, number, number];
     /** Z-axis range as [min, max, step]. Default: [-4, 4, 1] */
     zRange?: [number, number, number];
+    /**
+     * Visual length of the x-axis in scene units, independent of xRange.
+     * When omitted, defaults to the x-range span (xMax - xMin), so the axis
+     * keeps a 1:1 range-to-visual mapping (unchanged default behavior).
+     */
+    xLength?: number;
+    /**
+     * Visual length of the y-axis in scene units, independent of yRange.
+     * When omitted, defaults to the y-range span (yMax - yMin).
+     */
+    yLength?: number;
+    /**
+     * Visual length of the z-axis in scene units, independent of zRange.
+     * When omitted, defaults to the z-range span (zMax - zMin).
+     */
+    zLength?: number;
     /** Default color for all axes. Default: '#ffffff' */
     axisColor?: string;
     /** Color for x-axis (overrides axisColor). Default: same as axisColor */
@@ -85,6 +101,12 @@ export declare class ThreeDAxes extends Group {
     private _xRange;
     private _yRange;
     private _zRange;
+    private _xLength;
+    private _yLength;
+    private _zLength;
+    private _xScale;
+    private _yScale;
+    private _zScale;
     private _showTicks;
     private _tickLength;
     private _ticks;
@@ -99,6 +121,12 @@ export declare class ThreeDAxes extends Group {
     private _labelOptions;
     constructor(options?: ThreeDAxesOptions);
     private _initRanges;
+    /**
+     * Resolve each axis visual length and its range-to-visual scale factor.
+     * When a length option is omitted, it defaults to the range span, which
+     * gives scale 1 and keeps the historical 1:1 mapping unchanged.
+     */
+    private _initLengths;
     private _initTickConfig;
     private _initLabelConfig;
     private _resolveAxisColors;
@@ -147,7 +175,9 @@ export declare class ThreeDAxes extends Group {
     private _buildLabel;
     /**
      * Convert graph coordinates to visual point coordinates (scene space).
-     * With unit_size=1, graph coordinates map directly to visual positions.
+     * Each graph coordinate is multiplied by its axis scale (length / span)
+     * before the axes' position offset is applied. With default lengths the
+     * scale is 1, so graph coordinates map directly to visual positions.
      */
     coordsToPoint(x: number, y: number, z: number): Vector3Tuple;
     /**
@@ -187,15 +217,18 @@ export declare class ThreeDAxes extends Group {
      */
     getZRange(): [number, number, number];
     /**
-     * Get the visual X length (range span)
+     * Get the visual X length in scene units. Equals the configured xLength,
+     * or the x-range span when xLength was omitted.
      */
     getXLength(): number;
     /**
-     * Get the visual Y length (range span)
+     * Get the visual Y length in scene units. Equals the configured yLength,
+     * or the y-range span when yLength was omitted.
      */
     getYLength(): number;
     /**
-     * Get the visual Z length (range span)
+     * Get the visual Z length in scene units. Equals the configured zLength,
+     * or the z-range span when zLength was omitted.
      */
     getZLength(): number;
     /**

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

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

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

@@ -0,0 +1,25 @@
+import { Vector3Tuple } from '../../core/MobjectTypes';
+import { VMobject } from '../../core/VMobject';
+/**
+ * The gradient start and end points, used by the 3D camera to shade a VMobject.
+ * Port of CE `get_3d_vmob_gradient_start_and_end_points`.
+ */
+export declare function get3dVmobGradientStartAndEndPoints(vmob: VMobject): [Vector3Tuple, Vector3Tuple];
+/** Index of the start corner (always 0). Port of CE `get_3d_vmob_start_corner_index`. */
+export declare function get3dVmobStartCornerIndex(_vmob: VMobject): number;
+/** Index of the end corner. Port of CE `get_3d_vmob_end_corner_index`. */
+export declare function get3dVmobEndCornerIndex(vmob: VMobject): number;
+/** The start corner point. Port of CE `get_3d_vmob_start_corner`. */
+export declare function get3dVmobStartCorner(vmob: VMobject): Vector3Tuple;
+/** The end corner point. Port of CE `get_3d_vmob_end_corner`. */
+export declare function get3dVmobEndCorner(vmob: VMobject): Vector3Tuple;
+/**
+ * The unit normal of the VMobject's surface at the given point index.
+ * Port of CE `get_3d_vmob_unit_normal`.
+ */
+export declare function get3dVmobUnitNormal(vmob: VMobject, pointIndex: number): Vector3Tuple;
+/** The unit normal at the start corner. Port of CE `get_3d_vmob_start_corner_unit_normal`. */
+export declare function get3dVmobStartCornerUnitNormal(vmob: VMobject): Vector3Tuple;
+/** The unit normal at the end corner. Port of CE `get_3d_vmob_end_corner_unit_normal`. */
+export declare function get3dVmobEndCornerUnitNormal(vmob: VMobject): Vector3Tuple;
+//# sourceMappingURL=threeDVmobUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"threeDVmobUtils.d.ts","sourceRoot":"","sources":["../../../src/mobjects/three-d/threeDVmobUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAExE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAiBpD;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,QAAQ,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAE/F;AAED,yFAAyF;AACzF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAEjE;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAE9D;AAED,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAMjE;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAM/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAiBpF;AAED,8FAA8F;AAC9F,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAE3E;AAED,0FAA0F;AAC1F,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAEzE"}

package/dist/renderer-DR_79fB0.js

@@ -0,0 +1,2 @@
+import { i as e } from "./esm-CiMKSfxz.js";
+export { e as createTypstRenderer };