@babylonjs/addons 8.22.2 → 8.23.0

package/lottie/lottie/parsedTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsedTypes.js","sourceRoot":"","sources":["../../../../../dev/addons/src/lottie/lottie/parsedTypes.ts"],"names":[],"mappings":"","sourcesContent":["import type { IVector2Like } from \"core/Maths/math.like\";\r\n\r\nimport type { BezierCurve } from \"../maths/bezier\";\r\n\r\nimport type { Node } from \"../rendering/node\";\r\n\r\n/**\r\n * Represents a Babylon.js thin version of a Lottie animation.\r\n */\r\nexport type AnimationInfo = {\r\n    /**\r\n     * Frame number where the animation starts.\r\n     */\r\n    startFrame: number;\r\n    /**\r\n     * Frame number where the animation ends.\r\n     */\r\n    endFrame: number;\r\n    /**\r\n     * Frame rate of the animation.\r\n     */\r\n    frameRate: number;\r\n    /**\r\n     * Width of the animation in pixels\r\n     */\r\n    widthPx: number;\r\n    /**\r\n     * Height of the animation in pixels\r\n     */\r\n    heightPx: number;\r\n    /**\r\n     * Nodes representing the animation\r\n     */\r\n    nodes: Node[];\r\n};\r\n\r\n/**\r\n * Transform properties for a Lottie animation.\r\n * Any of these properties may be animated.\r\n */\r\nexport type Transform = {\r\n    /**\r\n     * The anchor point of the layer, which is the point around which transformations are applied.\r\n     */\r\n    anchorPoint: Vector2Property;\r\n    /**\r\n     * The position of the layer in the animation.\r\n     */\r\n    position: Vector2Property;\r\n    /**\r\n     * The rotation of the layer in degrees.\r\n     */\r\n    rotation: ScalarProperty;\r\n    /**\r\n     * The scale of the layer in the X and Y axis.\r\n     */\r\n    scale: Vector2Property;\r\n    /**\r\n     * The opacity of the layer, represented as a scalar value.\r\n     */\r\n    opacity: ScalarProperty;\r\n};\r\n\r\n/**\r\n * Represents a scalar that can be animated.\r\n */\r\nexport type ScalarProperty = {\r\n    /**\r\n     * The initial value of the property at the start of the animation.\r\n     */\r\n    startValue: number;\r\n    /**\r\n     * The current value of the property during the animation.\r\n     */\r\n    currentValue: number;\r\n    /**\r\n     * An array of keyframes for the property.\r\n     */\r\n    keyframes?: ScalarKeyframe[];\r\n    /**\r\n     * The index of the current keyframe being processed in the animation.\r\n     */\r\n    currentKeyframeIndex: number;\r\n};\r\n\r\n/**\r\n * Represents a keyframe for a scalar property.\r\n */\r\nexport type ScalarKeyframe = {\r\n    /**\r\n     * The value at this keyframe.\r\n     */\r\n    value: number;\r\n    /**\r\n     * The time at which this keyframe occurs in the animation, in frames.\r\n     */\r\n    time: number;\r\n    /**\r\n     * The easing function applied to the transition from this keyframe to the next one.\r\n     */\r\n    easeFunction: BezierCurve;\r\n};\r\n\r\n/**\r\n * Represents a 2D vector that can be animated.\r\n */\r\nexport type Vector2Property = {\r\n    /**\r\n     * The initial value at the start of the animation.\r\n     */\r\n    startValue: IVector2Like;\r\n    /**\r\n     * The current value during the animation.\r\n     */\r\n    currentValue: IVector2Like;\r\n    /**\r\n     * An array of keyframes for the property.\r\n     */\r\n    keyframes?: Vector2Keyframe[];\r\n    /**\r\n     * The index of the current keyframe being processed in the animation.\r\n     */\r\n    currentKeyframeIndex: number;\r\n};\r\n\r\n/**\r\n * Represents a keyframe for a 2D vector property.\r\n */\r\nexport type Vector2Keyframe = {\r\n    /**\r\n     * The value at this keyframe.\r\n     */\r\n    value: IVector2Like;\r\n    /**\r\n     * The time at which this keyframe occurs in the animation, in frames.\r\n     */\r\n    time: number;\r\n    /**\r\n     * The easing function applied to the transition from this keyframe to the next one.\r\n     * This is used for the first dimension of the vector.\r\n     */\r\n    easeFunction1: BezierCurve;\r\n    /**\r\n     * The easing function applied to the transition from this keyframe to the next one.\r\n     * This is used for the second dimension of the vector.\r\n     */\r\n    easeFunction2: BezierCurve;\r\n};\r\n"]}

package/lottie/lottie/rawTypes.d.ts

@@ -0,0 +1,152 @@
+export type RawLottieAnimation = {
+    v: string;
+    fr: number;
+    ip: number;
+    op: number;
+    w: number;
+    h: number;
+    nm?: string;
+    layers: RawLottieLayer[];
+};
+export type RawLottieLayer = {
+    ind?: number;
+    ty: RawLayerType;
+    nm?: string;
+    parent?: number;
+    hd?: boolean;
+    sr?: number;
+    ao?: number;
+    ip?: number;
+    op?: number;
+    st?: number;
+    ct?: number;
+    ks: RawTransform;
+    shapes?: RawGraphicElement[];
+};
+export type RawGraphicElement = {
+    nm?: string;
+    hd?: boolean;
+    ty: RawShapeType;
+    bm?: number;
+    ix?: number;
+};
+export type RawGroupShape = RawGraphicElement & {
+    it?: RawGraphicElement[];
+};
+export type RawRectangleShape = RawGraphicElement & {
+    d: RawShapeDirection;
+    p: RawPositionProperty;
+    s: RawVectorProperty;
+    r: RawScalarProperty;
+};
+export type RawPathShape = RawGraphicElement & {
+    d: RawShapeDirection;
+    ks: RawBezierShapeProperty;
+};
+export type RawFillShape = RawGraphicElement & {
+    o: RawScalarProperty;
+    c: RawColorProperty;
+    r: RawFillRule;
+};
+export type RawGradientFillShape = RawGraphicElement & {
+    o: RawScalarProperty;
+    g: RawGradientsProperty;
+    s: RawPositionProperty;
+    e: RawPositionProperty;
+    t: RawGradientType;
+    h: RawScalarProperty;
+    a?: RawScalarProperty;
+    r: RawFillRule;
+};
+export type RawTransformShape = RawGraphicElement & {
+    a: RawPositionProperty;
+    p: RawPositionProperty;
+    r: RawScalarProperty;
+    s: RawVectorProperty;
+    o: RawScalarProperty;
+    sk: RawScalarProperty;
+    sa: RawScalarProperty;
+};
+export type RawTransform = {
+    a?: RawPositionProperty;
+    p?: RawPositionProperty;
+    r?: RawScalarProperty;
+    s?: RawVectorProperty;
+    o?: RawScalarProperty;
+};
+export type RawScalarProperty = {
+    a: RawNumberBoolean;
+    k: number | RawVectorKeyframe[];
+};
+export type RawVectorProperty = {
+    a: RawNumberBoolean;
+    k: number[] | RawVectorKeyframe[];
+    l: number;
+};
+export type RawVectorKeyframe = {
+    t: number;
+    s: number[];
+    h?: RawNumberBoolean;
+    i?: RawKeyFrameEasing;
+    o?: RawKeyFrameEasing;
+};
+export type RawPositionProperty = {
+    a: RawNumberBoolean;
+    k: number[] | RawPositionKeyframe[];
+    l: number;
+};
+export type RawPositionKeyframe = {
+    t: number;
+    h?: RawNumberBoolean;
+    i?: RawKeyFrameEasing;
+    o?: RawKeyFrameEasing;
+    s: number[];
+    ti: number[];
+    to: number[];
+};
+export type RawBezierShapeProperty = {
+    a: RawNumberBoolean;
+    k: RawBezier | RawBezierShapeKeyframe[];
+};
+export type RawBezierShapeKeyframe = {
+    t: number;
+    h?: RawNumberBoolean;
+    i?: RawKeyFrameEasing;
+    o?: RawKeyFrameEasing;
+    s: RawBezier[];
+};
+export type RawColorProperty = {
+    a: RawNumberBoolean;
+    k: number[] | RawColorKeyframe[];
+};
+export type RawColorKeyframe = {
+    t: number;
+    h?: RawNumberBoolean;
+    i?: RawKeyFrameEasing;
+    o?: RawKeyFrameEasing;
+    s: number[];
+};
+export type RawGradientsProperty = {
+    p: number;
+    k: RawGradientProperty;
+};
+export type RawGradientProperty = {
+    a: RawNumberBoolean;
+    k: number[];
+};
+export type RawKeyFrameEasing = {
+    x: number | number[];
+    y: number | number[];
+};
+export type RawBezier = {
+    c: boolean;
+    i: number[][];
+    o: number[][];
+    v: number[][];
+};
+export type RawNumberBoolean = 0 | 1;
+export type RawLayerType = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+export type RawShapeType = "fl" | "gf" | "gr" | "tr" | "sh" | "rc";
+export type RawShapeDirection = 1 | 3;
+export type RawFillRule = 1 | 2;
+export type RawGradientType = 1 | 2;

package/lottie/lottie/rawTypes.js

@@ -0,0 +1,4 @@
+/* eslint-disable jsdoc/require-jsdoc */
+/* eslint-disable @typescript-eslint/no-unused-vars */
+export {};
+//# sourceMappingURL=rawTypes.js.map

package/lottie/lottie/rawTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rawTypes.js","sourceRoot":"","sources":["../../../../../dev/addons/src/lottie/lottie/rawTypes.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,sDAAsD","sourcesContent":["/* eslint-disable jsdoc/require-jsdoc */\r\n/* eslint-disable @typescript-eslint/no-unused-vars */\r\n\r\n// Types for the raw Lottie .json data\r\n\r\n// General animation data\r\nexport type RawLottieAnimation = {\r\n    v: string; // Version\r\n    fr: number; // Framerate in frames per second\r\n    ip: number; // \tFrame the animation starts at (usually 0)\r\n    op: number; // \tFrame the animation stops/loops at, which makes this the duration in frames when ip is 0\r\n    w: number; // Width\r\n    h: number; // Height\r\n    nm?: string; // Human readable name\r\n    layers: RawLottieLayer[]; // Layers\r\n};\r\n\r\n// Layer data\r\nexport type RawLottieLayer = {\r\n    ind?: number; // Index that can be used for parenting and referenced in expressions\r\n    ty: RawLayerType; // Layer type (0: precomp, 1: solid, 2: image, 3: null, 4: shape, 5: text)\r\n    nm?: string; // Human readable name\r\n    parent?: number; // Must be the ind property of another layer\r\n    hd?: boolean; // Hidden\r\n    sr?: number; // Time Stretch\r\n    ao?: number; // Auto-Orient (0: false, 1: true), if 1, the layer will rotate itself to match its animated position path\r\n    ip?: number; // Frame when the layer becomes visible\r\n    op?: number; // Frame when the layer becomes invisible\r\n    st?: number; // Start time\r\n    ct?: number; // Collapse Transform (0: false, 1: true), marks that transforms should be applied before masks\r\n    ks: RawTransform; // Layer transform\r\n    shapes?: RawGraphicElement[];\r\n};\r\n\r\nexport type RawGraphicElement = {\r\n    nm?: string; // Human readable name\r\n    hd?: boolean; // Hidden\r\n    ty: RawShapeType; // Type ('gr' for group, 'rc' for rectangle, 'el' for ellipse, 'sh' for path, etc.)\r\n    bm?: number; // Blend mode\r\n    ix?: number; // Index\r\n};\r\n\r\nexport type RawGroupShape = RawGraphicElement & {\r\n    it?: RawGraphicElement[]; // shapes\r\n};\r\n\r\nexport type RawRectangleShape = RawGraphicElement & {\r\n    d: RawShapeDirection; // direction the shape is drawn as, mostly relevant when using trim path\r\n    p: RawPositionProperty; // center of the rectangle\r\n    s: RawVectorProperty; // size of the rectangle\r\n    r: RawScalarProperty; // rounded corners radius\r\n};\r\n\r\nexport type RawPathShape = RawGraphicElement & {\r\n    d: RawShapeDirection; // direction the shape is drawn as, mostly relevant when using trim path\r\n    ks: RawBezierShapeProperty; // bezier path\r\n};\r\n\r\nexport type RawFillShape = RawGraphicElement & {\r\n    o: RawScalarProperty; // Opacity, 100 means fully opaque\r\n    c: RawColorProperty; // Color\r\n    r: RawFillRule; // fill rule\r\n};\r\n\r\nexport type RawGradientFillShape = RawGraphicElement & {\r\n    o: RawScalarProperty; // Opacity, 100 means fully opaque\r\n    g: RawGradientsProperty; // Gradient colors\r\n    s: RawPositionProperty; // Starting point of the gradient\r\n    e: RawPositionProperty; // End point of the gradient\r\n    t: RawGradientType; // type of the gradient\r\n    h: RawScalarProperty; // highlight length as a percentage between s and e\r\n    a?: RawScalarProperty; // highlight angle in clockwise degrees, relative to the direction from s to e\r\n    r: RawFillRule; // fill rule\r\n};\r\n\r\nexport type RawTransformShape = RawGraphicElement & {\r\n    a: RawPositionProperty; // anchor point\r\n    p: RawPositionProperty; // position/translation\r\n    r: RawScalarProperty; // rotation in degrees, clockwise\r\n    s: RawVectorProperty; // scale factor, [100, 100] for no scaling\r\n    o: RawScalarProperty; // opacity\r\n    sk: RawScalarProperty; // skew amount as an angle in degrees\r\n    sa: RawScalarProperty; // skew axis, direction along which skew is applied, in degrees (0 skes along the x axis, 90 along the Y axys)\r\n};\r\n\r\nexport type RawTransform = {\r\n    a?: RawPositionProperty; // Anchor point: a position (relative to its parent) around which transformations are applied (ie: center for rotation / scale)\r\n    p?: RawPositionProperty; // Position / Translation\r\n    r?: RawScalarProperty; // Rotation in degrees, clockwise\r\n    s?: RawVectorProperty; // Scale factor, [100, 100] for no scaling\r\n    o?: RawScalarProperty; // Opacity\r\n};\r\n\r\nexport type RawScalarProperty = {\r\n    a: RawNumberBoolean; // Animated (0: false, 1: true)\r\n    k: number | RawVectorKeyframe[]; // When it's not animated, k will contain the value directly. When animated, k will be an array of keyframes.\r\n};\r\n\r\nexport type RawVectorProperty = {\r\n    a: RawNumberBoolean; // Animated (0: false, 1: true)\r\n    k: number[] | RawVectorKeyframe[]; // When it's not animated, k will contain the value directly. When animated, k will be an array of keyframes.\r\n    l: number; // Number of components in the value arrays. If present values will be truncated or expanded to match this length when accessed from expressions\r\n};\r\n\r\nexport type RawVectorKeyframe = {\r\n    t: number; // Time, Frame number\r\n    s: number[]; // Value at this keyframe\r\n    h?: RawNumberBoolean; // Hold flag (0: false, 1: true)\r\n    i?: RawKeyFrameEasing; // In tangent, easing tangent going into the next keyframe\r\n    o?: RawKeyFrameEasing; // Out tanget, easing tangent leaving the current keyframe\r\n};\r\n\r\nexport type RawPositionProperty = {\r\n    a: RawNumberBoolean; // Animated (0: false, 1: true)\r\n    k: number[] | RawPositionKeyframe[]; // When it's not animated, k will contain the value directly. When animated, k will be an array of keyframes.\r\n    l: number; // Number of components in the value arrays. If present values will be truncated or expanded to match this length when accessed from expressions\r\n};\r\n\r\nexport type RawPositionKeyframe = {\r\n    t: number; // Time, Frame number\r\n    h?: RawNumberBoolean; // Hold flag (0: false, 1: true)\r\n    i?: RawKeyFrameEasing; // In tangent, easing tangent going into the next keyframe\r\n    o?: RawKeyFrameEasing; // Out tanget, easing tangent leaving the current keyframe\r\n    s: number[]; // Value at this keyframe\r\n    ti: number[]; // Value In Tangent, tangent for values (eg: moving position around a curved path)\r\n    to: number[]; // Value Out Tangent, tangent for values (eg: moving position around a curved path)\r\n};\r\n\r\nexport type RawBezierShapeProperty = {\r\n    a: RawNumberBoolean; // Animated (0: false, 1: true)\r\n    k: RawBezier | RawBezierShapeKeyframe[]; // When it's not animated, k will contain the value directly. When animated, k will be an array of keyframes\r\n};\r\n\r\nexport type RawBezierShapeKeyframe = {\r\n    t: number; // Time, Frame number\r\n    h?: RawNumberBoolean; // Hold flag (0: false, 1: true)\r\n    i?: RawKeyFrameEasing; // In tangent, easing tangent going into the next keyframe\r\n    o?: RawKeyFrameEasing; // Out tanget, easing tangent leaving the current keyframe\r\n    s: RawBezier[]; // Value at this keyframe\r\n};\r\n\r\nexport type RawColorProperty = {\r\n    a: RawNumberBoolean; // Animated (0: false, 1: true)\r\n    k: number[] | RawColorKeyframe[]; // When it's not animated, k will contain the value directly. When animated, k will be an array of keyframes\r\n};\r\n\r\nexport type RawColorKeyframe = {\r\n    t: number; // Time, Frame number\r\n    h?: RawNumberBoolean; // Hold flag (0: false, 1: true)\r\n    i?: RawKeyFrameEasing; // In tangent, easing tangent going into the next keyframe\r\n    o?: RawKeyFrameEasing; // Out tanget, easing tangent leaving the current keyframe\r\n    s: number[]; // Value at this keyframe\r\n};\r\n\r\nexport type RawGradientsProperty = {\r\n    p: number; // Color stop count\r\n    k: RawGradientProperty;\r\n};\r\n\r\nexport type RawGradientProperty = {\r\n    a: RawNumberBoolean; // Animated (0: false, 1: true)\r\n    k: number[]; // Gradient colors array\r\n};\r\n\r\nexport type RawKeyFrameEasing = {\r\n    x: number | number[]; // Time component: 0 means start time of the keyframe, 1 means time of the next keyframe.\r\n    y: number | number[]; // Value interpolation component: 0 means start value of the keyframe, 1 means value at the next keyframe.\r\n};\r\n\r\nexport type RawBezier = {\r\n    c: boolean; // Closed\r\n    i: number[][]; // In tangents, array of points, each point is an array of coordinates. These points are along the in tangents relative to the corresponding v\r\n    o: number[][]; // Out tangents, array of points, each point is an array of coordinates. These points are along the out tangents relative to the corresponding v\r\n    v: number[][]; // Vertices, array of points, each point is an array of coordinates. These points are along the bezier path\r\n};\r\n\r\nexport type RawNumberBoolean = 0 | 1; // 0: false, 1: true;\r\nexport type RawLayerType = 0 | 1 | 2 | 3 | 4 | 5 | 6; // Layer type (0: precomposition, 1: solid, 2: image, 3: null, 4: shape, 5: text, 6: audio)\r\nexport type RawShapeType = \"fl\" | \"gf\" | \"gr\" | \"tr\" | \"sh\" | \"rc\"; // Shape type (fl: fill, gf: gradient fill, gr: group, tr: transform, sh: path, rc: rectangle)\r\nexport type RawShapeDirection = 1 | 3; // 1: clockwise, 3: counter-clockwise\r\nexport type RawFillRule = 1 | 2; // Fill rule (1: non-zero, everything is colored (You can think of this as an OR), 2: even-odd, colored based on intersections and path direction, can be used to create \"holes\")\r\nexport type RawGradientType = 1 | 2; // Gradient type (1: linear, 2: radial)\r\n"]}

package/lottie/lottiePlayer.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Configuration options for the Lottie animation player.
+ */
+export type AnimationConfiguration = {
+    /**
+     * Whether the animation should play on a loop or not
+     */
+    loopAnimation: boolean;
+    /**
+     * Size of the sprite atlas texture.
+     * Default is 2048.
+     */
+    spriteAtlasSize: number;
+    /**
+     * Gap size around sprites in the atlas.
+     * Default is 5.
+     */
+    gapSize: number;
+    /**
+     * Maximum number of sprites the renderer can handle at once.
+     * Default is 64.
+     */
+    spritesCapacity: number;
+    /**
+     * Background color for the animation canvas.
+     * Default is white with full opacity.
+     */
+    backgroundColor: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+    /**
+     * Minimum scale factor to prevent too small sprites.
+     * Default is 5.
+     */
+    scaleMultiplier: number;
+    /**
+     * Scale factor for the rendering.
+     * Default is 1.
+     */
+    devicePixelRatio: number;
+    /**
+     * Number of steps to sample cubic bezier easing functions for animations.
+     * Default is 4.
+     */
+    easingSteps: number;
+    /**
+     * Whether to ignore opacity animations for performance.
+     * Default is true.
+     */
+    ignoreOpacityAnimations: boolean;
+    /**
+     * Whether to support device lost events for WebGL contexts.
+     * Default is false.
+     */
+    supportDeviceLost: boolean;
+};
+/**
+ * LottiePlayer is a class that allows you to play Lottie animations using Babylon.js.
+ * It plays the animations in a worker thread using OffscreenCanvas.
+ * Once instance of this class can only be used to play a single animation. If you want to play multiple animations, create a new instance for each animation.
+ */
+export declare class LottiePlayer {
+    private _playing;
+    private _disposed;
+    private _worker;
+    private _canvas;
+    private _resizeObserver;
+    private readonly _container;
+    private readonly _animationFile;
+    private readonly _configuration;
+    /**
+     * Creates a new instance of the LottiePlayer.
+     * @param container The HTMLDivElement to create the canvas in and render the animation on.
+     * @param animationFile The URL of the Lottie animation file to be played.
+     * @param configuration Optional configuration object to customize the animation playback.
+     */
+    constructor(container: HTMLDivElement, animationFile: string, configuration?: Partial<AnimationConfiguration>);
+    /**
+     * Loads and plays a lottie animation.
+     * @returns True if the animation is successfully set up to play, false if the animation couldn't play.
+     */
+    playAnimation(): boolean;
+    /**
+     * Disposes the LottiePlayer instance, cleaning up resources and event listeners.
+     */
+    dispose(): void;
+    private _onWindowResize;
+    private _onBeforeUnload;
+}

package/lottie/lottiePlayer.js

@@ -0,0 +1,101 @@
+/**
+ * LottiePlayer is a class that allows you to play Lottie animations using Babylon.js.
+ * It plays the animations in a worker thread using OffscreenCanvas.
+ * Once instance of this class can only be used to play a single animation. If you want to play multiple animations, create a new instance for each animation.
+ */
+export class LottiePlayer {
+    /**
+     * Creates a new instance of the LottiePlayer.
+     * @param container The HTMLDivElement to create the canvas in and render the animation on.
+     * @param animationFile The URL of the Lottie animation file to be played.
+     * @param configuration Optional configuration object to customize the animation playback.
+     */
+    constructor(container, animationFile, configuration) {
+        this._playing = false;
+        this._disposed = false;
+        this._worker = null;
+        this._canvas = null;
+        this._resizeObserver = null;
+        this._onWindowResize = () => {
+            if (this._disposed || !this._canvas || !this._worker) {
+                return;
+            }
+            const w = this._canvas.clientWidth;
+            const h = this._canvas.clientHeight;
+            this._worker.postMessage({ width: w, height: h });
+        };
+        this._onBeforeUnload = () => {
+            this._worker?.terminate();
+            this._worker = null;
+        };
+        this._container = container;
+        this._animationFile = animationFile;
+        this._configuration = configuration ?? {};
+    }
+    /**
+     * Loads and plays a lottie animation.
+     * @returns True if the animation is successfully set up to play, false if the animation couldn't play.
+     */
+    playAnimation() {
+        if (this._playing || this._disposed) {
+            return false;
+        }
+        if ("OffscreenCanvas" in window) {
+            // Create the canvas element
+            this._canvas = document.createElement("canvas");
+            this._canvas.width = this._container.clientWidth;
+            this._canvas.height = this._container.clientHeight;
+            // Style the canvas to fill the container
+            this._canvas.style.width = "100%";
+            this._canvas.style.height = "100%";
+            this._canvas.style.display = "block";
+            // Append the canvas to the container
+            this._container.appendChild(this._canvas);
+            const offscreen = this._canvas.transferControlToOffscreen();
+            this._worker = new Worker(new URL("./worker.ts", import.meta.url), { type: "module" });
+            this._worker.onmessage = (evt) => {
+                if (evt.data.animationWidth && evt.data.animationHeight && this._canvas) {
+                    this._canvas.style.width = `${evt.data.animationWidth}px`;
+                    this._canvas.style.height = `${evt.data.animationHeight}px`;
+                }
+            };
+            this._worker.postMessage({ canvas: offscreen, file: this._animationFile, config: this._configuration }, [offscreen]);
+            this._playing = true;
+            window.addEventListener("resize", this._onWindowResize);
+            window.addEventListener("beforeunload", this._onBeforeUnload);
+            if ("ResizeObserver" in window) {
+                this._resizeObserver = new ResizeObserver(() => {
+                    if (this._disposed || !this._canvas || !this._worker) {
+                        return;
+                    }
+                    const w = this._canvas.clientWidth;
+                    const h = this._canvas.clientHeight;
+                    this._worker.postMessage({ width: w, height: h });
+                });
+                this._resizeObserver.observe(this._container);
+            }
+            return true;
+        }
+        else {
+            return false;
+        }
+    }
+    /**
+     * Disposes the LottiePlayer instance, cleaning up resources and event listeners.
+     */
+    dispose() {
+        window.removeEventListener("resize", this._onWindowResize);
+        window.removeEventListener("beforeunload", this._onBeforeUnload);
+        if (this._resizeObserver) {
+            this._resizeObserver.disconnect();
+            this._resizeObserver = null;
+        }
+        this._onBeforeUnload();
+        if (this._canvas) {
+            this._container.removeChild(this._canvas);
+            this._canvas = null;
+        }
+        this._disposed = true;
+    }
+}
+//# sourceMappingURL=lottiePlayer.js.map

package/lottie/lottiePlayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lottiePlayer.js","sourceRoot":"","sources":["../../../../dev/addons/src/lottie/lottiePlayer.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Nullable } from \"core/types\";\r\n\r\n/**\r\n * Configuration options for the Lottie animation player.\r\n */\r\nexport type AnimationConfiguration = {\r\n    /**\r\n     * Whether the animation should play on a loop or not\r\n     */\r\n    loopAnimation: boolean;\r\n    /**\r\n     * Size of the sprite atlas texture.\r\n     * Default is 2048.\r\n     */\r\n    spriteAtlasSize: number;\r\n    /**\r\n     * Gap size around sprites in the atlas.\r\n     * Default is 5.\r\n     */\r\n    gapSize: number;\r\n    /**\r\n     * Maximum number of sprites the renderer can handle at once.\r\n     * Default is 64.\r\n     */\r\n    spritesCapacity: number;\r\n    /**\r\n     * Background color for the animation canvas.\r\n     * Default is white with full opacity.\r\n     */\r\n    backgroundColor: { r: number; g: number; b: number; a: number };\r\n    /**\r\n     * Minimum scale factor to prevent too small sprites.\r\n     * Default is 5.\r\n     */\r\n    scaleMultiplier: number;\r\n    /**\r\n     * Scale factor for the rendering.\r\n     * Default is 1.\r\n     */\r\n    devicePixelRatio: number;\r\n    /**\r\n     * Number of steps to sample cubic bezier easing functions for animations.\r\n     * Default is 4.\r\n     */\r\n    easingSteps: number;\r\n    /**\r\n     * Whether to ignore opacity animations for performance.\r\n     * Default is true.\r\n     */\r\n    ignoreOpacityAnimations: boolean;\r\n    /**\r\n     * Whether to support device lost events for WebGL contexts.\r\n     * Default is false.\r\n     */\r\n    supportDeviceLost: boolean;\r\n};\r\n\r\n/**\r\n * LottiePlayer is a class that allows you to play Lottie animations using Babylon.js.\r\n * It plays the animations in a worker thread using OffscreenCanvas.\r\n * Once instance of this class can only be used to play a single animation. If you want to play multiple animations, create a new instance for each animation.\r\n */\r\nexport class LottiePlayer {\r\n    private _playing: boolean = false;\r\n    private _disposed: boolean = false;\r\n    private _worker: Nullable<Worker> = null;\r\n    private _canvas: Nullable<HTMLCanvasElement> = null;\r\n    private _resizeObserver: Nullable<ResizeObserver> = null;\r\n\r\n    private readonly _container: HTMLDivElement;\r\n    private readonly _animationFile: string;\r\n    private readonly _configuration: Partial<AnimationConfiguration>;\r\n\r\n    /**\r\n     * Creates a new instance of the LottiePlayer.\r\n     * @param container The HTMLDivElement to create the canvas in and render the animation on.\r\n     * @param animationFile The URL of the Lottie animation file to be played.\r\n     * @param configuration Optional configuration object to customize the animation playback.\r\n     */\r\n    public constructor(container: HTMLDivElement, animationFile: string, configuration?: Partial<AnimationConfiguration>) {\r\n        this._container = container;\r\n        this._animationFile = animationFile;\r\n        this._configuration = configuration ?? {};\r\n    }\r\n\r\n    /**\r\n     * Loads and plays a lottie animation.\r\n     * @returns True if the animation is successfully set up to play, false if the animation couldn't play.\r\n     */\r\n    public playAnimation(): boolean {\r\n        if (this._playing || this._disposed) {\r\n            return false;\r\n        }\r\n\r\n        if (\"OffscreenCanvas\" in window) {\r\n            // Create the canvas element\r\n            this._canvas = document.createElement(\"canvas\");\r\n            this._canvas.width = this._container.clientWidth;\r\n            this._canvas.height = this._container.clientHeight;\r\n\r\n            // Style the canvas to fill the container\r\n            this._canvas.style.width = \"100%\";\r\n            this._canvas.style.height = \"100%\";\r\n            this._canvas.style.display = \"block\";\r\n\r\n            // Append the canvas to the container\r\n            this._container.appendChild(this._canvas);\r\n\r\n            const offscreen = this._canvas.transferControlToOffscreen();\r\n\r\n            this._worker = new Worker(new URL(\"./worker.ts\", import.meta.url), { type: \"module\" });\r\n            this._worker.onmessage = (evt: MessageEvent) => {\r\n                if (evt.data.animationWidth && evt.data.animationHeight && this._canvas) {\r\n                    this._canvas.style.width = `${evt.data.animationWidth}px`;\r\n                    this._canvas.style.height = `${evt.data.animationHeight}px`;\r\n                }\r\n            };\r\n\r\n            this._worker.postMessage({ canvas: offscreen, file: this._animationFile, config: this._configuration }, [offscreen]);\r\n            this._playing = true;\r\n\r\n            window.addEventListener(\"resize\", this._onWindowResize);\r\n            window.addEventListener(\"beforeunload\", this._onBeforeUnload);\r\n\r\n            if (\"ResizeObserver\" in window) {\r\n                this._resizeObserver = new ResizeObserver(() => {\r\n                    if (this._disposed || !this._canvas || !this._worker) {\r\n                        return;\r\n                    }\r\n\r\n                    const w = this._canvas.clientWidth;\r\n                    const h = this._canvas.clientHeight;\r\n\r\n                    this._worker.postMessage({ width: w, height: h });\r\n                });\r\n\r\n                this._resizeObserver.observe(this._container);\r\n            }\r\n\r\n            return true;\r\n        } else {\r\n            return false;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Disposes the LottiePlayer instance, cleaning up resources and event listeners.\r\n     */\r\n    public dispose(): void {\r\n        window.removeEventListener(\"resize\", this._onWindowResize);\r\n        window.removeEventListener(\"beforeunload\", this._onBeforeUnload);\r\n\r\n        if (this._resizeObserver) {\r\n            this._resizeObserver.disconnect();\r\n            this._resizeObserver = null;\r\n        }\r\n\r\n        this._onBeforeUnload();\r\n\r\n        if (this._canvas) {\r\n            this._container.removeChild(this._canvas);\r\n            this._canvas = null;\r\n        }\r\n\r\n        this._disposed = true;\r\n    }\r\n\r\n    private _onWindowResize = () => {\r\n        if (this._disposed || !this._canvas || !this._worker) {\r\n            return;\r\n        }\r\n\r\n        const w = this._canvas.clientWidth;\r\n        const h = this._canvas.clientHeight;\r\n\r\n        this._worker.postMessage({ width: w, height: h });\r\n    };\r\n\r\n    private _onBeforeUnload = () => {\r\n        this._worker?.terminate();\r\n        this._worker = null;\r\n    };\r\n}\r\n"]}

package/lottie/maths/bezier.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Represents a Babylon.js thin version of a cubic bezier curve
+ * We are only exposing what we truly need in the scope of
+ * the Lottie Renderer project preventing the dependency on the full
+ * Babylon.js animation system.
+ */
+export declare class BezierCurve {
+    /**
+     * X of the first control point
+     */
+    readonly x1: number;
+    /**
+     * Y of the first control point
+     */
+    readonly y1: number;
+    /**
+     * X of the second control point
+     */
+    readonly x2: number;
+    /**
+     * Y of the second control point
+     */
+    readonly y2: number;
+    private readonly _easingSteps;
+    private readonly _f0;
+    private readonly _f1;
+    private readonly _f2;
+    /**
+     * Instantiates a bezier function
+     * @see http://cubic-bezier.com/#.17,.67,.83,.67
+     * @param x1 Defines the x component of the start tangent in the bezier curve
+     * @param y1 Defines the y component of the start tangent in the bezier curve
+     * @param x2 Defines the x component of the end tangent in the bezier curve
+     * @param y2 Defines the y component of the end tangent in the bezier curve
+     * @param easingSteps Number of steps to sample the bezier curve for easing
+     */
+    constructor(x1: number | undefined, y1: number | undefined, x2: number | undefined, y2: number | undefined, easingSteps: number);
+    /**
+     * Interpolates the bezier curve at a given time
+     * @param t Defines the time to evaluate the bezier curve at, between 0 and 1
+     * @returns The interpolated value at time t
+     */
+    interpolate(t: number): number;
+}

package/lottie/maths/bezier.js

@@ -0,0 +1,53 @@
+/**
+ * Represents a Babylon.js thin version of a cubic bezier curve
+ * We are only exposing what we truly need in the scope of
+ * the Lottie Renderer project preventing the dependency on the full
+ * Babylon.js animation system.
+ */
+export class BezierCurve {
+    /**
+     * Instantiates a bezier function
+     * @see http://cubic-bezier.com/#.17,.67,.83,.67
+     * @param x1 Defines the x component of the start tangent in the bezier curve
+     * @param y1 Defines the y component of the start tangent in the bezier curve
+     * @param x2 Defines the x component of the end tangent in the bezier curve
+     * @param y2 Defines the y component of the end tangent in the bezier curve
+     * @param easingSteps Number of steps to sample the bezier curve for easing
+     */
+    constructor(x1 = 0, y1 = 0, x2 = 1, y2 = 1, easingSteps) {
+        this.x1 = x1;
+        this.y1 = y1;
+        this.x2 = x2;
+        this.y2 = y2;
+        this._easingSteps = easingSteps;
+        // Pre-calculate coefficients
+        this._f0 = 1 - 3 * this.x2 + 3 * this.x1;
+        this._f1 = 3 * this.x2 - 6 * this.x1;
+        this._f2 = 3 * this.x1;
+    }
+    /**
+     * Interpolates the bezier curve at a given time
+     * @param t Defines the time to evaluate the bezier curve at, between 0 and 1
+     * @returns The interpolated value at time t
+     */
+    interpolate(t) {
+        if (t === 0) {
+            return 0;
+        }
+        if (t === 1) {
+            return 1;
+        }
+        let refinedT = t;
+        for (let i = 0; i < this._easingSteps; i++) {
+            const refinedT2 = refinedT * refinedT;
+            const refinedT3 = refinedT2 * refinedT;
+            const x = this._f0 * refinedT3 + this._f1 * refinedT2 + this._f2 * refinedT;
+            const slope = 1.0 / (3.0 * this._f0 * refinedT2 + 2.0 * this._f1 * refinedT + this._f2);
+            refinedT -= (x - t) * slope;
+            refinedT = Math.min(1, Math.max(0, refinedT));
+        }
+        // Resolve cubic bezier for the given x
+        return 3 * (1 - refinedT) * (1 - refinedT) * refinedT * this.y1 + 3 * (1 - refinedT) * refinedT * refinedT * this.y2 + refinedT * refinedT * refinedT;
+    }
+}
+//# sourceMappingURL=bezier.js.map

package/lottie/maths/bezier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bezier.js","sourceRoot":"","sources":["../../../../../dev/addons/src/lottie/maths/bezier.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,WAAW;IAwBpB;;;;;;;;OAQG;IACH,YAAY,KAAa,CAAC,EAAE,KAAa,CAAC,EAAE,KAAa,CAAC,EAAE,KAAa,CAAC,EAAE,WAAmB;QAC3F,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAEhC,6BAA6B;QAC7B,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,CAAS;QACxB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACV,OAAO,CAAC,CAAC;QACb,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACV,OAAO,CAAC,CAAC;QACb,CAAC;QAED,IAAI,QAAQ,GAAG,CAAC,CAAC;QAEjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;YACtC,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;YACvC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC;YAC5E,MAAM,KAAK,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG,SAAS,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACxF,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;YAC5B,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;QAClD,CAAC;QAED,uCAAuC;QACvC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC,EAAE,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1J,CAAC;CACJ","sourcesContent":["/**\r\n * Represents a Babylon.js thin version of a cubic bezier curve\r\n * We are only exposing what we truly need in the scope of\r\n * the Lottie Renderer project preventing the dependency on the full\r\n * Babylon.js animation system.\r\n */\r\nexport class BezierCurve {\r\n    /**\r\n     * X of the first control point\r\n     */\r\n    public readonly x1: number;\r\n    /**\r\n     * Y of the first control point\r\n     */\r\n    public readonly y1: number;\r\n    /**\r\n     * X of the second control point\r\n     */\r\n    public readonly x2: number;\r\n    /**\r\n     * Y of the second control point\r\n     */\r\n    public readonly y2: number;\r\n\r\n    private readonly _easingSteps: number;\r\n\r\n    private readonly _f0: number;\r\n    private readonly _f1: number;\r\n    private readonly _f2: number;\r\n\r\n    /**\r\n     * Instantiates a bezier function\r\n     * @see http://cubic-bezier.com/#.17,.67,.83,.67\r\n     * @param x1 Defines the x component of the start tangent in the bezier curve\r\n     * @param y1 Defines the y component of the start tangent in the bezier curve\r\n     * @param x2 Defines the x component of the end tangent in the bezier curve\r\n     * @param y2 Defines the y component of the end tangent in the bezier curve\r\n     * @param easingSteps Number of steps to sample the bezier curve for easing\r\n     */\r\n    constructor(x1: number = 0, y1: number = 0, x2: number = 1, y2: number = 1, easingSteps: number) {\r\n        this.x1 = x1;\r\n        this.y1 = y1;\r\n        this.x2 = x2;\r\n        this.y2 = y2;\r\n        this._easingSteps = easingSteps;\r\n\r\n        // Pre-calculate coefficients\r\n        this._f0 = 1 - 3 * this.x2 + 3 * this.x1;\r\n        this._f1 = 3 * this.x2 - 6 * this.x1;\r\n        this._f2 = 3 * this.x1;\r\n    }\r\n\r\n    /**\r\n     * Interpolates the bezier curve at a given time\r\n     * @param t Defines the time to evaluate the bezier curve at, between 0 and 1\r\n     * @returns The interpolated value at time t\r\n     */\r\n    public interpolate(t: number): number {\r\n        if (t === 0) {\r\n            return 0;\r\n        }\r\n\r\n        if (t === 1) {\r\n            return 1;\r\n        }\r\n\r\n        let refinedT = t;\r\n\r\n        for (let i = 0; i < this._easingSteps; i++) {\r\n            const refinedT2 = refinedT * refinedT;\r\n            const refinedT3 = refinedT2 * refinedT;\r\n            const x = this._f0 * refinedT3 + this._f1 * refinedT2 + this._f2 * refinedT;\r\n            const slope = 1.0 / (3.0 * this._f0 * refinedT2 + 2.0 * this._f1 * refinedT + this._f2);\r\n            refinedT -= (x - t) * slope;\r\n            refinedT = Math.min(1, Math.max(0, refinedT));\r\n        }\r\n\r\n        // Resolve cubic bezier for the given x\r\n        return 3 * (1 - refinedT) * (1 - refinedT) * refinedT * this.y1 + 3 * (1 - refinedT) * refinedT * refinedT * this.y2 + refinedT * refinedT * refinedT;\r\n    }\r\n}\r\n"]}

package/lottie/maths/boundingBox.d.ts

@@ -0,0 +1,28 @@
+import type { RawGroupShape } from "../lottie/rawTypes.js";
+/**
+ * Represents a bounding box for a shape in the animation.
+ */
+export type BoundingBox = {
+    /**
+     * Height of the bounding box
+     */
+    height: number;
+    /**
+     * Width of the bounding box
+     */
+    width: number;
+    /**
+     * X coordinate of the center of the bounding box
+     */
+    centerX: number;
+    /**
+     * Y coordinate of the center of the bounding box
+     */
+    centerY: number;
+};
+/**
+ * Calculates the bounding box for a group shape in a Lottie animation.
+ * @param rawGroup The raw group shape to calculate the bounding box for
+ * @returns The bounding box for the group shape
+ */
+export declare function GetBoundingBox(rawGroup: RawGroupShape): BoundingBox;