manim-web 0.11.0 → 0.12.0

package/dist/mobjects/svg/SVGMobject.d.ts

@@ -1,5 +1,6 @@
 import { VMobject } from '../../core/VMobject';
 import { VGroup } from '../../core/VGroup';
+import { SvgFetcher } from './svgLoader';
 /**
  * SVGMobject options
  */
@@ -21,6 +22,14 @@ export interface SVGMobjectOptions {
     /** Center position */
     center?: [number, number, number];
 }
+/**
+ * Options for {@link SVGMobject.fromUrl}. Same as {@link SVGMobjectOptions}
+ * (minus `svgString`, which is fetched) plus an injectable fetcher.
+ */
+export type SVGMobjectFromUrlOptions = Omit<SVGMobjectOptions, 'svgString'> & {
+    /** Fetch implementation. Defaults to `globalThis.fetch`. */
+    fetcher?: SvgFetcher;
+};
 /**
  * VMobjectFromSVGPath options
  */
@@ -49,7 +58,27 @@ export declare class VMobjectFromSVGPath extends VMobject {
  */
 export declare class SVGMobject extends VGroup {
     private _svgString;
+    private _loadError;
     constructor(options?: SVGMobjectOptions);
+    /**
+     * Fetch an SVG from a URL and parse it through the standard string path.
+     *
+     * The fetcher is injected (default `globalThis.fetch`) so tests can mock it.
+     * A fetch or parse failure does not throw: it returns an empty SVGMobject
+     * whose {@link getLoadError} reports the error.
+     *
+     * @param url - The SVG resource URL.
+     * @param options - Standard SVGMobject options plus an optional `fetcher`.
+     * @returns A promise resolving to the parsed (or empty, on error) SVGMobject.
+     */
+    static fromUrl(url: string, options?: SVGMobjectFromUrlOptions): Promise<SVGMobject>;
+    /**
+     * The error captured while loading or parsing, or null when none occurred.
+     *
+     * Set by {@link fromUrl} on a fetch failure and by the parser when the input
+     * has no `<svg>` root.
+     */
+    getLoadError(): Error | null;
     private _parseSVG;
     /**
      * Get all subpaths as individual VMobjects.

package/dist/mobjects/svg/SVGMobject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SVGMobject.d.ts","sourceRoot":"","sources":["../../../src/mobjects/svg/SVGMobject.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAQ3C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAydD;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,0BAA0B;IAqBtC,IAAI,IAAI,mBAAmB;CAWrC;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,MAAM;IACpC,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,GAAE,iBAAsB;IAqC3C,OAAO,CAAC,SAAS;IAuOjB;;OAEG;IACH,WAAW,IAAI,QAAQ,EAAE;IAIhB,IAAI,IAAI,UAAU;CAO5B;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAC7C,UAAU,CAEZ"}
+{"version":3,"file":"SVGMobject.d.ts","sourceRoot":"","sources":["../../../src/mobjects/svg/SVGMobject.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAQ3C,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAK/E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAAG;IAC5E,4DAA4D;IAC5D,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAocD;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,0BAA0B;IAqBtC,IAAI,IAAI,mBAAmB;CAWrC;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,MAAM;IACpC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAsB;gBAE5B,OAAO,GAAE,iBAAsB;IAqC3C;;;;;;;;;;OAUG;WACU,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,UAAU,CAAC;IAa9F;;;;;OAKG;IACH,YAAY,IAAI,KAAK,GAAG,IAAI;IAI5B,OAAO,CAAC,SAAS;IAmPjB;;OAEG;IACH,WAAW,IAAI,QAAQ,EAAE;IAIhB,IAAI,IAAI,UAAU;CAO5B;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAC7C,UAAU,CAEZ"}

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

@@ -6,5 +6,7 @@
  * of the manimweb rendering pipeline.
  */
 export { Brace, BraceBetweenPoints, ArcBrace, BraceLabel, BraceText, type BraceOptions, type BraceBetweenPointsOptions, type ArcBraceOptions, type BraceLabelOptions, } from './Brace';
-export { SVGMobject, svgMobject, VMobjectFromSVGPath, type SVGMobjectOptions, type VMobjectFromSVGPathOptions, } from './SVGMobject';
+export { SVGMobject, svgMobject, VMobjectFromSVGPath, type SVGMobjectOptions, type VMobjectFromSVGPathOptions, type SVGMobjectFromUrlOptions, } from './SVGMobject';
+export { GradientVMobject, type GradientVMobjectOptions, type SvgGradient, type SvgGradientStop, type SvgGradientType, } from './svgGradients';
+export { type SvgFetcher, type SvgFetchResponse } from './svgLoader';
 //# sourceMappingURL=index.d.ts.map

package/dist/mobjects/svg/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/svg/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,KAAK,EACL,kBAAkB,EAClB,QAAQ,EACR,UAAU,EACV,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,GAChC,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/svg/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,KAAK,EACL,kBAAkB,EAClB,QAAQ,EACR,UAAU,EACV,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,GAC9B,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/mobjects/svg/svgFill.d.ts

@@ -0,0 +1,42 @@
+import { VMobject } from '../../core/VMobject';
+import { SvgGradient } from './svgGradients';
+/**
+ * Create a flat-styled VMobject from Bezier control points.
+ *
+ * @param points3D - Bezier control points in 3D.
+ * @param color - Stroke color.
+ * @param strokeWidth - Stroke width.
+ * @param fillColor - Optional fill color.
+ * @param fillOpacity - Fill opacity (default 0).
+ */
+export declare function createStyledVMobject(points3D: [number, number, number][], color: string, strokeWidth: number, fillColor?: string, fillOpacity?: number): VMobject;
+/** Options describing how to style one SVG shape's fill. */
+export interface FilledVMobjectOptions {
+    /** Bezier control points in 3D. */
+    points3D: [number, number, number][];
+    /** Resolved stroke color. */
+    strokeColor: string;
+    /** Resolved stroke width. */
+    strokeWidth: number;
+    /** The raw `fill` attribute from the element (may be null). */
+    rawFill: string | null;
+    /**
+     * Fallback fill used when the element has no `fill` attribute. `<path>` falls
+     * back to the SVGMobject default fill; other shapes pass undefined to match
+     * their original behavior.
+     */
+    fallbackFill?: string;
+    /** Default fill opacity for a filled shape. */
+    defaultFillOpacity?: number;
+    /** Gradient definitions for resolving `url(#id)` fills. */
+    defs: Map<string, SvgGradient>;
+}
+/**
+ * Build a VMobject for a fill-bearing SVG shape, applying a gradient fill when
+ * the `fill` is a resolvable `url(#id)` reference and a flat fill otherwise.
+ *
+ * The flat-fill branch reproduces the original per-shape logic exactly, so
+ * non-gradient shapes are unaffected.
+ */
+export declare function makeFilledVMobject(options: FilledVMobjectOptions): VMobject;
+//# sourceMappingURL=svgFill.d.ts.map

package/dist/mobjects/svg/svgFill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svgFill.d.ts","sourceRoot":"","sources":["../../../src/mobjects/svg/svgFill.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEzF;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,EACpC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,QAAQ,CAUV;AAED,4DAA4D;AAC5D,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IACrC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAChC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,QAAQ,CAqB3E"}

package/dist/mobjects/svg/svgGradients.d.ts

@@ -0,0 +1,68 @@
+import { VMobject } from '../../core/VMobject';
+/** Gradient geometry kind parsed from an SVG definition. */
+export type SvgGradientType = 'linear' | 'radial';
+/** One color stop of an SVG gradient. */
+export interface SvgGradientStop {
+    /** Position along the gradient, clamped to [0, 1]. */
+    offset: number;
+    /** Stop color as a CSS color string (default black). */
+    color: string;
+    /** Stop opacity in [0, 1] (default 1). */
+    opacity: number;
+}
+/** Parsed SVG gradient definition. */
+export interface SvgGradient {
+    /** The gradient `id` used by `url(#id)` references. */
+    id: string;
+    /** Gradient kind. Radial is approximated as a linear stop sequence. */
+    type: SvgGradientType;
+    /** Ordered color stops. */
+    stops: SvgGradientStop[];
+}
+/**
+ * Collect every `<linearGradient>`/`<radialGradient>` definition in an SVG,
+ * keyed by its `id`. Gradients without an `id` or without stops are skipped.
+ *
+ * @param svg - The parsed `<svg>` root element.
+ * @returns A map from gradient id to its parsed definition.
+ */
+export declare function parseGradientDefs(svg: Element): Map<string, SvgGradient>;
+/**
+ * Resolve a `fill="url(#id)"` reference to its gradient definition.
+ *
+ * @param fillAttr - The raw fill attribute value.
+ * @param defs - Gradient definitions from {@link parseGradientDefs}.
+ * @returns The matching gradient, or undefined when the fill is not a gradient
+ *   reference or the id is unknown.
+ */
+export declare function resolveGradientFill(fillAttr: string | null | undefined, defs: Map<string, SvgGradient>): SvgGradient | undefined;
+/** Options for {@link GradientVMobject}. */
+export interface GradientVMobjectOptions {
+    /** The resolved gradient applied as this object's fill. */
+    gradient: SvgGradient;
+    /** Bezier control points in 3D. */
+    points3D: [number, number, number][];
+    /** Stroke color (default WHITE). */
+    strokeColor?: string;
+    /** Stroke width (default DEFAULT_STROKE_WIDTH). */
+    strokeWidth?: number;
+    /** Fill opacity (default 0.5). */
+    fillOpacity?: number;
+}
+/**
+ * A VMobject whose fill comes from an SVG gradient.
+ *
+ * The flat `fillColor` is the first (offset-0) stop, so it renders correctly in
+ * the single-fill pipeline. {@link gradientColors} holds the full resampled
+ * palette (via {@link colorGradient}) for consumers that render or animate the
+ * gradient, and {@link gradient} keeps the original parsed stops.
+ */
+export declare class GradientVMobject extends VMobject {
+    /** The parsed gradient definition applied as fill. */
+    readonly gradient: SvgGradient;
+    /** Evenly spaced palette of the gradient stops (via {@link colorGradient}). */
+    readonly gradientColors: string[];
+    constructor(options: GradientVMobjectOptions);
+    copy(): GradientVMobject;
+}
+//# sourceMappingURL=svgGradients.d.ts.map

package/dist/mobjects/svg/svgGradients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svgGradients.d.ts","sourceRoot":"","sources":["../../../src/mobjects/svg/svgGradients.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAK/C,4DAA4D;AAC5D,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElD,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,IAAI,EAAE,eAAe,CAAC;IACtB,2BAA2B;IAC3B,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAqDD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAcxE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAC7B,WAAW,GAAG,SAAS,CAKzB;AAgBD,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,2DAA2D;IAC3D,QAAQ,EAAE,WAAW,CAAC;IACtB,mCAAmC;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IACrC,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;gBAEtB,OAAO,EAAE,uBAAuB;IAcnC,IAAI,IAAI,gBAAgB;CAWlC"}

package/dist/mobjects/svg/svgImage.d.ts

@@ -0,0 +1,9 @@
+import { ImageMobject } from '../image';
+/**
+ * Build one {@link ImageMobject} per `<image>` element that has an href.
+ *
+ * @param svg - The parsed `<svg>` root element.
+ * @returns Image mobjects, in document order. Elements without an href are skipped.
+ */
+export declare function buildSvgImageMobjects(svg: Element): ImageMobject[];
+//# sourceMappingURL=svgImage.d.ts.map

package/dist/mobjects/svg/svgImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svgImage.d.ts","sourceRoot":"","sources":["../../../src/mobjects/svg/svgImage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAcxC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,EAAE,CAwBlE"}

package/dist/mobjects/svg/svgLoader.d.ts

@@ -0,0 +1,35 @@
+/**
+ * URL loading for SVGMobject (best-manim enhancement).
+ *
+ * `SVGMobject.fromUrl` fetches SVG text and parses it through the existing
+ * string path. The fetcher is injected (default `globalThis.fetch`) so tests
+ * can supply a mock and never touch the network.
+ */
+/** Minimal response shape `fromUrl` needs — satisfied by the DOM `Response`. */
+export interface SvgFetchResponse {
+    /** Whether the HTTP status is in the 2xx range. */
+    ok: boolean;
+    /** HTTP status code. */
+    status: number;
+    /** Resolve to the response body as text. */
+    text(): Promise<string>;
+}
+/** A function that fetches a URL, compatible with `globalThis.fetch`. */
+export type SvgFetcher = (url: string) => Promise<SvgFetchResponse>;
+/**
+ * Default fetcher: delegates to `globalThis.fetch`.
+ *
+ * Rejects with a clear error when no global fetch exists, so the caller can
+ * record it via `getLoadError()` instead of throwing a cryptic ReferenceError.
+ */
+export declare const defaultSvgFetcher: SvgFetcher;
+/**
+ * Fetch SVG text from a URL using the injected fetcher.
+ *
+ * @param url - The SVG resource URL.
+ * @param fetcher - The fetch implementation (defaults to {@link defaultSvgFetcher}).
+ * @returns The response body as text.
+ * @throws When the fetch rejects or the response status is not ok.
+ */
+export declare function fetchSvgText(url: string, fetcher?: SvgFetcher): Promise<string>;
+//# sourceMappingURL=svgLoader.d.ts.map

package/dist/mobjects/svg/svgLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svgLoader.d.ts","sourceRoot":"","sources":["../../../src/mobjects/svg/svgLoader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,EAAE,EAAE,OAAO,CAAC;IACZ,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,yEAAyE;AACzE,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAO/B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,UAA8B,GACtC,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/dist/mobjects/svg/svgText.d.ts

@@ -0,0 +1,15 @@
+import { Text } from '../text/Text';
+/** Default styling for `<text>` elements that omit their own. */
+export interface SvgTextDefaults {
+    /** Fill color used when the element has no usable `fill`. */
+    color: string;
+}
+/**
+ * Build one {@link Text} mobject per `<text>` element in the SVG.
+ *
+ * @param svg - The parsed `<svg>` root element.
+ * @param defaults - Fallback styling (currently the default fill color).
+ * @returns Text mobjects, in document order. Empty `<text>` nodes are skipped.
+ */
+export declare function buildSvgTextMobjects(svg: Element, defaults: SvgTextDefaults): Text[];
+//# sourceMappingURL=svgText.d.ts.map

package/dist/mobjects/svg/svgText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svgText.d.ts","sourceRoot":"","sources":["../../../src/mobjects/svg/svgText.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;CACf;AASD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,EAAE,CA2BpF"}

package/dist/rendering/blendModes.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Per-mobject blend modes.
+ *
+ * Maps a small, Manim-friendly set of named blend modes to Three.js material
+ * blending state. The default is `'normal'`, which equals three.js's own
+ * default (`NormalBlending`), so a mobject that never sets a blend mode renders
+ * exactly as before.
+ *
+ * `'screen'` has no built-in three.js constant, so it uses `CustomBlending`
+ * with the standard screen equation `src + dst*(1 - src)`.
+ */
+import * as THREE from 'three';
+/**
+ * Named blend mode for a mobject's rendered material(s).
+ *
+ * - `normal`: default alpha blending (three.js `NormalBlending`).
+ * - `additive`: add source to destination (`AdditiveBlending`); good for glow.
+ * - `multiply`: multiply source and destination (`MultiplyBlending`).
+ * - `subtractive`: subtract source from destination (`SubtractiveBlending`).
+ * - `screen`: screen blend via `CustomBlending` (`src + dst*(1 - src)`).
+ */
+export type BlendMode = 'normal' | 'additive' | 'multiply' | 'subtractive' | 'screen';
+/** Every supported blend mode name, in a stable order. */
+export declare const BLEND_MODES: readonly BlendMode[];
+/** Map a blend mode to the three.js `Blending` constant it primarily uses. */
+export declare function blendModeToThree(mode: BlendMode): THREE.Blending;
+/**
+ * Apply a blend mode to a single three.js material in place.
+ *
+ * The material version only bumps (`needsUpdate`) when the blending constant
+ * actually changes, so re-applying the same mode is cheap and idempotent. For
+ * `'screen'` the custom blend equation and factors are set explicitly.
+ *
+ * @param material - The material to configure.
+ * @param mode - The blend mode to apply.
+ */
+export declare function applyBlendMode(material: THREE.Material, mode: BlendMode): void;
+//# sourceMappingURL=blendModes.d.ts.map

package/dist/rendering/blendModes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blendModes.d.ts","sourceRoot":"","sources":["../../src/rendering/blendModes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,QAAQ,CAAC;AAEtF,0DAA0D;AAC1D,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAM3C,CAAC;AAEF,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,CAAC,QAAQ,CAchE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAe9E"}