@aarsteinmedia/dotlottie-player 6.3.4 → 6.3.6

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 Changelog was only added since [3.2.3], so it's not exhaustive. [Please report any missing noteable changes to us](https://github.com/aarsteinmedia/dotlottie-player/issues), and we'll add them promptly.
 
+## [6.3.6] - 09-06-2026
+
+### Changed
+
+- Added support for seedRandom expression.
+- Various backend optimizations.
+
 ## [6.3.0] - 22-02-2026
 
 ### Changed

package/custom-elements.json

@@ -1,5 +1,119 @@
 {
   "schemaVersion": "1.0.0",
   "readme": "",
-  "modules": []
+  "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "dist/full.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "DotLottie Player Web Component.",
+          "name": "DotLottiePlayer",
+          "members": [
+            {
+              "kind": "method",
+              "name": "loadAnimation",
+              "parameters": [
+                {
+                  "name": "config"
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "setOptions",
+              "parameters": [
+                {
+                  "name": "{ container, hasAutoplay, hasLoop, initialSegment, preserveAspectRatio, rendererType }"
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "addAnimation",
+              "default": "addAnimation"
+            },
+            {
+              "kind": "field",
+              "name": "convert",
+              "default": "convert"
+            }
+          ],
+          "superclass": {
+            "name": "DotLottiePlayerBase",
+            "module": "/dist/chunks/DotLottiePlayerBase-BBHa6yP8.js"
+          },
+          "tagName": "tagName",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "PlayMode",
+          "declaration": {
+            "name": "PlayMode",
+            "package": "@aarsteinmedia/lottie-web/utils"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "PlayerEvents",
+          "declaration": {
+            "name": "PlayerEvents",
+            "package": "@aarsteinmedia/lottie-web/utils"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RendererType",
+          "declaration": {
+            "name": "RendererType",
+            "package": "@aarsteinmedia/lottie-web/utils"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "MouseOut",
+          "declaration": {
+            "name": "M",
+            "module": "./chunks/DotLottiePlayerBase-BBHa6yP8.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "PlayerState",
+          "declaration": {
+            "name": "P",
+            "module": "./chunks/DotLottiePlayerBase-BBHa6yP8.js"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "tagName",
+          "declaration": {
+            "name": "DotLottiePlayer",
+            "module": "dist/full.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "DotLottiePlayer",
+            "module": "dist/full.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "tagName",
+          "declaration": {
+            "name": "tagName",
+            "module": "dist/full.js"
+          }
+        }
+      ]
+    }
+  ]
 }

package/dist/canvas.d.ts

@@ -1,13 +1,14 @@
 import { RendererType, PreserveAspectRatio } from '@aarsteinmedia/lottie-web/utils';
 export { PlayMode, PlayerEvents, RendererType } from '@aarsteinmedia/lottie-web/utils';
-import { D as DotLottiePlayerBase, a as DotLottieAnimationInstance } from './chunks/DotLottiePlayerBase.d-COx4pY8X.js';
-export { M as MouseOut, P as PlayerState, t as tagName } from './chunks/DotLottiePlayerBase.d-COx4pY8X.js';
+import * as _aarsteinmedia_lottie_web from '@aarsteinmedia/lottie-web';
 import { AnimationConfiguration, Vector2 } from '@aarsteinmedia/lottie-web';
+import { D as DotLottiePlayerBase } from './chunks/DotLottiePlayerBase.d-BSagzEPB.js';
+export { M as MouseOut, P as PlayerState, t as tagName } from './chunks/DotLottiePlayerBase.d-BSagzEPB.js';
 
 declare class DotLottiePlayerCanvas extends DotLottiePlayerBase {
     get renderer(): RendererType;
     constructor();
-    loadAnimation(config: AnimationConfiguration): DotLottieAnimationInstance;
+    loadAnimation(config: AnimationConfiguration): _aarsteinmedia_lottie_web.AnimationItem;
     protected setOptions({ container, hasAutoplay, hasLoop, initialSegment, preserveAspectRatio, }: {
         container?: HTMLElement;
         rendererType: RendererType;

package/dist/canvas.js

@@ -1,8 +1,8 @@
 import { RendererType, isServer } from '@aarsteinmedia/lottie-web/utils';
 export { PlayMode, PlayerEvents, RendererType } from '@aarsteinmedia/lottie-web/utils';
 import Lottie from '@aarsteinmedia/lottie-web/canvas';
-import { D as DotLottiePlayerBase, t as tagName } from './chunks/DotLottiePlayerBase-B6CMicGB.js';
-export { M as MouseOut, P as PlayerState } from './chunks/DotLottiePlayerBase-B6CMicGB.js';
+import { D as DotLottiePlayerBase, t as tagName } from './chunks/DotLottiePlayerBase-BBHa6yP8.js';
+export { M as MouseOut, P as PlayerState } from './chunks/DotLottiePlayerBase-BBHa6yP8.js';
 import '@aarsteinmedia/lottie-web/dotlottie';
 
 /**

package/dist/chunks/{DotLottiePlayerBase-B6CMicGB.js → DotLottiePlayerBase-BBHa6yP8.js}

@@ -299,6 +299,13 @@ const pauseIcon = /* HTML */ `
         }
     }
     return res;
+}, isEnum = (val, _enum)=>{
+    if (val === undefined || val === null) {
+        return false;
+    }
+    // Numeric enums have reverse-mapping keys like "0", "1", etc.
+    const enumKeys = Object.keys(_enum).filter((k)=>Number.isNaN(Number(k)));
+    return enumKeys.some((k)=>_enum[k] === val);
 }, isLottie = (json)=>{
     const mandatory = [
         'v',
@@ -317,6 +324,24 @@ const notImplemented = 'Method is not implemented', getStyles = async ()=>{
     await styleSheet.replace(css_248z);
     return styleSheet;
 };
+// export interface DotLottieAnimationInstance {
+//   addEventListener: (name: string, callback: (...args: any[]) => void) => void
+//   autoplay?: boolean
+//   currentFrame: number
+//   destroy: () => void
+//   goToAndPlay: (value: number, isFrame?: boolean) => void
+//   goToAndStop: (value: number, isFrame?: boolean) => void
+//   pause: () => void
+//   play: () => void
+//   playDirection: number
+//   removeEventListener: (name: string, callback: (...args: any[]) => void) => void
+//   setDirection: (direction: AnimationDirection) => void
+//   setLoop: (loop: boolean) => void
+//   setSpeed: (speed: number) => void
+//   setSubframe: (useSubframe: boolean) => void
+//   stop: () => void
+//   totalFrames: number
+// }
 /**
  * DotLottie Player Web Component.
  */ class DotLottiePlayerBase extends PropertyCallbackElement {
@@ -521,7 +546,7 @@ const notImplemented = 'Method is not implemented', getStyles = async ()=>{
     }
     get objectfit() {
         const val = this.getAttribute('objectfit');
-        if (val && Object.values(ObjectFit).includes(val)) {
+        if (isEnum(val, ObjectFit)) {
             return val;
         }
         return ObjectFit.Contain;
@@ -561,7 +586,7 @@ const notImplemented = 'Method is not implemented', getStyles = async ()=>{
     }
     get preserveAspectRatio() {
         const val = this.getAttribute('preserveAspectRatio');
-        if (val && Object.values(PreserveAspectRatio).includes(val)) {
+        if (isEnum(val, PreserveAspectRatio)) {
             return val;
         }
         return null;
@@ -756,6 +781,9 @@ const notImplemented = 'Method is not implemented', getStyles = async ()=>{
             case 'mode':
                 {
                     const toggleBoomerang = this.shadow.querySelector('.toggleBoomerang');
+                    if (!isEnum(value, PlayMode)) {
+                        break;
+                    }
                     if (toggleBoomerang instanceof HTMLButtonElement) {
                         toggleBoomerang.dataset.active = (value === PlayMode.Bounce).toString();
                     }

package/dist/chunks/{DotLottiePlayerBase.d-COx4pY8X.d.ts → DotLottiePlayerBase.d-BSagzEPB.d.ts}

@@ -1,4 +1,4 @@
-import { HTMLBooleanAttribute, AnimationData, AnimationDirection, AddAnimationParams, Result, ConvertParams, LottieManifest, AnimationSettings, Vector2, AnimationConfiguration } from '@aarsteinmedia/lottie-web';
+import { HTMLBooleanAttribute, AnimationData, AnimationDirection, AddAnimationParams, Result, ConvertParams, AnimationItem, LottieManifest, AnimationSettings, Vector2, AnimationConfiguration } from '@aarsteinmedia/lottie-web';
 import { PlayMode, PreserveAspectRatio, RendererType } from '@aarsteinmedia/lottie-web/utils';
 
 declare abstract class PropertyCallbackElement extends HTMLElement {
@@ -29,27 +29,9 @@ declare enum PlayerState {
 }
 declare const tagName = "dotlottie-player";
 
-interface DotLottieAnimationInstance {
-    addEventListener: (name: string, callback: (...args: any[]) => void) => void;
-    autoplay?: boolean;
-    currentFrame: number;
-    destroy: () => void;
-    goToAndPlay: (value: number, isFrame?: boolean) => void;
-    goToAndStop: (value: number, isFrame?: boolean) => void;
-    pause: () => void;
-    play: () => void;
-    playDirection: number;
-    removeEventListener: (name: string, callback: (...args: any[]) => void) => void;
-    setDirection: (direction: AnimationDirection) => void;
-    setLoop: (loop: boolean) => void;
-    setSpeed: (speed: number) => void;
-    setSubframe: (useSubframe: boolean) => void;
-    stop: () => void;
-    totalFrames: number;
-}
 declare abstract class DotLottiePlayerBase extends PropertyCallbackElement {
     static get observedAttributes(): readonly ["animateOnScroll", "autoplay", "controls", "direction", "hover", "loop", "mode", "playOnClick", "playOnVisible", "selector", "speed", "src", "subframe"];
-    static get observedProperties(): string[];
+    static get observedProperties(): readonly ["playerState", "_isSettingsOpen", "_seeker", "_currentAnimation", "_animations"];
     static get styles(): () => Promise<CSSStyleSheet>;
     isLight: boolean;
     playerState: PlayerState;
@@ -141,12 +123,12 @@ declare abstract class DotLottiePlayerBase extends PropertyCallbackElement {
     convert(_params: ConvertParams): Promise<Result>;
     destroy(): void;
     disconnectedCallback(): void;
-    getLottie(): DotLottieAnimationInstance | null;
+    getLottie(): AnimationItem | null;
     getManifest(): LottieManifest | undefined;
     getMultiAnimationSettings(): AnimationSettings[];
     getSegment(): Vector2 | undefined;
     load(src: string | null): Promise<void>;
-    loadAnimation(_config: AnimationConfiguration): DotLottieAnimationInstance;
+    loadAnimation(_config: AnimationConfiguration): AnimationItem;
     next(): void;
     pause(): void;
     play(): void;
@@ -201,4 +183,3 @@ declare abstract class DotLottiePlayerBase extends PropertyCallbackElement {
 }
 
 export { DotLottiePlayerBase as D, MouseOut as M, PlayerState as P, tagName as t };
-export type { DotLottieAnimationInstance as a };

package/dist/full.d.ts

@@ -1,14 +1,15 @@
 import { RendererType, PreserveAspectRatio } from '@aarsteinmedia/lottie-web/utils';
 export { PlayMode, PlayerEvents, RendererType } from '@aarsteinmedia/lottie-web/utils';
-import { D as DotLottiePlayerBase, a as DotLottieAnimationInstance } from './chunks/DotLottiePlayerBase.d-COx4pY8X.js';
-export { M as MouseOut, P as PlayerState, t as tagName } from './chunks/DotLottiePlayerBase.d-COx4pY8X.js';
+import * as _aarsteinmedia_lottie_web from '@aarsteinmedia/lottie-web';
 import { AnimationConfiguration, Vector2 } from '@aarsteinmedia/lottie-web';
 import { addAnimation, convert } from '@aarsteinmedia/lottie-web/dotlottie';
+import { D as DotLottiePlayerBase } from './chunks/DotLottiePlayerBase.d-BSagzEPB.js';
+export { M as MouseOut, P as PlayerState, t as tagName } from './chunks/DotLottiePlayerBase.d-BSagzEPB.js';
 
 declare class DotLottiePlayer extends DotLottiePlayerBase {
     addAnimation: typeof addAnimation;
     convert: typeof convert;
-    loadAnimation(config: AnimationConfiguration): DotLottieAnimationInstance;
+    loadAnimation(config: AnimationConfiguration): _aarsteinmedia_lottie_web.AnimationItem;
     protected setOptions({ container, hasAutoplay, hasLoop, initialSegment, preserveAspectRatio, rendererType }: {
         container?: undefined | HTMLElement;
         rendererType: RendererType;

package/dist/full.js

@@ -2,8 +2,8 @@ import { RendererType, isServer } from '@aarsteinmedia/lottie-web/utils';
 export { PlayMode, PlayerEvents, RendererType } from '@aarsteinmedia/lottie-web/utils';
 import Lottie from '@aarsteinmedia/lottie-web';
 import { addAnimation, convert } from '@aarsteinmedia/lottie-web/dotlottie';
-import { D as DotLottiePlayerBase, t as tagName } from './chunks/DotLottiePlayerBase-B6CMicGB.js';
-export { M as MouseOut, P as PlayerState } from './chunks/DotLottiePlayerBase-B6CMicGB.js';
+import { D as DotLottiePlayerBase, t as tagName } from './chunks/DotLottiePlayerBase-BBHa6yP8.js';
+export { M as MouseOut, P as PlayerState } from './chunks/DotLottiePlayerBase-BBHa6yP8.js';
 
 /**
  * DotLottie Player Web Component.
@@ -38,9 +38,7 @@ export { M as MouseOut, P as PlayerState } from './chunks/DotLottiePlayerBase-B6
                 {
                     options.rendererSettings = {
                         ...options.rendererSettings,
-                        // `clearCanvas` is canvas-only, but `rendererSettings` is typed as a
-                        // renderer union, so we have to narrow/cast in this branch.
-                        clearCanvas: true,
+                        // clearCanvas: true,
                         preserveAspectRatio,
                         progressiveLoad: true
                     };

package/dist/light.d.ts

@@ -1,13 +1,14 @@
 import { RendererType, PreserveAspectRatio } from '@aarsteinmedia/lottie-web/utils';
 export { PlayMode, PlayerEvents, RendererType } from '@aarsteinmedia/lottie-web/utils';
-import { D as DotLottiePlayerBase, a as DotLottieAnimationInstance } from './chunks/DotLottiePlayerBase.d-COx4pY8X.js';
-export { M as MouseOut, P as PlayerState, t as tagName } from './chunks/DotLottiePlayerBase.d-COx4pY8X.js';
+import * as _aarsteinmedia_lottie_web from '@aarsteinmedia/lottie-web';
 import { AnimationConfiguration, Vector2 } from '@aarsteinmedia/lottie-web';
+import { D as DotLottiePlayerBase } from './chunks/DotLottiePlayerBase.d-BSagzEPB.js';
+export { M as MouseOut, P as PlayerState, t as tagName } from './chunks/DotLottiePlayerBase.d-BSagzEPB.js';
 
 declare class DotLottiePlayerLight extends DotLottiePlayerBase {
     get renderer(): RendererType;
     constructor();
-    loadAnimation(config: AnimationConfiguration): DotLottieAnimationInstance;
+    loadAnimation(config: AnimationConfiguration): _aarsteinmedia_lottie_web.AnimationItem;
     protected setOptions({ container, hasAutoplay, hasLoop, initialSegment, preserveAspectRatio, }: {
         container?: HTMLElement;
         rendererType: RendererType;

package/dist/light.js

@@ -1,8 +1,8 @@
 import { RendererType, isServer } from '@aarsteinmedia/lottie-web/utils';
 export { PlayMode, PlayerEvents, RendererType } from '@aarsteinmedia/lottie-web/utils';
 import Lottie from '@aarsteinmedia/lottie-web/light';
-import { D as DotLottiePlayerBase, t as tagName } from './chunks/DotLottiePlayerBase-B6CMicGB.js';
-export { M as MouseOut, P as PlayerState } from './chunks/DotLottiePlayerBase-B6CMicGB.js';
+import { D as DotLottiePlayerBase, t as tagName } from './chunks/DotLottiePlayerBase-BBHa6yP8.js';
+export { M as MouseOut, P as PlayerState } from './chunks/DotLottiePlayerBase-BBHa6yP8.js';
 import '@aarsteinmedia/lottie-web/dotlottie';
 
 /**

package/dist/svg.d.ts

@@ -1,13 +1,14 @@
 import { RendererType, PreserveAspectRatio } from '@aarsteinmedia/lottie-web/utils';
 export { PlayMode, PlayerEvents, RendererType } from '@aarsteinmedia/lottie-web/utils';
-import { D as DotLottiePlayerBase, a as DotLottieAnimationInstance } from './chunks/DotLottiePlayerBase.d-COx4pY8X.js';
-export { M as MouseOut, P as PlayerState, t as tagName } from './chunks/DotLottiePlayerBase.d-COx4pY8X.js';
+import * as _aarsteinmedia_lottie_web from '@aarsteinmedia/lottie-web';
 import { AnimationConfiguration, Vector2 } from '@aarsteinmedia/lottie-web';
+import { D as DotLottiePlayerBase } from './chunks/DotLottiePlayerBase.d-BSagzEPB.js';
+export { M as MouseOut, P as PlayerState, t as tagName } from './chunks/DotLottiePlayerBase.d-BSagzEPB.js';
 
 declare class DotLottiePlayerSVG extends DotLottiePlayerBase {
     get renderer(): RendererType;
     constructor();
-    loadAnimation(config: AnimationConfiguration): DotLottieAnimationInstance;
+    loadAnimation(config: AnimationConfiguration): _aarsteinmedia_lottie_web.AnimationItem;
     protected setOptions({ container, hasAutoplay, hasLoop, initialSegment, preserveAspectRatio, }: {
         container?: undefined | HTMLElement;
         rendererType: RendererType;

package/dist/svg.js

@@ -1,8 +1,8 @@
 import { RendererType, isServer } from '@aarsteinmedia/lottie-web/utils';
 export { PlayMode, PlayerEvents, RendererType } from '@aarsteinmedia/lottie-web/utils';
 import Lottie from '@aarsteinmedia/lottie-web/svg';
-import { D as DotLottiePlayerBase, t as tagName } from './chunks/DotLottiePlayerBase-B6CMicGB.js';
-export { M as MouseOut, P as PlayerState } from './chunks/DotLottiePlayerBase-B6CMicGB.js';
+import { D as DotLottiePlayerBase, t as tagName } from './chunks/DotLottiePlayerBase-BBHa6yP8.js';
+export { M as MouseOut, P as PlayerState } from './chunks/DotLottiePlayerBase-BBHa6yP8.js';
 import '@aarsteinmedia/lottie-web/dotlottie';
 
 /**