[ts][webcomponents] Add holdDurationLastAnimation to animations attribute.

spine-ts/spine-webcomponents/example/tutorial.html

@@ -765,10 +765,11 @@
                     <li><code>mixDuration</code>: the mix duration between this animation and the previous one (not used for the first animation on a track)</li>
                 </ol>
 
-                <p>To loop a track once it reaches the end, add the special group <code>[loop, trackNumber]</code>, where:</p>
+                <p>To loop a track once it reaches the end, add the special group <code>[loop, trackNumber, holdDurationLastAnimation]</code>, where:</p>
                 <ul>
                     <li><code>loop</code>: identifies this as a loop instruction</li>
                     <li><code>trackNumber</code>: the number of the track to loop</li>
+                    <li><code>holdDurationLastAnimation</code>: the number of seconds to wait after the last animation is completed before repeating the loop</li>
                 </ul>
 
                 <p>The parameters of the first group on each track are passed to the <code>setAnimation</code> method, while the remaining groups use <code>addAnimation</code>.</p>

spine-ts/spine-webcomponents/src/SpineWebComponentSkeleton.ts

@@ -58,7 +58,11 @@ type UpdateSpineWidgetFunction = (delta: number, skeleton: Skeleton, state: Anim
 export type OffScreenUpdateBehaviourType = "pause" | "update" | "pose";
 export type ModeType = "inside" | "origin";
 export type FitType = "fill" | "width" | "height" | "contain" | "cover" | "none" | "scaleDown";
-export type AnimationsInfo = Record<string, { cycle?: boolean, animations: Array<AnimationsType> }>;
+export type AnimationsInfo = Record<string, {
+	cycle?: boolean,
+	holdDurationLastAnimation?: number;
+	animations: Array<AnimationsType>
+}>;
 export type AnimationsType = { animationName: string | "#EMPTY#", loop?: boolean, delay?: number, mixDuration?: number };
 export type CursorEventType = "down" | "up" | "enter" | "leave" | "move" | "drag";
 export type CursorEventTypesInput = Exclude<CursorEventType, "enter" | "leave">;
@@ -1028,7 +1032,7 @@ export class SpineWebComponentSkeleton extends HTMLElement implements Disposable
 			state.data.defaultMix = defaultMix;
 
 			if (animationsInfo) {
-				for (const [trackIndexString, { cycle, animations }] of Object.entries(animationsInfo)) {
+				for (const [trackIndexString, { cycle, animations, holdDurationLastAnimation }] of Object.entries(animationsInfo)) {
 					const cycleFn = () => {
 						const trackIndex = Number(trackIndexString);
 						for (const [index, { animationName, delay, loop, mixDuration }] of animations.entries()) {
@@ -1050,7 +1054,15 @@ export class SpineWebComponentSkeleton extends HTMLElement implements Disposable
 							if (mixDuration) track.mixDuration = mixDuration;
 
 							if (cycle && index === animations.length - 1) {
-								track.listener = { complete: () => cycleFn() };
+								track.listener = {
+									complete: () => {
+										if (holdDurationLastAnimation)
+											setTimeout(() => cycleFn(), 1000 * holdDurationLastAnimation);
+										else
+											cycleFn();
+										delete track.listener?.complete;
+									}
+								};
 							};
 						}
 					}

spine-ts/spine-webcomponents/src/wcUtils.ts

@@ -104,7 +104,7 @@ function castToAnimationsInfo (value: string | null): AnimationsInfo | undefined
 	if (!matches) return undefined;
 
 	return matches.reduce((obj, group) => {
-		const [trackIndexStringOrLoopDefinition, animationNameOrTrackIndexStringCycle, loop, delayString, mixDurationString] = group.slice(1, -1).split(',').map(v => v.trim());
+		const [trackIndexStringOrLoopDefinition, animationNameOrTrackIndexStringCycle, loopOrHoldDurationLastAnimation, delayString, mixDurationString] = group.slice(1, -1).split(',').map(v => v.trim());
 
 		if (trackIndexStringOrLoopDefinition === "loop") {
 			if (!Number.isInteger(Number(animationNameOrTrackIndexStringCycle))) {
@@ -112,6 +112,15 @@ function castToAnimationsInfo (value: string | null): AnimationsInfo | undefined
 			}
 			const animationInfoObject = obj[animationNameOrTrackIndexStringCycle] ||= { animations: [] };
 			animationInfoObject.cycle = true;
+
+			if (loopOrHoldDurationLastAnimation !== undefined) {
+				const holdDurationLastAnimation = Number(loopOrHoldDurationLastAnimation);
+				if (Number.isNaN(holdDurationLastAnimation)) {
+					throw new Error(`If present, duration of last animation of cycle in ${group} must be a positive integer number, instead it is ${loopOrHoldDurationLastAnimation}. Original value: ${value}`);
+				}
+				animationInfoObject.holdDurationLastAnimation = holdDurationLastAnimation;
+			}
+
 			return obj;
 		}
 
@@ -139,7 +148,7 @@ function castToAnimationsInfo (value: string | null): AnimationsInfo | undefined
 		const animationInfoObject = obj[trackIndexStringOrLoopDefinition] ||= { animations: [] };
 		animationInfoObject.animations.push({
 			animationName: animationNameOrTrackIndexStringCycle,
-			loop: loop.trim().toLowerCase() === "true",
+			loop: loopOrHoldDurationLastAnimation.trim().toLowerCase() === "true",
 			delay,
 			mixDuration,
 		});