motion 12.7.3 → 12.7.5-alpha.0

package/dist/es/motion/lib/react.mjs

@@ -36,11 +36,6 @@ export { resolveMotionValue } from '../../framer-motion/dist/es/value/utils/reso
 export { useReducedMotion } from '../../framer-motion/dist/es/utils/reduced-motion/use-reduced-motion.mjs';
 export { useReducedMotionConfig } from '../../framer-motion/dist/es/utils/reduced-motion/use-reduced-motion-config.mjs';
 export { MotionGlobalConfig } from '../../motion-utils/dist/es/global-config.mjs';
-export { invariant } from '../../motion-utils/dist/es/errors.mjs';
-export { noop } from '../../motion-utils/dist/es/noop.mjs';
-export { progress } from '../../motion-utils/dist/es/progress.mjs';
-export { AcceleratedAnimation } from '../../framer-motion/dist/es/animation/animators/AcceleratedAnimation.mjs';
-export { animateValue } from '../../framer-motion/dist/es/animation/animators/MainThreadAnimation.mjs';
 export { animationControls } from '../../framer-motion/dist/es/animation/hooks/animation-controls.mjs';
 export { useAnimate } from '../../framer-motion/dist/es/animation/hooks/use-animate.mjs';
 export { useAnimateMini } from '../../framer-motion/dist/es/animation/hooks/use-animate-style.mjs';
@@ -64,11 +59,6 @@ export { useAnimationFrame } from '../../framer-motion/dist/es/utils/use-animati
 export { useCycle } from '../../framer-motion/dist/es/utils/use-cycle.mjs';
 export { useInView } from '../../framer-motion/dist/es/utils/use-in-view.mjs';
 export { disableInstantTransitions, useInstantTransition } from '../../framer-motion/dist/es/utils/use-instant-transition.mjs';
-export { color } from '../../framer-motion/dist/es/value/types/color/index.mjs';
-export { complex } from '../../framer-motion/dist/es/value/types/complex/index.mjs';
-export { px } from '../../framer-motion/dist/es/value/types/numbers/units.mjs';
-export { spring } from '../../framer-motion/dist/es/animation/generators/spring/index.mjs';
-export { findSpring } from '../../framer-motion/dist/es/animation/generators/spring/find.mjs';
 export { optimizedAppearDataAttribute } from '../../framer-motion/dist/es/animation/optimized-appear/data-id.mjs';
 export { startOptimizedAppearAnimation } from '../../framer-motion/dist/es/animation/optimized-appear/start.mjs';
 export { LayoutGroupContext } from '../../framer-motion/dist/es/context/LayoutGroupContext.mjs';
@@ -82,35 +72,121 @@ export { AnimateSharedLayout } from '../../framer-motion/dist/es/components/Anim
 export { DeprecatedLayoutGroupContext } from '../../framer-motion/dist/es/context/DeprecatedLayoutGroupContext.mjs';
 export { useInvertedScale as useDeprecatedInvertedScale } from '../../framer-motion/dist/es/value/use-inverted-scale.mjs';
 export { delay } from '../../framer-motion/dist/es/utils/delay.mjs';
-export { MotionValue, motionValue } from '../../motion-dom/dist/es/value/index.mjs';
-export { cancelFrame, frame, frameData } from '../../motion-dom/dist/es/frameloop/frame.mjs';
-export { cancelSync, sync } from '../../motion-dom/dist/es/frameloop/index-legacy.mjs';
-export { hover } from '../../motion-dom/dist/es/gestures/hover.mjs';
-export { isDragActive } from '../../motion-dom/dist/es/gestures/drag/state/is-active.mjs';
-export { press } from '../../motion-dom/dist/es/gestures/press/index.mjs';
-export { time } from '../../motion-dom/dist/es/frameloop/sync-time.mjs';
 export { animate, createScopedAnimate } from '../../framer-motion/dist/es/animation/animate/index.mjs';
 export { animateMini } from '../../framer-motion/dist/es/animation/animators/waapi/animate-style.mjs';
 export { scroll } from '../../framer-motion/dist/es/render/dom/scroll/index.mjs';
 export { scrollInfo } from '../../framer-motion/dist/es/render/dom/scroll/track.mjs';
 export { inView } from '../../framer-motion/dist/es/render/dom/viewport/index.mjs';
-export { inertia } from '../../framer-motion/dist/es/animation/generators/inertia.mjs';
-export { keyframes } from '../../framer-motion/dist/es/animation/generators/keyframes.mjs';
 export { stagger } from '../../framer-motion/dist/es/animation/utils/stagger.mjs';
-export { clamp } from '../../framer-motion/dist/es/utils/clamp.mjs';
-export { mix } from '../../framer-motion/dist/es/utils/mix/index.mjs';
-export { pipe } from '../../framer-motion/dist/es/utils/pipe.mjs';
 export { transform } from '../../framer-motion/dist/es/utils/transform.mjs';
-export { wrap } from '../../framer-motion/dist/es/utils/wrap.mjs';
-export { anticipate } from '../../framer-motion/dist/es/easing/anticipate.mjs';
-export { backIn, backInOut, backOut } from '../../framer-motion/dist/es/easing/back.mjs';
-export { circIn, circInOut, circOut } from '../../framer-motion/dist/es/easing/circ.mjs';
-export { cubicBezier } from '../../framer-motion/dist/es/easing/cubic-bezier.mjs';
-export { easeIn, easeInOut, easeOut } from '../../framer-motion/dist/es/easing/ease.mjs';
-export { mirrorEasing } from '../../framer-motion/dist/es/easing/modifiers/mirror.mjs';
-export { reverseEasing } from '../../framer-motion/dist/es/easing/modifiers/reverse.mjs';
-export { steps } from '../../framer-motion/dist/es/easing/steps.mjs';
 export { distance, distance2D } from '../../framer-motion/dist/es/utils/distance.mjs';
-export { interpolate } from '../../framer-motion/dist/es/utils/interpolate.mjs';
+export { addUniqueItem, moveItem, removeItem } from '../../motion-utils/dist/es/array.mjs';
+export { clamp } from '../../motion-utils/dist/es/clamp.mjs';
+export { invariant, warning } from '../../motion-utils/dist/es/errors.mjs';
+export { isNumericalString } from '../../motion-utils/dist/es/is-numerical-string.mjs';
+export { isZeroValueString } from '../../motion-utils/dist/es/is-zero-value-string.mjs';
+export { memo } from '../../motion-utils/dist/es/memo.mjs';
+export { noop } from '../../motion-utils/dist/es/noop.mjs';
+export { pipe } from '../../motion-utils/dist/es/pipe.mjs';
+export { progress } from '../../motion-utils/dist/es/progress.mjs';
+export { SubscriptionManager } from '../../motion-utils/dist/es/subscription-manager.mjs';
+export { millisecondsToSeconds, secondsToMilliseconds } from '../../motion-utils/dist/es/time-conversion.mjs';
+export { velocityPerSecond } from '../../motion-utils/dist/es/velocity-per-second.mjs';
+export { hasWarned, warnOnce } from '../../motion-utils/dist/es/warn-once.mjs';
+export { wrap } from '../../motion-utils/dist/es/wrap.mjs';
+export { anticipate } from '../../motion-utils/dist/es/easing/anticipate.mjs';
+export { backIn, backInOut, backOut } from '../../motion-utils/dist/es/easing/back.mjs';
+export { circIn, circInOut, circOut } from '../../motion-utils/dist/es/easing/circ.mjs';
+export { cubicBezier } from '../../motion-utils/dist/es/easing/cubic-bezier.mjs';
+export { easeIn, easeInOut, easeOut } from '../../motion-utils/dist/es/easing/ease.mjs';
+export { mirrorEasing } from '../../motion-utils/dist/es/easing/modifiers/mirror.mjs';
+export { reverseEasing } from '../../motion-utils/dist/es/easing/modifiers/reverse.mjs';
+export { steps } from '../../motion-utils/dist/es/easing/steps.mjs';
+export { getEasingForSegment } from '../../motion-utils/dist/es/easing/utils/get-easing-for-segment.mjs';
+export { isBezierDefinition } from '../../motion-utils/dist/es/easing/utils/is-bezier-definition.mjs';
+export { isEasingArray } from '../../motion-utils/dist/es/easing/utils/is-easing-array.mjs';
+export { easingDefinitionToFunction } from '../../motion-utils/dist/es/easing/utils/map.mjs';
+export { AsyncMotionValueAnimation } from '../../motion-dom/dist/es/animation/AsyncMotionValueAnimation.mjs';
+export { GroupAnimation } from '../../motion-dom/dist/es/animation/GroupAnimation.mjs';
+export { GroupAnimationWithThen } from '../../motion-dom/dist/es/animation/GroupAnimationWithThen.mjs';
+export { JSAnimation, animateValue } from '../../motion-dom/dist/es/animation/JSAnimation.mjs';
+export { NativeAnimation } from '../../motion-dom/dist/es/animation/NativeAnimation.mjs';
+export { NativeAnimationExtended } from '../../motion-dom/dist/es/animation/NativeAnimationExtended.mjs';
+export { NativeAnimationWrapper } from '../../motion-dom/dist/es/animation/NativeAnimationWrapper.mjs';
+export { animationMapKey, getAnimationMap } from '../../motion-dom/dist/es/animation/utils/active-animations.mjs';
+export { getVariableValue, parseCSSVariable } from '../../motion-dom/dist/es/animation/utils/css-variables-conversion.mjs';
+export { getValueTransition } from '../../motion-dom/dist/es/animation/utils/get-value-transition.mjs';
+export { isCSSVariableName, isCSSVariableToken } from '../../motion-dom/dist/es/animation/utils/is-css-variable.mjs';
+export { inertia } from '../../motion-dom/dist/es/animation/generators/inertia.mjs';
+export { defaultEasing, keyframes } from '../../motion-dom/dist/es/animation/generators/keyframes.mjs';
+export { spring } from '../../motion-dom/dist/es/animation/generators/spring/index.mjs';
+export { calcGeneratorDuration, maxGeneratorDuration } from '../../motion-dom/dist/es/animation/generators/utils/calc-duration.mjs';
+export { createGeneratorEasing } from '../../motion-dom/dist/es/animation/generators/utils/create-generator-easing.mjs';
+export { isGenerator } from '../../motion-dom/dist/es/animation/generators/utils/is-generator.mjs';
+export { DOMKeyframesResolver } from '../../motion-dom/dist/es/animation/keyframes/DOMKeyframesResolver.mjs';
+export { KeyframeResolver, flushKeyframeResolvers } from '../../motion-dom/dist/es/animation/keyframes/KeyframesResolver.mjs';
+export { defaultOffset } from '../../motion-dom/dist/es/animation/keyframes/offsets/default.mjs';
+export { fillOffset } from '../../motion-dom/dist/es/animation/keyframes/offsets/fill.mjs';
+export { convertOffsetToTimes } from '../../motion-dom/dist/es/animation/keyframes/offsets/time.mjs';
+export { applyPxDefaults } from '../../motion-dom/dist/es/animation/keyframes/utils/apply-px-defaults.mjs';
+export { fillWildcards } from '../../motion-dom/dist/es/animation/keyframes/utils/fill-wildcards.mjs';
+export { cubicBezierAsString } from '../../motion-dom/dist/es/animation/waapi/easing/cubic-bezier.mjs';
+export { isWaapiSupportedEasing } from '../../motion-dom/dist/es/animation/waapi/easing/is-supported.mjs';
+export { mapEasingToNativeEasing } from '../../motion-dom/dist/es/animation/waapi/easing/map-easing.mjs';
+export { supportedWaapiEasing } from '../../motion-dom/dist/es/animation/waapi/easing/supported.mjs';
+export { startWaapiAnimation } from '../../motion-dom/dist/es/animation/waapi/start-waapi-animation.mjs';
+export { supportsPartialKeyframes } from '../../motion-dom/dist/es/animation/waapi/supports/partial-keyframes.mjs';
+export { supportsBrowserAnimation } from '../../motion-dom/dist/es/animation/waapi/supports/waapi.mjs';
+export { acceleratedValues } from '../../motion-dom/dist/es/animation/waapi/utils/accelerated-values.mjs';
+export { generateLinearEasing } from '../../motion-dom/dist/es/animation/waapi/utils/linear.mjs';
+export { createRenderBatcher } from '../../motion-dom/dist/es/frameloop/batcher.mjs';
+export { cancelMicrotask, microtask } from '../../motion-dom/dist/es/frameloop/microtask.mjs';
+export { time } from '../../motion-dom/dist/es/frameloop/sync-time.mjs';
+export { isDragActive, isDragging } from '../../motion-dom/dist/es/gestures/drag/state/is-active.mjs';
+export { setDragLock } from '../../motion-dom/dist/es/gestures/drag/state/set-active.mjs';
+export { hover } from '../../motion-dom/dist/es/gestures/hover.mjs';
+export { press } from '../../motion-dom/dist/es/gestures/press/index.mjs';
+export { isNodeOrChild } from '../../motion-dom/dist/es/gestures/utils/is-node-or-child.mjs';
+export { isPrimaryPointer } from '../../motion-dom/dist/es/gestures/utils/is-primary-pointer.mjs';
+export { parseValueFromTransform, readTransformValue } from '../../motion-dom/dist/es/render/dom/parse-transform.mjs';
+export { getComputedStyle } from '../../motion-dom/dist/es/render/dom/style-computed.mjs';
+export { setStyle } from '../../motion-dom/dist/es/render/dom/style-set.mjs';
+export { positionalKeys } from '../../motion-dom/dist/es/render/utils/keys-position.mjs';
+export { transformPropOrder, transformProps } from '../../motion-dom/dist/es/render/utils/keys-transform.mjs';
+export { observeTimeline } from '../../motion-dom/dist/es/scroll/observe.mjs';
+export { recordStats } from '../../motion-dom/dist/es/stats/index.mjs';
+export { activeAnimations } from '../../motion-dom/dist/es/stats/animation-count.mjs';
+export { statsBuffer } from '../../motion-dom/dist/es/stats/buffer.mjs';
+export { interpolate } from '../../motion-dom/dist/es/utils/interpolate.mjs';
+export { mix } from '../../motion-dom/dist/es/utils/mix/index.mjs';
+export { mixColor, mixLinearColor } from '../../motion-dom/dist/es/utils/mix/color.mjs';
+export { getMixer, mixArray, mixComplex, mixObject } from '../../motion-dom/dist/es/utils/mix/complex.mjs';
+export { mixImmediate } from '../../motion-dom/dist/es/utils/mix/immediate.mjs';
+export { mixNumber } from '../../motion-dom/dist/es/utils/mix/number.mjs';
+export { invisibleValues, mixVisibility } from '../../motion-dom/dist/es/utils/mix/visibility.mjs';
+export { resolveElements } from '../../motion-dom/dist/es/utils/resolve-elements.mjs';
+export { supportsFlags } from '../../motion-dom/dist/es/utils/supports/flags.mjs';
+export { supportsLinearEasing } from '../../motion-dom/dist/es/utils/supports/linear-easing.mjs';
+export { supportsScrollTimeline } from '../../motion-dom/dist/es/utils/supports/scroll-timeline.mjs';
+export { MotionValue, collectMotionValues, motionValue } from '../../motion-dom/dist/es/value/index.mjs';
+export { color } from '../../motion-dom/dist/es/value/types/color/index.mjs';
+export { hex } from '../../motion-dom/dist/es/value/types/color/hex.mjs';
+export { hsla } from '../../motion-dom/dist/es/value/types/color/hsla.mjs';
+export { hslaToRgba } from '../../motion-dom/dist/es/value/types/color/hsla-to-rgba.mjs';
+export { rgbUnit, rgba } from '../../motion-dom/dist/es/value/types/color/rgba.mjs';
+export { analyseComplexValue, complex } from '../../motion-dom/dist/es/value/types/complex/index.mjs';
+export { dimensionValueTypes, findDimensionValueType } from '../../motion-dom/dist/es/value/types/dimensions.mjs';
+export { defaultValueTypes, getDefaultValueType } from '../../motion-dom/dist/es/value/types/maps/defaults.mjs';
+export { numberValueTypes } from '../../motion-dom/dist/es/value/types/maps/number.mjs';
+export { transformValueTypes } from '../../motion-dom/dist/es/value/types/maps/transform.mjs';
+export { alpha, number, scale } from '../../motion-dom/dist/es/value/types/numbers/index.mjs';
+export { degrees, percent, progressPercentage, px, vh, vw } from '../../motion-dom/dist/es/value/types/numbers/units.mjs';
+export { testValueType } from '../../motion-dom/dist/es/value/types/test.mjs';
+export { getAnimatableNone } from '../../motion-dom/dist/es/value/types/utils/animatable-none.mjs';
+export { findValueType } from '../../motion-dom/dist/es/value/types/utils/find.mjs';
+export { getValueAsType } from '../../motion-dom/dist/es/value/types/utils/get-as-type.mjs';
+export { ViewTransitionBuilder, animateView } from '../../motion-dom/dist/es/view/index.mjs';
+export { cancelSync, sync } from '../../motion-dom/dist/es/frameloop/index-legacy.mjs';
+export { cancelFrame, frame, frameData, frameSteps } from '../../motion-dom/dist/es/frameloop/frame.mjs';
 import * as namespace from '../../framer-motion/dist/es/components/Reorder/namespace.mjs';
 export { namespace as Reorder };

package/dist/es/motion-dom/dist/es/animation/AsyncMotionValueAnimation.mjs

@@ -0,0 +1,179 @@
+import { time } from '../frameloop/sync-time.mjs';
+import { JSAnimation } from './JSAnimation.mjs';
+import { getFinalKeyframe } from './keyframes/get-final.mjs';
+import { KeyframeResolver, flushKeyframeResolvers } from './keyframes/KeyframesResolver.mjs';
+import { NativeAnimationExtended } from './NativeAnimationExtended.mjs';
+import { canAnimate } from './utils/can-animate.mjs';
+import { WithPromise } from './utils/WithPromise.mjs';
+import { supportsBrowserAnimation } from './waapi/supports/waapi.mjs';
+import { MotionGlobalConfig } from '../../../../motion-utils/dist/es/global-config.mjs';
+import { noop } from '../../../../motion-utils/dist/es/noop.mjs';
+
+/**
+ * Maximum time allowed between an animation being created and it being
+ * resolved for us to use the latter as the start time.
+ *
+ * This is to ensure that while we prefer to "start" an animation as soon
+ * as it's triggered, we also want to avoid a visual jump if there's a big delay
+ * between these two moments.
+ */
+const MAX_RESOLVE_DELAY = 40;
+class AsyncMotionValueAnimation extends WithPromise {
+    constructor({ autoplay = true, delay = 0, type = "keyframes", repeat = 0, repeatDelay = 0, repeatType = "loop", keyframes, name, motionValue, element, ...options }) {
+        super();
+        /**
+         * Bound to support return animation.stop pattern
+         */
+        this.stop = () => {
+            if (this._animation) {
+                this._animation.stop();
+                this.stopTimeline?.();
+            }
+            else {
+                this.keyframeResolver?.cancel();
+            }
+        };
+        this.createdAt = time.now();
+        const optionsWithDefaults = {
+            autoplay,
+            delay,
+            type,
+            repeat,
+            repeatDelay,
+            repeatType,
+            name,
+            motionValue,
+            element,
+            ...options,
+        };
+        const KeyframeResolver$1 = element?.KeyframeResolver || KeyframeResolver;
+        this.keyframeResolver = new KeyframeResolver$1(keyframes, (resolvedKeyframes, finalKeyframe, forced) => this.onKeyframesResolved(resolvedKeyframes, finalKeyframe, optionsWithDefaults, !forced), name, motionValue, element);
+        this.keyframeResolver?.scheduleResolve();
+    }
+    onKeyframesResolved(keyframes, finalKeyframe, options, sync) {
+        this.keyframeResolver = undefined;
+        const { name, type, velocity, delay, isHandoff, onUpdate, onComplete } = options;
+        this.resolvedAt = time.now();
+        /**
+         * If we can't animate this value with the resolved keyframes
+         * then we should complete it immediately.
+         */
+        if (!canAnimate(keyframes, name, type, velocity)) {
+            if (MotionGlobalConfig.instantAnimations || !delay) {
+                onUpdate?.(getFinalKeyframe(keyframes, options, finalKeyframe));
+            }
+            keyframes[0] = keyframes[keyframes.length - 1];
+            options.duration = 0;
+            options.repeat = 0;
+        }
+        /**
+         * Resolve startTime for the animation.
+         *
+         * This method uses the createdAt and resolvedAt to calculate the
+         * animation startTime. *Ideally*, we would use the createdAt time as t=0
+         * as the following frame would then be the first frame of the animation in
+         * progress, which would feel snappier.
+         *
+         * However, if there's a delay (main thread work) between the creation of
+         * the animation and the first commited frame, we prefer to use resolvedAt
+         * to avoid a sudden jump into the animation.
+         */
+        const startTime = sync
+            ? !this.resolvedAt
+                ? this.createdAt
+                : this.resolvedAt - this.createdAt > MAX_RESOLVE_DELAY
+                    ? this.resolvedAt
+                    : this.createdAt
+            : undefined;
+        const resolvedOptions = {
+            startTime,
+            finalKeyframe,
+            ...options,
+            keyframes,
+        };
+        /**
+         * Animate via WAAPI if possible. If this is a handoff animation, the optimised animation will be running via
+         * WAAPI. Therefore, this animation must be JS to ensure it runs "under" the
+         * optimised animation.
+         */
+        const animation = !isHandoff && supportsBrowserAnimation(resolvedOptions)
+            ? new NativeAnimationExtended({
+                ...resolvedOptions,
+                element: resolvedOptions.motionValue.owner.current,
+            })
+            : new JSAnimation(resolvedOptions);
+        animation.finished
+            .then(() => {
+            onComplete?.();
+            this.notifyFinished();
+        })
+            .catch(noop);
+        if (this.pendingTimeline) {
+            this.stopTimeline = animation.attachTimeline(this.pendingTimeline);
+            this.pendingTimeline = undefined;
+        }
+        this._animation = animation;
+    }
+    get finished() {
+        if (!this._animation) {
+            return this._finished;
+        }
+        else {
+            return this.animation.finished;
+        }
+    }
+    then(onResolve, _onReject) {
+        return this.finished.finally(onResolve).then(() => { });
+    }
+    get animation() {
+        if (!this._animation) {
+            flushKeyframeResolvers();
+        }
+        return this._animation;
+    }
+    get duration() {
+        return this.animation.duration;
+    }
+    get time() {
+        return this.animation.time;
+    }
+    set time(newTime) {
+        this.animation.time = newTime;
+    }
+    get speed() {
+        return this.animation.speed;
+    }
+    get state() {
+        return this.animation.state;
+    }
+    set speed(newSpeed) {
+        this.animation.speed = newSpeed;
+    }
+    get startTime() {
+        return this.animation.startTime;
+    }
+    attachTimeline(timeline) {
+        if (this._animation) {
+            this.stopTimeline = this.animation.attachTimeline(timeline);
+        }
+        else {
+            this.pendingTimeline = timeline;
+        }
+        return () => this.stop();
+    }
+    play() {
+        this.animation.play();
+    }
+    pause() {
+        this.animation.pause();
+    }
+    complete() {
+        console.log("async animation complete");
+        this.animation.complete();
+    }
+    cancel() {
+        this.animation.cancel();
+    }
+}
+
+export { AsyncMotionValueAnimation };

package/dist/es/motion-dom/dist/es/animation/GroupAnimation.mjs

@@ -1,8 +1,6 @@
-import { supportsScrollTimeline } from '../utils/supports/scroll-timeline.mjs';
-
 class GroupAnimation {
     constructor(animations) {
-        // Bound to accomodate common `return animation.stop` pattern
+        // Bound to accomadate common `return animation.stop` pattern
         this.stop = () => this.runAll("stop");
         this.animations = animations.filter(Boolean);
     }
@@ -20,15 +18,8 @@ class GroupAnimation {
             this.animations[i][propName] = newValue;
         }
     }
-    attachTimeline(timeline, fallback) {
-        const subscriptions = this.animations.map((animation) => {
-            if (supportsScrollTimeline() && animation.attachTimeline) {
-                return animation.attachTimeline(timeline);
-            }
-            else if (typeof fallback === "function") {
-                return fallback(animation);
-            }
-        });
+    attachTimeline(timeline) {
+        const subscriptions = this.animations.map((animation) => animation.attachTimeline(timeline));
         return () => {
             subscriptions.forEach((cancel, i) => {
                 cancel && cancel();
@@ -48,6 +39,9 @@ class GroupAnimation {
     set speed(speed) {
         this.setAll("speed", speed);
     }
+    get state() {
+        return this.getAll("state");
+    }
     get startTime() {
         return this.getAll("startTime");
     }
@@ -61,9 +55,6 @@ class GroupAnimation {
     runAll(methodName) {
         this.animations.forEach((controls) => controls[methodName]());
     }
-    flatten() {
-        this.runAll("flatten");
-    }
     play() {
         this.runAll("play");
     }