manim-web 0.11.0 → 0.13.0

package/dist/mobjects/image/AnimatedImageMobject.d.ts

@@ -0,0 +1,141 @@
+import { Vector3Tuple } from '../../core/Mobject';
+import { TexturedMobject } from '../../core/TexturedMobject';
+import { GifDecoder } from './gifDecoder';
+import * as THREE from 'three';
+export type { DecodedGif, DecodedGifFrame, GifDecoder } from './gifDecoder';
+/**
+ * Options for creating an {@link AnimatedImageMobject}.
+ */
+export interface AnimatedImageMobjectOptions {
+    /** GIF source: URL or base64 data URI. Required. */
+    source: string;
+    /** Loop back to the first frame after the last. Default: true */
+    loop?: boolean;
+    /** Start playing as soon as the GIF decodes. Default: false */
+    autoplay?: boolean;
+    /** Override the GIF frame rate (frames per second). Default: use GIF delays */
+    fps?: number;
+    /** Width of the image in scene units. Default: auto from aspect ratio */
+    width?: number;
+    /** Height of the image in scene units. Default: auto from aspect ratio */
+    height?: number;
+    /** If both width and height given, fit inside the box preserving aspect. Default: true */
+    scaleToFit?: boolean;
+    /** Center position [x, y, z]. Default: [0, 0, 0] */
+    center?: Vector3Tuple;
+    /** Opacity from 0 to 1. Default: 1 */
+    opacity?: number;
+    /** Render both sides of the plane. Default: false */
+    doubleSided?: boolean;
+}
+/**
+ * Inject a GIF decoder, replacing the lazy-loaded `gifuct-js` decoder. Pass
+ * `null` to restore the default. Tests use this to decode a mock GIF with no
+ * network or `gifuct-js` dependency.
+ */
+export declare function setGifDecoder(decoder: GifDecoder | null): void;
+/**
+ * AnimatedImageMobject - play an animated GIF as a movable, scalable mobject.
+ *
+ * The GIF is decoded to RGBA frames (see {@link gifDecoder}) and each frame is
+ * drawn through a `THREE.DataTexture` on a `THREE.PlaneGeometry`, mirroring how
+ * `ImageMobject` draws a still image. It therefore participates in the standard
+ * mobject transforms, z-index/depth, opacity, and `scene.add`. During play an
+ * updater advances the frame by elapsed time; call {@link syncToTime} on scrub
+ * or seek so the displayed frame follows the scene time.
+ *
+ * @example
+ * ```typescript
+ * const gif = new AnimatedImageMobject({ source: 'spin.gif', width: 4, loop: true });
+ * scene.add(gif);
+ * await gif.waitForLoad();
+ * gif.play();
+ * ```
+ */
+export declare class AnimatedImageMobject extends TexturedMobject {
+    protected _source: string;
+    protected _loop: boolean;
+    protected _autoplay: boolean;
+    protected _fps: number | undefined;
+    protected _width: number | undefined;
+    protected _height: number | undefined;
+    protected _scaleToFit: boolean;
+    protected _centerPoint: Vector3Tuple;
+    protected _doubleSided: boolean;
+    protected _frames: Uint8ClampedArray[];
+    protected _frameDurations: number[];
+    protected _frameTextures: (THREE.DataTexture | null)[];
+    protected _totalDurationMs: number;
+    protected _currentFrame: number;
+    protected _accumulatorMs: number;
+    protected _playing: boolean;
+    protected _texture: THREE.DataTexture | null;
+    protected _loaded: boolean;
+    protected _loadError: Error | null;
+    protected _naturalWidth: number;
+    protected _naturalHeight: number;
+    private _mesh;
+    private _loadPromise;
+    private _loadResolve;
+    private _loadReject;
+    constructor(options: AnimatedImageMobjectOptions);
+    /** Decode the GIF, then ingest its frames. Node/SSR-safe: never throws. */
+    private _startLoad;
+    /** Store decoded frames, compute durations, and show the first frame. */
+    private _ingest;
+    /** Record a load error and reject the ready promise once. */
+    private _failLoad;
+    /** Advance playback by `deltaMs`, honouring per-frame delays and loop. */
+    private _advance;
+    /** Build (or reuse) the texture for `index` and show it. */
+    private _setFrame;
+    /** Create an upright RGBA DataTexture from a full-canvas frame buffer. */
+    private _createFrameTexture;
+    /** Promise that resolves once the GIF decodes and rejects on decode error. */
+    waitForLoad(): Promise<void>;
+    /** The captured load error, or null when no error occurred. */
+    getLoadError(): Error | null;
+    /** Whether the GIF has decoded and the first frame is ready. */
+    isLoaded(): boolean;
+    /** The GIF source URL or data URI. */
+    getSource(): string;
+    /** Number of decoded frames (0 until the GIF loads). */
+    get frameCount(): number;
+    /** Index of the frame currently displayed. */
+    get currentFrame(): number;
+    /** Total play time of one loop, in seconds (0 until loaded). */
+    get duration(): number;
+    /** Whether playback is currently running. */
+    isPlaying(): boolean;
+    /** Start or resume playback. */
+    play(): this;
+    /** Pause playback on the current frame. */
+    pause(): this;
+    /** Jump to a frame index, clamped to [0, frameCount - 1]. */
+    seek(frame: number): this;
+    /** Enable or disable looping. */
+    setLoop(loop: boolean): this;
+    /**
+     * Follow the Player clock: show the frame at `sceneTime` seconds. Use this on
+     * scrub and seek so the displayed frame tracks the timeline position.
+     */
+    syncToTime(sceneTime: number): this;
+    /** Display dimensions from width/height options and the natural size. */
+    private _calculateDimensions;
+    protected _createThreeObject(): THREE.Object3D;
+    getDisplayMeshLength(): number;
+    getDisplayMeshes(): THREE.Mesh[];
+    applyTextureFrom(other: TexturedMobject): void;
+    applyVisualSize(width: number, height: number): void;
+    applyContentFrom(other: TexturedMobject): void;
+    protected _updateGeometry(): void;
+    protected _syncMaterialToThree(): void;
+    getBoundingBox(): {
+        width: number;
+        height: number;
+        depth: number;
+    };
+    copy(): AnimatedImageMobject;
+    dispose(): void;
+}
+//# sourceMappingURL=AnimatedImageMobject.d.ts.map

package/dist/mobjects/image/AnimatedImageMobject.d.ts.map

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

package/dist/mobjects/image/gifDecoder.d.ts

@@ -0,0 +1,46 @@
+/**
+ * GIF decoding seam for {@link AnimatedImageMobject}.
+ *
+ * The browser decodes a multi-frame GIF to an array of fully composited RGBA
+ * frames plus per-frame delays. Decoding is done with the small, well
+ * maintained `gifuct-js` library, which is LAZY-LOADED through a dynamic
+ * `import()`. The static module graph never references `gifuct-js`, so the base
+ * bundle stays small and SSR / Node never pull the decoder in for users who do
+ * not touch animated GIFs. The dynamic import specifier is a literal, so
+ * bundlers emit a separate chunk and static analysers (knip) still see the
+ * dependency as used.
+ *
+ * Tests inject a mock decoder through `AnimatedImageMobject.setGifDecoder`,
+ * which bypasses the dynamic import and the network entirely.
+ */
+/** One decoded GIF frame: a full-canvas RGBA buffer and its display delay. */
+export interface DecodedGifFrame {
+    /** Row-major RGBA pixels for the whole canvas (length = width * height * 4). */
+    data: Uint8ClampedArray;
+    /** How long this frame stays on screen, in milliseconds. */
+    delay: number;
+}
+/** A decoded animated GIF: canvas size and the composited frames. */
+export interface DecodedGif {
+    /** Canvas width in pixels. */
+    width: number;
+    /** Canvas height in pixels. */
+    height: number;
+    /** Composited frames in play order. */
+    frames: DecodedGifFrame[];
+}
+/**
+ * A function that decodes a GIF source (URL or data URI) to {@link DecodedGif}.
+ * This is the dependency-injection seam: tests set a mock decoder so the real
+ * `gifuct-js` decoder and the network are never used.
+ */
+export type GifDecoder = (source: string) => Promise<DecodedGif>;
+/**
+ * Default browser GIF decoder: fetch the bytes, then decode with `gifuct-js`.
+ *
+ * Node/SSR-safe: it refuses when there is no DOM instead of throwing at import
+ * time. The decode itself is pure data work, but requiring a browser keeps this
+ * a browser-only feature and makes the Node path fail fast and deterministically.
+ */
+export declare const defaultGifDecoder: GifDecoder;
+//# sourceMappingURL=gifDecoder.d.ts.map

package/dist/mobjects/image/gifDecoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gifDecoder.d.ts","sourceRoot":"","sources":["../../../src/mobjects/image/gifDecoder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,IAAI,EAAE,iBAAiB,CAAC;IACxB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAuFjE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAkB/B,CAAC"}

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/mobjects/text/Code.d.ts

@@ -1,6 +1,7 @@
 import { VMobject } from '../../core/VMobject';
 import { Vector3Tuple } from '../../core/Mobject';
-import { Token, CodeColorScheme } from './CodeHighlighting';
+import { Token, TokenType, CodeColorScheme } from './CodeHighlighting';
+import { CodeToken } from './CodeTokenLayout';
 import * as THREE from 'three';
 export { type Token, type TokenType, type CodeColorScheme, DEFAULT_COLOR_SCHEME, MONOKAI_COLOR_SCHEME, } from './CodeHighlighting';
 /**
@@ -142,6 +143,27 @@ export declare class Code extends VMobject {
         position: Vector3Tuple;
         tokens: Token[];
     } | null;
+    /**
+     * Get a flat list of tokens with their world-space positions.
+     *
+     * The positions come from the same layout as the rendered block, computed
+     * without a 2D canvas so this also works in a headless environment.
+     * `TransformMatchingCode` uses this to match unchanged tokens between two
+     * Code blocks and animate only the difference.
+     *
+     * @returns One {@link CodeToken} per token, in reading order.
+     */
+    getCodeTokens(): CodeToken[];
+    /**
+     * Build a standalone Code mobject that renders a single token, styled like
+     * this block. The token keeps its syntax color, has no line numbers and no
+     * background. `TransformMatchingCode` uses this to animate single tokens.
+     *
+     * @param text - The token text.
+     * @param type - The syntax type that selects the color.
+     * @returns A new single-token Code mobject.
+     */
+    makeTokenMobject(text: string, type: TokenType): Code;
     /**
      * Highlight a range of lines with a background color
      * @param startLine - Starting line number (1-based)

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

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

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

@@ -0,0 +1,44 @@
+import { Vector3Tuple } from '../../core/Mobject';
+import { Token, TokenType } from './CodeHighlighting';
+/**
+ * A single token of a Code block with its position.
+ */
+export interface CodeToken {
+    /** The token text. */
+    text: string;
+    /** The syntax type of the token. */
+    type: TokenType;
+    /** Zero-based index of the line that holds the token. */
+    line: number;
+    /** Zero-based index of the token within its line. */
+    tokenIndex: number;
+    /** World-space position of the left edge of the token. */
+    position: Vector3Tuple;
+}
+/**
+ * Inputs for {@link computeCodeTokens}. These mirror the Code mobject fields.
+ */
+export interface CodeTokenLayoutParams {
+    /** Parsed lines (tabs already expanded to spaces). */
+    lines: string[];
+    /** Tokens for each line. */
+    tokenizedLines: Token[][];
+    /** Font size in pixels. */
+    fontSize: number;
+    /** Line height multiplier. */
+    lineHeight: number;
+    /** Background padding in pixels. */
+    backgroundPadding: number;
+    /** Whether line numbers take horizontal space. */
+    lineNumbers: boolean;
+    /** World-space position (center) of the Code block. */
+    position: Vector3Tuple;
+}
+/**
+ * Compute the flat list of tokens with world-space positions.
+ *
+ * @param params - The Code block layout inputs.
+ * @returns One {@link CodeToken} per token, in reading order.
+ */
+export declare function computeCodeTokens(params: CodeTokenLayoutParams): CodeToken[];
+//# sourceMappingURL=CodeTokenLayout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CodeTokenLayout.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/CodeTokenLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAWtD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,IAAI,EAAE,SAAS,CAAC;IAChB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4BAA4B;IAC5B,cAAc,EAAE,KAAK,EAAE,EAAE,CAAC;IAC1B,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,WAAW,EAAE,OAAO,CAAC;IACrB,uDAAuD;IACvD,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,qBAAqB,GAAG,SAAS,EAAE,CAiD5E"}

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

@@ -21,6 +21,7 @@ export { renderTypstToSVG, preloadTypst, isTypstLoaded, setTypstCompiler, type T
 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';
+export { type CodeToken, type CodeTokenLayoutParams } from './CodeTokenLayout';
 export { SingleStringMathTex, type SingleStringMathTexOptions, MathTexPart, type MathTexPartOptions, } from './MathTexParts';
 export { BulletedList, Title, MarkdownText, type BulletedListOptions, type TitleOptions, type MarkdownTextOptions, } from './TextExtensions';
 //# sourceMappingURL=index.d.ts.map

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,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"}
+{"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;AAChB,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG/E,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/rate-functions/customEase.d.ts

@@ -0,0 +1,39 @@
+import { RateFunction } from './index';
+/**
+ * Create a CSS cubic-bezier easing.
+ *
+ * Control points are P0 = (0, 0), P1 = (x1, y1), P2 = (x2, y2), P3 = (1, 1).
+ * x1 and x2 are clamped to [0, 1] so the x axis stays monotonic, as CSS
+ * requires. y1 and y2 are free, so the curve may overshoot.
+ *
+ * @example
+ * const ease = cubicBezier(0.25, 0.1, 0.25, 1);
+ * ease(0); // 0
+ * ease(1); // 1
+ */
+export declare const cubicBezier: (x1: number, y1: number, x2: number, y2: number) => RateFunction;
+/** CSS `ease`: slow start, fast middle, slow end. */
+export declare const ease: RateFunction;
+/** CSS `ease-in`: slow start. */
+export declare const easeInBezier: RateFunction;
+/** CSS `ease-out`: slow end. */
+export declare const easeOutBezier: RateFunction;
+/** CSS `ease-in-out`: slow start and end. */
+export declare const easeInOutBezier: RateFunction;
+/** Where a step jumps: at the start or the end of each interval. */
+export type StepPosition = 'start' | 'end';
+/**
+ * Create a CSS steps() timing function with n steps.
+ *
+ * - 'end' (default) holds then jumps at the end of each interval.
+ * - 'start' jumps at the start of each interval.
+ *
+ * Both start at 0 at t = 0 and reach 1 at t = 1.
+ *
+ * @example
+ * const quantized = steps(4);
+ * quantized(0); // 0
+ * quantized(1); // 1
+ */
+export declare const steps: (n: number, position?: StepPosition) => RateFunction;
+//# sourceMappingURL=customEase.d.ts.map

package/dist/rate-functions/customEase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customEase.d.ts","sourceRoot":"","sources":["../../src/rate-functions/customEase.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA+D5C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,EAAE,IAAI,MAAM,EAAE,IAAI,MAAM,EAAE,IAAI,MAAM,KAAG,YAa5E,CAAC;AAIF,qDAAqD;AACrD,eAAO,MAAM,IAAI,EAAE,YAA8C,CAAC;AAElE,iCAAiC;AACjC,eAAO,MAAM,YAAY,EAAE,YAAyC,CAAC;AAErE,gCAAgC;AAChC,eAAO,MAAM,aAAa,EAAE,YAAyC,CAAC;AAEtE,6CAA6C;AAC7C,eAAO,MAAM,eAAe,EAAE,YAA4C,CAAC;AAI3E,oEAAoE;AACpE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,EAAE,WAAU,YAAoB,KAAG,YAOjE,CAAC"}