manim-web 0.12.0 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,141 @@
1
+ import { Vector3Tuple } from '../../core/Mobject';
2
+ import { TexturedMobject } from '../../core/TexturedMobject';
3
+ import { GifDecoder } from './gifDecoder';
4
+ import * as THREE from 'three';
5
+ export type { DecodedGif, DecodedGifFrame, GifDecoder } from './gifDecoder';
6
+ /**
7
+ * Options for creating an {@link AnimatedImageMobject}.
8
+ */
9
+ export interface AnimatedImageMobjectOptions {
10
+ /** GIF source: URL or base64 data URI. Required. */
11
+ source: string;
12
+ /** Loop back to the first frame after the last. Default: true */
13
+ loop?: boolean;
14
+ /** Start playing as soon as the GIF decodes. Default: false */
15
+ autoplay?: boolean;
16
+ /** Override the GIF frame rate (frames per second). Default: use GIF delays */
17
+ fps?: number;
18
+ /** Width of the image in scene units. Default: auto from aspect ratio */
19
+ width?: number;
20
+ /** Height of the image in scene units. Default: auto from aspect ratio */
21
+ height?: number;
22
+ /** If both width and height given, fit inside the box preserving aspect. Default: true */
23
+ scaleToFit?: boolean;
24
+ /** Center position [x, y, z]. Default: [0, 0, 0] */
25
+ center?: Vector3Tuple;
26
+ /** Opacity from 0 to 1. Default: 1 */
27
+ opacity?: number;
28
+ /** Render both sides of the plane. Default: false */
29
+ doubleSided?: boolean;
30
+ }
31
+ /**
32
+ * Inject a GIF decoder, replacing the lazy-loaded `gifuct-js` decoder. Pass
33
+ * `null` to restore the default. Tests use this to decode a mock GIF with no
34
+ * network or `gifuct-js` dependency.
35
+ */
36
+ export declare function setGifDecoder(decoder: GifDecoder | null): void;
37
+ /**
38
+ * AnimatedImageMobject - play an animated GIF as a movable, scalable mobject.
39
+ *
40
+ * The GIF is decoded to RGBA frames (see {@link gifDecoder}) and each frame is
41
+ * drawn through a `THREE.DataTexture` on a `THREE.PlaneGeometry`, mirroring how
42
+ * `ImageMobject` draws a still image. It therefore participates in the standard
43
+ * mobject transforms, z-index/depth, opacity, and `scene.add`. During play an
44
+ * updater advances the frame by elapsed time; call {@link syncToTime} on scrub
45
+ * or seek so the displayed frame follows the scene time.
46
+ *
47
+ * @example
48
+ * ```typescript
49
+ * const gif = new AnimatedImageMobject({ source: 'spin.gif', width: 4, loop: true });
50
+ * scene.add(gif);
51
+ * await gif.waitForLoad();
52
+ * gif.play();
53
+ * ```
54
+ */
55
+ export declare class AnimatedImageMobject extends TexturedMobject {
56
+ protected _source: string;
57
+ protected _loop: boolean;
58
+ protected _autoplay: boolean;
59
+ protected _fps: number | undefined;
60
+ protected _width: number | undefined;
61
+ protected _height: number | undefined;
62
+ protected _scaleToFit: boolean;
63
+ protected _centerPoint: Vector3Tuple;
64
+ protected _doubleSided: boolean;
65
+ protected _frames: Uint8ClampedArray[];
66
+ protected _frameDurations: number[];
67
+ protected _frameTextures: (THREE.DataTexture | null)[];
68
+ protected _totalDurationMs: number;
69
+ protected _currentFrame: number;
70
+ protected _accumulatorMs: number;
71
+ protected _playing: boolean;
72
+ protected _texture: THREE.DataTexture | null;
73
+ protected _loaded: boolean;
74
+ protected _loadError: Error | null;
75
+ protected _naturalWidth: number;
76
+ protected _naturalHeight: number;
77
+ private _mesh;
78
+ private _loadPromise;
79
+ private _loadResolve;
80
+ private _loadReject;
81
+ constructor(options: AnimatedImageMobjectOptions);
82
+ /** Decode the GIF, then ingest its frames. Node/SSR-safe: never throws. */
83
+ private _startLoad;
84
+ /** Store decoded frames, compute durations, and show the first frame. */
85
+ private _ingest;
86
+ /** Record a load error and reject the ready promise once. */
87
+ private _failLoad;
88
+ /** Advance playback by `deltaMs`, honouring per-frame delays and loop. */
89
+ private _advance;
90
+ /** Build (or reuse) the texture for `index` and show it. */
91
+ private _setFrame;
92
+ /** Create an upright RGBA DataTexture from a full-canvas frame buffer. */
93
+ private _createFrameTexture;
94
+ /** Promise that resolves once the GIF decodes and rejects on decode error. */
95
+ waitForLoad(): Promise<void>;
96
+ /** The captured load error, or null when no error occurred. */
97
+ getLoadError(): Error | null;
98
+ /** Whether the GIF has decoded and the first frame is ready. */
99
+ isLoaded(): boolean;
100
+ /** The GIF source URL or data URI. */
101
+ getSource(): string;
102
+ /** Number of decoded frames (0 until the GIF loads). */
103
+ get frameCount(): number;
104
+ /** Index of the frame currently displayed. */
105
+ get currentFrame(): number;
106
+ /** Total play time of one loop, in seconds (0 until loaded). */
107
+ get duration(): number;
108
+ /** Whether playback is currently running. */
109
+ isPlaying(): boolean;
110
+ /** Start or resume playback. */
111
+ play(): this;
112
+ /** Pause playback on the current frame. */
113
+ pause(): this;
114
+ /** Jump to a frame index, clamped to [0, frameCount - 1]. */
115
+ seek(frame: number): this;
116
+ /** Enable or disable looping. */
117
+ setLoop(loop: boolean): this;
118
+ /**
119
+ * Follow the Player clock: show the frame at `sceneTime` seconds. Use this on
120
+ * scrub and seek so the displayed frame tracks the timeline position.
121
+ */
122
+ syncToTime(sceneTime: number): this;
123
+ /** Display dimensions from width/height options and the natural size. */
124
+ private _calculateDimensions;
125
+ protected _createThreeObject(): THREE.Object3D;
126
+ getDisplayMeshLength(): number;
127
+ getDisplayMeshes(): THREE.Mesh[];
128
+ applyTextureFrom(other: TexturedMobject): void;
129
+ applyVisualSize(width: number, height: number): void;
130
+ applyContentFrom(other: TexturedMobject): void;
131
+ protected _updateGeometry(): void;
132
+ protected _syncMaterialToThree(): void;
133
+ getBoundingBox(): {
134
+ width: number;
135
+ height: number;
136
+ depth: number;
137
+ };
138
+ copy(): AnimatedImageMobject;
139
+ dispose(): void;
140
+ }
141
+ //# sourceMappingURL=AnimatedImageMobject.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AnimatedImageMobject.d.ts","sourceRoot":"","sources":["../../../src/mobjects/image/AnimatedImageMobject.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,46 @@
1
+ /**
2
+ * GIF decoding seam for {@link AnimatedImageMobject}.
3
+ *
4
+ * The browser decodes a multi-frame GIF to an array of fully composited RGBA
5
+ * frames plus per-frame delays. Decoding is done with the small, well
6
+ * maintained `gifuct-js` library, which is LAZY-LOADED through a dynamic
7
+ * `import()`. The static module graph never references `gifuct-js`, so the base
8
+ * bundle stays small and SSR / Node never pull the decoder in for users who do
9
+ * not touch animated GIFs. The dynamic import specifier is a literal, so
10
+ * bundlers emit a separate chunk and static analysers (knip) still see the
11
+ * dependency as used.
12
+ *
13
+ * Tests inject a mock decoder through `AnimatedImageMobject.setGifDecoder`,
14
+ * which bypasses the dynamic import and the network entirely.
15
+ */
16
+ /** One decoded GIF frame: a full-canvas RGBA buffer and its display delay. */
17
+ export interface DecodedGifFrame {
18
+ /** Row-major RGBA pixels for the whole canvas (length = width * height * 4). */
19
+ data: Uint8ClampedArray;
20
+ /** How long this frame stays on screen, in milliseconds. */
21
+ delay: number;
22
+ }
23
+ /** A decoded animated GIF: canvas size and the composited frames. */
24
+ export interface DecodedGif {
25
+ /** Canvas width in pixels. */
26
+ width: number;
27
+ /** Canvas height in pixels. */
28
+ height: number;
29
+ /** Composited frames in play order. */
30
+ frames: DecodedGifFrame[];
31
+ }
32
+ /**
33
+ * A function that decodes a GIF source (URL or data URI) to {@link DecodedGif}.
34
+ * This is the dependency-injection seam: tests set a mock decoder so the real
35
+ * `gifuct-js` decoder and the network are never used.
36
+ */
37
+ export type GifDecoder = (source: string) => Promise<DecodedGif>;
38
+ /**
39
+ * Default browser GIF decoder: fetch the bytes, then decode with `gifuct-js`.
40
+ *
41
+ * Node/SSR-safe: it refuses when there is no DOM instead of throwing at import
42
+ * time. The decode itself is pure data work, but requiring a browser keeps this
43
+ * a browser-only feature and makes the Node path fail fast and deterministically.
44
+ */
45
+ export declare const defaultGifDecoder: GifDecoder;
46
+ //# sourceMappingURL=gifDecoder.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -1,6 +1,7 @@
1
1
  import { VMobject } from '../../core/VMobject';
2
2
  import { Vector3Tuple } from '../../core/Mobject';
3
- import { Token, CodeColorScheme } from './CodeHighlighting';
3
+ import { Token, TokenType, CodeColorScheme } from './CodeHighlighting';
4
+ import { CodeToken } from './CodeTokenLayout';
4
5
  import * as THREE from 'three';
5
6
  export { type Token, type TokenType, type CodeColorScheme, DEFAULT_COLOR_SCHEME, MONOKAI_COLOR_SCHEME, } from './CodeHighlighting';
6
7
  /**
@@ -142,6 +143,27 @@ export declare class Code extends VMobject {
142
143
  position: Vector3Tuple;
143
144
  tokens: Token[];
144
145
  } | null;
146
+ /**
147
+ * Get a flat list of tokens with their world-space positions.
148
+ *
149
+ * The positions come from the same layout as the rendered block, computed
150
+ * without a 2D canvas so this also works in a headless environment.
151
+ * `TransformMatchingCode` uses this to match unchanged tokens between two
152
+ * Code blocks and animate only the difference.
153
+ *
154
+ * @returns One {@link CodeToken} per token, in reading order.
155
+ */
156
+ getCodeTokens(): CodeToken[];
157
+ /**
158
+ * Build a standalone Code mobject that renders a single token, styled like
159
+ * this block. The token keeps its syntax color, has no line numbers and no
160
+ * background. `TransformMatchingCode` uses this to animate single tokens.
161
+ *
162
+ * @param text - The token text.
163
+ * @param type - The syntax type that selects the color.
164
+ * @returns A new single-token Code mobject.
165
+ */
166
+ makeTokenMobject(text: string, type: TokenType): Code;
145
167
  /**
146
168
  * Highlight a range of lines with a background color
147
169
  * @param startLine - Starting line number (1-based)
@@ -1 +1 @@
1
- {"version":3,"file":"Code.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/Code.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"Code.d.ts","sourceRoot":"","sources":["../../../src/mobjects/text/Code.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,44 @@
1
+ import { Vector3Tuple } from '../../core/Mobject';
2
+ import { Token, TokenType } from './CodeHighlighting';
3
+ /**
4
+ * A single token of a Code block with its position.
5
+ */
6
+ export interface CodeToken {
7
+ /** The token text. */
8
+ text: string;
9
+ /** The syntax type of the token. */
10
+ type: TokenType;
11
+ /** Zero-based index of the line that holds the token. */
12
+ line: number;
13
+ /** Zero-based index of the token within its line. */
14
+ tokenIndex: number;
15
+ /** World-space position of the left edge of the token. */
16
+ position: Vector3Tuple;
17
+ }
18
+ /**
19
+ * Inputs for {@link computeCodeTokens}. These mirror the Code mobject fields.
20
+ */
21
+ export interface CodeTokenLayoutParams {
22
+ /** Parsed lines (tabs already expanded to spaces). */
23
+ lines: string[];
24
+ /** Tokens for each line. */
25
+ tokenizedLines: Token[][];
26
+ /** Font size in pixels. */
27
+ fontSize: number;
28
+ /** Line height multiplier. */
29
+ lineHeight: number;
30
+ /** Background padding in pixels. */
31
+ backgroundPadding: number;
32
+ /** Whether line numbers take horizontal space. */
33
+ lineNumbers: boolean;
34
+ /** World-space position (center) of the Code block. */
35
+ position: Vector3Tuple;
36
+ }
37
+ /**
38
+ * Compute the flat list of tokens with world-space positions.
39
+ *
40
+ * @param params - The Code block layout inputs.
41
+ * @returns One {@link CodeToken} per token, in reading order.
42
+ */
43
+ export declare function computeCodeTokens(params: CodeTokenLayoutParams): CodeToken[];
44
+ //# sourceMappingURL=CodeTokenLayout.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -21,6 +21,7 @@ export { renderTypstToSVG, preloadTypst, isTypstLoaded, setTypstCompiler, type T
21
21
  export { DecimalNumber, Integer, type DecimalNumberOptions } from './DecimalNumber';
22
22
  export { Variable, type VariableOptions } from './Variable';
23
23
  export { Code, type CodeOptions, type CodeColorScheme, type Token, type TokenType, DEFAULT_COLOR_SCHEME, MONOKAI_COLOR_SCHEME, } from './Code';
24
+ export { type CodeToken, type CodeTokenLayoutParams } from './CodeTokenLayout';
24
25
  export { SingleStringMathTex, type SingleStringMathTexOptions, MathTexPart, type MathTexPartOptions, } from './MathTexParts';
25
26
  export { BulletedList, Title, MarkdownText, type BulletedListOptions, type TitleOptions, type MarkdownTextOptions, } from './TextExtensions';
26
27
  //# sourceMappingURL=index.d.ts.map
@@ -1 +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"}
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;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"}
@@ -0,0 +1,39 @@
1
+ import { RateFunction } from './index';
2
+ /**
3
+ * Create a CSS cubic-bezier easing.
4
+ *
5
+ * Control points are P0 = (0, 0), P1 = (x1, y1), P2 = (x2, y2), P3 = (1, 1).
6
+ * x1 and x2 are clamped to [0, 1] so the x axis stays monotonic, as CSS
7
+ * requires. y1 and y2 are free, so the curve may overshoot.
8
+ *
9
+ * @example
10
+ * const ease = cubicBezier(0.25, 0.1, 0.25, 1);
11
+ * ease(0); // 0
12
+ * ease(1); // 1
13
+ */
14
+ export declare const cubicBezier: (x1: number, y1: number, x2: number, y2: number) => RateFunction;
15
+ /** CSS `ease`: slow start, fast middle, slow end. */
16
+ export declare const ease: RateFunction;
17
+ /** CSS `ease-in`: slow start. */
18
+ export declare const easeInBezier: RateFunction;
19
+ /** CSS `ease-out`: slow end. */
20
+ export declare const easeOutBezier: RateFunction;
21
+ /** CSS `ease-in-out`: slow start and end. */
22
+ export declare const easeInOutBezier: RateFunction;
23
+ /** Where a step jumps: at the start or the end of each interval. */
24
+ export type StepPosition = 'start' | 'end';
25
+ /**
26
+ * Create a CSS steps() timing function with n steps.
27
+ *
28
+ * - 'end' (default) holds then jumps at the end of each interval.
29
+ * - 'start' jumps at the start of each interval.
30
+ *
31
+ * Both start at 0 at t = 0 and reach 1 at t = 1.
32
+ *
33
+ * @example
34
+ * const quantized = steps(4);
35
+ * quantized(0); // 0
36
+ * quantized(1); // 1
37
+ */
38
+ export declare const steps: (n: number, position?: StepPosition) => RateFunction;
39
+ //# sourceMappingURL=customEase.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -221,4 +221,8 @@ export declare const easeInOutBounce: RateFunction;
221
221
  export { easeIn as easeInCubic };
222
222
  export { easeOut as easeOutCubic };
223
223
  export { easeInOut as easeInOutCubic };
224
+ export { spring } from './spring';
225
+ export type { SpringOptions } from './spring';
226
+ export { cubicBezier, ease, easeInBezier, easeOutBezier, easeInOutBezier, steps, } from './customEase';
227
+ export type { StepPosition } from './customEase';
224
228
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rate-functions/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rate-functions/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,38 @@
1
+ import { RateFunction } from './index';
2
+ /**
3
+ * Options for the spring rate function.
4
+ *
5
+ * Use either the physical model (stiffness, damping, mass) or the simpler
6
+ * bounce model. If bounce is set, it wins over stiffness and damping.
7
+ */
8
+ export interface SpringOptions {
9
+ /** Spring constant. Higher is tighter. Default 100. */
10
+ stiffness?: number;
11
+ /** Damping (friction) coefficient. Higher settles faster. Default 10. */
12
+ damping?: number;
13
+ /** Mass on the spring. Higher is slower. Default 1. */
14
+ mass?: number;
15
+ /**
16
+ * Bounce in [0, 1). 0 gives no overshoot. Values near 1 give large
17
+ * overshoot. If set, this replaces stiffness and damping.
18
+ */
19
+ bounce?: number;
20
+ /**
21
+ * Settle threshold used to map physical time into [0, 1].
22
+ * The spring reaches this distance from 1 at t = 1. Default 0.005.
23
+ */
24
+ restThreshold?: number;
25
+ }
26
+ /**
27
+ * Create a damped spring rate function.
28
+ *
29
+ * The returned function maps t in [0, 1] to a value that starts at 0 and
30
+ * settles at 1. With an underdamped spring the value overshoots 1 first.
31
+ *
32
+ * @example
33
+ * const bouncy = spring({ bounce: 0.6 });
34
+ * bouncy(0); // 0
35
+ * bouncy(1); // 1
36
+ */
37
+ export declare const spring: (options?: SpringOptions) => RateFunction;
38
+ //# sourceMappingURL=spring.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"spring.d.ts","sourceRoot":"","sources":["../../src/rate-functions/spring.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA6ED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM,GAAI,UAAS,aAAkB,KAAG,YAapD,CAAC"}
@@ -0,0 +1,23 @@
1
+ //#region \0rolldown/runtime.js
2
+ var e = Object.create, t = Object.defineProperty, n = Object.getOwnPropertyDescriptor, r = Object.getOwnPropertyNames, i = Object.getPrototypeOf, a = Object.prototype.hasOwnProperty, o = (e, t) => () => (t || (e((t = { exports: {} }).exports, t), e = null), t.exports), s = (e, n) => {
3
+ let r = {};
4
+ for (var i in e) t(r, i, {
5
+ get: e[i],
6
+ enumerable: !0
7
+ });
8
+ return n || t(r, Symbol.toStringTag, { value: "Module" }), r;
9
+ }, c = (e, i, o, s) => {
10
+ if (i && typeof i == "object" || typeof i == "function") for (var c = r(i), l = 0, u = c.length, d; l < u; l++) d = c[l], !a.call(e, d) && d !== o && t(e, d, {
11
+ get: ((e) => i[e]).bind(null, d),
12
+ enumerable: !(s = n(i, d)) || s.enumerable
13
+ });
14
+ return e;
15
+ }, l = (n, r, a) => (a = n == null ? {} : e(i(n)), c(r || !n || !n.__esModule ? t(a, "default", {
16
+ value: n,
17
+ enumerable: !0
18
+ }) : a, n)), u = /* @__PURE__ */ ((e) => typeof require < "u" ? require : typeof Proxy < "u" ? new Proxy(e, { get: (e, t) => (typeof require < "u" ? require : e)[t] }) : e)(function(e) {
19
+ if (typeof require < "u") return require.apply(this, arguments);
20
+ throw Error("Calling `require` for \"" + e + "\" in an environment that doesn't expose the `require` function. See https://rolldown.rs/in-depth/bundling-cjs#require-external-modules for more details.");
21
+ });
22
+ //#endregion
23
+ export { l as i, s as n, u as r, o as t };